npm - figma-cache-toolchain - Versions diffs - 2.0.1 → 2.0.3 - Mend

figma-cache-toolchain 2.0.1 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md +2 -2
package/cursor-bootstrap/AGENT-SETUP-PROMPT.md +43 -60
package/cursor-bootstrap/examples/README.md +10 -6
package/cursor-bootstrap/examples/generated-ui-reset.css.template +32 -0
package/cursor-bootstrap/examples/ui-1to1-preflight.template.md +80 -0
package/cursor-bootstrap/managed-files.json +41 -0
package/cursor-bootstrap/rules/02-figma-stack-adapter.mdc +15 -25
package/cursor-bootstrap/rules/03-figma-ui-implementation-hard-constraints.mdc +58 -0
package/cursor-bootstrap/rules/04-ui-baseline-governance.mdc +35 -0
package/cursor-bootstrap/skills/figma-ui-dual-mode-execution/SKILL.md +37 -0
package/figma-cache/docs/README.md +1 -1
package/figma-cache/figma-cache.js +10 -4
package/figma-cache/js/cursor-bootstrap-cli.js +218 -186
package/package.json +75 -74

package/README.md CHANGED Viewed

@@ -32,9 +32,9 @@ npx figma-cache cursor init
 该命令会：
-- 默认覆盖写入最新 `.cursor/rules/`、`.cursor/skills/` 模板
+- 默认安全模式：保留已有 `.cursor/rules/`、`.cursor/skills/`，仅补缺失文件
 - 新增通用规则：`.cursor/rules/00-output-token-budget.mdc`（全任务低 token 输出基线）
-- 若需保留已存在模板，可使用 `npx figma-cache cursor init --force`（跳过同名覆盖）
+- 若需覆盖现有模板，可使用 `npx figma-cache cursor init --overwrite`
 - 确保根目录存在 `figma-cache.config.js`
 - 刷新根目录 `AGENT-SETUP-PROMPT.md`
 - 同步刷新 `figma-cache/docs/colleague-guide-zh.md`

package/cursor-bootstrap/AGENT-SETUP-PROMPT.md CHANGED Viewed

@@ -1,60 +1,43 @@
-# Figma Cache：请 Agent 一次性完成项目适配
-> **给 Cursor Agent 的指令**：你正在操作的是**用户业务项目**的根目录。以下文件应已存在（由 `npx figma-cache cursor init` 从 npm 包 **`{{NPM_PACKAGE_NAME}}`** 复制到当前仓库根）：
-> - `.cursor/rules/01-figma-cache-core.mdc`
-> - `.cursor/rules/00-output-token-budget.mdc`（通用低 token 输出基线）
-> - `.cursor/rules/02-figma-stack-adapter.mdc`（**占位**，任务完成后需删除）
-> - `.cursor/rules/figma-local-cache-first.mdc`（可选保留）
-> - `.cursor/skills/figma-mcp-local-cache/SKILL.md`
-> - `figma-cache.config.js`（示例 `postEnsure`：目录级 adapter hint + 可选 `docs/figma-flow-readme.md`）
-> - （兼容旧项目）`figma-cache.config.example.js` 可能存在；仅当内容被用户自定义且无法安全迁移时保留
-## 你必须完成的任务（按顺序执行，尽量少问用户）
-1. **读取工程事实**
-   阅读 `package.json` 及存在的构建配置（如 `vite.config.*`、`vue.config.js`、`next.config.*`、`tsconfig.json` 等），**自行推断** UI 技术栈（框架、组件库、样式方案、状态管理若有则记录）。仅在关键信息完全无法从仓库推断时，再向用户提一个极简问题。
-2. **检查并合并 `figma-cache.config.js`**
-   - 若根目录**不存在** `figma-cache.config.js`：基于当前文件创建完整配置，并实现与栈匹配的 `hooks.postEnsure`。
-   - 若**已存在** `figma-cache.config.js`：**合并**而非盲目覆盖——保留用户已有非 figma-cache 字段，仅补充或调整 `hooks.postEnsure` 及与 figma-cache 相关的导出；冲突时以「不破坏用户现有逻辑」优先并注释说明。
-   - 默认建议：`FIGMA_CACHE_ADAPTER_DOC_MODE=cache-root`（目录级单文件，减少重复）；仅在团队明确需要节点文档时改为 `node`。
-3. **清理 legacy example（若安全）**
-   若根目录存在 `figma-cache.config.example.js` 且其内容与 `figma-cache.config.js` 等价（或为未改动模板），请删除该 example 文件，避免后续协作混淆。
-4. **生成栈专属 Adapter 规则**
-   新建 **`.cursor/rules/02-figma-<栈简名>-adapter.mdc`**（`alwaysApply: false`）。内容须与 **`01-figma-cache-core.mdc`** 边界一致：只约束「在通用缓存可读之后如何写业务 UI」；**禁止**要求在 `meta.json` / `raw.json` / `spec.md` 中写入框架专有实现。
-5. **删除占位规则**
-   确认第 4 步文件已写入且无语法问题后，**删除** `.cursor/rules/02-figma-stack-adapter.mdc`。若用户在 Cursor 设置里固定引用了该文件名，请在汇报中提示用户改为引用新的 `02-figma-<栈>-adapter.mdc`。
-6. **补全 npm scripts（若缺失）**
-   若 `package.json` 中没有任何 `figma:cache:*` 脚本，请追加一组，命令使用 **`npx figma-cache`** 或 **`figma-cache`**（与项目是否已安装本包、以及 `node_modules/.bin` 是否可用一致即可，优先 `npx figma-cache` 以减少环境差异）。至少包含：`init`、`config`、`validate`、`ensure`、`get`（名称与 `figma-cache --help` 或包内 **`figma-cache/docs/README.md`** 中 scripts 示例一致即可）。
-7. **收尾**
-   - 用简短列表向用户汇报：新建/修改/删除了哪些路径。
-   - 若项目根**尚无** `figma-cache/index.json`，提示用户执行：`npm run figma:cache:init`（若已加 script）或 `npx figma-cache init`（与 `cursor init` 不同，用于创建空索引与缓存目录）。
-   - 提示用户在本项目根执行：`npm run figma:cache:validate`（若已加 script）或 `npx figma-cache validate`。
-   - 说明：后续 Figma 相关对话将主要由 **01 Core + 新 Adapter + Skill** 驱动。
-      - **可选**：若项目已通过 `cursor init` 同步 `figma-cache/docs/colleague-guide-zh.md`，提示团队默认只使用 **§5.1「最推荐主提示词」**，只有特殊诉求再追加 **§5.2** 的一句附加要求。
-## 输出与 token 约束（强制）
-- 默认“只要结果”：不输出思考过程，不粘贴 MCP 长回包。
-- 执行 Figma MCP 后，用户可见回复只保留：缓存状态、调用次数、产物路径、校验结论、失败修复动作。
-- 除非用户明确要求，禁止在 chat 中贴出 `get_design_context` 全文；原始内容仅保存到 `mcp-raw/*`。
-## 硬约束（违反则视为未完成）
-- **不要**修改 `node_modules/{{NPM_PACKAGE_NAME}}/` 下已发布包内文件（应无此必要）。
-- **不要**修改 `figma-cache/figma-cache.js` 或破坏 Core「框架中立」语义。
-- **不要**把业务路由名、具体组件库 API 写进 `figma-cache/files/**` 下的 `meta.json` / `raw.json` / `spec.md`。
-## 可选参考（仅在用户需要 Vue2+Vuetify2 时）
-包内附带参考文本（**不在 init 时复制到 .cursor**）：
-`node_modules/{{NPM_PACKAGE_NAME}}/cursor-bootstrap/examples/vue2-vuetify2-adapter.reference.mdc`
-若用户明确要求该栈，可读入后改写为第 4 步的 Adapter 规则内容。
----
-**开始执行：**读完本文件后立刻按上述顺序操作仓库文件，直至全部完成。
+# Figma Cache：请 Agent 一次性完成项目适配（精简）
+> 前提：你在用户业务项目根目录；以下模板来自 `{{NPM_PACKAGE_NAME}}`。
+## 必做（按序）
+1. 读取项目栈事实（package.json + 构建配置）。
+2. 合并/创建 `figma-cache.config.js`（不破坏用户已有逻辑）。
+3. 生成 `.cursor/rules/02-figma-<stack>-adapter.mdc`。
+4. 验证新 adapter 可用（语法 + 最小执行验证）。
+5. 补全 `figma:cache:*` scripts（缺失时）。
+## 老项目 UI 基线（默认 B0）
+1. 复制模板：
+   `node_modules/{{NPM_PACKAGE_NAME}}/cursor-bootstrap/examples/generated-ui-reset.css.template`
+   -> 项目 `src/styles/generated-ui-reset.css`
+2. 在入口（如 `src/main.ts`）单次引入。
+3. 后续生成组件根节点统一加：`generate-ui-reset`。
+4. 若用户要求更强控制，再升级 B1/B2。
+## 生成完成后清理临时模板文件（强制）
+- 删除 `.cursor/rules/02-figma-stack-adapter.mdc`
+- 删除 `AGENT-SETUP-PROMPT.md`
+## 规则优先级
+- 缓存层：`01-figma-cache-core.mdc`
+- UI 实现：`03-figma-ui-implementation-hard-constraints.mdc`
+- 基线治理：`04-ui-baseline-governance.mdc`
+- 输出约束：`00-output-token-budget.mdc`
+## UI 标签口径
+- 默认优先 `div/span/img`
+- 默认禁用 `p/ul/li/ol/h1-h6`（除非用户明确要求）
+- `input/select/textarea/a` 可直接使用
+- 原生 `button` 默认禁用（封装或 UI 库按钮除外）
+- `role/aria-*` 默认不强制
+- `data-node-id/data-name` 默认不输出（调试模式除外）
+## 输出约束
+- 结果优先，不贴 MCP 长原文。
+- 仅输出：结论、关键改动、验证结果、下一步。
+---
+开始执行：直接落文件并完成验证。

