@nick848/fet 1.1.3 → 1.1.5

package/README.md

@@ -50,6 +50,7 @@ fet --help
 
 ```sh
 fet init
+fet fill-context
 fet doctor
 ```
 
@@ -95,6 +96,18 @@ fet init --lang en
 | `--verbose` | 输出更多诊断信息。 | `fet doctor --verbose` |
 | `--no-color` | 禁用终端颜色。 | `fet --no-color doctor` |
 
+### 版本更新检查
+
+除 `fet update` 外，FET 在执行其他命令前会检查 npm 上是否有新版本（默认缓存 6 小时）。发现新版本时会提示当前版本与最新版本；在交互式终端中可选择立即升级、跳过并继续当前任务，或取消命令。
+
+| 环境变量 | 说明 |
+|----------|------|
+| `FET_UPDATE_CHECK` | `off` 关闭检查；`warn` 仅警告并继续；`confirm` 在 TTY 中交互询问（默认）。 |
+| `FET_SKIP_UPDATE_CHECK` | 设为 `1` 时等同于 `FET_UPDATE_CHECK=off`。 |
+| `FET_UPDATE_CHECK_TTL_MS` | 版本检查缓存时长（毫秒），默认 `21600000`（6 小时）。 |
+
+使用 `--yes` 或 `--json` 时会跳过交互式升级询问；跳过某版本后，同一最新版本不会重复提示，直到检测到更高的新版本。
+
 ## 命令列表
 
 | 命令 | 用法 | 说明 |
