@takuma-hirai/hirai-method 0.1.0

package/.claude/tests/hook-cwd-robustness-smoke.sh

@@ -0,0 +1,206 @@
+#!/usr/bin/env bash
+# hook-cwd-robustness-smoke.sh — task-71 Step 8 S-B
+#
+# 目的:
+#   repo root 以外の cwd から dispatcher を実行しても正常に動作することを実証する。
+#   resolve_project_root の fallback 機構 (HC_PROJECT_ROOT env / git rev-parse / CLAUDE_PROJECT_DIR)
+#   が cwd 非依存で機能することを確認する。
+#
+# ケース:
+#   SB-1: mktemp -d の cwd (repo root 以外) から dispatcher を実行 → CLAUDE_PROJECT_DIR なし、HC_PROJECT_ROOT あり
+#   SB-2: mktemp -d の cwd + CLAUDE_PROJECT_DIR=<root> で実行 (CLAUDE_PROJECT_DIR fallback 実証)
+#   SB-3: CLAUDE_PROJECT_DIR unset + HC_PROJECT_ROOT unset、git rev-parse で解決 (cwd=repo subdir から)
+#   SB-4: 非 repo dir cwd + HC_PROJECT_ROOT で解決 → blocker 判定が repo root 基準で正常
+#
+# bash 3.2 互換 (macOS)。
+# 規約: file-top set -u + case 別 ( set -uo pipefail ) + run_case。
+
+set -u
+
+# --- root 解決 ---
+_resolve_root() (
+  set -uo pipefail
+  if [ -n "${HC_PROJECT_ROOT:-}" ] && [ -d "${HC_PROJECT_ROOT}" ]; then
+    printf '%s' "${HC_PROJECT_ROOT}"; return 0
+  fi
+  local _sdir
+  _sdir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  if command -v git >/dev/null 2>&1; then
+    local r
+    r=$(git -C "$_sdir" rev-parse --show-toplevel 2>/dev/null)
+    [ -n "$r" ] && [ -d "$r" ] && { printf '%s' "$r"; return 0; }
+  fi
+  if command -v git >/dev/null 2>&1; then
+    local r2
+    r2=$(git rev-parse --show-toplevel 2>/dev/null)
+    [ -n "$r2" ] && [ -d "$r2" ] && { printf '%s' "$r2"; return 0; }
+  fi
+  pwd
+)
+
+ROOT="$(_resolve_root)"
+DISPATCHER="${ROOT}/.claude/hooks/pre-tool-use-dispatcher.sh"
+
+TMPBASE="$(mktemp -d "${TMPDIR:-/tmp}/cwd-robustness-smoke.XXXXXX")"
+trap 'rm -rf "$TMPBASE"' EXIT
+
+PASS=0
+FAIL=0
+
+ok() { PASS=$((PASS+1)); printf '  PASS: %s\n' "$1"; }
+bad() { FAIL=$((FAIL+1)); printf '  FAIL: %s\n' "$1"; }
+
+_has_block() {
+  printf '%s' "$1" | grep -q '"decision"[[:space:]]*:[[:space:]]*"block"' && printf 'yes' || printf 'no'
+}
+
+# --- SB-1: 非 repo cwd + HC_PROJECT_ROOT → blocker 判定が正常 ---
+run_sb1() ( set -uo pipefail
+  local unrelated_dir
+  unrelated_dir="$(mktemp -d "${TMPBASE}/unrelated-cwd.XXXXXX")"
+  local marker_dir
+  marker_dir="$(mktemp -d "${TMPBASE}/marker-sb1.XXXXXX")"
+  # src/x.ts は delegation-guard が block するはずのパス
+  INPUT=$(python3 -c "
+import json,sys
+print(json.dumps({'tool_name':'Edit','tool_input':{'file_path':sys.argv[1]+'/src/x.ts'}}))
+" "${ROOT}")
+  local out rc=0
+  # cd して unrelated dir から dispatcher を実行
+  out=$(
+    cd "$unrelated_dir"
+    printf '%s' "$INPUT" | \
+      HC_PROJECT_ROOT="${ROOT}" \
+      HC_FEATURE_DELEGATION_GUARD_ENABLED=true \
+      HC_AGENT_MARKER_DIR="${marker_dir}" \
+      bash "$DISPATCHER" "Edit|Write" 2>/dev/null
+  ) || rc=$?
+  printf '%s\n%s\n' "$rc" "$(_has_block "$out")" > "${TMPBASE}/result-sb1"
+)
+
+# --- SB-2: 非 repo cwd + CLAUDE_PROJECT_DIR → fallback で root 解決 ---
+run_sb2() ( set -uo pipefail
+  local unrelated_dir
+  unrelated_dir="$(mktemp -d "${TMPBASE}/unrelated-cwd2.XXXXXX")"
+  local marker_dir
+  marker_dir="$(mktemp -d "${TMPBASE}/marker-sb2.XXXXXX")"
+  INPUT=$(python3 -c "
+import json,sys
+print(json.dumps({'tool_name':'Edit','tool_input':{'file_path':sys.argv[1]+'/src/x.ts'}}))
+" "${ROOT}")
+  local out rc=0
+  # CLAUDE_PROJECT_DIR fallback (HC_PROJECT_ROOT unset)
+  out=$(
+    cd "$unrelated_dir"
+    unset HC_PROJECT_ROOT
+    printf '%s' "$INPUT" | \
+      CLAUDE_PROJECT_DIR="${ROOT}" \
+      HC_FEATURE_DELEGATION_GUARD_ENABLED=true \
+      HC_AGENT_MARKER_DIR="${marker_dir}" \
+      bash "$DISPATCHER" "Edit|Write" 2>/dev/null
+  ) || rc=$?
+  printf '%s\n%s\n' "$rc" "$(_has_block "$out")" > "${TMPBASE}/result-sb2"
+)
+
+# --- SB-3: git subdir cwd → git rev-parse が root を解決 ---
+run_sb3() ( set -uo pipefail
+  # repo 内の .claude/hooks subdir から実行 → git がある場合は rev-parse で root 解決
+  local subdir="${ROOT}/.claude/hooks"
+  local marker_dir
+  marker_dir="$(mktemp -d "${TMPBASE}/marker-sb3.XXXXXX")"
+  INPUT=$(python3 -c "
+import json,sys
+print(json.dumps({'tool_name':'Edit','tool_input':{'file_path':sys.argv[1]+'/src/x.ts'}}))
+" "${ROOT}")
+  local out rc=0
+  out=$(
+    cd "$subdir"
+    unset HC_PROJECT_ROOT
+    unset CLAUDE_PROJECT_DIR 2>/dev/null || true
+    printf '%s' "$INPUT" | \
+      HC_FEATURE_DELEGATION_GUARD_ENABLED=true \
+      HC_AGENT_MARKER_DIR="${marker_dir}" \
+      bash "$DISPATCHER" "Edit|Write" 2>/dev/null
+  ) || rc=$?
+  printf '%s\n%s\n' "$rc" "$(_has_block "$out")" > "${TMPBASE}/result-sb3"
+)
+
+# --- SB-4: 非 repo cwd + stop-dispatcher (exit2 channel) → exit code 正常伝播 ---
+run_sb4() ( set -uo pipefail
+  local unrelated_dir
+  unrelated_dir="$(mktemp -d "${TMPBASE}/unrelated-cwd4.XXXXXX")"
+  # byproduct-discharge-guard via stop-dispatcher から、非 repo cwd で exit 2 が出るか
+  local tmp_bd
+  tmp_bd="$(mktemp -d "${TMPBASE}/bd-sb4.XXXXXX")"
+  mkdir -p "${tmp_bd}/docs/tasks" "${tmp_bd}/.claude"
+  ln -s "${ROOT}/.claude/hooks" "${tmp_bd}/.claude/hooks"
+  ln -s "${ROOT}/.claude/harness-config.yml" "${tmp_bd}/.claude/harness-config.yml"
+  cp "${ROOT}/.claude/tests/fixtures/next-actions/case-with-red.md" \
+     "${tmp_bd}/docs/tasks/next-actions.md"
+  local rc=0
+  (
+    cd "$unrelated_dir"
+    echo '{}' | \
+      HC_PROJECT_ROOT="${ROOT}" \
+      HC_FEATURE_BYPRODUCT_DISCHARGE_ENABLED=true \
+      CLAUDE_PROJECT_DIR="${tmp_bd}" \
+      bash "${ROOT}/.claude/hooks/stop-dispatcher.sh" >/dev/null 2>&1
+  ) || rc=$?
+  printf '%s\nno\n' "$rc" > "${TMPBASE}/result-sb4"
+)
+
+_read_result() {
+  local f="${TMPBASE}/result-$1"
+  if [ -f "$f" ]; then
+    printf '%s %s' "$(head -1 "$f" | tr -d '[:space:]')" "$(tail -1 "$f" | tr -d '[:space:]')"
+  else
+    printf 'ERR ERR'
+  fi
+}
+
+# ------------------------------------------------------------------
+printf "=== S-B: hook-cwd-robustness-smoke ===\n\n"
+
+printf "SB-1: non-repo cwd + HC_PROJECT_ROOT → delegation-guard block\n"
+run_sb1
+read -r sb1_rc sb1_block <<< "$(_read_result sb1)"
+if [ "$sb1_rc" = "0" ] && [ "$sb1_block" = "yes" ]; then
+  ok "SB-1 HC_PROJECT_ROOT fallback: rc=0, block=yes"
+else
+  bad "SB-1 HC_PROJECT_ROOT fallback: rc=${sb1_rc} (want 0), block=${sb1_block} (want yes)"
+fi
+
+printf "SB-2: non-repo cwd + CLAUDE_PROJECT_DIR (unset HC_PROJECT_ROOT) → block\n"
+run_sb2
+read -r sb2_rc sb2_block <<< "$(_read_result sb2)"
+if [ "$sb2_rc" = "0" ] && [ "$sb2_block" = "yes" ]; then
+  ok "SB-2 CLAUDE_PROJECT_DIR fallback: rc=0, block=yes"
+else
+  bad "SB-2 CLAUDE_PROJECT_DIR fallback: rc=${sb2_rc} (want 0), block=${sb2_block} (want yes)"
+fi
+
+printf "SB-3: repo subdir cwd + git rev-parse → block\n"
+run_sb3
+read -r sb3_rc sb3_block <<< "$(_read_result sb3)"
+if [ "$sb3_rc" = "0" ] && [ "$sb3_block" = "yes" ]; then
+  ok "SB-3 git rev-parse fallback: rc=0, block=yes"
+else
+  bad "SB-3 git rev-parse fallback: rc=${sb3_rc} (want 0), block=${sb3_block} (want yes)"
+fi
+
+printf "SB-4: non-repo cwd + stop-dispatcher exit2 propagation\n"
+run_sb4
+read -r sb4_rc sb4_block <<< "$(_read_result sb4)"
+if [ "$sb4_rc" = "2" ]; then
+  ok "SB-4 cwd-agnostic stop-dispatcher: rc=2 (exit2 propagated)"
+else
+  bad "SB-4 cwd-agnostic stop-dispatcher: rc=${sb4_rc} (want 2)"
+fi
+
+# ------------------------------------------------------------------
+TOTAL=$((PASS + FAIL))
+printf "\n===== S-B Result =====\n"
+printf "PASS: %d / %d\n" "$PASS" "$TOTAL"
+printf "FAIL: %d / %d\n" "$FAIL" "$TOTAL"
+[ "$FAIL" -gt 0 ] && exit 1
+exit 0

package/.claude/tests/hook-frequency-tweaks-smoke.sh

@@ -0,0 +1,312 @@
+#!/usr/bin/env bash
+# hook-frequency-tweaks-smoke.sh — task-21 W1.4/W1.5/W1.6 cross-cutting smoke
+#
+# 目的:
+#   Wave 1.4 / 1.5 / 1.6 で導入した 3 hook の頻度間引きを cross-cut 検証する。
+#   既存 smoke (context-budget-smoke / next-actions-hooks-smoke /
+#   session-help-surface-smoke) との重複を避け、attention dilution 削減効果が
+#   実測されることに focus する。
+#
+# 起源: docs/draft/system-reminder-attention-fix.md W1.4-1.6
+#
+# テストケース (8 件):
+#   1. context-budget: 30% (低 ratio) で完全 silent
+#   2. context-budget: 60% で fire (kill switch 通過)
+#   3. context-budget: SILENT_BELOW_THRESHOLD=false で debug 出力 (stderr)
+#   4. next-actions-surface: 🔴 あり → fire (default RED_ONLY=true)
+#   5. next-actions-surface: 🟡 のみ → silent (W1.5 frequency filter)
+#   6. next-actions-surface: 🟡 のみ + RED_ONLY=false → 旧挙動 fire (env override)
+#   7. session-help-surface: 初回 (marker 未存在) → 表示
+#   8. session-help-surface: 2 回目 (marker 既存) → silent + FORCE=1 で revive
+#
+# 重要制約:
+#   - set -e は使わない (mode-loader.sh の CB-verify 教訓 - 5846925)
+#   - 各 case は per-case tmp state で隔離 (順序依存排除)
+#
+# 実行:
+#   bash .claude/tests/hook-frequency-tweaks-smoke.sh
+#
+# 終了コード:
+#   0 = 全 case PASS / 1 = 1 件以上 FAIL
+
+set -u
+
+cd "$(cd "$(dirname "$0")/../.." && pwd)" || exit 1
+REPO_ROOT="$(pwd)"
+
+CB_HOOK="${REPO_ROOT}/.claude/hooks/context-budget.sh"
+NAS_HOOK="${REPO_ROOT}/.claude/hooks/next-actions-surface.sh"
+SHS_HOOK="${REPO_ROOT}/.claude/hooks/session-help-surface.sh"
+FIXTURES_CB="${REPO_ROOT}/.claude/tests/fixtures"
+FIXTURES_NA="${REPO_ROOT}/.claude/tests/fixtures/next-actions"
+
+TMP_BASE="$(mktemp -d /tmp/hook-frequency-tweaks-smoke.XXXXXX)"
+trap 'rm -rf "$TMP_BASE"' EXIT
+
+PASS=0
+FAIL=0
+FAILED=()
+
+# helper: record result
+_check() {
+  local label="$1" actual_result="$2"
+  if [ "$actual_result" = "0" ]; then
+    printf '  PASS  %s\n' "$label"
+    PASS=$((PASS+1))
+  else
+    printf '  FAIL  %s\n' "$label"
+    FAIL=$((FAIL+1))
+    FAILED+=("$label")
+  fi
+}
+
+# helper: create a per-case tmp project root with hooks/lib symlinked
+_make_tmp_root() {
+  local case_id="$1"
+  local root="$TMP_BASE/root-$case_id"
+  mkdir -p "$root/.claude"
+  ln -s "${REPO_ROOT}/.claude/hooks" "$root/.claude/hooks"
+  mkdir -p "$root/docs/tasks"
+  printf '%s' "$root"
+}
+
+# helper: stub the transcript_path JSON for context-budget
+_cb_input() {
+  local transcript="$1" session="$2"
+  printf '{"transcript_path":"%s","session_id":"%s"}' "$transcript" "$session"
+}
+
+# ----------------------------------------------------------------------
+# Case 1: context-budget 30% (低 ratio) → 完全 silent (W1.4 kill switch)
+# ----------------------------------------------------------------------
+case_1_cb_low_ratio_silent() {
+  # 50% fixture を使い、閾値 60% で silent。
+  # 本 repo の yml は context_budget_threshold: 0.66 を採用するため env で 0.60 を明示
+  # (task-55 で config-loader の env-guard bug を修正、yml 値が確実に load されるようになった
+  # ことで本 smoke の暗黙 default 依存が露呈、明示 env override で deterministic 化)。
+  local state_dir="$TMP_BASE/cb-case1"
+  mkdir -p "$state_dir"
+  local out
+  out=$(_cb_input "${FIXTURES_CB}/transcript-50pct.jsonl" "case1" \
+    | env HC_MODE=loop HC_CONTEXT_BUDGET_STATE_DIR="$state_dir" \
+          HC_CONTEXT_BUDGET_THRESHOLD=0.60 \
+        bash "$CB_HOOK" 2>&1)
+  local code=$?
+  # stdout / stderr どちらにも system-reminder が無く、exit 0
+  if [ "$code" = "0" ] && ! printf '%s' "$out" | grep -q "system-reminder"; then
+    _check "Case 1: cb 50pct silent (below 60% threshold)" 0
+  else
+    _check "Case 1: cb 50pct silent (below 60% threshold)" 1
+    printf '    output: %s\n' "$out" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 2: context-budget 60% → fire (kill switch 通過)
+# ----------------------------------------------------------------------
+case_2_cb_threshold_fires() {
+  # 本 repo の yml は context_budget_threshold: 0.66、60% fixture が fire するよう
+  # env で閾値 0.60 を明示 (Case 1 と同じ理由、task-55 修正後の deterministic 化)。
+  local state_dir="$TMP_BASE/cb-case2"
+  mkdir -p "$state_dir"
+  local out
+  out=$(_cb_input "${FIXTURES_CB}/transcript-60pct.jsonl" "case2" \
+    | env HC_MODE=loop HC_CONTEXT_BUDGET_STATE_DIR="$state_dir" \
+          HC_CONTEXT_BUDGET_THRESHOLD=0.60 \
+        bash "$CB_HOOK" 2>&1)
+  local code=$?
+  if [ "$code" = "0" ] && printf '%s' "$out" | grep -q "system-reminder" \
+     && printf '%s' "$out" | grep -q "NOTICE"; then
+    _check "Case 2: cb 60pct fires (threshold crossed)" 0
+  else
+    _check "Case 2: cb 60pct fires (threshold crossed)" 1
+    printf '    output: %s\n' "$out" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 3: context-budget SILENT_BELOW_THRESHOLD=false → stderr debug 出力
+# ----------------------------------------------------------------------
+case_3_cb_debug_below_threshold() {
+  local state_dir="$TMP_BASE/cb-case3"
+  mkdir -p "$state_dir"
+  local out err
+  err_file="$TMP_BASE/cb-case3.err"
+  out=$(_cb_input "${FIXTURES_CB}/transcript-50pct.jsonl" "case3" \
+    | env HC_MODE=loop HC_CONTEXT_BUDGET_STATE_DIR="$state_dir" \
+          HC_CONTEXT_BUDGET_SILENT_BELOW_THRESHOLD=false \
+        bash "$CB_HOOK" 2>"$err_file")
+  local code=$?
+  err=$(cat "$err_file" 2>/dev/null)
+  # stdout に system-reminder 無し / stderr に "below threshold" / exit 0
+  if [ "$code" = "0" ] \
+     && ! printf '%s' "$out" | grep -q "system-reminder" \
+     && printf '%s' "$err" | grep -q "below threshold"; then
+    _check "Case 3: cb SILENT_BELOW_THRESHOLD=false → stderr debug" 0
+  else
+    _check "Case 3: cb SILENT_BELOW_THRESHOLD=false → stderr debug" 1
+    printf '    stdout: %s\n    stderr: %s\n' "$out" "$err" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 4: next-actions 🔴 あり → fire (default RED_ONLY=true でも 🔴 で発火)
+# ----------------------------------------------------------------------
+case_4_na_red_fires() {
+  local root
+  root=$(_make_tmp_root "case4")
+  cp "${FIXTURES_NA}/case-with-red.md" "$root/docs/tasks/next-actions.md"
+  local err_file="$TMP_BASE/na-case4.err"
+  env -i PATH="$PATH" HOME="$HOME" \
+    CLAUDE_PROJECT_DIR="$root" \
+    bash "$NAS_HOOK" </dev/null >/dev/null 2>"$err_file"
+  local code=$?
+  local err
+  err=$(cat "$err_file" 2>/dev/null)
+  if [ "$code" = "0" ] && printf '%s' "$err" | grep -q "🔴 2"; then
+    _check "Case 4: next-actions 🔴 あり → fire" 0
+  else
+    _check "Case 4: next-actions 🔴 あり → fire" 1
+    printf '    stderr: %s\n' "$err" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 5: next-actions 🟡 のみ → silent (W1.5 frequency filter default)
+# ----------------------------------------------------------------------
+case_5_na_yellow_only_silent() {
+  local root
+  root=$(_make_tmp_root "case5")
+  cp "${FIXTURES_NA}/case-with-yellow-only.md" "$root/docs/tasks/next-actions.md"
+  local err_file="$TMP_BASE/na-case5.err"
+  env -i PATH="$PATH" HOME="$HOME" \
+    CLAUDE_PROJECT_DIR="$root" \
+    bash "$NAS_HOOK" </dev/null >/dev/null 2>"$err_file"
+  local code=$?
+  local err err_len
+  err=$(cat "$err_file" 2>/dev/null)
+  err_len=${#err}
+  if [ "$code" = "0" ] && [ "$err_len" = "0" ]; then
+    _check "Case 5: next-actions 🟡 のみ → silent (W1.5 default)" 0
+  else
+    _check "Case 5: next-actions 🟡 のみ → silent (W1.5 default)" 1
+    printf '    code=%s stderr_len=%s stderr=%s\n' "$code" "$err_len" "$err" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 6: next-actions 🟡 + RED_ONLY=false → 旧挙動 fire
+# ----------------------------------------------------------------------
+case_6_na_yellow_red_only_false_fires() {
+  local root
+  root=$(_make_tmp_root "case6")
+  cp "${FIXTURES_NA}/case-with-yellow-only.md" "$root/docs/tasks/next-actions.md"
+  local err_file="$TMP_BASE/na-case6.err"
+  env -i PATH="$PATH" HOME="$HOME" \
+    CLAUDE_PROJECT_DIR="$root" \
+    HC_NEXT_ACTIONS_SURFACE_RED_ONLY=false \
+    bash "$NAS_HOOK" </dev/null >/dev/null 2>"$err_file"
+  local code=$?
+  local err
+  err=$(cat "$err_file" 2>/dev/null)
+  if [ "$code" = "0" ] && printf '%s' "$err" | grep -q "🟡 1" \
+     && printf '%s' "$err" | grep -q "🔴 0"; then
+    _check "Case 6: next-actions 🟡 + RED_ONLY=false → fire (旧挙動 revert)" 0
+  else
+    _check "Case 6: next-actions 🟡 + RED_ONLY=false → fire (旧挙動 revert)" 1
+    printf '    stderr: %s\n' "$err" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 7: session-help-surface 初回 (marker 未存在) → 1 行 pointer 表示 + marker 作成
+#
+# task-68 §3.2 (2026-06-01) opt-in 化に追従した spec-drift 修正:
+#   旧期待値: 初回で "主要 slash commands" 全文 help が出る (FORCE 未指定時も)
+#   新期待値: FORCE 未指定時は 1 行 pointer のみ (HC_SESSION_HELP_FORCE=true 案内)
+#             + marker 作成。"主要 slash commands" 全文は含まない。
+# ----------------------------------------------------------------------
+case_7_shs_first_session_shows() {
+  local marker="$TMP_BASE/shs-case7-marker"
+  rm -f "$marker"
+  local out
+  out=$(env -i PATH="$PATH" HOME="$HOME" \
+        HC_SESSION_HELP_MARKER_PATH="$marker" \
+        bash "$SHS_HOOK" </dev/null 2>/dev/null)
+  local code=$?
+  # task-68 §3.2: FORCE 未指定 → 1 行 pointer (短文) が出力される
+  #   - exit 0
+  #   - 出力に HC_SESSION_HELP_FORCE の案内語が含まれる (pointer 識別)
+  #   - 出力に "主要 slash commands" 全文は含まれない (opt-in 側経路のみ)
+  #   - marker ファイルが作成される
+  local pointer_present=1
+  local full_help_absent=1
+  printf '%s' "$out" | grep -q "HC_SESSION_HELP_FORCE" || pointer_present=0
+  printf '%s' "$out" | grep -q "主要 slash commands"   && full_help_absent=0
+  if [ "$code" = "0" ] && [ "$pointer_present" = "1" ] \
+     && [ "$full_help_absent" = "1" ] && [ -f "$marker" ]; then
+    _check "Case 7: shs 初回 (marker 未存在) → 1 行 pointer + marker 作成 (opt-in 化後仕様)" 0
+  else
+    _check "Case 7: shs 初回 (marker 未存在) → 1 行 pointer + marker 作成 (opt-in 化後仕様)" 1
+    printf '    code=%s marker_exists=%s pointer_present=%s full_help_absent=%s out_len=%s\n' \
+      "$code" "$([ -f "$marker" ] && echo yes || echo no)" \
+      "$pointer_present" "$full_help_absent" "${#out}" >&2
+    printf '    out: %s\n' "$out" >&2
+  fi
+}
+
+# ----------------------------------------------------------------------
+# Case 8: session-help-surface 2 回目 (marker 既存) → silent + FORCE で revive
+# ----------------------------------------------------------------------
+case_8_shs_second_silent_then_force() {
+  local marker="$TMP_BASE/shs-case8-marker"
+  : > "$marker"  # marker 既存 (初回完了済)
+
+  # 2 回目: silent のはず
+  local out2
+  out2=$(env -i PATH="$PATH" HOME="$HOME" \
+        HC_SESSION_HELP_MARKER_PATH="$marker" \
+        bash "$SHS_HOOK" </dev/null 2>/dev/null)
+  local code2=$?
+
+  # FORCE=1: revive
+  local out3
+  out3=$(env -i PATH="$PATH" HOME="$HOME" \
+        HC_SESSION_HELP_MARKER_PATH="$marker" \
+        HC_SESSION_HELP_FORCE=1 \
+        bash "$SHS_HOOK" </dev/null 2>/dev/null)
+  local code3=$?
+
+  if [ "$code2" = "0" ] && [ -z "$out2" ] \
+     && [ "$code3" = "0" ] && printf '%s' "$out3" | grep -q "主要 slash commands"; then
+    _check "Case 8: shs 2 回目 silent + FORCE=1 で revive" 0
+  else
+    _check "Case 8: shs 2 回目 silent + FORCE=1 で revive" 1
+    printf '    code2=%s out2_len=%s code3=%s out3_match=%s\n' \
+      "$code2" "${#out2}" "$code3" \
+      "$(printf '%s' "$out3" | grep -q '主要 slash commands' && echo yes || echo no)" >&2
+  fi
+}
+
+# === run all ===
+printf '===== task-21 W1.4/1.5/1.6 hook-frequency-tweaks smoke =====\n'
+case_1_cb_low_ratio_silent
+case_2_cb_threshold_fires
+case_3_cb_debug_below_threshold
+case_4_na_red_fires
+case_5_na_yellow_only_silent
+case_6_na_yellow_red_only_false_fires
+case_7_shs_first_session_shows
+case_8_shs_second_silent_then_force
+
+printf '\n===== Result =====\n'
+printf 'PASS: %d / 8\n' "$PASS"
+printf 'FAIL: %d / 8\n' "$FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  printf 'Failed cases:\n'
+  for c in "${FAILED[@]}"; do
+    printf '  - %s\n' "$c"
+  done
+  exit 1
+fi
+exit 0