feat(mosaic): unified first-run UX wizard -> gateway install -> verify #418

Merged
jason.woltje merged 1 commits from feat/mosaic-first-run-ux into main 2026-04-05 07:29:18 +00:00

1 Commits

Author SHA1 Message Date
Jarvis
e99a4921ed feat(mosaic): unified first-run UX wizard -> gateway install -> verify (CU-07-01..04)
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful
- CU-07-01: install.sh gains --yes/--no-auto-launch flags; on first install
  with a TTY, auto-launches mosaic wizard then mosaic gateway install before
  the summary. Non-interactive / --no-auto-launch falls back to guidance text.
- CU-07-02: wizard writes transient session state to $XDG_RUNTIME_DIR/
  mosaic-install-state.json on completion; gateway install reads it on startup,
  announces the resume, and applies mosaicHome for custom-home installs.
  State is cleared on successful gateway install.
- CU-07-03: new packages/mosaic/src/commands/gateway/verify.ts exports
  runPostInstallVerification() (3 checks: gateway /health, admin token on file,
  /api/bootstrap/status). Called at end of runInstall. Registered as
  mosaic gateway verify subcommand. fetchWithRetry retries non-OK responses
  to handle startup races.
- CU-07-04: tools/e2e-install-test.sh — Docker-based e2e harness that runs
  the full install.sh -> wizard -> gateway install -> verify flow in a clean
  node:22-alpine container. Skips gracefully if Docker is unavailable.
  Gateway verify step skips with explanation when the published CLI pre-dates
  the new command (expected until next release).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-05 02:25:06 -05:00