@code-yeongyu/senpi 2026.7.17 → 2026.7.20-2

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

@@ -0,0 +1,82 @@
+// Markdown round-trip for the phased todo model.
+//
+// Ported and adapted from oh-my-pi's `packages/coding-agent/src/tools/todo.ts`
+// (MIT — see NOTICE.md). Phases render as `# <name>` headings and tasks as
+// checklist rows whose marker encodes status: `[ ]` pending, `[/]` in_progress,
+// `[x]` completed, `[-]` abandoned.
+import { isAbsolute, resolve } from "node:path";
+import { DEFAULT_INIT_PHASE, normalizeInProgressTask } from "./state.js";
+const STATUS_TO_MARKER = {
+    pending: " ",
+    in_progress: "/",
+    completed: "x",
+    abandoned: "-",
+};
+const MARKER_TO_STATUS = {
+    " ": "pending",
+    "": "pending",
+    x: "completed",
+    X: "completed",
+    "/": "in_progress",
+    ">": "in_progress",
+    "-": "abandoned",
+    "~": "abandoned",
+};
+/** Default file name for `/todo export` and `/todo import`. */
+export const DEFAULT_TODO_MARKDOWN_FILE = "TODO.md";
+/** Resolve a user-supplied path argument against cwd; empty input → TODO.md. */
+export function resolveTodoMarkdownPath(input, cwd) {
+    const raw = input.trim().replace(/^["']|["']$/g, "") || DEFAULT_TODO_MARKDOWN_FILE;
+    return isAbsolute(raw) ? raw : resolve(cwd, raw);
+}
+/** Render todo phases as a Markdown checklist suitable for editing/copying. */
+export function phasesToMarkdown(phases) {
+    if (phases.length === 0)
+        return `# ${DEFAULT_INIT_PHASE}\n`;
+    const out = [];
+    for (let index = 0; index < phases.length; index += 1) {
+        if (index > 0)
+            out.push("");
+        out.push(`# ${phases[index].name}`);
+        for (const task of phases[index].tasks) {
+            out.push(`- [${STATUS_TO_MARKER[task.status]}] ${task.content}`);
+        }
+    }
+    return `${out.join("\n")}\n`;
+}
+/** Parse a Markdown checklist back into todo phases. */
+export function markdownToPhases(markdown) {
+    const errors = [];
+    const phases = [];
+    let currentPhase;
+    const lines = markdown.split(/\r?\n/);
+    for (let lineNumber = 0; lineNumber < lines.length; lineNumber += 1) {
+        const trimmed = lines[lineNumber].trim();
+        if (!trimmed)
+            continue;
+        const headingMatch = /^#{1,6}\s+(.+?)\s*$/.exec(trimmed);
+        if (headingMatch) {
+            currentPhase = { name: headingMatch[1].trim(), tasks: [] };
+            phases.push(currentPhase);
+            continue;
+        }
+        const taskMatch = /^[-*+]\s*\[(.?)\]\s+(.+?)\s*$/.exec(trimmed);
+        if (taskMatch) {
+            if (!currentPhase) {
+                currentPhase = { name: DEFAULT_INIT_PHASE, tasks: [] };
+                phases.push(currentPhase);
+            }
+            const status = MARKER_TO_STATUS[taskMatch[1]];
+            if (!status) {
+                errors.push(`Line ${lineNumber + 1}: unknown status marker "[${taskMatch[1]}]" (use [ ], [x], [/], [-])`);
+                continue;
+            }
+            currentPhase.tasks.push({ content: taskMatch[2].trim(), status });
+            continue;
+        }
+        errors.push(`Line ${lineNumber + 1}: unrecognized syntax "${trimmed}"`);
+    }
+    normalizeInProgressTask(phases);
+    return { phases, errors };
+}
+//# sourceMappingURL=markdown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/markdown.ts"],"names":[],"mappings":"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","sourcesContent":["// Markdown round-trip for the phased todo model.\n//\n// Ported and adapted from oh-my-pi's `packages/coding-agent/src/tools/todo.ts`\n// (MIT — see NOTICE.md). Phases render as `# <name>` headings and tasks as\n// checklist rows whose marker encodes status: `[ ]` pending, `[/]` in_progress,\n// `[x]` completed, `[-]` abandoned.\n\nimport { isAbsolute, resolve } from \"node:path\";\nimport { DEFAULT_INIT_PHASE, normalizeInProgressTask, type TodoPhase, type TodoStatus } from \"./state.ts\";\n\nconst STATUS_TO_MARKER: Record<TodoStatus, string> = {\n\tpending: \" \",\n\tin_progress: \"/\",\n\tcompleted: \"x\",\n\tabandoned: \"-\",\n};\n\nconst MARKER_TO_STATUS: Record<string, TodoStatus> = {\n\t\" \": \"pending\",\n\t\"\": \"pending\",\n\tx: \"completed\",\n\tX: \"completed\",\n\t\"/\": \"in_progress\",\n\t\">\": \"in_progress\",\n\t\"-\": \"abandoned\",\n\t\"~\": \"abandoned\",\n};\n\n/** Default file name for `/todo export` and `/todo import`. */\nexport const DEFAULT_TODO_MARKDOWN_FILE = \"TODO.md\";\n\n/** Resolve a user-supplied path argument against cwd; empty input → TODO.md. */\nexport function resolveTodoMarkdownPath(input: string, cwd: string): string {\n\tconst raw = input.trim().replace(/^[\"']|[\"']$/g, \"\") || DEFAULT_TODO_MARKDOWN_FILE;\n\treturn isAbsolute(raw) ? raw : resolve(cwd, raw);\n}\n\n/** Render todo phases as a Markdown checklist suitable for editing/copying. */\nexport function phasesToMarkdown(phases: readonly TodoPhase[]): string {\n\tif (phases.length === 0) return `# ${DEFAULT_INIT_PHASE}\\n`;\n\tconst out: string[] = [];\n\tfor (let index = 0; index < phases.length; index += 1) {\n\t\tif (index > 0) out.push(\"\");\n\t\tout.push(`# ${phases[index].name}`);\n\t\tfor (const task of phases[index].tasks) {\n\t\t\tout.push(`- [${STATUS_TO_MARKER[task.status]}] ${task.content}`);\n\t\t}\n\t}\n\treturn `${out.join(\"\\n\")}\\n`;\n}\n\n/** Parse a Markdown checklist back into todo phases. */\nexport function markdownToPhases(markdown: string): { phases: TodoPhase[]; errors: string[] } {\n\tconst errors: string[] = [];\n\tconst phases: TodoPhase[] = [];\n\tlet currentPhase: TodoPhase | undefined;\n\n\tconst lines = markdown.split(/\\r?\\n/);\n\tfor (let lineNumber = 0; lineNumber < lines.length; lineNumber += 1) {\n\t\tconst trimmed = lines[lineNumber].trim();\n\t\tif (!trimmed) continue;\n\n\t\tconst headingMatch = /^#{1,6}\\s+(.+?)\\s*$/.exec(trimmed);\n\t\tif (headingMatch) {\n\t\t\tcurrentPhase = { name: headingMatch[1].trim(), tasks: [] };\n\t\t\tphases.push(currentPhase);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst taskMatch = /^[-*+]\\s*\\[(.?)\\]\\s+(.+?)\\s*$/.exec(trimmed);\n\t\tif (taskMatch) {\n\t\t\tif (!currentPhase) {\n\t\t\t\tcurrentPhase = { name: DEFAULT_INIT_PHASE, tasks: [] };\n\t\t\t\tphases.push(currentPhase);\n\t\t\t}\n\t\t\tconst status = MARKER_TO_STATUS[taskMatch[1]];\n\t\t\tif (!status) {\n\t\t\t\terrors.push(`Line ${lineNumber + 1}: unknown status marker \"[${taskMatch[1]}]\" (use [ ], [x], [/], [-])`);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tcurrentPhase.tasks.push({ content: taskMatch[2].trim(), status });\n\t\t\tcontinue;\n\t\t}\n\n\t\terrors.push(`Line ${lineNumber + 1}: unrecognized syntax \"${trimmed}\"`);\n\t}\n\n\tnormalizeInProgressTask(phases);\n\treturn { phases, errors };\n}\n"]}

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

@@ -1,2 +1,3 @@
-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\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\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";
+export declare const TODO_TOOL_DESCRIPTION = "**Tasks referenced by verbatim content string, NEVER an auto-generated ID \u2014 no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase \u2014 expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase, items: string[] | Append tasks to phase; lazily creates phase |\n| view | \u2014 | Read-only: echo list |\n\n## Anatomy\n- **Task content**: 5\u201310 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing. Complete phases in order.\n- NEVER make a todo call your turn's only tool call \u2014 batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced.\n- Lost the exact task text? view echoes the list \u2014 NEVER guess from memory.\n\n## When to create a list\n- Task requires 3+ distinct steps\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task \u2014 capture before proceeding\n\n<critical>\nUser hands you a multi-step plan \u2014 phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>";
+export declare const TASK_MANAGEMENT_SECTION = "\n<Task_Management>\n## Todo Management (CRITICAL)\n\nUse the todo tool for multi-step work. It is one operation at a time: initialize a phased list, then start, complete, abandon, append, remove, or view tasks by their exact content. The earliest open task auto-promotes after each completion.\n\n**Tasks referenced by verbatim content string, NEVER an auto-generated ID \u2014 no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase \u2014 expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase, items: string[] | Append tasks to phase; lazily creates phase |\n| view | \u2014 | Read-only: echo list |\n\n## Anatomy\n- **Task content**: 5\u201310 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing. Complete phases in order.\n- NEVER make a todo call your turn's only tool call \u2014 batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced.\n- Lost the exact task text? view echoes the list \u2014 NEVER guess from memory.\n\n## When to create a list\n- Task requires 3+ distinct steps\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task \u2014 capture before proceeding\n\n<critical>\nUser hands you a multi-step plan \u2014 phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>\n\n## Evidence\n- File edit: inspect the changed files and diagnostics.\n- Build command: require exit code 0.\n- Test run: require passing output, or state the pre-existing failure.\n</Task_Management>\n";
 //# sourceMappingURL=prompt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,oqKAgKnC,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,6mEAuCtB,CAAC;AAEb,eAAO,MAAM,uBAAuB,omFAanC,CAAC"}

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

@@ -1,162 +1,59 @@
+// Adapted from oh-my-pi's todo prompt (MIT License).
+// Copyright (c) 2025 Mario Zechner
+// Copyright (c) 2025-2026 Can Bölük
+// https://github.com/can1357/oh-my-pi
+export const TODO_TOOL_DESCRIPTION = `**Tasks referenced by verbatim content string, NEVER an auto-generated ID — no "task-1"/"task-N" exists. Pass the content text in the task field.**
+
+On each completion the earliest still-open task (in phase order) auto-promotes to in_progress.
+Completing tasks out of phase order can move this pointer **back** to an earlier phase — expected; completed tasks are never reverted.
+
+## Operations
+
+| op | Required fields | Effect |
+|---|---|---|
+| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |
+| init | items: string[] | Flattened single-phase init |
+| start | task | Mark in progress |
+| done | task or phase | Mark completed |
+| drop | task or phase | Mark abandoned |
+| rm | task or phase (optional) | Remove task or phase; omit both to clear |
+| append | phase, items: string[] | Append tasks to phase; lazily creates phase |
+| view | — | Read-only: echo list |
+
+## Anatomy
+- **Task content**: 5–10 words; what, not how. Unique identifier.
+- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.
+
+## Rules
+- Mark tasks done immediately after finishing. Complete phases in order.
+- NEVER make a todo call your turn's only tool call — batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.
+- Blocked? append a task to the active phase, or drop.
+- Keep task/phase strings stable once introduced.
+- Lost the exact task text? view echoes the list — NEVER guess from memory.
+
+## When to create a list
+- Task requires 3+ distinct steps
+- User explicitly requests one
+- User provides a set of tasks
+- New instructions arrive mid-task — capture before proceeding
+
+<critical>
+User hands you a multi-step plan — phased todo, numbered/bulleted checklist, or "N bugs/items/tasks":
+- You MUST init the list with EVERY item as its own task before working.
+- Enumerate all; NEVER summarize into fewer tasks, sample "the important ones", drop items, or track the rest from memory.
+</critical>`;
 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.
+Use the todo tool for multi-step work. It is one operation at a time: initialize a phased list, then start, complete, abandon, append, remove, or view tasks by their exact content. The earliest open task auto-promotes after each completion.
 
-<mandatory_workflow>
-### The EXPLORE-DEFINE-PLAN-TODO Workflow (NON-NEGOTIABLE)
+${TODO_TOOL_DESCRIPTION}
 
-**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
-
-**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
-
-**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>
+## Evidence
+- File edit: inspect the changed files and diagnostics.
+- Build command: require exit code 0.
+- Test run: require passing output, or state the pre-existing failure.
 </Task_Management>
 `;
 //# sourceMappingURL=prompt.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKtC,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\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\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"]}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAAmC;AACnC,oCAAoC;AACpC,sCAAsC;AAEtC,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAuCzB,CAAC;AAEb,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;EAMrC,qBAAqB;;;;;;;CAOtB,CAAC","sourcesContent":["// Adapted from oh-my-pi's todo prompt (MIT License).\n// Copyright (c) 2025 Mario Zechner\n// Copyright (c) 2025-2026 Can Bölük\n// https://github.com/can1357/oh-my-pi\n\nexport const TODO_TOOL_DESCRIPTION = `**Tasks referenced by verbatim content string, NEVER an auto-generated ID — no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase — expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase, items: string[] | Append tasks to phase; lazily creates phase |\n| view | — | Read-only: echo list |\n\n## Anatomy\n- **Task content**: 5–10 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing. Complete phases in order.\n- NEVER make a todo call your turn's only tool call — batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced.\n- Lost the exact task text? view echoes the list — NEVER guess from memory.\n\n## When to create a list\n- Task requires 3+ distinct steps\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task — capture before proceeding\n\n<critical>\nUser hands you a multi-step plan — phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>`;\n\nexport const TASK_MANAGEMENT_SECTION = `\n<Task_Management>\n## Todo Management (CRITICAL)\n\nUse the todo tool for multi-step work. It is one operation at a time: initialize a phased list, then start, complete, abandon, append, remove, or view tasks by their exact content. The earliest open task auto-promotes after each completion.\n\n${TODO_TOOL_DESCRIPTION}\n\n## Evidence\n- File edit: inspect the changed files and diagnostics.\n- Build command: require exit code 0.\n- Test run: require passing output, or state the pre-existing failure.\n</Task_Management>\n`;\n"]}

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

@@ -1,29 +1,82 @@
+import type { SessionEntry } from "../../../session-manager.ts";
+export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned";
+export type TodoOperation = "init" | "start" | "done" | "rm" | "drop" | "append" | "view";
 export type TodoItem = {
     content: string;
-    status: string;
-    priority: string;
+    status: TodoStatus;
 };
-export type TodoWriteDetails = {
-    todos: TodoItem[];
+export type TodoPhase = {
+    name: string;
+    tasks: TodoItem[];
 };
-export type TodoStateEntry = {
-    todos: TodoItem[];
+export type TodoCompletionTransition = {
+    phase: string;
+    content: string;
+};
+export type TodoToolDetails = {
+    op?: TodoOperation;
+    phases: TodoPhase[];
+    storage: "session" | "memory";
+    completedTasks?: TodoCompletionTransition[];
 };
-type BranchEntry = {
-    type: string;
-    customType?: string;
-    data?: unknown;
-    message?: unknown;
+export type TodoStateEntry = {
+    schema: "v2";
+    phases: TodoPhase[];
 };
 export declare const TODO_STATE_ENTRY_TYPE = "senpi.todo-state";
+export declare const DEFAULT_INIT_PHASE = "Tasks";
+type TodoPhaseInput = {
+    phase: string;
+    items: string[];
+};
+export type TodoOpEntry = {
+    op: TodoOperation;
+    list?: TodoPhaseInput[];
+    task?: string;
+    phase?: string;
+    items?: string[];
+};
+type TaskHit = {
+    task: TodoItem;
+    phase: TodoPhase;
+};
+type BranchEntry = SessionEntry;
+export declare function findTaskByContent(phases: TodoPhase[], content: string): TaskHit | undefined;
+export declare function findPhaseByName(phases: TodoPhase[], name: string): TodoPhase | undefined;
+export declare function cloneTask(task: TodoItem): TodoItem;
+export declare function clonePhases(phases: readonly TodoPhase[]): TodoPhase[];
+export declare function normalizeInProgressTask(phases: TodoPhase[]): void;
+/** Return the active task, preferring an in-progress item over the first pending item. */
+export declare function nextActionableTask(phases: readonly TodoPhase[]): TodoItem | undefined;
+export declare function getCompletionTransitions(previous: readonly TodoPhase[], updated: readonly TodoPhase[]): TodoCompletionTransition[];
+export declare function resolveTaskOrError(phases: TodoPhase[], content: string | undefined, errors: string[]): TaskHit | undefined;
+export declare function resolvePhaseOrError(phases: TodoPhase[], name: string | undefined, errors: string[]): TodoPhase | undefined;
+export declare function getTaskTargets(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoItem[];
+export declare function initPhases(entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function appendItems(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function removeTasks(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function applyEntry(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function applyParams(phases: TodoPhase[], params: TodoOpEntry): {
+    phases: TodoPhase[];
+    errors: string[];
+};
+export declare function applyOpsToPhases(currentPhases: readonly TodoPhase[], ops: readonly TodoOpEntry[]): {
+    phases: TodoPhase[];
+    errors: string[];
+};
+export declare function formatSummary(phases: readonly TodoPhase[], errors: readonly string[], readOnly?: boolean): string;
+export declare function sanitizeTodoText(text: string): string;
 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 getTodoWidgetLines(phases: readonly TodoPhase[]): string[] | undefined;
+export declare function getTodoResultLines(phases: readonly TodoPhase[]): string[];
 export declare function isTodoItem(value: unknown): value is TodoItem;
 export declare function isTodoItemArray(value: unknown): value is TodoItem[];
+export declare function isTodoPhase(value: unknown): value is TodoPhase;
+export declare function isTodoPhaseArray(value: unknown): value is TodoPhase[];
+export declare function getLatestPhasesFromBranchEntries(entries: BranchEntry[]): TodoPhase[];
+/** Compatibility reader for callers that still expect the old flat array. */
 export declare function getLatestTodosFromBranchEntries(entries: BranchEntry[]): TodoItem[];
 export {};
 //# sourceMappingURL=state.d.ts.map

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

@@ -1 +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,qBAAqB,CAAC;AAExD,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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"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"}