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

{claude_code_conductor-2.15.2 → claude_code_conductor-2.17.0}/.claude/CLAUDE.md

@@ -49,6 +49,7 @@
 
 `.claude/docs/` は人間向けリファレンスのためエージェントは読まなくてよい。
 詳細は `.claude/docs/taxonomy.md` を参照。
+設定の優先順位・配布判断は `.claude/docs/config-policy.md` を参照。
 
 ## Platform Compatibility
 

claude_code_conductor-2.17.0/.claude/docs/config-policy.md

@@ -0,0 +1,308 @@
+# C3 Config Policy — 設定階層・配布判断の公式リファレンス
+
+**バージョン**: v2.17.0
+**対象読者**: C3 利用先ユーザー / C3 自体をフォーク・拡張する開発者
+**canonical 宣言**: 設定優先順位・配布判断に関しては本ドキュメントが唯一の公式情報源。
+他ファイル（`CLAUDE.md` / `_excludes.py` docstring）から本ドキュメントへの参照リンクが張られている場合、
+詳細は常に本ドキュメントを参照すること。
+
+---
+
+## 1. 設定ファイル一覧（所在マップ）
+
+### 1-1. 配布元リポジトリ（C3 開発者向け）
+
+```
+/CLAUDE.md                             配布元専用（.gitignore で除外）
+.claude/CLAUDE.md                      配布元・配布先共通（常時注入）
+.claude/settings.json                  プロジェクト共通設定（配布される）
+.claude/settings.local.json            個人 override（配布されない）
+.claude/permission_rules.json          C3 独自の自動承認パターン（配布される）
+.claude/rules/                         C3 配布デフォルトルール（配布される）
+.claude/rules/promoted/                プロジェクト固有昇格ルール（配布される、update は触らない）
+.claude/hooks/                         Claude Code lifecycle hooks（配布される）
+.dev/hooks/                            配布元専用 hook（配布されない）
+src/c3/_excludes.py                    wheel 除外パターン（配布元のビルド制御）
+hatch_build.py                         _excludes.py の重複定義（ビルド時専用）
+```
+
+### 1-2. 利用先プロジェクト（C3 ユーザー向け）
+
+```
+.claude/CLAUDE.md                      c3 init で配置・c3 update で更新
+.claude/settings.json                  c3 init で配置・c3 update で更新
+.claude/settings.local.json            ユーザーが個別作成（c3 は触らない）
+.claude/permission_rules.json          c3 init で配置・c3 update で更新
+.claude/rules/                         c3 init で配置・c3 update で更新
+.claude/rules/promoted/index.md        c3 init で空雛形のみ配置（c3 update は触らない）
+.claude/hooks/                         c3 init で配置・c3 update で更新
+.claude/state/                         実行時生成（gitignore 推奨）
+.claude/memory/                        実行時生成
+.claude/agent-memory/                  実行時生成
+.claude/reports/                       実行時生成（gitignore 推奨）
+.claude/worktrees/                     並列実行時一時生成
+.claude/logs/                          実行時生成
+```
+
+### 1-3. ディレクトリの命名・配置チート
+
+各ディレクトリの **命名・役割・配置判断** は `.claude/docs/taxonomy.md` を参照。
+本ドキュメントは配布判断・優先順位に特化しており、taxonomy と住み分けている。
+
+---
+
+## 2. 設定優先順位と書き込み権限
+
+設定は性質の異なる **3 つのレイヤー** に分かれる。1 列に並べると誤解を生むため分離して記述する。
+
+### レイヤー A: ツール権限（Claude Code 公式）
+
+同じキー（`permissions.allow` など）が複数ファイルで定義されている場合、
+**上位ファイルが下位ファイルを上書き**する（高 → 低の順）:
+
+1. `.claude/settings.local.json` — 個人 override（`.gitignore` 推奨。c3 update の対象外）
+2. `.claude/settings.json` — プロジェクト共通設定（git 管理）
+3. `~/.claude/settings.json` — グローバル個人設定（マシンローカル）
+
+> **重要**: `hooks` セクションのみ「マージしない・完全上書き」挙動。
+> `settings.local.json` に `hooks` を書くと `settings.json` の `hooks` が **すべて無効化** される。
+> 詳細は §7「既知の落とし穴」を参照。
+> キー仕様の詳細は `.claude/docs/settings.json.md` を参照。
+
+### レイヤー B: 自動承認パターン（C3 独自拡張）
+
+- `.claude/permission_rules.json` の `auto_allow` 配列
+- `permission_handler.py`（`PermissionRequest` hook）が読み込んで、パターンにマッチすれば自動承認
+- レイヤー A で `deny` 判定されたものを覆すことはできない（hook の決定権の範囲内）
+- `notify_on_auto: false` で通知を抑止できる
+
+> **注意**: `permission_rules.json` は Claude Code 公式の `permissions.allow` とは **独立した別レイヤー**。
+> 同列に並べると「どちらが優先されるか」で誤解が生じる。レイヤー A と B は並立している。
+
+> **注意**: `auto_allow` パターンは最小限に留めること。広範なパターン（例: `Bash(*)`）は C3 の意図する動作範囲を超えた危険コマンドも自動承認する可能性がある。
+
+### レイヤー C: LLM 指示・知識（CLAUDE.md / rules）
+
+- `.claude/CLAUDE.md` — 常時注入されるプロジェクト指示
+- `.claude/rules/*.md` — `paths:` フロントマターがあればパスマッチ時のみ、なければ常時注入
+- `.claude/rules/promoted/index.md` — `@rules/promoted/index.md` で CLAUDE.md から include される
+  （`/promote-pattern` skill が追記する **ユーザー所有領域**）
+
+「優先順位」という概念は厳密には適用されない（全文ロードされる）が、
+**`rules/promoted/` は c3 update が触らない**点が肝となる。
+
+### 書き込み権限マトリクス
+
+| ファイル | c3 init が初期配置 | c3 update が上書き | ユーザーが編集してよい |
+|---|---|---|---|
+| `.claude/settings.json` | ○ | ○ | △（チーム合意のもと） |
+| `.claude/settings.local.json` | × | × | ○（個人 override / 秘匿情報） |
+| `.claude/permission_rules.json` | ○ | ○ | △（ファイル全体を上書き編集する場合は注意） |
+| `.claude/CLAUDE.md` | ○ | ○ | △（c3 update で上書きされる前提で） |
+| `.claude/rules/*.md` | ○ | ○ | △（同上） |
+| `.claude/rules/promoted/index.md` | ○（空雛形のみ） | × | ○（`/promote-pattern` が追記、手動編集も可） |
+
+---
+
+## 3. 配布判断マトリクス（12 カテゴリ）
+
+`_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` を実装照合した結果。
+各カテゴリに配布有無・c3 update の更新有無・理由を明示する。
+
+| # | カテゴリ | 配布 | c3 update が更新 | 理由 |
+|---|---|---|---|---|
+| 1 | `.claude/hooks/*.py` | ○ | ○ | Claude Code lifecycle hook の実体。配布先で動作する。例外: `subagent_log.py` のみ除外（個人デバッグ用） |
+| 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 配布デフォルトルール（常時注入対象） |
+| 5 | `.claude/rules/promoted/*` | ○ | × | プロジェクト固有昇格ルール。配布元の `promoted/index.md` は空雛形のみ配布。利用先で `/promote-pattern` が追記する **ユーザー所有領域**。c3 update が触ると昇格内容が失われる |
+| 6 | `.claude/docs/*.md` | △（一部のみ） | ○ | 利用先向けリファレンス。配布対象は `platform-adapters.md` / `settings.json.md` / `parallel-agents-setup.md` / `config-policy.md`（本ドキュメント）の 4 ファイル。配布元固有の設計メモ等は `_excludes.py` で個別除外。`taxonomy.md` は tracked（GitHub 公開）だが EXCLUDE 対象のため wheel 非配布（詳細は §7 落とし穴 2 参照）。 |
+| 7 | `.claude/CLAUDE.md` | ○ | ○ | 配布先で常時注入される共通ルール |
+| 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` で配布。データ本体は除外 |
+| 12 | `.dev/*` / `/CLAUDE.md` / `/AGENTS.md` / `/.codex/` / `/.cursor/` / `/.agents/` | × | — | 配布元専用または adapter 生成物。wheel には構造的に含まれない（`src/c3/_template/.claude/` 配下のみ同梱）が、配布元 `.gitignore` で commit 混入も防ぐ |
+
+> **注意 (カテゴリ #6)**: `taxonomy.md` は `_excludes.py` の EXCLUDE 対象だが、`.gitignore` では tracked 状態（GitHub に公開済み）。
+> **wheel には含まれない**点に注意。gitignore と wheel 配布は別レイヤーであり、
+> 「tracked = 配布される」ではない。
+
+---
+
+## 4. settings.local.json 運用の原則
+
+`settings.local.json` は以下の **3 原則**で運用する:
+
+### 原則 1: 個人 override / 秘匿情報はここに書く
+
+- 個人の `permissions.allow` 追加（チーム全員には不要なもの）
+- API キー・個人トークン等の秘匿情報（`env` セクションに記述）
+- 個人的な `mcpServers` 設定
+
+`.gitignore` に含まれているため、通常の `git add` では staging されずリモートに上がらない（ただし `git status` で確認を推奨）。
+
+> **注意**: `git add -f` の強制オプションを使うと `.gitignore` が無効化されるため、秘匿情報が誤ってコミットされるリスクがある。CI/CD パイプラインでの自動 `add` 設定にも注意すること。
+
+> **注意**: `c3 init` はプロジェクトルートの `.gitignore` を自動編集しない。`settings.local.json` を新規作成する場合は、ユーザー自身が `.gitignore` に `.claude/settings.local.json` を追加すること。
+
+### 原則 2: c3 update は触らない
+
+`settings.local.json` は `c3 init` も `c3 update` も作成・上書きしない。
+個人設定を安全に保ちつつ、C3 のアップデートを受け取れる設計。
+
+### 原則 3: `hooks` セクションは書かない
+
+**最重要の落とし穴**。`settings.local.json` に `hooks` セクションを追記すると、
+`settings.json` の `hooks` エントリが **すべて無効化** される（マージではなく完全上書き）。
+
+C3 の lifecycle hook（`permission_handler.py` 等）が動かなくなるため、
+`hooks` のカスタマイズは必ず `settings.json` 側に行う（チーム合意を経て）。
+
+詳細は §7「既知の落とし穴」の項目 1 を参照。
+
+---
+
+## 5. プラットフォーム別 config 整合（canonical 宣言）
+
+### canonical は `.claude/` に置く
+
+C3 の設定・ルール・スキルの **唯一の公式ソース** は `.claude/` ディレクトリ。
+Codex / Cursor 向けの adapter 生成物は **派生生成物** であり、primary source ではない。
+
+| プラットフォーム | 設定参照経路 | 生成コマンド |
+|---|---|---|
+| Claude Code | `.claude/settings.json` / `.claude/CLAUDE.md` | — |
+| Codex | `.codex/` / `/AGENTS.md` | `c3 init --platform codex` |
+| Cursor | `.cursor/rules/c3-core.mdc` | `c3 init --platform cursor` |
+
+### adapter 生成物の位置付け
+
+- `.codex/` / `/AGENTS.md` / `/.cursor/` / `/.agents/` は **c3 init が生成する派生物**
+- これらを直接編集すると `c3 init --platform` の再実行で上書きされる
+- 配布元リポジトリでは `.gitignore` に含まれる（配布対象外）
+
+### 複数プラットフォームを切り替える場合
+
+同じプロジェクトで Claude Code / Codex / Cursor を切り替えて使う場合、
+設定の変更は必ず `.claude/` 側に行い、必要に応じて `c3 init --platform` で adapter を再生成する。
+
+詳細は `.claude/docs/platform-adapters.md` を参照。
+
+---
+
+## 6. 3 ファイル同期ルール
+
+### なぜ 3 ファイルが同期されなければならないか
+
+C3 の wheel 配布除外パターンは **3 つのファイルに分散して定義** されている:
+
+| ファイル | 役割 | 変更が必要な場面 |
+|---|---|---|
+| `.gitignore` | git 追跡から除外（配布元リポジトリの個人作業ファイルを管理外に） | 配布元で新たに除外すべきファイルが増えた時 |
+| `src/c3/_excludes.py` | `c3 init` / `c3 update` 時の除外判断（Python 実装） | 配布先への配布/非配布を変更する時 |
+| `hatch_build.py` | wheel ビルド時の除外判断（`_excludes.py` の重複定義） | `_excludes.py` を変更した時（必ず同期） |
+
+`hatch_build.py` の重複が必要な理由: hatch build hook はパッケージ import 前に走るため、
+`_excludes.py` を import できない。2 ファイルの完全一致が必須。
+
+### 同期確認の方法
+
+`.dev/hooks/_sync_check.py`（PostToolUse hook）が、3 ファイルのいずれかを変更した時に
+残り 2 ファイルの同期を `stderr` で警告する。警告が出たら必ず対応する。
+
+### 変更手順
+
+1. `.gitignore` / `_excludes.py` / `hatch_build.py` のいずれかを変更
+2. `_sync_check.py` の警告を確認
+3. 残り 2 ファイルに同じパターンを追加（または削除）
+4. `python -m build --wheel` で wheel を再生成して実体検証
+
+### 過去の同期漏れ defect
+
+| バージョン | 内容 | カテゴリ #（§3 参照） |
+|---|---|---|
+| v1.1.0 | `state/tier_selection.json` が wheel に混入した | #11 |
+| v2.14.1 | `worktrees/` 配下ファイルが wheel に混入した | #11 |
+
+いずれも `_excludes.py` / `hatch_build.py` の同期漏れが原因。
+
+---
+
+## 7. 既知の落とし穴
+
+**ここを読まないと事故る**ポイントを集約。症状が出たらまず確認すること。
+
+### 落とし穴 1: `hooks` セクションが `settings.local.json` で完全上書きされる
+
+**症状**: `permission_handler.py` 等の C3 hook が突然動かなくなる。
+
+**原因**: Claude Code の `settings.json` 系では、`hooks` セクションのみマージではなく
+**完全上書き**の挙動を取る（`permissions.allow` 等他のキーはマージ）。
+`settings.local.json` に `hooks: []` や任意の hook 定義を書くと、
+`settings.json` の `hooks` エントリが全て無効化される。
+
+**対処**: `settings.local.json` の `hooks` セクションを削除し、`settings.json` 側に移す。
+カスタム hook を追加したい場合はチームで `settings.json` を編集する（git 管理）。
+
+### 落とし穴 2: `taxonomy.md` は tracked だが wheel 配布されない
+
+**症状**: `_excludes.py` で除外されているはずの `taxonomy.md` が GitHub に公開されている、
+または「なぜ `.gitignore` に入っていないのか」と疑問に思う。
+
+**原因**: `taxonomy.md` は `.gitignore` では tracked（GitHub に公開済み）だが、
+`_excludes.py` の `EXCLUDE_PATTERNS` で除外されているため **wheel には含まれない**。
+「git tracked = 配布される」ではない。wheel 配布と git 追跡は独立したレイヤー。
+
+**対処**: 混乱した場合は §3 のカテゴリ #6 の注意書きを参照。
+`config-policy.md`（本ドキュメント）は wheel に含まれる設計になっている（`_excludes.py` に除外パターンなし）。
+
+### 落とし穴 3: `rules/promoted/` を `c3 update` が上書きしない
+
+**症状**: `c3 update` 後に `/promote-pattern` で追加したルールが消えている（実際には消えないが消えると思って不安）、
+または「なぜ promoted/ は更新されないのか」と疑問に思う。
+
+**原因**: `.claude/rules/promoted/index.md` は **ユーザー所有領域**。
+c3 update が上書きすると利用先で `/promote-pattern` が追記したルールが消失するため、意図的に除外している（§3 カテゴリ #5 参照）。
+
+**対処**: `promoted/` への変更は `c3 update` に委ねず、手動または `/promote-pattern` skill で管理する。
+C3 side で `promoted/` の雛形を更新した場合は、リリースノートで手動マージ手順を案内する。
+
+### 落とし穴 4: `permission_rules.json` は `settings.json.permissions.deny` を覆せない（要検証）
+
+**現状**: `permission_handler.py` の実装を読む限り、`PermissionRequest` hook は
+Claude Code 側で `deny` 判定が出た後に発火するため、`permission_rules.json` の `auto_allow` で
+`deny` を覆すことはできないはず。ただし Claude Code 公式仕様に明記なし。
+
+**残課題**: v2.18.0 以降の検証タスクとして記録。現時点では「覆せない前提で設計する」ことを推奨。
+
+---
+
+## 8. 参照先
+
+### 一次資料
+
+| 資料 | 場所 | 内容 |
+|---|---|---|
+| 配布元ルール | `/CLAUDE.md` | 3 ファイル同期・wheel 実体検証手順（配布元開発者向け） |
+| 共通ルール | `.claude/CLAUDE.md` | LLM 行動規範・承認フロー |
+| 設定キー仕様 | `.claude/docs/settings.json.md` | settings.json の各キー詳細仕様 |
+| ディレクトリ命名 | `.claude/docs/taxonomy.md` | ディレクトリの命名・役割・配置判断 |
+| プラットフォーム別 | `.claude/docs/platform-adapters.md` | Codex / Cursor adapter の生成物と参照経路 |
+| 背景・設計判断 | `.claude/docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md` | 本ドキュメント作成の背景・version upgrade の残課題 |
+
+### 実装ファイル
+
+| ファイル | 場所 | 内容 |
+|---|---|---|
+| 除外パターン定義 | `src/c3/_excludes.py` | `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` 定数 + `should_skip()` |
+| ビルド時除外 | `hatch_build.py` | `_excludes.py` の重複定義（ビルドフック用） |
+| 同期確認 hook | `.dev/hooks/_sync_check.py` | 3 ファイル変更時の警告（配布元専用） |
+| 自動承認 hook | `.claude/hooks/permission_handler.py` | `permission_rules.json` を読んで自動承認 |
+
+### 残課題リンク（v2.18.0 以降）
+
+- `permission_rules.json` の `auto_allow` が `settings.json.permissions.deny` を覆せるか検証
+- `~/.claude/settings.json` のグローバル設定と `.claude/settings.json` の同キー競合時のマージ範囲確認
+- `c3 update` の削除検出（`deletions.txt` 方式、v2.18.0 予定）
+- `c3 update` 時の Breaking changes 警告（v2.19.0 予定）

{claude_code_conductor-2.15.2 → claude_code_conductor-2.17.0}/.claude/hooks/stop.py

@@ -11,7 +11,7 @@ import re
 import tempfile
 from datetime import date, datetime, timezone
 
-from session_utils import SESSION_JSON_MARKER, is_worktree, create_session_template, SESSIONS_DIR, ensure_session_initialized
+from session_utils import SESSION_JSON_MARKER, is_worktree, create_session_template, SESSIONS_DIR, ensure_session_initialized, extract_section
 
 try:
     sys.stdin.reconfigure(encoding='utf-8')
@@ -31,6 +31,14 @@ MAX_ID_LENGTH = 64
 MAX_DESCRIPTION_LENGTH = 500
 MAX_LAST_MSG = 500
 
+# 過去セッションファイルから引き継ぐ - [ ] 行のサニタイズ用パターン。
+# C0/C1 制御文字 (タブ 	 と通常スペース   は保持) と U+2028 / U+2029 を除去する。
+# 過去ファイルの ## 残タスク はユーザー編集領域のため信頼境界として扱う [SR-V-001]。
+# raw string は \uXXXX を解釈しないため、U+2028 / U+2029 は chr() で生成して連結する。
+_INHERIT_SANITIZE_RE = re.compile(
+    r'[\x00-\x08\x0b-\x1f\x7f-\x9f' + chr(0x2028) + chr(0x2029) + r']'
+)
+
 # _append_last_message が処理済みのパスを記録するキャッシュ（重複 read/write 防止）。
 _last_message_applied_paths: set = set()
 
@@ -39,6 +47,99 @@ def get_session_path(date_str: str) -> str:
     return os.path.join(SESSIONS_DIR, f'{date_str}.tmp')
 
 
+def _inherit_backlog_from_latest_session(
+    new_path: str, today_str: str, sessions_dir: str | None = None
+) -> None:
+    """新規セッションファイルに、直近過去セッションの未完了バックログを引き継ぐ。
+
+    過去ファイルの ``## 残タスク`` セクションから ``- [ ]`` 行のみ抽出し、
+    新規ファイルの ``## 残タスク`` セクションに追記する。``- [x]`` 行は対象外。
+    マルチライン継続行（インデントされた `- [ ]` 以外の継続行）は引き継がない。
+
+    本ヘルパーは `ensure_session_file` の新規作成パスからのみ呼ばれる。既存当日
+    ファイルが存在する場合は呼ばれないため、ユーザー編集を上書きする危険はない。
+
+    過去ファイルから引き継ぐ行は `_INHERIT_SANITIZE_RE` で制御文字・ANSI エスケープ・
+    U+2028/U+2029 を除去してから書き込むため、過去ファイルの改ざんによる端末
+    インジェクションは構造的に防御される [SR-V-001]。
+
+    Args:
+        new_path: 新規作成された当日セッションファイルのパス。
+        today_str: 今日の日付（YYYYMMDD）。これ未満の日付の .tmp が対象。
+        sessions_dir: SESSIONS_DIR を上書きしたい場合のテスト用引数。
+            None の場合はモジュールグローバル SESSIONS_DIR を使う。
+    """
+    _sessions_dir = sessions_dir if sessions_dir is not None else SESSIONS_DIR
+    if not os.path.isdir(_sessions_dir):
+        return
+
+    # 今日より前で最大の日付（= 直近過去セッション）を選ぶ
+    past_dates = [
+        fname[:-4] for fname in os.listdir(_sessions_dir)
+        if fname.endswith('.tmp') and fname[:-4] < today_str
+    ]
+    if not past_dates:
+        return
+    latest_past_path = os.path.join(_sessions_dir, f'{max(past_dates)}.tmp')
+
+    try:
+        # universal newlines（デフォルト）で読み込む。攻撃により \r 単体が混入しても
+        # この時点で \n に変換されるため、\r 単体は構造的に防御される。
+        # ただし Python の str.splitlines() は \n に加え \v / \f / \x1c / \x1d / \x1e /
+        # \x85 / U+2028 / U+2029 でも分割する。これらは _INHERIT_SANITIZE_RE で
+        # 事前に除去してから splitlines に渡す必要がある。
+        with open(latest_past_path, 'r', encoding='utf-8') as f:
+            past_content = f.read()
+    except OSError:
+        return
+
+    # U+2028/U+2029 等の行区切り文字を事前にサニタイズしてから splitlines するため、
+    # 過去ファイルに混入した行区切り文字によって意図しない行分割が発生しない。
+    backlog_section = extract_section(past_content, '残タスク')
+    sanitized_section = _INHERIT_SANITIZE_RE.sub('', backlog_section)
+    pending_tasks = [
+        line for line in sanitized_section.splitlines()
+        if line.lstrip().startswith('- [ ]')
+    ]
+    if not pending_tasks:
+        return
+
+    try:
+        with open(new_path, 'r', encoding='utf-8') as f:
+            new_content = f.read()
+    except OSError:
+        return
+
+    inheritance_block = '\n'.join(pending_tasks) + '\n'
+    updated = new_content.replace(
+        '## 残タスク\n',
+        f'## 残タスク\n{inheritance_block}',
+        1,
+    )
+
+    if updated == new_content:
+        return
+
+    # アトミック書き込み: _apply_session_updates と同じ tempfile + os.replace パターン。
+    # suffix='.writing' は SESSIONS_DIR 内の `.tmp` 一覧フィルタに引っかからないよう
+    # 構造的に隔離する [SR-NEW L-1]。
+    dir_ = os.path.dirname(new_path)
+    tmp_path = None
+    try:
+        tmp_fd, tmp_path = tempfile.mkstemp(dir=dir_, suffix='.writing')
+        try:
+            with os.fdopen(tmp_fd, 'w', encoding='utf-8') as tmp_f:
+                tmp_f.write(updated)
+        except Exception:
+            os.close(tmp_fd)
+            raise
+        os.replace(tmp_path, new_path)
+        tmp_path = None
+    finally:
+        if tmp_path is not None and os.path.exists(tmp_path):
+            os.unlink(tmp_path)
+
+
 def ensure_session_file(date_str: str) -> None:
     os.makedirs(SESSIONS_DIR, exist_ok=True)
     path = get_session_path(date_str)
@@ -46,6 +147,11 @@ def ensure_session_file(date_str: str) -> None:
     try:
         with open(path, 'x', encoding='utf-8') as f:
             f.write(create_session_template(date_str))
+        # 新規作成時のみ、直近過去セッションから未完了タスクを引き継ぐ。
+        # 既存ファイルがある場合 (FileExistsError ブランチ) はユーザー編集を尊重し
+        # 引き継ぎを発動しない。sessions_dir を明示渡しにすることで、引き継ぎ関数内
+        # の SESSIONS_DIR 直参照を排除し、テスト時のグローバル差し替え依存を減らす。
+        _inherit_backlog_from_latest_session(path, date_str, sessions_dir=SESSIONS_DIR)
         print(f'[Stop] セッションファイルを作成しました: {path}', file=sys.stderr)
     except FileExistsError:
         # /exit による中断等でファイルが空の場合はテンプレートを書き直す（DRY: session_utils へ委譲）
@@ -65,8 +171,12 @@ def _apply_session_updates(path: str, content: str, message: str = '') -> None:
     now = datetime.now(timezone.utc).astimezone().strftime('%Y-%m-%d %H:%M:%S')
     updated = re.sub(r'(- 記録時刻: ).*', rf'\g<1>{now}', content)
 
-    # 最終応答を追記（メッセージがあり、まだ存在しない場合のみ）
-    if message and '- 最終応答:' not in updated:
+    # 最終応答を最新メッセージに更新する（既存があれば上書き、なければ追記）。
+    # 同一 stop hook 呼び出し内の冪等性は session_stop.py が stop.run を 1 回だけ呼ぶ
+    # + stop_hook_active 早期 return (run() 内) で担保されているため、過去セッションの
+    # 古い応答は積極的に上書きしてよい。古い `not in updated` ガードは「最初の応答が
+    # 一日中残る」問題を引き起こしていた。
+    if message:
         single_line = ' '.join(message.split())
         # サロゲート文字など UTF-8 非互換文字を除去（JSON デコード時に生成される場合がある）
         single_line = single_line.encode('utf-8', errors='replace').decode('utf-8')
@@ -76,11 +186,23 @@ def _apply_session_updates(path: str, content: str, message: str = '') -> None:
         # --> をサニタイズして <!-- C3:SESSION:JSON ... --> ブロックを保護する
         truncated = truncated.replace('-->', '-- >')
 
-        updated = re.sub(
-            r'(- 記録時刻: [^\n]*)',
-            lambda m: m.group(0) + f'\n- 最終応答: {truncated}',
-            updated
-        )
+        # 置換文字列に truncated（LLM 出力由来）を直接埋め込むと \1 等が後方参照として
+        # 解釈される。両分岐とも lambda で構造的に防御する [SR-V-001 Info-1]。
+        if '- 最終応答:' in updated:
+            replacement = f'- 最終応答: {truncated}'
+            updated = re.sub(
+                r'- 最終応答: [^\n]*',
+                lambda _: replacement,
+                updated,
+                count=1,
+            )
+        else:
+            updated = re.sub(
+                r'(- 記録時刻: [^\n]*)',
+                lambda m: m.group(0) + f'\n- 最終応答: {truncated}',
+                updated,
+                count=1,
+            )
 
     if updated != content:
         dir_ = os.path.dirname(path)

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

@@ -1,5 +1,129 @@
 # Changelog
 
+## v2.17.0 (2026-05-24)
+
+**基盤整備リリース第 1 弾**: 設定階層と配布判断ルールを canonical 化する。
+コード変更は最小（docstring 追記のみ）、API 互換性完全維持、利用先への影響なし。
+
+### 追加
+
+- **`.claude/docs/config-policy.md` を新規作成（308 行）**: 設定階層と配布判断ルールを
+  canonical 化する。主要構成は以下:
+  - §1 設定ファイル所在マップ（配布元と利用先での所在を一覧化）
+  - §2 設定優先順位（3 レイヤー: ツール権限 / 自動承認パターン / LLM 指示）と書き込み権限マトリクス
+  - §3 配布判断マトリクス（12 カテゴリ、`_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS`
+    と完全照合済み）
+  - §4 `settings.local.json` 運用の原則（`git add -f` リスク警告 / `c3 init` は `.gitignore`
+    を自動編集しないため手動追記が必要な点を明記）
+  - §5 プラットフォーム別 config 整合（canonical は `.claude/`、`.codex/` / `.cursor/` /
+    `.agents/` は adapter 生成物）
+  - §6 3 ファイル同期ルール（`.gitignore` / `_excludes.py` / `hatch_build.py`）
+  - §7 既知の落とし穴（`hooks` セクションの完全上書き / `taxonomy.md` の特殊扱い /
+    `rules/promoted/` を `c3 update` が触らない / `permission_rules.json` の `auto_allow`
+    過度設定リスク）
+  - §8 参照先
+- **`src/c3/_excludes.py` / `hatch_build.py` の docstring**:
+  両ファイル冒頭の docstring 末尾に「See `.claude/docs/config-policy.md`」参照を
+  完全一致 1 文で追記（3 ファイル同期の精神に則る）。定数 `EXCLUDE_PATTERNS` /
+  `KEEP_PATTERNS` は変更なし。
+- **`.claude/CLAUDE.md`**: Directory Structure セクション末尾に config-policy.md
+  への参照を 1 行追加。
+
+### 背景・経緯
+
+`.claude/docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md`（2026-05-22
+作成、配布元専用）で整理された「基盤整備 3 連発」のうち、規模「小 × 2」の高優先項目
+を 1 リリースで完結させた。アーキテクト段階の実装照合で以下 3 点を初期素案から
+訂正:
+- 配布判断マトリクス 10 → 12 カテゴリ（`permission_rules.json` 独立追加、例外 3 件明示）
+- 章数 7 → 8（§7「既知の落とし穴」追加）
+- 「5 段優先順位」→「3 レイヤー」（実装と乖離していたため修正）
+
+### 次リリース予告
+
+- **v2.18.0** (予定): `c3 update` が削除を検出しない問題（`c3_update_no_delete_detection`
+  パターン）の解消。`deletions.txt` 方式で配布物に削除すべきパス一覧を含める。
+- **v2.19.0** (予定): Breaking changes 警告 + バージョン checkpoint。`c3 update`
+  実行時に前回バージョンとの diff から breaking changes 一覧を表示する。
+
+### 影響
+
+- 既存利用先: なし。doc 追加 + docstring 追記のみで、コード挙動・CLI 挙動・wheel
+  配布物の構造（`_template/.claude/docs/` 配下に `config-policy.md` 追加のみ）に
+  破壊的変更はない。
+- 既存テスト: 944 PASS / 4 skip 維持。
+- レビュー対応: Round 1 code-review 4 件（M-01 / M-02 / L-01 / L-02）+ Round 2
+  security-review 3 件（SR-M-01 / SR-L-01 / SR-L-02）を計 3 ラウンドで全件解消。
+
+---
+
+## v2.16.0 (2026-05-24)
+
+### 修正
+
+- **stop.py: 最終応答が古いまま残るバグを修正**:
+  `_apply_session_updates` の `if message and '- 最終応答:' not in updated:`
+  ガードにより、1 日に複数 Claude セッションがあると最初のセッションの最終
+  応答が一日中残り続けていた。`re.sub` で最新メッセージに上書きする方式に
+  変更。同一 stop hook 呼び出し内の冪等性は `session_stop.py` の単一プロセス +
+  `stop_hook_active` 早期 return で従来通り担保されている。
+
+### 追加
+
+- **stop.py: 残タスクの前日自動引き継ぎ機能**:
+  新規ヘルパー `_inherit_backlog_from_latest_session` を追加し、
+  `ensure_session_file` の新規作成パスで `SESSIONS_DIR` 内の直近過去 `.tmp`
+  から `## 残タスク` セクションの `- [ ]` 行のみを抽出して当日ファイルに
+  引き継ぐ。既存当日ファイルがある場合 (`FileExistsError` ブランチ) は
+  発動せずユーザー編集を尊重する。`init-session` Step 1.5（git log 照合）が
+  これまで空ファイルでは何も検出できなかった問題を構造的に解消。
+- **過去ファイル由来の制御文字サニタイズ** [SR-V-001]:
+  `_INHERIT_SANITIZE_RE` を導入し、過去ファイルから引き継ぐ `- [ ]` 行に
+  含まれる C0/C1 制御文字 (`\x00-\x08` / `\x0b-\x1f` / `\x7f-\x9f`) と
+  U+2028 / U+2029 を除去。タブ (`\x09`) と通常スペース (`\x20`) は保持。
+  universal newlines による `\r` の `\n` 変換と二層で防御することで、
+  過去ファイル改ざんによる端末インジェクションを構造的に防ぐ。
+- **新規ヘルパー `_inherit_backlog_from_latest_session` の `sessions_dir`
+  引数**: テスト時にモジュールグローバル `SESSIONS_DIR` を差し替えずに
+  動作確認できるよう、`sessions_dir: str | None = None` 引数を追加。
+  `ensure_session_file` からは `sessions_dir=SESSIONS_DIR` を明示渡し。
+
+### 改善
+
+- **`_apply_session_updates` の `re.sub` 置換文字列を lambda 形式に統一**:
+  上書き分岐 / 追記分岐の両方で `lambda _: replacement` または
+  `lambda m: ...` 形式に統一し、LLM 出力由来の `\1` 等が後方参照として
+  解釈されるリスクを構造的に防御。
+- **アトミック書き込みの tempfile suffix を `.writing` に変更**:
+  `_inherit_backlog_from_latest_session` 内の一時ファイルが `.tmp`
+  フィルタと誤検出される可能性を排除（書き込み途中の一時ファイルを
+  `YYYYMMDD.tmp` として誤認することを構造的に防ぐ）。
+
+### 回帰防御
+
+- `tests/test_stop_additional.py` に新規 10 件のテスト追加:
+  - `TestAppendLastMessageOverwrite` (3 件): 最終応答上書き / 他セクション
+    保全 / 冪等性
+  - `TestInheritBacklogFromLatestSession` (4 件): 引き継ぎ動作 / 過去
+    ファイル無し / 既存当日ファイル保護 / 完了済みのみケース
+  - `TestInheritBacklogControlCharSanitize` (1 件): 制御文字・ANSI・
+    U+2028/U+2029 の除去とタブ・スペース保持
+  - `TestInheritBacklogSessionsDirArg` (1 件): `sessions_dir` 引数経路
+  - `TestInheritBacklogNewPathOSErrorGuard` (1 件): `new_path` 読み込み
+    OSError の伝播防止
+- pytest フル実行: **944 passed** / 4 skipped / 0 regression
+
+### 内部
+
+- `_inherit_backlog_from_latest_session` の `new_path` 読み込みに
+  `try/except OSError: return` を追加。Stop hook プロセスの異常終了を防ぐ。
+- `_INHERIT_SANITIZE_RE` の U+2028 / U+2029 は `chr(0x2028)` + `chr(0x2029)`
+  の連結で構築（raw string が `\uXXXX` を解釈しないため、表記揺れを排除）。
+- `tests/test_stop_additional.py`: `from session_utils import extract_section`
+  をファイル先頭に集約 / `_setup` 戻り値型ヒントを精緻化。
+
+---
+
 ## v2.15.2 (2026-05-24)
 
 ### 改善

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.15.2
+Version: 2.17.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.15.2 → claude_code_conductor-2.17.0}/hatch_build.py

@@ -6,6 +6,9 @@ than rely on ``[tool.hatch.build] exclude`` patterns - which do not propagate
 into ``force-include`` sources - we copy the wanted subset into a staging
 location during ``initialize()`` and the wheel target packages that staged tree
 verbatim.
+
+See ``.claude/docs/config-policy.md`` for the distribution decision matrix
+and the rationale behind each excluded pattern.
 """
 
 from __future__ import annotations

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

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