b38cfac760
Moves all Mosaic framework runtime files from the separate bootstrap repo into the monorepo as canonical source. The @mosaic/mosaic npm package now ships the complete framework — bin scripts, runtime configs, tools, and templates — enabling standalone installation via npm install. Structure: packages/mosaic/framework/ ├── bin/ 28 CLI scripts (mosaic, mosaic-doctor, mosaic-sync-skills, etc.) ├── runtime/ Runtime adapters (claude, codex, opencode, pi, mcp) ├── tools/ Shell tooling (git, prdy, orchestrator, quality, etc.) ├── templates/ Agent and repo templates ├── defaults/ Default identity files (AGENTS.md, STANDARDS.md, SOUL.md, etc.) ├── install.sh Legacy bash installer └── remote-install.sh One-liner remote installer Key files with Pi support and recent fixes: - bin/mosaic: launch_pi() with skills-local loop - bin/mosaic-doctor: --fix auto-wiring for all 4 harnesses - bin/mosaic-sync-skills: Pi as 4th link target, symlink-aware find - bin/mosaic-link-runtime-assets: Pi settings.json patching - bin/mosaic-migrate-local-skills: Pi skill roots, symlink find - runtime/pi/RUNTIME.md + mosaic-extension.ts Package ships 251 framework files in the npm tarball (278KB compressed).
Repo Mosaic Linkage
This repository is attached to the machine-wide Mosaic framework.
Load Order for Agents
~/.config/mosaic/STANDARDS.mdAGENTS.md(this repository).mosaic/repo-hooks.sh(repo-specific automation hooks)
Purpose
- Keep universal standards in
~/.config/mosaic - Keep repo-specific behavior in this repo
- Avoid copying large runtime configs into each project
Optional Quality Rails
Use .mosaic/quality-rails.yml to track whether quality rails are enabled for this repo.
Apply a template:
~/.config/mosaic/bin/mosaic-quality-apply --template <template> --target .
Verify enforcement:
~/.config/mosaic/bin/mosaic-quality-verify --target .
Optional Matrix Orchestrator Rail
Repo-local orchestrator state lives in .mosaic/orchestrator/.
Run one cycle:
~/.config/mosaic/bin/mosaic-orchestrator-matrix-cycle
~/.config/mosaic/bin/mosaic-orchestrator-run --once
Run continuously:
~/.config/mosaic/bin/mosaic-orchestrator-run --poll-sec 10
Bridge events to Matrix:
~/.config/mosaic/bin/mosaic-orchestrator-matrix-publish
~/.config/mosaic/bin/mosaic-orchestrator-matrix-consume
Run until queue is drained (syncs from docs/tasks.md first):
~/.config/mosaic/bin/mosaic-orchestrator-drain
Set worker command if auto-detect does not match your CLI:
export MOSAIC_WORKER_EXEC="codex -p"
# or
export MOSAIC_WORKER_EXEC="opencode -p"
Use repo helper (foreground or detached):
bash scripts/agent/orchestrator-daemon.sh drain
bash scripts/agent/orchestrator-daemon.sh start
bash scripts/agent/orchestrator-daemon.sh status
bash scripts/agent/orchestrator-daemon.sh stop