claude-autopm 1.26.0 → 1.27.0

package/autopm/.claude/scripts/pm-task-update-local.js

@@ -0,0 +1,109 @@
+/**
+ * Update Local Task
+ *
+ * Updates task frontmatter and automatically updates epic counters.
+ * Optionally validates dependency constraints.
+ *
+ * Usage:
+ *   const { updateLocalTask } = require('./pm-task-update-local');
+ *
+ *   // Update task status
+ *   await updateLocalTask('epic-001', 'task-001', { status: 'completed' });
+ *
+ *   // Update with dependency validation
+ *   await updateLocalTask('epic-001', 'task-002', {
+ *     status: 'completed',
+ *     validateDependencies: true
+ *   });
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { parseFrontmatter, stringifyFrontmatter } = require('../lib/frontmatter');
+const { showLocalTask } = require('./pm-task-show-local');
+const { listLocalTasks } = require('./pm-task-list-local');
+const { updateLocalEpic } = require('./pm-epic-update-local');
+
+/**
+ * Update task frontmatter
+ *
+ * @param {string} epicId - Epic ID containing the task
+ * @param {string} taskId - Task ID to update
+ * @param {Object} updates - Fields to update
+ * @param {boolean} [updates.validateDependencies] - Validate dependencies before update
+ * @returns {Promise<Object>} Updated task object
+ * @throws {Error} If task not found or dependencies not met
+ */
+async function updateLocalTask(epicId, taskId, updates) {
+  const { validateDependencies, ...frontmatterUpdates } = updates;
+
+  // Get current task
+  const task = await showLocalTask(epicId, taskId);
+
+  // Validate dependencies if requested and status is changing to completed
+  if (validateDependencies && frontmatterUpdates.status === 'completed') {
+    const dependencies = task.frontmatter.dependencies || [];
+
+    if (dependencies.length > 0) {
+      // Check if all dependencies are completed
+      const allTasks = await listLocalTasks(epicId);
+
+      for (const depId of dependencies) {
+        const depTask = allTasks.find(t =>
+          t.id === depId ||
+          t.id === `task-${epicId}-${depId.replace('task-', '')}` ||
+          t.filename === `${depId}.md`
+        );
+
+        if (depTask && depTask.status !== 'completed') {
+          throw new Error(
+            `Dependencies not met: ${depId} (status: ${depTask.status}) must be completed first`
+          );
+        }
+      }
+    }
+  }
+
+  // Track if status changed to/from completed
+  const oldStatus = task.frontmatter.status;
+  const newStatus = frontmatterUpdates.status || oldStatus;
+  const statusChanged = oldStatus !== newStatus;
+  const wasCompleted = oldStatus === 'completed';
+  const nowCompleted = newStatus === 'completed';
+
+  // Merge updates into frontmatter
+  const updatedFrontmatter = {
+    ...task.frontmatter,
+    ...frontmatterUpdates
+  };
+
+  // Preserve body content
+  const updatedContent = stringifyFrontmatter(updatedFrontmatter, task.body);
+
+  // Write updated content back to file
+  await fs.writeFile(task.path, updatedContent, 'utf8');
+
+  // Update epic tasks_completed counter if status changed
+  if (statusChanged && (wasCompleted || nowCompleted)) {
+    const allTasks = await listLocalTasks(epicId);
+    const completedCount = allTasks.filter(t => {
+      if (t.id === task.frontmatter.id || t.id === updatedFrontmatter.id) {
+        return nowCompleted;
+      }
+      return t.status === 'completed';
+    }).length;
+
+    await updateLocalEpic(epicId, {
+      tasks_completed: completedCount
+    });
+  }
+
+  return {
+    taskId,
+    epicId,
+    frontmatter: updatedFrontmatter,
+    body: task.body
+  };
+}
+
+module.exports = { updateLocalTask };

package/autopm/.claude/scripts/setup-local-mode.js

@@ -0,0 +1,127 @@
+const fs = require('fs').promises;
+const path = require('path');
+
+/**
+ * Setup local mode directory structure
+ * Creates .claude/prds/, .claude/epics/, .claude/context/, .claude/logs/
+ *
+ * @returns {Promise<void>}
+ */
+async function setupLocalDirectories() {
+  const baseDir = path.join(process.cwd(), '.claude');
+
+  const directories = [
+    'prds',       // Product Requirements Documents
+    'epics',      // Epic definitions and task breakdowns
+    'context',    // Project context files (NEW)
+    'logs'        // Verification and operation logs (NEW)
+  ];
+
+  for (const dir of directories) {
+    const dirPath = path.join(baseDir, dir);
+
+    try {
+      await fs.mkdir(dirPath, { recursive: true, mode: 0o755 });
+      console.log(`✅ Created ${dirPath}`);
+    } catch (err) {
+      // EEXIST is OK - directory already exists
+      if (err.code !== 'EEXIST') {
+        throw err;
+      }
+    }
+  }
+}
+
+/**
+ * Update .gitignore with ClaudeAutoPM local mode entries
+ * Creates .gitignore if it doesn't exist
+ * Appends entries if .gitignore exists (idempotent)
+ *
+ * @returns {Promise<void>}
+ */
+async function updateGitignore() {
+  const gitignorePath = path.join(process.cwd(), '.gitignore');
+
+  const entries = [
+    '# ClaudeAutoPM Local Mode',
+    '.claude/logs/*.log',
+    '.claude/context/.context-version',
+    '.claude/prds/drafts/',
+    ''
+  ].join('\n');
+
+  try {
+    // Try to read existing .gitignore
+    const existing = await fs.readFile(gitignorePath, 'utf8');
+
+    // Check if our entries are already present
+    if (!existing.includes('.claude/logs/')) {
+      // Append our entries
+      await fs.appendFile(gitignorePath, '\n' + entries);
+      console.log('✅ Updated .gitignore');
+    } else {
+      console.log('ℹ️  .gitignore already contains ClaudeAutoPM entries');
+    }
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      // .gitignore doesn't exist, create it
+      await fs.writeFile(gitignorePath, entries);
+      console.log('✅ Created .gitignore');
+    } else {
+      throw err;
+    }
+  }
+}
+
+/**
+ * Main setup function
+ * Called during `autopm install` or standalone
+ *
+ * @returns {Promise<void>}
+ */
+async function setup() {
+  console.log('🚀 Setting up ClaudeAutoPM local mode...\n');
+
+  try {
+    await setupLocalDirectories();
+    await updateGitignore();
+
+    console.log('\n✅ Local mode setup complete!');
+    console.log('\nCreated directories:');
+    console.log('  - .claude/prds/     (Product Requirements Documents)');
+    console.log('  - .claude/epics/    (Epic breakdowns and tasks)');
+    console.log('  - .claude/context/  (Project context files)');
+    console.log('  - .claude/logs/     (Operation logs)');
+    console.log('\nUpdated .gitignore with exclusions for:');
+    console.log('  - .claude/logs/*.log');
+    console.log('  - .claude/context/.context-version');
+    console.log('  - .claude/prds/drafts/');
+    console.log('\nYou can now use local mode commands:');
+    console.log('  /pm:prd-new --local "Feature Name"');
+    console.log('  /pm:epic-decompose --local <id>');
+    console.log('  /pm:context-create');
+
+  } catch (error) {
+    console.error('❌ Setup failed:', error.message);
+
+    // Provide helpful error messages
+    if (error.code === 'EACCES') {
+      console.error('\nPermission denied. Try running with sudo or check directory permissions.');
+    } else if (error.code === 'ENOSPC') {
+      console.error('\nNo space left on device. Free up some space and try again.');
+    }
+
+    process.exit(1);
+  }
+}
+
+// If run directly (not required as module)
+if (require.main === module) {
+  setup();
+}
+
+module.exports = {
+  setupLocalDirectories,
+  updateGitignore,
+  setup
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "bin": {
@@ -123,11 +123,13 @@
     "glob": "^11.0.3",
     "inquirer": "^12.9.6",
     "js-yaml": "^4.1.0",
+    "markdown-it": "^14.1.0",
     "moment": "^2.29.4",
     "ora": "^5.4.1",
     "simple-git": "^3.20.0",
     "table": "^6.8.1",
     "which": "^4.0.0",
+    "yaml": "^2.8.1",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
@@ -149,8 +151,8 @@
     "sinon": "^21.0.0"
   },
   "optionalDependencies": {
-    "@upstash/context7-mcp": "^1.0.0",
-    "@playwright/mcp": "^0.0.40"
+    "@playwright/mcp": "^0.0.40",
+    "@upstash/context7-mcp": "^1.0.0"
   },
   "publishConfig": {
     "access": "public",

package/scripts/create-task-issues.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# Create GitHub issues for all tasks in epic
+
+cd .claude/epics/ccpm-001-features-integration/
+
+echo "Creating GitHub issues for all tasks..."
+echo ""
+
+for task_file in task-*.md; do
+  if [ "$task_file" != "task-*.md" ]; then
+    task_num=$(echo "$task_file" | grep -o '[0-9]\+' | head -1)
+    task_title=$(grep "^title:" "$task_file" | head -1 | sed 's/title: //')
+
+    echo "Creating issue for TASK-$task_num: $task_title"
+
+    issue_url=$(gh issue create \
+      --title "[TASK-$task_num] $task_title" \
+      --body-file "$task_file" \
+      --label "task" --label "enhancement")
+
+    echo "  ✅ Created: $issue_url"
+    echo ""
+  fi
+done
+
+echo "✅ All task issues created!"

package/scripts/fix-invalid-command-refs.sh

@@ -71,11 +71,12 @@ remove_from_file() {
   local cmd="$2"
 
   if grep -q "$cmd" "$file" 2>/dev/null; then
-    # Remove lines containing the command
+    # Remove lines containing the command (with word boundary)
+    # Match only whole command tokens, not substrings
     if [[ "$OSTYPE" == "darwin"* ]]; then
-      sed -i '' "/$cmd/d" "$file"
+      sed -i '' -E "/([[:space:]]|^)${cmd}([[:space:]]|\$|[[:punct:]])/d" "$file"
     else
-      sed -i "/$cmd/d" "$file"
+      sed -i -E "/([[:space:]]|^)${cmd}([[:space:]]|\$|[[:punct:]])/d" "$file"
     fi
     echo "  ✗ $file: removed $cmd"
     ((total_changes++))

package/scripts/fix-invalid-refs-simple.sh

@@ -13,19 +13,23 @@ safe_replace() {
   local old="$1"
   local new="$2"
   local desc="$3"
+  local count=0
 
   echo "Replacing: $old → $new ($desc)"
 
   # Find and replace (exclude our analysis docs)
-  find . -name "*.md" -type f ! -path "*/MISSING-COMMANDS-ANALYSIS.md" ! -path "*/node_modules/*" -exec grep -l "$old" {} \; 2>/dev/null | while read file; do
+  while IFS= read -r file; do
     if [[ "$OSTYPE" == "darwin"* ]]; then
       sed -i '' "s|$old|$new|g" "$file"
     else
       sed -i "s|$old|$new|g" "$file"
     fi
     echo "  ✓ $file"
-    ((total++)) || true
-  done
+    ((count++))
+  done < <(find . -name "*.md" -type f ! -path "*/MISSING-COMMANDS-ANALYSIS.md" ! -path "*/node_modules/*" -exec grep -l "$old" {} \; 2>/dev/null)
+
+  ((total += count))
+  echo "  Updated: $count file(s)"
 }
 
 # Replacements
@@ -39,6 +43,7 @@ safe_replace "/pm:prd-split" "/pm:epic-split" "split after parse"
 
 echo ""
 echo "✅ Replacements complete!"
+echo "📊 Total files updated: $total"
 echo ""
 echo "📝 Note: The following invalid commands still exist in docs:"
 echo "   - Azure commands (/pm:azure-*)"