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

claude_code_conductor-2.19.0/.claude/breaking-changes.txt

@@ -0,0 +1,7 @@
+# C3 breaking changes log
+# Format: vX.Y.Z|<English summary>|<Japanese summary>
+# Note: extra '|' characters in the Japanese field are allowed (parser uses maxsplit=2).
+# Note: English field must not contain '|' (validated by scripts/extract_breaking_changes.py).
+# Lines starting with '#' are comments. Blank lines ignored.
+
+v2.11.0|summarize-memory agent + skill removed; replaced by `c3 recall`|summarize-memory エージェント / skill を完全廃止。代替は `c3 recall` の意味検索。

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

@@ -64,8 +64,8 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 2. `.claude/settings.json` — プロジェクト共通設定（git 管理）
 3. `~/.claude/settings.json` — グローバル個人設定（マシンローカル）
 
-> **重要**: `hooks` セクションのみ「マージしない・完全上書き」挙動。
-> `settings.local.json` に `hooks` を書くと `settings.json` の `hooks` が **すべて無効化** される。
+> **補足**: `hooks` は両ファイルの内容がマージされる（本配布元リポで `settings.json` の lifecycle hooks と `settings.local.json` の `.dev/hooks/*` が並走している実機事実）。
+> ただし Claude Code 公式 docs では hooks のマージ挙動が明記されていないため、チーム全体で必要な hook は `settings.json` 側に集約するのが安全。
 > 詳細は §7「既知の落とし穴」を参照。
 > キー仕様の詳細は `.claude/docs/settings.json.md` を参照。
 
@@ -84,7 +84,7 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 ### レイヤー C: LLM 指示・知識（CLAUDE.md / rules）
 
 - `.claude/CLAUDE.md` — 常時注入されるプロジェクト指示
-- `.claude/rules/*.md` — `paths:` フロントマターがあればパスマッチ時のみ、なければ常時注入
+- `.claude/rules/*.md` — 常時全文注入（`paths:` フロントマターは「適用範囲のドキュメント」であり、注入タイミングは変わらない）
 - `.claude/rules/promoted/index.md` — `@rules/promoted/index.md` で CLAUDE.md から include される
   （`/promote-pattern` skill が追記する **ユーザー所有領域**）
 
@@ -104,7 +104,7 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 
 ---
 
-## 3. 配布判断マトリクス（13 カテゴリ）
+## 3. 配布判断マトリクス（14 カテゴリ）
 
 `_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` を実装照合した結果。
 各カテゴリに配布有無・c3 update の更新有無・理由を明示する。
