claude-code-conductor 2.74.0__tar.gz → 2.76.0__tar.gz

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/.claude/CLAUDE.md

@@ -14,6 +14,22 @@ C3 は、業務アプリケーション開発で製品としての品質を保
 
 背景: 業務アプリは機密情報を扱い、作って終わりではなく保守・運用が続く。
 
+## 根本解決の原則（監査・レビューを通すための対応をしない）
+
+- 監査（C-3）・レビュー（E）・テストの指摘に対して、**指摘を消すためだけの対応（言い換え・周辺の付け足し・機構の差し替え）を行わない**
+- 指摘の背後にある**根本問題を 1 文で書き**、それを解く手段を採る。根本問題を解いているかは、OS・ライブラリの一次資料（ソース・公式ドキュメント）と実測で裏取りしてから確定する
+- **影響範囲が大きくても、コストがかかっても、根本解決できるものは必ず根本解決の手段を取る。** 同じコストを払うなら、修正範囲が広い根本解決の方が、後から積む機能への影響が少なくトータルコストが安い
+- 監査・レビューを通すためだけの対応に払うコストは、開発で最も無駄なコストである。ゲートが緑になることは目的の達成を意味しない
+- 対症療法しか取れない場合は、その理由（根本解決が構造的に不可能・現時点の情報では原因が確定しない等）を明記し、根本解決へ戻るトリガーをセッションファイルの残タスクに残す。「後で直す」をトリガーなしに先送りしない
+
+判断の手順:
+
+1. 指摘・欠陥の**根本問題を 1 文で書く**
+2. 候補となる対策が、その根本問題を**解くのか・隠すのか**を分ける。隠す対策は採らない
+3. 解く対策の修正範囲が大きい場合も、設計（architecture-report）と計画（plan-report）に載せて実施する。範囲の大きさを理由に縮小する裁定はユーザーが行う
+4. 実装前に一次資料と再現実験で仮説を裏取りする。仮説が反証されたら実装せず再調査する
+5. 是正後は「指摘が消えたか」ではなく「根本問題が解けたか」を実測で示す（Red → Green の反転・本番経路での再現条件の消失）
+
 ## 設計思想
 
 - 対策・規約は「書きやすい場所」ではなく「効く場所」に置く。読み手（agent / skill）の Read 経路に届いていない規約は存在しないのと同じ

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/.claude/hooks/statusline.py

@@ -13,9 +13,12 @@ import threading
 from datetime import datetime, timezone
 from typing import Any
 
-sys.stdout.reconfigure(encoding='utf-8')
-sys.stderr.reconfigure(encoding='utf-8')
-sys.stdin.reconfigure(encoding='utf-8')
+try:
+    sys.stdin.reconfigure(encoding='utf-8')
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
 
 MAX_INPUT = 64 * 1024  # 64 KB
 

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/.claude/skills/parallel-agents/SKILL.md

@@ -157,7 +157,7 @@ wave を起動する前に `git status` が空（未コミット変更なし）
 各 Agent ツール呼び出しに以下を指定:
 
 - `subagent_type`: 上記マッピング表の値
