@qijenchen/design-system 0.1.0-beta.83 → 0.1.0-beta.84

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

@@ -0,0 +1,76 @@
+#!/bin/bash
+# test_check_dynamic_tailwind_class.sh — 動態 Tailwind class 哨測試
+# (2026-07-10 補 hook-test-coverage debt;hook 2026-07-09 建,anchor = h-table-row-${size} row 塌)
+set -uo pipefail
+cd "$(dirname "$0")/../../.."
+HOOK=".claude/hooks/check_dynamic_tailwind_class.sh"
+PASS=0; FAIL=0; FAILED_TESTS=""
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+export CLAUDE_PROJECT_DIR="$TMP_DIR"
+mkdir -p "$TMP_DIR/.claude/logs"
+
+PROD_TSX="/Users/x/proj/packages/design-system/src/components/DataTable/data-table.tsx"
+
+run_hook() {
+  local file_path="$1"; local content="$2"
+  local payload
+  payload=$(jq -n --arg fp "$file_path" --arg c "$content" \
+    '{tool_name:"Edit", tool_input:{file_path:$fp, new_string:$c}}')
+  STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >/dev/null 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR" 2>/dev/null); rm -f "$STDERR"
+}
+
+expect_block() {
+  local name="$1"
+  if [ "$EXIT" = "2" ]; then echo "  PASS  $name"; PASS=$((PASS+1))
+  else echo "  FAIL  $name (expected exit=2, got exit=$EXIT)"; FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"; fi
+}
+expect_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then echo "  PASS  $name"; PASS=$((PASS+1))
+  else echo "  FAIL  $name (expected silent exit=0, got exit=$EXIT, stderr=${STDERR_TEXT:+non-empty})"; FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"; fi
+}
+
+# 1. POSITIVE:病根錨例 h-table-row-${size}(class 名含插值)→ BLOCK
+run_hook "$PROD_TSX" 'const cls = `h-table-row-${size} flex`'
+expect_block "1. h-table-row-\${size} → BLOCK"
+
+# 2. POSITIVE:間距 utility gap-${g} → BLOCK
+run_hook "$PROD_TSX" 'const cls = `flex gap-${g}`'
+expect_block "2. gap-\${g} → BLOCK"
+
+# 3. NEGATIVE:正解 literal map → silent
+run_hook "$PROD_TSX" "const cls = { sm: 'h-table-row-sm', md: 'h-table-row-md', lg: 'h-table-row-lg' }[size]"
+expect_silent "3. literal class 對照表 → silent"
+
+# 4. NEGATIVE:arbitrary value 內插值(是值不是 class 名)→ silent
+run_hook "$PROD_TSX" 'const cls = `h-[calc(100%_-_${offset}px)]`'
+expect_silent "4. h-[calc(\${x})] arbitrary → silent"
+
+# 5. NEGATIVE:var() 內插值 → silent
+run_hook "$PROD_TSX" 'const cls = `w-[var(--col-${i})]`'
+expect_silent "5. w-[var(--x-\${i})] → silent"
+
+# 6. NEGATIVE:色彩 utility 不在 scope(hook 只鎖尺寸/間距)→ silent
+run_hook "$PROD_TSX" 'const cls = `text-${color}`'
+expect_silent "6. text-\${color}(非尺寸間距)→ silent"
+
+# 7. NEGATIVE:escape 註解 → silent
+run_hook "$PROD_TSX" 'const cls = `size-${px}` // @dynamic-tailwind-allow: 傳給 canvas 非 class'
+expect_silent "7. @dynamic-tailwind-allow escape → silent"
+
+# 8. NEGATIVE:非 production path(tests/)→ silent
+run_hook "/Users/x/proj/scripts/gen-something.mjs" 'const cls = `h-${x}`'
+expect_silent "8. 非 tsx production path → silent"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then printf "Failed:%b\n" "$FAILED_TESTS"; exit 1; fi
+exit 0

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

@@ -182,6 +182,30 @@ expect_not_block "N8. empty content → not blocked"
 run_hook_bypass "Write" "$CONSUMER" "content" "$C_3DISTINCT"
 expect_not_block "N9. CLAUDE_BYPASS_ESCAPE_MARKER_AUDIT=1 override → not blocked"
 
+# ── R-series:repo 級累計 ratchet(2026-07-08 WM 戰役 R4)──────────────────────
+# 存量 ≥10(apps/** 全 repo)後,只擋「本次 edit 再新增 marker」;無 marker edit 不 brick。
+mkdir -p "$TMP_DIR/apps/work/src"
+for i in 1 2 3 4 5 6; do
+  printf '// @ds-misuse-allow: seeded reason %s\n// @layout-space-magic-ok: seeded reason %sb\n' "$i" "$i" \
+    > "$TMP_DIR/apps/work/src/seed$i.tsx"
+done
+
+# R1. 存量 12 ≥ cap 10 + 本次新增 1 marker → BLOCK(ratchet)
+run_hook "Write" "/repo/apps/work/src/new.tsx" "content" '<div /> // @ds-misuse-allow: one more'
+expect_block "R1. repo 存量 12 ≥ cap + edit 加 marker → blocked (ratchet)" "ESCAPE-MARKER-REPO-RATCHET"
+
+# R2. 存量 12 ≥ cap 但本次 edit 無 marker → not blocked(不因存量 brick 無關 edit)
+run_hook "Write" "/repo/apps/work/src/new.tsx" "content" '<div className="flex" />'
+expect_not_block "R2. repo 存量 ≥ cap 但 edit 無 marker → not blocked"
+
+# R3. 存量降到 4 < cap + 本次加 1 marker → not blocked
+rm -f "$TMP_DIR/apps/work/src/seed3.tsx" "$TMP_DIR/apps/work/src/seed4.tsx" \
+      "$TMP_DIR/apps/work/src/seed5.tsx" "$TMP_DIR/apps/work/src/seed6.tsx"
+run_hook "Write" "/repo/apps/work/src/new.tsx" "content" '<div /> // @ds-misuse-allow: legit case'
+expect_not_block "R3. repo 存量 4 < cap + edit 加 marker → not blocked"
+
+rm -rf "$TMP_DIR/apps"
+
 echo ""
 echo "=== Summary ==="
 echo "Passed: $PASS / $((PASS + FAIL))"

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

@@ -1,11 +1,13 @@
 #!/bin/bash
-# Tests for check_field_family_invariants.sh — merged 4 sub-rules(A.1-A.4)
+# Tests for check_field_family_invariants.sh — merged sub-rules(A.1-A.4 + A.6)
 #
-# Coverage(每 sub-rule pass + block 各 1 case,共 12 case):
+# Coverage(每 sub-rule pass + block 各 1 case):
 #   A.1 naked row-mode propagation:pass / block / allowlist
 #   A.2 FieldControlGroup wrapper child:pass / block / allowlist
 #   A.3 Field state ring SSOT:pass / 3 block(shadow inset / outline / per-control open)
 #   A.4 disabled placeholder color:pass / 1 stderr-warn(exit 0)/ allowlist
+#   A.6 空值顯示 SSOT(2026-07-08 半形 hyphen):非 owner import EMPTY_DISPLAY block /
+#       owner skip / 全形 em dash block / 半形 pass / allowlist
 #   non-target:non-tsx skip / SSOT host skip(field-wrapper.tsx)
 
 set -u
@@ -183,6 +185,29 @@ else
   FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - A.4.3"
 fi
 
+echo ""
+echo "=== A.6 空值顯示 SSOT(2026-07-08 半形 hyphen)==="
+
+# 17. 非 owner import EMPTY_DISPLAY → BLOCK(應消費 useFieldEmptyDisplay hook 分流)
+run_hook "/r/packages/design-system/src/components/Bad/bad.tsx" "import { EMPTY_DISPLAY } from '@/design-system/components/Field/field-wrapper'"
+expect_exit "A.6.1 非 owner import EMPTY_DISPLAY → BLOCK" 2 "EMPTY_DISPLAY 直引"
+
+# 18. owner field-context.ts import EMPTY_DISPLAY → pass(SSOT owner skip)
+run_hook "/r/packages/design-system/src/components/Field/field-context.ts" "import { EMPTY_DISPLAY } from './field-wrapper'"
+expect_exit "A.6.1 owner field-context.ts import → pass" 0
+
+# 19. components tsx hardcode 全形 em dash '—' → BLOCK
+run_hook "/r/packages/design-system/src/components/Bad/bad.tsx" "const cls = value ?? '—'"
+expect_exit "A.6.2 hardcode 全形 em dash → BLOCK" 2 "全形 em dash"
+
+# 20. 半形 hyphen '-' → pass(非全形,不觸發)
+run_hook "/r/packages/design-system/src/components/Bad/bad.tsx" "const sep = '-'"
+expect_exit "A.6.2 半形 hyphen → pass" 0
+
+# 21. allowlist → pass
+run_hook "/r/packages/design-system/src/components/Bad/bad.tsx" "const cls = value ?? '—' // @empty-display-allow: legacy N/A marker"
+expect_exit "A.6 allowlist → pass" 0
+
 echo ""
 echo "=== Skip cases ==="
 

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

@@ -56,6 +56,18 @@ expect_warn() {
   fi
 }
 
+# #71 soft WARN tier(micro_gap / fraction):exit 0(不 block)+ stderr 含 'soft flag'
+expect_soft_flag() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && echo "$STDERR_TEXT" | grep -qF "soft flag"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit=0 + 'soft flag', got exit=$EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
 echo "=== check_opacity_token_usage tests ==="
 
 # 1. raw opacity-30 → warn
@@ -101,6 +113,33 @@ const b = "opacity-75"
 '
 expect_warn "7. multi opacity-N values → warn" "opacity-25"
 
+# ── #71 micro_gap / fraction soft WARN tier(2026-07-11 接線)──────────────────
+FP71="/repo/packages/design-system/src/components/Calendar/calendar.tsx"
+
+# 8. gap-0.5(micro gap)→ soft flag(exit 0,非 block)
+run_hook "$FP71" 'const a = <div className="gap-0.5" />'
+expect_soft_flag "8. gap-0.5 micro gap → soft WARN(非 block)"
+
+# 9. w-1/3(registry fraction)→ soft flag(exit 0)
+run_hook "$FP71" 'const a = <div className="w-1/3" />'
+expect_soft_flag "9. w-1/3 registry fraction → soft WARN"
+
+# 10. w-1/2(合法,不在 registry 14 條)→ silent(不誤殺)
+run_hook "$FP71" 'const a = <div className="w-1/2" />'
+expect_pass_silent "10. w-1/2(合法留白)→ silent 不誤殺"
+
+# 11. gap-2(合法)→ silent
+run_hook "$FP71" 'const a = <div className="gap-2" />'
+expect_pass_silent "11. gap-2(合法)→ silent"
+
+# 12. 硬 violation + gap-0.5 → exit 2(hard block 不被 soft tier 弱化)
+run_hook "$FP71" 'const a = <div className="text-muted-foreground gap-0.5" />'
+expect_warn "12. 硬 violation + gap-0.5 → exit 2 block" "shadcn alias"
+
+# 13. gap-0.5 + @token-registry-ok escape → silent
+run_hook "$FP71" 'const a = <div className="gap-0.5" /> // @token-registry-ok: skeleton bone'
+expect_pass_silent "13. gap-0.5 + escape → silent"
+
 echo ""
 echo "=== Summary ==="
 echo "Passed: $PASS / $((PASS + FAIL))"

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

@@ -0,0 +1,76 @@
+#!/bin/bash
+# test_check_tabs_content_chrome_body_double_gap.sh — overlay-body layout-space 哨測試
+# (2026-07-10 補 hook-test-coverage debt;hook 2026-07-01 建,anchor = 專案設定 Dialog 雙 tight)
+# 注意:本 hook 是 PostToolUse「讀完整檔」型(防 partial-edit 盲區)→ 測試必寫真實 temp 檔,
+# 且路徑必須匹配 scope regex(packages/design-system/src/ 或 /apps/)。
+set -uo pipefail
+cd "$(dirname "$0")/../../.."
+HOOK=".claude/hooks/check_tabs_content_chrome_body_double_gap.sh"
+PASS=0; FAIL=0; FAILED_TESTS=""
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+export CLAUDE_PROJECT_DIR="$TMP_DIR"
+mkdir -p "$TMP_DIR/.claude/logs"
+
+# scope 內的真實 temp 檔路徑(hook 讀 disk)
+DS_DIR="$TMP_DIR/packages/design-system/src/components/Dialog"
+mkdir -p "$DS_DIR"
+
+run_hook_file() {
+  local file_path="$1"; local content="$2"
+  mkdir -p "$(dirname "$file_path")"
+  printf '%s' "$content" > "$file_path"
+  local payload
+  payload=$(jq -n --arg fp "$file_path" --arg c "$content" \
+    '{tool_name:"Edit", tool_input:{file_path:$fp, new_string:$c}}')
+  STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >/dev/null 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR" 2>/dev/null); rm -f "$STDERR"
+  rm -f "$file_path"
+}
+
+expect_block() {
+  local name="$1"
+  if [ "$EXIT" = "2" ]; then echo "  PASS  $name"; PASS=$((PASS+1))
+  else echo "  FAIL  $name (expected exit=2, got exit=$EXIT)"; FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"; fi
+}
+expect_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then echo "  PASS  $name"; PASS=$((PASS+1))
+  else echo "  FAIL  $name (expected silent exit=0, got exit=$EXIT, stderr=${STDERR_TEXT:+non-empty})"; FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"; fi
+}
+
+# 1. POSITIVE(Check 1 錨例):chrome body 內 TabsContent 無 mt-0 → 雙重 gap → BLOCK
+run_hook_file "$DS_DIR/case1.stories.tsx" '<DialogBody><Tabs value={t}><TabsContent value="a"><p>內容</p></TabsContent></Tabs></DialogBody>'
+expect_block "1. DialogBody 內 TabsContent 無 mt-0 → BLOCK"
+
+# 2. NEGATIVE:TabsContent 帶 mt-0(ownership 轉移給 body)→ silent
+run_hook_file "$DS_DIR/case2.stories.tsx" '<DialogBody><Tabs value={t}><TabsContent value="a" className="mt-0"><p>內容</p></TabsContent></Tabs></DialogBody>'
+expect_silent "2. TabsContent className=mt-0 → silent"
+
+# 3. NEGATIVE:TabsContent 不在 chrome body 內(頁面級 Tabs)→ silent
+run_hook_file "$DS_DIR/case3.stories.tsx" '<Tabs value={t}><TabsList>…</TabsList><TabsContent value="a"><p>內容</p></TabsContent></Tabs>'
+expect_silent "3. 頁面級 Tabs(無 chrome body)→ silent"
+
+# 4. POSITIVE(Check 3 root 簽名):TabsList 手塞 DialogBody 同檔且無 tabsSlot → BLOCK
+run_hook_file "$DS_DIR/case4.stories.tsx" '<DialogBody><TabsList size="sm"><TabsTrigger value="a">A</TabsTrigger></TabsList><TabsContent value="a" className="mt-0">x</TabsContent></DialogBody>'
+expect_block "4. TabsList 手塞 chrome body 無 tabsSlot → BLOCK(root)"
+
+# 5. NEGATIVE:escape 註解 → silent
+run_hook_file "$DS_DIR/case5.stories.tsx" '{/* @tabs-content-gap-ok: 內容層分頁非 dialog chrome */}
+<DialogBody><Tabs value={t}><TabsContent value="a">x</TabsContent></Tabs></DialogBody>'
+expect_silent "5. @tabs-content-gap-ok escape → silent"
+
+# 6. NEGATIVE:scope 外路徑(非 DS-src / apps)→ silent
+run_hook_file "$TMP_DIR/docs/example.tsx" '<DialogBody><TabsContent value="a">x</TabsContent></DialogBody>'
+expect_silent "6. scope 外路徑 → silent"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then printf "Failed:%b\n" "$FAILED_TESTS"; exit 1; fi
+exit 0

package/ds-canonical/references/audit-coverage-vs-24-checklist.md

@@ -45,7 +45,7 @@
 
 | 真缺項 | 補的形式 | Commit |
 |---|---|---|
-| #13 i18n 硬寫字串 | `.claude/hooks/check_hardcoded_strings.sh` PostToolUse,flag DS primitive tsx(非 stories)CJK ≥ 3 chars / 英文 sentence-case label;支援 `// i18n-allow: {rationale}` 白名單 | 本次 session |
+| #13 i18n 硬寫字串 | `post_edit_dispatcher.sh → lib/_hardcoded_strings.sh` PostToolUse flag(2026-05-13 由獨立 hook `check_hardcoded_strings.sh` folded 進 dispatcher lib),flag DS primitive tsx(非 stories)CJK ≥ 3 chars / 英文 sentence-case label;支援 `// i18n-allow: {rationale}` 白名單 | 本次 session |
 | #3 Controlled / Uncontrolled + #12 Form dual-mode | `design-system-audit` Dim 26(新 Group J)— 掃 form + overlay 元件 value/defaultValue / open/defaultOpen / checked/defaultChecked 的 pair 完整性;V1-V4 violation types | 本次 session |
 | #23 edge case(null / empty / rapid / success) | `/ux-audit` Phase 5 從 3 態 → 5 態 + null-safety + rapid-interaction + edge case corollary | 本次 session |
 

package/ds-canonical/references/build-ui-canonicals.md

@@ -18,6 +18,7 @@
 | 資料表格(含 header / sorting / sticky) | `<table><thead>...</thead><tbody>...</tbody></table>` | `<DataTable columns={...} data={...} />` |
 | 檔案上傳列表 | `<div>filename</div><ProgressBar /><Paperclip />` | `<FileItem mode="compact" />` or `<FileUpload>` |
 | 表單欄位(label + control + error) | `<label>...</label><input/><span className="text-error">...</span>` | `<Field><FieldLabel>...<Input />...<FieldError/>` |
+| 表單提交驗證(何時顯錯 / 提交可點性) | 手刻 `useState(showErrors)` + `submitAttempt` 旗標自組顯錯時機 | `useFormValidation`(Field 家族 hook,`intent:'create'` = 提交恆可點、點擊時 validate 顯錯;搭 `<FieldError>`)|
 | 全頁 / 區域 loading | `<div className="absolute inset-0 flex center"><Spinner /></div>` | `<Empty icon={<CircularProgress />} description="..." />` |
 | 確認對話框 | raw `<div className="fixed inset-0 bg-black/50">...<button>OK</button>` | `<Dialog>` + `<DialogHeader>` etc |
 | 分隔線 | `<hr className="..." />` or `<div className="h-px bg-..."/>` | `<Separator />`(必要時)or CSS border(見 separator.spec) |
@@ -60,7 +61,7 @@
 - 以上都沒命中 → 才可自建,但 **建完要立刻回來加行**(防下一個人又重造輪子)
 - **本規則同樣適用 story / consumer / exploration code**:不 hand-craft 已有 prop 能做的事(如 Input loading 走 `loading` prop 不自刻 `<div className="relative"><input/><div className="absolute">` / 全頁 loading 走 `<Empty icon={<CircularProgress/>}/>` 不自刻 `absolute inset-0`)。遇缺口**回元件 spec 擴 API**,不自刻繞過 — hand-craft 視覺對齊 bug 上游
 
-具體 anti-pattern signals → `/design-system-audit` Dim 21;pixel-level 視覺 regression(API 用對但視覺仍跑掉)→ `/visual-audit`(D5)抓(原 memory `project_pending_tasks` 已 retire)。
+具體 anti-pattern signals → `design-system-audit/references/audit-prompts.md`「L1. 手刻繞 DS canonical」+ Dim 71 consumer 手刻(Pattern 10;現行 Dim 21 已是「連續 item list wrapper gap」,勿誤指);pixel-level 視覺 regression(API 用對但視覺仍跑掉)→ `/visual-audit`(D5)抓(原 memory `project_pending_tasks` 已 retire)。
 
 ---
 

package/ds-canonical/references/failure-class-registry.json

@@ -0,0 +1,145 @@
+{
+  "_meta": {
+    "invariant": "每類被抓過的 failure class 必須終有 ship 到 consumer 的機械防線(user 2026-07-10 verbatim「建立治理的基本原則」)。status 三態:protected(已有 MECHANICAL_CONSUMER / DS_API_FIXED 防線)/ remediating(必帶 plan 指標)/ judgment(regex 不可判,必帶 auditDim 兜底)。gate = scripts/audit-failure-class-coverage.mjs --check(deep-audit dim 91 chain)。",
+    "source": ".claude/logs/failure-class-coverage-matrix.json(2026-07-10 41-agent 對抗 workflow,每 verdict cite 驗證)",
+    "addRule": "新 failure class(deep-audit / user 抓 / codex 抓)→ 本 registry 加 row;沒 row 或 status 缺 = gate 紅燈。remediation 落地後把 status 升 protected 並記 landedAt。"
+  },
+  "classes": [
+    {
+      "id": "phantom-layout-token",
+      "name": "幻覺 layout token / utility",
+      "status": "protected",
+      "note": "check_layout_space_magic_numbers PHANTOM 白名單(SHIP_AS_IS)+ opacity hook 第 10 類幻覺 state 尾綴(2026-07-10)"
+    },
+    {
+      "id": "handcraft-mini-table",
+      "name": "手刻 mini-table(grid-cols 黏死欄寬)",
+      "status": "protected",
+      "note": "r3 偽表格簽名 + magic-hook grid-cols px(皆 SHIP_AS_IS)"
+    },
+    {
+      "id": "handcraft-menu-item-row",
+      "name": "手刻 menu-item 可點列",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "根因 MenuItem startContent(beta.84)+ r3 nav-row 簽名(hover+selected 成對)"
+    },
+    {
+      "id": "export-chain-break",
+      "name": "export 斷鏈逼手刻(R2)",
+      "status": "protected",
+      "note": "DS_API_FIXED — barrel generator + preflight --check drift gate;beta.84 發版後 consumer 正式接上"
+    },
+    {
+      "id": "contrast-pair-violation",
+      "name": "對比配對違規(亮色底 × text-white)",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "r3 C5 簽名 → CAT_SOLID pair"
+    },
+    {
+      "id": "handcraft-form-validation",
+      "name": "手刻表單驗證 state",
+      "status": "protected",
+      "note": "r3 useFormValidation 零消費簽名(SHIP_AS_IS)"
+    },
+    {
+      "id": "selectmenu-direct-use",
+      "name": "SelectMenu internal 直用",
+      "status": "protected",
+      "note": "r3 C7 簽名(<SelectMenu 直用 → BLOCK,escape @selectmenu-direct-ok:;select-menu.spec.md:53 明文禁直用特例)",
+      "landedAt": "2026-07-10"
+    },
+    {
+      "id": "handcraft-header-tabs",
+      "name": "頁內手刻 header+TabsList(未走 tabsSlot)",
+      "status": "judgment",
+      "note": "dialog/surface 半邊已有 check_tabs_content_chrome_body_double_gap P0(SHIP_AS_IS);頁內 h2+TabsList 存在合法場景(TypeSettings 內容層分頁 @tabs-content-gap-ok 錨例)= context 判斷,倉促 regex = 誤殺",
+      "auditDim": "product-ui-audit + header-canonical.spec.md Rule W4"
+    },
+    {
+      "id": "spacing-tier-semantic",
+      "name": "spacing 親疏語義誤用(tier 選錯)",
+      "status": "judgment",
+      "auditDim": "90(layout-space macro judgment sweep)+ product-ui-audit",
+      "note": "合法 token 用錯 tier = context 判斷,regex 不可判;magic/phantom 機械半邊已 protected"
+    },
+    {
+      "id": "search-action-position",
+      "name": "業務 search 被推工具層位置",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "r3 C10 簽名(spacer+Search Input);業務 vs 工具判定本身 judgment → escape @search-right-ok"
+    },
+    {
+      "id": "dialog-chrome-double-x",
+      "name": "dialog chrome 雙 X / header 操作不走 actions",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "r3 C11 簽名(DialogHeader 250 字窗)"
+    },
+    {
+      "id": "field-width-misuse",
+      "name": "Field 家族硬寬 / hug-fill 語義",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "硬寬 w-N 機械(r3 C12);hug vs fill 語義選擇 = judgment 半邊歸 product-ui-audit"
+    },
+    {
+      "id": "handcraft-section-header",
+      "name": "手刻可收合 section header",
+      "status": "protected",
+      "note": "R3-7 拍板 codify 進 item-anatomy.spec.md「可收合 section header 組合 canonical」(組合非元件,隨 npm ship)+ r3 C13 簽名(Chevron+justify-between+可點且無共用元件 → BLOCK)",
+      "landedAt": "2026-07-10"
+    },
+    {
+      "id": "avatar-anatomy-misuse",
+      "name": "avatar row-context 直用(未走 ItemAvatar/PersonValue 鏈)",
+      "status": "judgment",
+      "note": "前置已清:PersonValue/PersonDisplay/PersonAvatarTag 2026-07-10 補進 export 面(probe 驗 root barrel 解析)= 正道可 import;「row context 內 raw Avatar」判定 = context 判斷,regex 不可判(Avatar 合法 standalone 場景遍地)",
+      "auditDim": "product-ui-audit + item-anatomy.spec.md:178(Prefix 垂直對齊)"
+    },
+    {
+      "id": "datatable-density-structure",
+      "name": "DataTable 密度/tree 佔位/inline-create idle 未消費",
+      "status": "judgment",
+      "note": "tree 佔位半邊 DS_API_FIXED(data-table.tsx sibling-aware,beta.84 生效);size 密度選擇與 idle 列樣式 = context 判斷(嵌入式 vs 主表格),spec 隨 npm ship 供讀",
+      "auditDim": "product-ui-audit + data-table.spec.md:71/80(size 密度)+ :360(inline-create idle)"
+    },
+    {
+      "id": "always-edit-cell",
+      "name": "恆-edit cell(display 態渲染 edit 控件)",
+      "status": "judgment",
+      "note": "機械半邊已上:story-baseline-registry antiPattern datatable-always-edit-cell(cell: 直渲 edit 控件 → R8 BLOCK,unless onCellCommit/editable/display);custom cell 元件包裹子集 regex 看不進去 + RoleCell 拍板反例證實 context 判斷 → judgment 兜底",
+      "auditDim": "product-ui-audit + data-table.spec.md:373(indicator A 案)"
+    },
+    {
+      "id": "separator-geometry",
+      "name": "分隔線幾何(黏按鈕無 mx)",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "r3 C17 簽名 + magic-hook divider 行豁免(治理自我打架修正)"
+    },
+    {
+      "id": "count-label-concat",
+      "name": "計數括號串接(children 層)",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "r3 C18 簽名(children 錨定,aria attr 合法)"
+    },
+    {
+      "id": "two-pane-dialog",
+      "name": "兩欄 dialog 版型 canonical 缺席",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "user 拍板:組合非元件(對齊 Atlassian/MUI composition verdict)→ overlay-surface.spec.md「兩欄 dialog 組合 canonical」(隨 npm ship)+ r3 C19 簽名(共用捲軸機械攔)"
+    },
+    {
+      "id": "handcraft-link-underline",
+      "name": "連結字手刻 underline",
+      "status": "protected",
+      "landedAt": "2026-07-10",
+      "note": "r3 C20 簽名(no-underline / hover:underline 形不誤殺)"
+    }
+  ]
+}

package/ds-canonical/references/governance-audit-coverage.md

@@ -0,0 +1,33 @@
+# 治理 home × 稽核者 覆蓋表(2026-07-10)
+
+**觸發**:user verbatim「綜觀來看,deep audit 到底會不會稽核**所有** DS 的治理?」— 不是單軸,是全部。本表 = 逐 home 盤點「誰稽核它、怎麼稽核、多常跑」,誠實標出弱軸。**機械消費點:deep-audit SKILL C.0b(2026-07-10 接線)— 每輪收尾必逐 row 對照本表,新治理物無 row = C 階段不完整**;另 knowledge-prune 季度掃時參照。
+
+## 覆蓋表(逐 home,cite 查證過)
+
+| 治理 home | 稽核者(機械) | 跑的時機 | 覆蓋度 |
+|---|---|---|---|
+| `CLAUDE.md` ×2 + 計數 snapshot | `sync-governance-counters --check`(數字 drift,fail-closed)+ session-start Check 7 + `_governance_coverage_check` PostToolUse(原則→dim 對映)+ knowledge-prune D1/D4(重複/矛盾) | 每 session + 每發版 + 季度 | ✅ 強 |
+| `.claude/rules/*.md`(M-rules 等) | counters(M-rule 數)+ `extract-canonical-rules --check` + canonical-reviewer agent(edit 時)+ knowledge-prune D1/D3/D4 | 每 edit + 每發版 + 季度 | ✅ 強 |
+| `*.spec.md`(83+) | deep-audit dims 6/7/8(NO-SAMPLE judgment)+ A.1b claim-vs-code 逐句 + `audit-spec-deadlinks --check` + `add-reciprocal-pointers --check` + `check_spec_class_drift` hook + `audit-content-quality --check`(**scope 註:此 script 只掃 components/ 的 spec/story,非治理 md**) | 每 deep-audit + 每發版 | ✅ 強 |
+| hooks(56) | `audit:hook-quality`(fire 活性/假死)+ `audit-hook-test-coverage --check`(BLOCKER hook 必有 test;**2026-07-10 進 preflight fail-closed**)+ `tests/run-all` + fork classification gate(`build-fork-governance --check`,新 hook 未分類 = 擋發版)+ counters(數量 cap) | 每發版 + 季度 | ✅ 強 |
+| skills(SKILL.md ×22) | knowledge-prune D7(invoke 活性)+ file-size hook + deep-audit A.0 第 7 項全讀(2026-07-10 補真 — 原宣稱超前)+ governance-health 月度 | 每 deep-audit + 季度 + 月度 | ⚠️ 中(read 層有了;逐句 claim-vs-behavior 仍無機械閘 = 弱軸 2) |
+| memory(SSOT + mirror) | session-start cap 檢查(≤20)+ `sync-memory` drift + knowledge-prune D8(recency/orphan) | 每 session + 季度 | ✅ 強 |
+| `references/`(registry / 對照表) | dim 91 registry gate(failure-class)+ `check_story_invariants` R8(story-baseline-registry 消費)+ prune D1/D4 + **D2 references-orphan 掃(2026-07-10 加)** | 每發版 + 季度 | ⚠️ 中(2026-07-10 修:原誤引 canonical_propagation/counters — 兩者實際不掃本目錄;純文字 reference 靠季度) |
+| `planning/`(Level 9 plan doc) | 設計上 = 歷史 SSOT 存檔;**D8 planning-orphan 掃(2026-07-10 補 — 原 D8 只掃 memory 方向相反)** | 季度 | ⚠️ 低-by-design(存檔性質;活的必有 memory pointer,無引用 → D8 列 orphan 候選) |
+| scripts/ gates(76 .mjs) | `audit-coverage-matrix --check`(每 dim 的 mechanism script 必存在於 disk)+「DETERMINISTIC dim 必驗 mode 真跑」鐵律(2026-06-11)+ 引入時 breadth-test 鐵律(注入違規→抓到→revert) | 每 deep-audit + 每發版 | ⚠️ 中(**gate script 自身正確性**只有 3 支有專屬 meta-test〔fork harness / DataTable invariants / story-manifest〕;其餘靠引入時 breadth-test + dim 真跑證據。系統性 meta-test = roadmap 候選,見下) |
+| plugin / marketplace / fork corpus | `plugin-structure-validate` + `build-fork-governance --check` + `test-fork-governance` 假 fork harness(防 false-green/brick)+ counters | 每發版 | ✅ 強 |
+| eslint-plugin | 自帶 node --test(50 case)| 手跑/CI 無(**未發佈 = 對 consumer 零效**,plan doc 批次 B) | ⚠️ 已知缺口(tracked) |
+| commands / agents(稀住戶) | knowledge-prune D2(2026-07-10 補 bullet:commands 對照 skill-invokes log / agents 用 git recency + transcript grep — 原 D2 零掃描此二 home) | 季度 | ⚠️ 低(住戶少、變動少) |
+| failure-class(病根→防線) | **dim 91 `audit-failure-class-coverage --check`(2026-07-10 新)** | 每 deep-audit + 每發版 | ✅ 強 |
+| codex 鏈(CLI/model 新鮮度) | **`check-codex-freshness.mjs`(2026-07-10;deep-audit B.0 前置 + codex-collab Step 0.4 同日補接 = 兩條 codex 路徑皆 gate;CLI 落後自動升 + 禁 model pin + effort probe top)** | 每次 codex 使用(兩路徑)| ✅ 強 |
+
+## 誠實結論(回答「所有?」)
+
+**主幹 9 軸已全機械化 + fail-closed**(內容/計數/機械化程度/hook 活性+測試/膨脹矛盾/fork 出貨/病根覆蓋/codex 新鮮度/dim 自身反抽樣)。**「所有」還不成立的 4 個弱軸**(全部 tracked,非隱藏):
+
+1. **gate script 自身正確性**:多數 .mjs gate 無 meta-test(靠引入時 breadth-test + deep-audit「真跑證據」規則)。升級路 = 對 fail-closed gate 逐支補「注入違規必 exit 1」self-test(fork harness 模式推廣)。歸 governance-evolution roadmap 方向 5 品質回灌。
+2. **SKILL.md 內容 claim-vs-behavior**:skill 文字宣稱的流程 vs 實際 hook/script 行為,無逐句機械比對(A.1b 只對 component spec)。季度 prune D5 部分覆蓋。
+3. **eslint-plugin 未發佈**(批次 B tracked)。
+4. **planning / 純文字 reference 靜置漂移**:by-design 低頻,D1/D4/D8 季度兜底;規則 = 活的內容必有 memory pointer。
+
+**加新治理物時的規矩**:新 home / 新 artifact 類型 → 本表加 row(誰稽核它、多常跑);沒 row = deep-audit C.0b 抓(已接線)。

