@nick848/fet 1.1.7 → 1.1.8

package/dist/cli/index.js

@@ -188,18 +188,18 @@ function toGitNexusState(detection, previous) {
   };
 }
 async function inspectGitNexusGraph(projectRoot, env = process.env) {
-  const relative4 = env.FET_GITNEXUS_GRAPH_PATH?.trim() || DEFAULT_GRAPH_PATH;
-  const graphPath = join5(projectRoot, relative4);
+  const relative5 = env.FET_GITNEXUS_GRAPH_PATH?.trim() || DEFAULT_GRAPH_PATH;
+  const graphPath = join5(projectRoot, relative5);
   try {
     const info = await stat2(graphPath);
     return {
-      graphPath: relative4,
+      graphPath: relative5,
       graphExists: true,
       lastIndexedAt: info.mtime.toISOString()
     };
   } catch {
     return {
-      graphPath: relative4,
+      graphPath: relative5,
       graphExists: false,
       lastIndexedAt: null
     };
@@ -2082,7 +2082,17 @@ function renderFetConfig(scan, language = "zh-CN") {
       },
       figmaGuard: {
         enabled: true,
+        mode: "require_before_ui",
         onUncertainty: "stop_and_ask"
+      },
+      uiDisplayContract: {
+        enabled: true
+      },
+      specLanguage: {
+        style: "layered_bilingual",
+        canonical: "en",
+        notesLocale: "zh-CN",
+        maintainZhNotesOnUpdate: true
       }
     }
   });
@@ -2248,6 +2258,75 @@ var FIGMA_URL_PATTERN = /https?:\/\/(?:www\.)?figma\.com\/(?:file|design|proto)\
 function figmaStopHandoffRelativePath(changeId) {
   return `openspec/changes/${changeId}/.fet/figma-stop.md`;
 }
