docs(src): re-key live docs.rs comments off the alknet replacement
- src/channels/adapter.rs: OQ-41's QUIC-native substrate deferral now names the composition layer (owner OQ-43, today the alknet glue) instead of repo-pinning 'the downstream alknet crate' — matching the re-key convention already applied to docs/architecture - src/client/mod.rs: AdapterError's downstream-adapter example renamed from the retired `alknet-http` to `alkhttp` - src/client/from_call.rs: stale 'integration test in a later task' hedging replaced with the actual loopback coverage (relay_tests, hub_leg_tests, gate2_tests) Verified: cargo test (697 ok incl. stub_guard), clippy -D warnings, fmt --check
This commit is contained in:
1 parent
ff07f92bdb
commit
3ca7505abd
3 files changed
+8
-5
No files matched your search
@@ -8,7 +8,8 @@
|
||||
//! (single bidi stream, header-demuxed N channels — TCP+TLS,
|
||||
//! WebTransport session, SSH `direct-tcpip`). The QUIC-native
|
||||
//! multi-stream substrate (accept remaining bidi streams, read headers
|
||||
//! off each) is deferred to the downstream alknet crate (OQ-41).
|
||||
//! off each) belongs in the composition layer's QUIC accept loop
|
||||
//! (OQ-41; composition-layer owner OQ-43 — today the alknet glue).
|
||||
//! The wire format and demux loop are correct for both substrates;
|
||||
//! only the outer `accept_bi()` loop is missing.
|
||||
//!
|
||||
@@ -103,8 +104,8 @@ impl ChannelsAdapter {
|
||||
/// in-line substrate mode (single bidi stream, header-demuxed N
|
||||
/// channels — TCP+TLS, WebTransport session, SSH `direct-tcpip`).
|
||||
/// The QUIC-native multi-stream substrate (accept remaining bidi
|
||||
/// streams, read headers off each) is deferred to the downstream
|
||||
/// alknet crate (OQ-41). The wire format and demux loop are correct
|
||||
/// streams, read headers off each) belongs in the composition
|
||||
/// layer (OQ-41; owner OQ-43 — today the alknet glue). The wire format and demux loop are correct
|
||||
/// for both substrates; only the outer `accept_bi()` loop is missing.
|
||||
/// See ADR-034 §substrate modes.
|
||||
async fn run_demux_loop(
|
||||
|
||||
@@ -1244,7 +1244,9 @@ mod tests {
|
||||
/// `from_call` against a stub `CallConnection` (no real transport) returns
|
||||
/// a `DiscoveryFailed` because `services/list` can't dispatch on a mock
|
||||
/// connection. This verifies the error path rather than the happy path
|
||||
/// (the happy path is covered by the integration test in a later task).
|
||||
/// (the happy path is covered by the loopback integration tests
|
||||
/// in `src/channels/relay_tests.rs`, `src/channels/hub_leg_tests.rs`,
|
||||
/// and `src/channels/gate2_tests.rs`).
|
||||
#[tokio::test]
|
||||
async fn from_call_against_mock_connection_returns_discovery_failed() {
|
||||
let conn = CallConnection::new(stub_connection());
|
||||
|
||||
+1
-1
@@ -23,7 +23,7 @@ use crate::registry::registration::HandlerRegistration;
|
||||
/// Errors produced by [`OperationAdapter::import`].
|
||||
///
|
||||
/// The variant set is the v1 default (two-way-door remainder, OQ-26);
|
||||
/// `#[non_exhaustive]` lets downstream adapters (e.g. `alknet-http`'s
|
||||
/// `#[non_exhaustive]` lets downstream adapters (e.g. `alkhttp`'s
|
||||
/// `from_openapi`/`from_mcp`) extend without breaking match arms. All
|
||||
/// payloads are string messages — kept simple and `Send + Sync` by
|
||||
/// construction.
|
||||
|
||||
Reference in new issue
Block a user