deepseek-v4-pro 85c5590001 docs(architecture): add alknet-typedef crate specs, ADRs 095-098, and OQs 069-071 ...

Add the alknet-typedef architecture specification — the binary struct
engine that takes JSON Schema with TypeDef:* custom keywords and produces
offset maps, read/write functions, and validation.

Specs (docs/architecture/crates/typedef/):
- overview.md: purpose, 'schema is the format' principle, consumers, scope
- schema-layer.md: 17 TypeDef:* kinds, jsonschema integration, annotations
- layout-engine.md: two layout modes, three variable-length strategies
- data-access.md: read/write, TUnion dispatch, field paths, zero-copy
- validation.md: custom keyword validators, TypedefError, TypedefEngine

ADRs:
- 095: Purpose, scope, and the jsonschema engine
- 096: Two layout modes — packed sequential vs aligned static
- 097: Schema annotations — endianness, alignment, encoding, TUnion
- 098: Error handling and validation strategy

OQs (deferred(scope)):
- 069: Arrays of variable-length-element structs
- 070: no_std + alloc support
- 071: Builder API for schema construction

Index updates: README doc table + ADR table, open-questions.md theme
table + Deferred/Blocked section, overview.md crate graph.

Grounded in the alknet-typedef POC (26 tests passing) and the
call-channels-unification research. Reviewed by architecture-reviewer;
all critical issues, warnings, and suggestions addressed.

2026-07-20 11:57:03 +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): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +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): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +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(arch): endpoint as pure accept-loop runner + acme-tls/1 guard relocation (ADR-083, OQ-60/61)

2026-07-14 07:59:04 +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

refactor(tty): split control channel into STREAM_CTRL_IN/STREAM_CTRL_OUT halves (Phase 7)

2026-07-18 17:02:59 +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): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +00:00

070-bidistreamsource-trait.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

071-channels-wire-format.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

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

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

073-channel-lifecycle-operations.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

074-channelconnection-bidistreamsource.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

075-channelsadapter-and-channelmanager.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

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

docs(adr): 094 — per-identity channel cap as DoS defense

2026-07-19 11:17:57 +00:00

077-tty-inside-channels.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

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

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

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

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

080-channelclient.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

081-channels-subcrate-decomposition.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

082-alknet-tls-extraction.md

docs(arch): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +00:00

083-endpoint-as-accept-loop-runner.md

docs(arch): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +00:00

084-aws-lc-rs-crypto-provider.md

docs(arch): workspace scope correction (ADR-085) + tls spec review fixes

2026-07-14 12:46:16 +00:00

085-workspace-scope-core-vs-consumer-repos.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

086-endpoint-types-and-entry-points.md

docs(arch): endpoint types and entry points (ADR-086) — resolves OQ-62

2026-07-15 05:19:11 +00:00

087-tlsclientconfig-not-blocked-on-dial.md

docs(arch): ConnectionCredentials decouples dial from call protocol (ADR-091) + migration plan cleanups

2026-07-17 05:56:47 +00:00

088-tlserror-shape.md

docs(arch): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +00:00

089-alknetclient-native-dial-seam.md

docs: remove CallCredentials — dead field, dead from_call path, auth_token is per-request payload

2026-07-17 08:54:04 +00:00

090-client-dial-socks5-proxy-seam.md

docs(arch): tighten tls/endpoint/client specs — remove connect/connect_quic, move CallCredentials to core, shed alknet-call TLS deps

2026-07-16 11:33:18 +00:00

091-connectioncredentials-decouple-dial-from-call.md

docs: remove CallCredentials — dead field, dead from_call path, auth_token is per-request payload

2026-07-17 08:54:04 +00:00

092-bistream-as-the-handler-leaf.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

093-channels-pure-channel-multiplexing.md

docs(adr): 093 — channels pure channel multiplexing (8-byte header, no stream_type)

2026-07-18 18:10:17 +00:00

094-per-identity-channel-cap.md

docs(adr): 094 — per-identity channel cap as DoS defense

2026-07-19 11:17:57 +00:00

095-alknet-typedef-purpose-scope-jsonschema-engine.md

docs(architecture): add alknet-typedef crate specs, ADRs 095-098, and OQs 069-071

2026-07-20 11:57:03 +00:00

096-two-layout-modes-packed-vs-aligned.md

docs(architecture): add alknet-typedef crate specs, ADRs 095-098, and OQs 069-071

2026-07-20 11:57:03 +00:00

097-schema-annotations.md

docs(architecture): add alknet-typedef crate specs, ADRs 095-098, and OQs 069-071

2026-07-20 11:57:03 +00:00

098-error-handling-validation-strategy.md

docs(architecture): add alknet-typedef crate specs, ADRs 095-098, and OQs 069-071

2026-07-20 11:57:03 +00:00