claude-code-conductor 2.67.0__tar.gz → 2.69.0__tar.gz

{claude_code_conductor-2.67.0 → claude_code_conductor-2.69.0}/.claude/breaking-changes.txt

@@ -12,3 +12,4 @@ v2.51.0|Hook and statusLine launchers in the distributed settings.json changed f
 v2.58.0|c3 init and c3 update now place .claude/.gitignore in the target project. It excludes only regenerable files (state/recall.*) and session-scoped files (state/*.flag, state/tier_selection.json, logs/, worktrees/, tmp/). Existing projects that already committed those must run 'git rm -r --cached .claude/state/recall.hnsw .claude/state/recall_meta.json .claude/logs .claude/worktrees' once and commit, because .gitignore has no effect on already-tracked files. If your root .gitignore excludes the whole .claude/state/ directory, git never descends into it and the negation patterns in .claude/.gitignore do not apply; change the root rule to .claude/state/* or remove it. See .claude/docs/config-policy.md section 1-2.|c3 init / c3 update が .claude/.gitignore を配置するようになりました。除外は再生成可能なもの（state/recall.*）とセッション一時のもの（state/*.flag・state/tier_selection.json・logs/・worktrees/・tmp/）のみです。既にこれらを commit している既存プロジェクトは、.gitignore が tracked ファイルに効かないため git rm -r --cached を一度実行してください。ルートの .gitignore で .claude/state/ をディレクトリごと除外している場合は否定パターンが効かないため、ワイルドカード形式へ変更するか削除してください。詳細は .claude/docs/config-policy.md §1-2 を参照。
 v2.60.0|c3 plan validate/waves now strictly validate po_plan_version: only "0.1" (parallel) or "sequential" (sequential TDD) quoted strings are accepted; unknown or non-string values fail with exit 2. Migrate existing plan-reports by setting po_plan_version: "0.1" or "sequential" (quoted).|po_plan_version の値を厳格検査（"0.1"/"sequential" のみ受理・他は exit 2）。既存 plan-report は引用符付きの正値へ修正する。
 v2.66.0|record_review_decision.py: --severity is now a required argument (omitting it exits 2 and records nothing; out-of-vocabulary values still fail-safe to NULL with a warning). --finding now rejects empty or whitespace-only values (exit 2). Update any custom invocations to pass --severity with one of critical/high/medium/low. Shipped SKILL.md call sites and docstrings are already updated.|
+v2.68.0|New PreToolUse Write hook report_path_guard.py is registered in the distributed settings.json. It blocks (exit 2) writes of report-prefixed filenames (requirements-report-, architecture-report-, plan-report-, design-review-report-, code-review-report-, security-review-report-, test-report-, debug-analysis-, debug-needed-) outside .claude/reports/, overwrites of existing timestamp-named reports, and non-timestamp naming for the strict 4 report types. Ordinary files whose names start with those prefixes can no longer be written outside .claude/reports/. Set C3_REPORT_GUARD_DISABLE=1 to bypass, or remove the hook registration from settings.json.|レポート 9 prefix 名ファイルの .claude/reports/ 外への Write・タイムスタンプ形式既存レポートの上書き・strict-4 の非タイムスタンプ命名を exit 2 で block する report_path_guard hook を配布 settings.json に登録。対象 prefix 名の一般ファイルも block されうる。回避は C3_REPORT_GUARD_DISABLE=1 または settings.json から登録を外す。

{claude_code_conductor-2.67.0 → claude_code_conductor-2.69.0}/.claude/hooks/_hook_utils.py

@@ -13,6 +13,11 @@ PYTHONPATH に追加してから `from _hook_utils import ...` する経路を
   fail-safe な書き込みヘルパー。
 - ``sanitize_for_terminal(text)`` — 端末出力（stderr / stdout JSON）へ載せる前に
   C0 + DEL + C1 制御文字に加え、双方向制御・ゼロ幅・行区切り文字を除去するヘルパー。
+- ``STRICT4_PREFIXES`` — タイムスタンプ形式のみ許容する prefix の tuple。
+  ``timestamp_pattern()`` と組み合わせて使用（report_path_guard / report_contract_check）。
+- ``timestamp_pattern(prefix)`` — ``{prefix}YYYYMMDD-HHMMSS.md`` のフルマッチ用
+  正規表現（``re.compile`` オブジェクト）を返す。全角数字偽装防止のため ``re.ASCII``
+  を指定。
 """
 
 from __future__ import annotations
@@ -54,6 +59,15 @@ _TERMINAL_SANITIZE_RE = re.compile(
     + r"]"
 )
 
+# strict-4: タイムスタンプ形式のみ許容する prefix の tuple。
+# report_path_guard.py / report_contract_check.py が共有する。
+STRICT4_PREFIXES = (
+    'requirements-report-',
+    'architecture-report-',
+    'plan-report-',
+    'design-review-report-',
+)
+
 
 # NOTE: 同一ロジックが src/c3/cli_update.py::_validate_deletion_path の step 13 に
 # 複製されている（import 経路がないため）。変更時は両方を揃えること。
@@ -79,6 +93,14 @@ def sanitize_for_terminal(text: str) -> str:
     return _TERMINAL_SANITIZE_RE.sub("", str(text))
 
 
+def timestamp_pattern(prefix: str) -> re.Pattern:
+    """``{prefix}YYYYMMDD-HHMMSS.md`` のフルマッチ用パターンを返す。
+
+    re.ASCII を指定してタイムスタンプを ASCII 数字に限定し、全角数字による偽装を防止する。
+    """
+    return re.compile(re.escape(prefix) + r'\d{8}-\d{6}\.md', re.ASCII)
+
+
 def write_debug_log(log_path: Path, line: str) -> None:
     """``C3_HOOK_DEBUG=1`` のとき、ログファイルに ``ISO8601 line`` を 1 行追記する。
 

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

@@ -0,0 +1,212 @@
+#!/usr/bin/env python3
+"""PostToolUse hook: タイムスタンプ報告契約の検査（P2・配布対象）。
+
+`.claude/reports/` 直下への Write で、以下 2 レジームのファイル名契約逸脱を warn する。
+
+**strict-4（タイムスタンプ形式のみ許容）** — 以下 4 prefix:
+  - 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 と タイムスタンプの間へ任意文字列を挟む名前も逸脱として検出するため）。
+
+**loose-3（タイムスタンプ形式 または task_id 形式のどちらかを許容＝緩検査）** — 以下 3 prefix:
+  - code-review-report-
+  - security-review-report-
+  - test-report-
+
+CR / SR / test レポートは「タイムスタンプ採番」と「task_id 採番（並列 wave のファイル名衝突
+回避）」の 2 レジームを持つため、どちらか一方を強制しない。以下 2 形式のいずれかに一致すれば
+沈黙し、どちらにも一致しなければ警告する:
+  - タイムスタンプ形式: `^{prefix}\\d{8}-\\d{6}\\.md$`
+  - task_id 形式: `^{prefix}[英数 . _ -]{1,200}\\.md$`
+
+`debug-analysis-` / `debug-needed-` はどちらのレジームにも属さず警告対象外。
+不一致の場合は 2 経路で警告: stderr（人間向け）+ stdout JSON（LLM向け）。
+
+## ディレクトリ判定とケース非依存化
+
+reports ディレクトリの判定は `.claude/reports/` 直下かどうかを名前ベースで確認する。
+Windows・macOS の既定（ケース非依存 FS）では `.CLAUDE` や `REPORTS` は `.claude` / `reports` と
+同一実体の別名であり、名前比較は `.lower()` を使用してケース非依存で行う。
+basename の判定は 2 レジームとも厳密に行う（`re.IGNORECASE` 不使用・`re.ASCII` で Unicode 偽装を
+防止）。strict-4 は prefix・タイムスタンプ・`.md` の厳密フルマッチ、loose-3 は
+タイムスタンプ形式 または task_id 形式（許容文字は ASCII 英数と `.` `_` `-` のみ）の
+どちらかへの厳密フルマッチであり、緩いのは「許容形式が 2 つある」点のみで
+各形式の照合自体は厳密である。
+
+## 出力契約（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, STRICT4_PREFIXES,
+# timestamp_pattern) を hooks/ 経由で import するため、このスクリプトのディレクトリを
+# PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import (  # noqa: E402
+    norm_component,
+    sanitize_for_terminal,
+    STRICT4_PREFIXES,
+    timestamp_pattern,
+)
+
+try:
+    sys.stdin.reconfigure(encoding='utf-8')
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+# strict-4: STRICT4_PREFIXES は _hook_utils から import。
+# loose-3: タイムスタンプ形式 または task_id 形式のどちらかを許容する prefix。
+# 注: タイムスタンプ形式（YYYYMMDD-HHMMSS）は task_id 形式の真部分集合であり、
+# 判定としては task_id 形式 1 本で足りる（2 形式併記は利用者向けの説明のため）。
+LOOSE3_PREFIXES = (
+    'code-review-report-',
+    'security-review-report-',
+    'test-report-',
+)
+
+# task_id の許容文字集合と長さ上限（英数と `.` `_` `-` のみ 1〜200 文字）。
+TASK_ID_MAX_LEN = 200
+
+
+def task_id_pattern(prefix):
+    """`{prefix}{task_id}.md` のフルマッチ用パターンを返す。
+
+    task_id は ASCII 英数と `.` `_` `-` のみ 1〜TASK_ID_MAX_LEN 文字。
+    文字集合をリテラルで ASCII に限定したうえで、`re.ASCII` も明示して意図を固定する。
+    """
+    return re.compile(
+        re.escape(prefix) + r'[A-Za-z0-9._-]{1,' + str(TASK_ID_MAX_LEN) + r'}\.md',
+        re.ASCII,
+    )
+
+
+def emit_warning(basename, expected_format, stderr_hint, context_hint):
+    """契約逸脱を 2 経路（stderr = 人間向け / stdout JSON = LLM 向け）で警告する。
+
+    basename は外部由来のため、両経路とも sanitize_for_terminal() を通してから出力する。
+    strict-4 / loose-3 で期待形式・採番案内の文面のみが変わり、出力の骨格は共通。
+    """
+    safe_basename = sanitize_for_terminal(basename)
+
+    # stderr（人間向け）
+    print(
+        f'[ReportContract WARN] {safe_basename} '
+        f'のファイル名形式が違反しています。'
+        f'期待形式: {expected_format}\n'
+        f'{stderr_hint}',
+        file=sys.stderr
+    )
+
+    # stdout JSON（LLM向け）
+    context = (
+        f'ファイル名: {safe_basename}\n'
+        f'期待形式: {expected_format}\n'
+        f'採番方法: {context_hint}'
+    )
+    output = {
+        'hookSpecificOutput': {
+            'hookEventName': 'PostToolUse',
+            'additionalContext': context
+        }
+    }
+    print(json.dumps(output), file=sys.stdout)
+
+
+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)
+
+    # basename を正規化（ケース非依存化・末尾ドット/スペース除去）してから prefix 判定。
+    # report_path_guard.py と同じポリシーで統一。
+    # **重要**: prefix 判定は norm_basename で行うが、形式マッチング（拡張子検証含む）は
+    # 元の basename に対して行う。これにより大文字混じり prefix（Test-Report-）は検出
+    # しつつ、`.MD` 拡張子のような大文字混じりは厳密に reject できる。
+    norm_basename = norm_component(basename)
+
+    # strict-4: 対象 prefix の確認 → basename 全体のフルマッチ確認
+    # （`{prefix}YYYYMMDD-HHMMSS.md` のみ許容）
+    for prefix in STRICT4_PREFIXES:
+        if not norm_basename.startswith(prefix):
+            continue
+        # 形式マッチングは元の basename に対して行う（`.md` 拡張子の厳密化）
+        if timestamp_pattern(prefix).fullmatch(basename):
+            # 正しい形式
+            sys.exit(0)
+        emit_warning(
+            basename,
+            '{prefix}YYYYMMDD-HHMMSS.md',
+            '採番は report-timestamp skill を使用してください。',
+            'report-timestamp skill で取得したタイムスタンプを使用してください。',
+        )
+        sys.exit(0)
+
+    # loose-3: 対象 prefix の確認 → 2 形式のいずれかへのフルマッチ確認
+    # （`{prefix}YYYYMMDD-HHMMSS.md` または `{prefix}{task_id}.md`）
+    for prefix in LOOSE3_PREFIXES:
+        if not norm_basename.startswith(prefix):
+            continue
+        # 形式マッチングは元の basename に対して行う（`.md` 拡張子の厳密化）
+        if (timestamp_pattern(prefix).fullmatch(basename)
+                or task_id_pattern(prefix).fullmatch(basename)):
+            # どちらかの正しい形式
+            sys.exit(0)
+        emit_warning(
+            basename,
+            '{prefix}YYYYMMDD-HHMMSS.md または {prefix}{task_id}.md'
+            f'（task_id は英数と . _ - のみ 1〜{TASK_ID_MAX_LEN} 文字）',
+            'タイムスタンプ採番は report-timestamp skill を、'
+            'task_id 採番は plan-report の task_id を使用してください。',
+            'タイムスタンプ形式なら report-timestamp skill で取得した値を、'
+            'task_id 形式なら plan-report の task_id を使用してください。',
+        )
+        sys.exit(0)
+
+    # どちらのレジームにも属さない prefix（debug 系・自由域）は対象外
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()

claude_code_conductor-2.69.0/.claude/hooks/report_path_guard.py

@@ -0,0 +1,283 @@
+#!/usr/bin/env python3
+"""PreToolUse hook: レポートの書き先パスを守るガード（P4・配布対象）。
+
+Write ツールで作成されるレポートファイル（対象 9 prefix）について、
+書き先が `.claude/reports/` 直下であること・既存レポートを上書きしないこと・
+strict-4 prefix がタイムスタンプ命名であることを検査し、逸脱を exit 2 でブロックする。
+
+## 発火条件
+
+`tool_name` == "Write" かつ、basename を `_hook_utils.norm_component()`
+（lower + 末尾ドット/スペース除去）で正規化した値が対象 9 prefix のいずれかで
+始まる場合のみ。非対象 basename・Write 以外は沈黙（exit 0・stderr 空）。
+
+## 判定入力の一本化
+
+target = `file_path` が絶対ならそのまま、相対なら `os.getcwd()` と結合したパス。
+第 1 層・第 2 層とも同じ target を判定する（判定対象が経路によってブレないようにする）。
+
+## 検査 1: 封じ込め（二層）
+
+- 第 1 層（名前判定）: target の親が `reports`・祖父が `.claude`
+  （`norm_component` 正規化で比較。ケース非依存 FS の別名・末尾ドットを吸収する）
+- 第 2 層（実体照合）: `realpath(target)` の親ディレクトリが許可 root と
+  `os.path.samefile` で一致すること
+
+許可 root は 2 つ:
+  - root A = `realpath(os.getcwd())/.claude/reports`（一次）
+  - root B = `realpath($CLAUDE_PROJECT_DIR)/.claude/reports`（env が非空のときのみ）
+
+env 未設定・空なら root A のみで判定する（縮退。root B が無いことを理由に block しない）。
+両層 AND で許可し、不成立・両 root 不在・親不在は block（fail-closed）。
+
+### 免責（脅威モデル外）
+
+許可 root ディレクトリ自体（`.claude/reports` そのもの）が外部へのリンクに
+差し替えられているケースは、expected（root A/B）と resolved（target の親）が
+同一実体になるため block しない。root そのものを差し替えられる権限を持つ相手は
+本 hook の防御対象ではなく、ここで block すると正規運用（reports を別ボリュームへ
+逃がす構成）を壊すだけになる。
+
+## 判定の分割（正規化 basename と元 basename）
+
+report_contract_check.py と統一したポリシー: **prefix 一致判定は
+`norm_component()` 正規化後の basename・形式（timestamp フルマッチ）判定は
+元の basename** に対して行う。これにより大文字混じり prefix（`Plan-Report-`）は
+prefix 一致として検出しつつ、`.MD` のような大文字混じり拡張子は timestamp 形式として
+誤許可しない（ケース非依存 FS では正規名と同一実体になりうるため、この場合は
+strict-4 なら検査 3 で block・非 strict-4 なら通常の新規作成として許可される）。
+
+## 検査 2: 上書き block
+
+元の basename が timestamp 形式（prefix + `\\d{8}-\\d{6}\\.md` の `re.ASCII`
+フルマッチ）かつ書き込み先実体が既存 → block。task_id 形式（非 timestamp）の
+既存上書きは許可する（同一 task の再実行で更新する正規経路のため）。
+
+## 検査 3: strict-4 形式 block
+
+strict-4 prefix（requirements / architecture / plan / design-review）に一致する
+（正規化 basename が prefix で始まる）ファイルの、元の basename が timestamp 形式に
+フルマッチしない場合は新規作成でも block。CR / SR / test / debug 系は
+task_id 命名が正規のため非適用。
+
+## fail 方針
+
+- 壊れた stdin JSON / payload 非オブジェクト / キー欠落 / 空 file_path は fail-open
+  （対象かどうかすら判定できない入力で他の Write を巻き込まない）
+- 対象と判定した後のパス判定で例外を誘発する入力・NUL 混入は fail-closed（block）
+
+## bypass
+
+環境変数 `C3_REPORT_GUARD_DISABLE=1` で全検査をスキップする。
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.norm_component, sanitize_for_terminal, STRICT4_PREFIXES,
+# timestamp_pattern) を hooks/ 経由で import するため、このスクリプトのディレクトリを
+# PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import (  # noqa: E402
+    norm_component,
+    sanitize_for_terminal,
+    STRICT4_PREFIXES,
+    timestamp_pattern,
+)
+
+try:
+    sys.stdin.reconfigure(encoding='utf-8')
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+# 対象 9 prefix（正規化済み basename に対して startswith で判定する）
+# strict-4 の先頭 4 件は _hook_utils.STRICT4_PREFIXES から導出し、二重管理を避ける。
+TARGET_PREFIXES = STRICT4_PREFIXES + (
+    'code-review-report-',
+    'security-review-report-',
+    'test-report-',
+    'debug-analysis-',
+    'debug-needed-',
+)
+
+REPORTS_DIR_NAME = 'reports'
+CLAUDE_DIR_NAME = '.claude'
+PROJECT_DIR_ENV = 'CLAUDE_PROJECT_DIR'
+DISABLE_ENV = 'C3_REPORT_GUARD_DISABLE'
+
+NUL = '\x00'
+
+
+def _match_prefix(norm_basename):
+    """正規化済み basename が対象 9 prefix のどれで始まるかを返す（無ければ None）。"""
+    for prefix in TARGET_PREFIXES:
+        if norm_basename.startswith(prefix):
+            return prefix
+    return None
+
+
+def _is_timestamp_name(basename, prefix):
+    """`{prefix}YYYYMMDD-HHMMSS.md` のフルマッチか。
+
+    _hook_utils.timestamp_pattern() へ委譲。**元の（正規化前の）basename** に対して
+    判定する（report_contract_check.py と統一。prefix 一致は正規化後 basename で行い、
+    形式判定は元の basename で行う分割により、`.MD` 等の大文字混じり拡張子を
+    timestamp 形式として誤許可しない）。
+    """
+    return timestamp_pattern(prefix).fullmatch(basename) is not None
+
+
+def _allowed_roots():
+    """許可 root（root A / root B）の候補パスを返す。
+
+    root B は `CLAUDE_PROJECT_DIR` が非空のときのみ加える。存在確認はここでは行わず、
+    照合側（samefile）に委ねる。
+    """
+    roots = [
+        os.path.join(
+            os.path.realpath(os.getcwd()), CLAUDE_DIR_NAME, REPORTS_DIR_NAME
+        )
+    ]
+    project_dir = os.environ.get(PROJECT_DIR_ENV, '')
+    if project_dir:
+        roots.append(
+            os.path.join(
+                os.path.realpath(project_dir), CLAUDE_DIR_NAME, REPORTS_DIR_NAME
+            )
+        )
+    return roots
+
+
+def _is_contained(target):
+    """target が許可 root 直下に封じ込められているか（二層 AND）。"""
+    # 第 1 層: 名前判定（`.claude/reports/` 直下の形をしているか）。
+    # `..` を含む脱出パスは親の名前が `..` になるためここで落ちる。
+    parent = target.parent
+    if norm_component(parent.name) != REPORTS_DIR_NAME:
+        return False
+    if norm_component(parent.parent.name) != CLAUDE_DIR_NAME:
+        return False
+
+    # 第 2 層: 実体照合（リンク偽装で名前だけ揃えた経路をここで落とす）。
+    resolved_parent = os.path.dirname(os.path.realpath(str(target)))
+    if NUL in resolved_parent:
+        return False
+    for root in _allowed_roots():
+        try:
+            if os.path.samefile(resolved_parent, root):
+                return True
+        except OSError:
+            # root 不在・親不在は「一致しない」として扱う（fail-closed）。
+            continue
+    return False
+
+
+def _block(kind_line, guidance):
+    """違反種別ごとのメッセージを stderr へ出して exit 2 する。"""
+    print(
+        f'[ReportPathGuard BLOCK] {kind_line}\n'
+        f'{guidance}\n'
+        f'恒久 bypass: {DISABLE_ENV}=1 環境変数を設定してください',
+        file=sys.stderr,
+    )
+    sys.exit(2)
+
+
+def _block_containment(display_name):
+    _block(
+        f'封じ込め違反: {display_name} の書き先が許可された reports ディレクトリの外です。',
+        'レポートは .claude/reports/ 直下に作成してください。\n'
+        '書き先パスをその形へ修正し、cwd がプロジェクトルート外なら'
+        'プロジェクトルートへ cd してから再実行してください。',
+    )
+
+
+def _block_overwrite(display_name):
+    _block(
+        f'上書き違反: {display_name} は既存のタイムスタンプ形式レポートです。',
+        '既存レポートの上書きは禁止です。'
+        'report-timestamp skill で新しいタイムスタンプを再採番し、'
+        '別名のファイルとして作成してください。',
+    )
+
+
+def _block_format(display_name, prefix):
+    _block(
+        f'形式違反: {display_name} は {prefix}YYYYMMDD-HHMMSS.md の形式ではありません。',
+        'report-timestamp skill でタイムスタンプを再採番し、'
+        'その値をファイル名に使用してください。',
+    )
+
+
+def main():
+    # bypass: 恒久 disable 環境変数の確認（`1` 以外の値では無効化しない）
+    if os.environ.get(DISABLE_ENV) == '1':
+        sys.exit(0)
+
+    # JSON payload の読み込み（fail-open）
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+    if not isinstance(payload, dict):
+        sys.exit(0)
+
+    # tool_name の確認（Write 以外は対象外）
+    if payload.get('tool_name') != 'Write':
+        sys.exit(0)
+
+    # file_path の抽出（キー欠落・空文字は fail-open）
+    tool_input = payload.get('tool_input')
+    if not isinstance(tool_input, dict):
+        sys.exit(0)
+    file_path = tool_input.get('file_path')
+    if not isinstance(file_path, str) or not file_path:
+        sys.exit(0)
+
+    # 発火条件: 正規化 basename が対象 9 prefix で始まるか。
+    # ここまでは純粋な文字列操作であり、対象外なら一切副作用を出さずに抜ける。
+    raw_basename = os.path.basename(file_path)
+    norm_basename = norm_component(raw_basename)
+    prefix = _match_prefix(norm_basename)
+    if prefix is None:
+        sys.exit(0)
+
+    display_name = sanitize_for_terminal(raw_basename)
+
+    # ここから先はパス判定。例外を誘発する入力は fail-closed で block する。
+    try:
+        if os.path.isabs(file_path):
+            target = Path(file_path)
+        else:
+            target = Path(os.getcwd()) / file_path
+
+        # NUL 混入は realpath / samefile の挙動が環境依存になるため明示 block
+        if NUL in str(target):
+            _block_containment(display_name)
+
+        # 検査 1: 封じ込め
+        if not _is_contained(target):
+            _block_containment(display_name)
+
+        is_timestamp = _is_timestamp_name(raw_basename, prefix)
+
+        # 検査 2: 上書き block（timestamp 形式の既存のみ）
+        if is_timestamp and os.path.exists(str(target)):
+            _block_overwrite(display_name)
+
+        # 検査 3: strict-4 形式 block
+        if prefix in STRICT4_PREFIXES and not is_timestamp:
+            _block_format(display_name, prefix)
+    except (OSError, ValueError):
+        _block_containment(display_name)
+
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()