mastracode 0.18.0-alpha.8 → 0.18.0-alpha.9

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # mastracode
 
+## 0.18.0-alpha.9
+
+### Minor Changes
+
+- Improved MastraCode task tracking so agents keep stable task IDs in prompts and update one task at a time while working. ([#16254](https://github.com/mastra-ai/mastra/pull/16254))
+
+  MastraCode now preserves Harness task IDs in state, includes those IDs in the current task list prompt, and replays structured task snapshots from full thread history when a thread reloads. The TUI keeps successful task updates quiet, shows task-tool failures inline, avoids duplicate completed-task summaries, and restores replayed tasks through the Harness display-state API.
+
+  MastraCode also documents the structured `task_check` result fields in agent guidance and keeps streaming `task_write` input typed separately from normalized task state.
+
+### Patch Changes
+
+- Updated dependencies [[`6742347`](https://github.com/mastra-ai/mastra/commit/6742347d71955d7639adc9ddf6ff8282de7ee3ba), [`7b0ad1f`](https://github.com/mastra-ai/mastra/commit/7b0ad1f5c53dc118c6da12ae82ae2587037dc2b8), [`62666c3`](https://github.com/mastra-ai/mastra/commit/62666c367eaeac3941ead454b1d38810cc855721), [`4af2160`](https://github.com/mastra-ai/mastra/commit/4af2160322f4718cac421930cce85641e9512389), [`b2fd6be`](https://github.com/mastra-ai/mastra/commit/b2fd6beef989f5e463c9a33d8a6c20ac1800e011), [`136c959`](https://github.com/mastra-ai/mastra/commit/136c9592fb0eeb0cd212f28629d8a29b7557a2fc), [`00106be`](https://github.com/mastra-ai/mastra/commit/00106bede59b81e5b0e9cd6aad8d3b5dbc336387), [`4df7cc7`](https://github.com/mastra-ai/mastra/commit/4df7cc79342fd065fe7fdeef93c094db14b12bcd), [`aca3121`](https://github.com/mastra-ai/mastra/commit/aca31211233dac25459f140ea4fcfb3a5af64c18), [`7b0ad1f`](https://github.com/mastra-ai/mastra/commit/7b0ad1f5c53dc118c6da12ae82ae2587037dc2b8), [`9cdf38e`](https://github.com/mastra-ai/mastra/commit/9cdf38e58506e1109c8b38f97cd7770978a4218e), [`990851e`](https://github.com/mastra-ai/mastra/commit/990851edcb0e30be5c2c18b6532f1a876cc2d335), [`6068a6c`](https://github.com/mastra-ai/mastra/commit/6068a6c42950fad3ebfc92346417896ba60803d2), [`00106be`](https://github.com/mastra-ai/mastra/commit/00106bede59b81e5b0e9cd6aad8d3b5dbc336387), [`e2a079c`](https://github.com/mastra-ai/mastra/commit/e2a079cc3755b1895f7bd5dc36e9be81b11c7c22), [`f70160c`](https://github.com/mastra-ai/mastra/commit/f70160c53c366e71e1d8dde2c6aeaf1b62fb77e6), [`534a456`](https://github.com/mastra-ai/mastra/commit/534a456a25e4df1e5407e7e632f4cb3b1fa14f9d), [`36bae07`](https://github.com/mastra-ai/mastra/commit/36bae07c0e70b1b3006f2fd20830e8883dcbd066)]:
+  - @mastra/core@1.33.0-alpha.7
+  - @mastra/libsql@1.10.1-alpha.1
+  - @mastra/observability@1.12.0-alpha.1
+  - @mastra/memory@1.18.0-alpha.2
+
 ## 0.18.0-alpha.8
 
 ### Patch Changes

package/dist/agents/prompts/build.d.ts

@@ -8,5 +8,5 @@ import type { PromptContext } from './index.js';
  * knows exactly what to implement.
  */
 export declare function buildModePromptFn(ctx: PromptContext): string;
-export declare const buildModePrompt = "\n# Build Mode\n\nYou are in BUILD mode. You have full access to all tools and can read, write, edit, and execute commands.\n\n## Working Style\n\n**For simple tasks** (typo fixes, small edits, single-file changes):\n- Just do it. No need to explain your plan first.\n\n**For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):\n- Use task_write to track your steps\n- Work on ONE step at a time \u2014 complete it and verify it works before moving on\n- If multiple approaches are plausible and the choice would materially affect scope, behavior, or risk, stop and ask the user\n\n## The Implementation Loop\n\nFor each change you make:\n\n1. **Understand** \u2014 Read the relevant code. Check how similar things are done elsewhere.\n2. **Implement** \u2014 Make the change. Follow existing patterns and conventions.\n3. **Verify** \u2014 Test that it works. Don't assume \u2014 actually run it.\n4. **Prove** \u2014 Proactively prove that the change is good, makes sense in context, is a positive contribution, and works fully. The burden of proof is on YOU.\n5. **Clean up** \u2014 Ensure no broken code, no debug statements, no half-done features.\n\nOnly move to the next change after the current one is verified and proved to be working.\n\n## Verification is Required\n\nBefore considering any task complete:\n- Run relevant tests (check package.json for test scripts)\n- For TypeScript, run `tsc --noEmit` to catch type errors\n- If there are no automated tests, manually verify the behavior works as expected\n- Confirm the result makes sense in the codebase and improves the requested behavior\n- Use task_check to ensure all tracked tasks are done\n\n**Don't mark something as done until you've verified and proved it actually works.**\n\n## Error Recovery\n\nWhen something breaks:\n1. Read the full error output carefully \u2014 don't guess\n2. Find the root cause, not just the symptom\n3. Fix it properly \u2014 no casts or suppressions to hide errors\n4. Re-run to confirm the fix\n5. If progress is blocked after reasonable attempts, briefly explain the blocker, what you've tried, and the next best option\n\n## Git in Build Mode\n\n- Before committing, verify the code compiles and passes lint\n- Use descriptive branch names: `feat/...`, `fix/...`, `refactor/...`\n";
+export declare const buildModePrompt = "\n# Build Mode\n\nYou are in BUILD mode. You have full access to all tools and can read, write, edit, and execute commands.\n\n## Working Style\n\n**For simple tasks** (typo fixes, small edits, single-file changes):\n- Just do it. No need to explain your plan first.\n\n**For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):\n- Use the available task-management tools to create and update your task list\n- Work on ONE step at a time \u2014 complete it and verify it works before moving on\n- If multiple approaches are plausible and the choice would materially affect scope, behavior, or risk, stop and ask the user\n\n## The Implementation Loop\n\nFor each change you make:\n\n1. **Understand** \u2014 Read the relevant code. Check how similar things are done elsewhere.\n2. **Implement** \u2014 Make the change. Follow existing patterns and conventions.\n3. **Verify** \u2014 Test that it works. Don't assume \u2014 actually run it.\n4. **Prove** \u2014 Proactively prove that the change is good, makes sense in context, is a positive contribution, and works fully. The burden of proof is on YOU.\n5. **Clean up** \u2014 Ensure no broken code, no debug statements, no half-done features.\n\nOnly move to the next change after the current one is verified and proved to be working.\n\n## Verification is Required\n\nBefore considering any task complete:\n- Run relevant tests (check package.json for test scripts)\n- For TypeScript, run `tsc --noEmit` to catch type errors\n- If there are no automated tests, manually verify the behavior works as expected\n- Confirm the result makes sense in the codebase and improves the requested behavior\n- Use available task-checking tools to ensure all tracked tasks are done\n\n**Don't mark something as done until you've verified and proved it actually works.**\n\n## Error Recovery\n\nWhen something breaks:\n1. Read the full error output carefully \u2014 don't guess\n2. Find the root cause, not just the symptom\n3. Fix it properly \u2014 no casts or suppressions to hide errors\n4. Re-run to confirm the fix\n5. If progress is blocked after reasonable attempts, briefly explain the blocker, what you've tried, and the next best option\n\n## Git in Build Mode\n\n- Before committing, verify the code compiles and passes lint\n- Use descriptive branch names: `feat/...`, `fix/...`, `refactor/...`\n";
 //# sourceMappingURL=build.d.ts.map

package/dist/agents/prompts/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiB5D;AAED,eAAO,MAAM,eAAe,8wEAmD3B,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiB5D;AAED,eAAO,MAAM,eAAe,00EAmD3B,CAAC"}

package/dist/agents/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAK3C,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAQpE,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA8D1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAK3C,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAepE,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA+D1D"}

package/dist/agents/prompts/tool-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-guidance.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/tool-guidance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,UAAU,mBAAmB;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA0K3F"}
+{"version":3,"file":"tool-guidance.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/tool-guidance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,UAAU,mBAAmB;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA6M3F"}

package/dist/agents/subagents/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,eAAO,MAAM,eAAe,EAAE,eA0C7B,CAAC"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/agents/subagents/execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,eAAO,MAAM,eAAe,EAAE,eAqC7B,CAAC"}

package/dist/{chunk-BV5IMX2N.cjs → chunk-2G75WRPR.cjs}

@@ -2,7 +2,7 @@
 
 var chunkU3HWL5UG_cjs = require('./chunk-U3HWL5UG.cjs');
 var chunk24SDVHO7_cjs = require('./chunk-24SDVHO7.cjs');
-var chunkOBFBUWOR_cjs = require('./chunk-OBFBUWOR.cjs');
+var chunkAWYGW5ZV_cjs = require('./chunk-AWYGW5ZV.cjs');
 var path = require('path');
 var agent = require('@mastra/core/agent');
 var harness = require('@mastra/core/harness');
@@ -214,7 +214,7 @@ Only if all are "no" \u2192 THEN ask the user
 - Your output is displayed in a terminal so long output text will be hard for the user to read. Keep responses short/concise and to the point, the user will ask questions if they need you to expand on anything. Be critical of yourself and don't add filler sentences, say what you mean, and say it quickly, while remaining friendly.
 - Use Github-flavored markdown for formatting.
 - Only use emojis if the user explicitly requests it.
-- Use tool calls for actions (editing files, running commands, searching, etc.). Use text for communication \u2014 talk to the user in text, not via tools, except for communication tools like \`submit_plan\`, \`ask_user\`, and \`task_write\`.
+- Use tool calls for actions (editing files, running commands, searching, updating tasks, etc.). Use text for communication \u2014 talk to the user in text, not via tools, except for explicit user-facing or progress tools listed in the tool guidance.
 - Prioritize technical accuracy over validating the user's beliefs. Be direct and objective. Respectful correction is more valuable than false agreement.
 `;
 }
@@ -251,7 +251,7 @@ You are in BUILD mode. You have full access to all tools and can read, write, ed
 - Just do it. No need to explain your plan first.
 
 **For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):
-- Use task_write to track your steps
+- Use the available task-management tools to create and update your task list
 - Work on ONE step at a time \u2014 complete it and verify it works before moving on
 - If multiple approaches are plausible and the choice would materially affect scope, behavior, or risk, stop and ask the user
 
@@ -274,7 +274,7 @@ Before considering any task complete:
 - For TypeScript, run \`tsc --noEmit\` to catch type errors
 - If there are no automated tests, manually verify the behavior works as expected
 - Confirm the result makes sense in the codebase and improves the requested behavior
-- Use task_check to ensure all tracked tasks are done
+- Use available task-checking tools to ensure all tracked tasks are done
 
 **Don't mark something as done until you've verified and proved it actually works.**
 
@@ -566,9 +566,9 @@ function getDynamicWorkspace({ requestContext, mastra: mastra2 }) {
   ];
   const isPlanMode = modeId === "plan";
   const planModeTools = {
-    mastra_workspace_write_file: { ...chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES.mastra_workspace_write_file, enabled: false },
-    mastra_workspace_edit_file: { ...chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES.mastra_workspace_edit_file, enabled: false },
-    mastra_workspace_ast_edit: { ...chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES.mastra_workspace_ast_edit, enabled: false }
+    mastra_workspace_write_file: { ...chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES.mastra_workspace_write_file, enabled: false },
+    mastra_workspace_edit_file: { ...chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES.mastra_workspace_edit_file, enabled: false },
+    mastra_workspace_ast_edit: { ...chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES.mastra_workspace_ast_edit, enabled: false }
   };
   let existing;
   try {
@@ -577,11 +577,11 @@ function getDynamicWorkspace({ requestContext, mastra: mastra2 }) {
   }
   if (existing) {
     existing.filesystem.setAllowedPaths(allowedPaths);
-    existing.setToolsConfig(isPlanMode ? { ...chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES, ...planModeTools } : chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES);
+    existing.setToolsConfig(isPlanMode ? { ...chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES, ...planModeTools } : chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES);
     return existing;
   }
   const userLsp = chunkU3HWL5UG_cjs.loadSettings().lsp ?? {};
-  const mcModulePath = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-BV5IMX2N.cjs', document.baseURI).href)))), "..");
+  const mcModulePath = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-2G75WRPR.cjs', document.baseURI).href)))), "..");
   const lspConfig = {
     ...userLsp,
     packageRunner: userLsp.packageRunner || detectPackageRunner(projectPath),
@@ -599,7 +599,7 @@ function getDynamicWorkspace({ requestContext, mastra: mastra2 }) {
       workingDirectory: projectPath,
       env: buildSandboxEnv()
     }),
-    tools: isPlanMode ? { ...chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES, ...planModeTools } : chunkOBFBUWOR_cjs.TOOL_NAME_OVERRIDES,
+    tools: isPlanMode ? { ...chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES, ...planModeTools } : chunkAWYGW5ZV_cjs.TOOL_NAME_OVERRIDES,
     ...skillPaths.length > 0 ? { skills: skillPaths } : {},
     lsp: lspConfig
   });
@@ -804,74 +804,74 @@ IMPORTANT: You can ONLY call tools by their exact registered names listed below.
 
 You have access to the following tools. Use the RIGHT tool for the job:`);
   const readTools = [];
