codehere 0.8.0 → 1.0.2

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

@@ -1,233 +0,0 @@
-/**
- * CLI command: verify
- *
- * v0.7 verifier-agent · Slice 2 (CLI surface for the pure verify-claim use case).
- *
- * Compares what the agent's Final Report TEXT claims against the structured
- * reality (artifacts + steps) captured during the session. Catches the
- * easy lies before they reach a PR description.
- *
- * Usage:
- *   codehere verify <session-id>          # run verifier on a completed session
- *   codehere verify <session-id> --json   # machine-readable output for CI
- *   codehere verify                       # list recent sessions to pick from
- *
- * Exit codes:
- *   0 = verified OR partial (warnings only · unverifiable claims)
- *   0 = no-report (nothing to verify; not a failure)
- *   1 = broken (at least one claim contradicts recorded reality)
- *   2 = session not found / invalid input
- *
- * The verifier is intentionally conservative: only claims that map to
- * structured data are checked. Prose claims pass through silently.
- */
-import { colors, symbols } from '../../../ui.js';
-import { loadSessionById, loadRecent, } from '../../../infrastructure/orchestration/session-persistence.js';
-import { verifyClaim } from '../../../application/use-cases/verify-claim.js';
-export async function executeVerifyCommand(sessionId, options = {}) {
-    // No session id: show a picker list and exit gracefully.
-    if (!sessionId) {
-        return showSessionPicker(options.json ?? false);
-    }
-    const session = loadSessionById(sessionId);
-    if (!session) {
-        if (options.json) {
-            process.stdout.write(JSON.stringify({
-                error: 'session-not-found',
-                sessionId,
-                hint: 'Run `codehere verify` (no args) to list recent sessions.',
-            }, null, 2) + '\n');
-        }
-        else {
-            process.stderr.write(colors.error(`${symbols.error} No completed session found matching "${sessionId}".\n`) +
-                colors.dim('   Tip: run `codehere verify` (no args) to see recent sessions.\n'));
-        }
-        return 2;
-    }
-    const result = verifyClaim({
-        summary: session.finalReport?.summary,
-        artifacts: session.artifacts,
-        steps: session.steps,
-    });
-    if (options.json) {
-        process.stdout.write(JSON.stringify(serializeResult(session, result), null, 2) + '\n');
-    }
-    else {
-        printHumanReadable(session, result);
-    }
-    // Exit code: only `broken` is a hard failure (CI-friendly).
-    return result.status === 'broken' ? 1 : 0;
-}
-/* ──────────────────────────────────────────────────────────────────────── */
-/* Picker mode · no session id given                                         */
-/* ──────────────────────────────────────────────────────────────────────── */
-function showSessionPicker(json) {
-    const recent = loadRecent(15);
-    if (recent.length === 0) {
-        if (json) {
-            process.stdout.write(JSON.stringify({ sessions: [], note: 'No completed sessions found.' }, null, 2) + '\n');
-        }
-        else {
-            process.stdout.write(colors.dim('No completed sessions found. Run a task first, then verify it:\n') +
-                colors.dim('   codehere task "describe what you want done"\n'));
-        }
-        return 0;
-    }
-    if (json) {
-        const items = recent.map((s) => ({
-            sessionId: s.sessionId,
-            agent: s.agent,
-            prompt: s.prompt,
-            completedAt: s.completedAt,
-            hasFinalReport: Boolean(s.finalReport),
-        }));
-        process.stdout.write(JSON.stringify({ sessions: items }, null, 2) + '\n');
-        return 0;
-    }
-    process.stdout.write('\n' + colors.bold('Recent sessions') + colors.dim('  (pass --json for machine output)\n\n'));
-    for (const s of recent) {
-        const shortId = s.sessionId.slice(0, 8);
-        const when = formatRelativeTime(s.completedAt);
-        const reportTag = s.finalReport ? colors.gray('· report ✓') : colors.gray('· no report');
-        const promptLine = truncate(s.prompt.replace(/\s+/g, ' ').trim(), 70);
-        process.stdout.write(`  ${colors.cyan(shortId)}  ${colors.gray(s.agent.padEnd(11))}${colors.dim(when.padEnd(14))} ${reportTag}\n` +
-            `             ${colors.dim(promptLine)}\n\n`);
-    }
-    process.stdout.write(colors.dim('To verify one of these:  ') + colors.bold('codehere verify <id>') + '\n\n');
-    return 0;
-}
-/* ──────────────────────────────────────────────────────────────────────── */
-/* Human-readable output                                                     */
-/* ──────────────────────────────────────────────────────────────────────── */
-function printHumanReadable(session, result) {
-    const shortId = session.sessionId.slice(0, 8);
-    const when = formatRelativeTime(session.completedAt);
-    // Header
-    process.stdout.write('\n' +
-        colors.dim('session ') +
-        colors.cyan(shortId) +
-        colors.dim(' · ') +
-        colors.gray(session.agent) +
-        colors.dim(' · ') +
-        colors.gray(when) +
-        '\n' +
-        colors.dim('task: ') +
-        truncate(session.prompt.replace(/\s+/g, ' ').trim(), 80) +
-        '\n\n');
-    // What the agent did — lead with the deliverable, not the audit. A
-    // non-technical user opening this wants "what happened" first, then "does
-    // it check out". Both come straight from recorded state (no screen lies).
-    if (session.finalReport?.summary) {
-        process.stdout.write(session.finalReport.summary.trim() + '\n\n');
-    }
-    // Files changed + trust, or the honest can't-track note.
-    const files = session.artifacts?.files ?? [];
-    if (session.artifacts?.noGitTracking) {
-        process.stdout.write(colors.dim("Files: codehere couldn't track changes here (this folder isn't a git repository).\n\n"));
-    }
-    else if (files.length > 0) {
-        process.stdout.write(colors.bold('Files changed:\n'));
-        for (const f of files) {
-            const trust = typeof f.trust === 'number' ? colors.dim(` · trust ${f.trust}/100`) : '';
-            process.stdout.write(`  • ${f.path}  ${colors.success('+' + f.added)}/${colors.error('-' + f.removed)}${trust}\n`);
-        }
-        process.stdout.write('\n');
-    }
-    // Verdict line · color-coded by status
-    const verdict = verdictLine(result);
-    process.stdout.write(colors.bold('Fact-check: ') + verdict + '\n\n');
-    // Findings detail
-    if (result.findings.length > 0 && result.status !== 'no-report') {
-        process.stdout.write(colors.bold('Findings:\n\n'));
-        for (let i = 0; i < result.findings.length; i++) {
-            const f = result.findings[i];
-            const num = colors.dim(`  ${(i + 1).toString().padStart(2)}. `);
-            const sev = severityTag(f.severity);
-            const kind = colors.gray(`[${f.kind}]`);
-            process.stdout.write(`${num}${sev} ${kind} ${f.message}\n`);
-            process.stdout.write(`      ${colors.dim('claim:')}   ${colors.gray(f.claim)}\n`);
-            process.stdout.write(`      ${colors.dim('reality:')} ${colors.gray(f.reality)}\n\n`);
-        }
-    }
-    // What was checked (so users know the verifier's scope)
-    process.stdout.write(colors.dim('What was checked:\n'));
-    process.stdout.write(colors.dim('  · numeric test claims (X tests passed, X of Y, etc) vs artifacts.tests\n'));
-    process.stdout.write(colors.dim('  · universal claims (all tests pass, no failures) vs artifacts.tests.failed\n'));
-    process.stdout.write(colors.dim('  · file claims (X files changed, no files changed) vs artifacts.files\n'));
-    process.stdout.write(colors.dim('Not checked: prose claims, intent, semantic correctness of changes.\n\n'));
-}
-function verdictLine(result) {
-    switch (result.status) {
-        case 'verified':
-            return colors.green(`${symbols.success} Verified`) + colors.dim('  ' + result.summary);
-        case 'partial':
-            return colors.warning(`${symbols.warning} Partial`) + colors.dim('  ' + result.summary);
-        case 'broken':
-            return colors.error(`${symbols.error} Broken`) + colors.dim('  ' + result.summary);
-        case 'no-report':
-            return colors.gray(`${symbols.dot} No report`) + colors.dim('  ' + result.summary);
-    }
-}
-function severityTag(sev) {
-    switch (sev) {
-        case 'fail':
-            return colors.error('fail');
-        case 'warn':
-            return colors.warning('warn');
-        case 'info':
-            return colors.info('info');
-    }
-}
-/* ──────────────────────────────────────────────────────────────────────── */
-/* JSON serialization                                                        */
-/* ──────────────────────────────────────────────────────────────────────── */
-function serializeResult(session, result) {
-    return {
-        sessionId: session.sessionId,
-        agent: session.agent,
-        prompt: session.prompt,
-        completedAt: session.completedAt,
-        durationMs: session.durationMs,
-        hasFinalReport: Boolean(session.finalReport),
-        verdict: {
-            status: result.status,
-            summary: result.summary,
-            findings: result.findings.map((f) => ({
-                severity: f.severity,
-                kind: f.kind,
-                claim: f.claim,
-                reality: f.reality,
-                message: f.message,
-            })),
-        },
-    };
-}
-/* ──────────────────────────────────────────────────────────────────────── */
-/* Small utilities                                                            */
-/* ──────────────────────────────────────────────────────────────────────── */
-function formatRelativeTime(ts) {
-    if (!ts || ts <= 0)
-        return 'unknown';
-    const deltaMs = Date.now() - ts;
-    if (deltaMs < 0)
-        return 'just now';
-    const seconds = Math.floor(deltaMs / 1000);
-    if (seconds < 60)
-        return `${seconds}s ago`;
-    const minutes = Math.floor(seconds / 60);
-    if (minutes < 60)
-        return `${minutes}m ago`;
-    const hours = Math.floor(minutes / 60);
-    if (hours < 24)
-        return `${hours}h ago`;
-    const days = Math.floor(hours / 24);
-    if (days < 30)
-        return `${days}d ago`;
-    return new Date(ts).toISOString().split('T')[0];
-}
-function truncate(s, max) {
-    if (s.length <= max)
-        return s;
-    return s.slice(0, max - 1).trimEnd() + '…';
-}
-//# sourceMappingURL=verify-command.js.map

