claude-code-conductor 2.54.0__tar.gz → 2.55.1__tar.gz

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/_hook_utils.py

@@ -7,8 +7,12 @@ PYTHONPATH に追加してから `from _hook_utils import ...` する経路を
 
 ## Exports
 
+- ``norm_component(s)`` — パス成分を正規化する（`.lower().rstrip('. ')`）。
+  ディレクトリ比較・拡張子判定の際にケース非依存化・末尾ドット/スペース除去を行う。
 - ``write_debug_log(log_path, line)`` — ``C3_HOOK_DEBUG=1`` のときのみログを追記する
   fail-safe な書き込みヘルパー。
+- ``sanitize_for_terminal(text)`` — 端末出力（stderr / stdout JSON）へ載せる前に
+  C0 + DEL + C1 制御文字を除去するヘルパー。
 """
 
 from __future__ import annotations
@@ -32,6 +36,27 @@ DEBUG_ENV = "C3_HOOK_DEBUG"
 _CONTROL_CHARS_RE = re.compile(r"[\x00-\x1f\x7f-\x9f]")
 
 
+def norm_component(s: str) -> str:
+    """パス成分を正規化する（ケース非依存化・末尾ドット/スペース除去）。
+
+    Windows・macOS の既定（ケース非依存 FS）では大文字・小文字の違い、
+    末尾のドットやスペースは同一実体を示す。複数ディレクトリ・拡張子判定の際に
+    `.lower().rstrip('. ')` で正規化してから比較する。
+    """
+    return str(s).lower().rstrip('. ')
+
+
+def sanitize_for_terminal(text: str) -> str:
+    """端末インジェクション対策: C0 制御文字 / DEL / C1 制御文字を除去する。
+
+    - 除去範囲は ``_CONTROL_CHARS_RE``（C0 + DEL + C1）と共通。ANSI エスケープの
+      ESC (``\\x1b``) と CSI (``\\x9b``) の双方をカバーする。
+    - hook が stderr / stdout JSON（additionalContext）へ外部由来の文字列
+      （ファイル名など）を載せる前に通す。
+    """
+    return _CONTROL_CHARS_RE.sub("", str(text))
+
+
 def write_debug_log(log_path: Path, line: str) -> None:
     """``C3_HOOK_DEBUG=1`` のとき、ログファイルに ``ISO8601 line`` を 1 行追記する。
 

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/check_agent_invocation.py

@@ -41,6 +41,7 @@ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 from _hook_utils import write_debug_log  # noqa: E402
 
 try:
+    sys.stdin.reconfigure(encoding="utf-8")
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
 except AttributeError:
@@ -53,8 +54,8 @@ REVIEWER_TYPES = frozenset({"code-reviewer", "security-reviewer"})
 PROJECT_ROOT = Path(__file__).resolve().parents[2]
 DEBUG_LOG_PATH = PROJECT_ROOT / ".claude" / "tmp" / "agent_hook_debug.log"
 
-# DoS 防御の読み取り上限（hook はローカル前提だが多層防御として明示する）。
-_STDIN_READ_LIMIT_BYTES = 1 * 1024 * 1024  # 1 MiB
+# DoS 防御の読み取り上限（文字数ベース）。hook はローカル前提だが多層防御として明示する。
+_STDIN_READ_LIMIT_CHARS = 1 * 1024 * 1024  # 1M chars
 
 
 def _escape_for_log(value: str) -> str:
@@ -64,7 +65,7 @@ def _escape_for_log(value: str) -> str:
 
 def main() -> None:
     try:
-        payload = json.loads(sys.stdin.read(_STDIN_READ_LIMIT_BYTES))
+        payload = json.loads(sys.stdin.read(_STDIN_READ_LIMIT_CHARS))
     except (json.JSONDecodeError, ValueError):
         sys.exit(0)
 

claude_code_conductor-2.55.1/.claude/hooks/patterns_guard.py

