Files
stack/docs/scratchpads/north-star-doctrine.md
Jason Woltje 6186c6dd23
Some checks failed
ci/woodpecker/push/ci Pipeline was canceled
ci/woodpecker/pr/ci Pipeline was canceled
docs(fleet): consolidate north-star doctrine — budget governance + control plane + identity (#620-adjacent)
Folds Mos's two consolidated drafts (budgeting/200k/delegation + control-plane/
central-register) into docs/fleet/north-star.md as ONE conflict-free PR per the
merge-map. Doctrine only — no implementation.

- Stack table: +Central register (Postgres fleet schema) + Budget/spend governance
  rows; PoC-socket-hygiene note.
- New '## Budget & token governance': even-spread pacing (Jason override), hard-cap
  downgrade→queue→refuse ladder, multi-sub auto-routing, historical spend learning,
  #558 budget CLI UX; + TTY OPS INVARIANT note.
- New '## Control plane & central register': Postgres fleet schema, gateway-API-only
  access, dispatcher = @mosaicstack/forge pipeline engine + thin forge-exec adapter
  (NOT a new daemon), register backs forge, 'board' role = forge BOD.
- Phased roadmap 4/5 annotated; Decisions of record (2026-06-22) extended (200k cap,
  worker bound #8, delegation discipline, budget governance, spend mandate, unified
  identity = Fleet, role-based session naming) + control-plane subgroup.
- Future enhancements: Matrix-on-local-homeserver future transport (F4) + tmux
  attack-surface hardening. Assumptions extended.

Tracked separately / out of scope: #622 (spend template std), #623 (telemetry
product), #625 (tenant_id schema), #628 (forge-exec adapter).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
2026-06-22 15:03:14 -05:00

1.8 KiB

north-star doctrine consolidation (#620-adjacent doc PR)

  • Branch: feat/north-star-doctrine (off main). Source: Mos's consolidated handoff + 2 drafts (budgeting/200k/delegation + control-plane). ONE conflict-free PR per the merge-map.

Applied (merge-map, in order)

  1. Stack table: +2 rows (Central register, Budget/spend governance) after Control plane + PoC-socket-hygiene note.
  2. ## Budget & token governance after Invariants (even-spread pacing [Jason override], hard-cap ladder, multi-sub auto-routing, historical learning, #558 CLI UX) + TTY OPS INVARIANT note.
  3. ## Control plane & central register after Observation model (Postgres fleet schema, gateway-API access, dispatcher = forge pipeline engine + forge-exec adapter [NOT a daemon], register backs forge, board = forge BOD).
  4. Phased roadmap Phase 4/5 annotated (fleet schema migration + forge-exec; central register live).
  5. Decisions of record (2026-06-22): doctrine §1(c) bullets (200k cap, worker bound #8, delegation, budget, spend mandate, unified identity Fleet, role-based session naming) + control-plane 6c ### Control plane & central register subgroup.
  6. Future enhancements: Matrix-future-transport (#10, F4 IS Matrix) + tmux security hardening (§5).
  7. Assumptions: doctrine §1(d) (3) + control-plane 6e (1) + release-procedure note + tracked-separately note.

Conflict checklist: all ✓

1 Decisions-2026-06-22; order Invariants→Budget→Observation→Control plane→Roadmap; 2 stack rows; even-spread (no opportunistic/HOLD); control-plane UNHELD; forge-exec = tracked #628 post-PoC; §7 drift re-captures all present (#8/#10/#558/TTY/release).

Out of scope (cited in doc + PR): #622 (spend template std), #623 (telemetry product), #625 (tenant_id schema), #628 (forge-exec adapter). Doctrine only — no implementation.