@nick848/fet 1.0.9 → 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";
@@ -1989,6 +1989,7 @@ async function proxyCommand(ctx, command, args) {
       await assertVerified(ctx);
     }
     const mapped = await mapOpenSpecCommand(ctx, command, openSpecArgs);
+    await assertOpenSpecCommandSupported(ctx, mapped.command, command);
     const mappedChangeId = extractChangeId(mapped.args);
     const targetChangeId = command === "archive" ? mapped.args[0] ?? ctx.changeId ?? mappedChangeId : ctx.changeId ?? mappedChangeId;
     runState.graphContext = await buildWorkflowGraphContext(ctx, {
@@ -2055,6 +2056,23 @@ async function proxyCommand(ctx, command, args) {
     data: graphContext ? { graphContext } : void 0
   });
 }
+async function assertOpenSpecCommandSupported(ctx, openSpecCommand, fetCommand) {
+  const capabilities = await ctx.openSpec.getCapabilities();
+  if (capabilities.commands.includes(openSpecCommand)) {
+    return;
+  }
+  throw new FetError({
+    code: "OPENSPEC_UNSUPPORTED_VERSION" /* OpenSpecUnsupportedVersion */,
+    message: `OpenSpec CLI ${capabilities.version} does not expose command "${openSpecCommand}" required by "fet ${fetCommand}". FET will not substitute another workflow command automatically.`,
+    details: {
+      openSpecVersion: capabilities.version,
+      requiredCommand: openSpecCommand,
+      availableCommands: capabilities.commands,
+      supported: capabilities.supported
+    },
+    suggestedCommand: "Upgrade OpenSpec to a version that supports this command, then rerun FET. Try: npm install -g @fission-ai/openspec@latest && fet doctor. If your OpenSpec version intentionally removed this command, pause and choose a compatible FET workflow instead of running ff automatically."
+  });
+}
 async function createChangelogEntry(projectRoot, changeId) {
   return {
     updateTime: formatLocalTimestamp(/* @__PURE__ */ new Date()),
@@ -2236,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";
@@ -2811,15 +3018,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 (language !== "en") {
     return renderSlashPromptZh(command);
   }
   if (command === "continue") {
     return renderContinueSlashPrompt(language);
   }
-  if (command === "ff" || command === "propose") {
-    return renderFastForwardSlashPrompt(command, language);
-  }
   if (command === "explore") {
     return renderExploreSlashPrompt(language);
   }
@@ -3419,11 +3626,11 @@ Guardrails:
   );
 }
 function renderFastForwardSlashPrompt(command, language) {
-  const title = command === "propose" ? "Propose a new FET/OpenSpec change" : "Fast-forward FET/OpenSpec artifact creation";
+  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>";
   return renderManagedSlashPrompt(
     `fet ${command} [...args]`,
-    command === "propose" ? "Create a change and generate required OpenSpec artifacts" : "Generate required OpenSpec artifacts for a change",
+    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}.
 
 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.
@@ -3438,6 +3645,7 @@ Steps:
    \`\`\`
 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.
 
 Artifact rules:
 - Follow the instruction field from OpenSpec/FET for each artifact.
@@ -3449,7 +3657,11 @@ Output:
 - Change id and location.
 - Artifacts created.
 - Current status.
-- Next recommended command, usually /prompts:fet-apply <change-id>.`,
+- Next recommended command, usually /prompts:fet-apply <change-id>.
+
+Guardrails:
+- Do not substitute one FET/OpenSpec workflow command for another after a command-not-found or unsupported-version error.
+- If OpenSpec appears outdated or incompatible, report the detected version and suggest \`npm install -g @fission-ai/openspec@latest\` or \`fet doctor\`, then wait for the user's decision.`,
     void 0,
     language
   );
@@ -3855,7 +4067,7 @@ async function findExecutable() {
   const command = process.platform === "win32" ? "where.exe" : "which";
   try {
     const { stdout } = await exec(command, ["openspec"]);
-    const first = stdout.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+    const first = stdout.split(/\r?\n/).map((line) => line.trim()).sort((left, right) => executablePreference(left) - executablePreference(right)).find(Boolean);
     if (first) {
       return first;
     }
@@ -3872,6 +4084,12 @@ async function findExecutable() {
     });
   }
 }
+function executablePreference(path) {
+  if (process.platform === "win32" && path.toLowerCase().endsWith(".cmd")) {
+    return 0;
+  }
+  return 1;
+}
 async function readVersion(executablePath) {
   const command = executablePath === "npx openspec" ? "npx" : executablePath;
   const args = executablePath === "npx openspec" ? ["openspec", "--version"] : ["--version"];
@@ -3892,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"
@@ -3986,7 +4204,10 @@ function parseCommands(help) {
     "bulk-archive",
     "onboard"
   ];
-  return known.filter((command) => help.includes(command));
+  return known.filter((command) => new RegExp(`\\b${escapeRegExp(command)}\\b`).test(help));
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
 // src/scanner/package.ts
@@ -4318,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"));
@@ -4400,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);