codehere 0.2.1 → 0.3.0-rc.1

package/dist/presentation/cli/commands/cost-command.js

@@ -1,191 +0,0 @@
-/**
- * CLI Command: Cost
- * View API cost tracking and budget status
- *
- * Clean Architecture: Presentation Layer
- */
-import { getCostTracker } from '../../../infrastructure/cost/cost-tracker.js';
-import { colors, sectionHeader, success, error, warning, info, newline, createBanner, createTable, formatNumber, } from '../../../ui.js';
-import { executionTracer } from '../../../infrastructure/observability/execution-tracer.js';
-import { findCodebaseRoot } from '../../../domain/services/codebase-detector.js';
-export async function executeCostCommand(action, runId) {
-    // Start execution tracing
-    const codebaseInfo = findCodebaseRoot(process.cwd());
-    const traceRunId = executionTracer.startRun('cost', {
-        codebaseId: codebaseInfo?.rootPath || process.cwd(),
-    });
-    try {
-        console.log(createBanner('Cost Tracking', 'What you\'re spending'));
-        newline();
-        const costTracker = getCostTracker();
-        switch (action) {
-            case 'status': {
-                await showBudgetStatus(costTracker);
-                break;
-            }
-            case 'summary': {
-                await showCostSummary(costTracker);
-                break;
-            }
-            case 'run': {
-                if (!runId) {
-                    console.log(error('Run ID is required for "run" action'));
-                    console.log(info('Usage: codehere cost run <runId>'));
-                    return;
-                }
-                await showRunCosts(costTracker, runId);
-                break;
-            }
-            case 'reset': {
-                await resetCosts(costTracker);
-                break;
-            }
-            default:
-                console.log(error(`Unknown action: ${action}`));
-                console.log(info('Available actions: status, summary, run, reset'));
-        }
-    }
-    catch (err) {
-        const { displayError } = await import('../error-display.js');
-        displayError(err, {
-            operation: `cost-${action}`,
-            showSuggestions: true,
-        });
-        throw err;
-    }
-    finally {
-        executionTracer.endRun();
-    }
-}
-async function showBudgetStatus(costTracker) {
-    const status = await costTracker.getBudgetStatus();
-    const budgetLimit = costTracker.getBudgetLimit();
-    sectionHeader('Cost Tracking (LOCAL ESTIMATE)');
-    newline();
-    console.log(warning('⚠️  This is a local estimate based on token counts, not your actual billing.'));
-    console.log(colors.dim('   It does NOT sync with your provider billing dashboard.'));
-    console.log(colors.dim('   Check your provider dashboard for actual usage.'));
-    console.log(colors.dim('   Use "codehere cost reset" to reset for new billing period.'));
-    newline();
-    if (budgetLimit !== null && budgetLimit > 0 && status.percentage !== null) {
-        const percentage = status.percentage;
-        const barLength = 40;
-        const filled = Math.floor((percentage / 100) * barLength);
-        const bar = '█'.repeat(filled) + '░'.repeat(barLength - filled);
-        let barColor = colors.green;
-        if (percentage >= 100) {
-            barColor = colors.yellow; // Changed from red to yellow - it's just a warning
-        }
-        else if (percentage >= 80) {
-            barColor = colors.yellow;
-        }
-        console.log(colors.bold('Budget Status (Local Estimate Only):'));
-        console.log(`  ${barColor(bar)} ${percentage.toFixed(1)}%`);
-        newline();
-        console.log(colors.bold('Details:'));
-        console.log(`  Spent (Estimate): ${colors.cyan(`$${status.spent.toFixed(4)}`)}`);
-        console.log(`  Limit: ${colors.cyan(`$${status.limit.toFixed(2)}`)}`);
-        console.log(`  Remaining: ${colors.cyan(`$${status.remaining.toFixed(4)}`)}`);
-        newline();
-        if (status.alert) {
-            console.log(warning('⚠️  Approaching budget limit (local estimate only)!'));
-            console.log(colors.dim('   This is a LOCAL ESTIMATE - check https://dashboard.cohere.com for actual usage'));
-            console.log(colors.dim('   API calls will continue. Run "codehere cost reset" to reset local tracking.'));
-            newline();
-        }
-        if (status.spent >= status.limit) {
-            console.log(warning('⚠️  Budget exceeded (local estimate only)!'));
-            console.log(colors.dim('   This is a LOCAL ESTIMATE - check https://dashboard.cohere.com for actual usage'));
-            console.log(colors.dim('   API calls will continue. Run "codehere cost reset" to reset local tracking.'));
-            newline();
-        }
-    }
-    else {
-        console.log(colors.bold('No Budget Limit Set'));
-        console.log(colors.dim('   Set CODEHERE_BUDGET_LIMIT env var to enable budget tracking.'));
-        newline();
-        console.log(colors.bold('Current Usage (Estimate):'));
-        console.log(`  Total: ${colors.cyan(`$${status.spent.toFixed(4)}`)}`);
-        newline();
-    }
-}
-async function showCostSummary(costTracker) {
-    const summary = await costTracker.getSummary();
-    sectionHeader('Cost Summary');
-    newline();
-    console.log(colors.bold('Total Costs:'));
-    console.log(`  Total: ${colors.cyan(`$${summary.totalCost.toFixed(4)}`)}`);
-    console.log(`  Operations: ${formatNumber(summary.operationCount)}`);
-    console.log(`  Daily: ${colors.cyan(`$${summary.dailyCost.toFixed(4)}`)}`);
-    console.log(`  Monthly: ${colors.cyan(`$${summary.monthlyCost.toFixed(4)}`)}`);
-    newline();
-    if (Object.keys(summary.byOperation).length > 0) {
-        sectionHeader('Cost by Operation');
-        const operationRows = Object.entries(summary.byOperation)
-            .sort((a, b) => b[1].cost - a[1].cost)
-            .map(([operation, data]) => {
-            const d = data;
-            return [
-                operation,
-                formatNumber(d.count),
-                `$${d.cost.toFixed(4)}`,
-            ];
-        });
-        const operationTable = createTable(['Operation', 'Count', 'Cost'], operationRows);
-        console.log(operationTable.toString());
-        newline();
-    }
-    if (Object.keys(summary.byModel).length > 0) {
-        sectionHeader('Cost by Model');
-        const modelRows = Object.entries(summary.byModel)
-            .sort((a, b) => b[1].cost - a[1].cost)
-            .map(([model, data]) => {
-            const d = data;
-            return [
-                model,
-                formatNumber(d.count),
-                `$${d.cost.toFixed(4)}`,
-            ];
-        });
-        const modelTable = createTable(['Model', 'Count', 'Cost'], modelRows);
-        console.log(modelTable.toString());
-        newline();
-    }
-}
-async function showRunCosts(costTracker, runId) {
-    const costs = await costTracker.getRunCosts(runId);
-    if (costs.length === 0) {
-        console.log(warning(`No costs found for run ${runId}`));
-        return;
-    }
-    sectionHeader(`Costs for Run: ${runId}`);
-    newline();
-    const totalCost = costs.reduce((sum, cost) => sum + cost.cost, 0);
-    const costRows = costs.map((cost) => [
-        new Date(cost.timestamp).toISOString(),
-        cost.operation,
-        cost.model || 'default',
-        cost.inputTokens ? formatNumber(cost.inputTokens) : 'N/A',
-        cost.outputTokens ? formatNumber(cost.outputTokens) : 'N/A',
-        `$${cost.cost.toFixed(6)}`,
-    ]);
-    const costTable = createTable(['Timestamp', 'Operation', 'Model', 'Input Tokens', 'Output Tokens', 'Cost'], costRows);
-    console.log(costTable.toString());
-    newline();
-    console.log(colors.bold(`Total Run Cost: ${colors.cyan(`$${totalCost.toFixed(4)}`)}`));
-    newline();
-}
-async function resetCosts(costTracker) {
-    console.log(warning('⚠️  This will delete all LOCAL cost tracking records.'));
-    console.log(colors.dim('   This does NOT affect your actual Cohere billing.'));
-    console.log(colors.dim('   Use this to reset local tracking for a new billing period.'));
-    console.log(colors.dim('   This action cannot be undone.'));
-    newline();
-    // In a real implementation, you might want to add a confirmation prompt
-    // For now, we'll just reset
-    await costTracker.resetCosts();
-    console.log(success('Cost tracking reset.'));
-    console.log(colors.dim('   Note: This is local tracking only. Check Cohere dashboard for actual usage.'));
-    newline();
-}
-//# sourceMappingURL=cost-command.js.map

