@takuma-hirai/hirai-method 0.1.0

package/.claude/tests/hc-config-git-policy-smoke.sh

@@ -0,0 +1,241 @@
+#!/usr/bin/env bash
+# .claude/tests/hc-config-git-policy-smoke.sh — task-77 Step 1
+#
+# 目的:
+#   git 統合ポリシー設定 key 基盤 (mainline_branch + mainline_integration_policy) の
+#   hc-config.sh validation / 値解決 / config-loader env export を検証する。
+#   設計 SSoT: docs/draft/git-integration-policy.md §3.1 / §3.4 / Step 1。
+#
+#   cases:
+#   - Case 1: --get mainline_branch / mainline_integration_policy が default 値を返す
+#   - Case 2: --set mainline_integration_policy=local-merge 成功、=yolo は非 0 reject
+#   - Case 3: --set mainline_branch="bad name" (空白) reject、=develop / =release/1.0 成功
+#   - Case 4: config-loader 経由で HC_MAINLINE_BRANCH / HC_MAINLINE_INTEGRATION_POLICY が
+#             env export される (unknown-key warn が出ない)
+#   - Case 5: 値解決順 env > yml > default (hc-config --get で env override が勝つ)
+#
+# 設計:
+#   - subshell 関数 ( set -uo pipefail; ... ) で各 case を隔離 (既存 script-smoke 慣習)
+#   - 一時 yml は SSoT yml を /tmp/ に copy して破壊操作を本番 yml に波及させない
+#   - file-top に set -euo pipefail を書かない (feedback_set_e_in_sourced_libs 規範)
+#   - bash 3.2 (macOS) + Linux bash 5.x 両対応
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+HC_CONFIG_SCRIPT="${REPO_ROOT}/.claude/scripts/hc-config.sh"
+HC_CONFIG_YML="${REPO_ROOT}/.claude/harness-config.yml"
+CONFIG_LOADER="${REPO_ROOT}/.claude/hooks/lib/config-loader.sh"
+
+TMP_DIR="$(mktemp -d "/tmp/hc-config-git-policy-smoke.XXXXXX")"
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+PASS=0
+FAIL=0
+FAILED_CASES=""
+
+_record() {
+  local result="$1" case_id="$2" desc="$3"
+  if [ "$result" = "PASS" ]; 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="${FAILED_CASES} ${case_id}"
+  fi
+}
+
+# RED guard: hc-config.sh が未実装なら EXPECTED FAIL
+_red_guard() {
+  local case_id="$1"
+  if [ ! -x "${HC_CONFIG_SCRIPT}" ]; then
+    printf '[Case %s] EXPECTED FAIL: hc-config.sh not implemented yet (RED phase)\n' "$case_id" >&2
+    return 1
+  fi
+  return 0
+}
+
+# 破壊操作用に SSoT yml を tmp に copy して返す (stdout に path)
+# 注意: mktemp の suffix 付き template (XXX.yml) は macOS で衝突するため、
+#       counter で衝突しない一意 path を組み立てて cp する。
+_FRESH_YML_COUNTER=0
+_fresh_yml() {
+  _FRESH_YML_COUNTER=$((_FRESH_YML_COUNTER + 1))
+  local f="${TMP_DIR}/cfg.$$.${_FRESH_YML_COUNTER}.yml"
+  cp "$HC_CONFIG_YML" "$f"
+  printf '%s' "$f"
+}
+
+# ============================================================
+# Case 1: --get が default 値を返す
+# ============================================================
+_case_1() (
+  set -uo pipefail
+  _red_guard "1" || return 1
+  local b p
+  b="$(bash "${HC_CONFIG_SCRIPT}" --get mainline_branch 2>/dev/null)"
+  p="$(bash "${HC_CONFIG_SCRIPT}" --get mainline_integration_policy 2>/dev/null)"
+  if [ "$b" != "main" ]; then
+    printf 'Case 1: mainline_branch expected "main", got "%s"\n' "$b" >&2
+    return 1
+  fi
+  if [ "$p" != "pr-required" ]; then
+    printf 'Case 1: mainline_integration_policy expected "pr-required", got "%s"\n' "$p" >&2
+    return 1
+  fi
+  return 0
+)
+
+# ============================================================
+# Case 2: policy enum validation (local-merge OK / yolo reject)
+# ============================================================
+_case_2() (
+  set -uo pipefail
+  _red_guard "2" || return 1
+  local yml; yml="$(_fresh_yml)"
+
+  # local-merge / local-merge-push / pr-required は成功
+  local v
+  for v in pr-required local-merge local-merge-push; do
+    if ! bash "${HC_CONFIG_SCRIPT}" --config "$yml" --set "mainline_integration_policy=${v}" >/dev/null 2>&1; then
+      printf 'Case 2: --set mainline_integration_policy=%s expected success\n' "$v" >&2
+      return 1
+    fi
+    if ! grep -q "^mainline_integration_policy: ${v}\$" "$yml"; then
+      printf 'Case 2: yml not updated to %s\n' "$v" >&2
+      return 1
+    fi
+  done
+
+  # yolo は非 0 reject
+  if bash "${HC_CONFIG_SCRIPT}" --config "$yml" --set "mainline_integration_policy=yolo" >/dev/null 2>&1; then
+    printf 'Case 2: --set mainline_integration_policy=yolo expected reject (non-zero)\n' >&2
+    return 1
+  fi
+  # reject 時 yml は直前の有効値 (local-merge-push) のまま
+  if ! grep -q "^mainline_integration_policy: local-merge-push\$" "$yml"; then
+    printf 'Case 2: reject altered yml value\n' >&2
+    return 1
+  fi
+  return 0
+)
+
+# ============================================================
+# Case 3: mainline_branch charset validation
+# ============================================================
+_case_3() (
+  set -uo pipefail
+  _red_guard "3" || return 1
+  local yml; yml="$(_fresh_yml)"
+
+  # 空白含む値は reject
+  if bash "${HC_CONFIG_SCRIPT}" --config "$yml" --set "mainline_branch=bad name" >/dev/null 2>&1; then
+    printf 'Case 3: --set "mainline_branch=bad name" expected reject (space)\n' >&2
+    return 1
+  fi
+  # reject 時 yml は default のまま
+  if ! grep -q "^mainline_branch: main\$" "$yml"; then
+    printf 'Case 3: reject altered mainline_branch\n' >&2
+    return 1
+  fi
+
+  # develop は成功
+  if ! bash "${HC_CONFIG_SCRIPT}" --config "$yml" --set "mainline_branch=develop" >/dev/null 2>&1; then
+    printf 'Case 3: --set mainline_branch=develop expected success\n' >&2
+    return 1
+  fi
+  if ! grep -q "^mainline_branch: develop\$" "$yml"; then
+    printf 'Case 3: yml not updated to develop\n' >&2
+    return 1
+  fi
+
+  # release/1.0 (slash + dot) は成功
+  if ! bash "${HC_CONFIG_SCRIPT}" --config "$yml" --set "mainline_branch=release/1.0" >/dev/null 2>&1; then
+    printf 'Case 3: --set mainline_branch=release/1.0 expected success\n' >&2
+    return 1
+  fi
+  if ! grep -q "^mainline_branch: release/1.0\$" "$yml"; then
+    printf 'Case 3: yml not updated to release/1.0\n' >&2
+    return 1
+  fi
+  return 0
+)
+
+# ============================================================
+# Case 4: config-loader env export + unknown-key warn 不在
+# ============================================================
+_case_4() (
+  set -uo pipefail
+  if [ ! -f "$CONFIG_LOADER" ]; then
+    printf 'Case 4: config-loader.sh not found: %s\n' "$CONFIG_LOADER" >&2
+    return 1
+  fi
+  local warnfile="${TMP_DIR}/cl-warn.$$"
+  local out
+  out="$(
+    unset HC_MAINLINE_BRANCH HC_MAINLINE_INTEGRATION_POLICY
+    # shellcheck disable=SC1090
+    source "$CONFIG_LOADER" 2>"$warnfile"
+    printf '%s|%s' "${HC_MAINLINE_BRANCH:-UNSET}" "${HC_MAINLINE_INTEGRATION_POLICY:-UNSET}"
+  )"
+  if [ "$out" != "main|pr-required" ]; then
+    printf 'Case 4: config-loader export expected "main|pr-required", got "%s"\n' "$out" >&2
+    return 1
+  fi
+  # mainline / unknown 系 warn が出ていないこと
+  if grep -iE "mainline|unknown_local_key" "$warnfile" >/dev/null 2>&1; then
+    printf 'Case 4: unexpected warn for mainline keys:\n' >&2
+    grep -iE "mainline|unknown_local_key" "$warnfile" >&2
+    return 1
+  fi
+  return 0
+)
+
+# ============================================================
+# Case 5: 値解決順 env > yml > default (hc-config --get で env override が勝つ)
+# ============================================================
+_case_5() (
+  set -uo pipefail
+  _red_guard "5" || return 1
+  local b p
+  b="$(HC_MAINLINE_BRANCH=develop bash "${HC_CONFIG_SCRIPT}" --get mainline_branch 2>/dev/null)"
+  p="$(HC_MAINLINE_INTEGRATION_POLICY=local-merge bash "${HC_CONFIG_SCRIPT}" --get mainline_integration_policy 2>/dev/null)"
+  if [ "$b" != "develop" ]; then
+    printf 'Case 5: env override mainline_branch expected "develop", got "%s"\n' "$b" >&2
+    return 1
+  fi
+  if [ "$p" != "local-merge" ]; then
+    printf 'Case 5: env override mainline_integration_policy expected "local-merge", got "%s"\n' "$p" >&2
+    return 1
+  fi
+  return 0
+)
+
+# ============================================================
+# runner
+# ============================================================
+if _case_1 2>&1; then _record PASS 1 "--get mainline_branch / policy が default を返す"
+else                  _record FAIL 1 "--get mainline_branch / policy が default を返す"; fi
+
+if _case_2 2>&1; then _record PASS 2 "policy enum validation (local-merge OK / yolo reject)"
+else                  _record FAIL 2 "policy enum validation (local-merge OK / yolo reject)"; fi
+
+if _case_3 2>&1; then _record PASS 3 "mainline_branch charset (space reject / develop / release/1.0)"
+else                  _record FAIL 3 "mainline_branch charset (space reject / develop / release/1.0)"; fi
+
+if _case_4 2>&1; then _record PASS 4 "config-loader env export + unknown-key warn 不在"
+else                  _record FAIL 4 "config-loader env export + unknown-key warn 不在"; fi
+
+if _case_5 2>&1; then _record PASS 5 "値解決順 env > yml > default (--get env override)"
+else                  _record FAIL 5 "値解決順 env > yml > default (--get env override)"; fi
+
+TOTAL=$((PASS + FAIL))
+printf '\n--- Result: %d/%d PASS ---\n' "$PASS" "$TOTAL"
+
+if [ "$FAIL" -gt 0 ]; then
+  printf 'FAILED cases:%s\n' "$FAILED_CASES"
+  exit 1
+fi
+exit 0

