feat(cli-pr-monitor): bookmark 検出を @-/@-- まで拡張 (PR #54 の水平展開)

[aloekun]

Summary

• PR feat(cli-merge-pipeline): PR detection を @-/@-- まで拡張 + trunk filter 追加 #54 で cli-merge-pipeline に適用した bookmark 検出拡張 (@-..@--) と trunk filter を cli-pr-monitor にも水平展開
• util.rs の get_jj_bookmarks は Strategy B の PR 検索と create_pr.rs の --head 自動補完の両方に使われているため、両経路に効果が及ぶ

Changes

src/cli-pr-monitor/src/util.rs

• 3 層構造 (parse / query / select) に分割
  • parse_bookmark_list_output (純粋): jj log 出力から bookmark 名を抽出、trunk 除外
  • query_bookmarks_at (I/O): 指定 revset に対し jj log を実行
  • select_from_revsets (優先度): 複数 revset を近い順に試行、最初のヒットで停止
• BOOKMARK_SEARCH_REVSETS = ["@", "@-", "@--"] で近い順に探索
• TRUNK_BOOKMARKS = ["main", "master", "trunk", "develop"] を PR 検索対象から除外
• select_from_revsets はクロージャ注入で単体テスト可能
• 自動レビューの SEC-RESOLVED-util-L105 指摘に従い doc comment 微修正

docs/todo.md

• task 7 (本 PR で完了) を削除
• 雑務 cleanup を task 7 に繰り下げ

副次効果

• create_pr.rs の --head 自動補完で、@ や @- が master を指す状態でも --head master のような誤った引数が補完されなくなる (trunk filter 効果)

Test Plan

• cargo test -p cli-pr-monitor で 78 テスト pass (+11)
  • parse_bookmark_list_output_*: 7 件
  • select_from_revsets_*: 4 件
  • is_trunk_bookmark_known_names_rejected: 1 件
• cargo test --workspace で 375 テスト pass
• cargo clippy -p cli-pr-monitor -- -D warnings 非テスト部は警告ゼロ
• .claude/cli-pr-monitor.exe 再ビルド済
• Smoke test: 現在 @ 空 / @- = master 状態で --head 自動補完が発生しない (trunk filter 効果確認)
• Security review (pre-push-review workflow) で APPROVE、finding 0

References

• PR feat(cli-merge-pipeline): PR detection を @-/@-- まで拡張 + trunk filter 追加 #54 (先行実装、cli-merge-pipeline)
• ADR-013 (cli-merge-pipeline)
• ADR-024 (共通 jj helpers、試験運用 — 2 箇所で重複発生したので抽出候補)

Summary by CodeRabbit

リリースノート

• ドキュメント

  • タスクリストから完了項目を削除し、後続の項目を再番号付けしました。

• 改善

  • ブックマーク検出の信頼性を向上させました。複数の検索パターンを優先順位順に試行し、最初に成功した結果を使用するようになりました。
  • 不要なブックマーク名（main、master、trunk、develop）を自動的にフィルタリングするようになりました。
  • ブックマークリストの重複を除去し、データの正確性を改善しました。

• テスト

  • ブックマーク処理とフィルタリングを検証する包括的なテストを追加しました。

[coderabbitai]

Warning

Rate limit exceeded

@aloekun has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 5 minutes and 34 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 5 minutes and 34 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c17cd602-bb30-430d-84b3-787129d6979d

📥 Commits

Reviewing files that changed from the base of the PR and between 08adc9b and b818709.

📒 Files selected for processing (2)

• docs/todo.md
• src/cli-pr-monitor/src/util.rs

📝 Walkthrough

Walkthrough

このPRは、docs/todo.mdからTODO項目を削除し、src/cli-pr-monitor/src/util.rsのget_jj_bookmarks関数に優先付きrevset検索、改善されたパース、トランク名フィルタリングを実装しています。

Changes

Cohort / File(s)	Summary
ドキュメント更新 docs/todo.md	TODO #7（revsetの拡張に関する項目）を削除し、後続するTODO #8を#7に繰り上げ。
ブックマーク検出の実装 src/cli-pr-monitor/src/util.rs	get_jj_bookmarksを変更：優先付きrevset検索（@、@-、@--）で候補ブックマークを取得、jj logのテンプレート出力パースを改善（複数行・カンマ区切り対応、ホワイトスペース削除、重複排除、トランク名フィルタリング）、関連する単体テストとエッジケーステストを追加。

推定コードレビュー工数

🎯 4 (Complex) | ⏱️ ~45 minutes

関連する可能性のあるPR

• chore: conflicted bookmarks 棚卸し + push 前 bookmark 自動前進 #49: 同一のブックマーク検出ロジック（revset優先選択、パース改善、トランク名フィルタリング）を別のツール（cli-push-runner）に実装しており、この実装パターンと共通。
• feat(cli-merge-pipeline): PR detection を @-/@-- まで拡張 + trunk filter 追加 #54: 同一のブックマーク検出リファクタ（revset選択、パース改善、フィルタリング）を別のツール（cli-merge-pipeline）に適用しており、実装内容が一致。
• fix(cli-pr-monitor): jj 環境での PR 作成時に --head を自動補完 #35: 同じget_jj_bookmarks関数に対する変更であり、この関数の出力を--headオートフィルに依存している関連性がある。

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: extending bookmark detection to @-/@-- revsets in cli-pr-monitor, and is clear and specific enough for understanding the primary change.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

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 and usage tips.}

