glm-5.2 2313c51f12 docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57 ...

Phase 1 architecture for alknet-channels (multiplexing proxy on
alknet/channels). Grounded in the completed de-risk POC (28 tests) and the
landed ADR-070 (BidiStreamSource trait + Connection::from_source).

ADRs:
- 071: 9-byte chunk wire format (generalizes TTY's 5-byte)
- 072: channel 0 pre-negotiated as alknet/call (no special control plane)
- 073: channel lifecycle operations on the call protocol — channel/open,
  close, control, resources/subscribe; direction field pinned; subscribe
  from day one (not poll-for-v1 — StreamingHandler machinery exists)
- 074: ChannelBidiStreamSource implements BidiStreamSource (ADR-070);
  into_sub_streams() typed accessor for TTY; accept_bi() generic path
- 075: ChannelsAdapter + ChannelManager; REQ-CH-01..04 wire invariants
- 076: bounded-buffer backpressure (1 MiB), 256-channel cap, monotonic IDs
- 077: TTY inside channels uses sub-streams, not own wire format;
  amends ADR-052 scope to direct-connect TTY; channels feature on tty
- 078: two-pump shutdown-on-completion contract (handler-level)
- 079: hub relay translates channel 0, byte-forwards data channels
- 080: ChannelClient (QUIC-only); AlknetClient core extraction deferred (OQ-55)

Spec docs: overview, channels-wire, channels-connection, channels-adapter,
channel-operations, channel-client.

OQ-56 (full windowing) and OQ-57 (two-pump helper extraction) are genuine
deferred(scope) deferrals with concrete blocking conditions; the contracts
are decided, only the extensions are deferred.

Hedging audit converted three research hedges into decisions:
resources/subscribe (not poll), server-assigned IDs (not if-zero-RTT),
bounded-buffer (not if-HOL-becomes-a-problem).

2026-07-12 12:57:18 +00:00

..

001-alpn-protocol-dispatch.md

docs(architecture): add Phase 0 architecture specs for ALPN-as-service model

2026-06-15 22:14:58 +00:00

002-protocol-handler-trait.md

docs(architecture): resolve review #002 Tiers 1-3 — mechanical and consistency fixes

2026-06-22 05:46:37 +00:00

003-crate-decomposition.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

004-auth-as-shared-core.md

docs(architecture): resolve review #002 Tiers 1-3 — mechanical and consistency fixes

2026-06-22 05:46:37 +00:00

005-irpc-as-call-protocol-foundation.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

006-alpn-convention-and-connection-model.md

docs(architecture): add Phase 0 architecture specs for ALPN-as-service model

2026-06-15 22:14:58 +00:00

007-bistream-type-definition.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

008-secret-service-integration.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

009-one-way-door-decision-framework.md

docs(arch): tighten door-type framing — reversal cost, not deferral

2026-06-28 09:19:10 +00:00

010-alpn-router-and-endpoint.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

011-authcontext-structure.md

docs(architecture): add alknet-call crate spec, ADR-012, resolve OQ-07

2026-06-16 14:22:20 +00:00

012-call-protocol-stream-model.md

docs(architecture): add alknet-call crate spec, ADR-012, resolve OQ-07

2026-06-16 14:22:20 +00:00

013-rust-canonical-implementation.md

docs(architecture): add ADR-014 secret material flow, remove vault ops from call protocol

2026-06-18 03:16:45 +00:00

014-secret-material-flow-and-capability-injection.md

docs(architecture): rename trusted to internal, add OQ-17 abort cascade and OQ-18 privilege model

2026-06-18 07:38:33 +00:00

015-privilege-model-and-authority-context.md

docs(architecture): add ADR-024 — operation registry layering, resolve C6

2026-06-22 13:44:58 +00:00

016-abort-cascade-for-nested-calls.md

docs(architecture): resolve review #002 remaining Tier 4 findings

2026-06-23 08:20:27 +00:00

017-call-protocol-client-and-adapter-contract.md

docs(arch): hub-wiring cluster — aggregated env, peer_operations, from_call cleanup, alknet-hub crate spec

2026-07-09 16:01:30 +00:00

018-vault-standalone-crate.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

019-vault-assembly-layer-only.md

docs(architecture): remove derive_password and site_password_path from vault

2026-06-23 06:06:11 +00:00

020-hd-derivation-for-encryption-keys.md

docs(architecture): resolve review #002 remaining Tier 4 findings

2026-06-23 08:20:27 +00:00

021-key-rotation-via-version-indexed-paths.md

docs(architecture): resolve review #002 Tiers 1-3 — mechanical and consistency fixes

2026-06-22 05:46:37 +00:00

022-handler-registration-provenance-and-composition-authority.md

docs(arch): ADR-066 — move from_jsonschema to alknet-http as HTTP-backed single-endpoint adapter

2026-07-09 11:42:56 +00:00

023-operation-error-schemas.md

docs(arch): ADR-049 — streaming handler for subscription operations

2026-07-02 07:43:01 +00:00

024-operation-registry-layering.md

docs(architecture): add ADR-024 — operation registry layering, resolve C6

2026-06-22 13:44:58 +00:00

025-vault-local-only-dispatch.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

026-vault-key-model-hd-derivation.md

docs(architecture): resolve review #002 remaining Tier 4 findings

2026-06-23 08:20:27 +00:00

027-tls-identity-redesign-acme-rawkey-decoupling.md

docs(adr-027): TLS identity redesign — ACME + RawKey decoupling

2026-06-24 12:29:24 +00:00

028-callclient-peer-scoped-registry-filtering.md

docs(arch): ADR-029 peer-graph routing model — supersedes ADR-028

2026-06-27 06:04:19 +00:00

029-peer-graph-routing-model.md

docs(arch): ADR-030..033 — repo/adapter pattern, PeerEntry, CredentialStore, forwarded-for

2026-06-27 12:12:25 +00:00

030-peerentry-and-identity-id-decoupling.md

docs(arch): multi-credential PeerEntry, resolve OQ-29, dissolve OQ-35, add OQ-37

2026-06-28 08:49:36 +00:00

031-credentialstore-repo-trait.md

docs(arch): ADR-035 — concrete persistence adapter shapes, resolve OQ-36

2026-06-28 11:10:31 +00:00

032-forwarded-for-identity.md

docs(arch): ADR-030..033 — repo/adapter pattern, PeerEntry, CredentialStore, forwarded-for

2026-06-27 12:12:25 +00:00

033-storage-boundary-and-repo-adapter-pattern.md

docs(arch): ADR-035 — concrete persistence adapter shapes, resolve OQ-36

2026-06-28 11:10:31 +00:00

034-outgoing-only-x509-and-three-peer-roles.md

docs(http): defer h3/WebTransport (ADR-044); browsers use WebSocket for v1

2026-06-30 05:55:55 +00:00

035-concrete-persistence-adapter-shapes.md

docs(arch): ADR-035 — concrete persistence adapter shapes, resolve OQ-36

2026-06-28 11:10:31 +00:00

036-http-to-call-operation-mapping.md

docs(http): resolve OQ-39; add ADRs 045-047; record pubsub prior art for WS path

2026-06-30 09:49:25 +00:00

037-mcp-stdio-transport-exclusion.md

docs(http): draft alknet-http architecture specs and ADRs 036-039

2026-06-29 05:53:38 +00:00

038-http3-and-webtransport-as-first-class.md

docs(http): defer h3/WebTransport (ADR-044); browsers use WebSocket for v1

2026-06-30 05:55:55 +00:00

039-http-server-and-client-host-colocated.md

docs(http): draft alknet-http architecture specs and ADRs 036-039

2026-06-29 05:53:38 +00:00

040-webtransport-alpn-stream-proxy.md

docs(http): defer h3/WebTransport (ADR-044); browsers use WebSocket for v1

2026-06-30 05:55:55 +00:00

041-mcp-tool-gateway-pattern.md

docs(http): add ADR-041 MCP tool-gateway pattern for to_mcp

2026-06-29 08:34:44 +00:00

042-openapi-gateway-pattern.md

docs(http): pre-decomposition sanity check fixes — /subscribe POST, direct-call cleanup, from_mcp output handling

2026-07-01 05:41:07 +00:00

043-webtransport-bidirectional-alpn-substrate.md

docs(http): defer h3/WebTransport (ADR-044); browsers use WebSocket for v1

2026-06-30 05:55:55 +00:00

044-defer-webtransport-browsers-use-websocket.md

docs(http): resolve OQ-39; add ADRs 045-047; record pubsub prior art for WS path

2026-06-30 09:49:25 +00:00

045-to-openapi-gateway-spec-versioning.md

docs(http): resolve OQ-39; add ADRs 045-047; record pubsub prior art for WS path

2026-06-30 09:49:25 +00:00

046-assembly-layer-custom-http-routes.md

docs(http): pre-decomposition sanity check fixes — /subscribe POST, direct-call cleanup, from_mcp output handling

2026-07-01 05:41:07 +00:00

047-remove-direct-call-http-surface.md

docs(http): pre-decomposition sanity check fixes — /subscribe POST, direct-call cleanup, from_mcp output handling

2026-07-01 05:41:07 +00:00

048-websocket-native-session-not-gateway.md

docs(http): pre-decomposition sanity check fixes — /subscribe POST, direct-call cleanup, from_mcp output handling

2026-07-01 05:41:07 +00:00

049-streaming-handler-for-subscriptions.md

docs(arch): ADR-049 — streaming handler for subscription operations

2026-07-02 07:43:01 +00:00

050-dynamic-resource-ownership-for-runtime-spawned-resources.md

docs(arch): add ADR-050 — dynamic resource ownership for runtime-spawned resources

2026-07-04 16:08:04 +00:00

051-yaml-input-for-from-openapi.md

docs(arch): amend ADR-051 §2 — yaml_serde 0.10.x is YAML 1.2, not 1.1

2026-07-06 13:30:59 +00:00

052-alknet-tty-wire-format-and-two-carriage.md

docs(arch): ADR-057 — alknet-tty does not depend on alknet-call (self-contained negotiation framing)

2026-07-07 11:15:52 +00:00

053-ttybackend-trait-and-ttyhandle.md

docs(arch): ADR-057 — alknet-tty does not depend on alknet-call (self-contained negotiation framing)

2026-07-07 11:15:52 +00:00

054-local-tty-backend-sibling-crate.md

docs(arch): ADR-057 — alknet-tty does not depend on alknet-call (self-contained negotiation framing)

2026-07-07 11:15:52 +00:00

055-exit-code-on-control-chunk.md

docs(arch): alknet-tty Phase 1 specs — wire format, backend trait, local backend, exit-chunk ordering

2026-07-06 15:05:36 +00:00

056-backend-cleanup-on-session-cancel.md

docs(arch): alknet-tty spec sanity-check fixes — TtyControlHandle newtype (C1), backend cleanup contract (W1, ADR-056), clarifications (S1-S5)

2026-07-07 10:38:49 +00:00

057-alknet-tty-no-alknet-call-dep.md

docs(arch): ADR-057 — alknet-tty does not depend on alknet-call (self-contained negotiation framing)

2026-07-07 11:15:52 +00:00

058-alknet-docker-on-alknet-call.md

docs(arch): draft alknet-docker architecture specs (ADRs 058-063, OQs 048-051)

2026-07-08 09:29:22 +00:00

059-bollard-021-dependency-and-features.md

docs(arch): draft alknet-docker architecture specs (ADRs 058-063, OQs 048-051)

2026-07-08 09:29:22 +00:00

060-container-resource-model-and-label-namespace.md

docs(arch): resolve OQ-050 — include docker/system/events in v1

2026-07-10 07:31:55 +00:00

061-docker-tty-backend-in-alknet-docker.md

docs(arch): draft alknet-docker architecture specs (ADRs 058-063, OQs 048-051)

2026-07-08 09:29:22 +00:00

062-docker-client-injection-via-closure-capture.md

docs(arch): draft alknet-docker architecture specs (ADRs 058-063, OQs 048-051)

2026-07-08 09:29:22 +00:00

063-exit-code-on-terminal-call-responded.md

docs(arch): draft alknet-docker architecture specs (ADRs 058-063, OQs 048-051)

2026-07-08 09:29:22 +00:00

064-irpc-never-integrated-hand-rolled-framing.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

065-connection-from-stream-generic-single-stream.md

docs(arch): sync specs to transport generalization sweep (ADR-064, ADR-065)

2026-07-09 07:40:51 +00:00

066-from-jsonschema-as-http-adapter.md

docs(arch): ADR-066 — move from_jsonschema to alknet-http as HTTP-backed single-endpoint adapter

2026-07-09 11:42:56 +00:00

067-aggregated-peer-env-wiring.md

docs(arch): clean unwrap, remove stale ownership, protocol-agnostic hub core

2026-07-10 06:26:56 +00:00

068-peer-composite-env-peer-operations.md

docs(arch): hub-wiring cluster — aggregated env, peer_operations, from_call cleanup, alknet-hub crate spec

2026-07-09 16:01:30 +00:00

069-from-call-manual-free-function.md

docs(arch): hub-wiring cluster — aggregated env, peer_operations, from_call cleanup, alknet-hub crate spec

2026-07-09 16:01:30 +00:00

070-bidistreamsource-trait.md

docs(arch): add Connection::from_source to ADR-070 — the missing extension point

2026-07-12 10:55:25 +00:00

071-channels-wire-format.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

072-channel-0-pre-negotiated-call.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

073-channel-lifecycle-operations.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

074-channelconnection-bidistreamsource.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

075-channelsadapter-and-channelmanager.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

076-backpressure-channel-limits-id-reuse.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

077-tty-inside-channels.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

078-two-pump-shutdown-on-completion.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

079-hub-relay-translate-not-forward.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00

080-channelclient.md

docs(arch): add alknet-channels specs — ADRs 071-080, 7 spec docs, OQ-56/57

2026-07-12 12:57:18 +00:00