package/.claude/tests/hc-config-key-parity-smoke.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# .claude/tests/hc-config-key-parity-smoke.sh — task-69 (hc-config key parity) smoke test
+#
+# 目的:
+#   `_yml_list_keys .claude/harness-config.yml` で抽出した YAML top-level key 集合と、
+#   `bash hc-config.sh --list` が出力する key 集合が **完全一致** することを検証する。
+#   SSoT は YAML top-level key (= harness-config.yml の `^[a-z_][a-zA-Z0-9_]*:`)。
+#   metadata (lib/hc-config-metadata.sh) は表示補助であり key 存在判定の SSoT にしない。
+#
+#   現状 (task-69 着手前): metadata 75 key vs yml 79 key の差異で cmd_list() が
+#   未分類 4 key (feature_reviewer_count_guard_enabled / feature_stale_harness_detect_enabled /
+#   harness_version / stale_harness_markers) を出力できず fail していた (履歴)。
+#   Step 1 (cmd_list 未分類 section) + Step 2 (metadata 4 key 追加) で揃え、
+#   Step 8 (task-69 リファクタリング) でさらに slip key 追加により 80 key へ増加。
+#   本 smoke の検証ロジック自体は yml key 数を動的計算するため hardcode を持たない。
+#
+# 設計:
+#   - subshell 関数 ( set -uo pipefail; ... ) で各 case を隔離
+#   - PASS/FAIL カウンタ + 結果出力 + 全 PASS で exit 0
+#   - 不一致時は set 差分 (yml にあって --list に無い / 逆) を生 log 出力
+#
+# 重要制約:
+#   - file-top に set -euo pipefail を書かない (feedback_set_e_in_sourced_libs 規範)
+#   - BSD/GNU bash 両対応 (macOS bash 3.2 + Linux bash 5.x)
+#
+# 起源: task-69 Step 1+2、設計 SSoT: docs/draft/harness-review-remediation-plan.md §4.1
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+HC_CONFIG_SCRIPT="${REPO_ROOT}/.claude/scripts/hc-config.sh"
+HC_CONFIG_YML="${REPO_ROOT}/.claude/harness-config.yml"
+
+PASS=0
+FAIL=0
+FAILED_CASES=""
+
+_record() {
+  local result="$1"
+  local case_id="$2"
+  local desc="$3"
+  if [ "$result" = "PASS" ]; 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="${FAILED_CASES} ${case_id}"
+  fi
+}
+
+# yml top-level key を抽出 (hc-config.sh の _yml_list_keys と同一 regex)
+_yml_keys() {
+  grep -E '^[a-z_][a-zA-Z0-9_]*:' "${HC_CONFIG_YML}" 2>/dev/null | sed -E 's/:.*$//'
+}
+
+# --list 出力から key を抽出。
+#   行頭 `^<key> ` (key + 空白) の data 行を拾う。section header (=== ... ===) /
+#   table header (KEY ...) / 空行は除外。
+_list_keys() {
+  bash "${HC_CONFIG_SCRIPT}" --list 2>/dev/null \
+    | grep -E '^[a-z_][a-zA-Z0-9_]*[[:space:]]' \
+    | awk '{print $1}'
+}
+
+# ============================================================
+# Case 1: yml key set == --list key set (完全一致)
+# ============================================================
+_case_1() (
+  set -uo pipefail
+
+  if [ ! -x "${HC_CONFIG_SCRIPT}" ]; then
+    printf 'Case 1: hc-config.sh not executable\n' >&2
+    return 1
+  fi
+  if [ ! -f "${HC_CONFIG_YML}" ]; then
+    printf 'Case 1: harness-config.yml not found\n' >&2
+    return 1
+  fi
+
+  local yml_keys list_keys yml_count list_count
+  yml_keys="$(_yml_keys | sort)"
+  list_keys="$(_list_keys | sort -u)"
+  yml_count=$(printf '%s\n' "$yml_keys" | grep -c .)
+  list_count=$(printf '%s\n' "$list_keys" | grep -c .)
+
+  printf 'Case 1: yml_count=%d list_count=%d\n' "$yml_count" "$list_count" >&2
+
+  local missing_in_list extra_in_list
+  missing_in_list="$(comm -23 <(printf '%s\n' "$yml_keys") <(printf '%s\n' "$list_keys"))"
+  extra_in_list="$(comm -13 <(printf '%s\n' "$yml_keys") <(printf '%s\n' "$list_keys"))"
+
+  local ok=0
+  if [ -n "$missing_in_list" ]; then
+    printf 'Case 1: in yml but NOT in --list output:\n%s\n' "$missing_in_list" >&2
+    ok=1
+  fi
+  if [ -n "$extra_in_list" ]; then
+    printf 'Case 1: in --list output but NOT in yml:\n%s\n' "$extra_in_list" >&2
+    ok=1
+  fi
+  if [ "$yml_count" -ne "$list_count" ]; then
+    printf 'Case 1: count mismatch yml=%d list=%d\n' "$yml_count" "$list_count" >&2
+    ok=1
+  fi
+
+  [ "$ok" -eq 0 ]
+)
+
+# ============================================================
+# Case 2: --list / --verbose / --show-default の全 mode で key set 不変
+# ============================================================
+# mode によって出力列は変わるが key 集合 (= 全 yml key) は不変であるべき。
+_case_2() (
+  set -uo pipefail
+
+  local yml_count
+  yml_count=$(_yml_keys | grep -c .)
+
+  local mode count
+  local ok=0
+  for mode in "--list" "--list --verbose" "--list --show-default"; do
+    # shellcheck disable=SC2086
+    count=$(bash "${HC_CONFIG_SCRIPT}" $mode 2>/dev/null \
+      | grep -E '^[a-z_][a-zA-Z0-9_]*[[:space:]]' | awk '{print $1}' | sort -u | grep -c .)
+    if [ "$count" -ne "$yml_count" ]; then
+      printf 'Case 2: mode "%s" key count=%d != yml=%d\n' "$mode" "$count" "$yml_count" >&2
+      ok=1
+    fi
+  done
+
+  [ "$ok" -eq 0 ]
+)
+
+# --- run ---
+printf '=== hc-config key parity smoke ===\n'
+
+_case_1 && _record PASS 1 "yml key set == --list key set (完全一致)" \
+       || _record FAIL 1 "yml key set == --list key set (完全一致)"
+_case_2 && _record PASS 2 "--list / --verbose / --show-default で key set 不変" \
+       || _record FAIL 2 "--list / --verbose / --show-default で key set 不変"
+
+printf '\n=== Result: %d PASS, %d FAIL ===\n' "$PASS" "$FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  printf 'Failed cases:%s\n' "$FAILED_CASES"
+  exit 1
+fi
+exit 0

