mosaicstack/stack
1
0
Fork 0
Code Issues 13 Pull Requests Actions Packages Projects Releases 11 Wiki Activity

docs: archive stale mission, scaffold CLI unification mission #399

Merged
jason.woltje merged 1 commits from docs/mission-cli-unification into main 2026-04-05 04:47:54 +00:00
Conversation 0 Commits 1 Files Changed 6 +320 -66
jason.woltje commented 2026-04-05 04:44:21 +00:00
Owner
Copy Link

Summary

Prior sessions left three different active missions scattered across the docs: a completed Harness Foundation mission in MISSION-MANIFEST.md, a partial Storage Abstraction Retrofit in TASKS.md, and a stale MVP scratchpad. This PR resets the working state to a single clean mission focused on what actually needs to happen next.

Parent mission: cli-unification-20260404 — unify the mosaic CLI, add first-class commands for every sub-package, fix the gateway bootstrap token recovery dead-end, stitch the install UX end-to-end, and add opt-in telemetry.

Companion PR: #398 (merged) — killed legacy @mosaicstack/cli package. This mission scaffold documents the remaining 7 milestones.

Changes

Archived to docs/archive/missions/:

  • Harness Foundation manifest + PRD → docs/archive/missions/harness-20260321/
  • Storage Abstraction TASKS.md → docs/archive/missions/storage-abstraction/

New mission artifacts:

  • docs/MISSION-MANIFEST.md — 8 milestones, 8 acceptance criteria, deployment + coordination metadata
  • docs/TASKS.md — per-milestone task breakdown with status, agent assignment, dependencies, token estimates
  • docs/scratchpads/cli-unification-20260404.md — planning decisions, gateway bootstrap bug root-cause analysis, telemetry architecture notes, known risks, verification evidence for completed M1

Left intact:

  • docs/PRD.md (v0.1.0, 1005 lines) — still the long-term target, referenced from new manifest
  • docs/PRD-TUI_Improvements.md — active TUI work, unrelated to this mission
  • docs/scratchpads/* — historical task scratchpads kept as append-only breadcrumbs

Milestones at a glance

  1. cu-m01 — Kill legacy @mosaicstack/cli — done (PR #398)
  2. cu-m02 — Archive + scaffold — in-progress (this PR)
  3. cu-m03 — Gateway bootstrap token recovery (server + CLI)
  4. cu-m04 — Alphabetize + group mosaic --help output
  5. cu-m05 — Sub-package CLI surface (auth / brain / forge / log / macp / memory / queue / storage)
  6. cu-m06 — mosaic telemetry (local OTEL + opt-in remote upload via telemetry-client-js)
  7. cu-m07 — Unified first-run UX (install.sh → wizard → gateway install → TUI)
  8. cu-m08 — Docs refresh + release tag

Test plan

  • pnpm format:check clean (all modified markdown)
  • No code changes — docs-only
  • CI pipeline green on merge
  • Mission docs reviewable + editable by Jason before M3 kickoff
## Summary Prior sessions left three different active missions scattered across the docs: a completed Harness Foundation mission in MISSION-MANIFEST.md, a partial Storage Abstraction Retrofit in TASKS.md, and a stale MVP scratchpad. This PR resets the working state to a single clean mission focused on what actually needs to happen next. **Parent mission:** cli-unification-20260404 — unify the mosaic CLI, add first-class commands for every sub-package, fix the gateway bootstrap token recovery dead-end, stitch the install UX end-to-end, and add opt-in telemetry. **Companion PR:** #398 (merged) — killed legacy @mosaicstack/cli package. This mission scaffold documents the remaining 7 milestones. ## Changes **Archived to docs/archive/missions/:** - Harness Foundation manifest + PRD → docs/archive/missions/harness-20260321/ - Storage Abstraction TASKS.md → docs/archive/missions/storage-abstraction/ **New mission artifacts:** - docs/MISSION-MANIFEST.md — 8 milestones, 8 acceptance criteria, deployment + coordination metadata - docs/TASKS.md — per-milestone task breakdown with status, agent assignment, dependencies, token estimates - docs/scratchpads/cli-unification-20260404.md — planning decisions, gateway bootstrap bug root-cause analysis, telemetry architecture notes, known risks, verification evidence for completed M1 **Left intact:** - docs/PRD.md (v0.1.0, 1005 lines) — still the long-term target, referenced from new manifest - docs/PRD-TUI_Improvements.md — active TUI work, unrelated to this mission - docs/scratchpads/* — historical task scratchpads kept as append-only breadcrumbs ## Milestones at a glance 1. cu-m01 — Kill legacy @mosaicstack/cli — **done (PR #398)** 2. cu-m02 — Archive + scaffold — **in-progress (this PR)** 3. cu-m03 — Gateway bootstrap token recovery (server + CLI) 4. cu-m04 — Alphabetize + group mosaic --help output 5. cu-m05 — Sub-package CLI surface (auth / brain / forge / log / macp / memory / queue / storage) 6. cu-m06 — mosaic telemetry (local OTEL + opt-in remote upload via telemetry-client-js) 7. cu-m07 — Unified first-run UX (install.sh → wizard → gateway install → TUI) 8. cu-m08 — Docs refresh + release tag ## Test plan - [x] pnpm format:check clean (all modified markdown) - [x] No code changes — docs-only - [ ] CI pipeline green on merge - [ ] Mission docs reviewable + editable by Jason before M3 kickoff
jason.woltje added 1 commit 2026-04-05 04:44:22 +00:00
docs: archive stale mission state, scaffold CLI unification mission
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
Details
ci/woodpecker/pr/ci Pipeline was successful
Details
f7b5f187c5 
Prior sessions left three different missions spread across the docs:
- docs/MISSION-MANIFEST.md: Harness Foundation (complete)
- docs/TASKS.md: Storage Abstraction Retrofit (P1-P4 done, P5 pending)
- docs/scratchpads/mvp-20260312.md: MVP mission (stale)

Reset the working state to a single clean mission focused on what
actually needs to happen next: unify the mosaic CLI, add first-class
commands for every sub-package, fix the gateway bootstrap token
recovery dead-end, and stitch the install UX end-to-end.

Changes:
- Move Harness Foundation manifest + PRD to docs/archive/missions/harness-20260321/
- Move Storage Abstraction TASKS.md to docs/archive/missions/storage-abstraction/
- Scaffold new docs/MISSION-MANIFEST.md for cli-unification-20260404
  with 8 milestones (M1 done via PR #398, M2 in-progress via this PR)
- Scaffold new docs/TASKS.md with per-milestone task breakdown,
  dependencies, agent assignments, and token estimates
- Scaffold docs/scratchpads/cli-unification-20260404.md with full
  planning decisions, gateway bootstrap bug root cause analysis,
  telemetry architecture notes, and open risks

Left intact:
- docs/PRD.md (v0.1.0, 1005 lines) — still the long-term target
- docs/PRD-TUI_Improvements.md — active TUI work
- docs/scratchpads/* historical task scratchpads — append-only breadcrumbs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
jason.woltje merged commit 6f15a84ccf into main 2026-04-05 04:47:54 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
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#399
Delete Branch "docs/mission-cli-unification"

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?