-  if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.VIEW)) {
+  if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW)) {
     readTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.VIEW}** \u2014 Read file contents
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW}** \u2014 Read file contents
 - Use this to read files before editing them. NEVER propose changes to code you haven't read.
 - Use \`offset\` (1-indexed start line) and \`limit\` (number of lines) for large files.
 - Example: Read lines 50-100: \`{ path: "src/big-file.ts", offset: 50, limit: 51 }\`
-- To list directories, use \`${chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES}\` instead.`);
+- To list directories, use \`${chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES}\` instead.`);
   }
-  if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.SEARCH_CONTENT)) {
+  if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.SEARCH_CONTENT)) {
     readTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.SEARCH_CONTENT}** \u2014 Search file contents using regex
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.SEARCH_CONTENT}** \u2014 Search file contents using regex
 - Preferred for content search (finding functions, variables, error messages, imports, etc.)
 - Use \`path\` to filter by directory or glob pattern. Supports \`contextLines\`, \`caseSensitive\`, and \`maxCount\`.
 - Example: Find a function: \`{ pattern: "function handleSubmit", path: "**/*.ts" }\`
 - Example: Find imports: \`{ pattern: "from ['\\"\\]express['\\"\\]", path: "**/*.ts" }\`
 - Respects .gitignore by default.`);
   }
