id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674)

Summary

Follow-on design ticket from #5674 — its decomposition sketch names this as a separate design, and the parent's acceptance requires these tickets to be filed and linked. Filed in the 2026-11-04 gap pass (WS-F) so the design work exists and can be prioritised on its own merits; implementation timing is a separate decision, possibly months out.

What this design must settle

The browser/restrictive-network adapter: WebSocket/WSS with HTTPS fallback, and what the fallback costs in latency and semantics.

Context from the parent

The parent design fixes the postcard wire-format family and the transport-adapter model that carries ID over non-UDP transports and relays. The parent issue carries the surrounding decisions this ticket must not re-decide; where this ticket's answer would change a parent decision, record that explicitly rather than silently forking it.

Decision record expected

Close this design with a recorded decision (on this issue or in a doc/ record linked from it): the chosen shape, the alternatives rejected and why, and the invariants implementation must hold. If the design splits further, file the splits and link them here rather than growing this issue.

Relations

Parent: #5674. Programme: epic #2056. Filed by WS-F (2026-11-04 ID design gap & expansion pass).

CODE-1494

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-i
Session / ID: task 10214
Found via: queue claim
Task: Work issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 — assigned_lane=opencode, handed off to opencode claimant per §1b; parked 1800s for claimant launch
Expectation: claimant launches bound opencode session
Links: n/a

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-k
Session / ID: task 10214
Found via: queue claim
Task: Triage issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811: id: design: adapter: WebSocket/WSS + HTTPS fallback (from id: design: Wire format & transport adapters — postcard schema, non-UDP carriers, relays/proxies #5674) — handed off to the opencode claimant per execution-lane assignment (assigned_lane=opencode); this lane does not work task 10214 itself.
Expectation: The laptop claimant launches a bound opencode session for task 10214, which drives issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 to a terminal state.
Links: task 10214 (queue repo-health-code-pilot)

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-s
Session / ID: task 10214
Found via: queue claim
Task: Triage of issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 (design: adapter WebSocket/WSS + HTTPS fallback, from id: design: Wire format & transport adapters — postcard schema, non-UDP carriers, relays/proxies #5674) — execution-lane assignment returned opencode, so this task is handed off; the laptop claimant launches the bound opencode session which drives it to its terminal state.
Expectation: Claimant session posts the triage findings on issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 and routes any follow-up.
Links: task 10214 · issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-k
Session / ID: task 10214
Found via: queue claim
Task: triage id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 — execution lane assigned opencode; handing off to the laptop opencode claimant, which launches a bound session. Verified fresh: issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 is OPEN with no hard-stop labels (no held, user/owned, do-not-merge, do-not-auto-edit).
Expectation: Claimant's bound opencode session works issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 at current main; if unbound at park expiry, task 10214 returns to queue.

agent-note:v1 — task 10214 (triage, #5811) picked up by lane code-u and handed off to the opencode execution lane (assigned_lane=opencode). The opencode-claimant launches the bound opencode session, which drives task 10214 to its terminal state. Labels synced: queue/claimed + status/in-progress + work/assigned. (Posted via the developing.today GitHub App — user gh token GraphQL rate-limited until ~16:46Z.)

🤖 Agent note · handed off

Agent: repo queue worker, lane code-j (repo-worker-code)
Session / ID: cron repo-queue-worker-shift-j run 2026-11-09 09:10 CST; task 12897
Found via: queue claim · task 12897
Task: task 12897 for issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811. Fresh check this shift: issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 is OPEN; no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit). Execution-lane assignment row 4595 returned opencode (no session bound yet) — handed off to the opencode claimant; this lane does not work it directly.
Expectation: claimant session drives task 12897 to a terminal state; task 12897 parked 20 minutes pending launch.
Links: task 12897 · issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811

🤖 Agent note · handed off

Agent: repo queue worker, lane code-n (repo-worker-code)
Session / ID: cron repo-queue-worker-shift-n run 2026-11-09 09:27 CST; task 12897
Found via: claimed task 12897 this shift (lane stamp code-n verified); execution-lane assignment returned opencode (lane row 4595), so this lane handed it off per runbook §1b and did not work it itself.
Task: task 12897 for issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 (small_fix). Verified fresh 2026-11-09T15:43:11Z via gh: issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 OPEN; no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit absent). No PRs in packet. Attempts 9/12.
Expectation: the opencode claimant launches the bound session; done looks like that session driving task 12897 to a terminal state per the packet.
Outcome this shift: checkpointed handed_off and parked task 12897 for 1200s. Labels synced to the parked set on issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811.
Links: task 12897 · issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811

🤖 Agent note · handed off

Agent: repo queue worker, lane code-p (repo-worker-code)
Session / ID: cron repo-queue-worker-shift-p run 2026-11-09 10:17 CST; task 12897
Found via: claimed task 12897 this shift (lane stamp code-p verified); execution-lane assignment returned opencode (lane row 4595)
Task: Re-claimed task 12897 for issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 (small_fix: WebSocket/WSS + HTTPS fallback adapter decision record, attempt 9/12). Fresh check via gh: issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 is OPEN, no hard-stop labels; parent issue id: design: Wire format & transport adapters — postcard schema, non-UDP carriers, relays/proxies #5674 is still OPEN. Handed off to the opencode claimant per runbook 1b; task parked 1200s pending claimant; this lane does not work it directly.
Expectation: claimant session drives task 12897 to a terminal state.
Links: task 12897 · issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 · issue id: design: Wire format & transport adapters — postcard schema, non-UDP carriers, relays/proxies #5674

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-x
Session / ID: task 12897 · cron repo-queue-worker-shift-x run 2026-11-09 10:39 CST
Found via: queue claim
Task: small_fix task 12897 for issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 — re-verified OPEN, no hard-stop labels (labels: status:in-review, task/triage, status/parked, queue/parked, app/id, work/assigned). Execution lane is opencode (lane row 4595, session_id None), so handed off to the opencode claimant. Attempts 3/3 AT CAP.
Expectation: claimant launches the bound opencode session; task 12897 parked 1200s for the claimant.
Links: issue id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811 · task 12897

Agent note - handed off: task 12897, lane code-j, opencode claimant row 4595; issue #5811 OPEN, no hard-stop labels; PR #7613 in prior progress.

Navigation Menu

Repository navigation

id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811

Summary

What this design must settle

Context from the parent

Decision record expected

Relations

122 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id: design: adapter: WebSocket/WSS + HTTPS fallback (from #5674) #5811

Description

Summary

What this design must settle

Context from the parent

Decision record expected

Relations

Activity

developing-today commented on Nov 5, 2026

developing-today commented on Nov 5, 2026

developing-today commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

developing-today commented on Nov 5, 2026

122 remaining items

dezren39 commented on Nov 9, 2026

dezren39 commented on Nov 9, 2026

dezren39 commented on Nov 9, 2026

dezren39 commented on Nov 9, 2026

dezren39 commented on Nov 9, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions