@code-yeongyu/senpi 0.74.0

package/dist/core/extensions/builtin/todotools/continuation/prompt.js

@@ -0,0 +1,34 @@
+import { isIncompleteTodo, sanitizeTodoText } from "../state.js";
+export const CONTINUATION_DIRECTIVE = `[SYSTEM DIRECTIVE: SANEPI - TODO CONTINUATION]
+
+Incomplete tasks remain in your todo list. Continue working on the next pending task.
+
+- FIRST: Continue the first actionable remaining task now. If an in-progress task is already done, verify it and mark it completed before moving on
+- Proceed without asking for permission
+- Mark each task complete immediately when finished
+- Do not stop until all tasks are done
+- Do not reply with refusal, deferral, or a summary-only response
+- If a task is already complete, no longer needed, or blocked, verify that and update the todo list to a terminal state instead of leaving it pending
+- If you believe all work is already complete, the system is questioning your completion claim. Critically re-examine each todo item from a skeptical perspective, verify the work was actually done correctly, and update the todo list accordingly.`;
+export function countIncomplete(todos) {
+    return todos.filter(isIncompleteTodo).length;
+}
+export function buildContinuationPrompt(todos) {
+    if (todos.length === 0) {
+        return "";
+    }
+    const completedCount = todos.filter((todo) => todo.status === "completed").length;
+    const remainingTodos = todos.filter(isIncompleteTodo);
+    const activeTotal = completedCount + remainingTodos.length;
+    const remainingLines = remainingTodos
+        .map((todo) => `- [${todo.status}] ${sanitizeTodoText(todo.content)}`)
+        .join("\n");
+    return `${CONTINUATION_DIRECTIVE}
+
+[Status: ${completedCount}/${activeTotal} completed, ${remainingTodos.length} remaining]
+
+Remaining tasks:
+${remainingLines}
+`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/core/extensions/builtin/todotools/continuation/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/todotools/continuation/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AAEhF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;sPAUgN,CAAC;AAEvP,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAU;IAC1D,OAAO,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;AAAA,CAC7C;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAiB,EAAU;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAClF,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC;IAC3D,MAAM,cAAc,GAAG,cAAc;SACnC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;SACrE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,GAAG,sBAAsB;;WAEtB,cAAc,IAAI,WAAW,eAAe,cAAc,CAAC,MAAM;;;EAG1E,cAAc;CACf,CAAC;AAAA,CACD","sourcesContent":["import { isIncompleteTodo, sanitizeTodoText, type TodoItem } from \"../state.js\";\n\nexport const CONTINUATION_DIRECTIVE = `[SYSTEM DIRECTIVE: SANEPI - TODO CONTINUATION]\n\nIncomplete tasks remain in your todo list. Continue working on the next pending task.\n\n- FIRST: Continue the first actionable remaining task now. If an in-progress task is already done, verify it and mark it completed before moving on\n- Proceed without asking for permission\n- Mark each task complete immediately when finished\n- Do not stop until all tasks are done\n- Do not reply with refusal, deferral, or a summary-only response\n- If a task is already complete, no longer needed, or blocked, verify that and update the todo list to a terminal state instead of leaving it pending\n- If you believe all work is already complete, the system is questioning your completion claim. Critically re-examine each todo item from a skeptical perspective, verify the work was actually done correctly, and update the todo list accordingly.`;\n\nexport function countIncomplete(todos: TodoItem[]): number {\n\treturn todos.filter(isIncompleteTodo).length;\n}\n\nexport function buildContinuationPrompt(todos: TodoItem[]): string {\n\tif (todos.length === 0) {\n\t\treturn \"\";\n\t}\n\n\tconst completedCount = todos.filter((todo) => todo.status === \"completed\").length;\n\tconst remainingTodos = todos.filter(isIncompleteTodo);\n\tconst activeTotal = completedCount + remainingTodos.length;\n\tconst remainingLines = remainingTodos\n\t\t.map((todo) => `- [${todo.status}] ${sanitizeTodoText(todo.content)}`)\n\t\t.join(\"\\n\");\n\n\treturn `${CONTINUATION_DIRECTIVE}\n\n[Status: ${completedCount}/${activeTotal} completed, ${remainingTodos.length} remaining]\n\nRemaining tasks:\n${remainingLines}\n`;\n}\n"]}

package/dist/core/extensions/builtin/todotools/continuation/runtime.d.ts

@@ -0,0 +1,11 @@
+import type { ExtensionAPI } from "../../../types.js";
+import type { TodoItem } from "../state.js";
+type ContinuationDeps = {
+    getCurrentTodos: () => TodoItem[];
+};
+export declare const CONTINUATION_CHAIN_CAP = 10;
+export declare function isContinuationFollowUpPrompt(prompt: string): boolean;
+export declare function isCleanStopReason(stopReason: string | undefined): boolean;
+export declare function installContinuation(pi: ExtensionAPI, deps: ContinuationDeps): void;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/extensions/builtin/todotools/continuation/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/todotools/continuation/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAuC,MAAM,mBAAmB,CAAC;AAE3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU5C,KAAK,gBAAgB,GAAG;IACvB,eAAe,EAAE,MAAM,QAAQ,EAAE,CAAC;CAClC,CAAC;AAGF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AA0BzC,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzE;AAwGD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAkGlF","sourcesContent":["import type { AssistantMessage } from \"@earendil-works/pi-ai\";\nimport { SettingsManager } from \"../../../../settings-manager.js\";\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from \"../../../types.js\";\nimport { emitBuiltinSystemMessageFailure, sendBuiltinUserMessage } from \"../../system-messages.js\";\nimport type { TodoItem } from \"../state.js\";\nimport { resolveContinuationConfig } from \"./config.js\";\nimport { buildContinuationPrompt, CONTINUATION_DIRECTIVE, countIncomplete } from \"./prompt.js\";\n\ntype ContinuationState = {\n\treEntryFlag: boolean;\n\tchainCount: number;\n\tpendingDispatchAbortController?: AbortController;\n};\n\ntype ContinuationDeps = {\n\tgetCurrentTodos: () => TodoItem[];\n};\n\nconst CLEAN_STOP_REASONS = new Set([\"stop\", \"toolUse\", \"endTurn\", \"end_turn\"]);\nexport const CONTINUATION_CHAIN_CAP = 10;\nconst IDLE_POLL_INTERVAL_MS = 50;\nconst IDLE_WAIT_TIMEOUT_MS = 10_000;\n\nfunction isAssistantMessage(message: unknown): message is AssistantMessage {\n\tif (!message || typeof message !== \"object\") {\n\t\treturn false;\n\t}\n\n\tconst role = (message as { role?: unknown }).role;\n\treturn role === \"assistant\";\n}\n\nfunction getLastAssistantStopReason(messages: unknown[]): string | undefined {\n\tfor (let index = messages.length - 1; index >= 0; index -= 1) {\n\t\tconst message = messages[index];\n\t\tif (!isAssistantMessage(message)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\treturn message.stopReason;\n\t}\n\n\treturn undefined;\n}\n\nexport function isContinuationFollowUpPrompt(prompt: string): boolean {\n\treturn prompt.includes(CONTINUATION_DIRECTIVE);\n}\n\nexport function isCleanStopReason(stopReason: string | undefined): boolean {\n\treturn typeof stopReason === \"string\" && CLEAN_STOP_REASONS.has(stopReason);\n}\n\nfunction createInitialState(): ContinuationState {\n\treturn {\n\t\treEntryFlag: false,\n\t\tchainCount: 0,\n\t};\n}\n\nfunction abortPendingDispatch(state: ContinuationState): void {\n\tstate.pendingDispatchAbortController?.abort();\n\tstate.pendingDispatchAbortController = undefined;\n}\n\nfunction getSessionState(sessionStates: Map<string, ContinuationState>, sessionId: string): ContinuationState {\n\tconst existingState = sessionStates.get(sessionId);\n\tif (existingState) {\n\t\treturn existingState;\n\t}\n\n\tconst nextState = createInitialState();\n\tsessionStates.set(sessionId, nextState);\n\treturn nextState;\n}\n\nfunction getSessionId(ctx: ExtensionContext): string {\n\treturn ctx.sessionManager.getSessionId();\n}\n\nfunction isNonInteractiveContext(ctx: ExtensionContext): boolean {\n\t// ExtensionContext does not expose a dedicated mode flag. The documented\n\t// signal for print/RPC mode is `hasUI === false`.\n\treturn !ctx.hasUI;\n}\n\nfunction shouldResetForSessionStart(event: SessionStartEvent): boolean {\n\tconst reason = event.reason as string;\n\treturn reason === \"reload\" || reason === \"resume\" || reason === \"compact\";\n}\n\nfunction reportContinuationError(pi: ExtensionAPI, ctx: ExtensionContext, error: unknown, prompt?: string): void {\n\tconst message = error instanceof Error ? error.message : String(error);\n\temitBuiltinSystemMessageFailure(pi, {\n\t\troute: \"todotools.continuation\",\n\t\tsessionId: getSessionId(ctx),\n\t\tkind: \"user_message\",\n\t\tcontent: prompt ?? \"\",\n\t\terrorMessage: message,\n\t});\n\tpi.events.emit(\"todotools:continuation_error\", {\n\t\tsessionId: getSessionId(ctx),\n\t\tmessage,\n\t});\n\tif (ctx.hasUI) {\n\t\tctx.ui.notify(`Todo continuation failed: ${message}`, \"error\");\n\t\treturn;\n\t}\n\tprocess.stderr.write(`[todotools continuation] ${message}\\n`);\n}\n\nfunction wait(ms: number): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tsetTimeout(resolve, ms);\n\t});\n}\n\nasync function dispatchContinuationWhenIdle(\n\tpi: ExtensionAPI,\n\tctx: ExtensionContext,\n\tprompt: string,\n\tsignal: AbortSignal,\n): Promise<void> {\n\tconst startedAt = Date.now();\n\n\tif (signal.aborted) {\n\t\treturn;\n\t}\n\n\twhile (Date.now() - startedAt < IDLE_WAIT_TIMEOUT_MS) {\n\t\tif (signal.aborted) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (ctx.isIdle()) {\n\t\t\tif (signal.aborted) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tsendBuiltinUserMessage(pi, \"todotools.continuation\", prompt, {\n\t\t\t\tsessionId: getSessionId(ctx),\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tawait wait(IDLE_POLL_INTERVAL_MS);\n\n\t\tif (signal.aborted) {\n\t\t\treturn;\n\t\t}\n\t}\n\n\tconsole.warn(\"[todotools continuation] Timed out waiting for idle state; skipping auto-dispatch.\");\n}\n\nexport function installContinuation(pi: ExtensionAPI, deps: ContinuationDeps): void {\n\tconst sessionStates = new Map<string, ContinuationState>();\n\n\tpi.registerFlag(\"disable-todo-continuation\", {\n\t\ttype: \"boolean\",\n\t\tdefault: false,\n\t\tdescription: \"Disable todo continuation — automatic follow-up when incomplete todos remain in the list\",\n\t});\n\n\tpi.on(\"before_agent_start\", async (event, ctx) => {\n\t\tconst sessionState = getSessionState(sessionStates, getSessionId(ctx));\n\t\tsessionState.reEntryFlag = false;\n\t\tif (!isContinuationFollowUpPrompt(event.prompt)) {\n\t\t\tsessionState.chainCount = 0;\n\t\t\tabortPendingDispatch(sessionState);\n\t\t}\n\t});\n\n\tpi.on(\"session_start\", async (event, ctx) => {\n\t\tif (!shouldResetForSessionStart(event)) {\n\t\t\treturn;\n\t\t}\n\t\tconst sessionId = getSessionId(ctx);\n\t\tconst existingState = sessionStates.get(sessionId);\n\t\tif (existingState) {\n\t\t\tabortPendingDispatch(existingState);\n\t\t}\n\t\tsessionStates.set(sessionId, createInitialState());\n\t});\n\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tconst sessionId = getSessionId(ctx);\n\t\tconst existingState = sessionStates.get(sessionId);\n\t\tif (existingState) {\n\t\t\tabortPendingDispatch(existingState);\n\t\t}\n\t\tsessionStates.delete(sessionId);\n\t});\n\n\tpi.on(\"agent_end\", async (event, ctx) => {\n\t\ttry {\n\t\t\tif (isNonInteractiveContext(ctx)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst stopReason = getLastAssistantStopReason(event.messages);\n\t\t\tif (!isCleanStopReason(stopReason)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst settingsManager = SettingsManager.create(ctx.cwd);\n\t\t\tconst config = resolveContinuationConfig({\n\t\t\t\tglobalSettings: settingsManager.getGlobalSettings() as Record<string, unknown>,\n\t\t\t\tprojectSettings: settingsManager.getProjectSettings() as Record<string, unknown>,\n\t\t\t\tcliFlag: pi.getFlag(\"disable-todo-continuation\"),\n\t\t\t});\n\t\t\tif (!config.enabled) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst todos = deps.getCurrentTodos();\n\t\t\tif (countIncomplete(todos) === 0) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst sessionId = getSessionId(ctx);\n\t\t\tconst sessionState = getSessionState(sessionStates, sessionId);\n\t\t\tif (sessionState.reEntryFlag) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (sessionState.chainCount >= CONTINUATION_CHAIN_CAP) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst prompt = buildContinuationPrompt(todos);\n\t\t\tabortPendingDispatch(sessionState);\n\t\t\tconst pendingDispatchAbortController = new AbortController();\n\t\t\tsessionState.pendingDispatchAbortController = pendingDispatchAbortController;\n\t\t\tsessionState.reEntryFlag = true;\n\t\t\tsessionState.chainCount += 1;\n\t\t\tsetTimeout(() => {\n\t\t\t\tvoid (async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait dispatchContinuationWhenIdle(pi, ctx, prompt, pendingDispatchAbortController.signal);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\treportContinuationError(pi, ctx, error, prompt);\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tconst currentState = sessionStates.get(sessionId);\n\t\t\t\t\t\tif (currentState?.pendingDispatchAbortController === pendingDispatchAbortController) {\n\t\t\t\t\t\t\tcurrentState.pendingDispatchAbortController = undefined;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t}, 0);\n\t\t} catch (error) {\n\t\t\treportContinuationError(pi, ctx, error);\n\t\t}\n\t});\n}\n"]}

