aaronrene / overseer-kit public
docs ONS-a feat/ons-operator-next-surfacing #3 / 3
aaronrene · 21 days ago · Aug 12, 2026 · Diff

docs(ONS-a): freeze operator NEXT surfacing (ok next + print-on-closeout)

Portable contract for printing the paste-ready fence from disk so operators are not stuck on a stale IDE tab. Spec-only; Auto is ONS-b. No main merge.

sha256:bc460a2ba03f4e1f3c1f7d1979e688bed71b1bca9fc5beea6bf0cd6473347914 sha
sha256:da152124438b2e85d903916a293aa652c996bdbb93b7420ae0d3792f951c7642 parent
+59 ~14 −7 symbols
sha256:436d9570a52df11d5e8850f77001027e69ed50caca406fc6554ea5b6b799404c snapshot
+59
symbols added
~14
symbols modified
−7
symbols removed
0
dead code introduced
Semantic Changes 80 symbols
~ docs/archive/phases/PHASE-ONS-OPERATOR-NEXT-SURFACING.md .md 52 symbols added
+ Phase ONS — Operator NEXT surfacing (portable + optional host niceties) section Phase ONS — Operator NEXT surfacing (portable + optional host niceties) L1–531
+ code[yaml] variable variable code[yaml] L6–46
+ table section table L57–61
+ 0 — Simple summary section §ONS.0 — Simple summary L64–86
+ 1 — Verified problem (do not redesign) section §ONS.1 — Verified problem (do not redesign) L86–103
+ table section table L88–100
+ 10 — Name collision table section §ONS.10 — Name collision table L419–432
+ table section table L421–427
+ 11 — Security / privacy section §ONS.11 — Security / privacy L432–447
+ 12 — Seven-tier test matrix (ONS-b) section §ONS.12 — Seven-tier test matrix (ONS-b) L447–461
+ table section table L449–458
+ 13 — Definition of Done (ONS-b) section §ONS.13 — Definition of Done (ONS-b) L461–477
+ 14 — Hard stops section §ONS.14 — Hard stops L477–489
+ 15 — Auto paste (ONS-b) — frozen for handover after ONS-a pass section §ONS.15 — Auto paste (ONS-b) — frozen for handover after ONS-a pass L489–521
+ code[text] variable variable code[text] L491–518
+ 16 — Cross-references section §ONS.16 — Cross-references L521–531
+ 2 — Scope section §ONS.2 — Scope L103–136
+ table section table L114–127
+ One living handover path (invariant) section §ONS.3 — A1. One living handover path (invariant) L136–149
+ Closeout still updates both docs (existing SD-17) section §ONS.4 — A2. Closeout still updates both docs (existing SD-17) L149–158
+ CLI: ok next (canonical) + --print-next (synonym) section §ONS.5 — A3. CLI: ok next (canonical) + --print-next (synonym) L158–282
+ 1 — Surfaces section §ONS.5.1 — Surfaces L160–174
+ table section table L162–171
+ 2 — Module + wiring (exact paths) section §ONS.5.2 — Module + wiring (exact paths) L174–184
+ table section table L176–183
+ 3 — Frozen heading section §ONS.5.3 — Frozen heading L184–194
+ code variable variable code L188–191
+ 4 — Human stdout (exit 0) section §ONS.5.4 — Human stdout (exit 0) L194–214
+ 5 — --json stdout (exit 0) section §ONS.5.5 — --json stdout (exit 0) L214–235
+ code[json] variable variable code[json] L218–228
+ 6 — Exit codes section §ONS.5.6 — Exit codes L235–249
+ table section table L237–243
+ 7 — Fail-closed reasons (closed vocabulary) section §ONS.5.7 — Fail-closed reasons (closed vocabulary) L249–265
+ table section table L253–261
+ 8 — Flags section §ONS.5.8 — Flags L265–282
+ table section table L269–273
+ Skill + alwaysApply rule (Cursor and Claude Code) section §ONS.6 — A4. Skill + alwaysApply rule (Cursor and Claude Code) L282–330
+ 1 — Deliverable paths section §ONS.6.1 — Deliverable paths L284–295
+ table section table L286–290
+ 2 — Frozen skill/rule obligations (normative text) section §ONS.6.2 — Frozen skill/rule obligations (normative text) L295–318
+ 3 — Also touch (additive one-liners, not a second protocol) section §ONS.6.3 — Also touch (additive one-liners, not a second protocol) L318–330
+ table section table L320–327
+ Copilot / other assistants section §ONS.7 — A5. Copilot / other assistants L330–353
+ table section table L332–338
+ Operator source of truth order (frozen) section §ONS.8 — A6. Operator source of truth order (frozen) L353–365
+ Optional host niceties (non-blocking) section §ONS.9 — B. Optional host niceties (non-blocking) L365–419
+ 1 — Cursor section §ONS.9.1 — Cursor L371–401
+ table@L373 section table@L373 L373–378
+ table@L381 section table@L381 L381–385
+ 2 — Claude Code section §ONS.9.2 — Claude Code L401–407
+ 3 — Copilot section §ONS.9.3 — Copilot L407–412
+ 4 — Honesty sentence (must appear in freeze, skill, PRINT-NEXT, cursor README) section §ONS.9.4 — Honesty sentence (must appear in freeze, skill, PRINT-NEXT, cursor README) L412–419
~ docs/OVERSEER-HANDOVER.md .md 7 symbols added, 7 symbols removed, 9 symbols modified
− NEXT SESSION — Public repository visibility flip section NEXT SESSION — Public repository visibility flip L11–62
− Paste-ready prompt — Public visibility flip section Paste-ready prompt — Public visibility flip L37–62
− code[text] variable variable code[text] L39–58
− THE ONE NEXT STEP — Model: Operator + Auto section THE ONE NEXT STEP — Model: Operator + Auto L23–37
− table section table L27–34
− What just landed section What just landed L17–23
− table section table L19–22
+ NEXT SESSION — ONS-b Operator NEXT surfacing build section NEXT SESSION — ONS-b Operator NEXT surfacing build L11–70
+ Paste-ready prompt — ONS-b section Paste-ready prompt — ONS-b L37–70
+ code[text] variable variable code[text] L39–66
+ THE ONE NEXT STEP — Model: Auto section THE ONE NEXT STEP — Model: Auto L23–37
+ table section table L27–34
+ What just landed section What just landed L17–23
+ table section table L19–22
~ 🆗 Overseer Kit — overseer-kit
~ Change log
~ Handover regeneration rules (SD-3, SD-17)
~ What just landed
~ table
~ VCS (verified 2026-08-04)
~ table
~ Verified snapshot
~ table
~ docs/ROADMAP.md .md 5 symbols modified
~ Overseer Kit — Roadmap
~ Build queue
~ table
~ Cross-references
~ Next step at a glance
← Older Oldest on feat/ons-operator-next-surfacing
All commits Newer feat(ons): ok next print-on-closeout (ONS-b) sha256:0a9bbb60949ef5f1a33bfee414da7b54d490f870ea30cb0f0abeae90e9599648

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:bc460a2ba03f4e1f3c1f7d1979e688bed71b1bca9fc5beea6bf0cd6473347914 --body "your comment"