/proactive-loop

name: proactive-loop
description: "Start Sutando's autonomous proactive loop. Monitors tasks, runs health checks, and builds missing capabilities on a recurring schedule."
user-invocable: true

Proactive Loop

One pass = the numbered steps below, in order. Each step is a command, its exit codes, and what to do per code. The reasoning, measurements and incidents behind every step live in [`docs/proactive-loop-rationale.md`](../../docs/proactive-loop-rationale.md) under the same step number; read it when a step surprises you, never per pass. A rule belongs here only as a command a mechanism enforces; prose lessons go to the rationale doc (`tests/proactive-loop-skill-budget.test.py` caps this file and refuses date stamps in it).

**Usage**: `/proactive-loop [interval]` (default 10m).

On activation

1. `/schedule-crons` — registers the session crons and stamps them. 2. Task watcher via the `Monitor` tool: `command: 'bash src/watch-tasks-stream.sh'`, `persistent: true`, `description: 'Streaming task watcher'`. Each `TASK_FILE: <name>` line is one task to Read and process. 3. If `CronList` already shows a `main-loop` / `/proactive-loop` job, run the per-pass body directly — never add a second loop driver.

Per pass

`WORKSPACE="$(bash scripts/sutando-config.sh workspace)"` once; quote every `"$WORKSPACE/..."` path.

0. **Status.** `bash scripts/core-status.sh running "<what the owner is waiting on>"`; rewrite on every pivot; `bash scripts/core-status.sh idle` at the end. Never `>` the JSON yourself. 0.5. **Quota tier** (Claude core): `python3 $CLAUDE_CONFIG_DIR/skills/quota-tracker/scripts/read-quota.py | python3 skills/proactive-loop/scripts/quota-tier.py` → `TIER <FULL|MEDIUM|LIGHT|MINIMAL> (bound by …)`. Then `python3 skills/proactive-loop/scripts/claude-quota-cadence.py --json` → if `effective_cron` differs from the `/proactive-loop` job in `CronList`: capture the old job id, `CronCreate` the new job with `prompt: "/proactive-loop"` and `cron: <effective_cron>`, confirm it in `CronList`. Then `CronDelete` the old id and confirm exactly one `/proactive-loop` job remains. If create or confirmation fails, keep the old job and stop loudly. Codex core: `python3 skills/proactive-loop/scripts/codex-quota-gate.py --json`. Tier caps step 6's depth (LIGHT/MINIMAL: no self-development); it never skips owner tasks, health or the log. 0.7. **Reconstruct.** Invoke the `context-reconstruct` skill (a Skill-tool call, not a mention). It reads `<workspace>/hosts/<host>/current-track.md` first, then the live thread (`python3 src/discord-read.py <channel> --serving <channel>` when serving a task, `--operator` otherwise), pending questions, relay, build log. Trust the record over recall; maintain `current-track.md`. 1. **Tasks.** Process every file in `$WORKSPACE/tasks/`; `access_tier: team|other` → the sandboxed path. Group a thread with `[deduped: task-<latest>]`, staged under its FINAL name and gated into place — `results/` is claimed by a poller in under a second, and the checker reads the source id from the BASENAME, so a generic temp name makes it pass everything: `S="$WORKSPACE/state/dedup-staging/<file>"` then `python3 skills/proactive-loop/scripts/check-dedup-targets.py "$S" && mv -f "$S" "$WORKSPACE/results/<file>"` (0 clean · 1 the dedup delivers nothing · 2 cannot answer). All-notice groups use `[no-send]` on each. Marker semantics belong to `src/result_markers.py`; never re-implement them. Bind idle to it too: `python3 scripts/unanswered-tasks.py --workspace "$WORKSPACE" && bash scripts/core-status.sh idle` (1 = a task got no result, so idle does not run). 2. **Questions.** Read `<workspace>/hosts/<host>/pending-questions.md`; surface via `results/question-<ts>.txt` when voice is connected, plus a macOS notification. 3. **Health.** `python3 src/health-check.py`; fix with `--fix` what it can. A warn is a pointer into the record: before investigating, `grep -in "<entity from the warn TEXT>" "$H/pending-questions.md" "$H/current-track.md"` with `H="$WORKSPACE/hosts/$(bash scripts/sutando-config.sh host-label)"`; a zero means try another token, then `grep -n '^## ' "$H"/*.md` before concluding absence. Extend a hit; never re-file it. 3.4. **Zero-result rule**, chained so a refusal cannot be skipped: `python3 skills/proactive-loop/scripts/warn-already-triaged.py --claim "<the sentence>" && <the send>` (1 already parked → read and extend · 0 untriaged · 2 cannot answer, not a green light). A negative states its population inline — "0 of N matching X" — or nobody, including its author, can falsify it. Name what a non-zero looks like, run the positive control, suspect scope then shape, never in zsh. 3.45. **Duplicate issue gate**, chained so a refusal cannot be skipped: `python3 skills/proactive-loop/scripts/gh-duplicate-check.py --repo <owner/name> --title "<title>" && gh issue create --repo <owner/name> --title "..." --body-file <f>` (0 no candidate · 1 do not file, candidates named · 2 cannot answer). 3.5. **Policy.** `python3 skills/proactive-loop/scripts/self-development-enabled.py` → `disabled` skips 4–8, 10, 11. Owner-requested tasks, pending questions, health/service recovery and the watcher remain active. Manual `/proactive-loop` invocation does not override the policy. 3.6. **Tool suites.** `python3 skills/proactive-loop/scripts/tool-suites-check.py --workspace "$WORKSPACE" --repo "$PWD"` (0 pass · 1 a suite failed · 2 cannot answer). Extra suites are declared in `$WORKSPACE/hosts/<host>/tool-suites-extra.json`. It passes no argv to a suite. 4. **Build log.** Read `$WORKSPACE/build_log.md`; do not rebuild what works. 5. **Pick** the highest-ROI unblocked item: owner tasks and blockers, then peer `opinion-requested` / `review-requested` claims in #bot2bot, then voice reliability, then regressions, then the menu. Write the pick into the status `step`. 6. **Act.** A bl