codehere 0.1.1

package/dist/infrastructure/xai/decision-tree-log.js

@@ -0,0 +1,212 @@
+/**
+ * INTERNAL ONLY — infrastructure helper, not a user-facing feature.
+ *
+ * Decision Tree Log - Complete audit trail for multi-step agentic workflows.
+ * Used internally for logging/debugging. Not guaranteed to be stable.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+/**
+ * Decision Tree Log
+ * Maintains complete execution trace for agentic workflows
+ */
+export class DecisionTreeLog {
+    nodes = new Map();
+    rootNodeId = null;
+    /**
+     * Log goal interpretation
+     */
+    logGoalInterpretation(goalId, interpretation, parentId) {
+        if (!this.rootNodeId) {
+            this.rootNodeId = goalId;
+        }
+        const node = {
+            id: goalId,
+            type: 'goal',
+            timestamp: Date.now(),
+            description: `Goal: ${interpretation.parsedIntent}`,
+            metadata: {
+                parsedIntent: interpretation.parsedIntent,
+                constraints: interpretation.constraints,
+                dependencies: interpretation.dependencies,
+                confidence: interpretation.confidence,
+            },
+            parentId,
+        };
+        this.nodes.set(goalId, node);
+        return goalId;
+    }
+    /**
+     * Log plan step
+     */
+    logPlanStep(planId, stepDescription, metadata, parentId) {
+        const node = {
+            id: planId,
+            type: 'plan',
+            timestamp: Date.now(),
+            description: stepDescription,
+            metadata,
+            parentId,
+        };
+        this.nodes.set(planId, node);
+        this.addChild(parentId, planId);
+        return planId;
+    }
+    /**
+     * Log tool execution with rationale
+     */
+    logToolExecution(toolId, rationale, parentId) {
+        const node = {
+            id: toolId,
+            type: 'tool',
+            timestamp: Date.now(),
+            description: `Tool: ${rationale.toolName}`,
+            metadata: {
+                toolName: rationale.toolName,
+                parameters: rationale.parameters,
+                reasoning: rationale.reasoning,
+                alternativeTools: rationale.alternativeTools,
+                executionTime: rationale.executionTime,
+                rawOutput: rationale.rawOutput, // Unaltered tool result for provenance
+            },
+            parentId,
+        };
+        this.nodes.set(toolId, node);
+        this.addChild(parentId, toolId);
+        return toolId;
+    }
+    /**
+     * Log external data provenance
+     */
+    logExternalData(dataId, provenance, parentId) {
+        const node = {
+            id: dataId,
+            type: 'tool', // External data comes via tools
+            timestamp: Date.now(),
+            description: `External Data: ${provenance.source}`,
+            metadata: {
+                source: provenance.source,
+                timestamp: provenance.timestamp,
+                freshness: provenance.freshness,
+                trustLevel: provenance.trustLevel,
+                url: provenance.url,
+                dataAge: Date.now() - provenance.timestamp, // Age in milliseconds
+            },
+            parentId,
+        };
+        this.nodes.set(dataId, node);
+        this.addChild(parentId, dataId);
+        return dataId;
+    }
+    /**
+     * Log integration step (how LLM processed external data)
+     */
+    logIntegrationStep(integrationId, step, parentId) {
+        const node = {
+            id: integrationId,
+            type: 'synthesis',
+            timestamp: Date.now(),
+            description: step.processingDescription,
+            metadata: {
+                inputData: step.inputData,
+                outputData: step.outputData,
+                transformations: step.transformations,
+            },
+            parentId,
+        };
+        this.nodes.set(integrationId, node);
+        this.addChild(parentId, integrationId);
+        return integrationId;
+    }
+    /**
+     * Log error
+     */
+    logError(errorId, error, context, parentId) {
+        const node = {
+            id: errorId,
+            type: 'error',
+            timestamp: Date.now(),
+            description: `Error: ${error.message}`,
+            metadata: {
+                error: error.message,
+                stack: error.stack,
+                context,
+            },
+            parentId,
+        };
+        this.nodes.set(errorId, node);
+        this.addChild(parentId, errorId);
+        return errorId;
+    }
+    /**
+     * Get complete execution tree
+     */
+    getExecutionTree() {
+        if (!this.rootNodeId) {
+            return null;
+        }
+        return this.buildTree(this.rootNodeId);
+    }
+    /**
+     * Build tree structure recursively
+     */
+    buildTree(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node) {
+            return null;
+        }
+        const children = [];
+        if (node.childNodeIds && node.childNodeIds.length > 0) {
+            for (const childId of node.childNodeIds) {
+                const childNode = this.buildTree(childId);
+                if (childNode) {
+                    children.push(childNode);
+                }
+            }
+        }
+        return {
+            ...node,
+            children: children.length > 0 ? children : undefined,
+        };
+    }
+    /**
+     * Add child node to parent
+     */
+    addChild(parentId, childId) {
+        const parent = this.nodes.get(parentId);
+        if (parent) {
+            if (!parent.childNodeIds) {
+                parent.childNodeIds = [];
+            }
+            if (!parent.childNodeIds.includes(childId)) {
+                parent.childNodeIds.push(childId);
+            }
+        }
+    }
+    /**
+     * Get trace for fault attribution
+     */
+    getErrorTrace(errorId) {
+        const trace = [];
+        let currentId = errorId;
+        while (currentId) {
+            const node = this.nodes.get(currentId);
+            if (!node) {
+                break;
+            }
+            trace.unshift(node);
+            currentId = node.parentId;
+        }
+        return trace;
+    }
+    /**
+     * Clear log
+     */
+    clear() {
+        this.nodes.clear();
+        this.rootNodeId = null;
+    }
+}
+//# sourceMappingURL=decision-tree-log.js.map

package/dist/infrastructure/xai/decision-tree-log.js.map

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

package/dist/infrastructure/xai/interactive-xai.d.ts

@@ -0,0 +1,104 @@
+/**
+ * INTERNAL ONLY — experimental feature, not a user-facing feature.
+ *
+ * Interactive XAI System - Allows users to click on code for explanations.
+ * Experimental infrastructure. Not guaranteed to be stable. May be moved to experimental directory.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+export interface CodeExplanation {
+    codeSpan: {
+        filepath: string;
+        startLine: number;
+        endLine: number;
+        content: string;
+    };
+    explanation: {
+        why: string;
+        how: string;
+        confidence: number;
+        uncertainty?: {
+            epistemic: number;
+            aleatoric?: number;
+            isHallucinationRisk: boolean;
+        };
+    };
+    reasoning: {
+        cotStepId?: string;
+        cotStepNumber?: number;
+        attentionSpans?: Array<{
+            filepath: string;
+            lines: number[];
+            relevanceScore: number;
+        }>;
+        decisionPoint?: string;
+    };
+    metadata: {
+        toolUsed?: string;
+        timestamp: number;
+        model?: string;
+    };
+}
+export interface InteractiveXAIState {
+    sessionId: string;
+    query: string;
+    explanations: Map<string, CodeExplanation>;
+    cotTrajectoryId?: string;
+    attentionMapId?: string;
+    createdAt: number;
+}
+/**
+ * Interactive XAI System
+ * Enables users to explore AI reasoning interactively
+ */
+export declare class InteractiveXAI {
+    private sessions;
+    /**
+     * Create new interactive XAI session
+     */
+    createSession(sessionId: string, query: string, options?: {
+        cotTrajectoryId?: string;
+        attentionMapId?: string;
+    }): InteractiveXAIState;
+    /**
+     * Get explanation for code span
+     */
+    getExplanation(sessionId: string, filepath: string, startLine: number, endLine: number): CodeExplanation | null;
+    /**
+     * Register code explanation
+     */
+    registerExplanation(sessionId: string, explanation: CodeExplanation): void;
+    /**
+     * Generate explanation for code span (on-demand)
+     */
+    generateExplanation(sessionId: string, filepath: string, startLine: number, endLine: number, code: string, context: {
+        query: string;
+        cotTrajectory?: any;
+        attentionMap?: any;
+        uncertainty?: any;
+    }): Promise<CodeExplanation>;
+    /**
+     * Get all explanations for a file
+     */
+    getFileExplanations(sessionId: string, filepath: string): CodeExplanation[];
+    /**
+     * Format explanation for display
+     */
+    formatExplanation(explanation: CodeExplanation, format: 'console' | 'json' | 'markdown'): string;
+    /**
+     * Get session state
+     */
+    getSession(sessionId: string): InteractiveXAIState | null;
+    private getExplanationKey;
+    private generateWhyExplanation;
+    private generateHowExplanation;
+    private calculateConfidence;
+    private findRelatedCoTStep;
+    private findRelatedAttentionSpans;
+    private findDecisionPoint;
+    private formatForConsole;
+    private formatForMarkdown;
+}
+//# sourceMappingURL=interactive-xai.d.ts.map

package/dist/infrastructure/xai/interactive-xai.d.ts.map

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

package/dist/infrastructure/xai/interactive-xai.js

@@ -0,0 +1,260 @@
+/**
+ * INTERNAL ONLY — experimental feature, not a user-facing feature.
+ *
+ * Interactive XAI System - Allows users to click on code for explanations.
+ * Experimental infrastructure. Not guaranteed to be stable. May be moved to experimental directory.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+/**
+ * Interactive XAI System
+ * Enables users to explore AI reasoning interactively
+ */
+export class InteractiveXAI {
+    sessions = new Map();
+    /**
+     * Create new interactive XAI session
+     */
+    createSession(sessionId, query, options) {
+        const state = {
+            sessionId,
+            query,
+            explanations: new Map(),
+            cotTrajectoryId: options?.cotTrajectoryId,
+            attentionMapId: options?.attentionMapId,
+            createdAt: Date.now(),
+        };
+        this.sessions.set(sessionId, state);
+        return state;
+    }
+    /**
+     * Get explanation for code span
+     */
+    getExplanation(sessionId, filepath, startLine, endLine) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return null;
+        }
+        const key = this.getExplanationKey(filepath, startLine, endLine);
+        return session.explanations.get(key) || null;
+    }
+    /**
+     * Register code explanation
+     */
+    registerExplanation(sessionId, explanation) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const key = this.getExplanationKey(explanation.codeSpan.filepath, explanation.codeSpan.startLine, explanation.codeSpan.endLine);
+        session.explanations.set(key, explanation);
+    }
+    /**
+     * Generate explanation for code span (on-demand)
+     */
+    async generateExplanation(sessionId, filepath, startLine, endLine, code, context) {
+        // Check if explanation already exists
+        const existing = this.getExplanation(sessionId, filepath, startLine, endLine);
+        if (existing) {
+            return existing;
+        }
+        // Generate explanation
+        const explanation = {
+            codeSpan: {
+                filepath,
+                startLine,
+                endLine,
+                content: code,
+            },
+            explanation: {
+                why: this.generateWhyExplanation(code, context.query),
+                how: this.generateHowExplanation(code, context.query),
+                confidence: this.calculateConfidence(context),
+                uncertainty: context.uncertainty ? {
+                    epistemic: context.uncertainty.epistemic?.value || 0,
+                    aleatoric: context.uncertainty.aleatoric?.value,
+                    isHallucinationRisk: context.uncertainty.isHallucinationRisk || false,
+                } : undefined,
+            },
+            reasoning: {
+                cotStepId: this.findRelatedCoTStep(context.cotTrajectory, code),
+                attentionSpans: this.findRelatedAttentionSpans(context.attentionMap, filepath, startLine, endLine),
+                decisionPoint: this.findDecisionPoint(context.cotTrajectory, code),
+            },
+            metadata: {
+                timestamp: Date.now(),
+            },
+        };
+        // Register explanation
+        this.registerExplanation(sessionId, explanation);
+        return explanation;
+    }
+    /**
+     * Get all explanations for a file
+     */
+    getFileExplanations(sessionId, filepath) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return [];
+        }
+        const explanations = [];
+        for (const explanation of session.explanations.values()) {
+            if (explanation.codeSpan.filepath === filepath) {
+                explanations.push(explanation);
+            }
+        }
+        return explanations.sort((a, b) => a.codeSpan.startLine - b.codeSpan.startLine);
+    }
+    /**
+     * Format explanation for display
+     */
+    formatExplanation(explanation, format) {
+        switch (format) {
+            case 'console':
+                return this.formatForConsole(explanation);
+            case 'json':
+                return JSON.stringify(explanation, null, 2);
+            case 'markdown':
+                return this.formatForMarkdown(explanation);
+        }
+    }
+    /**
+     * Get session state
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId) || null;
+    }
+    // Private helpers
+    getExplanationKey(filepath, startLine, endLine) {
+        return `${filepath}:${startLine}:${endLine}`;
+    }
+    generateWhyExplanation(code, query) {
+        // Simple heuristic-based explanation
+        // In production, this would use LLM to generate explanation
+        return `This code was generated to address: "${query.substring(0, 100)}". The implementation follows the requested functionality.`;
+    }
+    generateHowExplanation(code, query) {
+        // Simple heuristic-based explanation
+        // In production, this would use LLM to generate explanation
+        return `This code relates to the query by implementing the core logic requested.`;
+    }
+    calculateConfidence(context) {
+        // Calculate confidence based on uncertainty and context quality
+        let confidence = 0.8; // Default
+        if (context.uncertainty) {
+            const epistemic = context.uncertainty.epistemic?.value || 0;
+            confidence = 1 - epistemic; // Lower epistemic uncertainty = higher confidence
+        }
+        // Adjust based on attention map quality
+        if (context.attentionMap) {
+            const avgAttention = context.attentionMap.averageAttentionScore || 0;
+            confidence = (confidence + avgAttention) / 2;
+        }
+        return Math.max(0, Math.min(1, confidence));
+    }
+    findRelatedCoTStep(cotTrajectory, code) {
+        // Find CoT step that likely generated this code
+        // In production, this would analyze trajectory and code content
+        if (!cotTrajectory || !cotTrajectory.steps) {
+            return undefined;
+        }
+        // Find action steps that match code generation
+        for (const step of cotTrajectory.steps) {
+            if (step.type === 'action' && step.metadata?.tool === 'edit' || step.metadata?.tool === 'create') {
+                return step.stepId;
+            }
+        }
+        return undefined;
+    }
+    findRelatedAttentionSpans(attentionMap, filepath, startLine, endLine) {
+        if (!attentionMap || !attentionMap.spans) {
+            return undefined;
+        }
+        // Find attention spans related to this file/region
+        const related = [];
+        for (const span of attentionMap.spans) {
+            if (span.filepath === filepath) {
+                // Check if spans overlap
+                if (span.startLine <= endLine && span.endLine >= startLine) {
+                    related.push({
+                        filepath: span.filepath,
+                        lines: Array.from({ length: span.endLine - span.startLine + 1 }, (_, i) => span.startLine + i),
+                        relevanceScore: span.attentionScore,
+                    });
+                }
+            }
+        }
+        return related.length > 0 ? related : undefined;
+    }
+    findDecisionPoint(cotTrajectory, code) {
+        // Find decision point that led to this code
+        if (!cotTrajectory || !cotTrajectory.steps) {
+            return undefined;
+        }
+        for (const step of cotTrajectory.steps) {
+            if (step.type === 'decision') {
+                return step.metadata?.decision || step.content;
+            }
+        }
+        return undefined;
+    }
+    formatForConsole(explanation) {
+        let output = '';
+        output += `\n${'═'.repeat(80)}\n`;
+        output += `Code Explanation: ${explanation.codeSpan.filepath} (lines ${explanation.codeSpan.startLine}-${explanation.codeSpan.endLine})\n`;
+        output += `${'═'.repeat(80)}\n\n`;
+        output += `Why:\n  ${explanation.explanation.why}\n\n`;
+        output += `How:\n  ${explanation.explanation.how}\n\n`;
+        output += `Confidence: ${(explanation.explanation.confidence * 100).toFixed(1)}%\n`;
+        if (explanation.explanation.uncertainty) {
+            output += `\nUncertainty:\n`;
+            output += `  Epistemic: ${(explanation.explanation.uncertainty.epistemic * 100).toFixed(1)}%\n`;
+            if (explanation.explanation.uncertainty.isHallucinationRisk) {
+                output += `  ⚠️  Hallucination Risk Detected\n`;
+            }
+        }
+        if (explanation.reasoning.cotStepNumber) {
+            output += `\nRelated Reasoning Step: #${explanation.reasoning.cotStepNumber}\n`;
+        }
+        if (explanation.reasoning.attentionSpans && explanation.reasoning.attentionSpans.length > 0) {
+            output += `\nContext Influences:\n`;
+            for (const span of explanation.reasoning.attentionSpans.slice(0, 3)) {
+                output += `  - ${span.filepath} (lines ${span.lines[0]}-${span.lines[span.lines.length - 1]}) - Relevance: ${(span.relevanceScore * 100).toFixed(1)}%\n`;
+            }
+        }
+        output += `\n${'═'.repeat(80)}\n`;
+        return output;
+    }
+    formatForMarkdown(explanation) {
+        let output = '';
+        output += `## Code Explanation\n\n`;
+        output += `**File:** \`${explanation.codeSpan.filepath}\` (lines ${explanation.codeSpan.startLine}-${explanation.codeSpan.endLine})\n\n`;
+        output += `### Why\n\n${explanation.explanation.why}\n\n`;
+        output += `### How\n\n${explanation.explanation.how}\n\n`;
+        output += `**Confidence:** ${(explanation.explanation.confidence * 100).toFixed(1)}%\n\n`;
+        if (explanation.explanation.uncertainty) {
+            output += `### Uncertainty\n\n`;
+            output += `- Epistemic: ${(explanation.explanation.uncertainty.epistemic * 100).toFixed(1)}%\n`;
+            if (explanation.explanation.uncertainty.isHallucinationRisk) {
+                output += `- ⚠️  **Hallucination Risk Detected**\n`;
+            }
+            output += `\n`;
+        }
+        if (explanation.reasoning.cotStepNumber) {
+            output += `### Related Reasoning\n\n`;
+            output += `Part of reasoning step #${explanation.reasoning.cotStepNumber}\n\n`;
+        }
+        if (explanation.reasoning.attentionSpans && explanation.reasoning.attentionSpans.length > 0) {
+            output += `### Context Influences\n\n`;
+            for (const span of explanation.reasoning.attentionSpans.slice(0, 3)) {
+                output += `- \`${span.filepath}\` (lines ${span.lines[0]}-${span.lines[span.lines.length - 1]}) - Relevance: ${(span.relevanceScore * 100).toFixed(1)}%\n`;
+            }
+            output += `\n`;
+        }
+        output += `\`\`\`\n${explanation.codeSpan.content}\n\`\`\`\n`;
+        return output;
+    }
+}
+//# sourceMappingURL=interactive-xai.js.map

package/dist/infrastructure/xai/interactive-xai.js.map

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

package/dist/infrastructure/xai/uncertainty-quantifier.d.ts

@@ -0,0 +1,77 @@
+/**
+ * INTERNAL ONLY — infrastructure helper, not a user-facing feature.
+ *
+ * Uncertainty Quantifier - Distinguishes Epistemic vs Aleatoric uncertainty.
+ * Used internally for logging/debugging. Not guaranteed to be stable.
+ *
+ * Do not rely on this directly.
+ *
+ * @internal
+ */
+export type UncertaintyType = 'epistemic' | 'aleatoric' | 'combined';
+export interface UncertaintyScore {
+    type: UncertaintyType;
+    value: number;
+    explanation: string;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    recommendation?: string;
+}
+export interface UncertaintyResult {
+    epistemic: UncertaintyScore;
+    aleatoric?: UncertaintyScore;
+    combined: UncertaintyScore;
+    isHallucinationRisk: boolean;
+}
+/**
+ * Uncertainty Quantifier
+ * Quantifies and communicates model uncertainty
+ */
+export declare class UncertaintyQuantifier {
+    private epistemicThreshold;
+    /**
+     * Quantify uncertainty from LLM response
+     * Uses multiple sampling approach (dropout method)
+     */
+    quantifyUncertainty(query: string, response: string, context?: {
+        chunks?: any[];
+        memories?: any[];
+    }): Promise<UncertaintyResult>;
+    /**
+     * Estimate epistemic uncertainty (model knowledge gap)
+     * High epistemic = query outside training distribution
+     */
+    private estimateEpistemicUncertainty;
+    /**
+     * Estimate aleatoric uncertainty (inherent randomness)
+     */
+    private estimateAleatoricUncertainty;
+    /**
+     * Combine uncertainties
+     */
+    private combineUncertainties;
+    /**
+     * Check for unknown patterns (outside training distribution)
+     */
+    private hasUnknownPatterns;
+    /**
+     * Calculate context availability score
+     */
+    private calculateContextScore;
+    /**
+     * Check for hedging language (indicates uncertainty)
+     */
+    private hasHedgingLanguage;
+    /**
+     * Check for niche/proprietary APIs
+     */
+    private hasNicheAPIs;
+    /**
+     * Get risk level from uncertainty value
+     */
+    private getRiskLevel;
+    /**
+     * Set epistemic threshold
+     */
+    setEpistemicThreshold(threshold: number): void;
+}
+//# sourceMappingURL=uncertainty-quantifier.d.ts.map