claude-autopm 1.15.5 → 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/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) {

package/package.json

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