-- `model`: **親 Claude は `model:` を指定しない**。`wt_developer` タスクは起動時に PreToolUse hook（`.claude/hooks/tier_autoapply.py`）が `[tier-routing 推奨]`（developer 基準）の推奨 Tier を `model:` へ自動適用する（機械適用・親 Claude が model: を転記する必要はない）。この推奨 Tier の SSOT は `.claude/state/tier_selection.json` の `tier`（無ければ `suggested_model`）であり、kickoff の UserPromptSubmit で 1 度確定して以降 wave をまたいで安定する（`[tier-routing 推奨]` の表示テキストはその派生表示）。hook は実適用した model を `.claude/state/tier_autoapply.jsonl` に記録する（適用者=記録 SSOT）。並列 wave 内に複数の `wt_developer` が居る場合、**全 wt_developer は同一の推奨 Tier（単一 tier_selection.json.tier）で起動される。これは本 MVP の設計として明示的に許容する**（per-task complexity に応じて wt_developer ごとに tier を変える機能は本 MVP のスコープ外・フェーズ 3 以降）。推奨と異なる Tier を使いたい場合のみ `model:` を明示指定する（明示指定は hook に尊重され上書きされない）。`wt_tester` は **test- タスク（Red）に限り機械適用対象**（`C3_TASK_ID` マーカーの `test-` プレフィックスで RED_APPLY_ROLES 注入・confirm- 等の非 test- タスクは対象外＝frontmatter 任せ）。`wt_systematic-debugger` / `code-reviewer` / `security-reviewer` は **model: 指定対象外**（frontmatter/元 agent 任せ・機械適用対象外）。fork は model 上書き不可のため対象外。
+- `model`: **親 Claude は `model:` を指定しない**。`wt_developer` タスクは起動時に PreToolUse hook（`.claude/hooks/tier_autoapply.py`）が `[tier-routing 推奨]`（developer 基準）の推奨 Tier を `model:` へ自動適用する（機械適用・親 Claude が model: を転記する必要はない）。この推奨 Tier の SSOT は `.claude/state/tier_selection.json` の `tier`（無ければ `suggested_model`）であり、kickoff の UserPromptSubmit で 1 度確定して以降 wave をまたいで安定する（`[tier-routing 推奨]` の表示テキストはその派生表示）。hook は実適用した model を `.claude/state/tier_autoapply.jsonl` に記録する（適用者=記録 SSOT）。並列 wave 内に複数の `wt_developer` が居る場合、**全 wt_developer は同一の推奨 Tier（単一 tier_selection.json.tier）で起動される。これは本 MVP の設計として明示的に許容する**（per-task complexity に応じて wt_developer ごとに tier を変える機能は本 MVP のスコープ外・フェーズ 3 以降）。推奨と異なる Tier を使いたい場合のみ `model:` を明示指定する（明示指定は hook に尊重され上書きされない）。**上流環境変数の注意**: `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`（Claude Code v2.1.257+）が設定されていると、ハーネスは per-spawn の `model:`（hook 注入・明示指定とも）と agent 定義の `model:` を無視して全サブエージェントを強制モデルで起動する。hook は注入と `tier_autoapply.jsonl` 記録を行うため、記録された tier と実適用モデルが乖離する。C3 は同変数を設定しない。tier-routing を使う環境ではこの変数を設定しないこと（`CLAUDE_CODE_SUBAGENT_MODEL` は既定値扱いで注入が優先されるため影響なし・v2.1.251+）。`wt_tester` は **test- タスク（Red）に限り機械適用対象**（`C3_TASK_ID` マーカーの `test-` プレフィックスで RED_APPLY_ROLES 注入・confirm- 等の非 test- タスクは対象外＝frontmatter 任せ）。`wt_systematic-debugger` / `code-reviewer` / `security-reviewer` は **model: 指定対象外**（frontmatter/元 agent 任せ・機械適用対象外）。fork は model 上書き不可のため対象外。
 - `isolation`: **`read_only: false` タスクのみ `"worktree"` を指定する。ただし `writes` が全て gitignored ファイル（実質 `.claude/reports/` のレポートのみ）のタスク（confirm- 系が典型）は git 的に「未変更」の worktree となるため Agent 完了時に auto-cleanup され、親が取り込む前に成果物が消失する（2026-07-26 実測）ため、worktree を使わず `isolation` を省略して main 直接経路・素の agent（読み替え: `wt_tester`→`tester` 等）で起動する。`read_only: true`（code-reviewer / security-reviewer）はソースを変更しないため worktree 不要。`isolation` を省略して main リポジトリで直接実行し、レポートを main の `.claude/reports/` に直接書かせる。**
   > **R5 hook による機械強制**: 上記ルールに違反して `read_only: true` のレビュータスクに `isolation: "worktree"` を指定した場合、`.claude/hooks/check_agent_invocation.py`（PreToolUse Agent hook）が exit 2 でブロックする。詳細は `.claude/skills/dev-workflow/references/plan-design-guidelines.md` R5 参照。
 - `run_in_background`: `true`

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/.gitignore

@@ -86,3 +86,7 @@ site/
 # Personal Claude Code overrides (per-user / per-worktree, never committed)
 # wheel からは _excludes.py / hatch_build.py で既に除外済み。git でも tracking しない方針。
 .claude/settings.local.json
