claude-autopm 1.17.0 → 1.20.0

package/bin/commands/team.js

@@ -2,6 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const MCPHandler = require('../../scripts/mcp-handler.js');
 
 // Paths
 const projectRoot = process.cwd();
@@ -68,6 +69,69 @@ function validateAgentFiles(agents, projectRoot) {
   return missingAgents;
 }
 
+// Helper function to validate MCP dependencies for agents
+function validateAgentMCPDependencies(agents, projectRoot) {
+  const warnings = [];
+
+  try {
+    const mcpHandler = new MCPHandler();
+    const config = mcpHandler.loadConfig();
+    const activeServers = config.mcp?.activeServers || [];
+
+    // Track all required MCP servers across all agents
+    const requiredServers = new Map(); // server -> [agents that need it]
+
+    agents.forEach(agentPath => {
+      // Extract agent name from path
+      // Handle both "core/test-runner.md" and "test-runner.md" formats
+      let agentName = agentPath;
+      if (agentName.endsWith('.md')) {
+        agentName = agentName.slice(0, -3); // Remove .md extension
+      }
+      // Get just the filename without directory
+      agentName = path.basename(agentName);
+
+      // Get MCP dependencies for this agent
+      const agentMCP = mcpHandler.getAgentMCP(agentName);
+
+      if (agentMCP.found && agentMCP.mcpServers.length > 0) {
+        agentMCP.mcpServers.forEach(serverName => {
+          if (!requiredServers.has(serverName)) {
+            requiredServers.set(serverName, []);
+          }
+          requiredServers.get(serverName).push(agentName);
+        });
+      }
+    });
+
+    // Check which required servers are missing or inactive
+    requiredServers.forEach((agentNames, serverName) => {
+      const isActive = activeServers.includes(serverName);
+      const serverExists = mcpHandler.getServer(serverName);
+
+      if (!serverExists) {
+        warnings.push({
+          type: 'not_installed',
+          server: serverName,
+          agents: agentNames
+        });
+      } else if (!isActive) {
+        warnings.push({
+          type: 'not_active',
+          server: serverName,
+          agents: agentNames
+        });
+      }
+    });
+
+  } catch (error) {
+    // If MCP validation fails, just warn but don't block
+    console.warn('⚠️  Warning: Could not validate MCP dependencies');
+  }
+
+  return warnings;
+}
+
 // Helper function to generate agent include list in Markdown format
 function generateAgentIncludes(agents) {
   return agents
@@ -216,6 +280,28 @@ const commands = {
         });
       }
 
+      // Validate MCP dependencies
+      const mcpWarnings = validateAgentMCPDependencies(agents, projectRoot);
+      if (mcpWarnings.length > 0) {
+        console.warn('\n⚠️  MCP Dependency Warnings:\n');
+
+        mcpWarnings.forEach(warning => {
+          if (warning.type === 'not_installed') {
+            console.warn(`❌ MCP server '${warning.server}' is NOT INSTALLED`);
+            console.warn(`   Required by: ${warning.agents.join(', ')}`);
+            console.warn(`   Fix: autopm mcp install ${warning.server}`);
+          } else if (warning.type === 'not_active') {
+            console.warn(`⚪ MCP server '${warning.server}' is NOT ACTIVE`);
+            console.warn(`   Required by: ${warning.agents.join(', ')}`);
+            console.warn(`   Fix: autopm mcp enable ${warning.server}`);
+          }
+          console.warn('');
+        });
+
+        console.warn('💡 Tip: Run "autopm mcp list" to see all MCP servers');
+        console.warn('💡 Tip: Run "autopm mcp setup" for interactive configuration\n');
+      }
+
       // Update CLAUDE.md with the new agent list
       updateClaudeMd(agents);
       console.log('✓ Updated CLAUDE.md with team agents');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "1.17.0",
+  "version": "1.20.0",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "bin": {

package/lib/agentExecutor.js.deprecated

@@ -1,101 +0,0 @@
-/**
- * Agent Executor Module
- * Handles execution of AI agents with prompts
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const { spawn } = require('child_process');
-const colors = require('./utils/colors');
-
-class AgentExecutor {
-  constructor() {
-    this.agentsPath = path.join(__dirname, '../autopm/.claude/agents');
-  }
-
-  /**
-   * Execute an agent with the given prompt
-   * @param {string} agentType - The type of agent to execute
-   * @param {string} prompt - The prompt to send to the agent
-   * @param {Object} context - Additional context for the agent
-   * @returns {Promise<Object>} The result of the agent execution
-   */
-  async run(agentType, prompt, context = {}) {
-    console.log(colors.blue(`🤖 Preparing ${agentType} agent...`));
-
-    try {
-      // Replace $ARGUMENTS in prompt with actual arguments
-      let finalPrompt = prompt;
-      if (context.arguments) {
-        finalPrompt = prompt.replace(/\$ARGUMENTS/g, context.arguments);
-      }
-
-      // Check if we're in Claude Code environment
-      const isClaudeCode = process.env.CLAUDE_CODE === 'true' ||
-                          process.env.ANTHROPIC_WORKSPACE === 'true';
-
-      if (isClaudeCode) {
-        // If in Claude Code, use the Task tool
-        console.log(colors.cyan('📋 Executing via Claude Code Task tool...'));
-        console.log(colors.gray('Prompt:'), finalPrompt.substring(0, 200) + '...');
-
-        // Claude Code should handle this through its Task tool
-        // This would be invoked by Claude when running the command
-        return {
-          status: 'success',
-          agent: agentType,
-          message: 'Agent should be executed via Claude Code Task tool',
-          prompt: finalPrompt,
-          context: context
-        };
-      }
-
-      // Not in Claude Code - show instructions
-      console.log();
-      console.log(colors.yellow('⚠️  This command requires Claude Code'));
-      console.log();
-      console.log(colors.cyan('To use AI-powered commands:'));
-      console.log();
-      console.log(colors.green('1. Open your project in Claude Code'));
-      console.log(colors.gray('2. Run commands directly in chat:'));
-      console.log(colors.gray(`   /pm:prd-new ${context.arguments || 'feature-name'}`));
-      console.log();
-      console.log(colors.blue('Why Claude Code?'));
-      console.log(colors.gray('• Interactive brainstorming sessions'));
-      console.log(colors.gray('• Intelligent context understanding'));
-      console.log(colors.gray('• Real-time Q&A during PRD creation'));
-      console.log();
-      console.log(colors.cyan('📝 What this command would do:'));
-      console.log(colors.gray('─'.repeat(60)));
-
-      // Show a summary of the command intent
-      if (agentType === 'pm-specialist' && context.arguments) {
-        console.log(colors.white(`Create PRD for: ${context.arguments}`));
-        console.log();
-        console.log('The AI agent would:');
-        console.log('1. Ask clarifying questions about the feature');
-        console.log('2. Help define user stories and requirements');
-        console.log('3. Generate comprehensive PRD document');
-        console.log(`4. Save to: .claude/prds/${context.arguments}.md`);
-      } else {
-        console.log(finalPrompt.substring(0, 300) + '...');
-      }
-      console.log(colors.gray('─'.repeat(60)));
-
-      return {
-        status: 'claude-required',
-        agent: agentType,
-        message: 'Claude Code required for AI-powered commands',
-        prompt: finalPrompt,
-        context: context
-      };
-
-    } catch (error) {
-      console.error(colors.red(`❌ Agent execution failed: ${error.message}`));
-      throw error;
-    }
-  }
-
-}
-
-module.exports = new AgentExecutor();

package/lib/azure/cache.js

@@ -1,80 +0,0 @@
-/**
- * Simple cache implementation for Azure DevOps API responses
- * Uses LRU (Least Recently Used) eviction policy
- */
-
-class AzureCache {
-  constructor(options = {}) {
-    this.ttl = options.ttl || 5 * 60 * 1000; // 5 minutes default
-    this.maxSize = options.maxSize || 100;
-    this.cache = new Map();
-    this.stats = { hits: 0, misses: 0 };
-  }
-
-  get(key) {
-    const item = this.cache.get(key);
-
-    if (!item) {
-      this.stats.misses++;
-      return null;
-    }
-
-    if (this.isExpired(item)) {
-      this.cache.delete(key);
-      this.stats.misses++;
-      return null;
-    }
-
-    // Move to end (most recently used)
-    this.cache.delete(key);
-    this.cache.set(key, item);
-
-    this.stats.hits++;
-    return item.value;
-  }
-
-  set(key, value) {
-    // Remove oldest item if at capacity
-    if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-      const firstKey = this.cache.keys().next().value;
-      this.cache.delete(firstKey);
-    }
-
-    this.cache.set(key, {
-      value,
-      timestamp: Date.now()
-    });
-  }
-
-  isExpired(item) {
-    return Date.now() - item.timestamp > this.ttl;
-  }
-
-  clear() {
-    this.cache.clear();
-    this.stats = { hits: 0, misses: 0 };
-  }
-
-  getStats() {
-    const total = this.stats.hits + this.stats.misses;
-    const hitRate = total > 0 ? (this.stats.hits / total * 100).toFixed(2) : 0;
-
-    return {
-      ...this.stats,
-      hitRate: `${hitRate}%`,
-      size: this.cache.size,
-      maxSize: this.maxSize
-    };
-  }
-
-  // Clean up expired entries
-  cleanup() {
-    for (const [key, item] of this.cache.entries()) {
-      if (this.isExpired(item)) {
-        this.cache.delete(key);
-      }
-    }
-  }
-}
-
-module.exports = AzureCache;

package/lib/azure/client.js

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Azure DevOps Client
- * Wrapper for Azure DevOps REST API
- */
-
-class AzureDevOpsClient {
-  constructor(options = {}) {
-    this.organization = options.organization;
-    this.project = options.project;
-    this.token = options.token;
-    this.baseUrl = `https://dev.azure.com/${this.organization}`;
-  }
-
-  /**
-   * Create work item
-   */
-  async createWorkItem(options) {
-    // This would make actual API call
-    console.log(`Creating ${options.type} work item`);
-    return {
-      id: Math.floor(Math.random() * 10000),
-      fields: options.fields,
-      url: `${this.baseUrl}/${this.project}/_workitems/edit/${Math.floor(Math.random() * 10000)}`
-    };
-  }
-
-  /**
-   * Update work item
-   */
-  async updateWorkItem(options) {
-    console.log(`Updating work item ${options.id}`);
-    return {
-      id: options.id,
-      fields: options.fields
-    };
-  }
-
-  /**
-   * Get work item
-   */
-  async getWorkItem(options) {
-    console.log(`Getting work item ${options.id}`);
-    return {
-      id: options.id,
-      fields: {
-        'System.Title': 'Work Item',
-        'System.State': 'Active'
-      }
-    };
-  }
-}
-
-/**
- * Create client instance
- */
-function createClient(options) {
-  return new AzureDevOpsClient(options);
-}
-
-/**
- * Get default client
- */
-function getClient() {
-  return createClient({
-    organization: process.env.AZURE_DEVOPS_ORG,
-    project: process.env.AZURE_DEVOPS_PROJECT,
-    token: process.env.AZURE_DEVOPS_PAT
-  });
-}
-
-module.exports = {
-  AzureDevOpsClient,
-  createClient,
-  getClient
-};

package/lib/azure/formatter.js

