attocode 0.1.3 → 0.1.4

package/dist/src/analysis/trace-summary.js

@@ -0,0 +1,261 @@
+/**
+ * Trace Summary Generator
+ *
+ * Generates structured summaries of trace sessions for LLM analysis.
+ * Designed to produce compact output suitable for analysis by other LLMs.
+ */
+/**
+ * Generates TraceSummary from SessionTrace data.
+ */
+export class TraceSummaryGenerator {
+    trace;
+    constructor(trace) {
+        this.trace = trace;
+    }
+    /**
+     * Generate a compact summary for LLM analysis.
+     * Target size: ~4000 tokens.
+     */
+    generate() {
+        return {
+            meta: this.generateMeta(),
+            metrics: this.generateMetrics(),
+            decisionPoints: this.extractDecisionPoints(),
+            anomalies: this.detectAnomalies(),
+            toolPatterns: this.analyzeToolPatterns(),
+            iterationSummaries: this.summarizeIterations(),
+            codeLocations: this.mapCodeLocations(),
+        };
+    }
+    /**
+     * Generate session metadata.
+     */
+    generateMeta() {
+        return {
+            sessionId: this.trace.sessionId,
+            task: this.truncate(this.trace.task, 200),
+            model: this.trace.model,
+            duration: this.trace.durationMs || 0,
+            status: this.trace.status,
+            timestamp: this.trace.startTime,
+        };
+    }
+    /**
+     * Generate aggregated metrics.
+     */
+    generateMetrics() {
+        const metrics = this.trace.metrics;
+        // Count unique tools
+        const toolNames = new Set();
+        for (const iter of this.trace.iterations) {
+            for (const tool of iter.toolExecutions) {
+                toolNames.add(tool.toolName);
+            }
+        }
+        return {
+            iterations: this.trace.iterations.length,
+            totalTokens: metrics.inputTokens + metrics.outputTokens,
+            inputTokens: metrics.inputTokens,
+            outputTokens: metrics.outputTokens,
+            thinkingTokens: undefined, // Would need to aggregate from iterations
+            cacheHitRate: metrics.avgCacheHitRate,
+            cost: metrics.estimatedCost,
+            costSaved: metrics.costSavedByCache,
+            toolCalls: metrics.toolCalls,
+            uniqueTools: toolNames.size,
+            errors: metrics.errors,
+        };
+    }
+    /**
+     * Extract key decision points from trace.
+     */
+    extractDecisionPoints() {
+        // This would need to read from decision trace events
+        // For now, return empty array - to be populated when decisions are captured
+        return [];
+    }
+    /**
+     * Detect anomalies in the trace.
+     */
+    detectAnomalies() {
+        const anomalies = [];
+        const metrics = this.trace.metrics;
+        // Check for excessive iterations
+        if (this.trace.iterations.length > 10) {
+            anomalies.push({
+                type: 'excessive_iterations',
+                severity: 'high',
+                description: `Session used ${this.trace.iterations.length} iterations, significantly above typical`,
+                evidence: `Iteration count: ${this.trace.iterations.length}`,
+            });
+        }
+        else if (this.trace.iterations.length > 7) {
+            anomalies.push({
+                type: 'excessive_iterations',
+                severity: 'medium',
+                description: `Session used ${this.trace.iterations.length} iterations`,
+                evidence: `Iteration count: ${this.trace.iterations.length}`,
+            });
+        }
+        // Check for low cache hit rate
+        if (metrics.avgCacheHitRate < 0.3 && this.trace.iterations.length > 2) {
+            anomalies.push({
+                type: 'cache_inefficiency',
+                severity: 'high',
+                description: `Very low cache hit rate: ${Math.round(metrics.avgCacheHitRate * 100)}%`,
+                evidence: `Expected >50% for multi-iteration sessions`,
+            });
+        }
+        else if (metrics.avgCacheHitRate < 0.5 && this.trace.iterations.length > 3) {
+            anomalies.push({
+                type: 'cache_inefficiency',
+                severity: 'medium',
+                description: `Below-average cache hit rate: ${Math.round(metrics.avgCacheHitRate * 100)}%`,
+                evidence: `Expected >50% for longer sessions`,
+            });
+        }
+        // Check for error count
+        if (metrics.errors > 3) {
+            anomalies.push({
+                type: 'error_loop',
+                severity: 'high',
+                description: `Session had ${metrics.errors} errors`,
+                evidence: `Error count: ${metrics.errors}`,
+            });
+        }
+        // Check for redundant tool calls
+        const toolCallCounts = new Map();
+        for (const iter of this.trace.iterations) {
+            for (const tool of iter.toolExecutions) {
+                toolCallCounts.set(tool.toolName, (toolCallCounts.get(tool.toolName) || 0) + 1);
+            }
+        }
+        for (const [tool, count] of toolCallCounts) {
+            if (count >= 5) {
+                anomalies.push({
+                    type: 'redundant_tool_calls',
+                    severity: count >= 8 ? 'high' : 'medium',
+                    description: `Tool "${tool}" called ${count} times`,
+                    evidence: `May indicate repetitive behavior`,
+                });
+            }
+        }
+        return anomalies;
+    }
+    /**
+     * Analyze tool usage patterns.
+     */
+    analyzeToolPatterns() {
+        const frequency = {};
+        const toolIterations = {};
+        const toolDurations = {};
+        for (const iter of this.trace.iterations) {
+            for (const tool of iter.toolExecutions) {
+                frequency[tool.toolName] = (frequency[tool.toolName] || 0) + 1;
+                if (!toolIterations[tool.toolName])
+                    toolIterations[tool.toolName] = [];
+                toolIterations[tool.toolName].push(iter.iterationNumber);
+                if (!toolDurations[tool.toolName])
+                    toolDurations[tool.toolName] = [];
+                toolDurations[tool.toolName].push(tool.durationMs);
+            }
+        }
+        // Find redundant calls
+        const redundantCalls = Object.entries(toolIterations)
+            .filter(([_, iters]) => iters.length >= 3)
+            .map(([tool, iterations]) => ({
+            tool,
+            count: iterations.length,
+            iterations,
+        }));
+        // Find slow tools
+        const slowTools = Object.entries(toolDurations)
+            .map(([tool, durations]) => ({
+            tool,
+            avgDuration: Math.round(durations.reduce((a, b) => a + b, 0) / durations.length),
+            maxDuration: Math.max(...durations),
+        }))
+            .filter(t => t.avgDuration > 5000);
+        return {
+            frequency,
+            redundantCalls,
+            slowTools,
+        };
+    }
+    /**
+     * Summarize each iteration.
+     */
+    summarizeIterations() {
+        return this.trace.iterations.map(iter => {
+            const hasError = iter.toolExecutions.some(t => t.status === 'error');
+            const flags = [];
+            if (hasError)
+                flags.push('error');
+            if (iter.metrics.cacheHitRate < 0.3)
+                flags.push('low_cache');
+            // Determine main action
+            let action = 'processing';
+            if (iter.toolExecutions.length > 0) {
+                action = `Tools: ${iter.toolExecutions.map(t => t.toolName).join(', ')}`;
+            }
+            return {
+                number: iter.iterationNumber,
+                action: this.truncate(action, 60),
+                outcome: hasError ? 'failure' : 'success',
+                tokensUsed: iter.metrics.inputTokens + iter.metrics.outputTokens,
+                flags,
+            };
+        });
+    }
+    /**
+     * Map anomalies to code locations.
+     */
+    mapCodeLocations() {
+        const anomalies = this.detectAnomalies();
+        const locations = [];
+        const CODE_MAP = {
+            excessive_iterations: [
+                { file: 'src/agent.ts', component: 'ProductionAgent.run', relevance: 'primary' },
+                { file: 'src/integrations/context-engineering.ts', component: 'ContextEngineering', relevance: 'secondary' },
+            ],
+            cache_inefficiency: [
+                { file: 'src/tracing/cache-boundary-tracker.ts', component: 'CacheBoundaryTracker', relevance: 'primary' },
+            ],
+            redundant_tool_calls: [
+                { file: 'src/agent.ts', component: 'executeToolCalls', relevance: 'primary' },
+                { file: 'src/tricks/failure-evidence.ts', component: 'FailureEvidence', relevance: 'secondary' },
+            ],
+            error_loop: [
+                { file: 'src/tricks/failure-evidence.ts', component: 'FailureEvidence', relevance: 'primary' },
+            ],
+        };
+        for (const anomaly of anomalies) {
+            const mappings = CODE_MAP[anomaly.type] || [];
+            for (const mapping of mappings) {
+                // Avoid duplicates
+                if (!locations.some(l => l.file === mapping.file && l.component === mapping.component)) {
+                    locations.push({
+                        ...mapping,
+                        description: `Related to: ${anomaly.type}`,
+                    });
+                }
+            }
+        }
+        return locations;
+    }
+    /**
+     * Truncate string to max length.
+     */
+    truncate(str, maxLen) {
+        if (str.length <= maxLen)
+            return str;
+        return str.slice(0, maxLen - 3) + '...';
+    }
+}
+/**
+ * Factory function.
+ */
+export function createTraceSummaryGenerator(trace) {
+    return new TraceSummaryGenerator(trace);
+}
+//# sourceMappingURL=trace-summary.js.map

