codehere 0.4.0 → 0.5.0-alpha

package/dist/index.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { config } from 'dotenv';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
 import { indexRepositoryParallel } from './embed.js';
 import { executeAskCommand } from './presentation/cli/commands/ask-command.js';
 import { executeReactCommand } from './presentation/cli/commands/react-command.js';
@@ -20,11 +21,16 @@ import { executeOrchestrateCommand } from './presentation/cli/commands/orchestra
 import { executeDocsCommand } from './presentation/cli/commands/docs-command.js';
 import { executeProductCommand } from './presentation/cli/commands/product-command.js';
 import { executeStatusCommand } from './presentation/cli/commands/status-command.js';
+import { executeSuggestCommand } from './presentation/cli/commands/suggest-command.js';
+import { executeRunCommand } from './presentation/cli/commands/run-command.js';
+import { executeModelsCommand } from './presentation/cli/commands/models-command.js';
+import { executeReviewCommand } from './presentation/cli/commands/review-command.js';
 import { executeDecisionCommand } from './presentation/cli/commands/decision-command.js';
 import { executeKnowledgeCommand } from './presentation/cli/commands/knowledge-command.js';
 import { executeLearningDashboardCommand } from './presentation/cli/commands/learning-dashboard-command.js';
 import { executeTraceCommand } from './presentation/cli/commands/trace-command.js';
 import { executeUndoCommand } from './presentation/cli/commands/undo-command.js';
+import { executeMemoryCommand } from './presentation/cli/commands/memory-command.js';
 import { reviewFile, formatReview } from './review.js';
 import { formatLearningInsights, getPerformanceInsights } from './learning.js';
 import { getCacheStats, clearAllCaches } from './cache.js';
@@ -33,7 +39,8 @@ import { generateTests, getTestFilePath, saveTests, improveTests } from './testg
 import { startSession } from './session.js';
 import { cleanResponse } from './formatter.js';
 import { displayError } from './presentation/cli/error-display.js';