@@ -1,177 +0,0 @@
-/**
- * Azure DevOps Output Formatter
- * Formats work items and sprint data for console display
- */
-
-const Table = require('table').table;
-const chalk = require('chalk');
-
-class AzureFormatter {
-  static formatWorkItems(items, options = {}) {
-    if (!items || items.length === 0) {
-      return chalk.yellow('No work items found.');
-    }
-
-    const headers = this.getHeaders(options);
-    const rows = items.map(item => this.formatWorkItem(item, options));
-
-    const tableConfig = {
-      header: {
-        alignment: 'center',
-        content: chalk.cyan.bold('Work Items')
-      }
-    };
-
-    return Table([headers, ...rows], tableConfig);
-  }
-
-  static getHeaders(options) {
-    const headers = [
-      chalk.bold('ID'),
-      chalk.bold('Type'),
-      chalk.bold('Title'),
-      chalk.bold('State'),
-      chalk.bold('Assigned To')
-    ];
-
-    if (options.showRemaining) {
-      headers.push(chalk.bold('Remaining'));
-    }
-
-    if (options.showPriority) {
-      headers.push(chalk.bold('Priority'));
-    }
-
-    return headers;
-  }
-
-  static formatWorkItem(item, options) {
-    const fields = item.fields || {};
-    const row = [
-      chalk.blue(item.id),
-      this.getTypeIcon(fields['System.WorkItemType']),
-      this.truncate(fields['System.Title'], 50),
-      this.getStateColor(fields['System.State']),
-      this.getAssignedTo(fields['System.AssignedTo'])
-    ];
-
-    if (options.showRemaining) {
-      row.push(fields['Microsoft.VSTS.Scheduling.RemainingWork'] || '-');
-    }
-
-    if (options.showPriority) {
-      row.push(fields['Microsoft.VSTS.Common.Priority'] || '-');
-    }
-
-    return row;
-  }
-
-  static getTypeIcon(type) {
-    const icons = {
-      'Task': '📋 Task',
-      'Bug': '🐛 Bug',
-      'User Story': '📖 Story',
-      'Feature': '🎯 Feature',
-      'Epic': '🏔️  Epic'
-    };
-    return icons[type] || type;
-  }
-
-  static getStateColor(state) {
-    const colors = {
-      'New': chalk.gray(state),
-      'Active': chalk.blue(state),
-      'In Progress': chalk.yellow(state),
-      'Resolved': chalk.green(state),
-      'Closed': chalk.dim(state),
-      'Done': chalk.green(state),
-      'Removed': chalk.strikethrough(state)
-    };
-    return colors[state] || state;
-  }
-
-  static getAssignedTo(assignedTo) {
-    if (!assignedTo) return chalk.gray('Unassigned');
-    const name = assignedTo.displayName || assignedTo.uniqueName || assignedTo;
-    return this.truncate(name, 20);
-  }
-
-  static truncate(text, length) {
-    if (!text) return '';
-    if (text.length <= length) return text;
-    return text.substring(0, length - 3) + '...';
-  }
-
-  static formatSummary(items) {
-    if (!items || items.length === 0) {
-      return '';
-    }
-
-    const states = {};
-    const types = {};
-    let totalRemaining = 0;
-
-    items.forEach(item => {
-      const fields = item.fields || {};
-      const state = fields['System.State'];
-      const type = fields['System.WorkItemType'];
-      const remaining = fields['Microsoft.VSTS.Scheduling.RemainingWork'] || 0;
-
-      states[state] = (states[state] || 0) + 1;
-      types[type] = (types[type] || 0) + 1;
-      totalRemaining += remaining;
-    });
-
-    const lines = [];
-    lines.push(chalk.bold('\n📊 Summary:'));
-    lines.push(`Total items: ${chalk.cyan(items.length)}`);
-
-    if (Object.keys(types).length > 0) {
-      lines.push('\nBy Type:');
-      Object.entries(types).forEach(([type, count]) => {
-        lines.push(`  ${this.getTypeIcon(type)}: ${count}`);
-      });
-    }
-
-    if (Object.keys(states).length > 0) {
-      lines.push('\nBy State:');
-      Object.entries(states).forEach(([state, count]) => {
-        lines.push(`  ${this.getStateColor(state)}: ${count}`);
-      });
-    }
-
-    if (totalRemaining > 0) {
-      lines.push(`\nTotal Remaining Work: ${chalk.yellow(totalRemaining + ' hours')}`);
-    }
-
-    return lines.join('\n');
-  }
-
-  static formatSprintInfo(sprint) {
-    if (!sprint) {
-      return chalk.yellow('No active sprint found.');
-    }
-
-    const attributes = sprint.attributes || {};
-    const startDate = attributes.startDate ? new Date(attributes.startDate).toLocaleDateString() : 'N/A';
-    const endDate = attributes.finishDate ? new Date(attributes.finishDate).toLocaleDateString() : 'N/A';
-
-    return chalk.cyan.bold(`\n🏃 Current Sprint: ${sprint.name}\n`) +
-           `  Start: ${startDate}\n` +
-           `  End: ${endDate}\n`;
-  }
-
-  static formatError(error) {
-    return chalk.red(`\n❌ Error: ${error.message}\n`);
-  }
-
-  static formatSuccess(message) {
-    return chalk.green(`\n✅ ${message}\n`);
-  }
-
-  static formatWarning(message) {
-    return chalk.yellow(`\n⚠️  ${message}\n`);
-  }
-}
-
-module.exports = AzureFormatter;