mosaicstack/stack
1
0
Fork 0
Code Issues 32 Pull Requests 3 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
jason.woltje commented 2026-06-22 20:03:49 +00:00
Owner
Copy Link

docs(fleet): consolidate north-star doctrine — ONE conflict-free PR

Folds Mos's two consolidated drafts (budgeting/200k/delegation + control-plane/central-register) into docs/fleet/north-star.md as a single conflict-free PR per the handoff merge-map. Doctrine only — no implementation.

Applied (in merge-map order)

  1. Stack table — +Central register (Postgres fleet schema) and +Budget / spend governance rows after Control plane; PoC-socket-hygiene note.
  2. ## Budget & token governance (after Invariants) — even-spread pacing (Jason override), hard-cap downgrade→queue→refuse ladder, multi-sub auto-routing, historical spend learning, #558 budget CLI UX; + a TTY OPS INVARIANT note.
  3. ## Control plane & central register (after Observation model) — 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.
  4. Phased roadmap Phase 4/5 annotated (fleet schema migration + forge-exec; central register live).
  5. 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 (the orchestrator's late addition) + a ### Control plane & central register subgroup (date prefix dropped — parent ## carries it).
  6. Future enhancements — Matrix-on-local-homeserver future transport (F4 IS Matrix) + tmux attack-surface hardening.
  7. Assumptions extended + release-procedure note.

Conflict checklist — all ✓

Exactly 1 ## Decisions of record (2026-06-22); section order Invariants → Budget → Observation → Control plane → Roadmap; exactly 2 new stack rows; pacing reads EVEN-SPREAD (no "opportunistic"/"HOLD"); control-plane UNHELD (forge reconciliation applied); forge-exec is tracked #628, post-PoC, not built here; §7 drift re-captures all present (#8 / #10 / #558 / TTY / release).

Tracked separately — out of scope for this PR

#622 (PRD/mission/task projected+actual-spend template standard) · #623 (anonymized telemetry → mosaicstack.dev product) · #625 (tenant_id roster-schema field) · #628 (forge-exec TaskExecutor adapter).

Docs-only → cheap under #619 (0 image builds).

🤖 Generated with Claude Code

## docs(fleet): consolidate north-star doctrine — ONE conflict-free PR Folds Mos's **two** consolidated drafts (budgeting/200k/delegation + control-plane/central-register) into `docs/fleet/north-star.md` as a single conflict-free PR per the handoff merge-map. **Doctrine only — no implementation.** ### Applied (in merge-map order) 1. **Stack table** — +`Central register` (Postgres `fleet` schema) and +`Budget / spend governance` rows after Control plane; PoC-socket-hygiene note. 2. **`## Budget & token governance`** (after Invariants) — even-spread pacing (**Jason override**), hard-cap **downgrade→queue→refuse** ladder, multi-sub auto-routing, historical spend learning, **#558** budget CLI UX; + a **TTY OPS INVARIANT** note. 3. **`## Control plane & central register`** (after Observation model) — 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**. 4. **Phased roadmap** Phase 4/5 annotated (`fleet` schema migration + `forge-exec`; central register live). 5. **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** (the orchestrator's late addition) + a `### Control plane & central register` subgroup (date prefix dropped — parent `##` carries it). 6. **Future enhancements** — Matrix-on-local-homeserver future transport (**F4 IS Matrix**) + tmux attack-surface hardening. 7. **Assumptions** extended + release-procedure note. ### Conflict checklist — all ✓ Exactly **1** `## Decisions of record (2026-06-22)`; section order Invariants → Budget → Observation → Control plane → Roadmap; exactly **2** new stack rows; pacing reads **EVEN-SPREAD** (no "opportunistic"/"HOLD"); control-plane **UNHELD** (forge reconciliation applied); `forge-exec` is tracked **#628**, post-PoC, **not built here**; §7 drift re-captures all present (#8 / #10 / #558 / TTY / release). ### Tracked separately — out of scope for this PR **#622** (PRD/mission/task projected+actual-spend template standard) · **#623** (anonymized telemetry → mosaicstack.dev product) · **#625** (`tenant_id` roster-schema field) · **#628** (`forge-exec` TaskExecutor adapter). Docs-only → cheap under #619 (0 image builds). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jason.woltje added 1 commit 2026-06-22 20:03:50 +00:00
docs(fleet): consolidate north-star doctrine — budget governance + control plane + identity (#620-adjacent)
Some checks failed
ci/woodpecker/push/ci Pipeline was canceled
Details
ci/woodpecker/pr/ci Pipeline was canceled
Details
6186c6dd23 
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
jason.woltje added 1 commit 2026-06-22 20:16:41 +00:00
docs(fleet): north-star socket refs → mosaic-fleet (brand-consistent)
All checks were successful
ci/woodpecker/pr/ci Pipeline was successful
Details
ci/woodpecker/push/ci Pipeline was successful
Details
9cb0f33696 
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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
jason.woltje merged commit 3f69d45334 into main 2026-06-22 21:08:42 +00:00
jason.woltje deleted branch feat/north-star-doctrine 2026-06-22 21:08:43 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
fleet-enhancement
Fleet-wide reliability/speed/cost improvements surfaced by the nightly enhance pass
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#629
Delete Branch "feat/north-star-doctrine"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?