claude-code-conductor 2.17.0__tar.gz → 2.18.0__tar.gz

claude_code_conductor-2.18.0/.claude/deletions.txt

@@ -0,0 +1,39 @@
+# C3 c3 update 削除リスト
+# このファイルに記載されたパスは `c3 update` 実行時に
+# 利用先の .claude/ から削除候補として扱われる。
+#
+# 仕様:
+# - 1 行 1 パス、.claude/ 相対表記
+# - # で始まる行はコメント、空行はスキップ
+# - 絶対パス / ../ を含むパス / シンボリックリンク は無視
+# - ディレクトリは削除しない（ファイルのみ）
+#
+# 詳細は .claude/docs/config-policy.md §3 #13 と §7 落とし穴 5 を参照。
+
+# ---- v2.1.0: tdd-develop / worktree-tdd-workflow 廃止 ----
+agents/tdd-develop.md
+skills/worktree-tdd-workflow/SKILL.md
+
+# ---- v2.11.0: summarize-memory 廃止 ----
+agents/summarize-memory.md
+skills/summarize-memory/SKILL.md
+
+# ---- v2.12.0: タクソノミー棚卸（hooks/ → skills/dev-workflow/scripts/ へ移動） ----
+hooks/record_review_decision.py
+hooks/record_tier_outcome.py
+hooks/review_hint_inject.py
+hooks/subagent_log.py
+
+# ---- (v2.x): task-routing skill 廃止 ----
+skills/task-routing/SKILL.md
+
+# ---- v2.15.1: /code-review skill を /review-phase にリネーム ----
+skills/code-review/SKILL.md
+
+# ---- 短期 revert（一時配布された可能性あり） ----
+skills/phase-a-requirements/SKILL.md
+skills/phase-b-architecture/SKILL.md
+skills/phase-c-plan/SKILL.md
+skills/phase-d-implement/SKILL.md
+skills/phase-debug/SKILL.md
+skills/phase-e-review/SKILL.md

{claude_code_conductor-2.17.0 → claude_code_conductor-2.18.0}/.claude/docs/config-policy.md

@@ -104,7 +104,7 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 
 ---
 
-## 3. 配布判断マトリクス（12 カテゴリ）
+## 3. 配布判断マトリクス（13 カテゴリ）
 
 `_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` を実装照合した結果。
 各カテゴリに配布有無・c3 update の更新有無・理由を明示する。
@@ -123,6 +123,7 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 | 10 | `.claude/settings.local.json` | × | — | 個人 override・秘匿情報。`_excludes.py` でも除外、`.gitignore` でも除外、c3 update も触らない |
 | 11 | `.claude/reports/*` / `memory/*` / `agent-memory/*` / `state/*` / `tmp/*` / `worktrees/*` / `logs/*` | × （`.gitkeep` のみ ○） | — | 実行時生成領域。空ディレクトリのみ `KEEP_PATTERNS` の `.gitkeep` で配布。データ本体は除外 |
 | 12 | `.dev/*` / `/CLAUDE.md` / `/AGENTS.md` / `/.codex/` / `/.cursor/` / `/.agents/` | × | — | 配布元専用または adapter 生成物。wheel には構造的に含まれない（`src/c3/_template/.claude/` 配下のみ同梱）が、配布元 `.gitignore` で commit 混入も防ぐ |