package/cursor-bootstrap/examples/README.md CHANGED Viewed

@@ -1,11 +1,15 @@
-# 栈相关参考（不随 `cursor init` 复制）
+# 栈相关参考（不随 `cursor init` 复制）
-本目录存放 **可选** 的完整 Adapter 示例，供人工或 Agent 对照；**通用默认**请使用 `cursor init` 生成的 `02-figma-stack-adapter.mdc` 与根目录 `figma-cache.config.js`。
+本目录存放可选参考与模板文件：
 | 文件 | 说明 |
-|------|------|
-| `vue2-vuetify2-adapter.reference.mdc` | 历史 Vue 2 + Vuetify 2 表现层规则全文，可复制为 `.cursor/rules/02-figma-vuetify2-adapter.mdc` 并按项目改名 |
-将参考规则复制进 `.cursor/rules/` 后，建议同步 `figma-cache.config.js` 的 adapter 提示策略：默认使用 `FIGMA_CACHE_ADAPTER_DOC_MODE=cache-root`（目录级单文件），仅在明确需要节点文档时改为 `node`。
+|---|---|
+| `vue2-vuetify2-adapter.reference.mdc` | 历史 Vue2 + Vuetify2 参考规则 |
+| `generated-ui-reset.css.template` | 老项目 B0 局部 reset 模板（推荐默认） |
+## B0 推荐用法（目标业务项目）
+1. 复制模板到项目：`src/styles/generated-ui-reset.css`
+2. 在入口（如 `src/main.ts`）引入一次
+3. 生成组件根节点加 `generate-ui-reset`
+说明：B0 仅做局部基线，不污染全局；B1/B2 见 `04-ui-baseline-governance.mdc`。

package/cursor-bootstrap/examples/generated-ui-reset.css.template ADDED Viewed

@@ -0,0 +1,32 @@
+/* Generated UI local reset (scoped) */
+:where(.generate-ui-reset),
+:where(.generate-ui-reset *) {
+  box-sizing: border-box;
+}
+:where(.generate-ui-reset img),
+:where(.generate-ui-reset svg),
+:where(.generate-ui-reset video),
+:where(.generate-ui-reset canvas) {
+  display: block;
+  max-width: 100%;
+}
+:where(.generate-ui-reset input),
+:where(.generate-ui-reset select),
+:where(.generate-ui-reset textarea),
+:where(.generate-ui-reset button),
+:where(.generate-ui-reset a) {
+  font: inherit;
+  color: inherit;
+  letter-spacing: inherit;
+}
+/* Optional strict mode for high-fidelity pages only */
+:where(.generate-ui-reset--strict input),
+:where(.generate-ui-reset--strict select),
+:where(.generate-ui-reset--strict textarea) {
+  margin: 0;
+  border-radius: 0;
+}

package/cursor-bootstrap/examples/ui-1to1-preflight.template.md ADDED Viewed

