@qijenchen/design-system 0.1.0-beta.8 → 0.1.0-beta.81

package/ds-canonical/hooks/retired/pre_write_subsumption_check.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+# PreToolUse Write / Edit: before adding NEW governance entry, check if existing
+# homes already cover the topic. Prevents CLAUDE.md / Meta-Pattern / spec drift
+# from append-only accumulation(CLAUDE.md 資訊治理 canonical「上游加 = 下游減」+
+# mindset #6 + M10 exhaustive scan)。
+#
+# Scope A — New file(Write only):
+#   - new memory_*.md      → grep MEMORY.md for similar topic
+#   - new hook             → grep existing hooks for similar pattern
+#   - new skill            → grep .claude/skills/ for similar purpose
+#   - new spec.md          → grep existing specs for same component name
+#
+# Scope B — Meta-Pattern M-row addition(Edit CLAUDE.md,2026-04-25 G4):
+#   當 Edit CLAUDE.md new_string 包含新增 M-row pattern(`| **M\d+** |`),prompt:
+#     - 列出被吸收可刪的下游 M-row / specific bug / memory entry
+#     - world-class benchmark(≥ 3 家,M8 強制)
+#     - Rule-of-3 check:本 pattern 已在 3+ 處 → 需挑 SSOT owner
+#
+# Output: additionalContext warning — Claude 必 acknowledge + answer 3 題才能繼續。
+# Non-blocking mechanical exit(0);enforcement 靠 Claude 讀 additionalContext 自律。
+
+# Per-hook fire logging(enables /knowledge-prune D2 dead-hook detection)
+source "$(dirname "$0")/_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -euo pipefail
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+[ -z "$FILE_PATH" ] && exit 0
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+cd "$PROJECT_DIR" || exit 0
+
+# ── Scope B: Meta-Pattern addition(Edit CLAUDE.md)── EARLY FIRE before new-file check
+case "$FILE_PATH" in
+  */CLAUDE.md)
+    if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "MultiEdit" ] || [ "$TOOL_NAME" = "Write" ]; then
+      # Pull new content(Write: tool_input.content / Edit: new_string / MultiEdit: edits[].new_string)
+      NEW_CONTENT=$(echo "$INPUT" | jq -r '
+        (.tool_input.content // "") + "\n" +
+        (.tool_input.new_string // "") + "\n" +
+        ([.tool_input.edits[]? | .new_string] | join("\n"))
+      ' 2>/dev/null || echo "")
+
+      # Detect new M-row pattern:CLAUDE.md Meta-Pattern 表格的 row 格式
+      # `| **M\d+** |` 或 `| \*\*M\d+\*\* |`(markdown bold escape 不同呈現)
+      if echo "$NEW_CONTENT" | grep -qE '\|\s*\*\*M[0-9]+\*\*\s*\|'; then
+        M_ROW=$(echo "$NEW_CONTENT" | grep -oE '\*\*M[0-9]+\*\*' | head -1 | tr -d '*')
+        MSG="🧭 Meta-Pattern 新增偵測(${M_ROW})— CLAUDE.md 資訊治理 canonical「上游加 = 下游減」+ M8(world-class benchmark)+ M10(exhaustive scan)觸發 3 題強制 self-check:\n\n"
+        MSG="${MSG}1. **World-class benchmark**(M8 強制):≥ 3 家 world-class DS(Polaris / Material / Atlassian / Ant / Carbon / Apple HIG / VS Code / Figma / Slack / Notion)的對照?列具體實作名或 API。\n\n"
+        MSG="${MSG}2. **上游加 = 下游減**(M10 + 資訊治理 retire pipeline):新 M-row 吸收了哪些既有內容?具體列:\n"
+        MSG="${MSG}   - 被吸收的下游 M-row(如 M3 加新章後,M5 某條變冗餘 → 可刪)\n"
+        MSG="${MSG}   - 被吸收的 specific bug(historical-bugs.md 內記的事件)\n"
+        MSG="${MSG}   - 被吸收的 memory entry(feedback_*.md / project_*.md)\n"
+        MSG="${MSG}   - 「無」也要明寫(空白不算回答)\n\n"
+        MSG="${MSG}3. **Rule-of-3**(資訊治理 canonical):本 pattern 概念在幾處出現?若已 ≥ 3 → 選 SSOT owner,其他 pointer only。新 M-row 是 SSOT 本身還是 pointer?\n\n"
+        MSG="${MSG}⚠️ 未在本輪對話明確回答 3 題前,禁止 commit 這個 edit。回答後繼續 OK。"
+        ESCAPED=$(printf '%b' "$MSG" | jq -Rs .)
+        printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","additionalContext":%s}}\n' "$ESCAPED"
+        exit 0
+      fi
+    fi
+    ;;
+esac
+
+# ── Scope A: New file detection ──
+# Only fire for NEW files (Write creates; Edit modifies existing)
+[ -f "$FILE_PATH" ] && exit 0
+
+BASENAME=$(basename "$FILE_PATH" .md)
+BASENAME=${BASENAME%.sh}
+BASENAME=${BASENAME%.py}
+
+MATCHES=""
+
+case "$FILE_PATH" in
+  */memory/*.md)
+    # Extract keywords from filename (e.g. feedback_xxx_yyy → xxx yyy)
+    KEYWORDS=$(echo "$BASENAME" | tr '_' ' ' | awk '{for(i=2;i<=NF;i++) printf "%s ",$i}')
+    MEMORY_DIR=$(dirname "$FILE_PATH")
+    [ -d "$MEMORY_DIR" ] && MATCHES=$(ls "$MEMORY_DIR" 2>/dev/null | grep -iE "$(echo "$KEYWORDS" | tr ' ' '|')" | head -3 || true)
+    HOME_LABEL="memory"
+    ;;
+  */.claude/hooks/*)
+    # New hook — check for similar name
+    KEYWORDS=$(echo "$BASENAME" | tr '_' ' ' | awk '{for(i=2;i<=NF;i++) printf "%s ",$i}')
+    [ -z "$KEYWORDS" ] && KEYWORDS="$BASENAME"
+    MATCHES=$(ls .claude/hooks/ 2>/dev/null | grep -iE "$(echo "$KEYWORDS" | tr ' ' '|')" | head -3 || true)
+    HOME_LABEL="hook"
+    ;;
+  */.claude/skills/*/SKILL.md)
+    # New skill — grep existing skill names
+    MATCHES=$(ls .claude/skills/ 2>/dev/null | grep -iE "$BASENAME" | head -3 || true)
+    HOME_LABEL="skill"
+    ;;
+  *.spec.md)
+    # New spec — grep existing specs for same component
+    MATCHES=$(find packages/design-system/src -name "${BASENAME}*" 2>/dev/null | head -3 || true)
+    HOME_LABEL="spec"
+    ;;
+  *) exit 0 ;;
+esac
+
+[ -z "$MATCHES" ] && exit 0
+
+MSG="📋 Creating new ${HOME_LABEL} file: ${FILE_PATH}\nPossibly-related existing files:\n$(echo "$MATCHES" | sed 's/^/  /')\nBefore writing, verify: (a) is this a duplicate? (b) can we extend an existing file instead? (c) CLAUDE.md Rule-of-3 SSOT — if concept exists in 3+ places, pick one owner, others point."
+
+ESCAPED=$(printf '%s' "$MSG" | jq -Rs .)
+printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","additionalContext":%s}}\n' "$ESCAPED"
+exit 0

package/ds-canonical/hooks/retired/stop_meta_self_audit.sh.retired-2026-05-13

@@ -0,0 +1,76 @@
+#!/bin/bash
+set -uo pipefail
+# Stop hook: META-LEVEL self-audit — auto-question「現在還是 best-practice 嗎?」
+# 取代 user 必須親問。User mandate「我希望我可以再也不用問你這個問題,你可以
+# 自己問自己並自我自動改善」(2026-04-26)。
+#
+# Mechanism:
+#   1. Run scripts/score-infra-best-practice.mjs(8 dimensions, 0-100)
+#   2. Compare current score to last logged baseline
+#   3. If REGRESSION(score dropped)OR ANY DIM < 80 → inject MAXIMUM-strength
+#      self-improve prompt to next-turn additionalContext
+#   4. AI 看到 inject 自動採取 corrective action,不靠 user 提醒
+#
+# Frequency: every Stop event(low cost ~200ms — 主要是 tsc check)
+#
+# 為什麼必要:M14/M19 markdown 規則 + stop_self_audit specific check 都不抓
+# meta 「整個 infra 還是 best-practice 嗎」這層。本 hook 補位。
+
+source "$(dirname "$0")/_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -uo pipefail
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+cd "$PROJECT_DIR" || exit 0
+
+LOG_FILE=".claude/logs/infra-best-practice-score.jsonl"
+
+# Run scoring(production mode silent stdout, only update log)
+SCORE_OUTPUT=$(node scripts/score-infra-best-practice.mjs --json 2>/dev/null)
+[ -z "$SCORE_OUTPUT" ] && exit 0
+
+CURRENT_SCORE=$(echo "$SCORE_OUTPUT" | jq -r '.finalScore // 0' 2>/dev/null || echo 0)
+[ "$CURRENT_SCORE" = "0" ] && exit 0  # script error, skip
+
+# Compare to PREVIOUS score(2nd-to-last entry — last is current run)
+PREV_SCORE=0
+if [ -f "$LOG_FILE" ]; then
+  # Get 2nd-to-last entry's finalScore
+  PREV_SCORE=$(tail -2 "$LOG_FILE" | head -1 | jq -r '.finalScore // 0' 2>/dev/null || echo 0)
+fi
+
+WARNINGS=""
+
+# Trigger 1: Regression(score dropped ≥ 5)
+if [ "$PREV_SCORE" -gt 0 ] && [ "$CURRENT_SCORE" -lt "$PREV_SCORE" ]; then
+  DROP=$((PREV_SCORE - CURRENT_SCORE))
+  if [ "$DROP" -ge 5 ]; then
+    WARNINGS="${WARNINGS}\n  🚨 SCORE REGRESSION: ${PREV_SCORE} → ${CURRENT_SCORE}(drop ${DROP})"
+  fi
+fi
+
+# Trigger 2: Any dim < 80
+LOW_DIMS=$(echo "$SCORE_OUTPUT" | jq -r '.dimensions[] | select(.score < 80) | "\(.dim): \(.score)/100 (\(.value))"' 2>/dev/null)
+if [ -n "$LOW_DIMS" ]; then
+  WARNINGS="${WARNINGS}\n  ⚠️  Sub-threshold dimensions:\n$(echo "$LOW_DIMS" | sed 's/^/    • /')"
+fi
+
+# Trigger 3: Below 80 overall
+if [ "$CURRENT_SCORE" -lt 80 ]; then
+  WARNINGS="${WARNINGS}\n  ❌ Overall score ${CURRENT_SCORE}/100 below threshold 80"
+fi
+
+# Silent if all green
+[ -z "$WARNINGS" ] && exit 0
+
+# Stop hooks 的 JSON schema 不接受 hookSpecificOutput.additionalContext
+# (only SessionStart/PostToolUse/UserPromptSubmit do)。改 silent log-to-file
+# + exit 0 — score regression 寫 .claude/logs/score-history.jsonl,user 不被打擾。
+mkdir -p "$PROJECT_DIR/.claude/logs" 2>/dev/null
+printf '{"ts":"%s","score":%s,"prev":%s,"warnings":%s}\n' \
+  "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+  "$CURRENT_SCORE" "$PREV_SCORE" \
+  "$(printf '%b' "$WARNINGS" | jq -Rs .)" \
+  >> "$PROJECT_DIR/.claude/logs/score-history.jsonl" 2>/dev/null || true
+
+exit 0

package/ds-canonical/hooks/retired/tests/test_check_anatomy_section_numbering.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_anatomy_section_numbering.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-anatomy file → silent skip"
+run_hook "/tmp/foo.stories.tsx" "export const X = {}"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL ($STDOUT)"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_avatar_hovercard.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_avatar_hovercard.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_avatar_hovercard.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_container_breathing.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_container_breathing.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_container_breathing.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_governance_compliance.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_governance_compliance.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_governance_compliance.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-governance file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_icon_only_padding_formula.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+# Tests for check_icon_only_padding_formula.sh
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_icon_only_padding_formula.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+
+PASS=0; FAIL=0; FAILED=""
+
+run_hook() {
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e; printf '%s' "$1" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"; EXIT=$?; set -e
+  STDOUT_TEXT=$(cat "$STDOUT"); rm -f "$STDOUT" "$STDERR"
+}
+
+expect_fire() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -q "padding-free idiom"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (exit=$EXIT, stdout='$STDOUT_TEXT')"
+    FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - $name"
+  fi
+}
+
+expect_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDOUT_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (exit=$EXIT, stdout='$STDOUT_TEXT')"
+    FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - $name"
+  fi
+}
+
+# Test 1: iconOnly + 16px formula → fire
+echo "Test 1: iconOnly host + padding-formula 16px"
+C='const ICON_ONLY = {sm:"px-[calc((var(--field-height-sm)-16px)/2)]"}; const Foo = ({iconOnly}) => null;'
+P=$(jq -nc --arg fp "/abs/packages/design-system/src/components/Foo/foo.tsx" --arg c "$C" '{tool_name:"Write",tool_input:{file_path:$fp,content:$c}}')
+run_hook "$P"; expect_fire "Test 1 padding-formula fires"
+
+# Test 2: vertical 1lh formula(label centering)— should NOT fire
+echo "Test 2: vertical 1lh formula silent"
+C='const PAD = "py-[calc((var(--field-height-sm)-1lh)/2)]"; export const Foo = ({iconOnly}) => null;'
+P=$(jq -nc --arg fp "/abs/packages/design-system/src/components/Foo/foo.tsx" --arg c "$C" '{tool_name:"Write",tool_input:{file_path:$fp,content:$c}}')
+run_hook "$P"; expect_silent "Test 2 1lh formula silent"
+
+# Test 3: 16px formula but no iconOnly keyword → silent
+echo "Test 3: formula without iconOnly keyword silent"
+C='const PAD = "px-[calc((var(--field-height-sm)-16px)/2)]"; export const Foo = () => null;'
+P=$(jq -nc --arg fp "/abs/packages/design-system/src/components/Foo/foo.tsx" --arg c "$C" '{tool_name:"Write",tool_input:{file_path:$fp,content:$c}}')
+run_hook "$P"; expect_silent "Test 3 no iconOnly keyword silent"
+
+# Test 4: allowlist comment → bypass
+echo "Test 4: allowlist bypass"
+C='// @icon-only-padding-allow: legacy
+const ICON_ONLY = "px-[calc((var(--field-height-sm)-16px)/2)]";
+const Foo = ({iconOnly}) => null;'
+P=$(jq -nc --arg fp "/abs/packages/design-system/src/components/Foo/foo.tsx" --arg c "$C" '{tool_name:"Write",tool_input:{file_path:$fp,content:$c}}')
+run_hook "$P"; expect_silent "Test 4 allowlist bypass"
+
+# Test 5: stories.tsx scope skip
+echo "Test 5: stories.tsx out of scope"
+C='const ICON_ONLY = "px-[calc((var(--field-height-sm)-16px)/2)]"; const iconOnly = true;'
+P=$(jq -nc --arg fp "/abs/packages/design-system/src/components/Foo/foo.stories.tsx" --arg c "$C" '{tool_name:"Write",tool_input:{file_path:$fp,content:$c}}')
+run_hook "$P"; expect_silent "Test 5 stories.tsx skip"
+
+# Test 6: non-DS path skip
+echo "Test 6: non-DS path skip"
+C='const ICON_ONLY = "px-[calc((var(--field-height-sm)-16px)/2)]"; const iconOnly = true;'
+P=$(jq -nc --arg fp "/abs/src/app/MyPage.tsx" --arg c "$C" '{tool_name:"Write",tool_input:{file_path:$fp,content:$c}}')
+run_hook "$P"; expect_silent "Test 6 non-DS skip"
+
+echo ""
+echo "════ Results: $PASS PASS, $FAIL FAIL ════"
+[ "$FAIL" -gt 0 ] && { printf "Failed:%b\n" "$FAILED"; exit 1; }
+exit 0

package/ds-canonical/hooks/retired/tests/test_check_item_content_primitive.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_item_content_primitive.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_item_content_primitive.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_item_list_gap.sh

@@ -0,0 +1,163 @@
+#!/bin/bash
+# Tests for check_item_list_gap.sh
+#
+# Drives PreToolUse Edit/Write payloads on stdin and verifies P1 warn vs P2 block
+# vs pass for FileItem list wrapper canonical(item-anatomy.spec.md「連續 item
+# 貼邊合法性 v2」/ file-item.spec.md「List wrapper canonical」).
+#
+# Usage: bash test_check_item_list_gap.sh
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_item_list_gap.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+run_hook() {
+  local file_path="$1"
+  local content="$2"
+  local payload
+  payload=$(jq -n \
+    --arg fp "$file_path" \
+    --arg c  "$content" \
+    '{tool_name: "Write", tool_input: {file_path: $fp, content: $c}}')
+
+  STDOUT=$(mktemp)
+  STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDOUT_TEXT=$(cat "$STDOUT")
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass_clean() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && ! echo "$STDERR_TEXT" | grep -q "P1\|P2"; then
+    echo "  PASS  $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (exit=$EXIT, stderr had warning?)"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_warn_p1() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && echo "$STDERR_TEXT" | grep -q "P1 list wrapper 可能缺 gap"; then
+    echo "  PASS  $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit 0 with P1 warn, got exit=$EXIT)"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_block_p2() {
+  local name="$1"
+  if [ "$EXIT" = "2" ] && echo "$STDERR_TEXT" | grep -q "P2 list wrapper 加外框"; then
+    echo "  PASS  $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit 2 + P2, got exit=$EXIT)"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+# ── Test 1: list wrapper with gap-2 + FileItem map → pass clean ──────────────
+echo "Test 1: flex-col gap-2 + FileItem → pass clean"
+read -r -d '' T1 <<'EOF' || true
+export const Demo = () => (
+  <div className="flex flex-col gap-2">
+    {files.map(f => <FileItem key={f.id} file={f} />)}
+  </div>
+)
+EOF
+run_hook "/fake/file-item.stories.tsx" "$T1"
+expect_pass_clean "Test 1 gap-2 wrapper clean"
+
+# ── Test 2: list wrapper border + overflow-hidden + FileItem → P2 block ──────
+echo ""
+echo "Test 2: flex-col border overflow-hidden + FileItem → P2 block"
+read -r -d '' T2 <<'EOF' || true
+export const Demo = () => (
+  <div className="flex flex-col border overflow-hidden rounded-lg">
+    {files.map(f => <FileItem key={f.id} file={f} />)}
+  </div>
+)
+EOF
+run_hook "/fake/file-item.stories.tsx" "$T2"
+expect_block_p2 "Test 2 outer-frame wrapper blocked"
+
+# ── Test 3: list wrapper flex-col without gap + FileItem → P1 warn ───────────
+echo ""
+echo "Test 3: flex-col no gap + FileItem → P1 warn (exit 0)"
+read -r -d '' T3 <<'EOF' || true
+export const Demo = () => (
+  <div className="flex flex-col">
+    {files.map(f => <FileItem key={f.id} file={f} />)}
+  </div>
+)
+EOF
+run_hook "/fake/file-item.stories.tsx" "$T3"
+expect_warn_p1 "Test 3 no-gap wrapper warns"
+
+# ── Test 4: file-level allowlist marker → pass even with violation ───────────
+echo ""
+echo "Test 4: // @item-gap-exempt: → bypass"
+read -r -d '' T4 <<'EOF' || true
+// @item-gap-exempt: anatomy story showing flush variant
+export const Demo = () => (
+  <div className="flex flex-col border overflow-hidden rounded-lg">
+    {files.map(f => <FileItem key={f.id} file={f} />)}
+  </div>
+)
+EOF
+run_hook "/fake/file-item.stories.tsx" "$T4"
+expect_pass_clean "Test 4 allowlist bypasses"
+
+# ── Test 5: non-tsx file → pass (out of scope) ───────────────────────────────
+echo ""
+echo "Test 5: .md file → pass (out of scope)"
+run_hook "/fake/note.md" "<div className=\"flex flex-col border\">{files.map(f => <FileItem />)}</div>"
+expect_pass_clean "Test 5 non-tsx out of scope"
+
+# ── Test 6: flex-col gap-2 BUT no FileItem map → pass(其他元件 list 不在 scope)
+echo ""
+echo "Test 6: flex-col without FileItem → pass (only FileItem MVP scope)"
+read -r -d '' T6 <<'EOF' || true
+export const Demo = () => (
+  <div className="flex flex-col">
+    {items.map(i => <MenuItem key={i.id}>{i.label}</MenuItem>)}
+  </div>
+)
+EOF
+run_hook "/fake/menu.stories.tsx" "$T6"
+expect_pass_clean "Test 6 non-FileItem out of scope"
+
+# ── Summary ──────────────────────────────────────────────────────────────────
+echo ""
+echo "════════════════════════════════════════"
+echo "  Results: $PASS PASS, $FAIL FAIL"
+echo "════════════════════════════════════════"
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed tests:%b\n" "$FAILED_TESTS"
+  exit 1
+fi
+exit 0

package/ds-canonical/hooks/retired/tests/test_check_sideoffset_canonical.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_sideoffset_canonical.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_sideoffset_canonical.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_spec_iteration_tag.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_spec_iteration_tag.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_spec_iteration_tag.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_ssot_consultation.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_ssot_consultation.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_ssot_consultation.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_sync_update.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_sync_update.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Edit", tool_input:{file_path:$fp, new_string:$ct, old_string:""}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-DS file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_check_third_party_dom_verified.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_third_party_dom_verified.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../check_third_party_dom_verified.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_enforce_home_charter.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for enforce_home_charter.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../enforce_home_charter.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-governance file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_pre_edit_spec_check.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for pre_edit_spec_check.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../pre_edit_spec_check.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not exec"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-matching file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL exit=$EXIT out=${STDOUT:0:80}"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/ds-canonical/hooks/retired/tests/test_pre_new_component_spec.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for pre_new_component_spec.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../pre_new_component_spec.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+PASS=0; FAIL=0
+run_hook() {
+  local payload=$(jq -n --arg fp "$1" --arg ct "$2" '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1); EXIT=$?
+}
+echo "Test 1: non-governance file → silent skip"
+run_hook "/tmp/random.txt" "x"
+[ "$EXIT" = "0" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+echo "Results: $PASS PASS, $FAIL FAIL"
+[ "$FAIL" -eq 0 ] || exit 1