+
+# agent 作業残骸 pytest_temp.ini の再発防止ガード（2026-05-02 混入・v0.4.2〔44be00f〕で削除＋
+# EXCLUDE_PATTERNS ガード化。本行はその git 側の対）
+.claude/pytest_temp.ini

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## [2.76.0] - 2026-09-04
+
+### 追加
+
+- `.claude/CLAUDE.md` に「根本解決の原則（監査・レビューを通すための対応をしない）」節を追加した。
+  監査（C-3）・レビュー（E）・テストの指摘に対し、指摘を消すためだけの対応（言い換え・周辺の付け足し・
+  機構の差し替え）を禁じ、根本問題を 1 文で書いてそれを解く手段を採る原則 5 項目と、判断の手順 5 段階
+  （根本問題の 1 文化 → 解く/隠すの仕分け → 修正範囲が大きくても設計・計画に載せる → 一次資料と再現実験で
+  裏取り → 根本問題が解けたことを実測で示す）を定めた。対症療法しか取れない場合は理由を明記し、
+  根本解決へ戻るトリガーをセッションファイルの残タスクに残す。是正ループの打切条件（3 連続で前提を疑う）は
+  dev-workflow E-3 を唯一の正本とし、本節には重複記述を置かない。利用先プロジェクトで運用して不足と
+  判明した規約を C3 本体へ取り込んだもの
+
+### 変更
+
+- `parallel-agents` skill の `model:` 指定規則と `docs/spec/02-hooks.md` の tier_autoapply 仕様表に、
+  Claude Code v2.1.257 で追加された環境変数 `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` の注意を追記した。
+  同変数が設定されていると per-spawn の `model:`（hook 注入・明示指定とも）と agent 定義の `model:` が
+  ハーネス側で無視され、tier_autoapply が記録した tier と実適用モデルが乖離する。C3 は同変数を設定しない
+  （`CLAUDE_CODE_SUBAGENT_MODEL` は v2.1.251 以降既定値扱いで注入が優先されるため影響なし）
+
+## [2.75.0] - 2026-08-16
+
+### 追加
+
+- **`c3 init` のテンプレート展開（`_copytree`）に symlink / NTFS ジャンクション防御を追加した**:
+  各 entry の realpath が「コピー元ルートの realpath ＋ 相対パス」と完全一致することを検査し、
+  一致しない entry（symlink・ジャンクション・壊れたリンク）はコピーせず stderr へ 1 件 1 行の警告を
+  出してスキップする。`is_symlink()` 単体判定はジャンクションに `False` を返すため採用せず、
+  realpath 完全一致方式に一本化した。比較の両辺とも realpath 済みのため、コピー元ルート自体が
+  リンク経由（macOS の `/tmp` 等）でも全件スキップに縮退しない。加えて:
+  - entry 側の realpath が `OSError`（`ELOOP` 含む）を送出した場合は「リンク疑い」として
+    警告付きスキップに倒す（fail-soft・`c3 init` 全体は異常終了しない。ルート側の解決不能は
+    テンプレート根本の異常のため従来どおり例外で停止する）
+  - `shutil.copy2` 直前にリンク再検証を行い、検査とコピーの間の差し替え（TOCTOU）の窓を狭めた
+    （残余の窓は脅威モデル上許容・docstring に記録）
+  - 性質テスト `tests/test_cli_init_symlink_guard.py` を新設（symlink 系・ジャンクション実測・
+    ルートをリンク経由で渡す回帰ガード・例外系/再検証の検知テストを含む）。ジャンクション/リンク作成の
+    テストヘルパー `_make_link` は `tests/conftest.py` へ共有化した
+- `.claude/hooks/statusline.py` の reconfigure 保護テスト
+  `tests/hooks/test_statusline_reconfigure_guard.py` を新設した（`reconfigure` 属性を持たない
+  ストリーム環境でも hook のロードがクラッシュしないこと）
+
+### 変更
+
+- `.claude/hooks/statusline.py` のストリーム reconfigure を canonical 順序（stdin→stdout→stderr）＋
+  `try/except AttributeError` の確立イディオムへ統一した（配布 hook 22 本で唯一の無保護だった）
+- `README.md` / `docs/getting-started.md` の前提条件に仮想環境（venv）の作成手順を追加した。
+  PEP 668（externally-managed-environment）環境で素の `pip install` が失敗する旨と、
+  隔離環境の但し書き 3 点（Claude Code を起動するシェルでも同じ venv を activate すること・
+  `pipx install claude-code-conductor` の代替・同一シェルでの `c3 doctor` による PATH 解決確認）を明記した
+- root `.gitignore` に `.claude/pytest_temp.ini` のガード行を追加した（2026-05-02 に agent 作業残骸として
+  混入し v0.4.2 で削除＋`EXCLUDE_PATTERNS` ガード化された経緯の git 側の対）。これに伴い
+  `tests/test_three_file_sync.py` の許容リスト A から同エントリを削除し、実効検査件数の下限を
+  16 / 16（遊びなし）へ締めた
+
 ## [2.74.0] - 2026-08-15
 
 ### 追加

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-code-conductor
-Version: 2.74.0
+Version: 2.76.0
 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