package/.claude/tests/hc-config-migration-smoke.sh

@@ -0,0 +1,251 @@
+#!/usr/bin/env bash
+# .claude/tests/hc-config-migration-smoke.sh — task-69 Step 4 (local override warning + key migration) smoke
+#
+# 目的:
+#   Step 4 で追加する 2 機構を検証する。
+#   (1) config-loader.sh の unknown_local_key warning:
+#       harness-config.local.yml にのみ存在し SSoT harness-config.yml に無い top-level key を
+#       source 時に stderr へ `unknown_local_key` warning として表示する (誤字検出)。
+#   (2) hc-config.sh の deprecated_keys table + `migrate` subcommand:
+#       deprecated table に登録された old key を yml から検出 → new key に値を移行 → 移行ログを出力。
+#       移行後も old key が残っていれば非0 exit (smoke fail trigger)。
+#       Step1-2 の cmd_list (parity) を壊さないこと。
+#
+# 設計:
+#   - subshell 関数 ( set -uo pipefail; ... ) で各 case を隔離
+#   - test isolation: /tmp に temp yml / local.yml を作り --config / HC_LOCAL_CONFIG_PATH で差し替える
+#   - PASS/FAIL カウンタ + 結果出力 + 全 PASS で exit 0
+#
+# 重要制約:
+#   - file-top に set -euo pipefail を書かない (feedback_set_e_in_sourced_libs 規範)
+#   - BSD/GNU bash 両対応 (macOS bash 3.2 + Linux bash 5.x)
+#
+# 起源: task-69 Step 4、設計 SSoT: docs/draft/harness-review-remediation-plan.md §4.1
+#       「local override の扱い」「migration の扱い」
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+HC_CONFIG_SCRIPT="${REPO_ROOT}/.claude/scripts/hc-config.sh"
+CONFIG_LOADER="${REPO_ROOT}/.claude/hooks/lib/config-loader.sh"
+
+PASS=0
+FAIL=0
+FAILED_CASES=""
+
+_record() {
+  local result="$1"
+  local case_id="$2"
+  local desc="$3"
+  if [ "$result" = "PASS" ]; 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="${FAILED_CASES} ${case_id}"
+  fi
+}
+
+# temp 作業ディレクトリ (各 case が自前で mktemp -d する方が isolation しやすい)
+_mk_tmpdir() {
+  mktemp -d "/tmp/hc-config-migration-smoke.XXXXXX"
+}
+
+# ============================================================
+# Case 1: unknown_local_key warning — local.yml にのみ存在する key を warning 表示
+# ============================================================
+_case_1() (
+  set -uo pipefail
+  local td
+  td=$(_mk_tmpdir) || return 1
+  # cleanup
+  trap 'rm -rf "$td"' EXIT
+
+  # SSoT yml (known key 1 件)
+  printf 'task_dir: docs/tasks\n' > "${td}/harness-config.yml"
+  # local.yml: known override 1 件 + unknown 1 件 (typo 想定)
+  printf 'task_dir: docs/tickets\ntsak_dir: docs/oops\n' > "${td}/harness-config.local.yml"
+
+  # config-loader.sh を source して stderr を捕捉
+  local err
+  err=$(
+    HC_CONFIG_PATH="${td}/harness-config.yml" \
+    HC_LOCAL_CONFIG_PATH="${td}/harness-config.local.yml" \
+    bash -c "source '${CONFIG_LOADER}' >/dev/null" 2>&1
+  )
+
+  printf 'Case 1: stderr=%s\n' "$err" >&2
+
+  # unknown_local_key warning に typo key 名 (tsak_dir) が含まれること
+  case "$err" in
+    *unknown_local_key*tsak_dir*|*tsak_dir*unknown_local_key*) return 0 ;;
+    *) printf 'Case 1: unknown_local_key warning for tsak_dir not found\n' >&2; return 1 ;;
+  esac
+)
+
+# ============================================================
+# Case 2: known local key は warning を出さない (誤検知なし)
+# ============================================================
+_case_2() (
+  set -uo pipefail
+  local td
+  td=$(_mk_tmpdir) || return 1
+  trap 'rm -rf "$td"' EXIT
+
+  printf 'task_dir: docs/tasks\ndraft_dir: docs/draft\n' > "${td}/harness-config.yml"
+  # local.yml: known key のみ
+  printf 'task_dir: docs/tickets\n' > "${td}/harness-config.local.yml"
+
+  local err
+  err=$(
+    HC_CONFIG_PATH="${td}/harness-config.yml" \
+    HC_LOCAL_CONFIG_PATH="${td}/harness-config.local.yml" \
+    bash -c "source '${CONFIG_LOADER}' >/dev/null" 2>&1
+  )
+
+  printf 'Case 2: stderr=%s\n' "$err" >&2
+
+  case "$err" in
+    *unknown_local_key*) printf 'Case 2: false positive unknown_local_key for known key\n' >&2; return 1 ;;
+    *) return 0 ;;
+  esac
+)
+
+# ============================================================
+# Case 3: local.yml 不在環境は no-op (warning なし、graceful)
+# ============================================================
+_case_3() (
+  set -uo pipefail
+  local td
+  td=$(_mk_tmpdir) || return 1
+  trap 'rm -rf "$td"' EXIT
+
+  printf 'task_dir: docs/tasks\n' > "${td}/harness-config.yml"
+  # local.yml は作らない
+
+  local err
+  err=$(
+    HC_CONFIG_PATH="${td}/harness-config.yml" \
+    HC_LOCAL_CONFIG_PATH="${td}/harness-config.local.yml" \
+    bash -c "source '${CONFIG_LOADER}' >/dev/null" 2>&1
+  )
+
+  case "$err" in
+    *unknown_local_key*) printf 'Case 3: unexpected unknown_local_key on missing local.yml\n' >&2; return 1 ;;
+    *) return 0 ;;
+  esac
+)
+
+# ============================================================
+# Case 4: migrate — deprecated old key が yml に無ければ "no migration" + exit 0
+# ============================================================
+_case_4() (
+  set -uo pipefail
+  local td
+  td=$(_mk_tmpdir) || return 1
+  trap 'rm -rf "$td"' EXIT
+
+  # deprecated old key を含まない yml
+  printf 'task_dir: docs/tasks\n' > "${td}/harness-config.yml"
+
+  local out rc
+  out=$(HC_ALLOW_EXTERNAL_CONFIG=1 bash "${HC_CONFIG_SCRIPT}" --config "${td}/harness-config.yml" --migrate 2>&1)
+  rc=$?
+
+  printf 'Case 4: rc=%d out=%s\n' "$rc" "$out" >&2
+  [ "$rc" -eq 0 ]
+)
+
+# ============================================================
+# Case 5: migrate — old key 検出 → new key へ値移行 + 移行ログ + exit 0
+# ============================================================
+# deprecated_keys table に少なくとも 1 entry が存在する前提で、
+# その old key を yml に注入して migrate が new key に値を移し old key を消すことを検証する。
+_case_5() (
+  set -uo pipefail
+  local td
+  td=$(_mk_tmpdir) || return 1
+  trap 'rm -rf "$td"' EXIT
+
+  # hc-config.sh が公開する deprecated mapping の先頭 entry を取得
+  # (実装は `--migrate --dry-run` 不要、deprecated table を smoke から直接読めるよう
+  #  hc-config.sh に `--list-deprecated` を持たせる。"old -> new" の行を期待。)
+  # 注: --config <path> は file 存在を要求するため、先に dummy yml を作る。
+  printf 'task_dir: docs/tasks\n' > "${td}/harness-config.yml"
+  local dep_line old_key new_key
+  dep_line=$(HC_ALLOW_EXTERNAL_CONFIG=1 bash "${HC_CONFIG_SCRIPT}" --config "${td}/harness-config.yml" --list-deprecated 2>/dev/null \
+    | grep -E '\->' | head -n 1)
+  if [ -z "$dep_line" ]; then
+    printf 'Case 5: no deprecated_keys entry (table empty) — skip-as-pass (placeholder seed needed)\n' >&2
+    # deprecated table が空でも実装としては正しい (将来の rename 用)。
+    # ただし Step 4 では最低 1 seed entry を期待するため fail。
+    return 1
+  fi
+  old_key=$(printf '%s' "$dep_line" | awk -F'->' '{gsub(/[[:space:]]/,"",$1); print $1}')
+  new_key=$(printf '%s' "$dep_line" | awk -F'->' '{gsub(/[[:space:]]/,"",$2); print $2}')
+  printf 'Case 5: deprecated %s -> %s\n' "$old_key" "$new_key" >&2
+
+  # yml に old key を注入 (new key は存在しない状態)
+  printf '%s: migrated_value_xyz\ntask_dir: docs/tasks\n' "$old_key" > "${td}/harness-config.yml"
+
+  local out rc
+  out=$(HC_ALLOW_EXTERNAL_CONFIG=1 bash "${HC_CONFIG_SCRIPT}" --config "${td}/harness-config.yml" --migrate 2>&1)
+  rc=$?
+  printf 'Case 5: rc=%d out=%s\n' "$rc" "$out" >&2
+
+  # 移行後 yml: old key 消失 + new key に値が移っている
+  local has_old has_new_val
+  has_old=$(grep -cE "^${old_key}:" "${td}/harness-config.yml" || true)
+  has_new_val=$(grep -E "^${new_key}:" "${td}/harness-config.yml" | grep -c 'migrated_value_xyz' || true)
+
+  local ok=0
+  [ "$rc" -ne 0 ] && { printf 'Case 5: migrate exit != 0\n' >&2; ok=1; }
+  [ "$has_old" -ne 0 ] && { printf 'Case 5: old key %s still present after migrate\n' "$old_key" >&2; ok=1; }
+  [ "$has_new_val" -eq 0 ] && { printf 'Case 5: new key %s did not receive migrated value\n' "$new_key" >&2; ok=1; }
+  case "$out" in
+    *migrat*) : ;;
+    *) printf 'Case 5: migration log line not found in output\n' >&2; ok=1 ;;
+  esac
+
+  [ "$ok" -eq 0 ]
+)
+
+# ============================================================
+# Case 6: migrate 後の parity 不変 — Step1-2 cmd_list を壊していない
+# ============================================================
+# real SSoT yml で --list が yml key set と一致し続けることを確認 (regression guard)。
+_case_6() (
+  set -uo pipefail
+  local yml="${REPO_ROOT}/.claude/harness-config.yml"
+  local yml_count list_count
+  yml_count=$(grep -E '^[a-z_][a-zA-Z0-9_]*:' "$yml" | sed -E 's/:.*$//' | sort -u | grep -c .)
+  list_count=$(bash "${HC_CONFIG_SCRIPT}" --list 2>/dev/null \
+    | grep -E '^[a-z_][a-zA-Z0-9_]*[[:space:]]' | awk '{print $1}' | sort -u | grep -c .)
+  printf 'Case 6: yml_count=%d list_count=%d\n' "$yml_count" "$list_count" >&2
+  [ "$yml_count" -eq "$list_count" ]
+)
+
+# --- run ---
+printf '=== hc-config migration / local-warning smoke ===\n'
+
+_case_1 && _record PASS 1 "unknown_local_key warning (local 専用 key を検出)" \
+       || _record FAIL 1 "unknown_local_key warning (local 専用 key を検出)"
+_case_2 && _record PASS 2 "known local key は warning なし (誤検知なし)" \
+       || _record FAIL 2 "known local key は warning なし (誤検知なし)"
+_case_3 && _record PASS 3 "local.yml 不在は no-op (graceful)" \
+       || _record FAIL 3 "local.yml 不在は no-op (graceful)"
+_case_4 && _record PASS 4 "migrate: deprecated key 不在で no-op + exit 0" \
+       || _record FAIL 4 "migrate: deprecated key 不在で no-op + exit 0"
+_case_5 && _record PASS 5 "migrate: old key 検出 → new key 移行 + ログ + old 消失" \
+       || _record FAIL 5 "migrate: old key 検出 → new key 移行 + ログ + old 消失"
+_case_6 && _record PASS 6 "migrate 機構追加後も --list parity 不変 (regression)" \
+       || _record FAIL 6 "migrate 機構追加後も --list parity 不変 (regression)"
+
+printf '\n=== Result: %d PASS, %d FAIL ===\n' "$PASS" "$FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  printf 'Failed cases:%s\n' "$FAILED_CASES"
+  exit 1
+fi
+exit 0