実行をまたいで残る状態（待ち行列・一時の worktree）に寿命と持ち主を持たせ、並行する実行が互いを塞がないようにする #2229

何が困るか

実行をまたいで残る状態（投稿の待ち行列・一時の worktree・状態ファイル）に寿命と持ち主が無い。並行する実行が残骸を積み、次の実行を塞ぐ。手で片付ける側が、実行中のものを消すおそれもある。

関連: #2221（承認の後の別のセッションのマージで止まる）、#2164・#2165（並行するプランの版数と触るファイル）。

修正レイヤー

実行をまたいで残る状態の寿命と持ち主を持つ層。 一時の置き場は lib/worktree_base.py に掃除を寄せ、merged-steps.py から呼ぶ。待ち行列は lib/post_queue.py の失敗の分類で、前の実行が積んだ項目の扱いを決める。

完了条件

• 状態ごとに持ち主（実行）と寿命が決まり、持ち主の終わった状態は自動で片付く
• 実行中の状態を、別の実行の片付けが消さない
• 前の実行の残りが、次の実行を止めない

要求と受け入れ条件

この節が要求の正である。上の「何が困るか」から「完了条件」までは起票時の文で、条件は下の「起票者の推定」の表で扱いを決め、受け入れ条件は下の AC1〜AC16 で置き換える。

依頼（原文）

• 状態ごとに持ち主（実行）と寿命が決まり、持ち主の終わった状態は自動で片付く
• 実行中の状態を、別の実行の片付けが消さない
• 前の実行の残りが、次の実行を止めない

（書き手: 起票者、日付: 2026-10-31。この課題の「完了条件」。利用者の指示の原文としては扱わない）

3. 並列実行に強い作りにする。実行をまたいで残る状態に寿命と持ち主を持たせ、承認の後の別のマージで止まらない（親 C・承認ゲート 2 の後に別のセッションが develop へマージすると、配布物の変わらない文書だけの PR でも承認を取り直す #2221）

（書き手: 不明、日付: 2026-10-31。マイルストーン「26 自律実行の信頼性」の説明の主題 3。2026-10-31 の新方針「並列に強く」を書き写した文と見られるが、利用者の原文を確かめられない）

子の課題の由来: #2085 は「利用者からの依頼（2026-10-23、Mac のディスクの空きが頻繁に無くなる件の調査）」と本文にあるが、依頼の原文は課題に無い。#2084 は carmo-screening #338 の振り返り（2026-10-21）で起票者が書いた。

起票者の推定

題・本文のうち、利用者の指示の原文に無く起票者が推して足した条件。承認ゲート 1 で利用者が確かめるまで、利用者の決定として扱わない。この課題には利用者の原文が無いため、条件はすべてここに並ぶ。

目的

• cross-review・cross-refactoring・merged を並行して回しても、ある実行が残した状態が別の実行を止めず、ディスクを埋めず、作業中の変更を消さない状態にする（Mission の「人の判断が要る所だけで止まる」。手で残骸を片付ける操作を無くす）

前提

• 前提 1: この課題は子の cross-review: 修正前のコミットの行を指す古い指摘が投稿の待ち行列の先頭で 422 になり、review が止まり続ける #2084（投稿キュー）と NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085（一時の置き場）を 1 つの設計で扱う。cross-refactoring の一時の worktree（rf<PR番号>）が merged の後片付けで外されず溜まる #1680（rf<n> が merged で外れない）は NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085 の受け入れ条件に含まれるため、ここで満たす。子の受け入れ条件は下の AC に取り込み、子の課題の本文は書き換えない
• 前提 2: 「実行」は、cross-review・cross-refactoring・merged の後片付け・Claude Code などのセッション（セッション開始 hook が状態ファイルを作るもの）・worktree-deps.sh のプロセス・テストのセッションのどれか 1 回を指す。持ち主はこの単位で記録する
• 前提 3: 自動の片付けの時点は「同じリポジトリで NDF の cross-review・cross-refactoring・merged の後片付けのどれかを実行したとき」とする。常駐のプロセスや cron は置かない。設計がこれより早い時点（セッションの終わりなど）を足すのは構わない
• 前提 4: 持ち主が終わったかを判定できない状態は、終わっていないとみなして残す（安全側）。判定の手段（プロセスの生存・PR の状態・記録の時刻）は設計が決める
• 前提 5: 片付けは git worktree remove と git branch -d のように git が拒めば止まる操作だけで行い、--force / -D を使わない（共通原則 C4）。未コミットの変更と未 push のコミットを持つ worktree は外さない（C3。作業を消さない）
• 前提 6: 一時の置き場は NDF_WORKTREE_BASE か ${TMPDIR:-/tmp} のままで、場所は変えない（どのプロジェクトでも同じ。Value 5）