+| 13 | `.claude/deletions.txt` | ○ | ○ | `c3 update` が読み込み、利用先 `.claude/` から該当ファイルを削除候補として扱う。配布元の `.claude/deletions.txt` に追記したエントリは次回 pip install → `c3 update` で利用先に伝播。`KEEP_PATTERNS` で明示配布。`c3 update` 自体は本ファイルを削除しない（§7 落とし穴 5 参照） |
 
 > **注意 (カテゴリ #6)**: `taxonomy.md` は `_excludes.py` の EXCLUDE 対象だが、`.gitignore` では tracked 状態（GitHub に公開済み）。
 > **wheel には含まれない**点に注意。gitignore と wheel 配布は別レイヤーであり、
@@ -268,7 +269,29 @@ c3 update が上書きすると利用先で `/promote-pattern` が追記した
 **対処**: `promoted/` への変更は `c3 update` に委ねず、手動または `/promote-pattern` skill で管理する。
 C3 side で `promoted/` の雛形を更新した場合は、リリースノートで手動マージ手順を案内する。
 
-### 落とし穴 4: `permission_rules.json` は `settings.json.permissions.deny` を覆せない（要検証）
+### 落とし穴 4: `deletions.txt` 自身は削除されない・絶対パスは無視される
+
+**症状**: `deletions.txt` が利用先に残り続ける / 絶対パスを書いたのに削除されない / `..` 含みパスが効かない。
+
+**原因**:
+- `deletions.txt` は **`c3 update` が読み取るための指示書** であり、削除対象として
+  `deletions.txt` 自身を含めても無視される（自分自身を削除すると次回 update で
+  ブートストラップが効かなくなるため）
+- セーフガードにより以下は **silent ではなく warning を出して無視** される:
+  - 絶対パス（先頭 `/`、`~`、Windows ドライブレター `C:`）
+  - `..` または `.` を含むパス
+  - `.claude/` プレフィックス（`.claude/agents/x.md` は不可、`agents/x.md` と書く）
+  - シンボリックリンク経由のパス
+  - ディレクトリ（ファイルのみサポート）
+  - `\` （バックスラッシュ）を含むパス
+
+**対処**:
+- 削除候補に書くパスは「.claude/ からの相対 POSIX パス」のみ（例: `agents/foo.md`）
+- ディレクトリを丸ごと削除したい場合は、配下のファイルを 1 つずつ列挙
+- `c3 update --dry-run` で warning が出ていないか確認
+- `deletions.txt` 自身を更新したい場合は通常の `c3 update` の add/update ロジックが処理する
+
+### 落とし穴 5: `permission_rules.json` は `settings.json.permissions.deny` を覆せない（要検証）
 
 **現状**: `permission_handler.py` の実装を読む限り、`PermissionRequest` hook は
 Claude Code 側で `deny` 判定が出た後に発火するため、`permission_rules.json` の `auto_allow` で
@@ -304,5 +327,5 @@ Claude Code 側で `deny` 判定が出た後に発火するため、`permission_
 
 - `permission_rules.json` の `auto_allow` が `settings.json.permissions.deny` を覆せるか検証
 - `~/.claude/settings.json` のグローバル設定と `.claude/settings.json` の同キー競合時のマージ範囲確認
-- `c3 update` の削除検出（`deletions.txt` 方式、v2.18.0 予定）
+- ~~`c3 update` の削除検出（`deletions.txt` 方式、v2.18.0 予定）~~ → v2.18.0 で実装
 - `c3 update` 時の Breaking changes 警告（v2.19.0 予定）

{claude_code_conductor-2.17.0 → claude_code_conductor-2.18.0}/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## v2.18.0 (2026-05-24)
+
+**基盤整備リリース第 2 弾**: `c3 update` の削除検出を `deletions.txt` 方式で導入する。
+v2.0.0 以来の `c3_update_no_delete_detection` defect（リリースで廃止した
+skill / hook / agent が利用先に残り続ける問題）を構造的に解消する。
+
+### 追加
+
+- **`.claude/deletions.txt`**（新規）: 利用先で削除すべきファイルパス一覧。
+  1 行 1 パス、`#` でコメント、`.claude/` 相対 POSIX パス。v2.1.0 / v2.11.0 /
+  v2.12.0 / v2.15.1 までの過去廃止 16 ファイルを初期エントリとして同梱。
+- **`c3 update` の自動削除機能**: `_template/.claude/deletions.txt` を読み、
+  利用先の該当ファイルを削除候補として扱う。`--dry-run` で予告のみ、通常実行は
+  確認プロンプト `y/N`、`--yes` / `-y` フラグでプロンプトスキップ可。
+- **`--yes` / `-y` フラグ**（新規）: 削除確認プロンプトをスキップする。
+  **CI / 自動化ワークフロー専用**。対話環境での常用は推奨しない。
+  `--dry-run` と同時指定しても効果なし。
+- **13 段セーフガード**: 削除対象パスに対する 13 種類の事前検査
+  - 文字列レベル: 空パス / 絶対パス / `~` / バックスラッシュ / Windows ドライブレター /
+    `.claude/` プレフィックス禁止 / ANSI エスケープシーケンス検出（ECMA-48 §5.4 全網羅）
+  - 構造レベル: `..` `.` 含み / null byte / `Path.is_symlink()` でシンボリックリンク拒否 /
+    `Path.resolve()` で `.claude/` 配下確認 / `Path.is_dir()` でディレクトリ拒否 /
+    `deletions.txt` 自身の自己削除拒否（Windows NTFS case-insensitive 対応）
+- **新規テスト 35 件**: `tests/test_cli_update_deletions.py` に A: ユニット 14 件 /
+  B: 結合 8 件 / C: 攻撃 10 件 / D: CLI 4 件 = 計 36 件（既存 DEPRECATED_PATHS
+  テスト 3 件削除 → 純増 32 件）
+
+### 撤去
+
+- **`cli_update.py` の `DEPRECATED_PATHS` 定数 + `_warn_deprecated_paths()`
+  関数**: v2.15.1 で導入した「stderr 警告のみ・削除しない」方式を完全撤去し、
+  `deletions.txt` 方式に一元化。
+
+### ドキュメント
+
+- **`.claude/docs/config-policy.md`**:
+  - §3 配布判断マトリクス 12 → 13 カテゴリ（`deletions.txt` 追加）
+  - §7「既知の落とし穴」5 項目目「`deletions.txt` 自身は削除されない・
+    絶対パスは無視される」追加
+  - §8 残課題から「v2.18.0 予定」を完了化
+
+### セキュリティ
+
+- パストラバーサル / 絶対パス / Home (`~`) / Windows ドライブレター /
+  バックスラッシュ / `.claude/` プレフィックス / 親遡り / シンボリックリンク経由 /
+  ディレクトリ削除 / Windows case-insensitive バイパス / ANSI CSI シーケンス /
+  null byte / `deletions.txt` 自身 — 計 12 種の攻撃面を構造的に防御
+- Round 1 + Round 2 + Round 3 で計 17 件のレビュー指摘（CR 10 + SR 7）全件対応
+
+### 次リリース予告
+
+- **v2.19.0**（予定）: Breaking changes 警告 + バージョン checkpoint。
+  `c3 update` 実行時に前回バージョンとの diff から breaking changes 一覧を表示する。
+
+### 影響
+
+- **既存利用先**: `c3 update` 実行時に過去廃止 16 ファイルの削除候補が表示される。
+  デフォルトは確認プロンプト（`N`）のため、誤削除事故は発生しない。
+- **CI / 自動化環境**: `--yes` フラグを明示しない限り従来通り（プロンプトで止まる）。
+- **既存テスト**: 944 → 979 PASS（純増 35 件）、API 互換性完全維持。
+
+---
+
 ## v2.17.0 (2026-05-24)
 
 **基盤整備リリース第 1 弾**: 設定階層と配布判断ルールを canonical 化する。

{claude_code_conductor-2.17.0 → claude_code_conductor-2.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.17.0
+Version: 2.18.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

{claude_code_conductor-2.17.0 → claude_code_conductor-2.18.0}/hatch_build.py

@@ -68,6 +68,7 @@ KEEP_PATTERNS: tuple[str, ...] = (
     "memory/archive/.gitkeep",
     "tmp/.gitkeep",
     "state/.gitkeep",
+    "deletions.txt",  # 新規: c3 update が読む削除指示書
 )
 
 

{claude_code_conductor-2.17.0 → claude_code_conductor-2.18.0}/src/c3/__init__.py

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

{claude_code_conductor-2.17.0 → claude_code_conductor-2.18.0}/src/c3/_excludes.py

@@ -65,6 +65,7 @@ KEEP_PATTERNS: tuple[str, ...] = (
     "memory/archive/.gitkeep",
     "tmp/.gitkeep",
     "state/.gitkeep",
+    "deletions.txt",  # 新規: c3 update が読む削除指示書
 )