@statforge/claudestat 1.2.0 → 1.2.3

package/dist/doctor.js

@@ -17,11 +17,9 @@ async function runDoctor() {
     const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
     checks.push({
         label: `Node.js version (${process.versions.node})`,
-        ok: nodeMajor >= 18,
-        note: nodeMajor >= 22 ? 'node:sqlite supported ✓'
-            : nodeMajor >= 18 ? 'Works — Node 22+ recommended for native node:sqlite'
-                : undefined,
-        fix: nodeMajor < 18 ? 'Install Node.js 18 or later: https://nodejs.org' : undefined,
+        ok: nodeMajor >= 22,
+        note: nodeMajor >= 22 ? 'node:sqlite supported ✓' : undefined,
+        fix: nodeMajor < 22 ? 'Install Node.js 22 or later: https://nodejs.org' : undefined,
     });
     // 2. Claude Code installed
     const claudeOk = (() => { try {
@@ -98,7 +96,7 @@ async function runDoctor() {
         label: 'Global CLI symlink valid',
         ok: symlinkOk,
         note: symlinkNote,
-        fix: symlinkOk ? undefined : 'npm install -g @deibygs/claudestat',
+        fix: symlinkOk ? undefined : 'npm install -g @statforge/claudestat',
     });
     // 8. No duplicate claudestat binaries in PATH
     let duplicatesOk = true;
@@ -117,7 +115,7 @@ async function runDoctor() {
         ok: duplicatesOk,
         note: duplicatesNote,
         fix: duplicatesOk ? undefined :
-            `npm uninstall -g @deibygs/claudestat && npm install -g @deibygs/claudestat\n       Then restart your terminal or run: ${paths_1.isWindows ? 'refreshenv' : 'hash -r claudestat'}`,
+            `npm uninstall -g @statforge/claudestat && npm install -g @statforge/claudestat\n       Then restart your terminal or run: ${paths_1.isWindows ? 'refreshenv' : 'hash -r claudestat'}`,
     });
     // 9. Active binary version matches installed package
     let versionOk = true;
@@ -146,7 +144,7 @@ async function runDoctor() {
         ok: versionOk,
         note: versionNote,
         fix: versionOk ? undefined :
-            `${paths_1.isWindows ? 'refreshenv' : 'hash -r claudestat'}  (or restart terminal)\n       If persists: npm uninstall -g @deibygs/claudestat && npm install -g @deibygs/claudestat`,
+            `${paths_1.isWindows ? 'refreshenv' : 'hash -r claudestat'}  (or restart terminal)\n       If persists: npm uninstall -g @statforge/claudestat && npm install -g @statforge/claudestat`,
     });
     // 10. NVM prefix sanity (only when NVM is active)
     if ((process.env.NVM_DIR || process.env.NVM_HOME) && activeBinary) {
@@ -165,9 +163,29 @@ async function runDoctor() {
             ok: nvmOk,
             note: nvmNote,
             fix: nvmOk ? undefined :
-                `nvm use default && npm install -g @deibygs/claudestat\n       Then restart terminal`,
+                `nvm use default && npm install -g @statforge/claudestat\n       Then restart terminal`,
         });
     }