package/dist/presentation/cli/commands/decision-command.js

@@ -1,207 +0,0 @@
-/**
- * CLI Command: Decision
- * Record and query architectural/design decisions
- *
- * Clean Architecture: Presentation Layer
- */
-import { container } from '../../../application/services/dependency-container.js';
-import { findCodebaseRoot } from '../../../domain/services/codebase-detector.js';
-import { colors, sectionHeader, success, error, info, newline, createBanner, createSpinner, } from '../../../ui.js';
-import { executionTracer } from '../../../infrastructure/observability/execution-tracer.js';
-export async function executeDecisionCommand(action, args, options = {}) {
-    // Start execution tracing
-    const codebasePath = options.codebase || process.cwd();
-    const codebaseInfo = findCodebaseRoot(codebasePath);
-    if (!codebaseInfo) {
-        console.log(error('Can\'t find a codebase here. Are you in a project folder?'));
-        return;
-    }
-    const runId = executionTracer.startRun('decision', {
-        query: args.join(' '),
-        codebaseId: codebaseInfo.rootPath,
-    });
-    try {
-        console.log(createBanner('Decision Recording', 'Why you built it this way'));
-        newline();
-        const codebaseId = codebaseInfo.codebaseId;
-        console.log(colors.dim(`Codebase: ${codebaseInfo.rootPath} (${codebaseInfo.type})`));
-        newline();
-        const decisionRecorder = container.decisionRecorder;
-        const decisionRetriever = container.decisionRetriever;
-        switch (action) {
-            case 'record': {
-                await handleRecord(args, codebaseId, decisionRecorder);
-                break;
-            }
-            case 'list': {
-                await handleList(codebaseId, decisionRetriever, options);
-                break;
-            }
-            case 'query': {
-                await handleQuery(args.join(' '), codebaseId, decisionRetriever, options);
-                break;
-            }
-            case 'explain': {
-                await handleExplain(args[0], decisionRetriever);
-                break;
-            }
-            default: {
-                console.log(error(`Unknown action: ${action}`));
-                console.log(info('Available actions: record, list, query, explain'));
-                break;
-            }
-        }
-    }
-    catch (err) {
-        const { displayError } = await import('../error-display.js');
-        displayError(err, {
-            operation: `decision-${action}`,
-            showSuggestions: true,
-        });
-        throw err;
-    }
-    finally {
-        executionTracer.endRun();
-    }
-}
-async function handleRecord(args, codebaseId, decisionRecorder) {
-    if (args.length === 0) {
-        console.log(error('Please provide a decision to record'));
-        console.log(info('Usage: codehere decision record "We chose React because..."'));
-        return;
-    }
-    const decisionText = args.join(' ');
-    const spinner = createSpinner('Recording decision...');
-    spinner.start();
-    try {
-        // For now, create a simple decision from text
-        // In the future, we could prompt for more details
-        const decision = await decisionRecorder.recordDecision({
-            codebaseId,
-            type: 'architectural',
-            title: decisionText.substring(0, 50),
-            description: decisionText,
-            rationale: decisionText,
-        });
-        spinner.stop();
-        console.log(success('Decision saved'));
-        newline();
-        console.log(colors.bold('Decision ID:'), decision.id);
-        console.log(colors.bold('Title:'), decision.title);
-        console.log(colors.dim('Created at:'), decision.createdAt.toISOString());
-    }
-    catch (err) {
-        spinner.stop();
-        throw err;
-    }
-}
-async function handleList(codebaseId, decisionRetriever, options) {
-    const spinner = createSpinner('Loading decisions...');
-    spinner.start();
-    try {
-        let decisions;
-        if (options.type) {
-            decisions = await decisionRetriever.getByType(codebaseId, options.type, options.limit || 20);
-        }
-        else {
-            decisions = await decisionRetriever.getRecent(codebaseId, options.limit || 10);
-        }
-        spinner.stop();
-        if (decisions.length === 0) {
-            console.log(info('No decisions saved yet'));
-            return;
-        }
-        sectionHeader(`Decisions (${decisions.length})`);
-        decisions.forEach((decision, i) => {
-            console.log(colors.bold(`\n${i + 1}. ${decision.title}`));
-            console.log(colors.dim(`   Type: ${decision.type}`));
-            console.log(colors.dim(`   Rationale: ${decision.rationale.substring(0, 100)}...`));
-            console.log(colors.dim(`   Created: ${decision.createdAt.toISOString()}`));
-            if (decision.id) {
-                console.log(colors.dim(`   ID: ${decision.id.substring(0, 8)}...`));
-            }
-        });
-    }
-    catch (err) {
-        spinner.stop();
-        throw err;
-    }
-}
-async function handleQuery(query, codebaseId, decisionRetriever, options) {
-    if (!query || query.trim().length === 0) {
-        console.log(error('Please provide a search query'));
-        console.log(info('Usage: codehere decision query "authentication"'));
-        return;
-    }
-    const spinner = createSpinner('Searching decisions...');
-    spinner.start();
-    try {
-        const result = await decisionRetriever.queryByContext(codebaseId, query.trim(), options.limit || 10);
-        spinner.stop();
-        if (result.decisions.length === 0) {
-            console.log(info('Nothing matches that search'));
-            return;
-        }
-        sectionHeader(`Found ${result.decisions.length} decision(s)`);
-        if (result.explanation) {
-            console.log(colors.dim(result.explanation));
-            newline();
-        }
-        result.decisions.forEach((decision, i) => {
-            console.log(colors.bold(`\n${i + 1}. ${decision.title}`));
-            console.log(colors.cyan(`   ${decision.description}`));
-            console.log(colors.dim(`   Rationale: ${decision.rationale}`));
-        });
-    }
-    catch (err) {
-        spinner.stop();
-        throw err;
-    }
-}
-async function handleExplain(decisionId, decisionRetriever) {
-    if (!decisionId || decisionId.trim().length === 0) {
-        console.log(error('Please provide a decision ID'));
-        console.log(info('Usage: codehere decision explain <decision-id>'));
-        return;
-    }
-    const spinner = createSpinner('Retrieving decision explanation...');
-    spinner.start();
-    try {
-        const explanation = await decisionRetriever.explainDecision(decisionId.trim());
-        spinner.stop();
-        if (!explanation) {
-            console.log(error('Decision not found'));
-            return;
-        }
-        sectionHeader('Decision Explanation');
-        console.log(colors.bold('Title:'), explanation.decision.title);
-        console.log(colors.bold('Type:'), explanation.decision.type);
-        newline();
-        console.log(colors.bold('Rationale:'));
-        console.log(colors.cyan(explanation.rationale));
-        newline();
-        if (explanation.context) {
-            console.log(colors.bold('Context:'));
-            console.log(colors.dim(explanation.context));
-            newline();
-        }
-        if (explanation.alternatives && explanation.alternatives.length > 0) {
-            console.log(colors.bold('Alternatives Considered:'));
-            explanation.alternatives.forEach((alt) => {
-                console.log(colors.dim(`  - ${alt}`));
-            });
-            newline();
-        }
-        if (explanation.tradeoffs && explanation.tradeoffs.length > 0) {
-            console.log(colors.bold('Trade-offs:'));
-            explanation.tradeoffs.forEach((tradeoff) => {
-                console.log(colors.dim(`  - ${tradeoff}`));
-            });
-        }
-    }
-    catch (err) {
-        spinner.stop();
-        throw err;
-    }
-}
-//# sourceMappingURL=decision-command.js.map