package/dist/core/extensions/builtin/todotools/continuation/runtime.js

@@ -0,0 +1,204 @@
+import { SettingsManager } from "../../../../settings-manager.js";
+import { emitBuiltinSystemMessageFailure, sendBuiltinUserMessage } from "../../system-messages.js";
+import { resolveContinuationConfig } from "./config.js";
+import { buildContinuationPrompt, CONTINUATION_DIRECTIVE, countIncomplete } from "./prompt.js";
+const CLEAN_STOP_REASONS = new Set(["stop", "toolUse", "endTurn", "end_turn"]);
+export const CONTINUATION_CHAIN_CAP = 10;
+const IDLE_POLL_INTERVAL_MS = 50;
+const IDLE_WAIT_TIMEOUT_MS = 10_000;
+function isAssistantMessage(message) {
+    if (!message || typeof message !== "object") {
+        return false;
+    }
+    const role = message.role;
+    return role === "assistant";
+}
+function getLastAssistantStopReason(messages) {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (!isAssistantMessage(message)) {
+            continue;
+        }
+        return message.stopReason;
+    }
+    return undefined;
+}
+export function isContinuationFollowUpPrompt(prompt) {
+    return prompt.includes(CONTINUATION_DIRECTIVE);
+}
+export function isCleanStopReason(stopReason) {
+    return typeof stopReason === "string" && CLEAN_STOP_REASONS.has(stopReason);
+}
+function createInitialState() {
+    return {
+        reEntryFlag: false,
+        chainCount: 0,
+    };
+}
+function abortPendingDispatch(state) {
+    state.pendingDispatchAbortController?.abort();
+    state.pendingDispatchAbortController = undefined;
+}
+function getSessionState(sessionStates, sessionId) {
+    const existingState = sessionStates.get(sessionId);
+    if (existingState) {
+        return existingState;
+    }
+    const nextState = createInitialState();
+    sessionStates.set(sessionId, nextState);
+    return nextState;
+}
+function getSessionId(ctx) {
+    return ctx.sessionManager.getSessionId();
+}
+function isNonInteractiveContext(ctx) {
+    // ExtensionContext does not expose a dedicated mode flag. The documented
+    // signal for print/RPC mode is `hasUI === false`.
+    return !ctx.hasUI;
+}
+function shouldResetForSessionStart(event) {
+    const reason = event.reason;
+    return reason === "reload" || reason === "resume" || reason === "compact";
+}
+function reportContinuationError(pi, ctx, error, prompt) {
+    const message = error instanceof Error ? error.message : String(error);
+    emitBuiltinSystemMessageFailure(pi, {
+        route: "todotools.continuation",
+        sessionId: getSessionId(ctx),
+        kind: "user_message",
+        content: prompt ?? "",
+        errorMessage: message,
+    });
+    pi.events.emit("todotools:continuation_error", {
+        sessionId: getSessionId(ctx),
+        message,
+    });
+    if (ctx.hasUI) {
+        ctx.ui.notify(`Todo continuation failed: ${message}`, "error");
+        return;
+    }
+    process.stderr.write(`[todotools continuation] ${message}\n`);
+}
+function wait(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+async function dispatchContinuationWhenIdle(pi, ctx, prompt, signal) {
+    const startedAt = Date.now();
+    if (signal.aborted) {
+        return;
+    }
+    while (Date.now() - startedAt < IDLE_WAIT_TIMEOUT_MS) {
+        if (signal.aborted) {
+            return;
+        }
+        if (ctx.isIdle()) {
+            if (signal.aborted) {
+                return;
+            }
+            sendBuiltinUserMessage(pi, "todotools.continuation", prompt, {
+                sessionId: getSessionId(ctx),
+            });
+            return;
+        }
+        await wait(IDLE_POLL_INTERVAL_MS);
+        if (signal.aborted) {
+            return;
+        }
+    }
+    console.warn("[todotools continuation] Timed out waiting for idle state; skipping auto-dispatch.");
+}
+export function installContinuation(pi, deps) {
+    const sessionStates = new Map();
+    pi.registerFlag("disable-todo-continuation", {
+        type: "boolean",
+        default: false,
+        description: "Disable todo continuation — automatic follow-up when incomplete todos remain in the list",
+    });
+    pi.on("before_agent_start", async (event, ctx) => {
+        const sessionState = getSessionState(sessionStates, getSessionId(ctx));
+        sessionState.reEntryFlag = false;
+        if (!isContinuationFollowUpPrompt(event.prompt)) {
+            sessionState.chainCount = 0;
+            abortPendingDispatch(sessionState);
+        }
+    });
+    pi.on("session_start", async (event, ctx) => {
+        if (!shouldResetForSessionStart(event)) {
+            return;
+        }
+        const sessionId = getSessionId(ctx);
+        const existingState = sessionStates.get(sessionId);
+        if (existingState) {
+            abortPendingDispatch(existingState);
+        }
+        sessionStates.set(sessionId, createInitialState());
+    });
+    pi.on("session_shutdown", async (_event, ctx) => {
+        const sessionId = getSessionId(ctx);
+        const existingState = sessionStates.get(sessionId);
+        if (existingState) {
+            abortPendingDispatch(existingState);
+        }
+        sessionStates.delete(sessionId);
+    });
+    pi.on("agent_end", async (event, ctx) => {
+        try {
+            if (isNonInteractiveContext(ctx)) {
+                return;
+            }
+            const stopReason = getLastAssistantStopReason(event.messages);
+            if (!isCleanStopReason(stopReason)) {
+                return;
+            }
+            const settingsManager = SettingsManager.create(ctx.cwd);
+            const config = resolveContinuationConfig({
+                globalSettings: settingsManager.getGlobalSettings(),
+                projectSettings: settingsManager.getProjectSettings(),
+                cliFlag: pi.getFlag("disable-todo-continuation"),
+            });
+            if (!config.enabled) {
+                return;
+            }
+            const todos = deps.getCurrentTodos();
+            if (countIncomplete(todos) === 0) {
+                return;
+            }
+            const sessionId = getSessionId(ctx);
+            const sessionState = getSessionState(sessionStates, sessionId);
+            if (sessionState.reEntryFlag) {
+                return;
+            }
+            if (sessionState.chainCount >= CONTINUATION_CHAIN_CAP) {
+                return;
+            }
+            const prompt = buildContinuationPrompt(todos);
+            abortPendingDispatch(sessionState);
+            const pendingDispatchAbortController = new AbortController();
+            sessionState.pendingDispatchAbortController = pendingDispatchAbortController;
+            sessionState.reEntryFlag = true;
+            sessionState.chainCount += 1;
+            setTimeout(() => {
+                void (async () => {
+                    try {
+                        await dispatchContinuationWhenIdle(pi, ctx, prompt, pendingDispatchAbortController.signal);
+                    }
+                    catch (error) {
+                        reportContinuationError(pi, ctx, error, prompt);
+                    }
+                    finally {
+                        const currentState = sessionStates.get(sessionId);
+                        if (currentState?.pendingDispatchAbortController === pendingDispatchAbortController) {
+                            currentState.pendingDispatchAbortController = undefined;
+                        }
+                    }
+                })();
+            }, 0);
+        }
+        catch (error) {
+            reportContinuationError(pi, ctx, error);
+        }
+    });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/extensions/builtin/todotools/continuation/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/todotools/continuation/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEnG,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAY/F,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC,SAAS,kBAAkB,CAAC,OAAgB,EAA+B;IAC1E,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAI,OAA8B,CAAC,IAAI,CAAC;IAClD,OAAO,IAAI,KAAK,WAAW,CAAC;AAAA,CAC5B;AAED,SAAS,0BAA0B,CAAC,QAAmB,EAAsB;IAC5E,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,SAAS;QACV,CAAC;QAED,OAAO,OAAO,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc,EAAW;IACrE,OAAO,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAAA,CAC/C;AAED,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAW;IAC1E,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAAA,CAC5E;AAED,SAAS,kBAAkB,GAAsB;IAChD,OAAO;QACN,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,CAAC;KACb,CAAC;AAAA,CACF;AAED,SAAS,oBAAoB,CAAC,KAAwB,EAAQ;IAC7D,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAE,CAAC;IAC9C,KAAK,CAAC,8BAA8B,GAAG,SAAS,CAAC;AAAA,CACjD;AAED,SAAS,eAAe,CAAC,aAA6C,EAAE,SAAiB,EAAqB;IAC7G,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,YAAY,CAAC,GAAqB,EAAU;IACpD,OAAO,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;AAAA,CACzC;AAED,SAAS,uBAAuB,CAAC,GAAqB,EAAW;IAChE,yEAAyE;IACzE,kDAAkD;IAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;AAAA,CAClB;AAED,SAAS,0BAA0B,CAAC,KAAwB,EAAW;IACtE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgB,CAAC;IACtC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;AAAA,CAC1E;AAED,SAAS,uBAAuB,CAAC,EAAgB,EAAE,GAAqB,EAAE,KAAc,EAAE,MAAe,EAAQ;IAChH,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,+BAA+B,CAAC,EAAE,EAAE;QACnC,KAAK,EAAE,wBAAwB;QAC/B,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC;QAC5B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,MAAM,IAAI,EAAE;QACrB,YAAY,EAAE,OAAO;KACrB,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;QAC9C,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC;QAC5B,OAAO;KACP,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,6BAA6B,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO;IACR,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,IAAI,CAAC,CAAC;AAAA,CAC9D;AAED,SAAS,IAAI,CAAC,EAAU,EAAiB;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAAA,CACxB,CAAC,CAAC;AAAA,CACH;AAED,KAAK,UAAU,4BAA4B,CAC1C,EAAgB,EAChB,GAAqB,EACrB,MAAc,EACd,MAAmB,EACH;IAChB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;IACR,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACtD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;QACR,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YAClB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;YACR,CAAC;YAED,sBAAsB,CAAC,EAAE,EAAE,wBAAwB,EAAE,MAAM,EAAE;gBAC5D,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC;aAC5B,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,MAAM,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAElC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;QACR,CAAC;IACF,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;AAAA,CACnG;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAgB,EAAE,IAAsB,EAAQ;IACnF,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE3D,EAAE,CAAC,YAAY,CAAC,2BAA2B,EAAE;QAC5C,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,4FAA0F;KACvG,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QACjD,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QACvE,YAAY,CAAC,WAAW,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC;YAC5B,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO;QACR,CAAC;QACD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,aAAa,EAAE,CAAC;YACnB,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAAA,CACnD,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,aAAa,EAAE,CAAC;YACnB,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC;QACD,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAAA,CAChC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC;YACJ,IAAI,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,OAAO;YACR,CAAC;YAED,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC9D,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpC,OAAO;YACR,CAAC;YAED,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,yBAAyB,CAAC;gBACxC,cAAc,EAAE,eAAe,CAAC,iBAAiB,EAA6B;gBAC9E,eAAe,EAAE,eAAe,CAAC,kBAAkB,EAA6B;gBAChF,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC;aAChD,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO;YACR,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACrC,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO;YACR,CAAC;YAED,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC/D,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;gBAC9B,OAAO;YACR,CAAC;YACD,IAAI,YAAY,CAAC,UAAU,IAAI,sBAAsB,EAAE,CAAC;gBACvD,OAAO;YACR,CAAC;YAED,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAC9C,oBAAoB,CAAC,YAAY,CAAC,CAAC;YACnC,MAAM,8BAA8B,GAAG,IAAI,eAAe,EAAE,CAAC;YAC7D,YAAY,CAAC,8BAA8B,GAAG,8BAA8B,CAAC;YAC7E,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC;YAChC,YAAY,CAAC,UAAU,IAAI,CAAC,CAAC;YAC7B,UAAU,CAAC,GAAG,EAAE,CAAC;gBAChB,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;oBACjB,IAAI,CAAC;wBACJ,MAAM,4BAA4B,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,8BAA8B,CAAC,MAAM,CAAC,CAAC;oBAC5F,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBAChB,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;oBACjD,CAAC;4BAAS,CAAC;wBACV,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;wBAClD,IAAI,YAAY,EAAE,8BAA8B,KAAK,8BAA8B,EAAE,CAAC;4BACrF,YAAY,CAAC,8BAA8B,GAAG,SAAS,CAAC;wBACzD,CAAC;oBACF,CAAC;gBAAA,CACD,CAAC,EAAE,CAAC;YAAA,CACL,EAAE,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IAAA,CACD,CAAC,CAAC;AAAA,CACH","sourcesContent":["import type { AssistantMessage } from \"@earendil-works/pi-ai\";\nimport { SettingsManager } from \"../../../../settings-manager.js\";\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from \"../../../types.js\";\nimport { emitBuiltinSystemMessageFailure, sendBuiltinUserMessage } from \"../../system-messages.js\";\nimport type { TodoItem } from \"../state.js\";\nimport { resolveContinuationConfig } from \"./config.js\";\nimport { buildContinuationPrompt, CONTINUATION_DIRECTIVE, countIncomplete } from \"./prompt.js\";\n\ntype ContinuationState = {\n\treEntryFlag: boolean;\n\tchainCount: number;\n\tpendingDispatchAbortController?: AbortController;\n};\n\ntype ContinuationDeps = {\n\tgetCurrentTodos: () => TodoItem[];\n};\n\nconst CLEAN_STOP_REASONS = new Set([\"stop\", \"toolUse\", \"endTurn\", \"end_turn\"]);\nexport const CONTINUATION_CHAIN_CAP = 10;\nconst IDLE_POLL_INTERVAL_MS = 50;\nconst IDLE_WAIT_TIMEOUT_MS = 10_000;\n\nfunction isAssistantMessage(message: unknown): message is AssistantMessage {\n\tif (!message || typeof message !== \"object\") {\n\t\treturn false;\n\t}\n\n\tconst role = (message as { role?: unknown }).role;\n\treturn role === \"assistant\";\n}\n\nfunction getLastAssistantStopReason(messages: unknown[]): string | undefined {\n\tfor (let index = messages.length - 1; index >= 0; index -= 1) {\n\t\tconst message = messages[index];\n\t\tif (!isAssistantMessage(message)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\treturn message.stopReason;\n\t}\n\n\treturn undefined;\n}\n\nexport function isContinuationFollowUpPrompt(prompt: string): boolean {\n\treturn prompt.includes(CONTINUATION_DIRECTIVE);\n}\n\nexport function isCleanStopReason(stopReason: string | undefined): boolean {\n\treturn typeof stopReason === \"string\" && CLEAN_STOP_REASONS.has(stopReason);\n}\n\nfunction createInitialState(): ContinuationState {\n\treturn {\n\t\treEntryFlag: false,\n\t\tchainCount: 0,\n\t};\n}\n\nfunction abortPendingDispatch(state: ContinuationState): void {\n\tstate.pendingDispatchAbortController?.abort();\n\tstate.pendingDispatchAbortController = undefined;\n}\n\nfunction getSessionState(sessionStates: Map<string, ContinuationState>, sessionId: string): ContinuationState {\n\tconst existingState = sessionStates.get(sessionId);\n\tif (existingState) {\n\t\treturn existingState;\n\t}\n\n\tconst nextState = createInitialState();\n\tsessionStates.set(sessionId, nextState);\n\treturn nextState;\n}\n\nfunction getSessionId(ctx: ExtensionContext): string {\n\treturn ctx.sessionManager.getSessionId();\n}\n\nfunction isNonInteractiveContext(ctx: ExtensionContext): boolean {\n\t// ExtensionContext does not expose a dedicated mode flag. The documented\n\t// signal for print/RPC mode is `hasUI === false`.\n\treturn !ctx.hasUI;\n}\n\nfunction shouldResetForSessionStart(event: SessionStartEvent): boolean {\n\tconst reason = event.reason as string;\n\treturn reason === \"reload\" || reason === \"resume\" || reason === \"compact\";\n}\n\nfunction reportContinuationError(pi: ExtensionAPI, ctx: ExtensionContext, error: unknown, prompt?: string): void {\n\tconst message = error instanceof Error ? error.message : String(error);\n\temitBuiltinSystemMessageFailure(pi, {\n\t\troute: \"todotools.continuation\",\n\t\tsessionId: getSessionId(ctx),\n\t\tkind: \"user_message\",\n\t\tcontent: prompt ?? \"\",\n\t\terrorMessage: message,\n\t});\n\tpi.events.emit(\"todotools:continuation_error\", {\n\t\tsessionId: getSessionId(ctx),\n\t\tmessage,\n\t});\n\tif (ctx.hasUI) {\n\t\tctx.ui.notify(`Todo continuation failed: ${message}`, \"error\");\n\t\treturn;\n\t}\n\tprocess.stderr.write(`[todotools continuation] ${message}\\n`);\n}\n\nfunction wait(ms: number): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tsetTimeout(resolve, ms);\n\t});\n}\n\nasync function dispatchContinuationWhenIdle(\n\tpi: ExtensionAPI,\n\tctx: ExtensionContext,\n\tprompt: string,\n\tsignal: AbortSignal,\n): Promise<void> {\n\tconst startedAt = Date.now();\n\n\tif (signal.aborted) {\n\t\treturn;\n\t}\n\n\twhile (Date.now() - startedAt < IDLE_WAIT_TIMEOUT_MS) {\n\t\tif (signal.aborted) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (ctx.isIdle()) {\n\t\t\tif (signal.aborted) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tsendBuiltinUserMessage(pi, \"todotools.continuation\", prompt, {\n\t\t\t\tsessionId: getSessionId(ctx),\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tawait wait(IDLE_POLL_INTERVAL_MS);\n\n\t\tif (signal.aborted) {\n\t\t\treturn;\n\t\t}\n\t}\n\n\tconsole.warn(\"[todotools continuation] Timed out waiting for idle state; skipping auto-dispatch.\");\n}\n\nexport function installContinuation(pi: ExtensionAPI, deps: ContinuationDeps): void {\n\tconst sessionStates = new Map<string, ContinuationState>();\n\n\tpi.registerFlag(\"disable-todo-continuation\", {\n\t\ttype: \"boolean\",\n\t\tdefault: false,\n\t\tdescription: \"Disable todo continuation — automatic follow-up when incomplete todos remain in the list\",\n\t});\n\n\tpi.on(\"before_agent_start\", async (event, ctx) => {\n\t\tconst sessionState = getSessionState(sessionStates, getSessionId(ctx));\n\t\tsessionState.reEntryFlag = false;\n\t\tif (!isContinuationFollowUpPrompt(event.prompt)) {\n\t\t\tsessionState.chainCount = 0;\n\t\t\tabortPendingDispatch(sessionState);\n\t\t}\n\t});\n\n\tpi.on(\"session_start\", async (event, ctx) => {\n\t\tif (!shouldResetForSessionStart(event)) {\n\t\t\treturn;\n\t\t}\n\t\tconst sessionId = getSessionId(ctx);\n\t\tconst existingState = sessionStates.get(sessionId);\n\t\tif (existingState) {\n\t\t\tabortPendingDispatch(existingState);\n\t\t}\n\t\tsessionStates.set(sessionId, createInitialState());\n\t});\n\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tconst sessionId = getSessionId(ctx);\n\t\tconst existingState = sessionStates.get(sessionId);\n\t\tif (existingState) {\n\t\t\tabortPendingDispatch(existingState);\n\t\t}\n\t\tsessionStates.delete(sessionId);\n\t});\n\n\tpi.on(\"agent_end\", async (event, ctx) => {\n\t\ttry {\n\t\t\tif (isNonInteractiveContext(ctx)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst stopReason = getLastAssistantStopReason(event.messages);\n\t\t\tif (!isCleanStopReason(stopReason)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst settingsManager = SettingsManager.create(ctx.cwd);\n\t\t\tconst config = resolveContinuationConfig({\n\t\t\t\tglobalSettings: settingsManager.getGlobalSettings() as Record<string, unknown>,\n\t\t\t\tprojectSettings: settingsManager.getProjectSettings() as Record<string, unknown>,\n\t\t\t\tcliFlag: pi.getFlag(\"disable-todo-continuation\"),\n\t\t\t});\n\t\t\tif (!config.enabled) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst todos = deps.getCurrentTodos();\n\t\t\tif (countIncomplete(todos) === 0) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst sessionId = getSessionId(ctx);\n\t\t\tconst sessionState = getSessionState(sessionStates, sessionId);\n\t\t\tif (sessionState.reEntryFlag) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (sessionState.chainCount >= CONTINUATION_CHAIN_CAP) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst prompt = buildContinuationPrompt(todos);\n\t\t\tabortPendingDispatch(sessionState);\n\t\t\tconst pendingDispatchAbortController = new AbortController();\n\t\t\tsessionState.pendingDispatchAbortController = pendingDispatchAbortController;\n\t\t\tsessionState.reEntryFlag = true;\n\t\t\tsessionState.chainCount += 1;\n\t\t\tsetTimeout(() => {\n\t\t\t\tvoid (async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait dispatchContinuationWhenIdle(pi, ctx, prompt, pendingDispatchAbortController.signal);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\treportContinuationError(pi, ctx, error, prompt);\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tconst currentState = sessionStates.get(sessionId);\n\t\t\t\t\t\tif (currentState?.pendingDispatchAbortController === pendingDispatchAbortController) {\n\t\t\t\t\t\t\tcurrentState.pendingDispatchAbortController = undefined;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t}, 0);\n\t\t} catch (error) {\n\t\t\treportContinuationError(pi, ctx, error);\n\t\t}\n\t});\n}\n"]}

package/dist/core/extensions/builtin/todotools/index.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionAPI } from "../../types.js";
+export default function todowriteExtension(pi: ExtensionAPI): void;
+export { TASK_MANAGEMENT_SECTION } from "./prompt.js";
+export { getLatestTodosFromBranchEntries, getTodoMarker, getTodoResultLines, getTodoWidgetLines, isTodoItem, isTodoItemArray, sanitizeTodoText, TODO_STATE_ENTRY_TYPE, type TodoItem, } from "./state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/todotools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAWrE,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAoCjE;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACN,+BAA+B,EAC/B,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,QAAQ,GACb,MAAM,YAAY,CAAC","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"../../types.js\";\nimport { installContinuation } from \"./continuation/index.js\";\nimport { TASK_MANAGEMENT_SECTION } from \"./prompt.js\";\nimport { getLatestTodosFromBranchEntries, getTodoWidgetLines, type TodoItem } from \"./state.js\";\nimport { registerTodoReadTool } from \"./tools/todoread.js\";\nimport { registerTodoWriteTool } from \"./tools/todowrite.js\";\n\nfunction getLatestTodos(ctx: ExtensionContext): TodoItem[] {\n\treturn getLatestTodosFromBranchEntries(ctx.sessionManager.getBranch());\n}\n\nexport default function todowriteExtension(pi: ExtensionAPI): void {\n\tlet currentTodos: TodoItem[] = [];\n\n\tconst getCurrentTodos = (): TodoItem[] => currentTodos;\n\n\tconst setCurrentTodos = (todos: TodoItem[]): void => {\n\t\tcurrentTodos = todos;\n\t};\n\n\tconst syncWidget = (ctx: ExtensionContext): void => {\n\t\tctx.ui.setWidget(\"todo-sidebar\", getTodoWidgetLines(currentTodos));\n\t};\n\n\tconst syncFromSession = (ctx: ExtensionContext): void => {\n\t\tcurrentTodos = getLatestTodos(ctx);\n\t\tsyncWidget(ctx);\n\t};\n\n\tinstallContinuation(pi, { getCurrentTodos });\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"session_tree\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => {\n\t\treturn {\n\t\t\tsystemPrompt: `${event.systemPrompt}\\n${TASK_MANAGEMENT_SECTION}`,\n\t\t};\n\t});\n\n\tregisterTodoWriteTool(pi, { getCurrentTodos, setCurrentTodos, syncWidget });\n\tregisterTodoReadTool(pi, getCurrentTodos);\n}\n\nexport { TASK_MANAGEMENT_SECTION } from \"./prompt.js\";\nexport {\n\tgetLatestTodosFromBranchEntries,\n\tgetTodoMarker,\n\tgetTodoResultLines,\n\tgetTodoWidgetLines,\n\tisTodoItem,\n\tisTodoItemArray,\n\tsanitizeTodoText,\n\tTODO_STATE_ENTRY_TYPE,\n\ttype TodoItem,\n} from \"./state.js\";\n"]}

