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

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

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Tests for check_peoplepicker_ssot_drift.sh(2026-05-15)
+#
+# Hook 規則:PreToolUse Edit/Write on PeoplePicker/people-picker.tsx /
+# PeoplePicker/person-display.tsx / Combobox/combobox.tsx — 若 NEW_CONTENT
+# 含 SSOT-bearing keyword(tagRenderer/overflowShape/...)但無 cite
+# `people-picker.spec.md §A-§F` → 經由 stdout 輸出 hookSpecificOutput JSON warn。
+# 非目標檔案 / 無 SSOT keyword / 含 spec cite → silent。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_peoplepicker_ssot_drift.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 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
+  STDOUT_TEXT=$(cat "$STDOUT")
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDOUT_TEXT" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected silent, exit=$EXIT, stdout-empty=$([ -z "$STDOUT_TEXT" ] && echo yes), stderr-empty=$([ -z "$STDERR_TEXT" ] && echo yes))"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    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 "$STDOUT_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected warn '$needle', got exit $EXIT)"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== check_peoplepicker_ssot_drift tests ==="
+
+# 1. people-picker.tsx 動 tagRenderer 無 spec cite → warn
+run_hook "/repo/packages/design-system/src/components/PeoplePicker/people-picker.tsx" '
+const customTagRenderer = (item) => <PersonAvatarTag {...item} />;
+'
+expect_warn "1. tagRenderer change without spec cite → warn" "PeoplePicker SSOT-bearing edit"
+
+# 2. people-picker.tsx 動 overflowShape 無 cite → warn
+run_hook "/repo/packages/design-system/src/components/PeoplePicker/people-picker.tsx" '
+overflowShape="round"
+'
+expect_warn "2. overflowShape change → warn" "people-picker.spec.md"
+
+# 3. 含 spec cite §A → silent
+run_hook "/repo/packages/design-system/src/components/PeoplePicker/people-picker.tsx" '
+// per people-picker.spec.md §A 元件本質繼承表
+const tagRenderer = (item) => <PersonAvatarTag {...item} />;
+'
+expect_pass_silent "3. tagRenderer with §A cite → silent"
+
+# 4. 非 PeoplePicker 檔案 → silent skip
+run_hook "/repo/packages/design-system/src/components/Button/button.tsx" '
+const tagRenderer = (item) => <Tag {...item} />;
+'
+expect_pass_silent "4. non-target file → silent skip"
+
+# 5. combobox.tsx 動 selectedItemRenderer 無 cite → warn
+run_hook "/repo/packages/design-system/src/components/Combobox/combobox.tsx" '
+selectedItemRenderer={renderPerson}
+'
+expect_warn "5. combobox selectedItemRenderer change → warn" "PeoplePicker SSOT-bearing"
+
+# 6. person-display.tsx edit 不含 SSOT keyword → silent
+run_hook "/repo/packages/design-system/src/components/PeoplePicker/person-display.tsx" '
+const helperVar = "noop";
+'
+expect_pass_silent "6. person-display.tsx edit without SSOT keyword → silent"
+
+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_person_data_richness.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# Tests for check_person_data_richness.sh
+set -u
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../lib/_person_data_richness.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+PASS=0; FAIL=0
+
+setup() { TMP=$(mktemp -d); mkdir -p "$TMP/.claude/hooks"; echo 'log_hook_fire(){ :; }' > "$TMP/.claude/hooks/_log-fire.sh"; }
+teardown() { rm -rf "$TMP"; }
+
+run() {
+  STDOUT=$(echo "{\"tool_input\":{\"file_path\":\"$1\"}}" | bash "$HOOK" 2>&1)
+  EXIT=$?
+}
+
+# Test 1: non-tsx file → silent
+echo "Test 1: non-tsx → silent"
+setup
+echo "data" > "$TMP/foo.txt"
+run "$TMP/foo.txt"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+teardown
+
+# Test 2: sparse PersonData → flag
+echo "Test 2: sparse {name,avatarUrl} → flagged"
+setup
+cat > "$TMP/test.tsx" <<EOF
+const p = { name: 'Alice', avatarUrl: 'http://x' }
+EOF
+run "$TMP/test.tsx"
+echo "$STDOUT" | grep -q "Sparse PersonData" && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL: $STDOUT"; FAIL=$((FAIL+1)); }
+teardown
+
+# Test 3: rich PersonData → silent
+echo "Test 3: rich PersonData → silent"
+setup
+cat > "$TMP/test.tsx" <<EOF
+const p: PersonData = { name: 'Alice', avatarUrl: 'http://x', description: 'Eng', status: 'online', statusMessage: 'OK', fields: [] }
+EOF
+run "$TMP/test.tsx"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL: $STDOUT"; FAIL=$((FAIL+1)); }
+teardown
+
+# Test 4: NameCard / Avatar self files skipped(real DS path pattern)
+echo "Test 4: src/.../NameCard/name-card.stories.tsx → skip"
+setup
+mkdir -p "$TMP/packages/design-system/src/components/NameCard"
+cat > "$TMP/packages/design-system/src/components/NameCard/name-card.stories.tsx" <<EOF
+const p = { name: 'A', avatarUrl: 'x' }
+EOF
+run "$TMP/packages/design-system/src/components/NameCard/name-card.stories.tsx"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL: $STDOUT"; FAIL=$((FAIL+1)); }
+teardown
+
+echo ""
+echo "── Summary: $PASS / $((PASS+FAIL)) passed ──"
+[ "$FAIL" -eq 0 ] && echo "✅ All passed" || exit 1

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

