From 3ca7505abd3e1dbcbe05586d308c827ec351b8ce Mon Sep 17 00:00:00 2001
From: "glm-5.3-flash" <glm-5.3-flash@alk.dev>
Date: Tue, 13 Oct 2026 11:32:12 +0000
Subject: [PATCH] docs(src): re-key live docs.rs comments off the alknet
 replacement
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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
---
 src/channels/adapter.rs | 7 ++++---
 src/client/from_call.rs | 4 +++-
 src/client/mod.rs       | 2 +-
 3 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/src/channels/adapter.rs b/src/channels/adapter.rs
index 126380d..959368b 100644
--- a/src/channels/adapter.rs
+++ b/src/channels/adapter.rs
@@ -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(
diff --git a/src/client/from_call.rs b/src/client/from_call.rs
index 027f3d6..876e837 100644
--- a/src/client/from_call.rs
+++ b/src/client/from_call.rs
@@ -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());
diff --git a/src/client/mod.rs b/src/client/mod.rs
index 66f24f3..9c4d8bd 100644
--- a/src/client/mod.rs
+++ b/src/client/mod.rs
@@ -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.