@takuma-hirai/hirai-method 0.1.0

package/.claude/tests/rule-change-draft-flow-guard-smoke.sh

@@ -0,0 +1,343 @@
+#!/usr/bin/env bash
+# rule-change-draft-flow-guard-smoke.sh — task-40 拡張の緩和 (2026-05-28) smoke
+#
+# 設計起源:
+#   docs/draft/task-mgmt-rules-with-draft-flow-enforcement.md (task-40、2026-05-26)
+#   2026-05-28 user 指示「既存 rules file の Edit は PASS (新規 Write のみ
+#   BLOCK) → 書き込みも許容してください」で task-40 拡張部分を撤廃。
+#
+# 緩和内容:
+#   旧 task-40 拡張は .claude/rules/*.md / .claude/commands/*.md /
+#   .claude/templates/docs/**/*.md への新規 Write を draft 承認 (approved_at /
+#   retroactive) 不在で BLOCK していた。本緩和で **これらは新規 Write / 既存
+#   Edit とも PASS** になる (本 hook は一切監視しない)。
+#   docs/ 直下の新規設計文書 BLOCK + 既存 Edit PASS は **完全維持** (回帰)。
+#
+# 対象 hook:
+#   .claude/hooks/draft-flow-guard.sh (PreToolUse Edit/Write)
+#
+# 検証範囲 (13 active + 1 skip):
+#   Case 1:  .claude/rules/foo.md 新規 Write + 対応 draft 不在 → PASS (緩和、旧 BLOCK)
+#   Case 2:  .claude/rules/foo.md 新規 Write + 対応 draft あり (approved_at 非空) → PASS
+#   Case 3:  .claude/rules/foo.md 新規 Write + 対応 draft あり (approved_at key 不在) → PASS (緩和、旧 BLOCK)
+#   Case 4:  .claude/templates/docs/tasks/foo.md 新規 Write + retroactive draft → PASS (緩和、旧 PASS+warn)
+#   Case 5:  .claude/rules/foo.md + ECC_RULE_CHANGE_GUARD_OFF=1 → PASS (env は dead path、緩和後も PASS)
+#   Case 6:  docs/new-feature.md 新規 Write + 対応 draft 不在 → BLOCK (docs/ block 維持、回帰)
+#   Case 7:  .claude/commands/foo.md 新規 Write + 対応 draft 不在 → PASS (緩和、旧 BLOCK)
+#   Case 8:  既存 .claude/rules/<existing>.md Edit → PASS (緩和前後とも PASS)
+#   Case 9:  ECC_DRAFT_FLOW_GUARD_OVERRIDE=1 で .claude/rules/foo.md Write → PASS + bypass.log (override は hook 冒頭で維持)
+#   Case 10: approved_at: (空白のみ) draft で .claude/rules/foo.md → PASS (緩和、旧 BLOCK)
+#   Case 11: approved_at: (key only) draft で .claude/rules/foo.md → PASS (緩和、旧 BLOCK)
+#   Case 12: .claude/rules/sub/foo.md (深さ 2) Write → PASS (緩和前後とも PASS)
+#   Case 13: HC_RULE_CHANGE_GUARD_ENABLED=false で .claude/rules/foo.md Write → PASS (config は dead path、緩和後も PASS)
+#   Case 14: docs/draft/ + docs/tasks/ 配下 → PASS [SKIP: 既存 draft-flow-guard-smoke.sh で網羅]
+#
+# 重要制約:
+#   - file-top の set -uo pipefail (errexit 外し、feedback_set_e_in_sourced_libs)
+#   - tmp project root を /tmp/ に作って独立 ツリーを配置
+#   - hook は project-root.sh の resolve_project_root に依存するため、tmp_root に .git
+#   - hook は exit 2 で BLOCK、exit 0 で PASS
+#
+# 実行:
+#   bash .claude/tests/rule-change-draft-flow-guard-smoke.sh
+#
+# 終了コード:
+#   0 = 全 PASS / 1 = 1 件以上 FAIL
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+HOOK="$REPO_ROOT/.claude/hooks/draft-flow-guard.sh"
+
+# clean env (新旧両方 bypass を unset)
+unset ECC_DRAFT_FLOW_GUARD_OVERRIDE
+unset ECC_RULE_CHANGE_GUARD_OFF
+unset HC_RULE_CHANGE_GUARD_ENABLED
+unset HC_DRAFT_FLOW_GUARD_WHITELIST
+unset HC_DOCS_APPROVED_DIR
+unset ECC_BYPASS_REASON
+
+# tmp project root に .git/ を作って resolve_project_root が安定して解決するように
+TMP_ROOT="$(mktemp -d /tmp/rule-change-draft-flow-guard-smoke.XXXXXX)"
+mkdir -p "$TMP_ROOT/.git" \
+         "$TMP_ROOT/docs/draft" \
+         "$TMP_ROOT/docs/tasks" \
+         "$TMP_ROOT/.claude/rules" \
+         "$TMP_ROOT/.claude/commands" \
+         "$TMP_ROOT/.claude/templates/docs/tasks" \
+         "$TMP_ROOT/.claude/rules/sub" \
+         "$TMP_ROOT/.claude/.workflow-state"
+
+trap 'rm -rf "$TMP_ROOT"' EXIT
+
+PASS=0
+FAIL=0
+FAILED_CASES=()
+
+# hook input JSON (PreToolUse Edit/Write)
+hook_input() {
+  local tool="$1"
+  local fp="$2"
+  TOOL="$tool" FP="$fp" python3 -c '
+import json, os
+print(json.dumps({
+    "tool_name": os.environ["TOOL"],
+    "tool_input": {"file_path": os.environ["FP"]}
+}))
+'
+}
+
+# hook を tmp project root cwd で実行
+run_hook() {
+  local tool="$1"
+  local fp="$2"
+  shift 2
+  (
+    cd "$TMP_ROOT" || exit 99
+    if [ $# -gt 0 ]; then
+      hook_input "$tool" "$fp" | env CLAUDE_PROJECT_DIR="$TMP_ROOT" "$@" bash "$HOOK"
+    else
+      hook_input "$tool" "$fp" | CLAUDE_PROJECT_DIR="$TMP_ROOT" bash "$HOOK"
+    fi
+  )
+}
+
+# helper: draft を frontmatter 付きで作成
+write_draft() {
+  local _path="$1"
+  local _approved_at="$2"
+  local _retroactive="${3:-}"
+  local _approved_by="${4:-}"
+  mkdir -p "$(dirname "$_path")"
+  {
+    echo '<!--'
+    [ -n "$_approved_at" ] && echo "approved_at: $_approved_at"
+    [ -n "$_retroactive" ] && echo "retroactive: $_retroactive"
+    [ -n "$_approved_by" ] && echo "approved_by: $_approved_by"
+    echo '-->'
+    echo ''
+    echo '# draft body'
+  } > "$_path"
+}
+
+write_draft_key_only() {
+  local path="$1"
+  {
+    echo '<!--'
+    printf 'approved_at:\n'
+    echo '-->'
+    echo ''
+    echo '# draft body'
+  } > "$path"
+}
+
+write_draft_spaces_only() {
+  local path="$1"
+  {
+    echo '<!--'
+    printf 'approved_at:    \n'
+    echo '-->'
+    echo ''
+    echo '# draft body'
+  } > "$path"
+}
+
+# 汎用 PASS 期待 assertion (rc=0)
+assert_pass() {
+  local label="$1"; local rc="$2"
+  if [ "$rc" -eq 0 ]; then
+    PASS=$((PASS + 1)); printf "  PASS: %s\n" "$label"
+  else
+    FAIL=$((FAIL + 1)); FAILED_CASES+=("$label (rc=$rc expected 0)")
+    printf "  FAIL: %s (rc=%d expected 0)\n" "$label" "$rc"
+  fi
+}
+
+# 汎用 BLOCK 期待 assertion (rc=2)
+assert_block() {
+  local label="$1"; local rc="$2"
+  if [ "$rc" -eq 2 ]; then
+    PASS=$((PASS + 1)); printf "  PASS: %s\n" "$label"
+  else
+    FAIL=$((FAIL + 1)); FAILED_CASES+=("$label (rc=$rc expected 2)")
+    printf "  FAIL: %s (rc=%d expected 2)\n" "$label" "$rc"
+  fi
+}
+
+# === Case 1 (緩和): .claude/rules/foo.md 新規 Write + 対応 draft 不在 → PASS ===
+case1_rules_no_draft_pass() {
+  local label="Case 1 (緩和): .claude/rules/case1.md w/o draft → PASS (旧 BLOCK)"
+  local fp="${TMP_ROOT}/.claude/rules/case1.md"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 2: .claude/rules/foo.md + draft (approved_at 非空) → PASS ===
+case2_rules_approved_pass() {
+  local label="Case 2: .claude/rules/case2.md w/ approved draft → PASS"
+  local fp="${TMP_ROOT}/.claude/rules/case2.md"
+  write_draft "${TMP_ROOT}/docs/draft/case2.md" "2026-05-26"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 3 (緩和): .claude/rules/foo.md + draft (approved_at key 不在) → PASS ===
+case3_rules_unapproved_pass() {
+  local label="Case 3 (緩和): .claude/rules/case3.md w/ draft (approved_at key absent) → PASS (旧 BLOCK)"
+  local fp="${TMP_ROOT}/.claude/rules/case3.md"
+  write_draft "${TMP_ROOT}/docs/draft/case3.md" "" ""
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 4 (緩和): templates/docs retroactive draft → PASS (warn なし) ===
+case4_templates_retroactive_pass() {
+  local label="Case 4 (緩和): templates/docs retroactive draft → PASS (旧 PASS+warn、現 plain PASS)"
+  local fp="${TMP_ROOT}/.claude/templates/docs/tasks/case4.md"
+  write_draft "${TMP_ROOT}/docs/draft/case4.md" "" "true" "Hirai"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 5 (緩和): ECC_RULE_CHANGE_GUARD_OFF=1 → PASS (env は dead path だが結果 PASS) ===
+case5_rule_guard_off_pass() {
+  local label="Case 5 (緩和): ECC_RULE_CHANGE_GUARD_OFF=1 on rules → PASS (env dead path)"
+  local fp="${TMP_ROOT}/.claude/rules/case5.md"
+  local rc=0
+  run_hook Write "$fp" ECC_RULE_CHANGE_GUARD_OFF=1 >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 6: docs/new-feature.md 新規 Write + draft 不在 → BLOCK (docs/ block 維持、回帰) ===
+case6_docs_root_block_regression() {
+  local label="Case 6 (回帰): docs/case6.md w/o draft → BLOCK (docs/ block 維持)"
+  local fp="${TMP_ROOT}/docs/case6.md"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_block "$label" "$rc"
+}
+
+# === Case 7 (緩和): .claude/commands/foo.md 新規 Write + draft 不在 → PASS ===
+case7_commands_no_draft_pass() {
+  local label="Case 7 (緩和): .claude/commands/case7.md w/o draft → PASS (旧 BLOCK)"
+  local fp="${TMP_ROOT}/.claude/commands/case7.md"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 8: 既存 .claude/rules/<existing>.md Edit → PASS (緩和前後とも) ===
+case8_existing_rules_edit_pass() {
+  local label="Case 8: existing .claude/rules/existing.md Edit → PASS (edit pass-through)"
+  local fp="${TMP_ROOT}/.claude/rules/existing.md"
+  touch "$fp"
+  local rc=0
+  run_hook Edit "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 9: ECC_DRAFT_FLOW_GUARD_OVERRIDE=1 + .claude/rules/foo.md Write → PASS + bypass.log ===
+# override は hook 冒頭 (docs/ block 含む全 path) で維持されるため bypass.log 記録も継続。
+case9_override_env_pass_and_bypass_log() {
+  local label="Case 9: ECC_DRAFT_FLOW_GUARD_OVERRIDE=1 → PASS + bypass.log (override 維持)"
+  local fp="${TMP_ROOT}/.claude/rules/case9.md"
+  local bypass_log="${TMP_ROOT}/.claude/.workflow-state/bypass.log"
+  rm -f "$bypass_log"
+  local rc=0
+  run_hook Write "$fp" ECC_DRAFT_FLOW_GUARD_OVERRIDE=1 >/dev/null 2>&1 || rc=$?
+
+  local bypass_logged=0
+  if [ -f "$bypass_log" ] && grep -q "ECC_DRAFT_FLOW_GUARD_OVERRIDE" "$bypass_log" 2>/dev/null; then
+    bypass_logged=1
+  fi
+
+  if [ "$rc" -eq 0 ] && [ "$bypass_logged" -eq 1 ]; then
+    PASS=$((PASS + 1)); printf "  PASS: %s\n" "$label"
+  else
+    FAIL=$((FAIL + 1)); FAILED_CASES+=("$label (rc=$rc, bypass_logged=$bypass_logged)")
+    printf "  FAIL: %s (rc=%d expected 0, bypass=%d)\n" "$label" "$rc" "$bypass_logged"
+  fi
+}
+
+# === Case 10 (緩和): approved_at: (空白のみ) draft で rules → PASS ===
+case10_approved_at_spaces_only_pass() {
+  local label="Case 10 (緩和): approved_at spaces-only draft + rules → PASS (旧 BLOCK)"
+  local fp="${TMP_ROOT}/.claude/rules/case10.md"
+  write_draft_spaces_only "${TMP_ROOT}/docs/draft/case10.md"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 11 (緩和): approved_at: (key only) draft で rules → PASS ===
+case11_approved_at_key_only_pass() {
+  local label="Case 11 (緩和): approved_at key-only draft + rules → PASS (旧 BLOCK)"
+  local fp="${TMP_ROOT}/.claude/rules/case11.md"
+  write_draft_key_only "${TMP_ROOT}/docs/draft/case11.md"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 12: .claude/rules/sub/foo.md (深さ 2) Write → PASS (緩和前後とも) ===
+case12_rules_subdirectory_depth2_pass() {
+  local label="Case 12: .claude/rules/sub/case12.md (depth 2) Write → PASS"
+  local fp="${TMP_ROOT}/.claude/rules/sub/case12.md"
+  local rc=0
+  run_hook Write "$fp" >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 13 (緩和): HC_RULE_CHANGE_GUARD_ENABLED=false → PASS (config dead path だが結果 PASS) ===
+case13_config_guard_disabled_pass() {
+  local label="Case 13 (緩和): HC_RULE_CHANGE_GUARD_ENABLED=false + rules → PASS (config dead path)"
+  local fp="${TMP_ROOT}/.claude/rules/case13.md"
+  local rc=0
+  run_hook Write "$fp" HC_RULE_CHANGE_GUARD_ENABLED=false >/dev/null 2>&1 || rc=$?
+  assert_pass "$label" "$rc"
+}
+
+# === Case 14: docs/draft/ + docs/tasks/ 配下は対象外 [SKIP] ===
+case14_draft_tasks_exempt_skip() {
+  local label="Case 14: docs/draft/ + docs/tasks/ 配下 exempt → PASS [SKIP: draft-flow-guard-smoke.sh で網羅]"
+  printf "  NOTE: %s\n" "$label"
+}
+
+printf "===== rule-change-draft-flow-guard-smoke (2026-05-28 緩和、13 active + 1 skip) =====\n\n"
+
+case1_rules_no_draft_pass
+case2_rules_approved_pass
+case3_rules_unapproved_pass
+case4_templates_retroactive_pass
+case5_rule_guard_off_pass
+case6_docs_root_block_regression
+case7_commands_no_draft_pass
+case8_existing_rules_edit_pass
+case9_override_env_pass_and_bypass_log
+case10_approved_at_spaces_only_pass
+case11_approved_at_key_only_pass
+case12_rules_subdirectory_depth2_pass
+case13_config_guard_disabled_pass
+case14_draft_tasks_exempt_skip
+
+TOTAL=$((PASS + FAIL))
+printf "\n===== Result =====\n"
+printf "PASS: %d / %d\n" "$PASS" "$TOTAL"
+printf "FAIL: %d / %d\n" "$FAIL" "$TOTAL"
+
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed cases:\n"
+  for c in "${FAILED_CASES[@]}"; do
+    printf "  - %s\n" "$c"
+  done
+  printf "\nsummary: %d/%d PASS\n" "$PASS" "$TOTAL"
+  exit 1
+fi
+
+printf "\nsummary: %d/%d PASS\n" "$PASS" "$TOTAL"
+exit 0

package/.claude/tests/run-all-smokes.sh

@@ -0,0 +1,340 @@
+#!/usr/bin/env bash
+# run-all-smokes.sh — 統合 smoke runner (task-74 Step 4a)
+#
+# 役割:
+#   .claude/tests/*smoke*.sh を全件発見し順次実行、各々の PASS/FAIL/SKIP を集計する。
+#   5 種別でグルーピング表示し、expected-fail manifest に登録された smoke は
+#   EXPECTED-FAIL として別集計する。UNEXPLAINED-FAIL == 0 で exit 0。
+#
+# 5 種別:
+#   parity      — SSoT drift 検出 (yml/settings/CommonRules の整合性)
+#   behavior    — BLOCK/warn 挙動検証
+#   budget      — 軽量性 regression (bytes/count 計測)
+#   portability — cwd/install 差分 (cross-env 堅牢性)
+#   stale-det   — 古い期待値検出 (自己改善系)
+#
+# expected-fail manifest:
+#   _is_expected_fail / _get_expected_reason 関数に "smoke-name" で登録。
+#   runner は smoke 全体が exit 1 した場合に manifest を参照し、
+#   EXPECTED-FAIL vs UNEXPLAINED-FAIL を判定する。
+#
+# 実行:
+#   bash .claude/tests/run-all-smokes.sh [OPTIONS]
+#
+# オプション:
+#   --category <name>  指定種別のみ実行 (parity/behavior/budget/portability/stale-det)
+#   --list             分類一覧を表示して終了
+#   --verbose          各 smoke の全出力を表示
+#
+# 終了コード:
+#   0 = UNEXPLAINED-FAIL == 0 (放置 fail なし)
+#   1 = UNEXPLAINED-FAIL > 0  (説明のつかない fail 存在)
+#
+# 重要制約:
+#   file-top に set -euo pipefail を書かない (feedback_set_e_in_sourced_libs 規範)
+#   declare -A (bash 4+) は使わない (macOS bash 3.2 対応)
+#   実装本体は subshell 関数化で局所化する。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# ============================================================
+# 5 種別 smoke 分類 (bash 3.2 対応: case 文ベース)
+# ============================================================
+_get_smoke_category() {
+  local name="$1"
+  case "$name" in
+    # parity: SSoT drift 検出
+    action-space-count-smoke|\
+    common-rules-import-smoke|\
+    config-feature-toggles-smoke|\
+    effective-hook-matrix-smoke|\
+    enforcement-mismatch-smoke|\
+    harness-config-local-smoke|\
+    hc-config-key-parity-smoke|\
+    hc-config-migration-smoke|\
+    layer-b-context-isolation-smoke|\
+    review-required-min-count-smoke|\
+    reviewer-count-guard-smoke|\
+    rule-architecture-smoke|\
+    settings-dispatcher-baseline-smoke|\
+    wave-precheck-template-smoke)
+      printf 'parity' ;;
+    # budget: 軽量性 regression
+    sessionstart-budget-smoke|\
+    sessionstart-footprint-smoke)
+      printf 'budget' ;;
+    # portability: cwd/install 差分
+    dual-mode-portability-smoke|\
+    hook-cwd-robustness-smoke|\
+    install-sh-sync-drift-smoke|\
+    project-root-smoke|\
+    session-start-parallel-smoke)
+      printf 'portability' ;;
+    # stale-det: 古い期待値自己検出
+    stale-harness-detect-smoke)
+      printf 'stale-det' ;;
+    # behavior: BLOCK/warn 挙動検証 (default)
+    # cli 機能検証 (task-83)
+    npx-cli-smoke)
+      printf 'behavior' ;;
+    *)
+      printf 'behavior' ;;
+  esac
+}
+
+# ============================================================
+# expected-fail manifest (bash 3.2 対応: case 文ベース)
+#
+# task-74 iter-1: manifest を「正当な expected fail」のみに縮小。
+#   - environmental (preset 緩和): harness-dev preset で feature toggle OFF により
+#     guard が advisory 化 / no-op 化する。team-default/strict では BLOCK/WARN する。
+#     恒久 expected (preset 設計上の正常 fail)。
+#   - flaky (quarantine): port contention / worktree timing 由来の間欠 fail。
+#     恒久 expected ではなく next-actions #72 で root-cause 追跡対象。
+#
+# 削除済 (iter-1 で本来処理して PASS 化):
+#   - stale-harness-detect-smoke: config-loader real bug fix (修正 1)
+#   - autonomous-action-guard/audit-followups/loop-auto-progress: obsolete case skip 化 (修正 2)
+#   - context-budget/wave-precheck-template/custom-pm-commands: spec-drift 決定論修正 (修正 3)
+# ============================================================
+_is_expected_fail() {
+  local name="$1"
+  # environmental (preset 緩和、恒久 expected): gateguard / workflow-guard /
+  #   task-rule-guard / list-md-plan-first-reminder / tool-call-slip-detector
+  # flaky (quarantine、next-actions #72 で根本追跡): hc-config-web-ui / install-sh-sync-drift
+  case "$name" in
+    gateguard-smoke|\
+    workflow-guard-smoke|\
+    task-rule-guard-smoke|\
+    list-md-plan-first-reminder-smoke|\
+    tool-call-slip-detector-smoke|\
+    hc-config-web-ui-smoke|\
+    install-sh-sync-drift-smoke)
+      return 0 ;;
+    *)
+      return 1 ;;
+  esac
+}
+
+# NB (fix 5, case 単位 parse の限界): 下記 reason の "Case N/M" は当該 smoke が
+# fail する想定 case。現 runner は smoke 単位 (exit code) で EXPECTED-FAIL 判定するため、
+# 列挙 case 以外が新たに fail しても smoke 全体 exit 1 として同じく EXPECTED-FAIL に
+# 吸収され UNEXPLAINED にならない。本来は列挙 case 以外の fail を UNEXPLAINED 扱い
+# すべきだが case 単位 parse は別 task。SMOKE-CLASSIFICATION.md §limitation に記録。
+_get_expected_reason() {
+  local name="$1"
+  case "$name" in
+    gateguard-smoke)
+      printf '[environmental] harness-dev preset で gateguard が advisory 化 (feature_gateguard_enabled を OFF 設定)。team-default/strict では BLOCK される。enforcement_matrix.gateguard.disabled_reason 参照。expected fail case は Case 1/3 のみ。' ;;
+    workflow-guard-smoke)
+      printf '[environmental] harness-dev preset で workflow_guard が advisory 化 (feature_workflow_guard_enabled=false)。team-default/strict では BLOCK される。expected fail case は Case 2/3/5 のみ。' ;;
+    task-rule-guard-smoke)
+      printf '[environmental] harness-dev preset で task_rule_guard が advisory 化 (feature_task_rule_guard_enabled=false)。Case 1/4 は BLOCK 期待だが advisory で素通り。Case 12 は list-md-plan-first-reminder が同 feature で no-op。expected fail case は Case 1/4/12 のみ。' ;;
+    list-md-plan-first-reminder-smoke)
+      printf '[environmental] feature_task_rule_guard_enabled=false により list-md-plan-first-reminder も no-op (同 feature group)。Case 1/7 が silent になるのは正常。team-default/strict では WARN が発火する。expected fail case は Case 1/7 のみ。' ;;
+    tool-call-slip-detector-smoke)
+      printf '[environmental] feature_tool_call_slip_detect_enabled=false (harness-config.yml、誤検出ループが主因と判明し 2026-06-01 切り分けで意図的 OFF) により hook が no-op。Case 1/2 の detection 期待は feature 有効時前提。feature ON 環境 (consuming repo) では PASS する。expected fail case は Case 1/2 のみ。' ;;
+    hc-config-web-ui-smoke)
+      printf '[flaky-quarantine] port contention / サーバ起動タイミングによる間欠 fail。同一 run で異なる case (S-02/S-39/S-45 等) が不定期 fail。単独再実行では PASS する場合が多い。恒久 expected ではなく next-actions #72 で root-cause 追跡 (web-ui port contention skip 強化)。' ;;
+    install-sh-sync-drift-smoke)
+      printf '[flaky-quarantine] git worktree 状態・rsync タイミング依存の間欠 fail (Case C/E)。単独実行では通常 PASS、parallel runner 実行時または dirty worktree で間欠 fail。恒久 expected ではなく next-actions #72 で root-cause 追跡 (install-sync sequential 実行化)。' ;;
+    *)
+      printf '(no reason recorded)' ;;
+  esac
+}
+
+# ============================================================
+# 引数解析
+# ============================================================
+FILTER_CATEGORY=""
+LIST_ONLY=0
+VERBOSE=0
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --category)
+      FILTER_CATEGORY="$2"
+      shift 2
+      ;;
+    --list)
+      LIST_ONLY=1
+      shift
+      ;;
+    --verbose)
+      VERBOSE=1
+      shift
+      ;;
+    *)
+      printf 'Unknown option: %s\n' "$1" >&2
+      shift
+      ;;
+  esac
+done
+
+# ============================================================
+# --list: 分類一覧表示
+# ============================================================
+if [ "$LIST_ONLY" = "1" ]; then
+  printf '=== Smoke 5-category classification ===\n\n'
+  for cat in parity behavior budget portability stale-det; do
+    printf '[%s]\n' "$cat"
+    for smoke_file in "$SCRIPT_DIR"/*smoke*.sh; do
+      name=$(basename "$smoke_file" .sh)
+      [ "$name" = "run-all-smokes" ] && continue
+      mapped_cat=$(_get_smoke_category "$name")
+      if [ "$mapped_cat" = "$cat" ]; then
+        ef_mark=""
+        _is_expected_fail "$name" && ef_mark=" [EXPECTED-FAIL]"
+        printf '  %s%s\n' "$name" "$ef_mark"
+      fi
+    done
+    printf '\n'
+  done
+  printf '=== Expected-fail manifest (task-74 iter-1: environmental 5 + flaky 2) ===\n\n'
+  for name in gateguard-smoke workflow-guard-smoke task-rule-guard-smoke \
+              list-md-plan-first-reminder-smoke tool-call-slip-detector-smoke \
+              hc-config-web-ui-smoke install-sh-sync-drift-smoke; do
+    reason=$(_get_expected_reason "$name")
+    printf '[%s]\n  %s\n\n' "$name" "$reason"
+  done
+  exit 0
+fi
+
+# ============================================================
+# 集計変数
+# ============================================================
+TOTAL_PASS=0
+TOTAL_EXPECTED_FAIL=0
+TOTAL_UNEXPLAINED_FAIL=0
+TOTAL_SKIP=0
+
+PASS_LIST=""
+EXPECTED_FAIL_LIST=""
+UNEXPLAINED_FAIL_LIST=""
+SKIP_LIST=""
+
+# ============================================================
+# smoke 実行関数
+# ============================================================
+CURRENT_CATEGORY=""
+
+run_smoke() {
+  local smoke_file="$1"
+  local name
+  name=$(basename "$smoke_file" .sh)
+  local cat
+  cat=$(_get_smoke_category "$name")
+
+  # category filter
+  if [ -n "$FILTER_CATEGORY" ] && [ "$cat" != "$FILTER_CATEGORY" ]; then
+    return
+  fi
+
+  # カテゴリ見出し (切替時)
+  if [ "$cat" != "$CURRENT_CATEGORY" ]; then
+    printf '\n--- [%s] ---\n' "$cat"
+    CURRENT_CATEGORY="$cat"
+  fi
+
+  # web-ui smoke: network bind 不可環境 (sandbox/CI) では SKIP
+  if [ "$name" = "hc-config-web-ui-smoke" ]; then
+    if ! python3 -c "import socket; s=socket.socket(); s.bind(('127.0.0.1',0)); s.close()" 2>/dev/null; then
+      printf '  SKIP  %s (network bind unavailable)\n' "$name"
+      TOTAL_SKIP=$((TOTAL_SKIP + 1))
+      SKIP_LIST="${SKIP_LIST} ${name}"
+      return
+    fi
+  fi
+
+  # smoke 実行
+  local out_file
+  out_file=$(mktemp /tmp/smoke-runner-out.XXXXXX)
+  local exit_code=0
+
+  bash "$smoke_file" >"$out_file" 2>&1 || exit_code=$?
+
+  if [ "$VERBOSE" = "1" ]; then
+    cat "$out_file"
+  fi
+
+  if [ "$exit_code" = "0" ]; then
+    printf '  PASS  %s\n' "$name"
+    TOTAL_PASS=$((TOTAL_PASS + 1))
+    PASS_LIST="${PASS_LIST} ${name}"
+  else
+    # expected-fail manifest 参照
+    if _is_expected_fail "$name"; then
+      local reason
+      reason=$(_get_expected_reason "$name")
+      printf '  EXPECTED-FAIL  %s\n' "$name"
+      printf '    reason: %s\n' "$reason"
+      TOTAL_EXPECTED_FAIL=$((TOTAL_EXPECTED_FAIL + 1))
+      EXPECTED_FAIL_LIST="${EXPECTED_FAIL_LIST} ${name}"
+    else
+      printf '  UNEXPLAINED-FAIL  %s (exit=%d)\n' "$name" "$exit_code"
+      # 出力の最後 5 行を表示 (診断支援)
+      tail -5 "$out_file" | sed 's/^/    /'
+      TOTAL_UNEXPLAINED_FAIL=$((TOTAL_UNEXPLAINED_FAIL + 1))
+      UNEXPLAINED_FAIL_LIST="${UNEXPLAINED_FAIL_LIST} ${name}"
+    fi
+  fi
+
+  rm -f "$out_file"
+}
+
+# ============================================================
+# メイン: 種別順でスキャン・実行
+# ============================================================
+printf '=== run-all-smokes.sh (%s) ===\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+printf 'repo: %s\n' "$REPO_ROOT"
+
+for cat in parity behavior budget portability stale-det; do
+  CURRENT_CATEGORY=""
+  for smoke_file in "$SCRIPT_DIR"/*smoke*.sh; do
+    name=$(basename "$smoke_file" .sh)
+    [ "$name" = "run-all-smokes" ] && continue
+    mapped_cat=$(_get_smoke_category "$name")
+    if [ "$mapped_cat" = "$cat" ]; then
+      run_smoke "$smoke_file"
+    fi
+  done
+done
+
+# ============================================================
+# 最終サマリー
+# ============================================================
+TOTAL=$((TOTAL_PASS + TOTAL_EXPECTED_FAIL + TOTAL_UNEXPLAINED_FAIL + TOTAL_SKIP))
+
+printf '\n'
+printf '=== run-all-smokes summary ===\n'
+printf 'Total smokes run : %d\n' "$TOTAL"
+printf 'PASS             : %d\n' "$TOTAL_PASS"
+printf 'EXPECTED-FAIL    : %d (manifest 登録済、reason 付)\n' "$TOTAL_EXPECTED_FAIL"
+printf 'UNEXPLAINED-FAIL : %d\n' "$TOTAL_UNEXPLAINED_FAIL"
+printf 'SKIP             : %d\n' "$TOTAL_SKIP"
+
+if [ -n "$EXPECTED_FAIL_LIST" ]; then
+  printf '\n[EXPECTED-FAIL list]\n'
+  for s in $EXPECTED_FAIL_LIST; do
+    printf '  - %s\n' "$s"
+  done
+fi
+
+if [ -n "$UNEXPLAINED_FAIL_LIST" ]; then
+  printf '\n[UNEXPLAINED-FAIL list -- requires investigation]\n'
+  for s in $UNEXPLAINED_FAIL_LIST; do
+    printf '  - %s\n' "$s"
+  done
+fi
+
+printf '\n'
+if [ "$TOTAL_UNEXPLAINED_FAIL" -eq 0 ]; then
+  printf 'EXIT 0: UNEXPLAINED-FAIL == 0 (放置 fail なし)\n'
+  exit 0
+else
+  printf 'EXIT 1: UNEXPLAINED-FAIL == %d (調査必要)\n' "$TOTAL_UNEXPLAINED_FAIL"
+  exit 1
+fi