-  if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES)) {
+  if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES)) {
     readTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES}** \u2014 List files and directories as a tree
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES}** \u2014 List files and directories as a tree
 - Preferred for exploring project structure and finding files by pattern.
 - Returns tree-style output. Respects .gitignore by default.
 - Example: List project root: \`{ path: "./" }\`
 - Example: Find test files: \`{ path: "./src", pattern: "**/*.test.ts" }\`
 - Example: Find config files: \`{ pattern: "*.config.{js,ts,json}" }\``);
   }
-  if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.EXECUTE_COMMAND)) {
+  if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.EXECUTE_COMMAND)) {
     readTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.EXECUTE_COMMAND}** \u2014 Run shell commands
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.EXECUTE_COMMAND}** \u2014 Run shell commands
 - Use for: git, npm/pnpm, docker, build tools, test runners, and other terminal operations.
-- Prefer dedicated tools for: file reading (${chunkOBFBUWOR_cjs.MC_TOOLS.VIEW}), file search (${chunkOBFBUWOR_cjs.MC_TOOLS.SEARCH_CONTENT}/${chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES}), file editing (${chunkOBFBUWOR_cjs.MC_TOOLS.STRING_REPLACE_LSP}/${chunkOBFBUWOR_cjs.MC_TOOLS.WRITE_FILE}).
+- Prefer dedicated tools for: file reading (${chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW}), file search (${chunkAWYGW5ZV_cjs.MC_TOOLS.SEARCH_CONTENT}/${chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES}), file editing (${chunkAWYGW5ZV_cjs.MC_TOOLS.STRING_REPLACE_LSP}/${chunkAWYGW5ZV_cjs.MC_TOOLS.WRITE_FILE}).
 - Commands have a 30-second default timeout. Use \`timeout\` for longer commands, \`cwd\` for working directory.
 - Use the \`tail\` parameter or pipe to \`| tail -N\` to limit output \u2014 the full output streams to the user, only the tail is returned to you. If you're building any kind of package you should be tailing.
 - Good: Run independent commands in parallel when possible.
-- Bad: Running \`cat file.txt\` \u2014 use the ${chunkOBFBUWOR_cjs.MC_TOOLS.VIEW} tool instead.`);
+- Bad: Running \`cat file.txt\` \u2014 use the ${chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW} tool instead.`);
   }