@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+"""PreToolUse hook: patterns.json への直接編集を事故防止ガード（P1・配布対象）。
+
+Write / Edit ツールで `.claude/memory/patterns.json` への書き込みを検出し、
+許可フラグがなければブロックする（TTL 型・600 秒）。正規経路は session.tmp 経由の
+promote-pattern skill。意図的な編集は `.claude/state/patterns_guard_allow.flag` で
+一時許可できる。
+
+## 射程の明記（設計の限界）
+
+- 対象: Write / Edit ツール呼び出しのみ
+- 対象外: Bash（python -c・sed 等）/ NotebookEdit 経由の書き込み
+- worktree 実行時: 基準が main/worktree のどちらになるかは環境解決に依存
+  （本 hook の基準は main の patterns.json 本体の事故防止。main 側保護が
+  保護されない場合は検知が働かない限界あり）
+- resolve() による大小文字の正準化は実在ファイルのみ（Windows nt._getfinalpathname）。
+  patterns.json が未作成の初期環境（c3 init 直後）ではケース違い指定が素通りする
+- Windows の末尾ドット・スペース正規化も実在パス限定。非実在パスでは本 hook が検知できない限界
+"""
+
+import json
+import os
+import sys
+import time
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.sanitize_for_terminal) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import sanitize_for_terminal  # noqa: E402
+
+try:
+    sys.stdin.reconfigure(encoding='utf-8')
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+# 許可フラグの有効期間（秒）。判定式はこの定数を参照する。
+TTL_SECONDS = 600
+
+
+def main():
+    # bypass: 恒久 disable 環境変数の確認
+    if os.environ.get('C3_PATTERNS_GUARD_DISABLE') == '1':
+        sys.exit(0)
+
+    # JSON payload の読み込み（fail-open）
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    # tool_name の確認（Write/Edit 以外は対象外）
+    tool_name = payload.get('tool_name', '')
+    if tool_name not in ('Write', 'Edit'):
+        sys.exit(0)
+
+    # file_path の抽出（キー欠落は fail-open）
+    file_path = payload.get('tool_input', {}).get('file_path', '')
+    if not file_path:
+        sys.exit(0)
+
+    # プロジェクトルートと保護対象パスの導出（Path(__file__) ベース）
+    hook_dir = Path(__file__).resolve().parent
+    project_root = hook_dir.parent.parent
+    flag_path = project_root / ".claude" / "state" / "patterns_guard_allow.flag"
+
+    # file_path と保護対象を同じ正規化（realpath）にそろえて比較する。
+    # NUL byte 混入など不正なパス文字列は OSError / ValueError になるため fail-open。
+    try:
+        protected_path = (
+            project_root / ".claude" / "memory" / "patterns.json"
+        ).resolve()
+        if os.path.isabs(file_path):
+            resolved = Path(file_path).resolve()
+        else:
+            # 相対パスは CWD を基準に解決（worktree 実行時は worktree CWD）
+            resolved = (Path.cwd() / file_path).resolve()
+    except (OSError, ValueError):
+        sys.exit(0)
+
+    # realpath 一致チェック
+    if resolved != protected_path:
+        sys.exit(0)
+
+    # patterns.json への書き込みが検出された → フラグチェック
+    # フラグが存在し TTL 内なら allow（削除しない＝複数操作可）
+    #
+    # TOCTOU 免責: exists() / getmtime() / unlink() の間にフラグが差し替えられる
+    # 競合は原理的に残る。本 hook は「事故防止ガード」であり悪意ある同時操作に対する
+    # セキュリティ境界ではないため、この競合は許容する。
+    if flag_path.exists():
+        mtime = os.path.getmtime(flag_path)
+        age = time.time() - mtime
+        if age <= TTL_SECONDS:
+            # TTL 内: 許可
+            sys.exit(0)
+        else:
+            # TTL 超過: フラグを削除して block
+            try:
+                flag_path.unlink()
+            except OSError:
+                pass
+
+    # ブロック: stderr と exit 2
+    flag_create_instruction = (
+        f".claude/state/patterns_guard_allow.flag を作成してください（空ファイルで可）。\n"
+        f"  例 Bash: touch {sanitize_for_terminal(str(flag_path))}\n"
+        f"  例 PowerShell: New-Item -ItemType File -Force "
+        f"{sanitize_for_terminal(str(flag_path))}"
+    )
+
+    message = (
+        f"[PatternGuard BLOCK] patterns.json への直接編集がブロックされました。\n"
+        f"正規経路: session.tmp の「##残タスク」へ記載後、promote-pattern skill を実行してください\n"
+        f"          または LLM が patterns.json を直接編集する場合は以下を実行:\n"
+        f"{flag_create_instruction}\n"
+        f"恒久 bypass: C3_PATTERNS_GUARD_DISABLE=1 環境変数を設定してください"
+    )
+
+    print(message, file=sys.stderr)
+    sys.exit(2)
+
+
+if __name__ == '__main__':
+    main()

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/planner_check.py

@@ -41,6 +41,7 @@ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 from _hook_utils import write_debug_log  # noqa: E402
 
 try:
+    sys.stdin.reconfigure(encoding="utf-8")
     sys.stdout.reconfigure(encoding="utf-8")
     sys.stderr.reconfigure(encoding="utf-8")
 except AttributeError:
