codehere 0.1.1

package/dist/infrastructure/observability/execution-tracer.js

@@ -0,0 +1,400 @@
+/**
+ * Infrastructure: Execution Tracer
+ * Tracks every LLM call, tool invocation, and operation for reproducibility
+ *
+ * Clean Architecture: Infrastructure Layer
+ * Strategic: Critical for production reliability and debugging
+ */
+import { randomUUID } from 'crypto';
+import { writeFileSync, mkdirSync, existsSync, readFileSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { getVersion } from '../../utils/version.js';
+// import { sanitizeForLogging } from '../security/input-validator.js'; // Function doesn't exist, removed
+import { getConfigManager } from '../config/config-manager.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Execution Tracer
+ * Tracks all operations for debugging and reproducibility
+ */
+export class ExecutionTracer {
+    currentRun = null;
+    tracesDir;
+    constructor() {
+        // Store traces in data/traces/
+        const config = getConfigManager();
+        const dataDir = config.getDataDir();
+        this.tracesDir = join(dataDir, 'traces');
+        if (!existsSync(this.tracesDir)) {
+            mkdirSync(this.tracesDir, { recursive: true });
+        }
+    }
+    /**
+     * Start a new run context
+     */
+    startRun(operation, context) {
+        const runId = randomUUID();
+        this.currentRun = {
+            runId,
+            startTime: Date.now(),
+            operation,
+            query: context?.query,
+            codebaseId: context?.codebaseId,
+            userAgent: context?.userAgent || 'codehere-cli',
+            version: getVersion(),
+            traces: [],
+        };
+        return runId;
+    }
+    /**
+     * End the current run and save to disk
+     */
+    endRun() {
+        if (!this.currentRun) {
+            return;
+        }
+        this.currentRun.endTime = Date.now();
+        // Save run to disk
+        const runFilePath = join(this.tracesDir, `${this.currentRun.runId}.json`);
+        writeFileSync(runFilePath, JSON.stringify(this.currentRun, null, 2), 'utf-8');
+        this.currentRun = null;
+    }
+    /**
+     * Trace an operation
+     */
+    trace(operation) {
+        if (!this.currentRun) {
+            // If no run context, create a temporary one
+            this.startRun('auto-trace');
+        }
+        const traceId = randomUUID();
+        const startTime = Date.now();
+        const trace = {
+            traceId,
+            runId: this.currentRun.runId,
+            operationType: operation.operationType,
+            operationName: operation.operationName,
+            timestamp: startTime,
+            duration: operation.duration,
+            input: this.sanitizeInput(operation.input),
+            output: this.sanitizeOutput(operation.output),
+            error: operation.error ? {
+                message: operation.error.message,
+                stack: operation.error.stack,
+                code: operation.error.code,
+            } : undefined,
+            metadata: operation.metadata,
+        };
+        this.currentRun.traces.push(trace);
+        return traceId;
+    }
+    /**
+     * Get run by ID (for reproducibility)
+     */
+    getRun(runId) {
+        const runFilePath = join(this.tracesDir, `${runId}.json`);
+        if (!existsSync(runFilePath)) {
+            return null;
+        }
+        try {
+            const content = readFileSync(runFilePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            console.error(`Failed to load run ${runId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * List recent runs
+     */
+    listRecentRuns(limit = 10) {
+        // In a real implementation, we'd index runs by timestamp
+        // For now, return empty array (can be enhanced with an index file)
+        return [];
+    }
+    /**
+     * Reproduce a run (replay operations in sequence)
+     * Enhanced: Actually replays operations with state restoration
+     */
+    async reproduceRun(runId, options) {
+        const run = this.getRun(runId);
+        if (!run) {
+            throw new Error(`Run ${runId} not found`);
+        }
+        // Create new run context for reproduction
+        const reproductionRunId = this.startRun(`reproduce:${run.operation}`, {
+            query: run.query,
+            codebaseId: run.codebaseId,
+        });
+        // Log reproduction start
+        console.log(`Reproducing run ${runId}...`);
+        console.log(`Operation: ${run.operation}`);
+        console.log(`Query: ${run.query || 'N/A'}`);
+        console.log(`Traces: ${run.traces.length}`);
+        console.log(`Step-by-step: ${options?.stepByStep || false}`);
+        // Replay each trace in sequence
+        for (let index = 0; index < run.traces.length; index++) {
+            const trace = run.traces[index];
+            console.log(`\n[${index + 1}/${run.traces.length}] ${trace.operationType}: ${trace.operationName}`);
+            if (trace.error) {
+                console.log(`  ⚠️  Original error: ${trace.error.message}`);
+                // Replay error trace
+                this.trace({
+                    operationType: trace.operationType,
+                    operationName: trace.operationName,
+                    input: trace.input,
+                    output: trace.output,
+                    error: new Error(trace.error.message),
+                    metadata: trace.metadata,
+                    duration: trace.duration,
+                });
+            }
+            else {
+                // Replay successful trace
+                this.trace({
+                    operationType: trace.operationType,
+                    operationName: trace.operationName,
+                    input: trace.input,
+                    output: trace.output,
+                    metadata: trace.metadata,
+                    duration: trace.duration,
+                });
+                // For tool invocations, attempt to replay if input/output available
+                if (trace.operationType === 'tool_invocation' && trace.input && trace.output) {
+                    console.log(`  ✓ Replayed: ${trace.operationName}`);
+                    if (trace.metadata?.filepath) {
+                        console.log(`    File: ${trace.metadata.filepath}`);
+                    }
+                }
+            }
+            // Step-by-step mode: wait for user confirmation
+            if (options?.stepByStep && index < run.traces.length - 1) {
+                // In a real CLI, we'd use readline to wait for user input
+                // For now, just log that step-by-step is enabled
+                console.log(`  [Press Enter to continue to next step...]`);
+            }
+        }
+        console.log(`\n✓ Reproduction complete. New run ID: ${reproductionRunId}`);
+        this.endRun();
+    }
+    /**
+     * Get current run ID
+     * Auto-creates a run if none exists to prevent null reference errors
+     */
+    getCurrentRunId() {
+        if (!this.currentRun) {
+            // Auto-create a run context if none exists
+            this.startRun('auto-run');
+        }
+        return this.currentRun.runId;
+    }
+    /**
+     * Export security audit trail for compliance
+     * P1 Security: Compliance-ready export formats
+     */
+    exportSecurityAuditTrail(options) {
+        const { format, startDate, endDate, includeInputs = false, includeOutputs = false, outputPath } = options;
+        // Collect all runs
+        const runs = [];
+        const files = readdirSync(this.tracesDir).filter(f => f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const run = this.getRun(file.replace('.json', ''));
+                if (!run)
+                    continue;
+                // Filter by date range if specified
+                if (startDate && run.startTime < startDate.getTime())
+                    continue;
+                if (endDate && run.startTime > endDate.getTime())
+                    continue;
+                runs.push(run);
+            }
+            catch {
+                // Skip invalid files
+            }
+        }
+        // Filter to security-relevant operations
+        const securityRuns = runs.filter(run => run.operation.includes('edit') ||
+            run.operation.includes('fix') ||
+            run.operation.includes('refactor') ||
+            run.traces.some(t => t.operationType === 'llm_call' ||
+                t.operationType === 'tool_invocation' ||
+                t.metadata?.injectionChecked ||
+                t.metadata?.securityScan));
+        // Generate export based on format
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const defaultPath = join(this.tracesDir, `security-audit-${timestamp}.${format}`);
+        const exportPath = outputPath || defaultPath;
+        if (format === 'json') {
+            const exportData = {
+                exportDate: new Date().toISOString(),
+                version: getVersion(),
+                totalRuns: securityRuns.length,
+                dateRange: {
+                    start: startDate?.toISOString(),
+                    end: endDate?.toISOString(),
+                },
+                runs: securityRuns.map(run => ({
+                    runId: run.runId,
+                    operation: run.operation,
+                    query: run.query,
+                    startTime: new Date(run.startTime).toISOString(),
+                    endTime: run.endTime ? new Date(run.endTime).toISOString() : undefined,
+                    duration: run.endTime ? run.endTime - run.startTime : undefined,
+                    traces: run.traces.map(trace => ({
+                        traceId: trace.traceId,
+                        operationType: trace.operationType,
+                        operationName: trace.operationName,
+                        timestamp: new Date(trace.timestamp).toISOString(),
+                        duration: trace.duration,
+                        error: trace.error,
+                        metadata: {
+                            ...trace.metadata,
+                            // Include security metadata
+                            injectionChecked: trace.metadata?.injectionChecked,
+                            securityScan: trace.metadata?.securityScan,
+                        },
+                        input: includeInputs ? trace.input : undefined,
+                        output: includeOutputs ? trace.output : undefined,
+                    })),
+                })),
+            };
+            writeFileSync(exportPath, JSON.stringify(exportData, null, 2), 'utf-8');
+        }
+        else if (format === 'jsonl') {
+            const lines = [];
+            for (const run of securityRuns) {
+                for (const trace of run.traces) {
+                    lines.push(JSON.stringify({
+                        runId: run.runId,
+                        operation: run.operation,
+                        query: run.query,
+                        traceId: trace.traceId,
+                        operationType: trace.operationType,
+                        operationName: trace.operationName,
+                        timestamp: new Date(trace.timestamp).toISOString(),
+                        duration: trace.duration,
+                        error: trace.error,
+                        metadata: trace.metadata,
+                        input: includeInputs ? trace.input : undefined,
+                        output: includeOutputs ? trace.output : undefined,
+                    }));
+                }
+            }
+            writeFileSync(exportPath, lines.join('\n'), 'utf-8');
+        }
+        else if (format === 'csv') {
+            const rows = [];
+            // CSV header
+            rows.push('runId,operation,query,traceId,operationType,operationName,timestamp,duration,error,injectionChecked,securityScan,model,temperature');
+            for (const run of securityRuns) {
+                for (const trace of run.traces) {
+                    const row = [
+                        run.runId,
+                        run.operation || '',
+                        (run.query || '').replace(/,/g, ';'), // Escape commas
+                        trace.traceId,
+                        trace.operationType,
+                        trace.operationName,
+                        new Date(trace.timestamp).toISOString(),
+                        trace.duration?.toString() || '',
+                        trace.error?.message || '',
+                        trace.metadata?.injectionChecked ? 'true' : 'false',
+                        trace.metadata?.securityScan ? 'true' : 'false',
+                        trace.metadata?.model || '',
+                        trace.metadata?.temperature?.toString() || '',
+                    ].map(field => `"${String(field).replace(/"/g, '""')}"`); // CSV escape
+                    rows.push(row.join(','));
+                }
+            }
+            writeFileSync(exportPath, rows.join('\n'), 'utf-8');
+        }
+        return exportPath;
+    }
+    /**
+     * List all runs (for audit trail export)
+     */
+    listAllRuns() {
+        const runs = [];
+        const files = readdirSync(this.tracesDir).filter(f => f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const run = this.getRun(file.replace('.json', ''));
+                if (run) {
+                    runs.push({
+                        runId: run.runId,
+                        operation: run.operation,
+                        timestamp: run.startTime,
+                        traceCount: run.traces.length,
+                    });
+                }
+            }
+            catch (err) {
+                // Skip invalid/corrupted files silently (common during development)
+                // Log only in debug mode to avoid noise
+                if (process.env.DEBUG) {
+                    console.warn(`Skipping corrupted trace file: ${file}`, err instanceof Error ? err.message : String(err));
+                }
+            }
+        }
+        return runs.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Sanitize input for storage (remove sensitive data, large objects)
+     */
+    sanitizeInput(input) {
+        if (!input)
+            return input;
+        // Limit size and remove sensitive fields
+        const sanitized = JSON.parse(JSON.stringify(input, (key, value) => {
+            // Remove API keys and secrets
+            if (typeof key === 'string' && (key.toLowerCase().includes('key') || key.toLowerCase().includes('secret') || key.toLowerCase().includes('password'))) {
+                return '[REDACTED]';
+            }
+            // Limit string length
+            if (typeof value === 'string' && value.length > 10000) {
+                return value.substring(0, 10000) + '...[truncated]';
+            }
+            // Limit array/object depth
+            return value;
+        }));
+        // Limit total size
+        const serialized = JSON.stringify(sanitized);
+        if (serialized.length > 100000) {
+            return { _truncated: true, _size: serialized.length };
+        }
+        return sanitized;
+    }
+    /**
+     * Sanitize output for storage
+     */
+    sanitizeOutput(output) {
+        if (!output)
+            return output;
+        // Limit size
+        const serialized = JSON.stringify(output);
+        if (serialized.length > 50000) {
+            return { _truncated: true, _size: serialized.length, _preview: serialized.substring(0, 1000) };
+        }
+        return output;
+    }
+}
+// Singleton instance - Lazy-loaded to prevent synchronous file system operations during module import
+// This prevents CLI startup hang (same pattern as dependency-container.ts)
+let _executionTracerInstance;
+export const executionTracer = new Proxy({}, {
+    get(_target, prop) {
+        if (!_executionTracerInstance) {
+            _executionTracerInstance = new ExecutionTracer();
+        }
+        const value = _executionTracerInstance[prop];
+        // Bind methods to the instance to preserve 'this' context
+        if (typeof value === 'function') {
+            return value.bind(_executionTracerInstance);
+        }
+        return value;
+    }
+});
+//# sourceMappingURL=execution-tracer.js.map