@@ -268,6 +268,30 @@ C3 の `.claude/` はプロジェクトコードに一切触れません。既
 - [Claude Code](https://claude.ai/code) がインストール済みでログインしていること
 - Python 3.10 以上がインストール済みであること
 
+**仮想環境（venv）の準備（推奨）**
+
+Python の導入方法によっては、素の `pip install` が PEP 668（externally-managed-environment）により拒否されます（Debian/Ubuntu の apt 版 Python、Homebrew の Python など）。仮想環境（venv）を作ってその中へインストールすれば、この制約を受けずに済みます。
+
+Windows（PowerShell）:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+```
+
+macOS / Linux:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+venv に入れた場合の注意:
+
+- C3 の hook は `c3 run` で起動されるため、**Claude Code を起動するシェルでも同じ venv を activate してください**。activate されていないシェルから Claude Code を起動すると `c3` が見つからず、hook が動作しません
+- venv を使わずグローバルに使いたい場合は [pipx](https://pipx.pypa.io/) が代替になります: `pipx install claude-code-conductor`
+- インストール後は、**Claude Code を起動するのと同じシェルで** `c3 doctor` を実行し、`c3` が PATH で解決されることを確認してください（`c3 doctor` が検査するのは実行中シェルの PATH です。別のシェルで実行しても、Claude Code の hook が起動される文脈は再現できません）
+
 ### 手順（推奨: PyPI から）
 
 **1. C3 をインストールする**
@@ -276,6 +300,8 @@ C3 の `.claude/` はプロジェクトコードに一切触れません。既
 pip install claude-code-conductor
 ```
 
+> このコマンドが PEP 668（externally-managed-environment）で拒否される場合や、インストール後に hook が動作しない場合は、[前提条件](#前提条件)の venv 手順（activate するシェルの注意点を含む）を参照してください。
+
 **2. プロジェクトに `.claude/` を展開する**
 
 ```bash

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/README.md

@@ -223,6 +223,30 @@ C3 の `.claude/` はプロジェクトコードに一切触れません。既
 - [Claude Code](https://claude.ai/code) がインストール済みでログインしていること
 - Python 3.10 以上がインストール済みであること
 
+**仮想環境（venv）の準備（推奨）**
+
+Python の導入方法によっては、素の `pip install` が PEP 668（externally-managed-environment）により拒否されます（Debian/Ubuntu の apt 版 Python、Homebrew の Python など）。仮想環境（venv）を作ってその中へインストールすれば、この制約を受けずに済みます。
+
+Windows（PowerShell）:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+```
+
+macOS / Linux:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+venv に入れた場合の注意:
+
+- C3 の hook は `c3 run` で起動されるため、**Claude Code を起動するシェルでも同じ venv を activate してください**。activate されていないシェルから Claude Code を起動すると `c3` が見つからず、hook が動作しません
+- venv を使わずグローバルに使いたい場合は [pipx](https://pipx.pypa.io/) が代替になります: `pipx install claude-code-conductor`
+- インストール後は、**Claude Code を起動するのと同じシェルで** `c3 doctor` を実行し、`c3` が PATH で解決されることを確認してください（`c3 doctor` が検査するのは実行中シェルの PATH です。別のシェルで実行しても、Claude Code の hook が起動される文脈は再現できません）
+
 ### 手順（推奨: PyPI から）
 
 **1. C3 をインストールする**
@@ -231,6 +255,8 @@ C3 の `.claude/` はプロジェクトコードに一切触れません。既
 pip install claude-code-conductor
 ```
 
+> このコマンドが PEP 668（externally-managed-environment）で拒否される場合や、インストール後に hook が動作しない場合は、[前提条件](#前提条件)の venv 手順（activate するシェルの注意点を含む）を参照してください。
+
 **2. プロジェクトに `.claude/` を展開する**
 
 ```bash

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/src/c3/__init__.py

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

{claude_code_conductor-2.74.0 → claude_code_conductor-2.76.0}/src/c3/cli_init.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import argparse
+import os
 import shutil
 import sys
 from collections.abc import Callable
@@ -181,28 +182,99 @@ def _do_git_init(target_root: Path) -> None:
         )
 
 
-def _copytree(src: Path, dst: Path, *, root: Path | None = None) -> int:
+def _is_link_entry(entry: Path, real_root: str, rel: str) -> bool:
+    """FR-4 choke point: realpath 完全一致でリンク経由の entry を検出する。
+
+    ``entry.is_symlink()`` は NTFS ディレクトリジャンクションに ``False`` を返し
+    素通りする（ADR-3・既知パターンの再発 5 回）ため採用しない。判定は
+    「entry の realpath」と「コピー元ルートの realpath ＋ ルートからの相対パス」の
+    完全一致（``.claude/skills/start/scripts/archive_reports.py`` の
+    ``_archive_dir_is_contained`` と同じ realpath 封じ込め方式）。
+
+    ``real_root`` は**呼び出し側で解決済みの** コピー元ルートの realpath（文字列）を
+    受け取る契約（ADR-3 追補 2・``_copytree`` が再帰境界で 1 回だけ計算して伝播する）。
+    本関数は root 側の realpath を行わない。比較の両辺とも realpath 済みであることが
+    判定の前提であり、その担保は呼び出し側の責務になる。
+
+    entry 側の realpath は ``OSError``（ELOOP・EACCES 等）を送出しうる。解決できない
+    entry は安全側に倒して「リンク疑い（``True``）」として扱い、呼び出し側の
+    警告付きスキップに委ねる（fail-soft・ADR-3 追補 1）。
+    """
+    # expected は「rel の各コンポーネントをリンクとして解決せず」文字列結合した
+    # 期待パス。os.path.realpath はここでは呼ばない（呼ぶと entry 側と同じ
+    # リンクを辿ってしまい、判定そのものが無効化される）。
+    expected = os.path.normpath(os.path.join(real_root, *rel.split("/")))
+    try:
+        actual = os.path.realpath(entry)
+    except OSError:
+        return True
+    return actual != expected
+
+
+def _copytree(
+    src: Path, dst: Path, *, root: Path | None = None, real_root: str | None = None
+) -> int:
     """Copy ``src`` -> ``dst`` recursively, skipping personal/working files.
 
     ``root`` defaults to ``src`` and represents the ``.claude/`` directory; the
     relative path from ``root`` is what ``should_skip`` matches against.
     Returns the number of regular files written.
+
+    ``real_root`` は ``root`` の realpath（解決済み文字列）。``None`` の初回呼び出しで
+    1 回だけ計算し、再帰には計算済みの値を渡す（ADR-3 追補 2 の hoist。entry 総数 N 回の
+    重複計算を 1 回に落とす）。
+
+    root 側 realpath の失敗（``OSError``）は捕捉せず伝播させる。root が解決不能なのは
+    テンプレート根本の異常であり、全 entry を「リンク疑い」として警告付きスキップし
+    「0 件コピーの exit 0」を返すより、例外で止める方が利用者に正しく伝わるため
+    （per-entry の fail-soft はコピー継続に意味がある場合の設計であり、根本が解決不能なら
+    継続に意味がない・ADR-3 追補 1）。
+
+    リンク判定 ``_is_link_entry`` の適用位置はファイル経路の 2 箇所のみ:
+    (i) ``should_skip`` 前段の初回判定 (ii) ``shutil.copy2`` 直前の再検証。
+    ディレクトリ側に再検証は追加しない。ディレクトリ entry が判定後にリンクへ
+    差し替わっても、再帰先の per-entry 検査で全子 entry の realpath が
+    ``real_root`` + rel と一致しなくなり内容は漏れないため（構造的再検証・ADR-3 追補 3）。
     """
     if root is None:
         root = src
+    if real_root is None:
+        # root 側の realpath はここで 1 回だけ。失敗は上記のとおり伝播させる。
+        real_root = os.path.realpath(root)
     dst.mkdir(parents=True, exist_ok=True)
     count = 0
     for entry in src.iterdir():
         rel = entry.relative_to(root).as_posix()
         target = dst / entry.name
+        # FR-4: リンク経由の entry は is_dir()/is_file() 分岐より前にスキップする
+        # （両者ともリンクを暗黙に辿るため）。EXCLUDE 対象かどうかに関わらず
+        # 検査するため should_skip より前段に置く（架空の EXCLUDE リンクも警告する・
+        # architecture DC-GP-003 裁定）。
+        if _is_link_entry(entry, real_root, rel):
+            print(
+                f"c3 init: リンク（symlink/junction）疑いの entry をスキップしました: {rel}",
+                file=sys.stderr,
+            )
+            continue
         if entry.is_dir():
-            count += _copytree(entry, target, root=root)
+            count += _copytree(entry, target, root=root, real_root=real_root)
             # Drop directories that ended up empty (everything inside was skipped).
             if not any(target.iterdir()):
                 target.rmdir()
         elif entry.is_file():
             if should_skip(rel):
                 continue
+            # 初回判定から copy2 到達までの間にリンクへ差し替わる TOCTOU を狭めるため、
+            # copy2 の直前で同じ choke point を再検証する（ADR-3 追補 3）。
+            # 残余リスク: 再検証と copy2 の間の窓は閉じない。窓を閉じる ``O_NOFOLLOW`` は
+            # POSIX 限定で Windows を含む配布対象では採用できないため不採用とし、
+            # 脅威モデル（ローカル開発者ツール）上この残余窓は許容する（ADR-3 追補 5）。
+            if _is_link_entry(entry, real_root, rel):
+                print(
+                    f"c3 init: リンク（symlink/junction）疑いの entry をスキップしました: {rel}",
+                    file=sys.stderr,
+                )
+                continue
             shutil.copy2(entry, target)
             count += 1
     return count

claude_code_conductor-2.76.0/tests/conftest.py

@@ -0,0 +1,57 @@
+"""
+tests/conftest.py
+
+pytest 共通セットアップ。
+worktree の src/ を sys.path の最初に追加し、テストがworktree のコードを使用するようにする。
+.claude/hooks/ も追加し、importlib 経由で stop.py / pre_compact.py を
+ロードするテストが session_utils をインポートできるようにする。
+
+リンク（symlink / junction）を実ファイルシステム上に作る共有ヘルパー ``_make_link``
+もここに置く。利用側は ``from tests.conftest import _make_link`` の**絶対 import**
+で参照する（tests/__init__.py が実在するパッケージ構成のため
+``from conftest import ...`` は ModuleNotFoundError になる）。
+"""
+import os
+import sys
+from pathlib import Path
+
+import pytest
+
+# Ensure worktree src is imported, not system-installed c3 package
+worktree_root = Path(__file__).parent.parent
+sys.path.insert(0, str(worktree_root / "src"))
+sys.path.insert(1, str(worktree_root / ".claude" / "hooks"))
+
+
+def _make_link(target: Path, link: Path) -> None:
+    """``link`` を ``target`` を指すリンクとして作る（OS 差を吸収する共有ヘルパー）.
+
+    Windows は junction（``_winapi.CreateJunction``・管理者権限不要）、
+    POSIX は ``os.symlink`` を使う。作成に失敗した場合は skip せず fail させる
+    （skip すると「リンクを辿らない」という契約が全 OS で無検証になりうる）。
+
+    呼び出し側が知っておくべき OS 差（実測・2026-08-15 / Windows 11）:
+
+    - junction は ``Path.is_symlink()`` が **False** を返し、``Path.is_dir()`` は
+      **True** を返す（＝素朴な ``is_symlink()`` ガードでは弾けない）
+    - junction は**ディレクトリ専用**。ファイルへのリンクは
+      ``os.symlink`` が必要で、非特権 Windows では ``WinError 1314``
+      (privilege not held) で失敗する
+    - 存在しないターゲットへの junction は ``FileNotFoundError`` で作れない
+      （dangling リンクのテストは POSIX 限定になる）
+
+    元は tests/test_stop_agent_memory_warn.py のローカルヘルパーだったものを、
+    tests/test_cli_init_symlink_guard.py と共有するため conftest へ移設した。
+    """
+    if sys.platform == "win32":
+        try:
+            import _winapi
+
+            _winapi.CreateJunction(str(target), str(link))
+        except Exception as exc:  # pragma: no cover - 環境不備時のみ
+            pytest.fail(f"junction の作成に失敗した（skip せず fail させる契約）: {exc!r}")
+    else:
+        try:
+            os.symlink(str(target), str(link), target_is_directory=True)
+        except OSError as exc:  # pragma: no cover - 環境不備時のみ
+            pytest.fail(f"symlink の作成に失敗した（skip せず fail させる契約）: {exc!r}")

claude_code_conductor-2.76.0/tests/hooks/test_statusline_reconfigure_guard.py

@@ -0,0 +1,197 @@
+"""[FR-3] .claude/hooks/statusline.py の reconfigure 保護に関する性質テスト。
+
+測るべき性質:
+    statusline.py はモジュールレベルで sys.stdout / sys.stderr / sys.stdin の
+    ``reconfigure(encoding='utf-8')`` を呼ぶ。``reconfigure`` 属性を持たない
+    ストリームオブジェクトが差し込まれている環境（pytest の ``DontReadFromInput``、
+    パイプ・ラッパ経由で差し替えられた擬似ストリーム等）でも、
+    **モジュールのロードが AttributeError でクラッシュしてはならない**。
+    すなわち CLAUDE.md §9-3 の canonical idiom
+    （``try: ... except AttributeError: pass``）による保護が入っていること。
+
+Red の正体:
+    無保護の現行実装（statusline.py:16-18）では、reconfigure を持たない
+    ストリーム注入下で exec_module が ``AttributeError`` を送出して落ちる。
+    保護が入ると緑に反転する。AttributeError は握り潰さず伝播させ、
+    pytest の traceback に実際の例外型・メッセージが出るようにしている
+    （Red が「正しい理由で赤い」ことを実出力で確認できるようにするため）。
+
+意図的な設計上の制約（変更しないこと）:
+    * モジュールのロードは ``importlib.util.spec_from_file_location`` +
+      ``exec_module`` で **毎回再実行** する。``import statusline`` は
+      tests/conftest.py:15 の sys.path 挿入で成立してしまうが、sys.modules
+      キャッシュにより 2 回目以降モジュール本体が再実行されず「空の緑」になる。
+      前例は tests/hooks/test_statusline.py:38-53 の ``load_statusline()``。
+    * 注入するストリームは reconfigure 属性を持たない **実オブジェクト**
+      （``io.StringIO``）とする。``MagicMock`` は未定義属性を自動生成するため
+      「reconfigure を持つ」ことになり、無保護実装でも赤にならない。
+    * 3 ストリームの差し替えは ``monkeypatch.setattr(sys, ...)`` でテスト内に閉じ、
+      teardown で確実に復元する。ambient なストリームには依存しない
+      （tests/test_statusline.py:18-21 は sys.stdin をグローバル置換したまま
+      復元しないため、ambient に依存すると Red が Red にならない）。
+    * **reconfigure 呼び出しの「粒度」は敢えて検証しない。** CLAUDE.md §9-3 の
+      canonical idiom は 3 ストリームを 1 つの try ブロックで囲む形であり、
+      「1 本壊れても残り 2 本は reconfigure されること」を要求すると
+      canonical idiom を弾いてしまう。要求するのは
+      「クラッシュしないこと」＋「対応ストリームには実際に適用されること」の 2 点のみ。
+"""
+
+import importlib.util
+import io
+import itertools
+import sys
+import types
+from pathlib import Path
+
+import pytest
+
+STATUSLINE_PATH = (
+    Path(__file__).parents[2]
+    / ".claude"
+    / "hooks"
+    / "statusline.py"
+)
+
+#: statusline.py がモジュールレベルで reconfigure を呼ぶ 3 ストリーム
+STREAM_NAMES = ("stdin", "stdout", "stderr")
+
+#: exec_module ごとにユニークなモジュール名を振り、キャッシュ経由の再利用を避ける
+_load_counter = itertools.count()
+
+
+def _stream_without_reconfigure() -> io.StringIO:
+    """``reconfigure`` を持たない実ストリームを返す。
+
+    テスト自体の有効性（この注入が無保護実装を確実に赤にすること）を
+    その場で表明しておく。将来 io.StringIO に reconfigure が生えたら、
+    サイレントに空の緑になるのではなくここで落ちる。
+    """
+    stream = io.StringIO()
+    assert not hasattr(stream, "reconfigure"), (
+        "io.StringIO が reconfigure を持つ実装では、この注入は無保護実装を"
+        "赤にできない（テストの検出力が失われている）"
+    )
+    return stream
+
+
+def _stream_with_reconfigure() -> io.TextIOWrapper:
+    """``reconfigure`` を持ち、適用されたかを ``encoding`` で観測できる実ストリーム。
+
+    初期 encoding は utf-8 以外（latin-1）にしておく。こうすることで
+    「utf-8 になっている」ことが reconfigure が実際に呼ばれた証拠になる。
+    """
+    stream = io.TextIOWrapper(io.BytesIO(), encoding="latin-1")
+    assert hasattr(stream, "reconfigure")
+    assert stream.encoding != "utf-8"
+    return stream
+
+
+def _exec_statusline() -> types.ModuleType:
+    """statusline.py を毎回新規に exec してモジュールオブジェクトを返す。
+
+    ``__name__`` にユニーク名を与えるため ``if __name__ == '__main__'`` 配下の
+    ``main()`` は起動しない（ロード自体は副作用を持たない）。
+    """
+    name = f"_statusline_reconfigure_probe_{next(_load_counter)}"
+    spec = importlib.util.spec_from_file_location(name, STATUSLINE_PATH)
+    assert spec is not None and spec.loader is not None
+    mod = importlib.util.module_from_spec(spec)
+    # module_from_spec は sys.modules に登録しない = 毎回本体が再実行される
+    assert name not in sys.modules
+    spec.loader.exec_module(mod)
+    return mod
+
+
+def _assert_module_fully_executed(mod: types.ModuleType) -> None:
+    """モジュール本体が最後まで実行されたことを確認する。
+
+    ``main`` は statusline.py:136 の最終 def。これが存在することで
+    「reconfigure 行で中断せず本体を最後まで通った」ことを担保する
+    （途中で例外を握り潰して打ち切る実装を空の緑にしないため）。
+    """
+    assert mod.MAX_INPUT == 64 * 1024
+    assert callable(mod.main)
+    assert callable(mod.render_output)
+    assert callable(mod.pct_color)
+
+
+# ---------------------------------------------------------------------------
+# 本命の性質: reconfigure 非対応ストリーム下でもロードがクラッシュしない
+# ---------------------------------------------------------------------------
+
+def test_module_loads_when_all_three_streams_lack_reconfigure(monkeypatch):
+    """3 ストリーム全てが reconfigure 非対応でも statusline のロードは成功する。
+
+    無保護実装では exec_module が AttributeError で落ちる（Red）。
+    try/except AttributeError 保護が入ると緑に反転する。
+    """
+    for name in STREAM_NAMES:
+        monkeypatch.setattr(sys, name, _stream_without_reconfigure())
+
+    mod = _exec_statusline()
+
+    _assert_module_fully_executed(mod)
+
+
+@pytest.mark.parametrize("broken", STREAM_NAMES)
+def test_module_loads_when_single_stream_lacks_reconfigure(monkeypatch, broken):
+    """3 ストリームのうち 1 本だけが reconfigure 非対応でもロードは成功する。
+
+    「どのストリームが欠けても落ちない」ことを 1 本ずつ独立に固定する。
+    残り 2 本は reconfigure 対応の実オブジェクトにしておくことで、
+    落ちる原因が対象ストリーム 1 本に限定されることを保証する。
+    """
+    for name in STREAM_NAMES:
+        if name == broken:
+            monkeypatch.setattr(sys, name, _stream_without_reconfigure())
+        else:
+            monkeypatch.setattr(sys, name, _stream_with_reconfigure())
+
+    mod = _exec_statusline()
+
+    _assert_module_fully_executed(mod)
+
+
+# ---------------------------------------------------------------------------
+# 反・空実装ガード: 保護を「reconfigure 呼び出しの削除」で通してはならない
+# ---------------------------------------------------------------------------
+
+def test_reconfigure_is_still_applied_when_streams_support_it(monkeypatch):
+    """reconfigure 対応ストリームには utf-8 が実際に適用される。
+
+    本テストは保護導入前から緑であり、Red の一部ではない。
+    「reconfigure 行を丸ごと削除する」という空実装で FR-3 を通す退行を防ぐ
+    回帰ガードとして置く（CLAUDE.md §9-3 が reconfigure 自体を必須としており、
+    削除は cp1252 環境での UnicodeEncodeError クラッシュを復活させる）。
+    """
+    streams = {}
+    for name in STREAM_NAMES:
+        stream = _stream_with_reconfigure()
+        monkeypatch.setattr(sys, name, stream)
+        streams[name] = stream
+
+    mod = _exec_statusline()
+
+    _assert_module_fully_executed(mod)
+    for name, stream in streams.items():
+        assert stream.encoding == "utf-8", (
+            f"sys.{name} が utf-8 に reconfigure されていない "
+            f"(encoding={stream.encoding!r})。reconfigure 呼び出しが"
+            "削除された可能性がある"
+        )
+
+
+def test_broken_stream_injection_is_actually_detectable(monkeypatch):
+    """テスト媒体の有効性: 注入したストリームが reconfigure を持たないこと。
+
+    本テストが緑である限り、上の 2 テストの Red は
+    「reconfigure 属性の不在」に由来すると言い切れる。
+    MagicMock 注入に差し替えられた場合はここが落ちる。
+    """
+    for name in STREAM_NAMES:
+        monkeypatch.setattr(sys, name, _stream_without_reconfigure())
+
+    for name in STREAM_NAMES:
+        stream = getattr(sys, name)
+        assert isinstance(stream, io.StringIO)
+        assert not hasattr(stream, "reconfigure")