@statforge/claudestat 1.1.1 → 1.2.2

package/dist/db.d.ts

@@ -126,9 +126,40 @@ export declare const dbOps: {
         total_duration_ms: number;
         total_cost_usd: number;
     }[];
+    getWeeklyInsight(days?: number): {
+        total_sessions: number;
+        total_cost: number;
+        input_tokens: number;
+        output_tokens: number;
+        cache_read: number;
+        total_loops: number;
+        avg_efficiency: number;
+        week_start: number;
+        week_end: number;
+    };
+    setMeta(key: string, value: string): void;
+    getMeta(key: string): string | undefined;
     getCostProjection(days?: number): {
         total_cost_usd: number;
         earliest: number;
         latest: number;
     };
+    getProjectCosts(days?: number): {
+        project: string;
+        session_count: number;
+        total_cost: number;
+    }[];
+    getHourlyDistribution(days?: number): {
+        hour: number;
+        session_count: number;
+    }[];
+    getCacheReadByModel(days: number): {
+        model: string;
+        cache_read: number;
+    }[];
+    getModelBreakdown(days: number): {
+        model: string;
+        total_cost: number;
+        session_count: number;
+    }[];
 };

package/dist/db.js

@@ -42,6 +42,15 @@ try {
 `);
 }
 catch { /* ya existe */ }
+try {
+    db.exec(`
+  CREATE TABLE IF NOT EXISTS meta (
+    key   TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+  )
+`);
+}
+catch { /* ya existe */ }
 db.exec(`
   CREATE TABLE IF NOT EXISTS sessions (
     id                     TEXT    PRIMARY KEY,
@@ -381,6 +390,25 @@ const stmts = {
     ORDER BY total_duration_ms DESC
     LIMIT ?
   `),
+    getWeeklyInsight: db.prepare(`
+    SELECT
+      COUNT(*)                                                      AS total_sessions,
+      COALESCE(SUM(total_cost_usd),       0)                        AS total_cost,
+      COALESCE(SUM(total_input_tokens),   0)                        AS input_tokens,
+      COALESCE(SUM(total_output_tokens),  0)                        AS output_tokens,
+      COALESCE(SUM(total_cache_read),     0)                        AS cache_read,
+      COALESCE(SUM(loops_detected),       0)                        AS total_loops,
+      COALESCE(AVG(CASE WHEN efficiency_score > 0 THEN efficiency_score END), 100) AS avg_efficiency,
+      MIN(started_at)                                               AS week_start,
+      MAX(last_event_at)                                            AS week_end
+    FROM sessions
+    WHERE started_at >= ?
+  `),
+    upsertMeta: db.prepare(`
+    INSERT INTO meta (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = excluded.value
+  `),
+    getMeta: db.prepare(`SELECT value FROM meta WHERE key = ?`),
     getCostProjection: db.prepare(`
     SELECT
       SUM(total_cost_usd)   AS total_cost_usd,
@@ -388,6 +416,26 @@ const stmts = {
       MAX(last_event_at)   AS latest
     FROM sessions
     WHERE started_at >= ?
+  `),
+    getProjectCosts: db.prepare(`
+    SELECT
+      COALESCE(project_path, 'no project') AS project,
+      COUNT(*)                              AS session_count,
+      COALESCE(SUM(total_cost_usd), 0)     AS total_cost
+    FROM sessions
+    WHERE started_at >= ? AND total_cost_usd > 0
+    GROUP BY project_path
+    ORDER BY total_cost DESC
+    LIMIT 5
+  `),
+    getHourlyDistribution: db.prepare(`
+    SELECT
+      CAST(strftime('%H', datetime(started_at/1000, 'unixepoch', 'localtime')) AS INTEGER) AS hour,
+      COUNT(*) AS session_count
+    FROM sessions
+    WHERE started_at >= ?
+    GROUP BY hour
+    ORDER BY hour ASC
   `),
     getUnattributedCost: db.prepare(`
     WITH period_cost AS (
@@ -539,8 +587,49 @@ exports.dbOps = {
         }
         return tools;
     },
+    getWeeklyInsight(days = 7) {
+        const since = Date.now() - days * 86400000;
+        return stmts.getWeeklyInsight.get(since);
+    },
+    setMeta(key, value) {
+        stmts.upsertMeta.run(key, value);
+    },
+    getMeta(key) {
+        const row = stmts.getMeta.get(key);
+        return row?.value;
+    },
     getCostProjection(days = 7) {
         const since = Date.now() - days * 86400000;
         return stmts.getCostProjection.get(since);
     },
+    getProjectCosts(days = 7) {
+        const since = Date.now() - days * 86400000;
+        return stmts.getProjectCosts.all(since);
+    },
+    getHourlyDistribution(days = 7) {
+        const since = Date.now() - days * 86400000;
+        return stmts.getHourlyDistribution.all(since);
+    },
+    getCacheReadByModel(days) {
+        const since = Date.now() - days * 86400000;
+        return db.prepare(`
+      SELECT COALESCE(dominant_model, 'unknown') as model, SUM(total_cache_read) as cache_read
+      FROM sessions
+      WHERE started_at >= ?
+      GROUP BY dominant_model
+    `).all(since);
+    },
+    getModelBreakdown(days) {
+        const since = Date.now() - days * 86400000;
+        return db.prepare(`
+      SELECT
+        COALESCE(dominant_model, 'unknown') as model,
+        SUM(total_cost_usd) as total_cost,
+        COUNT(*) as session_count
+      FROM sessions
+      WHERE started_at >= ?
+      GROUP BY dominant_model
+      ORDER BY total_cost DESC
+    `).all(since);
+    },
 };

package/dist/doctor.js

@@ -183,6 +183,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,9 +27,10 @@ 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)();
@@ -64,7 +65,12 @@ async function stopDaemon() {
     catch { }
     try {
         const pid = parseInt(fs_1.default.readFileSync(PID_FILE, 'utf8').trim(), 10);
-        process.kill(pid, 'SIGTERM');
+        if (process.platform === 'win32') {
+            process.kill(pid);
+        }
+        else {
+            process.kill(pid, 'SIGTERM');
+        }
         console.log(`✅ claudestat daemon stopped (pid ${pid})`);
         removePidFile();
     }
@@ -77,6 +83,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 {
@@ -86,7 +106,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`);
         }
     }
@@ -94,8 +114,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)')
@@ -146,9 +179,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'),
@@ -157,12 +190,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 ? '🟡' : '🟢';
-            console.log(`Current ${pctCycle}%${cycleEmoji} ${q.detectedPlan}`);
-            process.exit(0);
-        }
         if (opts.json) {
             console.log(JSON.stringify({
                 cyclePrompts: q.cyclePrompts,
@@ -174,35 +201,50 @@ program
                 weeklyLimitSonnet: q.weeklyLimitSonnet,
                 weeklyHoursOpus: q.weeklyHoursOpus,
                 weeklyLimitOpus: q.weeklyLimitOpus,
+                weeklyPctAll: q.weeklyPctAll,
                 burnRateTokensPerMin: q.burnRateTokensPerMin,
             }));
             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 burnLabel = q.burnRateTokensPerMin > 0
-            ? ` │ 🔥 ${q.burnRateTokensPerMin.toLocaleString()} tok/min`
-            : '';
-        const burnRow = q.burnRateTokensPerMin > 0
-            ? `  Burn rate   ${q.burnRateTokensPerMin.toLocaleString()} tok/min\n`
-            : '';
-        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` +
-            `  Sonnet      ${q.weeklyHoursSonnet}h / ${q.weeklyLimitSonnet}h  this week\n` +
-            (q.weeklyLimitOpus > 0
-                ? `  Opus        ${q.weeklyHoursOpus}h / ${q.weeklyLimitOpus}h  this week\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 {
@@ -250,13 +292,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
@@ -292,25 +359,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 {
@@ -326,15 +417,14 @@ program
     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) => {
+    .command('roast')
+    .description('Roast your Claude Code usage habits')
+    .option('--stats', 'Show raw stats only, no roast')
+    .option('--months <n>', 'Look back N months (default: 1)', String, '1')
+    .action(async (opts) => {
     try {
-        const format = (opts.format ?? 'ascii');
-        const copy = !!opts.copy;
-        await (0, share_1.runShare)({ sessionId, format, copy });
+        const months = parseInt(opts.months || '1', 10);
+        await (0, roast_1.runRoast)({ stats: !!opts.stats, months });
         process.exit(0);
     }
     catch (err) {
@@ -343,14 +433,46 @@ program
     }
 });
 program
-    .command('roast')
-    .description('Roast your Claude Code usage habits')
-    .option('--stats', 'Show raw stats only, no roast')
-    .option('--months <n>', 'Look back N months (default: 1)', String, '1')
+    .command('weekly')
+    .description('Show weekly usage summary')
+    .option('--json', 'Output as JSON')
     .action(async (opts) => {
     try {
-        const months = parseInt(opts.months || '1', 10);
-        await (0, roast_1.runRoast)({ stats: !!opts.stats, months });
+        const data = (0, insights_1.getWeeklyInsightData)();
+        if (data.total_sessions === 0) {
+            console.log('\n📊 No usage data yet — start using Claude Code and claudestat will track it.\n');
+            process.exit(0);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            process.exit(0);
+        }
+        console.log((0, insights_1.renderWeeklyInsight)(data));
+        process.exit(0);
+    }
+    catch (err) {
+        console.error('\n❌ Error:', err.message);
+        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) {

package/dist/insights.d.ts

@@ -0,0 +1,45 @@
+export interface WeeklyInsightData {
+    total_sessions: number;
+    total_cost: number;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read: number;
+    cache_hit_pct: number;
+    total_loops: number;
+    avg_efficiency: number;
+    top_tool: string;
+    top_tool_cost_pct: number;
+    week_start: number;
+    week_end: number;
+}
+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;