@takuma-hirai/hirai-method 0.1.0

package/.claude/hooks/tests/test-improvement-proposal.sh

@@ -0,0 +1,284 @@
+#!/usr/bin/env bash
+# test-improvement-proposal.sh — smoke tests for improvement-proposal.sh
+#
+# 検証する仕様:
+#   1. observations 0 件 + state 空 → 何も出力しない、exit 0
+#   2. mock observations: Bash deny 多数 → "Agent 委譲" 系の提案出力
+#   3. mock GateGuard cleared 多数 → "事実材料" 系の提案出力
+#   4. dedup: 24h 以内に同提案出ていたら抑制
+#   5. ECC_IMPROVEMENT_PROPOSAL=off → 全 skip
+#   6. HC_IMPROVEMENT_PROPOSAL_ENABLED=false → 全 skip
+#   7. fail-open: python3 不在等の障害でも exit 0
+#   8. failure-loop active session 検出 → "agent-introspect" 提案出力
+#
+# bash 3.2 互換 (macOS 標準) で動作する。
+
+set -u
+
+HOOKS_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+HOOK="$HOOKS_DIR/improvement-proposal.sh"
+PASS=0
+FAIL=0
+
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+
+# Empty config so config-loader doesn't WARN
+: > "$TMP/empty.yml"
+
+assert_contains() {
+  local name="$1"
+  local needle="$2"
+  local haystack="$3"
+  if [[ "$haystack" == *"$needle"* ]]; then
+    printf "PASS: %s\n" "$name"
+    PASS=$((PASS + 1))
+  else
+    printf "FAIL: %s\n  expected substring: %s\n  got: %s\n" "$name" "$needle" "$haystack"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_not_contains() {
+  local name="$1"
+  local needle="$2"
+  local haystack="$3"
+  if [[ "$haystack" != *"$needle"* ]]; then
+    printf "PASS: %s\n" "$name"
+    PASS=$((PASS + 1))
+  else
+    printf "FAIL: %s\n  unexpected substring: %s\n  got: %s\n" "$name" "$needle" "$haystack"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_eq() {
+  local name="$1"
+  local expected="$2"
+  local actual="$3"
+  if [ "$expected" = "$actual" ]; then
+    printf "PASS: %s\n" "$name"
+    PASS=$((PASS + 1))
+  else
+    printf "FAIL: %s\n  expected: [%s]\n  actual:   [%s]\n" "$name" "$expected" "$actual"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# Helper: run the hook in an isolated PROJECT_DIR with controlled HC_*
+# Args:
+#   $1 = scenario name (used for tmpdir)
+#   $2 = obs records jsonl content (multiline string)
+#   $3 = number of GateGuard .cleared files to drop into HC_GATEGUARD_STATE_DIR
+#   $4 = number of confidence bypass.log lines
+#   $5 = number of failure-window logs with active loop signature
+#   $@ from $6 onward = extra "VAR=val" exports
+run_hook() {
+  local scenario="$1"
+  local obs_content="$2"
+  local gg_count="$3"
+  local cg_count="$4"
+  local fw_count="$5"
+  shift 5
+
+  local proj="$TMP/$scenario"
+  rm -rf "$proj"
+  mkdir -p "$proj/.claude/.gateguard-state"
+  mkdir -p "$proj/.claude/.taskguard-state"
+  mkdir -p "$proj/.claude/.failure-window"
+  mkdir -p "$proj/.claude/.confidence-gate-state"
+  mkdir -p "$proj/.claude/.improvement-proposal-state"
+  mkdir -p "$proj/homunculus"
+
+  # observations.jsonl drop
+  if [ -n "$obs_content" ]; then
+    printf '%s\n' "$obs_content" > "$proj/homunculus/observations.jsonl"
+  fi
+
+  # GateGuard cleared files
+  local i=0
+  while [ "$i" -lt "$gg_count" ]; do
+    : > "$proj/.claude/.gateguard-state/edit-mock${i}.cleared"
+    i=$((i + 1))
+  done
+
+  # confidence bypass.log
+  if [ "$cg_count" -gt 0 ]; then
+    local j=0
+    : > "$proj/.claude/.confidence-gate-state/bypass.log"
+    while [ "$j" -lt "$cg_count" ]; do
+      printf '%s\tbypassed: mock-reason-%d\n' \
+        "${ECC_IMPROVEMENT_PROPOSAL_TEST_NOW:-2026-05-07T00:00:00Z}" "$j" \
+        >> "$proj/.claude/.confidence-gate-state/bypass.log"
+      j=$((j + 1))
+    done
+  fi
+
+  # failure-window active loops
+  local k=0
+  while [ "$k" -lt "$fw_count" ]; do
+    {
+      echo "Bash:fooerror"
+      echo "Bash:fooerror"
+      echo "Bash:fooerror"
+    } > "$proj/.claude/.failure-window/session${k}.log"
+    k=$((k + 1))
+  done
+
+  local extra_env=""
+  for spec in "$@"; do
+    extra_env="$extra_env export $spec;"
+  done
+
+  bash -c "
+    set +u
+    for v in \$(env | grep -oE '^HC_[A-Z_]+' || true); do unset \"\$v\"; done
+    unset ECC_IMPROVEMENT_PROPOSAL
+    export HC_CONFIG_PATH='$TMP/empty.yml'
+    export CLAUDE_PROJECT_DIR='$proj'
+    export HC_HOMUNCULUS_ROOT='$proj/homunculus'
+    export HC_GATEGUARD_STATE_DIR='.claude/.gateguard-state'
+    export HC_TASKGUARD_STATE_DIR='.claude/.taskguard-state'
+    export HC_FAILURE_WINDOW_DIR='.claude/.failure-window'
+    export HC_CONFIDENCE_STATE_DIR='.claude/.confidence-gate-state'
+    export HC_IMPROVEMENT_PROPOSAL_STATE_DIR='.claude/.improvement-proposal-state'
+    export HC_IMPROVEMENT_PROPOSAL_ENABLED=true
+    export HC_IMPROVEMENT_PROPOSAL_LOOKBACK_DAYS=7
+    export HC_IMPROVEMENT_PROPOSAL_MAX_COUNT=3
+    export HC_IMPROVEMENT_PROPOSAL_DEDUP_HOURS=24
+    export ECC_IMPROVEMENT_PROPOSAL_TEST_NOW='${ECC_IMPROVEMENT_PROPOSAL_TEST_NOW:-2026-05-07T12:00:00Z}'
+    $extra_env
+    bash '$HOOK' </dev/null 2>&1
+    echo \"EXIT_CODE=\$?\"
+  "
+}
+
+# === Helper to generate mock observations records ===
+# Args: count, tool, with_perm_deny (1 or 0)
+gen_obs_records() {
+  local count="$1"
+  local tool="$2"
+  local perm_deny="$3"
+  local i=0
+  local out=""
+  while [ "$i" -lt "$count" ]; do
+    local line='{"ts":"2026-05-07T10:00:00Z","event":"PostToolUse","tool":"'"$tool"'","raw":{"hook_event_name":"PostToolUse","tool_name":"'"$tool"'"'
+    if [ "$perm_deny" = "1" ]; then
+      line="$line"',"tool_response":{"is_error":true,"content":"Permission denied: please use Agent","decision":"block"}}}'
+    else
+      line="$line"',"tool_response":{"is_error":false}}}'
+    fi
+    if [ -z "$out" ]; then
+      out="$line"
+    else
+      out="$out"$'\n'"$line"
+    fi
+    i=$((i + 1))
+  done
+  printf '%s' "$out"
+}
+
+# === Case 1: empty obs + empty state -> no output, exit 0 ===
+out=$(run_hook "case1" "" 0 0 0)
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+non_exit_lines=$(printf '%s\n' "$out" | grep -v '^EXIT_CODE=')
+assert_eq "Case1a: empty -> exit 0" "EXIT_CODE=0" "$exit_line"
+assert_eq "Case1b: empty -> no output" "" "$non_exit_lines"
+
+# === Case 2: many Bash perm denials -> Agent 委譲 proposal ===
+obs=$(gen_obs_records 10 "Bash" 1)
+out=$(run_hook "case2" "$obs" 0 0 0)
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+assert_eq "Case2a: bash deny -> exit 0" "EXIT_CODE=0" "$exit_line"
+assert_contains "Case2b: bash deny -> proposal header" "Improvement proposals" "$out"
+assert_contains "Case2c: bash deny -> Agent 委譲 hint" "Agent tool 経由" "$out"
+assert_contains "Case2d: footer present" "block しません" "$out"
+
+# === Case 3: many GateGuard .cleared -> 事実材料 proposal ===
+out=$(run_hook "case3" "" 8 0 0)
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+assert_eq "Case3a: gateguard -> exit 0" "EXIT_CODE=0" "$exit_line"
+assert_contains "Case3b: gateguard -> 事実材料 hint" "事実材料" "$out"
+
+# === Case 4: dedup within DEDUP_HOURS suppresses repeat ===
+# 1st run: produce proposal (uses dedup_state inside the project's .claude)
+out1=$(run_hook "case4" "" 8 0 0)
+# 2nd run with same project dir: should be suppressed
+out2=$(bash -c "
+  set +u
+  for v in \$(env | grep -oE '^HC_[A-Z_]+' || true); do unset \"\$v\"; done
+  unset ECC_IMPROVEMENT_PROPOSAL
+  export HC_CONFIG_PATH='$TMP/empty.yml'
+  export CLAUDE_PROJECT_DIR='$TMP/case4'
+  export HC_HOMUNCULUS_ROOT='$TMP/case4/homunculus'
+  export HC_GATEGUARD_STATE_DIR='.claude/.gateguard-state'
+  export HC_TASKGUARD_STATE_DIR='.claude/.taskguard-state'
+  export HC_FAILURE_WINDOW_DIR='.claude/.failure-window'
+  export HC_CONFIDENCE_STATE_DIR='.claude/.confidence-gate-state'
+  export HC_IMPROVEMENT_PROPOSAL_STATE_DIR='.claude/.improvement-proposal-state'
+  export HC_IMPROVEMENT_PROPOSAL_ENABLED=true
+  export HC_IMPROVEMENT_PROPOSAL_LOOKBACK_DAYS=7
+  export HC_IMPROVEMENT_PROPOSAL_MAX_COUNT=3
+  export HC_IMPROVEMENT_PROPOSAL_DEDUP_HOURS=24
+  export ECC_IMPROVEMENT_PROPOSAL_TEST_NOW='2026-05-07T13:00:00Z'
+  bash '$HOOK' </dev/null 2>&1
+  echo \"EXIT_CODE=\$?\"
+")
+exit_line=$(printf '%s\n' "$out2" | grep '^EXIT_CODE=' | tail -1)
+non_exit_lines=$(printf '%s\n' "$out2" | grep -v '^EXIT_CODE=')
+assert_contains "Case4a: 1st run shows proposal" "Improvement proposals" "$out1"
+assert_eq "Case4b: 2nd run within dedup -> exit 0" "EXIT_CODE=0" "$exit_line"
+assert_eq "Case4c: 2nd run within dedup -> no output" "" "$non_exit_lines"
+
+# === Case 5: ECC_IMPROVEMENT_PROPOSAL=off -> all skip ===
+out=$(run_hook "case5" "$(gen_obs_records 10 Bash 1)" 8 0 0 "ECC_IMPROVEMENT_PROPOSAL=off")
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+non_exit_lines=$(printf '%s\n' "$out" | grep -v '^EXIT_CODE=')
+assert_eq "Case5a: ECC kill switch -> exit 0" "EXIT_CODE=0" "$exit_line"
+assert_eq "Case5b: ECC kill switch -> no output" "" "$non_exit_lines"
+
+# === Case 6: HC_IMPROVEMENT_PROPOSAL_ENABLED=false -> all skip ===
+out=$(run_hook "case6" "$(gen_obs_records 10 Bash 1)" 8 0 0 "HC_IMPROVEMENT_PROPOSAL_ENABLED=false")
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+non_exit_lines=$(printf '%s\n' "$out" | grep -v '^EXIT_CODE=')
+assert_eq "Case6a: HC kill switch -> exit 0" "EXIT_CODE=0" "$exit_line"
+assert_eq "Case6b: HC kill switch -> no output" "" "$non_exit_lines"
+
+# === Case 7: fail-open without python3 -> exit 0 silently ===
+# Strip dirs containing python3 from PATH so `command -v python3` fails.
+# We DO keep system bins (/bin /usr/bin) so bash/grep/cat work.
+strip_python_path() {
+  local p clean=""
+  local OLDIFS="$IFS"
+  IFS=':'
+  for p in $PATH; do
+    [ -z "$p" ] && continue
+    [ -x "$p/python3" ] && continue
+    if [ -z "$clean" ]; then clean="$p"; else clean="$clean:$p"; fi
+  done
+  IFS="$OLDIFS"
+  printf '%s' "$clean"
+}
+clean_path=$(strip_python_path)
+proj7="$TMP/case7"
+mkdir -p "$proj7"
+out=$(PATH="$clean_path" bash -c "
+  set +u
+  for v in \$(env | grep -oE '^HC_[A-Z_]+' 2>/dev/null || true); do unset \"\$v\"; done
+  unset ECC_IMPROVEMENT_PROPOSAL
+  export HC_CONFIG_PATH='$TMP/empty.yml'
+  export CLAUDE_PROJECT_DIR='$proj7'
+  bash '$HOOK' </dev/null 2>&1
+  echo \"EXIT_CODE=\$?\"
+")
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+assert_eq "Case7: no python3 -> exit 0 (fail-open)" "EXIT_CODE=0" "$exit_line"
+
+# === Case 8: failure-window active loop -> agent-introspect proposal ===
+out=$(run_hook "case8" "" 0 0 1)
+assert_contains "Case8a: failure-loop -> agent-introspect hint" "agent-introspect" "$out"
+exit_line=$(printf '%s\n' "$out" | grep '^EXIT_CODE=' | tail -1)
+assert_eq "Case8b: failure-loop -> exit 0" "EXIT_CODE=0" "$exit_line"
+
+printf "\n--- test-improvement-proposal.sh: %d pass / %d fail ---\n" "$PASS" "$FAIL"
+[ "$FAIL" -eq 0 ]

package/.claude/hooks/tool-call-slip-detector.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+# tool-call-slip-detector.sh — Stop hook
+#
+# 役割:
+#   AI 最終 assistant message の本文 (.text) に「tool-call markup slip の痕跡」
+#   が残っている場合、tool 呼び出しが serialize 失敗し本文 text 化したと判定し、
+#   top-level `{"decision":"block","reason":"..."}` を出力して AI を停止させず
+#   次 turn に是正 context を注入する。
+#
+#   markup slip とは: `antml:invoke` の構造化出力が生成中に部分破綻し、囲みタグ
+#   (`<invoke>`) が落ちて中身 (`call` トークン / bare command / `<parameter ...>`
+#   断片) が assistant message の .text に流れ込む現象。tool は実行されないまま
+#   turn 終了 → 気づかず同じ batch を再 emit → 無限ループに見える
+#   (user には「途中で止まった / 動いていない」)。
+#   実証: transcript dc60eacc (2026-06-01 task-69 session) で直近 400 行に
+#   standalone `call` 12+ 回 + `<parameter name="description">...` の text 漏れを観測。
+#
+# 検出の根拠 (なぜ .text を見れば分かるか):
+#   成功した tool_use ブロックは `.type=="tool_use"` の構造化要素で .text を持たない
+#   ため last_assistant (= .text の join) には混入しない。slip した残骸のみが .text
+#   に現れる。よって .text に slip 痕跡があれば「直前 tool 呼び出しが失敗」と確定できる。
+#
+# 設計起源:
+#   docs/draft/tool-call-slip-detector-hook.md (approved_by: user, 2026-06-01)
+#   memory feedback_multi_tool_block_serialization_failure (arity × payload 複雑度
+#   閾値超過で構造化出力が壊れる) の機械的セーフティネット。
+#   PreToolUse では捕捉不能 (slip は生成中 = parse 前に起きるため hook が発火しない)。
+#   唯一効くレバー = 「user が気づいて指摘」を「Stop hook が自動検出し次 turn 自己是正」
+#   に置換する。同型先例 loop-confirmation-detector.sh (task-41) の構造を踏襲。
+#
+# 発火 timing:
+#   Stop hook (AI 最終 assistant message 完了時)
+#
+# 動作概要:
+#   1. stdin JSON から transcript_path 抽出 (jq 不在 / 不在 path で fail-open)
+#   2. bypass env 判定
+#   3. transcript 末尾から最後の assistant .text を抽出
+#   4. fenced code block (``` 囲み) を除去 (bug の meta 議論で markup を引用しても
+#      誤検出しないため — slip は fence の外、引用は fence の中)
+#   5. slip 痕跡 regex で照合:
+#      - standalone `call` 行 (broken invoke wrapper の残渣、最高 signal)
+#      - leaked markup 断片 (`<parameter name=` / `<invoke name=` / `</invoke>`
+#        / `function_calls>`)
+#   6. 検出時: bypass.log に VIOLATION 記録 + `{"decision":"block","reason":"..."}`
+#   7. 検出なしなら silent exit 0
+#
+# mode について:
+#   markup slip は Normal / Loop 両モードで起きる (mode 非依存) ため、
+#   loop-confirmation-detector と異なり mode gate しない (常時作動)。
+#
+# 環境変数:
+#   HC_FEATURE_TOOL_CALL_SLIP_DETECT_ENABLED=false  ... feature toggle OFF (yml 経由集中管理)
+#   ECC_TOOL_CALL_SLIP_OFF=1                        ... 一時 OFF (1 セッション)
+#   HC_TOOL_CALL_SLIP_DETECTION_ENABLED=false       ... config レベル無効化
+#
+# 失敗時の挙動:
+#   - exit 0 のみ (fail-open)。jq 不在 / transcript 不在 / parse 失敗 → silent skip。
+#   - Stop hook の `decision:"block"` は「AI を停止させず reason を次 turn に注入」の
+#     意味 (通常の PreToolUse block と semantics 反転)。
+#
+# bash flags の方針 (CLAUDE.md Critical Lessons HIGH 準拠):
+#   file-top に `set -euo pipefail` を **書かない** (caller への leak / SIGPIPE 死防止)。
+
+set -uo pipefail  # errexit は外し、unset + pipefail のみ
+
+# stdin を必ず保持 (pipeline 詰まり防止)
+input=$(cat 2>/dev/null || true)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# --- bypass-logger.sh (best-effort) ---
+# shellcheck source=lib/bypass-logger.sh
+if [ -f "$SCRIPT_DIR/lib/bypass-logger.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/bypass-logger.sh" 2>/dev/null || true
+fi
+
+# --- config-loader.sh (best-effort、HC_* env 解決) ---
+# shellcheck source=lib/config-loader.sh
+if [ -f "$SCRIPT_DIR/lib/config-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+fi
+
+# --- feature toggle (paired 実装、yml feature_tool_call_slip_detect_enabled) ---
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled tool_call_slip_detect; then
+  exit 0
+fi
+
+# --- bypass 判定 ---
+if [ "${ECC_TOOL_CALL_SLIP_OFF:-0}" = "1" ]; then
+  if command -v log_bypass >/dev/null 2>&1; then
+    log_bypass "tool-call-slip-detector" "ECC_TOOL_CALL_SLIP_OFF" "${ECC_BYPASS_REASON:-(not provided)}"
+  fi
+  exit 0
+fi
+
+if [ "${HC_TOOL_CALL_SLIP_DETECTION_ENABLED:-true}" = "false" ]; then
+  if command -v log_bypass >/dev/null 2>&1; then
+    log_bypass "tool-call-slip-detector" "HC_TOOL_CALL_SLIP_DETECTION_ENABLED" "config-disabled"
+  fi
+  exit 0
+fi
+
+# --- 依存チェック (jq 不在で fail-open) ---
+if ! command -v jq >/dev/null 2>&1; then
+  exit 0
+fi
+
+# --- transcript_path 抽出 ---
+transcript_path=$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
+
+if [ -z "$transcript_path" ] || [ ! -f "$transcript_path" ]; then
+  exit 0
+fi
+
+# システム機密 path への traversal を拒否
+case "$transcript_path" in
+  /etc/*|/usr/*|/bin/*|/sbin/*|/sys/*|/proc/*|/var/log/*|/dev/*)
+    exit 0 ;;
+esac
+
+# --- 直前 assistant text 抽出 (末尾 50 行、loop-confirmation-detector と同戦略) ---
+last_assistant=$(tail -n 50 "$transcript_path" 2>/dev/null | jq -rs '
+  [
+    .[]
+    | select(
+        ((.type // "") == "assistant")
+        or ((.role // "") == "assistant")
+        or (((.message // {}).role // "") == "assistant")
+      )
+    | (
+        ((.message // .).content)
+        | if type == "array" then
+            [ .[] | (.text // "") ] | join("\n")
+          elif type == "string" then .
+          else "" end
+      )
+  ]
+  | last // ""
+' 2>/dev/null)
+
+if [ -z "$last_assistant" ]; then
+  exit 0
+fi
+
+# --- fenced code block (``` 囲み) を除去 ---
+# bug の meta 議論で markup を引用 (常に fence 内) しても誤検出しないため。
+# slip 残渣は prose 中 = fence の外に出るので、fence 内を捨てても検出は失われない。
+stripped=$(printf '%s\n' "$last_assistant" | awk '
+  /^[[:space:]]*```/ { infence = !infence; next }
+  infence { next }
+  { print }
+')
+
+# --- slip 痕跡 regex ---
+# (1) standalone `call` 行: broken invoke wrapper の最高 signal。
+#     前後 whitespace のみ許容、それ単独行のみ (文中の "call" 単語は match しない)。
+# (2) leaked markup 断片: invoke 囲みが落ちて parameter / invoke タグだけ漏れた形。
+SLIP_REGEX='(^[[:space:]]*call[[:space:]]*$)|(<parameter[[:space:]]+name=)|(<invoke[[:space:]]+name=)|(</invoke>)|(function_calls>)'
+
+if ! printf '%s' "$stripped" | grep -Eq "$SLIP_REGEX" 2>/dev/null; then
+  # slip 痕跡なし → silent exit 0
+  exit 0
+fi
+
+# --- 検出: bypass.log 記録 + reason 注入 ---
+if command -v log_bypass >/dev/null 2>&1; then
+  log_bypass "tool-call-slip-detector" "VIOLATION" "markup-slip-detected"
+fi
+
+warn_message=$(cat <<'EOF'
+[tool-call-slip-detector] 直前の tool 呼び出しが serialize 失敗 (markup slip) し、command が本文 text 化して実行されませんでした。同じ batch を retry してはいけません (同じく失敗しループします)。次の手順で出し直してください: (1) tool 呼び出しは 1 ターンに 1 件のシンプルな形で再発行する。(2) 検証用の複雑な複合 command (複数 echo/grep の連結・grep の alternation・多数 quote/pipe/日本語混在) を inline で組まない — 既存/専用の smoke script を 1 コマンドで実行するか、目的ごとに 1 command へ分割する。(3) subagent fan-out が 3 件以上なら Workflow ツールを使う。手書きは 1 ターン 1-2 件まで、長 prompt は file 経由。(4) tool 呼び出しの前に `call` 等の前置き語を書かない。詳細: memory feedback_multi_tool_block_serialization_failure + .claude/rules/development-process.md §「多数 fan-out の Workflow 標準化 + 1 ターン tool block 上限」。
+EOF
+)
+
+if printf '%s' "$warn_message" | jq -Rsc '{
+  decision: "block",
+  reason: .
+}' 2>/dev/null; then
+  :
+else
+  cat <<'FALLBACK'
+{"decision":"block","reason":"[tool-call-slip-detector] 直前の tool 呼び出しが serialize 失敗 (markup slip) し本文 text 化しました。同 batch を retry せず、1 ターン 1 件のシンプルな tool 呼び出しで出し直してください。複雑な検証 command は分割 or 専用 smoke script を実行。詳細: .claude/rules/development-process.md §多数 fan-out。"}
+FALLBACK
+fi
+
+exit 0

package/.claude/hooks/user-prompt-submit-dispatcher.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# user-prompt-submit-dispatcher.sh — task-71 Step 4-6 dispatcher (thin wrapper)
+# 実行 script (sourced lib ではない) → set -uo pipefail は OK (errexit 外す)。
+# event 名は固定 literal で run_dispatch に渡す。matcher は $1 (matcher 無し event は空)。
+set -uo pipefail
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/dispatcher-core.sh
+source "$DIR/lib/dispatcher-core.sh"
+run_dispatch "UserPromptSubmit" "${1:-}"

package/.claude/hooks/why-x5-reminder.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# why-x5-reminder.sh — SessionStart wrapper child (session-start-wrapper.sh DEFAULT_HOOKS)
+#
+# session 開始時に 1 度、「何のために何をやるのか」を **1 行** で出すルールの compact pointer を
+# <system-reminder> として提示する (advisory)。
+# v11 (2026-06-01, task-68 §3.3) — 「ターン冒頭 1 回」規範。
+# task-73 案 B: full 説明を 1-2 行 pointer へ短縮。本 rule 全文は frontmatter-less 常時参照として
+#   毎ターン context に load 済のため、ターン冒頭 1 行の遵守は in-context rule に基づく。
+#
+# 環境変数:
+#   HC_WHY_X5_DISABLE=1  ... 一時無効化（雑談セッション等で off にする）
+#
+# 失敗時の挙動:
+#   - exit 0 のみ。失敗してもセッションをブロックしない。
+
+set -uo pipefail  # task-22 W1: errexit 外し SIGPIPE 141 サイレント死を防止 (CLAUDE.md Critical Lessons HIGH)
+
+# config-loader.sh source (is_feature_enabled 関数取得用、task-45 Phase 2)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/lib/config-loader.sh" ]; then
+  # shellcheck source=lib/config-loader.sh
+  source "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+fi
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled why_x5_enforcement; then
+  exit 0   # feature OFF で no-op
+fi
+
+# stdin を必ず消費（消費しないと caller が pipe block する可能性がある）
+cat > /dev/null 2>&1 || true
+
+# 環境変数で無効化されている場合は何も出さない
+if [ "${HC_WHY_X5_DISABLE:-0}" = "1" ]; then
+  exit 0
+fi
+
+# task-73 案 B: 1-2 行 pointer 短縮 (full rule 本文は in-context)
+cat <<'EOF'
+<system-reminder>
+why-x5: 各ターン冒頭に1行「<何のため>のため<何をやる>を行う」(目的×作業)。詳細 .claude/rules/why-x5-output.md
+</system-reminder>
+EOF
+
+exit 0

package/.claude/hooks/why-x5-violation-detect.sh

@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+# why-x5-violation-detect.sh — PostToolUse hook
+#
+# 役割:
+#   AI 直前応答 (transcript 末尾) を grep し、Why × 5 v10 format 違反 (4 セクション
+#   format / 「【システムの存在意義】」「【whyN】」等の v9 残骸 / 「何のため」省略)
+#   を検出した場合のみ、`<system-reminder>` で v10 1 行 format を再注入する。
+#   違反未検出時は silent (exit 0)。
+#
+# 設計の根本変更 (task-21 W0.3, 2026-05-23):
+#   旧 why-x5-reminder.sh は UserPromptSubmit で毎ターン全文 (~2 KB) 注入していたが、
+#   AI は 1 度読めば理解しているため過剰だった。
+#   本 hook が「実際に違反した時のみ」再注入することで attention dilution を解消。
+#
+# 簡略実装 (初期版):
+#   transcript の末尾 50 行から最後の assistant text を抽出し、以下を grep:
+#     - v9 残骸: "【システムの存在意義】" / "【whyN】" / "【現在行っていること】" / "【他の選択肢を取らない理由】"
+#   検出時は <system-reminder> 出力、未検出時は silent。
+#   将来精度向上の余地: 「何のため」省略の構文解析、装飾行 (見出し / 表) 検出など。
+#
+# 環境変数:
+#   HC_WHY_X5_VIOLATION_ENABLED=false   ... 無効化
+#
+# 失敗時の挙動:
+#   - exit 0 のみ。failure は fail-open。
+#
+# 設計起源:
+#   docs/draft/system-reminder-attention-fix.md §2 W0.3
+#   docs/tasks/task-21-system-reminder-attention-fix.md W0.3
+#
+# 共有 feature toggle group:
+#   - グループ制御 toggle: `feature_why_x5_enforcement_enabled` (default: true)
+#   - OFF にすると本 hook を含む同 group の全 hook が no-op
+#   - 編集: `bash .claude/scripts/hc-config.sh --feature why_x5_enforcement=false`
+#   - 同 group の他 hook: why-x5-reminder.sh
+
+set -u
+
+# config 読み込み (HC_* 変数 + is_feature_enabled 関数 export、task-45 Phase 2)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/config-loader.sh
+. "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled why_x5_enforcement; then
+  echo '{}'
+  exit 0   # feature OFF で no-op (PostToolUse hook response 規約: empty JSON)
+fi
+
+# stdin を必ず消費
+input=$(cat 2>/dev/null || true)
+
+# --- 早期 bypass ---
+if [ "${HC_WHY_X5_VIOLATION_ENABLED:-true}" = "false" ]; then
+  exit 0
+fi
+
+if [ "${HC_WHY_X5_DISABLE:-0}" = "1" ]; then
+  exit 0
+fi
+
+# --- 依存チェック ---
+if ! command -v jq >/dev/null 2>&1; then
+  exit 0
+fi
+
+# --- transcript_path 抽出 ---
+transcript_path=$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
+
+if [ -z "$transcript_path" ] || [ ! -f "$transcript_path" ]; then
+  exit 0
+fi
+
+# --- 直前 assistant text 抽出 (末尾 50 行) ---
+last_assistant=$(tail -n 50 "$transcript_path" 2>/dev/null | jq -rs '
+  [
+    .[]
+    | select(
+        ((.type // "") == "assistant")
+        or ((.role // "") == "assistant")
+        or (((.message // {}).role // "") == "assistant")
+      )
+    | (
+        ((.message // .).content)
+        | if type == "array" then
+            [ .[] | (.text // "") ] | join("\n")
+          elif type == "string" then .
+          else "" end
+      )
+  ]
+  | last // ""
+' 2>/dev/null)
+
+if [ -z "$last_assistant" ]; then
+  exit 0
+fi
+
+# --- v9 4 セクション format 残骸検出 ---
+# default パターン (env override 可、改行区切り)
+DEFAULT_PATTERNS='【システムの存在意義】
+【whyN】
+【現在行っていること】
+【他の選択肢を取らない理由】
+【why1】
+【why2】
+【why3】'
+
+PATTERNS="${HC_WHY_X5_VIOLATION_PATTERNS:-$DEFAULT_PATTERNS}"
+
+matched=""
+while IFS= read -r pat; do
+  if [ -n "$pat" ] && printf '%s' "$last_assistant" | grep -qF "$pat"; then
+    matched="$pat"
+    break
+  fi
+done <<< "$PATTERNS"
+
+if [ -z "$matched" ]; then
+  exit 0
+fi
+
+# --- system-reminder 注入 ---
+cat <<EOF
+<system-reminder>
+**Why × 5 v10 format 違反検出 (why-x5-violation-detect)**
+
+直前応答に v9 残骸 (4 セクション format) が含まれています:
+  matched pattern: \`${matched}\`
+
+v10 format (2026-05-23 確定、\`.claude/rules/why-x5-output.md\`):
+
+  「<何のため (目的)> のため、<何をやる (今のステップ / tool / file)> を行う」
+
+要件:
+- ステップごとに **1 行** (ツール呼び出し前 / 別ステップ移行時 / 別 file 編集時)
+- 4 セクション format (システム意義 / whyN / 現在の作業 / 他選択肢) は **v10 で廃止**
+- 装飾 (見出し / 表 / 矢印列挙) は禁止、純粋な 1 行のみ
+- 「何のため」と「何をやる」の **両方** が含まれる
+
+OK 例:
+- 「install.sh を smoke test するため、tmp dir に実 install を実行する」
+- 「規範を v10 化するため、why-x5-output.md を全文書き換える」
+
+次の作業ステップから v10 1 行 format で出力してください。
+
+**bypass**:
+- \`HC_WHY_X5_VIOLATION_ENABLED=false\` で本検出 OFF
+- \`HC_WHY_X5_DISABLE=1\` で Why × 5 規範全体 OFF (雑談セッション等)
+</system-reminder>
+EOF
+
+exit 0