Repository navigation
id: design: fleet surface for the broker role (from #5671) #5798
Description
Summary
Follow-on design ticket from #5671 — 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 future fleet id subcommand wiring the broker role into fleet sandbox→laptop patterns — the operational surface of the fallback design.
Context from the parent
The parent design fixes how ID clients and servers stay reachable when UDP is denied — fallback order, broker shapes, trust model, and the E2E boundary. 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: #5671. Programme: epic #2056. Filed by WS-F (2026-11-04 ID design gap & expansion pass).
Activity
developing-today commentedon Nov 5, 2026
CODE-1481
dezren39 commentedon Nov 5, 2026
🤖 Agent note · picked up
dezren39 commentedon Nov 5, 2026
🤖 Agent note · triage complete
Triage of issue #5798 at current main (verified fresh 2026-11-05):
app/id). No hard-stop labels, no design content posted yet beyond the filing stub, and no implementation or PR references it. Its expected output is explicit in the body: a recorded decision (chosen shape, alternatives rejected and why, invariants implementation must hold) — the design itself is the work, not a code fix.status/parkedunder another queue task. The parent fixes the decisions this ticket must not re-decide (fallback order, broker shapes, trust model, E2E boundary).Ordering (the substantive triage finding): #5798 designs the fleet surface (
fleet idwiring) for the broker role — it consumes other tickets' outputs, so it goes last in this sibling set:fleet idverb/registry shape for the broker role in the sandbox→laptop pattern, which parent decisions it binds to (cited, not re-decided), and the decision record the body requires.Blockers recorded: sequencing only — #5798 is blocked in practice on #5792/#5795/#5791 decisions, all of which are open design work under parent #5671 (programme epic #2056). No Drew decision is needed to proceed in that order; implementation timing remains a separate decision per the filing note. Issue #5798 stays open as the design ticket.