@@ -58,8 +59,8 @@ except ImportError:
 PROJECT_ROOT = Path(__file__).resolve().parents[2]
 DEBUG_LOG_PATH = PROJECT_ROOT / ".claude" / "tmp" / "planner_check_debug.log"
 
-# DoS 防御の読み取り上限（hook はローカル前提だが多層防御として明示する）。
-_STDIN_READ_LIMIT_BYTES = 1 * 1024 * 1024  # 1 MiB
+# DoS 防御の読み取り上限（stdin は文字数ベース）。hook はローカル前提だが多層防御として明示する。
+_STDIN_READ_LIMIT_CHARS = 1 * 1024 * 1024  # 1M chars
 _FILE_READ_LIMIT_BYTES = 512 * 1024        # 512 KiB
 
 
@@ -230,7 +231,7 @@ def _check_r6_reviewer_absence(tasks: list) -> list[str]:
 
 def main() -> None:
     try:
-        payload = json.loads(sys.stdin.read(_STDIN_READ_LIMIT_BYTES))
+        payload = json.loads(sys.stdin.read(_STDIN_READ_LIMIT_CHARS))
     except (json.JSONDecodeError, ValueError):
         sys.exit(0)
 

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/post_tool.py

@@ -21,6 +21,7 @@ import re
 import sys
 
 try:
+    sys.stdin.reconfigure(encoding='utf-8')
     sys.stdout.reconfigure(encoding='utf-8')
     sys.stderr.reconfigure(encoding='utf-8')
 except AttributeError:

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/pre_compact.py

@@ -12,10 +12,23 @@ import re
 import sys
 from datetime import datetime, timedelta, timezone
 
-sys.stdout.reconfigure(encoding='utf-8')
-sys.stderr.reconfigure(encoding='utf-8')
-
-from session_utils import SESSION_JSON_MARKER, append_checkpoint, is_worktree, SESSIONS_DIR
+try:
+    sys.stdin.reconfigure(encoding='utf-8')
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+from session_utils import append_checkpoint, is_worktree, SESSIONS_DIR
+# SESSION_JSON_MARKER は本ファイルのロジックでは未参照だが、過去レビュー（Code Medium-3a）の
+# 契約として module-level 定数の存在を tests/test_stop_precompact_fixes.py が要求する再エクスポート。
+# 未使用に見えても削除しないこと。
+# `# noqa: F401` は flake8/ruff 固有の規約で生の pyflakes は解釈しないため、
+# 代わりに __all__ へ列挙して re-export であることを明示する（pyflakes は
+# __all__ 掲載名を使用済みとみなすため、警告が実際に抑制される）。
+from session_utils import SESSION_JSON_MARKER
+
+__all__ = ["SESSION_JSON_MARKER"]
 
 
 # デバウンス窓幅（秒）。直近の PreCompact checkpoint からこの秒数以内の再実行は

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/pre_tool.py

@@ -7,8 +7,12 @@ import re
 import shlex
 import sys
 
-sys.stdout.reconfigure(encoding='utf-8')
-sys.stderr.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
 
 
 def _is_rm_rf(tokens: list[str], rm_idx: int) -> bool:

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.1}/.claude/hooks/recall_autorebuild.py

@@ -23,8 +23,10 @@ import sys
 import time
 from pathlib import Path
 
-# CLAUDE.md §9-3: reconfigure stdout/stderr to UTF-8 on Windows.
+# CLAUDE.md §9-3: reconfigure stdin/stdout/stderr to UTF-8 on Windows.
 try:
+    if sys.stdin and hasattr(sys.stdin, "reconfigure"):
+        sys.stdin.reconfigure(encoding="utf-8")
     if sys.stdout and hasattr(sys.stdout, "reconfigure"):
         sys.stdout.reconfigure(encoding="utf-8")
     if sys.stderr and hasattr(sys.stderr, "reconfigure"):

claude_code_conductor-2.55.1/.claude/hooks/report_contract_check.py