-  if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.LSP_INSPECT)) {
+  if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.LSP_INSPECT)) {
     readTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.LSP_INSPECT}** \u2014 Inspect code using Language Server Protocol
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.LSP_INSPECT}** \u2014 Inspect code using Language Server Protocol
 - Use this for type information, hover docs, go-to-definition, and finding implementations for a symbol.
 - Best when you already know the file and line and need semantic code intelligence rather than raw file contents.
 - Input: \`path\` (absolute file path), \`line\` (1-indexed line number), \`match\` (the exact line content with exactly one \`<<<\` cursor marker).
 - Output includes: \`hover\`, \`definition\` (compact location with preview), and \`implementation\` (compact usage/implementation locations).
 - Example: \`{ path: "/abs/path/src/foo.ts", line: 10, match: "const foo = <<<bar()" }\` \u2014 inspect the symbol at the \`<<<\` position.
-- Use \`${chunkOBFBUWOR_cjs.MC_TOOLS.VIEW}\` when you need to read the implementation or surrounding code.
-- Use \`${chunkOBFBUWOR_cjs.MC_TOOLS.SEARCH_CONTENT}\` or \`${chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES}\` first if you do not yet know where the symbol is.`);
+- Use \`${chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW}\` when you need to read the implementation or surrounding code.
+- Use \`${chunkAWYGW5ZV_cjs.MC_TOOLS.SEARCH_CONTENT}\` or \`${chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES}\` first if you do not yet know where the symbol is.`);
   }
   if (readTools.length > 0) {
     sections.push(readTools.join("\n"));
   }
   if (modeId !== "plan") {
     const writeTools = [];
-    if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.STRING_REPLACE_LSP)) {
+    if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.STRING_REPLACE_LSP)) {
       writeTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.STRING_REPLACE_LSP}** \u2014 Edit files by replacing exact text
