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

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

@@ -0,0 +1,197 @@
+#!/bin/bash
+# Tests for check_story_anatomy.sh
+#
+# Runs 5 scenarios by crafting PreToolUse JSON payloads on stdin and checking
+# the hook's exit code (0 = pass / 2 = block) + stderr output.
+#
+# Usage: bash test_check_story_anatomy.sh
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Cluster A merge(2026-05-10):check_story_anatomy.sh 已 fold 進
+# check_story_invariants.sh dispatcher R1。本 test 改 call dispatcher,
+# dispatcher 會跑 5 rule(R1 anatomy + R2-R5),anatomy 違反時 R1 fire 攔截。
+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=""
+
+# ── Helpers ──────────────────────────────────────────────────────────────────
+
+# run_hook <file_path> <content> → emits JSON payload and runs hook
+# Captures exit code in $EXIT, stderr in $STDERR, stdout in $STDOUT
+run_hook() {
+  local file_path="$1"
+  local content="$2"
+  local tool="${3:-Write}"
+
+  local payload
+  payload=$(jq -n \
+    --arg tool "$tool" \
+    --arg fp "$file_path" \
+    --arg c  "$content" \
+    '{tool_name: $tool, 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 ---"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    echo "  --- end stderr ---"
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_block() {
+  local name="$1"
+  local needle="$2"
+  if [ "$EXIT" = "2" ]; then
+    if echo "$STDERR_TEXT" | grep -qF "$needle"; then
+      echo "  PASS  $name"
+      PASS=$((PASS+1))
+    else
+      echo "  FAIL  $name (exit 2 OK but stderr missing '$needle')"
+      echo "  --- stderr ---"
+      echo "$STDERR_TEXT" | sed 's/^/    /'
+      echo "  --- end stderr ---"
+      FAIL=$((FAIL+1))
+      FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+    fi
+  else
+    echo "  FAIL  $name (expected exit 2, got $EXIT)"
+    echo "  --- stderr ---"
+    echo "$STDERR_TEXT" | sed 's/^/    /'
+    echo "  --- end stderr ---"
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+# ── Test 1: Normal story using <MenuItem> → pass ─────────────────────────────
+echo "Test 1: normal <MenuItem> usage → pass"
+read -r -d '' T1_CONTENT <<'EOF' || true
+import { MenuItem, ItemIcon, ItemLabel } from '@/design-system/patterns/element-anatomy/item-anatomy'
+import { Folder } from 'lucide-react'
+
+export const Default = {
+  render: () => (
+    <MenuItem>
+      <ItemIcon icon={Folder} />
+      <ItemLabel>專案檔案</ItemLabel>
+    </MenuItem>
+  ),
+}
+EOF
+run_hook "/fake/src/design-system/components/Menu/menu.stories.tsx" "$T1_CONTENT"
+expect_pass "Test 1 normal MenuItem usage passes"
+
+# ── Test 2: hand-craft raw row → block ───────────────────────────────────────
+echo ""
+echo "Test 2: raw <div flex items-center><Icon/> → block"
+read -r -d '' T2_CONTENT <<'EOF' || true
+import { Folder } from 'lucide-react'
+
+export const Default = {
+  render: () => (
+    <div className="flex items-center gap-2 px-3 py-2"><Folder className="size-4" />
+      <span>專案檔案</span>
+    </div>
+  ),
+}
+EOF
+run_hook "/fake/src/design-system/components/Menu/menu.stories.tsx" "$T2_CONTENT"
+expect_block "Test 2 raw item-anatomy row is blocked" "A.1"
+
+# ── Test 3: dismiss via label Button → block ─────────────────────────────────
+echo ""
+echo "Test 3: <Button>關閉</Button> under onClose context → block"
+read -r -d '' T3_CONTENT <<'EOF' || true
+import { Dialog, DialogHeader } from '@/design-system/components/Dialog/dialog'
+import { Button } from '@/design-system/components/Button/button'
+
+export const Default = {
+  render: ({ onClose }: { onClose: () => void }) => (
+    <Dialog>
+      <DialogHeader>
+        <h2>確認送出</h2>
+        <Button onClick={onClose}>關閉</Button>
+      </DialogHeader>
+    </Dialog>
+  ),
+}
+EOF
+run_hook "/fake/src/design-system/components/Dialog/dialog.stories.tsx" "$T3_CONTENT"
+expect_block "Test 3 dismiss via label Button is blocked" "B dismiss via label Button"
+
+# ── Test 4: file-level allowlist → bypass ────────────────────────────────────
+echo ""
+echo "Test 4: file-level // @anatomy-exempt marker → pass even with violation"
+read -r -d '' T4_CONTENT <<'EOF' || true
+// @anatomy-exempt: teaching raw primitive — anatomy docs show internals
+import { Folder } from 'lucide-react'
+
+export const Anatomy = {
+  render: () => (
+    <div className="flex items-center gap-2"><Folder className="size-4" />
+      <span>anatomy demo</span>
+    </div>
+  ),
+}
+EOF
+run_hook "/fake/src/design-system/components/Menu/menu.stories.tsx" "$T4_CONTENT"
+expect_pass "Test 4 file-level exempt bypasses hook"
+
+# ── Test 5: per-line allowlist → only that line skipped, next violation blocks ──
+echo ""
+echo "Test 5: // @anatomy-exempt-next skips only the following line"
+# First sub-test: the exempted line is clean, hook should still block on a
+# NEW violation later in the file.
+read -r -d '' T5_CONTENT <<'EOF' || true
+import { Folder } from 'lucide-react'
+
+export const Demo = {
+  render: () => (
+    <>
+      {/* @anatomy-exempt-next */}
+      <div className="flex items-center gap-2"><Folder className="size-4" /><span>exempt</span></div>
+      <div className="flex items-center gap-2"><Folder className="size-4" /><span>NOT exempt</span></div>
+    </>
+  ),
+}
+EOF
+run_hook "/fake/src/design-system/components/Menu/menu.stories.tsx" "$T5_CONTENT"
+expect_block "Test 5 per-line exempt skips one line but next violation still blocks" "A.1"
+
+# ── 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_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