claude-code-conductor 2.73.0__tar.gz → 2.75.0__tar.gz

{claude_code_conductor-2.73.0 → claude_code_conductor-2.75.0}/.claude/docs/config-policy.md

@@ -283,17 +283,40 @@ C3 の wheel 配布除外パターンは **3 つのファイルに分散して
 **KEEP 対象が sdist exclude 配下にある場合は `pyproject.toml` の force-include も同期対象**:
 公開ビルドは sdist を経由するため、sdist から落ちたファイルは wheel にも届かない。
 
+この辺（KEEP ↔ sdist exclude / force-include）は `tests/test_three_file_sync.py` が双方向に機械検証する
+（救済漏れと、用途不明な force-include キーの増殖の両方を検出する）。
+ただし **KEEP に相当する配布必須ファイルは force-include による救済を認めず、ignore 規則そのもの（否定行）で戻す**
+（force-include で救うと git 履歴から消える脆い救済になるため。force-include が担うのは sdist exclude 経路の救済に限る）。
+この検査は**配布元 C3 のリポジトリ専用**である: 配布元 C3 が公開する wheel に `tests/` は含まれず、
+利用先プロジェクトにこの検査は配置されない。ただし**配布元 C3 が PyPI へ公開する第二の成果物である
+sdist には `tests/` が含まれる**（`pyproject.toml` の sdist `include`）。sdist は PyPI で公開されるため
+`tests/` 配下の内容は第三者が閲覧可能であり、機密情報を書いてはならない。
+
 ### 同期確認の方法
 
 `.dev/hooks/_sync_check.py`（PostToolUse hook）が、3 ファイルのいずれかを変更した時に
 残り 2 ファイルの同期を `stderr` で警告する。警告が出たら必ず対応する。
 
+同期の実効一致はテスト 2 本が機械検証する（hook の警告は編集時の即時注意喚起、テストは CI /
+フルスイートでの機械判定という役割分担）:
+
+| テスト | 検証する辺 |
+|---|---|
+| `tests/test_excludes.py` | `_excludes.py` ↔ `hatch_build.py`（パターン集合の完全一致） |
+| `tests/test_three_file_sync.py` | `.gitignore` ↔ `_excludes.py`（挙動の一致）・`pyproject.toml` の sdist exclude / force-include |
+
+これらのテストも**配布元 C3 のリポジトリ専用**である: 配布元 C3 が公開する wheel に `tests/` は
+含まれず、利用先プロジェクトにこれらのテストは配置されない。ただし**配布元 C3 が PyPI へ公開する
+第二の成果物である sdist には `tests/` が含まれる**（`pyproject.toml` の sdist `include`）。
+sdist は PyPI で公開されるため `tests/` 配下の内容は第三者が閲覧可能であり、機密情報を書いてはならない。
+
 ### 変更手順
 
 1. `.gitignore` / `_excludes.py` / `hatch_build.py` のいずれかを変更
 2. `_sync_check.py` の警告を確認
 3. 残り 2 ファイルに同じパターンを追加（または削除）。3 ファイルが既に同じ意図を持っている場合は、出遅れた 1 ファイルを合わせるだけでよい（配布元の root `.gitignore` を `KEEP_PATTERNS` の意図へ合わせた 2026-08-14 の是正が実例）
-4. 配布元では `python scripts/verify_wheel.py` で wheel 実体を機械検証する（`scripts/` は配布物に含まれないため、利用先には存在しないコマンド）
+4. 意図的差分（3 ファイルの意図をあえて揃えない例外）を増減する場合は、`tests/test_three_file_sync.py` の許容リスト（理由文字列必須）と件数定数群を同時更新する（配布元専用。増減いずれの場合もレビュー対象）
+5. 配布元では `python scripts/verify_wheel.py` で wheel 実体を機械検証する（`scripts/` は配布物に含まれないため、利用先には存在しないコマンド）
 
 ### 過去の同期漏れ defect
 

{claude_code_conductor-2.73.0 → claude_code_conductor-2.75.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.73.0 → claude_code_conductor-2.75.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.73.0 → claude_code_conductor-2.75.0}/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## [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
+
+### 追加
+
+- **3 ファイル同期（`.gitignore` / `_excludes.py` / `pyproject.toml`）を機械検証化した**:
+  `tests/test_three_file_sync.py`（検査）と `tests/_sync_semantics.py`（検出器・引数注入の
+  純粋関数）を追加した。これまで `.dev/hooks/_sync_check.py` の警告（編集時の注意喚起）しか
+  無かった辺を、CI / フルスイートで機械判定する:
+  - 辺 1: `_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` と root `.gitignore` の意図一致を、
+    表記の一致ではなく**挙動の一致**（プローブパス＋`git check-ignore` の実挙動／`should_skip`）で
+    双方向に検証する
+  - 辺 2: `KEEP_PATTERNS` と `pyproject.toml` の sdist force-include を双方向に検証する
+    （救済漏れと、用途不明な force-include キーの増殖の両方を検出）
+  - 辺 3: sdist exclude の `.claude/` エントリが `should_skip` の意図と整合することを検証する
+
+  意図的差分は理由文字列必須の許容リストとして明示し、実効検査件数の下限・許容リスト件数を
+  凍結して「何も検査していないのに緑」になる退化を塞いでいる。
+  `.dev/hooks/_sync_check.py` は編集時の即時フィードバック層として存置する。
+
+### 変更
+
+- `/CLAUDE.md` §2 と `.claude/docs/config-policy.md` §6 に、上記の機械検証 2 本と
+  許容リスト・件数定数群の同時更新の運用を追記した（**配布元 C3 のリポジトリ専用の検査**である旨の
+  但し書き付き。配布元 C3 が公開する wheel に `tests/` は含まれず利用先プロジェクトには配置されないが、
+  配布元 C3 が PyPI へ公開する第二の成果物である sdist には `tests/` が含まれる。sdist は PyPI で
+  公開されるため `tests/` 配下の内容は第三者が閲覧可能であり、機密情報を書いてはならない）。
+
 ## [2.73.0] - 2026-08-15
 
 ### 追加

{claude_code_conductor-2.73.0 → claude_code_conductor-2.75.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-code-conductor
-Version: 2.73.0
+Version: 2.75.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.73.0 → claude_code_conductor-2.75.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.73.0 → claude_code_conductor-2.75.0}/src/c3/__init__.py

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

{claude_code_conductor-2.73.0 → claude_code_conductor-2.75.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