Collapse `mosaic wizard` and `mosaic gateway install` into a single cohesive
first-run experience. Gateway config and admin bootstrap now run as terminal
stages of `runWizard`, sharing `WizardState` with the framework stages and
eliminating the fragile 10-minute `$XDG_RUNTIME_DIR/mosaic-install-state.json`
session-file bridge.
- Extract `gatewayConfigStage` and `gatewayBootstrapStage` as first-class
wizard stages with full spec coverage (headless + interactive paths).
- `mosaic gateway install` becomes a thin wrapper that invokes the same
two stages — the CLI entry point is preserved for operators who only
need to (re)configure the daemon.
- Honor explicit `--port` override even on resume: when the override
differs from the saved GATEWAY_PORT, force a config regeneration so
`.env` and `meta.json` cannot drift.
- Honor `state.hooks.accepted === false` in the finalize stage and in
`mosaic-link-runtime-assets`: declined hooks are now actually opted-out,
with a stable `mosaic-managed: true` marker in the template so cleanup
survives template updates without touching user-owned configs.
- Headless rerun of an already-bootstrapped gateway with no local token
cache is a successful no-op (no more false-positive install failures).
- `tools/install.sh` calls `mosaic wizard` only — the follow-up
`mosaic gateway install` auto-launch is removed.
Closesmosaicstack/mosaic-stack#427.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
git pull --rebase fails with 'cannot pull with rebase: You have
unstaged changes' when the skills repo has local modifications.
Fix: detect dirty index/worktree, stash before pull, restore after.
Also gracefully handle pull failures (warn and continue with existing
checkout) and stash pop conflicts.
- mosaic-init bash script: detect existing SOUL.md/USER.md/TOOLS.md and
prompt user to keep, import (re-use values as defaults), or overwrite.
Non-interactive mode exits cleanly unless --force is passed.
Overwrite creates timestamped backups before replacing files.
- launch.ts checkSoul(): prefer 'mosaic wizard' over legacy bash script
when SOUL.md is missing, with fallback to mosaic-init.
- detect-install.ts: pre-populate wizard state with existing values when
user chooses 'reconfigure', so they see current settings as defaults.
- soul-setup.ts: show existing agent name and communication style as
defaults during reconfiguration.
- Added tests for reconfigure pre-population and reset non-population.
