feat: integrate framework files into monorepo #344

jason.woltje · 2026-04-02T02:20:12Z

jason.woltje commented

2026-04-02 02:20:12 +00:00

Summary

Moves all Mosaic framework runtime files into the monorepo as canonical source. Previously these lived in a separate mosaic/bootstrap repo and were only on the local filesystem at ~/.config/mosaic/. Now @mosaic/mosaic ships everything needed for standalone installation via npm install.

What Moved

Directory	Contents	Files
`framework/bin/`	CLI scripts (`mosaic`, `mosaic-doctor`, etc.)	28
`framework/runtime/`	Runtime adapters (claude, codex, opencode, pi, mcp)	14
`framework/tools/`	Shell tooling (git, prdy, orchestrator, quality, etc.)	153
`framework/templates/`	Agent and repo templates	48
`framework/defaults/`	Default identity files (AGENTS.md, STANDARDS.md, etc.)	6
`framework/install.sh`	Legacy bash installer	1
`framework/remote-install.sh`	One-liner remote installer	1

Total: 251 files, 278KB compressed in npm tarball.

Why This Matters

All Pi runtime support, the mosaic pi launcher, mosaic doctor --fix, skill wiring fixes, and runtime adapters were only on the local filesystem — not tracked in any repo. A fresh install or mosaic-release-upgrade would overwrite them with the old bootstrap versions that had none of these changes.

Key Files with Recent Changes

bin/mosaic: launch_pi() function, 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
runtime/pi/RUNTIME.md + mosaic-extension.ts

Testing

pnpm typecheck — 36/36 pass
pnpm pack — 251 framework files in tarball
ESLint config updated to ignore framework/ dir

## Summary Moves all Mosaic framework runtime files into the monorepo as canonical source. Previously these lived in a separate `mosaic/bootstrap` repo and were only on the local filesystem at `~/.config/mosaic/`. Now `@mosaic/mosaic` ships everything needed for standalone installation via `npm install`. ## What Moved | Directory | Contents | Files | |-----------|----------|-------| | `framework/bin/` | CLI scripts (`mosaic`, `mosaic-doctor`, etc.) | 28 | | `framework/runtime/` | Runtime adapters (claude, codex, opencode, pi, mcp) | 14 | | `framework/tools/` | Shell tooling (git, prdy, orchestrator, quality, etc.) | 153 | | `framework/templates/` | Agent and repo templates | 48 | | `framework/defaults/` | Default identity files (AGENTS.md, STANDARDS.md, etc.) | 6 | | `framework/install.sh` | Legacy bash installer | 1 | | `framework/remote-install.sh` | One-liner remote installer | 1 | **Total:** 251 files, 278KB compressed in npm tarball. ## Why This Matters All Pi runtime support, the `mosaic pi` launcher, `mosaic doctor --fix`, skill wiring fixes, and runtime adapters were only on the local filesystem — not tracked in any repo. A fresh install or `mosaic-release-upgrade` would overwrite them with the old bootstrap versions that had none of these changes. ## Key Files with Recent Changes - `bin/mosaic`: `launch_pi()` function, 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 - `runtime/pi/RUNTIME.md` + `mosaic-extension.ts` ## Testing - `pnpm typecheck` — 36/36 pass - `pnpm pack` — 251 framework files in tarball - ESLint config updated to ignore `framework/` dir

jason.woltje added 1 commit 2026-04-02 02:20:13 +00:00

feat: integrate framework files into monorepo under packages/mosaic/framework/

ci/woodpecker/push/ci Pipeline was successful

Details

ci/woodpecker/pr/ci Pipeline was successful

Details

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).

jason.woltje merged commit 53199122d8 into main

2026-04-02 02:20:19 +00:00

jason.woltje referenced this issue from a commit

2026-04-02 02:20:19 +00:00

Merge pull request 'feat: integrate framework files into monorepo' (#344) from feat/framework-into-monorepo into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: mosaicstack/stack#344