fix(cli-pr-monitor): 並列テスト flaky を tempfile 一意化と state path DI で構造的に解消

[aloekun]

概要

cli-pr-monitor の並列テストで断続的に発生していた flaky test を構造的に解消する。原因は独立した 2 系統あり、それぞれ別コミットで修正した。加えて完了済みの todo エントリを整理する。

変更内容

1. create_pr temp-file flaky の解消 (tempfile crate + dir injection)

convert_body_to_file が --body-file 用一時ファイルを pid + ms 命名で生成していたため、並列 cargo test（同一プロセス・同一 ms）で名前が衝突し flaky 化していた。

• tempfile crate を導入し O_EXCL + ランダム名 + 衝突時リトライで一意名を生成
• 生成先ディレクトリを引数注入（本番は std::env::temp_dir()、テストは専用 tempdir() を注入して本番 namespace から分離）
• Drop guard を自前 TempFile struct から tempfile::TempPath に置換

2. parallel-test flaky の解消 (state path DI + env-var global 除去)

state ファイルパスを env-var 経由の ambient global で解決していたため、並列テスト間で競合していた。共有グローバルやロックではなく依存注入で根本解決する方針に沿う。

• state path を全レイヤー（monitor / poll / rate_limit / review_recheck）に引数注入
• env-var global を撤去

3. docs(todo) の整理

完了済みエントリ（順位 229・230）を todo-summary.md / todo13.md から削除。

テスト

push pipeline の品質ゲート（clippy / cargo test / cargo test --ignored）で検証済み。

Summary by CodeRabbit

• Bug Fixes

  • 一時ファイルや状態ファイルの競合を避けるようになり、並列実行や不安定なテストに起因する問題が減りました。
  • 状態保存・読み取りがより明示的になり、監視や再開処理の信頼性が向上しました。

• Chores

  • 内部の状態管理まわりの実装整理により、環境差による挙動のぶれを抑えました。

[coderabbitai]

📝 Walkthrough

Walkthrough

PR_MONITOR_STATE_FILE_OVERRIDE 環境変数と env_override_lock によるグローバルな状態ファイル切り替え機構を廃止し、write_state/read_state ラッパーを削除。PollContext に state_path: &Path フィールドを追加して、monitor・poll・rate_limit・review_recheck・create_pr の各ステージへ明示的なファイルパスを伝播する形に統一した。

Changes

明示的な state_path 注入リファクタリング

