refactor(cli-push-runner): config.rs + stages/lint_screen.rs を 800 行以下に module 分割 (PR-W4)

[aloekun]

概要

file-length-enforcement-plan の PR-W4: cli-push-runner の 800 行超 2 ファイルを module 分割。

mechanical refactor / behavior 不変 / test count 不変 (168 tests、baseline から変化なし)。

分割内容

元ファイル	分割後	最大行数
config.rs (946 行)	config/{mod,lint_screen,pr_size_check,scratch_file_warning}.rs	429
stages/lint_screen.rs (982 行)	stages/lint_screen/{mod,classifier,diff_filter,report}.rs	415

全ファイル ≤ 800 行を達成。

config/ の分割方針

• mod.rs: Config 集約構造体 + config_path / load_config / validate_config + 共通定数 + 再エクスポート
• lint_screen.rs: LintScreenConfig + LINT_SCREEN_ENABLED env override 解釈
• pr_size_check.rs: PrSizeCheckConfig + 順位 151 定数
• scratch_file_warning.rs: ScratchFileWarningConfig

stages/lint_screen/ の分割方針

• mod.rs: orchestration (run_lint_screen + params 解決 + diff 読み込み)
• classifier.rs: cli-finding-classifier.exe の subprocess 起動
• report.rs: classifier 出力 (JSON) の markdown 整形 + 書き出し
• diff_filter.rs: LLM 入力前の diff 前処理 (対象外拡張子除外 + metadata strip)

制約遵守 (Phase 1 共通)

• pre-existing 非 doc コメントは移動時に削除 (config_path → exe_adjacent_config_path 分割で意図を表現)
• 関数長 50 行: invoke_classifier から spawn_classifier を抽出
• cross-module visibility は pub(crate) / pub(super)
• test helper は per-module duplicate (共有 util module を作らない)

検証

• ✅ cargo test -p cli-push-runner: 168 passed (baseline 不変)
• ✅ cargo clippy --workspace -- -D warnings: clean
• ✅ cargo fmt: clean
• ✅ 全ファイル ≤ 800 行
• ✅ cargo test --workspace: regression なし

同梱の docs コミット (mechanical refactor とは別コミット)

イテレーションコスト低減のため、前セッションのフィードバック由来 docs 変更を本 PR に同梱 (コミットは分離):

