PJR-0158 exec runにproject単位の実行ロックを追加しroutineのbusy-skipを実現
1. 概要
exec run全体をproject単位のheartbeatロックで排他。--if-busy skip/wait/fail(手動fail/routine skip)。routine-state.jsonにlast_result=skippedを追加。retryは次のcron tickに委ね待機なし。
exec run プロセス同士（routine 起動・手動・CI）の重なりを止めるガードが無く、provider の max_concurrency は 1 プロセス内でしか効かないため、同時 agent 数とレートリミットが想定を超える。同一タスクの二重実行は claim が防ぐため正しさの問題ではなく、リソース統制の課題である。project 単位の実行ロックを exec run に導入し、routine は busy なら skip する運用に統一する。
2. 完了条件
exec runが project スコープの実行ロックを run 全体のライフタイムで保持し、他プロセスのexec runを排他する（同一プロセス内の--parallelは阻害しない）。- ロックの stale 判定が固定 age ではなく heartbeat ベースで、長時間 run を stale 誤判定しない。crash 時は finally 解放と stale 奪取で回復する。
exec runに--if-busy <skip|wait|fail>を追加し、手動 CLI の既定はfail、routine 経由はskipを渡す。- routine の
exec-auto/exec-resume/registeraction が busy 時に skip し、[routine] skipped <id>: exec busyをログする。 routine-state.jsonのlast_resultにskippedを追加し、routine listで failure と区別して表示する。skip は failure 扱いにしない。- retry は次の cron tick に委ね、単一 routine 実行内での待機は実装しない。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | project スコープの exec-run.lock（heartbeat/stale/finally解放）実装 | codex-expert-edit-agent | done | 既存 scheduler.lock とは別レイヤ |
| 2 | exec run に --if-busy <skip|wait|fail> 追加 | codex-expert-edit-agent | done | 手動既定 fail |
| 3 | routine 各 action へ --if-busy skip 引き渡しと skip ログ | codex-expert-edit-agent | done | buildExecAutoArgs 等 |
| 4 | routine-state.json last_result に skipped 追加・list 表示 | codex-expert-edit-agent | done | failure と区別して表示 |
| 5 | ガイド更新（exec-operation / exec-config / routine-operation） | codex-expert-edit-agent | done | 排他モデルと --if-busy を記載 |
| 6 | テスト追加（ロック排他・skip 記録・list 表示） | codex-expert-edit-agent | done | vitest |
4. 対応結果
execution_path/exec/.locks/exec-run.lockを追加し、所有トークン、別プロセス heartbeat、stale lock の rename 奪取、所有者一致時だけの解放を実装した。exec runとexec resumeの実行全体を project 単位で排他し、--if-busy skip|wait|fail（既定fail）を追加した。- routine の
register/exec-auto/exec-resumeから--if-busy skipを渡し、busy 時に[routine] skipped <id>: exec busyを出力してlast_result: skippedを記録するようにした。 routine listが(skipped)を表示し、skip を failure 件数・終了コードに含めないことを実装した。- specdojo:exec-operation-guide、specdojo:exec-config-guide、specdojo:routine-operation-guide に排他モデルと運用方法を反映した。
- ロック排他、wait、heartbeat、stale 回復、CLI busy 方針、routine 引数・表示のテストを追加した。