nuxt-data-audit

本流程只稽核與回報。metadata.clade.permission_tier 是政策標記，不是原生權限控制；修正依本次任務既有授權處理。

nuxt-data-audit — Nuxt data-fetching & performance golden path audit，另含 client-server schema boundary mode（schema，即 data-sanity）。這是 skill 的檢查流程，沒有同名獨立 CLI；下方參數由執行 skill 的 agent 解讀。原生入口未載入時，讀取本文件與 reference rule 後依已授權工具執行。

開始評分前讀取 reference rule：clade 的 rules/core/nuxt-data-perf.md，或目前 runtime 已交付的同名規約。若無法取得該規約，報告標示未完成。 Cookbook：~/offline/clade/vendor/snippets/nuxt-data-perf/

怎麼跑

/nuxt-data-audit                          # 掃當前 cwd 的 consumer
/nuxt-data-audit ~/offline/<consumer-id>  # 掃指定 consumer
/nuxt-data-audit --fleet                  # 掃全 fleet（從 clade home 用 registry/consumers.json）
/nuxt-data-audit schema <files>           # 查 paginated-query / lookup-map contract boundary

schema mode 的完整偵測項、JSON schema 與 exit-code contract 保留於 data-sanity reference；需要時讀取後執行 node <clade-vendor>/scripts/audit-data-sanity.ts --consumer-path . --json。

Phase 1 — Dependency Detection

判斷 consumer 的 data-fetching stack：

# 檢查 package.json
grep -E '@pinia/colada|@pinia/colada-nuxt|@pinia/nuxt' package.json

分為兩類：

• Colada consumer：安裝了 @pinia/colada → 全部 checklist 適用
• Non-Colada consumer：未安裝 → E9/E10 標 N/A，其餘全部適用

Phase 2 — 候選掃描與逐項查核

以下文字搜尋只產生候選；程式探索先使用當前可用的 codebase graph 工具，shell 搜尋依 repository 規約補充。逐筆讀取實際呼叫與資料路徑後評分。零命中、檔案數或函式名稱數量不等於行為已驗證。

每列保留適用範圍、檔案／呼叫位置與判定證據。沒有適用對象記 N/A 並說明已查範圍；尚未讀完呼叫鏈或缺執行證據記 unknown。這兩種狀態都不算 pass。

E1 — setup 無裸 $fetch（HR-1）

# 找 .vue 檔中 <script setup> 的 $fetch（排除 event handler）
# 注意 $csrfFetch 等 alias 也要查
find . -name '*.vue' -not -path '*/node_modules/*' -not -path '*/.nuxt/*' -not -path '*/test/*' \
  | xargs grep -l '\$fetch\|\$csrfFetch'

對每個命中檔案：追查初始資料載入的實際呼叫路徑，包括 setup 呼叫的 helper／alias。函式包裝本身不提供 SSR payload 保護。

判定：

• pass：初始資料由 useFetch／useAsyncData／useQuery 等適用機制承接，其他 $fetch 只由事件等非初始載入入口觸發。
• fail：setup 初始載入直接或經 helper 呼叫裸 $fetch。

E2 — useFetch 有適當 key（HR-4 useFetch 部分）