agent-nuvira 1.14.0

package/dist/cli/learn.js

@@ -0,0 +1,320 @@
+/**
+ * LearnCommand — CLI interface for the self-improvement system.
+ *
+ * Subcommands:
+ *   buff learn stats         — Show agent performance stats
+ *   buff learn patterns      — Show/extract coding patterns
+ *   buff learn optimize      — Generate optimized model routing
+ *   buff learn status        — Show overall self-improvement status
+ *   buff learn clear         — Reset learning data
+ *   buff learn compare       — A/B model comparison via benchmarks
+ *   buff learn feedback      — Rate a trajectory or view feedback stats
+ *   buff learn quality       — Show pattern quality and decay metrics
+ *   buff learn gc            — Garbage-collect low-quality patterns
+ */
+import { Command } from 'commander';
+import { getAgentStats } from '../learning/agent-stats.js';
+import { getSelfImprover } from '../learning/self-improver.js';
+import { getPatternStore } from '../learning/pattern-extractor.js';
+import { getFeedbackStore } from '../learning/feedback.js';
+import { compareModelRuns, findBestModelForAgent, formatComparisonResult, formatBenchmarkRecommendations, } from '../learning/model-compare.js';
+import { getBenchmarkRuns } from '../learning/benchmark.js';
+import { ConfigManager } from '../config/manager.js';
+import { ProviderFactory } from '../inference/factory.js';
+import { logger } from '../utils/logger.js';
+export class LearnCommand {
+    configManager;
+    constructor(configManager) {
+        this.configManager = configManager ?? new ConfigManager();
+    }
+    create() {
+        const cmd = new Command('learn')
+            .description('Self-improvement system — agent stats, patterns, and optimization');
+        cmd
+            .command('stats')
+            .description('Show per-agent performance statistics')
+            .action(() => this.showStats());
+        cmd
+            .command('patterns')
+            .description('Show extracted coding patterns')
+            .option('--extract', 'Force pattern extraction from stored trajectories')
+            .option('--provider <provider>', 'Provider to use for LLM calls during extraction')
+            .option('--model <model>', 'Model to use for extraction')
+            .action((opts) => this.showPatterns(opts));
+        cmd
+            .command('optimize')
+            .description('Generate optimized model-to-agent routing recommendations')
+            .action(() => this.showOptimizations());
+        cmd
+            .command('status')
+            .description('Show overall self-improvement status')
+            .action(() => this.showStatus());
+        cmd
+            .command('clear')
+            .description('Reset all learning data (stats, patterns, memory)')
+            .option('-f, --force', 'Skip confirmation prompt')
+            .action((opts) => this.clearData(opts));
+        // ── Phase 2.5: New subcommands ─────────────────────────────────────
+        cmd
+            .command('compare')
+            .description('Compare benchmark results between two models')
+            .option('--last', 'Compare the last two benchmark runs', false)
+            .option('--all', 'Show all benchmark-driven model recommendations', false)
+            .action(async (opts) => this.compareModels(opts));
+        cmd
+            .command('feedback')
+            .description('Rate a trajectory or view feedback statistics')
+            .option('--trajectory <id>', 'Trajectory ID to rate')
+            .option('--rating <positive|negative|neutral|skip>', 'Your rating')
+            .option('--comment <text>', 'Optional comment on your rating')
+            .option('--stats', 'Show feedback statistics', false)
+            .action(async (opts) => this.handleFeedback(opts));
+        cmd
+            .command('quality')
+            .description('Show pattern quality and decay metrics')
+            .option('--details', 'Show detailed per-pattern metrics', false)
+            .action((opts) => this.showQuality(opts));
+        cmd
+            .command('gc')
+            .description('Garbage-collect low-quality patterns')
+            .option('-n, --dry-run', 'Show what would be removed without removing', false)
+            .action(async (opts) => this.garbageCollect(opts));
+        return cmd;
+    }
+    // ── Action handlers ───────────────────────────────────────────────────
+    showStats() {
+        const stats = getAgentStats();
+        console.log(stats.formatStats());
+        const recommendations = stats.formatModelRecommendations();
+        if (recommendations.includes('→')) {
+            console.log('');
+            console.log(recommendations);
+        }
+    }
+    async showPatterns(opts) {
+        const patternStore = getPatternStore();
+        const patterns = patternStore.getAll();
+        if (opts.extract) {
+            console.log('🔄 Extracting patterns from stored trajectories...\n');
+            const providerType = (opts.provider || this.configManager.getAll().defaultProvider);
+            const { config } = this.configManager.getProviderConfig(providerType);
+            const provider = ProviderFactory.createProvider(providerType, config);
+            const callLLM = async (prompt) => {
+                const result = await provider.generate(prompt, {
+                    model: opts.model || config.model,
+                    temperature: 0.3,
+                    maxTokens: 4096,
+                });
+                return result;
+            };
+            const improver = getSelfImprover();
+            const count = await improver.extractPatterns(callLLM, true);
+            improver.resetExtractionCounter();
+            if (count === 0) {
+                console.log('   No new patterns extracted. Check that trajectories exist and have scores above 0.7.');
+            }
+            return;
+        }
+        if (patterns.length === 0) {
+            console.log('📝 No patterns found. Run with `--extract` to generate patterns from stored trajectories.');
+            return;
+        }
+        console.log(`📝 ${patterns.length} Coding Pattern(s)\n`);
+        for (let i = 0; i < patterns.length; i++) {
+            const p = patterns[i];
+            console.log(`${'─'.repeat(50)}`);
+            console.log(`Pattern ${i + 1}: ${p.title}`);
+            console.log(`   Domains: ${p.applicableDomains.join(', ')}`);
+            console.log(`   Source trajectories: ${p.sourceCount}`);
+            console.log(`   Avg source score: ${(p.avgSourceScore * 100).toFixed(0)}%`);
+            console.log(`   Usage: ${p.usageCount} time(s)`);
+            console.log('');
+            console.log(`   ${p.description}`);
+            console.log('');
+            console.log(`   Common files: ${p.commonFiles.join(', ')}`);
+            console.log(`   Agent sequence: ${p.commonAgentSequence.join(' → ')}`);
+        }
+        console.log(`${'─'.repeat(50)}`);
+    }
+    showOptimizations() {
+        const improver = getSelfImprover();
+        const modelMap = improver.getOptimizedModelMap();
+        if (Object.keys(modelMap).length === 0) {
+            console.log('🤖 No optimization data yet. Run some agent tasks first to collect performance stats.');
+            return;
+        }
+        console.log('🤖 Optimized Model Recommendations\n');
+        for (const [agentType, model] of Object.entries(modelMap)) {
+            console.log(`   ${agentType.padEnd(20)} → ${model}`);
+        }
+        console.log('\nTo use these recommendations, pass:');
+        console.log('   `--auto-route` to the execute command, or');
+        console.log('   Configure them in your workflow template\'s recommendedModels.');
+    }
+    showStatus() {
+        const improver = getSelfImprover();
+        console.log(improver.getStatus());
+        // Also show feedback stats if available
+        const feedbackStore = getFeedbackStore();
+        const feedbackStats = feedbackStore.getStats();
+        if (feedbackStats.totalRatings > 0) {
+            console.log('');
+            console.log('── User Feedback ──');
+            console.log(`   Total ratings: ${feedbackStats.totalRatings}`);
+            console.log(`   Positive: ${(feedbackStats.positiveRatio * 100).toFixed(0)}%`);
+            console.log(`   Negative: ${(feedbackStats.negativeRatio * 100).toFixed(0)}%`);
+            console.log(`   Trend: ${feedbackStats.recentTrend}`);
+        }
+        // Show pattern quality stats
+        const patternStore = getPatternStore();
+        const allPatterns = patternStore.getAll();
+        if (allPatterns.length > 0) {
+            const qualityReport = patternStore.getQualityReport();
+            const lowQuality = qualityReport.filter((q) => q.decayScore < 0.5);
+            if (lowQuality.length > 0) {
+                console.log('');
+                console.log('── Pattern Quality ──');
+                console.log(`   ${lowQuality.length}/${allPatterns.length} patterns below 0.5 decay score`);
+                console.log('   Run `buff learn gc` to clean up low-quality patterns.');
+            }
+        }
+    }
+    clearData(opts) {
+        if (!opts.force) {
+            logger.warn('Use `--force` to confirm clearing all learning data.');
+            logger.warn('This will reset agent stats, patterns, feedback, and trajectory memory.');
+            return;
+        }
+        getAgentStats().clear();
+        getPatternStore().clear();
+        getFeedbackStore().clear();
+        getSelfImprover().resetExtractionCounter();
+        logger.success('All learning data cleared.');
+    }
+    // ── Phase 2.5: New handlers ──────────────────────────────────────────
+    async compareModels(opts) {
+        const runs = getBenchmarkRuns();
+        if (runs.length < 2) {
+            console.log('⚔️ Need at least 2 benchmark runs to compare models.');
+            console.log('   Run `buff benchmark` against different models first.');
+            return;
+        }
+        if (opts.last) {
+            // Compare the last two runs
+            const result = compareModelRuns(runs[0], runs[1]);
+            console.log(formatComparisonResult(result));
+            return;
+        }
+        if (opts.all) {
+            // Show all benchmark-driven routing recommendations
+            const agentTypes = ['planner', 'writer', 'reviewer', 'tester', 'debugger', 'context-gatherer'];
+            const recommendations = agentTypes.map((type) => findBestModelForAgent(type));
+            console.log(formatBenchmarkRecommendations(recommendations));
+            return;
+        }
+        // Default: compare last two and show routing recommendations
+        console.log('⚔️ Comparing last two benchmark runs...\n');
+        const result = compareModelRuns(runs[0], runs[1]);
+        console.log(formatComparisonResult(result));
+        console.log('\n📊 Benchmark-driven routing recommendations:\n');
+        const agentTypes = ['planner', 'writer', 'reviewer', 'tester', 'debugger', 'context-gatherer'];
+        const recommendations = agentTypes.map((type) => findBestModelForAgent(type));
+        console.log(formatBenchmarkRecommendations(recommendations));
+    }
+    async handleFeedback(opts) {
+        const feedbackStore = getFeedbackStore();
+        if (opts.stats) {
+            const stats = feedbackStore.getStats();
+            console.log('📊 User Feedback Statistics\n');
+            console.log(`   Total ratings: ${stats.totalRatings}`);
+            console.log(`   Positive:      ${(stats.positiveRatio * 100).toFixed(1)}%`);
+            console.log(`   Negative:      ${(stats.negativeRatio * 100).toFixed(1)}%`);
+            console.log(`   Neutral:       ${(stats.neutralRatio * 100).toFixed(1)}%`);
+            console.log(`   Recent trend:  ${stats.recentTrend}`);
+            if (stats.totalRatings > 0) {
+                const recent = feedbackStore.getAll().slice(-5).reverse();
+                console.log('\n   Recent ratings:');
+                for (const entry of recent) {
+                    const icon = entry.rating === 'positive' ? '👍' : entry.rating === 'negative' ? '👎' : '➖';
+                    console.log(`     ${icon} ${entry.goal.slice(0, 50)} — ${entry.model}`);
+                }
+            }
+            return;
+        }
+        // Rate a specific trajectory
+        if (opts.trajectory && opts.rating) {
+            const validRatings = ['positive', 'negative', 'neutral', 'skip'];
+            if (!validRatings.includes(opts.rating)) {
+                logger.error(`Invalid rating: ${opts.rating}. Use: positive, negative, neutral, or skip.`);
+                return;
+            }
+            feedbackStore.record(opts.trajectory, opts.rating, {
+                goal: opts.trajectory,
+                provider: 'unknown',
+                model: 'unknown',
+                comment: opts.comment,
+            });
+            logger.success(`Rating recorded: ${opts.rating} for trajectory ${opts.trajectory.slice(0, 12)}...`);
+            return;
+        }
+        // Show help
+        console.log('📝 Feedback commands:\n');
+        console.log('  buff learn feedback --stats              Show feedback statistics');
+        console.log('  buff learn feedback --trajectory <id>    Rate a specific trajectory');
+        console.log('             --rating positive             Set rating (positive/negative/neutral/skip)');
+        console.log('             --comment "your notes"        Add optional comment');
+        console.log('');
+    }
+    async showQuality(opts) {
+        const patternStore = getPatternStore();
+        const patterns = patternStore.getAll();
+        if (patterns.length === 0) {
+            console.log('📝 No patterns to evaluate.');
+            return;
+        }
+        const qualityReport = patternStore.getQualityReport();
+        const avgDecay = qualityReport.reduce((sum, q) => sum + q.decayScore, 0) / qualityReport.length;
+        console.log('📊 Pattern Quality Report\n');
+        console.log(`   Total patterns: ${patterns.length}`);
+        console.log(`   Average decay score: ${(avgDecay * 100).toFixed(1)}%`);
+        console.log(`   Healthy (≥ 0.5): ${qualityReport.filter((q) => q.decayScore >= 0.5).length}`);
+        console.log(`   Needs attention (< 0.5): ${qualityReport.filter((q) => q.decayScore < 0.5).length}`);
+        console.log(`   Candidates for removal (< ${0.2}): ${qualityReport.filter((q) => q.decayScore < 0.2).length}`);
+        console.log('');
+        if (opts.details) {
+            console.log('   Per-pattern details:\n');
+            for (const q of qualityReport.sort((a, b) => a.decayScore - b.decayScore)) {
+                const bar = '█'.repeat(Math.round(q.decayScore * 20));
+                const remaining = '░'.repeat(20 - Math.round(q.decayScore * 20));
+                console.log(`   ${(q.decayScore * 100).toFixed(0).padStart(3)}% ${bar}${remaining}  ${q.title.slice(0, 40).padEnd(40)} used ${q.usageCount}x, ${q.ageDays}d old`);
+            }
+        }
+        console.log('');
+        console.log('   Run `buff learn gc` to remove low-quality patterns.');
+    }
+    async garbageCollect(opts) {
+        const patternStore = getPatternStore();
+        if (opts.dryRun) {
+            const qualityReport = patternStore.getQualityReport();
+            const candidates = qualityReport.filter((q) => q.decayScore < 0.2);
+            if (candidates.length === 0) {
+                console.log('✅ No patterns need garbage collection.');
+                return;
+            }
+            console.log('🔍 Dry run: would remove these patterns:\n');
+            for (const q of candidates) {
+                console.log(`   ❌ ${q.title} (score: ${(q.decayScore * 100).toFixed(0)}%)`);
+            }
+            console.log(`\n   Total: ${candidates.length} pattern(s) would be removed.`);
+            return;
+        }
+        const removed = patternStore.garbageCollect();
+        if (removed === 0) {
+            console.log('✅ All patterns have acceptable quality scores. No garbage collection needed.');
+        }
+        else {
+            logger.success(`Garbage collection removed ${removed} low-quality pattern(s).`);
+        }
+    }
+}
+//# sourceMappingURL=learn.js.map