+    // 11. MCP server registered in Claude Code
+    let mcpOk = false;
+    let mcpNote;
+    const mcpResult = (0, child_process_1.spawnSync)('claude', ['mcp', 'list'], { encoding: 'utf8', timeout: 15000 });
+    if (mcpResult.error) {
+        mcpNote = '"claude" CLI not found — install Claude Code first';
+    }
+    else {
+        const mcpList = (mcpResult.stdout ?? '') + (mcpResult.stderr ?? '');
+        const mcpLine = mcpList.split('\n').find(l => l.includes('claudestat'));
+        mcpOk = !!mcpLine && !mcpLine.includes('Failed') && !mcpLine.includes('✗');
+        if (!mcpOk)
+            mcpNote = 'Run "claudestat install" to register it automatically';
+    }
+    checks.push({
+        label: 'MCP server registered in Claude Code',
+        ok: mcpOk,
+        note: mcpNote,
+        fix: mcpOk ? undefined : 'claudestat install',
+    });
     // ── Print results ───────────────────────────────────────────
     console.log('\n🩺 claudestat doctor\n' + '─'.repeat(46));
     for (const c of checks) {
@@ -183,6 +201,7 @@ async function runDoctor() {
     const failed = checks.filter(c => !c.ok).length;
     if (failed === 0) {
         console.log('  \x1b[32mAll checks passed — claudestat is healthy!\x1b[0m\n');
+        process.exit(0);
     }
     else {
         console.log(`  \x1b[31m${failed} check(s) failed — see fixes above\x1b[0m\n`);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
 /**
  * index.ts — Entry point del CLI
  *

package/dist/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
 "use strict";
 /**
  * index.ts — Entry point del CLI
@@ -27,13 +27,48 @@ const install_1 = require("./install");
 const export_1 = require("./export");
 const config_1 = require("./config");
 const doctor_1 = require("./doctor");
-const share_1 = require("./share");
 const roast_1 = require("./roast");
 const insights_1 = require("./insights");
 const paths_1 = require("./paths");
+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)();
+// ── Update notifier ────────────────────────────────────────────
+const SKIP_UPDATE_NOTICE = new Set(['start', 'stop', 'restart', 'watch']);
+const subcommand = process.argv[2];
+if (!SKIP_UPDATE_NOTICE.has(subcommand)) {
+    const UPDATE_CACHE = path_1.default.join((0, paths_1.getClaudestatDir)(), 'update-cache.json');
+    let cachedLatest = null;
+    const fetchLatestVersion = () => {
+        fetch('https://registry.npmjs.org/@statforge/claudestat/latest', { signal: AbortSignal.timeout(3000) })
+            .then(r => r.json())
+            .then(j => {
+            if (j?.version) {
+                cachedLatest = j.version;
+                fs_1.default.writeFileSync(UPDATE_CACHE, JSON.stringify({ version: j.version, ts: Date.now() }));
+            }
+        })
+            .catch(() => { });
+    };
+    try {
+        const cache = JSON.parse(fs_1.default.readFileSync(UPDATE_CACHE, 'utf8'));
+        cachedLatest = cache.version;
+        if (Date.now() - cache.ts >= 24 * 60 * 60 * 1000)
+            fetchLatestVersion();
+    }
+    catch {
+        fetchLatestVersion();
+    }
+    const _exit = process.exit.bind(process);
+    process.exit = ((code) => {
+        if ((code ?? 0) === 0 && cachedLatest && cachedLatest !== PKG_VERSION) {
+            console.log(`\n  ✦ Update available: ${PKG_VERSION} → ${cachedLatest}`);
+            console.log(`    Run: npm install -g @statforge/claudestat\n`);
+        }
+        _exit(code);
+    });
+}
 function spawnDaemon() {
     const child = (0, child_process_1.spawn)(process.execPath, [process.argv[1], 'start'], {
         detached: true,
@@ -83,6 +118,20 @@ async function stopDaemon() {
         throw new Error(`Error stopping daemon: ${e.message}`);
     }
 }
+async function checkLatestVersion() {
+    try {
+        const res = await fetch('https://registry.npmjs.org/@statforge/claudestat/latest', {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!res.ok)
+            return null;
+        const json = await res.json();
+        return json.version;
+    }
+    catch {
+        return null;
+    }
+}
 // Warn if the active binary is outside the current npm global prefix (NVM conflict)
 if (process.env.NVM_DIR || process.env.NVM_HOME) {
     try {
@@ -92,7 +141,7 @@ if (process.env.NVM_DIR || process.env.NVM_HOME) {
             const refreshCmd = paths_1.isWindows ? 'refreshenv' : 'hash -r claudestat';
             process.stderr.write(`\x1b[33m⚠️  claudestat is running from ${runningFrom}\x1b[0m\n` +
                 `   This binary may not match the active Node version (${process.version}).\n` +
-                `   Fix: \x1b[36mnvm use default && npm install -g @deibygs/claudestat\x1b[0m\n` +
+                `   Fix: \x1b[36mnvm use default && npm install -g @statforge/claudestat\x1b[0m\n` +
                 `   Then restart your terminal or run: \x1b[36m${refreshCmd}\x1b[0m\n\n`);
         }
     }
@@ -100,8 +149,21 @@ if (process.env.NVM_DIR || process.env.NVM_HOME) {
 }
 program
     .name('claudestat')
-    .description('Real-time execution trace and cost intelligence for Claude Code')
+    .description('Real-time execution trace and cost intelligence for Claude Code · github.com/DeibyGS/claudestat')
     .version(PKG_VERSION);
+program
+    .command('version')
+    .description('Show version and check for updates')
+    .action(async () => {
+    console.log(PKG_VERSION);
+    const latest = await checkLatestVersion();
+    if (latest) {
+        const isLatest = latest === PKG_VERSION;
+        const tag = isLatest ? `\x1b[32mlatest ✓\x1b[0m` : `\x1b[33mlatest: ${latest} — run npm update\x1b[0m`;
+        console.log(`  ${tag}`);
+    }
+    process.exit(0);
+});
 program
     .command('start')
     .description('Start the background daemon (receives Claude Code hook events)')
@@ -152,9 +214,9 @@ program
     .command('status')
     .description('Show current quota, cost and burn rate')
     .option('--json', 'Output raw JSON instead of formatted text')
-    .option('--compact', 'One-line output for tmux')
     .action(async (opts) => {
     try {
+        await (0, quota_tracker_1.refreshFromApi)(); // refresh disk cache on demand; daemon reads from disk
         const [quotaRes, healthRes] = await Promise.all([
             fetch('http://localhost:7337/quota'),
             fetch('http://localhost:7337/health'),
@@ -163,13 +225,6 @@ program
             throw new Error('Daemon unavailable');
         const q = await quotaRes.json();
         const _h = await healthRes.json().catch(() => ({}));
-        if (opts.compact) {
-            const pctCycle = q.cyclePct;
-            const cycleEmoji = pctCycle >= 95 ? '🔴' : pctCycle >= 70 ? '🟡' : '🟢';
-            const wEmoji = q.weeklyPctAll >= 95 ? '🔴' : q.weeklyPctAll >= 70 ? '🟡' : '🟢';
-            console.log(`C:${pctCycle}%${cycleEmoji} W:${q.weeklyPctAll}%${wEmoji} ${q.detectedPlan}`);
-            process.exit(0);
-        }
         if (opts.json) {
             console.log(JSON.stringify({
                 cyclePrompts: q.cyclePrompts,
@@ -187,33 +242,44 @@ program
             process.exit(0);
         }
         const R = '\x1b[0m';
-        const pctColor = q.cyclePct >= 95 ? '\x1b[31m'
-            : q.cyclePct >= 85 ? '\x1b[33m'
-                : q.cyclePct >= 70 ? '\x1b[33m'
-                    : '\x1b[32m';
-        const resetMin = Math.ceil(q.cycleResetMs / 60000);
-        const resetLabel = resetMin >= 60
-            ? `${Math.floor(resetMin / 60)}h ${resetMin % 60}m`
-            : `${resetMin}m`;
-        const burnRow = q.burnRateTokensPerMin > 0
-            ? `  Burn rate   ${q.burnRateTokensPerMin.toLocaleString()} tok/min\n`
-            : '';
-        const weeklyTotalHours = q.weeklyHoursSonnet + q.weeklyHoursOpus;
-        const weeklyLimitTotal = q.weeklyLimitSonnet + q.weeklyLimitOpus;
-        const weeklyPctColor = q.weeklyPctAll >= 95 ? '\x1b[31m'
-            : q.weeklyPctAll >= 70 ? '\x1b[33m'
-                : '\x1b[32m';
-        console.log(`\n📊 claudestat status\n` +
-            `──────────────────────────────────────────\n` +
-            `  Quota 5h    ${pctColor}${q.cyclePrompts}/${q.cycleLimit} prompts (${q.cyclePct}%)${R}  │  resets in ${resetLabel}\n` +
-            `  Plan        ${q.detectedPlan.toUpperCase()}\n` +
-            `  Weekly      ${weeklyTotalHours}h / ${weeklyLimitTotal}h (${weeklyPctColor}${q.weeklyPctAll}%${R})  this week\n` +
-            (q.weeklyLimitOpus > 0
-                ? `   ├─ Sonnet  ${q.weeklyHoursSonnet}h / ${q.weeklyLimitSonnet}h\n` +
-                    `   └─ Opus    ${q.weeklyHoursOpus}h / ${q.weeklyLimitOpus}h\n`
-                : '') +
-            `${burnRow}` +
-            `──────────────────────────────────────────\n`);
+        const B = '\x1b[1m';
+        const D = '\x1b[2m';
+        const pctBar = (pct, width = 20) => {
+            const filled = Math.round(Math.min(pct, 100) / 100 * width);
+            const color = pct >= 90 ? '\x1b[31m' : pct >= 70 ? '\x1b[33m' : '\x1b[32m';
+            return `${color}${'█'.repeat(filled)}${R}${D}${'░'.repeat(width - filled)}${R}`;
+        };
+        const resetTime = q.cycleResetAt
+            ? new Date(q.cycleResetAt).toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' })
+            : (() => {
+                const m = Math.ceil(q.cycleResetMs / 60000);
+                return m >= 60 ? `${Math.floor(m / 60)}h ${m % 60}m` : `${m}m`;
+            })();
+        const now = new Date();
+        const daysToMonday = ((8 - now.getDay()) % 7) || 7;
+        const nextMonday = new Date(now);
+        nextMonday.setDate(now.getDate() + daysToMonday);
+        const weekReset = nextMonday.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+        const lines = [];
+        lines.push(`\n${B}📊 claudestat${R}  ${D}${q.detectedPlan.toUpperCase()} plan${R}`);
+        lines.push('━'.repeat(42));
+        lines.push('');
+        lines.push(`  5h      ${pctBar(q.cyclePct)}  ${B}${q.cyclePct}%${R}   ${D}resets ${resetTime}${R}`);
+        lines.push('');
+        lines.push(`  Week    ${pctBar(q.weeklyPctAll)}  ${B}${q.weeklyPctAll}%${R}   ${D}resets ${weekReset}${R}`);
+        if (q.weeklyLimitOpus > 0) {
+            lines.push('');
+            lines.push(`  ${D}  ├─ Sonnet  ${q.weeklyHoursSonnet}h / ${q.weeklyLimitSonnet}h${R}`);
+            lines.push(`  ${D}  └─ Opus    ${q.weeklyHoursOpus}h / ${q.weeklyLimitOpus}h${R}`);
+        }
+        if (q.burnRateTokensPerMin > 0) {
+            lines.push('');
+            lines.push(`  🔥 ${B}${q.burnRateTokensPerMin.toLocaleString()}${R} tok/min  ${D}·  ${q.cyclePrompts} prompts used${R}`);
+        }
+        lines.push('');
+        lines.push('━'.repeat(42));
+        lines.push('');
+        console.log(lines.join('\n'));
         process.exit(0);
     }
     catch {
@@ -261,13 +327,38 @@ program
         (0, config_1.writeConfig)(cfg);
         console.log('✅ Config saved to ~/.claudestat/config.json');
     }
-    // Always show current config
-    console.log('\n📋 Current config:');
-    console.log(`   killSwitchEnabled:  ${cfg.killSwitchEnabled}`);
-    console.log(`   killSwitchThreshold: ${cfg.killSwitchThreshold}%`);
-    console.log(`   warnThresholds:     ${cfg.warnThresholds.join('%, ')}%`);
-    console.log(`   alertsEnabled:      ${cfg.alertsEnabled}`);
-    console.log(`   plan:               ${cfg.plan ?? 'auto-detect'}\n`);
+    const R = '\x1b[0m';
+    const B = '\x1b[1m';
+    const D = '\x1b[2m';
+    const G = '\x1b[32m';
+    const Y = '\x1b[33m';
+    const C = '\x1b[36m';
+    const bar = (pct, width = 20) => {
+        const filled = Math.round(Math.min(pct, 100) / 100 * width);
+        const color = pct >= 95 ? '\x1b[31m' : pct >= 85 ? '\x1b[33m' : '\x1b[32m';
+        return `${color}${'█'.repeat(filled)}${R}${D}${'░'.repeat(width - filled)}${R}`;
+    };
+    const planColor = cfg.plan === 'pro' ? G : cfg.plan === 'max5' ? C : cfg.plan === 'max20' ? '\x1b[35m' : Y;
+    const planLabel = cfg.plan ?? 'auto-detect';
+    const alertsIcon = cfg.alertsEnabled ? `${G}enabled${R}` : `${Y}disabled${R}`;
+    const lines = [];
+    lines.push(`\n${B}⚙️  claudestat config${R}`);
+    lines.push('━'.repeat(42));
+    lines.push('');
+    lines.push(`  Plan              ${planColor}${planLabel.toUpperCase()}${R}`);
+    lines.push(`  Alerts            ${alertsIcon}`);
+    lines.push('');
+    lines.push(`  Kill switch       ${cfg.killSwitchEnabled ? `${Y}ON${R} at ${cfg.killSwitchThreshold}%` : `${D}OFF${R}`}`);
+    if (cfg.killSwitchEnabled) {
+        lines.push(`                    ${bar(cfg.killSwitchThreshold)}`);
+    }
+    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)}`);
+    lines.push('');
+    lines.push('━'.repeat(42));
+    lines.push('');
+    console.log(lines.join('\n'));
     process.exit(0);
 });
 program
@@ -303,25 +394,49 @@ program
         if (!res.ok)
             throw new Error('Daemon unavailable');
         const data = await res.json();
+        const R = '\x1b[0m';
+        const B = '\x1b[1m';
+        const D = '\x1b[2m';
         const label = by === 'count' ? 'calls' : by === 'duration' ? 'duration' : 'est. cost';
-        console.log(`\n🏆 claudestat top — by ${label} (last ${days} days)\n`);
-        console.log('  #  Tool              Calls    Duration   Est. Cost      %');
-        console.log('  ── ───────────────── ──────── ───────────── ───────── ────');
+        const maxVal = Math.max(...data.tools.map((t) => by === 'cost' ? t.estimatedCostUsd : by === 'count' ? t.count : t.totalDurationMs));
+        const bar = (val, max, width = 20) => {
+            const pct = max > 0 ? val / max * 100 : 0;
+            const filled = Math.round(pct / 100 * width);
+            const rank = data.tools.findIndex((t) => {
+                const tv = by === 'cost' ? t.estimatedCostUsd : by === 'count' ? t.count : t.totalDurationMs;
+                return tv === val;
+            });
+            const color = rank === 0 ? '\x1b[31m' : rank <= 2 ? '\x1b[33m' : '\x1b[32m';
+            return `${color}${'█'.repeat(filled)}${R}${D}${'░'.repeat(width - filled)}${R}`;
+        };
+        const fmtCost = (n) => n < 0.01 ? `< $0.01` : `$${n.toFixed(2)}`;
+        const fmtDur = (ms) => ms >= 60000 ? `${(ms / 60000).toFixed(1)}m` : `${(ms / 1000).toFixed(0)}s`;
+        const fmtPct = (n) => `${Math.round(n)}%`;
+        const lines = [];
+        lines.push(`\n${B}🏆 claudestat top${R}  ${D}by ${label} (last ${days} days)${R}`);
+        lines.push('━'.repeat(52));
+        lines.push('');
         for (let i = 0; i < data.tools.length; i++) {
             const t = data.tools[i];
             const isOther = t.tool === 'Other';
-            const dur = isOther ? '—'
-                : t.totalDurationMs >= 60000
-                    ? `${(t.totalDurationMs / 60000).toFixed(1)}m`
-                    : `${(t.totalDurationMs / 1000).toFixed(0)}s`;
-            const cost = t.estimatedCostUsd < 0.01
-                ? `$${t.estimatedCostUsd.toFixed(4)}`
-                : `$${t.estimatedCostUsd.toFixed(2)}`;
-            const pct = by === 'cost' ? `${t.pctCost}%` : isOther ? '' : `${t.pctCount}%`;
+            const val = isOther ? 0 : (by === 'cost' ? t.estimatedCostUsd : by === 'count' ? t.count : t.totalDurationMs);
+            const pct = by === 'cost' ? t.pctCost : (isOther ? 0 : t.pctCount);
+            const dur = isOther ? '—' : fmtDur(t.totalDurationMs);
+            const cost = isOther ? fmtCost(t.estimatedCostUsd) : fmtCost(t.estimatedCostUsd);
             const countStr = isOther ? '—' : String(t.count);
-            console.log(`  ${(i + 1).toString().padStart(2)}  ${t.tool.padEnd(18)} ${countStr.padStart(8)} ${dur.padStart(13)} ${cost.padStart(9)} ${pct.padStart(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}`);
+            }
         }
-        console.log();
+        lines.push('');
+        lines.push('━'.repeat(52));
+        lines.push('');
+        console.log(lines.join('\n'));
         process.exit(0);
     }
     catch {
@@ -336,23 +451,6 @@ program
     console.error('\n❌ Error:', err.message);
     process.exit(1);
 }));
-program
-    .command('share [session-id]')
-    .description('Generate a shareable session card (ASCII or JSON)')
-    .option('--format <type>', 'Output format: ascii, json (default: ascii)')
-    .option('--copy', 'Copy to clipboard (macOS only)')
-    .action(async (sessionId, opts) => {
-    try {
-        const format = (opts.format ?? 'ascii');
-        const copy = !!opts.copy;
-        await (0, share_1.runShare)({ sessionId, format, copy });
-        process.exit(0);
-    }
-    catch (err) {
-        console.error('\n❌ Error:', err.message);
-        process.exit(1);
-    }
-});
 program
     .command('roast')
     .description('Roast your Claude Code usage habits')
@@ -392,4 +490,29 @@ program
         process.exit(1);
     }
 });
+program
+    .command('insights')
+    .description('Show usage insights: cost breakdown, cache savings, efficiency trend, peak hours')
+    .option('--days <number>', 'Look back N days (default 7)')
+    .option('--json', 'Output raw JSON')
+    .action((opts) => {
+    try {
+        const days = Math.max(1, Math.min(90, parseInt(opts.days ?? '7', 10) || 7));
+        const data = (0, insights_1.getUsageInsights)(days);
+        if (data.total_sessions === 0) {
+            console.log(`\n💡 No data for the last ${days} days.\n`);
+            process.exit(0);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            process.exit(0);
+        }
+        console.log((0, insights_1.renderInsights)(data));
+        process.exit(0);
+    }
+    catch (err) {
+        console.error('\n❌ Error:', err.message);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/insights.d.ts

@@ -14,6 +14,32 @@ export interface WeeklyInsightData {
 }
 export declare function getWeeklyInsightData(days?: number): WeeklyInsightData;
 export declare function generateTip(d: WeeklyInsightData): string;
+export interface UsageInsightsData {
+    days: number;
+    total_sessions: number;
+    total_cost: number;
+    avg_cost_per_session: number;
+    cache_savings_usd: number;
+    cache_hit_pct: number;
+    output_input_ratio: number;
+    ratio_label: string;
+    avg_efficiency: number;
+    efficiency_delta: number;
+    total_loops: number;
+    project_costs: {
+        project: string;
+        session_count: number;
+        total_cost: number;
+    }[];
+    hour_ranges: {
+        emoji: string;
+        from: string;
+        to: string;
+        count: number;
+    }[];
+}
+export declare function getUsageInsights(days?: number): UsageInsightsData;
+export declare function renderInsights(d: UsageInsightsData): string;
 export declare function shouldShowInsight(): boolean;
 export declare function markInsightShown(): void;
 export declare function renderWeeklyInsight(d: WeeklyInsightData): string;