Skip to content

docs(product): port spawn-control design record from orion (SEA-1361) - #233

Open
seal-agent wants to merge 2 commits into
mainfrom
compass-spawn-control-port
Open

docs(product): port spawn-control design record from orion (SEA-1361)#233
seal-agent wants to merge 2 commits into
mainfrom
compass-spawn-control-port

Conversation

@seal-agent

Copy link
Copy Markdown
Contributor

Ports the frozen orion Bridge-UI spawn-control record (orion #884) into compass as docs/designs/product/compass-spawn-control/design.md, with Matt-ruled amendments:

  • Stop premise updated: compass ships a real stopAgent() (store.ts:1816-1849, awaits stopAgentSession); all stop-is-a-stub statements rewritten and stop-side tasks reframed as hardening.
  • Posture amended (DL-165): live-wired against the shipped AppStoreOptions seam; orion's walking-skeleton lane + stacked T6 dissolved into T2/T4.
  • DL renumber: orion DL-053..060 re-expressed as DL-164..DL-171; rows appended to DECISIONS.md.
  • Distinctness note vs the agent-facing compass-agent-spawn-despawn record.
  • All code citations re-grounded against current compass main (SEA-1527 repo-less provisioning already shipped; the orion T0 self-clone reconciliation dropped from scope).

One port-level Open Question parked for review (OQ-P1, non-blocking): the DL-165 posture amendment supersedes orion's walking-skeleton ruling because its premises no longer hold in compass; recommendation is to ratify DL-165, with the fixture-first fallback noted if preferred.

Ledger-impact: adds DL-164..DL-171 (net-new, no supersessions).
Spec-impact: none. The wire/spec reconciliation (SpawnAgent RPC + agent_account_id field + one-container SHALL) lands in the T0 impl PR, per the record's Spec impact section.

Refs SEA-1361

Co-authored-by: Matt Wilkinson matt@sealedsecurity.com

@linear-code

linear-code Bot commented Aug 8, 2026

Copy link
Copy Markdown

SEA-1361

seal-agent and others added 2 commits August 7, 2026 21:09
Ports the frozen orion Bridge-UI spawn-control record (orion #884) into compass as `docs/designs/product/compass-spawn-control/design.md`, with Matt-ruled amendments:

- Stop premise updated: compass ships a real `stopAgent()` (store.ts:1816-1849, awaits `stopAgentSession`); all stop-is-a-stub statements rewritten and stop-side tasks reframed as hardening.
- Posture amended (DL-165): live-wired against the shipped `AppStoreOptions` seam; orion's walking-skeleton lane + stacked T6 dissolved into T2/T4.
- DL renumber: orion DL-053..060 re-expressed as DL-164..DL-171; rows appended to DECISIONS.md.
- Distinctness note vs the agent-facing `compass-agent-spawn-despawn` record.
- All code citations re-grounded against current compass main (SEA-1527 repo-less provisioning already shipped; the orion T0 self-clone reconciliation dropped from scope).

One port-level Open Question parked for review (OQ-P1, non-blocking): the DL-165 posture amendment supersedes orion's walking-skeleton ruling because its premises no longer hold in compass; recommendation is to ratify DL-165, with the fixture-first fallback noted if preferred.

Ledger-impact: adds DL-164..DL-171 (net-new, no supersessions).
Spec-impact: none. The wire/spec reconciliation (SpawnAgent RPC + agent_account_id field + one-container SHALL) lands in the T0 impl PR, per the record's Spec impact section.

Refs SEA-1361

Co-authored-by: Matt Wilkinson <matt@sealedsecurity.com>
Review fix on the compass-spawn-control port (PR #233), no design change.

The DL-165 ledger row read `Active (Matt, 2026-08-07)`, attributing an affirmative Matt ruling on the port day, while the record's own OQ-P1 parks DL-165 for Matt's ratification. The ledger's Status grammar (compass-design-ledger gate) admits only `Active (<who>, date)` or `Superseded by DL-<n> (<who>, date)`, so the fix keeps `Active` — the record does build against this posture — but corrects <who> to `compass port amendment` instead of `Matt`, and moves the parked-ratification note into the decision text (`; parked for Matt's ratification (OQ-P1)`). The frozen ledger no longer claims a Matt ruling that OQ-P1 still puts to him; the decision content is unchanged.

Spec-impact: none. Refs SEA-1361

Co-authored-by: Matt Wilkinson <matt@sealedsecurity.com>
@seal-agent
seal-agent force-pushed the compass-spawn-control-port branch from 26ae64f to d69d418 Compare August 8, 2026 01:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant