codehere 0.1.0 → 0.2.0

package/dist/infrastructure/observability/execution-tracer.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Infrastructure: Execution Tracer
+ * Tracks every LLM call, tool invocation, and operation for reproducibility
+ *
+ * Clean Architecture: Infrastructure Layer
+ * Strategic: Critical for production reliability and debugging
+ */
+export type OperationType = 'llm_call' | 'tool_invocation' | 'memory_operation' | 'plan_generation' | 'code_analysis' | 'embedding' | 'rerank' | 'file_operation' | 'git_operation' | 'other';
+export interface OperationTrace {
+    traceId: string;
+    runId: string;
+    operationType: OperationType;
+    operationName: string;
+    timestamp: number;
+    duration?: number;
+    input?: any;
+    output?: any;
+    error?: {
+        message: string;
+        stack?: string;
+        code?: string;
+    };
+    metadata?: {
+        model?: string;
+        temperature?: number;
+        tokens?: number;
+        filepath?: string;
+        codebaseId?: string;
+        [key: string]: any;
+    };
+}
+export interface RunContext {
+    runId: string;
+    startTime: number;
+    endTime?: number;
+    operation: string;
+    query?: string;
+    codebaseId?: string;
+    userAgent?: string;
+    version?: string;
+    traces: OperationTrace[];
+}
+/**
+ * Execution Tracer
+ * Tracks all operations for debugging and reproducibility
+ */
+export declare class ExecutionTracer {
+    private currentRun;
+    private tracesDir;
+    constructor();
+    /**
+     * Start a new run context
+     */
+    startRun(operation: string, context?: {
+        query?: string;
+        codebaseId?: string;
+        userAgent?: string;
+    }): string;
+    /**
+     * End the current run and save to disk
+     */
+    endRun(): void;
+    /**
+     * Trace an operation
+     */
+    trace(operation: {
+        operationType: OperationType;
+        operationName: string;
+        input?: any;
+        output?: any;
+        error?: Error;
+        metadata?: OperationTrace['metadata'];
+        duration?: number;
+    }): string;
+    /**
+     * Get run by ID (for reproducibility)
+     */
+    getRun(runId: string): RunContext | null;
+    /**
+     * List recent runs
+     */
+    listRecentRuns(limit?: number): Array<{
+        runId: string;
+        operation: string;
+        timestamp: number;
+    }>;
+    /**
+     * Reproduce a run (replay operations in sequence)
+     */
+    reproduceRun(runId: string): Promise<void>;
+    /**
+     * Get current run ID
+     */
+    getCurrentRunId(): string | null;
+    /**
+     * Sanitize input for storage (remove sensitive data, large objects)
+     */
+    private sanitizeInput;
+    /**
+     * Sanitize output for storage
+     */
+    private sanitizeOutput;
+}
+export declare const executionTracer: ExecutionTracer;
+//# sourceMappingURL=execution-tracer.d.ts.map

package/dist/infrastructure/observability/execution-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-tracer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/observability/execution-tracer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,QAAQ,GACR,gBAAgB,GAChB,eAAe,GACf,OAAO,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,SAAS,CAAS;;IAY1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM;IAeV;;OAEG;IACH,MAAM,IAAI,IAAI;IAcd;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE;QACf,aAAa,EAAE,aAAa,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,QAAQ,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;QACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,MAAM;IA8BV;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAgBxC;;OAEG;IACH,cAAc,CAAC,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAMlG;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BhD;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,cAAc;CAWvB;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

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

@@ -0,0 +1,190 @@
+/**
+ * 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 } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { getVersion } from '../../utils/version.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 agent/data/traces/
+        const agentDir = join(__dirname, '../../..');
+        this.tracesDir = join(agentDir, 'data', '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)
+     */
+    async reproduceRun(runId) {
+        const run = this.getRun(runId);
+        if (!run) {
+            throw new Error(`Run ${runId} not found`);
+        }
+        // Create new run context for reproduction
+        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}`);
+        // In a real implementation, we would replay each trace
+        // For now, just log the sequence
+        run.traces.forEach((trace, index) => {
+            console.log(`[${index + 1}] ${trace.operationType}: ${trace.operationName}`);
+            if (trace.error) {
+                console.log(`  Error: ${trace.error.message}`);
+            }
+        });
+        this.endRun();
+    }
+    /**
+     * Get current run ID
+     */
+    getCurrentRunId() {
+        return this.currentRun?.runId || null;
+    }
+    /**
+     * 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
+export const executionTracer = new ExecutionTracer();
+//# 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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"}