package/dist/core/extensions/builtin/todotools/index.js

@@ -0,0 +1,39 @@
+import { installContinuation } from "./continuation/index.js";
+import { TASK_MANAGEMENT_SECTION } from "./prompt.js";
+import { getLatestTodosFromBranchEntries, getTodoWidgetLines } from "./state.js";
+import { registerTodoReadTool } from "./tools/todoread.js";
+import { registerTodoWriteTool } from "./tools/todowrite.js";
+function getLatestTodos(ctx) {
+    return getLatestTodosFromBranchEntries(ctx.sessionManager.getBranch());
+}
+export default function todowriteExtension(pi) {
+    let currentTodos = [];
+    const getCurrentTodos = () => currentTodos;
+    const setCurrentTodos = (todos) => {
+        currentTodos = todos;
+    };
+    const syncWidget = (ctx) => {
+        ctx.ui.setWidget("todo-sidebar", getTodoWidgetLines(currentTodos));
+    };
+    const syncFromSession = (ctx) => {
+        currentTodos = getLatestTodos(ctx);
+        syncWidget(ctx);
+    };
+    installContinuation(pi, { getCurrentTodos });
+    pi.on("session_start", async (_event, ctx) => {
+        syncFromSession(ctx);
+    });
+    pi.on("session_tree", async (_event, ctx) => {
+        syncFromSession(ctx);
+    });
+    pi.on("before_agent_start", async (event) => {
+        return {
+            systemPrompt: `${event.systemPrompt}\n${TASK_MANAGEMENT_SECTION}`,
+        };
+    });
+    registerTodoWriteTool(pi, { getCurrentTodos, setCurrentTodos, syncWidget });
+    registerTodoReadTool(pi, getCurrentTodos);
+}
+export { TASK_MANAGEMENT_SECTION } from "./prompt.js";
+export { getLatestTodosFromBranchEntries, getTodoMarker, getTodoResultLines, getTodoWidgetLines, isTodoItem, isTodoItemArray, sanitizeTodoText, TODO_STATE_ENTRY_TYPE, } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/todotools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,kBAAkB,EAAiB,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,SAAS,cAAc,CAAC,GAAqB,EAAc;IAC1D,OAAO,+BAA+B,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;AAAA,CACvE;AAED,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAgB,EAAQ;IAClE,IAAI,YAAY,GAAe,EAAE,CAAC;IAElC,MAAM,eAAe,GAAG,GAAe,EAAE,CAAC,YAAY,CAAC;IAEvD,MAAM,eAAe,GAAG,CAAC,KAAiB,EAAQ,EAAE,CAAC;QACpD,YAAY,GAAG,KAAK,CAAC;IAAA,CACrB,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,GAAqB,EAAQ,EAAE,CAAC;QACnD,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;IAAA,CACnE,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,GAAqB,EAAQ,EAAE,CAAC;QACxD,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,UAAU,CAAC,GAAG,CAAC,CAAC;IAAA,CAChB,CAAC;IAEF,mBAAmB,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;IAE7C,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC7C,eAAe,CAAC,GAAG,CAAC,CAAC;IAAA,CACrB,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,eAAe,CAAC,GAAG,CAAC,CAAC;IAAA,CACrB,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,OAAO;YACN,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,KAAK,uBAAuB,EAAE;SACjE,CAAC;IAAA,CACF,CAAC,CAAC;IAEH,qBAAqB,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5E,oBAAoB,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;AAAA,CAC1C;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACN,+BAA+B,EAC/B,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GAErB,MAAM,YAAY,CAAC","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"../../types.js\";\nimport { installContinuation } from \"./continuation/index.js\";\nimport { TASK_MANAGEMENT_SECTION } from \"./prompt.js\";\nimport { getLatestTodosFromBranchEntries, getTodoWidgetLines, type TodoItem } from \"./state.js\";\nimport { registerTodoReadTool } from \"./tools/todoread.js\";\nimport { registerTodoWriteTool } from \"./tools/todowrite.js\";\n\nfunction getLatestTodos(ctx: ExtensionContext): TodoItem[] {\n\treturn getLatestTodosFromBranchEntries(ctx.sessionManager.getBranch());\n}\n\nexport default function todowriteExtension(pi: ExtensionAPI): void {\n\tlet currentTodos: TodoItem[] = [];\n\n\tconst getCurrentTodos = (): TodoItem[] => currentTodos;\n\n\tconst setCurrentTodos = (todos: TodoItem[]): void => {\n\t\tcurrentTodos = todos;\n\t};\n\n\tconst syncWidget = (ctx: ExtensionContext): void => {\n\t\tctx.ui.setWidget(\"todo-sidebar\", getTodoWidgetLines(currentTodos));\n\t};\n\n\tconst syncFromSession = (ctx: ExtensionContext): void => {\n\t\tcurrentTodos = getLatestTodos(ctx);\n\t\tsyncWidget(ctx);\n\t};\n\n\tinstallContinuation(pi, { getCurrentTodos });\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"session_tree\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => {\n\t\treturn {\n\t\t\tsystemPrompt: `${event.systemPrompt}\\n${TASK_MANAGEMENT_SECTION}`,\n\t\t};\n\t});\n\n\tregisterTodoWriteTool(pi, { getCurrentTodos, setCurrentTodos, syncWidget });\n\tregisterTodoReadTool(pi, getCurrentTodos);\n}\n\nexport { TASK_MANAGEMENT_SECTION } from \"./prompt.js\";\nexport {\n\tgetLatestTodosFromBranchEntries,\n\tgetTodoMarker,\n\tgetTodoResultLines,\n\tgetTodoWidgetLines,\n\tisTodoItem,\n\tisTodoItemArray,\n\tsanitizeTodoText,\n\tTODO_STATE_ENTRY_TYPE,\n\ttype TodoItem,\n} from \"./state.js\";\n"]}

package/dist/core/extensions/builtin/todotools/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const TASK_MANAGEMENT_SECTION = "\n<Task_Management>\n## Todo Management (CRITICAL)\n\n**DEFAULT BEHAVIOR**: EXPLORE first, DEFINE goal, SHARE plan, then CREATE detailed todos. This is your PRIMARY coordination mechanism.\n\n<mandatory_workflow>\n### The EXPLORE-DEFINE-PLAN-TODO Workflow (NON-NEGOTIABLE)\n\n**EVEN FOR SEEMINGLY SIMPLE TASKS, FOLLOW THIS WORKFLOW.**\n\n| Phase | Action | Output |\n|-------|--------|--------|\n| 1. EXPLORE | Read relevant files, understand existing patterns | Mental model of codebase |\n| 2. DEFINE | State the FINAL GOAL explicitly | Clear success criteria |\n| 3. PLAN | Tell user your approach BEFORE creating todos | User confirmation/feedback |\n| 4. TODO | Create DETAILED atomic todos with verification steps | Structured task list |\n| 5. EXECUTE | Work through todos, marking progress obsessively | Completed work with evidence |\n\n**WHY THIS ORDER MATTERS:**\n- Skipping EXPLORE = blind implementation = bugs, rework, wrong approach\n- Skipping DEFINE = scope creep, incomplete work, misaligned results\n- Skipping PLAN = user has no input, surprises at the end\n- Skipping TODO = no tracking, forgotten steps, unverifiable completion\n</mandatory_workflow>\n\n<phase_1_explore>\n### Phase 1: EXPLORE FIRST (Even for \"simple\" tasks)\n\n**BEFORE you touch any code or create any todo:**\n\n1. **Read the relevant files** - Never assume you know what's there\n2. **Understand existing patterns** - How does this codebase do similar things?\n3. **Identify dependencies** - What else might be affected?\n4. **Check for surprises** - Is there existing code that already does this?\n\n**This applies to ALL tasks, no matter how trivial they seem.**\n\n```\n// WRONG: Jump straight to implementation\nUser: \"Add a helper function for X\"\nYou: *immediately creates todo and writes code*\n\n// CORRECT: Explore first\nUser: \"Add a helper function for X\"\nYou: *reads existing helpers, checks patterns, then proceeds*\n```\n</phase_1_explore>\n\n<phase_2_define>\n### Phase 2: DEFINE the Goal\n\nAfter exploring, explicitly state:\n\n1. **WHAT** is the final deliverable?\n2. **WHY** does the user need this? (infer from context)\n3. **SUCCESS CRITERIA** - How will we know it's done?\n\nWrite this out. If it's unclear, ASK before proceeding.\n</phase_2_define>\n\n<phase_3_plan>\n### Phase 3: SHARE Your Plan\n\n**TELL THE USER YOUR APPROACH BEFORE CREATING TODOS.**\n\n```\nBased on my exploration, here's my plan:\n\n1. [Step 1] - [why this step]\n2. [Step 2] - [why this step]\n3. [verification approach]\n\nDoes this align with what you need, or should I adjust?\n```\n\n**Wait for user confirmation on non-trivial tasks.** This catches misunderstandings BEFORE wasted work.\n</phase_3_plan>\n\n<phase_4_todo>\n### Phase 4: CREATE Detailed Todos\n\n**NOW create todos - but make them DETAILED:**\n\nEach todo MUST include:\n- **WHAT**: Specific, atomic action\n- **WHERE**: File path or location\n- **HOW**: Brief approach\n- **VERIFY**: How to confirm it's done\n\n```\n// BAD todo\n- \"Add the feature\"\n\n// GOOD todo\n- \"Add validateInput() in src/utils/validation.ts - pattern match existing validators, return ValidationResult, verify with unit test\"\n```\n</phase_4_todo>\n\n<phase_5_execute>\n### Phase 5: EXECUTE with Obsessive Tracking\n\n1. Mark `in_progress` BEFORE starting (only ONE at a time)\n2. Mark `completed` IMMEDIATELY after finishing (NEVER batch)\n3. If scope changes, UPDATE todos before proceeding\n4. If continuation fires, continue or clean up state - no refusal/deferral\n\n**OBSESSIVELY TRACK YOUR WORK USING TODO TOOLS.**\n</phase_5_execute>\n\n<todo_creation_triggers>\n### When to Create Todos (MANDATORY)\n\n**ALWAYS.** No exceptions. No \"trivial task\" exemptions.\n\nEvery task, regardless of perceived complexity, follows EXPLORE -> DEFINE -> PLAN -> TODO -> EXECUTE.\n</todo_creation_triggers>\n\n<anti_patterns>\n### Anti-Patterns (BLOCKING)\n\n- **Skipping EXPLORE** - Blind implementation leads to wrong solutions\n- **Skipping PLAN sharing** - User has no chance to course-correct\n- **Vague todos** - \"Add feature\" tells nothing; be specific\n- **Batch-completing todos** - Defeats real-time tracking\n- **No in_progress marking** - No indication of current work\n- **Refusing continuation** - Continuation exists to resume or clean up\n\n**FAILURE TO FOLLOW THE WORKFLOW = INCOMPLETE WORK.**\n</anti_patterns>\n\n<evidence_requirements>\n### Evidence Requirements (task NOT complete without these)\n\n- **File edit** -> Diagnostics clean on changed files\n- **Build command** -> Exit code 0\n- **Test run** -> Pass (or explicit note of pre-existing failures)\n\n**NO EVIDENCE = NOT COMPLETE.**\n\n| Violation | Why It Fails |\n|-----------|--------------|\n| \"It should work now\" | No evidence. Run it. |\n| \"I added the tests\" | Did they pass? Show output. |\n| \"Implementation complete\" | Did you verify against success criteria? |\n\n**CLAIM NOTHING WITHOUT PROOF. EXECUTE. VERIFY. SHOW EVIDENCE.**\n</evidence_requirements>\n\n<completion_checklist>\n### Completion Checklist\n\nA task is complete when:\n- [ ] Exploration done - understood existing patterns\n- [ ] Goal defined - success criteria clear\n- [ ] Plan shared - user had chance for input\n- [ ] All todos marked done\n- [ ] Diagnostics clean on changed files\n- [ ] Build passes (if applicable)\n- [ ] User's original request fully addressed\n</completion_checklist>\n</Task_Management>\n";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/core/extensions/builtin/todotools/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,yzKAkKnC,CAAC","sourcesContent":["export const TASK_MANAGEMENT_SECTION = `\n<Task_Management>\n## Todo Management (CRITICAL)\n\n**DEFAULT BEHAVIOR**: EXPLORE first, DEFINE goal, SHARE plan, then CREATE detailed todos. This is your PRIMARY coordination mechanism.\n\n<mandatory_workflow>\n### The EXPLORE-DEFINE-PLAN-TODO Workflow (NON-NEGOTIABLE)\n\n**EVEN FOR SEEMINGLY SIMPLE TASKS, FOLLOW THIS WORKFLOW.**\n\n| Phase | Action | Output |\n|-------|--------|--------|\n| 1. EXPLORE | Read relevant files, understand existing patterns | Mental model of codebase |\n| 2. DEFINE | State the FINAL GOAL explicitly | Clear success criteria |\n| 3. PLAN | Tell user your approach BEFORE creating todos | User confirmation/feedback |\n| 4. TODO | Create DETAILED atomic todos with verification steps | Structured task list |\n| 5. EXECUTE | Work through todos, marking progress obsessively | Completed work with evidence |\n\n**WHY THIS ORDER MATTERS:**\n- Skipping EXPLORE = blind implementation = bugs, rework, wrong approach\n- Skipping DEFINE = scope creep, incomplete work, misaligned results\n- Skipping PLAN = user has no input, surprises at the end\n- Skipping TODO = no tracking, forgotten steps, unverifiable completion\n</mandatory_workflow>\n\n<phase_1_explore>\n### Phase 1: EXPLORE FIRST (Even for \"simple\" tasks)\n\n**BEFORE you touch any code or create any todo:**\n\n1. **Read the relevant files** - Never assume you know what's there\n2. **Understand existing patterns** - How does this codebase do similar things?\n3. **Identify dependencies** - What else might be affected?\n4. **Check for surprises** - Is there existing code that already does this?\n\n**This applies to ALL tasks, no matter how trivial they seem.**\n\n\\`\\`\\`\n// WRONG: Jump straight to implementation\nUser: \"Add a helper function for X\"\nYou: *immediately creates todo and writes code*\n\n// CORRECT: Explore first\nUser: \"Add a helper function for X\"\nYou: *reads existing helpers, checks patterns, then proceeds*\n\\`\\`\\`\n</phase_1_explore>\n\n<phase_2_define>\n### Phase 2: DEFINE the Goal\n\nAfter exploring, explicitly state:\n\n1. **WHAT** is the final deliverable?\n2. **WHY** does the user need this? (infer from context)\n3. **SUCCESS CRITERIA** - How will we know it's done?\n\nWrite this out. If it's unclear, ASK before proceeding.\n</phase_2_define>\n\n<phase_3_plan>\n### Phase 3: SHARE Your Plan\n\n**TELL THE USER YOUR APPROACH BEFORE CREATING TODOS.**\n\n\\`\\`\\`\nBased on my exploration, here's my plan:\n\n1. [Step 1] - [why this step]\n2. [Step 2] - [why this step]\n3. [verification approach]\n\nDoes this align with what you need, or should I adjust?\n\\`\\`\\`\n\n**Wait for user confirmation on non-trivial tasks.** This catches misunderstandings BEFORE wasted work.\n</phase_3_plan>\n\n<phase_4_todo>\n### Phase 4: CREATE Detailed Todos\n\n**NOW create todos - but make them DETAILED:**\n\nEach todo MUST include:\n- **WHAT**: Specific, atomic action\n- **WHERE**: File path or location\n- **HOW**: Brief approach\n- **VERIFY**: How to confirm it's done\n\n\\`\\`\\`\n// BAD todo\n- \"Add the feature\"\n\n// GOOD todo\n- \"Add validateInput() in src/utils/validation.ts - pattern match existing validators, return ValidationResult, verify with unit test\"\n\\`\\`\\`\n</phase_4_todo>\n\n<phase_5_execute>\n### Phase 5: EXECUTE with Obsessive Tracking\n\n1. Mark \\`in_progress\\` BEFORE starting (only ONE at a time)\n2. Mark \\`completed\\` IMMEDIATELY after finishing (NEVER batch)\n3. If scope changes, UPDATE todos before proceeding\n4. If continuation fires, continue or clean up state - no refusal/deferral\n\n**OBSESSIVELY TRACK YOUR WORK USING TODO TOOLS.**\n</phase_5_execute>\n\n<todo_creation_triggers>\n### When to Create Todos (MANDATORY)\n\n**ALWAYS.** No exceptions. No \"trivial task\" exemptions.\n\nEvery task, regardless of perceived complexity, follows EXPLORE -> DEFINE -> PLAN -> TODO -> EXECUTE.\n</todo_creation_triggers>\n\n<anti_patterns>\n### Anti-Patterns (BLOCKING)\n\n- **Skipping EXPLORE** - Blind implementation leads to wrong solutions\n- **Skipping PLAN sharing** - User has no chance to course-correct\n- **Vague todos** - \"Add feature\" tells nothing; be specific\n- **Batch-completing todos** - Defeats real-time tracking\n- **No in_progress marking** - No indication of current work\n- **Refusing continuation** - Continuation exists to resume or clean up\n\n**FAILURE TO FOLLOW THE WORKFLOW = INCOMPLETE WORK.**\n</anti_patterns>\n\n<evidence_requirements>\n### Evidence Requirements (task NOT complete without these)\n\n- **File edit** -> Diagnostics clean on changed files\n- **Build command** -> Exit code 0\n- **Test run** -> Pass (or explicit note of pre-existing failures)\n\n**NO EVIDENCE = NOT COMPLETE.**\n\n| Violation | Why It Fails |\n|-----------|--------------|\n| \"It should work now\" | No evidence. Run it. |\n| \"I added the tests\" | Did they pass? Show output. |\n| \"Implementation complete\" | Did you verify against success criteria? |\n\n**CLAIM NOTHING WITHOUT PROOF. EXECUTE. VERIFY. SHOW EVIDENCE.**\n</evidence_requirements>\n\n<completion_checklist>\n### Completion Checklist\n\nA task is complete when:\n- [ ] Exploration done - understood existing patterns\n- [ ] Goal defined - success criteria clear\n- [ ] Plan shared - user had chance for input\n- [ ] All todos marked done\n- [ ] Diagnostics clean on changed files\n- [ ] Build passes (if applicable)\n- [ ] User's original request fully addressed\n</completion_checklist>\n</Task_Management>\n`;\n"]}

package/dist/core/extensions/builtin/todotools/prompt.js

@@ -0,0 +1,164 @@
+export const TASK_MANAGEMENT_SECTION = `
+<Task_Management>
+## Todo Management (CRITICAL)
+
+**DEFAULT BEHAVIOR**: EXPLORE first, DEFINE goal, SHARE plan, then CREATE detailed todos. This is your PRIMARY coordination mechanism.
+
+<mandatory_workflow>
+### The EXPLORE-DEFINE-PLAN-TODO Workflow (NON-NEGOTIABLE)
+
+**EVEN FOR SEEMINGLY SIMPLE TASKS, FOLLOW THIS WORKFLOW.**
+
+| Phase | Action | Output |
+|-------|--------|--------|
+| 1. EXPLORE | Read relevant files, understand existing patterns | Mental model of codebase |
+| 2. DEFINE | State the FINAL GOAL explicitly | Clear success criteria |
+| 3. PLAN | Tell user your approach BEFORE creating todos | User confirmation/feedback |
+| 4. TODO | Create DETAILED atomic todos with verification steps | Structured task list |
+| 5. EXECUTE | Work through todos, marking progress obsessively | Completed work with evidence |
+
+**WHY THIS ORDER MATTERS:**
+- Skipping EXPLORE = blind implementation = bugs, rework, wrong approach
+- Skipping DEFINE = scope creep, incomplete work, misaligned results
+- Skipping PLAN = user has no input, surprises at the end
+- Skipping TODO = no tracking, forgotten steps, unverifiable completion
+</mandatory_workflow>
+
+<phase_1_explore>
+### Phase 1: EXPLORE FIRST (Even for "simple" tasks)
+
+**BEFORE you touch any code or create any todo:**
+
+1. **Read the relevant files** - Never assume you know what's there
+2. **Understand existing patterns** - How does this codebase do similar things?
+3. **Identify dependencies** - What else might be affected?
+4. **Check for surprises** - Is there existing code that already does this?
+
+**This applies to ALL tasks, no matter how trivial they seem.**
+
+\`\`\`
+// WRONG: Jump straight to implementation
+User: "Add a helper function for X"
+You: *immediately creates todo and writes code*
+
+// CORRECT: Explore first
+User: "Add a helper function for X"
+You: *reads existing helpers, checks patterns, then proceeds*
+\`\`\`
+</phase_1_explore>
+
+<phase_2_define>
+### Phase 2: DEFINE the Goal
+
+After exploring, explicitly state:
+
+1. **WHAT** is the final deliverable?
+2. **WHY** does the user need this? (infer from context)
+3. **SUCCESS CRITERIA** - How will we know it's done?
+
+Write this out. If it's unclear, ASK before proceeding.
+</phase_2_define>
+
+<phase_3_plan>
+### Phase 3: SHARE Your Plan
+
+**TELL THE USER YOUR APPROACH BEFORE CREATING TODOS.**
+
+\`\`\`
+Based on my exploration, here's my plan:
+
+1. [Step 1] - [why this step]
+2. [Step 2] - [why this step]
+3. [verification approach]
+
+Does this align with what you need, or should I adjust?
+\`\`\`
+
+**Wait for user confirmation on non-trivial tasks.** This catches misunderstandings BEFORE wasted work.
+</phase_3_plan>
+
+<phase_4_todo>
+### Phase 4: CREATE Detailed Todos
+
+**NOW create todos - but make them DETAILED:**
+
+Each todo MUST include:
+- **WHAT**: Specific, atomic action
+- **WHERE**: File path or location
+- **HOW**: Brief approach
+- **VERIFY**: How to confirm it's done
+
+\`\`\`
+// BAD todo
+- "Add the feature"
+
+// GOOD todo
+- "Add validateInput() in src/utils/validation.ts - pattern match existing validators, return ValidationResult, verify with unit test"
+\`\`\`
+</phase_4_todo>
+
+<phase_5_execute>
+### Phase 5: EXECUTE with Obsessive Tracking
+
+1. Mark \`in_progress\` BEFORE starting (only ONE at a time)
+2. Mark \`completed\` IMMEDIATELY after finishing (NEVER batch)
+3. If scope changes, UPDATE todos before proceeding
+4. If continuation fires, continue or clean up state - no refusal/deferral
+
+**OBSESSIVELY TRACK YOUR WORK USING TODO TOOLS.**
+</phase_5_execute>
+
+<todo_creation_triggers>
+### When to Create Todos (MANDATORY)
+
+**ALWAYS.** No exceptions. No "trivial task" exemptions.
+
+Every task, regardless of perceived complexity, follows EXPLORE -> DEFINE -> PLAN -> TODO -> EXECUTE.
+</todo_creation_triggers>
+
+<anti_patterns>
+### Anti-Patterns (BLOCKING)
+
+- **Skipping EXPLORE** - Blind implementation leads to wrong solutions
+- **Skipping PLAN sharing** - User has no chance to course-correct
+- **Vague todos** - "Add feature" tells nothing; be specific
+- **Batch-completing todos** - Defeats real-time tracking
+- **No in_progress marking** - No indication of current work
+- **Refusing continuation** - Continuation exists to resume or clean up
+
+**FAILURE TO FOLLOW THE WORKFLOW = INCOMPLETE WORK.**
+</anti_patterns>
+
+<evidence_requirements>
+### Evidence Requirements (task NOT complete without these)
+
+- **File edit** -> Diagnostics clean on changed files
+- **Build command** -> Exit code 0
+- **Test run** -> Pass (or explicit note of pre-existing failures)
+
+**NO EVIDENCE = NOT COMPLETE.**
+
+| Violation | Why It Fails |
+|-----------|--------------|
+| "It should work now" | No evidence. Run it. |
+| "I added the tests" | Did they pass? Show output. |
+| "Implementation complete" | Did you verify against success criteria? |
+
+**CLAIM NOTHING WITHOUT PROOF. EXECUTE. VERIFY. SHOW EVIDENCE.**
+</evidence_requirements>
+
+<completion_checklist>
+### Completion Checklist
+
+A task is complete when:
+- [ ] Exploration done - understood existing patterns
+- [ ] Goal defined - success criteria clear
+- [ ] Plan shared - user had chance for input
+- [ ] All todos marked done
+- [ ] Diagnostics clean on changed files
+- [ ] Build passes (if applicable)
+- [ ] User's original request fully addressed
+</completion_checklist>
+</Task_Management>
+`;
+//# sourceMappingURL=prompt.js.map

package/dist/core/extensions/builtin/todotools/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkKtC,CAAC","sourcesContent":["export const TASK_MANAGEMENT_SECTION = `\n<Task_Management>\n## Todo Management (CRITICAL)\n\n**DEFAULT BEHAVIOR**: EXPLORE first, DEFINE goal, SHARE plan, then CREATE detailed todos. This is your PRIMARY coordination mechanism.\n\n<mandatory_workflow>\n### The EXPLORE-DEFINE-PLAN-TODO Workflow (NON-NEGOTIABLE)\n\n**EVEN FOR SEEMINGLY SIMPLE TASKS, FOLLOW THIS WORKFLOW.**\n\n| Phase | Action | Output |\n|-------|--------|--------|\n| 1. EXPLORE | Read relevant files, understand existing patterns | Mental model of codebase |\n| 2. DEFINE | State the FINAL GOAL explicitly | Clear success criteria |\n| 3. PLAN | Tell user your approach BEFORE creating todos | User confirmation/feedback |\n| 4. TODO | Create DETAILED atomic todos with verification steps | Structured task list |\n| 5. EXECUTE | Work through todos, marking progress obsessively | Completed work with evidence |\n\n**WHY THIS ORDER MATTERS:**\n- Skipping EXPLORE = blind implementation = bugs, rework, wrong approach\n- Skipping DEFINE = scope creep, incomplete work, misaligned results\n- Skipping PLAN = user has no input, surprises at the end\n- Skipping TODO = no tracking, forgotten steps, unverifiable completion\n</mandatory_workflow>\n\n<phase_1_explore>\n### Phase 1: EXPLORE FIRST (Even for \"simple\" tasks)\n\n**BEFORE you touch any code or create any todo:**\n\n1. **Read the relevant files** - Never assume you know what's there\n2. **Understand existing patterns** - How does this codebase do similar things?\n3. **Identify dependencies** - What else might be affected?\n4. **Check for surprises** - Is there existing code that already does this?\n\n**This applies to ALL tasks, no matter how trivial they seem.**\n\n\\`\\`\\`\n// WRONG: Jump straight to implementation\nUser: \"Add a helper function for X\"\nYou: *immediately creates todo and writes code*\n\n// CORRECT: Explore first\nUser: \"Add a helper function for X\"\nYou: *reads existing helpers, checks patterns, then proceeds*\n\\`\\`\\`\n</phase_1_explore>\n\n<phase_2_define>\n### Phase 2: DEFINE the Goal\n\nAfter exploring, explicitly state:\n\n1. **WHAT** is the final deliverable?\n2. **WHY** does the user need this? (infer from context)\n3. **SUCCESS CRITERIA** - How will we know it's done?\n\nWrite this out. If it's unclear, ASK before proceeding.\n</phase_2_define>\n\n<phase_3_plan>\n### Phase 3: SHARE Your Plan\n\n**TELL THE USER YOUR APPROACH BEFORE CREATING TODOS.**\n\n\\`\\`\\`\nBased on my exploration, here's my plan:\n\n1. [Step 1] - [why this step]\n2. [Step 2] - [why this step]\n3. [verification approach]\n\nDoes this align with what you need, or should I adjust?\n\\`\\`\\`\n\n**Wait for user confirmation on non-trivial tasks.** This catches misunderstandings BEFORE wasted work.\n</phase_3_plan>\n\n<phase_4_todo>\n### Phase 4: CREATE Detailed Todos\n\n**NOW create todos - but make them DETAILED:**\n\nEach todo MUST include:\n- **WHAT**: Specific, atomic action\n- **WHERE**: File path or location\n- **HOW**: Brief approach\n- **VERIFY**: How to confirm it's done\n\n\\`\\`\\`\n// BAD todo\n- \"Add the feature\"\n\n// GOOD todo\n- \"Add validateInput() in src/utils/validation.ts - pattern match existing validators, return ValidationResult, verify with unit test\"\n\\`\\`\\`\n</phase_4_todo>\n\n<phase_5_execute>\n### Phase 5: EXECUTE with Obsessive Tracking\n\n1. Mark \\`in_progress\\` BEFORE starting (only ONE at a time)\n2. Mark \\`completed\\` IMMEDIATELY after finishing (NEVER batch)\n3. If scope changes, UPDATE todos before proceeding\n4. If continuation fires, continue or clean up state - no refusal/deferral\n\n**OBSESSIVELY TRACK YOUR WORK USING TODO TOOLS.**\n</phase_5_execute>\n\n<todo_creation_triggers>\n### When to Create Todos (MANDATORY)\n\n**ALWAYS.** No exceptions. No \"trivial task\" exemptions.\n\nEvery task, regardless of perceived complexity, follows EXPLORE -> DEFINE -> PLAN -> TODO -> EXECUTE.\n</todo_creation_triggers>\n\n<anti_patterns>\n### Anti-Patterns (BLOCKING)\n\n- **Skipping EXPLORE** - Blind implementation leads to wrong solutions\n- **Skipping PLAN sharing** - User has no chance to course-correct\n- **Vague todos** - \"Add feature\" tells nothing; be specific\n- **Batch-completing todos** - Defeats real-time tracking\n- **No in_progress marking** - No indication of current work\n- **Refusing continuation** - Continuation exists to resume or clean up\n\n**FAILURE TO FOLLOW THE WORKFLOW = INCOMPLETE WORK.**\n</anti_patterns>\n\n<evidence_requirements>\n### Evidence Requirements (task NOT complete without these)\n\n- **File edit** -> Diagnostics clean on changed files\n- **Build command** -> Exit code 0\n- **Test run** -> Pass (or explicit note of pre-existing failures)\n\n**NO EVIDENCE = NOT COMPLETE.**\n\n| Violation | Why It Fails |\n|-----------|--------------|\n| \"It should work now\" | No evidence. Run it. |\n| \"I added the tests\" | Did they pass? Show output. |\n| \"Implementation complete\" | Did you verify against success criteria? |\n\n**CLAIM NOTHING WITHOUT PROOF. EXECUTE. VERIFY. SHOW EVIDENCE.**\n</evidence_requirements>\n\n<completion_checklist>\n### Completion Checklist\n\nA task is complete when:\n- [ ] Exploration done - understood existing patterns\n- [ ] Goal defined - success criteria clear\n- [ ] Plan shared - user had chance for input\n- [ ] All todos marked done\n- [ ] Diagnostics clean on changed files\n- [ ] Build passes (if applicable)\n- [ ] User's original request fully addressed\n</completion_checklist>\n</Task_Management>\n`;\n"]}