-- You MUST read a file with \`${chunkOBFBUWOR_cjs.MC_TOOLS.VIEW}\` before editing it.
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.STRING_REPLACE_LSP}** \u2014 Edit files by replacing exact text
+- You MUST read a file with \`${chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW}\` before editing it.
 - \`old_string\` must be an exact match of existing text in the file.
 - Provide enough surrounding context in \`old_string\` to make it unique.
 - Use \`replace_all: true\` to replace all occurrences (default: false, requires unique match).
-- For creating new files, use \`${chunkOBFBUWOR_cjs.MC_TOOLS.WRITE_FILE}\` instead.
+- For creating new files, use \`${chunkAWYGW5ZV_cjs.MC_TOOLS.WRITE_FILE}\` instead.
 - Good: Include 2-3 lines of surrounding context to ensure uniqueness.
 - Bad: Using just \`return true;\` \u2014 too common, will match multiple places.`);
     }
-    if (!denied.has(chunkOBFBUWOR_cjs.MC_TOOLS.WRITE_FILE)) {
+    if (!denied.has(chunkAWYGW5ZV_cjs.MC_TOOLS.WRITE_FILE)) {
       writeTools.push(`
-**${chunkOBFBUWOR_cjs.MC_TOOLS.WRITE_FILE}** \u2014 Create new files or overwrite existing ones
+**${chunkAWYGW5ZV_cjs.MC_TOOLS.WRITE_FILE}** \u2014 Create new files or overwrite existing ones
 - Use this to create new files.
-- If overwriting an existing file, you MUST have read it first with \`${chunkOBFBUWOR_cjs.MC_TOOLS.VIEW}\`.
+- If overwriting an existing file, you MUST have read it first with \`${chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW}\`.
 - Prefer editing existing files over creating new ones.`);
     }
     if (writeTools.length > 0) {
@@ -889,20 +889,42 @@ ${webTools.join(" / ")} \u2014 Search the web / extract page content
     }
   }
   const taskTools = [];
