claude-autopm 1.23.1 → 1.24.0

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

@@ -0,0 +1,141 @@
+#!/bin/bash
+# Fix invalid command references in documentation
+
+set -e
+
+echo "🔧 Fixing invalid command references..."
+
+# Replacement map (escaped for use in sed)
+declare -A REPLACEMENTS=(
+  ["\/pm:epic-new"]="\/pm:prd-new"
+  ["\/pm:done"]="\/pm:issue-close"
+  ["\/pm:next-task"]="\/pm:next"
+  ["\/pm:epic-resolve"]="\/pm:epic-close"
+  ["\/pm:epic-stop"]="\/pm:epic-close"
+  ["\/pm:prd-split"]="\/pm:epic-split"
+)
+
+# Commands to remove (no replacement) - escaped
+REMOVE_COMMANDS=(
+  "\/pm:azure-next"
+  "\/pm:azure-sync"
+  "\/pm:board"
+  "\/pm:build"
+  "\/pm:config"
+  "\/pm:optimize"
+  "\/pm:pr-create"
+  "\/pm:pr-list"
+  "\/pm:query"
+  "\/pm:release"
+  "\/pm:report"
+  "\/pm:resource"
+  "\/pm:resource-action"
+  "\/pm:sprint"
+  "\/pm:sprint-status"
+  "\/pm:sync-all"
+  "\/pm:test"
+  "\/pm:todo"
+  "\/pm:wip"
+)
+
+# Generic commands to remove (too vague) - escaped
+GENERIC_COMMANDS=(
+  "\/pm:epic"
+  "\/pm:issue"
+  "\/pm:prd"
+  "\/pm:pr"
+)
+
+total_changes=0
+
+# Function to replace in file
+replace_in_file() {
+  local file="$1"
+  local old="$2"
+  local new="$3"
+
+  if grep -q "$old" "$file" 2>/dev/null; then
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+      sed -i '' "s|$old|$new|g" "$file"
+    else
+      sed -i "s|$old|$new|g" "$file"
+    fi
+    echo "  ✓ $file: $old → $new"
+    ((total_changes++))
+  fi
+}
+
+# Function to remove command references
+remove_from_file() {
+  local file="$1"
+  local cmd="$2"
+
+  if grep -q "$cmd" "$file" 2>/dev/null; then
+    # Remove lines containing the command
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+      sed -i '' "/$cmd/d" "$file"
+    else
+      sed -i "/$cmd/d" "$file"
+    fi
+    echo "  ✗ $file: removed $cmd"
+    ((total_changes++))
+  fi
+}
+
+echo ""
+echo "=== Replacing commands with correct alternatives ==="
+for old in "${!REPLACEMENTS[@]}"; do
+  new="${REPLACEMENTS[$old]}"
+  echo ""
+  echo "Replacing: $old → $new"
+
+  # Find files with this command (excluding our analysis doc and script)
+  while IFS= read -r file; do
+    if [[ "$file" != *"MISSING-COMMANDS-ANALYSIS.md"* ]] && \
+       [[ "$file" != *"fix-invalid-command-refs.sh"* ]]; then
+      replace_in_file "$file" "$old" "$new"
+    fi
+  done < <(grep -rl "$old" . --include="*.md" 2>/dev/null || true)
+done
+
+echo ""
+echo "=== Removing commands with no replacement ==="
+for cmd in "${REMOVE_COMMANDS[@]}"; do
+  echo ""
+  echo "Removing: $cmd"
+
+  while IFS= read -r file; do
+    if [[ "$file" != *"MISSING-COMMANDS-ANALYSIS.md"* ]] && \
+       [[ "$file" != *"fix-invalid-command-refs.sh"* ]]; then
+      remove_from_file "$file" "$cmd"
+    fi
+  done < <(grep -rl "$cmd" . --include="*.md" 2>/dev/null || true)
+done
+
+echo ""
+echo "=== Removing generic commands (too vague) ==="
+for cmd in "${GENERIC_COMMANDS[@]}"; do
+  echo ""
+  echo "Removing: $cmd (too vague - use specific commands instead)"
+
+  while IFS= read -r file; do
+    if [[ "$file" != *"MISSING-COMMANDS-ANALYSIS.md"* ]] && \
+       [[ "$file" != *"fix-invalid-command-refs.sh"* ]] && \
+       [[ "$file" != *"COMMANDS.md"* ]]; then
+      # Only remove if it's standalone, not part of a longer command
+      if grep -E "$cmd[[:space:]]|$cmd\$|$cmd\`" "$file" &>/dev/null; then
+        remove_from_file "$file" "$cmd"
+      fi
+    fi
+  done < <(grep -rl "$cmd" . --include="*.md" 2>/dev/null || true)
+done
+
+echo ""
+echo "════════════════════════════════════════════"
+echo "✅ Complete! Total changes: $total_changes"
+echo "════════════════════════════════════════════"
+echo ""
+echo "Next steps:"
+echo "1. Review changes: git diff"
+echo "2. Test affected documentation"
+echo "3. Commit: git add . && git commit -m 'fix: remove invalid command references'"

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

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Simple script to fix invalid command references
+
+set -e
+
+echo "🔧 Fixing invalid command references..."
+echo ""
+
+total=0
+
+# Function to safely replace
+safe_replace() {
+  local old="$1"
+  local new="$2"
+  local desc="$3"
+
+  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
+    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
+}
+
+# Replacements
+echo "=== Step 1: Replacing with correct alternatives ==="
+safe_replace "/pm:epic-new" "/pm:prd-new" "create PRD first"
+safe_replace "/pm:done" "/pm:issue-close" "close issue"
+safe_replace "/pm:next-task" "/pm:next" "get next task"
+safe_replace "/pm:epic-resolve" "/pm:epic-close" "close epic"
+safe_replace "/pm:epic-stop" "/pm:epic-close" "close epic"
+safe_replace "/pm:prd-split" "/pm:epic-split" "split after parse"
+
+echo ""
+echo "✅ Replacements complete!"
+echo ""
+echo "📝 Note: The following invalid commands still exist in docs:"
+echo "   - Azure commands (/pm:azure-*)"
+echo "   - Generic commands (/pm:epic, /pm:issue, /pm:prd, /pm:pr)"
+echo "   - Other unimplemented commands"
+echo ""
+echo "These should be manually reviewed and removed/updated in context."
+echo "See docs/MISSING-COMMANDS-ANALYSIS.md for full list."

