feat: r0 coordinator tooling for orchestrator protocol

Implements the manual coordinator workflow for multi-session agent
orchestration. Agents stop after one milestone (confirmed limitation);
these tools let the human coordinator check status, generate continuation
prompts, and chain sessions together.

New:
- tools/orchestrator/ — 5 scripts + shared library (_lib.sh)
  - mission-init.sh: initialize mission with milestones and state files
  - mission-status.sh: dashboard showing milestones, tasks, sessions
  - session-status.sh: check if agent is running/stale/dead
  - continue-prompt.sh: generate paste-ready continuation prompt
  - session-resume.sh: crash recovery with dirty state detection
- guides/ORCHESTRATOR-PROTOCOL.md: agent-facing mission lifecycle guide
- templates/docs/: mission manifest, scratchpad, continuation templates
- templates/repo/.mosaic/orchestrator/mission.json: state file template

Modified:
- bin/mosaic: add 'coord' subcommand + resume advisory on launch
- AGENTS.md: conditional loading for protocol guide + rule 37
- bin/mosaic-doctor: checks for new coordinator files
- session hooks: mission detection on start, cleanup on end

Usage: mosaic coord init|mission|status|continue|resume

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

bin/mosaic

@@ -51,6 +51,14 @@ Management:
   release-upgrade [...]  Upgrade installed Mosaic release
   project-upgrade [...]  Clean up stale SOUL.md/CLAUDE.md in a project
 
+Coordinator (r0):
+  coord <subcommand>     Manual coordinator tools
+                         init    Initialize a new mission
+                         mission Show mission progress dashboard
+                         status  Check agent session health
+                         continue Generate continuation prompt
+                         resume  Crash recovery
+
 Options:
   -h, --help             Show this help
   -v, --version          Show version
@@ -187,6 +195,8 @@ launch_claude() {
   check_runtime "claude"
   check_sequential_thinking "claude"
 
+  _check_resumable_session
+
   # Claude supports --append-system-prompt for direct injection
   local runtime_prompt
   runtime_prompt="$(build_runtime_prompt "claude")"
@@ -201,6 +211,8 @@ launch_opencode() {
   check_runtime "opencode"
   check_sequential_thinking "opencode"
 
+  _check_resumable_session
+
   # OpenCode reads from ~/.config/opencode/AGENTS.md
   ensure_runtime_config "opencode" "$HOME/.config/opencode/AGENTS.md"
   echo "[mosaic] Launching OpenCode..."
@@ -214,6 +226,8 @@ launch_codex() {
   check_runtime "codex"
   check_sequential_thinking "codex"
 
+  _check_resumable_session
+
   # Codex reads from ~/.codex/instructions.md
   ensure_runtime_config "codex" "$HOME/.codex/instructions.md"
   echo "[mosaic] Launching Codex..."
@@ -325,6 +339,76 @@ run_seq() {
   esac
 }
 
+run_coord() {
+  check_mosaic_home
+  local subcmd="${1:-help}"
+  shift || true
+
+  local tool_dir="$MOSAIC_HOME/tools/orchestrator"
+
+  case "$subcmd" in
+    status|session)
+      exec bash "$tool_dir/session-status.sh" "$@"
+      ;;
+    init)
+      exec bash "$tool_dir/mission-init.sh" "$@"
+      ;;
+    mission|progress)
+      exec bash "$tool_dir/mission-status.sh" "$@"
+      ;;
+    continue|next)
+      exec bash "$tool_dir/continue-prompt.sh" "$@"
+      ;;
+    resume|recover)
+      exec bash "$tool_dir/session-resume.sh" "$@"
+      ;;
+    help|*)
+      cat <<COORD_USAGE
+mosaic coord — r0 manual coordinator tools
+
+Commands:
+  init --name <name> [opts]   Initialize a new mission
+  mission [--project <path>]  Show mission progress dashboard
+  status [--project <path>]   Check agent session health
+  continue [--project <path>] Generate continuation prompt for next session
+  resume [--project <path>]   Crash recovery (detect dirty state, generate fix)
+
+Examples:
+  mosaic coord init --name "Security Fix" --milestones "Critical,High,Medium"
+  mosaic coord mission
+  mosaic coord continue --copy
+
+COORD_USAGE
+      ;;
+  esac
+}
+
+# Resume advisory — prints warning if active mission or stale session detected
+_check_resumable_session() {
+  local mission_file=".mosaic/orchestrator/mission.json"
+  local lock_file=".mosaic/orchestrator/session.lock"
+
+  command -v jq &>/dev/null || return 0
+
+  if [[ -f "$lock_file" ]]; then
+    local pid
+    pid="$(jq -r '.pid // 0' "$lock_file" 2>/dev/null)"
+    if [[ -n "$pid" ]] && [[ "$pid" != "0" ]] && ! kill -0 "$pid" 2>/dev/null; then
+      echo "[mosaic] Previous orchestration session detected (crashed)."
+      echo "[mosaic] Run: mosaic coord resume"
+      echo ""
+    fi
+  elif [[ -f "$mission_file" ]]; then
+    local status
+    status="$(jq -r '.status // "inactive"' "$mission_file" 2>/dev/null)"
+    if [[ "$status" == "active" ]]; then
+      echo "[mosaic] Active mission detected. Generate continuation prompt with:"
+      echo "[mosaic]   mosaic coord continue"
+      echo ""
+    fi
+  fi
+}
+
 run_bootstrap() {
   check_mosaic_home
   exec "$MOSAIC_HOME/bin/mosaic-bootstrap-repo" "$@"
@@ -397,6 +481,7 @@ case "$command" in
   sync)       run_sync "$@" ;;
   seq)        run_seq "$@" ;;
   bootstrap)  run_bootstrap "$@" ;;
+  coord)      run_coord "$@" ;;
   upgrade)    run_upgrade "$@" ;;
   release-upgrade) run_release_upgrade "$@" ;;
   project-upgrade) run_project_upgrade "$@" ;;

bin/mosaic-doctor

@@ -172,6 +172,14 @@ expect_file "$MOSAIC_HOME/tools/git/ci-queue-wait.sh"
 expect_file "$MOSAIC_HOME/tools/git/pr-ci-wait.sh"
 expect_file "$MOSAIC_HOME/tools/orchestrator-matrix/transport/matrix_transport.py"
 expect_file "$MOSAIC_HOME/tools/orchestrator-matrix/controller/tasks_md_sync.py"
+expect_file "$MOSAIC_HOME/guides/ORCHESTRATOR-PROTOCOL.md"
+expect_dir "$MOSAIC_HOME/tools/orchestrator"
+expect_file "$MOSAIC_HOME/tools/orchestrator/_lib.sh"
+expect_file "$MOSAIC_HOME/tools/orchestrator/mission-init.sh"
+expect_file "$MOSAIC_HOME/tools/orchestrator/mission-status.sh"
+expect_file "$MOSAIC_HOME/tools/orchestrator/continue-prompt.sh"
+expect_file "$MOSAIC_HOME/tools/orchestrator/session-status.sh"
+expect_file "$MOSAIC_HOME/tools/orchestrator/session-resume.sh"
 expect_file "$MOSAIC_HOME/runtime/mcp/SEQUENTIAL-THINKING.json"
 expect_file "$MOSAIC_HOME/runtime/claude/RUNTIME.md"
 expect_file "$MOSAIC_HOME/runtime/codex/RUNTIME.md"