@statforge/claudestat 1.6.1 → 1.8.0

package/dist/index.js

@@ -6,6 +6,39 @@
  * Suprimimos el ExperimentalWarning de node:sqlite antes de importar nada.
  * El módulo funciona perfectamente — el warning es solo informativo.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -20,8 +53,6 @@ const commander_1 = require("commander");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
-const daemon_1 = require("./daemon");
-const watchdog_1 = require("./watchdog");
 const watch_1 = require("./watch");
 const install_1 = require("./install");
 const service_1 = require("./service");
@@ -36,6 +67,18 @@ const quota_tracker_1 = require("./quota-tracker");
 const program = new commander_1.Command();
 const PKG_VERSION = JSON.parse(fs_1.default.readFileSync(path_1.default.join(__dirname, '..', 'package.json'), 'utf8')).version;
 const PID_FILE = (0, paths_1.getPidFile)();
+const PORT = (0, config_1.readConfig)().port;
+function semverGt(a, b) {
+    const [pa, pb] = [a.split('.').map(Number), b.split('.').map(Number)];
+    for (let i = 0; i < 3; i++) {
+        const aVal = pa[i] ?? 0, bVal = pb[i] ?? 0;
+        if (aVal > bVal)
+            return true;
+        if (aVal < bVal)
+            return false;
+    }
+    return false;
+}
 // ── Update notifier ────────────────────────────────────────────
 const SKIP_UPDATE_NOTICE = new Set(['start', 'stop', 'restart', 'watch']);
 const subcommand = process.argv[2];