package/dist/src/analysis/trace-summary.js.map

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

package/dist/src/commands/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/commands/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwJhE;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC,CA0xCxB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,YAAY,EAAE,aAAa,CAMxE"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/commands/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA+JhE;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC,CAo+CxB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,YAAY,EAAE,aAAa,CAMxE"}

package/dist/src/commands/handler.js

@@ -118,6 +118,13 @@ ${c('SKILLS & AGENTS', 'bold')}
 ${c('INITIALIZATION', 'bold')}
   ${c('/init', 'cyan')}              Initialize .attocode/ directory structure
 
+${c('TRACE ANALYSIS', 'bold')}
+  ${c('/trace', 'cyan')}             Show current session trace summary
+  ${c('/trace --analyze', 'cyan')}   Run efficiency analysis on trace
+  ${c('/trace issues', 'cyan')}      List detected inefficiencies
+  ${c('/trace fixes', 'cyan')}       List pending improvements
+  ${c('/trace export', 'cyan')}      Export trace JSON for LLM analysis
+
 ${c('CAPABILITIES & DEBUGGING', 'bold')}
   ${c('/powers', 'cyan')}            Show all agent capabilities
   ${c('/powers <type>', 'cyan')}     List by type (tools, skills, agents, mcp, commands)
@@ -1086,7 +1093,7 @@ ${c('Tip:', 'dim')} Use /mcp search <query> to load specific tools on-demand.
         case '/compact':
             try {
                 const state = agent.getState();
-                const contextUsage = getContextUsage(state.messages, 80000);
+                const contextUsage = getContextUsage(state.messages, agent.getMaxContextTokens());
                 if (args[0] === 'status') {
                     output.log(`
 ${c('Context Status:', 'bold')}
@@ -1158,7 +1165,7 @@ ${c('  Category             Tokens    % of Total', 'dim')}
                         .filter(m => m.role !== 'system')
                         .reduce((sum, m) => sum + estimateTokens(m.content), 0);
                     const totalTokens = baseTokens + convTokens;
-                    const contextLimit = 80000;
+                    const contextLimit = agent.getMaxContextTokens();
                     const percent = Math.round((totalTokens / contextLimit) * 100);
                     const shouldCompact = percent >= 80;
                     const bar = '='.repeat(Math.min(20, Math.round(percent / 5))) +
@@ -1412,6 +1419,191 @@ ${c('Test it:', 'dim')}
             await handleInitCommand(args, ctx);
             break;
         // =========================================================================
+        // TRACE ANALYSIS
+        // =========================================================================
+        case '/trace': {
+            const traceCollector = agent.getTraceCollector();
+            if (args.length === 0) {
+                // Show current session trace summary
+                if (!traceCollector) {
+                    output.log(c('Tracing is not enabled. Start agent with --trace to enable.', 'yellow'));
+                    break;
+                }
+                const data = traceCollector.getSessionTrace();
+                if (!data || !data.iterations || data.iterations.length === 0) {
+                    output.log(c('No trace data collected yet.', 'dim'));
+                    break;
+                }
+                output.log(`
+${c('Trace Summary:', 'bold')}
+  Session ID:    ${data.sessionId}
+  Status:        ${data.status}
+  Iterations:    ${data.iterations.length}
+  Duration:      ${data.durationMs ? `${Math.round(data.durationMs / 1000)}s` : 'ongoing'}
+
+${c('Metrics:', 'bold')}
+  Input tokens:  ${data.metrics.inputTokens.toLocaleString()}
+  Output tokens: ${data.metrics.outputTokens.toLocaleString()}
+  Cache hit:     ${Math.round(data.metrics.avgCacheHitRate * 100)}%
+  Tool calls:    ${data.metrics.toolCalls}
+  Errors:        ${data.metrics.errors}
+  Est. Cost:     $${data.metrics.estimatedCost.toFixed(4)}
+
+${c('Use:', 'dim')} /trace --analyze for efficiency analysis
+${c('     ', 'dim')} /trace issues to see detected inefficiencies
+`);
+            }
+            else if (args[0] === '--analyze' || args[0] === 'analyze') {
+                // Run efficiency analysis
+                if (!traceCollector) {
+                    output.log(c('Tracing is not enabled.', 'yellow'));
+                    break;
+                }
+                const data = traceCollector.getSessionTrace();
+                if (!data || !data.iterations || data.iterations.length === 0) {
+                    output.log(c('No trace data to analyze.', 'dim'));
+                    break;
+                }
+                output.log(c('Analyzing trace...', 'cyan'));
+                // Import analysis module dynamically
+                const { createTraceSummaryGenerator } = await import('../analysis/trace-summary.js');
+                const generator = createTraceSummaryGenerator(data);
+                const summary = generator.generate();
+                // Display analysis results
+                output.log(`
+${c('Efficiency Analysis:', 'bold')}
+
+${c('Anomalies Detected:', 'bold')} ${summary.anomalies.length}
+`);
+                if (summary.anomalies.length === 0) {
+                    output.log(c('  No significant issues detected.', 'green'));
+                }
+                else {
+                    for (const anomaly of summary.anomalies) {
+                        const severityColor = anomaly.severity === 'high' ? 'red' :
+                            anomaly.severity === 'medium' ? 'yellow' : 'dim';
+                        output.log(`  ${c(`[${anomaly.severity.toUpperCase()}]`, severityColor)} ${anomaly.type}`);
+                        output.log(`       ${anomaly.description}`);
+                        output.log(c(`       Evidence: ${anomaly.evidence}`, 'dim'));
+                    }
+                }
+                output.log(`
+${c('Tool Patterns:', 'bold')}
+  Unique tools used: ${Object.keys(summary.toolPatterns.frequency).length}
+  Redundant calls:   ${summary.toolPatterns.redundantCalls.length}
+  Slow tools:        ${summary.toolPatterns.slowTools.length}
+`);
+                if (summary.codeLocations.length > 0) {
+                    output.log(c('Related Code Locations:', 'bold'));
+                    for (const loc of summary.codeLocations) {
+                        const rel = loc.relevance === 'primary' ? c('[PRIMARY]', 'cyan') :
+                            loc.relevance === 'secondary' ? c('[SECONDARY]', 'dim') : '';
+                        output.log(`  ${rel} ${loc.file} - ${loc.component}`);
+                        output.log(c(`       ${loc.description}`, 'dim'));
+                    }
+                }
+            }
+            else if (args[0] === 'issues') {
+                // List detected inefficiencies
+                if (!traceCollector) {
+                    output.log(c('Tracing is not enabled.', 'yellow'));
+                    break;
+                }
+                const data = traceCollector.getSessionTrace();
+                if (!data || !data.iterations || data.iterations.length === 0) {
+                    output.log(c('No trace data to analyze.', 'dim'));
+                    break;
+                }
+                const { createTraceSummaryGenerator } = await import('../analysis/trace-summary.js');
+                const generator = createTraceSummaryGenerator(data);
+                const summary = generator.generate();
+                if (summary.anomalies.length === 0) {
+                    output.log(c('No issues detected in current session.', 'green'));
+                }
+                else {
+                    output.log(c('\nDetected Issues:', 'bold'));
+                    summary.anomalies.forEach((anomaly, i) => {
+                        const icon = anomaly.severity === 'high' ? c('!', 'red') :
+                            anomaly.severity === 'medium' ? c('*', 'yellow') : c('-', 'dim');
+                        output.log(`  ${icon} ${i + 1}. ${anomaly.type} (${anomaly.severity})`);
+                        output.log(`       ${anomaly.description}`);
+                    });
+                }
+            }
+            else if (args[0] === 'fixes') {
+                // List pending improvements from feedback loop
+                try {
+                    const { createFeedbackLoopManager } = await import('../analysis/feedback-loop.js');
+                    const feedbackManager = createFeedbackLoopManager();
+                    const pendingFixes = feedbackManager.getPendingFixes();
+                    const stats = feedbackManager.getSummaryStats();
+                    output.log(`
+${c('Feedback Loop Summary:', 'bold')}
+  Total analyses:     ${stats.totalAnalyses}
+  Avg efficiency:     ${stats.avgEfficiencyScore}%
+  Total fixes:        ${stats.totalFixes}
+  Implemented:        ${stats.implementedFixes}
+  Verified:           ${stats.verifiedFixes}
+  Avg improvement:    ${stats.avgImprovement}%
+`);
+                    if (pendingFixes.length === 0) {
+                        output.log(c('No pending fixes.', 'dim'));
+                    }
+                    else {
+                        output.log(c('Pending Fixes:', 'bold'));
+                        for (const fix of pendingFixes.slice(0, 10)) {
+                            output.log(`  - ${fix.description}`);
+                            output.log(c(`    ID: ${fix.id} | Created: ${new Date(fix.createdAt).toLocaleDateString()}`, 'dim'));
+                        }
+                        if (pendingFixes.length > 10) {
+                            output.log(c(`  ... and ${pendingFixes.length - 10} more`, 'dim'));
+                        }
+                    }
+                    feedbackManager.close();
+                }
+                catch (error) {
+                    output.log(c(`Error loading feedback data: ${error.message}`, 'red'));
+                }
+            }
+            else if (args[0] === 'compare' && args.length >= 3) {
+                // Compare two sessions
+                output.log(c(`Comparing sessions: ${args[1]} vs ${args[2]}`, 'cyan'));
+                output.log(c('Use the trace dashboard for session comparison:', 'dim'));
+                output.log(c('  npm run dashboard', 'dim'));
+                output.log(c(`  Then visit: http://localhost:5173/compare?a=${args[1]}&b=${args[2]}`, 'dim'));
+            }
+            else if (args[0] === 'export') {
+                // Export current trace as JSON for LLM analysis
+                if (!traceCollector) {
+                    output.log(c('Tracing is not enabled.', 'yellow'));
+                    break;
+                }
+                const data = traceCollector.getSessionTrace();
+                if (!data) {
+                    output.log(c('No trace data to export.', 'dim'));
+                    break;
+                }
+                const { createTraceSummaryGenerator } = await import('../analysis/trace-summary.js');
+                const generator = createTraceSummaryGenerator(data);
+                const summary = generator.generate();
+                const outFile = args[1] || `trace-${sessionId}.json`;
+                const { writeFile } = await import('fs/promises');
+                await writeFile(outFile, JSON.stringify(summary, null, 2), 'utf-8');
+                output.log(c(`+ Trace exported to: ${outFile}`, 'green'));
+                output.log(c('  This JSON is optimized for LLM analysis (~4000 tokens)', 'dim'));
+            }
+            else {
+                output.log(c('Usage:', 'bold'));
+                output.log(c('  /trace              - Show current session trace summary', 'dim'));
+                output.log(c('  /trace --analyze    - Run efficiency analysis', 'dim'));
+                output.log(c('  /trace issues       - List detected inefficiencies', 'dim'));
+                output.log(c('  /trace fixes        - List pending improvements', 'dim'));
+                output.log(c('  /trace export [file]- Export trace JSON for LLM analysis', 'dim'));
+                output.log(c('  /trace compare <a> <b> - Compare two sessions (via dashboard)', 'dim'));
+            }
+            break;
+        }
+        // =========================================================================
         // UNKNOWN COMMAND
         // =========================================================================
         default: