sparkecoder 0.1.83 → 0.1.85

package/dist/tools/index.d.ts

@@ -104,15 +104,12 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
         createdAt: string;
     }[];
     stats?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
-    planName?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     plans?: undefined;
     count?: undefined;
+    planName?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     deleted?: undefined;
     error?: undefined;
 } | {
@@ -133,18 +130,16 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
         createdAt: string;
     }[];
     itemsAdded?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
-    planName?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     plans?: undefined;
     count?: undefined;
+    planName?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     deleted?: undefined;
     error?: undefined;
 } | {
+    planContinuation?: string | undefined;
     success: boolean;
     action: string;
     item: {
@@ -158,13 +153,11 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     items?: undefined;
     stats?: undefined;
     itemsRemoved?: undefined;
-    planName?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     plans?: undefined;
     count?: undefined;
+    planName?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     deleted?: undefined;
     error?: undefined;
 } | {
@@ -174,17 +167,20 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     itemsAdded?: undefined;
     items?: undefined;
     stats?: undefined;
-    item?: undefined;
-    planName?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     plans?: undefined;
     count?: undefined;
+    planName?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     deleted?: undefined;
     error?: undefined;
 } | {
+    autoCreatedTodos?: {
+        id: string;
+        content: string;
+        status: string;
+    }[] | undefined;
+    autoCreatedFromPhase?: string | undefined;
     success: boolean;
     action: string;
     planName: string;
@@ -194,7 +190,6 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     itemsAdded?: undefined;
     items?: undefined;
     stats?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
     plans?: undefined;
     count?: undefined;
@@ -214,13 +209,10 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     itemsAdded?: undefined;
     items?: undefined;
     stats?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
     planName?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     deleted?: undefined;
     error?: undefined;
 } | {
@@ -232,10 +224,7 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     itemsAdded?: undefined;
     items?: undefined;
     stats?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
-    filename?: undefined;
-    path?: undefined;
     plans?: undefined;
     count?: undefined;
     deleted?: undefined;
@@ -248,14 +237,11 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     itemsAdded?: undefined;
     items?: undefined;
     stats?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     plans?: undefined;
     count?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     error?: undefined;
 } | {
     success: boolean;
@@ -264,15 +250,12 @@ declare function createTodoTool(options: TodoToolOptions): ai.Tool<{
     itemsAdded?: undefined;
     items?: undefined;
     stats?: undefined;
-    item?: undefined;
     itemsRemoved?: undefined;
-    planName?: undefined;
-    filename?: undefined;
-    path?: undefined;
-    sizeChars?: undefined;
     plans?: undefined;
     count?: undefined;
+    planName?: undefined;
     content?: undefined;
+    sizeChars?: undefined;
     deleted?: undefined;
 }>;
 

package/dist/tools/index.js

@@ -2779,22 +2779,27 @@ function createTodoTool(options) {
 - "clear": Remove all todo items from the list
 
 ## Plan Actions (for complex, multi-phase work)
-- "save_plan": Create or update a named plan \u2014 a persistent markdown document with hierarchical tasks, subtasks, and notes. Plans survive context compaction and are always available.
+- "save_plan": Create or update a named plan. When saved and no active todos exist, todos are AUTO-CREATED from the first uncompleted phase.
 - "list_plans": List all plans for this session
 - "get_plan": Read a specific plan by name
 - "delete_plan": Remove a plan
 
 ## Plans vs Todos
 - **Plans** are the big picture \u2014 the full spec with phases, subtasks, notes, and decisions. They persist on disk and are always injected into your context, even after old messages are summarized.
-- **Todos** are your current focus \u2014 the immediate steps you're working on right now.
+- **Todos** are your current focus \u2014 the immediate steps you're working on right now, auto-derived from plan phases.
 
 ## Workflow for complex tasks
-1. Create a plan with phases and subtasks (save_plan)
-2. Create todos from the first uncompleted phase (add)
-3. Work through the todos, marking them as you go
-4. When all current todos are done, update the plan (mark completed sections with [x]) and save it
-5. Create new todos from the next uncompleted phase
-6. Repeat until the plan is fully complete
+1. Create a plan with phases and subtasks using checkboxes (save_plan) \u2014 todos are auto-created from Phase 1
+2. Work through the todos, marking them as you go
+3. When all todos are done, update the plan: mark the completed phase heading with [completed] and its items with [x]
+4. Call save_plan again with the updated content \u2014 todos are auto-created from the next uncompleted phase
+5. Repeat until all phases are complete, then delete_plan
+
+## Auto-todo creation rules
+- Only triggers when there are NO active (pending/in_progress) todos
+- Skips phases with [completed] in the heading
+- Skips sections named Overview, Notes, Key Decisions, etc.
+- Only top-level checklist items (- [ ]) become todos \u2014 indented sub-items are task details
 
 ## Plan format
 Plans should be markdown with this structure:
@@ -2878,10 +2883,34 @@ Plans should be markdown with this structure:
                 error: `Todo item not found: ${todoId}`
               };
             }
+            let planContinuation;
+            if (status === "completed") {
+              const allTodos = await todoQueries.getBySession(options.sessionId);
+              const allDone = allTodos.every(
+                (t) => t.status === "completed" || t.status === "cancelled"
+              );
+              if (allDone) {
+                const plansDir = getPlansDir(options.workingDirectory, options.sessionId);
+                if (existsSync9(plansDir)) {
+                  const planFiles = readdirSync(plansDir).filter((f) => f.endsWith(".md"));
+                  for (const f of planFiles) {
+                    try {
+                      const content = await readFile6(join4(plansDir, f), "utf-8");
+                      if (parseNextUncompletedPhase(content) !== null) {
+                        planContinuation = "All todos are done but your plan has remaining phases. Update the plan now: mark the completed phase heading with [completed] and its items with [x], then call save_plan to save \u2014 new todos will be auto-created from the next phase.";
+                        break;
+                      }
+                    } catch {
+                    }
+                  }
+                }
+              }
+            }
             return {
               success: true,
               action: "mark",
-              item: formatTodoItem(updated)
+              item: formatTodoItem(updated),
+              ...planContinuation ? { planContinuation } : {}
             };
           }
           case "clear": {
@@ -2904,13 +2933,32 @@ Plans should be markdown with this structure:
             const filename = `${slugify(planName)}.md`;
             const filePath = join4(dir, filename);
             await writeFile4(filePath, planContent, "utf-8");
+            const existingTodos = await todoQueries.getBySession(options.sessionId);
+            const hasActiveTodos = existingTodos.some(
+              (t) => t.status === "pending" || t.status === "in_progress"
+            );
+            let autoCreatedTodos = [];
+            if (!hasActiveTodos) {
+              const nextPhase = parseNextUncompletedPhase(planContent);
+              if (nextPhase) {
+                const created = await todoQueries.createMany(
+                  options.sessionId,
+                  nextPhase.tasks.map((task, i) => ({ content: task, order: i }))
+                );
+                autoCreatedTodos = created.map(formatTodoItem);
+              }
+            }
             return {
               success: true,
               action: "save_plan",
               planName,
               filename,
               path: filePath,
-              sizeChars: planContent.length
+              sizeChars: planContent.length,
+              ...autoCreatedTodos.length > 0 ? {
+                autoCreatedTodos,
+                autoCreatedFromPhase: "Created todos from the first uncompleted phase. Start working on them!"
+              } : {}
             };
           }
           case "list_plans": {
@@ -2991,6 +3039,47 @@ function formatTodoItem(item) {
     createdAt: item.createdAt.toISOString()
   };
 }
+function parseNextUncompletedPhase(content) {
+  const lines = content.split("\n");
+  let currentPhase = null;
+  let currentTasks = [];
+  let hasUncompletedTask = false;
+  for (const line of lines) {
+    const h2Match = line.match(/^##\s+(.+)/);
+    if (h2Match) {
+      if (currentPhase && hasUncompletedTask && currentTasks.length > 0) {
+        return { phaseName: currentPhase, tasks: currentTasks };
+      }
+      const headingText = h2Match[1].trim();
+      if (/^(overview|notes|key decisions|context|summary|references)\b/i.test(headingText)) {
+        currentPhase = null;
+        currentTasks = [];
+        hasUncompletedTask = false;
+        continue;
+      }
+      if (/\[completed\]/i.test(headingText)) {
+        currentPhase = null;
+        currentTasks = [];
+        hasUncompletedTask = false;
+        continue;
+      }
+      currentPhase = headingText.replace(/\s*\[(in_progress|pending|completed)\]\s*/gi, "").replace(/^Phase\s+\d+[:\s]*/i, "").trim();
+      currentTasks = [];
+      hasUncompletedTask = false;
+      continue;
+    }
+    if (!currentPhase) continue;
+    const uncheckedMatch = line.match(/^[-*]\s+\[\s\]\s+(.+)/);
+    if (uncheckedMatch) {
+      currentTasks.push(uncheckedMatch[1].trim());
+      hasUncompletedTask = true;
+    }
+  }
+  if (currentPhase && hasUncompletedTask && currentTasks.length > 0) {
+    return { phaseName: currentPhase, tasks: currentTasks };
+  }
+  return null;
+}
 
 // src/tools/load-skill.ts
 import { tool as tool5 } from "ai";