-
released this
2026-04-05 20:53:26 +00:00 | 19 commits to main since this release@mosaicstack/mosaic 0.0.25 — install UX hardening
Closes the install-ux-hardening-20260405 mission. All 7 acceptance criteria satisfied across three feature PRs.
New features
mosaic uninstall(PR #429)- Top-level command that cleanly reverses every mutation made by
tools/install.sh— framework data, npm CLI, nested stack deps, runtime asset injections in~/.claude/, and npmrc scope mapping - Flags:
--framework,--cli,--gateway,--all,--keep-data,--yes,--dry-run - New install manifest at
~/.config/mosaic/.install-manifest.jsondrives deterministic reversal; heuristic fallback for installs that predate the manifest - Shell fallback:
curl … | bash -s -- --uninstallworks without a functioning CLI
Wizard remediation (PR #431)
- Password entry is now masked in raw mode with a confirmation prompt (no plaintext echo)
- New hooks-preview stage shows exactly which Claude hooks will be installed and captures explicit consent
- New
mosaic config hooks list|enable|disablesubcommands for post-install management - Headless install path:
MOSAIC_ASSUME_YES=1+MOSAIC_ADMIN_NAME/EMAIL/PASSWORDlets CI/automation complete the wizard without a TTY
Unified first-run wizard (PR #433)
mosaic wizardandmosaic gateway installare collapsed into a single cohesive flow with shared in-memory state- Gateway config + admin bootstrap are now terminal stages 11 & 12 of
runWizard - The fragile 10-minute
$XDG_RUNTIME_DIR/mosaic-install-state.jsonsession bridge has been removed mosaic gateway installstill works standalone (thin wrapper over the same stages) for users who already went through the wizardstate.hooks.accepted === falsenow propagates end-to-end viaMOSAIC_SKIP_CLAUDE_HOOKS— declining hooks actually skips hook installation
Stats
- 24 test files, 219 tests passing (+15 net new since 0.0.24)
- 4 rounds of independent codex code review applied across the milestones
Upgrade
npm i -g @mosaicstack/mosaic@0.0.25Alpha — stays in 0.0.x until GA.
Downloads
- Top-level command that cleanly reverses every mutation made by