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

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

@@ -0,0 +1,8 @@
+# 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` の意味検索。
+v2.20.0|hooks/schema.sql removed; SQLite schema is now managed by c3/migrations/ (auto-applied at session_start)|hooks/schema.sql を削除しました。SQLite スキーマは c3/migrations/ (wheel 内) で管理され session_start で自動適用されます。

{claude_code_conductor-2.18.0 → claude_code_conductor-2.20.0}/.claude/deletions.txt

@@ -37,3 +37,6 @@ skills/phase-c-plan/SKILL.md
 skills/phase-d-implement/SKILL.md
 skills/phase-debug/SKILL.md
 skills/phase-e-review/SKILL.md
+
+# ---- v2.20.0: schema.sql を c3/migrations/ へ移行 ----
+hooks/schema.sql

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

@@ -24,6 +24,7 @@
 .dev/hooks/                            配布元専用 hook（配布されない）
 src/c3/_excludes.py                    wheel 除外パターン（配布元のビルド制御）
 hatch_build.py                         _excludes.py の重複定義（ビルド時専用）
+src/c3/migrations/                     SQLite schema migration SQL ファイル群（Python package・wheel 同梱・.claude/ 配下ではないため 3 ファイル同期対象外）
 ```
 
 ### 1-2. 利用先プロジェクト（C3 ユーザー向け）
@@ -64,8 +65,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 +85,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,14 +105,14 @@ hatch_build.py                         _excludes.py の重複定義（ビルド
 
 ---
 
-## 3. 配布判断マトリクス（13 カテゴリ）
+## 3. 配布判断マトリクス（14 カテゴリ）
 
 `_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` を実装照合した結果。
 各カテゴリに配布有無・c3 update の更新有無・理由を明示する。
 
 | # | カテゴリ | 配布 | c3 update が更新 | 理由 |
 |---|---|---|---|---|
-| 1 | `.claude/hooks/*.py` | ○ | ○ | Claude Code lifecycle hook の実体。配布先で動作する。例外: `subagent_log.py` のみ除外（個人デバッグ用） |
+| 1 | `.claude/hooks/*.py` | ○ | ○ | Claude Code lifecycle hook の実体。配布先で動作する。例外: `subagent_log.py` のみ除外（個人デバッグ用）。v2.20.0 で `hooks/schema.sql` を削除し SQLite スキーマは `src/c3/migrations/` に移管 |
 | 2 | `.claude/agents/*.md` | ○ | ○ | ペルソナ定義。配布先で読まれる。例外: `tdd-develop.md` のみ除外（v2.1.0 廃止） |
 | 3 | `.claude/skills/*/` | ○ | ○ | オーケストレーション/ユーティリティ skill 定義（`scripts/` / `templates/` 等サブディレクトリ含む）。例外: `worktree-tdd-workflow/*` のみ除外（v2.1.0 廃止） |
 | 4 | `.claude/rules/*.md` | ○ | ○ | C3 配布デフォルトルール（常時注入対象） |
@@ -121,9 +122,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 +154,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 +206,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 +238,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.20.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.20.0}/.claude/hooks/session_start.py

@@ -12,22 +12,23 @@
 設計判断:
 - 旧 3 ファイルを統合することで SessionStart hook は本ファイル 1 本のみで完結
 - init-session SKILL.md からの手動 2 回呼び出しが不要になる
-- 旧 init_c3_db.py の `apply_schema()` / `SCHEMA_VERSION` は test 互換性のため
-  module レベルでそのまま公開する
+- v2.20.0 で apply_schema() を c3.migrate.apply_pending_migrations() に委譲。
+  SCHEMA_VERSION / SCHEMA_PATH 定数および schema.sql は廃止。
 """
 
 from __future__ import annotations
 
 import json
+import logging
 import os
 import shutil
-import sqlite3
 import sys
 import tempfile
-from datetime import datetime, timezone
 
 from session_utils import is_worktree
 
+logger = logging.getLogger(__name__)
+
 try:
     sys.stdin.reconfigure(encoding="utf-8")
     sys.stdout.reconfigure(encoding="utf-8")
@@ -71,7 +72,11 @@ def _run_clear_file_history() -> None:
         except FileNotFoundError:
             pass  # already deleted by another process between listdir and unlink/rmtree
         except Exception as e:
-            print(f'[clear-file-history] 削除に失敗: {name} ({e})', file=sys.stderr)
+            # [SR-R-001] shutil.rmtree / os.unlink のエラーメッセージには失敗したパス
+            # （FILE_HISTORY_DIR はホームディレクトリ配下のためユーザー名を含む）が
+            # 含まれる可能性がある。main() の SR M-1 修正と一貫して例外型名のみ出力する。
+            logger.debug('[clear-file-history] delete failed: %s', name, exc_info=True)
+            print(f'[clear-file-history] 削除に失敗: {name} ({type(e).__name__})', file=sys.stderr)
 
     print(f'[clear-file-history] {deleted} 件削除しました。')
 
@@ -113,7 +118,9 @@ def _run_enable_sandbox() -> None:
         try:
             settings = json.load(f)
         except json.JSONDecodeError as e:
-            print(f'[enable-sandbox] settings.json の JSON 解析に失敗しました: {e}')
+            # [SR-R-001] 一貫性のため例外型名のみ出力（JSONDecodeError 自体はパスを含まない
+            # が、SR M-1 / _run_clear_file_history と方針を統一する）。
+            print(f'[enable-sandbox] settings.json の JSON 解析に失敗しました: {type(e).__name__}')
             return
 
     if settings.get('sandbox', {}).get('enabled') is True:
@@ -132,7 +139,14 @@ def _run_enable_sandbox() -> None:
                 json.dump(settings, tmp_f, ensure_ascii=False, indent=2)
                 tmp_f.write('\n')
         except Exception:
-            os.close(fd)
+            # [CR-E-001] os.fdopen 成功後の書き込み例外では with __exit__ が既に
+            # fd を閉じているため、ここでの os.close(fd) は OSError(Bad file
+            # descriptor) を raise し元の例外を上書きしてしまう。os.fdopen 自体が
+            # 失敗して with に入らなかった場合のみ fd 解放が必要なので OSError を無視する。
+            try:
+                os.close(fd)
+            except OSError:
+                pass
             raise
         os.replace(tmp_path, settings_path)
         tmp_path = None  # os.replace が成功したので finally でのクリーンアップ不要
@@ -147,19 +161,10 @@ def _run_enable_sandbox() -> None:
 # 3. C3 SQLite DB 初期化（旧 init_c3_db.py）
 # =============================================================================
 
-# 現行スキーマバージョン。schema.sql に破壊的変更を入れたら +1 して
-# マイグレーションロジックを apply_schema() に追加する。
-SCHEMA_VERSION = 3  # v2.0.0 で PO 廃止に伴い po_results / po_status を削除
-
 _HOOKS_DIR = os.path.dirname(os.path.abspath(__file__))
 _CLAUDE_DIR = os.path.dirname(_HOOKS_DIR)
 STATE_DIR = os.path.join(_CLAUDE_DIR, 'state')
 DB_PATH = os.path.join(STATE_DIR, 'c3.db')
-SCHEMA_PATH = os.path.join(_HOOKS_DIR, 'schema.sql')
-
-
-def _now_iso() -> str:
-    return datetime.now(timezone.utc).astimezone().isoformat(timespec='seconds')
 
 
 def _ensure_state_dir() -> None:
@@ -167,38 +172,36 @@ def _ensure_state_dir() -> None:
     os.makedirs(STATE_DIR, exist_ok=True)
 
 
-def apply_schema(db_path: str = DB_PATH, schema_path: str = SCHEMA_PATH) -> None:
-    """schema_path の DDL を db_path の SQLite に適用する。
+def apply_schema(db_path: str = DB_PATH) -> list[str]:
+    """SQLite DB にスキーマ migration を適用する。
 
-    - WAL モードに切り替える
-    - schema.sql の CREATE TABLE IF NOT EXISTS 等を実行
-    - schema_version テーブルに現行バージョンを INSERT OR IGNORE
+    v2.20.0+: 実体は c3.migrate.apply_pending_migrations() に委譲。
+    schema.sql は廃止され、src/c3/migrations/ の連番 SQL ファイルで管理される。
 
-    冪等: 既存 DB に何度呼んでもエラーにならない。
+    戻り値: 今回新たに適用した migration version のリスト（例: ['001']）
     """
-    with open(schema_path, 'r', encoding='utf-8') as f:
-        ddl = f.read()
-
-    conn = sqlite3.connect(db_path, timeout=30)
+    from c3.migrate import apply_pending_migrations
     try:
-        # WAL モードを有効化（reader が writer をブロックしない）
-        conn.execute('PRAGMA journal_mode=WAL')
-        # 全 DDL を一括実行（CREATE TABLE IF NOT EXISTS なので冪等）
-        conn.executescript(ddl)
-        # スキーマバージョンを記録（既存なら無視）
-        conn.execute(
-            'INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)',
-            (SCHEMA_VERSION, _now_iso()),
+        return apply_pending_migrations(db_path)
+    except FileNotFoundError:
+        # migrations ディレクトリ不在（wheel が壊れている等）でもセッションは続行。
+        # [SR-R-001] 例外 e にはインストールパス（ユーザー名含む）が含まれるため
+        # stderr には固定文言のみ出力する。詳細は内部 logger（DEBUG）に残す。
+        logger.debug('apply_schema: migrations directory not found', exc_info=True)
+        print(
+            'warning: c3 migrations directory not found (wheel may be corrupted)',
+            file=sys.stderr,
         )
-        conn.commit()
-    finally:
-        conn.close()
+        return []
 
 
 def _run_init_c3_db() -> None:
     """C3 SQLite DB を初期化する."""
     _ensure_state_dir()
-    apply_schema()
+    # [CR-M-003] apply_schema() の戻り値（適用した migration version の list[str]）は
+    # 現状ログ・利用しない。セッション開始を妨げないことを最優先し、適用結果の通知は
+    # 行わない設計（将来 welcome メッセージ等で利用する場合はここで受ける）。
+    _ = apply_schema()
 
 
 # =============================================================================
@@ -222,7 +225,14 @@ def main() -> int:
             handler()
         except Exception as e:
             # 各ハンドラ失敗時は警告のみ（次のハンドラを継続）
-            print(f'[session_start:{label}] failed: {e}', file=sys.stderr)
+            # [SR-R-001] 例外メッセージには db_path 等のプロジェクトパスが含まれる
+            # 可能性がある（例: sqlite3.OperationalError）。stderr には例外型名のみ
+            # 出力し、詳細は内部 logger（DEBUG）に残す。
+            # NOTE(SR Info-2): exc_info=True は現状ハンドラ未設定で出力されないが、
+            # 将来 logging ハンドラを追加する場合はスタックトレースにインストールパスが
+            # 含まれる点に留意する。
+            logger.debug('[session_start:%s] handler failed', label, exc_info=True)
+            print(f'[session_start:{label}] failed: {type(e).__name__}', file=sys.stderr)
     return 0
 
 

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

@@ -1,5 +1,143 @@
 # Changelog
 
+## [2.20.0] - 2026-05-25
+
+**SQLite schema migration 枠組み導入**: `.claude/hooks/schema.sql` の「冪等 DDL 一発実行」から、`src/c3/migrations/` の「連番 NNN_xxx.sql migration runner」へ移行する基盤を整備する。
+v2.18.0 の `deletions.txt` 機構・v2.19.0 の `breaking-changes.txt` 機構の初の実運用ドッグフーディングでもある。
+
+### 機能追加
+
+- **`src/c3/migrate.py`（新規）**: SQLite migration runner。
+  公開 API `apply_pending_migrations(db_path, migrations_dir=None) -> list[str]` および例外クラス `MigrationError(RuntimeError)` を提供。
+  `src/c3/migrations/` 配下の連番 SQL ファイルを昇順に適用し、適用済み migration を `schema_migrations` テーブルで管理する。
+  WAL モード / busy_timeout=5000ms を冒頭で設定（既存 `c3.db.BUSY_TIMEOUT_MS` を SSOT として参照）。
+
+- **`src/c3/migrations/001_initial.sql`（新規）**: 既存 `hooks/schema.sql` の DDL を逐語移植 + bootstrap。
+  `schema_migrations` テーブル新設、旧 `schema_version` テーブル DROP、`BEGIN;` / `COMMIT;` 明示記述による transaction 境界保証を含む。
+
+- **`src/c3/migrations/__init__.py`（新規）**: Python package marker（wheel 自動同梱のため）。
+
+- **`src/c3/migrations/README.md`（新規）**: 命名規約（`NNN_xxx.sql`）・`BEGIN;`/`COMMIT;` 必須運用ルール・002 以降の追加手順を記載。
+
+- **`schema_migrations` テーブル（新規）**: 適用済み migration の一覧を保持（`version TEXT PK`, `applied_at TIMESTAMP`）。
+  旧 `schema_version (version INTEGER PK, applied_at TEXT)` を置換。
+
+### 変更
+
+- **`.claude/hooks/session_start.py`**: `apply_schema(db_path)` の実体を `c3.migrate.apply_pending_migrations()` に委譲。
+  戻り値が `None` → `list[str]`（適用した migration version のリスト）に変更。
+  migrations_dir 不在時は `FileNotFoundError` を warning として stderr に出力し、セッションは続行する（exit 0 維持の既存方針踏襲）。
+
+- **`src/c3/__init__.py`**: `__version__` を `"2.19.0"` から `"2.20.0"` に更新。
+
+### 破壊的変更
+
+- **`hooks/schema.sql` 削除**: `.claude/hooks/schema.sql` をリポジトリから削除。
+  SQLite スキーマは `src/c3/migrations/` (wheel 内) で管理され、`session_start` で自動適用される。
+  利用先からの削除は `deletions.txt` 機構（v2.18.0）によって `c3 update` 実行時に処理される。
+
+- **`apply_schema` の `schema_path` 引数削除**: `session_start.py::apply_schema()` から `schema_path` 引数を完全削除（deprecation 期間なし）。
+  呼び出し側で `schema_path=` を渡している場合は削除が必要（`c3 update` 実行後のテストコード等）。
+
+### ドキュメント
+
+- **`.claude/docs/config-policy.md`**:
+  - §1-1 配布元ディレクトリ表に `src/c3/migrations/` を追加（Python package・wheel 同梱・3 ファイル同期対象外）
+  - §3 カテゴリ #1 hooks 備考に「v2.20.0 で `hooks/schema.sql` を削除、SQLite スキーマは `src/c3/migrations/` に移管」を追記
+
+- **`.claude/breaking-changes.txt`**: v2.20.0 エントリ追記（`hooks/schema.sql` 削除）
+
+- **`.claude/deletions.txt`**: `hooks/schema.sql` 追記（利用先からの自動削除を `c3 update` 経由で実現）
+
+### ドッグフーディング
+
+- **v2.18.0 `deletions.txt` 機構**: `hooks/` 配下の非テスト SQL ファイル削除の初の実運用事例（過去は `agents/` / `skills/` の `.md` のみ）。
+- **v2.19.0 `breaking-changes.txt` 機構**: v2.20.0 エントリを新規追加して MINOR bump 表示路を初通過させる。
+- **`scripts/extract_breaking_changes.py`**: `--dry-run` / 通常実行 / `--check` のフルライフサイクル運用。
+
+### 影響
+
+- **既存利用先**: `c3 update` 実行時に v2.20.0 breaking change が表示される（v2.19.0 以降の利用先）。
+  `.claude/hooks/schema.sql` は `c3 update` 実行時に自動削除される。
+  次回セッション開始時に `apply_pending_migrations` が `schema_migrations` テーブルを新設し 001 を適用する。
+  既存データ（`review_decisions` 等）は保持される。`schema_version` テーブルは削除される。
+
+---
+
+## [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.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.18.0
+Version: 2.20.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.20.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.20.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.20.0"

{claude_code_conductor-2.18.0 → claude_code_conductor-2.20.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 が読む破壊的変更ログ
 )