mcp-github-project-manager

Instructions

Implementation Reference

• src/infrastructure/tools/ai-tasks/GetNextTaskTool.ts:27-127 (handler)

  Main execution function for the 'get_next_task' tool. Handles input args, generates mock tasks (placeholder for real integration), applies filters, prioritizes, generates AI analysis, and formats comprehensive response.
  async function executeGetNextTask(args: GetNextTaskArgs): Promise<MCPResponse> { const taskService = new TaskGenerationService(); try { // For now, create mock tasks for demonstration // In a full implementation, this would integrate with ResourceManager const mockTasks = [ { id: 'task-1', title: 'Set up project infrastructure', description: 'Initialize project structure, CI/CD, and development environment', priority: 'high', complexity: 4, estimatedHours: 8, status: 'pending', dependencies: [], tags: ['setup', 'infrastructure'] }, { id: 'task-2', title: 'Implement user authentication', description: 'Create login, registration, and password reset functionality', priority: 'critical', complexity: 6, estimatedHours: 16, status: 'pending', dependencies: ['task-1'], tags: ['auth', 'security'] }, { id: 'task-3', title: 'Design database schema', description: 'Create database tables and relationships for core entities', priority: 'high', complexity: 5, estimatedHours: 12, status: 'pending', dependencies: ['task-1'], tags: ['database', 'design'] } ]; // Apply filters let filteredTasks = mockTasks; if (args.maxComplexity) { filteredTasks = filteredTasks.filter(task => task.complexity <= args.maxComplexity!); } if (args.assignee) { // Would filter by assignee in real implementation } // Get recommendations (simplified) const recommendations = filteredTasks .sort((a, b) => { // Sort by priority first, then complexity const priorityOrder = { critical: 4, high: 3, medium: 2, low: 1 }; const priorityDiff = (priorityOrder[b.priority as keyof typeof priorityOrder] || 0) - (priorityOrder[a.priority as keyof typeof priorityOrder] || 0); if (priorityDiff !== 0) return priorityDiff; return a.complexity - b.complexity; // Prefer lower complexity }) .slice(0, args.limit); // Calculate sprint fit const totalHours = recommendations.reduce((sum, task) => sum + task.estimatedHours, 0); const sprintCapacity = args.sprintCapacity || 40; const sprintFit = totalHours <= sprintCapacity; // Generate AI analysis const analysis = args.includeAnalysis ? generateTaskAnalysis(recommendations, args) : null; // Format response const summary = formatNextTaskRecommendations(recommendations, analysis, { totalHours, sprintCapacity, sprintFit, filtersApplied: getAppliedFilters(args) }); return ToolResultFormatter.formatSuccess('get_next_task', { summary, recommendations, analysis, metrics: { totalTasks: recommendations.length, totalHours, sprintCapacity, sprintFit } }); } catch (error) { process.stderr.write(`Error in get_next_task tool: ${error}\n`); return ToolResultFormatter.formatSuccess('get_next_task', { error: `Failed to get task recommendations: ${error instanceof Error ? error.message : 'Unknown error'}`, success: false }); } }
• src/infrastructure/tools/ai-tasks/GetNextTaskTool.ts:8-20 (schema)

  Zod input schema validation for get_next_task tool parameters.
  const getNextTaskSchema = z.object({ projectId: z.string().optional().describe('Filter tasks by specific project ID'), featureId: z.string().optional().describe('Filter tasks by specific feature ID'), assignee: z.string().optional().describe('Filter tasks for specific team member'), teamSkills: z.array(z.string()).optional().describe('Team skills to match against task requirements'), sprintCapacity: z.number().optional().describe('Available hours in current sprint (default: 40)'), currentPhase: z.enum(['planning', 'development', 'testing', 'review', 'deployment']).optional() .describe('Focus on tasks in specific phase'), excludeBlocked: z.boolean().default(true).describe('Whether to exclude blocked tasks'), maxComplexity: z.number().min(1).max(10).optional().describe('Maximum task complexity to consider'), includeAnalysis: z.boolean().default(true).describe('Whether to include detailed AI analysis'), limit: z.number().min(1).max(20).default(5).describe('Maximum number of tasks to recommend') });
• src/infrastructure/tools/ToolRegistry.ts:268-277 (registration)

  Registration of the getNextTaskTool in the central ToolRegistry singleton instance during built-in tools initialization.
  // Register AI task management tools this.registerTool(addFeatureTool); this.registerTool(generatePRDTool); this.registerTool(parsePRDTool); this.registerTool(getNextTaskTool); this.registerTool(analyzeTaskComplexityTool); this.registerTool(expandTaskTool); this.registerTool(enhancePRDTool); this.registerTool(createTraceabilityMatrixTool);
• src/infrastructure/tools/ai-tasks/GetNextTaskTool.ts:287-305 (registration)

  ToolDefinition object that registers the get_next_task tool with name, description, schema, and usage examples.
  export const getNextTaskTool: ToolDefinition<GetNextTaskArgs> = { name: "get_next_task", description: "Get AI-powered recommendations for the next task to work on based on priorities, dependencies, team capacity, and current project state", schema: getNextTaskSchema as unknown as ToolSchema<GetNextTaskArgs>, examples: [ { name: "Get next task for development", description: "Get the next recommended task for a developer with specific skills", args: { teamSkills: ["typescript", "react", "node.js"], sprintCapacity: 40, maxComplexity: 7, excludeBlocked: true, includeAnalysis: true, limit: 3 } } ] };
• src/infrastructure/tools/ai-tasks/GetNextTaskTool.ts:168-284 (helper)

  Key helper function that formats task recommendations into a detailed, structured Markdown report including overview, analysis, task details, and next steps.
  function formatNextTaskRecommendations( tasks: any[], analysis: string | null, metrics: any ): string { const sections = [ '# Next Task Recommendations', '', '## Overview', `**Recommended Tasks:** ${tasks.length}`, `**Total Effort:** ${metrics.totalHours} hours`, `**Sprint Capacity:** ${metrics.sprintCapacity} hours`, `**Sprint Fit:** ${metrics.sprintFit ? '✅ Fits in sprint' : '⚠️ Exceeds capacity'}`, '' ]; // Applied filters if (metrics.filtersApplied.length > 0) { sections.push( '**Applied Filters:**', ...metrics.filtersApplied.map((filter: string) => `- ${filter}`), '' ); } // AI Analysis if (analysis) { sections.push( '## AI Analysis', analysis, '' ); } // Task recommendations if (tasks.length === 0) { sections.push( '## No Tasks Available', 'No tasks match your criteria or all tasks are completed/blocked.', '', '**Suggestions:**', '- Remove some filters to see more tasks', '- Check if there are blocked tasks that need attention', '- Consider adding new features with `add_feature`' ); } else { sections.push('## Recommended Tasks'); tasks.forEach((task, index) => { sections.push( `### ${index + 1}. ${task.title}`, `**Priority:** ${task.priority} | **Complexity:** ${task.complexity}/10 | **Effort:** ${task.estimatedHours}h`, `**Status:** ${task.status}`, '' ); if (task.description) { sections.push( `**Description:** ${task.description}`, '' ); } if (task.dependencies.length > 0) { sections.push( `**Dependencies:** ${task.dependencies.length} items`, '' ); } if (task.tags.length > 0) { sections.push( `**Tags:** ${task.tags.join(', ')}`, '' ); } sections.push('---', ''); }); // Priority breakdown const priorityBreakdown = tasks.reduce((acc, task) => { acc[task.priority] = (acc[task.priority] || 0) + 1; return acc; }, {}); sections.push( '## Summary', '**Priority Breakdown:**', ...Object.entries(priorityBreakdown).map(([priority, count]) => `- ${priority}: ${count} task${(count as number) > 1 ? 's' : ''}` ), '' ); } // Next steps sections.push( '## Next Steps', '1. Review the recommended tasks and select one to start', '2. Use `update_task_lifecycle` to begin work and track progress', '3. Use `expand_task` if any task seems too complex', '4. Check dependencies before starting work', '' ); // Related commands sections.push( '## Related Commands', '- `update_task_lifecycle` - Start work and track progress', '- `expand_task` - Break down complex tasks', '- `analyze_task_complexity` - Get detailed complexity analysis', '- `add_feature` - Add new features if no suitable tasks available' ); return sections.join('\n'); }