bootstrap/README.md

Mosaic Agent Framework

~/.mosaic is the universal userspace standards layer (master) for all agent runtimes.

Install Master Layer

From the standalone source repo:

git clone https://git.mosaicstack.dev/mosaic/bootstrap.git ~/src/mosaic-bootstrap
bash ~/src/mosaic-bootstrap/install.sh

What It Provides

• Shared standards document: ~/.mosaic/STANDARDS.md
• Runtime adapter docs: ~/.mosaic/adapters/
• Shared wrapper commands: ~/.mosaic/bin/

Usage

Inside any compatible repository:

~/.mosaic/bin/mosaic-session-start
~/.mosaic/bin/mosaic-critical
~/.mosaic/bin/mosaic-session-end

Wrapper commands call local repo scripts under scripts/agent/.

Bootstrap Any Repo (Slave Linkage)

Attach any repository/workspace to the master layer:

~/.mosaic/bin/mosaic-bootstrap-repo /path/to/repo

This creates/updates:

• .mosaic/ (repo-specific hook/config surface)
• scripts/agent/ (portable lifecycle scripts)
• AGENTS.md (if missing)

Upgrade Existing Slave Repos

Preview upgrades (dry-run):

~/.mosaic/bin/mosaic-upgrade-slaves

Apply upgrades:

~/.mosaic/bin/mosaic-upgrade-slaves --apply