An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
JavaScript aicursorcursor-aicursorailovablelovable-devroocodetask-managertaskstasks-listwindsurfwindsurf-ai
feat(mcp): Implement update-task MCP command for updating single tasks by ID with proper direct function wrapper, MCP tool implementation, and registration
Eyal Toledano38f9e4deaa0e
diff --git a/.changeset/two-bats-smoke.md b/.changeset/two-bats-smoke.mdindex f93b9737..c86b1ec9 100644--- a/.changeset/two-bats-smoke.md+++ b/.changeset/two-bats-smoke.md@@ -2,4 +2,4 @@"task-master-ai": patch----Split monolithic task-master-core.js into separate function files within+Split monolithic task-master-core.js into separate function files within direct-functions directory and implement update-task MCP command for updating a single task by IDdiff --git a/mcp-server/src/core/direct-functions/update-task-by-id.js b/mcp-server/src/core/direct-functions/update-task-by-id.jsnew file mode 100644index 00000000..4bb7a304--- /dev/null+++ b/mcp-server/src/core/direct-functions/update-task-by-id.js@@ -0,0 +1,105 @@+/**+ * update-task-by-id.js+ * Direct function implementation for updating a single task by ID with new information+ */++import { updateTaskById } from '../../../../scripts/modules/task-manager.js';+import { findTasksJsonPath } from '../utils/path-utils.js';++/**+ * Direct function wrapper for updateTaskById with error handling.+ *+ * @param {Object} args - Command arguments containing id, prompt, useResearch and file path options.+ * @param {Object} log - Logger object.+ * @returns {Promise<Object>} - Result object with success status and data/error information.+ */+export async function updateTaskByIdDirect(args, log) {+ try {+ log.info(`Updating task with args: ${JSON.stringify(args)}`);++ // Check required parameters+ if (!args.id) {+ const errorMessage = 'No task ID specified. Please provide a task ID to update.';+ log.error(errorMessage);+ return {+ success: false,+ error: { code: 'MISSING_TASK_ID', message: errorMessage },+ fromCache: false+ };+ }++ if (!args.prompt) {+ const errorMessage = 'No prompt specified. Please provide a prompt with new information for the task update.';+ log.error(errorMessage);+ return {+ success: false,+ error: { code: 'MISSING_PROMPT', message: errorMessage },+ fromCache: false+ };+ }++ // Parse taskId - handle both string and number values+ let taskId;+ if (typeof args.id === 'string') {+ // Handle subtask IDs (e.g., "5.2")+ if (args.id.includes('.')) {+ taskId = args.id; // Keep as string for subtask IDs+ } else {+ // Parse as integer for main task IDs+ taskId = parseInt(args.id, 10);+ if (isNaN(taskId)) {+ const errorMessage = `Invalid task ID: ${args.id}. Task ID must be a positive integer or subtask ID (e.g., "5.2").`;+ log.error(errorMessage);+ return {+ success: false,+ error: { code: 'INVALID_TASK_ID', message: errorMessage },+ fromCache: false+ };+ }+ }+ } else {+ taskId = args.id;+ }++ // Get tasks file path+ let tasksPath;+ try {+ tasksPath = findTasksJsonPath(args, log);+ } catch (error) {+ log.error(`Error finding tasks file: ${error.message}`);+ return {+ success: false,+ error: { code: 'TASKS_FILE_ERROR', message: error.message },+ fromCache: false+ };+ }++ // Get research flag+ const useResearch = args.research === true;++ log.info(`Updating task with ID ${taskId} with prompt "${args.prompt}" and research: ${useResearch}`);++ // Execute core updateTaskById function+ await updateTaskById(tasksPath, taskId, args.prompt, useResearch);++ // Since updateTaskById doesn't return a value but modifies the tasks file,+ // we'll return a success message+ return {+ success: true,+ data: {+ message: `Successfully updated task with ID ${taskId} based on the prompt`,+ taskId,+ tasksPath,+ useResearch+ },+ fromCache: false // This operation always modifies state and should never be cached+ };+ } catch (error) {+ log.error(`Error updating task by ID: ${error.message}`);+ return {+ success: false,+ error: { code: 'UPDATE_TASK_ERROR', message: error.message || 'Unknown error updating task' },+ fromCache: false+ };+ }+}\ No newline at end of filediff --git a/mcp-server/src/core/task-master-core.js b/mcp-server/src/core/task-master-core.jsindex 55d297b1..2111e221 100644--- a/mcp-server/src/core/task-master-core.js+++ b/mcp-server/src/core/task-master-core.js@@ -9,6 +9,7 @@ import { listTasksDirect } from './direct-functions/list-tasks.js';import { getCacheStatsDirect } from './direct-functions/cache-stats.js';import { parsePRDDirect } from './direct-functions/parse-prd.js';import { updateTasksDirect } from './direct-functions/update-tasks.js';+import { updateTaskByIdDirect } from './direct-functions/update-task-by-id.js';// Re-export utility functionsexport { findTasksJsonPath } from './utils/path-utils.js';@@ -19,6 +20,7 @@ export {getCacheStatsDirect,parsePRDDirect,updateTasksDirect,+ updateTaskByIdDirect,};/**@@ -30,5 +32,6 @@ export const directFunctions = {cacheStats: getCacheStatsDirect,parsePRD: parsePRDDirect,update: updateTasksDirect,+ updateTask: updateTaskByIdDirect,// Add more functions as we implement them};\ No newline at end of filediff --git a/mcp-server/src/tools/index.js b/mcp-server/src/tools/index.jsindex cb62c305..ebf242d9 100644--- a/mcp-server/src/tools/index.js+++ b/mcp-server/src/tools/index.js@@ -12,6 +12,7 @@ import { registerNextTaskTool } from "./nextTask.js";import { registerAddTaskTool } from "./addTask.js";import { registerParsePRDTool } from "./parsePRD.js";import { registerUpdateTool } from "./update.js";+import { registerUpdateTaskTool } from "./update-task.js";/*** Register all Task Master tools with the MCP server@@ -26,6 +27,7 @@ export function registerTaskMasterTools(server) {registerAddTaskTool(server);registerParsePRDTool(server);registerUpdateTool(server);+ registerUpdateTaskTool(server);}export default {diff --git a/mcp-server/src/tools/update-task.js b/mcp-server/src/tools/update-task.jsnew file mode 100644index 00000000..8cdd6974--- /dev/null+++ b/mcp-server/src/tools/update-task.js@@ -0,0 +1,51 @@+/**+ * tools/update-task.js+ * Tool to update a single task by ID with new information+ */++import { z } from "zod";+import {+ handleApiResult,+ createErrorResponse+} from "./utils.js";+import { updateTaskByIdDirect } from "../core/task-master-core.js";++/**+ * Register the update-task tool with the MCP server+ * @param {Object} server - FastMCP server instance+ */+export function registerUpdateTaskTool(server) {+ server.addTool({+ name: "update-task",+ description: "Updates a single task by ID with new information",+ parameters: z.object({+ id: z.union([z.number(), z.string()]).describe("ID of the task to update"),+ prompt: z.string().describe("New information or context to update the task"),+ research: z.boolean().optional().describe("Use Perplexity AI for research-backed updates"),+ file: z.string().optional().describe("Path to the tasks file"),+ projectRoot: z+ .string()+ .optional()+ .describe(+ "Root directory of the project (default: current working directory)"+ ),+ }),+ execute: async (args, { log }) => {+ try {+ log.info(`Updating task with args: ${JSON.stringify(args)}`);++ // Call the direct function wrapper+ const result = await updateTaskByIdDirect(args, log);++ // Log result+ log.info(`${result.success ? `Successfully updated task with ID ${args.id}` : 'Failed to update task'}`);++ // Use handleApiResult to format the response+ return handleApiResult(result, log, 'Error updating task');+ } catch (error) {+ log.error(`Error in update-task tool: ${error.message}`);+ return createErrorResponse(error.message);+ }+ },+ });+}\ No newline at end of filediff --git a/tasks/task_023.txt b/tasks/task_023.txtindex d6377c52..9d6d3d0b 100644--- a/tasks/task_023.txt+++ b/tasks/task_023.txt@@ -372,7 +372,7 @@ Following MCP implementation standards:\n\n1. Create parsePRDDirect function in### Details:Following MCP implementation standards:\n\n1. Create updateTasksDirect function in task-master-core.js:\n - Import updateTasks from task-manager.js\n - Handle file paths using findTasksJsonPath utility\n - Process arguments: fromId, prompt, useResearch\n - Validate inputs and handle errors with try/catch\n - Return standardized { success, data/error } object\n - Add to directFunctions map\n\n2. Create update.js MCP tool in mcp-server/src/tools/:\n - Import z from zod for parameter schema\n - Import executeMCPToolAction from ./utils.js\n - Import updateTasksDirect from task-master-core.js\n - Define parameters matching CLI options using zod schema\n - Implement registerUpdateTool(server) with server.addTool\n - Use executeMCPToolAction in execute method\n\n3. Register in tools/index.js\n\n4. Add to .cursor/mcp.json with appropriate schema\n\n5. Write tests following testing guidelines:\n - Unit test for updateTasksDirect\n - Integration test for MCP tool-## 18. Implement update-task MCP command [pending]+## 18. Implement update-task MCP command [done]### Dependencies: None### Description: Create direct function wrapper and MCP tool for updating a single task by ID with new information.### Details:diff --git a/tasks/tasks.json b/tasks/tasks.jsonindex 0f754b46..a4d7a08b 100644--- a/tasks/tasks.json+++ b/tasks/tasks.json@@ -1510,7 +1510,7 @@"title": "Implement update-task MCP command","description": "Create direct function wrapper and MCP tool for updating a single task by ID with new information.","details": "Following MCP implementation standards:\n\n1. Create updateTaskByIdDirect.js in mcp-server/src/core/direct-functions/:\n - Import updateTaskById from task-manager.js\n - Handle file paths using findTasksJsonPath utility\n - Process arguments: taskId, prompt, useResearch\n - Validate inputs and handle errors with try/catch\n - Return standardized { success, data/error } object\n\n2. Export from task-master-core.js:\n - Import the function from its file\n - Add to directFunctions map\n\n3. Create update-task.js MCP tool in mcp-server/src/tools/:\n - Import z from zod for parameter schema\n - Import executeMCPToolAction from ./utils.js\n - Import updateTaskByIdDirect from task-master-core.js\n - Define parameters matching CLI options using zod schema\n - Implement registerUpdateTaskTool(server) with server.addTool\n - Use executeMCPToolAction in execute method\n\n4. Register in tools/index.js\n\n5. Add to .cursor/mcp.json with appropriate schema\n\n6. Write tests following testing guidelines:\n - Unit test for updateTaskByIdDirect.js\n - Integration test for MCP tool",- "status": "pending",+ "status": "done","dependencies": [],"parentTaskId": 23},