Taskmaster

/** * tools/clear-subtasks.js * Tool for clearing subtasks from parent tasks */ import { createErrorResponse, handleApiResult, withToolContext } from '@tm/mcp'; import { z } from 'zod'; import { resolveTag } from '../../../scripts/modules/utils.js'; import { clearSubtasksDirect } from '../core/task-master-core.js'; import { findTasksPath } from '../core/utils/path-utils.js'; /** * Register the clearSubtasks tool with the MCP server * @param {Object} server - FastMCP server instance */ export function registerClearSubtasksTool(server) { server.addTool({ name: 'clear_subtasks', description: 'Clear subtasks from specified tasks', parameters: z .object({ id: z .string() .optional() .describe('Task IDs (comma-separated) to clear subtasks from'), all: z.boolean().optional().describe('Clear subtasks from all tasks'), file: z .string() .optional() .describe( 'Absolute path to the tasks file (default: tasks/tasks.json)' ), projectRoot: z .string() .describe('The directory of the project. Must be an absolute path.'), tag: z.string().optional().describe('Tag context to operate on') }) .refine((data) => data.id || data.all, { message: "Either 'id' or 'all' parameter must be provided", path: ['id', 'all'] }), execute: withToolContext('clear-subtasks', async (args, context) => { try { context.log.info( `Clearing subtasks with args: ${JSON.stringify(args)}` ); const resolvedTag = resolveTag({ projectRoot: args.projectRoot, tag: args.tag }); // Use args.projectRoot directly (guaranteed by withNormalizedProjectRoot) let tasksJsonPath; try { tasksJsonPath = findTasksPath( { projectRoot: args.projectRoot, file: args.file }, context.log ); } catch (error) { context.log.error(`Error finding tasks.json: ${error.message}`); return createErrorResponse( `Failed to find tasks.json: ${error.message}` ); } const result = await clearSubtasksDirect( { tasksJsonPath: tasksJsonPath, id: args.id, all: args.all, projectRoot: args.projectRoot, tag: resolvedTag }, context.log, { session: context.session } ); if (result.success) { context.log.info( `Subtasks cleared successfully: ${result.data.message}` ); } else { context.log.error( `Failed to clear subtasks: ${result.error.message}` ); } return handleApiResult({ result, log: context.log, errorPrefix: 'Error clearing subtasks', projectRoot: args.projectRoot }); } catch (error) { context.log.error(`Error in clearSubtasks tool: ${error.message}`); return createErrorResponse(error.message); } }) }); }