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

package/ds-canonical/hooks/lib/_layout_space_canonical.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# PostToolUse hook: detect layoutSpace canonical violations in stories / showcase tsx.
+#
+# Catches typical block-vs-inline gap mistakes per layoutSpace.spec.md:
+# 1. Hardcoded mt-N / mb-N / pt-N / pb-N (4/6/8) instead of tokens — should use --layout-space-*
+# 2. gap-tight on a flex column form with all-inline elements (should be loose per rule 3)
+# 3. block element (DataTable / Textarea / Editor) followed by mt-tight on next sibling
+#    (block → 容器底 / chrome band 應該 loose,規則 4)
+#
+# Scope: design-system stories.tsx + app/ + explorations/ (consumer-side layout).
+# WARN-style (not BLOCK): emit additionalContext so AI reads and can fix.
+
+# Per-hook fire logging
+source "$(dirname "$0")/../_log-fire.sh" 2>/dev/null && log_hook_fire
+
+FILE_PATH=$(jq -r '.tool_input.file_path // empty')
+
+# Scope: only stories.tsx + app code (not core component .tsx — they own their own internal padding)
+if ! echo "$FILE_PATH" | grep -qE '(\.stories\.tsx$|src/app/.*\.tsx$|src/explorations/.*\.tsx$)'; then
+  exit 0
+fi
+if [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+VIOLATIONS=""
+
+# ── Check 1: hardcoded mt-N / mb-N adjacent to <DataTable / Textarea / Editor> ──
+# Block elements need loose bottom/top gap; tight is rule violation.
+# Pattern: <DataTable...>...</...> followed by <Alert / BulkActionBar / div with mt-tight>
+BLOCK_TIGHT_HITS=$(grep -nE "(mt|mb)-\[var\(--layout-space-tight\)\]" "$FILE_PATH" 2>/dev/null | head -5)
+if [ -n "$BLOCK_TIGHT_HITS" ]; then
+  # Only flag if file ALSO contains block elements (DataTable / Textarea / Editor / CodeBlock)
+  if grep -qE '<(DataTable|Textarea|Editor|CodeBlock)' "$FILE_PATH" 2>/dev/null; then
+    VIOLATIONS="${VIOLATIONS}\n⚠️ tight margin near block element(可能違反規則 4:block → 容器底 / chrome band = loose):\n${BLOCK_TIGHT_HITS}\n  → 確認該位置:block 旁邊應 loose;只有 block ↔ block 緊鄰且都在 form 內才用 tight。"
+  fi
+fi
+
+# ── Check 3: gap-tight on flex column form with all-inline (likely violation)──
+# 規則 3:inline ↔ inline = loose,不是 tight
+GAP_TIGHT_FLEX=$(grep -nE 'flex-col\s+gap-\[var\(--layout-space-tight\)\]' "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$GAP_TIGHT_FLEX" ]; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ flex-col gap-tight(若內容全是 inline 元件就違反規則 3:inline ↔ inline 應 loose):\n${GAP_TIGHT_FLEX}\n  → 確認 form 內含 block(Table/Textarea/Editor)?有 → 保留 tight 合規;全 inline → 改 loose。"
+fi
+
+if [ -n "$VIOLATIONS" ]; then
+  ADDITIONAL_CONTEXT=$(printf '⚠️ layoutSpace canonical 提醒(tokens/layoutSpace/layoutSpace.spec.md):%b' "$VIOLATIONS")
+  jq -n --arg ctx "$ADDITIONAL_CONTEXT" '{
+    hookSpecificOutput: {
+      hookEventName: "PostToolUse",
+      additionalContext: $ctx
+    }
+  }'
+fi
+
+exit 0

package/ds-canonical/hooks/lib/_overlay_handcraft.sh

