[takemi-ohama]

スプリント l20261031-5 の課題を develop へ取り込む。

利用者向けの変化

• ndf の cross-refactoring は、想定最大時間を省くと下限の値で動きます。（#2047 を実装する（スプリント l20261031-5） #2307）
• ndf の cross-refactoring は、時間の枠が足りないときに、リファクタリングを飛ばした結果を返します。（#2047 を実装する（スプリント l20261031-5） #2307）
• ndf の supervise は、飛ばしたリファクタリングを止めずにコードレビューへ進めます。（#2047 を実装する（スプリント l20261031-5） #2307）
• ndf の supervise は、駆動の見込みに合わせてステップの締め切りを延ばします。（#2047 を実装する（スプリント l20261031-5） #2307）

移行の手順

• ndf の cross-refactoring: 書き出し済みのプランは自動では書き直しません。古いプランで止まったときは、今と同じく --refactor-budget-minutes を付けてプランを書き直してください。（#2047 を実装する（スプリント l20261031-5） #2307）

課題と設計

• 課題: 全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291 検査のプランの構造改善が既定の予算で下限に届かず、33 行の差分でも refactor が落ちて abort へ進む #2047
• 無し
• 設計: 全体テスト: 手元と PR の CI の両方で 3 分以内に終わり、打ち切ってもプロセスを残さない（#2291） #2304 検査のプラン: 想定最大時間を省いてもリファクタリングが下限の時間で通り、収まらないときはコードレビューへ進む（#2047） #2301

コミット

