@polka-codes/cli 0.9.48 → 0.9.50

package/dist/index.js

@@ -35579,7 +35579,7 @@ var {
   Help
 } = import__.default;
 // package.json
-var version = "0.9.48";
+var version = "0.9.50";
 
 // src/commands/code.ts
 import { readFile as readFile3 } from "node:fs/promises";
@@ -48478,8 +48478,40 @@ var fetchUrl_default = {
   ...toolInfo3,
   handler: handler3
 };
-// ../core/src/tools/listFiles.ts
+// ../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
+};
+// ../core/src/tools/listFiles.ts
+var toolInfo5 = {
   name: "listFiles",
   description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.",
   parameters: exports_external.object({
@@ -48517,7 +48549,7 @@ var toolInfo4 = {
     ]
   })
 };
-var handler4 = async (provider, args) => {
+var handler5 = async (provider, args) => {
   if (!provider.listFiles) {
     return {
       type: "Error" /* Error */,
@@ -48527,7 +48559,7 @@ var handler4 = async (provider, args) => {
       }
     };
   }
-  const { path, maxCount, recursive, includeIgnored } = toolInfo4.parameters.parse(args);
+  const { path, maxCount, recursive, includeIgnored } = toolInfo5.parameters.parse(args);
   const [files, limitReached] = await provider.listFiles(path, recursive, maxCount, includeIgnored);
   return {
     type: "Reply" /* Reply */,
@@ -48543,16 +48575,16 @@ ${files.join(`
   };
 };
 var listFiles_default = {
-  ...toolInfo4,
-  handler: handler4
+  ...toolInfo5,
+  handler: handler5
 };
 // ../core/src/tools/listMemoryTopics.ts
-var toolInfo5 = {
+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 handler5 = async (provider, _args) => {
+var handler6 = async (provider, _args) => {
   const topics = await provider.listMemoryTopics();
   if (!topics.length) {
     return { type: "Reply" /* Reply */, message: { type: "text", value: "No topics found." } };
@@ -48568,18 +48600,89 @@ ${topics.join(`
   };
 };
 var listMemoryTopics_default = {
-  ...toolInfo5,
-  handler: handler5
+  ...toolInfo6,
+  handler: handler6
+};
+// ../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(),
+  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(),
+  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 toolInfo6 = {
+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 handler6 = async (provider, args) => {
+var handler8 = async (provider, args) => {
   if (!provider.readBinaryFile) {
     return {
       type: "Error" /* Error */,
@@ -48589,7 +48692,7 @@ var handler6 = async (provider, args) => {
       }
     };
   }
-  const { url: url2 } = toolInfo6.parameters.parse(args);
+  const { url: url2 } = toolInfo8.parameters.parse(args);
   try {
     const filePart = await provider.readBinaryFile(url2);
     return {
@@ -48618,11 +48721,11 @@ var handler6 = async (provider, args) => {
   }
 };
 var readBinaryFile_default = {
-  ...toolInfo6,
-  handler: handler6
+  ...toolInfo8,
+  handler: handler8
 };
 // ../core/src/tools/readFile.ts
-var toolInfo7 = {
+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({
@@ -48659,7 +48762,7 @@ var toolInfo7 = {
     ]
   })
 };
-var handler7 = async (provider, args) => {
+var handler9 = async (provider, args) => {
   if (!provider.readFile) {
     return {
       type: "Error" /* Error */,
@@ -48669,7 +48772,7 @@ var handler7 = async (provider, args) => {
       }
     };
   }
-  const { path: paths, includeIgnored } = toolInfo7.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);
@@ -48694,19 +48797,19 @@ var handler7 = async (provider, args) => {
   };
 };
 var readFile_default = {
-  ...toolInfo7,
-  handler: handler7
+  ...toolInfo9,
+  handler: handler9
 };
 // ../core/src/tools/readMemory.ts
-var toolInfo8 = {
+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 handler8 = async (provider, args) => {
-  const { topic } = toolInfo8.parameters.parse(args);
+var handler10 = async (provider, args) => {
+  const { topic } = toolInfo10.parameters.parse(args);
   const content = await provider.readMemory(topic);
   if (content) {
     return {
@@ -48728,11 +48831,11 @@ ${content}
   };
 };
 var readMemory_default = {
-  ...toolInfo8,
-  handler: handler8
+  ...toolInfo10,
+  handler: handler10
 };
 // ../core/src/tools/removeFile.ts
-var toolInfo9 = {
+var toolInfo11 = {
   name: "removeFile",
   description: "Request to remove a file at the specified path.",
   parameters: exports_external.object({
@@ -48748,7 +48851,7 @@ var toolInfo9 = {
     ]
   })
 };
-var handler9 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.removeFile) {
     return {
       type: "Error" /* Error */,
@@ -48758,7 +48861,7 @@ var handler9 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo9.parameters.safeParse(args);
+  const parsed = toolInfo11.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -48779,11 +48882,11 @@ var handler9 = async (provider, args) => {
   };
 };
 var removeFile_default = {
-  ...toolInfo9,
-  handler: handler9
+  ...toolInfo11,
+  handler: handler11
 };
 // ../core/src/tools/renameFile.ts
-var toolInfo10 = {
+var toolInfo12 = {
   name: "renameFile",
   description: "Request to rename a file from source path to target path.",
   parameters: exports_external.object({
@@ -48801,7 +48904,7 @@ var toolInfo10 = {
     ]
   })
 };
-var handler10 = async (provider, args) => {
+var handler12 = async (provider, args) => {
   if (!provider.renameFile) {
     return {
       type: "Error" /* Error */,
@@ -48811,7 +48914,7 @@ var handler10 = async (provider, args) => {
       }
     };
   }
-  const { source_path, target_path } = toolInfo10.parameters.parse(args);
+  const { source_path, target_path } = toolInfo12.parameters.parse(args);
   await provider.renameFile(source_path, target_path);
   return {
     type: "Reply" /* Reply */,
@@ -48822,12 +48925,12 @@ var handler10 = async (provider, args) => {
   };
 };
 var renameFile_default = {
-  ...toolInfo10,
-  handler: handler10
+  ...toolInfo12,
+  handler: handler12
 };
 // ../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] });
@@ -48900,7 +49003,7 @@ var replaceInFile = (fileContent, diff) => {
 };
 
 // ../core/src/tools/replaceInFile.ts
-var toolInfo11 = {
+var toolInfo13 = {
   name: "replaceInFile",
   description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.",
   parameters: exports_external.object({
@@ -49010,7 +49113,7 @@ function oldFeature() {
     ]
   })
 };
-var handler11 = async (provider, args) => {
+var handler13 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -49020,7 +49123,7 @@ var handler11 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo11.parameters.safeParse(args);
+  const parsed = toolInfo13.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49084,11 +49187,11 @@ var handler11 = async (provider, args) => {
   }
 };
 var replaceInFile_default = {
-  ...toolInfo11,
-  handler: handler11
+  ...toolInfo13,
+  handler: handler13
 };
 // ../core/src/tools/searchFiles.ts
-var toolInfo12 = {
+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({
@@ -49112,7 +49215,7 @@ var toolInfo12 = {
     ]
   })
 };
-var handler12 = async (provider, args) => {
+var handler14 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
       type: "Error" /* Error */,
@@ -49122,7 +49225,7 @@ var handler12 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo12.parameters.safeParse(args);
+  const parsed = toolInfo14.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49160,13 +49263,13 @@ ${files.join(`
   }
 };
 var searchFiles_default = {
-  ...toolInfo12,
-  handler: handler12
+  ...toolInfo14,
+  handler: handler14
 };
 // ../core/src/tools/updateMemory.ts
-var toolInfo13 = {
+var toolInfo15 = {
   name: "updateMemory",
-  description: "Appends, replaces, or removes content from a memory topic.",
+  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:".'),
@@ -49191,7 +49294,7 @@ var toolInfo13 = {
     }
   })
 };
-var handler13 = async (provider, args) => {
+var handler15 = async (provider, args) => {
   if (!provider.updateMemory) {
     return {
       type: "Error" /* Error */,
@@ -49201,7 +49304,7 @@ var handler13 = async (provider, args) => {
       }
     };
   }
-  const params = toolInfo13.parameters.parse(args);
+  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":
@@ -49231,11 +49334,41 @@ var handler13 = async (provider, args) => {
   }
 };
 var updateMemory_default = {
-  ...toolInfo13,
-  handler: handler13
+  ...toolInfo15,
+  handler: handler15
+};
+// ../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 toolInfo14 = {
+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 +49397,7 @@ export default App;
     ]
   })
 };
-var handler14 = async (provider, args) => {
+var handler17 = async (provider, args) => {
   if (!provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -49274,7 +49407,7 @@ var handler14 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo14.parameters.safeParse(args);
+  const parsed = toolInfo17.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49298,8 +49431,8 @@ var handler14 = async (provider, args) => {
   };
 };
 var writeToFile_default = {
-  ...toolInfo14,
-  handler: handler14
+  ...toolInfo17,
+  handler: handler17
 };
 // ../core/src/UsageMeter.ts
 class UsageMeter {
@@ -51340,15 +51473,15 @@ function useKeypress(userHandler) {
   signal.current = userHandler;
   useEffect((rl) => {
     let ignore = false;
-    const handler15 = withUpdates((_input, event) => {
+    const handler18 = withUpdates((_input, event) => {
       if (ignore)
         return;
       signal.current(event, rl);
     });
-    rl.input.on("keypress", handler15);
+    rl.input.on("keypress", handler18);
     return () => {
       ignore = true;
-      rl.input.removeListener("keypress", handler15);
+      rl.input.removeListener("keypress", handler18);
     };
   }, []);
 }
@@ -51507,16 +51640,16 @@ class Emitter {
 
 class SignalExitBase {
 }
-var signalExitWrap = (handler15) => {
+var signalExitWrap = (handler18) => {
   return {
     onExit(cb, opts) {
-      return handler15.onExit(cb, opts);
+      return handler18.onExit(cb, opts);
     },
     load() {
-      return handler15.load();
+      return handler18.load();
     },
     unload() {
-      return handler15.unload();
+      return handler18.unload();
     }
   };
 };
@@ -52337,36 +52470,147 @@ async function searchFiles(path, regex, filePattern, cwd, excludeFiles) {
 }
 
 // ../cli-shared/src/provider.ts
+class InMemoryStore {
+  #data;
+  async read() {
+    return this.#data;
+  }
+  async write(data) {
+    this.#data = data;
+  }
+}
 var getProvider = (options = {}) => {
   const ig = import_ignore2.default().add(options.excludeFiles ?? []);
-  const memoryStore = {};
+  const memoryStore = options.memoryStore ?? new InMemoryStore;
+  const todoItemStore = options.todoItemStore ?? new InMemoryStore;
   const defaultMemoryTopic = ":default:";
   const provider2 = {
+    listTodoItems: async (id, status) => {
+      const todoItems = await todoItemStore.read() ?? [];
+      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 todoItems = await todoItemStore.read() ?? [];
+      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) => {
+      const todoItems = await todoItemStore.read() ?? [];
+      if (input.operation === "add") {
+        const { parentId, title, description, status } = 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);
+          const maxId = childItems.reduce((max, item) => {
+            const parts = item.id.split(".");
+            const lastPart = parseInt(parts[parts.length - 1], 10);
+            return Math.max(max, lastPart);
+          }, 0);
+          newId = `${parentId}.${maxId + 1}`;
+        } else {
+          const rootItems = todoItems.filter((i) => !i.id.includes("."));
+          const maxId = rootItems.reduce((max, item) => {
+            const idNum = parseInt(item.id, 10);
+            return Math.max(max, idNum);
+          }, 0);
+          newId = `${maxId + 1}`;
+        }
+        const newItem = {
+          id: newId,
+          title,
+          description: description ?? "",
+          status: status ?? "open"
+        };
+        await todoItemStore.write([...todoItems, 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.status != null) {
+          item.status = input.status;
+        }
+        await todoItemStore.write(todoItems);
+        return { id };
+      }
+    },
     listMemoryTopics: async () => {
-      return Object.keys(memoryStore);
+      const memory = await memoryStore.read() ?? {};
+      return Object.keys(memory);
     },
     readMemory: async (topic = defaultMemoryTopic) => {
-      return memoryStore[topic];
+      const memory = await memoryStore.read() ?? {};
+      return memory[topic];
     },
     updateMemory: async (operation, topic, content) => {
       const memoryTopic = topic ?? defaultMemoryTopic;
+      const memory = await memoryStore.read() ?? {};
       switch (operation) {
         case "append":
           if (content === undefined) {
             throw new Error("Content is required for append operation.");
           }
-          memoryStore[memoryTopic] = (memoryStore[memoryTopic] || "") + content;
+          memory[memoryTopic] = `${memory[memoryTopic] || ""}
+${content}`;
           break;
         case "replace":
           if (content === undefined) {
             throw new Error("Content is required for replace operation.");
           }
-          memoryStore[memoryTopic] = content;
+          memory[memoryTopic] = content;
           break;
         case "remove":
-          delete memoryStore[memoryTopic];
+          delete memory[memoryTopic];
           break;
       }
+      await memoryStore.write(memory);
     },
     readFile: async (path, includeIgnored) => {
       if (!includeIgnored && ig.ignores(path)) {
@@ -64126,16 +64370,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: toolInfo15, 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 toolInfo15) {
+  for (const tool3 of toolInfo18) {
     toolSet[tool3.name] = {
       description: tool3.description,
       inputSchema: jsonSchema(toJSONSchema(tool3.parameters))
@@ -64183,7 +64423,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) {
@@ -64197,7 +64439,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) {
@@ -64266,6 +64510,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
@@ -64835,6 +65080,53 @@ 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 taskToolCallStats = new Map;
 var globalToolCallStats = new Map;
@@ -64859,8 +65151,26 @@ function logToolCallStats(stream, statsMap, title) {
     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) {
-  logToolCallStats(stream, globalToolCallStats, "Global Tool Call Stats");
+  const merged = mergeToolCallStats(globalToolCallStats, taskToolCallStats);
+  logToolCallStats(stream, merged, "Global Tool Call Stats");
 }
 var printEvent = (verbose, usageMeter, stream = process.stdout) => {
   if (verbose < 0) {
@@ -64868,6 +65178,7 @@ var printEvent = (verbose, usageMeter, stream = process.stdout) => {
   }
   const customConsole = new Console(stream, stream);
   let hadReasoning = false;
+  let hasText = false;
   const write = stream.write.bind(stream);
   return (event) => {
     switch (event.kind) {
@@ -64884,6 +65195,7 @@ ${event.systemPrompt}`);
         }
         break;
       case "StartRequest" /* StartRequest */:
+        hasText = false;
         if (verbose > 0) {
           customConsole.log(`
 
@@ -64937,6 +65249,11 @@ ${event.systemPrompt}`);
           customConsole.log(`
 
 ======== Request Ended ========
+`);
+        }
+        if (verbose === 0 && hasText) {
+          write(`
+
 `);
         }
         if (verbose > 1) {
@@ -64950,6 +65267,9 @@ ${event.systemPrompt}`);
 `);
           hadReasoning = false;
         }
+        if (event.newText.trim().length > 0) {
+          hasText = true;
+        }
         write(event.newText);
         break;
       }
@@ -64962,9 +65282,10 @@ ${event.systemPrompt}`);
       }
       case "ToolUse" /* ToolUse */: {
         if (verbose > 0) {
+          const params = verbose > 1 ? event.params : simplifyToolParameters(event.tool, event.params);
           customConsole.log(source_default.yellow(`
 
-Tool use:`, event.tool), event.params);
+Tool use:`, event.tool), params);
         }
         const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.calls++;
@@ -65000,18 +65321,28 @@ 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);
+            if (verbose > 0) {
+              customConsole.log("Exit Message:", event.exitReason.message);
+            }
             break;
         }
+        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) {
-          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);
-          }
           logToolCallStats(stream, taskToolCallStats, "Task Tool Call Stats");
         }
         break;
@@ -77501,7 +77832,7 @@ function annotateDiffWithLineNumbers(diff) {
 }
 
 // src/tools/gitDiff.ts
-var toolInfo15 = {
+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({
@@ -77530,7 +77861,7 @@ var toolInfo15 = {
     }, exports_external.boolean().optional().default(false)).describe("Annotate the diff with line numbers for additions and deletions.")
   })
 };
-var handler15 = async (provider3, args) => {
+var handler18 = async (provider3, args) => {
   if (!provider3.executeCommand) {
     return {
       type: "Error" /* Error */,
@@ -77540,7 +77871,7 @@ var handler15 = async (provider3, args) => {
       }
     };
   }
-  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo15.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");
@@ -77597,8 +77928,8 @@ ${result.stderr}`
   }
 };
 var gitDiff_default = {
-  ...toolInfo15,
-  handler: handler15
+  ...toolInfo18,
+  handler: handler18
 };
 // src/utils/cacheControl.ts
 var CACHEABLE_MODELS = ["sonnet", "opus", "haiku", "gemini"];
@@ -77929,7 +78260,10 @@ var allTools = [
   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) {
@@ -77974,6 +78308,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) {
@@ -77985,6 +78320,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
   });
@@ -77999,6 +78335,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) {
@@ -78188,11 +78525,31 @@ ${defaultContent}
   return contextParts.join(`
 `);
 }
+async function readMemory(input2, context) {
+  const provider3 = context.toolProvider;
+  return await provider3.readMemory(input2.topic) ?? "";
+}
+async function listMemoryTopics(_input, context) {
+  const provider3 = context.toolProvider;
+  return provider3.listMemoryTopics();
+}
 async function updateMemory(input2, context) {
   const provider3 = context.toolProvider;
   const content = "content" in input2 ? input2.content : undefined;
   return provider3.updateMemory(input2.operation, input2.topic, content);
 }
+async function listTodoItems(input2, context) {
+  const provider3 = context.toolProvider;
+  return provider3.listTodoItems(input2.id, input2.status);
+}
+async function getTodoItem(input2, context) {
+  const provider3 = context.toolProvider;
+  return provider3.getTodoItem(input2.id);
+}
+async function updateTodoItem(input2, context) {
+  const provider3 = context.toolProvider;
+  return provider3.updateTodoItem(input2);
+}
 var localToolHandlers = {
   createPullRequest,
   createCommit,
@@ -78207,12 +78564,17 @@ var localToolHandlers = {
   invokeTool,
   taskEvent,
   getMemoryContext,
-  updateMemory
+  readMemory,
+  listMemoryTopics,
+  updateMemory,
+  listTodoItems,
+  getTodoItem,
+  updateTodoItem
 };
 async function toolCall(toolCall2, context) {
-  const handler16 = localToolHandlers[toolCall2.tool];
-  if (handler16) {
-    return handler16(toolCall2.input, context);
+  const handler19 = localToolHandlers[toolCall2.tool];
+  if (handler19) {
+    return handler19(toolCall2.input, context);
   }
   throw new Error(`Unknown tool: ${toolCall2.tool}`);
 }
@@ -78236,7 +78598,7 @@ async function runWorkflow(workflow2, workflowInput, options) {
     maxCost: config4.budget
   });
   const onEvent = printEvent(verbose, usage, process.stderr);
-  const toolProvider = getProvider({ excludeFiles: config4.excludeFiles });
+  const toolProvider = (options.getProvider ?? getProvider)({ excludeFiles: config4.excludeFiles });
   const commandConfig = providerConfig.getConfigForCommand(commandName);
   if (!commandConfig) {
     throw new Error(`No provider configured for command: ${commandName}`);
@@ -78284,11 +78646,15 @@ Workflow completed successfully.`);
     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;
@@ -78305,14 +78671,33 @@ ${JSON.stringify(schema, null, 2)}
 \`\`\`
 `;
 }
+var TOOL_USAGE_INSTRUCTION = `
+## Action Line
+
+Before any tool call, emit a single high-level action line.
+
+You MUST follow these style constraints for the action line:
+- NO filler or preambles.
+- DO NOT use "ok", "okay", "alright".
+- DO NOT use first person ("I", "I'm", "I will", "I'll", etc.).
+- NO apologies, hedging, or promises about later work.
+`;
 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.
@@ -78321,6 +78706,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:
@@ -78506,6 +78893,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:
@@ -78528,15 +78917,21 @@ Effective planning requires understanding before action:
    - File system exploration (\`listFiles\`, \`searchFiles\`) reveals structure and patterns.
    - Reading existing files (\`readFile\`) shows coding style and conventions.
 
-3. **High-Level, Not Granular**
-   - Your plan should focus on the "what" and "why" at a strategic level.
-   - Avoid getting bogged down in implementation minutiae. For example, instead of "add a 20px margin to the button", say "Update the component styling to align with the design system".
-   - The output should be a roadmap, not a turn-by-turn navigation.
+3. **High-Level Strategy with Detailed Tasks**
+   - "High-level" refers to strategic phases and architectural decisions, not individual implementation steps.
+   - While the plan structure should be strategic (phases, components), each task item must contain detailed implementation guidance.
+   - Each task should include specific file paths, function names, implementation patterns, and technical details.
+   - The plan should be detailed enough that task creation does not require additional codebase exploration.
+   - Example of appropriate detail level:
+     * ❌ Too vague: "Add authentication"
+     * ❌ Too granular: "Add a 20px margin to the button on line 45"
+     * ✅ Appropriate: "Implement authentication endpoints in \`src/api/auth.ts\` with \`POST /api/auth/login\` that validates credentials using bcrypt and returns JWT tokens"
 
 4. **Clarity for AI Implementation**
-   - The plan must be clear enough for AI agents to implement directly.
-   - Each task should be a concrete, implementable piece of work.
-   - Focus on what needs to be built and how.
+   - The plan must be clear enough for AI agents to implement directly without further exploration.
+   - Each task should be a concrete, implementable piece of work with all necessary details.
+   - Include specific technical information: file paths, function signatures, dependencies, patterns to follow.
+   - The task creation agent should be able to parse the plan and create todo items without exploring the codebase.
 
 ## Your Approach
 
@@ -78557,33 +78952,61 @@ For epic-scale work, **checkboxes are RECOMMENDED** to help track progress throu
 
 **Recommended Checklist Format**:
 - Use markdown checkboxes (\`- [ ] item\`) for major components and tasks
+- Create nested task breakdowns with 3-4 levels of detail
 - Each checkbox represents a distinct, trackable piece of work
-- Each checkbox item should be specific and implementable independently
-- Group related checkboxes under numbered sections or phases when appropriate
+- Each checkbox item must include detailed implementation guidance
+- Group related checkboxes under numbered sections or phases
 - Items will be implemented one at a time iteratively
 - After each implementation, the completed item will be marked with \`- [x]\` when the plan is updated
 
-**Example checklist format**:
+**Implementation Details Requirements**:
+
+Each task item must specify:
+- **Exact file paths** for new files or modifications (e.g., \`src/api/auth.ts\`)
+- **Function signatures and class names** to implement (e.g., \`async function authenticateUser(email: string, password: string)\`)
+- **Specific patterns from the codebase** to follow (e.g., "Follow the middleware pattern used in \`src/middleware/logger.ts\`")
+- **Required imports and dependencies** (e.g., "Import \`bcrypt\` for password hashing, use \`jsonwebtoken\` for JWT generation")
+- **Error handling approach** (e.g., "Use \`ApiError\` class from \`src/errors.ts\`")
+- **Integration points** with existing code (e.g., "Register middleware in \`src/app.ts\` before route handlers")
+- **Testing requirements** if applicable (e.g., "Add unit tests in \`src/api/__tests__/auth.test.ts\`")
+
+**Example checklist format with proper detail**:
 \`\`\`
 1. Phase 1: Backend API Development
-   - [ ] Design and implement user authentication endpoints
+   - [ ] Design and implement user authentication endpoints in \`src/api/auth.ts\`
+     - [ ] Create \`POST /api/auth/login\` endpoint that accepts email/password in request body, validates using bcrypt, returns JWT token using \`jsonwebtoken\` library with 24h expiration
+     - [ ] Create \`POST /api/auth/register\` endpoint that validates input with zod schema (\`email\`, \`password\` min 8 chars), hashes password with bcrypt (10 rounds), stores in database using Prisma ORM
+     - [ ] Add authentication middleware in \`src/middleware/auth.ts\` that verifies JWT tokens from Authorization header and attaches user object to \`req.user\`
    - [ ] Create database schema and migrations
-   - [ ] Implement data validation middleware
+     - [ ] Define User model in \`prisma/schema.prisma\` with fields: id (UUID), email (unique string), passwordHash (string), createdAt (DateTime), updatedAt (DateTime)
+     - [ ] Generate migration with \`npx prisma migrate dev --name add-user-auth\`
+     - [ ] Update \`src/db/client.ts\` to export Prisma client instance
+   - [ ] Implement data validation middleware in \`src/middleware/validation.ts\`
+     - [ ] Create \`validateRequest\` function that accepts zod schema and returns Express middleware
+     - [ ] Add error handling that returns 400 status with validation errors in response body
+     - [ ] Follow error format used in \`src/middleware/errorHandler.ts\`
 
 2. Phase 2: Frontend Integration
-   - [ ] Build authentication UI components
-   - [ ] Integrate with backend API
+   - [ ] Build authentication UI components in \`src/components/auth/\`
+     - [ ] Create \`LoginForm.tsx\` component with email/password fields using React Hook Form, submit handler calls \`/api/auth/login\`
+     - [ ] Create \`RegisterForm.tsx\` component with email/password/confirmPassword fields, client-side validation matches backend rules
+     - [ ] Add \`AuthContext.tsx\` using React Context API to manage auth state (user object, isAuthenticated boolean, login/logout functions)
+   - [ ] Integrate with backend API using \`src/lib/api.ts\`
+     - [ ] Add \`login(email, password)\` function that calls \`POST /api/auth/login\`, stores JWT in localStorage, returns user object
+     - [ ] Add \`register(email, password)\` function that calls \`POST /api/auth/register\`
+     - [ ] Add \`logout()\` function that removes JWT from localStorage and clears auth state
    - [ ] Add error handling and loading states
+     - [ ] Display API errors in form using \`ErrorMessage\` component from \`src/components/ui/ErrorMessage.tsx\`
+     - [ ] Show loading spinner during API calls using \`LoadingSpinner\` component from \`src/components/ui/LoadingSpinner.tsx\`
+     - [ ] Add toast notifications for success/error using \`react-hot-toast\` library
 \`\`\`
 
-**Alternative Format**:
-You may also use numbered lists if checkboxes don't fit the task structure. However, each item should still be clear, actionable, and implementable independently.
-
 **What to Include**:
-- Actionable implementation steps
-- Technical requirements and specifications
-- Specific files, functions, or components to create/modify
-- Context needed for implementation
+- Actionable implementation steps with complete technical specifications
+- Exact file paths, function names, and implementation patterns
+- All dependencies, imports, and integration points
+- Specific technical constraints and requirements
+- Testing approach if applicable
 
 **What NOT to Include**:
 - Future enhancements or scope outside the current task
@@ -78602,9 +79025,11 @@ Branch names should:
 
 1. Analyze the task and the existing plan (if any).
 2. If the requirements are clear and you can generate or update the plan:
-   a. Provide the plan in the "plan" field using the checklist format described above
-   b. Propose a suitable git branch name in the "branchName" field.
-   c. Include relevant file paths in the "files" array if applicable
+   a. **Explore the codebase first** to understand patterns, conventions, and existing implementations
+   b. Provide the plan in the "plan" field using the checklist format with detailed implementation guidance
+   c. Ensure the plan is detailed enough that task creation does not require additional codebase exploration
+   d. Each task item must include specific file paths, function names, implementation patterns, and technical details
+   e. Propose a suitable git branch name in the "branchName" field
 3. If the requirements are not clear:
    a. Ask a clarifying question in the "question" field
 4. If the task is already implemented or no action is needed:
@@ -78623,9 +79048,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()
@@ -78647,57 +79075,92 @@ ${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: Parse a detailed epic plan and create todo items from the provided task breakdowns.
 
-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 responsible for parsing a detailed epic plan and creating todo items that can be executed autonomously by an AI coding agent.
 
-## Your Task
+## Your Responsibility
 
-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
+Your goal is to create todo items that are:
+- **Specific and actionable**: Each item should be clear enough for an AI agent to implement without human intervention
+- **Well-documented**: Include detailed implementation guidance extracted from the plan
+- **Context-rich**: Specify relevant files that will be modified or created (as provided in the plan)
+- **Self-contained**: Each item should be implementable independently with the context from the plan
 
-## Process
+## Plan Structure Expectations
 
-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
+The plan you receive contains all necessary implementation details. You should NOT need to explore the codebase because:
+- Each task in the plan already includes specific file paths
+- Function and class names are specified in the plan
+- Implementation patterns and approaches are provided
+- Dependencies and imports are listed
+- Technical specifications are included
+- Integration points are documented
 
-## Output Requirements
+Your job is to extract these details from the plan and create todo items, not to research or discover them.
 
-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
+## Todo Item Requirements
 
-## Important Notes
+For each task in the plan, create a todo item using the \`updateTodoItem\` tool with:
 
-- 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
+### 1. **title** (required)
+A concise, action-oriented task name that clearly states what needs to be done.
 
-## Response Format
+**Examples:**
+- ✅ "Implement user authentication with JWT tokens"
+- ✅ "Add validation middleware for API endpoints"
+- ❌ "Authentication" (too vague)
+
+### 2. **description** (required)
+Detailed implementation instructions extracted from the plan. Include:
+
+**Must extract from the plan:**
+- **Specific files to create or modify** with exact paths (as specified in the plan)
+- **Function/class names** to implement or modify (as specified in the plan)
+- **Implementation patterns** to follow (as referenced in the plan)
+- **Technical requirements** and constraints (as documented in the plan)
+- **Dependencies** and imports needed (as listed in the plan)
+- **Integration points** with existing code (as described in the plan)
+
+**Example of extracting from a detailed plan task:**
+
+Plan task:
+\`\`\`
+- [ ] Add authentication middleware in \`src/middleware/auth.ts\` that verifies JWT tokens from Authorization header and attaches user object to \`req.user\`
+\`\`\`
+
+Todo item description:
+\`\`\`
+Create a new authentication middleware in \`src/middleware/auth.ts\`:
+
+1. Implement \`authenticateJWT\` function that:
+   - Extracts JWT token from Authorization header
+   - Verifies token (implementation details from plan)
+   - Attaches user object to \`req.user\`
+   - Returns 401 error for invalid/missing tokens
+
+2. Export the middleware for use in route definitions
+\`\`\`
+
+**Note:** All implementation details should come from the plan. Do not add information not present in the plan.
+
+## Process
+
+1. **Read and parse the plan** provided in the user message to identify individual tasks
+2. **Parse the plan structure** to understand the task hierarchy and details
+3. **For each task in the plan:**
+   a. Extract the specific files mentioned in the task
+   b. Extract implementation patterns specified in the plan
+   c. Create a detailed description using the plan's guidance
+   d. Identify all relevant files from the plan
+   e. Call \`updateTodoItem\` with operation='add', title and description
+
+**Important:** Do NOT explore the codebase. All necessary information is already in the plan.
 
-${createJsonResponseInstruction({
-  updatedPlan: "The full plan with completed item marked",
-  isComplete: false,
-  nextTask: "The text of the next incomplete item (or null if complete)"
-})}
 `;
-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.
 
@@ -78705,6 +79168,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
@@ -78778,6 +79243,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:
@@ -78815,6 +79282,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.
@@ -78929,6 +79398,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.
 
@@ -78941,6 +79412,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.
 
@@ -78953,6 +79426,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.)
@@ -79364,10 +79839,10 @@ var ImplementOutputSchema = exports_external.object({
 });
 var codeWorkflow = async (input2, context) => {
   const { logger, step, tools: tools2 } = context;
-  const { task, files, mode = "interactive" } = input2;
+  const { task, files, mode = "interactive", additionalTools, additionalInstructions } = input2;
   const summaries = [];
   logger.info(`
-\uD83D\uDCCB Phase 1: Creating implementation plan...
+Phase 1: Creating implementation plan...
 `);
   const planResult = await step("plan", async () => {
     return await planWorkflow({ task, files, mode: mode === "interactive" ? "confirm" : "noninteractive" }, context);
@@ -79378,7 +79853,7 @@ var codeWorkflow = async (input2, context) => {
   }
   const { plan, files: planFiles } = planResult;
   logger.info(`
-⚙️  Phase 2: Implementing the plan...
+Phase 2: Implementing the plan...
 `);
   let implementPrompt = getImplementPrompt(plan);
   if (planFiles && planFiles.length > 0) {
@@ -79426,6 +79901,9 @@ ${fileContentString}`;
   if (mode === "interactive") {
     agentTools.push(askFollowupQuestion_default);
   }
+  if (additionalTools) {
+    agentTools.push(...additionalTools);
+  }
   const res = await step("implement", async () => {
     const defaultContext = await getDefaultContext();
     const memoryContext = await tools2.getMemoryContext();
@@ -79442,8 +79920,11 @@ ${memoryContext}`;
 ${memoryContext}`
       });
     }
+    const systemPrompt = additionalInstructions ? `${CODER_SYSTEM_PROMPT}
+
+${additionalInstructions}` : CODER_SYSTEM_PROMPT;
     return await agentWorkflow({
-      systemPrompt: CODER_SYSTEM_PROMPT,
+      systemPrompt,
       userMessage: [{ role: "user", content: userContent }],
       tools: agentTools,
       outputSchema: ImplementOutputSchema
@@ -79453,13 +79934,13 @@ ${memoryContext}`
     const { summary, bailReason } = res.object;
     if (bailReason) {
       logger.error(`
-❌ Implementation failed: ${bailReason}
+Implementation failed: ${bailReason}
 `);
       return { success: false, reason: bailReason, summaries };
     }
     if (summary) {
       logger.info(`
-✅ Implementation complete!
+Implementation complete!
 `);
       summaries.push(summary);
       logger.info(`Summary: ${summary}`);
@@ -79472,20 +79953,20 @@ ${memoryContext}`
       });
     } else {
       logger.info(`
-✅ Implementation complete!
+Implementation complete!
 `);
     }
   } else if (res.type === "Exit" /* Exit */) {
     logger.info(`
-✅ Implementation complete!
+Implementation complete!
 `);
   } else {
     logger.warn(`
-⚠️ Implementation failed. Please check the output for errors.
+Warning: Implementation failed. Please check the output for errors.
 `, res);
   }
   logger.info(`
-\uD83D\uDD27 Phase 3: Checking for errors...
+Phase 3: Checking for errors...
 `);
   const fixResult = await step("fix", async () => {
     return await fixWorkflow({ interactive: false, task: input2.task }, context);
@@ -79895,98 +80376,67 @@ ${provider3.toUpperCase()}_API_KEY=${providerConfig.apiKey}`;
   });
   return { configPath };
 };
-// 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.`
-    };
+// src/workflows/epic-context.ts
+import { promises as fs3 } from "node:fs";
+var EPIC_CONTEXT_FILE = ".epic.yml";
+var EpicContextSchema = exports_external.object({
+  task: exports_external.string().nullish(),
+  plan: exports_external.string().nullish(),
+  branchName: exports_external.string().nullish(),
+  todos: exports_external.array(TodoItemSchema).nullish(),
+  memory: exports_external.record(exports_external.string(), exports_external.string()).nullish()
+});
+var saveEpicContext = async (context) => {
+  const yamlString = $stringify(context);
+  await fs3.writeFile(EPIC_CONTEXT_FILE, yamlString, "utf-8");
+};
+var loadEpicContext = async () => {
+  let fileContent;
+  try {
+    fileContent = await fs3.readFile(EPIC_CONTEXT_FILE, "utf-8");
+  } catch {
+    return {};
   }
-  if (name18.length > 255) {
-    return { valid: false, error: "Branch name is too long (max 255 characters)." };
+  try {
+    const loaded = $parse(fileContent);
+    return EpicContextSchema.parse(loaded);
+  } catch (error46) {
+    console.error("Error parsing epic context file:", EPIC_CONTEXT_FILE, error46);
+    return {};
   }
-  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, 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(`✅ 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:
+class EpicMemoryStore {
+  #context;
+  constructor(context) {
+    this.#context = context;
+  }
+  async read() {
+    return this.#context.memory ?? {};
+  }
+  async write(data) {
+    this.#context.memory = data;
+    await saveEpicContext(this.#context);
+  }
+}
 
-${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 };
-    }
+class EpicTodoItemStore {
+  #context;
+  constructor(context) {
+    this.#context = context;
+  }
+  async read() {
+    return this.#context.todos ?? [];
+  }
+  async write(data) {
+    this.#context.todos = data;
+    await saveEpicContext(this.#context);
   }
-  return { passed: false };
 }
+
+// src/workflows/epic.workflow.ts
+var MAX_REVIEW_RETRIES = 5;
+var TODO_HANDLING_INSTRUCTIONS = `If you discover that a task is larger than you thought, or that a new task is required, you can add a // TODO comment in the code and create a todo item for it. This will allow you to continue with the current task and address the larger issue later.`;
 async function createPlan2(input2, context) {
   const { task, plan, files, feedback } = input2;
   const content = [{ type: "text", text: getPlanPrompt(task, plan) }];
@@ -80036,316 +80486,517 @@ ${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(`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(`Plan:
+${result.plan}`);
+      if (result.branchName) {
+        logger.info(`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(`Phase 3: Creating/switching to feature branch...
+`);
+  const branchExistsResult = await step("checkBranchExists", async () => await tools2.executeCommand({ command: "git", args: ["rev-parse", "--verify", branchName] }));
+  if (branchExistsResult.exitCode === 0) {
+    const currentBranchResult = await step("getCurrentBranch", async () => tools2.executeCommand({ command: "git", args: ["rev-parse", "--abbrev-ref", "HEAD"] }));
+    const currentBranch = currentBranchResult.stdout.trim();
+    if (currentBranch !== branchName) {
+      logger.info(`Branch '${branchName}' already exists. Switching to it...`);
+      const checkoutResult = await step("checkoutBranch", async () => await tools2.executeCommand({ command: "git", args: ["checkout", branchName] }));
+      if (checkoutResult.exitCode !== 0) {
+        logger.error(`Error: Failed to switch to branch '${branchName}'. Git command failed.`);
+        return { success: false, branchName: null };
+      }
+    } else {
+      logger.info(`Already on branch '${branchName}'.`);
+    }
+  } else {
+    logger.info(`Creating new branch '${branchName}'...`);
+    const createBranchResult = await step("createBranch", async () => await tools2.executeCommand({ command: "git", args: ["checkout", "-b", branchName] }));
+    if (createBranchResult.exitCode !== 0) {
+      logger.error(`Error: Failed to create branch '${branchName}'. Git command failed.`);
+      return { success: false, branchName: null };
+    }
+  }
+  logger.info(`Successfully on branch '${branchName}'.
+`);
+  return { success: true, branchName };
 }
-async function runPreflightChecks(context) {
+async function addTodoItemsFromPlan(plan, context) {
   const { logger, step, tools: tools2 } = context;
-  logger.info(`\uD83D\uDCCB Phase 1: Running pre-flight checks...
+  logger.info(`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(epicContext, context) {
+  const { logger, step, tools: tools2 } = context;
+  logger.info(`Phase 1: Running pre-flight checks...
 `);
   const gitCheckResult = await step("gitCheck", async () => tools2.executeCommand({ command: "git", args: ["rev-parse", "--git-dir"] }));
   if (gitCheckResult.exitCode !== 0) {
-    logger.error("❌ Error: Git is not initialized in this directory. Please run `git init` first.");
-    logger.info("\uD83D\uDCA1 Suggestion: Run `git init` to initialize a git repository.\n");
-    return { success: false };
+    logger.error("Error: Git is not initialized in this directory. Please run `git init` first.");
+    logger.info("Suggestion: Run `git init` to initialize a git repository.\n");
+    return false;
+  }
+  if (epicContext.plan) {
+    logger.info("Found an existing `.epic.yml` file.");
+    if (epicContext.branchName) {
+      const currentBranchResult = await step("getCurrentBranch", async () => tools2.executeCommand({ command: "git", args: ["rev-parse", "--abbrev-ref", "HEAD"] }));
+      const currentBranch = currentBranchResult.stdout.trim();
+      if (currentBranch !== epicContext.branchName) {
+        throw new Error(`You are on branch '${currentBranch}' but the epic was started on branch '${epicContext.branchName}'. Please switch to the correct branch to resume.`);
+      }
+    }
+    logger.info("Resuming previous epic session.");
+    return true;
   }
   const gitStatusResult = await step("gitStatus", async () => tools2.executeCommand({ command: "git status --porcelain", shell: true }));
   if (gitStatusResult.stdout.trim() !== "") {
-    logger.error("❌ Error: Your working directory is not clean. Please stash or commit your changes before running the epic workflow.");
-    logger.info("\uD83D\uDCA1 Suggestion: Run `git add .` and `git commit` to clean your working directory, or `git stash` to temporarily save changes.\n");
-    return { success: false };
+    logger.error("Error: Your working directory is not clean. Please stash or commit your changes before running the epic workflow.");
+    logger.info("Suggestion: Run `git add .` and `git commit` to clean your working directory, or `git stash` to temporarily save changes.\n");
+    return false;
   }
-  logger.info(`✅ Pre-flight checks passed.
+  logger.info(`Pre-flight checks passed.
 `);
-  return { success: true };
+  return 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;
-    let planAttempt = 1;
-    try {
-      while (true) {
-        const result = await step2(`plan-${planAttempt}`, () => createPlan2({ task: task2, feedback }, context2));
-        planAttempt++;
-        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(`
+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(`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(`Warning: 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.updateMemory({
-      operation: "append",
-      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",
+        additionalInstructions: TODO_HANDLING_INSTRUCTIONS,
+        additionalTools: [getTodoItem_default, listTodoItems_default, updateTodoItem_default]
+      }, context);
     });
-    await tools3.updateMemory({ operation: "append", 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(`
+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(`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(`
-${"━".repeat(80)}`);
-      logger.info(`\uD83D\uDCCC Iteration ${iterationCount}`);
-      logger.info(`${"━".repeat(80)}`);
-      logger.info(`${nextTask}
+  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(`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.updateMemory({ operation: "replace", 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`;
-      }
-      logger.info(`
-\uD83D\uDCCA Progress: ${progressMessage}`);
-      if (isComplete) {
-        logger.info(`✅ All tasks complete!
-`);
-        break;
+      return await codeWorkflow({
+        task: taskWithContext,
+        mode: "noninteractive",
+        additionalInstructions: TODO_HANDLING_INSTRUCTIONS,
+        additionalTools: [getTodoItem_default, listTodoItems_default, updateTodoItem_default]
+      }, 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(`Warning: 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.");
       }
-      if (nextTask) {
-        logger.info(`\uD83D\uDCCC Next task: ${nextTask}
+      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(`
+Progress: ${progressMessage}`);
+    if (isComplete) {
+      logger.info(`All tasks complete!
 `);
-      }
-      logger.info(`${"━".repeat(80)}
+      break;
+    }
+    if (nextTask) {
+      logger.info(`Next task: ${nextTask}
 `);
     }
-  } catch (error46) {
-    logger.error(`
-❌ Epic workflow failed: ${error46 instanceof Error ? error46.message : String(error46)}`);
-    logger.info(`
-Branch '${branchName}' was created but work is incomplete.`);
-    logger.info(`To cleanup: git checkout <previous-branch> && git branch -D ${branchName}
+    logger.info(`${"-".repeat(80)}
 `);
-    await tools2.updateMemory({ operation: "remove", topic: "epic-context" });
-    await tools2.updateMemory({ operation: "remove", 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)}`);
+  return commitMessages;
+}
+async function performFinalReviewAndFix(context, highLevelPlan) {
+  const { logger, step, tools: tools2 } = context;
   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}
+Phase 6: Final Review and Fixup...
 `);
-  logger.info("\uD83D\uDCDD Commits created:");
-  commitMessages.forEach((msg, idx) => {
-    logger.info(`   ${idx + 1}. ${msg}`);
+  const ghCheckResult = await tools2.executeCommand({ command: "gh", args: ["--version"] });
+  if (ghCheckResult.exitCode !== 0) {
+    logger.warn("Warning: 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"]
   });
-  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
+  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.
 `);
-  logger.info(`${"=".repeat(80)}
+      return { passed: true };
+    }
+    logger.info(`
+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(`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(`Warning: 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(`
+
 `);
-  await tools2.updateMemory({ operation: "remove", topic: "epic-context" });
-  await tools2.updateMemory({ operation: "remove", topic: "epic-plan" });
+    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",
+        additionalInstructions: TODO_HANDLING_INSTRUCTIONS,
+        additionalTools: [getTodoItem_default, listTodoItems_default, updateTodoItem_default]
+      }, 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(`
+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, tools: tools2 } = context;
+  const { task, epicContext = {} } = input2;
+  const workflowStartTime = Date.now();
+  if (!task || task.trim() === "") {
+    logger.error("Error: Task cannot be empty. Please provide a valid task description.");
+    return;
+  }
+  if (!epicContext.task) {
+    epicContext.task = task;
+  }
+  try {
+    const preflightResult = await runPreflightChecks(epicContext, context);
+    if (!preflightResult) {
+      return;
+    }
+    if (!epicContext.plan) {
+      if (!epicContext.task) {
+        logger.error("Error: Task is missing in epic context. Exiting.");
+        return;
+      }
+      const planResult = await createAndApprovePlan(epicContext.task, context);
+      if (!planResult)
+        return;
+      epicContext.plan = planResult.plan;
+      epicContext.branchName = planResult.branchName;
+      await saveEpicContext(epicContext);
+    }
+    if (!epicContext.plan) {
+      logger.error("Error: Plan is missing after planning phase. Exiting.");
+      return;
+    }
+    if (!epicContext.branchName) {
+      logger.error("Error: Branch name is missing after planning phase. Exiting.");
+      return;
+    }
+    const branchResult = await createFeatureBranch(epicContext.branchName, context);
+    if (!branchResult.success || !branchResult.branchName)
+      return;
+    if (epicContext.branchName !== branchResult.branchName) {
+      epicContext.branchName = branchResult.branchName;
+      await saveEpicContext(epicContext);
+    }
+    const todos = await tools2.listTodoItems({});
+    if (todos.length === 0) {
+      await addTodoItemsFromPlan(epicContext.plan, context);
+    }
+    const commitMessages = await runImplementationLoop(context, epicContext.plan);
+    await performFinalReviewAndFix(context, epicContext.plan);
+    await tools2.executeCommand({ command: "git", args: ["rm", "-f", ".epic.yml"] });
+    const statusResult = await tools2.executeCommand({
+      command: "git",
+      args: ["status", "--porcelain", "--", ".epic.yml"]
+    });
+    if (statusResult.stdout.trim() !== "") {
+      await tools2.executeCommand({ command: "git", args: ["commit", "-m", "chore: remove .epic.yml", "--", ".epic.yml"] });
+      logger.info("Cleaned up .epic.yml file.");
+    }
+    const totalElapsed = Date.now() - workflowStartTime;
+    const totalElapsedTime = formatElapsedTime(totalElapsed);
+    logger.info(`
+${"=".repeat(80)}`);
+    logger.info("Epic Workflow Complete!");
+    logger.info(`${"=".repeat(80)}`);
+    logger.info(`
+Summary:`);
+    logger.info(`   Branch: ${epicContext.branchName}`);
+    logger.info(`   Total time: ${totalElapsedTime}`);
+    logger.info(`   Total commits: ${commitMessages.length}`);
+    logger.info("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)}`);
+    if (epicContext?.branchName) {
+      logger.info(`
+Branch '${epicContext.branchName}' was created but work is incomplete.`);
+      logger.info(`To cleanup: git checkout <previous-branch> && git branch -D ${epicContext.branchName}
+`);
+    }
+    throw error46;
+  }
 };
 
 // src/workflows/task.workflow.ts
@@ -80356,7 +81007,7 @@ var taskWorkflow = async (input2, context) => {
   const { logger, step } = context;
   const { task } = input2;
   logger.info(`
-\uD83E\uDD16 Running generic agent...
+Running generic agent...
 `);
   await step("agent", async () => {
     const defaultContext = await getDefaultContext();
@@ -80381,7 +81032,7 @@ ${defaultContext}`;
     }, context);
   });
   logger.info(`
-✅ Agent finished!
+Agent finished!
 `);
   return { success: true };
 };
@@ -80394,7 +81045,7 @@ var metaWorkflow = async (input2, context) => {
   const { task } = input2;
   const { logger } = context;
   logger.info(`
-\uD83E\uDD14 Deciding which workflow to use for task...
+Deciding which workflow to use for task...
 `);
   const result = await agentWorkflow({
     systemPrompt: META_SYSTEM_PROMPT,
@@ -80415,7 +81066,7 @@ var metaWorkflow = async (input2, context) => {
     throw new Error("Could not decide which workflow to run.");
   }
   logger.info(`
-✅ Decision: Using '${decision.workflow}' workflow.`);
+Decision: Using '${decision.workflow}' workflow.`);
   switch (decision.workflow) {
     case "code":
       await codeWorkflow({ task }, context);
@@ -80635,30 +81286,32 @@ var commitCommand = new Command("commit").description("Create a commit with AI-g
 async function runEpic(task2, _options, command) {
   let taskInput = task2;
   if (!taskInput) {
-    try {
-      taskInput = await esm_default3({
-        message: "What epic or large feature do you want to implement?"
-      });
-    } catch (error46) {
-      if (error46 instanceof Error && error46.name === "ExitPromptError") {
-        return;
-      }
-      throw error46;
+    taskInput = await getUserInput("What epic or large feature do you want to implement?");
+    if (!taskInput) {
+      return;
     }
   }
   if (!taskInput) {
     console.error("No task provided. Aborting.");
     return;
   }
+  const ctx = await loadEpicContext();
   const workflowInput = {
-    task: taskInput
+    task: taskInput,
+    epicContext: ctx
   };
   const globalOpts = (command.parent ?? command).opts();
   const { verbose, yes } = globalOpts;
   const logger = createLogger({
     verbose
   });
-  await runWorkflow(epicWorkflow, workflowInput, { commandName: "epic", command, logger, yes });
+  await runWorkflow(epicWorkflow, workflowInput, {
+    commandName: "epic",
+    command,
+    logger,
+    yes,
+    getProvider: (opt) => getProvider({ ...opt, todoItemStore: new EpicTodoItemStore(ctx), memoryStore: new EpicMemoryStore(ctx) })
+  });
 }
 var epicCommand = new Command("epic").description("Orchestrates a large feature or epic, breaking it down into smaller tasks.").argument("[task]", "The epic to plan and implement.").action(runEpic);