claude-autopm 1.15.4 → 1.16.0

package/autopm/scripts/epic-status.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+
+# Epic Status Checker
+# Part of ClaudeAutoPM Framework
+# Usage: ./scripts/epic-status.sh [epic-name]
+
+EPIC_NAME=${1:-}
+
+if [ -z "$EPIC_NAME" ]; then
+    echo "Usage: $0 <epic-name>"
+    echo ""
+    echo "Available epics:"
+    if [ -d ".claude/epics" ]; then
+        ls -1 .claude/epics/ 2>/dev/null || echo "No epics found"
+    else
+        echo "No .claude/epics directory found"
+    fi
+    exit 1
+fi
+
+EPIC_DIR=".claude/epics/$EPIC_NAME"
+
+if [ ! -d "$EPIC_DIR" ]; then
+    echo "Error: Epic '$EPIC_NAME' not found"
+    echo ""
+    echo "Available epics:"
+    ls -1 .claude/epics/ 2>/dev/null
+    exit 1
+fi
+
+echo "Epic: $EPIC_NAME"
+echo "===================="
+echo ""
+
+# Count total tasks
+total_tasks=$(find "$EPIC_DIR" -maxdepth 2 -name "[0-9][0-9][0-9].md" 2>/dev/null | wc -l | tr -d ' ')
+
+# Count completed tasks (looking for status: completed in frontmatter)
+completed=0
+in_progress=0
+pending=0
+
+for task_file in $(find "$EPIC_DIR" -maxdepth 2 -name "[0-9][0-9][0-9].md" 2>/dev/null); do
+    if grep -q "^status: completed" "$task_file" 2>/dev/null; then
+        completed=$((completed + 1))
+    elif grep -q "^status: in-progress\|^status: in_progress" "$task_file" 2>/dev/null; then
+        in_progress=$((in_progress + 1))
+    else
+        pending=$((pending + 1))
+    fi
+done
+
+# Calculate progress percentage
+if [ "$total_tasks" -gt 0 ]; then
+    progress=$((completed * 100 / total_tasks))
+else
+    progress=0
+fi
+
+echo "Total tasks:     $total_tasks"
+echo "Completed:       $completed ($progress%)"
+echo "In Progress:     $in_progress"
+echo "Pending:         $pending"
+echo ""
+
+# Progress bar
+if [ "$total_tasks" -gt 0 ]; then
+    bar_length=50
+    filled=$((progress * bar_length / 100))
+    empty=$((bar_length - filled))
+
+    printf "Progress: ["
+    printf "%${filled}s" | tr ' ' '='
+    printf "%${empty}s" | tr ' ' '-'
+    printf "] %d%%\n" "$progress"
+    echo ""
+fi
+
+# Show breakdown by sub-epic if they exist
+sub_dirs=$(find "$EPIC_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+
+if [ "$sub_dirs" -gt 0 ]; then
+    echo "Sub-Epic Breakdown:"
+    echo "-------------------"
+
+    for sub_dir in "$EPIC_DIR"/*/; do
+        if [ -d "$sub_dir" ]; then
+            sub_name=$(basename "$sub_dir")
+            sub_count=$(find "$sub_dir" -maxdepth 1 -name "[0-9][0-9][0-9].md" 2>/dev/null | wc -l | tr -d ' ')
+
+            if [ "$sub_count" -gt 0 ]; then
+                # Count completed in sub-epic
+                sub_completed=0
+                for task_file in $(find "$sub_dir" -maxdepth 1 -name "[0-9][0-9][0-9].md" 2>/dev/null); do
+                    if grep -q "^status: completed" "$task_file" 2>/dev/null; then
+                        sub_completed=$((sub_completed + 1))
+                    fi
+                done
+
+                printf "  %-30s %3d tasks (%d completed)\n" "$sub_name" "$sub_count" "$sub_completed"
+            fi
+        fi
+    done
+fi

package/autopm/scripts/package.json.template

@@ -1,30 +1,33 @@
 {
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
   "scripts": {
     "// Safety Scripts": "Safeguards against bad commits",
     "precommit": "npm test && npm run build && npm run lint",
     "verify": "npm test && npm run build && npm run lint && npm run typecheck",
     "safe-commit": "./scripts/safe-commit.sh",
     "prepush": "npm run verify && npm run test:e2e",
-    
+
     "// Quick Checks": "Quick checks",
     "check": "npm run lint && npm run typecheck",
     "check:all": "npm run verify",
-    
+
     "// Git Helpers": "Git helper commands",
     "commit": "npm run precommit && git add -A && git commit",
     "push:safe": "npm run prepush && git push",
-    
+
     "// CI/CD Simulation": "Local CI/CD simulation",
     "ci:local": "npm ci && npm run verify && npm run test:e2e",
     "ci:validate": "npm run ci:local",
-    
+
     "// Emergency": "Emergency",
     "fix": "npm run lint -- --fix && npm run format",
     "format": "prettier --write .",
     "clean:hooks": "rm -f .git/hooks/pre-* && npm run setup:hooks",
     "setup:hooks": "husky install || cp scripts/hooks/* .git/hooks/"
   },
-  
+
   "husky": {
     "hooks": {
       "pre-commit": "npm run precommit",
@@ -32,7 +35,7 @@
       "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
     }
   },
-  
+
   "// Usage examples": [
     "npm run safe-commit 'feat: add new feature'",
     "npm run verify",

package/bin/autopm.js

@@ -180,6 +180,8 @@ function main() {
     .command(require('./commands/config'))
     // MCP management command
     .command(require('./commands/mcp'))
+    // Epic management command
+    .command(require('./commands/epic'))
     // Validation command
     .command('validate', 'Validate ClaudeAutoPM configuration and setup',
       (yargs) => {

package/bin/commands/epic.js

@@ -0,0 +1,161 @@
+/**
+ * Epic Command for autopm CLI
+ * Manages epic status, breakdown, and analysis
+ */
+
+const path = require('path');
+const { execSync } = require('child_process');
+const fs = require('fs');
+
+module.exports = {
+  command: 'epic <action> [name]',
+  describe: 'Manage epics and view epic status',
+
+  builder: (yargs) => {
+    return yargs
+      .positional('action', {
+        describe: 'Epic action to perform',
+        type: 'string',
+        choices: ['status', 'list', 'breakdown']
+      })
+      .positional('name', {
+        describe: 'Epic name (for status action)',
+        type: 'string'
+      })
+      .option('detailed', {
+        alias: 'd',
+        describe: 'Show detailed breakdown',
+        type: 'boolean',
+        default: false
+      })
+      .example('autopm epic list', 'List all available epics')
+      .example('autopm epic status fullstack', 'Show status of fullstack epic')
+      .example('autopm epic breakdown fullstack', 'Show detailed task breakdown');
+  },
+
+  handler: async (argv) => {
+    const action = argv.action;
+    const name = argv.name;
+
+    try {
+      switch (action) {
+        case 'list':
+          listEpics();
+          break;
+
+        case 'status':
+          if (!name) {
+            console.error('Error: Epic name required for status action');
+            console.log('Usage: autopm epic status <epic-name>');
+            process.exit(1);
+          }
+          showEpicStatus(name);
+          break;
+
+        case 'breakdown':
+          if (!name) {
+            console.error('Error: Epic name required for breakdown action');
+            console.log('Usage: autopm epic breakdown <epic-name>');
+            process.exit(1);
+          }
+          showEpicBreakdown(name);
+          break;
+
+        default:
+          console.error(`Unknown action: ${action}`);
+          process.exit(1);
+      }
+    } catch (error) {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  }
+};
+
+function listEpics() {
+  const epicsDir = path.join(process.cwd(), '.claude', 'epics');
+
+  if (!fs.existsSync(epicsDir)) {
+    console.log('No epics found. Create epics with /pm:epic-split or /pm:epic-decompose');
+    return;
+  }
+
+  const epics = fs.readdirSync(epicsDir).filter(f => {
+    return fs.statSync(path.join(epicsDir, f)).isDirectory();
+  });
+
+  if (epics.length === 0) {
+    console.log('No epics found. Create epics with /pm:epic-split or /pm:epic-decompose');
+    return;
+  }
+
+  console.log('Available Epics:');
+  console.log('================\n');
+
+  epics.forEach(epic => {
+    console.log(`  • ${epic}`);
+  });
+
+  console.log('');
+  console.log('Use: autopm epic status <epic-name> to see details');
+}
+
+function showEpicStatus(epicName) {
+  const scriptPath = path.join(process.cwd(), 'scripts', 'epic-status.sh');
+
+  if (!fs.existsSync(scriptPath)) {
+    console.error('Error: epic-status.sh script not found');
+    console.error('Run: autopm install to get the latest scripts');
+    process.exit(1);
+  }
+
+  try {
+    execSync(`bash "${scriptPath}" "${epicName}"`, {
+      stdio: 'inherit',
+      cwd: process.cwd()
+    });
+  } catch (error) {
+    process.exit(error.status || 1);
+  }
+}
+
+function showEpicBreakdown(epicName) {
+  const epicDir = path.join(process.cwd(), '.claude', 'epics', epicName);
+
+  if (!fs.existsSync(epicDir)) {
+    console.error(`Error: Epic '${epicName}' not found`);
+    process.exit(1);
+  }
+
+  console.log(`Epic Breakdown: ${epicName}`);
+  console.log('='.repeat(50));
+  console.log('');
+
+  // Find all task files
+  const findTasks = (dir, prefix = '') => {
+    const items = fs.readdirSync(dir);
+
+    items.forEach(item => {
+      const itemPath = path.join(dir, item);
+      const stat = fs.statSync(itemPath);
+
+      if (stat.isDirectory()) {
+        console.log(`\n${prefix}📁 ${item}`);
+        findTasks(itemPath, prefix + '  ');
+      } else if (item.match(/^\d{3}\.md$/)) {
+        const content = fs.readFileSync(itemPath, 'utf-8');
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const statusMatch = content.match(/^status:\s+(.+)$/m);
+
+        const title = titleMatch ? titleMatch[1] : item;
+        const status = statusMatch ? statusMatch[1] : 'pending';
+
+        const icon = status === 'completed' ? '✅' : status === 'in-progress' ? '🔄' : '⚪';
+
+        console.log(`${prefix}  ${icon} ${item}: ${title}`);
+      }
+    });
+  };
+
+  findTasks(epicDir);
+}

package/install/install.js

@@ -323,7 +323,8 @@ ${this.colors.BOLD}Examples:${this.colors.NC}
       'safe-commit.sh',
       'safe-commit.js',
       'setup-hooks.sh',
-      'setup-hooks.js'
+      'setup-hooks.js',
+      'epic-status.sh'
     ];
 
     for (const script of scripts) {
@@ -339,6 +340,63 @@ ${this.colors.BOLD}Examples:${this.colors.NC}
         this.printSuccess(`Installed ${script}`);
       }
     }
