claude-autopm 2.2.0 → 2.2.2

package/lib/cli/commands/prd.js

@@ -310,13 +310,31 @@ async function prdNew(argv) {
     // Build script path
     const scriptPath = path.join(process.cwd(), '.claude', 'scripts', 'pm', 'prd-new.js');
 
+    // Debug: Show what we're looking for
+    if (process.env.DEBUG) {
+      console.log(chalk.gray(`\nDebug: Looking for script at: ${scriptPath}`));
+      console.log(chalk.gray(`Debug: Current directory: ${process.cwd()}`));
+    }
+
     // Check if script exists
     const scriptExists = await fs.pathExists(scriptPath);
     if (!scriptExists) {
       spinner.fail(chalk.red('PRD creation script not found'));
       console.error(chalk.red('\nError: .claude/scripts/pm/prd-new.js not found'));
-      console.error(chalk.yellow('Run: autopm install'));
-      return;
+      console.error(chalk.red(`Expected location: ${scriptPath}`));
+      console.error(chalk.yellow('\nSolution: Run "autopm install" to install the framework'));
+
+      // Show what directories DO exist
+      const claudeDir = path.join(process.cwd(), '.claude');
+      const scriptsDir = path.join(claudeDir, 'scripts');
+      const pmDir = path.join(scriptsDir, 'pm');
+
+      console.error(chalk.gray('\nDirectory status:'));
+      console.error(chalk.gray(`  .claude/ exists: ${await fs.pathExists(claudeDir)}`));
+      console.error(chalk.gray(`  .claude/scripts/ exists: ${await fs.pathExists(scriptsDir)}`));
+      console.error(chalk.gray(`  .claude/scripts/pm/ exists: ${await fs.pathExists(pmDir)}`));
+
+      process.exit(1);
     }
 
     // Build arguments
@@ -325,29 +343,57 @@ async function prdNew(argv) {
       args.push('--template', argv.template);
     }
 
+    if (process.env.DEBUG) {
+      console.log(chalk.gray(`Debug: Running: node ${args.join(' ')}`));
+    }
+
     spinner.stop();
 
+    console.log(chalk.cyan(`\n🚀 Starting PRD wizard for: ${argv.name}`));
+    if (argv.template) {
+      console.log(chalk.cyan(`📝 Using template: ${argv.template}`));
+    }
+    console.log(chalk.gray('Press Ctrl+C to cancel\n'));
+
     // Spawn interactive process
     const child = spawn('node', args, {
       stdio: 'inherit',
-      cwd: process.cwd()
+      cwd: process.cwd(),
+      env: { ...process.env }
     });
 
     // Wait for completion
     await new Promise((resolve, reject) => {
       child.on('close', (code) => {
         if (code === 0) {
+          console.log(chalk.green('\n✓ PRD created successfully'));
           resolve();
+        } else if (code === null) {
+          console.error(chalk.yellow('\n⚠ Process was terminated'));
+          reject(new Error('Process terminated'));
         } else {
+          console.error(chalk.red(`\n✗ PRD creation failed with exit code ${code}`));
           reject(new Error(`PRD creation failed with code ${code}`));
         }
       });
-      child.on('error', reject);
+
+      child.on('error', (err) => {
+        console.error(chalk.red(`\n✗ Failed to start process: ${err.message}`));
+        reject(err);
+      });
     });
 
   } catch (error) {
-    spinner.fail(chalk.red('Failed to create PRD'));
-    console.error(chalk.red(`\nError: ${error.message}`));
+    console.error(chalk.red(`\n✗ Error: ${error.message}`));
+
+    if (error.message.includes('terminated')) {
+      console.error(chalk.yellow('Operation cancelled by user'));
+    } else if (error.code === 'ENOENT') {
+      console.error(chalk.red('Node.js executable not found'));
+      console.error(chalk.yellow('Ensure Node.js is installed and in PATH'));
+    }
+
+    process.exit(1);
   }
 }
 