対象範囲

含む:

• NDF が実行をまたいで残す状態の一覧と、それぞれの持ち主・寿命の取り決め（AC1）
• レビュー worktree（<NDF_WORKTREE_BASE>/<slug>/pr<n>・rf<n>）、ndf-worktree-<session>.json、ndf-deps.*、fix-pr<n>-*、ndf-tests-* の片付け
• cross-review の投稿キューで、以前の実行が積んだ項目が恒久に送れないときの扱い（cross-review: 修正前のコミットの行を指す古い指摘が投稿の待ち行列の先頭で 422 になり、review が止まり続ける #2084）
• 片付けの結果（外した・残した・理由）を結果の JSON の items へ出すこと

含まない:

• 承認の後の別のセッションのマージで止まる件（承認ゲート 2 の後に別のセッションが develop へマージすると、配布物の変わらない文書だけの PR でも承認を取り直す #2221）、並行するプランの版数と触るファイルの件（スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164・設計を持たない実装のプランが触るファイルを宣言せず、同時に流す別のプランと重なるとそのファイルを「変えない」と指示されて止まる #2165）
• 開発 worktree（.worktrees/<ブランチ名>）の片付けの規則の変更（merged の今の扱いのまま）
• relay の状態ディレクトリ（${XDG_STATE_HOME:-~/.local/state}/ndf/relay/）と supervise.py の状態の置き場
• 2026-10-31 時点で手元に残っている残骸を、この変更の外で手で消すこと（AC2〜AC6 の片付けを初めて回したときに片付く）

ドメインイベント

用語

受け入れ条件

持ち主と寿命:

• AC1: NDF が実行をまたいで残す状態（対象範囲の 5 種と投稿キューの項目）が 1 か所の一覧にあり、各行に置き場・持ち主・寿命・片付ける時点が書かれている。一覧に無い種類の残る状態を NDF のスクリプトが作ると、テストが落ちる

持ち主の終わった状態は自動で片付く:

• AC2: マージ済みの Pull Request n について merged-steps.py cleanup を実行すると、変更も未 push のコミットも持たない <NDF_WORKTREE_BASE>/<slug>/rf<n>（中の work を含む）が pr<n> と同じく外れ、git worktree list からもディレクトリからも消え、結果の items に removed で出る（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085・cross-refactoring の一時の worktree（rf<PR番号>）が merged の後片付けで外されず溜まる #1680）
• AC3: merged を通らずにマージされた、または閉じられた Pull Request のレビュー worktree（pr<n>・rf<n>）で、変更も未 push のコミットも持たないものは、前提 3 の時点の後に残らない（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085）
• AC4: 持ち主のセッションが終わった ndf-worktree-<session>.json は、前提 3 の時点の後に残らない（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085）
• AC5: 持ち主のプロセスが終わった ndf-deps.* は、trap が走らずにプロセスが止められた場合も、前提 3 の時点の後に残らない（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085）
• AC6: 持ち主の実行が終わった fix-pr<n>-* と ndf-tests-* は、AC1 の一覧の寿命を過ぎた後、前提 3 の時点かテストのセッションの終わりの後に残らない

実行中の状態を別の実行が消さない:

• AC7: open の Pull Request のレビュー worktree は、どの片付けを回しても外れない（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085）
• AC8: 前提: 実行 A が pr<n>（または rf<n>）を使って動いている。操作: 別の実行 B が同じリポジトリで片付けを回す。結果: A の worktree と状態ファイルは残り、B の結果の items に kept と理由が出る。Pull Request n が既にマージ済みでも同じ
• AC9: 生きているセッション・プロセスの ndf-worktree-<session>.json と ndf-deps.* は、別の実行の片付けで消えない（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085）
• AC10: 未コミットの変更か未 push のコミットを持つレビュー worktree は外れず、結果の items に kept と理由が出る。片付けは --force / -D を使わない（NDF の手順が TMPDIR に置く一時の worktree と状態のファイルが消されず溜まる（1 回分で数百 MB） #2085。rf1732/work の 23 件のような作業を消さない）

以前の実行の残りが次の実行を止めない:

