claude-code-conductor 2.53.0__tar.gz → 2.55.0__tar.gz

{claude_code_conductor-2.53.0 → claude_code_conductor-2.55.0}/.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.55.0/.claude/hooks/patterns_guard.py

@@ -0,0 +1,126 @@
+#!/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.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.55.0/.claude/hooks/report_contract_check.py

@@ -0,0 +1,130 @@
+#!/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.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()

{claude_code_conductor-2.53.0 → claude_code_conductor-2.55.0}/.claude/hooks/select_tier.py

@@ -12,9 +12,17 @@ tier-routing MVP: タスクの複雑度を簡易ヒューリスティックで
   推奨の提示と tier_selection.json への記録のみを担い、model の注入は
   tier_autoapply.py が行う。明示指定された `model:` は tier_autoapply が
   尊重して上書きしない。agent の `model:` フロントマター自体は変更しない
-- **やらない**: developer / wt_developer 以外の role への適用、
+- **やる（ADR-3〜ADR-5 拡張）**: tester(Red) 推奨を additive な ``roles.tester``
+  キーとして tier_selection.json に併記する。tester / wt_tester は test- タスク
+  （Red フェーズ）に限り tier_autoapply が機械適用する（D-3/D-5 等の非 Red 起動は
+  従来どおり frontmatter 任せ）。
+- **やらない**: developer / wt_developer / tester(Red) 以外の role への適用、
   フォールバック（Haiku 失敗→Sonnet 自動昇格）
 
+【opus 固定不変則（ADR-6）】機械適用（APPLY_ROLES / RED_APPLY_ROLES）に追加できるのは
+frontmatter ``model: sonnet`` の role のみ。opus frontmatter の agent（architect /
+planner / design-critic / doc-writer / project-setup）は tier レバーを持たず恒久対象外。
+
 学習データ（帰属機械化・フェーズ3）:
 - 結果は ``.claude/state/tier_selection.json`` に直近 1 件のみ書き込む
 - Agent 起動時に ``tier_autoapply.py`` が実適用 model を