@@ -0,0 +1,80 @@
+# UI 1:1 实现前预检模板
+> 用途：在“开始写组件前”完成事实快照、状态对照与预检，降低返工。
+> 适用：Figma 缓存驱动实现（任意 nodeId）。
+## 0. 基本信息
+- fileKey:
+- nodeId:
+- cachePath:
+- 实现目标页面/组件路径:
+- 执行模式（短流程 / 严格流程）:
+## 1. 设计值快照（Design Facts）
+### 1.1 结构与尺寸
+- 根容器（宽/高/圆角/边框/背景）:
+- 关键子容器尺寸:
+- 宽度策略（固定 / 自适应，仅可选一）:
+- 对齐策略（左/右/居中）:
+### 1.2 文案
+- 标签文本:
+- 值文本:
+- 选项文本:
+### 1.3 Token
+- 字体（size/line-height/weight/letter-spacing）:
+- 主文本色:
+- 次文本色:
+- 背景色:
+- 边框色:
+- 状态色（hover/focus/selected）:
+### 1.4 交互与语义
+- 交互触发（click/esc/outside/keyboard）:
+- 语义角色（combobox/listbox/option 等）:
+- 禁止项（本任务）:
+## 2. 状态对照表（必须填写）
+| 状态 | 背景 | 边框 | 文本 | 图标 | 数据状态 | 是否实现 |
+| --- | --- | --- | --- | --- | --- | --- |
+| default |  |  |  |  |  | [ ] |
+| hover |  |  |  |  |  | [ ] |
+| focus |  |  |  |  |  | [ ] |
+| active |  |  |  |  |  | [ ] |
+| expanded |  |  |  |  |  | [ ] |
+| selected |  |  |  |  |  | [ ] |
+| unselected |  |  |  |  |  | [ ] |
+| disabled（若存在） |  |  |  |  |  | [ ] |
+## 3. 1:1 预检清单（实现前）
+- [ ] 已读取 `spec.md` / `raw.json` / `state-map.md` / `mcp-raw-get-design-context.txt`
+- [ ] 冲突裁决规则确认：`mcp-raw-get-design-context.txt` 优先
+- [ ] 全组件盒模型策略一致（建议 `box-border`）
+- [ ] 文本溢出策略明确（`min-w-0` + `truncate` 或等效）
+- [ ] 弹层锚定触发器（非页面硬编码定位）
+- [ ] 图标策略确认（项目图标库优先；兜底 `inline svg`）
+- [ ] 禁止使用 Figma 临时远程资产 URL 作为运行时图标
+- [ ] 禁止无意义标签嵌套
+- [ ] 默认无横向滚动
+## 4. 实现后验收（最小）
+- [ ] 改动文件 lint 通过
+- [ ] 关键状态可见且可切换（至少 default/expanded/selected/unselected）
+- [ ] 关键视觉项（尺寸/对齐/图标居中）通过
+- [ ] 输出“设计值 -> 代码映射”
+## 5. 失败反馈（固定三段）
+1. 失败原因
+2. 定位信息（文件/字段/样式项）
+3. 修复动作

package/cursor-bootstrap/managed-files.json ADDED Viewed

@@ -0,0 +1,41 @@
+{
+  "managedFiles": [
+    {
+      "from": "rules/00-output-token-budget.mdc",
+      "to": ".cursor/rules/00-output-token-budget.mdc"
+    },
+    {
+      "from": "rules/01-figma-cache-core.mdc",
+      "to": ".cursor/rules/01-figma-cache-core.mdc"
+    },
+    {
+      "from": "rules/02-figma-stack-adapter.mdc",
+      "to": ".cursor/rules/02-figma-stack-adapter.mdc"
+    },
+    {
+      "from": "rules/03-figma-ui-implementation-hard-constraints.mdc",
+      "to": ".cursor/rules/03-figma-ui-implementation-hard-constraints.mdc"
+    },
+    {
+      "from": "rules/04-ui-baseline-governance.mdc",
+      "to": ".cursor/rules/04-ui-baseline-governance.mdc"
+    },
+    {
+      "from": "rules/figma-local-cache-first.mdc",
+      "to": ".cursor/rules/figma-local-cache-first.mdc"
+    },
+    {
+      "from": "skills/figma-mcp-local-cache/SKILL.md",
+      "to": ".cursor/skills/figma-mcp-local-cache/SKILL.md"
+    },
+    {
+      "from": "skills/figma-ui-dual-mode-execution/SKILL.md",
+      "to": ".cursor/skills/figma-ui-dual-mode-execution/SKILL.md"
+    }
+  ],
+  "retiredFiles": [
+    ".cursor/skills/ui-baseline-governance/SKILL.md",
+    ".cursor/rules/04-command-execution-anti-regression.mdc",
+    ".cursor/rules/commit-conventions.mdc"
+  ]
+}

package/cursor-bootstrap/rules/02-figma-stack-adapter.mdc CHANGED Viewed

@@ -1,32 +1,22 @@
----
-description: 栈占位：由 Agent 按项目 UI 技术栈生成 02-figma-<stack>-adapter.mdc 后再实现业务 UI（本文件可删除或 alwaysApply 保持 false）
+---
+description: 栈占位模板（仅生成期使用）：生成完成后删除本文件与 AGENT-SETUP-PROMPT.md
 alwaysApply: false
 ---
-# Figma → UI Stack Adapter（占位）
-本文件是 **通用脚手架**，不绑定 Vue / React / 任何组件库。若你已有具体栈的 Adapter 规则（例如 `02-figma-vuetify2-adapter.mdc`、`02-figma-react-mui-adapter.mdc`），可将本文件删除，或在 Cursor 设置中不再引用本文件。
-## 第一步：用 Agent 生成栈专属规则
-在项目根执行 `npx figma-cache cursor init` 后，打开 **`AGENT-SETUP-PROMPT.md`**，在 Cursor 里 **`@AGENT-SETUP-PROMPT.md`** 或整篇粘贴给 Agent，让其按文档顺序执行（含推断栈、生成配置、删除本占位文件）。若你更习惯手写，也可自行新建 `02-figma-<栈>-adapter.mdc` 与 `figma-cache.config.js`，再删除本文件。
-生成后，**01-figma-cache-core** 仍只负责缓存与校验；**表现层**仅由你的 `02-figma-*-adapter` 约束。
-## 与 01 的固定边界
-- **单一事实来源**：实现 UI 时只从 `raw.json`、`spec.md`、`state-map.md`、`meta.json` 取数；不在这些通用文件里写入框架专有代码或路由名。
-- **仅当任务包含「写/改业务 UI」且缓存可读**时，才应用具体栈的 Adapter；纯缓存维护、只跑 CLI，不触发表现层规则。
-## React 直复用（选用规则）
+# Figma -> UI Stack Adapter（占位模板）
-仅当 Agent 识别目标项目为 **React 栈**（如 React + Tailwind / React + CSS Modules / React + styled-system）时启用：
+本文件仅用于生成阶段引导，非长期规则。
-- 优先复用节点目录下 `mcp-raw-get-design-context.txt` 的 React 参考代码作为起稿。
-- 在此基础上仅做必要微调：项目 token 映射、组件替换、状态/交互逻辑、数据绑定、可访问性与响应式。
-- 若项目非 React 栈，禁止直接复用该 React 代码，应按目标栈 Adapter 规则转换实现。
-- 复用时优先保持结构与视觉一致性；改动应聚焦“接入项目规范”而非重写布局。
+## 生成流程（强制）
+1. 基于项目栈生成 `.cursor/rules/02-figma-<stack>-adapter.mdc`。
+2. 验证新 adapter 可用（语法 + 最小执行验证）。
+3. 删除临时模板文件：
+   - `.cursor/rules/02-figma-stack-adapter.mdc`
+   - `AGENT-SETUP-PROMPT.md`
-## 参考实现（非默认）
+## 边界
+- `01-figma-cache-core` 仅负责缓存与校验。
+- 业务 UI 实现约束由新生成的 `02-figma-<stack>-adapter.mdc` + `03/04` 规则承接。
-安装本包后，示例路径为 **`node_modules/figma-cache-toolchain/cursor-bootstrap/examples/vue2-vuetify2-adapter.reference.mdc`**（Vue 2 + Vuetify 2 全文参考），需时由 Agent 读入并改写为你的 `.cursor/rules/02-figma-...`。
+## 说明
+- 若用户明确要求保留任务书或占位模板，可不删除，并在汇报中说明原因。

