Skip to content

docs: ADR-038 textual fix + Bundle f task registration (post-PR #120 follow-up)#121

Merged
aloekun merged 1 commit intomasterfrom
feat/adr-038-textual-fix-bundle-f-registration
May 7, 2026
Merged

docs: ADR-038 textual fix + Bundle f task registration (post-PR #120 follow-up)#121
aloekun merged 1 commit intomasterfrom
feat/adr-038-textual-fix-bundle-f-registration

Conversation

@aloekun
Copy link
Copy Markdown
Owner

@aloekun aloekun commented May 7, 2026

Summary

PR #120 (ADR-038 Phase 5 land) の事後整理を 1 PR に集約 (docs-only):

  1. ADR-038 line 61 textual fix (docs/local-llm-offload-analysis.md §8.C 該当): confidence=0.0action_confidence=0.0 に統一。実装の ClassifiedFinding.action_confidence schema 名称との整合
  2. PR feat(cli-pr-monitor): cli-finding-classifier 統合 + Finding C strict (ADR-038 Phase 5) #120 post-merge-feedback の採用 5 件登録 (Bundle f): cli-pr-monitor の wakeup state 遷移 / auto-retry path に関する dogfood signals
  3. docs/local-llm-offload-analysis.md の更新: §7 実装進捗ログ + §8 LANDED マーク + 優先度表現の中立化

Bundle f の内訳 (採用 5 件)

順位 Tier タスク Effort
80 🚀 Tier 1 rate-limit auto-retry wakeup 予約ロジック整理 M
81 🚀 Tier 1 CR 投稿エラー (Failed to post review comments) auto-retry 拡張 M
82 💎 Tier 3 ADR-018 update (transient failure auto-retry 設計の明文化) S
83 🔧 Tier 2 複合 AND guard の各条件を独立テストで検証 S
84 💎 Tier 3 code-review.md に「early-return guard テスト分離」checklist 追記 XS

運用方針: Bundle f は新規フィードバックのため、頻度が確認できるまで優先度は再観測を経て判断する (新規 = 即優先しない方針、本セッションで明文化)。

設計のポイント

  • docs-only PR (ADR-035 適用): コード変更なし、機能影響なし
  • B-2 削除: docs/local-llm-offload-analysis.md §8 から「B-2. Bundle f」エントリを削除し、Bundle f を「優先タスク」ではなく「記録 + 後日評価」の位置づけに変更
  • §7 prioritization 表現削除: 「先行 land を推奨」を削除し中立的な記録に書き換え

検証結果

  • quality_gate (lint/test/build/rust-test): PASS
  • takt pre-push-review: APPROVE (3 iter, 10m 15s、convergence_verdict: fully_resolved)
  • F-001 (typo) は本 PR 中で resolution 確認

scope 外 (本 PR では未対応)

  • Bundle f 自体の実装 (順位 80-84) は別 PR (頻度評価後に着手)
  • 提案 1 (lint screen facet, §8.E) / 提案 3 (PR body draft, §8.F) — 別途検討

Test plan

関連

Summary by CodeRabbit

  • Documentation
    • ローカルLLMを使用したFinding分類とissue要約正規化に関するアーキテクチャ設計ドキュメント(ADR-038)を追加
    • Phase 5実装状況と拡張計画に関する技術ドキュメントを更新
    • 今後の開発タスク計画(rate-limit対応、エラーハンドリング強化など)を整理

…follow-up)

PR #120 (ADR-038 Phase 5 land) の事後整理を 1 commit に集約 (docs-only):

1. ADR-038 line 61 textual fix (`docs/local-llm-offload-analysis.md` §8.C)
   - `confidence=0.0` → `action_confidence=0.0` に統一
   - 実装の `ClassifiedFinding.action_confidence` schema 名称との整合
   - 機能影響なし、永続 ADR の内部一貫性確保

2. PR #120 post-merge-feedback の採用 5 件を登録 (Bundle f)
   - 順位 80 (Tier 1, Bundle f): rate-limit auto-retry wakeup 予約ロジック整理
   - 順位 81 (Tier 1, Bundle f): CR 投稿エラー auto-retry 拡張
   - 順位 82 (Tier 3, Bundle f): ADR-018 update (transient failure auto-retry)
   - 順位 83 (Tier 2, 独立): 複合 AND guard 独立テスト
   - 順位 84 (Tier 3, 独立): code-review.md checklist 追記
   - 詳細エントリは docs/todo5.md 末尾、priority table は docs/todo.md
   - Bundle f は新規フィードバックのため、頻度が確認できるまで優先度は再観測を経て判断

3. docs/local-llm-offload-analysis.md の更新
   - §7 (実装進捗ログ) に Phase 5 land 記録 + Bundle f cross-reference 追加
   - §8 (次の作業候補) で A/B を ✅ LANDED にマーク
   - 「先行 land を推奨」等の prioritization 表現を削除し、頻度未確定の新規フィードバックを優先しない方針を明記
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 7, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 12809cff-9372-4bfd-973b-6bf8c96f267e

📥 Commits

Reviewing files that changed from the base of the PR and between 3b6a847 and f435914.

📒 Files selected for processing (4)
  • docs/adr/adr-038-local-llm-finding-classification.md
  • docs/local-llm-offload-analysis.md
  • docs/todo.md
  • docs/todo5.md

📝 Walkthrough

Walkthrough

このPRは、ローカルLLM(Ollama)を用いたFinding分類機能の設計(ADR-038)と、その統合実装内容、および関連する後続タスク・エッジケース対応を記録する4つのドキュメントの更新である。

Changes

ローカルLLMオフロード機能の設計・実装・追跡ドキュメント

Layer / File(s) Summary
アーキテクチャ決定
docs/adr/adr-038-local-llm-finding-classification.md
Ollama API クライアント、Finding 分類器 CLI、失敗時フォールバック仕様を定義。action_confidence=0.0 の統一表記によりスキーマ整合性を明確化。
実装統合・観測分析
docs/local-llm-offload-analysis.md
PR #120(Phase 5)の実装詳細(cli-pr-monitor への classifier subprocess 統合、Finding C 正規化の strict 化)と、dogfood 期間に検出された post-pr-monitor edge case を記録。次の作業候補を LANDED 扱いに更新。
タスク優先順位・計画
docs/todo.md, docs/todo5.md
Bundle f(rate-limit auto-retry 整理、CR 投稿エラー retry 拡張、ADR-018 更新、テスト分離、ガイドライン追記)の 5 タスクを推奨実行順序表に登録。詳細な実装期待値・完了基準を todo5.md に追記。

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 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 PRのタイトルは「docs: ADR-038 textual fix + Bundle f task registration (post-PR #120 follow-up)」であり、変更の主要な内容(ADR-038のテキスト修正とBundle fタスク登録)を明確に伝えており、ドキュメント更新のみの性質とも合致している。
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.

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

Warning

Review ran into problems

🔥 Problems

Git: Failed to clone repository. Please run the @coderabbitai full review command to re-trigger a full review. If the issue persists, set path_filters to include or exclude specific files.

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


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

@aloekun aloekun merged commit 6640dc7 into master May 7, 2026
1 check passed
@aloekun aloekun deleted the feat/adr-038-textual-fix-bundle-f-registration branch May 7, 2026 04:48
aloekun added a commit that referenced this pull request May 7, 2026
…ow-up) (#122)

PR #121 post-merge-feedback の採用 4 件 (Bundle g) 登録 + §8.A-2 (Phase 5 dogfood 計測計画) 策定を 1 commit に集約 (docs-only):

1. Bundle g 採用 4 件登録 (順位 85-88、PR #121 post-merge-feedback)
   - 順位 85 (Tier 1): cli-pr-monitor monitor state machine guard 強化 (`review_state: not_found && findings: []` を pending 据置)
     → 3 PR 連続観測 (PR #119/#120/#121) で頻度確認済 Tier 1 妥当性確定
   - 順位 86 (Tier 2): state transition test 網羅 (順位 85 の回帰テスト)
   - 順位 87 (Tier 3): Multi-PR chaining ベストプラクティス codify
     → PR #119#120#121 の連鎖を再利用可能化
   - 順位 88 (Tier 3): edge case 観測頻度 3 = Tier 1 昇格基準 codify
     → ユーザー方針 (新規フィードバックは頻度確認後優先) を明文化
   - 詳細エントリは docs/todo5.md 末尾、bundle commentary は docs/todo.md
   - Bundle f (順位 80-82) との関係: f = retry logic、g = verdict logic で別軸

2. §8.A-2 Phase 5 dogfood 計画 策定 (docs/local-llm-offload-analysis.md)
   - ADR-038 §試験運用→本採用の未達条件 1 (5 PR dogfood) + 3 (token 削減確認) を達成する計画
   - 構成: P-0 (config opt-in) + P-1〜P-5 (Tier 1 タスク優先で 5 PR)
   - Setup 手順 / 計測手順 / 判定基準 / 既知の注意事項 / session 跨ぎ運用ガイドを self-contained 形式で記載
   - 別セッションで再開可能な構造 (本 doc 1 ファイルで全手順把握可)

3. 整合更新
   - §7 § 効果実測の現状 を §8.A-2 参照に更新 (「未測定」を明示)
   - §8.E dependency を §8.A-2 完了 + 判定基準達成にリンク
aloekun added a commit that referenced this pull request May 7, 2026
…g + transition matrix tests (順位 85+86 / Bundle g-1) (#125)

§A-2 Phase 5 dogfood P-1 (Bundle g-1)。3 PR 連続観測 (PR #119/#120/#121) で
発覚した monitor の誤 approved 判定を fix。

順位 85 (Tier 1, T1-1):
- compute_verdict() に review_state guard 追加。CodeRabbit が未投稿
  (review_state: not_found) もしくは進行中 (pending) のときは findings
  の有無に関わらず判定保留。空 findings を 'no problems' と誤同一視する
  false negative を防止。

順位 86 (Tier 2, T2-4):
- mod tests に (action, review_state, findings) → verdict transition
  matrix を 12 unit test で網羅:
  - parked_rate_limit / parked_review_recheck (action 優先)
  - not_found + 空 / pending + 空 / not_found + findings (順位 85 fix)
  - success + 空 / minor / critical / high / major
  - skipped (skip_coderabbit 経路)
  - coderabbit field None (初期 state)
- 既存 should_resume_wakeup_* テスト 7 件と並存、no regression

build + deploy 済 (.claude/cli-pr-monitor.exe を release build で再生成)。
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