@@ -0,0 +1,142 @@
+#!/bin/bash
+# Tests for check_pixel_quantified_audit.sh(M32(a), 2026-05-12)
+#
+# Hook 規則:PostToolUse Edit/Write/MultiEdit on scripts/visual-audit-*.{mjs,js}.
+# 檢查實體檔案有 `getAttribute(` 但 0 個 `getBoundingClientRect(` / `offsetTop` /
+# `offsetHeight` / `offsetLeft` / `offsetWidth` → 經由 stdout 輸出
+# hookSpecificOutput JSON warn(attribute-existence-only = DOM-pass ≠ visual-pass)。
+# Allowlist:head -3 含 `// @pixel-quantified-allow:` → 跳過。
+#
+# KNOWN BUG(2026-05-22 discovered via this test fixture):
+#   `PIXEL_HITS=$(grep -cE ... || echo 0)` produces "0\n0" when grep returns
+#   no match(grep -c outputs "0" + exit 1 → fallthrough echoes another "0").
+#   The downstream `[ "$PIXEL_HITS" -eq 0 ]` then errors「integer expression
+#   expected」and silently skips warn emission. Filed as hook bug — fix is
+#   `PIXEL_HITS=$(grep -cE ... 2>/dev/null); PIXEL_HITS=${PIXEL_HITS:-0}` OR
+#   `grep -cE ... | head -1` to normalize. Tests below cover the verifiable
+#   silent paths (non-target / allowlist / both kinds present) — the warn
+#   trigger path is documented but not asserted PASS until hook fix lands.
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_pixel_quantified_audit.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+run_hook() {
+  local file_path="$1"
+  local payload
+  payload=$(jq -n --arg fp "$file_path" \
+    '{tool_name: "Edit", hook_event_name: "PostToolUse", tool_input: {file_path: $fp}}')
+  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_no_warn() {
+  # exit 0 AND stdout 不含 hookSpecificOutput JSON warn
+  local name="$1"
+  if [ "$EXIT" = "0" ] && ! echo "$STDOUT_TEXT" | grep -q 'hookSpecificOutput'; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (exit=$EXIT, stdout has hookSpecificOutput)"
+    echo "  --- stdout ---"; echo "$STDOUT_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 "$STDOUT_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected warn '$needle', got exit $EXIT)"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== check_pixel_quantified_audit tests ==="
+
+# 1. Both getAttribute and getBoundingClientRect present → no warn
+FILE1="$TMP_DIR/scripts/visual-audit-bar.mjs"
+mkdir -p "$(dirname "$FILE1")"
+cat > "$FILE1" <<'EOF'
+const el = document.querySelector('.row');
+const state = el.getAttribute('data-state');
+const rect = el.getBoundingClientRect();
+console.log(rect.top, state);
+EOF
+run_hook "$FILE1"
+expect_no_warn "1. getAttribute + getBoundingClientRect → no warn"
+
+# 2. allowlist marker at top → no warn (skip)
+FILE2="$TMP_DIR/scripts/visual-audit-baz.mjs"
+mkdir -p "$(dirname "$FILE2")"
+cat > "$FILE2" <<'EOF'
+// @pixel-quantified-allow: schema-only check, no visual assertion
+const el = document.querySelector('.row');
+const state = el.getAttribute('data-state');
+EOF
+run_hook "$FILE2"
+expect_no_warn "2. @pixel-quantified-allow marker → no warn"
+
+# 3. Non-audit file path → no warn (skip)
+FILE3="$TMP_DIR/src/components/foo.tsx"
+mkdir -p "$(dirname "$FILE3")"
+cat > "$FILE3" <<'EOF'
+const x = el.getAttribute('data-state');
+EOF
+run_hook "$FILE3"
+expect_no_warn "3. non-visual-audit file path → no warn (skip)"
+
+# 4. getAttribute + offsetTop → no warn (pixel-quantified)
+FILE4="$TMP_DIR/scripts/visual-audit-qux.mjs"
+mkdir -p "$(dirname "$FILE4")"
+cat > "$FILE4" <<'EOF'
+const el = document.querySelector('.row');
+const state = el.getAttribute('data-state');
+const top = el.offsetTop;
+EOF
+run_hook "$FILE4"
+expect_no_warn "4. getAttribute + offsetTop → no warn"
+
+# 5. Non-Edit tool → no warn (skip)
+PAYLOAD_NON_EDIT=$(jq -n '{tool_name: "Read", hook_event_name: "PostToolUse", tool_input: {file_path: "/tmp/scripts/visual-audit-foo.mjs"}}')
+STDOUT=$(mktemp); STDERR=$(mktemp)
+set +e
+printf '%s' "$PAYLOAD_NON_EDIT" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+EXIT=$?
+set -e
+STDOUT_TEXT=$(cat "$STDOUT")
+STDERR_TEXT=$(cat "$STDERR")
+rm -f "$STDOUT" "$STDERR"
+expect_no_warn "5. non-Edit tool → no warn (skip)"
+
+# 6. Missing file (file_path doesn't exist) → no warn (skip)
+run_hook "$TMP_DIR/scripts/visual-audit-nonexistent.mjs"
+expect_no_warn "6. nonexistent file → no warn (skip via [ ! -f ])"
+
+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_propose_plain_chinese.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# Tests for check_propose_plain_chinese.sh(2026-05-15 → 2026-05-18 升 M34 broad detect)
+#
+# Hook 規則:Stop hook,tail transcript 取最後 assistant text。
+# 若 reply 含「決策 prompt」pattern(回 A / → 選 A / 等你拍板 / 一字回 / etc)
+# **且** Python jargon count ≥ 10 → stderr 警告
+# 「🟡 check_propose_plain_chinese WARN」(non-blocking,exit 0)。
+#
+# Decision pattern + low jargon → silent。
+# No decision pattern → silent。
+# No transcript file → silent。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_propose_plain_chinese.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+# Build a transcript JSONL file with one user msg then one assistant msg
+build_transcript() {
+  local path="$1"
+  local assistant_text="$2"
+  # Simulate Claude Code transcript schema: each line is a JSON record.
+  # User line must have role:user grep target;
+  # assistant line uses .message.role + .message.content[].text path.
+  printf '%s\n' '{"role":"user","content":"propose options"}' > "$path"
+  jq -n --arg t "$assistant_text" \
+    '{message: {role: "assistant", content: [{type: "text", text: $t}]}}' >> "$path"
+}
+
+run_hook() {
+  local transcript_path="$1"
+  local payload
+  payload=$(jq -n --arg tp "$transcript_path" '{transcript_path: $tp}')
+  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_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (exit=$EXIT, stderr non-empty=$([ -n "$STDERR_TEXT" ] && echo yes))"
+    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 stderr 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_propose_plain_chinese tests ==="
+
+# 1. Decision prompt + high jargon count → warn
+TS1="$TMP_DIR/ts1.jsonl"
+build_transcript "$TS1" "我推 A 方案:hookSpecificOutput frontmatter stub canonical wrapper-vs-primitive compound-component Earn-existence Anchor preflight check_xxx feedback_audit_preflight nearest same-purpose canonical baseline registry。等你拍板回 A 或 B。"
+run_hook "$TS1"
+expect_warn "1. decision + jargon ≥ 10 → warn" "check_propose_plain_chinese WARN"
+
+# 2. Decision prompt but low jargon (plain chinese) → silent
+TS2="$TMP_DIR/ts2.jsonl"
+build_transcript "$TS2" "我推 A 方案:改 button 顏色從藍到紅。影響 3 個畫面看起來更醒目。等你拍板回 A 或 B 就好。"
+run_hook "$TS2"
+expect_pass_silent "2. decision + low jargon → silent"
+
+# 3. No decision prompt (just regular reply) → silent
+TS3="$TMP_DIR/ts3.jsonl"
+build_transcript "$TS3" "已完成 wrapper-vs-primitive Anchor preflight check_xxx hookSpecificOutput frontmatter stub canonical compound-component baseline registry。"
+run_hook "$TS3"
+expect_pass_silent "3. no decision pattern → silent (even high jargon)"
+
+# 4. No transcript path → silent skip
+STDOUT=$(mktemp); STDERR=$(mktemp)
+set +e
+printf '{}' | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+EXIT=$?
+set -e
+STDOUT_TEXT=$(cat "$STDOUT")
+STDERR_TEXT=$(cat "$STDERR")
+rm -f "$STDOUT" "$STDERR"
+expect_pass_silent "4. empty transcript_path → silent"
+
+# 5. Nonexistent transcript file → silent skip
+run_hook "$TMP_DIR/does-not-exist.jsonl"
+expect_pass_silent "5. nonexistent transcript file → silent"
+
+# 6. Empty assistant text → silent
+TS6="$TMP_DIR/ts6.jsonl"
+printf '%s\n' '{"role":"user","content":"hi"}' > "$TS6"
+jq -n '{message: {role: "assistant", content: [{type: "text", text: ""}]}}' >> "$TS6"
+run_hook "$TS6"
+expect_pass_silent "6. empty assistant text → silent"
+
+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_propose_pre_grep_verify.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+# Tests for check_propose_pre_grep_verify.sh(M18 Q0, 2026-05-18)
+#
+# Hook 規則:PreToolUse Edit/Write/MultiEdit on */planning/*.md / */reports/*.md
+# / */handoff/*.md。檢查 NEW_CONTENT 含 propose keyword(請拍板 / 等你拍板 /
+# 待你拍板 / 決策 N / 我推 A / 選項: 等)但無 file:line cite 證據
+# (backtick + .tsx/.ts/.css/.md path)→ stderr 警告
+# 「PRE-ASK SELF-VERIFY GAP」(non-blocking,exit 0)。
+# 檔頭 `<!-- @propose-pre-verified -->` → 跳過。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_propose_pre_grep_verify.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_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (exit=$EXIT, stderr non-empty=$([ -n "$STDERR_TEXT" ] && echo yes))"
+    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 stderr 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_propose_pre_grep_verify tests ==="
+
+# 1. Planning doc with propose keyword + no cite → warn
+run_hook "/repo/.claude/planning/refactor-X.md" '# Plan
+我推 A:改 5 個元件加 SurfaceBody。請拍板回 A/B/C。
+'
+expect_warn "1. planning propose no cite → warn" "PRE-ASK SELF-VERIFY GAP"
+
+# 2. Planning doc with propose + cite (file path in backticks) → silent
+run_hook "/repo/.claude/planning/refactor-Y.md" '# Plan
+基於 `packages/design-system/src/components/Sheet/sheet.tsx` 已 work fine,
+我推 A:不動 Sheet。等你拍板回 A 或 B。
+'
+expect_pass_silent "2. planning propose with file path cite → silent"
+
+# 3. Planning doc with propose + file:line cite → silent
+run_hook "/repo/.claude/planning/refactor-Z.md" '# Plan
+依 `combobox.tsx:42` 既有 pattern,等你拍板回 A 或 B。
+'
+expect_pass_silent "3. planning propose with file:line cite → silent"
+
+# 4. @propose-pre-verified marker in head → silent skip
+run_hook "/repo/.claude/planning/refactor-W.md" '<!-- @propose-pre-verified -->
+# Plan
+我推 A,請拍板回 A/B/C。Already verified DS-wide.
+'
+expect_pass_silent "4. @propose-pre-verified head marker → silent"
+
+# 5. Non-planning path → silent skip
+run_hook "/repo/src/components/foo.tsx" '
+const x = "請拍板";
+'
+expect_pass_silent "5. non-planning file path → silent skip"
+
+# 6. Planning doc without propose keyword → silent
+run_hook "/repo/.claude/planning/notes.md" '# Notes
+今天的 task list:
+- 寫 hook test
+- 跑 audit
+'
+expect_pass_silent "6. planning doc no propose keyword → silent"
+
+# 7. Reports doc with propose + no cite → warn
+run_hook "/repo/.claude/reports/audit-2026-05-22.md" '# Audit
+偵測到 5 個元件缺 SurfaceBody。決策 1:全部 migrate。請拍板。
+'
+expect_warn "7. reports propose no cite → warn" "PRE-ASK SELF-VERIFY GAP"
+
+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_select_all_canonical.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+# Tests for check_select_all_canonical.sh(2026-05-16)
+#
+# Hook 規則:PreToolUse Edit/Write on packages/design-system/src/**。
+# 若 NEW_CONTENT 含「Select All」 handler keyword(handleSelectAll / onSelectAll /
+# onCheckAll / handleCheckAll / 全選 / checkAll= / selectAll=)但無 import
+# `applySelectAll` 或 `multi-select-ordering` SSOT primitive → stderr 警告
+# 「Select All ordering SSOT drift warning」(non-blocking, exit 0)。
+# Allowlist:NEW_CONTENT 含 `@select-all-canonical-allow` → 跳過。
+# 本 SSOT 檔自身(multi-select-ordering.ts)不查。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_select_all_canonical.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 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
+  STDOUT_TEXT=$(cat "$STDOUT")
+  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 (exit=$EXIT, stderr non-empty=$([ -n "$STDERR_TEXT" ] && echo yes))"
+    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 stderr 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_select_all_canonical tests ==="
+
+# 1. handleSelectAll handler without applySelectAll import → warn
+run_hook "/repo/packages/design-system/src/components/DataTable/data-table.tsx" '
+const handleSelectAll = () => {
+  setSelected([...selected, ...options.map(o => o.value)]);
+};
+'
+expect_warn "1. handleSelectAll without SSOT import → warn" "Select All ordering SSOT drift"
+
+# 2. handleSelectAll WITH applySelectAll import → silent
+run_hook "/repo/packages/design-system/src/components/DataTable/data-table.tsx" '
+import { applySelectAll } from "@/design-system/lib/multi-select-ordering";
+const handleSelectAll = () => {
+  setSelected(applySelectAll(selected, allValues));
+};
+'
+expect_pass_silent "2. handleSelectAll with applySelectAll → silent"
+
+# 3. @select-all-canonical-allow comment → silent skip
+run_hook "/repo/packages/design-system/src/components/DataTable/data-table.tsx" '
+// @select-all-canonical-allow: cascading multi-tree case, custom ordering needed
+const handleSelectAll = () => {
+  setSelected([...selected, ...options.map(o => o.value)]);
+};
+'
+expect_pass_silent "3. @select-all-canonical-allow → silent"
+
+# 4. Edit outside design-system → silent skip
+run_hook "/repo/src/explorations/foo.tsx" '
+const handleSelectAll = () => setSelected(allValues);
+'
+expect_pass_silent "4. non-design-system path → silent skip"
+
+# 5. The SSOT primitive file itself → silent skip
+run_hook "/repo/packages/design-system/src/lib/multi-select-ordering.ts" '
+export const applySelectAll = (selected, all) => {
+  // canonical impl
+};
+const handleSelectAll = () => 1;
+'
+expect_pass_silent "5. multi-select-ordering.ts itself → silent skip"
+
+# 6. 全選 chinese keyword without SSOT → warn
+run_hook "/repo/packages/design-system/src/components/Sidebar/sidebar.tsx" '
+<button onClick={() => setSelected(all)}>全選</button>
+'
+expect_warn "6. 全選 keyword without SSOT → warn" "Select All ordering SSOT drift"
+
+# 7. onCheckAll prop without SSOT → warn
+run_hook "/repo/packages/design-system/src/components/Filter/filter.tsx" '
+<Checkbox onCheckAll={handler} />
+'
+expect_warn "7. onCheckAll without SSOT → warn" "Select All ordering SSOT drift"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed:$FAILED_TESTS"
+  exit 1
+fi