@@ -104,7 +117,7 @@ fet init --lang en
 | `fet fill-context` | `fet fill-context [--yes]` | 刷新 IDE 交接命令，引导 AI 替换 `AGENTS.md` 占位符。 |
 | `fet doctor` | `fet doctor [--fix-lock]` | 诊断 OpenSpec、FET 状态、上下文文件、工具集成和锁文件。 |
 | `fet explore` | `fet explore [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 explore，保留交互式需求澄清。 |
-| `fet propose` | `fet propose <change-id>` | 创建新的 OpenSpec change，并进入提案工作流。 |
+| `fet propose` | `fet propose <change-id-or-description>` | 创建 OpenSpec change，并生成第一个 ready 规划产物；后续产物用 `continue` 逐步推进。 |
 | `fet new` | `fet new <change-id>` | 创建新的 OpenSpec change。 |
 | `fet continue` | `fet continue [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 continue。 |
 | `fet ff` | `fet ff [...args] [--change <id>]` | 通过 FET 执行 OpenSpec 原生 ff。 |

package/README_en.md

@@ -51,6 +51,7 @@ Run this in a project root that should use OpenSpec:
 
 ```sh
 fet init
+fet fill-context
 fet doctor
 ```
 
@@ -96,6 +97,18 @@ fet init --lang en
 | `--verbose` | Print more diagnostics. | `fet doctor --verbose` |
 | `--no-color` | Disable terminal colors. | `fet --no-color doctor` |
 
+### Version update check
+
+Before most commands (except `fet update`), FET checks npm for a newer release (cached for 6 hours by default). When an update is available, it prints the current and latest versions. In an interactive terminal you can upgrade now, skip and continue the current task, or cancel the command.
+
+| Variable | Description |
+|----------|-------------|
+| `FET_UPDATE_CHECK` | `off` disables checks; `warn` prints a warning and continues; `confirm` prompts in a TTY (default). |
+| `FET_SKIP_UPDATE_CHECK` | Set to `1` to disable checks (same as `FET_UPDATE_CHECK=off`). |
+| `FET_UPDATE_CHECK_TTL_MS` | Cache TTL in milliseconds; default `21600000` (6 hours). |
+
+`--yes` and `--json` skip the interactive upgrade prompt. If you skip a specific latest version, FET will not prompt again for that version until a newer release appears.
+
 ## Commands
 
 | Command | Usage | Description |
@@ -106,7 +119,7 @@ fet init --lang en
 | `fet fill-context` | `fet fill-context [--yes]` | Refresh IDE handoff commands that ask AI to replace `AGENTS.md` placeholders. |
 | `fet doctor` | `fet doctor [--fix-lock]` | Diagnose OpenSpec, FET state, context files, tool integration, and lock files. |
 | `fet explore` | `fet explore [...args] [--change <id>]` | Run native OpenSpec explore through FET so clarification prompts remain interactive. |
-| `fet propose` | `fet propose <change-id>` | Create a new OpenSpec change and enter the proposal workflow. |
+| `fet propose` | `fet propose <change-id-or-description>` | Create an OpenSpec change and the first ready planning artifact; use `continue` for each subsequent artifact after review. |
 | `fet new` | `fet new <change-id>` | Create a new OpenSpec change. |
 | `fet continue` | `fet continue [...args] [--change <id>]` | Run native OpenSpec continue through FET. |
 | `fet ff` | `fet ff [...args] [--change <id>]` | Run native OpenSpec ff through FET. |

package/dist/cli/index.js

@@ -5,7 +5,7 @@ import {
 } from "../chunk-J5WB4KAL.js";
 
 // src/cli/index.ts
-import { createInterface as createInterface2 } from "readline/promises";
+import { createInterface as createInterface3 } from "readline/promises";
 import { Command } from "commander";
 
 // src/commands/doctor.ts
@@ -2287,8 +2287,9 @@ async function artifactWorkflowCommand(ctx, command, args) {
       warnings: runState.graphContext?.warnings,
       nextSteps: [
         `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}`
+        status.isComplete ? `Run fet apply --change ${changeId}` : `Run fet continue --change ${changeId} when ready for the next artifact`
       ],
       data: {
         changeId,
@@ -2678,60 +2679,16 @@ async function assertVerifiedChange(ctx, changeId) {
   }
 }
 
-// src/commands/update.ts
+// src/update/npm.ts
 import { spawn } from "child_process";
-var DEFAULT_PACKAGE_NAME = "@nick848/fet";
-async function updateCommand(ctx) {
-  const packageName = process.env.FET_UPDATE_PACKAGE_NAME ?? DEFAULT_PACKAGE_NAME;
-  const npmExecutable = process.env.FET_UPDATE_NPM_EXECUTABLE ?? defaultNpmExecutable();
-  const latestVersion = await resolveLatestVersion(packageName, npmExecutable);
-  const currentVersion = ctx.fetVersion;
-  if (compareVersions(currentVersion, latestVersion) >= 0) {
-    ctx.output.result({
-      ok: true,
-      command: "update",
-      summary: ctx.language === "en" ? `FET is already up to date (${currentVersion}).` : `FET \u5DF2\u662F\u6700\u65B0\u7248 (${currentVersion})\u3002`,
-      data: {
-        packageName,
-        currentVersion,
-        latestVersion,
-        updated: false
-      }
-    });
-    return;
-  }
-  if (!ctx.json) {
-    ctx.output.info(
-      ctx.language === "en" ? `Updating FET from ${currentVersion} to ${latestVersion}...` : `\u6B63\u5728\u5C06 FET \u4ECE ${currentVersion} \u5347\u7EA7\u5230 ${latestVersion}...`
-    );
-  }
-  const installArgs = ["install", "-g", `${packageName}@latest`];
-  const result = await runNpm(npmExecutable, installArgs, {
-    cwd: ctx.cwd,
-    stdio: ctx.json ? "pipe" : "inherit"
-  });
-  if (result.exitCode !== 0) {
-    throw new FetError({
-      code: "UPDATE_FAILED" /* UpdateFailed */,
-      message: ctx.language === "en" ? "FET update failed." : "FET \u5347\u7EA7\u5931\u8D25\u3002",
-      details: result,
-      suggestedCommand: `${npmExecutable} ${installArgs.join(" ")}`
-    });
-  }
-  ctx.output.result({
-    ok: true,
-    command: "update",
-    summary: ctx.language === "en" ? `FET updated from ${currentVersion} to ${latestVersion}.` : `FET \u5DF2\u4ECE ${currentVersion} \u5347\u7EA7\u5230 ${latestVersion}\u3002`,
-    data: {
-      packageName,
-      currentVersion,
-      latestVersion,
-      updated: true,
-      installCommand: `${npmExecutable} ${installArgs.join(" ")}`
-    }
-  });
+var DEFAULT_FET_PACKAGE_NAME = "@nick848/fet";
+function getFetPackageName(env = process.env) {
+  return env.FET_UPDATE_PACKAGE_NAME?.trim() || DEFAULT_FET_PACKAGE_NAME;
 }
-async function resolveLatestVersion(packageName, npmExecutable) {
+function getNpmExecutable(env = process.env) {
+  return env.FET_UPDATE_NPM_EXECUTABLE?.trim() || (process.platform === "win32" ? "npm.cmd" : "npm");
+}
+async function resolveLatestFetVersion(packageName = getFetPackageName(), npmExecutable = getNpmExecutable()) {
   const override = process.env.FET_UPDATE_LATEST_VERSION?.trim();
   if (override) {
     return override;
@@ -2758,6 +2715,32 @@ async function resolveLatestVersion(packageName, npmExecutable) {
   }
   return version;
 }
+async function performFetUpdate(currentVersion, latestVersion, options) {
+  const packageName = getFetPackageName();
+  const npmExecutable = getNpmExecutable();
+  const installArgs = ["install", "-g", `${packageName}@latest`];
+  if (!options.json) {
+    options.info(
+      options.language === "en" ? `Updating FET from ${currentVersion} to ${latestVersion}...` : `\u6B63\u5728\u5C06 FET \u4ECE ${currentVersion} \u5347\u7EA7\u5230 ${latestVersion}...`
+    );
+  }
+  const result = await runNpm(npmExecutable, installArgs, {
+    cwd: options.cwd,
+    stdio: options.json ? "pipe" : "inherit"
+  });
+  if (result.exitCode !== 0) {
+    throw new FetError({
+      code: "UPDATE_FAILED" /* UpdateFailed */,
+      message: options.language === "en" ? "FET update failed." : "FET \u5347\u7EA7\u5931\u8D25\u3002",
+      details: result,
+      suggestedCommand: `${npmExecutable} ${installArgs.join(" ")}`
+    });
+  }
+  return {
+    packageName,
+    installCommand: `${npmExecutable} ${installArgs.join(" ")}`
+  };
+}
 function parseNpmVersion(stdout) {
   const trimmed = stdout.trim();
   if (!trimmed) {
@@ -2804,9 +2787,6 @@ function runNpm(command, args, options) {
     });
   });
 }
-function defaultNpmExecutable() {
-  return process.platform === "win32" ? "npm.cmd" : "npm";
-}
 function compareVersions(left, right) {
   const leftVersion = parseVersion(left);
   const rightVersion = parseVersion(right);
@@ -2867,6 +2847,45 @@ function comparePrereleasePart(left, right) {
   return left.localeCompare(right);
 }
 
+// src/commands/update.ts
+async function updateCommand(ctx) {
+  const packageName = getFetPackageName();
+  const latestVersion = await resolveLatestFetVersion(packageName);
+  const currentVersion = ctx.fetVersion;
+  if (compareVersions(currentVersion, latestVersion) >= 0) {
+    ctx.output.result({
+      ok: true,
+      command: "update",
+      summary: ctx.language === "en" ? `FET is already up to date (${currentVersion}).` : `FET \u5DF2\u662F\u6700\u65B0\u7248 (${currentVersion})\u3002`,
+      data: {
+        packageName,
+        currentVersion,
+        latestVersion,
+        updated: false
+      }
+    });
+    return;
+  }
+  const install = await performFetUpdate(currentVersion, latestVersion, {
+    cwd: ctx.cwd,
+    json: ctx.json,
+    language: ctx.language,
+    info: (message) => ctx.output.info(message)
+  });
+  ctx.output.result({
+    ok: true,
+    command: "update",
+    summary: ctx.language === "en" ? `FET updated from ${currentVersion} to ${latestVersion}.` : `FET \u5DF2\u4ECE ${currentVersion} \u5347\u7EA7\u5230 ${latestVersion}\u3002`,
+    data: {
+      packageName,
+      currentVersion,
+      latestVersion,
+      updated: true,
+      installCommand: install.installCommand
+    }
+  });
+}
+
 // src/commands/verify.ts
 import { createHash } from "crypto";
 import { mkdir as mkdir7, readFile as readFile12, stat as stat5 } from "fs/promises";
@@ -3442,12 +3461,15 @@ After the command completes, report the GitNexus state, generated handoff files,
 `;
 }
 function renderSlashPrompt(command, language) {
-  if (command === "ff" || command === "propose") {
-    return renderFastForwardSlashPrompt(command, language);
+  if (command === "ff") {
+    return renderFastForwardSlashPrompt(language);
   }
   if (language !== "en") {
     return renderSlashPromptZh(command);
   }
+  if (command === "propose") {
+    return renderProposeSlashPrompt(language);
+  }
   if (command === "continue") {
     return renderContinueSlashPrompt(language);
   }
@@ -3561,12 +3583,12 @@ ${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" ? "- \u66FF\u6362 AGENTS.md \u4E2D\u6BCF\u4E2A `[NEEDS LLM INPUT]` \u6216 `[NEED 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 === "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 === "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" ? "- \u66FF\u6362 AGENTS.md \u4E2D\u6BCF\u4E2A `[NEEDS LLM INPUT]` \u6216 `[NEED 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" : ""}`;
 }
 function commandTitleZh(command) {
   const titles = {
     explore: "\u63A2\u7D22 FET/OpenSpec \u9700\u6C42",
-    propose: "\u521B\u5EFA\u5E76\u8865\u9F50 FET/OpenSpec \u63D0\u6848\u4EA7\u7269",
+    propose: "\u521B\u5EFA FET/OpenSpec change \u5E76\u751F\u6210\u9996\u4E2A\u89C4\u5212\u4EA7\u7269",
     new: "\u521B\u5EFA\u65B0\u7684 FET/OpenSpec change \u9AA8\u67B6",
     continue: "\u63A8\u8FDB\u5F53\u524D FET/OpenSpec change \u7684\u4E0B\u4E00\u4E2A\u4EA7\u7269",
     ff: "\u5FEB\u901F\u751F\u6210 FET/OpenSpec \u6240\u9700\u4EA7\u7269",
@@ -3591,9 +3613,15 @@ function commandGoalZh(command) {
   if (command === "fill-context") {
     return "\u8865\u9F50 FET \u81EA\u52A8\u751F\u6210\u7684\u9879\u76EE\u4E0A\u4E0B\u6587\uFF0C\u8BA9\u540E\u7EED AI \u7F16\u7801\u548C OpenSpec \u5DE5\u4F5C\u6D41\u62E5\u6709\u7A33\u5B9A\u7684\u9879\u76EE\u4E8B\u5B9E\u3002";
   }
+  if (command === "propose") {
+    return "\u6839\u636E change id \u6216\u63CF\u8FF0\u521B\u5EFA OpenSpec change\uFF08\u5982\u4E0D\u5B58\u5728\uFF09\uFF0C\u5E76\u53EA\u751F\u6210\u5F53\u524D\u7B2C\u4E00\u4E2A ready \u7684\u89C4\u5212\u4EA7\u7269\u3002";
+  }
   if (command === "continue") {
     return "\u57FA\u4E8E active change \u6216\u7528\u6237\u6307\u5B9A\u7684 change\uFF0C\u521B\u5EFA\u4E0B\u4E00\u4E2A ready \u7684 OpenSpec \u89C4\u5212\u4EA7\u7269\u3002";
   }
+  if (command === "ff") {
+    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";
   }
@@ -4007,6 +4035,45 @@ Guardrails:
     language
   );
 }
+function renderProposeSlashPrompt(language) {
+  return renderManagedSlashPrompt(
+    "fet propose [...args]",
+    "Create a FET/OpenSpec change and its first ready artifact",
+    `Start proposal planning for a FET-managed OpenSpec change by creating exactly one ready artifact.
+
+Input after the slash command may be a change id or a short description of what the user wants to build. If omitted, ask the user.
+
+Steps:
+
+1. Load project context from AGENTS.md and openspec/config.yaml.
+2. Derive a kebab-case change id when the user provided a description. If ambiguous, ask the user.
+3. Run the native OpenSpec propose flow through FET. This creates the change when needed and returns instructions for only the next ready artifact:
+   \`\`\`sh
+   fet propose <change-id-or-description> --json
+   \`\`\`
+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.
+7. Verify the file exists, then run:
+   \`\`\`sh
+   fet passthrough status --change <change-id>
+   \`\`\`
+
+Output:
+- Change id and location.
+- Which single artifact was created and its file path.
+- Current status.
+- Tell the user to review the artifact and run /prompts:fet-continue <change-id> when ready for the next artifact. Mention /prompts:fet-ff <change-id> only if they explicitly want to fast-forward all remaining artifacts.
+
+Guardrails:
+- Create one artifact per invocation. Do not run fet continue or fet ff in the same session unless the user explicitly asks after reviewing the artifact just created.
+- Never skip dependency order.
+- Do not substitute one FET/OpenSpec workflow command for another after a command-not-found or unsupported-version error.
+- Ask the user if instructions are ambiguous enough that a useful artifact cannot be written.`,
+    void 0,
+    language
+  );
+}
 function renderContinueSlashPrompt(language) {
   return renderManagedSlashPrompt(
     "fet continue [...args]",
@@ -4049,27 +4116,27 @@ Guardrails:
     language
   );
 }
-function renderFastForwardSlashPrompt(command, language) {
-  const title = language === "en" ? command === "propose" ? "Propose a new FET/OpenSpec change" : "Fast-forward FET/OpenSpec artifact creation" : command === "propose" ? "\u521B\u5EFA\u5E76\u8865\u9F50 FET/OpenSpec \u63D0\u6848\u4EA7\u7269" : "\u5FEB\u901F\u751F\u6210 FET/OpenSpec \u6240\u9700\u4EA7\u7269";
-  const commandLine = command === "propose" ? "fet propose <change-id-or-description>" : "fet ff --change <change-id>";
+function renderFastForwardSlashPrompt(language) {
   return renderManagedSlashPrompt(
-    `fet ${command} [...args]`,
-    language === "en" ? command === "propose" ? "Create a change and generate required OpenSpec artifacts" : "Generate required OpenSpec artifacts for a change" : command === "propose" ? "\u521B\u5EFA\u5E76\u8865\u9F50 FET/OpenSpec \u63D0\u6848\u4EA7\u7269" : "\u5FEB\u901F\u751F\u6210 FET/OpenSpec \u6240\u9700\u4EA7\u7269",
-    `${title}.
+    "fet ff [...args]",
+    language === "en" ? "Fast-forward FET/OpenSpec artifact creation" : "\u5FEB\u901F\u751F\u6210 FET/OpenSpec \u6240\u9700\u4EA7\u7269",
+    `${language === "en" ? "Fast-forward FET/OpenSpec artifact creation" : "\u5FEB\u901F\u751F\u6210 FET/OpenSpec \u6240\u9700\u4EA7\u7269"}.
 
-Input after the slash command may be a change id or a description of what the user wants to build. For ff, it may be omitted when the active OpenSpec change is unambiguous.
+Use this command only when the user explicitly wants to generate all remaining planning artifacts in one session without reviewing each artifact between steps. For step-by-step review, use /prompts:fet-propose or /prompts:fet-continue instead.
+
+Input after the slash command may be a change id. It may be omitted when the active OpenSpec change is unambiguous.
 
 Steps:
 
 1. Load project context from AGENTS.md and openspec/config.yaml.
-2. Resolve the change id or description. If ambiguous, ask the user.
-3. Run the native OpenSpec ${command} flow through FET:
+2. Resolve the change id. If ambiguous, ask the user.
+3. Run the native OpenSpec ff flow through FET:
    \`\`\`sh
-   ${commandLine}
+   fet ff --change <change-id>
    \`\`\`
 4. Follow the native output. If it asks for clarification, ask the user rather than inventing details.
-5. If the native output includes artifact paths or templates to write, create only those files and preserve OpenSpec structure.
-6. If FET reports that the OpenSpec CLI does not expose the requested command, stop immediately. Do not run \`fet ff\`, \`openspec ff\`, \`openspec change\`, or any alternative workflow command unless the user explicitly chooses that fallback after seeing the error.
+5. If the native output includes artifact paths or templates to write, create those files and preserve OpenSpec structure.
+6. If FET reports that the OpenSpec CLI does not expose the requested command, stop immediately. Do not run \`fet continue\`, \`openspec change\`, or any alternative workflow command unless the user explicitly chooses that fallback after seeing the error.
 
 Artifact rules:
 - Follow the instruction field from OpenSpec/FET for each artifact.
@@ -4974,6 +5041,173 @@ async function createCommandContext(command, options) {
   };
 }
 
+// src/cli/update-check.ts
+import { createInterface as createInterface2 } from "readline/promises";
+
+// src/update/check.ts
+import { mkdir as mkdir10, readFile as readFile16, writeFile } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname10, join as join21 } from "path";
+var DEFAULT_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
+function getFetUpdateCheckMode(env = process.env) {
+  const value = env.FET_UPDATE_CHECK?.trim().toLowerCase();
+  if (value === "off" || env.FET_SKIP_UPDATE_CHECK === "1") {
+    return "off";
+  }
+  if (value === "warn") {
+    return "warn";
+  }
+  if (value === "confirm") {
+    return "confirm";
+  }
+  return "confirm";
+}
+function shouldCheckFetUpdateForCommand(command) {
+  return command !== "update";
+}
+async function resolveFetUpdateAvailability(currentVersion) {
+  const packageName = getFetPackageName();
+  const cache = await readUpdateCheckCache();
+  const ttlMs = Number.parseInt(process.env.FET_UPDATE_CHECK_TTL_MS ?? "", 10);
+  const cacheTtlMs = Number.isFinite(ttlMs) && ttlMs > 0 ? ttlMs : DEFAULT_CACHE_TTL_MS;
+  let latestVersion = cache?.latestVersion;
+  const cacheFresh = cache?.checkedAt ? Date.now() - Date.parse(cache.checkedAt) < cacheTtlMs : false;
+  if (!latestVersion || !cacheFresh) {
+    try {
+      latestVersion = await resolveLatestFetVersion(packageName);
+      await writeUpdateCheckCache({
+        latestVersion,
+        checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        dismissedLatestVersion: cache?.dismissedLatestVersion
+      });
+    } catch {
+      if (cache?.latestVersion) {
+        latestVersion = cache.latestVersion;
+      } else {
+        return null;
+      }
+    }
+  }
+  if (compareVersions(currentVersion, latestVersion) >= 0) {
+    return null;
+  }
+  if (cache?.dismissedLatestVersion === latestVersion) {
+    return null;
+  }
+  return {
+    packageName,
+    currentVersion,
+    latestVersion
+  };
+}
+async function rememberDismissedFetUpdate(latestVersion) {
+  const cache = await readUpdateCheckCache() ?? {
+    latestVersion,
+    checkedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await writeUpdateCheckCache({
+    ...cache,
+    latestVersion,
+    checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    dismissedLatestVersion: latestVersion
+  });
+}
+function formatFetUpdateWarning(availability, language) {
+  if (language === "en") {
+    return `A newer FET release is available (${availability.currentVersion} -> ${availability.latestVersion}). Run \`fet update\` or choose update when prompted.`;
+  }
+  return `\u68C0\u6D4B\u5230 FET \u6709\u65B0\u7248\u672C\uFF08\u5F53\u524D ${availability.currentVersion}\uFF0C\u6700\u65B0 ${availability.latestVersion}\uFF09\u3002\u53EF\u8FD0\u884C \`fet update\`\uFF0C\u6216\u5728\u63D0\u793A\u65F6\u9009\u62E9\u5347\u7EA7\u3002`;
+}
+function cachePath() {
+  const home = process.env.FET_UPDATE_CHECK_CACHE_HOME?.trim() || homedir2();
+  return join21(home, ".fet", "update-check-cache.json");
+}
+async function readUpdateCheckCache() {
+  try {
+    const raw = await readFile16(cachePath(), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.latestVersion !== "string" || typeof parsed.checkedAt !== "string") {
+      return null;
+    }
+    return {
+      latestVersion: parsed.latestVersion,
+      checkedAt: parsed.checkedAt,
+      dismissedLatestVersion: typeof parsed.dismissedLatestVersion === "string" ? parsed.dismissedLatestVersion : void 0
+    };
+  } catch {
+    return null;
+  }
+}
+async function writeUpdateCheckCache(cache) {
+  const path = cachePath();
+  await mkdir10(dirname10(path), { recursive: true });
+  await writeFile(path, `${JSON.stringify(cache, null, 2)}
+`, "utf8");
+}
+
+// src/cli/update-check.ts
+async function handleFetUpdateCheck(ctx) {
+  if (!shouldCheckFetUpdateForCommand(ctx.command)) {
+    return;
+  }
+  const mode = getFetUpdateCheckMode();
+  if (mode === "off") {
+    return;
+  }
+  const availability = await resolveFetUpdateAvailability(ctx.fetVersion);
+  if (!availability) {
+    return;
+  }
+  const warning = formatFetUpdateWarning(availability, ctx.language);
+  ctx.output.warn(warning);
+  const forceConfirm = process.env.FET_UPDATE_CHECK_FORCE_CONFIRM === "1";
+  const interactive = mode === "confirm" && !ctx.json && !ctx.yes && (forceConfirm || process.stdin.isTTY && process.stderr.isTTY);
+  if (!interactive) {
+    return;
+  }
+  const choice = await promptFetUpdateChoice(availability, ctx.language);
+  if (choice === "skip") {
+    await rememberDismissedFetUpdate(availability.latestVersion);
+    return;
+  }
+  if (choice === "cancel") {
+    throw new FetError({
+      code: "USER_CANCELLED" /* UserCancelled */,
+      message: ctx.language === "en" ? "Command cancelled before FET update." : "\u547D\u4EE4\u5DF2\u53D6\u6D88\uFF0C\u672A\u6267\u884C FET \u5347\u7EA7\u3002",
+      details: availability,
+      suggestedCommand: ctx.language === "en" ? `fet update` : "fet update"
+    });
+  }
+  await performFetUpdate(availability.currentVersion, availability.latestVersion, {
+    cwd: ctx.cwd,
+    json: ctx.json,
+    language: ctx.language,
+    info: (message) => ctx.output.info(message)
+  });
+  throw new FetError({
+    code: "USER_CANCELLED" /* UserCancelled */,
+    message: ctx.language === "en" ? `FET updated to ${availability.latestVersion}. Rerun this command to use the new version.` : `FET \u5DF2\u5347\u7EA7\u5230 ${availability.latestVersion}\u3002\u8BF7\u91CD\u65B0\u8FD0\u884C\u5F53\u524D\u547D\u4EE4\u4EE5\u4F7F\u7528\u65B0\u7248\u672C\u3002`,
+    details: availability,
+    suggestedCommand: `fet ${ctx.command}`
+  });
+}
+async function promptFetUpdateChoice(availability, language) {
+  const rl = createInterface2({ input: process.stdin, output: process.stderr });
+  try {
+    const question = language === "en" ? `Update FET now (${availability.currentVersion} -> ${availability.latestVersion})? [U]pdate / [S]kip / [C]ancel [s]: ` : `\u662F\u5426\u73B0\u5728\u5347\u7EA7 FET\uFF08${availability.currentVersion} -> ${availability.latestVersion}\uFF09\uFF1F[U]\u5347\u7EA7 / [S]\u8DF3\u8FC7 / [C]\u53D6\u6D88 [s]: `;
+    const answer = (await rl.question(question)).trim().toLowerCase();
+    if (answer === "u" || answer === "update" || answer === "\u5347\u7EA7") {
+      return "update";
+    }
+    if (answer === "c" || answer === "cancel" || answer === "\u53D6\u6D88") {
+      return "cancel";
+    }
+    return "skip";
+  } finally {
+    rl.close();
+  }
+}
+
 // src/cli/index.ts
 var program = new Command();
 program.name("fet").description("\u56F4\u7ED5 OpenSpec \u7684\u524D\u7AEF\u5F00\u53D1\u5DE5\u4F5C\u6D41\u7F16\u6392\u5DE5\u5177\u3002").enablePositionalOptions().version(FET_VERSION).option("--cwd <path>", "\u6307\u5B9A\u9879\u76EE\u6839\u76EE\u5F55").option("--change <id>", "\u6307\u5B9A OpenSpec change").option("--lang <language>", "\u6307\u5B9A FET \u4EA4\u4E92\u4FE1\u606F\u548C\u751F\u6210\u4EA7\u7269\u8BED\u8A00\uFF0C\u9ED8\u8BA4 zh-CN").option("--yes", "\u5BF9\u4F4E\u98CE\u9669\u786E\u8BA4\u4F7F\u7528\u9ED8\u8BA4\u540C\u610F").option("--json", "\u8F93\u51FA\u673A\u5668\u53EF\u8BFB JSON").option("--verbose", "\u8F93\u51FA\u8BCA\u65AD\u7EC6\u8282").option("--no-color", "\u7981\u7528\u7EC8\u7AEF\u989C\u8272");
@@ -5017,6 +5251,7 @@ function wrap(command, handler) {
     const opts = isCommandLike(maybeCommand) ? { ...maybeCommand.parent?.opts(), ...maybeCommand.opts() } : program.opts();
     const ctx = await createCommandContext(command, { ...opts, ...extractGlobalOptions(args) });
     try {
+      await handleFetUpdateCheck(ctx);
       await handleModelPolicyRecommendation(ctx);
       await warnIfContextPlaceholdersRemain(ctx);
       await handler(ctx, ...args);
@@ -5038,7 +5273,7 @@ async function handleModelPolicyRecommendation(ctx) {
   if (policyMode !== "confirm" || ctx.yes || ctx.json || !process.stdin.isTTY || !process.stderr.isTTY) {
     return;
   }
-  const rl = createInterface2({ input: process.stdin, output: process.stderr });
+  const rl = createInterface3({ input: process.stdin, output: process.stderr });
   try {
     const question = ctx.language === "en" ? "Continue anyway? [y/N] " : "\u4ECD\u7136\u7EE7\u7EED\uFF1F[y/N] ";
     const answer = (await rl.question(question)).trim().toLowerCase();