data-sanity

<!-- 🔒 LOCKED — managed by clade · auto-generated by sync-to-cursor; edit source in .claude/ then re-run sync --> <!-- clade-targets: claude,codex,cursor --> <!-- clade-adapters: claude --> `data-sanity` — Layer C static data-shape audit。依當前產品已安裝的 skill 入口呼叫，或讀取本文件後使用下列 CLI。 本 skill 執行唯讀稽核與回報；發現問題後，修正依本次任務既有授權處理。`metadata.clade.permission_tier` 記錄這項政策，不是原生權限控制。 Born from perno `app-status-badge-extraction`（2026-05-24）: `attendance/amendments.vue` 用 `useEmployeeListQuery({ perPage: 200 })`，但 server schema 是 `perPage: z....max(100)` → API 400 → `employeeNameMap` empty → 員工 column 整列「-」。typecheck / lint / design review / verify:ui 全沒抓到，因為它是**資料形狀**問題，不是型別或視覺問題。 這是 clade 自有 skill（**不是** `/impeccable` 的 sub-command — impeccable 是第三方 npx-managed skill，clade 不擁有）。 ## 何時跑 - **Design Checkpoint 期間**（[[proactive-skills.design-checkpoint]]）：對本次工作觸及的 paginated query + lookup-resolved column 跑一次。 - **交付人工檢查之前**：data-shape 防線。 - **Ad-hoc**：任何改到 `useXxxQuery({ <param>: <literal> })` 或 lookup map 的工作。 ## 怎麼跑 從 clade central 呼叫（`<clade-vendor>` = `~/offline/clade/vendor`，與其他 vendor script 同慣例）： ```bash node <clade-vendor>/scripts/audit-data-sanity.ts \ --consumer-path . \ [--files <comma-separated-touched-files>] \ --json ``` - 不給 `--files` → walk 整個 consumer（skip node_modules/.nuxt/dist）。 - 給 `--files` → 掃指定的既有檔；route 關聯可額外讀取它匯入的 schema。範圍以傳入路徑為準，此參數不提供目錄隔離；只傳本次已授權的路徑。 ## 偵測項 1. **PARAM_BOUNDARY（Critical — blocks archive）**：client 端 pagination-ish param literal（`perPage` ...