-  if (!denied.has("task_write")) {
+  const canUpdateTask = !denied.has("task_update");
+  const canCompleteTask = !denied.has("task_complete");
+  const canCheckTasks = !denied.has("task_check");
+  const canWriteTasks = !denied.has("task_write");
+  const patchToolGuidance = canUpdateTask && canCompleteTask ? "- Prefer task_update or task_complete when changing one existing task." : canUpdateTask ? "- Prefer task_update when changing one existing task." : canCompleteTask ? "- Prefer task_complete when marking one existing task completed." : "- Use task_write with the full task list when changing existing tasks.";
+  if (canWriteTasks) {
     taskTools.push(`
 **task_write** \u2014 Track tasks for complex multi-step work
 - Use when a task requires 3 or more distinct steps or actions.
-- Pass the FULL task list each time (replaces previous list).
+- Use task_write to create the initial task list or replace the whole list after replanning.
+- Each task has: id (stable identifier), content (imperative form), status (pending, in_progress, or completed), activeForm (present continuous form shown during execution).
+- Keep task IDs stable across updates. If you omit IDs, the tool result returns generated IDs.
+${patchToolGuidance}
 - Mark tasks \`in_progress\` BEFORE starting work. Only ONE task should be \`in_progress\` at a time.
-- Mark tasks \`completed\` IMMEDIATELY after finishing each task. Do not batch completions.
-- Each task has: content (imperative form), status (pending|in_progress|completed), activeForm (present continuous form shown during execution).`);
+- Mark tasks \`completed\` IMMEDIATELY after finishing each task. Do not batch completions.`);
   }
-  if (!denied.has("task_check")) {
+  if (canUpdateTask) {
+    taskTools.push(`
+**task_update** \u2014 Patch one tracked task by ID
+- Use this for targeted changes to one existing task.
+- Provide the task ID and only the fields that changed: content, status, or activeForm.`);
+  }
+  if (canCompleteTask) {
+    const idSource = canCheckTasks ? "Use task_check if you need the current IDs before completing a task." : canWriteTasks ? "Use IDs returned by task_write." : "Use only task IDs already visible in the current task list.";
+    taskTools.push(`
+**task_complete** \u2014 Mark one tracked task completed by ID
+- Use this immediately after finishing a tracked task.
+- ${idSource}`);
+  }
+  if (canCheckTasks) {
     taskTools.push(`
 **task_check** \u2014 Check completion status of tasks
-- Use this BEFORE deciding you're done with a task to verify all tasks are completed.
-- Returns the number of completed, in progress, and pending tasks.
+- Use this BEFORE finishing tracked work to verify all tasks are completed.
+- Returns a readable status summary plus structured fields: tasks, summary, incompleteTasks, and isError.
+- summary includes total, completed, inProgress, pending, incomplete, hasTasks, and allCompleted.
+- Use summary.allCompleted to decide whether tracked work is complete; if summary.hasTasks is false, no task list is currently tracked.
 - If any tasks remain incomplete, continue working on them.
 - IMPORTANT: Always check task completion before ending work on a complex task.`);
   }
@@ -935,6 +957,9 @@ ${webTools.join(" / ")} \u2014 Search the web / extract page content
 }
 
 // src/agents/prompts/index.ts
