code-be-01
95c48b2bda
ci/woodpecker/pr/ci Pipeline was successful
Replaces the v1 two-key declaration with the schema_version 2 form per mosaic-brain docs/plans/2026-08-23_repo-structure-declaration.md section 1.3 (spec of record @ brain main 515bcbab): flow, canonical_remote, canonical_clone, worktree_root, and transitional worktree_policy (orchestrator-precreated until the J3/#1174 amendment). Validated by the wave-1 validator: OK in managed mode with launch-equivalent anchors; fail-closed on absent anchors per spec 1.2a interim; display mode warns and passes. Docs-only, exactly one file.
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