@polka-codes/cli 0.9.47 → 0.9.49

package/dist/index.js

@@ -35579,7 +35579,7 @@ var {
   Help
 } = import__.default;
 // package.json
-var version = "0.9.47";
+var version = "0.9.49";
 
 // src/commands/code.ts
 import { readFile as readFile3 } from "node:fs/promises";
@@ -48216,36 +48216,12 @@ var configSchema = exports_external.object({
   rules: exports_external.array(exports_external.string()).optional().or(exports_external.string()).optional(),
   excludeFiles: exports_external.array(exports_external.string()).optional()
 }).strict();
-// ../core/src/tools/appendMemory.ts
-var toolInfo = {
-  name: "appendMemory",
-  description: "Appends content to a memory topic.",
-  parameters: exports_external.object({
-    topic: exports_external.string().nullish().describe('The topic to append to in memory. Defaults to ":default:".'),
-    content: exports_external.string().describe("The content to append.")
-  })
-};
-var handler = async (provider, args) => {
-  const { topic, content } = toolInfo.parameters.parse(args);
-  await provider.appendMemory(topic ?? undefined, content);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Content appended to memory topic '${topic || ""}'.`
-    }
-  };
-};
-var appendMemory_default = {
-  ...toolInfo,
-  handler
-};
 // ../core/src/tools/askFollowupQuestion.ts
 var questionObject = exports_external.object({
   prompt: exports_external.string().describe("The text of the question.").meta({ usageValue: "question text here" }),
   options: exports_external.array(exports_external.string()).default([]).describe("Ordered list of suggested answers (omit if none).").meta({ usageValue: "suggested answer here" })
 });
-var toolInfo2 = {
+var toolInfo = {
   name: "askFollowupQuestion",
   description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.",
   parameters: exports_external.object({
@@ -48295,7 +48271,7 @@ var toolInfo2 = {
     ]
   })
 };
-var handler2 = async (provider, args) => {
+var handler = async (provider, args) => {
   if (!provider.askFollowupQuestion) {
     return {
       type: "Error" /* Error */,
@@ -48305,7 +48281,7 @@ var handler2 = async (provider, args) => {
       }
     };
   }
-  const { questions } = toolInfo2.parameters.parse(args);
+  const { questions } = toolInfo.parameters.parse(args);
   if (questions.length === 0) {
     return {
       type: "Error" /* Error */,
@@ -48333,11 +48309,11 @@ ${answer}
   };
 };
 var askFollowupQuestion_default = {
-  ...toolInfo2,
-  handler: handler2
+  ...toolInfo,
+  handler
 };
 // ../core/src/tools/executeCommand.ts
-var toolInfo3 = {
+var toolInfo2 = {
   name: "executeCommand",
   description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.",
   parameters: exports_external.object({
@@ -48364,7 +48340,7 @@ var toolInfo3 = {
     ]
   })
 };
-var handler3 = async (provider, args) => {
+var handler2 = async (provider, args) => {
   if (!provider.executeCommand) {
     return {
       type: "Error" /* Error */,
@@ -48374,7 +48350,7 @@ var handler3 = async (provider, args) => {
       }
     };
   }
-  const { command, requiresApproval } = toolInfo3.parameters.parse(args);
+  const { command, requiresApproval } = toolInfo2.parameters.parse(args);
   try {
     const result = await provider.executeCommand(command, requiresApproval);
     let message = `<command>${command}</command>
@@ -48421,11 +48397,11 @@ ${result.stderr}
   }
 };
 var executeCommand_default = {
-  ...toolInfo3,
-  handler: handler3
+  ...toolInfo2,
+  handler: handler2
 };
 // ../core/src/tools/fetchUrl.ts
-var toolInfo4 = {
+var toolInfo3 = {
   name: "fetchUrl",
   description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.",
   parameters: exports_external.object({
@@ -48458,7 +48434,7 @@ var toolInfo4 = {
     ]
   })
 };
-var handler4 = async (provider, args) => {
+var handler3 = async (provider, args) => {
   if (!provider.fetchUrl) {
     return {
       type: "Error" /* Error */,
@@ -48468,7 +48444,7 @@ var handler4 = async (provider, args) => {
       }
     };
   }
-  const { url: urls } = toolInfo4.parameters.parse(args);
+  const { url: urls } = toolInfo3.parameters.parse(args);
   if (urls.length === 0) {
     return {
       type: "Error" /* Error */,
@@ -48499,6 +48475,38 @@ var handler4 = async (provider, args) => {
   };
 };
 var fetchUrl_default = {
+  ...toolInfo3,
+  handler: handler3
+};
+// ../core/src/tools/getTodoItem.ts
+var toolInfo4 = {
+  name: "getTodoItem",
+  description: "Get a to-do item by its ID.",
+  parameters: exports_external.object({
+    id: exports_external.string().describe("The ID of the to-do item.")
+  })
+};
+var handler4 = async (provider, args) => {
+  if (!provider.getTodoItem) {
+    return {
+      type: "Error" /* Error */,
+      message: {
+        type: "error-text",
+        value: "Not possible to get a to-do item."
+      }
+    };
+  }
+  const { id } = toolInfo4.parameters.parse(args);
+  const item = await provider.getTodoItem(id);
+  return {
+    type: "Reply" /* Reply */,
+    message: {
+      type: "json",
+      value: item ?? null
+    }
+  };
+};
+var getTodoItem_default = {
   ...toolInfo4,
   handler: handler4
 };
@@ -48573,7 +48581,7 @@ var listFiles_default = {
 // ../core/src/tools/listMemoryTopics.ts
 var toolInfo6 = {
   name: "listMemoryTopics",
-  description: "Lists all topics in memory.",
+  description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.",
   parameters: exports_external.object({})
 };
 var handler6 = async (provider, _args) => {
@@ -48595,15 +48603,88 @@ var listMemoryTopics_default = {
   ...toolInfo6,
   handler: handler6
 };
-// ../core/src/tools/readBinaryFile.ts
+// ../core/src/tools/todo.ts
+var TodoStatus = exports_external.enum(["open", "completed", "closed"]);
+var TodoItemSchema = exports_external.object({
+  id: exports_external.string(),
+  title: exports_external.string(),
+  description: exports_external.string(),
+  relevantFileList: exports_external.array(exports_external.string()),
+  status: TodoStatus
+});
+var UpdateTodoItemInputSchema = exports_external.object({
+  operation: exports_external.enum(["add", "update"]),
+  id: exports_external.string().nullish(),
+  parentId: exports_external.string().nullish(),
+  title: exports_external.string().nullish(),
+  description: exports_external.string().nullish(),
+  relevantFileList: exports_external.array(exports_external.string()).nullish(),
+  status: TodoStatus.nullish()
+}).superRefine((data, ctx) => {
+  if (data.operation === "add") {
+    if (!data.title) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'Title is required for "add" operation',
+        path: ["title"]
+      });
+    }
+  } else if (data.operation === "update") {
+    if (!data.id) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'ID is required for "update" operation',
+        path: ["id"]
+      });
+    }
+  }
+});
+var UpdateTodoItemOutputSchema = exports_external.object({
+  id: exports_external.string()
+});
+
+// ../core/src/tools/listTodoItems.ts
 var toolInfo7 = {
+  name: "listTodoItems",
+  description: "List all to-do items, sorted by id. If an id is provided, it lists all sub-items for that id. Can be filtered by status.",
+  parameters: exports_external.object({
+    id: exports_external.string().nullish(),
+    status: TodoStatus.nullish()
+  })
+};
+var handler7 = async (provider, args) => {
+  if (!provider.listTodoItems) {
+    return {
+      type: "Error" /* Error */,
+      message: {
+        type: "error-text",
+        value: "Not possible to list to-do items."
+      }
+    };
+  }
+  const { id, status } = toolInfo7.parameters.parse(args);
+  const items = await provider.listTodoItems(id, status);
+  return {
+    type: "Reply" /* Reply */,
+    message: {
+      type: "json",
+      value: items
+    }
+  };
+};
+var listTodoItems_default = {
+  ...toolInfo7,
+  handler: handler7
+};
+// ../core/src/tools/readBinaryFile.ts
+var toolInfo8 = {
   name: "readBinaryFile",
   description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.",
   parameters: exports_external.object({
     url: exports_external.string().describe("The URL or local path of the file to read.")
   })
 };
-var handler7 = async (provider, args) => {
+var handler8 = async (provider, args) => {
   if (!provider.readBinaryFile) {
     return {
       type: "Error" /* Error */,
@@ -48613,7 +48694,7 @@ var handler7 = async (provider, args) => {
       }
     };
   }
-  const { url: url2 } = toolInfo7.parameters.parse(args);
+  const { url: url2 } = toolInfo8.parameters.parse(args);
   try {
     const filePart = await provider.readBinaryFile(url2);
     return {
@@ -48642,11 +48723,11 @@ var handler7 = async (provider, args) => {
   }
 };
 var readBinaryFile_default = {
-  ...toolInfo7,
-  handler: handler7
+  ...toolInfo8,
+  handler: handler8
 };
 // ../core/src/tools/readFile.ts
-var toolInfo8 = {
+var toolInfo9 = {
   name: "readFile",
   description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.",
   parameters: exports_external.object({
@@ -48683,7 +48764,7 @@ var toolInfo8 = {
     ]
   })
 };
-var handler8 = async (provider, args) => {
+var handler9 = async (provider, args) => {
   if (!provider.readFile) {
     return {
       type: "Error" /* Error */,
@@ -48693,7 +48774,7 @@ var handler8 = async (provider, args) => {
       }
     };
   }
-  const { path: paths, includeIgnored } = toolInfo8.parameters.parse(args);
+  const { path: paths, includeIgnored } = toolInfo9.parameters.parse(args);
   const resp = [];
   for (const path of paths) {
     const fileContent = await provider.readFile(path, includeIgnored);
@@ -48718,19 +48799,19 @@ var handler8 = async (provider, args) => {
   };
 };
 var readFile_default = {
-  ...toolInfo8,
-  handler: handler8
+  ...toolInfo9,
+  handler: handler9
 };
 // ../core/src/tools/readMemory.ts
-var toolInfo9 = {
+var toolInfo10 = {
   name: "readMemory",
-  description: "Reads content from a memory topic.",
+  description: "Reads content from a memory topic. Use this to retrieve information stored in previous steps. If no topic is specified, reads from the default topic.",
   parameters: exports_external.object({
     topic: exports_external.string().optional().describe('The topic to read from memory. Defaults to ":default:".')
   })
 };
-var handler9 = async (provider, args) => {
-  const { topic } = toolInfo9.parameters.parse(args);
+var handler10 = async (provider, args) => {
+  const { topic } = toolInfo10.parameters.parse(args);
   const content = await provider.readMemory(topic);
   if (content) {
     return {
@@ -48752,11 +48833,11 @@ ${content}
   };
 };
 var readMemory_default = {
-  ...toolInfo9,
-  handler: handler9
+  ...toolInfo10,
+  handler: handler10
 };
 // ../core/src/tools/removeFile.ts
-var toolInfo10 = {
+var toolInfo11 = {
   name: "removeFile",
   description: "Request to remove a file at the specified path.",
   parameters: exports_external.object({
@@ -48772,7 +48853,7 @@ var toolInfo10 = {
     ]
   })
 };
-var handler10 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.removeFile) {
     return {
       type: "Error" /* Error */,
@@ -48782,7 +48863,7 @@ var handler10 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo10.parameters.safeParse(args);
+  const parsed = toolInfo11.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -48803,29 +48884,6 @@ var handler10 = async (provider, args) => {
   };
 };
 var removeFile_default = {
-  ...toolInfo10,
-  handler: handler10
-};
-// ../core/src/tools/removeMemory.ts
-var toolInfo11 = {
-  name: "removeMemory",
-  description: "Removes a topic from memory.",
-  parameters: exports_external.object({
-    topic: exports_external.string().optional().describe('The topic to remove from memory. Defaults to ":default:".')
-  })
-};
-var handler11 = async (provider, args) => {
-  const { topic } = toolInfo11.parameters.parse(args);
-  await provider.removeMemory(topic);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Memory topic '${topic || ""}' removed.`
-    }
-  };
-};
-var removeMemory_default = {
   ...toolInfo11,
   handler: handler11
 };
@@ -48874,7 +48932,7 @@ var renameFile_default = {
 };
 // ../core/src/tools/utils/replaceInFile.ts
 var replaceInFile = (fileContent, diff) => {
-  const blockPattern = /<<<<<+ SEARCH>?\s*\r?\n([\s\S]*?)\r?\n=======[ \t]*\r?\n([\s\S]*?)\r?\n?>>>>>+ REPLACE/g;
+  const blockPattern = /^\s*<<<<<+\s*SEARCH>?\s*\r?\n([\s\S]*?)\r?\n=======[ \t]*\r?\n([\s\S]*?)\r?\n?>>>>>+\s*REPLACE\s*$/gm;
   const blocks = [];
   for (let match = blockPattern.exec(diff);match !== null; match = blockPattern.exec(diff)) {
     blocks.push({ search: match[1], replace: match[2] });
@@ -49134,32 +49192,8 @@ var replaceInFile_default = {
   ...toolInfo13,
   handler: handler13
 };
-// ../core/src/tools/replaceMemory.ts
-var toolInfo14 = {
-  name: "replaceMemory",
-  description: "Replaces content of a memory topic.",
-  parameters: exports_external.object({
-    topic: exports_external.string().optional().describe('The topic to replace in memory. Defaults to ":default:".'),
-    content: exports_external.string().describe("The new content.")
-  })
-};
-var handler14 = async (provider, args) => {
-  const { topic, content } = toolInfo14.parameters.parse(args);
-  await provider.replaceMemory(topic, content);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Memory topic '${topic || ""}' replaced.`
-    }
-  };
-};
-var replaceMemory_default = {
-  ...toolInfo14,
-  handler: handler14
-};
 // ../core/src/tools/searchFiles.ts
-var toolInfo15 = {
+var toolInfo14 = {
   name: "searchFiles",
   description: "Request to perform a regex search across files in a specified directory, outputting context-rich results that include surrounding lines. This tool searches for patterns or specific content across multiple files, displaying each match with encapsulating context.",
   parameters: exports_external.object({
@@ -49183,7 +49217,7 @@ var toolInfo15 = {
     ]
   })
 };
-var handler15 = async (provider, args) => {
+var handler14 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
       type: "Error" /* Error */,
@@ -49193,7 +49227,7 @@ var handler15 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo15.parameters.safeParse(args);
+  const parsed = toolInfo14.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49231,11 +49265,112 @@ ${files.join(`
   }
 };
 var searchFiles_default = {
+  ...toolInfo14,
+  handler: handler14
+};
+// ../core/src/tools/updateMemory.ts
+var toolInfo15 = {
+  name: "updateMemory",
+  description: 'Appends, replaces, or removes content from a memory topic. Use "append" to add to existing content, "replace" to overwrite entirely, or "remove" to delete a topic. Memory persists across tool calls within a workflow.',
+  parameters: exports_external.object({
+    operation: exports_external.enum(["append", "replace", "remove"]).describe("The operation to perform."),
+    topic: exports_external.string().nullish().describe('The topic to update in memory. Defaults to ":default:".'),
+    content: exports_external.string().optional().describe("The content for append or replace operations. Must be omitted for remove operation.")
+  }).superRefine((data, ctx) => {
+    if (data.operation === "append" || data.operation === "replace") {
+      if (data.content === undefined) {
+        ctx.addIssue({
+          code: "custom",
+          message: 'Content is required for "append" and "replace" operations.',
+          path: ["content"]
+        });
+      }
+    } else if (data.operation === "remove") {
+      if (data.content !== undefined) {
+        ctx.addIssue({
+          code: "custom",
+          message: 'Content must not be provided for "remove" operation.',
+          path: ["content"]
+        });
+      }
+    }
+  })
+};
+var handler15 = async (provider, args) => {
+  if (!provider.updateMemory) {
+    return {
+      type: "Error" /* Error */,
+      message: {
+        type: "error-text",
+        value: "Memory operations are not supported by the current provider."
+      }
+    };
+  }
+  const params = toolInfo15.parameters.parse(args);
+  await provider.updateMemory(params.operation, params.topic ?? undefined, "content" in params ? params.content : undefined);
+  switch (params.operation) {
+    case "append":
+      return {
+        type: "Reply" /* Reply */,
+        message: {
+          type: "text",
+          value: `Content appended to memory topic '${params.topic || ":default:"}'.`
+        }
+      };
+    case "replace":
+      return {
+        type: "Reply" /* Reply */,
+        message: {
+          type: "text",
+          value: `Memory topic '${params.topic || ":default:"}' replaced.`
+        }
+      };
+    case "remove":
+      return {
+        type: "Reply" /* Reply */,
+        message: {
+          type: "text",
+          value: `Memory topic '${params.topic || ":default:"}' removed.`
+        }
+      };
+  }
+};
+var updateMemory_default = {
   ...toolInfo15,
   handler: handler15
 };
-// ../core/src/tools/writeToFile.ts
+// ../core/src/tools/updateTodoItem.ts
 var toolInfo16 = {
+  name: "updateTodoItem",
+  description: "Add or update a to-do item.",
+  parameters: UpdateTodoItemInputSchema
+};
+var handler16 = async (provider, args) => {
+  if (!provider.updateTodoItem) {
+    return {
+      type: "Error" /* Error */,
+      message: {
+        type: "error-text",
+        value: "Not possible to update a to-do item."
+      }
+    };
+  }
+  const input = toolInfo16.parameters.parse(args);
+  const result = await provider.updateTodoItem(input);
+  return {
+    type: "Reply" /* Reply */,
+    message: {
+      type: "json",
+      value: result
+    }
+  };
+};
+var updateTodoItem_default = {
+  ...toolInfo16,
+  handler: handler16
+};
+// ../core/src/tools/writeToFile.ts
+var toolInfo17 = {
   name: "writeToFile",
   description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.",
   parameters: exports_external.object({
@@ -49264,7 +49399,7 @@ export default App;
     ]
   })
 };
-var handler16 = async (provider, args) => {
+var handler17 = async (provider, args) => {
   if (!provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -49274,7 +49409,7 @@ var handler16 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo16.parameters.safeParse(args);
+  const parsed = toolInfo17.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49298,8 +49433,8 @@ var handler16 = async (provider, args) => {
   };
 };
 var writeToFile_default = {
-  ...toolInfo16,
-  handler: handler16
+  ...toolInfo17,
+  handler: handler17
 };
 // ../core/src/UsageMeter.ts
 class UsageMeter {
@@ -51340,15 +51475,15 @@ function useKeypress(userHandler) {
   signal.current = userHandler;
   useEffect((rl) => {
     let ignore = false;
-    const handler17 = withUpdates((_input, event) => {
+    const handler18 = withUpdates((_input, event) => {
       if (ignore)
         return;
       signal.current(event, rl);
     });
-    rl.input.on("keypress", handler17);
+    rl.input.on("keypress", handler18);
     return () => {
       ignore = true;
-      rl.input.removeListener("keypress", handler17);
+      rl.input.removeListener("keypress", handler18);
     };
   }, []);
 }
@@ -51507,16 +51642,16 @@ class Emitter {
 
 class SignalExitBase {
 }
-var signalExitWrap = (handler17) => {
+var signalExitWrap = (handler18) => {
   return {
     onExit(cb, opts) {
-      return handler17.onExit(cb, opts);
+      return handler18.onExit(cb, opts);
     },
     load() {
-      return handler17.load();
+      return handler18.load();
     },
     unload() {
-      return handler17.unload();
+      return handler18.unload();
     }
   };
 };
@@ -52340,27 +52475,122 @@ async function searchFiles(path, regex, filePattern, cwd, excludeFiles) {
 var getProvider = (options = {}) => {
   const ig = import_ignore2.default().add(options.excludeFiles ?? []);
   const memoryStore = {};
+  const todoItems = [];
   const defaultMemoryTopic = ":default:";
   const provider2 = {
+    listTodoItems: async (id, status) => {
+      let items;
+      if (!id) {
+        items = todoItems.filter((i) => !i.id.includes("."));
+      } else {
+        const parent = todoItems.find((i) => i.id === id);
+        if (!parent) {
+          throw new Error(`To-do item with id ${id} not found`);
+        }
+        items = todoItems.filter((i) => i.id.startsWith(`${id}.`) && i.id.split(".").length === id.split(".").length + 1);
+      }
+      if (status) {
+        items = items.filter((item) => item.status === status);
+      }
+      items.sort((a, b) => {
+        const aParts = a.id.split(".");
+        const bParts = b.id.split(".");
+        const len = Math.min(aParts.length, bParts.length);
+        for (let i = 0;i < len; i++) {
+          const comparison = aParts[i].localeCompare(bParts[i], undefined, { numeric: true });
+          if (comparison !== 0) {
+            return comparison;
+          }
+        }
+        return aParts.length - bParts.length;
+      });
+      return items;
+    },
+    getTodoItem: async (id) => {
+      const item = todoItems.find((i) => i.id === id);
+      if (!item) {
+        throw new Error(`To-do item with id ${id} not found`);
+      }
+      const subItems = todoItems.filter((i) => i.id.startsWith(`${id}.`) && i.id.split(".").length === id.split(".").length + 1).map(({ id: id2, title }) => ({ id: id2, title }));
+      return { ...item, subItems };
+    },
+    updateTodoItem: async (input) => {
+      if (input.operation === "add") {
+        const { parentId, title, description, relevantFileList } = input;
+        if (!title) {
+          throw new Error("Title is required for add operation");
+        }
+        let newId;
+        if (parentId) {
+          const parent = todoItems.find((i) => i.id === parentId);
+          if (!parent) {
+            throw new Error(`Parent to-do item with id ${parentId} not found`);
+          }
+          const childItems = todoItems.filter((i) => i.id.startsWith(`${parentId}.`) && i.id.split(".").length === parentId.split(".").length + 1);
+          newId = `${parentId}.${childItems.length + 1}`;
+        } else {
+          const rootItems = todoItems.filter((i) => !i.id.includes("."));
+          newId = `${rootItems.length + 1}`;
+        }
+        const newItem = {
+          id: newId,
+          title,
+          description: description ?? "",
+          relevantFileList: relevantFileList ?? [],
+          status: "open"
+        };
+        todoItems.push(newItem);
+        return { id: newId };
+      } else {
+        const { id } = input;
+        if (!id) {
+          throw new Error("ID is required for update operation");
+        }
+        const item = todoItems.find((i) => i.id === id);
+        if (!item) {
+          throw new Error(`To-do item with id ${id} not found`);
+        }
+        if (input.title != null) {
+          item.title = input.title;
+        }
+        if (input.description != null) {
+          item.description = input.description ?? "";
+        }
+        if (input.relevantFileList != null) {
+          item.relevantFileList = input.relevantFileList;
+        }
+        if (input.status != null) {
+          item.status = input.status;
+        }
+        return { id };
+      }
+    },
     listMemoryTopics: async () => {
       return Object.keys(memoryStore);
     },
     readMemory: async (topic = defaultMemoryTopic) => {
       return memoryStore[topic];
     },
-    appendMemory: async (topic = defaultMemoryTopic, content) => {
-      if (memoryStore[topic]) {
-        memoryStore[topic] += content;
-      } else {
-        memoryStore[topic] = content;
+    updateMemory: async (operation, topic, content) => {
+      const memoryTopic = topic ?? defaultMemoryTopic;
+      switch (operation) {
+        case "append":
+          if (content === undefined) {
+            throw new Error("Content is required for append operation.");
+          }
+          memoryStore[memoryTopic] = (memoryStore[memoryTopic] || "") + content;
+          break;
+        case "replace":
+          if (content === undefined) {
+            throw new Error("Content is required for replace operation.");
+          }
+          memoryStore[memoryTopic] = content;
+          break;
+        case "remove":
+          delete memoryStore[memoryTopic];
+          break;
       }
     },
-    replaceMemory: async (topic = defaultMemoryTopic, content) => {
-      memoryStore[topic] = content;
-    },
-    removeMemory: async (topic = defaultMemoryTopic) => {
-      delete memoryStore[topic];
-    },
     readFile: async (path, includeIgnored) => {
       if (!includeIgnored && ig.ignores(path)) {
         throw new Error(`Not allow to access file ${path}`);
@@ -64119,16 +64349,12 @@ var uiMessagesSchema = lazyValidator(() => zodSchema(exports_external.array(expo
 
 // ../workflow/src/agent.workflow.ts
 var agentWorkflow = async (input, { step, tools: tools2 }) => {
-  const event = async (name17, event2) => {
-    await step(name17, async () => {
-      await tools2.taskEvent(event2);
-    });
-  };
-  const { tools: toolInfo17, maxToolRoundTrips = 200 } = input;
+  const event = (name17, event2) => step(name17, () => tools2.taskEvent(event2));
+  const { tools: toolInfo18, maxToolRoundTrips = 200 } = input;
   const messages = "systemPrompt" in input ? [{ role: "system", content: input.systemPrompt }] : input.messages;
   await event("start-task", { kind: "StartTask" /* StartTask */, systemPrompt: "systemPrompt" in input ? input.systemPrompt : "" });
   const toolSet = {};
-  for (const tool3 of toolInfo17) {
+  for (const tool3 of toolInfo18) {
     toolSet[tool3.name] = {
       description: tool3.description,
       inputSchema: jsonSchema(toJSONSchema(tool3.parameters))
@@ -64176,7 +64402,9 @@ var agentWorkflow = async (input, { step, tools: tools2 }) => {
     await event(`end-round-${i}`, { kind: "EndRequest" /* EndRequest */, message: textContent });
     if (toolCalls.length === 0) {
       if (!input.outputSchema) {
-        return { type: "Exit" /* Exit */, message: textContent };
+        const exitReason2 = { type: "Exit" /* Exit */, message: textContent };
+        await event("end-task", { kind: "EndTask" /* EndTask */, exitReason: exitReason2 });
+        return exitReason2;
       }
       const parsed = parseJsonFromMarkdown(textContent);
       if (!parsed.success) {
@@ -64190,7 +64418,9 @@ var agentWorkflow = async (input, { step, tools: tools2 }) => {
         nextMessage = [{ role: "user", content: errorMessage }];
         continue;
       }
-      return { type: "Exit" /* Exit */, message: textContent, object: validated.data };
+      const exitReason = { type: "Exit" /* Exit */, message: textContent, object: validated.data };
+      await event("end-task", { kind: "EndTask" /* EndTask */, exitReason });
+      return exitReason;
     }
     const toolResults = [];
     for (const toolCall of toolCalls) {
@@ -64259,6 +64489,7 @@ var agentWorkflow = async (input, { step, tools: tools2 }) => {
       }
     ];
   }
+  await event("end-task", { kind: "EndTask" /* EndTask */, exitReason: { type: "UsageExceeded" } });
   throw new Error("Maximum number of tool round trips reached.");
 };
 // ../workflow/src/json-ai-types.ts
@@ -64828,19 +65059,110 @@ var chalk = createChalk();
 var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
+// ../cli-shared/src/utils/parameterSimplifier.ts
+function replaceInFileSimplifier(params) {
+  return { path: params.path };
+}
+function writeToFileSimplifier(params) {
+  return { path: params.path };
+}
+function readFileSimplifier(params) {
+  return { path: params.path, includeIgnored: params.includeIgnored };
+}
+function listFilesSimplifier(params) {
+  const maxCount = params.maxCount;
+  return {
+    path: params.path,
+    recursive: params.recursive,
+    ...maxCount !== 2000 && { maxCount }
+  };
+}
+function searchFilesSimplifier(params) {
+  return { ...params };
+}
+function executeCommandSimplifier(params) {
+  return { command: params.command, requiresApproval: params.requiresApproval };
+}
+function updateMemorySimplifier(params) {
+  return { operation: params.operation, topic: params.topic };
+}
+var SIMPLIFIERS = {
+  replaceInFile: replaceInFileSimplifier,
+  writeToFile: writeToFileSimplifier,
+  readFile: readFileSimplifier,
+  listFiles: listFilesSimplifier,
+  searchFiles: searchFilesSimplifier,
+  executeCommand: executeCommandSimplifier,
+  updateMemory: updateMemorySimplifier
+};
+function simplifyToolParameters(toolName, params) {
+  if (params === undefined || params === null) {
+    return {};
+  }
+  const simplifier = SIMPLIFIERS[toolName];
+  if (simplifier) {
+    return simplifier(params);
+  }
+  return { ...params };
+}
+
 // ../cli-shared/src/utils/eventHandler.ts
-var toolCallStats = new Map;
+var taskToolCallStats = new Map;
+var globalToolCallStats = new Map;
+function logToolCallStats(stream, statsMap, title) {
+  const customConsole = new Console(stream, stream);
+  customConsole.log(`
+
+======== ${title} ========`);
+  if (statsMap.size > 0) {
+    const tableData = [...statsMap.entries()].map(([tool3, stats]) => {
+      const successRate = stats.calls > 0 ? stats.success / stats.calls * 100 : 0;
+      return {
+        "Tool Name": tool3,
+        Calls: stats.calls,
+        Success: stats.success,
+        Errors: stats.errors,
+        "Success Rate": `${successRate.toFixed(2)}%`
+      };
+    });
+    customConsole.table(tableData);
+  } else {
+    customConsole.log("No tools were called.");
+  }
+}
+var mergeToolCallStats = (a, b) => {
+  const merged = new Map;
+  for (const [tool3, stat] of a) {
+    merged.set(tool3, { ...stat });
+  }
+  for (const [tool3, stat] of b) {
+    const existing = merged.get(tool3);
+    if (existing) {
+      existing.calls += stat.calls;
+      existing.success += stat.success;
+      existing.errors += stat.errors;
+    } else {
+      merged.set(tool3, { ...stat });
+    }
+  }
+  return merged;
+};
+function logGlobalToolCallStats(stream) {
+  const merged = mergeToolCallStats(globalToolCallStats, taskToolCallStats);
+  logToolCallStats(stream, merged, "Global Tool Call Stats");
+}
 var printEvent = (verbose, usageMeter, stream = process.stdout) => {
   if (verbose < 0) {
     return () => {};
   }
   const customConsole = new Console(stream, stream);
   let hadReasoning = false;
+  let hasText = false;
   const write = stream.write.bind(stream);
   return (event) => {
     switch (event.kind) {
       case "StartTask" /* StartTask */:
-        toolCallStats.clear();
+        taskToolCallStats.clear();
         if (verbose > 2) {
           customConsole.log(`
 ====== System Prompt ======
@@ -64852,10 +65174,13 @@ ${event.systemPrompt}`);
         }
         break;
       case "StartRequest" /* StartRequest */:
-        customConsole.log(`
+        hasText = false;
+        if (verbose > 0) {
+          customConsole.log(`
 
 ======== New Request ========
 `);
+        }
         if (verbose > 1) {
           for (const message of event.userMessage) {
             const userMessage = message.content;
@@ -64899,10 +65224,17 @@ ${event.systemPrompt}`);
         }
         break;
       case "EndRequest" /* EndRequest */:
-        customConsole.log(`
+        if (verbose > 0) {
+          customConsole.log(`
 
 ======== Request Ended ========
 `);
+        }
+        if (verbose === 0 && hasText) {
+          write(`
+
+`);
+        }
         if (verbose > 1) {
           customConsole.log(usageMeter.getUsageText());
         }
@@ -64914,27 +65246,34 @@ ${event.systemPrompt}`);
 `);
           hadReasoning = false;
         }
+        if (event.newText.trim().length > 0) {
+          hasText = true;
+        }
         write(event.newText);
         break;
       }
       case "Reasoning" /* Reasoning */: {
-        write(source_default.dim(event.newText));
-        hadReasoning = true;
+        if (verbose > 0) {
+          write(source_default.dim(event.newText));
+          hadReasoning = true;
+        }
         break;
       }
       case "ToolUse" /* ToolUse */: {
-        customConsole.log(source_default.yellow(`
+        if (verbose > 0) {
+          customConsole.log(source_default.yellow(`
 
-Tool use:`, event.tool), event.params);
-        const stats = toolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
+Tool use:`, event.tool), simplifyToolParameters(event.tool, event.params));
+        }
+        const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.calls++;
-        toolCallStats.set(event.tool, stats);
+        taskToolCallStats.set(event.tool, stats);
         break;
       }
       case "ToolReply" /* ToolReply */: {
-        const stats = toolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
+        const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.success++;
-        toolCallStats.set(event.tool, stats);
+        taskToolCallStats.set(event.tool, stats);
         break;
       }
       case "ToolError" /* ToolError */: {
@@ -64942,9 +65281,9 @@ Tool use:`, event.tool), event.params);
 
 Tool error:`, event.tool));
         customConsole.error(event.error);
-        const stats = toolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
+        const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.errors++;
-        toolCallStats.set(event.tool, stats);
+        taskToolCallStats.set(event.tool, stats);
         break;
       }
       case "UsageExceeded" /* UsageExceeded */:
@@ -64960,27 +65299,27 @@ Tool error:`, event.tool));
 `);
         customConsole.log("Reason:", event.exitReason.type);
         switch (event.exitReason.type) {
+          case "Error": {
+            const { error: error46 } = event.exitReason;
+            customConsole.error(source_default.red(`Workflow failed: ${error46.message}`));
+            if (verbose > 0 && error46.stack) {
+              customConsole.error(source_default.red(error46.stack));
+            }
+            break;
+          }
           case "Exit" /* Exit */:
             customConsole.log("Exit Message:", event.exitReason.message);
             break;
         }
-        customConsole.log(`
-
-======== Tool Call Stats ========`);
-        if (toolCallStats.size > 0) {
-          const tableData = [...toolCallStats.entries()].map(([tool3, stats]) => {
-            const successRate = stats.calls > 0 ? stats.success / stats.calls * 100 : 0;
-            return {
-              "Tool Name": tool3,
-              Calls: stats.calls,
-              Success: stats.success,
-              Errors: stats.errors,
-              "Success Rate": `${successRate.toFixed(2)}%`
-            };
-          });
-          customConsole.table(tableData);
-        } else {
-          customConsole.log("No tools were called.");
+        for (const [tool3, taskStats] of taskToolCallStats.entries()) {
+          const globalStats = globalToolCallStats.get(tool3) ?? { calls: 0, success: 0, errors: 0 };
+          globalStats.calls += taskStats.calls;
+          globalStats.success += taskStats.success;
+          globalStats.errors += taskStats.errors;
+          globalToolCallStats.set(tool3, globalStats);
+        }
+        if (verbose > 0) {
+          logToolCallStats(stream, taskToolCallStats, "Task Tool Call Stats");
         }
         break;
     }
@@ -77469,7 +77808,7 @@ function annotateDiffWithLineNumbers(diff) {
 }
 
 // src/tools/gitDiff.ts
-var toolInfo17 = {
+var toolInfo18 = {
   name: "git_diff",
   description: "Get the git diff for the current repository. Can be used to get staged changes, unstaged changes, or changes between commits. By default, it returns unstaged changes.",
   parameters: exports_external.object({
@@ -77498,7 +77837,7 @@ var toolInfo17 = {
     }, exports_external.boolean().optional().default(false)).describe("Annotate the diff with line numbers for additions and deletions.")
   })
 };
-var handler17 = async (provider3, args) => {
+var handler18 = async (provider3, args) => {
   if (!provider3.executeCommand) {
     return {
       type: "Error" /* Error */,
@@ -77508,7 +77847,7 @@ var handler17 = async (provider3, args) => {
       }
     };
   }
-  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo17.parameters.parse(args);
+  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo18.parameters.parse(args);
   const commandParts = ["git", "diff", "--no-color", `-U${contextLines}`];
   if (staged) {
     commandParts.push("--staged");
@@ -77565,8 +77904,8 @@ ${result.stderr}`
   }
 };
 var gitDiff_default = {
-  ...toolInfo17,
-  handler: handler17
+  ...toolInfo18,
+  handler: handler18
 };
 // src/utils/cacheControl.ts
 var CACHEABLE_MODELS = ["sonnet", "opus", "haiku", "gemini"];
@@ -77889,17 +78228,18 @@ var allTools = [
   listFiles_default,
   readBinaryFile_default,
   readFile_default,
-  appendMemory_default,
   readMemory_default,
-  replaceMemory_default,
-  removeMemory_default,
   listMemoryTopics_default,
+  updateMemory_default,
   removeFile_default,
   renameFile_default,
   replaceInFile_default,
   searchFiles_default,
   writeToFile_default,
-  gitDiff_default
+  gitDiff_default,
+  getTodoItem_default,
+  listTodoItems_default,
+  updateTodoItem_default
 ];
 var toolHandlers = new Map(allTools.map((t) => [t.name, t]));
 async function createPullRequest(input, _context) {
@@ -77944,6 +78284,7 @@ async function confirm(input, context) {
   }
   await new Promise((resolve4) => setTimeout(resolve4, 50));
   try {
+    process.stderr.write("\x07");
     const result = await esm_default2({ message: input.message });
     return result;
   } catch (_e) {
@@ -77955,6 +78296,7 @@ async function input(input2, context) {
     return input2.default ?? "";
   }
   await new Promise((resolve4) => setTimeout(resolve4, 50));
+  process.stderr.write("\x07");
   const result = await getUserInput(input2.message, {
     default: input2.default
   });
@@ -77969,6 +78311,7 @@ async function select(input2, context) {
   }
   await new Promise((resolve4) => setTimeout(resolve4, 50));
   try {
+    process.stderr.write("\x07");
     const result = await esm_default5({ message: input2.message, choices: input2.choices });
     return result;
   } catch (_e) {
@@ -78158,17 +78501,22 @@ ${defaultContent}
   return contextParts.join(`
 `);
 }
-async function appendMemory(input2, context) {
+async function updateMemory(input2, context) {
   const provider3 = context.toolProvider;
-  await provider3.appendMemory(input2.topic, input2.content);
+  const content = "content" in input2 ? input2.content : undefined;
+  return provider3.updateMemory(input2.operation, input2.topic, content);
 }
-async function replaceMemory(input2, context) {
+async function listTodoItems(input2, context) {
   const provider3 = context.toolProvider;
-  await provider3.replaceMemory(input2.topic, input2.content);
+  return provider3.listTodoItems(input2.id, input2.status);
 }
-async function removeMemory(input2, context) {
+async function getTodoItem(input2, context) {
   const provider3 = context.toolProvider;
-  await provider3.removeMemory(input2.topic);
+  return provider3.getTodoItem(input2.id);
+}
+async function updateTodoItem(input2, context) {
+  const provider3 = context.toolProvider;
+  return provider3.updateTodoItem(input2);
 }
 var localToolHandlers = {
   createPullRequest,
@@ -78184,14 +78532,15 @@ var localToolHandlers = {
   invokeTool,
   taskEvent,
   getMemoryContext,
-  appendMemory,
-  replaceMemory,
-  removeMemory
+  updateMemory,
+  listTodoItems,
+  getTodoItem,
+  updateTodoItem
 };
 async function toolCall(toolCall2, context) {
-  const handler18 = localToolHandlers[toolCall2.tool];
-  if (handler18) {
-    return handler18(toolCall2.input, context);
+  const handler19 = localToolHandlers[toolCall2.tool];
+  if (handler19) {
+    return handler19(toolCall2.input, context);
   }
   throw new Error(`Unknown tool: ${toolCall2.tool}`);
 }
@@ -78256,19 +78605,27 @@ async function runWorkflow(workflow2, workflowInput, options) {
   try {
     logger.info("Running workflow...");
     const output = await workflow2(workflowInput, context);
-    logger.info("Workflow completed successfully.");
+    logger.info(`
+
+Workflow completed successfully.`);
     logger.info(usage.getUsageText());
     return output;
   } catch (e) {
     const error46 = e;
+    onEvent({
+      kind: "EndTask" /* EndTask */,
+      exitReason: {
+        type: "Error",
+        error: { message: error46.message, stack: error46.stack }
+      }
+    });
     if (error46 instanceof UserCancelledError) {
       logger.warn("Workflow cancelled by user.");
-    } else {
-      logger.error(`Workflow failed: ${error46.message}`);
-      logger.error(error46);
     }
     logger.info(usage.getUsageText());
     return;
+  } finally {
+    logGlobalToolCallStats(process.stderr);
   }
 }
 
@@ -78280,14 +78637,23 @@ ${JSON.stringify(schema, null, 2)}
 \`\`\`
 `;
 }
+var TOOL_USAGE_INSTRUCTION = `When you use a tool, you MUST first provide a short summary of what you are doing and why you are using that tool. This summary will be shown to the user to explain your actions.`;
 var MEMORY_USAGE_SECTION = `## Memory Usage
 
 You have access to a memory feature to store and retrieve information across tool calls.
 
-Use memory to:
-- Store context between steps.
-- Keep track of important information like file paths or decisions made.
-- Avoid re-running expensive discovery tools.
+### Topic Organization
+
+Memory is organized using topics, which are like named containers for different types of information:
+- **Default topic** (\`:default:\`): Used when no topic is specified. Good for general context.
+- **Named topics**: Create meaningful topic names to organize different types of information
+
+### Best Practices
+
+- Store decisions and context that inform subsequent steps
+- Use named topics to organize different types of information
+- Use the default topic for simple, single-context scenarios
+- Memory persists across all tool calls within the current workflow
 `;
 var PLANNER_SYSTEM_PROMPT = `Role: Expert software architect and planner.
 Goal: Analyze user requests and create detailed, actionable implementation plans for software development tasks.
@@ -78296,6 +78662,8 @@ You are an expert software architect and planner with deep experience in breakin
 
 ${MEMORY_USAGE_SECTION}
 
+${TOOL_USAGE_INSTRUCTION}
+
 ## Your Role
 
 As a planner, your expertise lies in:
@@ -78303,7 +78671,8 @@ As a planner, your expertise lies in:
 - Exploring codebases to identify patterns, conventions, and integration points
 - Breaking down complex tasks into clear, logical sequences of steps
 - Anticipating dependencies, edge cases, and potential challenges
-- Creating plans that are specific, actionable, and implementable by other developers or AI agents
+- Creating plans that can be executed autonomously by an AI coding agent
+- Providing technical specificity required for autonomous implementation
 
 ## Planning Philosophy
 
@@ -78322,16 +78691,39 @@ Effective planning requires understanding before action:
    - Understanding context prevents suggesting solutions that don't fit the project
 
 3. **Specificity Over Generality**
-   - Vague plans lead to implementation confusion
+   - Vague plans lead to implementation confusion and prevent autonomous execution
    - Instead of "implement the feature," specify which files to modify, what functions to add, and what logic to implement
    - Name specific components, modules, or files when possible
    - Describe what needs to change and why
-
-4. **Clarity for AI and Human Implementers**
-   - Plans should be understandable and actionable by someone else
-   - Each step should have a clear deliverable
-   - Break complex tasks into smaller, logical units
+   - Examples:
+     * ❌ Vague: "Implement the feature"
+     * ✅ Specific: "Create \`src/components/LoginForm.tsx\` with a React component that includes email and password fields, using the existing \`useAuth\` hook from \`src/hooks/useAuth.ts\`"
+     * ❌ Vague: "Add error handling"
+     * ✅ Specific: "In \`src/api/client.ts\`, wrap the fetch call in a try-catch block and throw custom errors using the \`ApiError\` class from \`src/errors.ts\`"
+
+4. **Clarity for AI Coding Agents**
+   - Plans will be executed autonomously by an AI coding agent without human intervention
+   - Break complex tasks into smaller, logical units that can be completed independently
    - Use clear structure (numbered lists, narrative text, or combined formats) to organize steps
+   - Include exact file paths, function names, and implementation patterns
+
+## Planning for AI Implementation
+
+Plans will be executed by an AI coding agent that operates autonomously with the following capabilities:
+
+**Planning Requirements:**
+Plans should include specific technical details to enable autonomous implementation:
+- **Function/class names**: Name specific functions, classes, or components to implement
+- **Implementation patterns**: Reference existing patterns or provide clear guidance on approach
+- **Import statements**: Specify required dependencies and where to import them from
+- **Technical constraints**: Note any architectural decisions, performance requirements, or compatibility concerns
+
+**What Makes a Good AI-Actionable Plan:**
+- Each step can be completed using the available tools
+- File paths and code structures are explicitly named
+- Dependencies between steps are clear
+- Implementation approach follows existing codebase patterns
+- Technical requirements are specific, not general
 
 ## Your Approach
 
@@ -78408,9 +78800,11 @@ When generating your plan, follow these formatting guidelines:
       2. Implement feature B
       3. Write tests
 
-5. Only include relevant details for AI Agents:
-    a. Avoid unnecessary technical jargon or implementation details
-    b. Avoid steps that require human intervention or cannot be done by an AI agent
+5. Include implementation-ready details for AI agents:
+    a. Provide specific technical details the coding agent needs (file paths, function signatures, etc.)
+    b. Avoid steps that require human intervention or manual processes
+    c. Each step should be implementable using the AI agent's available tools
+    d. Reference existing code patterns and conventions from the codebase
 
 **Note**: Plans should use flexible formats such as numbered lists or narrative text. Checklist formats (markdown checkboxes) are NOT required and should only be used when specifically appropriate for tracking independent action items.
 
@@ -78455,6 +78849,8 @@ You are an expert software architect specializing in creating high-level plans f
 
 ${MEMORY_USAGE_SECTION}
 
+${TOOL_USAGE_INSTRUCTION}
+
 ## Your Role
 
 As a high-level planner for epics, your expertise lies in:
@@ -78572,9 +78968,12 @@ ${createJsonResponseInstruction({
   reason: "If no plan is needed, provide a reason here."
 })}
 `;
+var BRANCH_NAME_PATTERN = /^[a-zA-Z0-9/_-]+$/;
 var EpicPlanSchema = exports_external.object({
   plan: exports_external.string().nullish(),
-  branchName: exports_external.string(),
+  branchName: exports_external.string().refine((name18) => name18.length >= 3, { message: "Branch name is too short (min 3 characters)." }).refine((name18) => name18.length <= 255, { message: "Branch name is too long (max 255 characters)." }).refine((name18) => BRANCH_NAME_PATTERN.test(name18), {
+    message: "Invalid branch name format. Branch names should contain only letters, numbers, hyphens, underscores, and forward slashes."
+  }),
   question: exports_external.object({
     question: exports_external.string(),
     defaultAnswer: exports_external.string().nullish()
@@ -78596,57 +78995,23 @@ ${task}
 </task>
 ${planSection}`;
 }
-var EPIC_PLAN_UPDATE_SYSTEM_PROMPT = `Role: Plan update agent
-Goal: Update the epic plan by marking the completed item and determining if work is complete
+var EPIC_ADD_TODO_ITEMS_SYSTEM_PROMPT = `Role: Task creation agent
+Goal: Read a high-level plan and create corresponding todo items.
 
-You are a plan update agent responsible for tracking progress on an epic by updating the plan.
+${TOOL_USAGE_INSTRUCTION}
 
-${MEMORY_USAGE_SECTION}
+You are a task creation agent. Your responsibility is to read a high-level plan for an epic and create a todo item for each task in the plan.
 
 ## Your Task
 
-You will receive:
-- **Current plan** (may use checkboxes \`- [ ]\`/\`- [x]\`, numbered lists, or other formats)
-- **Implementation summary** describing what was just completed
-- **The specific task** that was just implemented
+You will have access to the high-level plan stored in memory under the topic 'epic-plan'.
+Read the plan and for each task item in the plan, use the 'updateTodoItem' tool to create a new todo item.
 
 ## Process
 
-1. **Find the completed item**: Locate the item in the plan that matches the completed task
-2. **Mark it as complete**: 
-   - If using checkboxes: Change \`- [ ]\` to \`- [x]\`
-   - If using numbered lists: Add a ✅ prefix (e.g., "1. Task" → "✅ 1. Task")
-   - If using narrative: Mark completion in context-appropriate way
-3. **Scan for next task**: Find the next incomplete item
-4. **Determine completion status**: Check if all items are complete
-
-## Output Requirements
-
-Return:
-- **updatedPlan**: The full plan text with the completed item marked
-- **isComplete**: boolean - true if all items are done, false if incomplete items remain
-- **nextTask**: The text of the next incomplete item, or null if all items are complete
-
-## Important Notes
-
-- Keep the plan structure and formatting intact
-- Adapt completion marking to match the plan's format
-- Extract the next task text without format prefixes (e.g., without "- [ ]" or "1.")
-- If multiple incomplete items remain, return the first one in document order
-
-## Response Format
-
-${createJsonResponseInstruction({
-  updatedPlan: "The full plan with completed item marked",
-  isComplete: false,
-  nextTask: "The text of the next incomplete item (or null if complete)"
-})}
+1. Parse the plan to identify individual tasks.
+2. For each task, call 'updateTodoItem' with the task description as the 'title'.
 `;
-var UpdatedPlanSchema = exports_external.object({
-  updatedPlan: exports_external.string().describe("The updated plan with completed item marked as [x]"),
-  isComplete: exports_external.boolean().describe("True if all checklist items are completed, false if incomplete items remain"),
-  nextTask: exports_external.string().nullish().describe("The next incomplete checklist item to implement, or null if complete")
-});
 var CODER_SYSTEM_PROMPT = `Role: AI developer.
 Goal: Implement the provided plan by writing and modifying code.
 
@@ -78654,6 +79019,8 @@ Your task is to implement the plan created and approved in Phase 1.
 
 ${MEMORY_USAGE_SECTION}
 
+${TOOL_USAGE_INSTRUCTION}
+
 ## Implementation Guidelines
 
 ### 1. Plan Analysis
@@ -78727,6 +79094,8 @@ You are an expert software developer. Your task is to fix a project that is fail
 
 ${MEMORY_USAGE_SECTION}
 
+${TOOL_USAGE_INSTRUCTION}
+
 After making changes, you MUST return a JSON object in a markdown block with either a summary of the changes OR a bailReason if you cannot complete the task.
 
 Example for successful fix:
@@ -78764,6 +79133,8 @@ ${stderr || "(empty)"}
 var CODE_REVIEW_SYSTEM_PROMPT = `Role: Senior software engineer.
 Goal: Review code changes and provide specific, actionable feedback on any issues found.
 
+${TOOL_USAGE_INSTRUCTION}
+
 # Code Review Prompt
 
 You are a senior software engineer reviewing code changes.
@@ -78878,6 +79249,8 @@ ${instructions}
 var COMMIT_MESSAGE_SYSTEM_PROMPT = `Role: Expert git user.
 Goal: Generate a concise and descriptive commit message in conventional commit format based on staged changes.
 
+${TOOL_USAGE_INSTRUCTION}
+
 You are an expert at writing git commit messages.
 Based on the provided list of staged files in <file_status>, the diff in <diff> and optional user context in <tool_input_context>, generate a concise and descriptive commit message.
 
@@ -78890,6 +79263,8 @@ ${createJsonResponseInstruction({
 var GET_PR_DETAILS_SYSTEM_PROMPT = `Role: Expert developer.
 Goal: Generate a pull request title and description based on the branch name, commits, and diff.
 
+${TOOL_USAGE_INSTRUCTION}
+
 You are an expert at creating pull requests.
 Based on the provided branch name, commit messages, and diff, generate a title and description for the pull request.
 
@@ -78902,6 +79277,8 @@ var INIT_WORKFLOW_ANALYZE_SYSTEM_PROMPT = `
 Role: Analyzer agent
 Goal: Produce a valid polkacodes YAML configuration for the project.
 
+${TOOL_USAGE_INSTRUCTION}
+
 Workflow
 1. Scan project files to identify the project's characteristics. Start using the "readFile" tool to understand the project's dependencies, scripts, and basic configuration.
    - Package/build tool (npm, bun, pnpm, etc.)
@@ -79060,9 +79437,7 @@ ${memoryContext}`
           removeFile_default,
           renameFile_default,
           readMemory_default,
-          appendMemory_default,
-          replaceMemory_default,
-          removeMemory_default,
+          updateMemory_default,
           listMemoryTopics_default
         ],
         outputSchema: FixIterationSummarySchema
@@ -79077,7 +79452,7 @@ ${memoryContext}`
         }
         if (summary) {
           summaries.push(summary);
-          await tools2.appendMemory({ content: `Summary of changes for fix attempt ${i + 1}: ${summary}` });
+          await tools2.updateMemory({ operation: "append", content: `Summary of changes for fix attempt ${i + 1}: ${summary}` });
           logger.info(`Summary of changes: ${summary}`);
         }
       }
@@ -79130,9 +79505,7 @@ ${defaultContext}`;
     fetchUrl_default,
     listMemoryTopics_default,
     readMemory_default,
-    appendMemory_default,
-    replaceMemory_default,
-    removeMemory_default
+    updateMemory_default
   ];
   if (interactive) {
     agentTools.push(askFollowupQuestion_default);
@@ -79373,9 +79746,7 @@ ${fileContentString}`;
     removeFile_default,
     renameFile_default,
     readMemory_default,
-    appendMemory_default,
-    replaceMemory_default,
-    removeMemory_default,
+    updateMemory_default,
     listMemoryTopics_default
   ];
   if (mode === "interactive") {
@@ -79419,7 +79790,8 @@ ${memoryContext}`
       summaries.push(summary);
       logger.info(`Summary: ${summary}`);
       await step("summarize-implementation", async () => {
-        await tools2.appendMemory({
+        await tools2.updateMemory({
+          operation: "append",
           topic: "implementation-summary",
           content: summary
         });
@@ -79851,107 +80223,6 @@ ${provider3.toUpperCase()}_API_KEY=${providerConfig.apiKey}`;
 };
 // src/workflows/epic.workflow.ts
 var MAX_REVIEW_RETRIES = 5;
-var BRANCH_NAME_PATTERN = /^[a-zA-Z0-9/_-]+$/;
-function validateBranchName(name18) {
-  if (!BRANCH_NAME_PATTERN.test(name18)) {
-    return {
-      valid: false,
-      error: `Invalid branch name format: "${name18}". Branch names should contain only letters, numbers, hyphens, underscores, and forward slashes.`
-    };
-  }
-  if (name18.length > 255) {
-    return { valid: false, error: "Branch name is too long (max 255 characters)." };
-  }
-  return { valid: true };
-}
-async function performReviewAndFixCycle(iterationCount, taskItem, currentPlan, context) {
-  const { logger, step, tools: tools2 } = context;
-  for (let i = 0;i < MAX_REVIEW_RETRIES; i++) {
-    const diffResult = await tools2.executeCommand({ command: "git", args: ["diff", "--name-status", "HEAD~1", "HEAD"] });
-    const changedFiles = parseGitDiffNameStatus(diffResult.stdout);
-    if (changedFiles.length === 0) {
-      logger.info(`ℹ️  No files were changed. Skipping review.
-`);
-      return { passed: true };
-    }
-    logger.info(`
-\uD83D\uDD0E Review iteration ${i + 1}/${MAX_REVIEW_RETRIES}`);
-    logger.info(`   Changed files: ${changedFiles.length}`);
-    const changeInfo = {
-      commitRange: "HEAD~1...HEAD",
-      changedFiles
-    };
-    const reviewAgentResult = await step(`review-${iterationCount}-${i}`, async () => {
-      const defaultContext = await getDefaultContext();
-      const memoryContext = await tools2.getMemoryContext();
-      const userMessage = `${defaultContext}
-${memoryContext}
-
-${formatReviewToolInput(changeInfo)}`;
-      return await agentWorkflow({
-        systemPrompt: CODE_REVIEW_SYSTEM_PROMPT,
-        userMessage: [{ role: "user", content: userMessage }],
-        tools: [
-          readFile_default,
-          readBinaryFile_default,
-          searchFiles_default,
-          listFiles_default,
-          gitDiff_default,
-          readMemory_default,
-          appendMemory_default,
-          replaceMemory_default,
-          removeMemory_default,
-          listMemoryTopics_default
-        ],
-        outputSchema: reviewOutputSchema
-      }, context);
-    });
-    if (reviewAgentResult.type !== "Exit" /* Exit */) {
-      logger.error(`\uD83D\uDEAB Review agent failed with status: ${reviewAgentResult.type}.`);
-      break;
-    }
-    const reviewResult = reviewAgentResult.object;
-    if (!reviewResult || !reviewResult.specificReviews || reviewResult.specificReviews.length === 0) {
-      logger.info(`✅ Review passed. No issues found.
-`);
-      return { passed: true };
-    }
-    logger.warn(`⚠️  Review found ${reviewResult.specificReviews.length} issue(s). Attempting to fix...
-`);
-    reviewResult.specificReviews.forEach((review, idx) => {
-      logger.warn(`   ${idx + 1}. ${review.file}:${review.lines}`);
-    });
-    logger.warn("");
-    const reviewSummary = reviewResult.specificReviews.map((r) => `File: ${r.file} (lines: ${r.lines})
-Review: ${r.review}`).join(`
-
-`);
-    const fixTask = `You are working on an epic. The original task was: "${taskItem}".
-
-Here is the full plan for context:
-<plan>
-${currentPlan}
-</plan>
-
-After an initial implementation, a review found the following issues. Please fix them:
-
-${reviewSummary}`;
-    await step(`fix-${iterationCount}-${i}`, async () => {
-      await codeWorkflow({ task: fixTask, mode: "noninteractive" }, context);
-    });
-    await step(`commit-fix-${iterationCount}-${i}`, async () => {
-      await tools2.executeCommand({ command: "git", args: ["add", "."] });
-      await tools2.executeCommand({ command: "git", args: ["commit", "--amend", "--no-edit"] });
-    });
-    if (i === MAX_REVIEW_RETRIES - 1) {
-      logger.error(`
-\uD83D\uDEAB Max retries (${MAX_REVIEW_RETRIES}) reached. Moving to the next task, but issues might remain.
-`);
-      return { passed: false };
-    }
-  }
-  return { passed: false };
-}
 async function createPlan2(input2, context) {
   const { task, plan, files, feedback } = input2;
   const content = [{ type: "text", text: getPlanPrompt(task, plan) }];
@@ -79991,9 +80262,7 @@ ${feedback}`
       readBinaryFile_default,
       searchFiles_default,
       readMemory_default,
-      appendMemory_default,
-      replaceMemory_default,
-      removeMemory_default,
+      updateMemory_default,
       listMemoryTopics_default
     ],
     outputSchema: EpicPlanSchema
@@ -80003,37 +80272,113 @@ ${feedback}`
   }
   return { plan: "", reason: "Usage limit exceeded.", type: "Exit" /* Exit */, branchName: "" };
 }
-async function updatePlanAgent(currentPlan, implementationSummary, completedTask, context) {
-  const userMessage = `# Current Plan
-
-<plan>
-${currentPlan}
-</plan>
-
-# Implementation Summary
-
-${implementationSummary}
-
-# Completed Task
-
-${completedTask}
-
-Please update the plan by marking the completed task as [x] and identify the next incomplete task.`;
-  const result = await agentWorkflow({
-    systemPrompt: EPIC_PLAN_UPDATE_SYSTEM_PROMPT,
-    userMessage: [{ role: "user", content: userMessage }],
-    tools: [],
-    outputSchema: UpdatedPlanSchema
-  }, context);
-  if (result.type !== "Exit" /* Exit */ || !result.object) {
-    throw new Error("Plan update agent failed");
+async function createAndApprovePlan(task, context) {
+  const { logger, step, tools: tools2 } = context;
+  logger.info(`\uD83D\uDCDD Phase 2: Creating high-level plan...
+`);
+  let feedback;
+  let highLevelPlan;
+  let branchName;
+  let planAttempt = 1;
+  try {
+    while (true) {
+      const result = await step(`plan-${planAttempt}`, () => createPlan2({ task, feedback }, context));
+      planAttempt++;
+      if (result.question) {
+        const answer = await tools2.input({
+          message: result.question.question,
+          default: result.question.defaultAnswer || undefined
+        });
+        feedback = `The user answered the question "${result.question.question}" with: "${answer}"`;
+        continue;
+      }
+      if (!result.plan) {
+        if (result.reason) {
+          logger.info(`No plan created. Reason: ${result.reason}`);
+        } else {
+          logger.info("No plan created.");
+        }
+        return null;
+      }
+      logger.info(`\uD83D\uDCDD Plan:
+${result.plan}`);
+      if (result.branchName) {
+        logger.info(`\uD83C\uDF3F Suggested branch name: ${result.branchName}`);
+      }
+      feedback = await tools2.input({ message: "Press Enter to approve the plan, or provide feedback to refine it." });
+      if (feedback.trim() === "") {
+        highLevelPlan = result.plan;
+        branchName = result.branchName;
+        break;
+      }
+    }
+  } catch (e) {
+    if (e instanceof UserCancelledError) {
+      logger.info("Plan creation cancelled by user.");
+      return null;
+    }
+    throw e;
   }
-  const updateResult = result.object;
-  return {
-    updatedPlan: updateResult.updatedPlan,
-    isComplete: updateResult.isComplete,
-    nextTask: updateResult.nextTask || null
-  };
+  if (!highLevelPlan) {
+    logger.info("Plan not approved. Exiting.");
+    return null;
+  }
+  if (!branchName) {
+    logger.error("❌ Error: No branch name was generated from the plan. Exiting.");
+    return null;
+  }
+  logger.info(`✅ High-level plan approved.
+`);
+  return { plan: highLevelPlan, branchName };
+}
+async function createFeatureBranch(branchName, context) {
+  const { logger, step, tools: tools2 } = context;
+  logger.info(`\uD83C\uDF3F Phase 3: Creating feature branch...
+`);
+  let finalBranchName = branchName;
+  const initialCheckResult = await step("checkBranch-initial", async () => await tools2.executeCommand({ command: "git", args: ["rev-parse", "--verify", finalBranchName] }));
+  if (initialCheckResult.exitCode === 0) {
+    logger.warn(`⚠️  Branch '${finalBranchName}' already exists. Trying to find an available name...`);
+    const suffixMatch = branchName.match(/-(\d+)$/);
+    let baseName = branchName;
+    let counter = 2;
+    if (suffixMatch) {
+      baseName = branchName.substring(0, suffixMatch.index);
+      counter = parseInt(suffixMatch[1], 10) + 1;
+    }
+    while (true) {
+      finalBranchName = `${baseName}-${counter}`;
+      const branchCheckResult = await step(`checkBranch-${counter}`, async () => await tools2.executeCommand({ command: "git", args: ["rev-parse", "--verify", finalBranchName] }));
+      if (branchCheckResult.exitCode !== 0) {
+        break;
+      }
+      counter++;
+    }
+  }
+  if (finalBranchName !== branchName) {
+    logger.info(`Branch name '${branchName}' was taken. Using '${finalBranchName}' instead.`);
+  }
+  await step("createBranch", async () => await tools2.executeCommand({ command: "git", args: ["checkout", "-b", finalBranchName] }));
+  logger.info(`✅ Branch '${finalBranchName}' created.
+`);
+  return { success: true, branchName: finalBranchName };
+}
+async function addTodoItemsFromPlan(plan, context) {
+  const { logger, step, tools: tools2 } = context;
+  logger.info(`\uD83D\uDCDD Phase 4: Creating todo items from plan...
+`);
+  await step("add-todo-items", async () => {
+    await agentWorkflow({
+      systemPrompt: EPIC_ADD_TODO_ITEMS_SYSTEM_PROMPT,
+      userMessage: [{ role: "user", content: `Please create the todo items based on the plan
+<plan>
+${plan}</plan>` }],
+      tools: [readFile_default, searchFiles_default, listFiles_default, readMemory_default, getTodoItem_default, listTodoItems_default, updateTodoItem_default, updateMemory_default, listMemoryTopics_default]
+    }, context);
+  });
+  const todos = await tools2.listTodoItems({});
+  logger.info(`✅ Created ${todos.length} todo items.
+`);
 }
 async function runPreflightChecks(context) {
   const { logger, step, tools: tools2 } = context;
@@ -80055,261 +80400,336 @@ async function runPreflightChecks(context) {
 `);
   return { success: true };
 }
-var epicWorkflow = async (input2, context) => {
+async function performReviewAndFixCycle(iterationCount, taskItem, highLevelPlan, context) {
   const { logger, step, tools: tools2 } = context;
-  const { task } = input2;
-  const workflowStartTime = Date.now();
-  const commitMessages = [];
-  if (!task || task.trim() === "") {
-    logger.error("❌ Error: Task cannot be empty. Please provide a valid task description.");
-    return;
-  }
-  const preflightResult = await runPreflightChecks(context);
-  if (!preflightResult.success) {
-    return;
-  }
-  async function createAndApprovePlan(task2, context2) {
-    const { logger: logger2, step: step2, tools: tools3 } = context2;
-    logger2.info(`\uD83D\uDCDD Phase 2: Creating high-level plan...
+  for (let i = 0;i < MAX_REVIEW_RETRIES; i++) {
+    const diffResult = await tools2.executeCommand({ command: "git", args: ["diff", "--name-status", "HEAD~1", "HEAD"] });
+    const changedFiles = parseGitDiffNameStatus(diffResult.stdout);
+    if (changedFiles.length === 0) {
+      logger.info(`ℹ️  No files were changed. Skipping review.
 `);
-    let feedback;
-    let highLevelPlan2;
-    let branchName2;
-    try {
-      while (true) {
-        const result = await step2("plan", () => createPlan2({ task: task2, feedback }, context2));
-        if (result.question) {
-          const answer = await tools3.input({
-            message: result.question.question,
-            default: result.question.defaultAnswer || undefined
-          });
-          feedback = `The user answered the question "${result.question.question}" with: "${answer}"`;
-          continue;
-        }
-        if (!result.plan) {
-          if (result.reason) {
-            logger2.info(`No plan created. Reason: ${result.reason}`);
-          } else {
-            logger2.info("No plan created.");
-          }
-          return null;
-        }
-        logger2.info(`\uD83D\uDCDD Plan:
-${result.plan}`);
-        if (result.branchName) {
-          logger2.info(`\uD83C\uDF3F Suggested branch name: ${result.branchName}`);
-        }
-        feedback = await tools3.input({ message: "Press Enter to approve the plan, or provide feedback to refine it." });
-        if (feedback.trim() === "") {
-          highLevelPlan2 = result.plan;
-          branchName2 = result.branchName;
-          break;
-        }
-      }
-    } catch (e) {
-      if (e instanceof UserCancelledError) {
-        logger2.info("Plan creation cancelled by user.");
-        return null;
-      }
-      throw e;
-    }
-    if (!highLevelPlan2) {
-      logger2.info("Plan not approved. Exiting.");
-      return null;
+      return { passed: true };
     }
-    if (!branchName2) {
-      logger2.error("❌ Error: No branch name was generated from the plan. Exiting.");
-      return null;
+    logger.info(`
+\uD83D\uDD0E Review iteration ${i + 1}/${MAX_REVIEW_RETRIES}`);
+    logger.info(`   Changed files: ${changedFiles.length}`);
+    const changeInfo = {
+      commitRange: "HEAD~1...HEAD",
+      changedFiles
+    };
+    const reviewAgentResult = await step(`review-${iterationCount}-${i}`, async () => {
+      const defaultContext = await getDefaultContext();
+      const memoryContext = await tools2.getMemoryContext();
+      const userMessage = `${defaultContext}
+${memoryContext}
+
+${formatReviewToolInput(changeInfo)}`;
+      return await agentWorkflow({
+        systemPrompt: CODE_REVIEW_SYSTEM_PROMPT,
+        userMessage: [{ role: "user", content: userMessage }],
+        tools: [readFile_default, readBinaryFile_default, searchFiles_default, listFiles_default, gitDiff_default, readMemory_default, updateMemory_default, listMemoryTopics_default],
+        outputSchema: reviewOutputSchema
+      }, context);
+    });
+    if (reviewAgentResult.type !== "Exit" /* Exit */) {
+      logger.error(`\uD83D\uDEAB Review agent failed with status: ${reviewAgentResult.type}.`);
+      break;
     }
-    logger2.info(`✅ High-level plan approved.
-`);
-    return { plan: highLevelPlan2, branchName: branchName2 };
-  }
-  const planResult = await createAndApprovePlan(task, context);
-  if (!planResult) {
-    return;
-  }
-  const highLevelPlan = planResult.plan;
-  let branchName = planResult.branchName;
-  async function createFeatureBranch(branchName2, task2, plan, context2) {
-    const { logger: logger2, step: step2, tools: tools3 } = context2;
-    logger2.info(`\uD83C\uDF3F Phase 3: Creating feature branch...
+    const reviewResult = reviewAgentResult.object;
+    if (!reviewResult || !reviewResult.specificReviews || reviewResult.specificReviews.length === 0) {
+      logger.info(`✅ Review passed. No issues found.
 `);
-    const branchValidation = validateBranchName(branchName2);
-    if (!branchValidation.valid) {
-      logger2.error(`❌ Error: ${branchValidation.error}`);
-      return { success: false, branchName: null };
-    }
-    let finalBranchName = branchName2;
-    const initialCheckResult = await step2("checkBranch-initial", async () => tools3.executeCommand({ command: "git", args: ["rev-parse", "--verify", finalBranchName] }));
-    if (initialCheckResult.exitCode === 0) {
-      logger2.warn(`⚠️  Branch '${finalBranchName}' already exists. Trying to find an available name...`);
-      const suffixMatch = branchName2.match(/-(\d+)$/);
-      let baseName = branchName2;
-      let counter = 2;
-      if (suffixMatch) {
-        baseName = branchName2.substring(0, suffixMatch.index);
-        counter = parseInt(suffixMatch[1], 10) + 1;
-      }
-      while (true) {
-        finalBranchName = `${baseName}-${counter}`;
-        const branchCheckResult = await step2(`checkBranch-${counter}`, async () => tools3.executeCommand({ command: "git", args: ["rev-parse", "--verify", finalBranchName] }));
-        if (branchCheckResult.exitCode !== 0) {
-          break;
-        }
-        counter++;
-      }
+      return { passed: true };
     }
-    if (finalBranchName !== branchName2) {
-      logger2.info(`Branch name '${branchName2}' was taken. Using '${finalBranchName}' instead.`);
+    logger.warn(`⚠️  Review found ${reviewResult.specificReviews.length} issue(s). Attempting to fix...
+`);
+    for (const [idx, review] of reviewResult.specificReviews.entries()) {
+      logger.warn(`   ${idx + 1}. ${review.file}:${review.lines}`);
     }
-    await step2("createBranch", async () => await tools3.executeCommand({ command: "git", args: ["checkout", "-b", finalBranchName] }));
-    logger2.info(`✅ Branch '${finalBranchName}' created.
+    logger.warn("");
+    const reviewSummary = reviewResult.specificReviews.map((r) => `File: ${r.file} (lines: ${r.lines})
+Review: ${r.review}`).join(`
+
 `);
-    await tools3.appendMemory({
-      topic: "epic-context",
-      content: `Epic: ${task2}
-Branch: ${finalBranchName}
-Started: ${new Date().toISOString()}`
+    const fixTask = `You are working on an epic. The original task was: "${taskItem}".
+
+Here is the full plan for context:
+<plan>
+${highLevelPlan}
+</plan>
+
+After an initial implementation, a review found the following issues. Please fix them:
+
+${reviewSummary}`;
+    await step(`fix-${iterationCount}-${i}`, async () => {
+      await codeWorkflow({ task: fixTask, mode: "noninteractive" }, context);
     });
-    await tools3.appendMemory({ topic: "epic-plan", content: plan });
-    return { success: true, branchName: finalBranchName };
-  }
-  const branchResult = await createFeatureBranch(branchName, task, highLevelPlan, context);
-  if (!branchResult.success || !branchResult.branchName) {
-    return;
+    await step(`commit-fix-${iterationCount}-${i}`, async () => {
+      await tools2.executeCommand({ command: "git", args: ["add", "."] });
+      await tools2.executeCommand({ command: "git", args: ["commit", "--amend", "--no-edit"] });
+    });
+    if (i === MAX_REVIEW_RETRIES - 1) {
+      logger.error(`
+\uD83D\uDEAB Max retries (${MAX_REVIEW_RETRIES}) reached. Moving to the next task, but issues might remain.
+`);
+      return { passed: false };
+    }
   }
-  branchName = branchResult.branchName;
-  logger.info(`\uD83D\uDE80 Phase 4: Iterative Implementation Loop...
+  return { passed: false };
+}
+async function runImplementationLoop(context, highLevelPlan) {
+  const { logger, step, tools: tools2 } = context;
+  const commitMessages = [];
+  logger.info(`\uD83D\uDE80 Phase 5: Iterative Implementation Loop...
 `);
   logger.info(`${"=".repeat(80)}
 `);
-  let currentPlan = highLevelPlan;
   let iterationCount = 0;
   let isComplete = false;
   let nextTask = null;
-  try {
-    const firstTaskResult = await step("extract-first-task", async () => {
-      return await updatePlanAgent(currentPlan, "", "", context);
-    });
-    currentPlan = firstTaskResult.updatedPlan;
-    nextTask = firstTaskResult.nextTask;
-    isComplete = firstTaskResult.isComplete;
-    while (!isComplete && nextTask) {
-      iterationCount++;
-      const taskStartTime = Date.now();
-      logger.info(`
+  let nextTaskId = null;
+  const initialTasks = await step("get-initial-tasks", async () => {
+    return await tools2.listTodoItems({ status: "open" });
+  });
+  if (initialTasks.length > 0) {
+    const firstTask = initialTasks[0];
+    nextTask = firstTask.title;
+    nextTaskId = firstTask.id;
+  } else {
+    isComplete = true;
+  }
+  while (!isComplete && nextTask && nextTaskId) {
+    iterationCount++;
+    const taskStartTime = Date.now();
+    logger.info(`
 ${"━".repeat(80)}`);
-      logger.info(`\uD83D\uDCCC Iteration ${iterationCount}`);
-      logger.info(`${"━".repeat(80)}`);
-      logger.info(`${nextTask}
+    logger.info(`\uD83D\uDCCC Iteration ${iterationCount}`);
+    logger.info(`${"━".repeat(80)}`);
+    logger.info(`${nextTask}
 `);
-      let implementationSummary = "";
-      const codeResult = await step(`task-${iterationCount}`, async () => {
-        const taskWithContext = `You are working on an epic. Here is the full plan:
+    await step(`task-${iterationCount}`, async () => {
+      const taskWithContext = `You are working on an epic. Here is the full plan:
 
 <plan>
-${currentPlan}
+${highLevelPlan}
 </plan>
 
 Your current task is to implement this specific item:
 ${nextTask}
 
 Focus only on this item, but use the plan for context.`;
-        return await codeWorkflow({ task: taskWithContext, mode: "noninteractive" }, context);
-      });
-      if (codeResult && "summaries" in codeResult && codeResult.summaries.length > 0) {
-        implementationSummary = codeResult.summaries.join(`
-`);
-      } else {
-        implementationSummary = nextTask;
-      }
-      const commitMessage = `feat: ${nextTask}`;
-      await step(`commit-initial-${iterationCount}`, async () => {
-        await tools2.executeCommand({ command: "git", args: ["add", "."] });
-        await tools2.executeCommand({ command: "git", args: ["commit", "-m", commitMessage] });
-      });
-      commitMessages.push(commitMessage);
-      const { passed: reviewPassed } = await performReviewAndFixCycle(iterationCount, nextTask, currentPlan, context);
-      const taskElapsed = Date.now() - taskStartTime;
-      const taskElapsedTime = formatElapsedTime(taskElapsed);
-      if (reviewPassed) {
-        logger.info(`✅ Iteration ${iterationCount} completed successfully (${taskElapsedTime})`);
-      } else {
-        logger.warn(`⚠️  Iteration ${iterationCount} completed with potential issues (${taskElapsedTime})`);
-      }
-      const updateResult = await step(`update-plan-${iterationCount}`, async () => {
-        return await updatePlanAgent(currentPlan, implementationSummary, nextTask ?? "", context);
-      });
-      currentPlan = updateResult.updatedPlan;
-      isComplete = updateResult.isComplete;
-      nextTask = updateResult.nextTask;
-      await tools2.replaceMemory({ topic: "epic-plan", content: currentPlan });
-      const checkboxCompleted = (currentPlan.match(/- \[x\]/g) || []).length;
-      const checkboxTotal = (currentPlan.match(/- \[[x ]\]/g) || []).length;
-      const checkmarkCompleted = (currentPlan.match(/^✅/gm) || []).length;
-      let progressMessage = "";
-      if (checkboxTotal > 0) {
-        progressMessage = `${checkboxCompleted}/${checkboxTotal} items completed`;
-      } else if (checkmarkCompleted > 0) {
-        progressMessage = `${checkmarkCompleted} items completed`;
-      } else {
-        progressMessage = `Iteration ${iterationCount} completed`;
+      return await codeWorkflow({ task: taskWithContext, mode: "noninteractive" }, context);
+    });
+    const commitMessage = `feat: ${nextTask}`;
+    await step(`commit-initial-${iterationCount}`, async () => {
+      await tools2.executeCommand({ command: "git", args: ["add", "."] });
+      await tools2.executeCommand({ command: "git", args: ["commit", "-m", commitMessage] });
+    });
+    commitMessages.push(commitMessage);
+    const { passed: reviewPassed } = await performReviewAndFixCycle(iterationCount, nextTask, highLevelPlan, context);
+    const taskElapsed = Date.now() - taskStartTime;
+    const taskElapsedTime = formatElapsedTime(taskElapsed);
+    if (reviewPassed) {
+      logger.info(`✅ Iteration ${iterationCount} completed successfully (${taskElapsedTime})`);
+    } else {
+      logger.warn(`⚠️  Iteration ${iterationCount} completed with potential issues (${taskElapsedTime})`);
+    }
+    await step(`update-task-status-${iterationCount}`, async () => {
+      if (!nextTaskId) {
+        throw new Error("Invariant violation: nextTaskId is null inside the implementation loop.");
       }
-      logger.info(`
+      await tools2.updateTodoItem({ operation: "update", id: nextTaskId, status: "completed" });
+    });
+    const openTasks = await step(`get-next-task-${iterationCount}`, async () => {
+      return await tools2.listTodoItems({ status: "open" });
+    });
+    if (openTasks.length > 0) {
+      const nextTodo = openTasks[0];
+      nextTask = nextTodo.title;
+      nextTaskId = nextTodo.id;
+      isComplete = false;
+    } else {
+      nextTask = null;
+      nextTaskId = null;
+      isComplete = true;
+    }
+    const allTodos = await tools2.listTodoItems({});
+    const completedTodos = allTodos.filter((t) => t.status === "completed").length;
+    const totalTodos = allTodos.length;
+    let progressMessage = "";
+    if (totalTodos > 0) {
+      progressMessage = `${completedTodos}/${totalTodos} items completed`;
+    } else {
+      progressMessage = `Iteration ${iterationCount} completed`;
+    }
+    logger.info(`
 \uD83D\uDCCA Progress: ${progressMessage}`);
-      if (isComplete) {
-        logger.info(`✅ All tasks complete!
+    if (isComplete) {
+      logger.info(`✅ All tasks complete!
 `);
-        break;
-      }
-      if (nextTask) {
-        logger.info(`\uD83D\uDCCC Next task: ${nextTask}
+      break;
+    }
+    if (nextTask) {
+      logger.info(`\uD83D\uDCCC Next task: ${nextTask}
 `);
-      }
-      logger.info(`${"━".repeat(80)}
+    }
+    logger.info(`${"━".repeat(80)}
+`);
+  }
+  return commitMessages;
+}
+async function performFinalReviewAndFix(context, highLevelPlan) {
+  const { logger, step, tools: tools2 } = context;
+  logger.info(`
+Phase 6: Final Review and Fixup...
+`);
+  const ghCheckResult = await tools2.executeCommand({ command: "gh", args: ["--version"] });
+  if (ghCheckResult.exitCode !== 0) {
+    logger.warn("⚠️  GitHub CLI (gh) is not installed. Skipping final review step. Please install it from https://cli.github.com/ to enable final reviews.");
+    return { passed: true };
+  }
+  const defaultBranchResult = await tools2.executeCommand({
+    command: "gh",
+    args: ["repo", "view", "--json", "defaultBranchRef", "--jq", ".defaultBranchRef.name"]
+  });
+  const defaultBranch = defaultBranchResult.stdout.trim();
+  const currentBranchResult = await tools2.executeCommand({ command: "git", args: ["rev-parse", "--abbrev-ref", "HEAD"] });
+  const currentBranch = currentBranchResult.stdout.trim();
+  if (currentBranch === defaultBranch) {
+    logger.info(`✅ You are on the default branch ('${defaultBranch}'). No final review needed.`);
+    return { passed: true };
+  }
+  const commitRange = `${defaultBranch}...${currentBranch}`;
+  for (let i = 0;i < MAX_REVIEW_RETRIES; i++) {
+    const diffResult = await tools2.executeCommand({ command: "git", args: ["diff", "--name-status", commitRange] });
+    const changedFiles = parseGitDiffNameStatus(diffResult.stdout);
+    if (changedFiles.length === 0) {
+      logger.info(`ℹ️  No files have been changed in this branch. Skipping final review.
+`);
+      return { passed: true };
+    }
+    logger.info(`
+\uD83D\uDD0E Final review iteration ${i + 1}/${MAX_REVIEW_RETRIES}`);
+    logger.info(`   Changed files: ${changedFiles.length}`);
+    const changeInfo = {
+      commitRange,
+      changedFiles
+    };
+    const reviewAgentResult = await step(`final-review-${i}`, async () => {
+      const defaultContext = await getDefaultContext();
+      const memoryContext = await tools2.getMemoryContext();
+      const userMessage = `${defaultContext}
+${memoryContext}
+
+${formatReviewToolInput(changeInfo)}`;
+      return await agentWorkflow({
+        systemPrompt: CODE_REVIEW_SYSTEM_PROMPT,
+        userMessage: [{ role: "user", content: userMessage }],
+        tools: [readFile_default, readBinaryFile_default, searchFiles_default, listFiles_default, gitDiff_default, readMemory_default, updateMemory_default, listMemoryTopics_default],
+        outputSchema: reviewOutputSchema
+      }, context);
+    });
+    if (reviewAgentResult.type !== "Exit" /* Exit */) {
+      logger.error(`\uD83D\uDEAB Review agent failed with status: ${reviewAgentResult.type}.`);
+      break;
+    }
+    const reviewResult = reviewAgentResult.object;
+    if (!reviewResult || !reviewResult.specificReviews || reviewResult.specificReviews.length === 0) {
+      logger.info(`✅ Final review passed. No issues found.
+`);
+      return { passed: true };
+    }
+    logger.warn(`⚠️  Final review found ${reviewResult.specificReviews.length} issue(s). Attempting to fix...
+`);
+    for (const [idx, review] of reviewResult.specificReviews.entries()) {
+      logger.warn(`   ${idx + 1}. ${review.file}:${review.lines}`);
+    }
+    logger.warn("");
+    const reviewSummary = reviewResult.specificReviews.map((r) => `File: ${r.file} (lines: ${r.lines})
+Review: ${r.review}`).join(`
+
+`);
+    const fixTask = `You are working on an epic. The original task was to implement a feature based on this plan:
+
+<plan>
+${highLevelPlan}
+</plan>
+
+A final review of all the changes in the branch found the following issues. Please fix them:
+
+${reviewSummary}`;
+    await step(`final-fix-${i}`, async () => {
+      await codeWorkflow({ task: fixTask, mode: "noninteractive" }, context);
+    });
+    await step(`commit-final-fix-${i}`, async () => {
+      await tools2.executeCommand({ command: "git", args: ["add", "."] });
+      await tools2.executeCommand({ command: "git", args: ["commit", "-m", "chore: apply automated review feedback"] });
+    });
+    if (i === MAX_REVIEW_RETRIES - 1) {
+      logger.error(`
+\uD83D\uDEAB Max retries (${MAX_REVIEW_RETRIES}) reached for final review. Issues might remain.
 `);
+      return { passed: false };
+    }
+  }
+  return { passed: false };
+}
+var epicWorkflow = async (input2, context) => {
+  const { logger } = context;
+  const { task } = input2;
+  const workflowStartTime = Date.now();
+  let branchName = "";
+  if (!task || task.trim() === "") {
+    logger.error("❌ Error: Task cannot be empty. Please provide a valid task description.");
+    return;
+  }
+  try {
+    const preflightResult = await runPreflightChecks(context);
+    if (!preflightResult.success) {
+      return;
+    }
+    const planResult = await createAndApprovePlan(task, context);
+    if (!planResult) {
+      return;
+    }
+    const { plan: highLevelPlan } = planResult;
+    branchName = planResult.branchName;
+    const branchResult = await createFeatureBranch(branchName, context);
+    if (!branchResult.success || !branchResult.branchName) {
+      return;
+    }
+    branchName = branchResult.branchName;
+    await addTodoItemsFromPlan(highLevelPlan, context);
+    const commitMessages = await runImplementationLoop(context, highLevelPlan);
+    await performFinalReviewAndFix(context, highLevelPlan);
+    const totalElapsed = Date.now() - workflowStartTime;
+    const totalElapsedTime = formatElapsedTime(totalElapsed);
+    const iterationCount = commitMessages.length;
+    logger.info(`
+${"=".repeat(80)}`);
+    logger.info("\uD83C\uDF89 Epic Workflow Complete!");
+    logger.info(`${"=".repeat(80)}`);
+    logger.info(`
+\uD83D\uDCCA Summary:`);
+    logger.info(`   Total iterations: ${iterationCount}`);
+    logger.info(`   Total commits: ${commitMessages.length}`);
+    logger.info(`   Branch: ${branchName}`);
+    logger.info(`   Total time: ${totalElapsedTime}`);
+    logger.info("\uD83D\uDCDD Commits created:");
+    for (const [idx, msg] of commitMessages.entries()) {
+      logger.info(`   ${idx + 1}. ${msg}`);
     }
   } catch (error46) {
     logger.error(`
 ❌ Epic workflow failed: ${error46 instanceof Error ? error46.message : String(error46)}`);
-    logger.info(`
+    if (branchName) {
+      logger.info(`
 Branch '${branchName}' was created but work is incomplete.`);
-    logger.info(`To cleanup: git checkout <previous-branch> && git branch -D ${branchName}
+      logger.info(`To cleanup: git checkout <previous-branch> && git branch -D ${branchName}
 `);
-    await tools2.removeMemory({ topic: "epic-context" });
-    await tools2.removeMemory({ topic: "epic-plan" });
+    }
     throw error46;
   }
-  const totalElapsed = Date.now() - workflowStartTime;
-  const totalElapsedTime = formatElapsedTime(totalElapsed);
-  const avgTimePerIteration = iterationCount > 0 ? formatElapsedTime(totalElapsed / iterationCount) : "N/A";
-  logger.info(`
-${"=".repeat(80)}`);
-  logger.info("\uD83C\uDF89 Epic Workflow Complete!");
-  logger.info(`${"=".repeat(80)}`);
-  logger.info(`
-\uD83D\uDCCA Summary:`);
-  logger.info(`   Total iterations: ${iterationCount}`);
-  logger.info(`   Total commits: ${commitMessages.length}`);
-  logger.info(`   Branch: ${branchName}`);
-  logger.info(`   Total time: ${totalElapsedTime}`);
-  logger.info(`   Average per iteration: ${avgTimePerIteration}
-`);
-  logger.info("\uD83D\uDCDD Commits created:");
-  commitMessages.forEach((msg, idx) => {
-    logger.info(`   ${idx + 1}. ${msg}`);
-  });
-  logger.info(`
-\uD83D\uDCA1 Next steps:`);
-  logger.info(`   • Review your changes: git log`);
-  logger.info(`   • Push to remote: git push origin ${branchName}`);
-  logger.info(`   • Create a pull request on your Git platform
-`);
-  logger.info(`${"=".repeat(80)}
-`);
-  await tools2.removeMemory({ topic: "epic-context" });
-  await tools2.removeMemory({ topic: "epic-plan" });
 };
 
 // src/workflows/task.workflow.ts