claude-autopm 1.12.2 → 1.13.0

package/.github/workflows/test.yml

@@ -0,0 +1,50 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test-matrix:
+    name: test-matrix
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Run quick tests
+      run: npm test
+
+    - name: Check test coverage
+      run: npm run test:coverage
+
+  # Summary job that branch protection can depend on
+  test:
+    name: test
+    runs-on: ubuntu-latest
+    needs: test-matrix
+    if: always()
+    steps:
+      - name: Check test results
+        run: |
+          if [ "${{ needs.test-matrix.result }}" != "success" ]; then
+            echo "Tests failed"
+            exit 1
+          fi
+          echo "All tests passed"

package/README.md

@@ -41,6 +41,28 @@ ClaudeAutoPM uses a **hybrid approach** combining deterministic operations with
 - **Smart Context Management** - Never lose track of your work
 - **Automated Workflows** - From PRD to production deployment
 
+## 📺 Visual Walkthrough
+
+See ClaudeAutoPM in action - from installation to deployment:
+
+### 1️⃣ Install AutoPM
+![Install AutoPM](Video%201.gif)
+
+### 2️⃣ First Claude Execution
+![First Claude Execution](Video%202.gif)
+
+### 3️⃣ Creation of PRD
+![Create PRD](Video%203.gif)
+
+### 4️⃣ GitHub Sync and Start Working on Issues
+![GitHub Sync](Video%204.gif)
+
+### 5️⃣ Issues Finished
+![Issues Complete](Video%205.gif)
+
+### 6️⃣ Checking the Work Done (Web App + FastAPI)
+![Web App and FastAPI](Video%206.gif)
+
 ## 🚀 Get Started in 5 Minutes
 
 ### 🎯 Quick Start for New Users
@@ -215,7 +237,9 @@ autopm pm:epic-sync user-auth
 - **50+ Specialized AI Agents** - Python, React, K8s, AWS, and more
 - **Parallel Execution** - Multiple agents working simultaneously
 - **Cross-Platform** - GitHub, Azure DevOps, GitLab (coming soon)
-- **MCP Integration** - Context management and browser automation
+- **MCP Integration** - Model Context Protocol for live documentation, codebase analysis, and tool integration
+- **Agent Analysis** - Discover which agents use MCP and their configurations
+- **Interactive Diagnostics** - Comprehensive health checks and connection testing
 
 ### 🤖 Dynamic Agent Teams
 
@@ -262,6 +286,110 @@ git checkout -b feat/backend/new-api       # Auto-loads 'python_backend' team
 
 Teams support inheritance, so specialized teams automatically include base agents. The active team configuration is saved in your project and persists across sessions.
 
+## 🔌 MCP (Model Context Protocol) Management
+
+ClaudeAutoPM provides comprehensive MCP management for agent-to-tool integration. **39 out of 53 agents (74%)** use MCP servers for live documentation and external tool access.
+
+### Quick Start with MCP
+
+```bash
+# List all available MCP servers
+autopm mcp list
+
+# Check which agents use MCP
+autopm mcp agents
+🤖 Agents Using MCP
+
+✅ react-frontend-engineer
+   └─ context7-docs
+
+✅ python-backend-engineer
+   └─ context7-docs
+   └─ sqlite-mcp
+
+📊 Summary:
+   Total agents: 53
+   Using MCP: 39 (74%)
+
+# Enable MCP servers
+autopm mcp enable context7-docs
+autopm mcp enable github-mcp
+
+# Configure API keys interactively
+autopm mcp setup
+
+# Sync configuration
+autopm mcp sync
+```
+
+### MCP Commands
+
+#### **Agent Analysis**
+```bash
+autopm mcp agents              # List agents using MCP
+autopm mcp agents --by-server  # Group by MCP server
+autopm mcp agent <name>        # Show agent MCP config
+autopm mcp usage               # Usage statistics
+autopm mcp tree                # Dependency tree
+```
+
+#### **Configuration & Diagnostics**
+```bash
+autopm mcp setup               # Interactive API key setup
+autopm mcp diagnose            # Run diagnostics
+autopm mcp test <server>       # Test server connection
+autopm mcp status              # Show servers status
+```
+
+#### **Server Management**
+```bash
+autopm mcp list                # List available servers
+autopm mcp info <server>       # Server details
+autopm mcp enable <server>     # Enable server
+autopm mcp disable <server>    # Disable server
+autopm mcp sync                # Sync configuration
+```
+
+### MCP Server Types
+
+- **Documentation** - `context7-docs` for live framework documentation (React, Python, AWS, etc.)
+- **Codebase** - `context7-codebase` for project analysis and navigation
+- **GitHub** - `github-mcp` for repository operations
+- **Databases** - `sqlite-mcp`, `postgresql-mcp`, `mongodb-mcp` for data operations
+- **Browser** - `playwright-mcp` for E2E testing and automation
+
+### Example: Setting Up Context7
+
+```bash
+# 1. Enable context7 documentation server
+autopm mcp enable context7-docs
+
+# 2. Configure API key
+cat > .claude/.env << EOF
+CONTEXT7_API_KEY=your-api-key-here
+CONTEXT7_WORKSPACE=your-workspace-id
+EOF
+
+# 3. Sync configuration
+autopm mcp sync
+
+# 4. Verify setup
+autopm mcp diagnose
+
+# 5. Test connection
+autopm mcp test context7-docs
+```
+
+### MCP Benefits
+
+- ✅ **Live Documentation** - Agents access latest framework docs automatically
+- ✅ **Codebase Context** - Deep understanding of your project structure
+- ✅ **Tool Integration** - GitHub, databases, browsers, and more
+- ✅ **No Hallucinations** - Real-time data instead of outdated training
+- ✅ **Extensible** - Add custom MCP servers for your tools
+
+📖 **Full MCP Setup Guide**: [`MCP_SETUP_GUIDE.md`](./MCP_SETUP_GUIDE.md)
+
 ## 📚 Full Documentation
 
 For comprehensive guides, advanced features, and detailed configuration:
@@ -291,9 +419,17 @@ autopm azure:sprint-status
 autopm context:create
 ```
 
-### New in v1.9.x: Complete PM Command Suite
+### Latest Features (v1.12.x)
+
+**v1.12.2 - Smart Installation & Command Fixes**
+- **Smart Tool Detection** - Installer automatically detects Docker and kubectl availability
+- **Intelligent Defaults** - Installation options filtered based on available tools
+- **Command Format Fixes** - All PM scripts now use consistent `/pm:...` format
+- **Version Tracking** - Update command now properly detects installed versions
+
+**v1.9.x - Complete PM Command Suite**
 
-The latest release includes 17 new PM commands providing comprehensive project management capabilities:
+17 new PM commands providing comprehensive project management capabilities:
 
 #### **PRD & Epic Management**
 ```bash

package/autopm/.claude/config.json

@@ -1,4 +1,6 @@
 {
+  "version": "1.12.2",
+  "installed": "2025-09-30T09:00:00Z",
   "execution_strategy": {
     "mode": "adaptive"
   },

package/autopm/.claude/providers/azure/issue-show.js

@@ -1,293 +1 @@
-#!/usr/bin/env node
-
-/**
- * Azure DevOps Issue Show Command
- * Retrieves and displays work item details
- */
-
-class AzureIssueShow {
-  constructor(options = {}) {
-    this.config = options;
-    this.api = options.api || null;
-    this.connection = options.connection || null;
-  }
-
-  /**
-   * Execute the issue show command
-   * @param {Object} params - Command parameters
-   * @param {string|number} params.id - Work item ID
-   * @returns {Promise<Object>} Result object with success, data, and formatted output
-   */
-  async execute(params) {
-    if (!params || !params.id) {
-      throw new Error('Work Item ID is required');
-    }
-
-    const workItemId = parseInt(params.id);
-    if (isNaN(workItemId)) {
-      throw new Error('Invalid work item ID');
-    }
-
-    // Check for Azure DevOps token
-    if (!process.env.AZURE_DEVOPS_TOKEN && !this.config.token) {
-      throw new Error('Azure DevOps personal access token is required. Set AZURE_DEVOPS_TOKEN environment variable.');
-    }
-
-    // Get work item from API
-    let workItem;
-    try {
-      // Support both api and connection patterns
-      if (this.api && this.api.getWorkItem) {
-        workItem = await this.api.getWorkItem(workItemId);
-      } else if (this.connection && this.connection.getWorkItemTrackingApi) {
-        const witApi = await this.connection.getWorkItemTrackingApi();
-        workItem = await witApi.getWorkItem(workItemId);
-      } else {
-        const project = this.config.project || 'project';
-        throw new Error(`Work Item #${workItemId} not found in ${project}`);
-      }
-    } catch (error) {
-      const project = this.config.project || 'project';
-
-      // Handle specific error codes
-      if (error.statusCode === 404 || error.message.includes('not found')) {
-        throw new Error(`Work Item #${workItemId} not found in ${project}`);
-      }
-      if (error.statusCode === 403) {
-        throw new Error(`Access denied: Insufficient permissions to view Work Item #${workItemId} in ${project}`);
-      }
-      if (error.code === 'ETIMEDOUT' || error.code === 'ECONNABORTED') {
-        throw new Error(`Request timeout: Failed to retrieve Work Item #${workItemId} from Azure DevOps`);
-      }
-
-      // Re-throw original error if not handled
-      throw error;
-    }
-
-    // Validate work item structure
-    if (!workItem || typeof workItem !== 'object') {
-      throw new Error(`Invalid response: Unable to parse Work Item #${workItemId} data`);
-    }
-
-    // Check for required fields
-    if (!workItem.fields) {
-      throw new Error(`Azure DevOps API error: Invalid work item structure for #${workItemId}`);
-    }
-
-    // Map Azure DevOps work item to common format
-    const data = this.mapWorkItem(workItem);
-
-    // Format for display
-    const formatted = this.formatWorkItem(data);
-
-    return {
-      success: true,
-      data: data,
-      formatted: formatted
-    };
-  }
-
-  /**
-   * Extract work item ID from relation URL
-   */
-  extractWorkItemId(url) {
-    if (!url) return null;
-    const match = url.match(/workItems\/(\d+)$/);
-    return match ? parseInt(match[1]) : null;
-  }
-
-  /**
-   * Map Azure DevOps work item to common format
-   */
-  mapWorkItem(workItem) {
-    const fields = workItem.fields || {};
-    const relations = workItem.relations || [];
-
-    // Map work item type
-    const typeMap = {
-      'User Story': 'issue',
-      'Bug': 'bug',
-      'Task': 'task',
-      'Epic': 'epic',
-      'Feature': 'feature'
-    };
-
-    // Map state
-    const stateMap = {
-      'New': 'open',
-      'Active': 'in_progress',
-      'In Progress': 'in_progress',
-      'Resolved': 'in_review',  // Changed from 'resolved' to match test
-      'Closed': 'closed',
-      'Done': 'closed',
-      'Removed': 'cancelled'  // Added for Bug work items
-    };
-
-    // Extract parent/children relationships and attachments from relations
-    let parent = null;
-    const children = [];
-    let attachmentCount = 0;
-
-    relations.forEach(relation => {
-      if (relation.rel === 'System.LinkTypes.Hierarchy-Reverse') {
-        // Parent relationship
-        parent = this.extractWorkItemId(relation.url);
-      } else if (relation.rel === 'System.LinkTypes.Hierarchy-Forward') {
-        // Child relationship
-        const childId = this.extractWorkItemId(relation.url);
-        if (childId) children.push(childId);
-      } else if (relation.rel === 'AttachedFile') {
-        // Attachment
-        attachmentCount++;
-      }
-    });
-
-    return {
-      id: workItem.id,
-      type: typeMap[fields['System.WorkItemType']] || 'issue',
-      title: fields['System.Title'] || '',
-      description: fields['System.Description'] || '',
-      state: stateMap[fields['System.State']] || 'open',
-      assignee: fields['System.AssignedTo']?.displayName || fields['System.AssignedTo'] || null,
-      creator: fields['System.CreatedBy']?.displayName || fields['System.CreatedBy'] || null,
-      created_at: fields['System.CreatedDate'] || null,
-      updated_at: fields['System.ChangedDate'] || null,
-      priority: fields['Microsoft.VSTS.Common.Priority'] || null,
-      tags: fields['System.Tags'] ? fields['System.Tags'].split(';').map(t => t.trim()) : [],
-      project: fields['System.TeamProject'] || null,
-      area: fields['System.AreaPath'] || null,
-      iteration: fields['System.IterationPath'] || null,
-      url: workItem._links?.html?.href || null,
-      // Additional fields expected by tests
-      workItemType: fields['System.WorkItemType'],
-      areaPath: fields['System.AreaPath'] || null,
-      iterationPath: fields['System.IterationPath'] || null,
-      storyPoints: fields['Microsoft.VSTS.Scheduling.StoryPoints'] || null,
-      parent: parent,
-      children: children,
-      attachmentCount: attachmentCount,
-      acceptanceCriteria: fields['Microsoft.VSTS.Common.AcceptanceCriteria'] || null,
-      originalType: fields['System.WorkItemType'],
-      originalState: fields['System.State'],
-      // Metrics object
-      metrics: {
-        storyPoints: fields['Microsoft.VSTS.Scheduling.StoryPoints'] || 0,
-        effort: fields['Microsoft.VSTS.Scheduling.Effort'] || 0,
-        remainingWork: fields['Microsoft.VSTS.Scheduling.RemainingWork'] || 0,
-        completedWork: fields['Microsoft.VSTS.Scheduling.CompletedWork'] || 0,
-        originalEstimate: fields['Microsoft.VSTS.Scheduling.OriginalEstimate'] || 0
-      }
-    };
-  }
-
-  /**
-   * Format work item for display
-   */
-  formatWorkItem(data) {
-    const lines = [];
-    lines.push('═'.repeat(60));
-    lines.push(`${data.originalType || 'Work Item'} #${data.id}: ${data.title}`);
-    lines.push('═'.repeat(60));
-    lines.push('');
-    lines.push(`**Status:** ${data.state}`);
-    lines.push(`**Assignee:** ${data.assignee || 'Unassigned'}`);
-    lines.push(`**Priority:** ${data.priority || 'Not set'}`);
-    lines.push(`**Iteration:** ${data.iterationPath || data.iteration || 'Not set'}`);
-
-    // Add story points if present
-    if (data.metrics && data.metrics.storyPoints) {
-      lines.push(`**Story Points:** ${data.metrics.storyPoints}`);
-    }
-
-    // Add parent/children relationships
-    if (data.parent) {
-      lines.push(`**Parent:** #${data.parent}`);
-    }
-
-    if (data.children && data.children.length > 0) {
-      lines.push(`**Children:** ${data.children.map(c => `#${c}`).join(', ')}`);
-    }
-
-    // Add tags
-    if (data.tags && data.tags.length > 0) {
-      lines.push(`**Tags:** ${data.tags.join(', ')}`);
-    }
-
-    // Add work metrics
-    if (data.metrics) {
-      if (data.metrics.remainingWork > 0) {
-        lines.push(`**Remaining:** ${data.metrics.remainingWork}h`);
-      }
-      if (data.metrics.completedWork > 0) {
-        lines.push(`**Completed:** ${data.metrics.completedWork}h`);
-      }
-    }
-
-    if (data.created_at) {
-      lines.push(`**Created:** ${new Date(data.created_at).toLocaleString()}`);
-    }
-
-    if (data.updated_at) {
-      lines.push(`**Updated:** ${new Date(data.updated_at).toLocaleString()}`);
-    }
-
-    if (data.description) {
-      lines.push('');
-      lines.push('Description:');
-      lines.push('-'.repeat(60));
-      lines.push(data.description.substring(0, 500));
-      if (data.description.length > 500) {
-        lines.push('... (truncated)');
-      }
-    } else {
-      lines.push('');
-      lines.push('Description:');
-      lines.push('-'.repeat(60));
-      lines.push('_No description provided_');
-    }
-
-    // Generate Azure DevOps URL if not provided
-    if (data.url) {
-      lines.push('');
-      lines.push(`View Online: ${data.url}`);
-    } else if (this.config.organization && this.config.project) {
-      lines.push('');
-      lines.push('View in Azure DevOps:');
-      lines.push(`https://dev.azure.com/${this.config.organization}/${this.config.project}/_workitems/edit/${data.id}`);
-    }
-
-    lines.push('═'.repeat(60));
-
-    return lines.join('\n');
-  }
-
-  /**
-   * Run as CLI command
-   */
-  async run(args) {
-    const workItemId = args[0];
-
-    if (!workItemId) {
-      console.error('Error: Work Item ID is required');
-      console.error('Usage: azure-issue-show <work-item-id>');
-      process.exit(1);
-    }
-
-    try {
-      const result = await this.execute({ id: workItemId });
-      console.log(result.formatted);
-    } catch (error) {
-      console.error(`Error: ${error.message}`);
-      process.exit(1);
-    }
-  }
-}
-
-// Export for testing and module usage
-module.exports = AzureIssueShow;
-
-// Run if called directly
-if (require.main === module) {
-  const issueShow = new AzureIssueShow();
-  issueShow.run(process.argv.slice(2));
-}
+module.exports = function() { console.log("Should not execute"); };

package/bin/autopm.js

@@ -178,6 +178,8 @@ function main() {
     .command(require('./commands/team'))
     // Config management command
     .command(require('./commands/config'))
+    // MCP management command
+    .command(require('./commands/mcp'))
     // Global options
     .option('verbose', {
       type: 'boolean',
@@ -228,6 +230,24 @@ function main() {
    # Validate configuration
    autopm config validate
 
+🔌 MCP (Model Context Protocol) Management:
+   # List and manage MCP servers
+   autopm mcp list                  # List all available MCP servers
+   autopm mcp enable context7-docs  # Enable documentation server
+   autopm mcp sync                  # Sync configuration to .claude/mcp-servers.json
+
+   # Agent Analysis
+   autopm mcp agents                # List agents using MCP
+   autopm mcp agent react-frontend-engineer  # Show MCP config for agent
+   autopm mcp usage                 # Show MCP usage statistics
+   autopm mcp tree                  # Show agent-MCP dependency tree
+
+   # Configuration & Diagnostics
+   autopm mcp setup                 # Interactive API key setup
+   autopm mcp diagnose              # Run comprehensive diagnostics
+   autopm mcp test context7-docs    # Test MCP server connection
+   autopm mcp status                # Show all MCP servers status
+
 🔑 Token Setup:
    # GitHub PAT (Settings → Developer settings → Personal access tokens)
    Scopes: repo, workflow, admin:repo_hook