generalize runtime ownership with doctor and local skill migration

This commit is contained in:
Jason Woltje
2026-02-17 12:10:06 -06:00
parent 967c9c462b
commit db2ec9524f
25 changed files with 3974 additions and 6 deletions

View File

@@ -21,6 +21,7 @@ bash ~/src/mosaic-bootstrap/install.sh
- Runtime overlays: `~/.mosaic/runtime/`
- Shared wrapper commands: `~/.mosaic/bin/`
- Canonical skills directory: `~/.mosaic/skills`
- Local cross-runtime skills: `~/.mosaic/skills-local`
## Universal Skills
@@ -38,6 +39,8 @@ Then links each skill into runtime directories:
- `~/.codex/skills`
- `~/.config/opencode/skills`
Local skills under `~/.mosaic/skills-local` are also linked into runtimes.
Manual commands:
```bash
@@ -50,15 +53,17 @@ Manual commands:
Installer also links Claude-compatible paths back to Mosaic canonicals:
- `~/.claude/agent-guides` -> `~/.mosaic/guides`
- `~/.claude/scripts/{git,codex,bootstrap,cicd}` -> `~/.mosaic/rails/...`
- `~/.claude/scripts/{git,codex,bootstrap,cicd,portainer}` -> `~/.mosaic/rails/...`
- `~/.claude/templates` -> `~/.mosaic/templates/agent`
- `~/.claude/presets/{domains,tech-stacks,workflows}` -> `~/.mosaic/profiles/...`
- `~/.claude/presets/*.json` runtime overlays -> `~/.mosaic/runtime/claude/settings-overlays/`
- `~/.claude/{CLAUDE.md,settings.json,hooks-config.json,context7-integration.md}` -> `~/.mosaic/runtime/claude/...`
Run manually:
```bash
~/.mosaic/bin/mosaic-link-runtime-assets
~/.mosaic/bin/mosaic-migrate-local-skills --apply
```
Prune migrated legacy backups from runtime folders (dry-run by default):
@@ -68,6 +73,13 @@ Prune migrated legacy backups from runtime folders (dry-run by default):
~/.mosaic/bin/mosaic-prune-legacy-runtime --runtime claude --apply
```
Audit runtime drift:
```bash
~/.mosaic/bin/mosaic-doctor
~/.mosaic/bin/mosaic-doctor --fail-on-warn
```
Opt-out during install:
```bash