@@ -64,7 +107,7 @@ if (!SKIP_UPDATE_NOTICE.has(subcommand)) {
     }
     const _exit = process.exit.bind(process);
     process.exit = ((code) => {
-        if ((code ?? 0) === 0 && cachedLatest && cachedLatest !== PKG_VERSION) {
+        if ((code ?? 0) === 0 && cachedLatest && semverGt(cachedLatest, PKG_VERSION)) {
             console.log(`\n  ✦ Update available: ${PKG_VERSION} → ${cachedLatest}`);
             console.log(`    Run: npm install -g @statforge/claudestat\n`);
         }
@@ -79,7 +122,7 @@ function spawnDaemon() {
     });
     child.unref();
     console.log(`✅ claudestat daemon started (pid ${child.pid})`);
-    console.log(`   Dashboard → http://localhost:7337`);
+    console.log(`   Dashboard → http://localhost:${PORT}`);
 }
 function removePidFile() {
     try {
@@ -89,7 +132,7 @@ function removePidFile() {
 }
 async function stopDaemon() {
     try {
-        const res = await fetch('http://localhost:7337/shutdown', {
+        const res = await fetch(`http://localhost:${PORT}/shutdown`, {
             method: 'POST',
             signal: AbortSignal.timeout(2000),
         });
@@ -166,18 +209,96 @@ program
     }
     process.exit(0);
 });
+program
+    .command('update')
+    .description('Check for updates and install the latest version from npm')
+    .option('--dry-run', 'Only check for updates, do not install')
+    .action(async (opts) => {
+    console.log('\n🔍 Checking for updates...');
+    const latest = await checkLatestVersion();
+    if (!latest) {
+        console.log('  ❌ Could not reach npm registry. Check your internet connection.\n');
+        process.exit(1);
+    }
+    if (!semverGt(latest, PKG_VERSION)) {
+        console.log(`  ✅ Already on latest version (${PKG_VERSION})\n`);
+        process.exit(0);
+    }
+    console.log(`  ✦ Update available: ${PKG_VERSION} → ${latest}`);
+    try {
+        const changelogPath = path_1.default.join(__dirname, '..', 'CHANGELOG.md');
+        const changelog = fs_1.default.readFileSync(changelogPath, 'utf8');
+        const sections = changelog.split(/^## /m).filter(Boolean);
+        const relevant = sections.filter(s => s.startsWith(`[${latest}]`) ||
+            (semverGt(s.split(']')[0].replace('[', ''), PKG_VERSION) &&
+                semverGt(latest, s.split(']')[0].replace('[', ''))));
+        if (relevant.length > 0) {
+            console.log('\n  📋 What\'s new:');
+            relevant.slice(0, 3).forEach(s => {
+                const lines = s.split('\n').slice(0, 6);
+                lines.forEach(l => console.log(`  ${l}`));
+            });
+        }
+    }
+    catch { }
+    if (opts.dryRun) {
+        console.log(`\n  Run \x1b[36mclaudestat update\x1b[0m to install.\n`);
+        process.exit(0);
+    }
+    console.log(`\n📦 Installing @statforge/claudestat@${latest}...`);
+    try {
+        (0, child_process_1.execSync)('npm install -g @statforge/claudestat', { stdio: 'inherit' });
+    }
+    catch {
+        console.error('\n❌ Installation failed. Try manually: npm install -g @statforge/claudestat\n');
+        process.exit(1);
+    }
+    console.log('\n🔗 Re-registering hooks...');
+    try {
+        const { installHooks } = await Promise.resolve().then(() => __importStar(require('./install')));
+        installHooks();
+    }
+    catch { }
+    console.log('\n🔄 Restarting daemon...');
+    try {
+        await stopDaemon().catch(() => { });
+        await new Promise(r => setTimeout(r, 500));
+        spawnDaemon();
+    }
+    catch { }
+    console.log(`\n✅ Updated to ${latest}. Run \x1b[36mclaudestat doctor\x1b[0m to verify.\n`);
+    process.exit(0);
+});
 program
     .command('start')
     .description('Start the background daemon (receives Claude Code hook events)')
     .option('--watchdog', 'Auto-restart daemon if it crashes')
-    .action((opts) => {
+    .option('--wait', 'Wait until daemon responds on /health before returning (max 10s)')
+    .action(async (opts) => {
     if (process.env.CLAUDESTAT_DAEMON) {
-        (0, daemon_1.startDaemon)();
-        if (opts.watchdog)
-            (0, watchdog_1.startWatchdog)();
+        const { startDaemon } = require('./daemon');
+        startDaemon();
+        if (opts.watchdog) {
+            const { startWatchdog } = require('./watchdog');
+            startWatchdog();
+        }
     }
     else {
         spawnDaemon();
+        if (opts.wait) {
+            const deadline = Date.now() + 10000;
+            while (Date.now() < deadline) {
+                await new Promise(r => setTimeout(r, 200));
+                try {
+                    const res = await fetch(`http://localhost:${PORT}/health`, { signal: AbortSignal.timeout(500) });
+                    if (res.ok) {
+                        console.log('✅ Daemon is ready');
+                        break;
+                    }
+                }
+                catch { }
+            }
+        }
         process.exit(0);
     }
 });
@@ -192,7 +313,21 @@ program
     .command('setup')
     .description('One-command setup: install hooks + register daemon as system service (auto-starts on login)')
     .option('--uninstall', 'Remove hooks and system service')
+    .option('--port <number>', 'Custom daemon port (default: 7337)')
+    .option('--reset', 'Reinstall from scratch (keeps SQLite history)')
     .action(async (opts) => {
+    if (opts.port) {
+        const p = parseInt(opts.port, 10);
+        if (!isNaN(p) && p >= 1024 && p <= 65535) {
+            const cfg = (0, config_1.readConfig)();
+            (0, config_1.writeConfig)({ ...cfg, port: p });
+            console.log(`✓ Port set to ${p}`);
+        }
+        else {
+            console.error('❌ Invalid port. Must be between 1024 and 65535.');
+            process.exit(1);
+        }
+    }
     if (opts.uninstall) {
         console.log('Uninstalling claudestat...');
         (0, service_1.uninstallService)();
@@ -201,10 +336,23 @@ program
         console.log('✅ claudestat fully removed');
         process.exit(0);
     }
+    if (opts.reset) {
+        console.log('\n🔄 Resetting claudestat installation...');
+        (0, service_1.uninstallService)();
+        (0, install_1.uninstallHooks)();
+        await stopDaemon().catch(() => { });
+        const cfgPath = path_1.default.join((0, paths_1.getClaudestatDir)(), 'config.json');
+        try {
+            fs_1.default.unlinkSync(cfgPath);
+        }
+        catch { }
+        console.log('  ✅ Hooks, service, and config removed (history preserved)');
+        console.log('  🔁 Starting fresh install...\n');
+    }
     // 1. Wizard: Node check + plan + config + hooks + MCP
     await (0, install_1.runWizard)();
     // 2. Start daemon now
-    const daemonRunning = await fetch('http://localhost:7337/health', {
+    const daemonRunning = await fetch(`http://localhost:${PORT}/health`, {
         signal: AbortSignal.timeout(2000),
     }).then(r => r.ok).catch(() => false);
     if (!daemonRunning) {
@@ -212,7 +360,7 @@ program
     }
     else {
         console.log('✅ Daemon already running');
-        console.log('   Dashboard → http://localhost:7337');
+        console.log(`   Dashboard → http://localhost:${PORT}`);
     }
     console.log('\n   Run \x1b[36mclaudestat watch\x1b[0m to see live activity');
     process.exit(0);
@@ -227,15 +375,16 @@ program
     .action(() => { (0, install_1.uninstallHooks)(); process.exit(0); });
 program
     .command('export [format]')
-    .description('Export session data (json | csv, default: json). Max 500 sessions.')
+    .description('Export session data (json | csv | markdown, default: json). Max 500 sessions.')
     .option('--from <date>', 'Start date YYYY-MM-DD (inclusive)')
     .option('--to <date>', 'End date YYYY-MM-DD (inclusive)')
+    .option('--since <period>', 'Shorthand: 7d, 30d, 90d (overrides --from)')
     .option('--project <name>', 'Filter by project path (case-insensitive substring)')
-    .option('--output <path>', 'Write to file instead of stdout')
+    .option('--output <path>', 'Write to file (default: stdout)')
     .action((format, opts) => {
     const fmt = (format ?? 'json').toLowerCase();
-    if (fmt !== 'json' && fmt !== 'csv') {
-        console.error('Error: format must be "json" or "csv"');
+    if (!['json', 'csv', 'markdown'].includes(fmt)) {
+        console.error('Error: format must be "json", "csv", or "markdown"');
         process.exit(1);
     }
     (0, export_1.runExport)({ format: fmt, ...opts });
@@ -249,8 +398,8 @@ program
     try {
         await (0, quota_tracker_1.refreshFromApi)(); // refresh disk cache on demand; daemon reads from disk
         const [quotaRes] = await Promise.all([
-            fetch('http://localhost:7337/quota'),
-            fetch('http://localhost:7337/health'),
+            fetch(`http://localhost:${PORT}/quota`),
+            fetch(`http://localhost:${PORT}/health`),
         ]);
         if (!quotaRes.ok)
             throw new Error('Daemon unavailable');
@@ -325,6 +474,13 @@ program
     .option('--plan <plan>', 'Force plan detection: pro|max5|max20|auto')
     .option('--alerts <bool>', 'Enable/disable daemon rate limit alerts: true|false')
     .option('--session-limit <usd>', 'Alert when a session exceeds this cost in USD (0 = disabled)')
+    .option('--kill-switch-force <bool>', 'Hard-block on kill switch instead of warning: true|false')
+    .option('--log-level <level>', 'Set log level: debug|info|warn|error (default: info)')
+    .option('--loop-threshold <number>', 'Tool calls in window to trigger loop detection (default: 8)')
+    .option('--loop-window <seconds>', 'Detection window in seconds (default: 120)')
+    .option('--alias <path=name>', 'Set a project alias: --alias "/path/to/repo=MyApp"')
+    .option('--remove-alias <path>', 'Remove a project alias')
+    .option('--webhook <url>', 'Set webhook URL for external alerts (Slack, Discord). Use "off" to disable.')
     .action((opts) => {
     const cfg = (0, config_1.readConfig)();
     let changed = false;
@@ -363,6 +519,63 @@ program
         else
             console.warn('  ⚠️  session-limit must be a number >= 0 (e.g. 5 for $5)');
     }
+    if (opts.killSwitchForce !== undefined) {
+        cfg.killSwitchForce = opts.killSwitchForce === 'true';
+        changed = true;
+    }
+    if (opts.logLevel !== undefined) {
+        if (['debug', 'info', 'warn', 'error'].includes(opts.logLevel)) {
+            cfg.logLevel = opts.logLevel;
+            changed = true;
+        }
+        else {
+            console.warn('  ⚠️  log-level must be: debug | info | warn | error');
+        }
+        if (opts.loopThreshold !== undefined) {
+            const v = parseInt(opts.loopThreshold, 10);
+            if (!isNaN(v) && v >= 2 && v <= 50) {
+                cfg.loopThreshold = v;
+                changed = true;
+            }
+            else
+                console.warn('  ⚠️  loopThreshold must be between 2 and 50');
+        }
+        if (opts.loopWindow !== undefined) {
+            const v = parseInt(opts.loopWindow, 10);
+            if (!isNaN(v) && v >= 10 && v <= 600) {
+                cfg.loopWindowSecs = v;
+                changed = true;
+            }
+            else
+                console.warn('  ⚠️  loopWindow must be between 10 and 600 seconds');
+        }
+        if (opts.alias !== undefined) {
+            const eqIdx = opts.alias.indexOf('=');
+            if (eqIdx < 1) {
+                console.warn('  ⚠️  format: --alias "/absolute/path=Alias Name"');
+            }
+            else {
+                const projectPath = opts.alias.slice(0, eqIdx).trim();
+                const aliasName = opts.alias.slice(eqIdx + 1).trim();
+                if (!projectPath.startsWith('/') && !projectPath.match(/^[A-Z]:\\/)) {
+                    console.warn('  ⚠️  project path must be absolute');
+                }
+                else {
+                    cfg.projectAliases = { ...cfg.projectAliases, [projectPath]: aliasName };
+                    changed = true;
+                }
+            }
+        }
+        if (opts.removeAlias !== undefined) {
+            const { [opts.removeAlias]: _, ...rest } = cfg.projectAliases;
+            cfg.projectAliases = rest;
+            changed = true;
+        }
+        if (opts.webhook !== undefined) {
+            cfg.webhookUrl = opts.webhook === 'off' ? null : opts.webhook;
+            changed = true;
+        }
+    }
     if (changed) {
         (0, config_1.writeConfig)(cfg);
         console.log('✅ Config saved to ~/.claudestat/config.json');
@@ -386,6 +599,7 @@ program
     lines.push('━'.repeat(42));
     lines.push('');
     lines.push(`  Plan              ${planColor}${planLabel.toUpperCase()}${R}`);
+    lines.push(`  Port              ${C}${cfg.port}${R}`);
     lines.push(`  Alerts            ${alertsIcon}`);
     lines.push('');
     lines.push(`  Kill switch       ${cfg.killSwitchEnabled ? `${Y}ON${R} at ${cfg.killSwitchThreshold}%` : `${D}OFF${R}`}`);
@@ -393,6 +607,17 @@ program
         lines.push(`                    ${bar(cfg.killSwitchThreshold)}`);
     }
     lines.push(`  Session limit     ${cfg.sessionCostLimitUsd > 0 ? `${Y}$${cfg.sessionCostLimitUsd.toFixed(2)}${R}` : `${D}OFF${R}`}`);
+    lines.push(`  Kill switch mode  ${cfg.killSwitchForce ? `${R}force-block${R}` : `${G}warn-only${R}  ${D}(use --kill-switch-force true to hard-block)${R}`}`);
+    const logColors = { debug: D, info: '', warn: Y, error: '\x1b[31m' };
+    lines.push(`  Log level         ${logColors[cfg.logLevel] ?? ''}${cfg.logLevel.toUpperCase()}${R}`);
+    lines.push(`  Loop detection    ${C}${cfg.loopThreshold} calls${R} in ${C}${cfg.loopWindowSecs}s${R}`);
+    lines.push(`  Webhook           ${cfg.webhookUrl ? `${C}${cfg.webhookUrl}${R}` : `${D}off${R}`}`);
+    if (Object.keys(cfg.projectAliases).length > 0) {
+        lines.push(`  Project aliases`);
+        for (const [p, a] of Object.entries(cfg.projectAliases)) {
+            lines.push(`    ${D}${p}${R} → ${C}${a}${R}`);
+        }
+    }
     lines.push('');
     lines.push(`  Cycle thresholds  ${cfg.warnThresholds.join('%, ')}%`);
     lines.push(`                    ${D}yellow${R} ${bar(cfg.warnThresholds[0], 8)}  ${D}orange${R} ${bar(cfg.warnThresholds[1], 8)}  ${D}red${R} ${bar(cfg.warnThresholds[2], 8)}`);
@@ -409,6 +634,20 @@ program
     await stopDaemon().catch((e) => { console.error(`❌ ${e.message}`); process.exit(1); });
     process.exit(0);
 });
+program
+    .command('resume')
+    .description('Remove the pause signal — allows Claude Code to continue after a quota warning')
+    .action(() => {
+    const signalFile = (0, paths_1.getPauseSignalFile)();
+    try {
+        fs_1.default.unlinkSync(signalFile);
+        console.log('✅ Pause signal removed — claudestat will no longer warn on tool calls');
+    }
+    catch {
+        console.log('  No pause signal active.');
+    }
+    process.exit(0);
+});
 program
     .command('restart')
     .description('Restart the claudestat daemon')
@@ -425,16 +664,21 @@ program
     .option('--by <metric>', 'Sort by: cost, count, duration (default: cost)')
     .option('--limit <number>', 'Number of tools to show (default: 10)')
     .option('--days <number>', 'Look back N days (default: 30)')
+    .option('--json', 'Output as JSON')
     .action(async (opts) => {
     try {
         const by = opts.by ?? 'cost';
         const limit = opts.limit ?? 10;
         const days = opts.days ?? 30;
-        const url = `http://localhost:7337/api/top?by=${by}&limit=${limit}&days=${days}`;
+        const url = `http://localhost:${PORT}/api/top?by=${by}&limit=${limit}&days=${days}`;
         const res = await fetch(url);
         if (!res.ok)
             throw new Error('Daemon unavailable');
         const data = await res.json();
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            process.exit(0);
+        }
         const R = '\x1b[0m';
         const B = '\x1b[1m';
         const D = '\x1b[2m';
@@ -465,13 +709,16 @@ program
             const dur = isOther ? '—' : fmtDur(t.totalDurationMs);
             const cost = isOther ? fmtCost(t.estimatedCostUsd) : fmtCost(t.estimatedCostUsd);
             const countStr = isOther ? '—' : String(t.count);
+            const avgPerCall = t.count > 0 && !isOther
+                ? `$${(t.estimatedCostUsd / t.count).toFixed(4)}`
+                : '—';
             const toolName = (t.tool.length > 18 ? t.tool.slice(0, 16) + '…' : t.tool).padEnd(18);
             if (isOther) {
                 lines.push(`  ${D}Other${R}  ${'—'.padStart(20)}  ${cost.padStart(10)}  ${fmtPct(pct)}`);
             }
             else {
                 lines.push(`  ${B}${(i + 1).toString().padStart(2)}${R}  ${toolName}  ${bar(val, maxVal)}  ${cost.padStart(10)}  ${fmtPct(pct)}`);
-                lines.push(`     ${D}${countStr} calls · ${dur}${R}`);
+                lines.push(`     ${D}${countStr} calls · ${dur} · avg/call ${avgPerCall}${R}`);
             }
         }
         lines.push('');
@@ -485,6 +732,63 @@ program
         process.exit(1);
     }
 });
+program
+    .command('loops')
+    .description('List sessions with detected loops')
+    .option('--days <number>', 'Look back N days (default: 30)', '30')
+    .option('--limit <number>', 'Max sessions to show (default: 10)', '10')
+    .option('--json', 'Output raw JSON')
+    .action(async (opts) => {
+    try {
+        const days = Math.min(parseInt(opts.days, 10) || 30, 365);
+        const limit = Math.min(parseInt(opts.limit, 10) || 10, 50);
+        const since = Date.now() - days * 86400000;
+        const res = await fetch(`http://localhost:${PORT}/sessions`);
+        if (!res.ok)
+            throw new Error('Daemon unavailable');
+        const sessions = await res.json();
+        const withLoops = sessions
+            .filter(s => (s.loops_detected ?? 0) > 0 && s.started_at >= since)
+            .slice(0, limit);
+        if (opts.json) {
+            console.log(JSON.stringify(withLoops, null, 2));
+            process.exit(0);
+        }
+        const R = '\x1b[0m', B = '\x1b[1m', D = '\x1b[2m', Y = '\x1b[33m';
+        if (withLoops.length === 0) {
+            console.log(`\n  No loops detected in the last ${days} days.\n`);
+            process.exit(0);
+        }
+        console.log(`\n${B}🔁 claudestat loops${R}  ${D}last ${days} days${R}`);
+        console.log('━'.repeat(52));
+        for (const s of withLoops) {
+            const date = new Date(s.started_at).toLocaleDateString('en-US', { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' });
+            const project = s.project_path ? path_1.default.basename(s.project_path) : 'unknown';
+            const cost = s.total_cost_usd ? `$${s.total_cost_usd.toFixed(3)}` : '$0.000';
+            console.log(`\n  ${Y}${s.loops_detected} loop(s)${R}  ${B}${project}${R}  ${D}${date}  ${cost}${R}`);
+            try {
+                const iRes = await fetch(`http://localhost:${PORT}/intelligence/${s.id}`);
+                const intel = await iRes.json();
+                for (const loop of (intel.loops ?? []).slice(0, 3)) {
+                    console.log(`    ${D}↳ ${loop.toolName} ×${loop.count} in ${loop.windowMs / 1000}s${R}`);
+                    if (loop.context?.repeatedFiles?.length > 0) {
+                        loop.context.repeatedFiles.slice(0, 3).forEach((f) => console.log(`      ${D}file: ${path_1.default.basename(f)}${R}`));
+                    }
+                    if (loop.context?.repeatedCommands?.length > 0) {
+                        loop.context.repeatedCommands.slice(0, 2).forEach((c) => console.log(`      ${D}cmd:  ${c.slice(0, 60)}${R}`));
+                    }
+                }
+            }
+            catch { }
+        }
+        console.log('\n' + '━'.repeat(52) + '\n');
+        process.exit(0);
+    }
+    catch {
+        console.error('\n❌ Daemon is not running. Start it with: claudestat start\n');
+        process.exit(1);
+    }
+});
 program
     .command('doctor')
     .description('Check installation health and diagnose common issues')
@@ -492,6 +796,70 @@ program
     console.error('\n❌ Error:', err.message);
     process.exit(1);
 }));
+program
+    .command('logs')
+    .description('Show daemon log (~/.claudestat/daemon.log)')
+    .option('-n <number>', 'Number of lines to show (default: 50)', '50')
+    .option('--follow', 'Tail the log in real time')
+    .option('--level <level>', 'Filter by minimum level: debug|info|warn|error')
+    .action((opts) => {
+    const logFile = (0, paths_1.getDaemonLogFile)();
+    if (!fs_1.default.existsSync(logFile)) {
+        console.log('\n  No daemon log found. Start the daemon first: claudestat start\n');
+        process.exit(0);
+    }
+    const minRank = { debug: 0, info: 1, warn: 2, error: 3 };
+    const levelFilter = opts.level ? (minRank[opts.level] ?? 0) : 0;
+    function filterLine(line) {
+        if (!opts.level)
+            return true;
+        const match = line.match(/\[(DEBUG|INFO|WARN|ERROR)\]/);
+        if (!match)
+            return true;
+        return (minRank[match[1].toLowerCase()] ?? 0) >= levelFilter;
+    }
+    const levelColor = {
+        DEBUG: '\x1b[2m', INFO: '\x1b[36m', WARN: '\x1b[33m', ERROR: '\x1b[31m'
+    };
+    function colorize(line) {
+        return line.replace(/\[(DEBUG|INFO|WARN|ERROR)\]/, (_, l) => `${levelColor[l] ?? ''}[${l}]\x1b[0m`);
+    }
+    if (opts.follow) {
+        const content = fs_1.default.readFileSync(logFile, 'utf8');
+        content.split('\n').filter(Boolean).filter(filterLine).slice(-20)
+            .forEach(l => console.log(colorize(l)));
+        let size = fs_1.default.statSync(logFile).size;
+        setInterval(() => {
+            try {
+                const newSize = fs_1.default.statSync(logFile).size;
+                if (newSize <= size)
+                    return;
+                const buf = Buffer.alloc(newSize - size);
+                const fd = fs_1.default.openSync(logFile, 'r');
+                fs_1.default.readSync(fd, buf, 0, buf.length, size);
+                fs_1.default.closeSync(fd);
+                size = newSize;
+                buf.toString('utf8').split('\n').filter(Boolean).filter(filterLine)
+                    .forEach(l => console.log(colorize(l)));
+            }
+            catch { }
+        }, 300);
+    }
+    else {
+        const n = Math.min(parseInt(opts.n, 10) || 50, 500);
+        const content = fs_1.default.readFileSync(logFile, 'utf8');
+        const lines = content.split('\n').filter(Boolean).filter(filterLine).slice(-n);
+        if (lines.length === 0) {
+            console.log(`\n  No log entries${opts.level ? ` at level ≥ ${opts.level}` : ''}.\n`);
+        }
+        else {
+            console.log('');
+            lines.forEach(l => console.log(colorize(l)));
+            console.log('');
+        }
+        process.exit(0);
+    }
+});
 program
     .command('roast')
     .description('Roast your Claude Code usage habits')
@@ -519,11 +887,29 @@ program
             console.log('\n📊 No usage data yet — start using Claude Code and claudestat will track it.\n');
             process.exit(0);
         }
+        const prev = (0, insights_1.getPrevWeekInsightData)();
+        const deltaCost = prev.total_cost > 0
+            ? Math.round((data.total_cost - prev.total_cost) / prev.total_cost * 100)
+            : null;
+        const deltaSessions = prev.total_sessions > 0
+            ? Math.round((data.total_sessions - prev.total_sessions) / prev.total_sessions * 100)
+            : null;
         if (opts.json) {
-            console.log(JSON.stringify(data, null, 2));
+            console.log(JSON.stringify({ current: data, prev, deltaCostPct: deltaCost, deltaSessionsPct: deltaSessions }, null, 2));
             process.exit(0);
         }
         console.log((0, insights_1.renderWeeklyInsight)(data));
+        if (deltaCost !== null || deltaSessions !== null) {
+            const R = '\x1b[0m', D = '\x1b[2m', G = '\x1b[32m', Y = '\x1b[33m';
+            const sign = (n) => n >= 0 ? `+${n}` : `${n}`;
+            const color = (n) => n > 0 ? Y : G;
+            console.log(`  ${D}vs last week:${R}`);
+            if (deltaCost !== null)
+                console.log(`    cost      ${color(deltaCost)}${sign(deltaCost)}%${R}`);
+            if (deltaSessions !== null)
+                console.log(`    sessions  ${sign(deltaSessions)}%`);
+            console.log('');
+        }
         process.exit(0);
     }
     catch (err) {

package/dist/insights.d.ts

@@ -43,3 +43,4 @@ export declare function renderInsights(d: UsageInsightsData): string;
 export declare function shouldShowInsight(): boolean;
 export declare function markInsightShown(): void;
 export declare function renderWeeklyInsight(d: WeeklyInsightData): string;
+export declare function getPrevWeekInsightData(): WeeklyInsightData;

package/dist/insights.js

@@ -10,6 +10,7 @@ exports.renderInsights = renderInsights;
 exports.shouldShowInsight = shouldShowInsight;
 exports.markInsightShown = markInsightShown;
 exports.renderWeeklyInsight = renderWeeklyInsight;
+exports.getPrevWeekInsightData = getPrevWeekInsightData;
 const path_1 = __importDefault(require("path"));
 const db_1 = require("./db");
 const WEEK_MS = 7 * 86400000;
@@ -253,3 +254,28 @@ function renderWeeklyInsight(d) {
     lines.push('');
     return lines.join('\n');
 }
+function getPrevWeekInsightData() {
+    const agg = db_1.dbOps.getPrevWeekInsight();
+    const topTools = db_1.dbOps.getTopTools(14, 'cost', 1);
+    const topTool = topTools[0];
+    const totalInputWithCache = agg.input_tokens + agg.cache_read;
+    const cacheHitPct = totalInputWithCache > 0
+        ? Math.min(100, Math.round(agg.cache_read / totalInputWithCache * 100))
+        : 0;
+    return {
+        total_sessions: agg.total_sessions,
+        total_cost: agg.total_cost,
+        input_tokens: agg.input_tokens,
+        output_tokens: agg.output_tokens,
+        cache_read: agg.cache_read,
+        cache_hit_pct: cacheHitPct,
+        total_loops: agg.total_loops,
+        avg_efficiency: Math.round(agg.avg_efficiency),
+        top_tool: topTool?.tool_name ?? 'Unknown',
+        top_tool_cost_pct: agg.total_cost > 0
+            ? Math.round((topTool?.total_cost_usd ?? 0) / agg.total_cost * 100)
+            : 0,
+        week_start: agg.week_start,
+        week_end: agg.week_end ?? agg.week_start,
+    };
+}