Skip to content

id: design: versioning, negotiation & forward-compatibility policy (from #5674) #5809

Open

Description

@dezren39

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

How wire versions are negotiated and what forward compatibility promises: what a v1 peer must do with a v2 frame, and what it may never silently drop.

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).

Activity

  1. added
    app/idPackage/app: id (pkgs/ or apps/ in this repo)
    on Nov 5, 2026
  2. developing-today commented on Nov 5, 2026

    @developing-today
    Contributor
  3. added
    queue/queuedHas a queued task in the Supabase agent queue
    task/triageQueue packet kind: verify, reproduce, and route this item
    work/assignedQueue worker lifecycle state
    queue/claimedQueue worker lifecycle state
    and removed
    queue/queuedHas a queued task in the Supabase agent queue
    on Nov 5, 2026
  4. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    agent-note:v1

  5. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    agent-note:v1

    • task: 10212
    • state: done (triaged)
    • lane: code-h (direct)

    Triage 2026-11-05 (task 10212): well-scoped follow-on design ticket; its one real ordering constraint is its parent.

    Verified fresh at triage:

    Routing: design work may proceed in parallel with #5674 (drafting the negotiation shape, v1-peer/v2-frame behavior, never-silently-drop invariants), but the closing decision record is ordered after #5674's decision record. No blocker on Drew; implementation timing is a separate later decision per the filing note.

  6. added
    kind/designA design proposal (design-architect): multi-step, phased, decision-bearing
    and removed
    queue/claimedQueue worker lifecycle state
    work/assignedQueue worker lifecycle state
    on Nov 5, 2026
  7. 148 remaining items

  8. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  9. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  10. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    agent-note:v1
    task 12799 handed off to opencode claimant (execution lane row 4560) by lane code-o. Issue #5809 OPEN verified fresh, no hard-stop labels. Next: claimant launches the bound opencode session.

  11. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  12. added
    queue/claimedQueue worker lifecycle state
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    status/parkedDeliberately paused with a recorded resume condition
    and removed
    status/parkedDeliberately paused with a recorded resume condition
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    queue/claimedQueue worker lifecycle state
    on Nov 9, 2026
  13. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  14. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    Agent note — lane code-k, task 12799

  15. dezren39 commented on Nov 9, 2026

    @dezren39
    MemberAuthor

    Agent note - handed off: task 12799, lane code-j, opencode claimant row 4560; issue #5809 OPEN, no hard-stop labels. Full note in action-outbox text file 12799-handoff-note-5809-j-20261109-1110.md if needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

app/idPackage/app: id (pkgs/ or apps/ in this repo)kind/designA design proposal (design-architect): multi-step, phased, decision-bearingqueue/parkedQueue task is parked (waiting on CI, time, or an event)status/parkedDeliberately paused with a recorded resume conditiontask/triageQueue packet kind: verify, reproduce, and route this itemwork/assignedQueue worker lifecycle state

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions