@nick848/fet 1.1.4 → 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` 时会跳过交互式升级询问；跳过某版本后，同一最新版本不会重复提示，直到检测到更高的新版本。
+
 ## 命令列表
 
 | 命令 | 用法 | 说明 |

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 |

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
@@ -2679,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;
+}
+function getNpmExecutable(env = process.env) {
+  return env.FET_UPDATE_NPM_EXECUTABLE?.trim() || (process.platform === "win32" ? "npm.cmd" : "npm");
 }
-async function resolveLatestVersion(packageName, npmExecutable) {
+async function resolveLatestFetVersion(packageName = getFetPackageName(), npmExecutable = getNpmExecutable()) {
   const override = process.env.FET_UPDATE_LATEST_VERSION?.trim();
   if (override) {
     return override;
@@ -2759,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) {
@@ -2805,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);
@@ -2868,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";
@@ -5023,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");
@@ -5066,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);
@@ -5087,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();