package/cursor-bootstrap/rules/03-figma-ui-implementation-hard-constraints.mdc ADDED Viewed

@@ -0,0 +1,58 @@
+---
+description: Figma 缓存驱动 UI 实现硬约束（统一版：含一次性交付与证据映射）
+alwaysApply: true
+---
+# Figma UI 实现硬约束（统一版）
+边界：仅约束缓存可读后的业务 UI 实现，不负责 MCP 拉取。
+## 0) 压缩级别（先选）
+- L0 严格：高保真/复杂交互/历史漂移（完整对齐 + 全状态 + 强校验）。
+- L1 标准（默认）：精简事实清单 + 核心状态 + lint。
+- L2 快速：仅“先看效果”场景，先静态后补交互。
+## 1) 首版必读（强制）
+- `spec.md` / `raw.json` / `state-map.md` / `mcp-raw-get-design-context.txt`
+## 2) 裁决顺序（强制）
+- 信息冲突：回到 `mcp-raw-get-design-context.txt`。
+- 仍无法裁决：先问用户，禁止猜测。
+## 3) 视觉与布局（强制）
+- 颜色/字体/几何/间距使用明确值，不用近似值。
+- 默认 `box-border`，文本溢出显式处理。
+- 禁止无依据横向滚动与布局抖动。
+## 4) 标签与控件（最新口径）
+- 默认优先：`div` / `span` / `img`。
+- 默认禁用：`p` / `ul` / `li` / `ol` / `h1-h6`（除非用户明确要求）。
+- 可直接使用：`input` / `select` / `textarea` / `a`。
+- 原生 `button` 默认禁用；仅封装按钮或 UI 库按钮可用。
+- `role` / `aria-*` 默认不强制。
+## 5) 元数据策略
+- `data-node-id` / `data-name` 默认不输出到最终业务代码。
+- 仅在调试映射模式下临时保留。
+## 6) 状态与交互（强制）
+- 覆盖缓存声明状态（至少 `default / expanded / selected / unselected`，若存在）。
+- 仅实现缓存声明或用户要求交互，不私增。
+## 7) 一次性交付判定（强制）
+- 信息充分（结构/文案/token/状态交互无关键缺口）时：必须一次性完成结构、样式、状态、基础响应式与可访问性，并同轮完成至少一项核心校验。
+- 信息不足时：必须一次性列出“缺失字段 + 影响范围 + 最小补充需求”，并标注“受限还原”。
+## 8) 证据映射（强制）
+- 交付说明至少覆盖：布局结构、核心文案、主要颜色/字体 token、状态/交互判断。
+- 每项实现事实必须给一个主来源（`raw.json/spec.md/state-map.md/mcp-raw-get-design-context.txt`）。
+- 若引用 `mcp-raw`，仅用于补缺口/消歧，不重复主来源事实。
+- 若 `raw/spec` 与 `mcp-raw` 冲突，先报告冲突再给采用依据。
+## 9) 验收与失败反馈
+- 每轮至少执行改动文件 lint。
+- 声称“1:1 完成”前，至少补一项构建/类型/核心测试。
+- 失败反馈固定三段：
+  1. 失败原因
+  2. 定位信息（文件 + 项）
+  3. 修复动作

package/cursor-bootstrap/rules/04-ui-baseline-governance.mdc ADDED Viewed

@@ -0,0 +1,35 @@
+---
+description: UI 基线治理（分级精简版：判型、局部基线、验证回滚）
+alwaysApply: false
+---
+# UI Baseline Governance（分级）
+## 0) 项目判型
+- 老项目：命中任一（页面多 / 已有 reset / UI 框架 / 全局样式风险）。
+- 新项目：均不命中且页面少。
+- 不确定：按老项目。
+## 1) 策略
+- 新项目：可一次性全局基线。
+- 老项目：局部基线优先，分层分批，可回滚。
+## 2) 基线实施级别（按效果选）
+- B0 保守（老项目默认）：
+  - 复制模板 `node_modules/{{NPM_PACKAGE_NAME}}/cursor-bootstrap/examples/generated-ui-reset.css.template`
+    -> 项目 `src/styles/generated-ui-reset.css`。
+  - 在入口（如 `src/main.ts`）单次引入。
+  - 生成组件根节点统一加 `generate-ui-reset`。
+- B1 中等：页面级作用域基线（新页面/新模块）。
+- B2 激进：全局基线（仅新项目或明确授权）。
+## 3) 最小联动约束
+- 默认 `box-border`。
+- 弹层锚定触发器。
+- 图标优先项目图标系统，兜底 `inline svg`。
+## 4) 验收输出
+1. 判型结论 + 证据
+2. 本轮级别（B0/B1/B2）
+3. 影响范围 + 回滚方式
+4. lint + 可视验证

package/cursor-bootstrap/skills/figma-ui-dual-mode-execution/SKILL.md ADDED Viewed

@@ -0,0 +1,37 @@
+---
+name: figma-ui-dual-mode-execution
+description: 仅用 nodeId 或 Figma 链接触发 UI 实现，支持 L0/L1/L2 压缩级别，并内置基线判型与 B0/B1/B2 选择。
+---
+# Figma UI Dual Mode Execution（分级）
+## 执行步骤（固定）
+1. 规范化 nodeId 并命中缓存目录。
+2. 读取 `spec/raw/state-map/design-context`。
+3. 选择压缩级别：L0/L1/L2（默认 L1）。
+4. 输出事实对齐清单并实现挂载。
+5. lint 验证并输出映射结论。
+## 压缩级别
+- L0：高保真严格流程（预检文档 + 完整状态）。
+- L1：标准流程（精简清单 + 核心状态）。
+- L2：快速看效果（先静态后补交互）。
+## 基线治理（并入）
+- 项目判型：新项目 / 老项目 / 不确定（不确定按老项目）。
+- 基线级别：B0/B1/B2（老项目默认 B0）。
+- B0（默认）：
+  - 复制模板到 `src/styles/generated-ui-reset.css`
+  - 入口单次引入
+  - 生成组件根节点加 `generate-ui-reset`
+- B1：仅新页面/模块范围启用作用域基线。
+- B2：全局基线，仅新项目或明确授权。
+- 若与规则冲突，以 `.cursor/rules/04-ui-baseline-governance.mdc` 为准。
+## 标签口径
+- 默认 `div/span/img`
+- 默认禁 `p/ul/li/ol/h1-h6`
+- `input/select/textarea/a` 允许
+- 原生 `button` 默认禁用（封装/UI 库按钮除外）
+- `role/aria-*` 默认不强制
+- `data-node-id/data-name` 默认不输出