+
+    // Install package.json if it doesn't exist
+    const packageJsonPath = path.join(this.targetDir, 'package.json');
+    const packageJsonTemplatePath = path.join(this.autopmDir, 'scripts', 'package.json.template');
+
+    if (!fs.existsSync(packageJsonPath) && fs.existsSync(packageJsonTemplatePath)) {
+      this.printStep('Creating package.json from template...');
+      const templateContent = fs.readFileSync(packageJsonTemplatePath, 'utf-8');
+
+      // Try to get project name from directory
+      const projectName = path.basename(this.targetDir);
+
+      // Parse template and add name field
+      const packageJson = JSON.parse(templateContent);
+      packageJson.name = projectName;
+      packageJson.version = packageJson.version || '1.0.0';
+      packageJson.description = packageJson.description || '';
+      packageJson.main = packageJson.main || 'index.js';
+      packageJson.license = packageJson.license || 'ISC';
+
+      fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf-8');
+      this.printSuccess('Created package.json');
+    } else if (fs.existsSync(packageJsonPath)) {
+      this.printInfo('package.json already exists, skipping');
+    }
+  }
+
+  installDependencies() {
+    const packageJsonPath = path.join(this.targetDir, 'package.json');
+
+    if (!fs.existsSync(packageJsonPath)) {
+      this.printInfo('No package.json found, skipping dependency installation');
+      return;
+    }
+
+    this.printStep('Installing npm dependencies...');
+
+    try {
+      // Check if package.json has dependencies
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+      if (!packageJson.dependencies || Object.keys(packageJson.dependencies).length === 0) {
+        this.printInfo('No dependencies to install');
+        return;
+      }
+
+      // Run npm install
+      execSync('npm install', {
+        cwd: this.targetDir,
+        encoding: 'utf-8',
+        stdio: 'inherit'
+      });
+
+      this.printSuccess('Dependencies installed successfully');
+    } catch (error) {
+      this.printWarning(`Failed to install dependencies: ${error.message}`);
+      this.printInfo('You can manually run: npm install');
+    }
   }
 
   checkToolAvailability() {
@@ -903,6 +961,9 @@ See: https://github.com/rafeekpro/ClaudeAutoPM
       await this.setupGitHooks();
     }
 
+    // Install npm dependencies
+    this.installDependencies();
+
     // Final success message
     console.log('');
     this.printMsg('GREEN', '╔══════════════════════════════════════════╗');

package/package.json

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