docs: capture planning decisions + session 1 handoff
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful

Lock in the four open questions resolved during session 1:
- Gateway recovery uses BetterAuth cookie (not nonce file or rescue flag)
- Sub-package command surface scope is acceptable as-is for this mission
- Telemetry upload ships in dry-run mode until mosaicstack.dev server exists
- Top-level mosaic config command is required (added as CU-04-04)

Also:
- Mark CU-02-01/02/03 done; milestone cu-m02 complete
- Mission progress 2/8, phase -> Execution
- CU-03-01 compressed from spike to plan-only (design locked)
- Added CU-04-04 mosaic config and CU-04-05 tests
- Full handoff block in scratchpad: state, decisions, gotchas,
  suggested starting tasks for session 2

No code changes. Docs-only. Session 1 closes clean for handoff.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jarvis
2026-04-04 23:53:08 -05:00
parent 6f15a84ccf
commit c7c5ad21d9
3 changed files with 103 additions and 32 deletions

View File

@@ -7,9 +7,9 @@
**ID:** cli-unification-20260404
**Statement:** Transform the Mosaic CLI from a partially-duplicated, manually-assembled experience into a single cohesive entry point that installs, configures, and controls the entire Mosaic system. Every Mosaic package gets first-class CLI surface. The first-run experience works end-to-end with no manual stitching. Gateway token recovery is possible without the web UI. Opt-in telemetry uses the published telemetry clients.
**Phase:** Planning
**Current Milestone:**
**Progress:** 1 / 8 milestones
**Phase:** Execution
**Current Milestone:** cu-m03 / cu-m04 / cu-m05 (parallel-eligible)
**Progress:** 2 / 8 milestones
**Status:** active
**Last Updated:** 2026-04-04
@@ -29,7 +29,7 @@
| # | ID | Name | Status | Branch | Issue | Started | Completed |
| --- | ------ | ------------------------------------------------------------------------ | ----------- | ---------------------------------- | ----- | ---------- | ---------- |
| 1 | cu-m01 | Kill legacy @mosaicstack/cli package | done | chore/remove-cli-package-duplicate | #398 | 2026-04-04 | 2026-04-04 |
| 2 | cu-m02 | Archive stale mission state + scaffold new mission | in-progress | docs/mission-cli-unification | | 2026-04-04 | |
| 2 | cu-m02 | Archive stale mission state + scaffold new mission | done | docs/mission-cli-unification | #399 | 2026-04-04 | 2026-04-04 |
| 3 | cu-m03 | Fix gateway bootstrap token recovery (server + CLI paths) | not-started | — | — | — | — |
| 4 | cu-m04 | Alphabetize + group `mosaic --help` output | not-started | — | — | — | — |
| 5 | cu-m05 | Sub-package CLI surface (auth/brain/forge/log/macp/memory/queue/storage) | not-started | — | — | — | — |
@@ -61,9 +61,9 @@
## Session History
| Session | Runtime | Started | Duration | Ended Reason | Last Task |
| ------- | --------------- | ---------- | --------- | ------------ | ---------------------------------------------------- |
| 1 | claude-opus-4-6 | 2026-04-04 | in-flight | — | cu-m01 merged (PR #398); cu-m02 scaffold in progress |
| Session | Runtime | Started | Duration | Ended Reason | Last Task |
| ------- | --------------- | ---------- | --------- | ------------ | ------------------------------------------------------------ |
| 1 | claude-opus-4-6 | 2026-04-04 | in-flight | — | cu-m01 + cu-m02 merged (#398, #399); open questions resolved |
## Scratchpad