Skip to content

docs(todo): WP-16 系 post-merge feedback 採用 5 件を todo14 に登録 (順位 359-363) - #346

Merged
aloekun merged 1 commit into
masterfrom
docs/wp16-feedback-todos
Aug 2, 2026
Merged

docs(todo): WP-16 系 post-merge feedback 採用 5 件を todo14 に登録 (順位 359-363)#346
aloekun merged 1 commit into
masterfrom
docs/wp16-feedback-todos

Conversation

@aloekun

@aloekun aloekun commented Aug 2, 2026

Copy link
Copy Markdown
Owner

Summary

Context

Why: WP-16 関連 4 PR (#342-#345) の post-merge feedback レポートから採用候補 14 件を系統別に整理し、「文書系 10 件 = 1 docs バッチ PR、実装系 4 件 = A/B 系統別 PR」の方針でユーザー承認を得た。本 PR はその todo 登録 (ADR-033: 詳細 = todo14.md、順位 table = todo-summary2.md 末尾)。

重複統合: #343 T2-3 は #342 T2-1 と同一提案のため順位 360 に統合 (連続指摘の事実は Frequency High の根拠として反映)。#345 は採用候補 0 件。様子見 6 件・却下推奨 9 件は本 PR の対象外 (未確定のまま)。

Validation

  • pnpm lint:docs OK (preamble + cross-ref + priority-inversion、summary 両ファイル統合検査)
  • markdownlint 対象 2 ファイル 0 error
  • pnpm push pre-push review: simplicity / security 両 approved (docs-only routing、pr_size 126 行)

References

Summary by CodeRabbit

  • ドキュメント
    • WP-16 関連の文書整備タスクを追加しました。
    • cargo test の対象範囲とコマンド等価性、JJ_VERSION の同期状態を検証する計画を記録しました。
    • Git 操作におけるブランチ名依存の検出、および detached HEAD 環境での CI 回帰テストに関するタスクを追加しました。
    • 各タスクに背景、対処案、参照情報、作業計画、完了基準を記載しました。

PR #342/#343/#344 の post-merge feedback 採用候補 14 件のうち、2026-08-02 の
方針決定 (文書系 10 件 = 1 docs バッチ PR、実装系 4 件 = A/B 系統別 PR) に従い
5 エントリとして登録:

- 順位 359: 文書系 10 件の docs バッチ (dev-conventions 集中、Severity High 2 件含む)
- 順位 360: cargo test コマンド等価性検証テスト (#342/#343 で連続指摘 = Frequency High)
- 順位 361: JJ_VERSION の 2 ファイル一致検証テスト (順位 360 と同一 PR 可)
- 順位 362: git subprocess ブランチ名依存引数の custom lint rule (#343 incident 由来)
- 順位 363: check-ci-coderabbit の detached HEAD 回帰統合テスト (順位 362 と同一 PR 可)
@coderabbitai

coderabbitai Bot commented Aug 2, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

WP-16 系の post-merge feedback に基づく TODO を追加しました。文書整備、Cargo と JJ_VERSION の整合性検証、Git subprocess の lint、detached HEAD の回帰テスト計画を記録しています。

Changes

WP-16 TODO 更新

Layer / File(s) Summary
文書整備タスク
docs/todo14.md, docs/todo-summary2.md
WP-16 系の文書作業と反映条件を TODO に追加しました。対応項目を todo-summary2.md に集約しました。
Cargo と JJ_VERSION の整合性検証
docs/todo14.md
cargo testcargo test --workspace の対象範囲、および .github/workflows/ci.ymlscripts/cloud-setup.shJJ_VERSION 一致を検証する計画を追加しました。
Git 経路の回帰検証
docs/todo14.md
ブランチ名依存の Git subprocess を検出する custom lint と、detached HEAD の CI 状態解決を検証する統合テスト計画を追加しました。

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

🚥 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 タイトルは、WP-16 系の post-merge feedback 5 件を todo14 に登録する主な変更を具体的かつ簡潔に示しています。
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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 unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/wp16-feedback-todos

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

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

@aloekun

aloekun commented Aug 2, 2026

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 2, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 `@docs/todo14.md`:
- Around line 774-792: 新設する detached HEAD 統合テストで、実際に fetch_ci の repo と pr を使う gh
pr view 経路を実行し、偽の gh 実行ファイルで「pr view <pr> --repo
<repo>」の引数と呼び出しを検証してください。parse_ci_rollup
やソース構造だけに依存せず、空のブランチ名へ回帰すると失敗するテストにし、通常の cargo test で実行可能にするか、CI で cargo test --
--ignored --test-threads=1 を明示的に実行できる設定を追加してください。
🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5e3ea232-9ed5-4a0b-a780-52cbf5106358

📥 Commits

Reviewing files that changed from the base of the PR and between e79b863 and 05ed5d0.

📒 Files selected for processing (2)
  • docs/todo-summary2.md
  • docs/todo14.md

Comment thread docs/todo14.md
Comment on lines +774 to +792
### check-ci-coderabbit の detached HEAD 回帰統合テスト

> **動機**: PR #343 で修正した「jj colocated (detached HEAD) 環境で CI 状態が恒久 pending 化する」バグの regression test が皆無 (`src/check-ci-coderabbit/tests/` 自体が不在)。再発時は監視の自律ループが再び silent に破綻する。#343 T2-1 採用。
>
> **対処案**: temp dir に jj colocated repo (detached HEAD) を組み、CI 状態解決が statusCheckRollup ベースで機能すること (旧経路のようにブランチ名解決依存で空にならないこと) を検証する統合テストを新設する。gh 呼び出しは実 API に依存しない形 (parse 層の既存単体テスト + 経路の構造検証) を基本とし、実 jj spawn が必要な部分は lib-jj-helpers の `#[ignore]` + 直列実行パターンを踏襲する。
>
> **参照**: `.claude/feedback-reports/343.md` Tier2 #1、`src/check-ci-coderabbit/src/main.rs` (`fetch_ci`) / `src/check-ci-coderabbit/src/parsers.rs` (`parse_ci_rollup` 単体テスト群 = 既存資産)。順位 362 と同一 PR (B 系統) にまとめてよい。
>
> **実行優先度**: 🔧 Tier 2 — Severity Medium / Frequency Low / Effort M / Adoption Risk None。

#### 作業計画

- [ ] detached HEAD 環境での CI 状態解決を検証する統合テストを新設
- [ ] ブランチ名依存の旧経路への回帰が fail することを確認
- [ ] 本エントリ削除 + todo-summary2.md 行削除

#### 完了基準

- detached HEAD 環境で CI 状態が pending に固着する回帰が、テスト失敗として land 前に検出されること。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | 🏗️ Heavy lift

🧩 Analysis chain

🏁 Script executed:

#!/usr/bin/env bash
set -euo pipefail

rg -n -C 4 '#\[ignore\]|--ignored|--include-ignored|test-threads|cargo test' \
  .github scripts src/check-ci-coderabbit Cargo.toml

Repository: aloekun/claude-code-hook-test

Length of output: 159


🏁 Script executed:

#!/usr/bin/env bash
set -euo pipefail

echo "== files =="
git ls-files | rg '(^|/)(docs/todo14\.md|src/check-ci-coderabbit/src/main\.rs|src/check-ci-coderabbit/src/.*\.rs|Cargo\.toml|README\.md)' || true

echo "== doc excerpt =="
sed -n '760,802p' docs/todo14.md 2>/dev/null || true

echo "== outline check-ci-coderabbit =="
ast-grep outline src/check-ci-coderabbit/src/main.rs --view compact 2>/dev/null || true

echo "== main relevant excerpt =="
sed -n '320,410p' src/check-ci-coderabbit/src/main.rs 2>/dev/null || true

echo "== tests directory =="
git ls-files src/check-ci-coderabbit | sort

echo "== grep ignore/test hints minimal =="
rg -n -C 2 '#\[ignore\]|--ignored|--include-ignored|test-threads|cargo test|fetch_ci|derive_ci|get_repo|repo.*pr|pr view' \
  src/check-ci-coderabbit docs/todo14.md Cargo.toml 2>/dev/null || true

Repository: aloekun/claude-code-hook-test

Length of output: 159


detached HEAD の実行経路を実際に検証してください。

parse_ci_rollup の単体テストとソース構造の検証だけでは、呼び出し側が空のブランチ名を repo または pr の代わりに渡す回帰を検出できません。

fetch_cirepopr を使って gh pr view を実行する経路を使い、偽の gh 実行ファイルで pr view <pr> --repo <repo> の引数を検証してください。

#[ignore] 付きテストは通常の cargo test では実行されません。完了基準を満たすには、CI で cargo test -- --ignored --test-threads=1 を明示的に実行するか、通常のテストスイートで実行できる構成にしてください。

🤖 Prompt for 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.

In `@docs/todo14.md` around lines 774 - 792, 新設する detached HEAD 統合テストで、実際に
fetch_ci の repo と pr を使う gh pr view 経路を実行し、偽の gh 実行ファイルで「pr view <pr> --repo
<repo>」の引数と呼び出しを検証してください。parse_ci_rollup
やソース構造だけに依存せず、空のブランチ名へ回帰すると失敗するテストにし、通常の cargo test で実行可能にするか、CI で cargo test --
--ignored --test-threads=1 を明示的に実行できる設定を追加してください。

@github-actions

github-actions Bot commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

🤖 PR Monitor 分析 (GitHub Actions バックストップ)

  • トリガー: pull_request_review (submitted) / 実行 run
  • CI: 実質的な check はすべて pass (CodeRabbit pass / rust (ubuntu-latest) pass / rust (windows-latest) pass)。analyze は本 workflow 自身であり pending は想定内。mergeStateStatus: UNSTABLE はこの pending 起因と推測される
  • レビュー状況: CodeRabbit が 1 件レビュー (state: COMMENTED, 2026-08-02T05:59:02Z) を提出し、インライン指摘 1 件 (docs/todo14.md 774-792行)。人間レビューはまだ無し (reviewDecision 未設定)
  • Verdict: approved

Applicable Findings (Critical / High / Major)

該当なし

Applicable Findings (Medium 以下)

該当なし

Filtered (not applicable)

# File (Line) Issue Filter Reason
1 docs/todo14.md (774-792) 新設予定の「detached HEAD 統合テスト」計画について、parse_ci_rollup 単体テストやソース構造検証だけでなく、fetch_ci が実際に gh pr view <pr> --repo <repo> を呼ぶ経路を偽 gh 実行ファイルで検証すべき、また #[ignore] テストは通常の cargo test では実行されないため CI 実行方法を明示すべき、との指摘 (CodeRabbit 申告 severity: Major) ADR-035 docs-only: 本 PR は docs/todo14.md / docs/todo-summary2.md のみの markdown 変更で ADR-035 の docs-only 判定基準 (path 基準・diff 内容基準) を満たす。指摘内容は「未来の作業計画に記載されたテスト設計の妥当性 (test coverage / test addition 要求)」であり、ADR-035 が明示的に除外する criterion に該当。実際のテストコードではなく TODO 計画文書の記述内容への指摘のため、着手時の実装 PR 側で再評価すべき事項

次のアクション

  • 本 PR (docs バッチ登録) はそのままマージ可。CodeRabbit の指摘内容自体は有用なので、順位 363「check-ci-coderabbit の detached HEAD 回帰統合テスト」に着手する際 (実装 PR) に、fake gh 経由での fetch_ci 経路検証・#[ignore] テストの CI 実行方法明示を計画に反映することを推奨
  • analyze check の pending 解消 (本 workflow 完了) を待って mergeStateStatus が正常化することを確認

@aloekun
aloekun merged commit d680a54 into master Aug 2, 2026
4 checks passed
@aloekun
aloekun deleted the docs/wp16-feedback-todos branch August 2, 2026 06:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant