stack/docs/TASKS.md

Tasks — MVP (Top-Level Rollup)

Single-writer: orchestrator only. Workers read but never modify.

Mission: mvp-20260312 Manifest: docs/MISSION-MANIFEST.md

This file is a rollup. Per-workstream task breakdowns live in workstream task files (e.g. docs/federation/TASKS.md). Workers operating inside a workstream should treat the workstream file as their primary task source; this file exists for orchestrator-level visibility into MVP-wide state.

Status values: not-started | in-progress | done | blocked | failed

Workstream Rollup

id	status	workstream	progress	tasks file	notes
W1	planning-complete	Federation v1 (FED)	0 / 7 milestones	docs/federation/TASKS.md	M1 task breakdown populated; M2–M7 deferred to mission planning
W2	planning-complete	Tess interaction agent	0 / 5 milestones	docs/tess/TASKS.md	Issue #706; independent planning gate PASS; M1 issue #707 ready
W3	planning-complete	Native Kanban/SOT	0 / 4 phases	docs/native-kanban-sot/TASKS.md	Issue #751; canon independently approved; implementation held until canon merges
W4	planning-complete	Fleet configuration management	0 / 12 cards	This file (§ Fleet configuration management #758)	Issue #758; M0 docs gate defines the implementation DAG before any fleet mutation

Cross-Cutting Tracking

These are MVP-level checks that don't belong to any single workstream. Updated by the orchestrator at each session.

id	status	description	notes
MVP-T01	done	Author MVP-level manifest at docs/MISSION-MANIFEST.md	This session (2026-04-19); PR pending
MVP-T02	done	Archive install-ux-v2 mission state to docs/archive/missions/install-ux-v2-20260405/	IUV-M03 retroactively closed (shipped via PR #446 + releases 0.0.27→0.0.29)
MVP-T03	done	Land federation v1 planning artifacts on main	PR #468 merged 2026-04-19 (commit 66512550)
MVP-T04	not-started	Sync .mosaic/orchestrator/mission.json MVP slot with this manifest (milestone enumeration, etc.)	Coord state file; consider whether to repopulate via mosaic coord or accept hand-edit
MVP-T05	in-progress	Kick off W1 / FED-M1 — federated tier infrastructure	Session 16 (2026-04-19): FED-M1-01 in-progress on feat/federation-m1-tier-config
MVP-T06	not-started	Declare additional workstreams (web dashboard, TUI/CLI parity, remote control, etc.) as scope solidifies	Track each new workstream by adding a row to the Workstream Rollup
T-A292E96F	in-progress	Fix Mosaic Gitea PR metadata/login wrapper regression for U-Connect merge preflight	Kanban t_a292e96f; branch fix/t-a292e96f-gitea-pr-metadata; scratchpad docs/scratchpads/t-a292e96f-gitea-pr-metadata.md

Pointer to Active Workstream

Active workstream is W1 — Federation v1. Workers should:

1. Read docs/federation/MISSION-MANIFEST.md for workstream scope
2. Read docs/federation/TASKS.md for the next pending task
3. Follow per-task agent + tier guidance from the workstream manifest

Fleet configuration management (#758) — M0–M5 implementation DAG

PRD: Fleet declarative configuration management · M0 acceptance: docs IA checklist · baseline dispositions: legacy example/profile inventory

Every row below is one independently reviewable card and one PR. depends_on is a hard DAG edge; no card may silently absorb another card's scope. All source cards require the repository quality gates, independent code and security review, terminal-green CI, and the applicable acceptance evidence before merge. Issue #758 remains open until M5 closes.

id	status	description	issue	agent	repo	branch	depends_on	estimate	notes
FCM-M0-001	in-progress	Publish normative PRD requirements/acceptance criteria, this M0–M5 DAG, docs-IA checklist, and legacy example/profile disposition inventory; no implementation changes	#758	sonnet	mosaicstack/stack	docs/758-fleet-config-management	—	18K	M0 exit: approved docs; every shipped example/profile classified; docs-only PR
FCM-M1-001	not-started	Implement narrow local-tmux v2 roster structural contract/compiler with YAML/JSON canonicalization and schema/parser parity tests	#758	codex	mosaicstack/stack	feat/758-roster-v2-compiler	FCM-M0-001	30K	No lifecycle, remote, connector, secret, channel, or gateway work
FCM-M1-002	not-started	Reuse existing profile/persona/provision resolver for roster semantics; add canonical class/authority validation and approved aliases	#758	codex	mosaicstack/stack	feat/758-shared-role-resolution	FCM-M0-001	25K	Validator is certificate-only; merge-gate remains sole merge authority
FCM-M1-003	not-started	Convert the M0 legacy inventory into executable example/profile validation and explicit v1-version/retirement checks	#758	codex	mosaicstack/stack	test/758-example-profile-dispositions	FCM-M1-001, FCM-M1-002	20K	Every shipped file must validate, be versioned v1, or be retired with replacement
FCM-M2-001	not-started	Migrate generic launch chain to deterministic .env.generated plus strict data-only .env.local; quarantine forbidden legacy keys	#758	codex	mosaicstack/stack	feat/758-generated-env-boundary	FCM-M1-001, FCM-M1-002	30K	No arbitrary command compatibility path; diagnostics expose key names/hashes only
FCM-M2-002	not-started	Add generation-guarded local fleet agent create/get/update/delete mutations with plan/dry-run, atomic roster writes, and recovery output	#758	codex	mosaicstack/stack	feat/758-fleet-agent-crud	FCM-M1-001, FCM-M2-001	30K	Fresh create persists stopped unless explicit persisted start
FCM-M3-001	not-started	Implement local roster-owned reconcile/apply plus lifecycle/status/verify/doctor contracts and stable JSON/exit codes	#758	codex	mosaicstack/stack	feat/758-local-reconciler	FCM-M2-001, FCM-M2-002	35K	Exact systemd/tmux ownership; remote/schema-only entries are inventory only
FCM-M3-002	not-started	Add isolated systemd/tmux lifecycle, drift, socket, unmanaged-session, crash, and rollback acceptance coverage	#758	sonnet	mosaicstack/stack	test/758-reconciler-lifecycle-gates	FCM-M3-001	25K	Proves stopped-state preservation and zero fuzzy destructive targeting
FCM-M4-001	not-started	Implement field-complete v1-to-v2 inventory/preview/migrator with alias, lifecycle, env-quarantine, and remote/connector disposition evidence	#758	codex	mosaicstack/stack	feat/758-v1-v2-migrator	FCM-M1-003, FCM-M3-001	35K	Preview first; no unreviewed lifecycle inference
FCM-M4-002	not-started	Add reversible canary migration, rollback, stale-projection/orphan classification, and current-host 9-managed/3-unmanaged fixture coverage	#758	sonnet	mosaicstack/stack	test/758-migration-rollback-gates	FCM-M4-001, FCM-M3-002	25K	Never starts a previously stopped agent or kills an unproven unmanaged session
FCM-M5-001	not-started	Deliver the accepted fleet documentation IA, how-to/operations/migration references, and link/example validation	#758	haiku	mosaicstack/stack	docs/758-fleet-config-operator-docs	FCM-M1-003, FCM-M2-002, FCM-M3-001, FCM-M4-001	24K	Must close every checklist item or record an approved deferral
FCM-M5-002	not-started	Package/update asset-drift checks, rolling local canary, independent validation certificate, and release evidence	#758	sonnet	mosaicstack/stack	feat/758-fleet-config-release-gate	FCM-M3-002, FCM-M4-002, FCM-M5-001	30K	Final #758 gate: quality, independent code/security review, validator certificate, merge-gate approval, green CI

Thin-core prompt diet (#528) — feat/contract-thin-core

• Status: PR open, awaiting maintainer merge ratification (fleet-governing change).
• Cut always-injected contract AGENTS+TOOLS+RUNTIME 8,827→4,122 tok (−53%); all 12 hard gates intact.
• Validation: deterministic gate-checklist PASS; headless A/B thin 7/9 vs monolith 5/9. Detail: scratchpads/contract-thin-core.md.

P5 — Overlay composer + cross-harness (#604) — feat/p5-overlay-composer

• Status: MERGED to main (#605). R7 (compose-contract) + R8 (cross-harness) + R9 (composer test).
• composeContract({harness, mosaicHome}) pure fn + .local overlay deltas-by-value; mosaic compose-contract <harness> command; AGENTS bare-launch nudge; composer spec (per-tier anchor + Tier-3 byte-equality). Detail: scratchpads/p5-overlay-composer.md.

P6 — Docs, compliance matrix, alpha tag (#606) — feat/p6-docs-compliance-alpha

• Status: in-repo deliverables done (CONTRIBUTING.md + harness×gate compliance matrix + check-resident-budget.sh + CI wiring + ALPHA-DOD.md). Remaining: alpha tag v0.0.39-alpha (Lead, post-merge). aiguide reconcile merged (#8). Detail: scratchpads/p6-docs-compliance-alpha.md.

F3-m3 — mosaic update re-seeds framework + relaunches agents (#609) — feat/f3-m3-update-reseed

• Status: implemented + tested. Closes R13: mosaic update now re-seeds the framework (data-safe MOSAIC_SYNC_ONLY) after the CLI install so shipped launcher/runtime changes activate; --relaunch restarts rostered agents; --no-reseed opts out. Detail: scratchpads/f3-m3-update-reseed.md.

Fleet-polish bundle — boot-survival symmetry (#611) — feat/fleet-polish-bundle

• Status: MERGED to main. disable-on-remove (boot-resurrection bug, TDD) + add-enable + init-R5 hard guarantee. 4 new + 147 existing fleet tests green. Detail: scratchpads/fleet-polish-bundle.md.

Fleet enhancer role + two-agent floor (#614) — feat/fleet-enhancer-floor

• Status: MERGED to main. enhancer added to 4 presets; init guarantees 1 orchestrator + >=1 enhancer; remove protects the sole enhancer; enhancer role doc. 155 fleet tests green. Detail: scratchpads/fleet-enhancer-floor.md.

F4 — Orchestrator chat connector + Matrix (#616) — feat/f4-matrix-connector

• Status: Phase 1 MERGED (#617: connector interface send/subscribe/health + registry + roster schema + design). Phase 2a (#618): Matrix CS-API client + factory. 20 connector tests green; no fleet.ts changes. Remaining Phase 2: init/configure connector-selection UX + roster wiring, systemd launch wiring, Conduit deploy guide. Detail: scratchpads/f4-matrix-connector.md.

Fleet onboarding-injection — comms cheat-sheet + peer roster (#620) — feat/fleet-comms-onboarding

• Status: implemented + tested. Injects # Fleet Comms (peer roster + cross-host agent-send commands + FLIP-reply + --verify) into each spawned fleet agent via composeContract; optional per-agent host/ssh/socket roster fields (socket: named → -L, unset → default socket no -L). 10 + 2 tests green. Detail: scratchpads/fleet-comms-onboarding.md.

Fleet stand-up fixes — model_hint→--model + socket-default trap (#626) — feat/fleet-standup-fixes

• Status: implemented + tested. FIX1 model_hint→MOSAIC_AGENT_MODEL→--model. FIX2 absent socket = default tmux socket (no -L) across parse/spawn/systemd-unit/observe (socketArgs helper, bare-empty shellEnvValue, conditional -L). 158 fleet tests green; shipped presets unaffected (explicit socket_name). Detail: scratchpads/fleet-standup-fixes.md.

north-star doctrine consolidation — doc PR — feat/north-star-doctrine

• Status: applied Mos's consolidated merge-map to docs/fleet/north-star.md (budget governance + control plane/central register + 200k cap + delegation + unified-identity Fleet + role-based naming + tmux security + drift re-captures). Doctrine only; #622/#623/#625/#628 out-of-scope. Conflict checklist green. Detail: scratchpads/north-star-doctrine.md.

#631 — re-seed preserves user fleet data (CRITICAL) — fix/631-reseed-preserves-fleet-data

• Status: implemented + tested. PRIMARY: install.sh PRESERVE_PATHS += fleet/*.yaml + fleet/agents + fleet/run (glob-aware cp-fallback); TS parity. SECONDARY: refreshActiveFleetUnits propagates unit fixes to ~/.config/systemd/user on mosaic update. bash F6 + TS + unit tests green. Detail: scratchpads/631-reseed-preserves-fleet.md.

#633 — comms-block emitter + FLEET-LAUNCH runbook — feat/633-comms-block-runbook

• Status: implemented + tested (TDD). mosaic fleet comms-block <role> [--host] wraps resolveCommsBlock → readFleetCommsBlock; fails loud (stderr + exit 1) on unknown role / missing roster instead of silent empty. docs/fleet/FLEET-LAUNCH.md runbook: worker path + orchestrator .env fold (MOSAIC_AGENT_COMMAND; line-41 [-z] short-circuits line-44 yolo hardcode) + 3 launch gotchas + #632 preserve note + North-Star 4-field arc (harness ✅/model ✅ roster-native today; yolo + command/channels = PATH B #636). 177 fleet+comms tests green (6 new resolveCommsBlock cases). PATH A of the A→B→webUI arc. Detail: scratchpads/633-comms-block-runbook.md.