@@ -357,10 +403,10 @@ async function prdNew(argv) {
  */
 async function prdParse(argv) {
   const spinner = ora(`Parsing PRD: ${argv.name}`).start();
-  const prdService = new PRDService();
 
   try {
     const content = await readPrdFile(argv.name);
+    const prdService = new PRDService();
 
     if (argv.stream) {
       // Streaming mode
@@ -388,12 +434,24 @@ async function prdParse(argv) {
     spinner.fail(chalk.red('Failed to parse PRD'));
 
     if (error.message.includes('not found')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: PRD file not found`));
+      console.error(chalk.red(`  File: ${getPrdPath(argv.name)}`));
+      console.error(chalk.yellow('\n💡 Use: autopm prd list to see available PRDs'));
+    } else if (error.message.includes('ANTHROPIC_API_KEY') || error.message.includes('API key')) {
+      console.error(chalk.red(`\n✗ Error: API key not configured`));
+      console.error(chalk.yellow('\n💡 Set your API key in .env file:'));
+      console.error(chalk.cyan('  ANTHROPIC_API_KEY=sk-ant-api03-...'));
     } else if (error.message.includes('Failed to read')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: Cannot read PRD file`));
+      console.error(chalk.red(`  ${error.message}`));
     } else {
-      console.error(chalk.red(`\nError: Failed to parse PRD: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: ${error.message}`));
+      if (process.env.DEBUG) {
+        console.error(chalk.gray('\nStack trace:'));
+        console.error(chalk.gray(error.stack));
+      }
     }
+    process.exit(1);
   }
 }
 
@@ -403,10 +461,10 @@ async function prdParse(argv) {
  */
 async function prdExtractEpics(argv) {
   const spinner = ora(`Extracting epics from: ${argv.name}`).start();
-  const prdService = new PRDService();
 
   try {
     const content = await readPrdFile(argv.name);
+    const prdService = new PRDService();
 
     if (argv.stream) {
       // Streaming mode
@@ -435,12 +493,24 @@ async function prdExtractEpics(argv) {
     spinner.fail(chalk.red('Failed to extract epics'));
 
     if (error.message.includes('not found')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: PRD file not found`));
+      console.error(chalk.red(`  File: ${getPrdPath(argv.name)}`));
+      console.error(chalk.yellow('\n💡 Use: autopm prd list to see available PRDs'));
+    } else if (error.message.includes('ANTHROPIC_API_KEY') || error.message.includes('API key')) {
+      console.error(chalk.red(`\n✗ Error: API key not configured`));
+      console.error(chalk.yellow('\n💡 Set your API key in .env file:'));
+      console.error(chalk.cyan('  ANTHROPIC_API_KEY=sk-ant-api03-...'));
     } else if (error.message.includes('Failed to read')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: Cannot read PRD file`));
+      console.error(chalk.red(`  ${error.message}`));
     } else {
-      console.error(chalk.red(`\nError: Failed to extract epics: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: ${error.message}`));
+      if (process.env.DEBUG) {
+        console.error(chalk.gray('\nStack trace:'));
+        console.error(chalk.gray(error.stack));
+      }
     }
+    process.exit(1);
   }
 }
 
@@ -450,10 +520,10 @@ async function prdExtractEpics(argv) {
  */
 async function prdSummarize(argv) {
   const spinner = ora(`Generating summary for: ${argv.name}`).start();
-  const prdService = new PRDService();
 
   try {
     const content = await readPrdFile(argv.name);
+    const prdService = new PRDService();
 
     if (argv.stream) {
       // Streaming mode
@@ -477,12 +547,24 @@ async function prdSummarize(argv) {
     spinner.fail(chalk.red('Failed to generate summary'));
 
     if (error.message.includes('not found')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: PRD file not found`));
+      console.error(chalk.red(`  File: ${getPrdPath(argv.name)}`));
+      console.error(chalk.yellow('\n💡 Use: autopm prd list to see available PRDs'));
+    } else if (error.message.includes('ANTHROPIC_API_KEY') || error.message.includes('API key')) {
+      console.error(chalk.red(`\n✗ Error: API key not configured`));
+      console.error(chalk.yellow('\n💡 Set your API key in .env file:'));
+      console.error(chalk.cyan('  ANTHROPIC_API_KEY=sk-ant-api03-...'));
     } else if (error.message.includes('Failed to read')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: Cannot read PRD file`));
+      console.error(chalk.red(`  ${error.message}`));
     } else {
-      console.error(chalk.red(`\nError: Failed to generate summary: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: ${error.message}`));
+      if (process.env.DEBUG) {
+        console.error(chalk.gray('\nStack trace:'));
+        console.error(chalk.gray(error.stack));
+      }
     }
+    process.exit(1);
   }
 }
 
@@ -492,83 +574,41 @@ async function prdSummarize(argv) {
  */
 async function prdValidate(argv) {
   const spinner = ora(`Validating PRD: ${argv.name}`).start();
-  const prdService = new PRDService();
 
   try {
     const content = await readPrdFile(argv.name);
+    const prdService = new PRDService();
     const result = await prdService.validate(content);
 
     if (result.valid) {
       spinner.succeed(chalk.green('PRD is valid'));
-      console.log(chalk.green('\nValidation passed - PRD structure is correct'));
+      console.log(chalk.green('\n✓ Validation passed - PRD structure is correct'));
     } else {
       spinner.fail(chalk.red(`PRD validation failed - ${result.issues.length} issues found`));
-      console.error(chalk.red(`\nValidation failed - ${result.issues.length} issue(s):`));
+      console.error(chalk.red(`\n✗ Validation failed - ${result.issues.length} issue(s):`));
       result.issues.forEach((issue, index) => {
         console.error(chalk.red(`  ${index + 1}. ${issue}`));
       });
+      process.exit(1);
     }
   } catch (error) {
     spinner.fail(chalk.red('Failed to validate PRD'));
 
     if (error.message.includes('not found')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: PRD file not found`));
+      console.error(chalk.red(`  File: ${getPrdPath(argv.name)}`));
+      console.error(chalk.yellow('\n💡 Use: autopm prd list to see available PRDs'));
     } else if (error.message.includes('Failed to read')) {
-      console.error(chalk.red(`\nError: ${error.message}`));
+      console.error(chalk.red(`\n✗ Error: Cannot read PRD file`));
+      console.error(chalk.red(`  ${error.message}`));
     } else {
-      console.error(chalk.red(`\nError: Failed to validate PRD: ${error.message}`));
-    }
-  }
-}
-
-/**
- * Main command handler
- * @param {Object} argv - Command arguments
- */
-async function handler(argv) {
-  // Validate action
-  const validActions = ['list', 'new', 'show', 'edit', 'status', 'parse', 'extract-epics', 'summarize', 'validate'];
-
-  if (!validActions.includes(argv.action)) {
-    console.error(chalk.red(`\nError: Unknown action: ${argv.action}`));
-    console.error(chalk.yellow(`Valid actions: ${validActions.join(', ')}`));
-    return;
-  }
-
-  // Route to appropriate handler
-  try {
-    switch (argv.action) {
-      case 'list':
-        await prdList(argv);
-        break;
-      case 'new':
-        await prdNew(argv);
-        break;
-      case 'show':
-        await prdShow(argv);
-        break;
-      case 'edit':
-        await prdEdit(argv);
-        break;
-      case 'status':
-        await prdStatus(argv);
-        break;
-      case 'parse':
-        await prdParse(argv);
-        break;
-      case 'extract-epics':
-        await prdExtractEpics(argv);
-        break;
-      case 'summarize':
-        await prdSummarize(argv);
-        break;
-      case 'validate':
-        await prdValidate(argv);
-        break;
+      console.error(chalk.red(`\n✗ Error: ${error.message}`));
+      if (process.env.DEBUG) {
+        console.error(chalk.gray('\nStack trace:'));
+        console.error(chalk.gray(error.stack));
+      }
     }
-  } catch (error) {
-    // Global error handler for unexpected errors
-    console.error(chalk.red(`\nUnexpected error: ${error.message}`));
+    process.exit(1);
   }
 }
 
@@ -585,7 +625,8 @@ function builder(yargs) {
       (yargs) => {
         return yargs
           .example('autopm prd list', 'Show all PRDs');
-      }
+      },
+      prdList  // Handler
     )
     .command(
       'new <name>',
@@ -603,7 +644,8 @@ function builder(yargs) {
           })
           .example('autopm prd new my-feature', 'Create PRD with wizard')
           .example('autopm prd new payment-api --template api-feature', 'Create PRD from template');
-      }
+      },
+      prdNew  // Handler
     )
     .command(
       'show <name>',
@@ -615,7 +657,8 @@ function builder(yargs) {
             type: 'string'
           })
           .example('autopm prd show my-feature', 'Display PRD content');
-      }
+      },
+      prdShow  // Handler
     )
     .command(
       'edit <name>',
@@ -628,7 +671,8 @@ function builder(yargs) {
           })
           .example('autopm prd edit my-feature', 'Open PRD in editor')
           .example('EDITOR=code autopm prd edit my-feature', 'Open PRD in VS Code');
-      }
+      },
+      prdEdit  // Handler
     )
     .command(
       'status <name>',
@@ -640,7 +684,8 @@ function builder(yargs) {
             type: 'string'
           })
           .example('autopm prd status my-feature', 'Show PRD status report');
-      }
+      },
+      prdStatus  // Handler
     )
     .command(
       'parse <name>',
@@ -661,7 +706,8 @@ function builder(yargs) {
             type: 'boolean',
             default: true
           });
-      }
+      },
+      prdParse  // Handler
     )
     .command(
       'extract-epics <name>',
@@ -677,7 +723,8 @@ function builder(yargs) {
             type: 'boolean',
             default: false
           });
-      }
+      },
+      prdExtractEpics  // Handler
     )
     .command(
       'summarize <name>',
@@ -693,7 +740,8 @@ function builder(yargs) {
             type: 'boolean',
             default: false
           });
-      }
+      },
+      prdSummarize  // Handler
     )
     .command(
       'validate <name>',
@@ -704,7 +752,8 @@ function builder(yargs) {
             describe: 'PRD name (without .md extension)',
             type: 'string'
           });
-      }
+      },
+      prdValidate  // Handler
     )
     .demandCommand(1, 'You must specify a PRD action')
     .strictCommands()
@@ -715,10 +764,27 @@ function builder(yargs) {
  * Command export
  */
 module.exports = {
-  command: 'prd <action> [name]',
+  command: 'prd',
   describe: 'Manage PRD (Product Requirements Documents)',
   builder,
-  handler,
+  handler: (argv) => {
+    // This is just for catching the base command without subcommand
+    if (!argv._.includes('prd') || argv._.length === 1) {
+      console.log(chalk.yellow('\nPlease specify a PRD command\n'));
+      console.log('Usage: autopm prd <command>\n');
+      console.log('Available commands:');
+      console.log('  list                  List all PRDs');
+      console.log('  new <name>            Create new PRD');
+      console.log('  show <name>           Display PRD');
+      console.log('  edit <name>           Edit PRD');
+      console.log('  status <name>         Show PRD status');
+      console.log('  parse <name>          Parse PRD with AI');
+      console.log('  extract-epics <name>  Extract epics');
+      console.log('  summarize <name>      Generate summary');
+      console.log('  validate <name>       Validate structure');
+      console.log('\nUse: autopm prd <command> --help for more info\n');
+    }
+  },
   handlers: {
     list: prdList,
     new: prdNew,

package/package.json

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