@takuma-hirai/hirai-method 0.1.0

package/.claude/tests/session-help-surface-smoke.sh

@@ -0,0 +1,224 @@
+#!/usr/bin/env bash
+# session-help-surface-smoke.sh — task #11 + Wave 1.6 smoke test
+#
+# Cases:
+#   Case 1: default (HC_SESSION_HELP_* unset) → 1 行 pointer が出力される (marker 作成、task-68 §3.2 opt-in 化)
+#   Case 2: HC_SESSION_HELP_ENABLED=false → silent (出力なし)
+#   Case 3: HC_SESSION_HELP_FORCE=true + VERBOSE=true → 詳細版が追加出力
+#   Case 4: FORCE=true の詳細 help に主要 command (`/save-state`, `/new-task`, `/mode`) が含まれる (task-68 §3.2)
+#
+# Wave 1.6 (2026-05-23) で追加された first-only 動作 + marker:
+#   Case 5: HC_SESSION_HELP_FIRST_ONLY=true (default) + marker 既存 → silent
+#   Case 6: HC_SESSION_HELP_FORCE=1 → marker 無視で詳細 help 強制表示
+#   Case 7: HC_SESSION_HELP_FIRST_ONLY=false (旧挙動) + marker 既存 → 1 行 pointer 表示
+#
+# 重要制約:
+#   - file-top に set -euo pipefail を書かない (feedback_set_e_in_sourced_libs 規範遵守)
+#   - 各 case 関数は ( set -uo pipefail; ... ) でラップして実行
+#   - 各 case は marker file を per-case 隔離 (TMP) して順序依存を排除
+#
+# 実行:
+#   bash .claude/tests/session-help-surface-smoke.sh
+#
+# 終了コード:
+#   0 = 全 case PASS / 1 = 1 件以上 FAIL
+
+set -u
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+HOOK="$PROJECT_ROOT/.claude/hooks/session-help-surface.sh"
+
+TMP_BASE="$(mktemp -d /tmp/session-help-surface-smoke.XXXXXX)"
+trap 'rm -rf "$TMP_BASE"' EXIT
+
+PASS=0
+FAIL=0
+FAILED_CASES=()
+
+# marker path を case 毎に隔離 (env override `HC_SESSION_HELP_MARKER_PATH`)
+# 各 case で uniq marker を使い、test 順序依存を排除
+_marker_for() {
+  local case_id="$1"
+  printf '%s/marker-%s' "$TMP_BASE" "$case_id"
+}
+
+# run_case <id> <desc> <test_fn>
+run_case() {
+  local case_id="$1"
+  local desc="$2"
+  local test_fn="$3"
+  if ( set -uo pipefail; "$test_fn" ) >/dev/null 2>&1; then
+    printf '  PASS  Case %s: %s\n' "$case_id" "$desc"
+    PASS=$((PASS+1))
+  else
+    printf '  FAIL  Case %s: %s\n' "$case_id" "$desc"
+    FAIL=$((FAIL+1))
+    FAILED_CASES+=("$case_id")
+  fi
+}
+
+# === Case 1: default → 1 行 pointer 出力 (task-68 §3.2 opt-in 化) ===
+case_1() {
+  local marker
+  marker=$(_marker_for 1)
+  rm -f "$marker"
+  local output
+  # marker 未存在 + first-only default → 1 行 pointer が表示される
+  output=$(unset HC_SESSION_HELP_ENABLED HC_SESSION_HELP_VERBOSE HC_SESSION_HELP_FORCE HC_SESSION_HELP_FIRST_ONLY; \
+    HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if [ -z "$output" ]; then
+    printf 'expected non-empty pointer output, got empty\n' >&2
+    return 1
+  fi
+  # default は詳細 help 全文 (主要 slash commands header) を含まず、pointer (HC_SESSION_HELP_FORCE 案内) を含む
+  if printf '%s' "$output" | grep -q '主要 slash commands'; then
+    printf 'expected pointer-only default (no 主要 slash commands header), got full help: %s\n' "$output" >&2
+    return 1
+  fi
+  if ! printf '%s' "$output" | grep -q 'HC_SESSION_HELP_FORCE'; then
+    printf 'expected pointer mentioning HC_SESSION_HELP_FORCE, got: %s\n' "$output" >&2
+    return 1
+  fi
+  if ! printf '%s' "$output" | grep -q 'system-reminder'; then
+    return 1
+  fi
+  # marker が作成されているはず
+  if [ ! -f "$marker" ]; then
+    printf 'expected marker created at %s\n' "$marker" >&2
+    return 1
+  fi
+  return 0
+}
+
+# === Case 2: HC_SESSION_HELP_ENABLED=false → silent ===
+case_2() {
+  local marker
+  marker=$(_marker_for 2)
+  rm -f "$marker"
+  local output
+  output=$(HC_SESSION_HELP_ENABLED=false HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if [ -n "$output" ]; then
+    printf 'expected silent, got: %s\n' "$output" >&2
+    return 1
+  fi
+  return 0
+}
+
+# === Case 3: HC_SESSION_HELP_FORCE=true + VERBOSE=true → 詳細版追加 (task-68 §3.2: VERBOSE は FORCE 配下) ===
+# 簡潔版 + 詳細版の 2 つの system-reminder section が出るはず。
+# grep -c '<system-reminder>' で open タグのみカウント (期待値: 2)。
+# grep -c 'system-reminder' は open+close 両タグを合算するため不正確 (qa LOW-8 修正)。
+case_3() {
+  local marker
+  marker=$(_marker_for 3)
+  rm -f "$marker"
+  local output
+  output=$(HC_SESSION_HELP_FORCE=true HC_SESSION_HELP_VERBOSE=true HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if ! printf '%s' "$output" | grep -q '詳細 commands'; then
+    printf 'expected "詳細 commands" verbose section, got: %s\n' "$output" >&2
+    return 1
+  fi
+  # open タグのみカウント: 簡潔版 + 詳細版 = 2 sections
+  local reminder_count
+  reminder_count=$(printf '%s' "$output" | grep -c '<system-reminder>' || true)
+  if [ "$reminder_count" -lt 2 ]; then
+    printf 'expected >=2 <system-reminder> open tags (2 sections), got: %s\n' "$reminder_count" >&2
+    return 1
+  fi
+  return 0
+}
+
+# === Case 4: FORCE=true 詳細 help に主要 command 含む (task-68 §3.2) ===
+case_4() {
+  local marker
+  marker=$(_marker_for 4)
+  rm -f "$marker"
+  local output
+  output=$(HC_SESSION_HELP_FORCE=true HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if ! printf '%s' "$output" | grep -q '/save-state'; then
+    printf 'missing /save-state\n' >&2
+    return 1
+  fi
+  if ! printf '%s' "$output" | grep -q '/new-task'; then
+    printf 'missing /new-task\n' >&2
+    return 1
+  fi
+  if ! printf '%s' "$output" | grep -q '/mode'; then
+    printf 'missing /mode\n' >&2
+    return 1
+  fi
+  return 0
+}
+
+# === Case 5 (W1.6): marker 既存 + first-only default → silent ===
+case_5_marker_exists_silent() {
+  local marker
+  marker=$(_marker_for 5)
+  # marker を事前に作成 (初回 session help 完了済の状態)
+  : > "$marker"
+  local output
+  output=$(unset HC_SESSION_HELP_ENABLED HC_SESSION_HELP_VERBOSE HC_SESSION_HELP_FORCE HC_SESSION_HELP_FIRST_ONLY; \
+    HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if [ -n "$output" ]; then
+    printf 'expected silent (marker exists, first-only default), got: %s\n' "$output" >&2
+    return 1
+  fi
+  return 0
+}
+
+# === Case 6 (W1.6): HC_SESSION_HELP_FORCE=1 → marker 無視で強制表示 ===
+case_6_force_overrides_marker() {
+  local marker
+  marker=$(_marker_for 6)
+  # marker 既存
+  : > "$marker"
+  local output
+  output=$(HC_SESSION_HELP_FORCE=1 HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if [ -z "$output" ]; then
+    printf 'expected force display (marker ignored), got empty\n' >&2
+    return 1
+  fi
+  if ! printf '%s' "$output" | grep -q '主要 slash commands'; then
+    printf 'expected force display content, got: %s\n' "$output" >&2
+    return 1
+  fi
+  return 0
+}
+
+# === Case 7 (W1.6): HC_SESSION_HELP_FIRST_ONLY=false → 旧挙動 (marker 既存でも毎回表示) ===
+# task-68 §3.2: FORCE 未指定なので表示されるのは 1 行 pointer (詳細 help は opt-in)。
+case_7_first_only_false_always_show() {
+  local marker
+  marker=$(_marker_for 7)
+  # marker 既存
+  : > "$marker"
+  local output
+  output=$(HC_SESSION_HELP_FIRST_ONLY=false HC_SESSION_HELP_MARKER_PATH="$marker" bash "$HOOK" </dev/null 2>/dev/null)
+  if [ -z "$output" ]; then
+    printf 'expected display (FIRST_ONLY=false), got empty\n' >&2
+    return 1
+  fi
+  if ! printf '%s' "$output" | grep -q 'HC_SESSION_HELP_FORCE'; then
+    printf 'expected pointer content (HC_SESSION_HELP_FORCE), got: %s\n' "$output" >&2
+    return 1
+  fi
+  return 0
+}
+
+printf '===== task #11 + Wave 1.6 session-help-surface smoke =====\n'
+run_case 1 'default -> 1 行 pointer 出力 + marker 作成 (§3.2 opt-in)' case_1
+run_case 2 'ENABLED=false -> silent' case_2
+run_case 3 'FORCE+VERBOSE -> 詳細版追加' case_3
+run_case 4 'FORCE 詳細 help に /save-state /new-task /mode 含む' case_4
+run_case 5 'W1.6: marker 既存 + first-only default -> silent' case_5_marker_exists_silent
+run_case 6 'W1.6: FORCE=1 -> marker 無視で詳細 help 表示' case_6_force_overrides_marker
+run_case 7 'W1.6: FIRST_ONLY=false -> pointer 表示' case_7_first_only_false_always_show
+
+printf '\n===== Result =====\n'
+printf 'PASS: %d / 7\n' "$PASS"
+printf 'FAIL: %d / 7\n' "$FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  printf 'Failed cases: %s\n' "${FAILED_CASES[*]}"
+  exit 1
+fi
+exit 0

package/.claude/tests/session-start-parallel-smoke.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+# session-start-parallel-smoke.sh — task-25 Sub-epic A2 smoke test
+#
+# 5 cases:
+#   1. all hooks normal → wrapper rc=0, stdout populated
+#   2. one hook fail → wrapper rc=0, tagged warn in stderr
+#   3. all hooks timeout → wrapper rc=0, TIMEOUT warns
+#   4. parallel mode wall time < serial sum (短縮確認)
+#   5. regression: real hooks (mode-session-start / why-x5-reminder /
+#                  session-help-surface / check-serena-mcp /
+#                  next-actions-surface / mode-asana-prompt) work through wrapper
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+WRAPPER="$REPO_ROOT/hooks/session-start-wrapper.sh"
+
+PASS=0
+FAIL=0
+FAILED_CASES=()
+
+assert_eq() {
+  local name="$1" expected="$2" actual="$3"
+  if [ "$expected" = "$actual" ]; then
+    echo "  PASS: $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL: $name (expected: '$expected', actual: '$actual')"
+    FAIL=$((FAIL+1))
+    FAILED_CASES+=("$name")
+  fi
+}
+
+assert_contains() {
+  local name="$1" needle="$2" haystack="$3"
+  # -F: fixed string match (角括弧等の regex metachar を literal 扱い)
+  if echo "$haystack" | grep -qF -- "$needle"; then
+    echo "  PASS: $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL: $name (missing '$needle' in haystack)"
+    FAIL=$((FAIL+1))
+    FAILED_CASES+=("$name")
+  fi
+}
+
+assert_le() {
+  local name="$1" threshold="$2" actual="$3"
+  if [ "$actual" -le "$threshold" ]; then
+    echo "  PASS: $name ($actual <= $threshold)"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL: $name ($actual > $threshold)"
+    FAIL=$((FAIL+1))
+    FAILED_CASES+=("$name")
+  fi
+}
+
+# Create fake hooks workspace for cases 1-4
+FAKE_HOOK_DIR=$(mktemp -d -t "session-start-fake-hooks.XXXXXX")
+trap 'rm -rf "$FAKE_HOOK_DIR"' EXIT
+
+# Helper: build wrapper with custom HOOK_DIR by overriding hook list
+make_fake_hook() {
+  local name="$1" body="$2"
+  cat > "$FAKE_HOOK_DIR/${name}.sh" <<EOF
+#!/usr/bin/env bash
+$body
+EOF
+  chmod +x "$FAKE_HOOK_DIR/${name}.sh"
+}
+
+# Run wrapper with custom SCRIPT_DIR (override hook locations via fake wrapper)
+# We re-implement minimal wrapper logic by sourcing the wrapper with overridden SCRIPT_DIR
+# Strategy: copy wrapper to FAKE_HOOK_DIR, then it picks up FAKE_HOOK_DIR/*.sh
+run_fake_wrapper() {
+  cp "$WRAPPER" "$FAKE_HOOK_DIR/wrapper.sh"
+  chmod +x "$FAKE_HOOK_DIR/wrapper.sh"
+  "$@" bash "$FAKE_HOOK_DIR/wrapper.sh" </dev/null 2>"$FAKE_HOOK_DIR/stderr" >"$FAKE_HOOK_DIR/stdout"
+  echo "$?"
+}
+
+echo "=== Case 1: all hooks normal → rc=0 + stdout populated ==="
+make_fake_hook "hook-a" 'echo "HOOK_A_OUTPUT"; exit 0'
+make_fake_hook "hook-b" 'echo "HOOK_B_OUTPUT"; exit 0'
+make_fake_hook "hook-c" 'echo "HOOK_C_OUTPUT"; exit 0'
+rc=$(HC_SESSION_START_PARALLEL_HOOKS="hook-a:hook-b:hook-c" run_fake_wrapper env)
+assert_eq "case1.rc" "0" "$rc"
+assert_contains "case1.stdout has HOOK_A_OUTPUT" "HOOK_A_OUTPUT" "$(cat "$FAKE_HOOK_DIR/stdout")"
+assert_contains "case1.stdout has HOOK_B_OUTPUT" "HOOK_B_OUTPUT" "$(cat "$FAKE_HOOK_DIR/stdout")"
+assert_contains "case1.stdout has HOOK_C_OUTPUT" "HOOK_C_OUTPUT" "$(cat "$FAKE_HOOK_DIR/stdout")"
+# verify stable order (alphabetical by hook name)
+first_hook=$(grep -E "^HOOK_[A-Z]_OUTPUT$" "$FAKE_HOOK_DIR/stdout" | head -1)
+assert_eq "case1.stdout stable order (hook-a first)" "HOOK_A_OUTPUT" "$first_hook"
+
+echo ""
+echo "=== Case 2: one hook fail → rc=0 (fail-open) + tagged stderr ==="
+make_fake_hook "hook-ok" 'echo "OK_OUTPUT"; exit 0'
+make_fake_hook "hook-fail" 'echo "ERR_MSG" >&2; exit 1'
+rc=$(HC_SESSION_START_PARALLEL_HOOKS="hook-ok:hook-fail" run_fake_wrapper env)
+assert_eq "case2.rc" "0" "$rc"
+assert_contains "case2.stdout has OK_OUTPUT" "OK_OUTPUT" "$(cat "$FAKE_HOOK_DIR/stdout")"
+assert_contains "case2.stderr has tag prefix" "[hook-fail] ERR_MSG" "$(cat "$FAKE_HOOK_DIR/stderr")"
+
+echo ""
+echo "=== Case 3: all hooks timeout → rc=0 + TIMEOUT warns ==="
+# Skip case3 if timeout/gtimeout not available
+if command -v timeout >/dev/null 2>&1 || command -v gtimeout >/dev/null 2>&1; then
+  make_fake_hook "hook-slow" 'sleep 10; echo "SLOW_OUTPUT"'
+  rc=$(HC_SESSION_START_PARALLEL_HOOKS="hook-slow" HC_SESSION_START_PARALLEL_TIMEOUT_SEC=1 run_fake_wrapper env)
+  assert_eq "case3.rc" "0" "$rc"
+  assert_contains "case3.stderr has TIMEOUT warn" "TIMEOUT" "$(cat "$FAKE_HOOK_DIR/stderr")"
+else
+  echo "  SKIP: timeout/gtimeout not available"
+fi
+
+echo ""
+echo "=== Case 4: parallel wall time < serial sum ==="
+make_fake_hook "hook-p1" 'sleep 0.2; echo "P1"'
+make_fake_hook "hook-p2" 'sleep 0.2; echo "P2"'
+make_fake_hook "hook-p3" 'sleep 0.2; echo "P3"'
+
+now_ms() { python3 -c "import time; print(int(time.time()*1000))"; }
+
+# Parallel
+start=$(now_ms)
+HC_SESSION_START_PARALLEL_HOOKS="hook-p1:hook-p2:hook-p3" HC_SESSION_START_PARALLEL_ENABLED=true \
+  run_fake_wrapper env > /dev/null
+end=$(now_ms)
+parallel_ms=$((end-start))
+
+# Serial
+start=$(now_ms)
+HC_SESSION_START_PARALLEL_HOOKS="hook-p1:hook-p2:hook-p3" HC_SESSION_START_PARALLEL_ENABLED=false \
+  run_fake_wrapper env > /dev/null
+end=$(now_ms)
+serial_ms=$((end-start))
+
+echo "  parallel: ${parallel_ms}ms / serial: ${serial_ms}ms"
+# Parallel should be < serial / 2 (3 hooks sleeping 200ms each)
+threshold=$((serial_ms / 2))
+assert_le "case4.parallel < serial/2" "$threshold" "$parallel_ms"
+
+echo ""
+echo "=== Case 5: regression — real SessionStart hooks via wrapper ==="
+# Use actual wrapper with default hooks (the production one)
+real_rc=$(bash "$WRAPPER" </dev/null 1>"$FAKE_HOOK_DIR/real-stdout" 2>"$FAKE_HOOK_DIR/real-stderr"; echo $?)
+assert_eq "case5.rc" "0" "$real_rc"
+# mode-session-start emits Serena resume reminder when .serena/memories/session/context.md exists
+# why-x5-reminder emits a system-reminder unconditionally
+real_stdout=$(cat "$FAKE_HOOK_DIR/real-stdout")
+# At least one system-reminder block should appear
+assert_contains "case5.real stdout has system-reminder block" "system-reminder" "$real_stdout"
+
+echo ""
+echo "================================"
+echo "Summary: PASS=$PASS FAIL=$FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed cases:"
+  printf '  - %s\n' "${FAILED_CASES[@]}"
+  exit 1
+fi
+echo "All cases passed."
+exit 0

package/.claude/tests/sessionstart-budget-smoke.sh

@@ -0,0 +1,185 @@
+#!/usr/bin/env bash
+# sessionstart-budget-smoke.sh — task-71 Step 8 S-C (H4 強化)
+#
+# 目的:
+#   session-start-dispatcher.sh の stdout byte 数を計測する。
+#   draft 目標 800 chars は warn ライン — 超過しても FAIL にしない (warn 記録のみ)。
+#   SessionStart は Claude Code に context (system-reminder 等) を戻す event で、
+#   出力が過大だと LLM の有効 context window を圧迫する。
+#
+# task-74 Step 3 統合判断 (2026-06-02):
+#   sessionstart-footprint-smoke.sh (task-73) と SessionStart bytes を二重計測している。
+#   footprint-smoke が hard cap 800B を担当 (正本)。本 smoke は以下の役割で残す:
+#     - SC-1: dispatcher exit 0 確認 (footprint に無い独自 assert)
+#     - SC-2: warn 800 + hard-fail 5000 の 2 段構成 (footprint の hard 800 とは閾値が異なる)
+#     - SC-3: stdout 非空 assert (footprint に無い独自 assert)
+#     - SC-4: NUL bytes チェック (footprint に無い独自 assert)
+#   SC-1/SC-3/SC-4 の独自 assert により本 smoke は廃止せず残す。
+#   SessionStart bytes の hard cap (800B) は sessionstart-footprint-smoke.sh を SSoT とする。
+#
+# 計測内容:
+#   SC-1: session-start-dispatcher を 隔離環境 (/dev/null stdin) で実行し stdout バイト数を取得。
+#         H4: 固定 mode.yml=normal + 空 list.md + HOME 隔離 で決定論化 (実 project 状態依存排除)。
+#   SC-2: 現状値を記録し、800 超過で WARN (fail にしない)。
+#         H4: hard-fail 上限 5000 chars 追加 (WARN 800 + HARD_FAIL 5000 の 2 段構成)。
+#         注: hard cap 800 は sessionstart-footprint-smoke.sh が担当 (SSoT)。
+#   SC-3: bootstrap 出力が非空であること を FAIL 検出 (session-start-wrapper 無音化を回帰検出)。
+#         H4: 旧実装は空出力を warn-pass にしていたが、非空を hard assert に変更。
+#   SC-4: 出力が有効 UTF-8 / printable であることを確認 (制御文字注入チェック)。
+#
+# 実行: bash .claude/tests/sessionstart-budget-smoke.sh
+# 終了: 0 = 全 case PASS (warn は PASS、hard fail は test failure のみ) / 1 = FAIL
+#
+# bash 3.2 互換 (macOS)。
+# 規約: file-top set -u + case 別 ( set -uo pipefail ) + run_case。
+
+set -u
+
+BUDGET_WARN=800      # chars warn ライン (超過で warn、fail にしない)
+BUDGET_HARD_FAIL=5000  # H4: hard-fail 上限 (超過で FAIL)
+
+# --- 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/session-start-dispatcher.sh"
+
+TMPBASE="$(mktemp -d "${TMPDIR:-/tmp}/sessionstart-budget-smoke.XXXXXX")"
+trap 'rm -rf "$TMPBASE"' EXIT
+
+PASS=0
+FAIL=0
+WARN=0
+
+ok()   { PASS=$((PASS+1)); printf '  PASS: %s\n' "$1"; }
+bad()  { FAIL=$((FAIL+1)); printf '  FAIL: %s\n' "$1"; }
+warn() { WARN=$((WARN+1)); printf '  WARN: %s\n' "$1"; }
+
+# ------------------------------------------------------------------
+# H4: 隔離環境セットアップ — 固定 mode.yml + 空 list.md + HOME 隔離 (決定論化)
+# 実 project の mode 状態・task list 状態に依存しない安定した実行環境を構築する。
+ISOLATED_HOME="$TMPBASE/isolated-home"
+ISOLATED_STATE="$TMPBASE/isolated-state"
+mkdir -p "$ISOLATED_HOME/.claude" "$ISOLATED_STATE"
+
+# 固定 mode.yml=normal (実 project の Loop モード状態に依存しない)
+printf 'mode: normal\n' > "$ISOLATED_HOME/.claude/mode.yml"
+# 空 list.md (list-md-plan-first-reminder の plan-first 警告を抑制)
+mkdir -p "$ISOLATED_HOME/.claude/docs/tasks" 2>/dev/null || true
+
+# ------------------------------------------------------------------
+printf "=== S-C: sessionstart-budget-smoke ===\n\n"
+printf "H4: 隔離環境 (HOME=%s、mode=normal、list.md=空)\n" "$ISOLATED_HOME"
+
+# SC-1: dispatcher が exit 0 で終了する (隔離環境)
+run_sc1() ( set -uo pipefail
+  local rc=0
+  HOME="$ISOLATED_HOME" \
+  HC_PROJECT_ROOT="$ROOT" \
+  HC_IMPROVEMENT_PROPOSAL_STATE_DIR="$ISOLATED_STATE/improvement" \
+  HC_STALE_HARNESS_DETECT_STATE_DIR="$ISOLATED_STATE/stale-harness" \
+  HC_CONTEXT_BUDGET_STATE_DIR="$ISOLATED_STATE/context-budget" \
+    bash "$DISPATCHER" </dev/null >/dev/null 2>/dev/null || rc=$?
+  printf '%s\n' "$rc" > "${TMPBASE}/result-sc1"
+)
+
+printf "SC-1: session-start-dispatcher exits 0 (isolated env)\n"
+run_sc1
+sc1_rc="$(cat "${TMPBASE}/result-sc1" 2>/dev/null | tr -d '[:space:]')"
+if [ "$sc1_rc" = "0" ]; then
+  ok "SC-1 exit 0"
+else
+  bad "SC-1 exit ${sc1_rc} (want 0)"
+fi
+
+# SC-2: stdout byte count measurement (隔離環境)
+run_sc2() ( set -uo pipefail
+  local out
+  out="$(
+    HOME="$ISOLATED_HOME" \
+    HC_PROJECT_ROOT="$ROOT" \
+    HC_IMPROVEMENT_PROPOSAL_STATE_DIR="$ISOLATED_STATE/improvement" \
+    HC_STALE_HARNESS_DETECT_STATE_DIR="$ISOLATED_STATE/stale-harness" \
+    HC_CONTEXT_BUDGET_STATE_DIR="$ISOLATED_STATE/context-budget" \
+      bash "$DISPATCHER" </dev/null 2>/dev/null
+  )"
+  local byte_count
+  byte_count=$(printf '%s' "$out" | wc -c | tr -d '[:space:]')
+  printf '%s\n' "$byte_count" > "${TMPBASE}/result-sc2-bytes"
+  printf '%s\n' "$out" > "${TMPBASE}/result-sc2-content"
+)
+
+printf "\nSC-2: measure stdout byte count (isolated env)\n"
+run_sc2
+BYTE_COUNT="$(cat "${TMPBASE}/result-sc2-bytes" 2>/dev/null | tr -d '[:space:]')"
+if [ -z "$BYTE_COUNT" ]; then
+  bad "SC-2 byte count measurement failed"
+else
+  printf "  INFO: session-start-dispatcher stdout = %s bytes\n" "$BYTE_COUNT"
+  # H4: 2 段構成 (warn 800 / hard-fail 5000)
+  if [ "$BYTE_COUNT" -le "$BUDGET_WARN" ]; then
+    ok "SC-2 stdout bytes=${BYTE_COUNT} (<= warn_line=${BUDGET_WARN})"
+  elif [ "$BYTE_COUNT" -le "$BUDGET_HARD_FAIL" ]; then
+    warn "SC-2 stdout bytes=${BYTE_COUNT} EXCEEDS warn_line=${BUDGET_WARN} (< hard_fail=${BUDGET_HARD_FAIL}) — context budget pressure (not FAIL)"
+    ok "SC-2 recorded (warn state, not hard fail)"
+  else
+    bad "SC-2 stdout bytes=${BYTE_COUNT} EXCEEDS hard_fail_line=${BUDGET_HARD_FAIL} — LLM context 過負荷リスク"
+  fi
+fi
+
+# SC-3: H4 bootstrap 出力が非空であることを assert (session-start-wrapper 無音化を回帰検出)
+#   旧実装: 空出力を warn-pass にしていた → 無音化を見逃す
+#   新実装: 空出力を FAIL として検出 (session-start-wrapper は最低限 mode 情報を出すべき)
+printf "\nSC-3: stdout non-empty (bootstrap context injection, hard assert)\n"
+CONTENT_SIZE="$(wc -c < "${TMPBASE}/result-sc2-content" 2>/dev/null | tr -d '[:space:]')"
+# session-start-dispatcher runs session-start-wrapper + list-md + stale-harness-detect + observe
+# session-start-wrapper は最低限 mode 情報 (normal/loop) を出すため空にならないはず。
+# ただし全 bootstrap hook が feature toggle で OFF の場合は空 → その時は WARN に留める
+if [ "${CONTENT_SIZE:-0}" -gt 0 ]; then
+  ok "SC-3 stdout non-empty (${CONTENT_SIZE} bytes written) — bootstrap context 注入確認"
+else
+  # H4: 空出力は FAIL (session-start-wrapper の無音化を回帰検出)
+  bad "SC-3 stdout empty — session-start-wrapper 無音化の可能性 (bootstrap context 未注入)"
+fi
+
+# SC-4: no NUL bytes / obvious binary in output (content quality check)
+printf "\nSC-4: output contains no NUL bytes (printable ASCII / UTF-8 check)\n"
+if [ -f "${TMPBASE}/result-sc2-content" ]; then
+  # cat -v shows non-printable as ^X, NUL as ^@ — check for ^@
+  if cat "${TMPBASE}/result-sc2-content" | od -c 2>/dev/null | grep -q '\\0'; then
+    bad "SC-4 output contains NUL bytes"
+  else
+    ok "SC-4 output is NUL-free"
+  fi
+else
+  warn "SC-4 content file missing, skip"
+  ok "SC-4 skip (no content)"
+fi
+
+# ------------------------------------------------------------------
+TOTAL=$((PASS + FAIL))
+printf "\n===== S-C Result =====\n"
+printf "PASS: %d / %d\n" "$PASS" "$TOTAL"
+printf "FAIL: %d / %d\n" "$FAIL" "$TOTAL"
+printf "WARN: %d\n" "$WARN"
+printf "Budget: %s bytes (warn line: %d, hard-fail line: %d)\n" "${BYTE_COUNT:-unknown}" "$BUDGET_WARN" "$BUDGET_HARD_FAIL"
+[ "$FAIL" -gt 0 ] && exit 1
+exit 0