mosaicstack/stack
1
0
Fork 1
Code Issues 200 Pull Requests 10 Actions Packages Projects Releases 15 Wiki Activity

docs(fleet): consolidate north-star doctrine (budget + control plane + identity) #629

Merged
jason.woltje merged 2 commits from feat/north-star-doctrine into main 2026-06-22 21:08:42 +00:00
Conversation 0 Commits 2 Files Changed 3
+263 -15
2 Commits
Author SHA1 Message Date
jason.woltjeandClaude Opus 4.8 9cb0f33696 docs(fleet): north-star socket refs → mosaic-fleet (brand-consistent)
ci/woodpecker/pr/ci Pipeline was successful
Details
ci/woodpecker/push/ci Pipeline was successful
Details 
Reconciles the doctrine with the socket rename (#630): the production-isolation
socket is mosaic-fleet (matches the product brand). mosaic-factory now appears
only where it legitimately describes the LEGACY dogfood canary (pending
migration). Adjusts the PoC-socket-hygiene note + the unified-identity note.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
 2026-06-22 15:16:30 -05:00
jason.woltjeandClaude Opus 4.8 6186c6dd23 docs(fleet): consolidate north-star doctrine — budget governance + control plane + identity (#620-adjacent)
ci/woodpecker/push/ci Pipeline was canceled
Details
ci/woodpecker/pr/ci Pipeline was canceled
Details 
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 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
 2026-06-22 15:03:14 -05:00