package/dist/presentation/cli/commands/docs-command.js

@@ -1,25 +0,0 @@
-/**
- * CLI Command: Docs
- * Generate documentation (README, API docs) using DocumentationAgent
- *
- * Phase 1: v0.5.0-alpha.0
- */
-import { colors, warning, newline } from '../../../ui.js';
-import { displayError } from '../error-display.js';
-export async function executeDocsCommand(type, options) {
-    try {
-        // In alpha, this is a stub
-        // Can be enhanced later with DocumentationAgent
-        console.log(warning('Documentation generation is not yet fully implemented in v0.5.0-alpha.0'));
-        console.log(colors.dim(`Requested type: ${type}`));
-        if (options?.target) {
-            console.log(colors.dim(`Target: ${options.target}`));
-        }
-    }
-    catch (err) {
-        displayError(err);
-        process.exit(1);
-    }
-    newline();
-}
-//# sourceMappingURL=docs-command.js.map

package/dist/presentation/cli/commands/fix-command.js

@@ -1,53 +0,0 @@
-/**
- * CLI Command: Fix/Edit
- * Apply AI-generated code edits to a file with review support
- *
- * Phase 1: v0.5.0-alpha.0
- */
-import { container } from '../../../application/services/dependency-container.js';
-import { colors, error, success, newline, isMinimalStyle } from '../../../ui.js';
-import { displayError } from '../error-display.js';
-export async function executeFixCommand(file, instruction, options) {
-    const minimal = isMinimalStyle();
-    // Header
-    if (minimal) {
-        console.log(colors.cyan('codehere fix') + colors.dim(' ▸ ') + file);
-    }
-    else {
-        console.log(colors.bold('Fix/Edit'));
-        console.log(colors.dim(`File: ${file}`));
-    }
-    console.log(colors.dim(`Instruction: ${instruction}`));
-    newline();
-    try {
-        // Use edit-file-use-case
-        const editUseCase = container.editFileUseCase;
-        const result = await editUseCase.execute({
-            filepath: file,
-            instruction,
-        });
-        if (result.success) {
-            console.log(colors.bold('Changes:'));
-            console.log(success(`✓ Applied changes to ${file}`));
-            if (result.edit) {
-                console.log(colors.dim(result.edit));
-            }
-            newline();
-            console.log(colors.dim('Note: Changes have been applied. Use "codehere undo" to revert if needed.'));
-        }
-        else {
-            console.log(colors.bold('Result:'));
-            console.log(error(`✗ Failed to edit ${file}`));
-            if (result.error) {
-                console.log(error(result.error));
-            }
-        }
-    }
-    catch (err) {
-        console.log(colors.bold('Result:'));
-        displayError(err);
-        process.exit(1);
-    }
-    newline();
-}
-//# sourceMappingURL=fix-command.js.map