package/dist/presentation/cli/error-display.js

@@ -1,336 +0,0 @@
-/**
- * Centralized Error Display Utility
- * Provides consistent, helpful error messages with recovery suggestions
- *
- * Clean Architecture: Presentation Layer
- */
-import { ErrorType, classifyError, EnterpriseError } from '../../error-handler.js';
-import { colors, separator, newline, symbols } from '../../ui.js';
-/**
- * Determine error severity based on error type
- */
-function getErrorSeverity(errorType) {
-    switch (errorType) {
-        case ErrorType.FATAL:
-        case ErrorType.POLICY:
-            return 'critical';
-        case ErrorType.RATE_LIMIT:
-        case ErrorType.API_ERROR:
-        case ErrorType.VALIDATION:
-            return 'warning';
-        case ErrorType.NETWORK:
-        case ErrorType.RETRYABLE:
-            return 'info';
-        default:
-            return 'warning';
-    }
-}
-/**
- * Get severity label (text-based, enterprise-grade)
- */
-function getSeverityLabel(severity) {
-    switch (severity) {
-        case 'critical':
-            return colors.red('[CRITICAL] Error:');
-        case 'warning':
-            return colors.yellow('[WARNING] Error:');
-        case 'info':
-            return colors.cyan('[INFO] Error:');
-        default:
-            return colors.red('Error:');
-    }
-}
-/**
- * Extract file path from error message
- */
-function extractFilePath(errorMessage) {
-    // Patterns: "File not found: path/to/file", "in path/to/file", "at path/to/file"
-    const patterns = [
-        /(?:File|file)\s+(?:not found|error|issue)[:\s]+([^\s]+)/i,
-        /(?:in|at)\s+([^\s]+\.(ts|js|py|json|md|yaml|yml))/i,
-        /([^\s]+\.(ts|js|py|json|md|yaml|yml)(?::\d+)?)/i,
-    ];
-    for (const pattern of patterns) {
-        const match = errorMessage.match(pattern);
-        if (match && match[1]) {
-            return match[1].replace(/^["']|["']$/g, ''); // Remove quotes
-        }
-    }
-    return undefined;
-}
-/**
- * Extract line number from error message
- */
-function extractLineNumber(errorMessage) {
-    // Patterns: "line 42", ":42", "at line 42"
-    const patterns = [/(?:line|Line)\s+(\d+)/i, /:(\d+):/, /\((\d+)\)/];
-    for (const pattern of patterns) {
-        const match = errorMessage.match(pattern);
-        if (match && match[1]) {
-            const line = parseInt(match[1], 10);
-            if (!isNaN(line) && line > 0) {
-                return line;
-            }
-        }
-    }
-    return undefined;
-}
-/**
- * Get recovery commands based on error type and context
- */
-function getRecoveryCommands(errorType, errorMessage, context) {
-    const commands = [];
-    const lowerMessage = errorMessage.toLowerCase();
-    switch (errorType) {
-        case ErrorType.VALIDATION:
-            if (lowerMessage.includes('file') || lowerMessage.includes('not found')) {
-                if (context.filepath) {
-                    commands.push(`codehere trust ${context.filepath}`);
-                }
-            }
-            break;
-        case ErrorType.API_ERROR:
-            if (lowerMessage.includes('api') || lowerMessage.includes('key')) {
-                commands.push('codehere setup');
-                commands.push('codehere config --help');
-            }
-            break;
-        case ErrorType.POLICY:
-            if (context.filepath) {
-                commands.push(`codehere trust ${context.filepath}`);
-                commands.push('codehere config policies');
-            }
-            break;
-        case ErrorType.RATE_LIMIT:
-            commands.push('codehere config --help');
-            break;
-        default:
-            break;
-    }
-    return commands;
-}
-/**
- * Get help command for operation (Task 7.3: Contextual Help Integration)
- */
-function getHelpCommandForOperation(operation) {
-    const operationLower = operation.toLowerCase();
-    // Map operations to help commands
-    if (operationLower.includes('ask') || operationLower.includes('question')) {
-        return 'ask';
-    }
-    if (operationLower.includes('explain')) {
-        return 'explain';
-    }
-    if (operationLower.includes('plan')) {
-        return 'plan';
-    }
-    if (operationLower.includes('orchestrate')) {
-        return 'orchestrate';
-    }
-    if (operationLower.includes('react')) {
-        return 'react';
-    }
-    if (operationLower.includes('index')) {
-        return 'index';
-    }
-    if (operationLower.includes('setup') || operationLower.includes('config')) {
-        return 'setup';
-    }
-    if (operationLower.includes('undo')) {
-        return 'undo';
-    }
-    if (operationLower.includes('trace')) {
-        return 'trace';
-    }
-    return null;
-}
-/**
- * Get documentation link for error type
- */
-function getDocumentationLink(errorType) {
-    const baseUrl = 'https://docs.codehere.dev';
-    switch (errorType) {
-        case ErrorType.POLICY:
-            return `${baseUrl}/security-policies`;
-        case ErrorType.API_ERROR:
-        case ErrorType.RATE_LIMIT:
-            return `${baseUrl}/setup/api-keys`;
-        case ErrorType.VALIDATION:
-            return `${baseUrl}/troubleshooting`;
-        case ErrorType.NETWORK:
-            return `${baseUrl}/troubleshooting/network`;
-        default:
-            return undefined;
-    }
-}
-/**
- * Generate error code for troubleshooting
- */
-function generateErrorCode(errorType, errorMessage) {
-    const prefix = errorType.toUpperCase().substring(0, 3);
-    const hash = errorMessage.split('').reduce((acc, char) => {
-        return (acc << 5) - acc + char.charCodeAt(0);
-    }, 0);
-    const code = Math.abs(hash).toString(16).substring(0, 4).toUpperCase();
-    return `${prefix}-${code}`;
-}
-/**
- * Display error with helpful context and recovery suggestions
- */
-export function displayError(error, options = {}) {
-    const { operation = 'operation', query, showSuggestions = true, showStack = false } = options;
-    const errorType = classifyError(error);
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    const isEnterpriseError = error instanceof EnterpriseError;
-    // Generate error code for troubleshooting
-    const errorCode = generateErrorCode(errorType, errorMessage);
-    // Determine error severity (based on error type)
-    const severity = getErrorSeverity(errorType);
-    // Extract file/line context from error message or options
-    const fileContext = options.filepath || extractFilePath(errorMessage);
-    const lineContext = options.lineNumber || extractLineNumber(errorMessage);
-    // Display error header
-    newline();
-    console.log(separator('═', 80));
-    // Show severity indicator (text-based, no emojis for enterprise)
-    const severityLabel = getSeverityLabel(severity);
-    if (severityLabel) {
-        console.log(severityLabel + ` ${errorMessage}`);
-    }
-    else {
-        console.log(colors.red(`Error: ${errorMessage}`));
-    }
-    if (errorCode) {
-        console.log(colors.dim(`Error Code: ${errorCode}`));
-    }
-    // Show file/line context if available
-    if (fileContext) {
-        console.log(colors.dim(`File: ${fileContext}${lineContext ? `:${lineContext}` : ''}`));
-    }
-    console.log(separator('═', 80));
-    newline();
-    // Show error type if it's an EnterpriseError
-    if (isEnterpriseError) {
-        console.log(colors.dim(`Type: ${errorType}`));
-        if (error.context?.attempt !== undefined) {
-            console.log(colors.dim(`Attempt: ${error.context.attempt + 1}/${error.context.maxRetries || '?'}`));
-        }
-        newline();
-    }
-    // Show suggestions based on error type
-    if (showSuggestions) {
-        const suggestions = getErrorSuggestions(errorType, errorMessage, { operation, query, filepath: fileContext });
-        if (suggestions.length > 0) {
-            console.log(colors.bold('Suggestions:'));
-            suggestions.forEach((suggestion) => {
-                console.log(colors.dim(`  ${symbols.bullet} ${suggestion}`));
-            });
-            newline();
-        }
-        // Show recovery commands for certain error types
-        const recoveryCommands = getRecoveryCommands(errorType, errorMessage, {
-            operation,
-            query,
-            filepath: fileContext,
-            lineNumber: lineContext,
-        });
-        if (recoveryCommands.length > 0) {
-            console.log(colors.bold('Recovery Commands:'));
-            recoveryCommands.forEach((cmd) => {
-                console.log(colors.cyan(`  $ ${cmd}`));
-            });
-            newline();
-        }
-        // Show documentation link for complex errors
-        const docLink = getDocumentationLink(errorType);
-        if (docLink) {
-            console.log(colors.dim(`Learn More: ${docLink}`));
-            newline();
-        }
-        // Contextual help suggestion (Task 7.3: Contextual Help Integration)
-        if (operation) {
-            const helpCommand = getHelpCommandForOperation(operation);
-            if (helpCommand) {
-                console.log(colors.dim(`Get help: ${colors.cyan(`codehere help ${helpCommand}`)}`));
-                newline();
-            }
-        }
-    }
-    // Show stack trace if requested (for debugging)
-    if (showStack && error instanceof Error && error.stack) {
-        console.log(colors.dim('Stack trace:'));
-        console.log(colors.dim(error.stack));
-        newline();
-    }
-}
-/**
- * Get recovery suggestions based on error type
- */
-function getErrorSuggestions(errorType, errorMessage, _context) {
-    const suggestions = [];
-    const lowerMessage = errorMessage.toLowerCase();
-    switch (errorType) {
-        case ErrorType.RATE_LIMIT:
-            suggestions.push("You've reached the API rate limit or monthly quota");
-            suggestions.push('Wait a moment and try again');
-            suggestions.push('Check your API key limits at: https://dashboard.cohere.com/api-keys');
-            suggestions.push('Consider upgrading your API key for higher limits');
-            break;
-        case ErrorType.API_ERROR:
-        case ErrorType.VALIDATION:
-            if (lowerMessage.includes('api') || lowerMessage.includes('key')) {
-                suggestions.push('Check your COHERE_API_KEY is set correctly');
-                suggestions.push('Verify your API key at: https://dashboard.cohere.com/api-keys');
-                suggestions.push('Make sure .env file exists in your project root');
-                suggestions.push('Run "codehere setup" to configure your API key');
-                suggestions.push('For troubleshooting, include the error code when reporting issues');
-            }
-            else if (lowerMessage.includes('not found') || lowerMessage.includes('missing')) {
-                suggestions.push("Make sure you're in the correct directory");
-                suggestions.push('Run "codehere trust ." to verify the path is scanned');
-            }
-            else {
-                suggestions.push('Check the error message above for specific details');
-                suggestions.push('Run "codehere setup" to verify your configuration');
-            }
-            break;
-        case ErrorType.NETWORK:
-            suggestions.push('Check your internet connection');
-            suggestions.push('Verify the API service is accessible');
-            suggestions.push('Try again in a few moments');
-            break;
-        case ErrorType.POLICY:
-            suggestions.push('The operation was blocked by safety policies');
-            suggestions.push('Review the policy reason above');
-            suggestions.push('Modify your request to comply with safety rules');
-            break;
-        case ErrorType.FATAL:
-            suggestions.push('This is a fatal error that cannot be recovered');
-            suggestions.push('Check the error message for details');
-            suggestions.push('If this persists, please report the issue');
-            break;
-        default:
-            // Generic suggestions for retryable errors
-            if (lowerMessage.includes('file') || lowerMessage.includes('path')) {
-                suggestions.push('Verify the file path is correct');
-                suggestions.push('Check file permissions');
-            }
-            else if (lowerMessage.includes('memory') || lowerMessage.includes('database')) {
-                suggestions.push('Run "codehere health" to inspect runtime state');
-            }
-            else {
-                suggestions.push('This error may be temporary - try again');
-                suggestions.push('Check the error message for specific details');
-            }
-    }
-    return suggestions;
-}
-/**
- * Display error and exit with appropriate code
- */
-export function displayErrorAndExit(error, options = {}) {
-    const { exitCode = 1, ...displayOptions } = options;
-    displayError(error, displayOptions);
-    process.exit(exitCode);
-}
-//# sourceMappingURL=error-display.js.map