hone-ai 0.2.0 → 0.9.0

package/src/index.ts

@@ -1,29 +1,34 @@
 #!/usr/bin/env bun
-import { Command } from 'commander';
-import { loadConfig, ensurePlansDir, resolveAgent, initProject } from './config';
-import type { AgentType } from './config';
-import { listPrds } from './prds';
-import { listIncompleteTaskFiles } from './status';
-import { generatePRD } from './prd-generator';
-import { generateTasksFromPRD } from './task-generator';
-import { setVerbose } from './logger';
+import { Command } from 'commander'
+import { loadConfig, ensurePlansDir, resolveAgent, initProject } from './config'
+import type { AgentType } from './config'
+import { listPrds } from './prds'
+import { listIncompleteTaskFiles } from './status'
+import { generatePRD } from './prd-generator'
+import { generateTasksFromPRD } from './task-generator'
+import { setVerbose } from './logger'
+import packageJson from '../package.json'
 
-const program = new Command();
+const program = new Command()
 
 // Get command name to avoid auto-init on 'init' command
-const isInitCommand = process.argv[2] === 'init';
+const isInitCommand = process.argv[2] === 'init'
 
 // Auto-initialize for all commands except 'init'
 if (!isInitCommand) {
-  ensurePlansDir();
-  loadConfig().catch(console.error);
+  ensurePlansDir()
+  loadConfig().catch(console.error)
 }
 
 program
   .name('hone')
-  .description('AI Coding Agent Orchestrator - Orchestrate AI agents to implement features based on PRDs')
-  .version('0.1.0')
-  .addHelpText('after', `
+  .description(
+    'AI Coding Agent Orchestrator - Orchestrate AI agents to implement features based on PRDs'
+  )
+  .version(packageJson.version, '-v, --version', 'output the current version')
+  .addHelpText(
+    'after',
+    `
 Model Configuration:
   Configure models in .plans/hone.config.yml:
   
@@ -35,14 +40,16 @@ Model Configuration:
     implement: claude-opus-4-20250514     # Override for implementation (optional)
     review: claude-sonnet-4-20250514      # Override for review (optional)
     finalize: claude-sonnet-4-20250514    # Override for finalization (optional)
+    agentsMd: claude-sonnet-4-20250514    # Override for AGENTS.md generation (optional)
   
   Phase-specific models are optional and override agent-specific models.
   Check available models: opencode --help or claude --help
-`);
+`
+  )
 
 // Global flags
-program.option('--agent <type>', 'Override default agent (opencode or claude)');
-program.option('--verbose', 'Show detailed agent interaction logs');
+program.option('--agent <type>', 'Override default agent (opencode or claude)')
+program.option('--verbose', 'Show detailed agent interaction logs')
 
 // Commands
 program
@@ -50,127 +57,131 @@ program
   .description('Initialize hone in current directory')
   .action(async () => {
     try {
-      const result = await initProject();
-      
+      const result = await initProject()
+
       if (!result.plansCreated && !result.configCreated) {
-        console.log('hone is already initialized in this directory.');
-        console.log('');
-        console.log('  .plans/ directory: exists');
-        console.log('  config file: exists');
-        return;
+        console.log('hone is already initialized in this directory.')
+        console.log('')
+        console.log('  .plans/ directory: exists')
+        console.log('  config file: exists')
+        return
       }
-      
-      console.log('Initialized hone successfully!');
-      console.log('');
-      
+
+      console.log('Initialized hone successfully!')
+      console.log('')
+
       if (result.plansCreated) {
-        console.log('  ✓ Created .plans/ directory');
+        console.log('  ✓ Created .plans/ directory')
       } else {
-        console.log('  • .plans/ directory already exists');
+        console.log('  • .plans/ directory already exists')
       }
-      
+
       if (result.configCreated) {
-        console.log('  ✓ Created .plans/hone.config.yml');
+        console.log('  ✓ Created .plans/hone.config.yml')
       } else {
-        console.log('  • .plans/hone.config.yml already exists');
+        console.log('  • .plans/hone.config.yml already exists')
       }
-      
-      console.log('');
-      console.log('Next steps:');
-      console.log('  1. Install opencode or claude CLI (hone uses agent subprocesses)');
-      console.log('  2. Generate a PRD: hone prd "your feature description"');
-      console.log('  3. Generate tasks: hone prd-to-tasks .plans/prd-<feature>.md');
-      console.log('  4. Execute tasks: hone run .plans/tasks-<feature>.yml -i 5');
+
+      console.log('')
+      console.log('Next steps:')
+      console.log('  1. Install opencode or claude CLI (hone uses agent subprocesses)')
+      console.log('  2. Generate a PRD: hone prd "your feature description"')
+      console.log('  3. Generate tasks: hone prd-to-tasks .plans/prd-<feature>.md')
+      console.log('  4. Execute tasks: hone run .plans/tasks-<feature>.yml -i 5')
     } catch (error) {
-      console.error('\n✗ Error initializing hone:', error instanceof Error ? error.message : error);
-      process.exit(1);
+      console.error('\n✗ Error initializing hone:', error instanceof Error ? error.message : error)
+      process.exit(1)
     }
-  });
+  })
 
 program
   .command('prds')
   .description('List all PRDs in .plans/ directory')
   .action(async () => {
-    const prds = await listPrds();
-    
+    const prds = await listPrds()
+
     if (prds.length === 0) {
-      console.log('No PRDs found in .plans/');
-      console.log('');
-      console.log('Create a PRD with: hone prd "your feature description"');
-      return;
+      console.log('No PRDs found in .plans/')
+      console.log('')
+      console.log('Create a PRD with: hone prd "your feature description"')
+      return
     }
-    
-    console.log('PRDs in .plans/');
-    console.log('');
-    
+
+    console.log('PRDs in .plans/')
+    console.log('')
+
     for (const prd of prds) {
-      console.log(`  .plans/${prd.filename}`);
-      console.log(`    Tasks: ${prd.taskFile ? `.plans/${prd.taskFile}` : 'none'}`);
-      
-      if (prd.status === 'in progress' && prd.completedCount !== undefined && prd.totalCount !== undefined) {
-        console.log(`    Status: ${prd.status} (${prd.completedCount}/${prd.totalCount} completed)`);
+      console.log(`  .plans/${prd.filename}`)
+      console.log(`    Tasks: ${prd.taskFile ? `.plans/${prd.taskFile}` : 'none'}`)
+
+      if (
+        prd.status === 'in progress' &&
+        prd.completedCount !== undefined &&
+        prd.totalCount !== undefined
+      ) {
+        console.log(`    Status: ${prd.status} (${prd.completedCount}/${prd.totalCount} completed)`)
       } else {
-        console.log(`    Status: ${prd.status}`);
+        console.log(`    Status: ${prd.status}`)
       }
-      console.log('');
+      console.log('')
     }
-  });
+  })
 
 program
   .command('status')
   .description('Show task status for incomplete task lists')
   .action(async () => {
-    const taskFiles = await listIncompleteTaskFiles();
-    
+    const taskFiles = await listIncompleteTaskFiles()
+
     if (taskFiles.length === 0) {
-      console.log('No incomplete task lists found.');
-      console.log('');
-      console.log('All tasks completed! 🎉');
-      return;
+      console.log('No incomplete task lists found.')
+      console.log('')
+      console.log('All tasks completed! 🎉')
+      return
     }
-    
-    console.log('Incomplete task lists:');
-    console.log('');
-    
+
+    console.log('Incomplete task lists:')
+    console.log('')
+
     for (const taskFile of taskFiles) {
-      console.log(`  .plans/${taskFile.filename}`);
-      console.log(`    Feature: ${taskFile.feature}`);
-      console.log(`    Progress: ${taskFile.completedCount}/${taskFile.totalCount} tasks completed`);
-      
+      console.log(`  .plans/${taskFile.filename}`)
+      console.log(`    Feature: ${taskFile.feature}`)
+      console.log(`    Progress: ${taskFile.completedCount}/${taskFile.totalCount} tasks completed`)
+
       if (taskFile.nextTask) {
-        console.log(`    Next: ${taskFile.nextTask.id} - ${taskFile.nextTask.title}`);
+        console.log(`    Next: ${taskFile.nextTask.id} - ${taskFile.nextTask.title}`)
       } else {
-        console.log(`    Next: (waiting for dependencies)`);
+        console.log(`    Next: (waiting for dependencies)`)
       }
-      console.log('');
+      console.log('')
     }
-  });
+  })
 
 program
   .command('prd <description>')