• docs(plan): PR-W3 land 済 (refactor(cli-merge-pipeline): feedback.rs + main.rs を 800 行以下に module 分割 (PR-W3) #230) 更新
• docs(todo): PR refactor(cli-merge-pipeline): feedback.rs + main.rs を 800 行以下に module 分割 (PR-W3) #230 post-merge-feedback 採用 4 件登録 (順位 238-241)
• docs(plan): PR-W4 分割に伴う lint_screen.rs / config.rs のリンクを module ディレクトリに更新

PR size

~8900 行の diff (削除 + 追加) だが mechanical な file 移動が主体。PR_SIZE_CHECK_OVERRIDE=1 で pre-push の pr_size_check を意図的バイパス (順位 151 の override 想定 use case)。

Summary by CodeRabbit

• New Features

  • push 時のチェック機能に、差分サイズやスクラッチファイル警告などの設定が追加されました。
  • lint-screen の有効/無効を環境変数で上書きできるようになりました。

• Bug Fixes

  • 一部の差分処理で、Markdown など対象外ファイルを自動的に除外するようになりました。
  • 失敗時の出力がより分かりやすくなり、結果の記録も安定しました。

• Documentation

  • 実装進捗と作業予定のドキュメントを最新状態に更新しました。

[coderabbitai]

📝 Walkthrough

Walkthrough

cli-push-runner の設定読み込み(config.rs)とlint-screenステージ(stages/lint_screen.rs)がそれぞれ複数のサブモジュール(config/mod.rs, config/lint_screen.rs, config/pr_size_check.rs, config/scratch_file_warning.rs / stages/lint_screen/mod.rs, classifier.rs, diff_filter.rs, report.rs)へ分割された。合わせて計画ドキュメントとTODOドキュメントが更新された。

Changes

cli-push-runner モジュール分割とドキュメント更新

Layer / File(s)	Summary
Config コア構造とロード処理 src/cli-push-runner/src/config.rs(削除), src/cli-push-runner/src/config/mod.rs	旧config.rsを削除し、Config構造体・config_path・load_config/validate_configをconfig/mod.rsへ新設。TOMLパース・quality_gate検証のテストも追加。
サブ設定モジュール src/cli-push-runner/src/config/lint_screen.rs, .../pr_size_check.rs, .../scratch_file_warning.rs	LintScreenConfigとLINT_SCREEN_ENABLED環境変数オーバーライド、PrSizeCheckConfig、ScratchFileWarningConfigをそれぞれ独立ファイルに定義し、パース挙動テストを追加。
lint-screenステージのdiff読込・フィルタ src/cli-push-runner/src/stages/lint_screen.rs(削除), .../stages/lint_screen/mod.rs, .../diff_filter.rs	旧stages/lint_screen.rsを削除し、run_lint_screenのフロー（diff読込、行数上限/空判定、除外ハンク処理、メタデータ除去）をmod.rsとdiff_filter.rsへ分割実装。
classifier起動とレポート出力 src/cli-push-runner/src/stages/lint_screen/classifier.rs, .../report.rs	classifier.exeのサブプロセス起動・タイムアウト判定を実装し、レポート/skip-reportのMarkdown生成・書き出しロジックを追加。
計画/TODOドキュメント更新 docs/file-length-enforcement-plan.md, docs/todo-summary.md, docs/todo13.md	PR-W3のland済ステータス反映、PR-W4の参照パス更新、post-merge-feedback由来の新規タスク（gh直叩き禁止lint、filter_transcripts決定論化、takt.rsエラー握り潰し解消、pub(crate)方針明文化）を追記。

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related PRs

• aloekun/claude-code-hook-test#132: 同じlint-screen機能に対する先行実装で、本PRがconfig.rsとstages/lint_screen.rsをモジュール分割へリファクタリングしている対象。
• aloekun/claude-code-hook-test#147: LINT_SCREEN_ENABLED環境変数オーバーライドロジックの元実装で、本PRでconfig/lint_screen.rsへ再配置された。
• aloekun/claude-code-hook-test#155: markdownハンク除外機能の元実装で、本PRのdiff_filter.rsのfilter_excluded_hunksへ継承されている。

Poem

• コードの兎、モジュールを跳ね
• config.rsは去り、mod.rsが咲く
• lint-screenは四つに分かれ
• diff読み、フィルタし、レポート書く
• TODOに新芽、進捗の跡も残す 🐇

🚥 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	config.rs と stages/lint_screen.rs をモジュール分割する変更を正確に要約しており、内容と一致しています。
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-push-runner/src/stages/lint_screen/classifier.rs`:
- Around line 46-67: In classifier.rs, the current spawn/order in the stage
logic can deadlock because stdin.write_all() runs before stdout/stderr draining
starts. Reorder the flow around spawn_classifier, drain_pipe_capped, and
wait_with_timeout_basic so the stdout/stderr drain threads are started before
writing diff to child.stdin, or move the stdin write onto a separate thread with
timeout protection. Keep the existing exit handling and error mapping intact
while ensuring large diffs cannot block the push pipeline.

🪄 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: d04afcde-094a-4042-ba0b-17807496412a

📥 Commits

Reviewing files that changed from the base of the PR and between 3e7fdf9 and c744bb1.

📒 Files selected for processing (13)

• docs/file-length-enforcement-plan.md
• docs/todo-summary.md
• docs/todo13.md
• src/cli-push-runner/src/config.rs
• src/cli-push-runner/src/config/lint_screen.rs
• src/cli-push-runner/src/config/mod.rs
• src/cli-push-runner/src/config/pr_size_check.rs
• src/cli-push-runner/src/config/scratch_file_warning.rs
• src/cli-push-runner/src/stages/lint_screen.rs
• src/cli-push-runner/src/stages/lint_screen/classifier.rs
• src/cli-push-runner/src/stages/lint_screen/diff_filter.rs
• src/cli-push-runner/src/stages/lint_screen/mod.rs
• src/cli-push-runner/src/stages/lint_screen/report.rs

💤 Files with no reviewable changes (2)

• src/cli-push-runner/src/stages/lint_screen.rs
• src/cli-push-runner/src/config.rs