docs(adrs): reconcile WS-03 browser data-channel promise (ADR-067/048)

Record the v1 cut for browser-opened data channels over WS (review-001
WS-03): the design (ADR-067) stands; only the wiring is deferred.

- open-questions.md: add OQ-05 (deferred(scope: v1 cut)) with gap
  detail and deferred scope
- ADR-067: dated status amendment + v1-cut note at the data-channel
  step; References point to OQ-05
- ADR-048: dated reconciliation note — overlay bidirectionality is
  decided design, not a v1 implementation commitment
- websocket.md: status notes on §"Data channels for browsers" and
  upgrade step 7
- task review-001-ws-data-channel-decision: completed, Summary filled

Verification: taskgraph validate (38 tasks OK); cargo doc --no-deps
(pre-existing warnings only).
This commit is contained in:
2026-08-29 13:57:24 +00:00
parent 6b0e4db912
commit a5b294e965
5 changed files with 96 additions and 6 deletions
@@ -1,7 +1,8 @@
---
id: review-001-ws-data-channel-decision
name: Reconcile ADR-067 browser data channels with the v1 implementation (WS-03, planning)
status: pending
status: completed
depends_on: []
scope: narrow
risk: low
@@ -29,8 +30,8 @@ ADR-067 (+ ADR-048's overlay contract) to defer with a rationale.
## Acceptance Criteria
- [ ] Decision made and recorded (implementation task + ADR/OQ update, or ADR-067 amendment)
- [ ] If v1-cut: ADR-067 and ADR-048 carry the reconciliation note; the gap is not silently silent
- [x] Decision made and recorded (implementation task + ADR/OQ update, or ADR-067 amendment)
- [x] If v1-cut: ADR-067 and ADR-048 carry the reconciliation note; the gap is not silently silent
- [ ] If in-scope: a follow-up task file exists with scoped acceptance criteria (incl. a browser-opened-channel test)
## References
@@ -45,6 +46,38 @@ ADR-067 (+ ADR-048's overlay contract) to defer with a rationale.
> planning so the WS-01/02 robustness work is not blocked on a design
> discussion.
Decision: **option (b) — v1 cut, recorded**. The design (ADR-067) needs
no changes; only the wiring is missing, and building it was out of scope
for the review-001 remediation cycle. The recently landed WS robustness
work (WS-01 idle-read timeout, WS-08/09 session caps/eviction, pump
consolidation) is the foundation the future data-channel wiring builds
on; a fresh, properly scoped implementation task in a later cycle is the
honest sequencing (tracked via OQ-05, reopened when a browser consumer
lands).
## Summary
> Filled on completion.
Decision: option (b) — record the v1 cut; do not wire the data-channel
path in this cycle. Where recorded:
- `docs/architecture/open-questions.md` — new **OQ-05** ("Browser-opened
data channels over WS — v1 cut"), status `deferred(scope: v1 cut —
no browser consumer yet; reopened when one lands)`, with the gap
spelled out (channel-0-only wiring in `src/websocket/upgrade.rs`; no
`ChannelCore`/`register_openable`/`ChannelOperations` path) and the
deferred scope named (openable-ALPN/policy pass-through + a
browser-opened-channel end-to-end test).
- `docs/architecture/decisions/067-websocket-carries-channels.md`
Status line amended (2026-08-29) and a v1-cut note added under the
data-channel step of the upgrade path; References point to OQ-05.
- `docs/architecture/decisions/048-websocket-native-session-not-gateway.md`
— dated reconciliation note under Status: §4's bidirectionality via
the connection-local overlay is decided design, not a v1
implementation commitment.
- `docs/architecture/websocket.md` — status note on §"Data channels for
browsers" and a parenthetical on upgrade step 7, so the spec no
longer silently promises the capability.
Verification: `taskgraph validate` passes (38 tasks); `cargo doc
--no-deps` unaffected (only pre-existing src/ rustdoc warnings — no
source changes in this task).