REFERENCE
Job状態
コード上の7つのJobStatusと、それぞれの状態から取る操作を確認します。
このページの内容
状態一覧
blockedとcompletedはJobStatusではありません。表示や説明で独自の状態名を作らず、state schemaに定義された7種類を使います。
| 状態 | 意味 | 次の操作 |
|---|---|---|
running | 実行中 | stale表示でもrunner ownershipを確認。process生存中は待機 |
awaiting-resume | 人間の応答または再開待ち | 再開runbookの全ゲート確認後にresume |
awaiting-archive | merge・archive待ち | PR確認後に job archive <slug> |
failed | 実行失敗 | Job IDで原因を確認し、再開runbookへ |
terminated | 実行が停止 | Job IDで原因を確認し、再開runbookへ |
archived | アーカイブ済み | 操作不要 |
canceled | キャンセル済み | 操作不要 |
運用ビューが次の操作を導出する
running + stalerunner ownership確認 →
job resumeawaiting-resumeintegrity・worktree確認 →
job resumeawaiting-archive + PR merged
job archivefailed / terminated
job resumestaleはresume許可ではありません。 sidecarがないfresh checkoutでは、表示commandとresume commandのstale判定が一致しない場合があります。別machine・CI・schedulerにactive runがないことを確認します。
awaiting-archiveから人間が確認する内容と安全な完了順序はPR・merge・archiveを参照してください。
操作前に状態を確認する
jobIdまたはslugで詳細を表示できます。同じslugのjobが複数ある場合は最新updatedAtが選ばれるため、操作対象はJob IDで固定します。resumeはslugが一意であることを確認してから実行します。
npx specrunner job ls --all --json
npx specrunner job show <job-id>
# /recovery の全ゲート確認後
npx specrunner job resume my-featurejob showが表示するjournal integrity、lineage、costの読み方は監査と証跡、statusから再開点を決める手順は再開と状態照合を参照してください。