51 lines
1.1 KiB
Markdown
51 lines
1.1 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
.mosaic/orchestrator/
|
|
config.json
|
|
tasks.json
|
|
state.json
|
|
events.ndjson
|
|
logs/
|
|
results/
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
From a bootstrapped repo:
|
|
|
|
```bash
|
|
~/.mosaic/bin/mosaic-orchestrator-run --once
|
|
```
|
|
|
|
Continuous loop:
|
|
|
|
```bash
|
|
~/.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.
|