package/figma-cache/docs/README.md CHANGED Viewed

@@ -134,7 +134,7 @@ npm run figma:cache:init
 - **项目根**仍需：`figma-cache.config.js`、`.cursor/` 规则与 Skill、`AGENT-SETUP-PROMPT.md`（或由等价流程生成）。
 - Vue2+Vuetify2 参考 Adapter：`cursor-bootstrap/examples/vue2-vuetify2-adapter.reference.mdc`（npm 安装时在 `node_modules/.../cursor-bootstrap/examples/`）。
-说明：Cursor **不会**在 `npm install` 时写入 `.cursor/`；`npx figma-cache cursor init` 负责从包内复制模板。`cursor init` 默认**覆盖**同名模板为最新版本（`--force` 可改为保留已有模板并跳过覆盖）；并会下发通用低 token 规则 `00-output-token-budget.mdc`；**`AGENT-SETUP-PROMPT.md` 每次 `cursor init` 均刷新**。
+说明：Cursor **不会**在 `npm install` 时写入 `.cursor/`；`npx figma-cache cursor init` 负责从包内复制模板。`cursor init` 默认**保留**同名模板（安全模式）；使用 `--overwrite` 可覆盖为最新版本；并会下发通用低 token 规则 `00-output-token-budget.mdc`；**`AGENT-SETUP-PROMPT.md` 每次 `cursor init` 均刷新**。
 ## package.json scripts 示例

package/figma-cache/figma-cache.js CHANGED Viewed

@@ -353,7 +353,7 @@ function run() {
     console.log(`  ${ex} flow show --flow=<flowId>`);
     console.log(`  ${ex} flow mermaid --flow=<flowId>`);
     console.log(
-      `${ex} cursor init [--force]  # default: overwrite .cursor templates with latest bootstrap; --force keeps existing templates (skip overwrite)`,
+      `${ex} cursor init [--overwrite] [--force]  # default safe mode; --overwrite forces replacement; --force keeps legacy behavior (no overwrite)`,
     );
     process.exit(1);
   }
