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

package/ds-canonical/hooks/tests/test_check_story_category.sh.broken

@@ -0,0 +1,187 @@
+#!/bin/bash
+# Tests for check_story_category.sh
+# Verifies trait-based compliance enforcement
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Cluster A merge(2026-05-10):check_story_category.sh fold 進
+# check_story_invariants.sh dispatcher R3。Test 走 dispatcher。
+HOOK="$SCRIPT_DIR/../check_story_invariants.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+
+PASS=0; FAIL=0; FAILED=""
+
+setup_proj() {
+  TMP_PROJ=$(mktemp -d)
+  mkdir -p "$TMP_PROJ/src/design-system/components/Foo" "$TMP_PROJ/.claude/hooks"
+  echo 'log_hook_fire() { :; }' > "$TMP_PROJ/.claude/hooks/_log-fire.sh"
+}
+teardown_proj() { rm -rf "$TMP_PROJ"; }
+
+run_hook() {
+  local content="$1"
+  local file_path="$2"
+  local payload
+  payload=$(jq -n \
+    --arg fp "$file_path" \
+    --arg ct "$content" \
+    '{tool_name:"Write", tool_input:{file_path:$fp, content:$ct}}')
+  STDOUT=$(echo "$payload" | bash "$HOOK" 2>&1)
+  EXIT=$?
+}
+
+# ── Test 1: no spec.md → silent pass ─────────────────────────────────────────
+echo "Test 1: no spec.md → silent pass"
+setup_proj
+run_hook "export const Default = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 1"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 1 (exit=$EXIT, output=${STDOUT:0:100})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 1"
+fi
+teardown_proj
+
+# ── Test 2: spec without traits frontmatter → silent pass ────────────────────
+echo "Test 2: spec without traits → silent pass"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+# Foo
+Some content.
+EOF
+run_hook "export const Default = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 2"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 2 (exit=$EXIT, output=${STDOUT:0:100})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 2"
+fi
+teardown_proj
+
+# ── Test 3: hasSizes trait + AllSizes present → pass ─────────────────────────
+echo "Test 3: hasSizes + AllSizes present → pass"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+---
+component: Foo
+traits:
+  - hasSizes
+  - hasInteractiveStates
+---
+# Foo
+EOF
+run_hook "export const Default = {};
+export const AllSizes = {};
+export const Disabled = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 3"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 3 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 3"
+fi
+teardown_proj
+
+# ── Test 4: hasSizes trait + per-size split → BLOCK ──────────────────────────
+echo "Test 4: hasSizes + Small/Medium/Large split → block P0"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+---
+traits:
+  - hasSizes
+---
+EOF
+run_hook "export const Default = {};
+export const Small = {};
+export const Medium = {};
+export const Large = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "2" ] && echo "$STDOUT" | grep -q "per-size split detected"; then
+  echo "  PASS  Test 4 per-size split blocked"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 4 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 4"
+fi
+teardown_proj
+
+# ── Test 5: isOverlay trait + no OpenSnapshot → BLOCK ────────────────────────
+echo "Test 5: isOverlay + no OpenSnapshot → block P0"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+---
+traits:
+  - isOverlay
+---
+EOF
+run_hook "export const Default = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "2" ] && echo "$STDOUT" | grep -q "isOverlay"; then
+  echo "  PASS  Test 5 overlay missing OpenSnapshot blocked"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 5 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 5"
+fi
+teardown_proj
+
+# ── Test 6: isOverlay + defaultOpen present → pass ───────────────────────────
+echo "Test 6: isOverlay + defaultOpen=true present → pass"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+---
+traits:
+  - isOverlay
+---
+EOF
+run_hook "export const Default = { args: { defaultOpen: true } };" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 6 defaultOpen ✓ pass"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 6 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 6"
+fi
+teardown_proj
+
+# ── Test 7: rationale escape allowlist ──────────────────────────────────────
+echo "Test 7: @story-trait-rationale escape → pass"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+---
+traits:
+  - hasSizes
+---
+EOF
+run_hook "// @story-trait-rationale: experimental design exploration
+export const Small = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.stories.tsx"
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 7 rationale escape works"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 7 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 7"
+fi
+teardown_proj
+
+# ── Test 8: anatomy/principles stories skipped ──────────────────────────────
+echo "Test 8: .anatomy.stories.tsx skipped(not subject to trait typology)"
+setup_proj
+cat > "$TMP_PROJ/src/design-system/components/Foo/foo.spec.md" <<EOF
+---
+traits:
+  - hasSizes
+---
+EOF
+run_hook "export const Small = {};" "$TMP_PROJ/src/design-system/components/Foo/foo.anatomy.stories.tsx"
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 8 anatomy stories exempted"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 8 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 8"
+fi
+teardown_proj
+
+# ── Summary ─────────────────────────────────────────────────────────────────
+echo ""
+echo "════════════════════════════════════════"
+echo "  Results: $PASS PASS, $FAIL FAIL"
+echo "════════════════════════════════════════"
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed:%b\n" "$FAILED"; exit 1
+fi
+exit 0

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

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

@@ -0,0 +1,209 @@
+#!/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,warn-only)
+#
+# Test 重點:silent skip / 各 rule fire / allowlist marker escape。
+# 不測 R3/R8(需 spec.md 或 registry 完整 fixture,scope 超 batch A)。
+
+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><span>Acme</span></SidebarHeader>
+  </Sidebar>
+);
+'
+expect_warn "10. R7 wrap <Sidebar> no @story-baseline → stderr warn" "R7 story_baseline_reference"
+
+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