a333d794e6
- MISSION-MANIFEST: mark cu-m03/04/05 done, cu-m06/07 in-progress - TASKS: mark CU-03-01..08, CU-04-01..05, CU-05-01..10 done - scratchpad: append Session 2 log, Wave 1-4 outcomes, new gotchas Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
13 KiB
13 KiB
Tasks — CLI Unification & E2E First-Run
Single-writer: orchestrator only. Workers read but never modify.
Mission: cli-unification-20260404 Schema:
| id | status | description | issue | agent | branch | depends_on | estimate | notes |Status values:not-started|in-progress|done|blocked|failed|needs-qaAgent values:codex|sonnet|haiku|opus|glm-5|—(auto)
Milestone 1 — Kill legacy @mosaicstack/cli (done)
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-01-01 | done | Delete packages/cli directory; update workspace + docs references | #398 | opus | chore/remove-cli-package-duplicate | — | 5K | Merged c39433c3. 6685 LOC−. |
Milestone 2 — Archive stale mission + scaffold new mission (done)
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-02-01 | done | Move stale MISSION-MANIFEST / TASKS / PRD-Harness to docs/archive/ | #399 | opus | docs/mission-cli-unification | CU-01-01 | 3K | Harness + storage missions done. |
| CU-02-02 | done | Scaffold new MISSION-MANIFEST.md, TASKS.md, scratchpad | #399 | opus | docs/mission-cli-unification | CU-02-01 | 5K | This file + manifest + scratchpad |
| CU-02-03 | done | PR review, merge, branch cleanup | #399 | opus | docs/mission-cli-unification | CU-02-02 | 2K | Merged as 6f15a84c |
Milestone 3 — Gateway bootstrap token recovery
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-03-01 | done | Implementation plan for BetterAuth-cookie recovery flow (decision locked 2026-04-04) | — | opus | — | CU-02-03 | 4K | Design locked; plan-only task |
| CU-03-02 | done | Server: add recovery/rotate endpoint on apps/gateway/src/admin (gated by design from CU-03-01) | — | sonnet | — | CU-03-01 | 12K | |
| CU-03-03 | done | CLI: mosaic gateway login — interactive BetterAuth sign-in, persist session |
— | sonnet | — | CU-03-02 | 10K | |
| CU-03-04 | done | CLI: mosaic gateway config rotate-token — mint new admin token via authenticated API |
— | sonnet | — | CU-03-03 | 8K | |
| CU-03-05 | done | CLI: mosaic gateway config recover-token — execute the recovery flow from CU-03-01 |
— | sonnet | — | CU-03-03 | 10K | |
| CU-03-06 | done | Install UX: fix the "user exists, no token" dead-end in runInstall bootstrapFirstUser path | — | sonnet | — | CU-03-05 | 8K | |
| CU-03-07 | done | Tests: integration tests for each recovery path (happy + error) | — | sonnet | — | CU-03-06 | 10K | |
| CU-03-08 | done | Code review + remediation | — | haiku | — | CU-03-07 | 4K |
Milestone 4 — mosaic --help alphabetize + grouping
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-04-01 | done | Enable configureHelp({ sortSubcommands: true }) on root program and each subgroup |
— | sonnet | — | CU-02-03 | 3K | |
| CU-04-02 | done | Group commands into sections (Runtime, Gateway, Framework, Platform) in help output | — | sonnet | — | CU-04-01 | 5K | |
| CU-04-03 | done | Verify help snapshots render readably; update any docs with stale output | — | haiku | — | CU-04-02 | 3K | |
| CU-04-04 | done | Top-level mosaic config command — show, get <key>, set <key> <val>, edit, path — wraps packages/mosaic/src/config/config-service.ts (framework/agent config; distinct from mosaic gateway config) |
— | sonnet | — | CU-02-03 | 10K | New scope (decision 2026-04-04) |
| CU-04-05 | done | Tests + code review for CU-04-04 | — | haiku | — | CU-04-04 | 4K |
Milestone 5 — Sub-package CLI surface
Pattern: each sub-package exports
register<Name>Command(program: Command)co-located with the library code (proven by@mosaicstack/quality-rails). Wire intopackages/mosaic/src/cli.ts.
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-05-01 | done | mosaic forge — subcommands: run, status, resume, personas list |
— | sonnet | — | CU-02-03 | 18K | User priority |
| CU-05-02 | done | mosaic storage — subcommands: status, tier show, tier switch, export, import, migrate |
— | sonnet | — | CU-02-03 | 15K | |
| CU-05-03 | done | mosaic queue — subcommands: list, stats, pause/resume, jobs tail, drain |
— | sonnet | — | CU-02-03 | 12K | |
| CU-05-04 | done | mosaic memory — subcommands: search, stats, insights list, preferences list |
— | sonnet | — | CU-02-03 | 12K | |
| CU-05-05 | done | mosaic brain — subcommands: projects list/create, missions list, tasks list, conversations list |
— | sonnet | — | CU-02-03 | 15K | |
| CU-05-06 | done | mosaic auth — subcommands: users list/create/delete, sso list, sso test, sessions list |
— | sonnet | — | CU-03-03 | 15K | needs gateway login |
| CU-05-07 | done | mosaic log — subcommands: tail, search, export, level <level> |
— | sonnet | — | CU-02-03 | 10K | |
| CU-05-08 | done | mosaic macp — subcommands: tasks list, submit, gate, events tail |
— | sonnet | — | CU-02-03 | 12K | |
| CU-05-09 | done | Wire all eight register<Name>Command calls into packages/mosaic/src/cli.ts |
— | haiku | — | CU-05-01…8 | 3K | |
| CU-05-10 | done | Integration test: mosaic <cmd> --help exits 0 for every new command |
— | haiku | — | CU-05-09 | 5K |
Milestone 6 — mosaic telemetry
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-06-01 | not-started | Add @mosaicstack/telemetry-client-js as dependency of @mosaicstack/mosaic from Gitea registry |
— | sonnet | — | CU-02-03 | 3K | |
| CU-06-02 | not-started | mosaic telemetry local — status, tail, Jaeger link (wraps existing apps/gateway/src/tracing.ts) |
— | sonnet | — | CU-06-01 | 8K | |
| CU-06-03 | not-started | mosaic telemetry — status, opt-in, opt-out, test, upload (uses telemetry-client-js) |
— | sonnet | — | CU-06-01 | 12K | Dry-run mode when server endpoint not yet live |
| CU-06-04 | not-started | Persistent consent state in mosaic config; disabled by default | — | sonnet | — | CU-06-03 | 5K | |
| CU-06-05 | not-started | Tests + code review | — | haiku | — | CU-06-04 | 5K |
Milestone 7 — Unified first-run UX
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-07-01 | not-started | tools/install.sh: after npm install, hand off to mosaic wizard then mosaic gateway install |
— | sonnet | — | CU-03-06 | 10K | |
| CU-07-02 | not-started | mosaic wizard and mosaic gateway install coordination: shared state, no duplicate prompts |
— | sonnet | — | CU-07-01 | 12K | |
| CU-07-03 | not-started | Post-install verification step: "gateway healthy, tui connects, admin token on file" | — | sonnet | — | CU-07-02 | 8K | |
| CU-07-04 | not-started | End-to-end test on a clean container from scratch | — | haiku | — | CU-07-03 | 8K |
Milestone 8 — Docs + release
| id | status | description | issue | agent | branch | depends_on | estimate | notes |
|---|---|---|---|---|---|---|---|---|
| CU-08-01 | not-started | Update README.md with new command tree, install flow, and feature list | — | sonnet | — | CU-07-04 | 8K | |
| CU-08-02 | not-started | Update docs/guides/user-guide.md with all new sub-package commands | — | sonnet | — | CU-08-01 | 10K | |
| CU-08-03 | not-started | Version bump @mosaicstack/mosaic, publish to Gitea registry |
— | opus | — | CU-08-02 | 3K | |
| CU-08-04 | not-started | Release notes, tag v0.1.0-rc.N, publish release on Gitea |
— | opus | — | CU-08-03 | 3K |