Layer / File(s)	Summary
state.rs: ラッパー削除と state_file_path 単純化 src/cli-pr-monitor/src/state.rs, src/cli-pr-monitor/Cargo.toml	state_file_path() から PR_MONITOR_STATE_FILE_OVERRIDE 参照を除去し常に実行ファイル配下を返すよう変更。write_state/read_state ラッパーを削除。tempfile を dev-dependencies から dependencies に昇格。
PollContext への state_path 追加と run_poll_loop 配線 src/cli-pr-monitor/src/stages/poll/mod.rs	PollContext に state_path: &'a Path を追加し、run_poll_loop で state_file_path() から取得した値を注入するよう変更。
monitor.rs: 状態読み書きをパス明示に変更 src/cli-pr-monitor/src/stages/monitor.rs	write_state/read_state を write_state_to(&state_file_path(), ...)/read_state_from(...) に置き換え、resume_fix_push_time_or_started_at に state_path: &Path 引数を追加。テストから env override を削除。
iteration.rs: state_path の伝播 src/cli-pr-monitor/src/stages/poll/iteration.rs	build_state_for_iteration・enrich_with_classifier・handle_rate_limit_branch に state_path を追加し、read_state_from/write_state_to に切り替え。テストは tempdir で state.json パスを生成して注入。
rate_limit.rs: finalize_* への state_path 伝播 src/cli-pr-monitor/src/stages/poll/rate_limit.rs	handle_rate_limit_branch/dispatch_rate_limit_outcome/finalize_posted_retrigger/finalize_parked に state_path 引数を追加し write_state_to に置換。テストは env override を廃止し unwritable_state_path() を直接渡す形に変更。
review_recheck.rs: ctx.state_path 経由の読み書きとテスト更新 src/cli-pr-monitor/src/stages/poll/review_recheck.rs	finalize_initial_review_park/finalize_review_recheck_park/finalize_review_recheck_max_reached/schedule_next_review_recheck_park を ctx.state_path 経由の read_state_from/write_state_to に変更。テストは env 変数操作を全廃し tempdir + state_path 注入に統一。
poll/mod.rs テスト・review_recheck_signal.rs テスト src/cli-pr-monitor/src/stages/poll/mod.rs, src/cli-pr-monitor/src/stages/poll/review_recheck_signal.rs	invoke_finalize_*_with_bad_path ヘルパーに state_path 引数を追加して PollContext に注入。env_override_lock/set_var/remove_var を全廃。review_recheck_signal.rs のテストでは PollContext 初期化に state_path: Path::new("unused") を追加。
create_pr.rs: TempPath 導入と配線変更 src/cli-pr-monitor/src/stages/create_pr.rs	カスタム TempFile を廃止し write_body_tempfile で tempfile::TempPath を返す形に変更。convert_body_to_file に temp_dir: &Path を追加し Option<TempPath> を返す形に変更。write_early_reset_state を write_state_to に切り替え。
docs: 完了タスクの削除 docs/todo13.md, docs/todo-summary.md	env_override_lock 共有化と create_pr::tests flaky 修正の2タスクエントリを削除。

推定コードレビュー工数

🎯 3 (Moderate) | ⏱️ ~25 minutes

関連する可能性のある PR

• aloekun/claude-code-hook-test#224: stages/poll/* の poll モジュール分割と iteration/signal 構造を導入した PR で、本 PR が同モジュールの state_path 伝播リファクタリングを直接実施している。
• aloekun/claude-code-hook-test#214: rate_limit.rs/review_recheck.rs の finalize_* API を導入した PR で、本 PR がそれらのシグネチャに state_path 引数を追加している。
• aloekun/claude-code-hook-test#114: review_recheck park モデルと PrMonitorState フィールドを実装した PR で、本 PR がその状態永続化を ctx.state_path 経由に変更している。

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	cli-pr-monitor の並列テスト flaky を、tempfile の一意化と state path DI で解消する変更を的確に要約しています。
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/cli-pr-monitor/src/stages/create_pr.rs`:
- Around line 207-208: `write_early_reset_state()` is still resolving
`state_file_path()` internally, so it can’t be isolated from the other state
operations in `run_create_pr`. Update `run_create_pr` to accept and pass a
`state_path: &Path` into `write_early_reset_state()`, and change that helper to
use the provided path when calling `write_state_to()`. This will let tests
inject a tempdir-backed state file and avoid sharing state across parallel or
repeated runs.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7e1a4830-62bf-4b65-a0b1-f1222f228f38

📥 Commits

Reviewing files that changed from the base of the PR and between e193714 and cfe2f2d.

📒 Files selected for processing (11)

• docs/todo-summary.md
• docs/todo13.md
• src/cli-pr-monitor/Cargo.toml
• src/cli-pr-monitor/src/stages/create_pr.rs
• src/cli-pr-monitor/src/stages/monitor.rs
• src/cli-pr-monitor/src/stages/poll/iteration.rs
• src/cli-pr-monitor/src/stages/poll/mod.rs
• src/cli-pr-monitor/src/stages/poll/rate_limit.rs
• src/cli-pr-monitor/src/stages/poll/review_recheck.rs
• src/cli-pr-monitor/src/stages/poll/review_recheck_signal.rs
• src/cli-pr-monitor/src/state.rs

💤 Files with no reviewable changes (2)

• docs/todo13.md
• docs/todo-summary.md