@qijenchen/design-system 0.1.0-beta.3 → 0.1.0-beta.32

package/ds-canonical/hooks/tests/test_check_canonical_propagation.sh

@@ -0,0 +1,133 @@
+#!/bin/bash
+# Tests for check_canonical_propagation.sh — merged 3 sub-rules
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_canonical_propagation.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+
+PASS=0; FAIL=0; FAILED_TESTS=""
+
+run_hook() {
+  local file_path="$1" content="$2" tool="${3:-Write}"
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  jq -n --arg tool "$tool" --arg fp "$file_path" --arg c "$content" \
+    '{tool_name:$tool, tool_input:{file_path:$fp, content:$c}}' \
+    | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR"); rm -f "$STDOUT" "$STDERR"
+}
+
+expect_exit() {
+  local name="$1" expect="$2" needle="${3:-}"
+  if [ "$EXIT" = "$expect" ] && { [ -z "$needle" ] || echo "$STDERR_TEXT" | grep -qF "$needle"; }; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit $expect${needle:+ + needle '$needle'}, got exit $EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== E.1 principles canonical ==="
+
+# 1. New principles file with 0 universal core → BLOCK
+run_hook "/r/packages/design-system/src/components/Foo/foo.principles.stories.tsx" "
+const meta = { title: 'Design System/Components/Foo/設計原則' }
+export default meta
+export const SomeStory = () => <div />
+" Write
+expect_exit "E.1.1 0 universal core → BLOCK" 2 "principles canonical"
+
+# 2. New principles with WhenToUse + WhenNotToUse → silent
+run_hook "/r/packages/design-system/src/components/Foo/foo.principles.stories.tsx" "
+const meta = { title: 'Design System/Components/Foo/設計原則' }
+export default meta
+export const WhenToUse = () => <div />
+export const WhenNotToUse = () => <div />
+" Write
+expect_exit "E.1.2 WhenToUse+WhenNotToUse → silent" 0 ""
+
+# 3. UsageGuidance integrated single export → silent (counts as ≥2)
+run_hook "/r/packages/design-system/src/components/Foo/foo.principles.stories.tsx" "
+const meta = { title: 'Design System/Components/Foo/設計原則' }
+export default meta
+export const UsageGuidance = () => <div />
+" Write
+expect_exit "E.1.3 UsageGuidance integrated → silent" 0 ""
+
+# 4. Deprecated naming Forbidden* on new file → BLOCK
+run_hook "/r/packages/design-system/src/components/Foo/foo.principles.stories.tsx" "
+const meta = { title: 'Design System/Components/Foo/設計原則' }
+export default meta
+export const ForbiddenPatterns = () => <div />
+export const WhenToUse = () => <div />
+" Write
+expect_exit "E.1.4 deprecated Forbidden* on new → BLOCK" 2 "principles canonical"
+
+# 5. Allowlist comment → silent
+run_hook "/r/packages/design-system/src/components/Foo/foo.principles.stories.tsx" "
+// @principles-rationale: legacy migration
+const meta = { title: 'Design System/Components/Foo/設計原則' }
+export default meta
+" Write
+expect_exit "E.1.5 allowlist → silent" 0 ""
+
+echo ""
+echo "=== E.2 L3 primitive import ==="
+
+# 6. App code import L3 → BLOCK
+run_hook "/r/src/app/page.tsx" "
+import { ItemInlineAction } from '@/design-system/patterns/element-anatomy/item-anatomy'
+" Write
+expect_exit "E.2.1 app code L3 import → BLOCK" 2 "L3 primitive import"
+
+# 7. DS internal can import L3 → silent
+run_hook "/r/packages/design-system/src/components/MyHost/my-host.tsx" "
+import { ItemInlineAction } from '@/design-system/patterns/element-anatomy/item-anatomy'
+" Write
+expect_exit "E.2.2 DS internal L3 → silent" 0 ""
+
+# 8. App code with allowlist comment → silent
+run_hook "/r/src/app/special.tsx" '// @l3-import-allow: spec.md L42 documented exception
+import { ItemInlineAction } from "@/design-system/patterns/element-anatomy/item-anatomy"
+' Write
+expect_exit "E.2.3 app code allowlist → silent" 0 ""
+
+# 9. App code without L3 import → silent
+run_hook "/r/src/app/page.tsx" "
+import { Button } from '@/design-system/components/Button/button'
+" Write
+expect_exit "E.2.4 no L3 import → silent" 0 ""
+
+echo ""
+echo "=== E.3 spec-impl default alignment ==="
+
+# 10. spec.md with 「預設」keyword → WARN stderr
+run_hook "/r/packages/design-system/src/components/Foo/foo.spec.md" '
+## Width
+預設 = trigger-width(同 popover anchor 寬)
+' Write
+expect_exit "E.3.1 預設 keyword → WARN stderr" 0 "spec-impl default"
+
+# 11. spec.md without default keyword → silent
+run_hook "/r/packages/design-system/src/components/Foo/foo.spec.md" '
+## Behavior
+按下 Esc 關閉。
+' Write
+expect_exit "E.3.2 no default keyword → silent" 0 ""
+
+# 12. spec.md with file-level allowlist → silent
+run_hook "/r/packages/design-system/src/components/Foo/foo.spec.md" '// @spec-impl-allow: spec values are intentionally aspirational
+## Width
+預設 = trigger-width
+' Write
+expect_exit "E.3.3 spec allowlist → silent" 0 ""
+
+echo ""
+echo "═══ Results: $PASS PASS, $FAIL FAIL ═══"
+[ "$FAIL" -gt 0 ] && { printf "Failed:%b\n" "$FAILED_TESTS"; exit 1; }
+exit 0

package/ds-canonical/hooks/tests/test_check_chrome_header_handcraft.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+# Tests for check_chrome_header_handcraft.sh
+#
+# Hook(PreToolUse Edit/Write/MultiEdit):packages/design-system/src/components/**/*.tsx
+# 偵測自刻 `h-[var(--chrome-header-height)] ... border-b ... border-divider` signature
+# → P1 soft warning stderr,exit 0(不 block)。
+# Skip:*.stories.tsx / ChromeHeader / header-canonical / overlay-surface 內部 / `@chrome-header-handcraft-allow:` escape。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_chrome_header_handcraft.sh"
+
+if [ ! -f "$HOOK" ]; then echo "FATAL: hook not found: $HOOK"; exit 1; fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+run_hook_write() {
+  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
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+run_hook_edit() {
+  local file_path="$1"; local new_string="$2"
+  local payload
+  payload=$(jq -n --arg fp "$file_path" --arg ns "$new_string" \
+    '{tool_name: "Edit", tool_input: {file_path: $fp, new_string: $ns}}')
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected silent, exit=$EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_warn() {
+  local name="$1"; local needle="$2"
+  # exit 0 + stderr contains needle (P1 soft warn)
+  if [ "$EXIT" = "0" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit=0 + stderr needle '$needle', got exit $EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== check_chrome_header_handcraft tests ==="
+
+# 1. Non-DS path → skip
+run_hook_write "/tmp/random.tsx" '<div className="h-[var(--chrome-header-height)] border-b border-divider" />'
+expect_pass_silent "1. non-DS path → skip"
+
+# 2. Stories file → skip
+run_hook_write "/repo/packages/design-system/src/components/Foo/foo.stories.tsx" '
+<div className="h-[var(--chrome-header-height)] border-b border-divider" />
+'
+expect_pass_silent "2. .stories.tsx → skip"
+
+# 3. ChromeHeader primitive internal → skip
+run_hook_write "/repo/packages/design-system/src/components/ChromeHeader/chrome-header.tsx" '
+<div className="h-[var(--chrome-header-height)] border-b border-divider" />
+'
+expect_pass_silent "3. ChromeHeader/ primitive home → skip"
+
+# 4. DS component, no chrome-header signature → silent
+run_hook_write "/repo/packages/design-system/src/components/Foo/foo.tsx" '
+import { Button } from "./button"
+export const Foo = () => <Button>x</Button>
+'
+expect_pass_silent "4. no handcraft signature → silent"
+
+# 5. DS component with full handcraft signature → warn
+run_hook_write "/repo/packages/design-system/src/components/Bar/bar.tsx" '
+export const Bar = () => (
+  <div className="h-[var(--chrome-header-height)] px-loose border-b border-divider" />
+)
+'
+expect_warn "5. handcraft signature → warn" "CHROME HEADER HANDCRAFT"
+
+# 6. Escape allowlist → silent
+run_hook_write "/repo/packages/design-system/src/components/Bar/bar.tsx" '// @chrome-header-handcraft-allow: tabs cva pattern
+export const Bar = () => (
+  <div className="h-[var(--chrome-header-height)] px-loose border-b border-divider" />
+)
+'
+expect_pass_silent "6. @chrome-header-handcraft-allow escape → silent"
+
+# 7. Edit (new_string) with handcraft → warn
+run_hook_edit "/repo/packages/design-system/src/components/Baz/baz.tsx" \
+  '<div className="h-[var(--chrome-header-height)] flex items-center border-b border-divider">'
+expect_warn "7. Edit new_string with handcraft → warn" "CHROME HEADER HANDCRAFT"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed:$FAILED_TESTS"
+  exit 1
+fi

package/ds-canonical/hooks/tests/test_check_code_quality.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_code_quality.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../lib/_code_quality.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/tests/test_check_codex_collab_5step.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# Tests for check_codex_collab_5step.sh(M31 5-step canonical soft warn)
+#
+# Hook 規則:Bash + git commit + commit message 含 codex collab keyword(codex / Layer A own /
+# Layer B codex / dual-track / 據理力爭 / cite battle)但缺 3 必備 marker
+# (spec cite / verify run / verdict)→ stderr soft warn (exit 0)。
+# Allow escape:`@codex-collab-allow: <reason>`。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_codex_collab_5step.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+run_hook() {
+  local tool="$1"
+  local command="$2"
+  local payload
+  payload=$(jq -n --arg t "$tool" --arg c "$command" \
+    '{tool_name: $t, tool_input: {command: $c}}')
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected silent, exit=$EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_warn() {
+  local name="$1"; local needle="$2"
+  if [ "$EXIT" = "0" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected warn '$needle', got exit $EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== check_codex_collab_5step tests ==="
+
+# 1. Non-Bash tool → skip
+run_hook "Edit" "irrelevant"
+expect_pass_silent "1. non-Bash tool → skip"
+
+# 2. Bash non-git-commit command → skip
+run_hook "Bash" "ls -la"
+expect_pass_silent "2. Bash non-git-commit → skip"
+
+# 3. git commit without codex keyword → skip
+run_hook "Bash" "git commit -m \"fix typo in spec\""
+expect_pass_silent "3. git commit no codex keyword → skip"
+
+# 4. git commit WITH codex keyword but NO marker → warn
+run_hook "Bash" "git commit -m \"codex propose accepted\""
+expect_warn "4. codex keyword, no markers → warn" "M31 codex-collab 5-step canonical 違反"
+
+# 5. git commit WITH codex keyword + allow escape → silent
+run_hook "Bash" "git commit -m \"codex propose @codex-collab-allow: emergency hotfix\""
+expect_pass_silent "5. codex keyword + @codex-collab-allow → silent"
+
+# 6. git commit WITH codex + all 3 markers → silent
+run_hook "Bash" "git commit -m \"codex collab agree synthesize: spec.md:L42 cite + tsc audit verify + verdict agree\""
+expect_pass_silent "6. codex + spec cite + verify + verdict → silent"
+
+# 7. git commit WITH cite battle keyword only(missing other 2 markers)→ warn
+run_hook "Bash" "git commit -m \"cite battle vs codex on field-controls\""
+expect_warn "7. cite battle only, missing verify/verdict → warn" "spec.md cite"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed:$FAILED_TESTS"
+  exit 1
+fi

package/ds-canonical/hooks/tests/test_check_cva_default_sync.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Smoke test for check_cva_default_sync.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../lib/_cva_default_sync.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/tests/test_check_datatable_invariants.sh

@@ -0,0 +1,122 @@
+#!/bin/bash
+# Tests for check_datatable_invariants.sh — merged 3 sub-rules
+#
+# 全 sub-rules 都是 P2 stderr-only(exit 0),不阻擋。verify stderr 內容對。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_datatable_invariants.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable: $HOOK"; exit 1; }
+
+PASS=0; FAIL=0; FAILED_TESTS=""
+
+run_hook() {
+  local file_path="$1" content="$2"
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  jq -n --arg fp "$file_path" --arg c "$content" \
+    '{tool_name:"Write", tool_input:{file_path:$fp, content:$c}}' \
+    | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR"); rm -f "$STDOUT" "$STDERR"
+}
+
+expect_stderr() {
+  local name="$1" needle="$2"
+  if [ "$EXIT" = "0" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected stderr '$needle', exit $EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected silent exit 0, exit $EXIT, stderr: ${STDERR_TEXT:0:80})"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== B.1 row drag getRowId ==="
+
+# 1. enableRowDrag without getRowId → warn
+run_hook "/r/src/app/products.tsx" '
+<DataTable enableRowDrag onReorder={fn} />
+'
+expect_stderr "B.1.1 enableRowDrag without getRowId → WARN" "row drag getRowId"
+
+# 2. enableRowDrag + getRowId → silent
+run_hook "/r/src/app/products.tsx" '
+<DataTable enableRowDrag getRowId={(r) => r.id} onReorder={fn} />
+'
+expect_silent "B.1.2 enableRowDrag + getRowId → silent"
+
+# 3. DataTable internal — skip
+run_hook "/r/packages/design-system/src/components/DataTable/data-table.tsx" '
+const x = "enableRowDrag"
+'
+expect_silent "B.1.3 DataTable internal skip → silent"
+
+echo ""
+echo "=== B.2 column size NUMBER → meta.width ==="
+
+# 4. column with root size: NUMBER → warn
+run_hook "/r/src/app/orders.tsx" '
+const cols = [
+  { accessorKey: "name", size: 240 },
+]
+'
+expect_stderr "B.2.1 root size NUMBER → WARN" "column size NUMBER"
+
+# 5. column with meta.width → silent
+run_hook "/r/src/app/orders.tsx" '
+const cols = [
+  { accessorKey: "name", meta: { width: 240, type: "string" } },
+]
+'
+expect_silent "B.2.2 meta.width → silent"
+
+# 6. column with size 'md' (string density) → silent (not NUMBER)
+run_hook "/r/src/app/orders.tsx" "
+const cols = [
+  { accessorKey: 'name', size: 'md' },
+]
+"
+expect_silent "B.2.3 size 'md' string → silent"
+
+# 7. cell-registry skip → silent
+run_hook "/r/packages/design-system/src/components/DataTable/cell-registry.tsx" '
+const cols = [{ accessorKey: "x", size: 240 }]
+'
+expect_silent "B.2.4 cell-registry skip → silent"
+
+echo ""
+echo "=== B.3 filter↔sort sibling sync ==="
+
+# 8. edit filter panel → reminder
+run_hook "/r/packages/design-system/src/components/DataTable/data-table-filter-panel.tsx" '
+const x = 1
+'
+expect_stderr "B.3.1 edit filter → reminder" "data-table-sort-manager"
+
+# 9. edit sort manager → reminder
+run_hook "/r/packages/design-system/src/components/DataTable/data-table-sort-manager.tsx" '
+const x = 1
+'
+expect_stderr "B.3.2 edit sort → reminder" "data-table-filter-panel"
+
+# 10. unrelated tsx → silent
+run_hook "/r/src/app/foo.tsx" 'const x = 1'
+expect_silent "B.3.3 unrelated tsx → silent"
+
+echo ""
+echo "═══ Results: $PASS PASS, $FAIL FAIL ═══"
+[ "$FAIL" -gt 0 ] && { printf "Failed:%b\n" "$FAILED_TESTS"; exit 1; }
+exit 0

package/ds-canonical/hooks/tests/test_check_dim_count_drift.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+# Tests for check_dim_count_drift.sh(audit dim count SSOT drift P1 soft warn)
+#
+# Hook 規則:Edit/Write/MultiEdit + 目標 file 是 chain skill / meta-patterns / CLAUDE.md /
+# skill SKILL.md / skill references → 偵測 `\b[1-9][0-9]+[ -]?(dim|audit dim|audit dimension)`
+# 形 hardcode → stderr soft warn (exit 0)。
+# Skip:design-system-audit/SKILL.md(SSOT)/ design-system-audit/references/* / out-of-scope path /
+# 同行含「SSOT / 禁 / forbidden / example / anti-pattern / invariant / hardcode」allowed context。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_dim_count_drift.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+run_hook() {
+  local tool="$1"
+  local file_path="$2"
+  local content="$3"
+  local payload
+  payload=$(jq -n --arg t "$tool" --arg fp "$file_path" --arg c "$content" \
+    '{tool_name: $t, tool_input: {file_path: $fp, content: $c}}')
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected silent, exit=$EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_warn() {
+  local name="$1"; local needle="$2"
+  if [ "$EXIT" = "0" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected warn '$needle', got exit $EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== check_dim_count_drift tests ==="
+
+# 1. non Edit/Write tool → skip
+run_hook "Read" "/repo/.claude/rules/meta-patterns.md" "53 dim hardcode"
+expect_pass_silent "1. non Edit/Write → skip"
+
+# 2. SSOT itself (design-system-audit/SKILL.md) → skip
+run_hook "Edit" "/repo/.claude/skills/design-system-audit/SKILL.md" "53 audit dimensions covers all"
+expect_pass_silent "2. SSOT file path → skip"
+
+# 3. Out-of-scope file (random tsx) → skip
+run_hook "Edit" "/repo/packages/design-system/src/foo.tsx" "53 dim hardcode"
+expect_pass_silent "3. out-of-scope path → skip"
+
+# 4. CLAUDE.md with hardcoded `53 dim` → warn
+run_hook "Edit" "/repo/CLAUDE.md" "現有 53 dim 覆蓋全部"
+expect_warn "4. CLAUDE.md + 53 dim hardcode → warn" "AUDIT DIM COUNT DRIFT"
+
+# 5. meta-patterns.md with `46 audit dimensions` → warn
+run_hook "Write" "/repo/.claude/rules/meta-patterns.md" "鏈到 46 audit dimensions"
+expect_warn "5. meta-patterns + 46 audit dimensions → warn" "AUDIT DIM COUNT DRIFT"
+
+# 6. Allowed context (line contains 'SSOT') → silent
+run_hook "Edit" "/repo/.claude/skills/foo/SKILL.md" "53 dim SSOT 在 design-system-audit"
+expect_pass_silent "6. line contains SSOT → allowed silent"
+
+# 7. Allowed context (line contains '禁') → silent
+run_hook "Edit" "/repo/.claude/skills/foo/SKILL.md" "禁 hardcode 53 dim 形式的數字"
+expect_pass_silent "7. line contains 禁 → allowed silent"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed:$FAILED_TESTS"
+  exit 1
+fi