@@ -121,9 +121,10 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 | 8 | `.claude/settings.json` | ○ | ○ | プロジェクト共通設定（hooks 登録・permissions など） |
 | 9 | `.claude/permission_rules.json` | ○ | ○ | C3 独自の自動承認パターン（PermissionRequest hook が参照） |
 | 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` で配布。データ本体は除外 |
+| 11 | `.claude/reports/*` / `memory/*` / `agent-memory/*` / `state/*` / `tmp/*` / `worktrees/*` / `logs/*` | × （`.gitkeep` のみ ○） | — | 実行時生成領域。空ディレクトリのみ `KEEP_PATTERNS` の `.gitkeep` で配布。データ本体は除外。v2.19.0 で `.claude/state/c3_version.txt`（バージョン checkpoint）を追加（`state/*` 一括除外により自動非配布） |
 | 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 参照） |
+| 14 | `.claude/breaking-changes.txt` | ○ | ○ | `c3 update` が読み込み、利用先の `.claude/state/c3_version.txt`（バージョン checkpoint）と diff を計算して破壊的変更を表示する。MAJOR bump 時は y/N 承認プロンプトを発火。`KEEP_PATTERNS` で明示配布。配布元 `.claude/breaking-changes.txt` を更新すれば次回 pip install → `c3 update` で利用先に伝播。利用先 git 管理は tracked（上書きされる） |
 
 > **注意 (カテゴリ #6)**: `taxonomy.md` は `_excludes.py` の EXCLUDE 対象だが、`.gitignore` では tracked 状態（GitHub に公開済み）。
 > **wheel には含まれない**点に注意。gitignore と wheel 配布は別レイヤーであり、
@@ -152,13 +153,13 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 `settings.local.json` は `c3 init` も `c3 update` も作成・上書きしない。
 個人設定を安全に保ちつつ、C3 のアップデートを受け取れる設計。
 
-### 原則 3: `hooks` セクションは書かない
+### 原則 3: `hooks` は「個人専用・配布元専用」のみに留める
 
-**最重要の落とし穴**。`settings.local.json` に `hooks` セクションを追記すると、
-`settings.json` の `hooks` エントリが **すべて無効化** される（マージではなく完全上書き）。
+`settings.local.json` の `hooks` は `settings.json` の `hooks` とマージされる（本配布元リポで `.dev/hooks/*` を `settings.local.json` に登録して `.claude/hooks/*` と並走させている実例あり）。
 
-C3 の lifecycle hook（`permission_handler.py` 等）が動かなくなるため、
-`hooks` のカスタマイズは必ず `settings.json` 側に行う（チーム合意を経て）。
+ただし以下の理由から、`settings.local.json` には「個人 / 配布元専用 hook」のみを書く:
+- Claude Code 公式 docs では hooks のマージ挙動が明記されておらず、将来仕様が変わるリスクがある
+- チーム全体で必要な hook は `settings.json` 側に置いてチーム合意を経るべき
 
 詳細は §7「既知の落とし穴」の項目 1 を参照。
 
@@ -204,6 +205,8 @@ C3 の wheel 配布除外パターンは **3 つのファイルに分散して
 | `src/c3/_excludes.py` | `c3 init` / `c3 update` 時の除外判断（Python 実装） | 配布先への配布/非配布を変更する時 |
 | `hatch_build.py` | wheel ビルド時の除外判断（`_excludes.py` の重複定義） | `_excludes.py` を変更した時（必ず同期） |
 
+**`breaking-changes.txt` の同期義務（v2.19.0 追加）**: 新たな破壊的変更をリリースする際は、必ず `_excludes.py` / `hatch_build.py` の `KEEP_PATTERNS` に `"breaking-changes.txt"` が含まれていることを確認した上で、配布元 `.claude/breaking-changes.txt` にエントリを追記する。`scripts/extract_breaking_changes.py --check` で CHANGELOG との整合性を確認し、未記載があれば追記してから wheel を再ビルドする（詳細は配布元 `/CLAUDE.md` §6 参照）。
+
 `hatch_build.py` の重複が必要な理由: hatch build hook はパッケージ import 前に走るため、
 `_excludes.py` を import できない。2 ファイルの完全一致が必須。
 
@@ -234,17 +237,13 @@ C3 の wheel 配布除外パターンは **3 つのファイルに分散して
 
 **ここを読まないと事故る**ポイントを集約。症状が出たらまず確認すること。
 
-### 落とし穴 1: `hooks` セクションが `settings.local.json` で完全上書きされる
-
-**症状**: `permission_handler.py` 等の C3 hook が突然動かなくなる。
+### 落とし穴 1: `hooks` のマージ挙動は公式 docs 未明記
 
-**原因**: Claude Code の `settings.json` 系では、`hooks` セクションのみマージではなく
-**完全上書き**の挙動を取る（`permissions.allow` 等他のキーはマージ）。
-`settings.local.json` に `hooks: []` や任意の hook 定義を書くと、
-`settings.json` の `hooks` エントリが全て無効化される。
+**現状**: 実機では `settings.local.json` の `hooks` と `settings.json` の `hooks` はマージされる（本配布元リポの `.dev/hooks/*` 登録が実例）。
+ただし Claude Code 公式 docs では hooks のマージ挙動が明記されていないため、将来の Claude Code バージョンで挙動が変わるリスクがある。
 
-**対処**: `settings.local.json` の `hooks` セクションを削除し、`settings.json` 側に移す。
-カスタム hook を追加したい場合はチームで `settings.json` を編集する（git 管理）。
+**対処**: チーム全体で必要な hook は `settings.json` 側に置く（git 管理 / チーム合意）。`settings.local.json` には個人 / 配布元専用 hook のみを書く（本リポでは `.dev/hooks/*` 配下のみ）。
+万が一 lifecycle hook が動かなくなった場合は、`settings.local.json` を一時退避して `settings.json` 単独で動作するか切り分ける。
 
 ### 落とし穴 2: `taxonomy.md` は tracked だが wheel 配布されない
 

{claude_code_conductor-2.18.0 → claude_code_conductor-2.19.0}/.claude/docs/settings.json.md

@@ -4,7 +4,8 @@ Claude Code の設定ファイル。プロジェクトルートの `.claude/sett
 ユーザーローカルの上書きは `.claude/settings.local.json`（`.gitignore` 推奨）。
 
 > 設定の優先順位: `settings.local.json` > `settings.json` > グローバル設定（`~/.claude/settings.json`）
-> ただし `hooks` セクションは `settings.local.json` が `settings.json` を**完全に上書き**する（マージしない）。
+> `hooks` セクションは両ファイルの内容がマージされる（本配布元リポで `.dev/hooks/*` を `settings.local.json` に登録して `.claude/hooks/*` と並走させている実機事実）。
+> ただし Claude Code 公式 docs では hooks のマージ挙動が明記されていないため、チーム全体で必要な hook は `settings.json` 側に集約するのが安全。
 
 ---
 
@@ -508,4 +509,4 @@ MCP（Model Context Protocol）サーバーを登録する。登録されたサ
 | `.claude/settings.json` | プロジェクト共通設定。git 管理する |
 | `.claude/settings.local.json` | 開発者個人の設定（追加 `allow` 等）。`.gitignore` に追加して git 管理しない |
 
-> `hooks` を `settings.local.json` に書くと `settings.json` の `hooks` が**完全に無効化**される。フックは `settings.json` のみに書くこと。
+> `hooks` は `settings.local.json` と `settings.json` の内容がマージされる（実機検証済み）。ただし Claude Code 公式 docs ではこの挙動が明記されていないため、チーム全体で必要なフックは `settings.json` 側に集約する。`settings.local.json` は個人・配布元専用フック（例: 本リポの `.dev/hooks/*`）に留める。

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

@@ -1,5 +1,79 @@
 # Changelog
 
+## [2.19.0] - 2026-05-24
+
+**基盤整備リリース第 3 弾**: `c3 update` 実行時に breaking changes 表示 + MAJOR 承認プロンプトを導入する。
+v2.11.0 の `summarize-memory` 廃止のように利用先設定の手動修正が必要なケースで、
+利用者が破壊的変更を見逃すリスクを構造的に防ぐ。
+
+### 機能追加
+
+- **`c3 update` 実行時の breaking changes 表示 + MAJOR 承認プロンプト**:
+  利用先 `.claude/state/c3_version.txt`（バージョン checkpoint）と配布元バージョン
+  (`c3.__version__`) を比較し、その区間にある breaking changes を
+  `.claude/breaking-changes.txt` から抽出して表示する。
+  - **initial（初回）**: 全件表示。プロンプト非発火。
+  - **minor / patch**: 区間内 breaking changes を表示。プロンプト非発火。
+  - **MAJOR**: 区間内 breaking changes を表示後、`Proceed with major version update? [y/N]:` プロンプトを発火。
+    N または非対話環境（EOF）で `exit 0`（add/update / deletions / checkpoint 更新のいずれも実行されない）。
+  - **downgrade**: stderr に 1 行 warning のみ。checkpoint 不変。プロンプト非発火。
+  - `--yes` フラグで MAJOR プロンプトをスキップ可（CI / 自動化用）。
+  - `--dry-run` では MAJOR プロンプト非発火（`(dry-run: confirmation would be required)` 表示）。
+  - `--platform codex` 等 claude 以外単独実行時は発火しない。
+
+- **`.claude/breaking-changes.txt`（新規）**: breaking changes ログファイル。
+  フォーマット: `vX.Y.Z|<English summary>|<Japanese summary>` の pipe 区切り 1 行 1 エントリ。
+  v2.11.0（`summarize-memory` 廃止）を初期エントリとして同梱。
+  `KEEP_PATTERNS` で明示配布。`c3 update` で利用先に伝播。
+
+- **`.claude/state/c3_version.txt`（新規、利用先生成）**: バージョン checkpoint ファイル。
+  `c3 update` の claude block 成功時（non-dry-run / non-downgrade）に自動更新。
+  `state/*` 一括除外により配布対象外（利用先で生成、git 管理は推奨しない）。
+
+- **`scripts/extract_breaking_changes.py`（新規）**: CHANGELOG.md の `### 破壊的変更` セクションを抽出し、
+  `.claude/breaking-changes.txt` に未記載のエントリを追記するリリースワークフロースクリプト。
+  - `--check`: 未記載があれば `exit 1` + stderr に未記載 version 列挙（CI 用）
+  - `--dry-run`: 候補表示のみ、書き込まない
+  - 対話モード: en サマリ必須入力（空入力はエラー）
+  - atomic write (tmp + `os.replace`) で安全に追記
+
+- **`KEEP_PATTERNS` への `breaking-changes.txt` 追加**: `src/c3/_excludes.py` / `hatch_build.py` の
+  `KEEP_PATTERNS` に `"breaking-changes.txt"` を追加（3 ファイル同期ルール準拠）。
+
+### 変更
+
+- **`src/c3/__init__.py`**: `__version__` を `"2.18.0"` から `"2.19.0"` に更新。
+
+### ドキュメント
+
+- **`.claude/docs/config-policy.md`**:
+  - §3 配布判断マトリクス 13 → 14 カテゴリ（`breaking-changes.txt` 追加）
+  - §11（`state/*`）に「v2.19.0 で `c3_version.txt` を追加」と注記
+  - §6 3 ファイル同期ルールに `breaking-changes.txt` のメンテ責任を追記
+- **`/CLAUDE.md`**（配布元 gitignored）:
+  - §6「リリース前 breaking changes チェック」を新規追加
+  - `scripts/extract_breaking_changes.py --check` 手順 / wheel 検証コマンドを含む
+
+### ドキュメント訂正（v2.17.0 / v2.18.0 で配布した記述の誤りを訂正）
+
+- **`hooks` のマージ挙動**: v2.17.0 / v2.18.0 で配布した `.claude/docs/config-policy.md` §2 / §4 / §7 と
+  `.claude/docs/settings.json.md` 冒頭・末尾の「`settings.local.json` の hooks が `settings.json` の
+  hooks を完全上書きする」記述は **誤り**。実機検証で両ファイルの hooks は **マージされる** ことを確認
+  （本配布元リポでも `settings.json` の lifecycle hooks と `settings.local.json` の `.dev/hooks/*` が並走）。
+  Claude Code 公式 docs では hooks のマージ挙動が明記されていないため、チーム全体で必要な hook は
+  `settings.json` 側に集約するのが安全、という方針に変更。
+- **`.claude/rules/*.md` の注入挙動**: v2.17.0 で配布した `.claude/docs/config-policy.md` §2 の
+  「`paths:` フロントマターがあればパスマッチ時のみ、なければ常時注入」記述は誤り。実機では `rules/*.md`
+  は常時全文注入され、`paths:` は「適用範囲のドキュメント」であって注入タイミングは変わらない。
+
+### 影響
+
+- **既存利用先**: `c3 update` 実行時に「初回 checkpoint 作成」ヘッダ + v2.11.0 の breaking change が表示される。
+  MAJOR バンプ確認プロンプトは発火しない（v2.11.0 → v2.19.0 は minor bump）。
+  `.claude/state/c3_version.txt` が自動生成されるが、`state/*` は gitignore 推奨。
+
+---
+
 ## v2.18.0 (2026-05-24)
 
 **基盤整備リリース第 2 弾**: `c3 update` の削除検出を `deletions.txt` 方式で導入する。

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.18.0
+Version: 2.19.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.18.0 → claude_code_conductor-2.19.0}/hatch_build.py

@@ -69,6 +69,7 @@ KEEP_PATTERNS: tuple[str, ...] = (
     "tmp/.gitkeep",
     "state/.gitkeep",
     "deletions.txt",  # 新規: c3 update が読む削除指示書
+    "breaking-changes.txt",  # v2.19.0: c3 update が読む破壊的変更ログ
 )
 
 

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

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

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

@@ -66,6 +66,7 @@ KEEP_PATTERNS: tuple[str, ...] = (
     "tmp/.gitkeep",
     "state/.gitkeep",
     "deletions.txt",  # 新規: c3 update が読む削除指示書
+    "breaking-changes.txt",  # v2.19.0: c3 update が読む破壊的変更ログ
 )