-import { colors, createSpinner, createBanner, createTable, success, error, warning, info, formatPath, formatNumber, sectionHeader, newline, createWelcomeMessage, } from './ui.js';
+import { getTelemetryService } from './infrastructure/telemetry/telemetry-service.js';
+import { colors, createSpinner, createBanner, createTable, success, error, warning, info, formatPath, formatNumber, sectionHeader, newline, createWelcomeMessage, isMinimalStyle, printMinimalHeader, } from './ui.js';
 // Load environment variables - try agent directory first, then current directory
 try {
     const __filename = fileURLToPath(import.meta.url);
@@ -133,6 +140,90 @@ program
     .action(async (action, key, value) => {
     await executeConfigCommand(action, key, value);
 });
+program
+    .command('models')
+    .description('List, search, and get info about available AI models')
+    .option('-l, --list', 'List all available models')
+    .option('-s, --search <query>', 'Search models by name or ID')
+    .option('-i, --info <model-id>', 'Get detailed info about a specific model')
+    .option('-p, --provider <provider>', 'Filter by provider (cohere, openai, openrouter, etc.)')
+    .option('--json', 'Output in JSON format')
+    .action(async (options) => {
+    initLogFile();
+    try {
+        await executeModelsCommand({
+            list: options.list,
+            search: options.search,
+            info: options.info,
+            provider: options.provider,
+            json: options.json,
+        });
+    }
+    catch (err) {
+        console.error(error('Error:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+program
+    .command('telemetry')
+    .description('Manage telemetry settings (opt-in, privacy-first)')
+    .option('--enable', 'Enable telemetry')
+    .option('--disable', 'Disable telemetry')
+    .option('--status', 'Show telemetry status')
+    .action(async (options) => {
+    const telemetry = getTelemetryService();
+    if (options.enable) {
+        telemetry.enable();
+        console.log(success('Telemetry enabled. Thank you for helping improve Codehere!'));
+        console.log(colors.dim('Data is anonymized and no code/content is transmitted.'));
+        newline();
+    }
+    else if (options.disable) {
+        telemetry.disable();
+        console.log(success('Telemetry disabled.'));
+        newline();
+    }
+    else {
+        console.log(colors.bold('Telemetry Status:'));
+        newline();
+        console.log(telemetry.isEnabled()
+            ? success('Enabled (opt-in)')
+            : colors.dim('Disabled (set --enable to opt-in)'));
+        newline();
+        console.log(colors.dim('Telemetry helps us understand usage patterns and improve Codehere.'));
+        console.log(colors.dim('All data is anonymized. No code or content is transmitted.'));
+        console.log(colors.dim('Enable with: codehere telemetry --enable'));
+        newline();
+    }
+});
+program
+    .command('memory')
+    .description('View and manage Codehere\'s operation history (XAI: See what Codehere remembers)')
+    .option('-l, --list', 'List all memories')
+    .option('-s, --search <term>', 'Search memories by description or type')
+    .option('--stats', 'Show memory statistics')
+    .option('--clear', 'Clear memories (requires --confirm)')
+    .option('--limit <number>', 'Limit number of results (default: 20)')
+    .option('--type <type>', 'Filter by memory type (observation, reflection, plan)')
+    .option('--json', 'Output in JSON format')
+    .action(async (options) => {
+    initLogFile();
+    try {
+        await executeMemoryCommand({
+            list: options.list,
+            search: options.search,
+            stats: options.stats,
+            clear: options.clear,
+            limit: options.limit ? parseInt(options.limit, 10) : undefined,
+            type: options.type,
+            json: options.json,
+        });
+    }
+    catch (err) {
+        displayError(err, { operation: 'memory' });
+        process.exit(1);
+    }
+});
 program
     .command('help')
     .description('Show help for commands')
@@ -146,7 +237,8 @@ program
     .option('-r, --repo <path>', 'Repository path (default: current directory)')
     .action(async (options) => {
     initLogFile();
-    if (!process.env.COHERE_API_KEY) {
+    // Allow fake AI for testing, or require real API key
+    if (!process.env.COHERE_API_KEY && process.env.CODEHERE_FAKE_AI !== '1') {
         newline();
         console.error(error('COHERE_API_KEY not found in environment'));
         newline();
@@ -155,12 +247,20 @@ program
         console.log('  2. Create a .env file in your project root:');
         console.log(colors.cyan('     echo "COHERE_API_KEY=your_key_here" > .env'));
         console.log('  3. Run the command again');
+        console.log('');
+        console.log(colors.dim('Note: For testing without API calls, set CODEHERE_FAKE_AI=1'));
         newline();
         process.exit(1);
     }
     try {
-        console.log(createBanner('Indexing Repository', 'Building semantic search index'));
-        newline();
+        if (isMinimalStyle()) {
+            console.log(colors.cyan('Indexing codebase...'));
+            newline();
+        }
+        else {
+            console.log(createBanner('Indexing Repository', 'Building semantic search index'));
+            newline();
+        }
         const repoPath = options.repo || process.cwd();
         // NEW: Use parallel indexing with caching
         await indexRepositoryParallel(repoPath, {
@@ -173,10 +273,32 @@ program
             policyStatus: 'allowed',
         });
         newline();
-        console.log(success('Indexing complete!'));
+        if (isMinimalStyle()) {
+            console.log(success('Indexing complete. Cache written to .codehere-cache/'));
+        }
+        else {
+            console.log(success('Indexing complete!'));
+        }
+        process.exit(0);
     }
     catch (err) {
-        console.error(error('Error indexing repository:'), err instanceof Error ? err.message : String(err));
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        // Check for 401 Unauthorized errors
+        if (errorMessage.includes('401') || errorMessage.includes('Unauthorized') || errorMessage.includes('no api key')) {
+            newline();
+            console.error(error('Authentication failed: Invalid or missing API key'));
+            newline();
+            console.log(colors.bold('Troubleshooting:'));
+            console.log('  1. Verify your COHERE_API_KEY is set correctly:');
+            console.log(colors.cyan('     echo $COHERE_API_KEY'));
+            console.log('  2. Check if the key is valid at: https://dashboard.cohere.com/api-keys');
+            console.log('  3. If using a .env file, ensure it\'s loaded (e.g., use dotenv)');
+            console.log('  4. For testing, you can use: CODEHERE_FAKE_AI=1 codehere index');
+            newline();
+        }
+        else {
+            console.error(error('Error indexing repository:'), errorMessage);
+        }
         process.exit(1);
     }
 });
@@ -185,22 +307,28 @@ program
     .description('Ask questions about your codebase using semantic search')
     .argument('<question>', 'The question to ask about your code')
     .alias('q')
+    .option('--explain', 'Show explainable AI (XAI) reasoning steps')
+    .option('--json', 'Output in JSON format')
     .addHelpText('after', `
 Examples:
   $ codehere ask "How does authentication work?"
-  $ codehere ask "Where is the user login function?"
+  $ codehere ask "Where is the user login function?" --explain
   $ codehere q "Explain the database schema"
 
 This command will:
   • Search your indexed codebase for relevant code
   • Use AI to generate a contextual answer
   • Show which files were used as context
+  • Use memories from past interactions (XAI: visible with --explain)
+
+Options:
+  --explain    Show explainable AI (XAI) reasoning steps
 
 Make sure to run "codehere index" first!
   `)
-    .action(async (question) => {
+    .action(async (question, options) => {
     initLogFile();
-    if (!process.env.COHERE_API_KEY) {
+    if (!process.env.COHERE_API_KEY && process.env.CODEHERE_FAKE_AI !== '1') {
         newline();
         console.error(error('COHERE_API_KEY not found in environment'));
         newline();
@@ -213,21 +341,7 @@ Make sure to run "codehere index" first!
         process.exit(1);
     }
     try {
-        console.log(createBanner('Ask Question', 'Semantic search + AI chat'));
-        newline();
-        // Display query
-        console.log(colors.bold('Query:'));
-        console.log(colors.cyan('  ' + question));
-        newline();
-        // Use clean architecture
-        const searchSpinner = createSpinner('Searching codebase...');
-        searchSpinner.start();
-        try {
-            await executeAskCommand(question);
-        }
-        finally {
-            searchSpinner.stop();
-        }
+        await executeAskCommand(question, { explain: options?.explain, json: options?.json });
         logEntry({
             timestamp: new Date().toISOString(),
             command: 'ask',
@@ -236,7 +350,12 @@ Make sure to run "codehere index" first!
         });
     }
     catch (err) {
-        console.error(error('Error:'), err instanceof Error ? err.message : String(err));
+        const errMessage = err instanceof Error ? err.message : String(err);
+        // If it's a missing embeddings error, exit with 1
+        if (errMessage.includes('No embeddings found')) {
+            process.exit(1);
+        }
+        console.error(error('Error:'), errMessage);
         process.exit(1);
     }
 });
@@ -282,6 +401,23 @@ Safety policies:
         process.exit(1);
     }
     try {
+        // Check if embeddings exist for this repository (skip check if using fake AI for testing)
+        if (process.env.CODEHERE_FAKE_AI !== '1') {
+            const { container } = await import('./application/services/dependency-container.js');
+            const embeddingRepo = container.getEmbeddingRepository(process.cwd());
+            const hasEmbeddings = await embeddingRepo.hasEmbeddings();
+            if (!hasEmbeddings) {
+                newline();
+                console.error(colors.red('No embeddings found for this repository.'));
+                newline();
+                console.log('Run:');
+                console.log(colors.cyan('  codehere index'));
+                console.log('');
+                console.log('then re-run this command.');
+                newline();
+                process.exit(1);
+            }
+        }
         await executeFixCommand(file, instruction, { review: options?.review });
         logEntry({
             timestamp: new Date().toISOString(),
@@ -332,8 +468,30 @@ This command will:
         process.exit(1);
     }
     try {
-        console.log(createBanner('Explain File', 'AI-powered code explanation'));
-        newline();
+        // Check if embeddings exist for this repository (skip check if using fake AI for testing)
+        if (process.env.CODEHERE_FAKE_AI !== '1') {
+            const { container } = await import('./application/services/dependency-container.js');
+            const embeddingRepo = container.getEmbeddingRepository(process.cwd());
+            const hasEmbeddings = await embeddingRepo.hasEmbeddings();
+            if (!hasEmbeddings) {
+                newline();
+                console.error(colors.red('No embeddings found for this repository.'));
+                newline();
+                console.log('Run:');
+                console.log(colors.cyan('  codehere index'));
+                console.log('');
+                console.log('then re-run this command.');
+                newline();
+                process.exit(1);
+            }
+        }
+        if (isMinimalStyle()) {
+            printMinimalHeader('explain', file);
+        }
+        else {
+            console.log(createBanner('Explain File', 'AI-powered code explanation'));
+            newline();
+        }
         const fullPath = join(process.cwd(), file);
         // Check if file exists
         const { existsSync } = await import('fs');
@@ -383,9 +541,14 @@ program
     .option('-m, --metrics', 'Show detailed metrics')
     .action((options) => {
     const health = performHealthCheck();
-    newline();
-    console.log(createBanner('System Health', 'Enterprise monitoring'));
-    newline();
+    if (isMinimalStyle()) {
+        printMinimalHeader('health', '');
+    }
+    else {
+        newline();
+        console.log(createBanner('System Health', 'Enterprise monitoring'));
+        newline();
+    }
     console.log(formatHealthStatus(health));
     if (options.metrics) {
         newline();
@@ -486,13 +649,13 @@ program
     }
 });
 program
-    .command('review')
+    .command('git-review')
     .description('Review git changes and suggest improvements')
     .option('-f, --file <file>', 'Review specific file')
     .action((options) => {
     initLogFile();
     try {
-        console.log(createBanner('Code Review', 'Git-aware code analysis'));
+        console.log(createBanner('Git Review', 'Git-aware code analysis'));
         newline();
         const status = getGitStatus();
         if (!status.isRepo) {
@@ -542,6 +705,7 @@ program
     .argument('<instruction>', 'Complex instruction to plan')
     .option('-e, --execute', 'Execute the plan after creating it')
     .option('--review', 'Enable review & feedback capture (used for trust scoring and Validation Mode)')
+    .option('--json', 'Output in JSON format')
     .action(async (instruction, options) => {
     initLogFile();
     if (!process.env.COHERE_API_KEY) {
@@ -549,12 +713,20 @@ program
         process.exit(1);
     }
     try {
-        console.log(createBanner('Task Planning', 'Intelligent multi-step execution'));
-        newline();
-        console.log(colors.bold('Instruction:') + ' ' + colors.cyan(instruction));
-        newline();
+        // Suppress header in JSON mode
+        if (!options.json) {
+            if (isMinimalStyle()) {
+                printMinimalHeader('plan', instruction);
+            }
+            else {
+                console.log(createBanner('Task Planning', 'Intelligent multi-step execution'));
+                newline();
+                console.log(colors.bold('Instruction:') + ' ' + colors.cyan(instruction));
+            }
+            newline();
+        }
         // Use new memory-based planning
-        await executePlanCommand(instruction, { execute: options.execute, review: options.review });
+        await executePlanCommand(instruction, { execute: options.execute, review: options.review, json: options.json });
     }
     catch (err) {
         console.error(error('Error:'), err instanceof Error ? err.message : String(err));
@@ -633,24 +805,38 @@ program
         process.exit(1);
     }
     try {
-        console.log(createBanner('Code Review', 'Automated senior-level analysis'));
-        newline();
+        if (isMinimalStyle()) {
+            console.log(colors.bold(`Review: ${file}`));
+            newline();
+        }
+        else {
+            console.log(createBanner('Code Review', 'Automated senior-level analysis'));
+            newline();
+        }
         const reviewSpinner = createSpinner('Reviewing code...');
         reviewSpinner.start();
         const review = await reviewFile(file);
         reviewSpinner.stop();
         newline();
-        console.log(formatReview(review));
-        // Display score
-        newline();
-        sectionHeader('Review Score');
-        const scoreTable = createTable(['Metric', 'Value'], [
-            ['Overall Score', `${review.score}/100`],
-            ['Errors', formatNumber(review.issues.filter(i => i.severity === 'error').length)],
-            ['Warnings', formatNumber(review.issues.filter(i => i.severity === 'warning').length)],
-            ['Info', formatNumber(review.issues.filter(i => i.severity === 'info').length)],
-        ]);
-        console.log(scoreTable.toString());
+        if (isMinimalStyle()) {
+            console.log(colors.bold('Findings:'));
+            console.log(formatReview(review));
+            newline();
+            console.log(colors.dim(`Score: ${review.score}/100`));
+        }
+        else {
+            console.log(formatReview(review));
+            // Display score
+            newline();
+            sectionHeader('Review Score');
+            const scoreTable = createTable(['Metric', 'Value'], [
+                ['Overall Score', `${review.score}/100`],
+                ['Errors', formatNumber(review.issues.filter(i => i.severity === 'error').length)],
+                ['Warnings', formatNumber(review.issues.filter(i => i.severity === 'warning').length)],
+                ['Info', formatNumber(review.issues.filter(i => i.severity === 'info').length)],
+            ]);
+            console.log(scoreTable.toString());
+        }
     }
     catch (err) {
         console.error(error('Error:'), err instanceof Error ? err.message : String(err));
@@ -820,10 +1006,157 @@ Warning: This command may create new files if --output is specified.
 // Status command
 program
     .command('status')
-    .description('Show per-agent reliability and trust scores based on feedback records (from data/feedback/agent-feedback.jsonl). Run commands with --review to collect feedback.')
+    .description('Show system status and optionally list recent tasks')
     .option('--json', 'Output machine-readable JSON summary instead of text')
+    .option('--tasks', 'Show recent tasks (experimental)')
+    .option('--env', 'Show environment details')
+    .option('--track', 'Show what works (success rates by command)')
     .action(async (options) => {
-    await executeStatusCommand({ json: Boolean(options.json) });
+    await executeStatusCommand({
+        json: Boolean(options.json),
+        tasks: Boolean(options.tasks),
+        env: Boolean(options.env),
+        track: Boolean(options.track),
+    });
+});
+// Suggest command - Read-only assistant mode
+program
+    .command('suggest')
+    .description('Read-only assistant mode - ask questions and get explanations without making changes')
+    .argument('<query>', 'The question or request')
+    .option('--file <file>', 'Focus on a specific file')
+    .addHelpText('after', `
+Examples:
+  $ codehere suggest "How does authentication work?"
+  $ codehere suggest "Explain this function" --file src/auth.ts
+
+This command:
+  • Searches your codebase for relevant code
+  • Provides contextual answers and explanations
+  • Does NOT make any changes (read-only mode)
+  • Creates a task record for tracking
+  `)
+    .action(async (query, options) => {
+    initLogFile();
+    if (!process.env.COHERE_API_KEY) {
+        newline();
+        console.error(error('COHERE_API_KEY not found in environment'));
+        process.exit(1);
+    }
+    try {
+        await executeSuggestCommand(query, {
+            file: options.file,
+            stream: false,
+        });
+        logEntry({
+            timestamp: new Date().toISOString(),
+            command: 'suggest',
+            query,
+            policyStatus: 'allowed',
+        });
+    }
+    catch (err) {
+        const errMessage = err instanceof Error ? err.message : String(err);
+        // If it's a missing embeddings error, exit with 1 (message already shown)
+        if (errMessage.includes('No embeddings found')) {
+            process.exit(1);
+        }
+        console.error(error('Error:'), errMessage);
+        process.exit(1);
+    }
+});
+// Run command - Unified agentic execution
+program
+    .command('run')
+    .description('Unified agentic execution - execute a task or goal')
+    .argument('<goal>', 'The goal to execute')
+    .option('--task-id <id>', 'Continue execution of an existing task')
+    .option('--file <file>', 'Focus on a specific file')
+    .option('--files <files>', 'Comma-separated list of files to process')
+    .option('--review', 'Enable review before applying changes')
+    .addHelpText('after', `
+Examples:
+  $ codehere run "Add error handling to the login function"
+  $ codehere run "Refactor authentication module" --file src/auth.ts
+  $ codehere run "Fix bug in payment processing" --task-id task-12345
+
+This command:
+  • Creates a plan for the goal
+  • Executes the plan step-by-step
+  • Creates/updates task records for tracking
+  • Shows risk tier and environment mode (advisory)
+  `)
+    .action(async (goal, options) => {
+    initLogFile();
+    if (!process.env.COHERE_API_KEY) {
+        newline();
+        console.error(error('COHERE_API_KEY not found in environment'));
+        process.exit(1);
+    }
+    try {
+        const files = options.files ? options.files.split(',').map((f) => f.trim()) : undefined;
+        await executeRunCommand(goal, {
+            taskId: options.taskId,
+            file: options.file,
+            files,
+            review: Boolean(options.review),
+        });
+        logEntry({
+            timestamp: new Date().toISOString(),
+            command: 'run',
+            query: goal,
+            policyStatus: 'allowed',
+        });
+    }
+    catch (err) {
+        console.error(error('Error:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+// Review command - Task review interface
+program
+    .command('review')
+    .description('Review and approve/reject tasks')
+    .argument('[task-id]', 'Task ID to review (omit to list tasks)')
+    .option('--list', 'List tasks needing review')
+    .option('--approve', 'Approve the task')
+    .option('--reject', 'Reject the task')
+    .option('--comment <text>', 'Add a comment to the review')
+    .option('--all', 'Show all completed tasks in list mode')
+    .addHelpText('after', `
+Examples:
+  $ codehere review --list
+  $ codehere review task-12345
+  $ codehere review task-12345 --approve
+  $ codehere review task-12345 --reject --comment "Security concerns"
+
+This command:
+  • Lists tasks that need review
+  • Shows task details (files changed, risk tier, etc.)
+  • Allows approving or rejecting tasks
+  • Updates task status and review records
+  `)
+    .action(async (taskId, options) => {
+    initLogFile();
+    try {
+        await executeReviewCommand(taskId, {
+            list: Boolean(options.list),
+            approve: Boolean(options.approve),
+            reject: Boolean(options.reject),
+            comment: options.comment,
+            all: Boolean(options.all),
+        });
+        logEntry({
+            timestamp: new Date().toISOString(),
+            command: 'review',
+            query: taskId,
+            policyStatus: 'allowed',
+        });
+    }
+    catch (err) {
+        console.error(error('Error:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
 });
 program
     .command('test')
@@ -917,6 +1250,7 @@ This command uses ReAct (Reasoning + Acting) pattern:
 });
 program
     .command('orchestrate')
+    .option('--json', 'Output in JSON format')
     .description('Orchestrate multi-agent workflows (plan, execute, validate)')
     .argument('<goal>', 'The goal to orchestrate')
     .option('-m, --mode <mode>', 'Orchestration mode: plan-only, execute-only, or full', 'full')
@@ -934,6 +1268,7 @@ program
             mode: options.mode,
             planId: options.planId,
             review: options.review,
+            json: options.json,
         });
         logEntry({
             timestamp: new Date().toISOString(),
@@ -1050,5 +1385,23 @@ program
         process.exit(1);
     }
 });
+// Initialize telemetry and track command
+const telemetry = getTelemetryService();
+// Track command usage (if enabled)
+const commandName = process.argv[2] || 'default';
+if (commandName !== 'telemetry') {
+    telemetry.trackCommand(commandName);
+}
+// Check for first run (install tracking)
+const codebaseRoot = process.cwd();
+const codehereDir = join(codebaseRoot, '.codehere');
+if (!existsSync(codehereDir)) {
+    // First run - track install
+    telemetry.track('install', {
+        version: process.env.npm_package_version || 'unknown',
+        os: process.platform,
+        nodeVersion: process.version,
+    });
+}
 program.parse();
 //# sourceMappingURL=index.js.map