bootstrap/rails/orchestrator-matrix

Mosaic Matrix Orchestrator Rail

Runtime-agnostic orchestration rail for delegating work to worker agents and enforcing mechanical quality gates.

Purpose

• Decouple orchestration from any single agent runtime feature set
• Persist state in repo-local .mosaic/orchestrator/ files
• Emit structured events for Matrix transport and audit trails
• Enforce rails before marking tasks complete

Components

• protocol/ - JSON schemas for task/event payloads
• controller/mosaic_orchestrator.py - deterministic controller loop
• adapters/ - runtime adapter guidance

Repo Contract

The controller expects this layout in each bootstrapped repo:

.mosaic/orchestrator/
  config.json
  tasks.json
  state.json
  events.ndjson
  logs/
  results/

Quick Start

From a bootstrapped repo:

~/.mosaic/bin/mosaic-orchestrator-run --once

Continuous loop:

~/.mosaic/bin/mosaic-orchestrator-run --poll-sec 10

Matrix Note

This rail writes canonical events to .mosaic/orchestrator/events.ndjson. Matrix bridge services can consume and relay these events to Matrix rooms.