claude-mycelium 2.0.0 → 2.2.0

package/dist/agent/task-worker.js

@@ -0,0 +1,173 @@
+/**
+ * Task Worker Process
+ *
+ * Independent agent process spawned for a specific task step.
+ * Integrates with the full mycelium system: file locks, inhibitors,
+ * quarantine, and the complete executeAgent() RALPH cycle.
+ *
+ * This runs as a separate Node.js process via child_process.fork()
+ */
+import { executeAgent } from '../core/agent-executor.js';
+import { tryAcquireLock, releaseLock } from '../coordination/file-locks.js';
+import { isQuarantined, recordExplorerAttempt } from '../quarantine/manager.js';
+import { logDebug, logError, logInfo } from '../utils/logger.js';
+/**
+ * Parse task context from environment variables
+ */
+function getTaskContext() {
+    const agentId = process.env.AGENT_ID;
+    const taskId = process.env.TASK_ID;
+    const stepOrder = process.env.STEP_ORDER;
+    const targetFile = process.env.TARGET_FILE;
+    const mode = process.env.MODE;
+    const description = process.env.STEP_DESCRIPTION;
+    if (!agentId || !taskId || !stepOrder || !targetFile || !mode) {
+        throw new Error('Missing required environment variables for task worker');
+    }
+    return {
+        agentId,
+        taskId,
+        stepOrder: parseInt(stepOrder, 10),
+        targetFile,
+        mode: mode,
+        description: description || '',
+    };
+}
+/**
+ * Send IPC message to parent process
+ */
+function sendMessage(type, data) {
+    if (process.send) {
+        process.send({ type, ...data });
+    }
+}
+/**
+ * Main worker execution
+ */
+async function main() {
+    let lockAcquired = false;
+    let lockId;
+    try {
+        const context = getTaskContext();
+        logInfo('Task worker started', {
+            agentId: context.agentId,
+            taskId: context.taskId,
+            stepOrder: context.stepOrder,
+            targetFile: context.targetFile,
+            mode: context.mode,
+        });
+        sendMessage('progress', {
+            message: `Starting work on ${context.targetFile}`,
+        });
+        // Check if file is quarantined
+        if (await isQuarantined(context.targetFile)) {
+            // Only explorer mode can work on quarantined files
+            if (context.mode === 'explorer') {
+                logInfo('Explorer mode working on quarantined file', {
+                    file: context.targetFile,
+                });
+                await recordExplorerAttempt(context.targetFile);
+            }
+            else {
+                logInfo('File is quarantined, skipping', {
+                    file: context.targetFile,
+                    mode: context.mode,
+                });
+                sendMessage('result', {
+                    success: false,
+                    error: `File ${context.targetFile} is quarantined. Only explorer mode can work on it.`,
+                });
+                process.exit(1);
+            }
+        }
+        // Try to acquire file lock
+        logDebug('Attempting to acquire lock', {
+            file: context.targetFile,
+            agentId: context.agentId,
+        });
+        const lockResult = await tryAcquireLock(context.targetFile, {
+            agent_id: context.agentId,
+            task_id: context.taskId,
+            mode: context.mode,
+        });
+        if (!lockResult.acquired) {
+            logInfo('Lock acquisition failed', {
+                file: context.targetFile,
+                reason: lockResult.reason,
+            });
+            sendMessage('result', {
+                success: false,
+                error: `Could not acquire lock: ${lockResult.reason}`,
+            });
+            process.exit(1);
+        }
+        lockAcquired = true;
+        lockId = lockResult.lockId;
+        logInfo('Lock acquired', {
+            file: context.targetFile,
+            lockId,
+        });
+        sendMessage('progress', {
+            message: 'Lock acquired, executing agent cycle',
+        });
+        // Execute the full agent cycle (RALPH loop)
+        // This includes:
+        // - Reading file and calculating gradient
+        // - Building prompt with inhibitors
+        // - Calling LLM
+        // - Applying changes
+        // - Running CI validation
+        // - Recording trace
+        // - Emitting inhibitors on failure
+        const result = await executeAgent(context.targetFile, context.mode, {
+            dryRun: false,
+            agentId: context.agentId,
+            taskId: context.taskId,
+        });
+        logInfo('Agent execution complete', {
+            file: context.targetFile,
+            success: result.success,
+            traceId: result.trace?.id,
+        });
+        // Send result back to coordinator
+        sendMessage('result', {
+            success: result.success,
+            traceId: result.trace?.id,
+            error: result.error,
+        });
+        // Clean exit
+        process.exit(result.success ? 0 : 1);
+    }
+    catch (error) {
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        logError('Task worker failed', errorObj, {
+            agentId: process.env.AGENT_ID,
+        });
+        sendMessage('result', {
+            success: false,
+            error: errorObj.message,
+        });
+        process.exit(1);
+    }
+    finally {
+        // Always release lock if we acquired it
+        if (lockAcquired && lockId) {
+            try {
+                const targetFile = process.env.TARGET_FILE;
+                if (targetFile) {
+                    await releaseLock(targetFile, lockId);
+                    logDebug('Lock released', { file: targetFile, lockId });
+                }
+            }
+            catch (error) {
+                logError('Failed to release lock', error, { lockId });
+            }
+        }
+    }
+}
+// Run the worker
+main().catch((error) => {
+    console.error('Fatal error in task worker:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=task-worker.js.map

package/dist/agent/task-worker.js.map

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

package/dist/agent/worker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agent Worker Process Entry Point
+ * Each agent runs as an independent Node.js process
+ *
+ * Reference: ADR-004 lines 30-45
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/agent/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/agent/worker.js

@@ -0,0 +1,97 @@
+/**
+ * Agent Worker Process Entry Point
+ * Each agent runs as an independent Node.js process
+ *
+ * Reference: ADR-004 lines 30-45
+ */
+// import { readGradientCache } from '../coordination/gradient-cache.js'; // TODO: Implement readGradientCache
+/**
+ * Main agent worker loop
+ */
+async function main() {
+    const agentId = process.env.AGENT_ID;
+    const maxIterations = parseInt(process.env.MAX_ITERATIONS ?? '10', 10);
+    if (!agentId) {
+        console.error('[worker] AGENT_ID environment variable not set');
+        process.exit(1);
+    }
+    console.log(`[${agentId}] Starting with max ${maxIterations} iterations`);
+    let iterations = 0;
+    while (iterations < maxIterations) {
+        try {
+            // 1. Read gradient cache
+            // const cache = await readGradientCache();  // TODO: Implement readGradientCache
+            const cache = null; // Temporary workaround
+            if (!cache) {
+                console.log(`[${agentId}] No gradient cache available. Exiting.`);
+                break;
+            }
+            // 2. Find unlocked target with highest gradient
+            // const target = findUnlockedTarget(cache.gradients);  // TODO: Fix when readGradientCache is implemented
+            const target = null; // Temporary workaround
+            if (!target) {
+                console.log(`[${agentId}] No unlocked work available. Exiting.`);
+                break;
+            }
+            // TODO: The following code is disabled until readGradientCache is implemented
+            /*
+            // 3. Try to acquire lock
+            const locked = await acquireLock(target.file, agentId, 'error_reducer');
+      
+            if (!locked) {
+              console.log(`[${agentId}] ${target.file} locked by another agent. Retrying...`);
+              iterations++;
+              continue;
+            }
+      
+            console.log(`[${agentId}] Acquired lock on ${target.file}`);
+      
+            try {
+              // 4. Execute work (stub for Phase 3)
+              console.log(`[${agentId}] Would process ${target.file} here`);
+      
+              // Simulate work
+              await new Promise((resolve) => setTimeout(resolve, 100));
+      
+              console.log(`[${agentId}] Completed work on ${target.file}`);
+            } finally {
+              // 5. Release lock
+              await releaseLock(target.file);
+              console.log(`[${agentId}] Released lock on ${target.file}`);
+            }
+            */
+            iterations++;
+        }
+        catch (error) {
+            console.error(`[${agentId}] Error in iteration ${iterations}:`, error);
+            iterations++;
+        }
+    }
+    console.log(`[${agentId}] Completed ${iterations} iterations. Exiting.`);
+    process.exit(0);
+}
+/**
+ * Find highest gradient file that isn't locked
+ * Stub implementation for Phase 3 - TODO: Enable when readGradientCache is implemented
+ */
+/*
+function findUnlockedTarget(gradients: any[]): { file: string; score: number } | null {
+  if (!gradients || gradients.length === 0) {
+    return null;
+  }
+
+  // Sort by score descending
+  const sorted = [...gradients].sort((a, b) => b.score - a.score);
+
+  // For Phase 3, just return the highest
+  // In Phase 4, we'll check lock status
+  return sorted[0] ? { file: sorted[0].file, score: sorted[0].score } : null;
+}
+*/
+// Run the worker
+main().catch((error) => {
+    console.error('[worker] Fatal error:', error);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=worker.js.map

package/dist/agent/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,8GAA8G;AAE9G;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrC,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAEvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,uBAAuB,aAAa,aAAa,CAAC,CAAC;IAE1E,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO,UAAU,GAAG,aAAa,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,yBAAyB;YACzB,iFAAiF;YACjF,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,uBAAuB;YAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,yCAAyC,CAAC,CAAC;gBAClE,MAAM;YACR,CAAC;YAED,gDAAgD;YAChD,0GAA0G;YAC1G,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,uBAAuB;YAE5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,wCAAwC,CAAC,CAAC;gBACjE,MAAM;YACR,CAAC;YAED,8EAA8E;YAC9E;;;;;;;;;;;;;;;;;;;;;;;;;cAyBE;YAEF,UAAU,EAAE,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,wBAAwB,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;YACvE,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,eAAe,UAAU,uBAAuB,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH;;;;;;;;;;;;;EAaE;AAEF,iBAAiB;AACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bin.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ * Executable entry point for claude-mycelium CLI
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ * Executable entry point for claude-mycelium CLI
+ */
+import { execute } from './cli/index.js';
+execute().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/cost.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cost CLI Command
+ *
+ * Display spending report with daily summaries
+ * Show efficiency trends
+ */
+import { Command } from 'commander';
+declare const command: Command;
+export default command;
+//# sourceMappingURL=cost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/cli/cost.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,QAAA,MAAM,OAAO,SA6ET,CAAC;AAuHL,eAAe,OAAO,CAAC"}

package/dist/cli/cost.js

@@ -0,0 +1,163 @@
+/**
+ * Cost CLI Command
+ *
+ * Display spending report with daily summaries
+ * Show efficiency trends
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+const command = new Command()
+    .name('cost')
+    .description('Show spending report and efficiency trends')
+    .option('--days <number>', 'Show data for last N days', '30')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const days = parseInt(options.days, 10) || 30;
+        const summary = await generateCostSummary(days);
+        if (options.json) {
+            console.log(JSON.stringify(summary, null, 2));
+            return;
+        }
+        // Colorized output
+        console.log('');
+        console.log(chalk.bold('Cost Report (Last ' + days + ' days)'));
+        console.log(chalk.dim('─'.repeat(80)));
+        // Overall totals
+        console.log(chalk.bold('Overall:'));
+        console.log(`  Total cost: ${chalk.yellow('$' + summary.total_usd.toFixed(2))}`);
+        console.log(`  Total tokens in: ${summary.total_tokens_in.toLocaleString()}`);
+        console.log(`  Total tokens out: ${summary.total_tokens_out.toLocaleString()}`);
+        console.log(`  Avg cost per run: ${chalk.yellow('$' + summary.avg_cost_per_run.toFixed(4))}`);
+        console.log(`  Avg cost per improvement: ${chalk.yellow('$' + summary.avg_cost_per_improvement.toFixed(4))}`);
+        // Trend
+        const trendColor = summary.cost_efficiency_trend === 'improving'
+            ? 'green'
+            : summary.cost_efficiency_trend === 'stable'
+                ? 'yellow'
+                : 'red';
+        console.log(`  Trend: ${chalk[trendColor](summary.cost_efficiency_trend)}`);
+        console.log(chalk.dim('─'.repeat(80)));
+        // Daily breakdown
+        if (summary.daily.length > 0) {
+            console.log(chalk.bold('Daily Breakdown:'));
+            console.log(chalk.gray(`${'Date'.padEnd(12)} ${'Runs'.padStart(6)} ${'Cost'.padStart(12)} ${'Eff.'.padStart(8)}`));
+            for (const day of summary.daily.slice(-7)) {
+                const costStr = ('$' + day.total_cost_usd.toFixed(2)).padStart(12);
+                const effStr = (day.avg_efficiency.toFixed(3)).padStart(8);
+                console.log(`${day.date.padEnd(12)} ${String(day.runs).padStart(6)} ${costStr} ${effStr}`);
+            }
+        }
+        console.log('');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk.red(`Error: ${message}`));
+        process.exit(1);
+    }
+});
+/**
+ * Generate cost summary from trace events
+ */
+async function generateCostSummary(days) {
+    const tracesDir = '.agent-meta/traces';
+    const now = Date.now();
+    const cutoffMs = days * 24 * 60 * 60 * 1000;
+    let traceFiles = [];
+    try {
+        const entries = await fs.readdir(tracesDir);
+        traceFiles = entries.filter(f => f.endsWith('.ndjson'));
+    }
+    catch {
+        // Traces directory doesn't exist
+    }
+    const events = [];
+    // Collect all trace events from last N days
+    for (const file of traceFiles) {
+        const filePath = path.join(tracesDir, file);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const lines = content.split('\n').filter(Boolean);
+            for (const line of lines) {
+                try {
+                    const event = JSON.parse(line);
+                    const ageMs = now - new Date(event.timestamp).getTime();
+                    if (ageMs < cutoffMs) {
+                        events.push(event);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        catch {
+            // File read error
+        }
+    }
+    // Calculate daily summaries
+    const byDate = new Map();
+    for (const event of events) {
+        const date = new Date(event.timestamp).toISOString().split('T')[0];
+        if (!byDate.has(date)) {
+            byDate.set(date, []);
+        }
+        byDate.get(date).push(event);
+    }
+    const daily = [];
+    let totalCost = 0;
+    let totalTokensIn = 0;
+    let totalTokensOut = 0;
+    let totalEfficiency = 0;
+    let improvementCount = 0;
+    for (const [date, dayEvents] of Array.from(byDate).sort()) {
+        const cost = dayEvents.reduce((sum, e) => sum + e.cost.estimated_usd, 0);
+        const tokensIn = dayEvents.reduce((sum, e) => sum + e.cost.tokens_in, 0);
+        const tokensOut = dayEvents.reduce((sum, e) => sum + e.cost.tokens_out, 0);
+        const avgEff = dayEvents.reduce((sum, e) => sum + e.efficiency, 0) / dayEvents.length;
+        const improvements = dayEvents.filter(e => e.gradient_delta > 0).length;
+        const dayData = {
+            date,
+            runs: dayEvents.length,
+            total_cost_usd: cost,
+            total_tokens_in: tokensIn,
+            total_tokens_out: tokensOut,
+            avg_efficiency: avgEff,
+            cost_per_improvement: improvements > 0 ? cost / improvements : cost,
+        };
+        daily.push(dayData);
+        totalCost += cost;
+        totalTokensIn += tokensIn;
+        totalTokensOut += tokensOut;
+        totalEfficiency += avgEff;
+        improvementCount += improvements;
+    }
+    // Calculate trend (compare first half vs second half)
+    let trend = 'stable';
+    if (daily.length >= 2) {
+        const mid = Math.floor(daily.length / 2);
+        const firstHalf = daily.slice(0, mid);
+        const secondHalf = daily.slice(mid);
+        const firstAvgEff = firstHalf.reduce((sum, d) => sum + d.avg_efficiency, 0) / firstHalf.length;
+        const secondAvgEff = secondHalf.reduce((sum, d) => sum + d.avg_efficiency, 0) / secondHalf.length;
+        if (secondAvgEff > firstAvgEff * 1.1) {
+            trend = 'improving';
+        }
+        else if (secondAvgEff < firstAvgEff * 0.9) {
+            trend = 'degrading';
+        }
+    }
+    return {
+        total_usd: totalCost,
+        total_tokens_in: totalTokensIn,
+        total_tokens_out: totalTokensOut,
+        avg_cost_per_run: events.length > 0 ? totalCost / events.length : 0,
+        avg_cost_per_improvement: improvementCount > 0 ? totalCost / improvementCount : totalCost,
+        cost_efficiency_trend: trend,
+        daily,
+    };
+}
+export default command;
+//# sourceMappingURL=cost.js.map

package/dist/cli/cost.js.map

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

package/dist/cli/gc.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GC CLI Command
+ *
+ * Manual garbage collection trigger
+ * Show GC report and statistics
+ */
+import { Command } from 'commander';
+declare const command: Command;
+export default command;
+//# sourceMappingURL=gc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../src/cli/gc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,QAAA,MAAM,OAAO,SAkBT,CAAC;AA4GL,eAAe,OAAO,CAAC"}

package/dist/cli/gc.js

@@ -0,0 +1,108 @@
+/**
+ * GC CLI Command
+ *
+ * Manual garbage collection trigger
+ * Show GC report and statistics
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { runGC, readGCLog } from '../gc/runner.js';
+const command = new Command()
+    .name('gc')
+    .description('Run garbage collection manually')
+    .option('--json', 'Output as JSON')
+    .option('--history', 'Show GC history')
+    .action(async (options) => {
+    try {
+        if (options.history) {
+            await showGCHistory(options.json);
+            return;
+        }
+        await runGarbageCollection(options.json);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk.red(`Error: ${message}`));
+        process.exit(1);
+    }
+});
+/**
+ * Run garbage collection and show report
+ */
+async function runGarbageCollection(json = false) {
+    if (!json) {
+        console.log('');
+        console.log(chalk.bold('Running garbage collection...'));
+    }
+    const report = await runGC();
+    if (json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    // Display report
+    console.log(chalk.green('✓ GC completed'));
+    console.log('');
+    console.log(chalk.bold('Report:'));
+    console.log(`  Timestamp: ${report.timestamp}`);
+    console.log(`  Duration: ${report.duration_ms}ms`);
+    console.log(`  Size before: ${report.size_before_mb.toFixed(2)} MB`);
+    console.log(`  Size after: ${report.size_after_mb.toFixed(2)} MB`);
+    if (report.size_before_mb > 0) {
+        const saved = report.size_before_mb - report.size_after_mb;
+        const percent = ((saved / report.size_before_mb) * 100).toFixed(1);
+        console.log(`  Space saved: ${chalk.green(saved.toFixed(2) + ' MB')} (${percent}%)`);
+    }
+    console.log('');
+    console.log(chalk.bold('Actions:'));
+    console.log(`  Deleted items: ${report.deleted}`);
+    console.log(`  Compacted files: ${report.compacted}`);
+    if (report.errors.length > 0) {
+        console.log('');
+        console.log(chalk.yellow('Warnings:'));
+        for (const error of report.errors) {
+            console.log(`  - ${error}`);
+        }
+    }
+    console.log('');
+}
+/**
+ * Show GC history
+ */
+async function showGCHistory(json = false) {
+    const reports = await readGCLog();
+    if (json) {
+        console.log(JSON.stringify(reports, null, 2));
+        return;
+    }
+    if (reports.length === 0) {
+        console.log(chalk.yellow('No GC history found'));
+        return;
+    }
+    console.log('');
+    console.log(chalk.bold('GC History'));
+    console.log(chalk.dim('─'.repeat(80)));
+    console.log(chalk.gray(`${'Timestamp'.padEnd(25)} ${'Duration'.padStart(10)} ${'Deleted'.padStart(10)} ${'Space'.padStart(15)}`));
+    console.log(chalk.dim('─'.repeat(80)));
+    for (const report of reports.slice(-10)) {
+        const date = new Date(report.timestamp).toISOString().split('T')[0];
+        const time = new Date(report.timestamp).toISOString().split('T')[1].substring(0, 5);
+        const timestamp = `${date} ${time}`.padEnd(25);
+        const duration = `${report.duration_ms}ms`.padStart(10);
+        const deleted = String(report.deleted).padStart(10);
+        const saved = (report.size_before_mb - report.size_after_mb).toFixed(2);
+        const space = `${saved}MB`.padStart(15);
+        console.log(`${timestamp} ${duration} ${deleted} ${space}`);
+    }
+    console.log(chalk.dim('─'.repeat(80)));
+    // Summary statistics
+    const totalDeleted = reports.reduce((sum, r) => sum + r.deleted, 0);
+    const totalSaved = reports.reduce((sum, r) => sum + (r.size_before_mb - r.size_after_mb), 0);
+    const avgDuration = reports.reduce((sum, r) => sum + r.duration_ms, 0) / reports.length;
+    console.log(chalk.bold('Summary (all runs):'));
+    console.log(`  Total items deleted: ${totalDeleted}`);
+    console.log(`  Total space saved: ${totalSaved.toFixed(2)} MB`);
+    console.log(`  Average duration: ${avgDuration.toFixed(0)}ms`);
+    console.log('');
+}
+export default command;
+//# sourceMappingURL=gc.js.map

package/dist/cli/gc.js.map

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