[coderabbitai]

🧹 Nitpick comments (2)

src/cli-pr-monitor/src/util.rs (2)

85-172: parse / query / select の3層分離は綺麗にまとまっており LGTM。

• parse_bookmark_list_output を純粋関数に分離したことで、trim / dedup / trunk 除外の仕様が単体テストで網羅できるようになっている点が良いです（特に parse_bookmark_list_output_excludes_trunk_bookmarks は create_pr.rs の --head 誤補完の再発防止ガードとして効いています）。
• select_from_revsets のクロージャ注入により I/O なしで fallback / short-circuit / 呼び出し順序まで検証できており（select_from_revsets_stops_at_first_hit で ["@","@-"] までしか叩かないことを RefCell で観測）、get_jj_bookmarks の振る舞いがテストで縛れています。
• is_trunk_bookmark を exact match にしてあるので main-feature のような feature ブランチが巻き込まれないのも妥当（該当テスト済）。

1点だけ、 TRUNK_BOOKMARKS / is_trunk_bookmark / BOOKMARK_SEARCH_REVSETS は cli-push-runner・cli-merge-pipeline にも同等物が存在しており（Lines 98-99 のコメントも cli-push-runner/push_jj_bookmark.rs と同じリストを採用 と明言）、3 クレートで定義が平行してぶら下がる状態になっています。docs/todo.md でも言及のある ADR-024 (共通 jj helper crate) のスコープに乗せる形で、後続 PR で jj-helpers 的な共有クレートに集約するのが良さそうです（この PR で広げる必要はなし）。

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@src/cli-pr-monitor/src/util.rs` around lines 85 - 172, Duplicate definitions
of BOOKMARK_SEARCH_REVSETS, TRUNK_BOOKMARKS, is_trunk_bookmark,
parse_bookmark_list_output, query_bookmarks_at and select_from_revsets exist
across multiple crates; extract them into a shared crate (e.g., jj_helpers) and
re-export them so other crates can import rather than redefine. Create a new
crate/module, move the constants and pure functions (BOOKMARK_SEARCH_REVSETS,
TRUNK_BOOKMARKS, is_trunk_bookmark, parse_bookmark_list_output,
select_from_revsets, query_bookmarks_at, get_jj_bookmarks) with identical
signatures and behavior, add pub visibility and documentation, update callers to
use the shared crate imports, and run/update unit tests to import these symbols
from the new crate to ensure no behavior/regression changes.

---

135-154: query_bookmarks_at の stderr 抑止方針を文書化推奨。

.stderr(Stdio::null()) で jj log の stderr を捨てているため、jj 側の動作エラーや予期しない失敗がサイレントに握り潰されます。現在、local_bookmarks.map(|b| b.name()).join(",") は jj 0.40.0 まで安定したドキュメント化済みの構文ですが、将来テンプレート DSL が変更される場合に問題の原因特定が難しくなる懸念があります。

select_from_revsets が空結果を「ヒットなし」として扱うため、テンプレート破損や jj バージョン非互換を観測できなくなる点は改善の余地があります。デバッグ性向上のため、少なくとも関数のドキュメントコメントに「stderr は意図的に抑止し、revset 不正や一時的な失敗は握り潰す」旨を明記しておくことを推奨します。必要に応じて、o.status.success() == false の分岐で警告ログを落とすことも検討してください。

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@src/cli-pr-monitor/src/util.rs` around lines 135 - 154, The function
query_bookmarks_at currently discards jj stderr via .stderr(Stdio::null()),
which can hide template/DLS or execution errors; add a doc comment on
query_bookmarks_at explaining that stderr is intentionally suppressed and that
revset/template failures will be treated as “no hits”, and optionally modify the
error branch (the match that returns Vec::new() when o.status.success() is
false) to emit a warning via the project logger (or a debug log) including the
command stderr/output to aid future debugging when jj templates or versions
change.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@src/cli-pr-monitor/src/util.rs`:
- Around line 85-172: Duplicate definitions of BOOKMARK_SEARCH_REVSETS,
TRUNK_BOOKMARKS, is_trunk_bookmark, parse_bookmark_list_output,
query_bookmarks_at and select_from_revsets exist across multiple crates; extract
them into a shared crate (e.g., jj_helpers) and re-export them so other crates
can import rather than redefine. Create a new crate/module, move the constants
and pure functions (BOOKMARK_SEARCH_REVSETS, TRUNK_BOOKMARKS, is_trunk_bookmark,
parse_bookmark_list_output, select_from_revsets, query_bookmarks_at,
get_jj_bookmarks) with identical signatures and behavior, add pub visibility and
documentation, update callers to use the shared crate imports, and run/update
unit tests to import these symbols from the new crate to ensure no
behavior/regression changes.
- Around line 135-154: The function query_bookmarks_at currently discards jj
stderr via .stderr(Stdio::null()), which can hide template/DLS or execution
errors; add a doc comment on query_bookmarks_at explaining that stderr is
intentionally suppressed and that revset/template failures will be treated as
“no hits”, and optionally modify the error branch (the match that returns
Vec::new() when o.status.success() is false) to emit a warning via the project
logger (or a debug log) including the command stderr/output to aid future
debugging when jj templates or versions change.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1ed8553d-bee3-4ee5-9ac0-08515f99e350

📥 Commits

Reviewing files that changed from the base of the PR and between e48cb0c and 08adc9b.

📒 Files selected for processing (2)

• docs/todo.md
• src/cli-pr-monitor/src/util.rs