-  .description('Generate PRD interactively from feature description')
+  .description('Generate PRD interactively from feature description (supports file paths and URLs)')
   .action(async (description: string) => {
     try {
-      setVerbose(program.opts().verbose || false);
-      await generatePRD(description);
+      setVerbose(program.opts().verbose || false)
+      await generatePRD(description)
     } catch (error) {
-      console.error('\n✗ Error generating PRD:', error instanceof Error ? error.message : error);
-      process.exit(1);
+      console.error('\n✗ Error generating PRD:', error instanceof Error ? error.message : error)
+      process.exit(1)
     }
-  });
+  })
 
 program
   .command('prd-to-tasks <prd-file>')
   .description('Generate task list from PRD file')
   .action(async (prdFile: string) => {
     try {
-      setVerbose(program.opts().verbose || false);
-      await generateTasksFromPRD(prdFile);
+      setVerbose(program.opts().verbose || false)
+      await generateTasksFromPRD(prdFile)
     } catch (error) {
-      console.error('\n✗ Error generating tasks:', error instanceof Error ? error.message : error);
-      process.exit(1);
+      console.error('\n✗ Error generating tasks:', error instanceof Error ? error.message : error)
+      process.exit(1)
     }
-  });
+  })
 
 program
   .command('run <tasks-file>')
@@ -179,19 +190,71 @@ program
   .option('--skip <phase>', 'Skip a phase (e.g., review)')
   .action(async (tasksFile: string, options: { iterations: string; skip?: string }) => {
     try {
-      setVerbose(program.opts().verbose || false);
-      const agent = await resolveAgent(program.opts().agent);
-      const { executeTasks } = await import('./run');
+      setVerbose(program.opts().verbose || false)
+      const agent = await resolveAgent(program.opts().agent)
+      const { executeTasks } = await import('./run')
       await executeTasks({
         tasksFile,
         iterations: parseInt(options.iterations, 10),
         agent,
-        skipPhase: options.skip as 'review' | undefined
-      });
+        skipPhase: options.skip as 'review' | undefined,
+      })
     } catch (error) {
-      console.error('\n✗ Error executing tasks:', error instanceof Error ? error.message : error);
-      process.exit(1);
+      console.error('\n✗ Error executing tasks:', error instanceof Error ? error.message : error)
+      process.exit(1)
     }
-  });
+  })
+
+program
+  .command('agents-md')
+  .description('Generate AGENTS.md documentation for the current project')
+  .option('--overwrite', 'Overwrite existing AGENTS.md file if it exists')
+  .action(async (options: { overwrite?: boolean }) => {
+    try {
+      setVerbose(program.opts().verbose || false)
+      const agent = await resolveAgent(program.opts().agent)
+      const { generateAgentsMd } = await import('./agents-md-generator')
+      const result = await generateAgentsMd({ overwrite: options.overwrite, agent })
+
+      if (!result.success) {
+        if (result.error?.message.includes('already exists')) {
+          console.error('\n✗ AGENTS.md already exists')
+          console.error('\nUse --overwrite to replace the existing file.')
+          console.error('Or review the current AGENTS.md before regenerating.')
+        } else {
+          console.error('\n✗ Failed to generate AGENTS.md')
+          console.error(`\nError: ${result.error?.message || 'Unknown error'}`)
+        }
+        process.exit(1)
+      }
+    } catch (error) {
+      console.error('\n✗ Failed to generate AGENTS.md')
+      console.error(`\nError: ${error instanceof Error ? error.message : error}`)
+      process.exit(1)
+    }
+  })
+
+// Handle unknown commands and options by showing help
+program.configureOutput({
+  outputError: (str, write) => {
+    // Suppress error messages for unknown commands/options since we show help instead
+    if (!str.includes('unknown option') && !str.includes('unknown command')) {
+      write(str)
+    }
+  },
+})
+
+program.exitOverride(err => {
+  if (err.code === 'commander.unknownOption' || err.code === 'commander.unknownCommand') {
+    program.outputHelp()
+    process.exit(0)
+  }
+  // Re-throw all other errors to maintain normal behavior
+  if (err.exitCode === 0) {
+    // For normal exits (like --version, --help), just exit normally
+    process.exit(0)
+  }
+  throw err
+})
 
-program.parse();
+program.parse()