feat(fleet): add machine-readable NORTH_STAR.yaml + Markdown projection #656

jason.woltje · 2026-06-24T14:20:30Z

jason.woltje commented

2026-06-24 14:20:30 +00:00

Card A1

Single machine-readable source of truth for fleet planning plus a deterministic Markdown projection. Self-contained Mosaic — no Hermes.

What

docs/fleet/NORTH_STAR.yaml — mission, substrate note (native Postgres storage service: @mosaicstack/db drizzle, PGlite-embedded default / full Postgres by config — the Mosaic Backlog of record, NOT Hermes), NS-1..NS-8 standing objectives, AC-NS-1..AC-NS-5 success criteria, workstreams A..F, seeded goal backlog (A1, A2, A3a, A3b, A4, B1, B2, B3a, B3b, G1) with a coherent depends_on DAG, vetoable assumptions, advisory spend block.
packages/mosaic/src/commands/fleet.ts — parseNorthStar, renderNorthStarMarkdown (pure deterministic projection, prettier-aligned tables → round-trip stable), generateNorthStarMarkdown/resolveNorthStarPaths (the only IO). No network, no CLI, no clock.
docs/fleet/NORTH_STAR.md — generated by running the generator.
packages/mosaic/src/commands/fleet-north-star.spec.ts — YAML parses + reuses ids, NS-/AC-NS- present, DAG coherent, projection deterministic and byte-matches the committed .md, no network/CLI.

Gates

typecheck, lint, format:check (prettier) — green
vitest: 567 passed (40 files), incl. 16 new NORTH_STAR specs

🤖 Generated with Claude Code

## Card A1 Single machine-readable source of truth for fleet planning plus a deterministic Markdown projection. Self-contained Mosaic — no Hermes. ### What - `docs/fleet/NORTH_STAR.yaml` — mission, substrate note (native Postgres storage service: `@mosaicstack/db` drizzle, PGlite-embedded default / full Postgres by config — the Mosaic Backlog of record, NOT Hermes), NS-1..NS-8 standing objectives, AC-NS-1..AC-NS-5 success criteria, workstreams A..F, seeded goal backlog (A1, A2, A3a, A3b, A4, B1, B2, B3a, B3b, G1) with a coherent `depends_on` DAG, vetoable assumptions, advisory spend block. - `packages/mosaic/src/commands/fleet.ts` — `parseNorthStar`, `renderNorthStarMarkdown` (pure deterministic projection, prettier-aligned tables → round-trip stable), `generateNorthStarMarkdown`/`resolveNorthStarPaths` (the only IO). No network, no CLI, no clock. - `docs/fleet/NORTH_STAR.md` — generated by running the generator. - `packages/mosaic/src/commands/fleet-north-star.spec.ts` — YAML parses + reuses ids, NS-*/AC-NS-* present, DAG coherent, projection deterministic and byte-matches the committed `.md`, no network/CLI. ### Gates - typecheck, lint, format:check (prettier) — green - vitest: 567 passed (40 files), incl. 16 new NORTH_STAR specs 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jason.woltje added 1 commit 2026-06-24 14:20:30 +00:00

feat(fleet): add machine-readable NORTH_STAR.yaml + Markdown projection

ci/woodpecker/pr/ci Pipeline was successful

Details

ci/woodpecker/push/ci Pipeline was successful

Details

cd80ca1025

Add docs/fleet/NORTH_STAR.yaml as the single machine-readable source of
truth for fleet planning, plus a pure, deterministic generator in
fleet.ts that projects it to docs/fleet/NORTH_STAR.md. The Markdown is a
projection (regenerate, do not hand-edit).

Self-contained Mosaic: the substrate names the native Postgres storage
service (@mosaicstack/db drizzle; PGlite-embedded by default, full
Postgres by config) as the backlog of record. No Hermes runtime
dependency.

- NORTH_STAR.yaml: mission, substrate, NS-1..NS-8 standing objectives,
  AC-NS-1..AC-NS-5 success criteria, workstreams A..F, seeded goal
  backlog (A1,A2,A3a,A3b,A4,B1,B2,B3a,B3b,G1) with depends_on DAG,
  vetoable assumptions, advisory spend block.
- parseNorthStar/renderNorthStarMarkdown/generateNorthStarMarkdown:
  pure parse + projection (no network/CLI/clock); writer is the only IO.
  Tables column-padded to stay prettier-clean and round-trip stable.
- fleet-north-star.spec.ts: YAML validates + reuses ids, NS-*/AC-NS-*
  present, depends_on DAG coherent, projection deterministic and matches
  the committed .md, no network/CLI.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

jason.woltje merged commit 61b1bdac2a into main

2026-06-24 14:40:09 +00:00

jason.woltje referenced this issue from a commit

2026-06-24 14:40:11 +00:00

feat(fleet): add machine-readable NORTH_STAR.yaml + Markdown projection (#656)

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: mosaicstack/stack#656