@nick848/fet 1.0.10 → 1.1.0

package/README_en.md

@@ -42,6 +42,7 @@ Check the installation:
 ```sh
 fet --version
 fet --help
+fet update
 ```
 
 ## Quick Start
@@ -100,6 +101,7 @@ fet init --lang en
 | Command | Usage | Description |
 |---------|-------|-------------|
 | `fet init` | `fet init [--yes] [--lang <language>]` | Initialize FET and OpenSpec; generate context, state, Cursor integration, and Codex workflow guides. |
+| `fet update` | `fet update` | Check whether FET is the latest published version and automatically upgrade when a newer version is available. |
 | `fet update-context` | `fet update-context [--yes]` | Rescan the project and update FET-managed regions in `AGENTS.md` and `openspec/config.yaml`. |
 | `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. |

package/dist/{chunk-V4ZRBF5L.js → chunk-J5WB4KAL.js}

@@ -15,6 +15,7 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["LockHeld"] = "LOCK_HELD";
   ErrorCode2["UserCancelled"] = "USER_CANCELLED";
   ErrorCode2["UnsafeScriptApprovalRequired"] = "UNSAFE_SCRIPT_APPROVAL_REQUIRED";
+  ErrorCode2["UpdateFailed"] = "UPDATE_FAILED";
   ErrorCode2["ToolAdapterConflict"] = "TOOL_ADAPTER_CONFLICT";
   ErrorCode2["ConfigInvalid"] = "CONFIG_INVALID";
   ErrorCode2["FileSystemError"] = "FILE_SYSTEM_ERROR";
@@ -31,6 +32,7 @@ function exitCodeForError(code) {
       return 3;
     case "OPENSPEC_COMMAND_FAILED" /* OpenSpecCommandFailed */:
     case "GRAPH_COMMAND_FAILED" /* GraphCommandFailed */:
+    case "UPDATE_FAILED" /* UpdateFailed */:
       return 4;
     case "OPENSPEC_STRUCTURE_UNKNOWN" /* OpenSpecStructureUnknown */:
     case "STATE_SCHEMA_UNSUPPORTED" /* StateSchemaUnsupported */:
@@ -105,4 +107,4 @@ export {
   FetError,
   toFetError
 };
-//# sourceMappingURL=chunk-V4ZRBF5L.js.map
+//# sourceMappingURL=chunk-J5WB4KAL.js.map

package/dist/chunk-J5WB4KAL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/codes.ts","../src/errors/fet-error.ts"],"sourcesContent":["export enum ErrorCode {\n  Unknown = \"UNKNOWN\",\n  InvalidArguments = \"INVALID_ARGUMENTS\",\n  OpenSpecNotFound = \"OPENSPEC_NOT_FOUND\",\n  OpenSpecUnsupportedVersion = \"OPENSPEC_UNSUPPORTED_VERSION\",\n  OpenSpecCommandFailed = \"OPENSPEC_COMMAND_FAILED\",\n  OpenSpecStructureUnknown = \"OPENSPEC_STRUCTURE_UNKNOWN\",\n  GraphProviderNotFound = \"GRAPH_PROVIDER_NOT_FOUND\",\n  GraphCommandFailed = \"GRAPH_COMMAND_FAILED\",\n  StateSchemaUnsupported = \"STATE_SCHEMA_UNSUPPORTED\",\n  StateCorrupted = \"STATE_CORRUPTED\",\n  LockHeld = \"LOCK_HELD\",\n  UserCancelled = \"USER_CANCELLED\",\n  UnsafeScriptApprovalRequired = \"UNSAFE_SCRIPT_APPROVAL_REQUIRED\",\n  UpdateFailed = \"UPDATE_FAILED\",\n  ToolAdapterConflict = \"TOOL_ADAPTER_CONFLICT\",\n  ConfigInvalid = \"CONFIG_INVALID\",\n  FileSystemError = \"FILE_SYSTEM_ERROR\"\n}\n\nexport function exitCodeForError(code: ErrorCode): number {\n  switch (code) {\n    case ErrorCode.InvalidArguments:\n    case ErrorCode.ConfigInvalid:\n      return 2;\n    case ErrorCode.OpenSpecNotFound:\n    case ErrorCode.OpenSpecUnsupportedVersion:\n    case ErrorCode.GraphProviderNotFound:\n      return 3;\n    case ErrorCode.OpenSpecCommandFailed:\n    case ErrorCode.GraphCommandFailed:\n    case ErrorCode.UpdateFailed:\n      return 4;\n    case ErrorCode.OpenSpecStructureUnknown:\n    case ErrorCode.StateSchemaUnsupported:\n    case ErrorCode.StateCorrupted:\n    case ErrorCode.ToolAdapterConflict:\n    case ErrorCode.FileSystemError:\n      return 5;\n    case ErrorCode.LockHeld:\n      return 6;\n    case ErrorCode.UserCancelled:\n      return 7;\n    case ErrorCode.UnsafeScriptApprovalRequired:\n      return 8;\n    case ErrorCode.Unknown:\n    default:\n      return 1;\n  }\n}\n","import { ErrorCode, exitCodeForError } from \"./codes.js\";\n\nexport interface FetErrorOptions {\n  code: ErrorCode;\n  message: string;\n  details?: unknown;\n  recoverable?: boolean;\n  suggestedCommand?: string;\n  cause?: unknown;\n}\n\nexport class FetError extends Error {\n  readonly code: ErrorCode;\n  readonly exitCode: number;\n  readonly details?: unknown;\n  readonly recoverable: boolean;\n  readonly suggestedCommand?: string;\n  override readonly cause?: unknown;\n\n  constructor(options: FetErrorOptions) {\n    super(options.message);\n    this.name = \"FetError\";\n    this.code = options.code;\n    this.exitCode = exitCodeForError(options.code);\n    this.details = options.details;\n    this.recoverable = options.recoverable ?? true;\n    this.suggestedCommand = options.suggestedCommand;\n    this.cause = options.cause;\n  }\n\n  toJSON() {\n    return {\n      code: this.code,\n      exitCode: this.exitCode,\n      message: this.message,\n      details: this.details,\n      recoverable: this.recoverable,\n      suggestedCommand: this.suggestedCommand\n    };\n  }\n}\n\nexport function toFetError(error: unknown): FetError {\n  if (error instanceof FetError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new FetError({\n      code: ErrorCode.Unknown,\n      message: error.message,\n      recoverable: false,\n      cause: error\n    });\n  }\n\n  return new FetError({\n    code: ErrorCode.Unknown,\n    message: \"Unknown error\",\n    details: error,\n    recoverable: false\n  });\n}\n"],"mappings":";;;AAAO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,gCAA6B;AAC7B,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,8BAA2B;AAC3B,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,4BAAyB;AACzB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,kCAA+B;AAC/B,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,qBAAkB;AAjBR,SAAAA;AAAA,GAAA;AAoBL,SAAS,iBAAiB,MAAyB;AACxD,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL;AACE,aAAO;AAAA,EACX;AACF;;;ACtCO,IAAM,WAAN,cAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACS;AAAA,EAElB,YAAY,SAA0B;AACpC,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,WAAW,iBAAiB,QAAQ,IAAI;AAC7C,SAAK,UAAU,QAAQ;AACvB,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,mBAAmB,QAAQ;AAChC,SAAK,QAAQ,QAAQ;AAAA,EACvB;AAAA,EAEA,SAAS;AACP,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,UAAU,KAAK;AAAA,MACf,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,kBAAkB,KAAK;AAAA,IACzB;AAAA,EACF;AACF;AAEO,SAAS,WAAW,OAA0B;AACnD,MAAI,iBAAiB,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,iBAAiB,OAAO;AAC1B,WAAO,IAAI,SAAS;AAAA,MAClB;AAAA,MACA,SAAS,MAAM;AAAA,MACf,aAAa;AAAA,MACb,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,SAAS;AAAA,IAClB;AAAA,IACA,SAAS;AAAA,IACT,SAAS;AAAA,IACT,aAAa;AAAA,EACf,CAAC;AACH;","names":["ErrorCode"]}

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 import {
   FetError,
   toFetError
-} from "../chunk-V4ZRBF5L.js";
+} from "../chunk-J5WB4KAL.js";
 
 // src/cli/index.ts
 import { createInterface } from "readline/promises";
@@ -2254,6 +2254,195 @@ async function assertVerified(ctx) {
   }
 }
 
+// src/commands/update.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(" ")}`
+    }
+  });
+}
+async function resolveLatestVersion(packageName, npmExecutable) {
+  const override = process.env.FET_UPDATE_LATEST_VERSION?.trim();
+  if (override) {
+    return override;
+  }
+  const result = await runNpm(npmExecutable, ["view", packageName, "version", "--json"], {
+    cwd: process.cwd(),
+    stdio: "pipe"
+  });
+  if (result.exitCode !== 0) {
+    throw new FetError({
+      code: "UPDATE_FAILED" /* UpdateFailed */,
+      message: "Unable to check the latest FET version from npm.",
+      details: result,
+      suggestedCommand: `${npmExecutable} view ${packageName} version`
+    });
+  }
+  const version = parseNpmVersion(result.stdout ?? "");
+  if (!version) {
+    throw new FetError({
+      code: "UPDATE_FAILED" /* UpdateFailed */,
+      message: "npm returned an invalid FET version.",
+      details: { stdout: result.stdout }
+    });
+  }
+  return version;
+}
+function parseNpmVersion(stdout) {
+  const trimmed = stdout.trim();
+  if (!trimmed) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(trimmed);
+    return typeof parsed === "string" && parsed.length > 0 ? parsed : null;
+  } catch {
+    return trimmed;
+  }
+}
+function runNpm(command, args, options) {
+  return new Promise((resolve2, reject) => {
+    const stdout = [];
+    const stderr = [];
+    const child = spawn(command, args, {
+      cwd: options.cwd,
+      stdio: options.stdio,
+      shell: process.platform === "win32"
+    });
+    child.stdout?.on("data", (chunk) => stdout.push(chunk));
+    child.stderr?.on("data", (chunk) => stderr.push(chunk));
+    child.on("error", (error) => {
+      reject(
+        new FetError({
+          code: "UPDATE_FAILED" /* UpdateFailed */,
+          message: "Unable to run npm for FET update.",
+          details: { command, args },
+          cause: error,
+          suggestedCommand: `${command} ${args.join(" ")}`
+        })
+      );
+    });
+    child.on("close", (exitCode, signal) => {
+      resolve2({
+        command,
+        args,
+        exitCode: exitCode ?? 1,
+        signal,
+        stdout: stdout.length ? Buffer.concat(stdout).toString("utf8") : void 0,
+        stderr: stderr.length ? Buffer.concat(stderr).toString("utf8") : void 0
+      });
+    });
+  });
+}
+function defaultNpmExecutable() {
+  return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+function compareVersions(left, right) {
+  const leftVersion = parseVersion(left);
+  const rightVersion = parseVersion(right);
+  for (let index = 0; index < 3; index += 1) {
+    const diff = leftVersion.main[index] - rightVersion.main[index];
+    if (diff !== 0) {
+      return Math.sign(diff);
+    }
+  }
+  if (!leftVersion.prerelease.length && rightVersion.prerelease.length) {
+    return 1;
+  }
+  if (leftVersion.prerelease.length && !rightVersion.prerelease.length) {
+    return -1;
+  }
+  const length = Math.max(leftVersion.prerelease.length, rightVersion.prerelease.length);
+  for (let index = 0; index < length; index += 1) {
+    const leftPart = leftVersion.prerelease[index];
+    const rightPart = rightVersion.prerelease[index];
+    if (leftPart === void 0) {
+      return -1;
+    }
+    if (rightPart === void 0) {
+      return 1;
+    }
+    const diff = comparePrereleasePart(leftPart, rightPart);
+    if (diff !== 0) {
+      return diff;
+    }
+  }
+  return 0;
+}
+function parseVersion(version) {
+  const [withoutBuild] = version.trim().replace(/^v/i, "").split("+");
+  const [mainValue = "", prereleaseValue = ""] = withoutBuild.split("-");
+  const mainParts = mainValue.split(".").map((part) => Number.parseInt(part, 10));
+  return {
+    main: [
+      Number.isFinite(mainParts[0]) ? mainParts[0] : 0,
+      Number.isFinite(mainParts[1]) ? mainParts[1] : 0,
+      Number.isFinite(mainParts[2]) ? mainParts[2] : 0
+    ],
+    prerelease: prereleaseValue ? prereleaseValue.split(".") : []
+  };
+}
+function comparePrereleasePart(left, right) {
+  const leftNumber = /^\d+$/.test(left) ? Number.parseInt(left, 10) : null;
+  const rightNumber = /^\d+$/.test(right) ? Number.parseInt(right, 10) : null;
+  if (leftNumber !== null && rightNumber !== null) {
+    return Math.sign(leftNumber - rightNumber);
+  }
+  if (leftNumber !== null) {
+    return -1;
+  }
+  if (rightNumber !== null) {
+    return 1;
+  }
+  return left.localeCompare(right);
+}
+
 // src/commands/verify.ts
 import { createHash } from "crypto";
 import { mkdir as mkdir7, readFile as readFile12, stat as stat5 } from "fs/promises";
@@ -3921,14 +4110,14 @@ function exec(command, args) {
 }
 
 // src/openspec/runner.ts
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 async function runOpenSpec(executablePath, command, args, options) {
   const spawnCommand = executablePath === "npx openspec" ? "npx" : executablePath;
   const spawnArgs = executablePath === "npx openspec" ? ["openspec", command, ...args] : [command, ...args];
   return new Promise((resolve2, reject) => {
     const stdout = [];
     const stderr = [];
-    const child = spawn(spawnCommand, spawnArgs, {
+    const child = spawn2(spawnCommand, spawnArgs, {
       cwd: options.cwd,
       stdio: options.stdio ?? "inherit",
       shell: process.platform === "win32"
@@ -4350,6 +4539,7 @@ async function createCommandContext(command, options) {
 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");
 addGlobalOptions(program.command("init")).description("\u521D\u59CB\u5316 FET + OpenSpec").action(wrap("init", initCommand));
+addGlobalOptions(program.command("update")).description("\u68C0\u67E5 FET \u662F\u5426\u4E3A\u6700\u65B0\u7248\uFF0C\u5E76\u5728\u9700\u8981\u65F6\u81EA\u52A8\u5347\u7EA7").action(wrap("update", updateCommand));
 addGlobalOptions(program.command("update-context")).description("\u66F4\u65B0\u9879\u76EE\u4E0A\u4E0B\u6587").action(wrap("update-context", updateContextCommand));
 addGlobalOptions(program.command("fill-context")).description("\u5237\u65B0 IDE \u586B\u5145 AGENTS.md \u5360\u4F4D\u7B26\u7684\u63D0\u793A\u6587\u4EF6").action(wrap("fill-context", fillContextCommand));
 var graph = addGlobalOptions(program.command("graph").description("\u7BA1\u7406\u53EF\u9009\u7684 GitNexus \u4EE3\u7801\u56FE\u652F\u6301"));
@@ -4432,7 +4622,7 @@ function renderModelPolicyActionHint(policyMode, language) {
   return language === "en" ? "This is advisory because FET_MODEL_POLICY=warn; the command will continue." : "\u5F53\u524D\u8BBE\u7F6E FET_MODEL_POLICY=warn\uFF0C\u8BE5\u63D0\u9192\u4EC5\u4F5C\u4E3A\u5EFA\u8BAE\uFF0C\u547D\u4EE4\u4F1A\u7EE7\u7EED\u6267\u884C\u3002";
 }
 async function warnIfContextPlaceholdersRemain(ctx) {
-  if (["init", "update-context", "fill-context", "doctor"].includes(ctx.command)) {
+  if (["init", "update", "update-context", "fill-context", "doctor"].includes(ctx.command)) {
     return;
   }
   const count2 = await countAgentsLlmPlaceholders(ctx.projectRoot);