package/ds-canonical/references/item-anatomy-recipe.md

@@ -204,14 +204,14 @@ const isActive = variant === "meta" ? false : (... 同上)
 
 ```bash
 # 找出可疑的 raw ItemPrefix wrap 用法（應該幾乎沒有）
-rg '<ItemPrefix>\s*<[A-Z]' src/design-system
+rg '<ItemPrefix>\s*<[A-Z]' packages/design-system/src
 
 # 找出硬寫 size 的 Avatar / Icon（在 row primitive 內應該為零）
 rg '<Avatar[^>]*size=\{[0-9]+\}' packages/design-system/src/components/{Sidebar,TreeView,SelectMenu,DropdownMenu}
 rg 'size=\{16\}|size=\{20\}|size=\{24\}' packages/design-system/src/components/{Sidebar,TreeView}
 
 # 找出沒走 ItemInlineAction 的 inline action button
-rg "group/action.*relative grid place-content-center" src/design-system
+rg "group/action.*relative grid place-content-center" packages/design-system/src
 ```
 
 任何一條結果非空就是 drift，要修。

package/ds-canonical/references/scenario-definition.md

@@ -23,7 +23,7 @@
 **他拿到**:scaffold + 治理 via C-prime committed-config(.claude hooks + SessionStart preamble 注入)+ DS + 治理本體 via npm
 **DS 取得方式**:`@qijenchen/design-system` npm registry(`^X.Y.Z`)
 **Governance 取得**:committed `.claude/settings.json`(dispatcher hooks + fail-open bootstrap)+ SessionStart 注入 npm-current preamble;本體在 npm `ds-canonical/fork`(`npm install` / `npm run sync-all` 同步)。**不需 /plugin install**(雲端不可靠 #62174/#63028)
-**E2E 流程**:`fork → npm install(治理本體隨 npm + committed hook 自動生效,免 plugin)→ claude → npm run setup:netlify(Netlify env var 設 STORYBOOK_BASIC_AUTH = user:password,免費機制走 edge function basic-auth)→ npm run create-app order-dashboard → npm install → npm run storybook → git push`
+**E2E 流程**:`fork → npm install(治理本體隨 npm + committed hook 自動生效,免 plugin)→ claude → npm run setup:netlify(自動 site create/link + 引導在 Netlify dashboard 設 STORYBOOK_BASIC_AUTH = user:password env var — CLI 不提供 one-shot setup,script 印 dashboard URL + step-by-step;免費機制走 edge function basic-auth)→ npm run create-app order-dashboard → npm install → npm run storybook → git push`
 **禁**:import `@qijenchen/design-system/src/**` 或 `/dist/**`(`lint:imports` 攔)
 
 ## 2. SSOT Architecture
@@ -56,12 +56,9 @@ ajenchen/ds-product-template (published repo) ← Mirror artifact ────
 
 ## 3. Mirror Workflow Chain(Scenario B 自動同步)
 
-**Trigger**:DS push main + template-affecting paths(per `.github/workflows/mirror-to-published-template.yml`):
-- `apps/template/**`
-- `scripts/create-app.mjs` + `scripts/setup-netlify-access.mjs` + `scripts/check-plugin-installed.mjs` + `scripts/build-published-template-mirror.mjs`
-- `.devcontainer/**`
-- `template/ds-product-template/**`
-- `package.json`
+**Trigger**(雙觸發,2026-06-16 起):
+- `workflow_run: Release completed` = **發版主路徑**(Release 成功 → npm 已有新版本 → mirror 內部 poll 第一輪即過,零等待)
+- DS push main + template-affecting paths(scaffold 改動路徑;版本未上 npm 時 graceful skip 不長等)— path 列表以 `.github/workflows/mirror-to-published-template.yml` `paths:` 為準(含 apps/template、consumer scripts、.devcontainer、template/ds-product-template、package.json 等),不在此逐條複寫
 
 **Build**:`scripts/build-published-template-mirror.mjs` 用 ALLOWLIST(non denylist,per codex r5)+ transform:
 - Flatten `template/ds-product-template/*` → mirror root
@@ -69,7 +66,7 @@ ajenchen/ds-product-template (published repo) ← Mirror artifact ────
 - Transform `apps/template/package.json`:`@qijenchen/design-system: "*"` → `^X.Y.Z`
 - 4 integrity scans:DS source residue / secret leak / Storybook glob / package dep
 
-**Push**:`workflow + CROSS_REPO_TOKEN PAT(user one-time setup,workflow 印中文指引若 missing)` force-push to `ajenchen/ds-product-template` main
+**Push**:`workflow + CROSS_REPO_TOKEN PAT(user one-time setup,workflow 印中文指引若 missing + fail-loud exit 1)` clone-and-overlay push to `ajenchen/ds-product-template` main — git clone + `rsync --checksum --delete --exclude='.github/workflows'`(保留 published repo 既有 workflows)+ fetch-rebase-retry 迴圈(非 force-push;2026-06-07 競態修)
 
 ## 4. Test Cases(Claude 19 + codex 18 union → 20 canonical)
 
@@ -106,7 +103,7 @@ ajenchen/ds-product-template (published repo) ← Mirror artifact ────
 | M4 | Storybook glob apps-only(no `../packages/**`)| build script integrity scan 3 |
 | M5 | package.json workspaces apps-only + DS dep transformed | build script integrity scan 4 |
 | M6 | `apps/template/package.json` DS dep `*` → `^X.Y.Z` | build script auto transform |
-| M7 | Force-push idempotent(reproducible)| `node scripts/build-published-template-mirror.mjs --out=/tmp/x` 多次 = 相同 output |
+| M7 | Clone-and-overlay push idempotent(reproducible)| `node scripts/build-published-template-mirror.mjs --out=/tmp/x` 多次 = 相同 output |
 
 ## 5. Verify Checkpoints — 後續增刪改 reference 此 SSOT
 

package/ds-canonical/references/ssot-consultation.md

@@ -50,7 +50,7 @@ CLAUDE.md `# SSOT 消費 canonical` 的詳表 + 反例。主章留核心 + point
  */
 ```
 
-Hook `check_ssot_consultation.sh`(retired;改靠 mindset #2 + `check_canonical_propagation.sh`)(原 Write 新 tsx 到 `packages/design-system/src/components/` 或 `src/explorations/` → 若檔內無上述註解區 → warn 要求補齊)。
+Hook `check_ssot_consultation.sh` retired;**2026-07-07 以 `check_ssot_header_declaration.sh` 精簡復活**(新建 production tsx 必帶「── 消費的 SSOT ──」段,P0 BLOCKER)+ mindset #2 + `check_canonical_propagation.sh`。(2026-07-10 hunt 修 stale 描述)
 
 ## 禁止:隱性自創
 
@@ -60,4 +60,4 @@ Hook `check_ssot_consultation.sh`(retired;改靠 mindset #2 + `check_canonical_p
 - 自寫 `<button aria-label="Close"><X /></button>` 作 dismiss(應用 `ItemInlineAction`)
 - 自寫 Row `<div><Icon /><span>label</span><Button /></div>`(應用 `<MenuItem>` + slot)
 - 自訂 Input `variant="custom-name"` 未先 grep 既有 variant 值
-- 在 Toolbar 用 `<input className="bg-transparent border-0 ...">`(應用 `<Input variant="bare">` 若既有;無 → Ambiguity Protocol)
+- 在 Toolbar 用 `<input className="bg-transparent border-0 ...">`(應用 `<Input size="sm" autoWidth>` 標準 default variant;`variant="bare"` 已於 2026-07-09 退役,不再使用)

package/ds-canonical/references/ssot-index.md

@@ -12,29 +12,30 @@
 
 | Interface | Owner spec | Canonical sentence | Drift status | Last divergence event |
 |---|---|---|---|---|
-| **DataTable body cell internal indicator**(display endAction / clear / edit indicator)| `data-table.spec.md`「Body cell internal」row + `inline-action.spec.md`「DataTable body cell internal」row | 「Body cell internal = Field family endAction(自動繼承)」「Field display 元件已對齊」 | ✅ aligned:2026-05-09 D-path retired — `getEditIndicator(colType)` parallel system 移除,indicator authority 移交 Field naked-display `showDisplayEndIcon` opt-in,cellEl 不再 render parallel indicator(見 data-table.tsx「D-path retired」註解)| 2026-05-08 round 5 → 2026-05-09 resolved |
+| **DataTable body cell internal indicator**(display endAction / clear / edit indicator)| `data-table.spec.md`「Body cell internal」row + `inline-action.spec.md`「DataTable body cell internal」row | 「Body cell internal = Field family endAction(自動繼承)」「Field display 元件已對齊」 | ✅ aligned:2026-05-09 D-path retired — `getEditIndicator(colType)` parallel system 移除,indicator authority 移交 Field naked-display `showDisplayEndIcon` opt-in,cellEl 不再 render parallel indicator(見 data-table.tsx「D-path retired」註解);2026-07-08 A 案:cell-registry 預設不再傳(display 態零恆顯 icon,prop 留 opt-in 逃生門,見 field.spec L6 v16)| 2026-05-08 round 5 → 2026-05-09 resolved |
 | **Field naked variant state ring**(hover / focus / open / error)| `field-wrapper.tsx` cva compoundVariants(v13.3)+ `field.spec.md`「focus dominates」段 | 「SSOT 在 field-wrapper.tsx 三 compoundVariant — 改一處全 control + cell + variant 跟動」 | ✅ aligned(2026-05-08 D path canary 違反後 revert)| 2026-05-08 round 4(D path canary 違反 SSOT,已 revert `f0faab9`)|
 | **Row prefix/suffix slot**(`<ItemPrefix>` / `<ItemSuffix>`)| `patterns/element-anatomy/item-anatomy.spec.md:175+190` | 「row prefix/suffix slot 必走 patterns/element-anatomy L1 primitive」「`h-[1lh] shrink-0 flex items-center` 普世正確」 | ✅ aligned(hook `check_pattern_invariants.sh` C.4 enforce)| — |
 | **Inline action gap**(ItemInlineAction sibling spacing)| `patterns/element-anatomy/inline-action.spec.md`「多個 inline action 間距」段 | 「inline-action 跟 sibling gap 必 = `gap-2`(8px)」 | ✅ aligned(hook C.2 enforce)| — |
 | **Drag visual**(drop indicator / drag overlay)| `lib/drag-visual.ts`(2026-05-06 v14.5)+ `tree-view.spec.md:265` | 「TreeView 是 DS 內最早 codified 的 drag canonical,DataTable row drag + column reorder 都 inherit via drag-visual.ts SSOT module」 | ✅ aligned | — |
-| **Color tokens**(primitive vs semantic)| `tokens/color/color.spec.md`(架構流派定位)+ `tokens/color/semantic.css` | 「禁 primitive 色名作 utility,用 semantic alias」 | ✅ aligned(hook D.3 enforce)| — |
+| **Color tokens**(primitive vs semantic)| `tokens/color/color.spec.md`(架構流派定位)+ `tokens/color/semantic.css` | 「禁 primitive 色名作 utility,用 semantic alias」 | ✅ aligned(hook `check_naming_and_abstraction.sh` D.3 enforce)| — |
 | **Layout space**(region/element + 親疏三級)| `tokens/layoutSpace/layoutSpace.spec.md` v6(原 memory `feedback_layout_v6_canonical.md` 已 retire)| 「region/element + bounded/unbounded + 親疏三級」 | ✅ aligned(2026-05-01 flush variant retire)| 2026-05-01 |
 | **DataTable scroll**(3-region synced + cross-OS scrollbar)| `data-table.spec.md:245-251` | 「center body 用 native overflow-x-auto(非 ScrollArea),pinned column 三 region 同步」 | ✅ aligned(v15.13 interim CSS parity for Windows Bug H,deferred ScrollArea full migration)| 2026-04-30 / 2026-05-07 |
 | **Cell display vs edit content position**(picker offset)| `field.spec.md`「Layout Family 4」段 + `data-table.spec.md`「Body cell internal」row | 「Field control display + edit 共用同 wrapper geometry」 | ⚠ partial:DataTable cell 場景已對齊(D-path `showDisplayEndIcon` opt-in 走 Field naked-display);standalone `mode="display"` 仍 bare-span(documented deferral,見 select.tsx 檔頭 `@renderer-symmetry-allow`)| 2026-05-07~08 round 1-5 → 2026-05-09 D-path 部分解決 |
 | **Field state machine focus dominates**(v13.3)| `field-wrapper.tsx` cva compoundVariants + `field.spec.md`「focus dominates」段 + `check_field_family_invariants.sh` A.3 | 「focus dominates everything;naked 不寫平行 outline ring」 | ✅ aligned;hook A.3 enforce | 2026-05-06 v9-v13.3 5 round refinement |
 | **Solo dev workflow**(1 chat = 1 branch / Netlify gate / squash merge)| `feedback_solo_dev_workflow.md` + CLAUDE.md「Git solo-work canonical」 | 「1 chat = 1 working branch;Netlify preview = user gate;『push / OK』trigger 才 merge main」 | ✅ aligned(M28 + hook `check_solo_workflow.sh`)| 2026-05-08 M28 codify |
 | **Wrapper-vs-primitive schema unify**(SelectOption / MenuItemProps 等)| `SelectMenu/select-menu.tsx` SelectMenuOption + `Combobox/combobox.tsx` extends + `PeoplePicker/people-picker.tsx` extends | 「wrapper API schema 必 `extends primitive`,wrapper 內部 mapping 必 forward 全 primitive surface field(M30)」 | ✅ aligned(2026-05-10 Round 1 commit `561945b` Combobox extends + forward 全 field;PeoplePicker 對齊 + hook `check_wrapper_primitive_schema_drift.sh` BLOCKER)| 2026-05-10 M30 codify |
+| **空值顯示符號 + 分流**(empty value display)| `field-context.ts` `useFieldEmptyDisplay()`(分流 hook)+ `field-wrapper.tsx` `EMPTY_DISPLAY = '-'`(半形常數)+ `field-controls.spec.md`「null / undefined 值」段 | 「符號 = 半形 hyphen `-`(U+002D),**非**全形 em dash;`surface==='table-cell' && isEditable ? '' : '-'`;可編輯 form edit 走 native placeholder。全 Field family 空值渲染必經 hook,consumer 禁直引 `EMPTY_DISPLAY`」 | ✅ aligned(2026-07-08 user 拍板半形;hook `check_field_family_invariants.sh` A.6 BLOCKER — 禁非 owner 直引常數 + 禁 hardcode 全形 em dash;DescriptionList / ProfileCard / FileViewer consumer 同步半形)| 2026-07-08 user directive |
 
 ## How to maintain
 
 - 新 interface 第一次 surface → 加進本 index
 - 新 divergence 發現 → 加 row + 標 ⚠ DRIFT
 - Drift 解決 → 改 ✅ aligned
-- 重大 round 結束 → 跑 audit Dim 38 反 grep verify
+- 重大 round 結束 → 逐 row 反 grep owner spec/code 驗仍一致(`/deep-audit-cross-codex` Phase A 必讀清單已含本檔,見 `phase-a-workflow.md:15`;無專屬 audit dim 機械化)
 
 ## 與 hook 關係
 
-- `check_ds_anchor_preflight.sh`(live,soft warn)— 偵測編 Field / DataTable / patterns code 時 stderr 提醒「先 grep ssot-index.md」
+- `check_ds_anchor_preflight.sh`(live,P0 BLOCKER exit 2,2026-07-07 升級)— 偵測 production tsx / apps consumer 內 DS primitive wrap 而無 canonical read trace → block;bypass `CLAUDE_BYPASS_DS_ANCHOR=1`(audit-logged)
 - `check_field_family_invariants.sh` A.3 — 機械化 enforce v13.3 SSOT
 - `check_pattern_invariants.sh` C.4 — 機械化 enforce row slot SSOT
 - `check_canonical_propagation.sh` E.2 — 機械化 enforce L3 primitive import