feat(FN-4130): classify zero-step tasks as retryable to todo on failure

Adds zero-step retry classification to the task workflow routes and pi extension, with test coverage in both packages and documentation updates.

Fusion-Task-Id: FN-4130

packages/cli/src/__tests__/extension.test.ts

@@ -1782,6 +1782,35 @@ describe("fn pi extension (runnable structured-output regression slice)", () =>
       expect(updated?.steps[1].status).toBe("in-progress");
     });
 
+    it("moves zero-step execution-failed in-review task to todo and clears failure state", async () => {
+      const store = new TaskStore(tmpDir);
+      await store.init();
+
+      const task = await store.createTask({
+        title: "zero-step execution-failed task",
+        description: "test",
+        column: "todo",
+      });
+      await writeFile(join(tmpDir, ".fusion", "tasks", task.id, "PROMPT.md"), "# zero-step execution-failed task\n\nNo steps yet.\n");
+      await store.updateTask(task.id, { steps: [] });
+      await store.moveTask(task.id, "in-progress");
+      await store.moveTask(task.id, "in-review");
+      await store.updateTask(task.id, { status: "failed", error: "executor crashed", mergeRetries: 0, steps: [] });
+
+      const retryTool = api.tools.get("fn_task_retry")!;
+      const result = await retryTool.execute("retry-zero-step-exec", { id: task.id }, undefined, undefined, makeCtx(tmpDir));
+
+      expect(result.isError).toBeFalsy();
+      expect(result.details.newColumn).toBe("todo");
+
+      const updated = await store.getTask(task.id);
+      expect(updated?.column).toBe("todo");
+      expect(updated?.status).toBeFalsy();
+      expect(updated?.error).toBeFalsy();
+      expect(updated?.steps).toEqual([]);
+      expect(updated?.mergeRetries).toBe(0);
+    });
+
     it("keeps merge-failed in-review task (all steps done) in in-review and resets merge state", async () => {
       const store = new TaskStore(tmpDir);
       await store.init();
@@ -1813,6 +1842,35 @@ describe("fn pi extension (runnable structured-output regression slice)", () =>
       expect(updated?.error).toBeFalsy();
       expect(updated?.mergeRetries).toBe(0);
     });
+
+    it("keeps zero-step merge-failed in-review task with prior merge attempts in-review and resets merge state", async () => {
+      const store = new TaskStore(tmpDir);
+      await store.init();
+
+      const task = await store.createTask({
+        title: "zero-step merge-failed task",
+        description: "test",
+        column: "todo",
+      });
+      await writeFile(join(tmpDir, ".fusion", "tasks", task.id, "PROMPT.md"), "# zero-step merge-failed task\n\nNo steps yet.\n");
+      await store.updateTask(task.id, { steps: [] });
+      await store.moveTask(task.id, "in-progress");
+      await store.moveTask(task.id, "in-review");
+      await store.updateTask(task.id, { status: "failed", error: "merge conflict", mergeRetries: 2, steps: [] });
+
+      const retryTool = api.tools.get("fn_task_retry")!;
+      const result = await retryTool.execute("retry-zero-step-merge", { id: task.id }, undefined, undefined, makeCtx(tmpDir));
+
+      expect(result.isError).toBeFalsy();
+      expect(result.details.newColumn).toBe("in-review");
+
+      const updated = await store.getTask(task.id);
+      expect(updated?.column).toBe("in-review");
+      expect(updated?.status).toBeFalsy();
+      expect(updated?.error).toBeFalsy();
+      expect(updated?.steps).toEqual([]);
+      expect(updated?.mergeRetries).toBe(0);
+    });
   });
 
   describe("fn_list_agents", () => {

packages/cli/src/extension.ts

@@ -884,11 +884,15 @@ export default function kbExtension(pi: ExtensionAPI) {
       
       // In-review retry: distinguish between execution failures and merge failures.
       if (task.column === 'in-review') {
-        const hasIncompleteSteps =
-          task.steps.length > 0 &&
-          task.steps.some((s: { status: string }) => s.status === "pending" || s.status === "in-progress");
+        const hasIncompleteSteps = task.steps.some(
+          (s: { status: string }) => s.status === "pending" || s.status === "in-progress",
+        );
+        // FN-4130 / PR #59 follow-up: zero-step review failures with no merge attempts
+        // (`mergeRetries ?? 0 === 0`) failed during execution, not merge finalization.
+        const isExecutionFailureInReview =
+          hasIncompleteSteps || (task.steps.length === 0 && (task.mergeRetries ?? 0) === 0);
 
-        if (hasIncompleteSteps) {
+        if (isExecutionFailureInReview) {
           await store.updateTask(params.id, { status: null, error: null, stuckKillCount: 0 });
           await store.logEntry(params.id, "Retry requested via Fusion extension (execution failure in-review → todo, preserving progress)");
           await store.moveTask(params.id, "todo", { preserveProgress: true });