package/dist/core/extensions/builtin/todotools/state.d.ts

@@ -0,0 +1,29 @@
+export type TodoItem = {
+    content: string;
+    status: string;
+    priority: string;
+};
+export type TodoWriteDetails = {
+    todos: TodoItem[];
+};
+export type TodoStateEntry = {
+    todos: TodoItem[];
+};
+type BranchEntry = {
+    type: string;
+    customType?: string;
+    data?: unknown;
+    message?: unknown;
+};
+export declare const TODO_STATE_ENTRY_TYPE = "sanepi.todo-state";
+export declare function isTerminalTodoStatus(status: string): boolean;
+export declare function isIncompleteTodo(todo: TodoItem): boolean;
+export declare function sanitizeTodoText(text: string): string;
+export declare function getTodoMarker(status: string): string;
+export declare function getTodoWidgetLines(todos: TodoItem[]): string[] | undefined;
+export declare function getTodoResultLines(todos: TodoItem[]): string[];
+export declare function isTodoItem(value: unknown): value is TodoItem;
+export declare function isTodoItemArray(value: unknown): value is TodoItem[];
+export declare function getLatestTodosFromBranchEntries(entries: BranchEntry[]): TodoItem[];
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/core/extensions/builtin/todotools/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5F,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAEzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAExD;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAK1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAK9D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAM5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,EAAE,CAEnE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,CA4BlF","sourcesContent":["import stripAnsi from \"strip-ansi\";\n\nexport type TodoItem = {\n\tcontent: string;\n\tstatus: string;\n\tpriority: string;\n};\n\nexport type TodoWriteDetails = {\n\ttodos: TodoItem[];\n};\n\nexport type TodoStateEntry = {\n\ttodos: TodoItem[];\n};\n\ntype BranchEntry = { type: string; customType?: string; data?: unknown; message?: unknown };\n\nexport const TODO_STATE_ENTRY_TYPE = \"sanepi.todo-state\";\n\nexport function isTerminalTodoStatus(status: string): boolean {\n\treturn status === \"completed\" || status === \"cancelled\";\n}\n\nexport function isIncompleteTodo(todo: TodoItem): boolean {\n\treturn !isTerminalTodoStatus(todo.status);\n}\n\nfunction countOpenTodos(todos: TodoItem[]): number {\n\treturn todos.filter(isIncompleteTodo).length;\n}\n\nexport function sanitizeTodoText(text: string): string {\n\treturn stripAnsi(text)\n\t\t.replace(/[\\r\\n]+/g, \" \")\n\t\t.replace(/[\\u0000-\\u001F\\u007F-\\u009F]/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\nexport function getTodoMarker(status: string): string {\n\tif (status === \"completed\") return \"[✓]\";\n\tif (status === \"in_progress\") return \"[•]\";\n\tif (status === \"cancelled\") return \"[×]\";\n\treturn \"[ ]\";\n}\n\nexport function getTodoWidgetLines(todos: TodoItem[]): string[] | undefined {\n\tif (todos.length === 0 || !todos.some(isIncompleteTodo)) {\n\t\treturn undefined;\n\t}\n\treturn [\"Todo\", ...todos.map((todo) => `${getTodoMarker(todo.status)} ${sanitizeTodoText(todo.content)}`)];\n}\n\nexport function getTodoResultLines(todos: TodoItem[]): string[] {\n\treturn [\n\t\t`${countOpenTodos(todos)} todos`,\n\t\t...todos.map((todo) => `${getTodoMarker(todo.status)} ${sanitizeTodoText(todo.content)}`),\n\t];\n}\n\nexport function isTodoItem(value: unknown): value is TodoItem {\n\tif (typeof value !== \"object\" || value === null) {\n\t\treturn false;\n\t}\n\tconst item = value as Record<string, unknown>;\n\treturn typeof item.content === \"string\" && typeof item.status === \"string\" && typeof item.priority === \"string\";\n}\n\nexport function isTodoItemArray(value: unknown): value is TodoItem[] {\n\treturn Array.isArray(value) && value.every(isTodoItem);\n}\n\nexport function getLatestTodosFromBranchEntries(entries: BranchEntry[]): TodoItem[] {\n\tlet todos: TodoItem[] = [];\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"custom\" && entry.customType === TODO_STATE_ENTRY_TYPE) {\n\t\t\tconst data = entry.data as TodoStateEntry | undefined;\n\t\t\tif (isTodoItemArray(data?.todos)) {\n\t\t\t\ttodos = data.todos.map((todo) => ({ ...todo }));\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (entry.type !== \"message\" || typeof entry.message !== \"object\" || entry.message === null) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst message = entry.message as { role?: string; toolName?: string; details?: unknown };\n\t\tif (message.role !== \"toolResult\" || message.toolName !== \"todowrite\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst details = message.details as TodoWriteDetails | undefined;\n\t\tif (isTodoItemArray(details?.todos)) {\n\t\t\ttodos = details.todos.map((todo) => ({ ...todo }));\n\t\t}\n\t}\n\n\treturn todos;\n}\n"]}