codehere 0.2.0 → 0.4.0

package/dist/infrastructure/ux/syntax-highlighter.js

@@ -0,0 +1,172 @@
+/**
+ * Syntax Highlighter for Terminal
+ * Provides basic syntax highlighting for code snippets using chalk
+ *
+ * Lightweight implementation - no heavy dependencies
+ * Supports: TypeScript, JavaScript, Python, JSON, YAML, Markdown, Shell
+ */
+import { colors } from '../../ui.js';
+/**
+ * Detect language from file extension
+ */
+export function detectLanguage(filepath) {
+    const ext = filepath.split('.').pop()?.toLowerCase() || '';
+    const languageMap = {
+        'ts': 'typescript',
+        'tsx': 'typescript',
+        'js': 'javascript',
+        'jsx': 'javascript',
+        'mjs': 'javascript',
+        'cjs': 'javascript',
+        'py': 'python',
+        'json': 'json',
+        'yaml': 'yaml',
+        'yml': 'yaml',
+        'md': 'markdown',
+        'sh': 'shell',
+        'bash': 'bash',
+    };
+    return languageMap[ext] || 'text';
+}
+/**
+ * Highlight TypeScript/JavaScript code
+ */
+function highlightTypeScript(code) {
+    const lines = code.split('\n');
+    return lines.map(line => {
+        let highlighted = line;
+        // Keywords (const, let, var, function, class, interface, type, etc.)
+        highlighted = highlighted.replace(/\b(const|let|var|function|class|interface|type|enum|namespace|import|export|from|as|default|extends|implements|public|private|protected|static|readonly|async|await|return|if|else|for|while|switch|case|break|continue|try|catch|finally|throw|new|this|super|typeof|instanceof|in|of)\b/g, (match) => colors.magenta(match));
+        // Strings (single, double, template literals)
+        highlighted = highlighted.replace(/(['"`])((?:\\.|(?!\1)[^\\])*?)\1/g, (match) => colors.green(match));
+        // Numbers
+        highlighted = highlighted.replace(/\b(\d+\.?\d*)\b/g, (match) => colors.yellow(match));
+        // Comments
+        highlighted = highlighted.replace(/(\/\/.*$|\/\*[\s\S]*?\*\/)/gm, (match) => colors.dim(match));
+        // Function/class names (before opening paren)
+        highlighted = highlighted.replace(/\b([A-Z][a-zA-Z0-9]*)\s*(?=\()/g, (match) => colors.cyan(match.trim()));
+        return highlighted;
+    }).join('\n');
+}
+/**
+ * Highlight Python code
+ */
+function highlightPython(code) {
+    const lines = code.split('\n');
+    return lines.map(line => {
+        let highlighted = line;
+        // Keywords
+        highlighted = highlighted.replace(/\b(def|class|if|elif|else|for|while|try|except|finally|with|import|from|as|return|yield|lambda|pass|break|continue|raise|assert|and|or|not|in|is|None|True|False)\b/g, (match) => colors.magenta(match));
+        // Strings
+        highlighted = highlighted.replace(/(['"])((?:\\.|(?!\1)[^\\])*?)\1/g, (match) => colors.green(match));
+        // Numbers
+        highlighted = highlighted.replace(/\b(\d+\.?\d*)\b/g, (match) => colors.yellow(match));
+        // Comments
+        highlighted = highlighted.replace(/(#.*$)/gm, (match) => colors.dim(match));
+        // Function/class names
+        highlighted = highlighted.replace(/\b(def|class)\s+([a-zA-Z_][a-zA-Z0-9_]*)/g, (match, keyword, name) => colors.magenta(keyword) + ' ' + colors.cyan(name));
+        return highlighted;
+    }).join('\n');
+}
+/**
+ * Highlight JSON code
+ */
+function highlightJSON(code) {
+    const lines = code.split('\n');
+    return lines.map(line => {
+        let highlighted = line;
+        // Keys (before colon)
+        highlighted = highlighted.replace(/"([^"]+)":/g, (match, key) => colors.green(`"${key}"`) + colors.dim(':'));
+        // Strings
+        highlighted = highlighted.replace(/"([^"]+)"/g, (match, value) => {
+            // Don't highlight keys again
+            if (match.includes(':'))
+                return match;
+            return colors.green(match);
+        });
+        // Numbers
+        highlighted = highlighted.replace(/\b(\d+\.?\d*)\b/g, (match) => colors.yellow(match));
+        // Booleans/null
+        highlighted = highlighted.replace(/\b(true|false|null)\b/g, (match) => colors.magenta(match));
+        return highlighted;
+    }).join('\n');
+}
+/**
+ * Highlight Shell/Bash code
+ */
+function highlightShell(code) {
+    const lines = code.split('\n');
+    return lines.map(line => {
+        let highlighted = line;
+        // Commands (first word)
+        highlighted = highlighted.replace(/^(\s*)([a-zA-Z_][a-zA-Z0-9_-]*)\s/, (match, indent, cmd) => indent + colors.cyan(cmd) + ' ');
+        // Variables
+        highlighted = highlighted.replace(/\$([a-zA-Z_][a-zA-Z0-9_]*)/g, (match) => colors.yellow(match));
+        // Strings
+        highlighted = highlighted.replace(/(['"])((?:\\.|(?!\1)[^\\])*?)\1/g, (match) => colors.green(match));
+        // Comments
+        highlighted = highlighted.replace(/(#.*$)/gm, (match) => colors.dim(match));
+        return highlighted;
+    }).join('\n');
+}
+/**
+ * Highlight code based on language
+ */
+export function highlightCode(code, language) {
+    if (!code)
+        return '';
+    const lang = (language || 'text');
+    // Check if terminal supports colors
+    if (!process.stdout.isTTY || process.env.NO_COLOR) {
+        return code; // Return unhighlighted if colors disabled
+    }
+    switch (lang) {
+        case 'typescript':
+        case 'javascript':
+            return highlightTypeScript(code);
+        case 'python':
+            return highlightPython(code);
+        case 'json':
+            return highlightJSON(code);
+        case 'shell':
+        case 'bash':
+            return highlightShell(code);
+        case 'yaml':
+        case 'markdown':
+        case 'text':
+        default:
+            // Basic highlighting for other languages
+            return code.split('\n').map(line => {
+                // Highlight comments
+                let highlighted = line.replace(/(#.*$)/gm, (match) => colors.dim(match));
+                // Highlight strings
+                highlighted = highlighted.replace(/(['"])((?:\\.|(?!\1)[^\\])*?)\1/g, (match) => colors.green(match));
+                return highlighted;
+            }).join('\n');
+    }
+}
+/**
+ * Format code block with syntax highlighting
+ */
+export function formatCodeBlockWithHighlight(code, language, filepath) {
+    const detectedLang = filepath ? detectLanguage(filepath) : (language || 'text');
+    const highlighted = highlightCode(code, detectedLang);
+    const lines = highlighted.split('\n');
+    const maxWidth = process.stdout.columns || 80;
+    const indent = '  ';
+    let output = colors.dim('┌─ Code');
+    if (detectedLang !== 'text') {
+        output += colors.dim(` (${detectedLang})`);
+    }
+    output += colors.dim(' ─'.repeat(Math.max(0, Math.floor((maxWidth - 20) / 2))) + '┐\n');
+    for (const line of lines) {
+        // Truncate very long lines
+        const displayLine = line.length > maxWidth - 10
+            ? line.substring(0, maxWidth - 13) + '...'
+            : line;
+        output += indent + displayLine + '\n';
+    }
+    output += colors.dim('└' + '─'.repeat(Math.max(0, maxWidth - 4)) + '┘');
+    return output;
+}
+//# sourceMappingURL=syntax-highlighter.js.map

package/dist/infrastructure/ux/syntax-highlighter.js.map

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

package/dist/infrastructure/validation/agent-feedback.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Infrastructure: Agent Feedback Module
+ * Unified evaluation & feedback capture layer for Validation Mode
+ *
+ * Features:
+ * - Record success/failure, user approval, user modifications, errors
+ * - Store anonymously in local memory for pattern improvements
+ * - JSON-based, appended per operation
+ * - Privacy-first design with opt-out support
+ */
+export type FeedbackOutcome = 'success' | 'failure' | 'partial_success' | 'cancelled' | 'error';
+export type UserAction = 'approved' | 'rejected' | 'modified' | 'skipped' | 'not_required';
+export interface AgentFeedback {
+    feedbackId: string;
+    runId: string;
+    agentName: string;
+    timestamp: number;
+    operation: string;
+    query?: string;
+    outcome: FeedbackOutcome;
+    userAction: UserAction;
+    filesChanged?: string[];
+    filesCreated?: string[];
+    filesDeleted?: string[];
+    userModifications?: Array<{
+        filepath: string;
+        modificationType: 'edited' | 'reverted' | 'accepted' | 'rejected';
+        description?: string;
+    }>;
+    errors?: string[];
+    warnings?: string[];
+    validationChecks?: Array<{
+        check: string;
+        passed: boolean;
+        message?: string;
+    }>;
+    metrics?: {
+        tokensUsed?: number;
+        duration?: number;
+        filesAnalyzed?: number;
+        changesProposed?: number;
+        changesApplied?: number;
+    };
+    context?: {
+        codebaseType?: string;
+        fileCount?: number;
+        operationType?: string;
+    };
+    userFeedback?: {
+        rating?: number;
+        comment?: string;
+    };
+}
+export interface AgentFeedbackConfig {
+    enabled: boolean;
+    storagePath?: string;
+    anonymize: boolean;
+    optOut: boolean;
+}
+/**
+ * Agent Feedback Manager
+ * Lightweight, privacy-first feedback capture
+ */
+export declare class AgentFeedbackManager {
+    private config;
+    private feedbackDir;
+    private feedbackHistory;
+    constructor(config?: Partial<AgentFeedbackConfig>);
+    /**
+     * Record feedback for an agent operation
+     * userAction is required - must be provided by caller
+     */
+    recordFeedback(feedback: Omit<AgentFeedback, 'feedbackId' | 'timestamp'> & {
+        userAction: UserAction;
+    }): string;
+    /**
+     * Get feedback for a run
+     */
+    getFeedbackForRun(runId: string): AgentFeedback | null;
+    /**
+     * Get recent feedback patterns (for learning)
+     */
+    getRecentFeedback(limit?: number): AgentFeedback[];
+    /**
+     * Get feedback statistics
+     */
+    getFeedbackStats(): {
+        total: number;
+        byOutcome: Record<FeedbackOutcome, number>;
+        byAgent: Record<string, number>;
+        averageRating?: number;
+    };
+    /**
+     * Anonymize feedback (remove sensitive data)
+     */
+    private anonymizeFeedback;
+    /**
+     * Anonymize file path (keep structure, not actual names)
+     */
+    private anonymizePath;
+    /**
+     * Load recent feedback from disk
+     */
+    private loadRecentFeedback;
+    /**
+     * Clear all feedback (privacy control)
+     */
+    clearFeedback(): void;
+    /**
+     * Check if feedback collection is enabled
+     */
+    isEnabled(): boolean;
+}
+export declare const agentFeedbackManager: AgentFeedbackManager;
+//# sourceMappingURL=agent-feedback.d.ts.map

package/dist/infrastructure/validation/agent-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-feedback.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/agent-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,CAAC;AAChG,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IAGvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAGxB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;QAClE,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAGH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAGpB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IAGH,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAGF,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAGF,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAuB;gBAElC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAgCjD;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG;QAAE,UAAU,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM;IAwC9G;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAItD;;OAEG;IACH,iBAAiB,CAAC,KAAK,GAAE,MAAY,GAAG,aAAa,EAAE;IAIvD;;OAEG;IACH,gBAAgB,IAAI;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAgCD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,aAAa,IAAI,IAAI;IAYrB;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/infrastructure/validation/agent-feedback.js

@@ -0,0 +1,227 @@
+/**
+ * Infrastructure: Agent Feedback Module
+ * Unified evaluation & feedback capture layer for Validation Mode
+ *
+ * Features:
+ * - Record success/failure, user approval, user modifications, errors
+ * - Store anonymously in local memory for pattern improvements
+ * - JSON-based, appended per operation
+ * - Privacy-first design with opt-out support
+ */
+import { writeFileSync, readFileSync, existsSync, mkdirSync, appendFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { randomUUID } from 'crypto';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Agent Feedback Manager
+ * Lightweight, privacy-first feedback capture
+ */
+export class AgentFeedbackManager {
+    config;
+    feedbackDir = '';
+    feedbackHistory = [];
+    constructor(config) {
+        // Check opt-out preference
+        const optOut = process.env.CODEHERE_FEEDBACK_OPT_OUT === 'true' ||
+            process.env.CODEHERE_TELEMETRY_DISABLED === 'true';
+        this.config = {
+            enabled: !optOut && (config?.enabled !== false),
+            anonymize: config?.anonymize !== false,
+            optOut: optOut || (config?.optOut === true),
+            storagePath: config?.storagePath,
+        };
+        if (this.config.optOut || !this.config.enabled) {
+            return;
+        }
+        // Set up feedback storage directory
+        if (this.config.storagePath) {
+            this.feedbackDir = this.config.storagePath;
+        }
+        else {
+            const agentDir = join(__dirname, '../../..');
+            this.feedbackDir = join(agentDir, 'data', 'feedback');
+        }
+        if (!existsSync(this.feedbackDir)) {
+            mkdirSync(this.feedbackDir, { recursive: true });
+        }
+        // Load recent feedback history (for pattern analysis)
+        this.loadRecentFeedback();
+    }
+    /**
+     * Record feedback for an agent operation
+     * userAction is required - must be provided by caller
+     */
+    recordFeedback(feedback) {
+        if (this.config.optOut || !this.config.enabled) {
+            return 'feedback-disabled';
+        }
+        const feedbackId = randomUUID();
+        const fullFeedback = {
+            ...feedback,
+            feedbackId,
+            timestamp: Date.now(),
+        };
+        // Anonymize if configured
+        const processedFeedback = this.config.anonymize
+            ? this.anonymizeFeedback(fullFeedback)
+            : fullFeedback;
+        // Store in memory
+        this.feedbackHistory.push(processedFeedback);
+        if (this.feedbackHistory.length > 1000) {
+            // Keep only last 1000 in memory
+            this.feedbackHistory = this.feedbackHistory.slice(-1000);
+        }
+        // Append to JSON file (one JSON object per line for easy parsing)
+        const feedbackFile = join(this.feedbackDir, 'agent-feedback.jsonl');
+        try {
+            appendFileSync(feedbackFile, JSON.stringify(processedFeedback) + '\n', 'utf-8');
+        }
+        catch (error) {
+            // Silent failure - don't break user workflow
+            console.error('[AgentFeedback] Failed to write feedback:', error);
+        }
+        return feedbackId;
+    }
+    /**
+     * Get feedback for a run
+     */
+    getFeedbackForRun(runId) {
+        return this.feedbackHistory.find(f => f.runId === runId) || null;
+    }
+    /**
+     * Get recent feedback patterns (for learning)
+     */
+    getRecentFeedback(limit = 100) {
+        return this.feedbackHistory.slice(-limit);
+    }
+    /**
+     * Get feedback statistics
+     */
+    getFeedbackStats() {
+        const stats = {
+            total: this.feedbackHistory.length,
+            byOutcome: {},
+            byAgent: {},
+            averageRating: undefined,
+        };
+        let totalRating = 0;
+        let ratingCount = 0;
+        for (const feedback of this.feedbackHistory) {
+            // Count by outcome
+            stats.byOutcome[feedback.outcome] = (stats.byOutcome[feedback.outcome] || 0) + 1;
+            // Count by agent
+            stats.byAgent[feedback.agentName] = (stats.byAgent[feedback.agentName] || 0) + 1;
+            // Calculate average rating
+            if (feedback.userFeedback?.rating) {
+                totalRating += feedback.userFeedback.rating;
+                ratingCount++;
+            }
+        }
+        if (ratingCount > 0) {
+            stats.averageRating = totalRating / ratingCount;
+        }
+        return stats;
+    }
+    /**
+     * Anonymize feedback (remove sensitive data)
+     */
+    anonymizeFeedback(feedback) {
+        const anonymized = { ...feedback };
+        // Remove query content if it might contain sensitive info
+        if (anonymized.query) {
+            // Keep only intent keywords, not full query
+            const keywords = anonymized.query
+                .split(/\s+/)
+                .filter(w => w.length > 3)
+                .slice(0, 5)
+                .join(' ');
+            anonymized.query = keywords || '[anonymized]';
+        }
+        // Remove file contents from modifications
+        if (anonymized.userModifications) {
+            anonymized.userModifications = anonymized.userModifications.map(mod => ({
+                filepath: this.anonymizePath(mod.filepath),
+                modificationType: mod.modificationType,
+                description: mod.description ? '[anonymized]' : undefined,
+            }));
+        }
+        // Anonymize file paths (keep structure, not names)
+        if (anonymized.filesChanged) {
+            anonymized.filesChanged = anonymized.filesChanged.map(p => this.anonymizePath(p));
+        }
+        if (anonymized.filesCreated) {
+            anonymized.filesCreated = anonymized.filesCreated.map(p => this.anonymizePath(p));
+        }
+        return anonymized;
+    }
+    /**
+     * Anonymize file path (keep structure, not actual names)
+     */
+    anonymizePath(filepath) {
+        // Replace actual file names with placeholders but keep structure
+        const parts = filepath.split('/');
+        return parts.map((part, index) => {
+            if (index === parts.length - 1) {
+                // Last part is filename
+                const ext = part.split('.').pop();
+                return `file${ext ? '.' + ext : ''}`;
+            }
+            return part;
+        }).join('/');
+    }
+    /**
+     * Load recent feedback from disk
+     */
+    loadRecentFeedback() {
+        const feedbackFile = join(this.feedbackDir, 'agent-feedback.jsonl');
+        if (!existsSync(feedbackFile)) {
+            return;
+        }
+        try {
+            const content = readFileSync(feedbackFile, 'utf-8');
+            const lines = content.trim().split('\n').filter(line => line.trim());
+            // Load last 100 entries
+            const recentLines = lines.slice(-100);
+            this.feedbackHistory = recentLines
+                .map(line => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((f) => f !== null);
+        }
+        catch (error) {
+            // Silent failure
+            console.error('[AgentFeedback] Failed to load feedback history:', error);
+        }
+    }
+    /**
+     * Clear all feedback (privacy control)
+     */
+    clearFeedback() {
+        this.feedbackHistory = [];
+        const feedbackFile = join(this.feedbackDir, 'agent-feedback.jsonl');
+        if (existsSync(feedbackFile)) {
+            try {
+                writeFileSync(feedbackFile, '', 'utf-8');
+            }
+            catch {
+                // Silent failure
+            }
+        }
+    }
+    /**
+     * Check if feedback collection is enabled
+     */
+    isEnabled() {
+        return !this.config.optOut && this.config.enabled;
+    }
+}
+// Singleton instance
+export const agentFeedbackManager = new AgentFeedbackManager();
+//# sourceMappingURL=agent-feedback.js.map

package/dist/infrastructure/validation/agent-feedback.js.map

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

package/dist/infrastructure/validation/agent-validation-helper.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Infrastructure: Agent Validation Helper
+ * Shared utilities for integrating Validation Layer into agents
+ *
+ * Provides:
+ * - Automatic TraceSummary generation
+ * - AgentFeedback recording
+ * - Run context tracking
+ */
+import type { TraceSummary } from './trace-summary.js';
+import type { FeedbackOutcome, UserAction } from './agent-feedback.js';
+export interface AgentValidationContext {
+    runId: string;
+    agentName: string;
+    operation: string;
+    startTime: number;
+}
+export interface AgentValidationResult<T = any> {
+    result: T;
+    summary: TraceSummary;
+    feedbackId: string;
+    runId: string;
+}
+/**
+ * Helper class for agent validation integration
+ */
+export declare class AgentValidationHelper {
+    /**
+     * Start validation context for an agent operation
+     */
+    startAgentOperation(agentName: string, operation: string, context?: {
+        query?: string;
+        codebaseId?: string;
+    }): AgentValidationContext;
+    /**
+     * Complete agent operation and generate validation artifacts
+     */
+    completeAgentOperation<T>(validationContext: AgentValidationContext, result: T, metadata: {
+        outcome: FeedbackOutcome;
+        userAction?: UserAction;
+        filesChanged?: string[];
+        filesCreated?: string[];
+        filesDeleted?: string[];
+        errors?: string[];
+        warnings?: string[];
+        validationChecks?: Array<{
+            check: string;
+            passed: boolean;
+            message?: string;
+            critical?: boolean;
+        }>;
+        metrics?: {
+            tokensUsed?: number;
+            duration?: number;
+            filesAnalyzed?: number;
+            changesProposed?: number;
+            changesApplied?: number;
+        };
+        additionalContext?: Record<string, any>;
+    }): Promise<AgentValidationResult<T>>;
+    /**
+     * Record a trace during agent operation
+     */
+    trace(operation: {
+        operationType: 'llm_call' | 'tool_invocation' | 'memory_operation' | 'plan_generation' | 'code_analysis' | 'file_operation' | 'git_operation' | 'other';
+        operationName: string;
+        input?: any;
+        output?: any;
+        error?: Error;
+        metadata?: Record<string, any>;
+        duration?: number;
+    }): string;
+}
+export declare const agentValidationHelper: AgentValidationHelper;
+//# sourceMappingURL=agent-validation-helper.d.ts.map

package/dist/infrastructure/validation/agent-validation-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validation-helper.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/agent-validation-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAiB,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,GAAG;IAC5C,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,sBAAsB;IAczB;;OAEG;IACG,sBAAsB,CAAC,CAAC,EAC5B,iBAAiB,EAAE,sBAAsB,EACzC,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe,CAAC;QACzB,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,gBAAgB,CAAC,EAAE,KAAK,CAAC;YACvB,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;QACH,OAAO,CAAC,EAAE;YACR,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;QACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACzC,GACA,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAuDpC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE;QACf,aAAa,EAAE,UAAU,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,OAAO,CAAC;QACxJ,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,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,MAAM;CAGX;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}