+function formatTaskPromptValue(value) {
+  return value.replace(/\s+/g, " ").replace(/[<>{}]/g, (char) => ({ "<": "&lt;", ">": "&gt;", "{": "&#123;", "}": "&#125;" })[char] ?? char).trim();
+}
 var modePrompts = {
   build: buildModePromptFn,
   plan: planModePrompt,
@@ -971,7 +996,8 @@ function buildFullPrompt(ctx) {
   if (tasks && tasks.length > 0) {
     const lines = tasks.map((t) => {
       const icon = t.status === "completed" ? "\u2713" : t.status === "in_progress" ? "\u25B8" : "\u25CB";
-      return `  ${icon} [${t.status}] ${t.content}`;
+      const id = t.id ? ` {id: ${formatTaskPromptValue(t.id)}}` : "";
+      return `  ${icon} [${t.status}]${id} ${formatTaskPromptValue(t.content)}`;
     });
     taskSection = `
 <current-task-list>
@@ -1116,6 +1142,8 @@ ${CAVEMAN_OM_INSTRUCTION}` : DYNAMIC_AGENTS_MD_INSTRUCTION;
     return cachedMemory;
   };
 }
+
+// src/agents/subagents/execute.ts
 var executeSubagent = {
   id: "execute",
   name: "Execute",
@@ -1136,10 +1164,9 @@ var executeSubagent = {
 
 ## Workflow
 . Understand the task and explore relevant code
-. For complex tasks (3+ steps): use task_write to track progress
+. For complex tasks (3+ steps): track progress internally and summarize it in your final answer
 . Make changes incrementally \u2014 verify each change before moving on
 . Run tests or type-check to verify
-. If you created tasks: ALWAYS call task_check before finishing
 
 ## Efficiency
 Your output returns to the parent agent. Be concise:
@@ -1152,11 +1179,7 @@ End with a structured summary:
 . **Completed**: What you implemented (1-2 sentences)
 . **Changes**: Files modified/created
 . **Verification**: How you verified it works
-. **Notes**: Follow-up needed (if any)`,
-  tools: {
-    task_write: harness.taskWriteTool,
-    task_check: harness.taskCheckTool
-  }
+. **Notes**: Follow-up needed (if any)`
 };
 
 // src/agents/subagents/explore.ts
@@ -1190,7 +1213,7 @@ End with a structured summary:
 . **Details**: Additional context if needed
 
 Keep your summary under 300 words.`,
-  allowedWorkspaceTools: [chunkOBFBUWOR_cjs.MC_TOOLS.VIEW, chunkOBFBUWOR_cjs.MC_TOOLS.SEARCH_CONTENT, chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES]
+  allowedWorkspaceTools: [chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW, chunkAWYGW5ZV_cjs.MC_TOOLS.SEARCH_CONTENT, chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES]
 };
 
 // src/agents/subagents/plan.ts
@@ -1226,7 +1249,7 @@ Structure your plan as:
 . **Risks**: Potential issues or edge cases (if any)
 
 Be specific about code locations (file paths, function names, line numbers). Keep the plan actionable and under 500 words.`,
-  allowedWorkspaceTools: [chunkOBFBUWOR_cjs.MC_TOOLS.VIEW, chunkOBFBUWOR_cjs.MC_TOOLS.SEARCH_CONTENT, chunkOBFBUWOR_cjs.MC_TOOLS.FIND_FILES]
+  allowedWorkspaceTools: [chunkAWYGW5ZV_cjs.MC_TOOLS.VIEW, chunkAWYGW5ZV_cjs.MC_TOOLS.SEARCH_CONTENT, chunkAWYGW5ZV_cjs.MC_TOOLS.FIND_FILES]
 };
 
 // src/agents/thread-caveman-state.ts
@@ -2625,6 +2648,7 @@ var stateSchema = zod.z.object({
   // Task list (ephemeral per-thread, cleared on thread switch/creation)
   tasks: zod.z.array(
     zod.z.object({
+      id: zod.z.string().optional(),
       content: zod.z.string(),
       status: zod.z.enum(["pending", "in_progress", "completed"]),
       activeForm: zod.z.string()
@@ -3184,7 +3208,7 @@ async function createMastraCode(config) {
     stateSchema,
     subagents,
     resolveModel: (modelId) => chunkU3HWL5UG_cjs.resolveModel(modelId),
-    toolCategoryResolver: chunkOBFBUWOR_cjs.getToolCategory,
+    toolCategoryResolver: chunkAWYGW5ZV_cjs.getToolCategory,
     initialState: {
       projectPath: project.rootPath,
       projectName: project.name,
@@ -3291,5 +3315,5 @@ async function createMastraCode(config) {
 
 exports.createAuthStorage = createAuthStorage;
 exports.createMastraCode = createMastraCode;
-//# sourceMappingURL=chunk-BV5IMX2N.cjs.map
-//# sourceMappingURL=chunk-BV5IMX2N.cjs.map
+//# sourceMappingURL=chunk-2G75WRPR.cjs.map
+//# sourceMappingURL=chunk-2G75WRPR.cjs.map