Taskmaster

Instructions

Implementation Reference

• apps/mcp/src/tools/tasks/generate.tool.ts:12-23 (schema)

  Zod schema defining input parameters for the 'generate' MCP tool: output directory, project root, and optional tag.

  const GenerateSchema = z.object({
  	output: z
  		.string()
  		.optional()
  		.describe(
  			'Output directory for generated files (default: same directory as tasks file)'
  		),
  	projectRoot: z
  		.string()
  		.describe('The directory of the project. Must be an absolute path.'),
  	tag: z.string().optional().describe('Tag context to operate on')
  });

• apps/mcp/src/tools/tasks/generate.tool.ts:39-102 (handler)

  Core handler logic for the 'generate' tool. Parses args, resolves output dir, calls tmCore.tasks.generateTaskFiles, handles success/error, and returns formatted result.

  const { projectRoot, tag, output } = args;
  
  try {
  	log.info(`Generating task files with args: ${JSON.stringify(args)}`);
  
  	// Resolve output directory
  	const outputDir = output
  		? path.resolve(projectRoot, output)
  		: undefined;
  
  	// Call tm-core to generate task files
  	const result = await tmCore.tasks.generateTaskFiles({
  		tag,
  		outputDir
  	});
  
  	if (result.success) {
  		log.info(
  			`Successfully generated ${result.count} task files in ${result.directory}`
  		);
  		if (result.orphanedFilesRemoved > 0) {
  			log.info(
  				`Removed ${result.orphanedFilesRemoved} orphaned task files`
  			);
  		}
  	} else {
  		log.error(
  			`Failed to generate task files: ${result.error || 'Unknown error'}`
  		);
  	}
  
  	return handleApiResult({
  		result: {
  			success: result.success,
  			data: result.success
  				? {
  						message: `Successfully generated ${result.count} task file(s)`,
  						count: result.count,
  						directory: result.directory,
  						orphanedFilesRemoved: result.orphanedFilesRemoved
  					}
  				: undefined,
  			error: result.success ? undefined : { message: result.error || 'Unknown error' }
  		},
  		log,
  		projectRoot,
  		tag
  	});
  } catch (error: any) {
  	log.error(`Error in generate tool: ${error.message}`);
  	if (error.stack) {
  		log.debug(error.stack);
  	}
  	return handleApiResult({
  		result: {
  			success: false,
  			error: {
  				message: `Failed to generate task files: ${error.message}`
  			}
  		},
  		log,
  		projectRoot
  	});
  }

• apps/mcp/src/tools/tasks/generate.tool.ts:30-106 (registration)

  Registration function that defines and adds the 'generate' tool to the FastMCP server instance.

  export function registerGenerateTool(server: FastMCP) {
  	server.addTool({
  		name: 'generate',
  		description:
  			'Generates individual task files in tasks/ directory based on tasks.json. Only works with local file storage.',
  		parameters: GenerateSchema,
  		execute: withToolContext(
  			'generate',
  			async (args: GenerateArgs, { log, tmCore }: ToolContext) => {
  				const { projectRoot, tag, output } = args;
  
  				try {
  					log.info(`Generating task files with args: ${JSON.stringify(args)}`);
  
  					// Resolve output directory
  					const outputDir = output
  						? path.resolve(projectRoot, output)
  						: undefined;
  
  					// Call tm-core to generate task files
  					const result = await tmCore.tasks.generateTaskFiles({
  						tag,
  						outputDir
  					});
  
  					if (result.success) {
  						log.info(
  							`Successfully generated ${result.count} task files in ${result.directory}`
  						);
  						if (result.orphanedFilesRemoved > 0) {
  							log.info(
  								`Removed ${result.orphanedFilesRemoved} orphaned task files`
  							);
  						}
  					} else {
  						log.error(
  							`Failed to generate task files: ${result.error || 'Unknown error'}`
  						);
  					}
  
  					return handleApiResult({
  						result: {
  							success: result.success,
  							data: result.success
  								? {
  										message: `Successfully generated ${result.count} task file(s)`,
  										count: result.count,
  										directory: result.directory,
  										orphanedFilesRemoved: result.orphanedFilesRemoved
  									}
  								: undefined,
  							error: result.success ? undefined : { message: result.error || 'Unknown error' }
  						},
  						log,
  						projectRoot,
  						tag
  					});
  				} catch (error: any) {
  					log.error(`Error in generate tool: ${error.message}`);
  					if (error.stack) {
  						log.debug(error.stack);
  					}
  					return handleApiResult({
  						result: {
  							success: false,
  							error: {
  								message: `Failed to generate task files: ${error.message}`
  							}
  						},
  						log,
  						projectRoot
  					});
  				}
  			}
  		)
  	});
  }

• mcp-server/src/tools/tool-registry.js:103-103 (registration)

  Central tool registry mapping the 'generate' tool name to its registration function.

  generate: registerGenerateTool

• mcp-server/src/tools/index.js:152-172 (registration)

  Dynamic registration loop that invokes the generate tool's registration function (along with others) on the MCP server.

  toolsToRegister.forEach((toolName) => {
  	try {
  		const registerFunction = getToolRegistration(toolName);
  		if (registerFunction) {
  			registerFunction(server);
  			logger.debug(`Registered tool: ${toolName}`);
  			registeredTools.push(toolName);
  		} else {
  			logger.warn(`Tool ${toolName} not found in registry`);
  			failedTools.push(toolName);
  		}
  	} catch (error) {
  		if (error.message && error.message.includes('already registered')) {
  			logger.debug(`Tool ${toolName} already registered, skipping`);
  			registeredTools.push(toolName);
  		} else {
  			logger.error(`Failed to register tool ${toolName}: ${error.message}`);
  			failedTools.push(toolName);
  		}
  	}
  });