codehere 0.1.0 → 0.2.0

package/dist/infrastructure/ux/team-standards.js

@@ -0,0 +1,196 @@
+/**
+ * Infrastructure: Team Standards Integration
+ *
+ * Aligns AI-generated code with team style guides and automated linting
+ * Research: Team standards integration, style guide enforcement, automated linting integration
+ *
+ * Features:
+ * - Team style guide enforcement
+ * - Automated linting integration
+ * - Code formatting standards
+ * - Team-specific patterns
+ */
+/**
+ * Team Standards Integration System
+ * Enforces team style guides and integrates with linting
+ */
+export class TeamStandards {
+    styleGuides = new Map();
+    defaultStyleGuide;
+    constructor() {
+        this.defaultStyleGuide = this.createDefaultStyleGuide();
+        this.styleGuides.set('default', this.defaultStyleGuide);
+    }
+    /**
+     * Load team style guide
+     */
+    loadStyleGuide(teamId, guide) {
+        this.styleGuides.set(teamId, guide);
+    }
+    /**
+     * Get style guide for team
+     */
+    getStyleGuide(teamId) {
+        return this.styleGuides.get(teamId) || this.defaultStyleGuide;
+    }
+    /**
+     * Validate code against style guide
+     */
+    validateCode(teamId, filepath, code) {
+        const styleGuide = this.getStyleGuide(teamId);
+        const issues = [];
+        const violations = [];
+        // Validate against each rule
+        for (const rule of styleGuide.rules) {
+            if (!rule.enabled)
+                continue;
+            const ruleIssues = this.checkRule(code, rule, filepath);
+            issues.push(...ruleIssues);
+            for (const issue of ruleIssues) {
+                violations.push({
+                    rule,
+                    line: issue.line,
+                    message: issue.message,
+                });
+            }
+        }
+        // Check for errors
+        const hasErrors = issues.some(i => i.severity === 'error');
+        const passed = !hasErrors;
+        return {
+            passed,
+            issues,
+            violations,
+        };
+    }
+    /**
+     * Apply style guide to code (auto-fix where possible)
+     */
+    applyStyleGuide(teamId, code, filepath) {
+        const styleGuide = this.getStyleGuide(teamId);
+        let modifiedCode = code;
+        let fixesApplied = 0;
+        const remainingIssues = [];
+        // Apply fixable rules
+        for (const rule of styleGuide.rules) {
+            if (!rule.enabled || !rule.fixable)
+                continue;
+            const { fixed, code: newCode } = this.applyRule(modifiedCode, rule, filepath);
+            if (fixed) {
+                modifiedCode = newCode;
+                fixesApplied++;
+            }
+        }
+        // Check remaining issues
+        const validation = this.validateCode(teamId, filepath, modifiedCode);
+        remainingIssues.push(...validation.issues.filter(i => !i.fixable || i.severity === 'error'));
+        return {
+            modified: modifiedCode,
+            fixesApplied,
+            remainingIssues,
+        };
+    }
+    /**
+     * Integrate with external linter (ESLint, Prettier, etc.)
+     */
+    async runLinter(filepath, code, linterConfig) {
+        // In production, this would:
+        // - Call external linter (ESLint, Prettier, etc.)
+        // - Parse linting results
+        // - Return structured results
+        // For now, return basic validation
+        const issues = [];
+        // Basic checks (in production, delegate to actual linter)
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Example: Check for trailing whitespace
+            if (line.trimEnd() !== line && line.trim().length > 0) {
+                issues.push({
+                    line: i + 1,
+                    message: 'Trailing whitespace',
+                    rule: 'no-trailing-whitespace',
+                    severity: 'warning',
+                    fixable: true,
+                    suggestedFix: line.trimEnd(),
+                });
+            }
+        }
+        const errors = issues.filter(i => i.severity === 'error');
+        const warnings = issues.filter(i => i.severity === 'warning');
+        const info = issues.filter(i => i.severity === 'info');
+        return {
+            filepath,
+            errors,
+            warnings,
+            info,
+            passed: errors.length === 0,
+        };
+    }
+    // Private helpers
+    checkRule(code, rule, filepath) {
+        const issues = [];
+        const lines = code.split('\n');
+        // Simple pattern matching (in production, use AST analysis)
+        if (rule.pattern) {
+            const regex = new RegExp(rule.pattern, 'g');
+            for (let i = 0; i < lines.length; i++) {
+                const matches = lines[i].match(regex);
+                if (matches) {
+                    issues.push({
+                        line: i + 1,
+                        message: rule.description,
+                        rule: rule.ruleId,
+                        severity: rule.severity,
+                        fixable: rule.fixable,
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+    applyRule(code, rule, filepath) {
+        // Simple auto-fix (in production, use proper AST transformation)
+        let modified = code;
+        let fixed = false;
+        // Example: Fix trailing whitespace
+        if (rule.ruleId === 'no-trailing-whitespace') {
+            const lines = modified.split('\n');
+            const fixedLines = lines.map(line => line.trimEnd());
+            modified = fixedLines.join('\n');
+            fixed = modified !== code;
+        }
+        return { fixed, code: modified };
+    }
+    createDefaultStyleGuide() {
+        return {
+            teamId: 'default',
+            enabled: true,
+            version: '1.0.0',
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            rules: [
+                {
+                    ruleId: 'no-trailing-whitespace',
+                    category: 'formatting',
+                    rule: 'Remove trailing whitespace',
+                    description: 'Lines should not end with whitespace',
+                    severity: 'warning',
+                    pattern: '\\s+$',
+                    fixable: true,
+                    enabled: true,
+                },
+                {
+                    ruleId: 'consistent-indentation',
+                    category: 'formatting',
+                    rule: 'Use consistent indentation (2 spaces)',
+                    description: 'Use 2 spaces for indentation',
+                    severity: 'error',
+                    fixable: true,
+                    enabled: true,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=team-standards.js.map

package/dist/infrastructure/ux/team-standards.js.map

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

package/dist/infrastructure/verification/verification-service.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Infrastructure: VerificationService
+ * Implements IVerificationService using existing verification system
+ */
+import type { IVerificationService } from '../../domain/interfaces/verification-service.interface.js';
+import type { VerificationResult } from '../../domain/entities/edit.js';
+export declare class VerificationService implements IVerificationService {
+    verifyCompilation(filepath: string): Promise<VerificationResult>;
+    runTests(filepath: string): Promise<VerificationResult>;
+    verify(filepath: string): Promise<VerificationResult>;
+}
+//# sourceMappingURL=verification-service.d.ts.map

package/dist/infrastructure/verification/verification-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-service.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/verification/verification-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAEtG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,qBAAa,mBAAoB,YAAW,oBAAoB;IACxD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAehE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAevD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAc5D"}

package/dist/infrastructure/verification/verification-service.js

@@ -0,0 +1,47 @@
+/**
+ * Infrastructure: VerificationService
+ * Implements IVerificationService using existing verification system
+ */
+import { verifyFile } from '../../verification/index.js';
+export class VerificationService {
+    async verifyCompilation(filepath) {
+        const result = await verifyFile(filepath, {
+            verifyCompilation: true,
+            runTests: false,
+        });
+        return {
+            success: result.success,
+            compiled: result.compiled,
+            testsPassed: false,
+            errors: result.errors,
+            warnings: result.warnings,
+        };
+    }
+    async runTests(filepath) {
+        const result = await verifyFile(filepath, {
+            verifyCompilation: false,
+            runTests: true,
+        });
+        return {
+            success: result.success,
+            compiled: true,
+            testsPassed: result.testsPassed,
+            errors: result.errors,
+            warnings: result.warnings,
+        };
+    }
+    async verify(filepath) {
+        const result = await verifyFile(filepath, {
+            verifyCompilation: true,
+            runTests: true,
+        });
+        return {
+            success: result.success,
+            compiled: result.compiled,
+            testsPassed: result.testsPassed,
+            errors: result.errors,
+            warnings: result.warnings,
+        };
+    }
+}
+//# sourceMappingURL=verification-service.js.map

package/dist/infrastructure/verification/verification-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-service.js","sourceRoot":"","sources":["../../../src/infrastructure/verification/verification-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAmD,MAAM,6BAA6B,CAAC;AAG1G,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE;YACxC,iBAAiB,EAAE,IAAI;YACvB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE;YACxC,iBAAiB,EAAE,KAAK;YACxB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE;YACxC,iBAAiB,EAAE,IAAI;YACvB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;CACF"}

package/dist/infrastructure/xai/attention-visualizer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Infrastructure: Attention Visualizer
+ *
+ * Visualizes which parts of code/context the AI is focusing on (attention weights)
+ * Research: Attention visualization proves context grounding
+ *
+ * Features:
+ * - Code span highlighting (which lines/chunks are most relevant)
+ * - Context relevance scoring
+ * - Attention heatmap generation
+ * - Grounding verification
+ */
+export interface AttentionSpan {
+    filepath: string;
+    startLine: number;
+    endLine: number;
+    content: string;
+    attentionScore: number;
+    relevanceReason?: string;
+}
+export interface AttentionMap {
+    query: string;
+    spans: AttentionSpan[];
+    totalContextLines: number;
+    averageAttentionScore: number;
+    topAttentionSpans: AttentionSpan[];
+    createdAt: number;
+}
+/**
+ * Attention Visualizer
+ * Identifies and visualizes code regions the AI is focusing on
+ */
+export declare class AttentionVisualizer {
+    /**
+     * Generate attention map from code chunks and relevance scores
+     */
+    generateAttentionMap(query: string, chunks: Array<{
+        filepath: string;
+        content: string;
+        score?: number;
+        startLine?: number;
+        endLine?: number;
+    }>): AttentionMap;
+    /**
+     * Format attention map for console output
+     */
+    formatForConsole(attentionMap: AttentionMap, options?: {
+        maxSpans?: number;
+        showContent?: boolean;
+    }): string;
+    /**
+     * Generate attention heatmap data (for UI visualization)
+     */
+    generateHeatmapData(attentionMap: AttentionMap): {
+        filepath: string;
+        lines: Array<{
+            lineNumber: number;
+            attentionScore: number;
+            content: string;
+        }>;
+    }[];
+    /**
+     * Verify context grounding (check if attention spans actually relate to query)
+     */
+    verifyGrounding(attentionMap: AttentionMap, query: string): {
+        grounded: boolean;
+        confidence: number;
+        issues?: string[];
+    };
+    private generateRelevanceReason;
+    private generateAttentionBar;
+}
+//# sourceMappingURL=attention-visualizer.d.ts.map

package/dist/infrastructure/xai/attention-visualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-visualizer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/xai/attention-visualizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,oBAAoB,CAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,GACD,YAAY;IAoCf;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,MAAM;IAuCV;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG;QAC/C,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC;YACX,UAAU,EAAE,MAAM,CAAC;YACnB,cAAc,EAAE,MAAM,CAAC;YACvB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC,CAAC;KACJ,EAAE;IA6DH;;OAEG;IACH,eAAe,CACb,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,MAAM,GACZ;QACD,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB;IA0BD,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,oBAAoB;CAK7B"}

package/dist/infrastructure/xai/attention-visualizer.js

@@ -0,0 +1,174 @@
+/**
+ * Infrastructure: Attention Visualizer
+ *
+ * Visualizes which parts of code/context the AI is focusing on (attention weights)
+ * Research: Attention visualization proves context grounding
+ *
+ * Features:
+ * - Code span highlighting (which lines/chunks are most relevant)
+ * - Context relevance scoring
+ * - Attention heatmap generation
+ * - Grounding verification
+ */
+/**
+ * Attention Visualizer
+ * Identifies and visualizes code regions the AI is focusing on
+ */
+export class AttentionVisualizer {
+    /**
+     * Generate attention map from code chunks and relevance scores
+     */
+    generateAttentionMap(query, chunks) {
+        const spans = chunks.map((chunk, index) => {
+            // Normalize score to 0-1 range (if not already)
+            const rawScore = chunk.score || 0;
+            const maxScore = Math.max(...chunks.map(c => c.score || 0), 1);
+            const attentionScore = maxScore > 0 ? rawScore / maxScore : 0;
+            // Extract line numbers if available
+            const startLine = chunk.startLine || 1;
+            const endLine = chunk.endLine || startLine + chunk.content.split('\n').length;
+            return {
+                filepath: chunk.filepath,
+                startLine,
+                endLine,
+                content: chunk.content,
+                attentionScore,
+                relevanceReason: this.generateRelevanceReason(chunk, attentionScore),
+            };
+        });
+        // Sort by attention score (descending)
+        spans.sort((a, b) => b.attentionScore - a.attentionScore);
+        const averageAttentionScore = spans.reduce((sum, span) => sum + span.attentionScore, 0) / spans.length;
+        return {
+            query,
+            spans,
+            totalContextLines: spans.reduce((sum, span) => sum + (span.endLine - span.startLine + 1), 0),
+            averageAttentionScore,
+            topAttentionSpans: spans.slice(0, 5), // Top 5 most attended spans
+            createdAt: Date.now(),
+        };
+    }
+    /**
+     * Format attention map for console output
+     */
+    formatForConsole(attentionMap, options) {
+        const { maxSpans = 10, showContent = false } = options || {};
+        const spansToShow = attentionMap.topAttentionSpans.slice(0, maxSpans);
+        let output = '';
+        output += `\n${'═'.repeat(80)}\n`;
+        output += `Attention Map: ${attentionMap.query.substring(0, 60)}${attentionMap.query.length > 60 ? '...' : ''}\n`;
+        output += `${'═'.repeat(80)}\n\n`;
+        output += `Total context: ${attentionMap.totalContextLines} lines across ${attentionMap.spans.length} spans\n`;
+        output += `Average attention score: ${(attentionMap.averageAttentionScore * 100).toFixed(1)}%\n\n`;
+        output += `Top ${spansToShow.length} Most Attended Code Regions:\n`;
+        output += `${'─'.repeat(80)}\n\n`;
+        for (let i = 0; i < spansToShow.length; i++) {
+            const span = spansToShow[i];
+            const attentionBar = this.generateAttentionBar(span.attentionScore);
+            output += `${i + 1}. ${span.filepath} (lines ${span.startLine}-${span.endLine})\n`;
+            output += `   Attention: ${attentionBar} ${(span.attentionScore * 100).toFixed(1)}%\n`;
+            if (span.relevanceReason) {
+                output += `   Reason: ${span.relevanceReason}\n`;
+            }
+            if (showContent) {
+                const preview = span.content.split('\n').slice(0, 5).join('\n');
+                output += `   Preview:\n${preview.split('\n').map(line => `      ${line}`).join('\n')}\n`;
+                if (span.content.split('\n').length > 5) {
+                    output += `      ... (${span.content.split('\n').length - 5} more lines)\n`;
+                }
+            }
+            output += '\n';
+        }
+        return output;
+    }
+    /**
+     * Generate attention heatmap data (for UI visualization)
+     */
+    generateHeatmapData(attentionMap) {
+        // Group spans by filepath
+        const fileMap = new Map();
+        for (const span of attentionMap.spans) {
+            if (!fileMap.has(span.filepath)) {
+                fileMap.set(span.filepath, []);
+            }
+            fileMap.get(span.filepath).push(span);
+        }
+        // Generate heatmap data for each file
+        const heatmapData = [];
+        for (const [filepath, spans] of fileMap.entries()) {
+            const lineMap = new Map();
+            // Collect attention scores per line
+            for (const span of spans) {
+                const lines = span.content.split('\n');
+                for (let i = 0; i < lines.length; i++) {
+                    const lineNumber = span.startLine + i;
+                    const existing = lineMap.get(lineNumber);
+                    // Use max attention score if line appears in multiple spans
+                    const score = existing
+                        ? Math.max(existing.score, span.attentionScore)
+                        : span.attentionScore;
+                    lineMap.set(lineNumber, {
+                        score,
+                        content: lines[i],
+                    });
+                }
+            }
+            // Convert to array and sort by line number
+            const lines = Array.from(lineMap.entries())
+                .map(([lineNumber, data]) => ({
+                lineNumber,
+                attentionScore: data.score,
+                content: data.content,
+            }))
+                .sort((a, b) => a.lineNumber - b.lineNumber);
+            heatmapData.push({
+                filepath,
+                lines,
+            });
+        }
+        return heatmapData;
+    }
+    /**
+     * Verify context grounding (check if attention spans actually relate to query)
+     */
+    verifyGrounding(attentionMap, query) {
+        const issues = [];
+        let totalScore = 0;
+        for (const span of attentionMap.topAttentionSpans.slice(0, 3)) {
+            totalScore += span.attentionScore;
+            // Check if high-attention spans have low relevance
+            if (span.attentionScore > 0.8 && !span.relevanceReason) {
+                issues.push(`High attention span (${span.filepath}) lacks clear relevance reason`);
+            }
+        }
+        const averageTopScore = totalScore / Math.min(3, attentionMap.topAttentionSpans.length);
+        const grounded = averageTopScore > 0.5 && issues.length === 0;
+        const confidence = averageTopScore;
+        return {
+            grounded,
+            confidence,
+            issues: issues.length > 0 ? issues : undefined,
+        };
+    }
+    // Private helpers
+    generateRelevanceReason(chunk, attentionScore) {
+        if (attentionScore > 0.8) {
+            return 'Highly relevant - direct match to query';
+        }
+        else if (attentionScore > 0.5) {
+            return 'Relevant - related functionality';
+        }
+        else if (attentionScore > 0.2) {
+            return 'Somewhat relevant - contextual reference';
+        }
+        else {
+            return 'Low relevance - background context';
+        }
+    }
+    generateAttentionBar(score, length = 20) {
+        const filled = Math.round(score * length);
+        const empty = length - filled;
+        return '█'.repeat(filled) + '░'.repeat(empty);
+    }
+}
+//# sourceMappingURL=attention-visualizer.js.map

package/dist/infrastructure/xai/attention-visualizer.js.map

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

package/dist/infrastructure/xai/cot-visualizer.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Infrastructure: Chain-of-Thought (CoT) Visualizer
+ *
+ * Visualizes AI reasoning steps in a human-readable format (Cursor Plan Mode style)
+ * Research: Chain-of-Thought (CoT) reasoning essential for transparency
+ *
+ * Features:
+ * - Step-by-step reasoning visualization
+ * - Tool selection rationale
+ * - Decision point explanations
+ * - Progress tracking
+ */
+export interface CoTStep {
+    stepId: string;
+    stepNumber: number;
+    type: 'thought' | 'action' | 'observation' | 'decision' | 'error';
+    content: string;
+    timestamp: number;
+    metadata?: {
+        tool?: string;
+        toolParams?: Record<string, any>;
+        confidence?: number;
+        reasoning?: string;
+        alternatives?: string[];
+        [key: string]: any;
+    };
+}
+export interface CoTTrajectory {
+    trajectoryId: string;
+    query: string;
+    steps: CoTStep[];
+    currentStep: number;
+    status: 'in_progress' | 'completed' | 'failed' | 'cancelled';
+    startedAt: number;
+    completedAt?: number;
+}
+/**
+ * Chain-of-Thought Visualizer
+ * Formats reasoning steps for human-readable display
+ */
+export declare class CoTVisualizer {
+    /**
+     * Create new CoT trajectory
+     */
+    createTrajectory(query: string): CoTTrajectory;
+    /**
+     * Add thought step
+     */
+    addThought(trajectory: CoTTrajectory, thought: string, metadata?: CoTStep['metadata']): string;
+    /**
+     * Add action step (tool call, edit, etc.)
+     */
+    addAction(trajectory: CoTTrajectory, action: string, metadata?: {
+        tool?: string;
+        toolParams?: Record<string, any>;
+        reasoning?: string;
+        alternatives?: string[];
+    }): string;
+    /**
+     * Add observation step (tool result, file content, etc.)
+     */
+    addObservation(trajectory: CoTTrajectory, observation: string, metadata?: CoTStep['metadata']): string;
+    /**
+     * Add decision step (choice point, branching)
+     */
+    addDecision(trajectory: CoTTrajectory, decision: string, options: string[], chosen: string, rationale?: string): string;
+    /**
+     * Add error step
+     */
+    addError(trajectory: CoTTrajectory, error: string, errorDetails?: any): string;
+    /**
+     * Mark trajectory as completed
+     */
+    completeTrajectory(trajectory: CoTTrajectory): void;
+    /**
+     * Format trajectory for console output (human-readable)
+     */
+    formatForConsole(trajectory: CoTTrajectory, options?: {
+        showMetadata?: boolean;
+        maxSteps?: number;
+        compact?: boolean;
+    }): string;
+    /**
+     * Format trajectory for JSON export
+     */
+    formatForJSON(trajectory: CoTTrajectory): string;
+    /**
+     * Format trajectory for interactive UI (structured data)
+     */
+    formatForUI(trajectory: CoTTrajectory): {
+        query: string;
+        status: string;
+        steps: Array<{
+            number: number;
+            type: string;
+            content: string;
+            timestamp: number;
+            metadata?: any;
+        }>;
+        duration?: number;
+    };
+    private formatStep;
+    private getStepIcon;
+}
+//# sourceMappingURL=cot-visualizer.d.ts.map

package/dist/infrastructure/xai/cot-visualizer.d.ts.map

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