claude-code-conductor 2.15.1__tar.gz → 2.15.2__tar.gz

claude_code_conductor-2.15.2/.claude/docs/parallel-agents-setup.md

@@ -0,0 +1,152 @@
+# parallel-agents 推奨個人設定
+
+C3 の `parallel-agents` skill（`/develop` から間接起動）を快適に使うための、
+**Claude Code バージョン要件と個人設定の推奨値**をまとめる。
+
+> 本ドキュメントは **C3 利用者（人間）向け** のリファレンス。
+> LLM 向けの skill 動作指針は `.claude/skills/parallel-agents/SKILL.md` を参照。
+
+---
+
+## 概要
+
+`parallel-agents` skill は Claude Code 公式の `isolation: "worktree"` 機構を使い、
+`.claude/worktrees/agent-<id>/` 配下に独立した git worktree を作成して並列実行する。
+このとき以下 2 点で **利用者環境への期待** が発生する。
+
+| 項目 | 推奨値 | 既定との差 |
+|---|---|---|
+| Claude Code バージョン | **2.1.150 以降** | 古いと auto-cleanup 不在 |
+| `worktree.baseRef` | **`"head"`** | 既定は `"fresh"` (= `origin/<default>` から作成) |
+
+設定しなくても skill 自体は動くが、以下の問題に遭遇しやすくなる:
+
+- 古い CC: 各 wave 終了時に `git worktree remove` が走らず `.claude/worktrees/` に
+  dead worktree が積もる
+- `baseRef: fresh`: push 前のローカルコミットが worktree から見えず、agent が
+  「ファイルが存在しない」と誤判定して fresh create に走る等の事故が起きる
+
+---
+
+## 推奨個人設定
+
+`~/.claude/settings.json` (グローバル個人設定) に以下を追加する:
+
+```json
+{
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+既存の `~/.claude/settings.json` がある場合はマージする。例:
+
+```json
+{
+  "permissions": {
+    "defaultMode": "auto"
+  },
+  "model": "sonnet",
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+### なぜプロジェクト設定 (`.claude/settings.json`) ではなく個人設定か
+
+`worktree.baseRef` は **Claude Code 公式機能の動作モード切替** であり、C3 固有の
+設定ではない。C3 が利用者の Claude Code 設定全体を書き換える形になると
+「C3 は `.claude/` 内に収まるフレームワーク」という設計思想と矛盾するため、
+C3 配布物には含めず利用者個人の判断で適用する形にしている。
+
+### worktree.baseRef: "head" の意味
+
+| 値 | base 元 |
+|---|---|
+| `"fresh"` (既定) | `origin/<default-branch>` (例: `origin/main`) |
+| `"head"` | 現在の local HEAD |
+
+`"head"` にすると、push 前のローカルコミットが worktree にも含まれる。
+parallel-agents は「直近の修正を反映した worktree で並列実装させる」ことが目的のため、
+`"head"` の方が C3 のワークフローと整合する。
+
+### 副作用
+
+- 作業中のローカル HEAD がコミットされていない（dirty）状態だと、その dirty も
+  worktree に持ち込まれる。これは通常のメリット（ローカル変更を反映）と表裏一体
+- 壊れた HEAD から worktree を作ると、worktree も壊れる。コミット前にビルドが
+  通っているかは利用者が確認する責任
+
+---
+
+## Claude Code バージョン要件
+
+### 2.1.150 以降を推奨する理由
+
+`isolation: "worktree"` 付き Agent が **完了時に worktree を auto-cleanup** する
+挙動が安定したのが 2.1.150 系。これにより:
+
+- `.claude/worktrees/` 配下に dead worktree が残らない
+- `worktree-agent-<id>` ブランチも自動削除される
+- 親 Claude が明示的に `git worktree remove` を呼ぶ必要がない
+
+2.1.150 未満の場合、SKILL.md Step 2-F-3 のフォールバック手順
+（`git worktree remove -f -f` + `git branch -D worktree-agent-<id>`）が
+**毎回必要** になる。dead worktree が積み重なるとパフォーマンス・容量への
+影響もあるため、可能ならアップグレードを推奨する。
+
+### auto-cleanup の信頼度
+
+検証実績 (2026-05-23 〜 2026-05-24):
+
+- foreground / background / 並列 / 失敗 (exit 1) の全パターンで 10/10 cleanup 確認
+- ごく稀に **外部要因による一時的ファイルロック** で cleanup が失敗するケースを
+  1 件観測 (約 1/11 以下)。原因は未特定（アンチウィルス・バックアップソフト・
+  その他常駐プロセスのいずれかの可能性）
+- SKILL.md Step 2-F-3 の残留チェック + `git worktree prune` フォールバックで
+  実害なく吸収される設計
+
+---
+
+## 設定後の動作確認
+
+1. 設定追加後、Claude Code を再起動する（または `/config` で反映）
+2. C3 で wt_tester を 1 件起動するだけの軽量タスクを実行（最も簡単な検証）:
+   - `/start` → 「直接指示する」→ 「wt_tester を 1 個 isolation:worktree で pwd だけ実行して」
+3. 完了通知後、`git worktree list --porcelain` と `ls .claude/worktrees/` で
+   両方 main 以外が無い状態を確認
+
+### baseRef 適用の確認
+
+ローカルだけにある commit がある状態で wt_tester を起動し、worktree 内で
+`git log -1` が **その commit を指していれば** baseRef: "head" が効いている。
+`origin/main` の commit を指していれば既定（`fresh`）のまま。
+
+---
+
+## トラブルシューティング
+
+### Q. worktree が cleanup されず残る
+
+A. 以下の順に対処:
+
+1. `git worktree list --porcelain` で main 以外の登録があるか確認
+2. 登録があれば `git worktree remove -f -f <path>` で削除
+3. 物理 dir だけ残っていれば `rm -rf .claude/worktrees/agent-*`
+4. ブランチが残っていれば `git branch -d worktree-agent-<id>` (force 必要なら `-D`)
+
+これらは parallel-agents SKILL.md Step 2-F-3 のフォールバック手順そのもの。
+auto-cleanup が動いている環境ではほぼ no-op になる。
+
+### Q. wt_developer / wt_tester が「ファイルが存在しない」と言う
+
+A. `worktree.baseRef` が `"fresh"` (既定) のまま、かつローカルに push 前の
+コミットでそのファイルを追加しているケースが典型。`worktree.baseRef: "head"` を
+設定するか、対象 commit を push してから再実行する。
+
+### Q. 設定変更しても効かない
+
+A. Claude Code の設定読み込みはセッション開始時。`/config` で再読み込みするか、
+Claude Code を再起動する。

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/.claude/skills/parallel-agents/SKILL.md

@@ -41,7 +41,7 @@ Claude Code のサブエージェントは **更にサブエージェントを s
 
 - plan-report が `.claude/reports/plan-report-*.md` の形式で配置され、YAML フロントマターを持つこと
 - フロントマターが無ければ `.claude/skills/dev-workflow/SKILL.md` の D-1〜D-5 ceremony へフォールバック
-- Claude Code の Agent ツールが `isolation: "worktree"` パラメータをサポートしていること（v2.1.x 以降）
+- Claude Code の Agent ツールが `isolation: "worktree"` パラメータをサポートしていること（v2.1.x 以降）。v2.1.150 未満では Agent 完了時の worktree auto-cleanup が動作しないため、2-F-3 のフォールバック手順が毎回必要になる挙動差がある（利用者向け推奨設定は [`.claude/docs/parallel-agents-setup.md`](../../docs/parallel-agents-setup.md) を参照）
 
 ---
 
@@ -208,7 +208,7 @@ worktree path は Agent ツール返り値の `<worktree><worktreePath>...</work
 }
 ```
 
-- 「リトライ」 → 失敗タスクのみ 2-C を再実行（成功 worktree はそのまま残し、失敗 worktree は事前に `git worktree remove -f -f` で削除）
+- 「リトライ」 → 失敗タスクのみ 2-C を再実行（失敗 worktree は auto-cleanup 済みのことが多いが、2-F-3 の残留チェックを実施してから再開すること。残留があった場合のみ事前に `git worktree remove -f -f` で削除）
 - 「スキップして次の wave へ」 → 失敗内容をセッションファイルの `## 試みたが失敗したアプローチ` に追記して次の wave へ
 - 「中断」 → セッションファイルの該当 wave 行は `- [ ]` のままにしてスキル終了
 
@@ -241,15 +241,29 @@ git commit -m "Wave {N}: {要約}"
 
 メッセージには各タスクの目的を簡潔にまとめる（例: 「Wave 1: auth ログイン/ログアウト実装」）。
 
-#### 2-F-3: worktree クリーンアップ
+#### 2-F-3: worktree クリーンアップ（残留チェックのみ）
 
-各 worktree を削除する。**`-f -f` フラグが必須**（Claude Code が worktree を `claude agent` lock で残すため）:
+Claude Code 2.1.x（少なくとも 2.1.150 で実測確認、2026-05-23）以降、`isolation:"worktree"` 付き Agent は完了時に **物理ディレクトリ・worktree 登録・`worktree-agent-*` ブランチが自動削除** される（foreground / background / 並列 / 失敗ケース全パターンで検証済み。詳細: `.claude/reports/worktree-cleanup-verification-20260523-234110.md`）。
+
+そのため明示的な `git worktree remove` は **不要**。auto-cleanup が race や障害でスキップされた場合のセーフティとして残留チェックのみ行う:
 
 ```bash
-git worktree remove -f -f .claude/worktrees/agent-{id}
-git worktree remove -f -f .claude/worktrees/agent-{id2}
+# 念のため worktree 登録の残留を確認、あれば prune（物理ディレクトリも片付く）
+git worktree list --porcelain
 git worktree prune
-git branch -D worktree-agent-{id} worktree-agent-{id2}
+
+# 念のため worktree-agent-* ブランチの残留チェック（あれば手動削除を検討）
+# Windows PowerShell では grep 未インストール時に動作しないため、代替として
+# `git branch --list "worktree-agent-*"` を使う:
+git branch -a | grep -E "worktree-agent-" || true
+# Windows 代替: git branch --list "worktree-agent-*"
+```
+
+残留があった場合のみ手動 cleanup（古い Claude Code バージョン互換 or auto-cleanup 失敗ケース）:
+
+```bash
+git worktree remove -f -f .claude/worktrees/agent-{id}  # -f -f は claude agent lock 残留対策
+git branch -D worktree-agent-{id}
 ```
 
 #### 2-F-4: セッション記録
@@ -285,5 +299,5 @@ checkpoint の summary には KEEP ルール（設計判断・決定事項・解
 - 並列実行で **特定パターンが詰まりがち** と気付いたら、セッションファイルの `## 試みたが失敗したアプローチ` に追記し `patterns` に登録する
 - 並列度を増やして race の兆候が出た場合は本 skill の上限値 15 を見直す（PoC では 15 並列まで 0 失敗確認済み）
 - agent ツール並列起動の `<task-notification>` の到着順序は保証されないため、結果集約の表は task_id でソートして提示する
-- worktree クリーンアップを忘れると `.claude/worktrees/` に dead worktree が積もる。`-f -f` フラグの必要性は PoC で実証済み
+- Claude Code 2.1.x 以降は Agent 完了時に worktree auto-cleanup されるため、明示的な `git worktree remove` は基本不要（2-F-3 参照）。`.claude/worktrees/` に dead worktree が残る場合は古い Claude Code バージョンで作成された残骸の可能性が高い
 

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/.gitignore

@@ -60,6 +60,7 @@ site/
 .claude/docs/ruflo_research_result.md
 .claude/docs/C3_hnsw_機能追加詳細設計.md
 .claude/docs/C3_利用状況可視化.md
+.claude/docs/C3_tier_routing_cost_integration_設計.md
 .claude/docs/grill-me機能を実装する際の考慮点とC3との相性や超えるべき壁.md
 .claude/docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md
 

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## v2.15.2 (2026-05-24)
+
+### 改善
+
+- **parallel-agents skill Step 2-F-3 を縮小**: Claude Code 2.1.150 で
+  `isolation:"worktree"` 付き Agent 完了時の worktree auto-cleanup 動作を
+  4 シナリオ (foreground / background / 並列 / 失敗 exit 1) で確定検証。
+  従来の「親 Claude が `git worktree remove -f -f` を毎回実行」を
+  「残留チェック + `git worktree prune` のみ」に縮小。
+  古い Claude Code バージョン (< 2.1.150) や稀な外部要因による cleanup
+  失敗時のフォールバック手順は残置。
+- Step 2-E (リトライ) と 知識蓄積セクションも同方針に整合化。
+
+### 追加
+
+- **`.claude/docs/parallel-agents-setup.md` 新規**: parallel-agents
+  利用者向けの推奨個人設定リファレンス。`worktree.baseRef: "head"` /
+  Claude Code バージョン要件 / トラブルシュート手順を集約。
+- **README.md に「推奨個人設定」セクション**: 最小設定例と詳細 docs への
+  リンクを `parallel-agents` 紹介の直後に追加。
+
+### 回帰防御
+
+- `tests/test_db.py` 新規 (4 + 1 件): `locate_c3_db` の env 優先 /
+  C3_PO_DB_PATH legacy fallback / 親遡り / 無効 env fallback /
+  ディレクトリ指定 fallback の各経路を契約として固定。
+- `tests/test_worktree_guard.py` に env gate 未設定時の no-op テスト
+  追加 (PO_WORKTREE_GUARD env 廃止移行を機械検出する番犬テスト)。
+- 合計 5 件追加で 928 → 934 PASS (回帰なし)。
+
+### 配布
+
+- `.claude/docs/C3_tier_routing_cost_integration_設計.md` (個人作業ノート)
+  を 3 ファイル同期 (.gitignore / `_excludes.py` / `hatch_build.py`) で
+  配布除外。
+
+### 内部整理
+
+- SKILL.md (LLM 向け) と人間向け推奨ドキュメントの責務を文書ヒエラルキー
+  思想 (SKILL.md = LLM 行動指針 / docs = 人間リファレンス) に従って分離。
+
+---
+
 ## v2.15.1 (2026-05-22)
 
 ### 変更

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.15.1
+Version: 2.15.2
 Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor
@@ -375,6 +375,27 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
 
 TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます。並列実行時は worktree 専用の `wt_tester` / `wt_developer` / `wt_systematic-debugger` agent が使用され、レポートは `task_id` ベースのファイル名で出力されます。
 
+### 推奨個人設定 (`~/.claude/settings.json`)
+
+`parallel-agents` を快適に使うため、以下 2 点を **個人設定として** 推奨します（C3 配布物には含めません）:
+
+| 項目 | 推奨値 | 理由 |
+|---|---|---|
+| Claude Code バージョン | 2.1.150 以降 | worktree auto-cleanup の安定動作 |
+| `worktree.baseRef` | `"head"` | push 前のローカルコミットを worktree に含める |
+
+最小設定例:
+
+```json
+{
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+詳細（背景・副作用・トラブルシュート）は [`.claude/docs/parallel-agents-setup.md`](./.claude/docs/parallel-agents-setup.md) を参照してください。
+
 ---
 
 ## セッション管理

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/README.md

@@ -328,6 +328,27 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
 
 TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます。並列実行時は worktree 専用の `wt_tester` / `wt_developer` / `wt_systematic-debugger` agent が使用され、レポートは `task_id` ベースのファイル名で出力されます。
 
+### 推奨個人設定 (`~/.claude/settings.json`)
+
+`parallel-agents` を快適に使うため、以下 2 点を **個人設定として** 推奨します（C3 配布物には含めません）:
+
+| 項目 | 推奨値 | 理由 |
+|---|---|---|
+| Claude Code バージョン | 2.1.150 以降 | worktree auto-cleanup の安定動作 |
+| `worktree.baseRef` | `"head"` | push 前のローカルコミットを worktree に含める |
+
+最小設定例:
+
+```json
+{
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+詳細（背景・副作用・トラブルシュート）は [`.claude/docs/parallel-agents-setup.md`](./.claude/docs/parallel-agents-setup.md) を参照してください。
+
 ---
 
 ## セッション管理

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/hatch_build.py

@@ -39,6 +39,7 @@ EXCLUDE_PATTERNS: tuple[str, ...] = (
     "docs/ruflo_research_result.md",
     "docs/C3_hnsw_機能追加詳細設計.md",
     "docs/C3_利用状況可視化.md",
+    "docs/C3_tier_routing_cost_integration_設計.md",
     "docs/grill-me機能を実装する際の考慮点とC3との相性や超えるべき壁.md",
     "docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md",
     "docs/codex対応/*",

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "2.15.1"
+__version__ = "2.15.2"

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/src/c3/_excludes.py

@@ -36,6 +36,7 @@ EXCLUDE_PATTERNS: tuple[str, ...] = (
     "docs/ruflo_research_result.md",
     "docs/C3_hnsw_機能追加詳細設計.md",
     "docs/C3_利用状況可視化.md",
+    "docs/C3_tier_routing_cost_integration_設計.md",
     "docs/grill-me機能を実装する際の考慮点とC3との相性や超えるべき壁.md",
     "docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md",
     "docs/codex対応/*",

claude_code_conductor-2.15.2/tests/test_db.py

@@ -0,0 +1,166 @@
+"""Tests for src/c3/db.py:locate_c3_db()
+
+`locate_c3_db()` の 3 経路を契約として固定する回帰テスト:
+  1. C3_DB_PATH env (worktree 内子プロセス用、v2.0.0+)
+  2. C3_PO_DB_PATH env (legacy, v1.x 互換)
+  3. CWD からの親遡り fallback
+
+worktree 環境変化（Claude Code v2.1.149 sandbox 厳格化など）に対する
+C3 側の env-aware path 解決の壊れにくさを担保する。
+"""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+import pytest
+
+from c3.db import locate_c3_db
+
+
+def _make_fake_db(base: Path) -> Path:
+    """`base/.claude/state/c3.db` を作って返す。
+
+    locate_c3_db は is_file() 判定のみ行い中身を読まないため、
+    空ファイルで十分。
+    """
+    db_path = base / ".claude" / "state" / "c3.db"
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    db_path.touch()
+    return db_path
+
+
+def _assert_fallback_warning(caplog: pytest.LogCaptureFixture) -> None:
+    """env が無効値・ディレクトリ等で fallback した時の警告内容を契約として固定する。
+
+    NOTE: src/c3/db.py の現在の警告フォーマット
+      "%s set but file not found: %s (falling back to traversal)"
+    を現状スナップショットとして検証する。将来ログメッセージを精緻化する場合は
+    本ヘルパーを意図的に更新すること（caplog の片側 OR では検出できないため）。
+    """
+    assert "C3_DB_PATH" in caplog.text, "Warning must mention env var name C3_DB_PATH."
+    assert "file not found" in caplog.text, (
+        "Warning must mention 'file not found' (current db.py message). "
+        "If db.py message is intentionally refined, update this assertion."
+    )
+    assert "falling back to traversal" in caplog.text, (
+        "Warning must mention 'falling back to traversal' (current db.py message). "
+        "If db.py message is intentionally refined, update this assertion."
+    )
+
+
+def test_locate_c3_db_env_priority(tmp_path: Path, monkeypatch: pytest.MonkeyPatch):
+    """C3_DB_PATH が設定されていれば、CWD 親遡りより優先される."""
+    env_db = _make_fake_db(tmp_path / "env_root")
+    cwd_db = _make_fake_db(tmp_path / "cwd_root")
+    cwd_subdir = tmp_path / "cwd_root" / "sub" / "deeper"
+    cwd_subdir.mkdir(parents=True)
+
+    monkeypatch.setenv("C3_DB_PATH", str(env_db))
+    monkeypatch.delenv("C3_PO_DB_PATH", raising=False)
+
+    result = locate_c3_db(start=cwd_subdir)
+
+    assert result == env_db.resolve(), (
+        f"C3_DB_PATH should win over parent traversal. "
+        f"Expected {env_db.resolve()}, got {result}"
+    )
+    assert result != cwd_db.resolve(), (
+        "Parent traversal should NOT have been triggered while C3_DB_PATH is valid."
+    )
+
+
+def test_locate_c3_db_legacy_env_fallback(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    caplog: pytest.LogCaptureFixture,
+):
+    """C3_DB_PATH 未設定で C3_PO_DB_PATH が設定されていれば legacy 経路で解決。
+    またこのとき deprecation 警告が WARNING で発火する。"""
+    legacy_db = _make_fake_db(tmp_path / "legacy_root")
+
+    monkeypatch.delenv("C3_DB_PATH", raising=False)
+    monkeypatch.setenv("C3_PO_DB_PATH", str(legacy_db))
+
+    with caplog.at_level(logging.WARNING, logger="c3.db"):
+        result = locate_c3_db(start=tmp_path)
+
+    assert result == legacy_db.resolve(), (
+        f"C3_PO_DB_PATH should resolve when C3_DB_PATH is unset. "
+        f"Expected {legacy_db.resolve()}, got {result}"
+    )
+    assert "C3_PO_DB_PATH is deprecated" in caplog.text, (
+        "Legacy env path should emit a deprecation warning."
+    )
+
+
+def test_locate_c3_db_parent_traversal(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+):
+    """env 未設定なら start から親遡りで .claude/state/c3.db を見つける."""
+    root_db = _make_fake_db(tmp_path)
+    deep = tmp_path / "a" / "b" / "c"
+    deep.mkdir(parents=True)
+
+    monkeypatch.delenv("C3_DB_PATH", raising=False)
+    monkeypatch.delenv("C3_PO_DB_PATH", raising=False)
+
+    result = locate_c3_db(start=deep)
+
+    assert result == root_db.resolve(), (
+        f"Parent traversal should find .claude/state/c3.db. "
+        f"Expected {root_db.resolve()}, got {result}"
+    )
+
+
+def test_locate_c3_db_invalid_env_falls_back_to_traversal(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    caplog: pytest.LogCaptureFixture,
+):
+    """env が設定されていても指すパスが無効ならば親遡り fallback に進む."""
+    valid_db = _make_fake_db(tmp_path)
+
+    monkeypatch.setenv("C3_DB_PATH", str(tmp_path / "nonexistent.db"))
+    monkeypatch.delenv("C3_PO_DB_PATH", raising=False)
+
+    with caplog.at_level(logging.WARNING, logger="c3.db"):
+        result = locate_c3_db(start=tmp_path)
+
+    assert result == valid_db.resolve(), (
+        "Invalid env path should fall through to parent traversal."
+    )
+    _assert_fallback_warning(caplog)
+
+
+def test_locate_c3_db_env_pointing_to_directory_falls_back_to_traversal(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    caplog: pytest.LogCaptureFixture,
+):
+    """ディレクトリ指定のテスト（SR L-3 追加）。
+
+    `test_locate_c3_db_invalid_env_falls_back_to_traversal` は env が「存在しない
+    ファイルパス」を指すケースをカバーするが、本テストは env が「実在するディレクトリ」
+    を指すケースをカバーする（is_file() False の別経路）。setup は env に
+    `tmp_path/some_dir` (mkdir 済) を設定し、親遡り fallback 用に
+    `_make_fake_db(tmp_path)` で `tmp_path/.claude/state/c3.db` を別途用意する。
+
+    SR L-3 指摘: ディレクトリ指定でも "file not found" のログが出る（診断メッセージの
+    誤解可能性）。この挙動をテストとして固定し、将来の修正時に意図的な変更として検出する。
+    """
+    some_dir = tmp_path / "some_dir"
+    some_dir.mkdir()
+    valid_db = _make_fake_db(tmp_path)
+
+    monkeypatch.setenv("C3_DB_PATH", str(some_dir))
+    monkeypatch.delenv("C3_PO_DB_PATH", raising=False)
+
+    with caplog.at_level(logging.WARNING, logger="c3.db"):
+        result = locate_c3_db(start=tmp_path)
+
+    assert result == valid_db.resolve(), (
+        "Directory env path should fall through to parent traversal."
+    )
+    _assert_fallback_warning(caplog)

{claude_code_conductor-2.15.1 → claude_code_conductor-2.15.2}/tests/test_worktree_guard.py

@@ -5,6 +5,7 @@ Tests are organised around the CWD-based activation scheme:
 2. CWD inside .claude/worktrees/ + Write inside worktree → exits 0
 3. CWD inside .claude/worktrees/ + Write outside worktree → exits 2 + stderr
 4. Block message sanitizes ANSI escapes in file_path (sec-Low)
+5. env gate: PO_WORKTREE_GUARD 未設定 → no-op (CWD が worktree 内でも exit 0)
 """
 
 from __future__ import annotations
@@ -206,3 +207,37 @@ def test_block_message_sanitizes_ansi_escapes(tmp_path: Path):
         "[sec-Low] Block message must not contain raw ANSI escape sequences. "
         f"stderr preview: {result.stderr[:300]!r}"
     )
+
+
+# ---------------------------------------------------------------------------
+# 5. env gate: PO_WORKTREE_GUARD 未設定なら CWD が worktree 内でも no-op
+# ---------------------------------------------------------------------------
+
+
+def test_guard_disabled_when_env_not_set(tmp_path: Path):
+    """env 未設定なら CWD が worktree 配下でも no-op (exit 0)。
+
+    worktree_guard.py L40 の env gate 契約を固定する回帰テスト。
+    将来 env gate を外す変更（auto activation のみ）に切り替える場合は
+    このテストが落ちることで設計変更を検出する。
+
+    Note (env gate 廃止移行時):
+        env gate を外して CWD ベース自動有効化に切り替える場合は、
+        先に本テスト自体を更新（または削除）してから worktree_guard.py 側を変更すること。
+        順序を逆にすると本テストが先に落ちて hook の正常な改修と区別できなくなる。
+    """
+    worktree = _make_worktree_cwd(tmp_path)
+    outside = tmp_path / "outside_file.txt"
+    payload = {
+        "tool_name": "Write",
+        "tool_input": {"file_path": str(outside)},
+    }
+    result = _run_guard(payload, cwd=str(worktree), enable_guard=False)
+
+    assert result.returncode == 0, (
+        f"Guard must be inactive without PO_WORKTREE_GUARD=1 even with CWD "
+        f"inside worktree, got exit={result.returncode}\nstderr: {result.stderr}"
+    )
+    assert not result.stderr.strip(), (
+        f"Inactive guard must produce NO stderr, got: {result.stderr!r}"
+    )