@@ -451,15 +459,20 @@ _ESCALATION_MAP: dict[str, str] = {
 # SSOT: db.ESCALATION_THRESHOLD_DEFAULT 由来（import 部で取得）。C3_ESCALATION_THRESHOLD env で上書き可（v2.26.0）。
 
 
-def _db_failure_rate(complexity: str, tier: str) -> tuple:
+def _db_failure_rate(complexity: str, tier: str, role: str = "developer") -> tuple:
     """DB から failure rate を読み取るデフォルト実装。
 
+    ``role`` は集計対象の agent role（既定 ``"developer"``・後方互換）。
+    ADR-5: tester 推奨の escalation では ``role="tester"`` を渡し
+    ``read_agent_failure_rate("tester", ...)`` を引く（role 別 gate 集合は
+    db 側 ``bandit_gates_for_role`` が解決する）。
+
     c3_db のインポートに失敗した場合は ``(None, 0)`` を返す。
     """
     c3_db = _load_c3_db_module()
     if c3_db is None:
         return None, 0
-    return c3_db.read_agent_failure_rate("developer", complexity, tier)
+    return c3_db.read_agent_failure_rate(role, complexity, tier)
 
 
 def maybe_escalate(
@@ -468,6 +481,7 @@ def maybe_escalate(
     *,
     failure_rate_fn=None,
     threshold: float | None = None,
+    role: str = "developer",
 ) -> tuple[str, str | None]:
     """Phase 2-B: failure rate が高ければ 1 段昇格する。
 
@@ -476,10 +490,15 @@ def maybe_escalate(
         chosen_tier: select_tier が選んだ tier。
         failure_rate_fn: テスト用に注入可能な
             ``(complexity, tier) -> (rate_or_None, sample_count)``。
-            省略時は :func:`_db_failure_rate` を使う。
+            省略時は :func:`_db_failure_rate` を使う。既存の注入契約（2 引数）を
+            保つため、注入時は ``role`` を渡さない（テストは戻り値を固定するため
+            role 分岐は不要）。role は既定実装 ``_db_failure_rate`` へのみ透過する。
         threshold: escalation 閾値（failure rate がこの値以上で昇格）。
             None のとき module 定数 ``ESCALATION_THRESHOLD`` を使う。
             ``main()`` は ``_resolve_escalation_threshold()`` で解決した値を渡す。
+        role: 集計対象の agent role（既定 ``"developer"``）。ADR-5: tester 推奨の
+            escalation では ``role="tester"`` を渡して ``_db_failure_rate`` 経由で
+            tester セルの failure rate を引く。
 
     Returns:
         ``(effective_tier, escalation_reason)``。
@@ -489,8 +508,10 @@ def maybe_escalate(
     if chosen_tier not in _ESCALATION_MAP:
         return chosen_tier, None
 
-    effective_fn = failure_rate_fn or _db_failure_rate
-    rate, samples = effective_fn(complexity, chosen_tier)
+    if failure_rate_fn is not None:
+        rate, samples = failure_rate_fn(complexity, chosen_tier)
+    else:
+        rate, samples = _db_failure_rate(complexity, chosen_tier, role)
     eff_threshold = threshold if threshold is not None else ESCALATION_THRESHOLD
     if rate is None or rate < eff_threshold:
         return chosen_tier, None
@@ -516,6 +537,7 @@ def write_tier_selection(
     cost_tiebreak: bool = False,
     cost_weighted: bool = False,
     cost_lambda: float | None = None,
+    roles: dict[str, dict] | None = None,
 ) -> None:
     """直近の選択結果を ``tier_selection.json`` に書く。
 
@@ -543,6 +565,13 @@ def write_tier_selection(
     ``cost_lambda`` を任意で含める（v2.26.0）。
     ``_resolve_cost_lambda()`` で解決した λ 値（None 以外のとき出力）。
     None のときはキー自体を省略する（env 未設定時の後方互換）。
+
+    ``roles`` を任意で含める（ADR-3・additive role 別推奨）。
+    ``{"tester": {"tier": <実効 tier>, "mode": <mode>, "escalated"?: True}}`` の形。
+    None（渡されない）のときはキー自体を省略する（session_id / cost_tiebreak と
+    同じ additive-omit パターン＝トップレベルの bit 一致を保つ後方互換の核心）。
+    トップレベルの ``tier`` / ``mode`` は現行どおり developer 推奨を書き、
+    ``roles.tester`` は新読者（tier_autoapply 注入・record 優先 3）だけが見る。
     """
     os.makedirs(os.path.dirname(TIER_SELECTION_PATH), exist_ok=True)
     payload: dict[str, object] = {
@@ -570,6 +599,8 @@ def write_tier_selection(
         payload["cost_weighted"] = True
     if cost_lambda is not None:
         payload["cost_lambda"] = cost_lambda
+    if roles is not None:
+        payload["roles"] = roles
     try:
         with open(TIER_SELECTION_PATH, "w", encoding="utf-8") as f:
             json.dump(payload, f, ensure_ascii=False)
@@ -588,6 +619,7 @@ def build_additional_context(
     complexity_source: str | None = None,
     cost_tiebreak: bool = False,
     cost_weighted: bool = False,
+    tester_tier: str | None = None,
 ) -> str:
     """親 Claude に追加注入する文字列を組み立てる。
 
@@ -597,6 +629,11 @@ def build_additional_context(
     ``cost_weighted`` が True のとき、cost-weighted 文言を suffix に追加する（v2.26.0）。
     True のときは cost_tiebreak の文言より優先される（λ>0 全 tier weighting を明示）。
     False のときは cost_tiebreak による既存文言のみ（v2.25.0 以前と完全一致）。
+
+    ``tester_tier`` が渡された場合、tester(Red) 推奨 Tier を併記する（ADR-4）。
+    None（既定）のときは併記行を省略する（build_additional_context を直接呼ぶ
+    既存テストの後方互換）。tester / wt_tester は test- タスク（Red）に限り機械適用
+    対象であることを対象説明に明記する。
     """
     trials = sum(p[2] for p in params.values())
     if mode == "uniform":
@@ -615,6 +652,10 @@ def build_additional_context(
     elif cost_tiebreak:
         suffix += " [cost-aware: 成功率拮抗のため低コスト Tier を選択]"
 
+    tester_note = ""
+    if tester_tier is not None:
+        tester_note = f" tester(Red) 推奨 Tier: {tester_tier}。"
+
     return (
         f"[tier-routing 推奨] 複雑度: {complexity} / 推奨 Tier: {tier}（{confidence}・developer 基準）。"
         f" developer / wt_developer を Agent ツールで起動する際は、PreToolUse hook"
@@ -622,9 +663,12 @@ def build_additional_context(
         f"（親 Claude が model: を転記する必要はありません・学習データ収集中の期間も含め常に適用）。"
         f" 推奨と異なる Tier を使いたい場合のみ、Agent 呼び出し時に model: を明示指定してください"
         f"（明示指定は尊重され hook に上書きされません。fork は model 上書き不可のため対象外）。"
-        f" 対象は developer / wt_developer のみ。tester 等の他 role、および親 Claude"
-        f" ペルソナで動かす role（interviewer / architect / planner）は"
-        f" tier レバーが無いため対象外で従来どおりとする。{suffix}"
+        f"{tester_note}"
+        f" tester / wt_tester は test- タスク（Red フェーズ）に限り機械適用対象です"
+        f"（C3_TASK_ID: test-... マーカー付き起動のみ・D-3/D-5 等の非 Red 起動は"
+        f" 従来どおり frontmatter 任せ）。親 Claude ペルソナで動かす role"
+        f"（interviewer / architect / planner）は tier レバーが無いため対象外で"
+        f" 従来どおりとする。{suffix}"
     )
 
 
@@ -814,6 +858,25 @@ def main() -> int:
     effective_tier, escalation_reason = maybe_escalate(complexity, tier, threshold=esc_thr)
     escalated = effective_tier != tier
 
+    # ADR-3/ADR-4/ADR-5: tester(Red) 推奨を additive に算出する。complexity /
+    # cost_map / epsilon / lam は developer と同一解決値を使う（per-prompt 分類・
+    # DC-AS-001）。escalation は role="tester" で tester セルの failure rate を引く。
+    # developer 推奨を先に確定してから算出するため、tester 側の rng 消費は
+    # developer の結果に影響しない（トップレベル bit 一致の後方互換を保つ）。
+    if c3_db is None:
+        tester_params = {t: (1.0, 1.0, 0) for t in TIERS}
+    else:
+        tester_params = c3_db.read_agent_tier_params("tester", complexity)
+    tester_result = select_tier_detailed(tester_params, cost_map=cost_map, epsilon=eps, lam=lam)
+    tester_effective, _tester_esc_reason = maybe_escalate(
+        complexity, tester_result.tier, threshold=esc_thr, role="tester",
+    )
+    tester_escalated = tester_effective != tester_result.tier
+    tester_entry: dict[str, object] = {"tier": tester_effective, "mode": tester_result.mode}
+    if tester_escalated:
+        tester_entry["escalated"] = True
+    roles = {"tester": tester_entry}
+
     write_tier_selection(
         complexity, effective_tier, mode,
         escalated=escalated, escalation_reason=escalation_reason,
@@ -823,6 +886,7 @@ def main() -> int:
         cost_tiebreak=cost_tiebreak,
         cost_weighted=result.cost_weighted,
         cost_lambda=lam,
+        roles=roles,
     )
 
     context_text = build_additional_context(
@@ -831,6 +895,7 @@ def main() -> int:
         complexity_source=complexity_source,
         cost_tiebreak=cost_tiebreak,
         cost_weighted=result.cost_weighted,
+        tester_tier=tester_effective,
     )
     output = {
         "hookSpecificOutput": {