package/dist/presentation/cli/commands/knowledge-command.js

@@ -1,129 +0,0 @@
-/**
- * CLI Command: Knowledge
- * Query and manage preserved knowledge
- *
- * Clean Architecture: Presentation Layer
- */
-import { container } from '../../../application/services/dependency-container.js';
-import { findCodebaseRoot } from '../../../domain/services/codebase-detector.js';
-import { colors, sectionHeader, success, error, warning, info, newline, createBanner, } from '../../../ui.js';
-import { executionTracer } from '../../../infrastructure/observability/execution-tracer.js';
-export async function executeKnowledgeCommand(action, args, options = {}) {
-    // Start execution tracing
-    const codebasePath = options.codebase || process.cwd();
-    const codebaseInfo = findCodebaseRoot(codebasePath);
-    if (!codebaseInfo) {
-        console.log(error('No codebase detected. Please run from a git repository or project directory.'));
-        return;
-    }
-    const runId = executionTracer.startRun('knowledge', {
-        query: args.join(' '),
-        codebaseId: codebaseInfo.rootPath,
-    });
-    try {
-        console.log(createBanner('Knowledge', 'What we know about your code'));
-        newline();
-        const codebaseId = codebaseInfo.codebaseId;
-        console.log(colors.dim(`Codebase: ${codebaseInfo.rootPath} (${codebaseInfo.type})`));
-        newline();
-        const knowledgeAccess = container.knowledgeAccess;
-        const knowledgeExtractor = container.knowledgeExtractor;
-        switch (action) {
-            case 'query': {
-                const query = args.join(' ');
-                if (!query) {
-                    console.log(error('Query required. Usage: codehere knowledge query <search term>'));
-                    return;
-                }
-                console.log(colors.bold('Searching knowledge...'));
-                const knowledge = await knowledgeAccess.query(codebaseId, query, options.limit || 10);
-                if (knowledge.length === 0) {
-                    console.log(warning('Nothing matches that search.'));
-                    return;
-                }
-                console.log(success(`Found ${knowledge.length} knowledge item(s):\n`));
-                knowledge.forEach((k, i) => {
-                    console.log(colors.bold(`${i + 1}. ${k.title}`));
-                    console.log(colors.dim(`   Type: ${k.type}`));
-                    console.log(colors.dim(`   Source: ${k.source.type}${k.source.filepath ? ` (${k.source.filepath})` : ''}`));
-                    console.log(`   ${k.content.substring(0, 200)}${k.content.length > 200 ? '...' : ''}`);
-                    if (k.relevanceScore) {
-                        console.log(colors.dim(`   Relevance: ${(k.relevanceScore * 100).toFixed(0)}%`));
-                    }
-                    newline();
-                });
-                break;
-            }
-            case 'list': {
-                const type = options.type;
-                console.log(colors.bold(type ? `Listing ${type} knowledge...` : 'Listing all knowledge...'));
-                const knowledge = type
-                    ? await knowledgeAccess.getByType(codebaseId, type, options.limit || 20)
-                    : await knowledgeAccess.query(codebaseId, '', options.limit || 20);
-                if (knowledge.length === 0) {
-                    console.log(warning('Nothing saved yet.'));
-                    return;
-                }
-                console.log(success(`Found ${knowledge.length} knowledge item(s):\n`));
-                knowledge.forEach((k, i) => {
-                    console.log(colors.bold(`${i + 1}. ${k.title}`));
-                    console.log(colors.dim(`   Type: ${k.type} | Extracted: ${k.extractedAt.toLocaleDateString()}`));
-                    console.log(`   ${k.content.substring(0, 100)}${k.content.length > 100 ? '...' : ''}`);
-                    newline();
-                });
-                break;
-            }
-            case 'summary': {
-                console.log(colors.bold('Generating knowledge summary...'));
-                const summary = await knowledgeAccess.getSummary(codebaseId);
-                console.log(sectionHeader('Knowledge Summary'));
-                console.log(`Total Knowledge: ${summary.totalKnowledge}`);
-                console.log('\nBy Type:');
-                Object.entries(summary.byType).forEach(([type, count]) => {
-                    console.log(`  ${type}: ${count}`);
-                });
-                if (summary.mostAccessed.length > 0) {
-                    console.log('\nMost Accessed:');
-                    summary.mostAccessed.forEach((k, i) => {
-                        console.log(`  ${i + 1}. ${k.title}`);
-                    });
-                }
-                if (summary.recent.length > 0) {
-                    console.log('\nRecent:');
-                    summary.recent.forEach((k, i) => {
-                        console.log(`  ${i + 1}. ${k.title} (${k.extractedAt.toLocaleDateString()})`);
-                    });
-                }
-                console.log(`\n${summary.summary}`);
-                break;
-            }
-            case 'extract': {
-                const filepath = args[0];
-                if (!filepath) {
-                    console.log(error('Filepath required. Usage: codehere knowledge extract <filepath>'));
-                    return;
-                }
-                console.log(colors.bold(`Extracting knowledge from ${filepath}...`));
-                await knowledgeExtractor.extractFromFile(filepath, codebaseId, codebaseInfo.rootPath);
-                console.log(success('Knowledge extracted.'));
-                break;
-            }
-            default:
-                console.log(error(`Unknown action: ${action}`));
-                console.log(info('Available actions: query, list, summary, extract'));
-        }
-    }
-    catch (err) {
-        const { displayError } = await import('../error-display.js');
-        displayError(err, {
-            operation: `knowledge-${action}`,
-            showSuggestions: true,
-            showStack: false,
-        });
-        throw err;
-    }
-    finally {
-        executionTracer.endRun();
-    }
-}
-//# sourceMappingURL=knowledge-command.js.map