@nick848/fet 1.0.9 → 1.0.10

package/dist/cli/index.js

@@ -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()),
@@ -2811,15 +2829,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 +3437,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 +3456,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 +3468,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 +3878,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 +3895,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"];
@@ -3986,7 +4015,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