The `mosaic gateway install` command had three UX problems:
1. Admin API token was silently saved to meta.json and never shown to
the user — no way to retrieve it without reading the file.
2. If install crashed mid-way (e.g. daemon health-check failure), the
next run prompted "Reinstall? [y/N]" and aborted on N, leaving a
half-configured install with no resume path.
3. Health-check failures only pointed at `mosaic gateway logs` — user
had to run a separate command to see the actual error.
Changes:
- **Prominent admin token banner** printed immediately after bootstrap
creates the first admin user. Clear "save now, won't be shown again"
warning.
- **Resumable install state machine.** Detects partial installs from
meta.json + .env + mosaic.config.json + daemon state, and picks up
where a prior attempt stopped instead of prompting. Fully set up
installs now offer "re-run config wizard" with explicit warnings
about what it does (regenerates .env, clears admin token, may change
backend storage).
- **Inline log tail on health failure.** Last 30 non-empty lines of
gateway.log printed automatically when the daemon fails to become
healthy, so the user sees the underlying error without running a
second command.
- **Corrupt-state detection.** If exactly one of .env / mosaic.config.json
exists (from an interrupted prior install), refuses to guess and
directs the user to `mosaic gateway uninstall`.
- **BETTER_AUTH_SECRET preservation** across config regeneration so
existing Better Auth sessions aren't silently invalidated.
- **Admin token dropped on any config regeneration** (the wizard may
point at a different backend; the old token is unverifiable).
- **Daemon stopped before config rewrite** so the live process never
serves stale config.
- Bump `@mosaic/mosaic` 0.0.19 → 0.0.20.
Known follow-ups (noted in review):
- `--port 14242` as an explicit override cannot be distinguished from
commander's default value; requires plumbing an `explicit` flag.
- No automated test coverage for the new state branches; requires
mocking fs/readline/fetch/spawn.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The migration file 0001_cynical_ultimatum.sql existed on disk but was not
registered in the Drizzle journal (_journal.json). This caused fresh-database
migrations (CI) to skip creating tables (agent_logs, insights, preferences,
skills, summarization_jobs), then 0002_nebulous_mimic.sql would fail trying
to ALTER the non-existent preferences table.
Fix: insert cynical_ultimatum at idx 1 in the journal and shift all
subsequent entries (idx 2-7).
Verified: pnpm test passes (347 tests, 35 tasks).
Mark P1-001, P1-007, P1-008, P2-001, P5-002, P6-005 as done (PR #61).
Add session 2 log entry for vertical slice delivery.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Jason directed: build Pi TUI → Gateway → Discord communication
spine before backfilling horizontal layers.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Break PRD into 8 milestones (Phase 0–7) with 59 issues on Gitea.
Populate TASKS.md, update mission manifest, initialize scratchpad.
Repo created at git.mosaicstack.dev/mosaic/mosaic-stack.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