@@ -0,0 +1,162 @@
+#!/bin/bash
+# PostToolUse hook: detect hand-crafted overlay chrome violating mindset #2.
+#
+# Catches: <div className="...px-[var(--layout-space-loose)]...border-(b|t) border-divider">
+# in stories.tsx / DataTable helper.tsx / app code — pattern means consumer self-rendered
+# overlay header/footer chrome instead of consuming SurfaceHeader / SurfaceBody / SurfaceFooter
+# (or PopoverHeader / DialogHeader / SheetHeader).
+#
+# Why block: canonical primitives bundle padding + border + close X (Popover) + autofocus +
+# typography (PopoverTitle text-body font-medium). Self-rendering bypasses these = mindset #2
+# violation + silently breaks alignment / close X 一致性。
+#
+# 對齊 patterns/overlay-surface/overlay-surface.spec.md「Consumer rule」+
+# components/Popover/popover.tsx:72「所有 PopoverHeader 一律附右上 X」canonical。
+#
+# Escape hatch:add `// overlay-handcraft-allow: <reason>` on prev/same line for intentional cases
+# (e.g. non-overlay panel that just borrows the layout-space token).
+#
+# WARN-style (additionalContext) — AI reads + fixes next iteration.
+
+# Per-hook fire logging
+source "$(dirname "$0")/../_log-fire.sh" 2>/dev/null && log_hook_fire
+
+FILE_PATH=$(jq -r '.tool_input.file_path // empty')
+
+# Scope: tsx files (stories, components, patterns, app, explorations)
+if ! echo "$FILE_PATH" | grep -qE '\.tsx$'; then
+  exit 0
+fi
+# Skip spec.md / anatomy stories (different context)
+if echo "$FILE_PATH" | grep -qE '(\.spec\.md$|\.anatomy\.stories\.tsx$|\.principles\.stories\.tsx$)'; then
+  exit 0
+fi
+if [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# Pattern: <div className="...px-[var(--layout-space-loose)]...border-(b|t) border-divider...">
+PATTERN='<div className="[^"]*px-\[var\(--layout-space-loose\)\][^"]*border-(b|t) border-divider'
+HITS=$(grep -nE "$PATTERN" "$FILE_PATH" 2>/dev/null | head -5)
+
+if [ -n "$HITS" ]; then
+  # filter out lines with allowlist comment
+  FILTERED=""
+  while IFS= read -r line; do
+    line_num=$(echo "$line" | cut -d: -f1)
+    [ -z "$line_num" ] && continue
+    # check current line + previous line for allowlist
+    prev_line=$(sed -n "$((line_num-1))p" "$FILE_PATH" 2>/dev/null)
+    cur_line=$(sed -n "${line_num}p" "$FILE_PATH" 2>/dev/null)
+    if echo "$prev_line $cur_line" | grep -q 'overlay-handcraft-allow:'; then
+      continue
+    fi
+    FILTERED="${FILTERED}${line}\n"
+  done <<< "$HITS"
+
+  if [ -n "$FILTERED" ]; then
+    VIOLATIONS="${VIOLATIONS}\n⚠️ Hand-crafted overlay chrome detected(自刻 overlay 結構違 mindset #2):\n${FILTERED}\n  → 改用 primitive:\n    Popover content → PopoverHeader / PopoverBody / PopoverFooter / PopoverTitle\n    Dialog content → DialogHeader / DialogBody / DialogFooter / DialogTitle\n    Generic overlay panel → SurfaceHeader / SurfaceBody / SurfaceFooter (overlay-surface)\n  Why:canonical 自帶 padding token + border + close X(Popover)+ autofocus + title typography。\n  Escape hatch:加 \`// overlay-handcraft-allow: <reason>\` 在同/前行。"
+  fi
+fi
+
+# ── Check 2.5: Raw row handcraft (px-loose + py + rounded-md + hover:bg-neutral-hover) ──
+# Pattern:`<div className="...flex...gap-2 px-loose py-1.5 rounded-md hover:bg-neutral-hover">`
+# = 自刻 MenuItem-like row 違反 mindset #2(MenuItem primitive 自帶這些 + size canonical + a11y)
+ROW_PATTERN='<div className="[^"]*flex[^"]*gap-[12][^"]*px-\[var\(--layout-space-loose\)\][^"]*hover:bg-neutral-hover[^"]*rounded'
+ROW_HITS=$(grep -nE "$ROW_PATTERN" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$ROW_HITS" ] && ! grep -qE 'menu-item-handcraft-allow:' "$FILE_PATH" 2>/dev/null; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ 自刻 row(MenuItem-like)違反 mindset #2:\n${ROW_HITS}\n  → 改用 <MenuItem startIcon={...} endContent={...} disabled={...}>label</MenuItem>\n  Why:MenuItem 自帶 SelectionItem py 公式 + size canonical + a11y(role=option, aria-disabled, aria-selected) + cursor-not-allowed disabled。\n  Escape hatch:加 \`// menu-item-handcraft-allow: <reason>\` 在檔頭。"
+fi
+
+# ── Check 2: Raw <Checkbox> count > 1 not in <CheckboxGroup> ──
+# 同 root cause(自刻 SelectionItem 包 Checkbox 而非消費 CheckboxGroup primitive)。
+# 對齊 checkbox.spec.md「群組模式(CheckboxGroup)」canonical line 225:
+#   多選 Checkbox 必包 <CheckboxGroup>(zero-gap canonical + Context 隔離 + a11y group)。
+# 2026-06-11 R2 held-item #11 context-narrow:檔案級 count 對下列合法 context 永久 FP(8 檔噪音實測):
+#   - DataTable / TreeView:row-selection canonical(selection column / tree 多選 = row anatomy,非 form 群組)
+#   - Checkbox / SelectionControl:selection primitive 自家 stories 示範 raw usage(同 Check 4 menu-primitive skip idiom)
+#   - Field:單顆 Checkbox 包 <Field> = field-controls Family 4 canonical(field.stories.tsx 每顆獨立非群組)
+#   - patterns/element-anatomy:row anatomy SSOT reference 本身
+# 消費者 / 其他 DS 元件自刻多選 list 仍照抓(原 bug class 保護不變)。
+# 2026-06-11 R2 Phase B(codex b3 抓縫):原 DataTable/TreeView 整目錄 skip 會放走目錄內
+# 其他檔(如 filter-panel)的真違規 — 縮到 row-selection canonical 真實檔名 + 自家 primitive。
+IS_CB_LEGIT_CONTEXT=$(echo "$FILE_PATH" | grep -cE '(components/DataTable/data-table\.tsx|components/TreeView/tree-view\.tsx|components/(Checkbox|SelectionControl|Field)/|patterns/element-anatomy/)' | head -1)
+IS_CB_LEGIT_CONTEXT=${IS_CB_LEGIT_CONTEXT:-0}
+CB_COUNT=$(grep -c '<Checkbox\b' "$FILE_PATH" 2>/dev/null | head -1 || echo 0)
+CBG_COUNT=$(grep -c '<CheckboxGroup\b' "$FILE_PATH" 2>/dev/null | head -1 || echo 0)
+CB_COUNT=${CB_COUNT:-0}
+CBG_COUNT=${CBG_COUNT:-0}
+if [ "$CB_COUNT" -ge 2 ] && [ "$CBG_COUNT" -eq 0 ] && [ "$IS_CB_LEGIT_CONTEXT" -eq 0 ]; then
+  CB_HITS=$(grep -nE '<Checkbox\b' "$FILE_PATH" 2>/dev/null | head -3)
+  # allowlist: same-line or prev-line has // checkbox-group-allow:
+  if ! grep -qE 'checkbox-group-allow:' "$FILE_PATH" 2>/dev/null; then
+    VIOLATIONS="${VIOLATIONS}\n⚠️ 多個 raw <Checkbox> 未包 <CheckboxGroup>(${CB_COUNT} hits)— 違反 checkbox.spec.md 群組 canonical:\n${CB_HITS}\n  → 改用 <CheckboxGroup><Checkbox label=\"...\" />...</CheckboxGroup>\n  Why:CheckboxGroup 自帶 zero-gap canonical(SelectionItem py 公式)+ Context 隔離 fieldCtx + a11y group;raw 自刻 wrapper 違 mindset #2。\n  Escape hatch:加 \`// checkbox-group-allow: <reason>\` 在檔頭。"
+  fi
+fi
+
+# ── Check 5: Same-row consistency 違反(同 row 混 ItemInlineActionButton + Button iconOnly)──
+# 對齊 inline-action.spec.md L152「Same-row consistency rule:同 action row 所有 icon action 必同一類」。
+# Pattern:同檔出現 <ItemInlineActionButton 與 <Button.*iconOnly,且非 menu primitive impl(menu 內 Button 為合法 chrome)。
+# 2026-06-11 R2 held-item #11 context-narrow(檔案級 co-occurrence 對合法 chrome-vs-row 永久 FP):
+#   (1) strip 純註解行再 count(對齊 check_story_invariants.sh R9 idiom;file-viewer.tsx 註解 cite
+#       `<Button iconOnly dismiss />` 字樣誤觸;不 strip 行內 // 避免 mutilate https:// URL)
+#   (2) 排除 dismiss Button:chrome corner close X = dismiss canonical(inline-action.spec.md
+#       「Dismiss canonical — X close only」+ button.spec.md「Dismiss 視覺類」),跟 row inline action
+#       永遠不同 row → 非 same-row mixing(把 hook 自述 escape note「chrome corner 跟 row 不同 row 可分開」codify 進 detection)
+#   (3) patterns/element-anatomy/ skip:anatomy SSOT 本身示範兩類對照(含刻意 ❌ mixed 教學例)
+# 真 same-row mixing(非 dismiss 的 iconOnly Button 與 InlineAction 同檔)仍照抓,保護不削弱。
+IS_ANATOMY_SSOT=$(echo "$FILE_PATH" | grep -c 'patterns/element-anatomy/' | head -1)
+IS_ANATOMY_SSOT=${IS_ANATOMY_SSOT:-0}
+OH5_SRC=$(grep -vE '^[[:space:]]*(//|\*|/\*|\{/\*)' "$FILE_PATH" 2>/dev/null)
+HAS_INLINE=$(printf '%s\n' "$OH5_SRC" | grep -c '<ItemInlineActionButton' 2>/dev/null | head -1)
+HAS_BTN_ICON=$(printf '%s\n' "$OH5_SRC" | grep -E '<Button[^>]*iconOnly' 2>/dev/null | grep -cv 'dismiss' | head -1)
+HAS_INLINE=${HAS_INLINE:-0}
+HAS_BTN_ICON=${HAS_BTN_ICON:-0}
+IS_MENU_PRIMITIVE2=$(echo "$FILE_PATH" | grep -cE '(DropdownMenu|SelectMenu|Combobox|Menu)/.*\.tsx$' | head -1)
+IS_MENU_PRIMITIVE2=${IS_MENU_PRIMITIVE2:-0}
+if [ "$HAS_INLINE" -ge 1 ] && [ "$HAS_BTN_ICON" -ge 1 ] && [ "$IS_MENU_PRIMITIVE2" -eq 0 ] && [ "$IS_ANATOMY_SSOT" -eq 0 ]; then
+  if ! grep -qE 'same-row-mixed-allow:' "$FILE_PATH" 2>/dev/null; then
+    VIOLATIONS="${VIOLATIONS}\n⚠️ 同檔混用 <ItemInlineActionButton>(${HAS_INLINE}) + <Button.*iconOnly>(${HAS_BTN_ICON}):\n  → 違反 inline-action.spec.md L152 Same-row consistency rule(同 row icon action 必同一類)。\n  → Box size 不一致(InlineAction 16+18 vs Button text sm 28)會 gap 斷裂。\n  → 修法:row 內 icon action 全 ItemInlineActionButton(對齊 size=md / 16+18 hover bg)。\n  Escape hatch:加 \`// same-row-mixed-allow: <reason>\` 在檔頭(若 chrome corner action group 跟 row 不同 row,可分開)。"
+  fi
+fi
+
+# ── Check 4: Panel-style Popover + MenuItem co-occur(2026-04-29) ──
+# Pattern:同檔出現 <PopoverHeader> 且 <MenuItem>(不是 DropdownMenu / SelectMenu primitive 自身)
+# → panel-style popover 不該硬塞 menu specialization。MenuItem 預設 `px-3` 不對齊 panel chrome
+# `loose`,且 startIcon 色彩無 override → 該用視覺 primitive(ItemPrefix/ItemLabel/ItemSuffix)自組。
+HAS_POP_HEADER=$(grep -c '<PopoverHeader' "$FILE_PATH" 2>/dev/null | head -1)
+HAS_MENU_ITEM=$(grep -c '<MenuItem\b' "$FILE_PATH" 2>/dev/null | head -1)
+HAS_POP_HEADER=${HAS_POP_HEADER:-0}
+HAS_MENU_ITEM=${HAS_MENU_ITEM:-0}
+# Skip:DropdownMenu/SelectMenu primitive impl 本身(他們 import MenuItem 是合法 menu-style)
+IS_MENU_PRIMITIVE=$(echo "$FILE_PATH" | grep -cE '(DropdownMenu|SelectMenu|Combobox)/.*\.tsx$' | head -1)
+IS_MENU_PRIMITIVE=${IS_MENU_PRIMITIVE:-0}
+if [ "$HAS_POP_HEADER" -ge 1 ] && [ "$HAS_MENU_ITEM" -ge 1 ] && [ "$IS_MENU_PRIMITIVE" -eq 0 ]; then
+  if ! grep -qE 'panel-menuitem-allow:' "$FILE_PATH" 2>/dev/null; then
+    VIOLATIONS="${VIOLATIONS}\n⚠️ Panel-style Popover(<PopoverHeader>)+ <MenuItem> 同檔(${HAS_MENU_ITEM} hits):\n  → MenuItem 是 menu specialization(px-3 menu-style + icon 色繼承),不適 panel chrome loose。\n  → 改用視覺 primitive 自組:ItemPrefix + ItemLabel + ItemSuffix(item-anatomy.tsx)+ ROW_PADDING_BY_SIZE.md\n  Why:panel-style 需對齊 chrome \`loose\` + utility chrome icon color(neutral-7 / fg-muted),MenuItem 兩處 workaround = 錯 layer。\n  Escape hatch:加 \`// panel-menuitem-allow: <reason>\` 在檔頭。"
+  fi
+fi
+
+# ── Check 6: Overlay body 重新引入 flush / 等價 boolean variant(2026-05-01)──
+# 對齊 patterns/overlay-surface/overlay-surface.spec.md「List-as-region in overlay body」。
+# 2026-05-01 移除 flush(rationale:Material/Atlassian/Mantine/shadcn 主流不做 universal LayoutBody flush;
+# variant 不解決底層脆弱 — 加 1 row search/banner 就破功)。
+# 防止未來 silent re-introduction:DialogBody / SheetBody / PopoverBody tsx 內出現
+# `flush?: boolean` / `flush = false` / `naked?: boolean` / `bare?: boolean` / `noPadding?: boolean` 同類 boolean 變體。
+# Scope:`components/(Dialog|Sheet|Popover)/*.tsx`(非 stories)。
+IS_OVERLAY_BODY_TSX=$(echo "$FILE_PATH" | grep -cE 'components/(Dialog|Sheet|Popover)/[^/]+\.tsx$' | head -1)
+IS_OVERLAY_BODY_TSX=${IS_OVERLAY_BODY_TSX:-0}
+if [ "$IS_OVERLAY_BODY_TSX" -ge 1 ] && ! echo "$FILE_PATH" | grep -qE '\.stories\.tsx$'; then
+  STRIPPED_PROPS_PATTERN='(flush|naked|bare|stripped|unpadded|noPadding|paddingless)\??:\s*boolean'
+  STRIPPED_HITS=$(grep -nE "$STRIPPED_PROPS_PATTERN" "$FILE_PATH" 2>/dev/null | head -3)
+  if [ -n "$STRIPPED_HITS" ] && ! grep -qE 'overlay-body-stripped-variant-allow:' "$FILE_PATH" 2>/dev/null; then
+    VIOLATIONS="${VIOLATIONS}\n⚠️ Overlay body 重新引入 stripped-padding boolean variant(2026-05-01 已移除):\n${STRIPPED_HITS}\n  → list-as-region in overlay body canonical = consumer 用 className override:\n    <DialogBody className=\"!px-0 !pt-0 !pb-0\"><div className=\"py-2\">{items}</div></DialogBody>\n  Why removed:Material/Atlassian/Mantine/shadcn 主流不做 universal LayoutBody flush;\n  variant 不解決底層脆弱(加 1 row search/banner 就破功)+ 把 1 surface decision 拆兩 API。\n  詳 overlay-surface.spec.md「List-as-region in overlay body」+ memory feedback_layout_v6_canonical.md\n  Escape hatch:加 \`// overlay-body-stripped-variant-allow: <reason>\` 在檔頭(必含 ≥3 家世界級對照 + multi-row hold 保證)。"
+  fi
+fi
+
+if [ -n "$VIOLATIONS" ]; then
+  ESCAPED=$(printf "%b" "$VIOLATIONS" | jq -Rs .)
+  cat <<EOJSON
+{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":"Primitive consumption 檢查發現違規:${ESCAPED}"}}
+EOJSON
+fi

package/ds-canonical/hooks/lib/_person_data_richness.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# PostToolUse hook: catch sparse PersonData literals that violate name-card.spec「DS-wide 預設展示一致 canonical」.
+#
+# Per name-card.spec.md:
+#   所有 PersonData 來源(table seller / picker member / dialog reviewer)展示 NameCard 時
+#   description / status / statusMessage / fields 4 個 section 預設都應提供
+#   sparse `{ name, avatarUrl }` 資料 = bug,違反一致呈現
+#
+# Detects literal `{ name: '...', avatar(Url)?: '...' }` with NO other PersonData fields.
+
+source "$(dirname "$0")/../_log-fire.sh" 2>/dev/null && log_hook_fire
+
+FILE_PATH=$(jq -r '.tool_input.file_path // empty')
+
+if ! echo "$FILE_PATH" | grep -qE '\.(tsx|stories\.tsx)$'; then
+  exit 0
+fi
+if [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# Skip the canonical sources(NameCard / Avatar / person-display 自身)
+if echo "$FILE_PATH" | grep -qE '(NameCard|Avatar|person-display|avatar\.spec)'; then
+  exit 0
+fi
+
+# Match `{ name: '...', avatarUrl?: '...' }` with no other PersonData fields on same line.
+# A "rich" PersonData usually spans multiple lines OR has description/status/statusMessage/fields.
+# Heuristic: single-line literal with only name + avatarUrl(no other PersonData props on same line).
+SPARSE_HITS=$(grep -nE "\{\s*name:\s*['\"][^'\"]+['\"],\s*avatar(Url)?:\s*['\"][^'\"]+['\"]\s*\}" "$FILE_PATH" 2>/dev/null | head -5)
+
+if [ -n "$SPARSE_HITS" ]; then
+  ADDITIONAL_CONTEXT=$(printf 'Sparse PersonData literal(違反 name-card.spec「DS-wide 預設展示一致 canonical」):\n%s\n  → 補上 description / status / statusMessage / fields 4 sections,讓 NameCard hover 展示資訊量一致' "$SPARSE_HITS")
+  jq -n --arg ctx "$ADDITIONAL_CONTEXT" '{
+    hookSpecificOutput: {
+      hookEventName: "PostToolUse",
+      additionalContext: $ctx
+    }
+  }'
+fi
+
+exit 0

package/ds-canonical/hooks/lib/_story_compile_drift.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# PreToolUse Edit/Write: 改過 tsx componentMeta / spec frontmatter 時,
+# 自動跑 compile-stories --check 偵測 drift。
+#
+# 對齊 Story Auto-Compile Phase 4 — stories canonical 從 spec+tsx 機械產,
+# key 不齊 = canonical drift,該修。本 hook 是 write-time early warning
+# (git commit 前),讓 AI / user 立刻看到 drift 而非 audit 時才發現。
+
+# Per-hook fire logging(enables /knowledge-prune D2 dead-hook detection)
+source "$(dirname "$0")/../_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -euo pipefail
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+[ -z "$FILE_PATH" ] && exit 0
+
+# Only trigger on component tsx / spec.md writes
+case "$FILE_PATH" in
+  */design-system/components/*.tsx) ;;
+  */design-system/components/*.spec.md) ;;
+  *) exit 0 ;;
+esac
+
+# Extract component name from path
+COMP_NAME=$(echo "$FILE_PATH" | grep -oE 'components/[^/]+/' | head -1 | sed 's|components/||' | sed 's|/||')
+[ -z "$COMP_NAME" ] && exit 0
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+COMPILE_SCRIPT="$PROJECT_DIR/scripts/compile-stories.mjs"
+
+# Skip if compile script not yet built(graceful for pre-Phase-4 state)
+[ ! -f "$COMPILE_SCRIPT" ] && exit 0
+
+# Run drift check(quiet mode)
+cd "$PROJECT_DIR" || exit 0
+OUTPUT=$(node "$COMPILE_SCRIPT" "$COMP_NAME" --check 2>&1 || true)
+
+# Check if drift detected(exit 1 or has 「spec/tsx canonical drift」 in output)
+if echo "$OUTPUT" | grep -qE "spec/tsx canonical drift|spec-only|tsx-only"; then
+  MSG="📐 Story canonical drift detected in ${COMP_NAME}:\n\n${OUTPUT}\n\nFix tsx componentMeta export 或 spec frontmatter 讓 keys 對齊。"
+  ESCAPED=$(printf '%s' "$MSG" | jq -Rs .)
+  printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","additionalContext":%s}}\n' "$ESCAPED"
+fi
+
+# Skip graceful(migration 未做的元件)不報
+exit 0

package/ds-canonical/hooks/lib/_tab_lg_chrome_header_equal.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+set -uo pipefail
+# Header canonical W3 Token alignment enforcement(per header-canonical.spec.md W3):
+#   --tab-height-lg(uiSize.css)與 --chrome-header-height(globals.css)必像素相等。
+#   兩 token scope 不同(uiSize 是 component-size reset / chrome-header-height 是 app-density)
+#   不該 CSS alias(綁死兩個不同 scope)— 改用 assert: parse 兩檔 md/lg 值對等。
+#
+# PreToolUse(Edit / Write)hook —— 編輯 `packages/design-system/src/tokens/uiSize/uiSize.css` 或
+# `src/globals.css` 時 assert 兩值仍相等。動一方未同步 = BLOCKER。
+#
+# 對齊 M31 codex 比稿 Step 5「保留 duplicated literals + audit hook assert equality」decision。
+
+source "$(dirname "$0")/../_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -euo pipefail
+
+INPUT=$(cat)
+TOOL=$(echo "$INPUT" | jq -r '.tool_name // ""')
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // ""')
+
+case "$TOOL" in
+  Edit|Write|MultiEdit) ;;
+  *) exit 0 ;;
+esac
+
+case "$FILE_PATH" in
+  */packages/design-system/src/tokens/uiSize/uiSize.css|*/src/globals.css) ;;
+  *) exit 0 ;;
+esac
+
+# 2026-06-01 #18 fix(user 授權):lib 被 dispatcher 以 `bash "$helper"` 呼叫($0=lib 自身路徑,在 .claude/hooks/lib/),
+# 需 3 層 ../ 才到 repo root。原 `../..` 只到 .claude → UISIZE_CSS/GLOBALS_CSS 路徑錯 → 兩值皆空 → empty==empty
+# → assertion 一直 vacuous(從不真 enforce,這才是 #18「assertion 失效」的底層根因,比讀錯檔更上游)。
+PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+UISIZE_CSS="$PROJECT_ROOT/packages/design-system/src/tokens/uiSize/uiSize.css"
+GLOBALS_CSS="$PROJECT_ROOT/src/globals.css"
+
+# Extract value of --tab-height-lg in md context(default :root block)
+TAB_LG_MD=$(grep -oE '\--tab-height-lg:[[:space:]]*[0-9.]+rem' "$UISIZE_CSS" | head -1 | grep -oE '[0-9.]+')
+# Extract --tab-height-lg in lg density override(2nd occurrence)
+TAB_LG_LG=$(grep -oE '\--tab-height-lg:[[:space:]]*[0-9.]+rem' "$UISIZE_CSS" | sed -n '2p' | grep -oE '[0-9.]+')
+
+# Extract --chrome-header-height md(1st occurrence)— 2026-06-01 #18 fix(user 授權):讀 uiSize.css(token 真實 SSOT,L50),
+# 非 src/globals.css(22 行 aggregator 無此 token,2026-05-23 deep-audit Decision 1 已搬走)→ 原讀空值,assertion 失效。
+CH_MD=$(grep -oE '\--chrome-header-height:[[:space:]]*[0-9.]+rem' "$UISIZE_CSS" | head -1 | grep -oE '[0-9.]+')
+# Extract --chrome-header-height lg(2nd occurrence in lg override)— 同上讀 uiSize.css(L98)
+CH_LG=$(grep -oE '\--chrome-header-height:[[:space:]]*[0-9.]+rem' "$UISIZE_CSS" | sed -n '2p' | grep -oE '[0-9.]+')
+
+ERRORS=()
+
+if [ "$TAB_LG_MD" != "$CH_MD" ]; then
+  ERRORS+=("md: --tab-height-lg=$TAB_LG_MD rem ≠ --chrome-header-height=$CH_MD rem")
+fi
+
+if [ "$TAB_LG_LG" != "$CH_LG" ]; then
+  ERRORS+=("lg: --tab-height-lg=$TAB_LG_LG rem ≠ --chrome-header-height=$CH_LG rem")
+fi
+
+if [ ${#ERRORS[@]} -gt 0 ]; then
+  printf '🚨 TAB_LG vs CHROME_HEADER_HEIGHT EQUAL BLOCKER(header-canonical.spec.md W3):\n' >&2
+  for E in "${ERRORS[@]}"; do
+    printf '   • %s\n' "$E" >&2
+  done
+  printf '\n  動一方必同步另一方(兩 token 像素相等是「lg tabs 取代 chrome header」SSOT linkage 鐵證)\n' >&2
+  printf '  SSOT: packages/design-system/src/patterns/header-canonical/header-canonical.spec.md W3\n' >&2
+  printf '  修方向: 改 uiSize.css 的 --tab-height-lg OR globals.css 的 --chrome-header-height 讓兩邊相等\n' >&2
+  exit 2
+fi
+
+exit 0

package/ds-canonical/hooks/lib/_token_hygiene.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# PostToolUse hook: catch 5 classes of token hygiene / cross-OS violations on component/pattern tsx edits.
+#
+# Detects (ALL are silent-fail or cross-OS drift bug classes per CLAUDE.md):
+# 1. shadcn compat alias 回流 — bg-popover / text-muted-foreground / bg-accent / text-accent-foreground / text-popover-foreground / bg-destructive / bg-background / bg-card / border-input / text-primary-foreground
+#    (these are shadcn safety-net aliases; our DS code MUST use direct tokens)
+# 2. Tailwind v4 `[--foo]` shorthand — must be `var(--foo)` wrapped; historical bug:
+#    Sidebar's `w-[--sidebar-width]` broke 8 places (silent fail, no error)
+# 3. Hardcoded Tailwind shadow — `shadow-sm/md/lg/xl/2xl` is forbidden; must use `shadow-[var(--elevation-N)] N∈{100,200}`
+# 4. primitive color name used as Tailwind utility — bg-neutral-3 / text-blue-6 silent-fail; use semantic utility or var()
+# 5. Native overflow-{auto,scroll} without ScrollArea — cross-OS scrollbar drift
+#    (macOS overlay 不吃寬 / Windows always-visible 吃 17px = 跨 OS 跑版)
+#    應改用 ScrollArea(Components/ScrollArea/)— overlay scrollbar 跨 OS 一致
+#
+# WARN-style (not BLOCK): hook emits additionalContext so AI reads and can fix in next iteration.
+
+# Per-hook fire logging(enables /knowledge-prune D2 dead-hook detection)
+source "$(dirname "$0")/../_log-fire.sh" 2>/dev/null && log_hook_fire
+
+FILE_PATH=$(jq -r '.tool_input.file_path // empty')
+
+# Scope: only design-system component / pattern .tsx files (not stories, not specs)
+if ! echo "$FILE_PATH" | grep -qE 'packages/design-system/src/(components|patterns)/.*\.tsx$'; then
+  exit 0
+fi
+if echo "$FILE_PATH" | grep -qE '\.stories\.tsx$'; then
+  exit 0
+fi
+if [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+VIOLATIONS=""
+
+# ── Check 1: shadcn compat alias 回流 ─────────────────────────────────────────
+# These are all shadcn safety-net aliases. Our code must use direct tokens instead.
+# bg-muted / bg-secondary / ring-ring are OUR tokens (kept), not listed here.
+SHADCN_PATTERN='\b(bg-popover|text-popover-foreground|text-muted-foreground|bg-accent|text-accent-foreground|bg-destructive|bg-background|bg-card|text-card-foreground|border-input|text-primary-foreground)\b'
+SHADCN_HITS=$(grep -nE "$SHADCN_PATTERN" "$FILE_PATH" 2>/dev/null | head -5)
+if [ -n "$SHADCN_HITS" ]; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ shadcn compat alias found (必須遷移為 direct token):\n${SHADCN_HITS}\n  映射: bg-popover→bg-surface-raised / text-popover-foreground→text-foreground / text-muted-foreground→text-fg-muted / bg-accent→bg-neutral-hover / text-accent-foreground→text-foreground / bg-destructive→bg-error / bg-background→bg-canvas / bg-card→bg-surface / border-input→border-border / text-primary-foreground→text-white"
+fi
+
+# ── Check 2: Tailwind v4 [--foo] shorthand (silent fail) ─────────────────────
+# Arbitrary-value class 引用 CSS variable 必須 var() 包覆,不能 [--foo] shorthand.
+# Matches: w-[--foo], h-[--bar-baz], shadow-[--elevation-100] 等
+# False positive exclusion: [&[data-...]] / [&:hover] 等 arbitrary variants (open bracket 後跟 & 或冒號)
+TWV4_PATTERN='\[--[a-z][a-z0-9-]*\]'
+TWV4_HITS=$(grep -nE "$TWV4_PATTERN" "$FILE_PATH" 2>/dev/null | grep -v '\[&' | head -5)
+if [ -n "$TWV4_HITS" ]; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ Tailwind v4 [--foo] shorthand found (silent fail,必須 var() 包覆):\n${TWV4_HITS}\n  修法:將 [--foo] 改為 [var(--foo)]"
+fi
+
+# ── Check 3: Hardcoded Tailwind shadow ────────────────────────────────────────
+# shadow-sm/md/lg/xl/2xl 是 Tailwind 預設,繞過 elevation token 系統——禁止.
+# 允許:shadow-none / shadow-[var(--elevation-N)] N∈{100,200} / shadow-[calc(...)]
+SHADOW_PATTERN='\bshadow-(sm|md|lg|xl|2xl|inner)\b'
+SHADOW_HITS=$(grep -nE "$SHADOW_PATTERN" "$FILE_PATH" 2>/dev/null | head -5)
+if [ -n "$SHADOW_HITS" ]; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ Tailwind default shadow found (禁用,必須用 elevation token):\n${SHADOW_HITS}\n  修法:shadow-sm→shadow-[var(--elevation-100)] / shadow-md→shadow-[var(--elevation-200)] / shadow-lg→shadow-[var(--elevation-200)](2026-05-31 修:elevation-300 不存在,最高 tier 是 200)"
+fi
+
+# ── Check 4: primitive color name used as Tailwind utility (silent fail) ─────
+# Primitive tokens (`--color-neutral-N` / `--color-blue-N` 等) 只在 :root 宣告,
+# 沒經 semantic.css 的 `@theme inline` 橋接 → 寫 `bg-neutral-3` / `text-blue-6`
+# 當 Tailwind utility 會 silent 失效(class 編譯後不生成任何規則)。
+# 正確:用 semantic utility(bg-secondary / bg-muted)或 arbitrary value
+# `bg-[var(--color-neutral-3)]`(Tag categorical 色常用)。
+# 歷史 bug:2026-04-22 FileItem compact static bg 用 `bg-neutral-3` 完全沒底色,
+# user 對照 Badge low 可見才發現;spec layer + 本 hook 同步修。
+PRIMITIVE_PATTERN='\b(bg|text|border|ring|fill|stroke|shadow|outline|decoration|divide|placeholder|caret|accent)-(neutral|blue|red|green|yellow|orange|purple|pink|cyan|teal|indigo|violet|deep-orange)-[0-9]+\b'
+PRIMITIVE_HITS=$(grep -nE "$PRIMITIVE_PATTERN" "$FILE_PATH" 2>/dev/null | head -5)
+if [ -n "$PRIMITIVE_HITS" ]; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ Primitive color name used as Tailwind utility (silent fail):\n${PRIMITIVE_HITS}\n  修法:改用 semantic utility(bg-secondary / bg-muted / bg-surface / text-fg-muted 等)或 arbitrary value(bg-[var(--color-neutral-3)] 給 Tag categorical 色用)。理由:primitive token 沒經 @theme inline 橋接,bg-neutral-3 等會 silent 失效。"
+fi
+
+# ── Check 5: native overflow-{auto,scroll} without ScrollArea ─────────────────
+# 在 component / pattern .tsx 裡 raw overflow-auto / overflow-scroll =
+# 跨 OS scrollbar 不一致(macOS overlay / Windows always-visible 吃 17px)。
+# 應改用 ScrollArea(Components/ScrollArea/)。
+# 允許:horizontal-overflow pattern(有 scrollbar-none / fade-mask 特殊 UX)/
+#      use-overflow-items hook consumers(Tabs/ChipGroup hiding scroll)
+# 2026-06-11 deep-audit R2(n=29):豁免 regex 補認 [scrollbar-width:none] arbitrary 語法 —
+# Tabs(tabs.tsx:211,307)/ Chip(chip.tsx:173,298)hidden-scrollbar 實寫
+# `overflow-x-auto [scrollbar-width:none] [&::-webkit-scrollbar]:hidden`,與 FileViewer 的
+# `scrollbar-none` utility 同語意;舊 regex 只認後者 → 豁免失效噪音 warn。
+# 同輪補:剝離純註解行(grep -n 輸出 `N:content` 前綴)— Tabs tabs.tsx:126,173,176,239 等
+# rationale 註解提及 overflow-x-auto 屬說明文字,非 className 用法,不構成跨 OS scrollbar drift。
+OVERFLOW_PATTERN='\boverflow-(auto|scroll|x-auto|x-scroll|y-auto|y-scroll)\b'
+# 2026-06-11 R2 Phase B(codex b3 抓縫):hidden-scrollbar 豁免限水平(overflow-x;canonical =
+# horizontal-overflow pattern)— vertical overflow-y-auto 配 scrollbar-width:none 不在 canonical,照 warn。
+OVERFLOW_HITS=$(grep -nE "$OVERFLOW_PATTERN" "$FILE_PATH" 2>/dev/null | grep -vE '^[0-9]+:[[:space:]]*(//|\*|/\*|\{/\*)' | grep -vE 'overflow-x-[a-z]+[^\n]*(scrollbar-none|\[scrollbar-width:none\])|(scrollbar-none|\[scrollbar-width:none\])[^\n]*overflow-x-[a-z]+' | grep -vE 'useOverflow|horizontal-overflow' | head -5)
+if [ -n "$OVERFLOW_HITS" ]; then
+  VIOLATIONS="${VIOLATIONS}\n⚠️ Native overflow-auto/scroll found (可能造成跨 OS 跑版):\n${OVERFLOW_HITS}\n  考慮改用 ScrollArea(\`@/design-system/components/ScrollArea/scroll-area\`)取得跨 OS 一致 overlay 捲軸。例外:刻意隱藏捲軸(scrollbar-none)+ fade-mask UX 屬 horizontal-overflow pattern,不套用本規則。"
+fi
+
+# ── Emit warning if any violation found ────────────────────────────────────
+if [ -n "$VIOLATIONS" ]; then
+  # Escape for JSON (newlines)
+  ESCAPED=$(printf "%b" "$VIOLATIONS" | jq -Rs .)
+  cat <<EOJSON
+{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":"Token hygiene 檢查發現違規 (CLAUDE.md 明文禁止項):${ESCAPED}\n\n這些是 silent-fail bug classes——不會造成 compile error,但 runtime 視覺或行為會壞。下個 Edit 回去修。"}}
+EOJSON
+fi

package/ds-canonical/hooks/log_governance_fires.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+set -uo pipefail
+# PostToolUse: log governance-relevant file writes to .claude/logs/hook-fires.jsonl
+#
+# Why: Meta-Pattern M18 — governance must be instrumented, not hoped for.
+# Fire-log lets /knowledge-prune identify:
+#   - dead hooks (never appear in log over 6 months → retire candidate)
+#   - hot files (edited constantly → candidate for refactor / split)
+#   - governance file edit cadence (CLAUDE.md edited 10x/week → churn signal)
+#
+# Size cap: if log > 1 MB, rotate to .jsonl.YYYYMM (keeps inspection file tight).
+# Non-blocking; silent on success.
+
+# Per-hook fire logging(enables /knowledge-prune D2 dead-hook detection)
+source "$(dirname "$0")/_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -euo pipefail
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+[ -z "$FILE_PATH" ] && exit 0
+
+# Only log governance files
+case "$FILE_PATH" in
+  */CLAUDE.md|*/memory/*.md|*.spec.md|*.claude/skills/*|*.claude/hooks/*|*.claude/settings.json) ;;
+  *) exit 0 ;;
+esac
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+LOG_DIR="$PROJECT_DIR/.claude/logs"
+LOG_FILE="$LOG_DIR/hook-fires.jsonl"
+
+mkdir -p "$LOG_DIR"
+
+# Rotate if > 1 MB
+if [ -f "$LOG_FILE" ]; then
+  SIZE=$(wc -c < "$LOG_FILE" | tr -d ' ')
+  if [ "$SIZE" -gt 1048576 ]; then
+    mv "$LOG_FILE" "${LOG_FILE}.$(date +%Y%m)"
+  fi
+fi
+
+# Append single-line JSON
+TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+REL_PATH=${FILE_PATH#$PROJECT_DIR/}
+printf '{"ts":"%s","tool":"%s","path":"%s"}\n' "$TIMESTAMP" "$TOOL_NAME" "$REL_PATH" >> "$LOG_FILE"
+
+exit 0

package/ds-canonical/hooks/log_skill_invokes.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+set -uo pipefail
+# PostToolUse Skill: log each skill invocation to .claude/logs/skill-invokes.jsonl
+#
+# 對齊 Meta-Pattern M14(AUTO integrate pipeline instrumentation)+ M10(proactive scan)。
+# /governance-health Phase 1 消費本 log 偵測 dead skill(3 mo 0 invoke = retire 候選)
+# + hot skill(high invoke = 值得優化 workflow)。
+#
+# 無本 hook,skill-invokes.jsonl 永遠空,governance-health 無法做 skill-level 決策。
+# Dogfood 時發現這個 gap。
+
+# Per-hook fire logging(enables /knowledge-prune D2 dead-hook detection)
+source "$(dirname "$0")/_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -euo pipefail
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+[ "$TOOL_NAME" != "Skill" ] && exit 0
+
+SKILL_NAME=$(echo "$INPUT" | jq -r '.tool_input.skill // empty')
+[ -z "$SKILL_NAME" ] && exit 0
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+LOG_DIR="$PROJECT_DIR/.claude/logs"
+LOG_FILE="$LOG_DIR/skill-invokes.jsonl"
+mkdir -p "$LOG_DIR"
+
+# Rotate if > 1 MB(對齊其他 log rotation 策略)
+if [ -f "$LOG_FILE" ]; then
+  SIZE=$(wc -c < "$LOG_FILE" | tr -d ' ')
+  if [ "$SIZE" -gt 1048576 ]; then
+    mv "$LOG_FILE" "${LOG_FILE}.$(date +%Y%m)"
+  fi
+fi
+
+TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+ARGS=$(echo "$INPUT" | jq -r '.tool_input.args // empty' | head -c 200)
+printf '{"ts":"%s","skill":"%s","args":"%s"}\n' "$TIMESTAMP" "$SKILL_NAME" "${ARGS//\"/\\\"}" >> "$LOG_FILE"
+
+exit 0

package/ds-canonical/hooks/post_edit_dispatcher.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+# post_edit_dispatcher.sh — orchestrate 8 lib helper rules (PostToolUse Write|Edit|MultiEdit)
+#
+# 2026-05-13 /knowledge-prune consolidation:
+#   Per CLAUDE.md governance hook count budget (25 soft / 30 hard,Anthropic ~15 guideline)
+#   Pre-consolidation: 32 hooks → BLOCKER 30 cap breached
+#   This dispatcher folds 8 lib/_*.sh helpers into one hook registration
+#   Lib helpers remain as standalone testable files (renamed `_*` per Unix internal-helper convention)
+#   Net hook count: 32 - 8 lib + 1 dispatcher = 25 ✅
+#
+# Pattern: read stdin INPUT once,pipe to each helper sequentially,collect their JSON outputs
+# Each helper:
+#   - Reads file_path from stdin via jq
+#   - Filters by scope (skips if out-of-scope)
+#   - Emits {hookSpecificOutput: {additionalContext: "..."}} OR exits 0 silent
+# Dispatcher: concatenate non-empty additionalContext blocks into ONE JSON output
+
+source "$(dirname "$0")/_log-fire.sh" 2>/dev/null && log_hook_fire
+
+set -uo pipefail
+
+INPUT=$(cat 2>/dev/null || echo "{}")
+HOOKS_DIR="$(dirname "$0")"
+LIB_DIR="$HOOKS_DIR/lib"
+
+# Aggregate additionalContext fragments from each helper
+COMBINED=""
+
+run_helper() {
+  local helper="$1"
+  [ -f "$helper" ] || return 0
+  local out
+  out=$(printf '%s' "$INPUT" | bash "$helper" 2>/dev/null)
+  [ -z "$out" ] && return 0
+  # Extract additionalContext via jq (each helper emits valid JSON)
+  local ctx
+  ctx=$(printf '%s' "$out" | jq -r '.hookSpecificOutput.additionalContext // empty' 2>/dev/null)
+  [ -z "$ctx" ] && return 0
+  if [ -z "$COMBINED" ]; then
+    COMBINED="$ctx"
+  else
+    COMBINED="${COMBINED}"$'\n\n────────\n\n'"$ctx"
+  fi
+}
+
+# Run 8 helpers sequentially (all silent-fail / exit 0 / additive warnings)
+run_helper "$LIB_DIR/_token_hygiene.sh"
+run_helper "$LIB_DIR/_hardcoded_strings.sh"
+run_helper "$LIB_DIR/_code_quality.sh"
+run_helper "$LIB_DIR/_layout_space_canonical.sh"
+run_helper "$LIB_DIR/_person_data_richness.sh"
+run_helper "$LIB_DIR/_overlay_handcraft.sh"
+run_helper "$LIB_DIR/_cva_default_sync.sh"
+run_helper "$LIB_DIR/_story_compile_drift.sh"
+run_helper "$LIB_DIR/_governance_coverage_check.sh"
+
+if [ -n "$COMBINED" ]; then
+  ESCAPED=$(printf '%s' "$COMBINED" | jq -Rs .)
+  printf '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":%s}}\n' "$ESCAPED"
+fi
+
+exit 0