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

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

@@ -0,0 +1,384 @@
+#!/bin/bash
+# Tests for check_story_invariants.sh(Cluster A merge dispatcher,2026-05-10)
+#
+# Hook 規則:Pre/PostToolUse + Edit|Write|MultiEdit + *.stories.tsx
+# 內部 8 rule:
+#   R1 anatomy(PreToolUse;raw hand-craft item/table/loading/overlay/dismiss → exit 2)
+#   R2 slot_split(PreToolUse;WithStartIcon+WithEndIcon / Default+AllVariants 拆 → exit 2)
+#   R3 category(PreToolUse;trait-based — 需 spec.md frontmatter,本 test 不 cover)
+#   R4 title_canonical(PreToolUse;non-canonical English name: → P1 stderr warn only)
+#   R5 name_jargon(PostToolUse;reads disk;L<n> layer / canonical / 中英夾雜 jargon)
+#   R6 description_jargon(PostToolUse;TS generic in description: → stderr warn)
+#   R7 story_baseline_reference(PreToolUse;wrap Sidebar/ChromeHeader/DataTable 無 baseline marker → stderr warn)
+#   R8 story_archetype_registry(PreToolUse;讀 .claude/references/story-baseline-registry.json;
+#      block-severity antiPattern → P0 record_worst 2,2026-06-02 升 P0)
+#
+# Test 重點:silent skip / 各 rule fire / allowlist marker escape。
+# 不測 R3(需 spec.md frontmatter);R8 P0 block-severity 已測(#11 單行 / #12-14 多行回歸防護,2026-06-03)。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_story_invariants.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 event="$1"; local tool="$2"; local file_path="$3"; local content="$4"
+  local payload
+  if [ "$tool" = "Edit" ]; then
+    payload=$(jq -n \
+      --arg ev "$event" --arg tn "$tool" --arg fp "$file_path" --arg c "$content" \
+      '{hook_event_name:$ev, tool_name:$tn, tool_input:{file_path:$fp, new_string:$c}}')
+  else
+    payload=$(jq -n \
+      --arg ev "$event" --arg tn "$tool" --arg fp "$file_path" --arg c "$content" \
+      '{hook_event_name:$ev, tool_name:$tn, tool_input:{file_path:$fp, content:$c}}')
+  fi
+  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, stderr=$([ -n "$STDERR_TEXT" ] && echo non-empty || echo empty))"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_block() {
+  local name="$1"; local needle="$2"
+  if [ "$EXIT" = "2" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected BLOCK exit=2 + '$needle', got 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 stderr warn '$needle', exit=$EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== check_story_invariants tests ==="
+
+# 1. Non-stories file → skip
+run_hook "PreToolUse" "Edit" "/foo/button.tsx" "<table>"
+expect_pass_silent "1. non-stories.tsx → skip"
+
+# 2. Wrong tool → skip
+run_hook "PreToolUse" "Read" "/foo/button.stories.tsx" "<table>"
+expect_pass_silent "2. tool=Read → skip"
+
+# 3. R2 slot_split: WithStartIcon + WithEndIcon both → BLOCK exit 2
+STORIES_BTN="/foo/my-project/packages/design-system/src/components/Button/button.stories.tsx"
+run_hook "PreToolUse" "Write" "$STORIES_BTN" '
+export const Default = { args: {} };
+export const WithStartIcon = { args: { startIcon: <Icon /> } };
+export const WithEndIcon = { args: { endIcon: <Icon /> } };
+'
+expect_block "3. R2 WithStartIcon + WithEndIcon → BLOCK" "WithStartIcon + WithEndIcon"
+
+# 4. R2 slot_split: allow marker → silent
+run_hook "PreToolUse" "Write" "$STORIES_BTN" '// @story-split-rationale: legacy showcase
+export const Default = { args: {} };
+export const WithStartIcon = { args: { startIcon: <Icon /> } };
+export const WithEndIcon = { args: { endIcon: <Icon /> } };
+'
+expect_pass_silent "4. R2 with @story-split-rationale marker → silent"
+
+# 5. R1 anatomy: raw <table> outside DataTable → BLOCK exit 2
+run_hook "PreToolUse" "Write" "$STORIES_BTN" '
+export const Default = () => (
+  <div>
+    <table>
+      <tr><td>x</td></tr>
+    </table>
+  </div>
+);
+'
+expect_block "5. R1 raw <table> outside DataTable → BLOCK" "raw <table>"
+
+# 6. R1 anatomy: allowlist @anatomy-exempt: → silent
+run_hook "PreToolUse" "Write" "$STORIES_BTN" '// @anatomy-exempt: legacy demo with raw table
+export const Default = () => (
+  <div>
+    <table>
+      <tr><td>x</td></tr>
+    </table>
+  </div>
+);
+'
+expect_pass_silent "6. R1 @anatomy-exempt marker → silent"
+
+# 7. Clean story (no violations) → silent
+# Note: AllVariants alone(no Default)since hook flags `Default + AllVariants` as redundant
+STORIES_CLEAN="/foo/my-project/packages/design-system/src/components/Foo/foo.stories.tsx"
+run_hook "PreToolUse" "Write" "$STORIES_CLEAN" '
+export const AllVariants = { args: {} };
+export const Disabled = { args: { disabled: true } };
+'
+expect_pass_silent "7. clean story (AllVariants + Disabled, no anti-patterns) → silent"
+
+# 8. R5 name_jargon (PostToolUse, reads disk): L<n> layer name → stderr warn
+STORIES_DISK="$TMP_DIR/datatable.stories.tsx"
+cat > "$STORIES_DISK" <<'EOF'
+export const Default = {
+  name: 'L1 基本展示',
+};
+EOF
+run_hook "PostToolUse" "Edit" "$STORIES_DISK" "(any update marker)"
+# R5 emits 'L<n> layer 代號' warning via stderr-injected context;但實際 hook emit
+# 是 jq stdout JSON,我們檢 STDERR 是否含 violation 或 stdout — 兩種任一即算 hit。
+# 觀察 source:rule_name_jargon 用 jq -n stdout(不是 stderr)。改檢 STDOUT。
+# 重跑 — 拿 stdout
+payload=$(jq -n --arg ev "PostToolUse" --arg fp "$STORIES_DISK" \
+  '{hook_event_name:$ev, tool_name:"Edit", tool_input:{file_path:$fp, new_string:""}}')
+STDOUT_PATH=$(mktemp); STDERR_PATH=$(mktemp)
+set +e
+printf '%s' "$payload" | bash "$HOOK" >"$STDOUT_PATH" 2>"$STDERR_PATH"
+EXIT=$?
+set -e
+STDOUT_TEXT=$(cat "$STDOUT_PATH")
+STDERR_TEXT=$(cat "$STDERR_PATH")
+rm -f "$STDOUT_PATH" "$STDERR_PATH"
+if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -q "L<n>"; then
+  echo "  PASS  8. R5 PostToolUse L<n> layer name → stdout JSON warn"
+  PASS=$((PASS+1))
+else
+  echo "  FAIL  8. R5 PostToolUse L<n> layer name → expected stdout 'L<n>'"
+  echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'
+  echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'
+  FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - 8. R5"
+fi
+
+# 9. R4 title_canonical: prop-leak syntax in name → P1 stderr warn (exit 0)
+# Use prop/parameter leak pattern `(prop)` which matches `\([a-zA-Z]+\)` branch — robust on macOS BSD grep
+# (pure English non-whitelisted depends on `[^\x00-\x7F]` regex semantics which vary)
+run_hook "PreToolUse" "Write" "$STORIES_CLEAN" "
+export const Default = {
+  name: 'Default (size=md)',
+};
+"
+expect_warn "9. R4 prop-leak syntax in name → P1 warn" "R4 title_canonical"
+
+# 10. R7 baseline reference: wrap <Sidebar> without baseline marker → stderr warn
+# Use a path NOT in skip list (Sidebar/, DataTable/, etc are skipped self-family)
+STORIES_APP="/foo/my-project/packages/design-system/src/components/AppShell/app-shell.stories.tsx"
+run_hook "PreToolUse" "Write" "$STORIES_APP" '
+export const Default = () => (
+  <Sidebar>
+    <SidebarHeader><WorkspaceBrand /></SidebarHeader>
+  </Sidebar>
+);
+'
+expect_warn "10. R7 wrap <Sidebar> no @story-baseline → stderr warn" "R7 story_baseline_reference"
+
+# 11. R8 archetype registry P0(2026-06-02 升 P0;DS+consumer 零違規確認後升級):
+#     wrap <Sidebar> + simplified <SidebarHeader><span> mock(registry block-severity antiPattern)→ BLOCK
+#     有 @story-baseline marker(R7 missing-marker 不 fire)→ exit 2 純由 R8 record_worst 2 造成
+STORIES_R8="/foo/my-project/packages/design-system/src/components/AppShell/app-shell-r8.stories.tsx"
+run_hook "PreToolUse" "Write" "$STORIES_R8" '
+// @story-baseline: @qijenchen/design-system/components/Sidebar/sidebar.stories.tsx#IconCollapse
+export const Default = () => (
+  <Sidebar>
+    <SidebarHeader><span>Acme</span></SidebarHeader>
+  </Sidebar>
+);
+'
+expect_block "11. R8 simplified-mock <SidebarHeader><span> → P0 BLOCK" "R8 story_archetype_registry"
+
+# 12. R8 MULTI-LINE Sidebar drift(2026-06-03 回歸防護;修前 grep -E line-oriented + \s 當字面 's' → 多行靜默漏 = 假 P0):
+#     <SidebarHeader> 與 <span> 分行(真實 JSX 縮排格式)→ 修後(hook tr 換行→空格 + regex [[:space:]])應 BLOCK
+run_hook "PreToolUse" "Write" "$STORIES_R8" '
+// @story-baseline: @qijenchen/design-system/components/Sidebar/sidebar.stories.tsx#IconCollapse
+export const Default = () => (
+  <Sidebar>
+    <SidebarHeader>
+      <span>Acme</span>
+    </SidebarHeader>
+  </Sidebar>
+);
+'
+expect_block "12. R8 多行 <SidebarHeader> 換行 <span> → P0 BLOCK(回歸防護)" "R8 story_archetype_registry"
+
+# 13. R8 MULTI-LINE ChromeHeader drift:<ChromeHeader> 與 <span flex-1> 分行 → 修後應 BLOCK
+#     (修前 [\s\S]*? 在 BSD grep -E 是字元類非「任意字元」+ line-oriented → 雙重漏)
+STORIES_CH="/foo/my-project/packages/design-system/src/components/AppShell/app-shell-ch.stories.tsx"
+run_hook "PreToolUse" "Write" "$STORIES_CH" '
+// @story-baseline: @qijenchen/design-system/components/Sidebar/sidebar.stories.tsx#IconCollapse
+export const Default = () => (
+  <ChromeHeader>
+    <SidebarTrigger />
+    <span className="flex-1 text-body-lg">儀表板</span>
+  </ChromeHeader>
+);
+'
+expect_block "13. R8 多行 <ChromeHeader> 換行 <span flex-1> → P0 BLOCK" "R8 story_archetype_registry"
+
+# 14. R8 false-positive 防護:正確多行 ChromeHeader(h1 緊鄰、無 flex-1 span)+ 另一 story 遠處(距 >160 字)
+#     有無關 flex-1 span → .{0,160} 長度界擋住跨 story 誤匹配(greedy .* boolean 等同 lazy,故必設界)→ NO block
+run_hook "PreToolUse" "Write" "$STORIES_CH" '
+// @story-baseline: @qijenchen/design-system/components/Sidebar/sidebar.stories.tsx#IconCollapse
+export const Correct = () => (
+  <ChromeHeader>
+    <SidebarTrigger />
+    <h1 className="text-body-lg font-medium">儀表板</h1>
+  </ChromeHeader>
+);
+export const Unrelated = () => (
+  <div className="grid grid-cols-3 gap-4 rounded-lg border border-border bg-surface p-6 mt-4">
+    <div className="text-body-sm text-muted">統計面板區塊內容說明文字</div>
+    <span className="flex-1">無關的彈性間距元素</span>
+  </div>
+);
+'
+expect_pass_silent "14. R8 正確多行 ChromeHeader + 遠處無關 flex-1(>160 字)→ 不誤判"
+
+# 15. R8 disk @story-baseline-allow 豁免(2026-06-03 回歸防護,fragment-vs-file bug class,對抗稽核抓到):
+#     檔頭有 @story-baseline-allow 的 disk 檔 + Edit 只送無 marker 片段(含 antiPattern)→ R8 不擋
+#     (補查整檔 disk head;修前只查片段 → 編輯有 marker 的 story 任一非 marker 行就被 R8 誤擋)。
+#     斷言 EXIT=0(R8 未 record_worst 2);R7 anti-pattern stderr 警告與否不影響此斷言。
+DISK_STORY_R8="$TMP_DIR/r8-disk-allow.stories.tsx"
+printf '%s\n' "// @story-baseline-allow: legacy migration RFC-123" "export const X = () => (<Sidebar><SidebarHeader><span>A</span></SidebarHeader></Sidebar>)" > "$DISK_STORY_R8"
+run_hook "PreToolUse" "Edit" "$DISK_STORY_R8" '  <SidebarHeader><span>Acme</span></SidebarHeader>'
+if [ "$EXIT" = "0" ]; then
+  echo "  PASS  15. R8 disk @story-baseline-allow + Edit 無 marker 片段 → R8 不擋(回歸防護)"; PASS=$((PASS+1))
+else
+  echo "  FAIL  15. R8 disk marker exempt (expected exit 0, got exit=$EXIT)"
+  echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+  FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - 15. R8 disk marker"
+fi
+
+# 16. R9 hand-craft overlay/chrome header(2026-06-04 codify per upload-manager 面板 drift):
+#     story 內手刻 <div px-[var(--layout-space-loose)] ... border-b border-divider> → P0 BLOCK
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-handcraft.stories.tsx" '
+export const Panel = () => (
+  <div className="max-w-md rounded-lg border bg-surface shadow-[var(--elevation-200)]">
+    <div className="flex items-center justify-between px-[var(--layout-space-loose)] py-2 border-b border-divider">
+      <span className="text-body font-medium">正在上傳 3 個項目</span>
+    </div>
+  </div>
+);
+'
+expect_block "16. R9 手刻 <div px-loose border-b border-divider> overlay header → P0 BLOCK" "R9 hand-craft overlay"
+
+# 17. R9 false-positive 防護:正確消費 SurfaceHeader + PopoverTitle → 不擋(silent)
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-correct.stories.tsx" '
+export const Panel = () => (
+  <div className="max-w-md flex flex-col rounded-lg border-border bg-surface-raised shadow-[var(--elevation-200)]">
+    <SurfaceHeader className="justify-between">
+      <div className="flex-1 min-w-0"><PopoverTitle>正在上傳 3 個項目</PopoverTitle></div>
+    </SurfaceHeader>
+  </div>
+);
+'
+expect_pass_silent "17. R9 正確消費 SurfaceHeader+PopoverTitle → 不誤判"
+
+# 18. R9 false-positive 防護:doc-table row 用 px-4(非 loose token)+ border-b → 不擋
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-doctable.stories.tsx" '
+export const Tbl = () => (<div className="px-4 py-2.5 border-b border-divider bg-neutral-hover">表頭列</div>);
+'
+expect_pass_silent "18. R9 doc-table px-4 + border-b(非 loose token)→ 不誤判"
+
+# 19. R9 escape:檔頭 @story-baseline-allow → 不擋
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-allow.stories.tsx" '// @story-baseline-allow: legacy panel demo
+export const P = () => (<div className="px-[var(--layout-space-loose)] py-2 border-b border-divider" />);
+'
+expect_pass_silent "19. R9 @story-baseline-allow 豁免 → 不擋"
+
+# 20. R9 FN-001 回歸(2026-06-04 adversarial workflow):多行 className flatten 後多空格 → 仍 BLOCK
+#     (修前單空格 regex 漏;改 border-b[[:space:]]+border-divider)
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-multispace.stories.tsx" 'export const P = () => (
+  <div
+    className="flex justify-between px-[var(--layout-space-loose)] py-2
+      border-b
+      border-divider"
+  >正在上傳</div>
+);
+'
+expect_block "20. R9 多行/多空格 className 手刻 header → BLOCK(FN-001 修)" "R9 hand-craft overlay"
+
+# 21. R9 FP-001 防護:border-b border-divider 在 data-* 屬性(非 className)→ 不擋
+#     (修前 [^>]* 跨屬性誤判;改 [^\">]* 限同 className 字串)
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-crossattr.stories.tsx" '
+export const P = () => (<div className="px-[var(--layout-space-loose)]" data-x="border-b border-divider">x</div>);
+'
+expect_pass_silent "21. R9 border-divider 在 data-* 屬性 → 不誤判(FP-001 修)"
+
+# 22. R9 FP-002 防護:純註解行含 pattern → 不擋(drop comment-only line 後 flatten)
+run_hook "PreToolUse" "Write" "$TMP_DIR/r9-comment.stories.tsx" '// 範例(禁): <div className="px-[var(--layout-space-loose)] border-b border-divider">
+export const P = () => (<SurfaceHeader>x</SurfaceHeader>);
+'
+expect_pass_silent "22. R9 純註解行含 pattern → 不誤判(FP-002 修)"
+
+# 23. R9 skip-list 補 isOverlay 家(FileViewer)→ 不擋(R9-SKIP-001)
+run_hook "PreToolUse" "Write" "/foo/my-project/packages/design-system/src/components/FileViewer/fv.stories.tsx" '
+export const P = () => (<div className="px-[var(--layout-space-loose)] border-b border-divider">x</div>);
+'
+expect_pass_silent "23. R9 skip FileViewer(isOverlay 家)→ 不檢查"
+
+# 24. R10 link_canonical: text-primary hover:underline → P1 warn(非 block)
+run_hook "PreToolUse" "Edit" "/foo/my-project/packages/design-system/src/components/Foo/foo.principles.stories.tsx" '
+<span className="text-primary hover:underline font-medium cursor-pointer">查看詳情</span>
+'
+expect_warn "24. R10 text-primary hover:underline → P1 warn" "R10 link_canonical"
+
+# 25. R10 canonical(hover:text-primary-hover 換色)→ silent
+run_hook "PreToolUse" "Edit" "/foo/my-project/packages/design-system/src/components/Foo/foo.principles.stories.tsx" '
+<span className="text-primary hover:text-primary-hover font-medium cursor-pointer">查看詳情</span>
+'
+expect_pass_silent "25. R10 canonical hover:text-primary-hover → silent"
+
+# 26. R10 escape marker @link-style-allow → silent
+run_hook "PreToolUse" "Edit" "/foo/my-project/packages/design-system/src/components/Foo/foo.principles.stories.tsx" '// @link-style-allow: legacy doc-nav underline
+<span className="text-primary hover:underline">查看詳情</span>
+'
+expect_pass_silent "26. R10 @link-style-allow 豁免 → silent"
+
+# 27. R10 broadened: class-separated(cursor-pointer 隔開)text-primary … hover:underline → warn
+run_hook "PreToolUse" "Edit" "/foo/my-project/packages/design-system/src/components/Foo/foo.anatomy.stories.tsx" '
+<button className="text-caption text-primary cursor-pointer hover:underline">重設</button>
+'
+expect_warn "27. R10 class-separated text-primary…hover:underline → warn" "R10 link_canonical"
+
+# 28. R10 不誤判描述 label「text-primary · hover:underline」(· 非 class-char,如 LinkInput anatomy 註解)→ silent
+run_hook "PreToolUse" "Edit" "/foo/my-project/packages/design-system/src/components/Foo/foo.anatomy.stories.tsx" '
+<span className="text-fg-muted font-mono">text-primary · hover:underline · 點擊開啟連結</span>
+'
+expect_pass_silent "28. R10 描述 label(· 分隔)→ 不誤判"
+
+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_story_name_jargon.sh.broken

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Tests for check_story_name_jargon.sh
+set -u
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Cluster A merge(2026-05-10):check_story_name_jargon.sh fold 進
+# check_story_invariants.sh dispatcher R5(PostToolUse)。Test 走 dispatcher。
+HOOK="$SCRIPT_DIR/../check_story_invariants.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-stories file → silent
+echo "Test 1: non-stories.tsx → silent"
+setup
+echo "export const x = {};" > "$TMP/foo.tsx"
+run "$TMP/foo.tsx"
+[ "$EXIT" = "0" ] && [ -z "$STDOUT" ] && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+teardown
+
+# Test 2: L<n> jargon → flag
+echo "Test 2: 'L2 Selection' name → flagged"
+setup
+echo "export const X = { name: 'L2 Selection — foo' }" > "$TMP/test.stories.tsx"
+run "$TMP/test.stories.tsx"
+echo "$STDOUT" | grep -q "layer 代號" && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL: $STDOUT"; FAIL=$((FAIL+1)); }
+teardown
+
+# Test 3: 'canonical' in name → flag
+echo "Test 3: 'canonical' name → flagged"
+setup
+echo "export const X = { name: '基本(canonical)' }" > "$TMP/test.stories.tsx"
+run "$TMP/test.stories.tsx"
+echo "$STDOUT" | grep -q "canonical" && { echo "  PASS"; PASS=$((PASS+1)); } || { echo "  FAIL"; FAIL=$((FAIL+1)); }
+teardown
+
+# Test 4: clean name → silent
+echo "Test 4: 人話 name → silent"
+setup
+echo "export const X = { name: '基本' }" > "$TMP/test.stories.tsx"
+run "$TMP/test.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_story_slot_split.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+# Tests for check_story_slot_split.sh
+#
+# Drives PreToolUse Edit/Write payloads on stdin and verifies block vs pass
+# for Manual story 拆分原則(.claude/rules/story-rules.md Polaris/Carbon idiom)。
+#
+# Usage: bash test_check_story_slot_split.sh
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Cluster A merge(2026-05-10):check_story_slot_split.sh fold 進
+# check_story_invariants.sh dispatcher R2。Test 走 dispatcher。
+HOOK="$SCRIPT_DIR/../check_story_invariants.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() {
+  local name="$1"
+  if [ "$EXIT" = "0" ]; then
+    echo "  PASS  $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit 0, got $EXIT)"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_block() {
+  local name="$1"
+  local needle="$2"
+  if [ "$EXIT" = "2" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit 2 + '$needle')"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+# ── Test 1: WithStartIcon + WithEndIcon 拆兩 → block ─────────────────────────
+echo "Test 1: WithStartIcon + WithEndIcon 同檔 → block"
+read -r -d '' T1 <<'EOF' || true
+export const WithStartIcon: Story = { args: { startIcon: Plus } }
+export const WithEndIcon: Story = { args: { endIcon: ChevronDown } }
+EOF
+run_hook "/fake/chip.stories.tsx" "$T1"
+expect_block "Test 1 WithStartIcon + WithEndIcon blocked" "WithStartIcon + WithEndIcon"
+
+# ── Test 2: 只 WithIcon → pass ─────────────────────────────────────────────────
+echo ""
+echo "Test 2: 只 WithIcon → pass"
+read -r -d '' T2 <<'EOF' || true
+export const WithIcon: Story = { args: { startIcon: Plus, endIcon: ChevronDown } }
+EOF
+run_hook "/fake/chip.stories.tsx" "$T2"
+expect_pass "Test 2 WithIcon alone passes"
+
+# ── Test 3: Default + AllVariants → block ─────────────────────────────────────
+echo ""
+echo "Test 3: Default + AllVariants 同檔 → block"
+read -r -d '' T3 <<'EOF' || true
+export const Default: Story = { args: { variant: 'primary' } }
+export const AllVariants: Story = { render: () => (<>...</>) }
+EOF
+run_hook "/fake/button.stories.tsx" "$T3"
+expect_block "Test 3 Default + AllVariants blocked" "Default + AllVariants"
+
+# ── Test 4: 只 AllVariants → pass ──────────────────────────────────────────────
+echo ""
+echo "Test 4: 只 AllVariants → pass"
+read -r -d '' T4 <<'EOF' || true
+export const AllVariants: Story = { render: () => (<>...</>) }
+EOF
+run_hook "/fake/button.stories.tsx" "$T4"
+expect_pass "Test 4 AllVariants alone passes"
+
+# ── Test 5: Primary + Secondary + Tertiary 拆三 → block ───────────────────────
+echo ""
+echo "Test 5: Primary + Secondary + Tertiary 拆細 → block"
+read -r -d '' T5 <<'EOF' || true
+export const Primary: Story = { args: { variant: 'primary' } }
+export const Secondary: Story = { args: { variant: 'secondary' } }
+export const Tertiary: Story = { args: { variant: 'tertiary' } }
+EOF
+run_hook "/fake/button.stories.tsx" "$T5"
+expect_block "Test 5 Primary/Secondary/Tertiary split blocked" "拆細"
+
+# ── Test 6: anatomy.stories.tsx 不在 scope → pass even with violation ─────────
+echo ""
+echo "Test 6: anatomy.stories.tsx out of scope → pass"
+read -r -d '' T6 <<'EOF' || true
+export const WithStartIcon: Story = { args: { startIcon: Plus } }
+export const WithEndIcon: Story = { args: { endIcon: ChevronDown } }
+EOF
+run_hook "/fake/chip.anatomy.stories.tsx" "$T6"
+expect_pass "Test 6 anatomy.stories.tsx out of scope"
+
+# ── Test 7: allowlist // @story-split-rationale: → bypass ─────────────────────
+echo ""
+echo "Test 7: allowlist marker → bypass"
+read -r -d '' T7 <<'EOF' || true
+// @story-split-rationale: startIcon vs endIcon 教不同 visual rules due to specific composition
+export const WithStartIcon: Story = { args: { startIcon: Plus } }
+export const WithEndIcon: Story = { args: { endIcon: ChevronDown } }
+EOF
+run_hook "/fake/special.stories.tsx" "$T7"
+expect_pass "Test 7 allowlist bypasses"
+
+# ── Test 8: 非 stories.tsx 不在 scope → pass ──────────────────────────────────
+echo ""
+echo "Test 8: .tsx (non-stories) → pass"
+run_hook "/fake/Button.tsx" "export const WithStartIcon = ... export const WithEndIcon = ..."
+expect_pass "Test 8 non-stories 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/tests/test_check_storybook_addon_packaging.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# test_check_storybook_addon_packaging.sh — 聚合測試(2026-06-11 prune merge 同名 coverage)
+# check_storybook_addon_packaging.sh 為 multi-rule 合併檔;各規則的完整 positive/negative 案例在下列既有
+# per-rule 測試(已 repoint 至合併檔)。本檔 = name-matched coverage gate 入口,零重複。
+set -uo pipefail
+DIR="$(dirname "$0")"
+fail=0
+bash "$DIR/test_check_addon_subdir_ship.sh" < /dev/null || { echo "SUB-FAIL: test_check_addon_subdir_ship.sh"; fail=1; }
+bash "$DIR/test_check_storybook_addon_preset_cjs.sh" < /dev/null || { echo "SUB-FAIL: test_check_storybook_addon_preset_cjs.sh"; fail=1; }
+exit $fail