package/dist/cli/learn.js.map

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

package/dist/cli/memory.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Memory command — Manage agent memory store with compression and pruning.
+ *
+ * Usage:
+ *   buff memory                    — Show memory usage statistics
+ *   buff memory stats              — Show detailed memory store statistics
+ *   buff memory optimize           — Run automatic compression + pruning
+ *   buff memory optimize --dry-run — Show what would be done without doing it
+ *   buff memory optimize --aggressive — More aggressive compression (14d retention, 0.2 min score)
+ *   buff memory prune              — Prune old/low-quality trajectories
+ *   buff memory prune --max-age 30 — Remove trajectories older than 30 days
+ *   buff memory prune --min-score 0.2 — Remove trajectories with score below 0.2
+ *   buff memory prune --max-count 200 — Keep at most 200 trajectories
+ *   buff memory summarize          — Summarize old trajectories by project fingerprint
+ *   buff memory summarize --retention 14 — Keep originals newer than 14 days
+ *   buff memory clear              — Clear all stored trajectories
+ *   buff memory info               — Show detailed compression analysis
+ *
+ * The memory optimization system provides:
+ * - Configurable retention policy (age-based, score-based, count-based)
+ * - Automatic trajectory summarization (merges similar old trajectories)
+ * - Dry-run mode to preview changes before applying
+ * - Aggressive mode for maximum space savings
+ * - Detailed memory usage statistics
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export declare class MemoryCommand extends BaseCommand {
+    create(): Command;
+    private showStats;
+    private optimize;
+    private prune;
+    private summarize;
+    private showInfo;
+    private clearMemory;
+    private formatBytes;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/cli/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/cli/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ5C,qBAAa,aAAc,SAAQ,WAAW;IAC5C,MAAM,IAAI,OAAO;YA4EH,SAAS;YA4DT,QAAQ;YAgER,KAAK;YAgCL,SAAS;YAwBT,QAAQ;YA4CR,WAAW;IAmBzB,OAAO,CAAC,WAAW;CAKpB"}