• AC11: 投稿キューの先頭に以前の実行が積んだ review-post の項目があり、GitHub がその行を 422（line could not be resolved）で拒むとき、今回の post_review は今回分の review を送り終え、failed を返さない。先頭の項目は待ち行列から外れ、dropped/ の控えか総評のどちらかに残る。テストの偽の gh で確かめる（cross-review: 修正前のコミットの行を指す古い指摘が投稿の待ち行列の先頭で 422 になり、review が止まり続ける #2084）
• AC12: AC11 の後、新しいラウンドで post_review をもう一度呼ぶと、同じ項目の 422 で止まらない（待ち行列にその項目が積まれていない）（cross-review: 修正前のコミットの行を指す古い指摘が投稿の待ち行列の先頭で 422 になり、review が止まり続ける #2084）
• AC13: 先頭の項目が一時の失敗（429・5xx・上限）で送れないときは、今までどおり外さず、今回分も順序を保って待つ（waitable が真）（cross-review: 修正前のコミットの行を指す古い指摘が投稿の待ち行列の先頭で 422 になり、review が止まり続ける #2084）
• AC14: 位置エラーでない恒久の失敗（422 でも line could not be resolved を含まないもの・400・404 など）の review-post の項目と、別の実行が積んでまだ送りを試みていない項目は、今の扱い（飛ばさない・送る）を変えない。変えるなら設計 PR に理由を書く（cross-review: 修正前のコミットの行を指す古い指摘が投稿の待ち行列の先頭で 422 になり、review が止まり続ける #2084）
• AC15: 以前の実行が残したレビュー worktree（同じ pr<n>・rf<n>）があっても、次の cross-review / cross-refactoring の開始は失敗しない（使い直すか、外して作り直す）。未コミットの変更か未 push のコミットを持つものは消さず、開始を止めて理由を返す

退行しないこと:

• AC16: 既存のテスト（plugins/ndf 一式）が通る。merged-steps.py cleanup の結果の JSON の形（items の kind・state・理由）は、足す値を除いて変わらない

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

進行

モード: — / 進め方: auto

• 要求と受け入れ条件 — 2026-10-31 01:59
• 作業場所の用意 — 2026-10-31 03:59
• 設計 — 2026-10-31 02:02
• 素材の収集と出典の確定
• ドキュメント再構成
• ドキュメントレビュー
• 計画 — 2026-10-31 03:59
• 実装 — 2026-10-31 05:36
• 構造改善 — 2026-10-31 07:37
• 実装レビュー — 2026-10-31 09:12
• 完了判定 — 2026-10-31 06:18
• Pull Request — 2026-10-31 06:41
• 確定仕様化 — 2026-10-31 11:00
• 後片付け — 2026-10-31 10:57
• 配布 — 2026-10-31 10:33
• 体裁レビュー
• リリース後テスト — 2026-10-31 10:56
• 振り返り — 2026-10-31 11:00
• 棚卸し — 2026-10-31 11:21

振り返り: #2282 (comment)

リリース後テスト（v10.27.2）で残ったこと

AC1〜AC16 はすべてテストで合格。AC3〜AC5 の手動確認（手元の残骸が片付けの後に減ること）は保留（記録: #2281 (comment) ）。

• 10.27.2 の片付けは、持ち主の記録の無い残骸を最後に動いた時刻から 24 時間（寿命の窓）残す。2026-10-31 20:08 JST の時点の残骸（/tmp/ndf-worktrees/devbasex--ai-plugins/ の rf 6 本・pr 3 本、ndf-worktree-*.json 68 件、ndf-deps.* 57 件）はすべて窓の中で、削除を止めた判定の再現では全件 kept だった
• 確かめ直す時点: 持ち主の記録が残る rf2312 が窓を出る 2026-11-02 02:29 JST より後に、cross-review か merged を 1 回回してから件数を数える。合格の行を同じ記録の PR（Release: ndf v10.27.2 #2281）へ足し、sprint-close.py --record-pr 2281 --with-verification で閉じる
• 2026-11-01 17:23 JST の時点の残骸は rf 3 本・pr 2 本（1.5G）、ndf-worktree-*.json 30 件、ndf-deps.* 5 件。削除を止めた片付けの模擬では、rf2268 は窓を出て removed、pr2277・pr2278 は Pull Request が open のため kept（AC7）、rf2283 は未コミットの変更 1 件のため kept（AC10）、rf2312 は finished_at が無いまま持ち主の窓の中で kept（cross-refactoring の init が着手前テストの打ち切りで止まると、持ち主の記録が残り次の実行を 24 時間断る #2321 に当たる見込み）