claude-autopm 1.31.0 → 2.1.1

package/README.md

@@ -15,7 +15,7 @@ Transform your development workflow with intelligent automation, parallel AI age
 
 ClaudeAutoPM is a comprehensive project management and development automation framework designed specifically for [Claude Code](https://claude.ai/code). It combines:
 
-- **109+ CLI commands** for deterministic operations (scaffolding, templates, automation)
+- **112+ CLI commands** for deterministic operations (scaffolding, templates, automation)
 - **39 specialized AI agents** for intelligent tasks (analysis, design, development)
 - **Dynamic team management** with automatic agent switching
 - **Hybrid execution modes** - choose between templates or AI assistance
@@ -44,7 +44,58 @@ PRD → Epic Decomposition → Parallel Development → Testing → Production
 
 ## ✨ Key Features
 
-### 🆕 **NEW in v1.30.0: Advanced Conflict Resolution - Complete Sync Safety!**
+### 🆕 **NEW in v2.1.0: STANDALONE CLI Commands - Direct Service Access!**
+
+**Three New CLI Commands** - Direct access to service layer without AI overhead
+- 🎯 **Deterministic Operations** - Fast, predictable, no AI required
+- 🎨 **Modern UX** - Progress spinners, color-coded output, streaming support
+- ⚡ **High Performance** - Direct service layer access for instant results
+- 🧪 **100% Test Coverage** - 65 CLI tests passing, full TDD methodology
+
+**New Commands:**
+
+```bash
+# PRD Management
+autopm prd parse my-prd --ai          # AI-powered PRD parsing
+autopm prd parse my-prd --stream      # Real-time streaming output
+autopm prd extract-epics my-prd       # Extract epics from PRD
+autopm prd summarize my-prd           # Generate comprehensive summary
+autopm prd validate my-prd            # Validate structure & quality
+
+# Task Management
+autopm task list epic-001             # Display all tasks from epic
+autopm task prioritize epic-001       # AI-powered prioritization
+
+# Agent Invocation
+autopm agent list                     # Display available agents
+autopm agent search "kubernetes"      # Search agents by keyword
+autopm agent invoke aws-architect "Design VPC"  # Invoke agent with task
+autopm agent invoke --stream agent-name "task"  # Streaming invocation
+```
+
+**User Experience Features:**
+- 🔄 Progress indicators with ora spinners
+- 🎨 Color-coded output (green=success, red=error, yellow=warning)
+- 📡 Streaming support for real-time AI responses
+- ❌ Comprehensive error handling with user-friendly messages
+- 📋 Consistent patterns across all commands
+
+**Technical Implementation:**
+- Extended PRDService with 4 non-streaming methods
+- All services support both streaming and non-streaming modes
+- Proper separation of concerns (CLI → Service → Provider)
+- Zero breaking changes to existing functionality
+- CommonJS compatibility maintained
+
+**Test Coverage:**
+- 28 new tests across 3 CLI command suites
+- 65 total CLI tests passing (100% pass rate)
+- Full TDD methodology with Jest
+- Comprehensive coverage of success, error, and streaming scenarios
+
+---
+
+### 🎉 **v1.30.0: Advanced Conflict Resolution - Complete Sync Safety!**
 
 **Three-Way Merge Conflict Resolution** - Safe GitHub synchronization
 - 🔒 **Intelligent Merge** - Three-way diff (local/remote/base) with conflict detection
@@ -341,7 +392,7 @@ claude --dangerously-skip-permissions .
 │                                                               │
 │  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐       │
 │  │ CLI Layer   │  │ Agent Teams  │  │ MCP Servers  │       │
-│  │ (109 cmds)  │  │ (39 agents)  │  │ (Context7)   │       │
+│  │ (112 cmds)  │  │ (39 agents)  │  │ (Context7)   │       │
 │  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘       │
 │         │                 │                  │                │
 │         └─────────────────┼──────────────────┘                │
@@ -351,6 +402,7 @@ claude --dangerously-skip-permissions .
 │  │  - Sequential / Adaptive / Hybrid                │        │
 │  │  - Parallel agent coordination                   │        │
 │  │  - Context optimization                          │        │
+│  │  - STANDALONE mode (direct service access)       │        │
 │  └────────────────────────┬─────────────────────────┘        │
 │                           │                                   │
 │  ┌────────────────────────┴─────────────────────────┐        │
@@ -405,8 +457,8 @@ claude --dangerously-skip-permissions .
 
 ## 📦 What's Included
 
-### CLI Commands (109 total)
-- **Project Management**: PRD, Epic, Issue, Task management
+### CLI Commands (112 total)
+- **Project Management**: PRD, Epic, Issue, Task management (3 new STANDALONE commands in v2.1.0)
 - **Development**: Scaffolding, testing, deployment
 - **Configuration**: Provider setup, team management, MCP servers
 - **DevOps**: Docker, Kubernetes, CI/CD automation

package/autopm/.claude/mcp/test-server.md

@@ -0,0 +1,10 @@
+
+# Test Server
+
+```json
+{
+  "name": "test-server",
+  "command": "npx",
+  "args": ["test-package"]
+}
+```

package/bin/autopm-poc.js

@@ -16,30 +16,38 @@ const fs = require('fs');
 const path = require('path');
 const ClaudeProvider = require('../lib/ai-providers/ClaudeProvider');
 const PRDService = require('../lib/services/PRDService');
+const EpicService = require('../lib/services/EpicService');
+const ConfigManager = require('../lib/config/ConfigManager');
+const ServiceFactory = require('../lib/utils/ServiceFactory');
 
 /**
  * Print usage information
  */
 function printUsage() {
   console.log(`
-AutoPM POC - Claude API Integration Demo
-=========================================
+AutoPM POC - Claude API Integration Demo (Streaming Support)
+=============================================================
 
 Usage:
-  autopm-poc parse <prd-file>          Parse PRD with streaming output
-  autopm-poc parse <prd-file> --json   Parse PRD and extract epics as JSON
-  autopm-poc summarize <prd-file>      Get one-paragraph summary
+  autopm-poc parse <prd-file>          Parse PRD with streaming AI analysis
+  autopm-poc extract-epics <prd-file>  Extract epics from PRD (streaming)
+  autopm-poc summarize <prd-file>      Get PRD summary (streaming)
+  autopm-poc decompose <epic-file>     Decompose epic into tasks (streaming)
+  autopm-poc analyze <prd-file>        Epic-level PRD analysis (streaming)
   autopm-poc test                      Test API connection
   autopm-poc help                      Show this help message
 
 Environment Variables:
   ANTHROPIC_API_KEY                    Required - Your Anthropic API key
+  AUTOPM_MASTER_PASSWORD               Optional - For encrypted config
 
 Examples:
   export ANTHROPIC_API_KEY="sk-ant-..."
   autopm-poc parse examples/sample-prd.md
+  autopm-poc extract-epics examples/sample-prd.md
   autopm-poc summarize examples/sample-prd.md
-  autopm-poc parse examples/sample-prd.md --json
+  autopm-poc decompose .claude/epics/user-auth.md
+  autopm-poc analyze examples/sample-prd.md
 `);
 }
 
@@ -89,39 +97,97 @@ async function parsePRDStream(service, content) {
 }
 
 /**
- * Parse PRD and extract epics as JSON
+ * Extract epics from PRD with streaming output
  */
-async function parsePRDJson(service, content) {
-  console.log('🔍 Extracting epics from PRD...\n');
+async function extractEpicsStream(service, content) {
+  console.log('🔍 Extracting epics from PRD with Claude AI...\n');
+  console.log('📝 Streaming response:\n');
+  console.log('─'.repeat(60));
+
+  let fullResponse = '';
+  try {
+    for await (const chunk of service.extractEpicsStream(content)) {
+      process.stdout.write(chunk);
+      fullResponse += chunk;
+    }
+
+    console.log('\n' + '─'.repeat(60));
+    console.log('\n✅ Epic extraction complete!');
+    console.log(`📊 Total response length: ${fullResponse.length} characters\n`);
+  } catch (error) {
+    console.error('\n❌ Error during epic extraction:', error.message);
+    process.exit(1);
+  }
+}
 
+/**
+ * Summarize PRD with streaming output
+ */
+async function summarizePRDStream(service, content) {
+  console.log('🔍 Summarizing PRD with Claude AI...\n');
+  console.log('📝 Streaming response:\n');
+  console.log('─'.repeat(60));
+
+  let fullResponse = '';
   try {
-    const epics = await service.extractEpics(content);
+    for await (const chunk of service.summarizeStream(content)) {
+      process.stdout.write(chunk);
+      fullResponse += chunk;
+    }
 
-    console.log('✅ Extraction complete!\n');
-    console.log('📋 Extracted Epics:\n');
-    console.log(JSON.stringify(epics, null, 2));
-    console.log(`\n📊 Found ${Array.isArray(epics) ? epics.length : 0} epic(s)\n`);
+    console.log('\n' + '─'.repeat(60));
+    console.log('\n✅ Summary complete!');
+    console.log(`📊 Total response length: ${fullResponse.length} characters\n`);
   } catch (error) {
-    console.error('❌ Error during JSON extraction:', error.message);
+    console.error('\n❌ Error during summarization:', error.message);
     process.exit(1);
   }
 }
 
 /**
- * Summarize PRD
+ * Decompose epic into tasks with streaming output
  */
-async function summarizePRD(service, content) {
-  console.log('🔍 Summarizing PRD...\n');
+async function decomposeEpicStream(epicService, content) {
+  console.log('🔍 Decomposing epic into tasks with Claude AI...\n');
+  console.log('📝 Streaming response:\n');
+  console.log('─'.repeat(60));
 
+  let fullResponse = '';
   try {
-    const summary = await service.summarize(content);
+    for await (const chunk of epicService.decomposeStream(content)) {
+      process.stdout.write(chunk);
+      fullResponse += chunk;
+    }
 
-    console.log('✅ Summary complete!\n');
-    console.log('📝 Summary:\n');
-    console.log(summary);
-    console.log();
+    console.log('\n' + '─'.repeat(60));
+    console.log('\n✅ Task decomposition complete!');
+    console.log(`📊 Total response length: ${fullResponse.length} characters\n`);
   } catch (error) {
-    console.error('❌ Error during summarization:', error.message);
+    console.error('\n❌ Error during decomposition:', error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Analyze PRD for epic breakdown with streaming output
+ */
+async function analyzePRDStream(epicService, content) {
+  console.log('🔍 Analyzing PRD for epic breakdown with Claude AI...\n');
+  console.log('📝 Streaming response:\n');
+  console.log('─'.repeat(60));
+
+  let fullResponse = '';
+  try {
+    for await (const chunk of epicService.analyzeStream(content)) {
+      process.stdout.write(chunk);
+      fullResponse += chunk;
+    }
+
+    console.log('\n' + '─'.repeat(60));
+    console.log('\n✅ PRD analysis complete!');
+    console.log(`📊 Total response length: ${fullResponse.length} characters\n`);
+  } catch (error) {
+    console.error('\n❌ Error during PRD analysis:', error.message);
     process.exit(1);
   }
 }
@@ -139,18 +205,55 @@ async function main() {
     process.exit(0);
   }
 
-  // Check for API key
-  const apiKey = process.env.ANTHROPIC_API_KEY;
-  if (!apiKey) {
-    console.error('❌ Error: ANTHROPIC_API_KEY environment variable required\n');
-    console.error('Set it with:');
-    console.error('  export ANTHROPIC_API_KEY="sk-ant-..."\n');
-    process.exit(1);
+  // Try ConfigManager first, fallback to environment variable
+  let prdService;
+  let epicService;
+  let provider;
+  let configManager;
+
+  const configPath = path.join(process.cwd(), '.autopm', 'config.json');
+  if (fs.existsSync(configPath)) {
+    try {
+      configManager = new ConfigManager(configPath);
+
+      // Check for master password
+      const password = process.env.AUTOPM_MASTER_PASSWORD;
+      if (password) {
+        configManager.setMasterPassword(password);
+
+        // Use ServiceFactory to create services and provider
+        const factory = new ServiceFactory(configManager);
+        provider = factory.createProvider();
+        prdService = factory.createPRDService({ provider });
+        epicService = factory.createEpicService({ provider });
+        console.log('✅ Using configuration from .autopm/config.json\n');
+      } else {
+        console.log('⚠️  Config file found but AUTOPM_MASTER_PASSWORD not set');
+        console.log('   Falling back to ANTHROPIC_API_KEY environment variable\n');
+      }
+    } catch (error) {
+      console.log(`⚠️  Error loading config: ${error.message}`);
+      console.log('   Falling back to ANTHROPIC_API_KEY environment variable\n');
+    }
   }
 
-  // Initialize provider and service
-  const provider = new ClaudeProvider(apiKey);
-  const service = new PRDService(provider);
+  // Fallback to environment variable
+  if (!prdService) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+      console.error('❌ Error: No API key found\n');
+      console.error('Either:');
+      console.error('  1. Run: autopm config:init (recommended)');
+      console.error('     Then: export AUTOPM_MASTER_PASSWORD="your-password"');
+      console.error('  2. Set: export ANTHROPIC_API_KEY="sk-ant-..."\n');
+      process.exit(1);
+    }
+
+    provider = new ClaudeProvider(apiKey);
+    prdService = new PRDService({ provider });
+    epicService = new EpicService({ prdService, provider });
+    console.log('✅ Using ANTHROPIC_API_KEY from environment\n');
+  }
 
   // Handle test command
   if (command === 'test') {
@@ -158,8 +261,8 @@ async function main() {
     process.exit(success ? 0 : 1);
   }
 
-  // Handle parse and summarize commands
-  if (command === 'parse' || command === 'summarize') {
+  // Handle PRD commands (parse, extract-epics, summarize, analyze)
+  if (['parse', 'extract-epics', 'summarize', 'analyze'].includes(command)) {
     const file = args[1];
 
     if (!file) {
@@ -187,20 +290,49 @@ async function main() {
 
     // Execute command
     if (command === 'parse') {
-      const jsonFlag = args[2] === '--json';
-
-      if (jsonFlag) {
-        await parsePRDJson(service, content);
-      } else {
-        await parsePRDStream(service, content);
-      }
+      await parsePRDStream(prdService, content);
+    } else if (command === 'extract-epics') {
+      await extractEpicsStream(prdService, content);
     } else if (command === 'summarize') {
-      await summarizePRD(service, content);
+      await summarizePRDStream(prdService, content);
+    } else if (command === 'analyze') {
+      await analyzePRDStream(epicService, content);
     }
 
     process.exit(0);
   }
 
+  // Handle decompose command (for epic files)
+  if (command === 'decompose') {
+    const file = args[1];
+
+    if (!file) {
+      console.error(`❌ Error: Epic file required for 'decompose' command\n`);
+      console.error(`Usage: autopm-poc decompose <epic-file>\n`);
+      process.exit(1);
+    }
+
+    // Check if file exists
+    if (!fs.existsSync(file)) {
+      console.error(`❌ Error: File not found: ${file}\n`);
+      process.exit(1);
+    }
+
+    // Read file content
+    const content = fs.readFileSync(file, 'utf8');
+
+    if (!content.trim()) {
+      console.error('❌ Error: Epic file is empty\n');
+      process.exit(1);
+    }
+
+    console.log(`📄 Reading Epic from: ${file}`);
+    console.log(`📏 File size: ${content.length} characters\n`);
+
+    await decomposeEpicStream(epicService, content);
+    process.exit(0);
+  }
+
   // Unknown command
   console.error(`❌ Error: Unknown command: ${command}\n`);
   printUsage();