@@ -362,12 +362,18 @@ function run() {
     const sub = args[0];
     if (sub !== "init") {
       console.error(
-        "Usage: figma-cache cursor init [--force]  # default overwrite; --force keeps existing templates",
+        "Usage: figma-cache cursor init [--overwrite] [--force]  # --overwrite replaces existing templates; --force keeps legacy no-overwrite behavior",
       );
       process.exit(1);
     }
-    const force = args.includes("--force");
-    copyCursorBootstrap(force, {
+    const hasOverwrite = args.includes("--overwrite");
+    const hasForce = args.includes("--force");
+    if (hasOverwrite && hasForce) {
+      console.error("Do not use --overwrite and --force together. Choose one mode.");
+      process.exit(1);
+    }
+    const overwrite = hasOverwrite;
+    copyCursorBootstrap({ overwrite, legacyForce: hasForce }, {
       fs,
       path,
       ROOT,

package/figma-cache/js/cursor-bootstrap-cli.js CHANGED Viewed

@@ -1,186 +1,218 @@
-/* eslint-disable no-console */
-function readUtf8IfExists(fs, absPath) {
-  if (!fs.existsSync(absPath)) {
-    return "";
-  }
-  return fs.readFileSync(absPath, "utf8");
-}
-function copyCursorBootstrap(force, deps) {
-  const {
-    fs,
-    path,
-    ROOT,
-    CACHE_DIR,
-    CURSOR_BOOTSTRAP_DIR,
-    normalizeSlash,
-    readSelfNpmPackageName,
-    packageDir,
-  } = deps;
-  const pairs = [
-    {
-      from: path.join("rules", "00-output-token-budget.mdc"),
-      to: path.join(".cursor", "rules", "00-output-token-budget.mdc"),
-    },
-    {
-      from: path.join("rules", "01-figma-cache-core.mdc"),
-      to: path.join(".cursor", "rules", "01-figma-cache-core.mdc"),
-    },
-    {
-      from: path.join("rules", "02-figma-stack-adapter.mdc"),
-      to: path.join(".cursor", "rules", "02-figma-stack-adapter.mdc"),
-    },
-    {
-      from: path.join("rules", "figma-local-cache-first.mdc"),
-      to: path.join(".cursor", "rules", "figma-local-cache-first.mdc"),
-    },
-    {
-      from: path.join("skills", "figma-mcp-local-cache", "SKILL.md"),
-      to: path.join(".cursor", "skills", "figma-mcp-local-cache", "SKILL.md"),
-    },
-  ];
-  if (!fs.existsSync(CURSOR_BOOTSTRAP_DIR)) {
-    console.error(
-      `[figma-cache] cursor-bootstrap not found at ${normalizeSlash(CURSOR_BOOTSTRAP_DIR)} (broken package install?)`
-    );
-    process.exit(1);
-  }
-  const overwrite = !force;
-  let copied = 0;
-  let skipped = 0;
-  pairs.forEach(({ from: relFrom, to: relTo }) => {
-    const absFrom = path.join(CURSOR_BOOTSTRAP_DIR, relFrom);
-    const absTo = path.join(ROOT, relTo);
-    if (!fs.existsSync(absFrom)) {
-      console.error(`[figma-cache] missing template file: ${normalizeSlash(absFrom)}`);
-      process.exit(1);
-    }
-    fs.mkdirSync(path.dirname(absTo), { recursive: true });
-    if (fs.existsSync(absTo) && !overwrite) {
-      skipped += 1;
-      return;
-    }
-    fs.copyFileSync(absFrom, absTo);
-    copied += 1;
-  });
-  const configTemplatePath = path.join(CURSOR_BOOTSTRAP_DIR, "figma-cache.config.example.js");
-  const projectConfigPath = path.join(ROOT, "figma-cache.config.js");
-  const legacyExamplePath = path.join(ROOT, "figma-cache.config.example.js");
-  if (!fs.existsSync(configTemplatePath)) {
-    console.error(`[figma-cache] missing template file: ${normalizeSlash(configTemplatePath)}`);
-    process.exit(1);
-  }
-  const hadProjectConfig = fs.existsSync(projectConfigPath);
-  const hadLegacyExample = fs.existsSync(legacyExamplePath);
-  const configTemplateBody = fs.readFileSync(configTemplatePath, "utf8");
-  let configAction = "skipped";
-  let configSource = "existing";
-  if (hadProjectConfig && !force) {
-    configAction = "skipped";
-    configSource = "existing";
-  } else if (!hadProjectConfig && hadLegacyExample && !force) {
-    fs.copyFileSync(legacyExamplePath, projectConfigPath);
-    configAction = "created";
-    configSource = "legacy-example";
-  } else {
-    fs.writeFileSync(projectConfigPath, configTemplateBody, "utf8");
-    configAction = hadProjectConfig ? "overwritten" : "created";
-    configSource = "template";
-  }
-  let legacyExampleStatus = "not-found";
-  if (fs.existsSync(legacyExamplePath)) {
-    const legacyBody = readUtf8IfExists(fs, legacyExamplePath);
-    const projectBody = readUtf8IfExists(fs, projectConfigPath);
-    const sameAsTemplate = legacyBody === configTemplateBody;
-    const sameAsProject = projectBody && legacyBody === projectBody;
-    if (sameAsTemplate || sameAsProject) {
-      fs.unlinkSync(legacyExamplePath);
-      legacyExampleStatus = "deleted";
-    } else {
-      legacyExampleStatus = "kept-customized";
-    }
-  }
-  const agentSrc = path.join(CURSOR_BOOTSTRAP_DIR, "AGENT-SETUP-PROMPT.md");
-  const agentDest = path.join(ROOT, "AGENT-SETUP-PROMPT.md");
-  if (!fs.existsSync(agentSrc)) {
-    console.error(`[figma-cache] missing ${normalizeSlash(agentSrc)}`);
-    process.exit(1);
-  }
-  let agentBody = fs.readFileSync(agentSrc, "utf8");
-  const npmPkg = readSelfNpmPackageName();
-  agentBody = agentBody.replace(/\{\{NPM_PACKAGE_NAME\}\}/g, npmPkg);
-  fs.writeFileSync(agentDest, agentBody, "utf8");
-  const colleagueSrc = path.join(packageDir, "docs", "colleague-guide-zh.md");
-  const colleagueDest = path.join(CACHE_DIR, "docs", "colleague-guide-zh.md");
-  if (!fs.existsSync(colleagueSrc)) {
-    console.error(`[figma-cache] missing ${normalizeSlash(colleagueSrc)} (broken package install?)`);
-    process.exit(1);
-  }
-  const colleagueSameFile = path.resolve(colleagueSrc) === path.resolve(colleagueDest);
-  if (!colleagueSameFile) {
-    fs.mkdirSync(path.dirname(colleagueDest), { recursive: true });
-    fs.copyFileSync(colleagueSrc, colleagueDest);
-  }
-  console.log(
-    JSON.stringify(
-      {
-        ok: true,
-        root: normalizeSlash(ROOT),
-        copied,
-        skipped,
-        force: !!force,
-        overwriteByDefault: overwrite,
-        hint: skipped
-          ? "Some template files were skipped (--force means keep existing files)."
-          : overwrite
-          ? "Done. Existing .cursor templates were overwritten by latest bootstrap."
-          : "Done.",
-        configFile: normalizeSlash(projectConfigPath),
-        configAction,
-        configSource,
-        legacyExampleFile: normalizeSlash(legacyExamplePath),
-        legacyExampleStatus,
-        agentPromptFile: normalizeSlash(agentDest),
-        colleagueGuideFile: normalizeSlash(colleagueDest),
-        colleagueGuideSynced: !colleagueSameFile,
-        colleagueGuideNote: colleagueSameFile
-          ? "colleague-guide-zh.md already at package path (toolchain dev tree); no copy."
-          : "colleague-guide-zh.md refreshed under FIGMA_CACHE_DIR/docs (default figma-cache/docs/).",
-        agentPromptNote:
-          "AGENT-SETUP-PROMPT.md is refreshed every run. Next: @ it in Cursor; after Agent finishes, run npm run figma:cache:init (or npx figma-cache init if scripts are missing).",
-        npmPackageName: npmPkg,
-      },
-      null,
-      2
-    )
-  );
-  console.log(
-    "\n" +
-      "================================================================\n" +
-      "下一步（请按顺序）：\n" +
-      "1) 在 Cursor 对话中输入 @AGENT-SETUP-PROMPT.md，并说明「按该文档执行」\n" +
-      "   （每次 cursor init 都会刷新该文件；无需再整篇粘贴。）\n" +
-      "2) 待 Agent 完成后，在项目根初始化本地缓存索引：\n" +
-      "   npm run figma:cache:init\n" +
-      "   若尚未补全 npm scripts，请改用：npx figma-cache init\n" +
-      "================================================================\n"
-  );
-}
-module.exports = {
-  copyCursorBootstrap,
-};
+/* eslint-disable no-console */
+function readUtf8IfExists(fs, absPath) {
+  if (!fs.existsSync(absPath)) {
+    return "";
+  }
+  return fs.readFileSync(absPath, "utf8");
+}
+function loadManagedManifest({ fs, path, CURSOR_BOOTSTRAP_DIR, normalizeSlash }) {
+  const manifestPath = path.join(CURSOR_BOOTSTRAP_DIR, "managed-files.json");
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`[figma-cache] missing managed files manifest: ${normalizeSlash(manifestPath)}`);
+    process.exit(1);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+  } catch (error) {
+    console.error(`[figma-cache] invalid managed files manifest: ${error.message}`);
+    process.exit(1);
+  }
+  const { managedFiles, retiredFiles } = parsed || {};
+  if (!Array.isArray(managedFiles) || managedFiles.length === 0) {
+    console.error("[figma-cache] managed-files.json must contain non-empty managedFiles");
+    process.exit(1);
+  }
+  const pairs = managedFiles.map((item, index) => {
+    if (!item || typeof item.from !== "string" || typeof item.to !== "string") {
+      console.error(`[figma-cache] invalid managedFiles[${index}] item`);
+      process.exit(1);
+    }
+    return {
+      from: item.from,
+      to: item.to,
+    };
+  });
+  const retired = Array.isArray(retiredFiles)
+    ? retiredFiles.filter((item) => typeof item === "string" && item.trim())
+    : [];
+  return { pairs, retired };
+}
+function copyCursorBootstrap(options, deps) {
+  const {
+    fs,
+    path,
+    ROOT,
+    CACHE_DIR,
+    CURSOR_BOOTSTRAP_DIR,
+    normalizeSlash,
+    readSelfNpmPackageName,
+    packageDir,
+  } = deps;
+  const {
+    overwrite = false,
+    legacyForce = false,
+  } = options || {};
+  const { pairs, retired } = loadManagedManifest({ fs, path, CURSOR_BOOTSTRAP_DIR, normalizeSlash });
+  if (!fs.existsSync(CURSOR_BOOTSTRAP_DIR)) {
+    console.error(
+      `[figma-cache] cursor-bootstrap not found at ${normalizeSlash(CURSOR_BOOTSTRAP_DIR)} (broken package install?)`
+    );
+    process.exit(1);
+  }
+  let copied = 0;
+  let skipped = 0;
+  pairs.forEach(({ from: relFrom, to: relTo }) => {
+    const absFrom = path.join(CURSOR_BOOTSTRAP_DIR, relFrom);
+    const absTo = path.join(ROOT, relTo);
+    if (!fs.existsSync(absFrom)) {
+      console.error(`[figma-cache] missing template file: ${normalizeSlash(absFrom)}`);
+      process.exit(1);
+    }
+    fs.mkdirSync(path.dirname(absTo), { recursive: true });
+    if (fs.existsSync(absTo) && !overwrite) {
+      skipped += 1;
+      return;
+    }
+    fs.copyFileSync(absFrom, absTo);
+    copied += 1;
+  });
+  const retiredDeleted = retired
+    .map((relPath) => {
+      const abs = path.join(ROOT, relPath);
+      if (!fs.existsSync(abs)) {
+        return null;
+      }
+      fs.unlinkSync(abs);
+      return normalizeSlash(relPath);
+    })
+    .filter(Boolean);
+  const configTemplatePath = path.join(CURSOR_BOOTSTRAP_DIR, "figma-cache.config.example.js");
+  const projectConfigPath = path.join(ROOT, "figma-cache.config.js");
+  const legacyExamplePath = path.join(ROOT, "figma-cache.config.example.js");
+  if (!fs.existsSync(configTemplatePath)) {
+    console.error(`[figma-cache] missing template file: ${normalizeSlash(configTemplatePath)}`);
+    process.exit(1);
+  }
+  const hadProjectConfig = fs.existsSync(projectConfigPath);
+  const hadLegacyExample = fs.existsSync(legacyExamplePath);
+  const configTemplateBody = fs.readFileSync(configTemplatePath, "utf8");
+  let configAction = "skipped";
+  let configSource = "existing";
+  if (hadProjectConfig && !overwrite) {
+    configAction = "skipped";
+    configSource = "existing";
+  } else if (!hadProjectConfig && hadLegacyExample && !overwrite) {
+    fs.copyFileSync(legacyExamplePath, projectConfigPath);
+    configAction = "created";
+    configSource = "legacy-example";
+  } else {
+    fs.writeFileSync(projectConfigPath, configTemplateBody, "utf8");
+    configAction = hadProjectConfig ? "overwritten" : "created";
+    configSource = "template";
+  }
+  let legacyExampleStatus = "not-found";
+  if (fs.existsSync(legacyExamplePath)) {
+    const legacyBody = readUtf8IfExists(fs, legacyExamplePath);
+    const projectBody = readUtf8IfExists(fs, projectConfigPath);
+    const sameAsTemplate = legacyBody === configTemplateBody;
+    const sameAsProject = projectBody && legacyBody === projectBody;
+    if (sameAsTemplate || sameAsProject) {
+      fs.unlinkSync(legacyExamplePath);
+      legacyExampleStatus = "deleted";
+    } else {
+      legacyExampleStatus = "kept-customized";
+    }
+  }
+  const agentSrc = path.join(CURSOR_BOOTSTRAP_DIR, "AGENT-SETUP-PROMPT.md");
+  const agentDest = path.join(ROOT, "AGENT-SETUP-PROMPT.md");
+  if (!fs.existsSync(agentSrc)) {
+    console.error(`[figma-cache] missing ${normalizeSlash(agentSrc)}`);
+    process.exit(1);
+  }
+  let agentBody = fs.readFileSync(agentSrc, "utf8");
+  const npmPkg = readSelfNpmPackageName();
+  agentBody = agentBody.replace(/\{\{NPM_PACKAGE_NAME\}\}/g, npmPkg);
+  fs.writeFileSync(agentDest, agentBody, "utf8");
+  const colleagueSrc = path.join(packageDir, "docs", "colleague-guide-zh.md");
+  const colleagueDest = path.join(CACHE_DIR, "docs", "colleague-guide-zh.md");
+  if (!fs.existsSync(colleagueSrc)) {
+    console.error(`[figma-cache] missing ${normalizeSlash(colleagueSrc)} (broken package install?)`);
+    process.exit(1);
+  }
+  const colleagueSameFile = path.resolve(colleagueSrc) === path.resolve(colleagueDest);
+  if (!colleagueSameFile) {
+    fs.mkdirSync(path.dirname(colleagueDest), { recursive: true });
+    fs.copyFileSync(colleagueSrc, colleagueDest);
+  }
+  console.log(
+    JSON.stringify(
+      {
+        ok: true,
+        root: normalizeSlash(ROOT),
+        copied,
+        skipped,
+        overwrite,
+        legacyForce,
+        retiredDeleted,
+        hint: skipped
+          ? "Some template files were skipped (default safe mode keeps existing files)."
+          : overwrite
+          ? "Done. Existing .cursor templates were overwritten by latest bootstrap."
+          : "Done.",
+        configFile: normalizeSlash(projectConfigPath),
+        configAction,
+        configSource,
+        legacyExampleFile: normalizeSlash(legacyExamplePath),
+        legacyExampleStatus,
+        agentPromptFile: normalizeSlash(agentDest),
+        colleagueGuideFile: normalizeSlash(colleagueDest),
+        colleagueGuideSynced: !colleagueSameFile,
+        colleagueGuideNote: colleagueSameFile
+          ? "colleague-guide-zh.md already at package path (toolchain dev tree); no copy."
+          : "colleague-guide-zh.md refreshed under FIGMA_CACHE_DIR/docs (default figma-cache/docs/).",
+        agentPromptNote:
+          "AGENT-SETUP-PROMPT.md is refreshed every run. Next: @ it in Cursor; after Agent finishes, run npm run figma:cache:init (or npx figma-cache init if scripts are missing).",
+        npmPackageName: npmPkg,
+      },
+      null,
+      2
+    )
+  );
+  console.log(
+    "\n" +
+      "================================================================\n" +
+      "下一步（请按顺序）：\n" +
+      "1) 在 Cursor 对话中输入 @AGENT-SETUP-PROMPT.md，并说明「按该文档执行」\n" +
+      "   （每次 cursor init 都会刷新该文件；无需再整篇粘贴。）\n" +
+      "2) 待 Agent 完成后，在项目根初始化本地缓存索引：\n" +
+      "   npm run figma:cache:init\n" +
+      "   若尚未补全 npm scripts，请改用：npx figma-cache init\n" +
+      "================================================================\n"
+  );
+}
+module.exports = {
+  copyCursorBootstrap,
+};

package/package.json CHANGED Viewed

@@ -1,74 +1,75 @@
-{
-  "name": "figma-cache-toolchain",
-  "version": "2.0.1",
-  "description": "Figma link normalization, local cache index, validation, and Node CLI (framework-agnostic core).",
-  "homepage": "https://github.com/907086379/figma-cache-toolchain#readme",
-  "keywords": [
-    "figma",
-    "cache",
-    "cli",
-    "design-tokens",
-    "mcp"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=16.20.0"
-  },
-  "bin": {
-    "figma-cache": "bin/figma-cache.js"
-  },
-  "files": [
-    "LICENSE",
-    "bin",
-    "cursor-bootstrap",
-    "figma-cache/figma-cache.js",
-    "figma-cache/js/flow-cli.js",
-    "figma-cache/js/validate-cli.js",
-    "figma-cache/js/budget-cli.js",
-    "figma-cache/js/index-store.js",
-    "figma-cache/js/cursor-bootstrap-cli.js",
-    "figma-cache/js/entry-files.js",
-    "figma-cache/js/backfill-cli.js",
-    "figma-cache/js/project-config.js",
-    "figma-cache/js/upsert-core.js",
-    "figma-cache/docs/*.md"
-  ],
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "test": "npm run cursor:shadow:check && npm run docs:encoding:check && node tests/rules-guard.js && node tests/smoke.js",
-    "prepack": "npm run cursor:shadow:check && npm run docs:encoding:check && node bin/figma-cache.js validate",
-    "figma:cache:normalize": "node bin/figma-cache.js normalize",
-    "figma:cache:get": "node bin/figma-cache.js get",
-    "figma:cache:upsert": "node bin/figma-cache.js upsert",
-    "figma:cache:ensure": "node bin/figma-cache.js ensure",
-    "figma:cache:validate": "node bin/figma-cache.js validate",
-    "figma:cache:stale": "node bin/figma-cache.js stale",
-    "figma:cache:budget": "node bin/figma-cache.js budget --mcp-only",
-    "figma:cache:backfill": "node bin/figma-cache.js backfill",
-    "figma:cache:init": "node bin/figma-cache.js init",
-    "figma:cache:config": "node bin/figma-cache.js config",
-    "figma:cache:flow:init": "node bin/figma-cache.js flow init",
-    "figma:cache:flow:add-node": "node bin/figma-cache.js flow add-node",
-    "figma:cache:flow:link": "node bin/figma-cache.js flow link",
-    "figma:cache:flow:chain": "node bin/figma-cache.js flow chain",
-    "figma:cache:flow:show": "node bin/figma-cache.js flow show",
-    "figma:cache:flow:mermaid": "node bin/figma-cache.js flow mermaid",
-    "figma:cache:cursor:init": "node bin/figma-cache.js cursor init",
-    "cursor:shadow:sync": "node scripts/sync-cursor-shadow.js",
-    "cursor:shadow:check": "node scripts/check-cursor-shadow.js",
-    "docs:encoding:check": "node scripts/check-doc-encoding.js",
-    "figma:cache:mobile:spec": "node scripts/mobile/generate-mobile-spec.js"
-  },
-  "volta": {
-    "node": "16.20.2"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/907086379/figma-cache-toolchain.git"
-  },
-  "bugs": {
-    "url": "https://github.com/907086379/figma-cache-toolchain/issues"
-  }
-}
+{
+  "name": "figma-cache-toolchain",
+  "version": "2.0.3",
+  "description": "Figma link normalization, local cache index, validation, and Node CLI (framework-agnostic core).",
+  "homepage": "https://github.com/907086379/figma-cache-toolchain#readme",
+  "keywords": [
+    "figma",
+    "cache",
+    "cli",
+    "design-tokens",
+    "mcp"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.20.0"
+  },
+  "bin": {
+    "figma-cache": "bin/figma-cache.js"
+  },
+  "files": [
+    "LICENSE",
+    "bin",
+    "cursor-bootstrap",
+    "figma-cache/figma-cache.js",
+    "figma-cache/js/flow-cli.js",
+    "figma-cache/js/validate-cli.js",
+    "figma-cache/js/budget-cli.js",
+    "figma-cache/js/index-store.js",
+    "figma-cache/js/cursor-bootstrap-cli.js",
+    "figma-cache/js/entry-files.js",
+    "figma-cache/js/backfill-cli.js",
+    "figma-cache/js/project-config.js",
+    "figma-cache/js/upsert-core.js",
+    "figma-cache/docs/*.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "npm run cursor:shadow:check && npm run docs:encoding:check && node tests/rules-guard.js && node tests/smoke.js",
+    "prepack": "npm run cursor:shadow:check && npm run docs:encoding:check && node bin/figma-cache.js validate",
+    "figma:cache:normalize": "node bin/figma-cache.js normalize",
+    "figma:cache:get": "node bin/figma-cache.js get",
+    "figma:cache:upsert": "node bin/figma-cache.js upsert",
+    "figma:cache:ensure": "node bin/figma-cache.js ensure",
+    "figma:cache:validate": "node bin/figma-cache.js validate",
+    "figma:cache:stale": "node bin/figma-cache.js stale",
+    "figma:cache:budget": "node bin/figma-cache.js budget --mcp-only",
+    "figma:cache:backfill": "node bin/figma-cache.js backfill",
+    "figma:cache:init": "node bin/figma-cache.js init",
+    "figma:cache:config": "node bin/figma-cache.js config",
+    "figma:cache:flow:init": "node bin/figma-cache.js flow init",
+    "figma:cache:flow:add-node": "node bin/figma-cache.js flow add-node",
+    "figma:cache:flow:link": "node bin/figma-cache.js flow link",
+    "figma:cache:flow:chain": "node bin/figma-cache.js flow chain",
+    "figma:cache:flow:show": "node bin/figma-cache.js flow show",
+    "figma:cache:flow:mermaid": "node bin/figma-cache.js flow mermaid",
+    "figma:cache:cursor:init": "node bin/figma-cache.js cursor init",
+    "cursor:shadow:sync": "node scripts/sync-cursor-shadow.js",
+    "cursor:shadow:check": "node scripts/check-cursor-shadow.js",
+    "docs:encoding:check": "node scripts/check-doc-encoding.js",
+    "figma:cache:mobile:spec": "node scripts/mobile/generate-mobile-spec.js",
+    "figma:ui:gate": "npm run figma:cache:validate && npm run cursor:shadow:check && npm test"
+  },
+  "volta": {
+    "node": "16.20.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/907086379/figma-cache-toolchain.git"
+  },
+  "bugs": {
+    "url": "https://github.com/907086379/figma-cache-toolchain/issues"
+  }
+}