+function figmaApplyInstructionsRelativePath(changeId) {
+  return `openspec/changes/${changeId}/.fet/figma-apply-instructions.md`;
+}
+function renderFigmaRequireBeforeUiBody(language, changeId) {
+  const stopPath = figmaStopHandoffRelativePath(changeId);
+  if (language === "en") {
+    return `## Mandatory before any UI implementation
+
+Complete these steps **before** writing or editing UI code (components, pages, styles, layout):
+
+1. Read \`${stopPath}\` for detected Figma links and stop rules.
+2. Use **Figma MCP/API** (or an approved Figma tool) to read every linked frame/node referenced by this change.
+3. In your reply, briefly list design facts you confirmed from Figma (frames, colors, typography, spacing, components, states).
+4. Only then implement UI tasks from \`tasks.md\`.
+
+## Forbidden
+
+- Implementing or restyling UI without reading Figma when this change references design links
+- Filling gaps with "common UI patterns", guessed pixel values, or invented tokens
+- Marking UI tasks complete while design input is still unclear
+
+## When to stop and talk to the user
+
+Follow the stop rules in \`${stopPath}\`. Pause implementation, explain what failed, and ask for a viewable link, screenshots, or explicit permission to infer\u2014do not continue UI work until the user answers or says to continue.`;
+  }
+  return `## \u5B9E\u65BD\u4EFB\u4F55 UI \u4EE3\u7801\u4E4B\u524D\u5FC5\u987B\u5B8C\u6210
+
+\u5728\u7F16\u5199\u6216\u4FEE\u6539 UI \u4EE3\u7801\uFF08\u7EC4\u4EF6\u3001\u9875\u9762\u3001\u6837\u5F0F\u3001\u5E03\u5C40\uFF09**\u4E4B\u524D**\uFF0C\u6309\u987A\u5E8F\u5B8C\u6210\uFF1A
+
+1. \u9605\u8BFB \`${stopPath}\` \u4E2D\u7684 Figma \u94FE\u63A5\u4E0E\u505C\u6B62\u89C4\u5219\u3002
+2. \u4F7F\u7528 **Figma MCP/API**\uFF08\u6216\u5DF2\u914D\u7F6E\u7684 Figma \u5DE5\u5177\uFF09\u8BFB\u53D6\u672C change \u5F15\u7528\u7684\u6BCF\u4E2A\u753B\u677F/\u8282\u70B9\u3002
+3. \u5728\u56DE\u590D\u4E2D\u7B80\u8981\u5217\u51FA\u5DF2\u4ECE Figma \u786E\u8BA4\u7684\u8BBE\u8BA1\u4E8B\u5B9E\uFF08\u753B\u677F\u3001\u989C\u8272\u3001\u5B57\u53F7\u3001\u95F4\u8DDD\u3001\u7EC4\u4EF6\u3001\u72B6\u6001\u7B49\uFF09\u3002
+4. \u5B8C\u6210\u4EE5\u4E0A\u6B65\u9AA4\u540E\uFF0C\u518D\u6309 \`tasks.md\` \u5B9E\u65BD UI \u4EFB\u52A1\u3002
+
+## \u7981\u6B62
+
+- \u672C change \u5DF2\u5F15\u7528\u8BBE\u8BA1\u7A3F\u65F6\uFF0C\u672A\u8BFB Figma \u5C31\u5B9E\u73B0\u6216\u6539 UI \u6837\u5F0F
+- \u7528\u300C\u5E38\u89C1 UI \u505A\u6CD5\u300D\u3001\u731C\u6D4B\u7684\u50CF\u7D20\u503C\u6216\u81EA\u521B token \u586B\u8865\u7A7A\u767D
+- \u8BBE\u8BA1\u8F93\u5165\u4ECD\u4E0D\u6E05\u6670\u5C31\u628A UI \u4EFB\u52A1\u6807\u4E3A\u5B8C\u6210
+
+## \u4F55\u65F6\u5FC5\u987B\u505C\u4E0B\u5E76\u4E0E\u7528\u6237\u6C9F\u901A
+
+\u9075\u5B88 \`${stopPath}\` \u4E2D\u7684\u505C\u6B62\u89C4\u5219\u3002\u6682\u505C\u5B9E\u65BD\uFF0C\u8BF4\u660E\u5361\u5728\u54EA\u4E00\u6B65\uFF0C\u5411\u7528\u6237\u7D22\u8981\u53EF\u67E5\u770B\u7684\u94FE\u63A5\u3001\u622A\u56FE\uFF0C\u6216\u660E\u786E\u5141\u8BB8\u6309\u67D0\u89C4\u5219\u63A8\u65AD\uFF1B\u5728\u7528\u6237\u56DE\u7B54\u6216\u660E\u786E\u8868\u793A\u7EE7\u7EED\u4E4B\u524D\uFF0C\u4E0D\u8981\u7EE7\u7EED UI \u5B9E\u73B0\u3002`;
+}
+function renderChangeFigmaApplyInstructions(options) {
+  const linkList = options.urls.map((url) => `- ${url}`).join("\n");
+  const title = options.language === "en" ? "Figma apply gate (this change)" : "Figma \u5B9E\u65BD\u95E8\u7981\uFF08\u672C change\uFF09";
+  const intro = options.language === "en" ? "FET detected Figma links in this change. **UI work must follow the design**\u2014read Figma first, do not invent styles. If access or design details fail, stop and coordinate with the user." : "FET \u5728\u672C change \u4E2D\u68C0\u6D4B\u5230 Figma \u94FE\u63A5\u3002**UI \u5FC5\u987B\u6309\u8BBE\u8BA1\u7A3F\u5B9E\u73B0**\u2014\u5148\u8BFB Figma\uFF0C\u7981\u6B62\u81EA\u521B\u6837\u5F0F\uFF1B\u8BBF\u95EE\u5931\u8D25\u6216\u7EC6\u8282\u4E0D\u6E05\u65F6\u505C\u4E0B\u5E76\u4E0E\u7528\u6237\u6C9F\u901A\u3002";
+  return `---
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generatedAt: ${options.generatedAt}
+changeId: ${options.changeId}
+purpose: figma-apply
+---
+
+# ${title}
+
+${intro}
+
+## Detected Figma links
+
+${linkList}
+
+${renderFigmaRequireBeforeUiBody(options.language, options.changeId)}
+
+${renderFigmaStopProtocolBody(options.language)}
+`;
+}
 function renderFigmaStopProtocolBody(language) {
   if (language === "en") {
     return `## Stop immediately (do not write or change UI code) when
@@ -2306,7 +2385,7 @@ ${language === "en" ? "Apply when the user shares a Figma link, asks to implemen
 
 ${renderFigmaStopProtocolBody(language)}
 
-${language === "en" ? "If this change has `openspec/changes/<change-id>/.fet/figma-stop.md`, read it for detected links and repeat the same stop rules." : "\u82E5\u5F53\u524D change \u5B58\u5728 `openspec/changes/<change-id>/.fet/figma-stop.md`\uFF0C\u8BF7\u5148\u9605\u8BFB\u5176\u4E2D\u7684\u94FE\u63A5\u5217\u8868\uFF0C\u5E76\u9075\u5B88\u76F8\u540C\u7684\u505C\u6B62\u89C4\u5219\u3002"}
+${language === "en" ? "If this change has `openspec/changes/<change-id>/.fet/figma-apply-instructions.md`, follow it before UI work. Also read `figma-stop.md` in the same folder for links and stop rules." : "\u82E5\u5F53\u524D change \u5B58\u5728 `openspec/changes/<change-id>/.fet/figma-apply-instructions.md`\uFF0C\u5B9E\u65BD UI \u524D\u5FC5\u987B\u9075\u5B88\uFF1B\u540C\u76EE\u5F55\u7684 `figma-stop.md` \u542B\u94FE\u63A5\u5217\u8868\u4E0E\u505C\u6B62\u89C4\u5219\u3002"}
 `;
 }
 function renderCodexFigmaStopGuide(language) {
@@ -2354,6 +2433,303 @@ function renderFigmaStopNextStep(changeId, language) {
   const path = figmaStopHandoffRelativePath(changeId);
   return language === "en" ? `Before UI implementation, read ${path}. If Figma access fails or design details are unclear, stop and ask the user\u2014do not guess styles.` : `\u5B9E\u65BD UI \u524D\u9605\u8BFB ${path}\u3002Figma \u8BBF\u95EE\u5931\u8D25\u6216\u8BBE\u8BA1\u7EC6\u8282\u4E0D\u660E\u786E\u65F6\u7ACB\u5373\u505C\u6B62\u5E76\u5411\u7528\u6237\u63D0\u95EE\uFF0C\u4E0D\u8981\u731C\u6D4B\u6837\u5F0F\u3002`;
 }
+function renderFigmaApplyNextSteps(changeId, language, mode) {
+  const applyPath = figmaApplyInstructionsRelativePath(changeId);
+  const stopPath = figmaStopHandoffRelativePath(changeId);
+  if (mode === "require_before_ui") {
+    return language === "en" ? [
+      `Before any UI task: read and follow ${applyPath} (mandatory). Use Figma MCP/API for every linked frame\u2014do not invent styles.`,
+      `If Figma access fails or design details are unclear, stop per ${stopPath} and ask the user before continuing.`,
+      `After Figma is confirmed, read openspec/changes/${changeId}/tasks.md and implement pending tasks.`
+    ] : [
+      `\u5B9E\u65BD\u4EFB\u4F55 UI \u4EFB\u52A1\u524D\uFF1A\u5FC5\u987B\u9605\u8BFB\u5E76\u9075\u5B88 ${applyPath}\uFF1B\u7528 Figma MCP/API \u8BFB\u53D6\u6BCF\u4E2A\u94FE\u63A5\u7684\u753B\u677F\uFF0C\u7981\u6B62\u81EA\u521B\u6837\u5F0F\u3002`,
+      `Figma \u8BBF\u95EE\u5931\u8D25\u6216\u8BBE\u8BA1\u7EC6\u8282\u4E0D\u6E05\uFF1A\u6309 ${stopPath} \u7ACB\u5373\u505C\u6B62\u5E76\u5411\u7528\u6237\u63D0\u95EE\uFF0C\u786E\u8BA4\u540E\u518D\u7EE7\u7EED\u3002`,
+      `\u8BBE\u8BA1\u786E\u8BA4\u540E\uFF0C\u518D\u9605\u8BFB openspec/changes/${changeId}/tasks.md \u5E76\u5B9E\u65BD\u5F85\u529E\u4EFB\u52A1\u3002`
+    ];
+  }
+  return [renderFigmaStopNextStep(changeId, language)];
+}
+
+// src/templates/ui-display-contract.ts
+import { stringify as stringify2 } from "yaml";
+function uiDisplayContractRelativePath(changeId) {
+  return `openspec/changes/${changeId}/.fet/ui-display-contract.yaml`;
+}
+function uiFieldApplyInstructionsRelativePath(changeId) {
+  return `openspec/changes/${changeId}/.fet/ui-field-apply-instructions.md`;
+}
+function renderUiDisplayContractYaml(doc) {
+  return stringify2(doc);
+}
+function renderUiFieldApplyInstructions(options) {
+  const title = options.language === "en" ? "UI field apply gate (this change)" : "UI \u5B57\u6BB5\u5B9E\u65BD\u95E8\u7981\uFF08\u672C change\uFF09";
+  const intro = options.language === "en" ? "FET generated a **UI display contract** draft. API docs are a superset; **only fields listed under `displayFields` may appear in the UI**. Figma defines what is visible; the contract records the binding." : "FET \u5DF2\u751F\u6210 **UI \u5C55\u793A\u5951\u7EA6** \u8349\u6848\u3002\u63A5\u53E3\u6587\u6863\u662F\u8D85\u96C6\uFF1B**\u53EA\u6709 `displayFields` \u4E2D\u7684\u5B57\u6BB5\u5141\u8BB8\u51FA\u73B0\u5728\u754C\u9762\u4E0A**\u3002Figma \u51B3\u5B9A\u53EF\u89C1\u6027\uFF1B\u5951\u7EA6\u8BB0\u5F55\u7ED1\u5B9A\u5173\u7CFB\u3002";
+  const steps = options.language === "en" ? `## Before binding API data to UI
+
+1. Read and update \`${options.contractPath}\` (confirm or fill \`displayFields\` per screen).
+2. ${options.hasFigma ? "Use Figma MCP/API to list visible labels, columns, and form fields; map them to API field names in `displayFields`." : "Infer visible fields from design artifacts in this change; document them in `displayFields`."}
+3. Move API fields that exist in docs but are **not** on the design into \`omittedFromUi\` (or \`hiddenButUsed\` if needed for logic without rendering).
+4. Resolve every entry in \`needsReview\` with the user before implementation.
+
+## Forbidden
+
+- Rendering every property from an API response type because it appears in OpenAPI/Swagger
+- Using \`Object.keys(data)\`, schema iteration, or generic "show all fields" table/form generators for user-facing UI
+- Adding columns or form inputs for fields not in \`displayFields\` unless the user explicitly expands the contract
+
+## Data vs presentation
+
+- **Data layer**: types, fetch, normalize may use the full API model.
+- **Presentation layer**: bind only \`displayFields\`; never surface \`omittedFromUi\` fields in lists, forms, cards, or detail views.` : `## \u5C06 API \u6570\u636E\u7ED1\u5B9A\u5230 UI \u4E4B\u524D
+
+1. \u9605\u8BFB\u5E76\u66F4\u65B0 \`${options.contractPath}\`\uFF08\u6309\u5C4F\u786E\u8BA4\u6216\u586B\u5199 \`displayFields\`\uFF09\u3002
+2. ${options.hasFigma ? "\u7528 Figma MCP/API \u5217\u51FA\u53EF\u89C1\u6587\u6848\u3001\u8868\u683C\u5217\u3001\u8868\u5355\u9879\uFF1B\u6620\u5C04\u5230 API \u5B57\u6BB5\u540D\u5E76\u5199\u5165 `displayFields`\u3002" : "\u4ECE\u672C change \u7684\u8BBE\u8BA1\u4EA7\u7269\u63A8\u65AD\u53EF\u89C1\u5B57\u6BB5\uFF0C\u5199\u5165 `displayFields`\u3002"}
+3. \u63A5\u53E3\u6587\u6863\u6709\u3001\u8BBE\u8BA1\u7A3F**\u6CA1\u6709**\u7684\u5B57\u6BB5\u653E\u5165 \`omittedFromUi\`\uFF08\u4EC5\u903B\u8F91\u4F7F\u7528\u4E14\u4E0D\u53EF\u89C1\u5219\u653E\u5165 \`hiddenButUsed\`\uFF09\u3002
+4. \`needsReview\` \u4E2D\u6BCF\u4E00\u9879\u987B\u5728\u5B9E\u65BD\u524D\u4E0E\u7528\u6237\u786E\u8BA4\u3002
+
+## \u7981\u6B62
+
+- \u56E0 OpenAPI/Swagger \u91CC\u6709\u5B57\u6BB5\u5C31\u5728\u9875\u9762\u4E0A\u5168\u90E8\u5C55\u793A
+- \u5BF9\u7528\u6237\u53EF\u89C1 UI \u4F7F\u7528 \`Object.keys(data)\`\u3001\u904D\u5386 schema \u6216\u300C\u81EA\u52A8\u5C55\u793A\u5168\u90E8\u5B57\u6BB5\u300D\u7684\u8868\u683C/\u8868\u5355
+- \u5728 \`displayFields\` \u672A\u5217\u5165\u65F6\u65B0\u589E\u5217\u3001\u8868\u5355\u9879\uFF08\u9664\u975E\u7528\u6237\u660E\u786E\u6269\u5C55\u5951\u7EA6\uFF09
+
+## \u6570\u636E\u5C42\u4E0E\u5C55\u793A\u5C42
+
+- **\u6570\u636E\u5C42**\uFF1A\u7C7B\u578B\u3001\u8BF7\u6C42\u3001normalize \u53EF\u4F7F\u7528\u5B8C\u6574 API \u6A21\u578B\u3002
+- **\u5C55\u793A\u5C42**\uFF1A\u53EA\u7ED1\u5B9A \`displayFields\`\uFF1B\`omittedFromUi\` \u4E2D\u7684\u5B57\u6BB5\u4E0D\u5F97\u51FA\u73B0\u5728\u5217\u8868\u3001\u8868\u5355\u3001\u5361\u7247\u3001\u8BE6\u60C5\u7B49\u53EF\u89C1\u533A\u57DF\u3002`;
+  return `---
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generatedAt: ${options.generatedAt}
+changeId: ${options.changeId}
+purpose: ui-field-apply
+---
+
+# ${title}
+
+${intro}
+
+${steps}
+`;
+}
+function renderUiDisplayContractApplyNextSteps(changeId, language) {
+  const contractPath = uiDisplayContractRelativePath(changeId);
+  const applyPath = uiFieldApplyInstructionsRelativePath(changeId);
+  if (language === "en") {
+    return [
+      `Read and confirm ${contractPath} before UI that binds API data (update displayFields from Figma; move extras to omittedFromUi).`,
+      `Follow ${applyPath}: API schema is not a UI checklist\u2014do not render undocumented fields.`,
+      `After the contract is confirmed, implement tasks from openspec/changes/${changeId}/tasks.md.`
+    ];
+  }
+  return [
+    `\u5728\u7ED1\u5B9A API \u7684 UI \u5B9E\u65BD\u524D\uFF1A\u9605\u8BFB\u5E76\u786E\u8BA4 ${contractPath}\uFF08\u6309 Figma \u586B\u5199 displayFields\uFF1B\u591A\u4F59\u5B57\u6BB5\u653E\u5165 omittedFromUi\uFF09\u3002`,
+    `\u9075\u5B88 ${applyPath}\uFF1A\u63A5\u53E3\u6587\u6863\u4E0D\u662F UI \u6E05\u5355\uFF0C\u7981\u6B62\u5C55\u793A\u5951\u7EA6\u672A\u5217\u51FA\u7684\u5B57\u6BB5\u3002`,
+    `\u5951\u7EA6\u786E\u8BA4\u540E\uFF0C\u518D\u5B9E\u65BD openspec/changes/${changeId}/tasks.md \u4E2D\u7684\u4EFB\u52A1\u3002`
+  ];
+}
+function renderUiDisplayContractGuardrail(language) {
+  if (language === "en") {
+    return "- When a change has API docs and UI (especially with Figma), read `openspec/changes/<change-id>/.fet/ui-display-contract.yaml`. In `specs/**/spec.md`, add the UI display contract Requirement (see planning guide); API fields not in `displayFields` MUST NOT be rendered.";
+  }
+  return "- change \u542B\u63A5\u53E3\u6587\u6863\u4E14\u6D89\u53CA UI\uFF08\u5C24\u5176\u6709 Figma\uFF09\u65F6\uFF0C\u9605\u8BFB `openspec/changes/<change-id>/.fet/ui-display-contract.yaml`\uFF1B\u5728 `specs/**/spec.md` \u4E2D\u5199\u5165 UI \u5C55\u793A\u5951\u7EA6 Requirement\uFF08\u89C1\u89C4\u5212\u6307\u5F15\uFF09\uFF1B\u672A\u5217\u5165 `displayFields` \u7684\u63A5\u53E3\u5B57\u6BB5\u7981\u6B62\u51FA\u73B0\u5728\u754C\u9762\u4E0A\u3002";
+}
+function renderPlanningArtifactUiContractBlock(language, changeId) {
+  const contractPath = uiDisplayContractRelativePath(changeId);
+  if (language === "en") {
+    return `## UI display contract (when API + UI)
+
+If this change renders API-backed UI (especially with Figma links), \`${contractPath}\` may exist or will be generated on \`fet apply\`. When writing \`specs/<capability>/spec.md\`, **add** this requirement (adjust screen ids as needed):
+
+\`\`\`markdown
+### Requirement: UI displays only contracted fields
+<!-- \u4E2D\u6587\uFF1A\u754C\u9762\u53EA\u5C55\u793A ui-display-contract.yaml \u4E2D displayFields \u5217\u51FA\u7684\u5B57\u6BB5\uFF1B\u63A5\u53E3\u6587\u6863\u5176\u4F59\u5B57\u6BB5\u4EC5\u7528\u4E8E\u7C7B\u578B/\u6570\u636E\u5C42\uFF0C\u4E0D\u5F97\u51FA\u73B0\u5728\u5217\u8868\u3001\u8868\u5355\u3001\u8BE6\u60C5\u7B49\u53EF\u89C1 UI -->
+
+The UI SHALL only render fields listed under \`displayFields\` for each screen in \`${contractPath}\`.
+Fields documented in API/OpenAPI but absent from the design MUST be listed under \`omittedFromUi\` and MUST NOT appear in user-visible UI.
+The system MAY use \`hiddenButUsed\` fields in logic without displaying them.
+On conflict between API schema completeness and Figma/contract, **Figma + ui-display-contract win** for presentation.
+\`\`\`
+
+Update \`displayFields\` / \`omittedFromUi\` in the contract in the **same edit** when requirements change.`;
+  }
+  return `## UI \u5C55\u793A\u5951\u7EA6\uFF08\u63A5\u53E3 + UI \u65F6\uFF09
+
+\u82E5\u672C change \u5B9E\u65BD\u7ED1\u5B9A\u63A5\u53E3\u7684 UI\uFF08\u5C24\u5176\u542B Figma \u94FE\u63A5\uFF09\uFF0C\`${contractPath}\` \u53EF\u80FD\u5DF2\u5B58\u5728\u6216\u5728 \`fet apply\` \u65F6\u751F\u6210\u3002\u7F16\u5199 \`specs/<capability>/spec.md\` \u65F6**\u5FC5\u987B\u52A0\u5165**\u5982\u4E0B Requirement\uFF08\u6309\u5B9E\u9645 screen \u8C03\u6574\uFF09\uFF1A
+
+\`\`\`markdown
+### Requirement: UI displays only contracted fields
+<!-- \u4E2D\u6587\uFF1A\u754C\u9762\u53EA\u5C55\u793A ui-display-contract.yaml \u4E2D displayFields \u5217\u51FA\u7684\u5B57\u6BB5\uFF1B\u63A5\u53E3\u6587\u6863\u5176\u4F59\u5B57\u6BB5\u4EC5\u7528\u4E8E\u7C7B\u578B/\u6570\u636E\u5C42\uFF0C\u4E0D\u5F97\u51FA\u73B0\u5728\u5217\u8868\u3001\u8868\u5355\u3001\u8BE6\u60C5\u7B49\u53EF\u89C1 UI -->
+
+The UI SHALL only render fields listed under \`displayFields\` for each screen in \`${contractPath}\`.
+Fields documented in API/OpenAPI but absent from the design MUST be listed under \`omittedFromUi\` and MUST NOT appear in user-visible UI.
+The system MAY use \`hiddenButUsed\` fields in logic without displaying them.
+On conflict between API schema completeness and Figma/contract, **Figma + ui-display-contract win** for presentation.
+\`\`\`
+
+\u4FEE\u6539 Requirement \u65F6\uFF0C**\u540C\u4E00\u6B21\u7F16\u8F91**\u987B\u540C\u6B65\u66F4\u65B0\u5951\u7EA6\u4E2D\u7684 \`displayFields\` / \`omittedFromUi\`\u3002`;
+}
+function renderCursorUiDisplayContractRule(language) {
+  const description = language === "en" ? "UI display contract: API schemas are not UI checklists; only displayFields may render" : "UI \u5C55\u793A\u5951\u7EA6\uFF1A\u63A5\u53E3\u6587\u6863\u4E0D\u662F UI \u6E05\u5355\uFF0C\u4EC5 displayFields \u53EF\u5C55\u793A";
+  return `<!-- FET:MANAGED
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generator: cursor-adapter
+adapterVersion: 1
+FET:END -->
+
+---
+description: ${description}
+alwaysApply: false
+---
+
+${language === "en" ? "Apply when implementing UI that binds API responses, or when `openspec/changes/<change-id>/.fet/ui-display-contract.yaml` exists." : "\u5728\u5B9E\u65BD\u7ED1\u5B9A\u63A5\u53E3\u54CD\u5E94\u7684 UI \u65F6\uFF0C\u6216\u5B58\u5728 `openspec/changes/<change-id>/.fet/ui-display-contract.yaml` \u65F6\u9002\u7528\u3002"}
+
+${renderUiDisplayContractGuardrail(language)}
+
+${language === "en" ? "Also read `ui-field-apply-instructions.md` in the same `.fet/` folder before UI work." : "\u5B9E\u65BD UI \u524D\u540C\u65F6\u9605\u8BFB\u540C\u76EE\u5F55 `.fet/ui-field-apply-instructions.md`\u3002"}
+`;
+}
+function renderCodexUiDisplayContractGuide(language) {
+  return `<!-- FET:MANAGED
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generator: codex-adapter
+adapterVersion: 1
+FET:END -->
+
+# UI display contract (Codex)
+
+${renderUiDisplayContractGuardrail(language)}
+
+${language === "en" ? "Read `openspec/changes/<change-id>/.fet/ui-display-contract.yaml` and `ui-field-apply-instructions.md` when applying UI tasks that use API data." : "\u5BF9\u4F7F\u7528\u63A5\u53E3\u6570\u636E\u7684 UI \u4EFB\u52A1\uFF0C\u9605\u8BFB `openspec/changes/<change-id>/.fet/ui-display-contract.yaml` \u4E0E `ui-field-apply-instructions.md`\u3002"}
+`;
+}
+
+// src/templates/spec-language.ts
+function renderSpecArtifactGuardrail(language) {
+  if (language === "en") {
+    return "- When creating or editing `openspec/changes/<change-id>/specs/**/spec.md` (or merging into `openspec/specs/**/spec.md`), keep English Requirements/Scenario headings and normative text; add or update the paired `<!-- \u4E2D\u6587\uFF1A... -->` note on the same edit\u2014never leave stale Chinese notes.";
+  }
+  return "- \u521B\u5EFA\u6216\u4FEE\u6539 `openspec/changes/<change-id>/specs/**/spec.md`\uFF08\u6216\u5408\u5E76\u5230 `openspec/specs/**/spec.md`\uFF09\u65F6\uFF1ARequirements/Scenario \u6807\u9898\u4E0E normative \u53E5\u4FDD\u6301\u82F1\u6587\uFF1B**\u540C\u4E00\u6B21\u7F16\u8F91**\u5FC5\u987B\u65B0\u589E\u6216\u66F4\u65B0\u5BF9\u5E94\u7684 `<!-- \u4E2D\u6587\uFF1A... -->` \u8BF4\u660E\uFF0C\u7981\u6B62\u7559\u4E0B\u8FC7\u65F6\u4E2D\u6587\u6CE8\u91CA\u3002";
+}
+function renderSpecLanguagePolicyBody(language) {
+  if (language === "en") {
+    return `## Layered bilingual spec (canonical English + Chinese notes)
+
+This project uses **layered_bilingual** OpenSpec specs (see \`fet.specLanguage\` in \`openspec/config.yaml\`).
+
+### Structure
+
+- **English (canonical)**: Keep OpenSpec section titles (\`## Requirements\`, \`### Requirement:\`, \`#### Scenario:\`) and normative sentences (SHALL/MUST, acceptance criteria) in English.
+- **Chinese (human notes)**: Immediately after each \`### Requirement:\` line (before the English body), add one HTML comment:
+
+\`\`\`markdown
+### Requirement: User can export report
+<!-- \u4E2D\u6587\uFF1A\u767B\u5F55\u7528\u6237\u53EF\u5728\u62A5\u8868\u9875\u5BFC\u51FA PDF\uFF1B\u9700\u5177\u5907 export \u6743\u9650\uFF1B\u5931\u8D25\u65F6\u63D0\u793A\u539F\u56E0 -->
+
+The system SHALL ...
+\`\`\`
+
+Optionally add \`<!-- \u4E2D\u6587\uFF1A... -->\` after \`#### Scenario:\` when the scenario needs extra business context.
+
+### When creating or updating specs
+
+- **Same edit rule**: Any change to English normative text MUST update the paired Chinese comment in the **same** commit/edit session.
+- **Do not** remove Chinese notes when refactoring English unless the requirement was removed.
+- **Do not** let Chinese notes contradict English; if they disagree, fix both or ask the user. **On conflict, English Requirements win.**
+- **proposal.md** / **design.md** may be Chinese; **tasks.md** may be Chinese with English identifiers.
+
+### Applies to
+
+- \`fet propose\`, \`fet continue\`, \`fet ff\` artifact writes
+- Manual edits to spec files in chat
+- \`fet sync\` merges into \`openspec/specs/**/spec.md\` (preserve or refresh Chinese notes for touched requirements)`;
+  }
+  return `## \u5206\u5C42\u53CC\u8BED spec\uFF08\u82F1\u6587\u89C4\u8303 + \u4E2D\u6587\u8BF4\u660E\uFF09
+
+\u672C\u9879\u76EE OpenSpec spec \u91C7\u7528 **layered_bilingual**\uFF08\u89C1 \`openspec/config.yaml\` \u7684 \`fet.specLanguage\`\uFF09\u3002
+
+### \u7ED3\u6784
+
+- **\u82F1\u6587\uFF08\u6743\u5A01\uFF09**\uFF1A\u4FDD\u7559 OpenSpec \u7AE0\u8282\u6807\u9898\uFF08\`## Requirements\`\u3001\`### Requirement:\`\u3001\`#### Scenario:\`\uFF09\u4E0E normative \u8BED\u53E5\uFF08SHALL/MUST\u3001\u9A8C\u6536\u6761\u4EF6\uFF09\u3002
+- **\u4E2D\u6587\uFF08\u7ED9\u4EBA\u8BFB\uFF09**\uFF1A\u5728\u6BCF\u4E2A \`### Requirement:\` \u6807\u9898\u884C\u4E4B\u540E\u3001\u82F1\u6587\u6B63\u6587\u4E4B\u524D\uFF0C\u6DFB\u52A0\u4E00\u6761 HTML \u6CE8\u91CA\uFF1A
+
+\`\`\`markdown
+### Requirement: User can export report
+<!-- \u4E2D\u6587\uFF1A\u767B\u5F55\u7528\u6237\u53EF\u5728\u62A5\u8868\u9875\u5BFC\u51FA PDF\uFF1B\u9700\u5177\u5907 export \u6743\u9650\uFF1B\u5931\u8D25\u65F6\u63D0\u793A\u539F\u56E0 -->
+
+The system SHALL ...
+\`\`\`
+
+\u82E5\u573A\u666F\u9700\u8981\u8865\u5145\u4E1A\u52A1\u8BED\u5883\uFF0C\u53EF\u5728 \`#### Scenario:\` \u540E\u540C\u6837\u6DFB\u52A0 \`<!-- \u4E2D\u6587\uFF1A... -->\`\u3002
+
+### \u521B\u5EFA\u6216\u66F4\u65B0 spec \u65F6\uFF08\u542B LLM \u6539\u6587\u6863\uFF09
+
+- **\u540C\u6B21\u7F16\u8F91\u539F\u5219**\uFF1A\u4FEE\u6539\u82F1\u6587\u89C4\u8303\u53E5\u65F6\uFF0C**\u5FC5\u987B\u5728\u540C\u4E00\u6B21\u7F16\u8F91\u4E2D**\u540C\u6B65\u66F4\u65B0\u5BF9\u5E94\u7684\u4E2D\u6587\u6CE8\u91CA\uFF0C\u4E0D\u5F97\u9057\u7559\u8FC7\u65F6\u8BF4\u660E\u3002
+- \u91CD\u6784\u82F1\u6587\u65F6\u4E0D\u8981\u65E0\u6545\u5220\u9664\u4E2D\u6587\u6CE8\u91CA\uFF1B\u82E5\u5220\u9664 Requirement\uFF0C\u4E00\u5E76\u5220\u9664\u5176\u6CE8\u91CA\u3002
+- \u4E2D\u6587\u8BF4\u660E\u4E0D\u5F97\u4E0E\u82F1\u6587\u77DB\u76FE\uFF1B\u82E5\u6709\u51B2\u7A81\uFF0C\u540C\u65F6\u4FEE\u6B63\u6216\u8BE2\u95EE\u7528\u6237\u3002**\u51B2\u7A81\u65F6\u4EE5\u82F1\u6587 Requirements \u4E3A\u51C6\u3002**
+- **proposal.md** / **design.md** \u53EF\u7528\u4E2D\u6587\uFF1B**tasks.md** \u53EF\u7528\u4E2D\u6587\u5E76\u4FDD\u7559\u82F1\u6587\u6807\u8BC6\u7B26\u3002
+
+### \u9002\u7528\u573A\u666F
+
+- \`fet propose\`\u3001\`fet continue\`\u3001\`fet ff\` \u5199\u5165\u7684\u4EA7\u7269
+- \u5BF9\u8BDD\u4E2D\u624B\u52A8\u4FEE\u6539 change \u4E0B spec
+- \`fet sync\` \u5408\u5E76\u5230 \`openspec/specs/**/spec.md\` \u65F6\uFF0C\u5BF9\u89E6\u53CA\u7684 Requirement \u4FDD\u7559\u6216\u5237\u65B0\u4E2D\u6587\u6CE8\u91CA`;
+}
+function renderCursorSpecLanguageRule(language) {
+  const description = language === "en" ? "Layered bilingual OpenSpec specs: English canonical text with synced Chinese HTML comments" : "OpenSpec \u5206\u5C42\u53CC\u8BED\uFF1A\u82F1\u6587\u89C4\u8303 + \u540C\u6B65\u7EF4\u62A4\u7684\u4E2D\u6587\u6CE8\u91CA";
+  return `<!-- FET:MANAGED
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generator: cursor-adapter
+adapterVersion: 1
+FET:END -->
+
+---
+description: ${description}
+alwaysApply: false
+---
+
+${language === "en" ? "Apply when creating or editing OpenSpec spec files under `openspec/changes/` or `openspec/specs/`, or when running `fet propose` / `fet continue` / `fet ff` / `fet sync`." : "\u5728\u521B\u5EFA\u6216\u7F16\u8F91 `openspec/changes/`\u3001`openspec/specs/` \u4E0B\u7684 spec\uFF0C\u6216\u8FD0\u884C `fet propose` / `fet continue` / `fet ff` / `fet sync` \u65F6\u9002\u7528\u3002"}
+
+${renderSpecLanguagePolicyBody(language)}
+`;
+}
+function renderCodexSpecLanguageGuide(language) {
+  return `<!-- FET:MANAGED
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generator: codex-adapter
+adapterVersion: 1
+FET:END -->
+
+# OpenSpec spec language (layered bilingual)
+
+${renderSpecLanguagePolicyBody(language)}
+`;
+}
+function renderPlanningArtifactSpecBlock(language, changeId) {
+  const uiBlock = changeId !== void 0 ? `
+
+${renderPlanningArtifactUiContractBlock(language, changeId)}` : "";
+  if (language === "en") {
+    return `## OpenSpec spec artifacts
+
+When the artifact is \`specs/<capability>/spec.md\` (or you edit spec files in this change):
+
+1. Follow \`.cursor/rules/fet-spec-language.mdc\` or \`.codex/fet/spec-language.md\`.
+2. English Requirements/Scenario + \`<!-- \u4E2D\u6587\uFF1A... -->\` after each Requirement title.
+3. Update Chinese notes in the **same edit** whenever English normative text changes.${uiBlock}`;
+  }
+  return `## OpenSpec spec \u4EA7\u7269
+
+\u5F53\u4EA7\u7269\u4E3A \`specs/<capability>/spec.md\`\uFF08\u6216\u4F60\u5728\u672C change \u4E2D\u4FEE\u6539 spec\uFF09\u65F6\uFF1A
+
+1. \u9075\u5B88 \`.cursor/rules/fet-spec-language.mdc\` \u6216 \`.codex/fet/spec-language.md\`\u3002
+2. \u82F1\u6587 Requirements/Scenario + \u6BCF\u4E2A Requirement \u6807\u9898\u540E\u52A0 \`<!-- \u4E2D\u6587\uFF1A... -->\`\u3002
+3. \u82F1\u6587\u89C4\u8303\u53E5\u6709\u4EFB\u4F55\u53D8\u52A8\u65F6\uFF0C**\u540C\u4E00\u6B21\u7F16\u8F91**\u5FC5\u987B\u540C\u6B65\u66F4\u65B0\u5BF9\u5E94\u4E2D\u6587\u6CE8\u91CA\u3002${uiBlock}`;
+}
 
 // src/commands/update-context.ts
 async function updateContextCommand(ctx) {
@@ -2516,8 +2892,8 @@ async function exists4(path) {
 }
 
 // src/commands/proxy.ts
-import { readFile as readFile14 } from "fs/promises";
-import { join as join18 } from "path";
+import { readFile as readFile15 } from "fs/promises";
+import { join as join19 } from "path";
 
 // src/figma-guard.ts
 import { readdir as readdir3, readFile as readFile11, stat as stat7 } from "fs/promises";
@@ -2525,6 +2901,7 @@ import { join as join16, relative as relative2 } from "path";
 import { parseDocument as parseDocument2 } from "yaml";
 var DEFAULT_CONFIG = {
   enabled: true,
+  mode: "require_before_ui",
   onUncertainty: "stop_and_ask"
 };
 async function loadFigmaGuardConfig(projectRoot) {
@@ -2537,8 +2914,11 @@ async function loadFigmaGuardConfig(projectRoot) {
       return DEFAULT_CONFIG;
     }
     const enabled = node.get("enabled");
+    const modeRaw = node.get("mode");
+    const mode = modeRaw === "stop_and_ask" ? "stop_and_ask" : "require_before_ui";
     return {
       enabled: enabled === void 0 ? true : Boolean(enabled),
+      mode,
       onUncertainty: "stop_and_ask"
     };
   } catch {
@@ -2585,7 +2965,11 @@ async function collectFigmaUrlsFromChange(projectRoot, changeId) {
   return { urls: [...urls], sources };
 }
 async function ensureChangeFigmaStopHandoff(options) {
-  const config = options.enabled === void 0 ? await loadFigmaGuardConfig(options.projectRoot) : { enabled: options.enabled, onUncertainty: "stop_and_ask" };
+  const config = options.enabled === void 0 ? await loadFigmaGuardConfig(options.projectRoot) : {
+    enabled: options.enabled,
+    mode: options.mode ?? "require_before_ui",
+    onUncertainty: "stop_and_ask"
+  };
   if (!config.enabled) {
     return null;
   }
@@ -2593,22 +2977,47 @@ async function ensureChangeFigmaStopHandoff(options) {
   if (!urls.length) {
     return null;
   }
-  const relativePath = figmaStopHandoffRelativePath(options.changeId);
-  const absolutePath = join16(options.projectRoot, relativePath);
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const content = renderChangeFigmaStopHandoff({
+  let written = false;
+  const stopRelativePath = figmaStopHandoffRelativePath(options.changeId);
+  const stopAbsolutePath = join16(options.projectRoot, stopRelativePath);
+  const stopContent = renderChangeFigmaStopHandoff({
     changeId: options.changeId,
     generatedAt,
     urls,
     sources,
     language: options.language
   });
-  const existing = await readOptional3(absolutePath);
-  const written = existing !== content;
-  if (written) {
-    await atomicWrite(absolutePath, content);
+  const existingStop = await readOptional3(stopAbsolutePath);
+  if (existingStop !== stopContent) {
+    await atomicWrite(stopAbsolutePath, stopContent);
+    written = true;
+  }
+  let applyInstructionsPath;
+  if (config.mode === "require_before_ui") {
+    applyInstructionsPath = figmaApplyInstructionsRelativePath(options.changeId);
+    const applyAbsolutePath = join16(options.projectRoot, applyInstructionsPath);
+    const applyContent = renderChangeFigmaApplyInstructions({
+      changeId: options.changeId,
+      generatedAt,
+      urls,
+      sources,
+      language: options.language
+    });
+    const existingApply = await readOptional3(applyAbsolutePath);
+    if (existingApply !== applyContent) {
+      await atomicWrite(applyAbsolutePath, applyContent);
+      written = true;
+    }
   }
-  return { path: relativePath, written, urls, sources };
+  return {
+    path: stopRelativePath,
+    applyInstructionsPath,
+    written,
+    urls,
+    sources,
+    mode: config.mode
+  };
 }
 async function listMarkdownFiles(root) {
   const files = [];
@@ -2639,6 +3048,300 @@ async function readOptional3(path) {
   }
 }
 
+// src/ui-display-contract.ts
+import { existsSync as existsSync2 } from "fs";
+import { readdir as readdir4, readFile as readFile12, stat as stat8 } from "fs/promises";
+import { join as join17, relative as relative3 } from "path";
+import { parse as parse3, parseDocument as parseDocument3 } from "yaml";
+var DEFAULT_CONFIG2 = {
+  enabled: true
+};
+var API_DOC_PATH_PATTERN = /(?:^|[\s(`])([\w./-]*(?:openapi|swagger|api-doc|api\/docs)[\w./-]*\.(?:ya?ml|json))(?:[\s)`.,;]|$)/gi;
+var MARKDOWN_LINK_PATH_PATTERN = /\[[^\]]*\]\(([^)]+\.(?:ya?ml|json))\)/gi;
+var BACKTICK_PATH_PATTERN = /`([^`]+\.(?:ya?ml|json))`/gi;
+var OPENAPI_BARE_PATTERN = /\b(openapi\.ya?ml|swagger\.ya?ml|swagger\.json)\b/gi;
+async function loadUiDisplayContractConfig(projectRoot) {
+  try {
+    const raw = await readFile12(join17(projectRoot, "openspec", "config.yaml"), "utf8");
+    const doc = parseDocument3(raw);
+    const fetNode = doc.get("fet", true);
+    const node = fetNode?.get?.("uiDisplayContract");
+    if (!node || typeof node.get !== "function") {
+      return DEFAULT_CONFIG2;
+    }
+    const enabled = node.get("enabled");
+    return {
+      enabled: enabled === void 0 ? true : Boolean(enabled)
+    };
+  } catch {
+    return DEFAULT_CONFIG2;
+  }
+}
+async function collectApiSourcesFromChange(projectRoot, changeId) {
+  const changePath = join17(projectRoot, "openspec", "changes", changeId);
+  const paths = /* @__PURE__ */ new Set();
+  const sources = [];
+  const candidates = ["proposal.md", "tasks.md", "design.md"];
+  for (const name of candidates) {
+    const filePath = join17(changePath, name);
+    const content = await readOptional4(filePath);
+    if (!content) {
+      continue;
+    }
+    const found = extractApiDocPaths(content, projectRoot);
+    if (found.length) {
+      sources.push(`openspec/changes/${changeId}/${name}`);
+      for (const path of found) {
+        paths.add(path);
+      }
+    }
+  }
+  const specsPath = join17(changePath, "specs");
+  for (const filePath of await listMarkdownFiles2(specsPath)) {
+    const content = await readOptional4(filePath);
+    if (!content) {
+      continue;
+    }
+    const found = extractApiDocPaths(content, projectRoot);
+    if (found.length) {
+      sources.push(relative3(projectRoot, filePath).replaceAll("\\", "/"));
+      for (const path of found) {
+        paths.add(path);
+      }
+    }
+  }
+  return { paths: [...paths], sources };
+}
+function extractApiDocPaths(content, projectRoot) {
+  const found = /* @__PURE__ */ new Set();
+  const patterns = [API_DOC_PATH_PATTERN, MARKDOWN_LINK_PATH_PATTERN, BACKTICK_PATH_PATTERN, OPENAPI_BARE_PATTERN];
+  for (const pattern of patterns) {
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+      const raw = (match[1] ?? match[0]).trim().replace(/^["']|["']$/g, "");
+      const normalized = normalizeRepoPath(raw, projectRoot);
+      if (normalized) {
+        found.add(normalized);
+      }
+    }
+  }
+  if (/\b(openapi|swagger|接口文档|API\s*文档)\b/i.test(content)) {
+    const common = ["openapi.yaml", "openapi.yml", "docs/openapi.yaml", "swagger.yaml", "swagger.json"];
+    for (const candidate of common) {
+      const normalized = normalizeRepoPath(candidate, projectRoot);
+      if (normalized && existsSync2(join17(projectRoot, normalized))) {
+        found.add(normalized);
+      }
+    }
+  }
+  return [...found];
+}
+async function extractOpenApiSchemas(projectRoot, relativePaths) {
+  const schemas = [];
+  for (const rel of relativePaths) {
+    const absolute = join17(projectRoot, rel);
+    const content = await readOptional4(absolute);
+    if (!content) {
+      continue;
+    }
+    let doc;
+    try {
+      doc = rel.endsWith(".json") ? JSON.parse(content) : parse3(content);
+    } catch {
+      continue;
+    }
+    const names = collectOpenApiSchemaPropertyNames(doc);
+    for (const [name, fields] of names) {
+      if (fields.length) {
+        schemas.push({ name, fields: [...new Set(fields)].sort(), sourcePath: rel });
+      }
+    }
+  }
+  return schemas;
+}
+function buildUiDisplayContractDocument(options) {
+  const allApiFields = [...new Set(options.apiSchemas.flatMap((schema) => schema.fields))].sort();
+  const screenId = options.figmaUrls.length ? "primary" : "default";
+  const omittedCandidates = allApiFields.map((field) => {
+    const schema = options.apiSchemas.find((item) => item.fields.includes(field))?.name;
+    return {
+      field,
+      schema,
+      reason: "Listed in API/OpenAPI schema; not yet in displayFields\u2014confirm with Figma before rendering in UI."
+    };
+  });
+  return {
+    schemaVersion: 1,
+    fetVersion: options.fetVersion,
+    generatedAt: options.generatedAt,
+    changeId: options.changeId,
+    purpose: "ui-display-contract",
+    status: "draft",
+    precedence: [
+      "ui-display-contract.yaml displayFields",
+      "Figma visible elements",
+      "API/OpenAPI schema (data layer and types only)"
+    ],
+    sources: {
+      figma: {
+        urls: options.figmaUrls,
+        artifactPaths: options.figmaSources
+      },
+      api: options.apiPaths.map((path) => ({
+        path,
+        artifactPaths: options.apiSources,
+        schemas: options.apiSchemas.filter((schema) => schema.sourcePath === path)
+      }))
+    },
+    screens: [
+      {
+        id: screenId,
+        title: options.figmaUrls.length ? "Primary screen (confirm id with design)" : "Default screen",
+        figmaUrls: options.figmaUrls,
+        displayFields: [],
+        hiddenButUsed: [],
+        omittedFromUi: [],
+        needsReview: allApiFields.length ? [
+          `Fill displayFields for screen "${screenId}" from Figma before UI implementation.`,
+          ...omittedCandidates.slice(0, 12).map((item) => `API field "${item.field}"\u2014omit from UI or add to displayFields?`)
+        ] : options.figmaUrls.length ? [`Fill displayFields for screen "${screenId}" from Figma MCP/API.`] : ["Add API doc paths to change artifacts or confirm this change has no API-backed UI."]
+      }
+    ],
+    omittedCandidates
+  };
+}
+async function ensureChangeUiDisplayContract(options) {
+  const config = options.enabled === void 0 ? await loadUiDisplayContractConfig(options.projectRoot) : { enabled: options.enabled };
+  if (!config.enabled) {
+    return null;
+  }
+  const figma = await collectFigmaUrlsFromChange(options.projectRoot, options.changeId);
+  const api = await collectApiSourcesFromChange(options.projectRoot, options.changeId);
+  const hasFigma = figma.urls.length > 0;
+  const hasApi = api.paths.length > 0;
+  if (!hasFigma && !hasApi) {
+    return null;
+  }
+  const apiSchemas = hasApi ? await extractOpenApiSchemas(options.projectRoot, api.paths) : [];
+  const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const contractRelativePath = uiDisplayContractRelativePath(options.changeId);
+  const applyRelativePath = uiFieldApplyInstructionsRelativePath(options.changeId);
+  const doc = buildUiDisplayContractDocument({
+    changeId: options.changeId,
+    generatedAt,
+    fetVersion: options.fetVersion,
+    figmaUrls: figma.urls,
+    figmaSources: figma.sources,
+    apiPaths: api.paths,
+    apiSources: api.sources,
+    apiSchemas
+  });
+  const contractContent = renderUiDisplayContractYaml(doc);
+  const contractAbsolutePath = join17(options.projectRoot, contractRelativePath);
+  const existingContract = await readOptional4(contractAbsolutePath);
+  let written = false;
+  if (existingContract !== contractContent) {
+    await atomicWrite(contractAbsolutePath, contractContent);
+    written = true;
+  }
+  const applyContent = renderUiFieldApplyInstructions({
+    changeId: options.changeId,
+    generatedAt,
+    contractPath: contractRelativePath,
+    language: options.language,
+    hasFigma,
+    hasApi
+  });
+  const applyAbsolutePath = join17(options.projectRoot, applyRelativePath);
+  const existingApply = await readOptional4(applyAbsolutePath);
+  if (existingApply !== applyContent) {
+    await atomicWrite(applyAbsolutePath, applyContent);
+    written = true;
+  }
+  return {
+    contractPath: contractRelativePath,
+    applyInstructionsPath: applyRelativePath,
+    written,
+    hasFigma,
+    hasApi,
+    apiFieldCount: apiSchemas.reduce((sum, schema) => sum + schema.fields.length, 0)
+  };
+}
+function collectOpenApiSchemaPropertyNames(doc) {
+  const result = /* @__PURE__ */ new Map();
+  if (!doc || typeof doc !== "object") {
+    return result;
+  }
+  const root = doc;
+  const components = root.components;
+  const schemas = components?.schemas;
+  if (schemas && typeof schemas === "object") {
+    for (const [name, schema] of Object.entries(schemas)) {
+      const fields = propertyNamesFromSchema(schema);
+      if (fields.length) {
+        result.set(name, fields);
+      }
+    }
+  }
+  return result;
+}
+function propertyNamesFromSchema(schema, depth = 0) {
+  if (!schema || typeof schema !== "object" || depth > 4) {
+    return [];
+  }
+  const node = schema;
+  if (node.$ref && typeof node.$ref === "string") {
+    return [];
+  }
+  const properties = node.properties;
+  if (properties && typeof properties === "object") {
+    return Object.keys(properties).sort();
+  }
+  if (node.items) {
+    return propertyNamesFromSchema(node.items, depth + 1);
+  }
+  if (node.allOf && Array.isArray(node.allOf)) {
+    return node.allOf.flatMap((part) => propertyNamesFromSchema(part, depth + 1));
+  }
+  return [];
+}
+function normalizeRepoPath(raw, projectRoot) {
+  const cleaned = raw.replace(/^\.\//, "").replaceAll("\\", "/");
+  if (!cleaned || cleaned.includes("..")) {
+    return null;
+  }
+  return cleaned;
+}
+async function listMarkdownFiles2(root) {
+  const files = [];
+  await walk2(root, files);
+  return files;
+}
+async function walk2(dir, files) {
+  try {
+    const entries = await readdir4(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join17(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walk2(fullPath, files);
+      } else if (entry.isFile() && entry.name.endsWith(".md")) {
+        files.push(fullPath);
+      }
+    }
+  } catch {
+    return;
+  }
+}
+async function readOptional4(path) {
+  try {
+    await stat8(path);
+    return await readFile12(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+
 // src/state/project.ts
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
@@ -2666,8 +3369,8 @@ async function git(cwd, args) {
 }
 
 // src/state/store.ts
-import { mkdir as mkdir6, readFile as readFile12 } from "fs/promises";
-import { join as join17 } from "path";
+import { mkdir as mkdir6, readFile as readFile13 } from "fs/promises";
+import { join as join18 } from "path";
 
 // src/language.ts
 var DEFAULT_LANGUAGE = "zh-CN";
@@ -2785,7 +3488,7 @@ var StateStore = class {
   project;
   async readGlobal() {
     try {
-      const value = JSON.parse(await readFile12(this.globalPath(), "utf8"));
+      const value = JSON.parse(await readFile13(this.globalPath(), "utf8"));
       assertGlobalState(value);
       return value;
     } catch (error) {
@@ -2800,13 +3503,13 @@ var StateStore = class {
   }
   async writeGlobal(state) {
     state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    await mkdir6(join17(this.projectRoot, "openspec"), { recursive: true });
+    await mkdir6(join18(this.projectRoot, "openspec"), { recursive: true });
     await atomicWrite(this.globalPath(), `${JSON.stringify(state, null, 2)}
 `);
   }
   async readChange(changeId) {
     try {
-      const value = JSON.parse(await readFile12(this.changePath(changeId), "utf8"));
+      const value = JSON.parse(await readFile13(this.changePath(changeId), "utf8"));
       assertChangeState(value);
       return value;
     } catch (error) {
@@ -2821,15 +3524,15 @@ var StateStore = class {
   }
   async writeChange(state) {
     state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    await mkdir6(join17(this.projectRoot, "openspec", "changes", state.changeId), { recursive: true });
+    await mkdir6(join18(this.projectRoot, "openspec", "changes", state.changeId), { recursive: true });
     await atomicWrite(this.changePath(state.changeId), `${JSON.stringify(state, null, 2)}
 `);
   }
   globalPath() {
-    return join17(this.projectRoot, "openspec", "fet-state.json");
+    return join18(this.projectRoot, "openspec", "fet-state.json");
   }
   changePath(changeId) {
-    return join17(this.projectRoot, "openspec", "changes", changeId, "fet-state.json");
+    return join18(this.projectRoot, "openspec", "changes", changeId, "fet-state.json");
   }
 };
 function isNotFound(error) {
@@ -2837,11 +3540,11 @@ function isNotFound(error) {
 }
 
 // src/state/tasks.ts
-import { readFile as readFile13 } from "fs/promises";
+import { readFile as readFile14 } from "fs/promises";
 async function readCompletedTaskIds(tasksPath) {
   let content;
   try {
-    content = await readFile13(tasksPath, "utf8");
+    content = await readFile14(tasksPath, "utf8");
   } catch {
     return [];
   }
@@ -2990,18 +3693,29 @@ async function applyWorkflowCommand(ctx, args) {
       exitCode: instructions.exitCode,
       phaseStatus: "in_progress"
     });
-    const figmaGuard = await ensureChangeFigmaStopHandoff({
-      projectRoot: ctx.projectRoot,
-      changeId,
-      language: ctx.language
-    });
+    const [figmaGuard, uiContract] = await Promise.all([
+      ensureChangeFigmaStopHandoff({
+        projectRoot: ctx.projectRoot,
+        changeId,
+        language: ctx.language
+      }),
+      ensureChangeUiDisplayContract({
+        projectRoot: ctx.projectRoot,
+        changeId,
+        language: ctx.language,
+        fetVersion: ctx.fetVersion
+      })
+    ]);
     const applyNextSteps = [
       `Read openspec/changes/${changeId}/tasks.md and the instructions output.`,
       "Implement pending tasks and update task checkboxes only after the work is done.",
       `Run fet verify --change ${changeId}`
     ];
+    if (uiContract) {
+      applyNextSteps.unshift(...renderUiDisplayContractApplyNextSteps(changeId, ctx.language));
+    }
     if (figmaGuard) {
-      applyNextSteps.unshift(renderFigmaStopNextStep(changeId, ctx.language));
+      applyNextSteps.unshift(...renderFigmaApplyNextSteps(changeId, ctx.language, figmaGuard.mode));
     }
     ctx.output.result({
       ok: true,
@@ -3014,7 +3728,8 @@ async function applyWorkflowCommand(ctx, args) {
         instructions: instructions.data,
         status,
         graphContext: runState.graphContext,
-        figmaGuard: figmaGuard ?? void 0
+        figmaGuard: figmaGuard ?? void 0,
+        uiDisplayContract: uiContract ?? void 0
       }
     });
   });
@@ -3166,17 +3881,30 @@ async function artifactWorkflowCommand(ctx, command, args) {
       exitCode: instructions.exitCode
     });
     const status = await readOpenSpecStatus(ctx, changeId);
-    const figmaGuard = await ensureChangeFigmaStopHandoff({
-      projectRoot: ctx.projectRoot,
-      changeId,
-      language: ctx.language
-    });
+    const [figmaGuard, uiContract] = await Promise.all([
+      ensureChangeFigmaStopHandoff({
+        projectRoot: ctx.projectRoot,
+        changeId,
+        language: ctx.language
+      }),
+      ensureChangeUiDisplayContract({
+        projectRoot: ctx.projectRoot,
+        changeId,
+        language: ctx.language,
+        fetVersion: ctx.fetVersion
+      })
+    ]);
     const planningNextSteps = [
       `Create or update openspec/changes/${changeId}/${resolveOutputPath(status, artifactId)}`,
       "Review the artifact with the user before generating the next planning file.",
       `Run fet passthrough status --change ${changeId}`,
       status.isComplete ? `Run fet apply --change ${changeId}` : `Run fet continue --change ${changeId} when ready for the next artifact`
     ];
+    if (uiContract) {
+      planningNextSteps.unshift(
+        ctx.language === "en" ? `If writing specs for API-backed UI, add the UI display contract Requirement; draft at ${uiContract.contractPath}.` : `\u82E5\u7F16\u5199\u7ED1\u5B9A\u63A5\u53E3\u7684 UI spec\uFF0C\u987B\u52A0\u5165 UI \u5C55\u793A\u5951\u7EA6 Requirement\uFF1B\u8349\u6848\u89C1 ${uiContract.contractPath}\u3002`
+      );
+    }
     if (figmaGuard) {
       planningNextSteps.unshift(renderFigmaStopNextStep(changeId, ctx.language));
     }
@@ -3192,7 +3920,8 @@ async function artifactWorkflowCommand(ctx, command, args) {
         instructions: instructions.data,
         status,
         graphContext: runState.graphContext,
-        figmaGuard: figmaGuard ?? void 0
+        figmaGuard: figmaGuard ?? void 0,
+        uiDisplayContract: uiContract ?? void 0
       }
     });
   });
@@ -3398,8 +4127,8 @@ async function createChangelogEntry(projectRoot, changeId) {
   };
 }
 async function appendChangelog(projectRoot, entry) {
-  const changelogPath = join18(projectRoot, "CHANGELOG.md");
-  const existing = await readOptional4(changelogPath);
+  const changelogPath = join19(projectRoot, "CHANGELOG.md");
+  const existing = await readOptional5(changelogPath);
   const legacyContentLabel = "\u66F4\u65B0\u5185\u5BB9";
   const block = `updateTime: ${entry.updateTime}
 changeRequirement:${entry.content}
@@ -3411,12 +4140,12 @@ ${block}` : block;
   await atomicWrite(changelogPath, next);
 }
 async function readChangeRequirement(projectRoot, changeId) {
-  const changeRoot = join18(projectRoot, "openspec", "changes", changeId);
-  const proposal = await readOptional4(join18(changeRoot, "proposal.md"));
+  const changeRoot = join19(projectRoot, "openspec", "changes", changeId);
+  const proposal = await readOptional5(join19(changeRoot, "proposal.md"));
   if (proposal) {
     return summarizeMarkdown(proposal);
   }
-  const readme = await readOptional4(join18(changeRoot, "README.md"));
+  const readme = await readOptional5(join19(changeRoot, "README.md"));
   if (readme) {
     return summarizeMarkdown(readme);
   }
@@ -3426,9 +4155,9 @@ function summarizeMarkdown(content) {
   const normalized = content.replace(/\r\n/g, "\n").split("\n").map((line) => line.trim()).filter((line) => line && !line.startsWith("<!--") && !line.startsWith("---")).join(" ");
   return normalized || "No change requirement found.";
 }
-async function readOptional4(path) {
+async function readOptional5(path) {
   try {
-    return await readFile14(path, "utf8");
+    return await readFile15(path, "utf8");
   } catch {
     return null;
   }
@@ -3784,8 +4513,8 @@ async function updateCommand(ctx) {
 
 // src/commands/verify.ts
 import { createHash } from "crypto";
-import { mkdir as mkdir7, readFile as readFile15, stat as stat8 } from "fs/promises";
-import { join as join19 } from "path";
+import { mkdir as mkdir7, readFile as readFile16, stat as stat9 } from "fs/promises";
+import { join as join20 } from "path";
 async function verifyCommand(ctx, options) {
   if (options.auto) {
     const scan = await ctx.scanner.scan(ctx.projectRoot, {});
@@ -3852,8 +4581,8 @@ async function verifyCommand(ctx, options) {
 async function writeInstructions(ctx, changeId) {
   await assertChangeExists(ctx, changeId);
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const dir = join19(ctx.projectRoot, "openspec", "changes", changeId, ".fet");
-  const instructionsPath = join19(dir, "verify-instructions.md");
+  const dir = join20(ctx.projectRoot, "openspec", "changes", changeId, ".fet");
+  const instructionsPath = join20(dir, "verify-instructions.md");
   await mkdir7(dir, { recursive: true });
   await atomicWrite(instructionsPath, renderVerifyInstructions(changeId, generatedAt));
   const state = await ctx.stateStore.getOrCreateChange(changeId, "verify");
@@ -3870,7 +4599,7 @@ async function writeInstructions(ctx, changeId) {
 async function markDone(ctx, changeId) {
   await assertChangeExists(ctx, changeId);
   const declaredAt = (/* @__PURE__ */ new Date()).toISOString();
-  const instructionsPath = join19(ctx.projectRoot, "openspec", "changes", changeId, ".fet", "verify-instructions.md");
+  const instructionsPath = join20(ctx.projectRoot, "openspec", "changes", changeId, ".fet", "verify-instructions.md");
   const instructions = await readInstructions(instructionsPath, changeId);
   const instructionsGeneratedAt = readFrontMatterValue(instructions, "generatedAt") ?? declaredAt;
   const state = await ctx.stateStore.getOrCreateChange(changeId, "verify");
@@ -3905,8 +4634,8 @@ async function assertChangeExists(ctx, changeId) {
 }
 async function readInstructions(path, changeId) {
   try {
-    await stat8(path);
-    const content = await readFile15(path, "utf8");
+    await stat9(path);
+    const content = await readFile16(path, "utf8");
     const fileChangeId = readFrontMatterValue(content, "changeId");
     if (fileChangeId !== changeId) {
       throw new FetError({
@@ -4044,9 +4773,9 @@ function renderIdeModelPolicy(command, language = "zh-CN") {
 import { resolve } from "path";
 
 // src/adapters/codex/index.ts
-import { mkdir as mkdir8, readFile as readFile16, stat as stat9 } from "fs/promises";
+import { mkdir as mkdir8, readFile as readFile17, stat as stat10 } from "fs/promises";
 import { homedir } from "os";
-import { dirname as dirname8, join as join20 } from "path";
+import { dirname as dirname8, join as join21 } from "path";
 
 // src/adapters/commands.ts
 var FET_WORKFLOW_COMMANDS = [
@@ -4089,6 +4818,9 @@ Before doing FET or OpenSpec work in Codex, read:
 - openspec/config.yaml
 - .codex/fet/karpathy-guidelines.md
 - .codex/fet/figma-stop.md when implementing UI from Figma
+- .codex/fet/spec-language.md when writing or updating OpenSpec specs
+- openspec/changes/<change-id>/.fet/figma-apply-instructions.md before UI work when FET apply reports Figma links
+- .codex/fet/ui-display-contract.md when UI binds API data; openspec/changes/<change-id>/.fet/ui-display-contract.yaml when present
 - the active change files under openspec/changes/<change-id>/, when a change is selected
 
 If GitNexus code graph context is available in the IDE or MCP tools, prefer it before broad repository scans. Use it to identify relevant modules, dependencies, and insertion points, then read only the concrete source files needed. If GitNexus is unavailable, continue with the normal FET/OpenSpec workflow.
@@ -4107,7 +4839,9 @@ ${languageInstruction(language)}
 - AGENTS.md
 - openspec/config.yaml
 - .codex/fet/karpathy-guidelines.md
-- \u6309 Figma \u5B9E\u73B0 UI \u65F6\u9605\u8BFB .codex/fet/figma-stop.md
+- \u6309 Figma \u5B9E\u73B0 UI \u65F6\u9605\u8BFB .codex/fet/figma-stop.md\uFF1B\u6709 figma-apply-instructions.md \u65F6\u5FC5\u987B\u5728\u6539 UI \u524D\u5B8C\u6574\u6267\u884C
+- \u7F16\u5199\u6216\u66F4\u65B0 spec \u65F6\u9605\u8BFB .codex/fet/spec-language.md\uFF08\u82F1\u6587\u89C4\u8303 + \u540C\u6B21\u7F16\u8F91\u7EF4\u62A4\u4E2D\u6587\u6CE8\u91CA\uFF09
+- \u7ED1\u5B9A\u63A5\u53E3\u7684 UI \u9605\u8BFB .codex/fet/ui-display-contract.md\uFF1B\u5B58\u5728 ui-display-contract.yaml \u65F6\u5B9E\u65BD\u524D\u987B\u786E\u8BA4 displayFields
 - \u5982\u679C\u5DF2\u9009\u62E9 change\uFF0C\u9605\u8BFB openspec/changes/<change-id>/ \u4E0B\u7684\u5F53\u524D\u4EA7\u7269
 
 \u5982\u679C IDE \u6216 MCP \u5DE5\u5177\u4E2D\u53EF\u7528 GitNexus \u4EE3\u7801\u56FE\u4E0A\u4E0B\u6587\uFF0C\u5148\u7528\u5B83\u7F29\u5C0F\u4ED3\u5E93\u626B\u63CF\u8303\u56F4\uFF1B\u7528\u56FE\u8BC6\u522B\u76F8\u5173\u6A21\u5757\u3001\u4F9D\u8D56\u548C\u63D2\u5165\u70B9\uFF0C\u518D\u53EA\u8BFB\u53D6\u9700\u8981\u786E\u8BA4\u884C\u4E3A\u7684\u5177\u4F53\u6E90\u7801\u6587\u4EF6\u3002GitNexus \u4E0D\u53EF\u7528\u65F6\uFF0C\u6309\u666E\u901A FET/OpenSpec \u5DE5\u4F5C\u6D41\u7EE7\u7EED\u3002
@@ -4134,10 +4868,24 @@ function codexFigmaStopFile(language = DEFAULT_LANGUAGE) {
     content: renderCodexFigmaStopGuide(language)
   };
 }
+function codexSpecLanguageFile(language = DEFAULT_LANGUAGE) {
+  return {
+    path: ".codex/fet/spec-language.md",
+    content: renderCodexSpecLanguageGuide(language)
+  };
+}
+function codexUiDisplayContractFile(language = DEFAULT_LANGUAGE) {
+  return {
+    path: ".codex/fet/ui-display-contract.md",
+    content: renderCodexUiDisplayContractGuide(language)
+  };
+}
 function codexCommandFiles(language = DEFAULT_LANGUAGE) {
   return [
     codexKarpathyGuidelinesFile(language),
     codexFigmaStopFile(language),
+    codexUiDisplayContractFile(language),
+    codexSpecLanguageFile(language),
     ...FET_ADAPTER_COMMANDS.map((command) => ({
       path: `.codex/fet/commands/${command}.md`,
       content: renderCommand(command, language)
@@ -4488,7 +5236,9 @@ ${commandGoalZh(command)}
 - \u9ED8\u8BA4\u4F7F\u7528\u4E2D\u6587\u4EA7\u51FA\u3002
 - \u4E0D\u8981\u7ED5\u8FC7 FET \u76F4\u63A5\u8C03\u7528 openspec\uFF0C\u9664\u975E FET \u547D\u4EE4\u672C\u8EAB\u4E0D\u53EF\u7528\u3002
 - change \u4E0D\u660E\u786E\u65F6\u5148\u8BE2\u95EE\u7528\u6237\u3002
-${command === "fill-context" ? "- fet fill-context \u53EF\u80FD\u5DF2\u5199\u5165\u5C0F\u7A0B\u5E8F\u5305\u4F53\u79EF\u4E0E 2MB \u7EA6\u675F\uFF0C\u4E0D\u8981\u8986\u76D6\u8BE5\u8282\u4E2D\u7684\u626B\u63CF\u7ED3\u679C\uFF0C\u9664\u975E\u4ED3\u5E93\u7ED3\u6784\u5DF2\u53D8\u3002\n- \u66FF\u6362 AGENTS.md \u4E2D\u5176\u4F59 [NEEDS LLM INPUT] \u5360\u4F4D\u7B26\uFF0C\u4FDD\u7559 FET \u6258\u7BA1\u6807\u8BB0\uFF0C\u4E0D\u8981\u4FEE\u6539\u4E1A\u52A1\u4EE3\u7801\u3002\n" : ""}${command === "propose" || command === "continue" ? "- \u4E00\u6B21\u53EA\u521B\u5EFA\u4E00\u4E2A ready artifact\uFF0C\u5E76\u5728\u5199\u5165\u524D\u9605\u8BFB\u4F9D\u8D56\u6587\u4EF6\u3002\n" : ""}${command === "propose" || command === "continue" ? "- \u4E0D\u8981\u5728\u7528\u6237\u5BA1\u9605\u5F53\u524D\u4EA7\u7269\u524D\u81EA\u52A8\u8FD0\u884C fet continue\u3001fet ff \u6216\u5FAA\u73AF\u751F\u6210\u540E\u7EED\u4EA7\u7269\uFF1B\u9700\u8981\u7528\u6237\u660E\u786E\u786E\u8BA4\u540E\u518D\u63A8\u8FDB\u3002\n" : ""}${command === "apply" ? "- \u4E0D\u8981\u5728\u672A\u5B8C\u6210\u771F\u5B9E\u5B9E\u73B0\u524D\u52FE\u9009 tasks.md\uFF1B\u4E0D\u8981\u4ECE apply \u9636\u6BB5\u76F4\u63A5 sync \u6216 archive\u3002\n" : ""}`;
+${command === "fill-context" ? "- fet fill-context \u53EF\u80FD\u5DF2\u5199\u5165\u5C0F\u7A0B\u5E8F\u5305\u4F53\u79EF\u4E0E 2MB \u7EA6\u675F\uFF0C\u4E0D\u8981\u8986\u76D6\u8BE5\u8282\u4E2D\u7684\u626B\u63CF\u7ED3\u679C\uFF0C\u9664\u975E\u4ED3\u5E93\u7ED3\u6784\u5DF2\u53D8\u3002\n- \u66FF\u6362 AGENTS.md \u4E2D\u5176\u4F59 [NEEDS LLM INPUT] \u5360\u4F4D\u7B26\uFF0C\u4FDD\u7559 FET \u6258\u7BA1\u6807\u8BB0\uFF0C\u4E0D\u8981\u4FEE\u6539\u4E1A\u52A1\u4EE3\u7801\u3002\n" : ""}${command === "propose" || command === "continue" || command === "ff" ? "- \u4E00\u6B21\u53EA\u521B\u5EFA\u4E00\u4E2A ready artifact\uFF0C\u5E76\u5728\u5199\u5165\u524D\u9605\u8BFB\u4F9D\u8D56\u6587\u4EF6\u3002\n" : ""}${command === "propose" || command === "continue" || command === "ff" ? "- \u4E0D\u8981\u5728\u7528\u6237\u5BA1\u9605\u5F53\u524D\u4EA7\u7269\u524D\u81EA\u52A8\u8FD0\u884C fet continue\u3001fet ff \u6216\u5FAA\u73AF\u751F\u6210\u540E\u7EED\u4EA7\u7269\uFF1B\u9700\u8981\u7528\u6237\u660E\u786E\u786E\u8BA4\u540E\u518D\u63A8\u8FDB\u3002\n" : ""}${command === "propose" || command === "continue" || command === "ff" || command === "sync" ? `${renderSpecArtifactGuardrail("zh-CN")}
+` : ""}${command === "propose" || command === "continue" || command === "ff" ? `${renderUiDisplayContractGuardrail("zh-CN")}
+` : ""}${command === "apply" ? "- \u4E0D\u8981\u5728\u672A\u5B8C\u6210\u771F\u5B9E\u5B9E\u73B0\u524D\u52FE\u9009 tasks.md\uFF1B\u4E0D\u8981\u4ECE apply \u9636\u6BB5\u76F4\u63A5 sync \u6216 archive\u3002\n- \u82E5\u5B58\u5728 openspec/changes/<change-id>/.fet/figma-apply-instructions.md\uFF0C\u5FC5\u987B\u5148\u8BFB Figma\uFF08MCP/API\uFF09\u518D\u6539 UI\uFF1B\u5931\u8D25\u5219\u505C\u4E0B\u95EE\u7528\u6237\uFF0C\u7981\u6B62\u731C\u6837\u5F0F\u3002\n- \u82E5\u5B58\u5728 openspec/changes/<change-id>/.fet/ui-display-contract.yaml\uFF0C\u5B9E\u65BD\u7ED1\u5B9A\u63A5\u53E3\u7684 UI \u524D\u987B\u786E\u8BA4 displayFields\uFF0C\u7981\u6B62\u6309 OpenAPI \u5168\u91CF\u5C55\u793A\u3002\n" : ""}`;
 }
 function commandTitleZh(command) {
   const titles = {
@@ -4528,7 +5278,7 @@ function commandGoalZh(command) {
     return "\u5728\u7528\u6237\u660E\u786E\u8981\u6C42\u5FEB\u8FDB\u65F6\uFF0C\u4E00\u6B21\u6027\u751F\u6210 change \u6240\u9700\u7684\u5168\u90E8\u89C4\u5212\u4EA7\u7269\u3002";
   }
   if (command === "apply") {
-    return "\u8BFB\u53D6 OpenSpec \u4EA7\u7269\u5E76\u6309 tasks.md \u5B9E\u65BD\u4EE3\u7801\u53D8\u66F4\u3002";
+    return "\u8BFB\u53D6 OpenSpec \u4EA7\u7269\uFF1B\u6709 Figma \u65F6\u5148\u8BFB\u7A3F\u518D\u5B9E\u65BD UI\uFF1B\u6709 ui-display-contract.yaml \u65F6\u53EA\u5C55\u793A displayFields\uFF0C\u7981\u6B62\u6309 OpenAPI \u5168\u91CF\u6E32\u67D3\u3002";
   }
   if (command.startsWith("graph-")) {
     return "\u7BA1\u7406\u53EF\u9009\u7684 GitNexus \u4EE3\u7801\u56FE\uFF0C\u8BA9 AI \u5728\u5927\u8303\u56F4\u626B\u63CF\u524D\u4F18\u5148\u83B7\u5F97\u7ED3\u6784\u5316\u4EE3\u7801\u4E0A\u4E0B\u6587\u3002";
@@ -4653,16 +5403,26 @@ Steps:
    fet apply --change <change-id> --json
    \`\`\`
 3. Follow the native apply output. If JSON output is unavailable, read the files referenced by the terminal output and the artifacts under openspec/changes/<change-id>/.
-4. If apply is blocked because required artifacts are missing, stop and suggest /prompts:fet-continue <change-id> or /prompts:fet-ff <change-id>.
-5. Implement pending tasks one by one:
+4. If \`openspec/changes/<change-id>/.fet/figma-apply-instructions.md\` exists (or apply nextSteps mention Figma):
+   - Read it and \`figma-stop.md\` in the same folder before any UI code.
+   - Use Figma MCP/API to read every linked frame; briefly confirm design facts in your reply.
+   - If Figma access fails or design details are unclear, stop and ask the user\u2014do not guess styles or implement UI.
+5. If \`openspec/changes/<change-id>/.fet/ui-display-contract.yaml\` exists (or apply nextSteps mention UI display contract):
+   - Read it and \`ui-field-apply-instructions.md\` in the same folder before UI that binds API data.
+   - Confirm \`displayFields\` from Figma; list API-only fields under \`omittedFromUi\`.
+   - Do not render every OpenAPI property\u2014only fields in \`displayFields\`.
+6. If apply is blocked because required artifacts are missing, stop and suggest /prompts:fet-continue <change-id> or /prompts:fet-ff <change-id>.
+7. Implement pending tasks one by one:
    - Keep code changes minimal and scoped to the task.
    - Follow proposal, specs, design, and tasks.
    - Mark each completed task checkbox in tasks.md from \`- [ ]\` to \`- [x]\`.
    - Pause and ask if a task is ambiguous or reveals a design conflict.
-6. After completing or pausing, summarize completed tasks, remaining tasks, and blockers.
+8. After completing or pausing, summarize completed tasks, remaining tasks, and blockers.
 
 Guardrails:
 - Never skip reading OpenSpec artifacts before implementation.
+- When Figma links exist for this change, never implement or restyle UI without reading Figma first.
+- When ui-display-contract.yaml exists, API schemas are not UI checklists\u2014only displayFields may render.
 - Do not mark a task complete until the code change is actually done.
 - Do not run sync or archive from apply.`,
     void 0,
@@ -4723,6 +5483,7 @@ Steps:
    - Remove REMOVED requirements.
    - Apply RENAMED requirements.
    - Preserve main-spec content not mentioned in the delta.
+   - Follow .codex/fet/spec-language.md: keep English normative text; carry over or refresh \`<!-- \u4E2D\u6587\uFF1A... -->\` for every touched Requirement in the same edit.
 5. If no delta specs exist, state that there is nothing to merge.
 6. Run the FET sync gate and strict OpenSpec validation:
    \`\`\`sh
@@ -4960,6 +5721,7 @@ Steps:
 4. Follow the native output. When it provides template, instruction, dependencies, and outputPath, use those fields.
 5. Read dependency files before writing.
 6. Create only that artifact file at outputPath. Do not copy context/rules wrapper text into the artifact.
+   - If the artifact is specs/<capability>/spec.md, follow .codex/fet/spec-language.md: English Requirements/Scenario plus \`<!-- \u4E2D\u6587\uFF1A... -->\` after each Requirement title; update Chinese notes in the same edit when English changes.
 7. Verify the file exists, then run:
    \`\`\`sh
    fet passthrough status --change <change-id>
@@ -5004,6 +5766,7 @@ Steps:
 6. Follow the native continue output. When it provides template, instruction, dependencies, and outputPath, use those fields.
 7. Read dependency files before writing.
 8. Create the artifact file at outputPath. Do not copy context/rules wrapper text into the artifact; use those fields only as constraints.
+   - If the artifact is specs/<capability>/spec.md, follow .codex/fet/spec-language.md: English Requirements/Scenario plus \`<!-- \u4E2D\u6587\uFF1A... -->\` after each Requirement title; update Chinese notes in the same edit when English changes.
 9. Verify the file exists, then run:
    \`\`\`sh
    fet passthrough status --change <change-id>
@@ -5048,6 +5811,7 @@ Artifact rules:
 - Follow the instruction field from OpenSpec/FET for each artifact.
 - Use template as structure, filling it with concrete project-specific content.
 - Do not copy context/rules wrapper text into artifact files.
+- For specs/<capability>/spec.md, follow .codex/fet/spec-language.md (English canonical + \`<!-- \u4E2D\u6587\uFF1A... -->\`; update Chinese notes in the same edit when English changes).
 - Verify each file exists after writing.
 
 Output:
@@ -5096,7 +5860,7 @@ var CodexAdapter = class {
   adapterVersion = 1;
   async detect(projectRoot) {
     return {
-      detected: await exists5(join20(projectRoot, ".codex")) || await exists5(join20(projectRoot, "AGENTS.md")),
+      detected: await exists5(join21(projectRoot, ".codex")) || await exists5(join21(projectRoot, "AGENTS.md")),
       reason: "Codex adapter is available for projects that use AGENTS.md"
     };
   }
@@ -5162,9 +5926,9 @@ var CodexAdapter = class {
 };
 function resolveTarget(projectRoot, file) {
   if (file.root === "codex-home") {
-    return join20(resolveCodexHome(), file.path);
+    return join21(resolveCodexHome(), file.path);
   }
-  return join20(projectRoot, file.path);
+  return join21(projectRoot, file.path);
 }
 function displayPathFor(file) {
   if (file.root === "codex-home") {
@@ -5173,18 +5937,18 @@ function displayPathFor(file) {
   return file.path;
 }
 function resolveCodexHome() {
-  return process.env.FET_CODEX_HOME ?? process.env.CODEX_HOME ?? join20(homedir(), ".codex");
+  return process.env.FET_CODEX_HOME ?? process.env.CODEX_HOME ?? join21(homedir(), ".codex");
 }
 async function readExisting(path) {
   try {
-    return await readFile16(path, "utf8");
+    return await readFile17(path, "utf8");
   } catch {
     return null;
   }
 }
 async function exists5(path) {
   try {
-    await stat9(path);
+    await stat10(path);
     return true;
   } catch {
     return false;
@@ -5192,8 +5956,8 @@ async function exists5(path) {
 }
 
 // src/adapters/cursor/index.ts
-import { mkdir as mkdir9, readFile as readFile17, stat as stat10 } from "fs/promises";
-import { dirname as dirname9, join as join21 } from "path";
+import { mkdir as mkdir9, readFile as readFile18, stat as stat11 } from "fs/promises";
+import { dirname as dirname9, join as join22 } from "path";
 
 // src/adapters/cursor/templates.ts
 function cursorFigmaStopRuleFile(language = DEFAULT_LANGUAGE) {
@@ -5202,8 +5966,25 @@ function cursorFigmaStopRuleFile(language = DEFAULT_LANGUAGE) {
     content: renderCursorFigmaStopRule(language)
   };
 }
+function cursorSpecLanguageRuleFile(language = DEFAULT_LANGUAGE) {
+  return {
+    path: ".cursor/rules/fet-spec-language.mdc",
+    content: renderCursorSpecLanguageRule(language)
+  };
+}
+function cursorUiDisplayContractRuleFile(language = DEFAULT_LANGUAGE) {
+  return {
+    path: ".cursor/rules/fet-ui-display-contract.mdc",
+    content: renderCursorUiDisplayContractRule(language)
+  };
+}
 function cursorRuleFiles(language = DEFAULT_LANGUAGE) {
-  return [cursorRuleFile(language), cursorFigmaStopRuleFile(language)];
+  return [
+    cursorRuleFile(language),
+    cursorFigmaStopRuleFile(language),
+    cursorUiDisplayContractRuleFile(language),
+    cursorSpecLanguageRuleFile(language)
+  ];
 }
 function cursorSkillFiles(language = DEFAULT_LANGUAGE) {
   return FET_ADAPTER_COMMANDS.map((command) => ({
@@ -5234,7 +6015,9 @@ ${languageInstruction(language)}
 - openspec/config.yaml
 - \u53EF\u7528\u65F6\u7684 GitNexus \u4EE3\u7801\u56FE\u4E0A\u4E0B\u6587\u3002\u4F18\u5148\u7528\u5B83\u7F29\u5C0F\u8303\u56F4\uFF1B\u4E0D\u53EF\u7528\u65F6\u6309\u666E\u901A FET/OpenSpec \u5DE5\u4F5C\u6D41\u7EE7\u7EED\u3002
 - \u5F53\u524D change \u76EE\u5F55\u4E0B\u7684 OpenSpec \u89C4\u5212\u4EA7\u7269\u3002
-- \u6309 Figma \u5B9E\u73B0 UI \u65F6\u9075\u5B88 \`.cursor/rules/fet-figma-stop.mdc\`\uFF1B\u82E5\u5B58\u5728 \`openspec/changes/<change-id>/.fet/figma-stop.md\` \u987B\u5148\u9605\u8BFB\u3002
+- \u6309 Figma \u5B9E\u73B0 UI \u65F6\u9075\u5B88 \`.cursor/rules/fet-figma-stop.mdc\`\uFF1B\u82E5\u5B58\u5728 \`openspec/changes/<change-id>/.fet/figma-apply-instructions.md\` \u5FC5\u987B\u5728\u6539 UI \u524D\u5B8C\u6574\u6267\u884C\uFF1B\u540C\u76EE\u5F55 \`figma-stop.md\` \u542B\u94FE\u63A5\u4E0E\u505C\u6B62\u89C4\u5219\u3002
+- \u7F16\u5199\u6216\u4FEE\u6539 OpenSpec \`specs/**/spec.md\` \u65F6\u9075\u5B88 \`.cursor/rules/fet-spec-language.mdc\`\uFF08\u82F1\u6587\u89C4\u8303 + \`<!-- \u4E2D\u6587\uFF1A... -->\`\uFF0C\u540C\u6B21\u7F16\u8F91\u540C\u6B65\u66F4\u65B0\u4E2D\u6587\u8BF4\u660E\uFF09\u3002
+- \u7ED1\u5B9A\u63A5\u53E3\u7684 UI \u9075\u5B88 \`.cursor/rules/fet-ui-display-contract.mdc\`\uFF1B\u5B58\u5728 \`openspec/changes/<change-id>/.fet/ui-display-contract.yaml\` \u65F6\u5B9E\u65BD\u524D\u987B\u786E\u8BA4 displayFields\u3002
 
 \u5982\u679C\u7528\u6237\u8F93\u5165\u7C7B\u4F3C \`/fet apply\` \u7684\u8BF7\u6C42\uFF0C\u8BF7\u628A\u5B83\u89C6\u4E3A\u5DE5\u4F5C\u6D41\u610F\u56FE\uFF0C\u5E76\u63D0\u793A\u6216\u6267\u884C\u5BF9\u5E94\u7684\u7EC8\u7AEF\u547D\u4EE4 \`fet <cmd>\`\u3002
 `
@@ -5303,6 +6086,12 @@ After installation, verify with \`gitnexus --version\`, then run \`fet graph ini
 \u5B89\u88C5\u540E\u7528 \`gitnexus --version\` \u9A8C\u8BC1\uFF1B\u5408\u9002\u65F6\u7EE7\u7EED\u8FD0\u884C \`fet graph init\` \u548C \`fet graph handoff\`\u3002\u5982\u679C\u5B89\u88C5\u5931\u8D25\uFF0C\u6C47\u603B\u5931\u8D25\u547D\u4EE4\u548C\u4E0B\u4E00\u6B65\u4EBA\u5DE5\u5904\u7406\u5EFA\u8BAE\u3002`}
 `;
   }
+  if (command === "apply") {
+    return renderApplySkill(usage, language);
+  }
+  if (command === "propose" || command === "continue" || command === "ff") {
+    return renderPlanningSkill(command, usage, language);
+  }
   return `<!-- FET:MANAGED
 schemaVersion: 1
 fetVersion: ${FET_VERSION}
@@ -5332,6 +6121,93 @@ ${usage}
 \u6267\u884C\u524D\u8BF7\u786E\u8BA4\u5DF2\u9605\u8BFB AGENTS.md \u548C openspec/config.yaml\u3002
 `;
 }
+function renderPlanningSkill(command, usage, language) {
+  const title = command === "propose" ? language === "en" ? "Create OpenSpec change and first artifact" : "\u521B\u5EFA OpenSpec change \u5E76\u751F\u6210\u9996\u4E2A\u89C4\u5212\u4EA7\u7269" : command === "ff" ? language === "en" ? "Fast-forward OpenSpec artifacts" : "\u5FEB\u8FDB\u751F\u6210 OpenSpec \u89C4\u5212\u4EA7\u7269" : language === "en" ? "Create next OpenSpec artifact" : "\u751F\u6210\u4E0B\u4E00\u4E2A OpenSpec \u89C4\u5212\u4EA7\u7269";
+  return `<!-- FET:MANAGED
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generator: cursor-adapter
+adapterVersion: 1
+command: ${usage}
+FET:END -->
+
+---
+name: fet-${command}
+description: ${title}
+disable-model-invocation: true
+---
+
+${renderIdeModelPolicy(command, language)}
+
+${languageInstruction(language)}
+
+\u8BF7\u5728\u7EC8\u7AEF\u4E2D\u6267\u884C\uFF1A
+
+\`\`\`sh
+${usage}
+\`\`\`
+
+${renderPlanningArtifactSpecBlock(language)}
+
+${renderSpecArtifactGuardrail(language)}
+
+${renderUiDisplayContractGuardrail(language)}
+
+\u6267\u884C\u524D\u8BF7\u9605\u8BFB AGENTS.md\u3001openspec/config.yaml\uFF08\u542B \`fet.specLanguage\`\uFF09\u4E0E\u5F53\u524D change \u5DF2\u6709\u4EA7\u7269\u3002
+`;
+}
+function renderApplySkill(usage, language) {
+  const uiContractBlock = language === "en" ? `If \`openspec/changes/<change-id>/.fet/ui-display-contract.yaml\` exists:
+
+1. Read it and \`ui-field-apply-instructions.md\` in the same folder before UI that binds API data.
+2. Confirm \`displayFields\` from Figma; put API-only fields in \`omittedFromUi\`.
+3. Do not render every OpenAPI property\u2014only contracted display fields.` : `\u82E5\u5B58\u5728 \`openspec/changes/<change-id>/.fet/ui-display-contract.yaml\`\uFF1A
+
+1. \u5728\u7ED1\u5B9A\u63A5\u53E3\u7684 UI \u5B9E\u65BD\u524D\u9605\u8BFB\u8BE5\u6587\u4EF6\u4E0E\u540C\u76EE\u5F55 \`ui-field-apply-instructions.md\`\u3002
+2. \u6309 Figma \u786E\u8BA4 \`displayFields\`\uFF1B\u4EC5\u63A5\u53E3\u6709\u7684\u5B57\u6BB5\u653E\u5165 \`omittedFromUi\`\u3002
+3. \u7981\u6B62\u6309 OpenAPI \u5168\u91CF\u5C55\u793A\u2014\u53EA\u6E32\u67D3\u5951\u7EA6\u4E2D\u7684 displayFields\u3002`;
+  const figmaBlock = language === "en" ? `If \`fet apply\` output or the change has \`openspec/changes/<change-id>/.fet/figma-apply-instructions.md\`:
+
+1. Read that file and \`figma-stop.md\` in the same folder before any UI code.
+2. Use Figma MCP/API to read every linked frame; do not invent colors, spacing, or layout.
+3. If Figma fails or design is unclear, stop and ask the user\u2014do not guess styles or mark UI tasks done.
+4. After design is confirmed, implement tasks from \`tasks.md\`.` : `\u82E5 \`fet apply\` \u8F93\u51FA\u6216 change \u4E2D\u5B58\u5728 \`openspec/changes/<change-id>/.fet/figma-apply-instructions.md\`\uFF1A
+
+1. \u5728\u6539\u4EFB\u4F55 UI \u4EE3\u7801\u524D\uFF0C\u5148\u9605\u8BFB\u8BE5\u6587\u4EF6\u4E0E\u540C\u76EE\u5F55 \`figma-stop.md\`\u3002
+2. \u7528 Figma MCP/API \u8BFB\u53D6\u6BCF\u4E2A\u94FE\u63A5\u7684\u753B\u677F\uFF1B\u7981\u6B62\u81EA\u521B\u989C\u8272\u3001\u95F4\u8DDD\u3001\u5E03\u5C40\u3002
+3. Figma \u5931\u8D25\u6216\u8BBE\u8BA1\u4E0D\u6E05\u65F6\u7ACB\u5373\u505C\u6B62\u5E76\u5411\u7528\u6237\u63D0\u95EE\uFF0C\u4E0D\u8981\u731C\u6837\u5F0F\uFF0C\u4E0D\u8981\u628A UI \u4EFB\u52A1\u6807\u4E3A\u5B8C\u6210\u3002
+4. \u8BBE\u8BA1\u786E\u8BA4\u540E\uFF0C\u518D\u6309 \`tasks.md\` \u5B9E\u65BD\u4EFB\u52A1\u3002`;
+  return `<!-- FET:MANAGED
+schemaVersion: 1
+fetVersion: ${FET_VERSION}
+generator: cursor-adapter
+adapterVersion: 1
+command: ${usage}
+FET:END -->
+
+---
+name: fet-apply
+description: ${language === "en" ? "Implement OpenSpec tasks; require Figma when design links exist" : "\u5B9E\u65BD OpenSpec \u4EFB\u52A1\uFF1B\u6709 Figma \u94FE\u63A5\u65F6\u5FC5\u987B\u5148\u6309\u7A3F\u5B9E\u73B0"}
+disable-model-invocation: true
+---
+
+${renderIdeModelPolicy("apply", language)}
+
+${languageInstruction(language)}
+
+\u8BF7\u5728\u7EC8\u7AEF\u4E2D\u6267\u884C\uFF1A
+
+\`\`\`sh
+${usage}
+\`\`\`
+
+${figmaBlock}
+
+${uiContractBlock}
+
+\u6267\u884C\u524D\u8BF7\u9605\u8BFB AGENTS.md\u3001openspec/config.yaml \u4E0E\u5F53\u524D change \u4E0B\u7684 OpenSpec \u4EA7\u7269\u3002
+`;
+}
 
 // src/adapters/cursor/index.ts
 var CursorAdapter = class {
@@ -5339,7 +6215,7 @@ var CursorAdapter = class {
   adapterVersion = 1;
   async detect(projectRoot) {
     return {
-      detected: await exists6(join21(projectRoot, ".cursor")),
+      detected: await exists6(join22(projectRoot, ".cursor")),
       reason: "Cursor adapter is available for any project"
     };
   }
@@ -5356,7 +6232,7 @@ var CursorAdapter = class {
     const written = [];
     const skipped = [];
     for (const file of plan.files) {
-      const target = join21(projectRoot, file.path);
+      const target = join22(projectRoot, file.path);
       const existing = await readExisting2(target);
       if (existing && !existing.includes("FET:MANAGED") && !force) {
         throw new FetError({
@@ -5379,7 +6255,7 @@ var CursorAdapter = class {
     const plan = await this.planInstall(projectRoot);
     const checks = [];
     for (const file of plan.files) {
-      const target = join21(projectRoot, file.path);
+      const target = join22(projectRoot, file.path);
       const content = await readExisting2(target);
       const managed = Boolean(content?.includes("FET:MANAGED"));
       const versionMatches = Boolean(content?.includes(`adapterVersion: ${this.adapterVersion}`));
@@ -5395,14 +6271,14 @@ var CursorAdapter = class {
 };
 async function readExisting2(path) {
   try {
-    return await readFile17(path, "utf8");
+    return await readFile18(path, "utf8");
   } catch {
     return null;
   }
 }
 async function exists6(path) {
   try {
-    await stat10(path);
+    await stat11(path);
     return true;
   } catch {
     return false;
@@ -5414,13 +6290,13 @@ import { execFile as execFile4 } from "child_process";
 import { promisify as promisify4 } from "util";
 
 // src/openspec/inspector.ts
-import { readdir as readdir4, stat as stat11 } from "fs/promises";
-import { join as join22 } from "path";
+import { readdir as readdir5, stat as stat12 } from "fs/promises";
+import { join as join23 } from "path";
 async function inspectOpenSpecProject(projectRoot) {
-  const openspecPath = join22(projectRoot, "openspec");
-  const changesPath = join22(openspecPath, "changes");
-  const legacyArchivePath = join22(openspecPath, "archive");
-  const changesArchivePath = join22(changesPath, "archive");
+  const openspecPath = join23(projectRoot, "openspec");
+  const changesPath = join23(openspecPath, "changes");
+  const legacyArchivePath = join23(openspecPath, "archive");
+  const changesArchivePath = join23(changesPath, "archive");
   return {
     exists: await exists7(openspecPath),
     changes: await listDirectories(changesPath, { exclude: ["archive"] }),
@@ -5428,13 +6304,13 @@ async function inspectOpenSpecProject(projectRoot) {
   };
 }
 async function inspectOpenSpecChange(projectRoot, changeId) {
-  const changePath = join22(projectRoot, "openspec", "changes", changeId);
-  const tasksPath = join22(changePath, "tasks.md");
-  const specsPath = join22(changePath, "specs");
+  const changePath = join23(projectRoot, "openspec", "changes", changeId);
+  const tasksPath = join23(changePath, "tasks.md");
+  const specsPath = join23(changePath, "specs");
   return {
     changeId,
     exists: await exists7(changePath),
-    hasProposal: await exists7(join22(changePath, "proposal.md")),
+    hasProposal: await exists7(join23(changePath, "proposal.md")),
     hasTasks: await exists7(tasksPath),
     hasSpecs: await exists7(specsPath),
     tasksPath,
@@ -5443,7 +6319,7 @@ async function inspectOpenSpecChange(projectRoot, changeId) {
 }
 async function listDirectories(path, options = {}) {
   try {
-    const entries = await readdir4(path, { withFileTypes: true });
+    const entries = await readdir5(path, { withFileTypes: true });
     const excluded = new Set(options.exclude ?? []);
     return entries.filter((entry) => entry.isDirectory() && !excluded.has(entry.name)).map((entry) => entry.name);
   } catch {
@@ -5452,7 +6328,7 @@ async function listDirectories(path, options = {}) {
 }
 async function exists7(path) {
   try {
-    await stat11(path);
+    await stat12(path);
     return true;
   } catch {
     return false;
@@ -5635,13 +6511,13 @@ function escapeRegExp(value) {
 }
 
 // src/scanner/routes.ts
-import { readdir as readdir5, stat as stat12 } from "fs/promises";
-import { join as join23, relative as relative3, sep } from "path";
+import { readdir as readdir6, stat as stat13 } from "fs/promises";
+import { join as join24, relative as relative4, sep } from "path";
 async function scanRoutes(projectRoot) {
   const candidates = ["src/routes", "src/pages", "app", "pages"];
   const routes = [];
   for (const candidate of candidates) {
-    const root = join23(projectRoot, candidate);
+    const root = join24(projectRoot, candidate);
     if (!await exists8(root)) {
       continue;
     }
@@ -5650,8 +6526,8 @@ async function scanRoutes(projectRoot) {
         continue;
       }
       routes.push({
-        path: inferRoutePath(relative3(root, file)),
-        source: relative3(projectRoot, file).split(sep).join("/"),
+        path: inferRoutePath(relative4(root, file)),
+        source: relative4(projectRoot, file).split(sep).join("/"),
         inferred: true,
         confidence: "medium"
       });
@@ -5666,10 +6542,10 @@ function inferRoutePath(relativePath) {
   return `/${withoutIndex}`.replace(/\/+/g, "/");
 }
 async function listFiles(root) {
-  const entries = await readdir5(root, { withFileTypes: true });
+  const entries = await readdir6(root, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
-    const path = join23(root, entry.name);
+    const path = join24(root, entry.name);
     if (entry.isDirectory()) {
       files.push(...await listFiles(path));
     } else {
@@ -5680,7 +6556,7 @@ async function listFiles(root) {
 }
 async function exists8(path) {
   try {
-    await stat12(path);
+    await stat13(path);
     return true;
   } catch {
     return false;
@@ -5837,9 +6713,9 @@ async function createCommandContext(command, options) {
 import { createInterface as createInterface2 } from "readline/promises";
 
 // src/update/check.ts
-import { mkdir as mkdir10, readFile as readFile18, writeFile } from "fs/promises";
+import { mkdir as mkdir10, readFile as readFile19, writeFile } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import { dirname as dirname10, join as join24 } from "path";
+import { dirname as dirname10, join as join25 } from "path";
 var DEFAULT_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
 function getFetUpdateCheckMode(env = process.env) {
   const value = env.FET_UPDATE_CHECK?.trim().toLowerCase();
@@ -5912,11 +6788,11 @@ function formatFetUpdateWarning(availability, language) {
 }
 function cachePath() {
   const home = process.env.FET_UPDATE_CHECK_CACHE_HOME?.trim() || homedir2();
-  return join24(home, ".fet", "update-check-cache.json");
+  return join25(home, ".fet", "update-check-cache.json");
 }
 async function readUpdateCheckCache() {
   try {
-    const raw = await readFile18(cachePath(), "utf8");
+    const raw = await readFile19(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.latestVersion !== "string" || typeof parsed.checkedAt !== "string") {
       return null;