Files

T

ci/woodpecker/pr/ci Pipeline was successful

Details

docs(fleet): tier the north star, declare the tier-0 operator surface

Add a capability tier orthogonal to phase. `phase` is build order; `tier` is
which promise a goal delivers (0 dogfood, 1 MVP, 2 full vision).

- AC-NS-0: a tier-0 exit test that can fail. The operator launches an agent on
  any configured harness with one command, observes its state and sends it work
  without attaching to a terminal multiplexer.
- `tier` on every goal and success criterion. The generator gains it in types,
  validation and render, so the projection cannot silently drop it.
- NS-10: an adoption is not complete until the mechanism it replaces is removed.
- Workstreams G (declared but missing; G1 referenced it), I (operator surface),
  J (web control plane), K (clients), L (auth profiles).
- Goals A5 and I1-I9 seeded at tier 0, dependency ordered.
- docs/fleet/north-star.md renamed FLEET-DOCTRINE.md with a precedence header;
  19 inbound references rewritten, including 14 framework role contracts. The
  old name sat one character from NORTH_STAR.md.
- docs/TASKS.md, docs/federation/TASKS.md and docs/fleet/TASKS.md carry
  superseded headers. docs/native-kanban-sot/TASKS.md is corrected instead: it
  advertised a blocker that was not real.
- Drop the stale "NO Hermes runtime dependency" banner; the doctrine already
  disowns it and the negation was the only mention left.

Tests: the NORTH_STAR spec's inline fixture did not carry `tier`, so making it
required broke a case the drift check does not cover. Fixture updated. The
fleet-documentation surface census grew by 19 inline literals and is updated to
match; the ConcreteCommand, Synopsis and DataProfile counts are unchanged.

Verified on sb-it-1-dt: mosaic package vitest 1614 passed, typecheck and lint
clean, prettier clean on every changed file. Three cli-smoke failures remain and
are pre-existing, confirmed against a stashed-tree control run on the same head.

2026-08-20 17:30:54 -05:00

5.2 KiB

Raw Blame History

Tasks — W-FLEET (Fleet) Phase 2: Observability

STATUS: SUPERSEDED — 2026-08-20. kind tracking · superseded by docs/fleet/NORTH_STAR.yaml

This file is the pre-backlog tracking mechanism. NS-2 in the north star declares the replacement: every backlog item is a Mosaic Backlog card projected from the YAML. That model replaced this one and nobody retired the old file, so it kept reading as authoritative while going stale.

Do not trust a status in this file. Verified 2026-08-20: it was already behind the code when it froze five weeks ago. The FLEET-OBS series was the one thing worth salvaging and is now carried as goals I2, I3, I6 and I7 at tier 0.

Kept as a record of what was believed. Do not update it; update the YAML.

Workstream task file for the Fleet. Single-writer: Fleet workstream lead (orchestrator). Workers read but never modify. This is not the MVP rollup (docs/TASKS.md) — a rollup row is proposed to the MVP orchestrator, not written here.

Mission: mvp-20260312 · PRD: docs/fleet/PRD.md · North star: docs/fleet/FLEET-DOCTRINE.md Status: not-started | in-progress | done | blocked | failed

id	status	description	depends_on	agent	pr	notes
FLEET-OBS-000	done	Plan: north-star + Phase-2 PRD + workstream scaffolding	—	lead	—	persisted 2026-06-20 on `feat/fleet-observability`
FLEET-OBS-001	done	Heartbeat protocol v1 spec finalized in PRD + framework doc	FLEET-OBS-000	lead	—	file-based ~/.config/mosaic/fleet/run/.hb; spec in PRD
FLEET-OBS-002	in-progress	Implement heartbeat responder in `dogfood-agent.py`	FLEET-OBS-001	fleet-coder	—	dispatched to ad-hoc mosaic yolo fleet agent (dogfood)
FLEET-OBS-003	done	mosaic fleet ps — join systemd+tmux+proc+idle+heartbeat; tenant+host tagged; drift + boot-enable flags; `--json`	FLEET-OBS-001	worker	—	commit ab47831; LIVE-verified on mosaic-fleet; caught canary-pi DRIFT + BOOT-ENABLE. Polish: idleSeconds parse returns null
FLEET-OBS-004	done	mosaic agent watch — read-only join (no resize, no keystrokes)	FLEET-OBS-000	worker	—	attach -r; verb wired
FLEET-OBS-005	done	mosaic agent send --verify — delivery/acceptance receipt	FLEET-OBS-000	worker	—	--verify flag; draft-heuristic verify
FLEET-OBS-006	done	CLI specs for ps/watch/send-verify (tenant+host shape, command construction)	FLEET-OBS-003,004,005	worker	—	62 tests green (31 new); re-verified by lead
FLEET-OBS-007	not-started	Framework doc: fleet observability guide + verbs	FLEET-OBS-003,004,005	lead	—	`docs/guides/` or `framework/tools/.../README`
FLEET-OBS-008	not-started	Independent review + dogfood verification on live fleet	FLEET-OBS-002..007	reviewer	—	author ≠ reviewer; capture evidence in scratchpad
FLEET-OBS-009	not-started	Open PR → green CI (queue guard) → squash-merge → close `fleet-observability-1`	FLEET-OBS-008	lead	—	trunk merge; no direct push to main

Proposed MVP rollup row (for the MVP orchestrator — not written by this workstream)

| W-FLEET | in-progress | Fleet (agent-session execution layer) | Phase 2/5 | docs/fleet/TASKS.md | observability dogfooded on live stub fleet; control plane rides federation (W1) |

5.2 KiB Raw Blame History

Tasks — W-FLEET (Fleet) Phase 2: Observability

Proposed MVP rollup row (for the MVP orchestrator — not written by this workstream)

5.2 KiB

Raw Blame History