@@ -0,0 +1,131 @@
+#!/usr/bin/env python3
+"""PostToolUse hook: タイムスタンプ報告契約の検査（P2・配布対象）。
+
+`.claude/reports/` 直下への Write で、以下 4 prefix のタイムスタンプ契約逸脱を warn する:
+  - requirements-report-
+  - architecture-report-
+  - plan-report-
+  - design-review-report-
+
+判定は basename 全体のフルマッチ `^{prefix}\\d{8}-\\d{6}\\.md$` で行う
+（prefix 一致と suffix 一致の独立 2 条件ではない。`plan-report-badname-extra-20260725-180252.md`
+のように prefix と タイムスタンプの間へ任意文字列を挟む名前も逸脱として検出するため）。
+不一致の場合は 2 経路で警告: stderr（人間向け）+ stdout JSON（LLM向け）。
+
+## ディレクトリ判定とケース非依存化
+
+reports ディレクトリの判定は `.claude/reports/` 直下かどうかを名前ベースで確認する。
+Windows・macOS の既定（ケース非依存 FS）では `.CLAUDE` や `REPORTS` は `.claude` / `reports` と
+同一実体の別名であり、名前比較は `.lower()` を使用してケース非依存で行う。
+basename（prefix・タイムスタンプ・`.md`）の判定は厳密に行う（`re.ASCII` で Unicode 偽装を防止）。
+
+## 出力契約（PostToolUse warn の標準形）
+
+exit 0 でも stdout JSON が LLM コンテキストへ additionalContext として注入される。
+stderr は人間にのみ届く。詳細は Claude Code 公式仕様を参照:
+  https://code.claude.com/docs/en/hooks
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.sanitize_for_terminal, norm_component) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import norm_component, sanitize_for_terminal  # noqa: E402
+
+try:
+    sys.stdin.reconfigure(encoding='utf-8')
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+
+def main():
+    # JSON payload の読み込み（fail-open）
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    # tool_name の確認（Write 以外は対象外＝新規命名は Write でのみ発生）
+    tool_name = payload.get('tool_name', '')
+    if tool_name != 'Write':
+        sys.exit(0)
+
+    # file_path の抽出（キー欠落は fail-open）
+    file_path = payload.get('tool_input', {}).get('file_path', '')
+    if not file_path:
+        sys.exit(0)
+
+    # `.claude/reports/` 直下かどうかの判定
+    path_obj = Path(file_path)
+    basename = path_obj.name
+    parent = path_obj.parent
+
+    # 構造判定: 親が `reports` かつ祖父が `.claude`（= `.claude/reports/` 直下）。
+    # 上流に同名の `reports/` があっても誤アンカーしない（resolve は使わない）。
+    # ケース非依存 FS（Windows・macOS）では `.CLAUDE` や `REPORTS` は `.claude` / `reports` と
+    # 同一実体の別名のため、比較は norm_component() で正規化してから行う。
+    # Windows の末尾ドット・スペースも norm_component() が除去する。
+    # 例: `/foo/.claude/reports/plan-report-20260725-180252.md` → 対象
+    # 例: `/foo/.claude/reports/archive/plan-report-final.md` → 対象外（直下でない）
+    if norm_component(parent.name) != 'reports' or norm_component(parent.parent.name) != '.claude':
+        sys.exit(0)
+
+    # strict-4: 対象 prefix の確認
+    strict4_prefixes = [
+        'requirements-report-',
+        'architecture-report-',
+        'plan-report-',
+        'design-review-report-',
+    ]
+
+    matched_prefix = None
+    for prefix in strict4_prefixes:
+        if basename.startswith(prefix):
+            matched_prefix = prefix
+            break
+    if matched_prefix is None:
+        sys.exit(0)
+
+    # basename 全体のフルマッチ確認（`{prefix}YYYYMMDD-HHMMSS.md`）
+    # re.ASCII を指定してタイムスタンプを ASCII 数字に限定し、全角数字による偽装を防止する。
+    contract_pattern = re.compile(re.escape(matched_prefix) + r'\d{8}-\d{6}\.md', re.ASCII)
+    if contract_pattern.fullmatch(basename):
+        # 正しい形式
+        sys.exit(0)
+
+    # 違反: 警告を出す（2 経路）
+    # stderr（人間向け）
+    print(
+        f'[ReportContract WARN] {sanitize_for_terminal(basename)} '
+        f'のファイル名形式が違反しています。'
+        f'期待形式: {{prefix}}YYYYMMDD-HHMMSS.md\n'
+        f'採番は report-timestamp skill を使用してください。',
+        file=sys.stderr
+    )
+
+    # stdout JSON（LLM向け）
+    context = (
+        f'ファイル名: {sanitize_for_terminal(basename)}\n'
+        f'期待形式: {{prefix}}YYYYMMDD-HHMMSS.md\n'
+        f'採番方法: report-timestamp skill で取得したタイムスタンプを使用してください。'
+    )
+    output = {
+        'hookSpecificOutput': {
+            'hookEventName': 'PostToolUse',
+            'additionalContext': context
+        }
+    }
+    print(json.dumps(output), file=sys.stdout)
+
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()