• Test: pytest が止められたときと終わったときに、テストが起こした子孫のプロセスを止める（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Feat: 全体テストを同じ条件で測り、着手前後のテストの集合を照らす実験版を足す（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Docs: テストを削る基準と速くする手段を開発ガイドに置く（意味の薄いテストを徹底的に削る: 削る基準を決めて要らないテストを消す（全体テストを 3 分以内にする #2291 の削る側） #2204・全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• CI: Python tests で同じ PR の古い実行を取り消し、uv をキャッシュつきで入れる（PR の pytest が 1 回 10〜13 分かかり、push のたびに古い実行も止まらず走り直す #2154・全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Test: 用語集のテストの分岐をプロセスの中で確かめ、重複と総当たりのテストを絞る（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291・意味の薄いテストを徹底的に削る: 削る基準を決めて要らないテストを消す（全体テストを 3 分以内にする #2291 の削る側） #2204）
• Test: supervise・リリース・宣言などのテストの分岐をプロセスの中で確かめる（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Test: 中継のテストの固定の待ちを、子が端末を raw にした印と既存の待ちの環境変数で縮める（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Test: 指示書の検査・スプリントの終わり・PR の手順などのテストの分岐をプロセスの中で確かめる（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Test: cross-refactoring の init のテストの git の準備をプロセスごとに 1 度作って複製する（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Fix: 計測の実験版の関数の名前を lib の同名の関数と分ける（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Docs: 根の conftest の説明に子孫のプロセスの後始末を足す（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• feat(cross-refactoring): 想定最大時間を省いたら下限まで上げ、時間の枠の不足は飛ばした結果で返す（検査のプランの構造改善が既定の予算で下限に届かず、33 行の差分でも refactor が落ちて abort へ進む #2047）
• feat(supervise): 飛ばしたリファクタリングをコードレビューへ進め、駆動の見込みでステップの締め切りを延ばす（検査のプランの構造改善が既定の予算で下限に届かず、33 行の差分でも refactor が落ちて abort へ進む #2047）
• fix: script-structure の行数の例外リストを 検査のプランの構造改善が既定の予算で下限に届かず、33 行の差分でも refactor が落ちて abort へ進む #2047 で増えた分へ更新する（cross-refactoring の drive.py・setup.py）
• docs(検査のプランの構造改善が既定の予算で下限に届かず、33 行の差分でも refactor が落ちて abort へ進む #2047): 確定仕様と締め切りの式の正本を、着手前のテストの見込み・想定最大時間の引き上げ・ステップの延長に合わせる
• docs: 仕様の文から課題番号の由来を外す（doc-lint）
• Merge pull request #2047 を実装する（スプリント l20261031-5） #2307 from devbasex/feat/issue-2047-l20261031-5
• Docs: 全体テストの着手前後の実測と遅いテストの表を台帳に書く（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Docs: 打ち切りの後にテストのプロセスが残らないことを確かめた結果を台帳に書く（全体テストが重すぎて工程の時間の枠に収まらない。手元の全体テストを 3 分以内にする #2291）
• Merge remote-tracking branch 'origin/sprint/l20261031-5' into feat/issue-2291-l20261031-5
• Merge pull request #2291 を実装する（スプリント l20261031-5） #2311 from devbasex/feat/issue-2291-l20261031-5

変更の統計

 .../scripts/refactor_lib/allocation.py             |   1 +
 .../scripts/refactor_lib/commands/report.py        |  10 +-
 .../scripts/refactor_lib/commands/setup.py         |  20 +-
 .../scripts/refactor_lib/init_test.py              |  96 ++++++++--
 .../cross-refactoring/scripts/refactor_lib/plan.py |   2 +-
 .../scripts/refactor_lib/timeline.py               |   7 +-
 .../cross-refactoring/tests/test_drive_contract.py |  61 ++++++
 .../skills/cross-refactoring/tests/test_init.py    | 162 +++++++++++++++-
 scripts/pytest_child_cleanup.py                    | 195 +++++++++++++++++++
 ...ross-refactoring__scripts__drive.py--lines.json |   2 +-
 ...s__refactor_lib__commands__setup.py--lines.json |   2 +-
 scripts/tests/test_check_script_structure.py       |   6 -
 scripts/tests/test_pytest_child_cleanup.py         | 145 ++++++++++++++
 scripts/tests/test_root_conftest.py                |  32 +---
 59 files changed, 1612 insertions(+), 191 deletions(-)

テスト（supervise.py の run のステップ）

ステップ	exit	最後の行
collect	0

集めた実装の PR

• #2047 を実装する（スプリント l20261031-5） #2307: 変化あり
• #2291 を実装する（スプリント l20261031-5） #2311: 利用者向けの変化なし

閉じる課題

Closes #2047
Closes #2154
Closes #2204
Closes #2291

手動確認

• 検査のプランの構造改善が既定の予算で下限に届かず、33 行の差分でも refactor が落ちて abort へ進む #2047 リリース後テストへ回す: 次のスプリントの検査のプランを想定最大時間を省いて書き、リファクタリングが下限の想定最大時間で通るか、飛ばしてコードレビューへ進むかを、フェーズレポートと状態ファイルで見る（リリース後テストで確かめる）

モード: standard / 通した工程: 実装 → Pull Request

🤖 Generated with Claude Code

[takemi-ohama]

🤖 cross-review | round 1 | codex | APPROVE

指定された59ファイルの差分に、基準に該当する critical / major の修正指摘はありません。

[takemi-ohama]

🤖 cross-review | round 1 | kiro | APPROVE

59 ファイルを読んだ。時間の枠の不足で refactor を飛ばす経路（exit 6・gaps・on_exit {"6":"review"}）、想定最大時間を省いたときの下限への引き上げ（settle_window）、子が書くステップの延長（NDF_STEP_EXTEND_FILE）、pytest の子孫プロセスの後始末（pytest_child_cleanup.py）、CI のキャッシュと concurrency、テストの in-proc 化を確認した。engine.py の on_exit は on_fail より先に見るため exit 6→review の遷移は成立する。run_ticking の extend は simultaneous 代入で timeout=longer に揃い、再延長と締め切りの前倒しが起きない。settle_window の floor 引き上げと grace_seconds=0 は設計文書と一致する。CI のキャッシュ・concurrency は所要と費用を下げる方向で、在庫の手元テストも subprocess から main() 呼びへ移して時間を縮めている。critical / major の基準（普通の経路での誤動作・秘密/データ/戻せない操作・トークン/時間/回数を増やす変更・実装を誤らせる設計の食い違い）に当たる指摘は見つからなかった。

[takemi-ohama]

🔧 /ndf:fix サマリ | commit (なし)

対応件数: critical=0 / major=0 / minor=0（合計 0 件）
決着: 0 件 / 見送り: 0 件 / 却下: 0 件
CI: NONE