package/scripts/standardize-commands.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+
+/**
+ * Standardize PM Commands to DEVELOPMENT-STANDARDS.md
+ *
+ * Adds frontmatter to commands that are missing it
+ * Commands should have:
+ * - Frontmatter with name, type, category
+ * - Context7 Documentation Queries section (already present)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Commands that need frontmatter (excluding docs)
+const commandsToFix = [
+  'ai/langgraph-workflow.md',
+  'ai/openai-chat.md',
+  'azure/feature-show.md',
+  'azure/task-analyze.md',
+  'config/toggle-features.md',
+  'infrastructure/ssh-security.md',
+  'infrastructure/traefik-setup.md',
+  'pm/epic-split.md',
+  'ui-framework-commands.md',
+  'ui/bootstrap-scaffold.md',
+  'ui/tailwind-system.md',
+  'ux-design-commands.md'
+];
+
+const commandsDir = path.join(__dirname, '..', 'autopm', '.claude', 'commands');
+
+function extractCommandName(filePath, content) {
+  // Try to get from first heading
+  const match = content.match(/^#\s+(.+?)(?:\s+Command)?$/m);
+  if (match) {
+    return match[1].trim().toLowerCase().replace(/\s+/g, '-');
+  }
+
+  // Fallback to filename
+  return path.basename(filePath, '.md');
+}
+
+function extractCategory(filePath) {
+  const parts = filePath.split('/');
+  if (parts.length > 1) {
+    return parts[0]; // azure, pm, ai, etc.
+  }
+  return 'general';
+}
+
+function extractDescription(content) {
+  // Get first paragraph after title
+  const lines = content.split('\n');
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line && !line.startsWith('#')) {
+      return line.length > 150 ? line.substring(0, 147) + '...' : line;
+    }
+  }
+  return 'PM command for project management workflow';
+}
+
+function determineCommandType(filePath, content) {
+  const contentLower = content.toLowerCase();
+
+  // Check category-specific types first
+  if (filePath.includes('ai/')) {
+    if (contentLower.includes('workflow') || contentLower.includes('langgraph')) return 'ai-workflow';
+    if (contentLower.includes('openai') || contentLower.includes('chat')) return 'ai-integration';
+    return 'ai-integration';
+  }
+
+  if (filePath.includes('infrastructure/')) return 'infrastructure';
+  if (filePath.includes('ui/')) return 'ui-development';
+  if (filePath.includes('config/')) return 'configuration';
+
+  // PM category types
+  if (contentLower.includes('epic') || contentLower.includes('feature')) return 'epic-management';
+  if (contentLower.includes('task') || contentLower.includes('issue')) return 'task-management';
+  if (contentLower.includes('sprint') || contentLower.includes('standup')) return 'sprint-management';
+  if (contentLower.includes('prd') || contentLower.includes('requirement')) return 'requirements';
+  if (contentLower.includes('sync') || contentLower.includes('import')) return 'integration';
+  if (contentLower.includes('analyze') || contentLower.includes('report')) return 'analytics';
+
+  return 'workflow';
+}
+
+function generateFrontmatter(filePath, content) {
+  const name = extractCommandName(filePath, content);
+  const description = extractDescription(content);
+  const category = extractCategory(filePath);
+  const type = determineCommandType(filePath, content);
+
+  return `---
+name: ${name}
+type: ${type}
+category: ${category}
+---
+
+`;
+}
+
+function addFrontmatter(filePath, content) {
+  // Check if already has frontmatter
+  if (content.startsWith('---')) {
+    console.log(`⏭️  Skipping ${filePath} - already has frontmatter`);
+    return content;
+  }
+
+  const frontmatter = generateFrontmatter(filePath, content);
+  console.log(`✅ Adding frontmatter to ${filePath}`);
+
+  return frontmatter + content;
+}
+
+function standardizeCommand(relativePath) {
+  const fullPath = path.join(commandsDir, relativePath);
+
+  if (!fs.existsSync(fullPath)) {
+    console.log(`⚠️  File not found: ${relativePath}`);
+    return;
+  }
+
+  const content = fs.readFileSync(fullPath, 'utf-8');
+  const updated = addFrontmatter(relativePath, content);
+
+  if (updated !== content) {
+    fs.writeFileSync(fullPath, updated);
+    console.log(`   Frontmatter added to ${relativePath}`);
+  }
+}
+
+// Main execution
+console.log('🔧 Standardizing PM Commands\n');
+
+let processed = 0;
+let updated = 0;
+
+for (const commandPath of commandsToFix) {
+  const fullPath = path.join(commandsDir, commandPath);
+
+  if (!fs.existsSync(fullPath)) {
+    console.log(`⚠️  Skipping ${commandPath} - not found`);
+    continue;
+  }
+
+  const before = fs.readFileSync(fullPath, 'utf-8');
+  standardizeCommand(commandPath);
+  const after = fs.readFileSync(fullPath, 'utf-8');
+
+  processed++;
+  if (before !== after) {
+    updated++;
+  }
+}
+
+console.log(`\n📊 Summary:`);
+console.log(`   Processed: ${processed} commands`);
+console.log(`   Updated: ${updated} commands`);
+console.log(`   Skipped: ${processed - updated} commands`);