package/dist/infrastructure/observability/execution-tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-tracer.js","sourceRoot":"","sources":["../../../src/infrastructure/observability/execution-tracer.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/observability/prompt-versioner.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Infrastructure: Prompt Versioner
+ * Tracks prompt versions for reproducibility and A/B testing
+ *
+ * Clean Architecture: Infrastructure Layer
+ * Strategic: Enable prompt versioning and comparison
+ */
+export interface PromptVersion {
+    versionId: string;
+    promptHash: string;
+    prompt: string;
+    createdAt: number;
+    usedBy: string[];
+    metadata?: {
+        model?: string;
+        temperature?: number;
+        operation?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Prompt Versioner
+ * Tracks prompt versions for reproducibility
+ */
+export declare class PromptVersioner {
+    private versionsDir;
+    private versionIndex;
+    constructor();
+    /**
+     * Register a prompt version
+     */
+    registerVersion(prompt: string, metadata?: PromptVersion['metadata']): string;
+    /**
+     * Link a run to a prompt version
+     */
+    linkRunToVersion(prompt: string, runId: string): string;
+    /**
+     * Get prompt version by ID
+     */
+    getVersion(versionId: string): PromptVersion | null;
+    /**
+     * Get prompt version by hash
+     */
+    getVersionByHash(promptHash: string): PromptVersion | null;
+    /**
+     * Get all versions for a prompt (by hash)
+     */
+    getVersionsForPrompt(prompt: string): PromptVersion[];
+    /**
+     * List all prompt versions
+     */
+    listAllVersions(): PromptVersion[];
+    /**
+     * Hash a prompt for versioning
+     */
+    private hashPrompt;
+    /**
+     * Load all versions from disk
+     */
+    private loadVersions;
+    /**
+     * Save version index
+     */
+    private saveIndex;
+}
+export declare const promptVersioner: PromptVersioner;
+//# sourceMappingURL=prompt-versioner.d.ts.map

package/dist/infrastructure/observability/prompt-versioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-versioner.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/observability/prompt-versioner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAA6B;;IAejD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,MAAM;IAiC7E;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBvD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAgBnD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI1D;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;IAMrD;;OAEG;IACH,eAAe,IAAI,aAAa,EAAE;IAIlC;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,SAAS;CAWlB;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/infrastructure/observability/prompt-versioner.js

@@ -0,0 +1,145 @@
+/**
+ * Infrastructure: Prompt Versioner
+ * Tracks prompt versions for reproducibility and A/B testing
+ *
+ * Clean Architecture: Infrastructure Layer
+ * Strategic: Enable prompt versioning and comparison
+ */
+import { createHash } from 'crypto';
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Prompt Versioner
+ * Tracks prompt versions for reproducibility
+ */
+export class PromptVersioner {
+    versionsDir;
+    versionIndex;
+    constructor() {
+        const agentDir = join(__dirname, '../../..');
+        this.versionsDir = join(agentDir, 'data', 'prompt-versions');
+        this.versionIndex = new Map();
+        if (!existsSync(this.versionsDir)) {
+            mkdirSync(this.versionsDir, { recursive: true });
+        }
+        // Load existing versions
+        this.loadVersions();
+    }
+    /**
+     * Register a prompt version
+     */
+    registerVersion(prompt, metadata) {
+        const promptHash = this.hashPrompt(prompt);
+        // Check if version already exists
+        if (this.versionIndex.has(promptHash)) {
+            const existing = this.versionIndex.get(promptHash);
+            return existing.versionId;
+        }
+        // Create new version
+        const versionId = `v${Date.now()}-${promptHash.substring(0, 8)}`;
+        const version = {
+            versionId,
+            promptHash,
+            prompt,
+            createdAt: Date.now(),
+            usedBy: [],
+            metadata,
+        };
+        // Save to disk
+        const versionPath = join(this.versionsDir, `${versionId}.json`);
+        writeFileSync(versionPath, JSON.stringify(version, null, 2), 'utf-8');
+        // Update index
+        this.versionIndex.set(promptHash, version);
+        // Save index
+        this.saveIndex();
+        return versionId;
+    }
+    /**
+     * Link a run to a prompt version
+     */
+    linkRunToVersion(prompt, runId) {
+        const promptHash = this.hashPrompt(prompt);
+        const version = this.versionIndex.get(promptHash);
+        if (version) {
+            if (!version.usedBy.includes(runId)) {
+                version.usedBy.push(runId);
+                // Update version file
+                const versionPath = join(this.versionsDir, `${version.versionId}.json`);
+                writeFileSync(versionPath, JSON.stringify(version, null, 2), 'utf-8');
+            }
+            return version.versionId;
+        }
+        // Version doesn't exist yet, register it
+        return this.registerVersion(prompt);
+    }
+    /**
+     * Get prompt version by ID
+     */
+    getVersion(versionId) {
+        const versionPath = join(this.versionsDir, `${versionId}.json`);
+        if (!existsSync(versionPath)) {
+            return null;
+        }
+        try {
+            const content = readFileSync(versionPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            console.error(`Failed to load prompt version ${versionId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Get prompt version by hash
+     */
+    getVersionByHash(promptHash) {
+        return this.versionIndex.get(promptHash) || null;
+    }
+    /**
+     * Get all versions for a prompt (by hash)
+     */
+    getVersionsForPrompt(prompt) {
+        const promptHash = this.hashPrompt(prompt);
+        const version = this.versionIndex.get(promptHash);
+        return version ? [version] : [];
+    }
+    /**
+     * List all prompt versions
+     */
+    listAllVersions() {
+        return Array.from(this.versionIndex.values());
+    }
+    /**
+     * Hash a prompt for versioning
+     */
+    hashPrompt(prompt) {
+        return createHash('sha256').update(prompt).digest('hex');
+    }
+    /**
+     * Load all versions from disk
+     */
+    loadVersions() {
+        // In a real implementation, we'd scan the versions directory
+        // For now, we load on-demand
+        // This could be optimized with an index file
+    }
+    /**
+     * Save version index
+     */
+    saveIndex() {
+        const indexPath = join(this.versionsDir, 'index.json');
+        const indexData = Array.from(this.versionIndex.entries()).map(([hash, version]) => ({
+            hash,
+            versionId: version.versionId,
+            createdAt: version.createdAt,
+            metadata: version.metadata,
+        }));
+        writeFileSync(indexPath, JSON.stringify(indexData, null, 2), 'utf-8');
+    }
+}
+// Singleton instance
+export const promptVersioner = new PromptVersioner();
+//# sourceMappingURL=prompt-versioner.js.map

package/dist/infrastructure/observability/prompt-versioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-versioner.js","sourceRoot":"","sources":["../../../src/infrastructure/observability/prompt-versioner.ts"],"names":[],"mappings":"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"}