d3d9dc6ebe
* wip: replace tool parameter inputs with root directory paths * fix: moved path resolving responsibility to tools - made path in parameters to optional for AI - internalised path resolving using session roots * chore: update package-lock.json * chore: fix regressions and fix CI * fix: make projectRoot required * fix: add-task tool * fix: updateTask tool * fix: remove reportProgress * chore: cleanup * fix: expand-task tool * chore: remove usless logs * fix: dependency manager logging in mcp server
124 lines
3.2 KiB
JavaScript
124 lines
3.2 KiB
JavaScript
/**
|
|
* tools/analyze.js
|
|
* Tool for analyzing task complexity and generating recommendations
|
|
*/
|
|
|
|
import { z } from 'zod';
|
|
import {
|
|
handleApiResult,
|
|
createErrorResponse,
|
|
getProjectRootFromSession
|
|
} from './utils.js';
|
|
import { analyzeTaskComplexityDirect } from '../core/task-master-core.js';
|
|
import { findTasksJsonPath } from '../core/utils/path-utils.js';
|
|
import path from 'path';
|
|
|
|
/**
|
|
* Register the analyze tool with the MCP server
|
|
* @param {Object} server - FastMCP server instance
|
|
*/
|
|
export function registerAnalyzeTool(server) {
|
|
server.addTool({
|
|
name: 'analyze_project_complexity',
|
|
description:
|
|
'Analyze task complexity and generate expansion recommendations',
|
|
parameters: z.object({
|
|
output: z
|
|
.string()
|
|
.optional()
|
|
.describe(
|
|
'Output file path for the report (default: scripts/task-complexity-report.json)'
|
|
),
|
|
model: z
|
|
.string()
|
|
.optional()
|
|
.describe(
|
|
'LLM model to use for analysis (defaults to configured model)'
|
|
),
|
|
threshold: z.coerce
|
|
.number()
|
|
.min(1)
|
|
.max(10)
|
|
.optional()
|
|
.describe(
|
|
'Minimum complexity score to recommend expansion (1-10) (default: 5)'
|
|
),
|
|
file: z
|
|
.string()
|
|
.optional()
|
|
.describe(
|
|
'Absolute path to the tasks file (default: tasks/tasks.json)'
|
|
),
|
|
research: z
|
|
.boolean()
|
|
.optional()
|
|
.describe('Use Perplexity AI for research-backed complexity analysis'),
|
|
projectRoot: z
|
|
.string()
|
|
.describe('The directory of the project. Must be an absolute path.')
|
|
}),
|
|
execute: async (args, { log, session }) => {
|
|
try {
|
|
log.info(
|
|
`Analyzing task complexity with args: ${JSON.stringify(args)}`
|
|
);
|
|
|
|
// Get project root from args or session
|
|
const rootFolder =
|
|
args.projectRoot || getProjectRootFromSession(session, log);
|
|
|
|
if (!rootFolder) {
|
|
return createErrorResponse(
|
|
'Could not determine project root. Please provide it explicitly or ensure your session contains valid root information.'
|
|
);
|
|
}
|
|
|
|
let tasksJsonPath;
|
|
try {
|
|
tasksJsonPath = findTasksJsonPath(
|
|
{ projectRoot: rootFolder, file: args.file },
|
|
log
|
|
);
|
|
} catch (error) {
|
|
log.error(`Error finding tasks.json: ${error.message}`);
|
|
return createErrorResponse(
|
|
`Failed to find tasks.json: ${error.message}`
|
|
);
|
|
}
|
|
|
|
const outputPath = args.output
|
|
? path.resolve(rootFolder, args.output)
|
|
: path.resolve(rootFolder, 'scripts', 'task-complexity-report.json');
|
|
|
|
const result = await analyzeTaskComplexityDirect(
|
|
{
|
|
tasksJsonPath: tasksJsonPath,
|
|
outputPath: outputPath,
|
|
model: args.model,
|
|
threshold: args.threshold,
|
|
research: args.research
|
|
},
|
|
log,
|
|
{ session }
|
|
);
|
|
|
|
if (result.success) {
|
|
log.info(`Task complexity analysis complete: ${result.data.message}`);
|
|
log.info(
|
|
`Report summary: ${JSON.stringify(result.data.reportSummary)}`
|
|
);
|
|
} else {
|
|
log.error(
|
|
`Failed to analyze task complexity: ${result.error.message}`
|
|
);
|
|
}
|
|
|
|
return handleApiResult(result, log, 'Error analyzing task complexity');
|
|
} catch (error) {
|
|
log.error(`Error in analyze tool: ${error.message}`);
|
|
return createErrorResponse(error.message);
|
|
}
|
|
}
|
|
});
|
|
}
|