Files
stack/docs/TASKS.md
Jason Woltje bca7fc4cf2 feat(mosaic): P5 overlay composer — compose-contract + *.local overlays (#604)
Implements R7 + R8 of the Constitution alpha: launcher-composed operator
overlays so a user's *.local deltas reach the model as one pre-merged blob
(DESIGN §3.2), without re-injecting full base prose.

- composeContract(runtime, mosaicHome=MOSAIC_HOME): testable pure fn extracted
  from the launcher prompt assembly; buildRuntimePrompt delegates to it.
- Overlay logic (deltas by value, base files keep residency):
  - USER.local.md -> appended under the # User Profile block (USER is injected)
  - SOUL.local.md + STANDARDS.local.md -> trailing # Operator Overlays section
    (their bases are load-on-demand; only the small delta is injected, so the
    P3 byte-budget tiering is preserved). Whitespace-only overlays ignored.
  - Absent *.local -> base-only, automatically.
- New command: mosaic compose-contract <harness> -> prints the composed blob
  to stdout (inspection / mosaic doctor / diffing / the composer test).
- defaults/AGENTS.md: bare-launch self-load fallback now nudges to relaunch via
  mosaic <harness> (or mosaic doctor) when *.local overlays exist (R7 known-limit).
- compose-contract.spec.ts (7 tests): per-tier anchors, Tier-3 byte-equality
  (injected L0 == CONSTITUTION.md on disk), overlay present/absent, per-harness.

ASSUMPTION: overlays injected as deltas-by-value under labeled sections; bases
keep existing residency. Rationale in docs/scratchpads/p5-overlay-composer.md.

Verified: 7 composer + 26 launch tests pass; tsc-clean on touched files;
prettier clean. Defers to P6: CONTRIBUTING.md + compliance matrix, line-count
CI ceiling, aiguide reconcile, alpha tag.

Refs #604, #542

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
2026-06-21 20:54:30 -05:00

4.8 KiB
Raw Permalink Blame History

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; M2M7 deferred to mission planning

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

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: in progress. 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.
  • Defer to P6: CONTRIBUTING.md + compliance matrix; line-count CI ceiling; aiguide; alpha tag.