@nick848/fet 1.1.2 → 1.1.4

package/README.md

@@ -104,7 +104,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

@@ -106,7 +106,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

@@ -2008,6 +2008,26 @@ async function proxyCommand(ctx, command, args) {
     await artifactWorkflowCommand(ctx, command, args);
     return;
   }
+  if (command === "apply") {
+    await applyWorkflowCommand(ctx, args);
+    return;
+  }
+  if (command === "explore") {
+    await exploreWorkflowCommand(ctx, args);
+    return;
+  }
+  if (command === "sync") {
+    await syncWorkflowCommand(ctx, args);
+    return;
+  }
+  if (command === "bulk-archive") {
+    await bulkArchiveWorkflowCommand(ctx, args);
+    return;
+  }
+  if (command === "onboard") {
+    await onboardWorkflowCommand(ctx);
+    return;
+  }
   const openSpecArgs = stripFetOptions(args);
   const runState = {};
   await withProjectLock(ctx.projectRoot, { command, cwd: ctx.cwd, fetVersion: ctx.fetVersion }, async () => {
@@ -2082,6 +2102,161 @@ async function proxyCommand(ctx, command, args) {
     data: graphContext ? { graphContext } : void 0
   });
 }
+async function applyWorkflowCommand(ctx, args) {
+  const changeId = await requireChangeId(ctx);
+  const runState = {};
+  await withProjectLock(ctx.projectRoot, { command: "apply", cwd: ctx.cwd, fetVersion: ctx.fetVersion }, async () => {
+    await assertOpenSpecCommandSupported(ctx, "status", "apply");
+    await assertOpenSpecCommandSupported(ctx, "instructions", "apply");
+    runState.graphContext = await buildWorkflowGraphContext(ctx, {
+      command: "apply",
+      args: ["tasks", "--change", changeId],
+      changeId
+    });
+    const status = await readOpenSpecStatus(ctx, changeId);
+    const tasks = status.artifacts?.find((artifact) => artifact.id === "tasks");
+    const warnings = tasks && tasks.status !== "complete" && tasks.status !== "ready" ? [`OpenSpec reports tasks artifact as "${tasks.status}". Finish planning artifacts before implementation if tasks.md is missing.`] : void 0;
+    const instructions = await runInstructions(ctx, changeId, "tasks");
+    await syncWorkflowState(ctx, "apply", changeId, {
+      openSpecCommand: "instructions",
+      openSpecArgs: ["tasks", "--change", changeId],
+      exitCode: instructions.exitCode,
+      phaseStatus: "in_progress"
+    });
+    ctx.output.result({
+      ok: true,
+      command: "apply",
+      summary: `fet apply prepared implementation instructions for change "${changeId}".`,
+      warnings: [...runState.graphContext?.warnings ?? [], ...warnings ?? []],
+      nextSteps: [
+        `Read openspec/changes/${changeId}/tasks.md and the instructions output.`,
+        "Implement pending tasks and update task checkboxes only after the work is done.",
+        `Run fet verify --change ${changeId}`
+      ],
+      data: {
+        changeId,
+        instructions: instructions.data,
+        status,
+        graphContext: runState.graphContext
+      }
+    });
+  });
+}
+async function exploreWorkflowCommand(ctx, args) {
+  const openSpecArgs = stripFetOptions(args);
+  const changeId = ctx.changeId ?? (openSpecArgs[0] && isKebabId(openSpecArgs[0]) ? openSpecArgs[0] : null);
+  const graphContext = await buildWorkflowGraphContext(ctx, {
+    command: "explore",
+    args: openSpecArgs,
+    changeId
+  });
+  ctx.output.result({
+    ok: true,
+    command: "explore",
+    summary: "fet explore is an IDE-guided workflow for shaping OpenSpec changes.",
+    warnings: graphContext.warnings,
+    nextSteps: [
+      "Discuss the requirement, constraints, and acceptance criteria with the user.",
+      changeId ? `Run fet continue --change ${changeId} when ready to create the next artifact.` : "Run fet propose <change-id-or-description> when ready to create a change."
+    ],
+    data: { changeId, args: openSpecArgs, graphContext }
+  });
+}
+async function syncWorkflowCommand(ctx, args) {
+  const changeId = await requireChangeId(ctx);
+  const openSpecArgs = stripFetOptions(args);
+  await withProjectLock(ctx.projectRoot, { command: "sync", cwd: ctx.cwd, fetVersion: ctx.fetVersion }, async () => {
+    await assertVerifiedChange(ctx, changeId);
+    await assertOpenSpecCommandSupported(ctx, "validate", "sync");
+    const validateArgs = [changeId, "--type", "change", ...openSpecArgs.filter((arg) => arg !== changeId)];
+    const result = await ctx.openSpec.run("validate", validateArgs, { cwd: ctx.projectRoot, stdio: ctx.json ? "pipe" : "inherit" });
+    if (result.exitCode !== 0) {
+      throw new FetError({
+        code: "OPENSPEC_COMMAND_FAILED" /* OpenSpecCommandFailed */,
+        message: "OpenSpec validate failed during fet sync.",
+        details: result,
+        recoverable: true
+      });
+    }
+    await syncWorkflowState(ctx, "sync", changeId, {
+      openSpecCommand: "validate",
+      openSpecArgs: validateArgs,
+      exitCode: result.exitCode,
+      phaseStatus: "done"
+    });
+    ctx.output.result({
+      ok: true,
+      command: "sync",
+      summary: `fet sync validated change "${changeId}". OpenSpec 1.3.x applies spec updates during archive.`,
+      nextSteps: [`Run fet archive --change ${changeId} when you are ready to archive and update main specs.`],
+      data: ctx.json ? { changeId, validate: result } : { changeId }
+    });
+  });
+}
+async function bulkArchiveWorkflowCommand(ctx, args) {
+  const openSpecArgs = stripFetOptions(args);
+  const targets = [.../* @__PURE__ */ new Set([...ctx.changeId ? [ctx.changeId] : [], ...openSpecArgs.filter((arg) => !arg.startsWith("-"))])];
+  if (!targets.length) {
+    throw new FetError({
+      code: "INVALID_ARGUMENTS" /* InvalidArguments */,
+      message: "fet bulk-archive requires explicit change ids with the current OpenSpec CLI.",
+      suggestedCommand: "fet bulk-archive --change <change-id>"
+    });
+  }
+  await withProjectLock(ctx.projectRoot, { command: "bulk-archive", cwd: ctx.cwd, fetVersion: ctx.fetVersion }, async () => {
+    await assertOpenSpecCommandSupported(ctx, "archive", "bulk-archive");
+    const archived = [];
+    for (const changeId of targets) {
+      await assertVerifiedChange(ctx, changeId);
+      const changelogEntry = await createChangelogEntry(ctx.projectRoot, changeId);
+      const result = await ctx.openSpec.run("archive", [changeId], { cwd: ctx.projectRoot, stdio: ctx.json ? "pipe" : "inherit" });
+      if (result.exitCode !== 0) {
+        throw new FetError({
+          code: "OPENSPEC_COMMAND_FAILED" /* OpenSpecCommandFailed */,
+          message: `OpenSpec archive failed for "${changeId}".`,
+          details: result,
+          recoverable: true
+        });
+      }
+      await appendChangelog(ctx.projectRoot, changelogEntry);
+      archived.push(changeId);
+    }
+    const inspection = await ctx.openSpec.inspectProject(ctx.projectRoot);
+    const state = await ctx.stateStore.getOrCreateGlobal();
+    state.openChangeIds = inspection.changes;
+    if (state.activeChangeId && !inspection.changes.includes(state.activeChangeId)) {
+      state.activeChangeId = null;
+    }
+    state.verifyAuthorization = null;
+    await ctx.stateStore.writeGlobal(state);
+    ctx.output.result({
+      ok: true,
+      command: "bulk-archive",
+      summary: `fet bulk-archive archived ${archived.length} change(s) via OpenSpec archive.`,
+      nextSteps: inspection.changes.length ? [`Remaining open changes: ${inspection.changes.join(", ")}`] : void 0,
+      data: { archived, openChangeIds: inspection.changes }
+    });
+  });
+}
+async function onboardWorkflowCommand(ctx) {
+  const inspection = await ctx.openSpec.inspectProject(ctx.projectRoot);
+  const state = await ctx.stateStore.getOrCreateGlobal();
+  state.openChangeIds = inspection.changes;
+  if (state.activeChangeId && !inspection.changes.includes(state.activeChangeId)) {
+    state.activeChangeId = inspection.changes.length === 1 ? inspection.changes[0] ?? null : null;
+  }
+  await ctx.stateStore.writeGlobal(state);
+  ctx.output.result({
+    ok: true,
+    command: "onboard",
+    summary: "fet onboard loaded local FET/OpenSpec workflow context.",
+    nextSteps: [
+      inspection.changes.length ? `Open changes: ${inspection.changes.join(", ")}` : "No open changes found. Run fet propose <change-id-or-description> to start one.",
+      "Use fet continue to prepare planning artifacts, fet apply for implementation instructions, fet verify before archive."
+    ],
+    data: { activeChangeId: state.activeChangeId, openChangeIds: inspection.changes, archivedChangeIds: inspection.archived }
+  });
+}
 async function artifactWorkflowCommand(ctx, command, args) {
   const openSpecArgs = stripFetOptions(args);
   const runState = {};
@@ -2112,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,
@@ -2267,9 +2443,10 @@ async function syncWorkflowState(ctx, command, changeId, lastOpenSpecCommand) {
   }
   const changeInspection = await ctx.openSpec.inspectChange(ctx.projectRoot, changeId);
   const changeState = await ctx.stateStore.getOrCreateChange(changeId, phaseByCommand[command] ?? "propose");
-  changeState.currentPhase = "propose";
-  changeState.phases.propose = {
-    status: "in_progress",
+  const phase = phaseByCommand[command] ?? "propose";
+  changeState.currentPhase = phase;
+  changeState.phases[phase] = {
+    status: lastOpenSpecCommand.phaseStatus ?? "in_progress",
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   changeState.lastOpenSpecCommand = {
@@ -2479,6 +2656,9 @@ async function assertVerified(ctx) {
       suggestedCommand: "fet verify --done --change <change-id>"
     });
   }
+  await assertVerifiedChange(ctx, changeId);
+}
+async function assertVerifiedChange(ctx, changeId) {
   const change = await ctx.stateStore.readChange(changeId);
   const inspection = await ctx.openSpec.inspectProject(ctx.projectRoot);
   if (!inspection.changes.includes(changeId)) {
@@ -2969,7 +3149,7 @@ var FET_WORKFLOW_COMMANDS = [
   "onboard"
 ];
 var FET_GRAPH_COMMANDS = ["graph-status", "graph-setup", "graph-init", "graph-refresh", "graph-doctor", "graph-handoff"];
-var FET_ADAPTER_COMMANDS = [...FET_WORKFLOW_COMMANDS, "fill-context", "passthrough", ...FET_GRAPH_COMMANDS];
+var FET_ADAPTER_COMMANDS = [...FET_WORKFLOW_COMMANDS, "update", "fill-context", "passthrough", ...FET_GRAPH_COMMANDS];
 function renderFetAdapterUsage(command, args = "[...args]") {
   if (command.startsWith("graph-")) {
     const subcommand = command.slice("graph-".length);
@@ -3263,12 +3443,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);
   }
@@ -3382,12 +3565,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",
@@ -3412,9 +3595,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";
   }
@@ -3828,6 +4017,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]",
@@ -3870,27 +4098,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"}.
+
+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 or a description of what the user wants to build. For ff, it may be omitted when the active OpenSpec change is unambiguous.
+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.