/** * tools/expand-all.js * Tool for expanding all pending tasks with subtasks */ import { z } from 'zod'; import { handleApiResult, createErrorResponse, withNormalizedProjectRoot } from './utils.js'; import { expandAllTasksDirect } from '../core/task-master-core.js'; import { findTasksJsonPath } from '../core/utils/path-utils.js'; /** * Register the expandAll tool with the MCP server * @param {Object} server - FastMCP server instance */ export function registerExpandAllTool(server) { server.addTool({ name: 'expand_all', description: 'Expand all pending tasks into subtasks based on complexity or defaults', parameters: z.object({ num: z .string() .optional() .describe( 'Target number of subtasks per task (uses complexity/defaults otherwise)' ), research: z .boolean() .optional() .describe( 'Enable research-backed subtask generation (e.g., using Perplexity)' ), prompt: z .string() .optional() .describe( 'Additional context to guide subtask generation for all tasks' ), force: z .boolean() .optional() .describe( 'Force regeneration of subtasks for tasks that already have them' ), file: z .string() .optional() .describe( 'Absolute path to the tasks file in the /tasks folder inside the project root (default: tasks/tasks.json)' ), projectRoot: z .string() .optional() .describe( 'Absolute path to the project root directory (derived from session if possible)' ) }), execute: withNormalizedProjectRoot(async (args, { log, session }) => { try { log.info( `Tool expand_all execution started with args: ${JSON.stringify(args)}` ); let tasksJsonPath; try { tasksJsonPath = findTasksJsonPath( { projectRoot: args.projectRoot, file: args.file }, log ); log.info(`Resolved tasks.json path: ${tasksJsonPath}`); } catch (error) { log.error(`Error finding tasks.json: ${error.message}`); return createErrorResponse( `Failed to find tasks.json: ${error.message}` ); } const result = await expandAllTasksDirect( { tasksJsonPath: tasksJsonPath, num: args.num, research: args.research, prompt: args.prompt, force: args.force, projectRoot: args.projectRoot }, log, { session } ); return handleApiResult(result, log, 'Error expanding all tasks'); } catch (error) { log.error( `Unexpected error in expand_all tool execute: ${error.message}` ); if (error.stack) { log.error(error.stack); } return createErrorResponse( `An unexpected error occurred: ${error.message}` ); } }) }); }