diff --git a/packages/mosaic/framework/tools/orchestrator/README.md b/packages/mosaic/framework/tools/orchestrator/README.md index 3ee7f104..3d3bb132 100644 --- a/packages/mosaic/framework/tools/orchestrator/README.md +++ b/packages/mosaic/framework/tools/orchestrator/README.md @@ -4,18 +4,18 @@ Helper scripts for r0 coordinator / orchestrator sessions — mission lifecycle, session health, continuation, and board maintenance. See `framework/guides/ORCHESTRATOR-PROTOCOL.md` for the surrounding process. -| Script | Purpose | -|--------|---------| -| `mission-init.sh` | Initialize a new orchestration mission (manifest, scratchpad, TASKS.md). | -| `mission-status.sh` | Show the mission progress dashboard. | -| `session-run.sh` | Generate continuation context and launch the target runtime. | -| `session-resume.sh` | Crash recovery for dead orchestrator sessions. | -| `session-status.sh` | Check agent session health. | -| `continue-prompt.sh` | Generate the continuation prompt for the next session. | -| `board-roll.sh` | Keep a LIVE orchestration board under its byte cap by rolling the oldest entries to its LEDGER. | -| `smoke-test.sh` | Behavior smoke checks for the coord continue/run workflows. | -| `test-board-roll.sh` | Regression harness for `board-roll.sh`. | -| `_lib.sh` | Shared functions sourced by the above (state files, TASKS.md parsing, locks). | +| Script | Purpose | +| -------------------- | ----------------------------------------------------------------------------------------------- | +| `mission-init.sh` | Initialize a new orchestration mission (manifest, scratchpad, TASKS.md). | +| `mission-status.sh` | Show the mission progress dashboard. | +| `session-run.sh` | Generate continuation context and launch the target runtime. | +| `session-resume.sh` | Crash recovery for dead orchestrator sessions. | +| `session-status.sh` | Check agent session health. | +| `continue-prompt.sh` | Generate the continuation prompt for the next session. | +| `board-roll.sh` | Keep a LIVE orchestration board under its byte cap by rolling the oldest entries to its LEDGER. | +| `smoke-test.sh` | Behavior smoke checks for the coord continue/run workflows. | +| `test-board-roll.sh` | Regression harness for `board-roll.sh`. | +| `_lib.sh` | Shared functions sourced by the above (state files, TASKS.md parsing, locks). | ## board-roll.sh @@ -35,16 +35,23 @@ always-current `##` sections) is pinned and never touched: ```markdown # MOS ORCHESTRATION BOARD — LIVE state + > protocol blockquote … (pinned) ## 🟦 Curated always-current section (pinned) + … + ### 2026-07-22 (mid²²) — newest tick, stays longest + … + ### 2026-07-20 (dawn) — oldest tick, rolled first + … + ```