@statforge/claudestat 1.2.0 → 1.2.3

package/dist/insights.js

@@ -1,10 +1,16 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWeeklyInsightData = getWeeklyInsightData;
 exports.generateTip = generateTip;
+exports.getUsageInsights = getUsageInsights;
+exports.renderInsights = renderInsights;
 exports.shouldShowInsight = shouldShowInsight;
 exports.markInsightShown = markInsightShown;
 exports.renderWeeklyInsight = renderWeeklyInsight;
+const path_1 = __importDefault(require("path"));
 const db_1 = require("./db");
 const WEEK_MS = 7 * 86400000;
 const META_KEY = 'last_insight_at';
@@ -58,6 +64,145 @@ function generateTip(d) {
     }
     return 'Enable quota alerts with "claudestat config --alerts true" to avoid surprise limits';
 }
+function getUsageInsights(days = 7) {
+    const agg = db_1.dbOps.getWeeklyInsight(days);
+    const aggTotal = db_1.dbOps.getWeeklyInsight(days * 2);
+    const prevSessions = aggTotal.total_sessions - agg.total_sessions;
+    const effDelta = prevSessions > 2
+        ? Math.round(agg.avg_efficiency -
+            (aggTotal.avg_efficiency * aggTotal.total_sessions - agg.avg_efficiency * agg.total_sessions) / prevSessions)
+        : -999;
+    const totalInputWithCache = agg.input_tokens + agg.cache_read;
+    const cacheHitPct = totalInputWithCache > 0
+        ? Math.min(100, Math.round(agg.cache_read / totalInputWithCache * 100))
+        : 0;
+    const outputInputRatio = agg.input_tokens > 0
+        ? parseFloat((agg.output_tokens / agg.input_tokens).toFixed(1))
+        : 0;
+    const ratioLabel = outputInputRatio > 10 ? 'cache-heavy workload'
+        : outputInputRatio > 5 ? 'generation-heavy'
+            : outputInputRatio > 2 ? 'balanced'
+                : 'reading-heavy';
+    const CACHE_READ_PRICE = {
+        'claude-haiku-4-5-20251001': 0.30 / 1000000,
+        'claude-sonnet-4-6': 2.70 / 1000000,
+        'claude-opus-4-6': 3.00 / 1000000,
+    };
+    const DEFAULT_CACHE_PRICE = 2.70 / 1000000;
+    const cacheByModel = db_1.dbOps.getCacheReadByModel(days);
+    const cacheSavings = cacheByModel.reduce((total, row) => {
+        const price = CACHE_READ_PRICE[row.model] ?? DEFAULT_CACHE_PRICE;
+        return total + row.cache_read * price;
+    }, 0);
+    return {
+        days,
+        total_sessions: agg.total_sessions,
+        total_cost: agg.total_cost,
+        avg_cost_per_session: agg.total_sessions > 0 ? agg.total_cost / agg.total_sessions : 0,
+        cache_savings_usd: cacheSavings,
+        cache_hit_pct: cacheHitPct,
+        output_input_ratio: outputInputRatio,
+        ratio_label: ratioLabel,
+        avg_efficiency: Math.round(agg.avg_efficiency),
+        efficiency_delta: effDelta,
+        total_loops: agg.total_loops,
+        project_costs: db_1.dbOps.getProjectCosts(days),
+        hour_ranges: (() => {
+            const hours = db_1.dbOps.getHourlyDistribution(days);
+            const dawn = hours.filter(h => h.hour >= 0 && h.hour <= 5).reduce((s, h) => s + h.session_count, 0);
+            const morn = hours.filter(h => h.hour >= 6 && h.hour <= 11).reduce((s, h) => s + h.session_count, 0);
+            const after = hours.filter(h => h.hour >= 12 && h.hour <= 17).reduce((s, h) => s + h.session_count, 0);
+            const night = hours.filter(h => h.hour >= 18 && h.hour <= 23).reduce((s, h) => s + h.session_count, 0);
+            return [
+                { emoji: '🌙', from: '00:00', to: '05:59', count: dawn },
+                { emoji: '🌅', from: '06:00', to: '11:59', count: morn },
+                { emoji: '☀️', from: '12:00', to: '17:59', count: after },
+                { emoji: '🌆', from: '18:00', to: '23:59', count: night },
+            ].filter(r => r.count > 0);
+        })(),
+    };
+}
+function renderInsights(d) {
+    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 M = '\x1b[35m';
+    const bar = (pct, width = 20) => '█'.repeat(Math.round(pct / 100 * width)) + '░'.repeat(width - Math.round(pct / 100 * width));
+    const fmtDollar = (n) => n < 0.01 ? '< $0.01' : `$${n.toFixed(2)}`;
+    const lines = [];
+    lines.push(`\n${B}💡 claudestat insights${R}  ${D}last ${d.days} days${R}`);
+    lines.push('━'.repeat(44));
+    // Cost summary
+    lines.push(`\n  💰  ${B}${fmtDollar(d.avg_cost_per_session)}/session${R}  ·  ${d.total_sessions} sessions  ·  ${fmtDollar(d.total_cost)} total`);
+    // Top projects
+    if (d.project_costs.length > 0) {
+        lines.push(`\n  🗂  Top projects`);
+        const topTotal = d.project_costs.reduce((s, p) => s + p.total_cost, 0);
+        const shown = d.project_costs.slice(0, 4);
+        const otherCost = d.total_cost - shown.reduce((s, p) => s + p.total_cost, 0);
+        for (let i = 0; i < shown.length; i++) {
+            const p = shown[i];
+            const pct = topTotal > 0 ? Math.round(p.total_cost / topTotal * 100) : 0;
+            const name = path_1.default.basename(p.project).slice(0, 14).padEnd(14);
+            lines.push(`     ${C}${name}${R}  ${bar(pct)}  ${fmtDollar(p.total_cost)}  ${D}${pct}%${R}`);
+            if (i < shown.length - 1 || (otherCost > 0.01 && d.project_costs.length > 4))
+                lines.push('');
+        }
+        if (otherCost > 0.01 && d.project_costs.length > 4) {
+            const pct = topTotal > 0 ? Math.round(otherCost / topTotal * 100) : 0;
+            lines.push(`     ${'other'.padEnd(14)}  ${bar(pct)}  ${fmtDollar(otherCost)}  ${D}${pct}%${R}`);
+        }
+    }
+    // Cache savings
+    const savingsLabel = d.cache_savings_usd >= 0.01
+        ? `${G}~${fmtDollar(d.cache_savings_usd)}${R} saved`
+        : 'no savings yet';
+    lines.push(`\n  ⚡  Cache ${savingsLabel}  ·  ${d.cache_hit_pct}% hit rate`);
+    // Output/input ratio
+    lines.push(`\n  📊  ${B}${d.output_input_ratio}×${R} output/input  ·  ${D}${d.ratio_label}${R}`);
+    // Efficiency trend
+    let effTrend = '';
+    if (d.efficiency_delta !== -999) {
+        const arrow = d.efficiency_delta > 0
+            ? `${G}↑ +${d.efficiency_delta}${R}`
+            : d.efficiency_delta < 0 ? `${Y}↓ ${d.efficiency_delta}${R}` : '→ same';
+        effTrend = `  ${arrow} vs prev period`;
+    }
+    const loopLabel = d.total_loops > 0 ? `  ·  ${Y}${d.total_loops} loops${R}` : '';
+    lines.push(`\n  📈  Efficiency  ${B}${d.avg_efficiency}/100${R}${effTrend}${loopLabel}`);
+    // Activity by time range
+    if (d.hour_ranges.length > 0) {
+        lines.push(`\n  ⏰  Activity by time of day`);
+        const maxCount = Math.max(...d.hour_ranges.map(r => r.count));
+        for (let i = 0; i < d.hour_ranges.length; i++) {
+            const r = d.hour_ranges[i];
+            const pct = maxCount > 0 ? Math.round(r.count / maxCount * 100) : 0;
+            lines.push(`     ${r.emoji}  ${D}${r.from}–${r.to}${R}  ${M}${bar(pct)}${R}  ${D}${r.count} sessions${R}`);
+            if (i < d.hour_ranges.length - 1)
+                lines.push('');
+        }
+    }
+    // Model breakdown
+    const models = db_1.dbOps.getModelBreakdown(d.days);
+    const modelsWithCost = models.filter(m => m.total_cost > 0);
+    if (modelsWithCost.length >= 2) {
+        lines.push(`\n  🤖  Models`);
+        for (let i = 0; i < modelsWithCost.length; i++) {
+            const m = modelsWithCost[i];
+            const pct = d.total_cost > 0 ? Math.round(m.total_cost / d.total_cost * 100) : 0;
+            const rawName = (m.model ?? 'unknown').replace(/^<|>$/g, '');
+            const name = rawName.slice(0, 28).padEnd(28);
+            lines.push(`     ${C}${name}${R}  ${bar(pct)}  ${fmtDollar(m.total_cost)}  ${D}${pct}% · ${m.session_count} sessions${R}`);
+            if (i < modelsWithCost.length - 1)
+                lines.push('');
+        }
+    }
+    lines.push('\n' + '━'.repeat(44) + '\n');
+    return lines.join('\n');
+}
 function shouldShowInsight() {
     const last = db_1.dbOps.getMeta(META_KEY);
     if (!last)
@@ -75,31 +220,38 @@ function renderWeeklyInsight(d) {
             return `${Math.round(n / 1000)}K`;
         return n.toString();
     };
-    const fmtCost = (n) => `$${n.toFixed(2)}`;
-    const fmtDate = (ts) => {
-        const d = new Date(ts);
-        return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
-    };
     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 >= 90 ? '\x1b[31m' : pct >= 70 ? '\x1b[33m' : '\x1b[32m';
+        return `${color}${'█'.repeat(filled)}${R}${D}${'░'.repeat(width - filled)}${R}`;
+    };
+    const fmtDate = (ts) => {
+        const dt = new Date(ts);
+        return dt.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+    };
     const lines = [];
-    lines.push(`\n${B}📊 claudestat weekly insight${R} ${D}(${fmtDate(d.week_start)} – ${fmtDate(d.week_end)})${R}`);
-    lines.push(`${'─'.repeat(60)}`);
-    lines.push(`   Sessions: ${d.total_sessions}  ·  Cost: ${fmtCost(d.total_cost)}  ·  Loops: ${d.total_loops}`);
-    lines.push(`   Top tool: ${d.top_tool} (${d.top_tool_cost_pct}% of cost)  ·  Efficiency: ${d.avg_efficiency}/100`);
-    const cacheLabel = d.total_sessions > 0
-        ? `  ·  Cache hit: ${d.cache_hit_pct}%`
-        : '';
-    const tokLabel = d.input_tokens + d.output_tokens > 0
-        ? `  ·  Tokens: ${fmtTok(d.input_tokens)}+${fmtTok(d.output_tokens)}`
-        : '';
-    if (cacheLabel || tokLabel) {
-        lines.push(`  ${D}${tokLabel}${cacheLabel}${R}`);
-    }
-    lines.push(`${'─'.repeat(60)}`);
-    lines.push(`   ${C}⚡${R} Tip: ${generateTip(d)}`);
+    lines.push(`\n${B}📊 claudestat weekly${R}  ${D}${fmtDate(d.week_start)} – ${fmtDate(d.week_end)}${R}`);
+    lines.push('━'.repeat(44));
+    lines.push('');
+    lines.push(`  💰  ${B}$${d.total_cost.toFixed(2)}${R} total  ·  ${B}${d.total_sessions}${R} sessions  ·  ${B}${d.total_loops}${R} loops`);
+    lines.push('');
+    lines.push(`  🔧  Top tool    ${B}${d.top_tool}${R}  ${D}${d.top_tool_cost_pct}% of cost${R}`);
+    lines.push('');
+    lines.push(`  📈  Efficiency    ${bar(d.avg_efficiency)}  ${B}${d.avg_efficiency}/100${R}`);
+    lines.push('');
+    lines.push(`  💾  Cache hit     ${bar(d.cache_hit_pct)}  ${B}${d.cache_hit_pct}%${R}`);
+    lines.push('');
+    lines.push(`  📦  Tokens  ${D}${fmtTok(d.input_tokens)} in + ${fmtTok(d.output_tokens)} out${R}`);
+    lines.push('');
+    lines.push(`  ${C}⚡  Tip:${R} ${generateTip(d)}`);
+    lines.push('');
+    lines.push('━'.repeat(44));
     lines.push('');
     return lines.join('\n');
 }

package/dist/install.js

@@ -20,6 +20,7 @@ exports.uninstallHooks = uninstallHooks;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const readline_1 = __importDefault(require("readline"));
+const child_process_1 = require("child_process");
 const paths_1 = require("./paths");
 const config_1 = require("./config");
 const CLAUDESTAT_DIR = (0, paths_1.getClaudestatDir)();
@@ -98,7 +99,9 @@ async function runInstall() {
     }
     else {
         showInstallStatus();
+        installMcp();
     }
+    process.exit(0);
 }
 async function runWizard() {
     const nonInteractive = !process.stdin.isTTY;
@@ -150,6 +153,42 @@ async function runWizard() {
     }
     // Paso 5: instalar hooks
     installHooks();
+    // Paso 6: registrar MCP server en Claude Code
+    installMcp();
+}
+function installMcp() {
+    const nodeExec = process.execPath;
+    const mcpScript = path_1.default.join(__dirname, 'mcp-server.js');
+    const manualCmd = `claude mcp add claudestat -s user -- "${nodeExec}" --disable-warning=ExperimentalWarning "${mcpScript}"`;
+    try {
+        const result = (0, child_process_1.spawnSync)('claude', ['mcp', 'list'], { encoding: 'utf8', timeout: 15000 });
+        const list = (result.stdout ?? '') + (result.stderr ?? '');
+        const mcpLine = list.split('\n').find((l) => l.includes('claudestat'));
+        if (mcpLine && !mcpLine.includes('Failed') && !mcpLine.includes('✗')) {
+            console.log('  (already registered): MCP server');
+            return;
+        }
+        if (mcpLine) {
+            // Registered but failing — remove from both scopes and re-register
+            (0, child_process_1.spawnSync)('claude', ['mcp', 'remove', 'claudestat', '-s', 'user'], { encoding: 'utf8' });
+            (0, child_process_1.spawnSync)('claude', ['mcp', 'remove', 'claudestat', '-s', 'local'], { encoding: 'utf8' });
+        }
+    }
+    catch {
+        console.log('\n⚠  Could not reach "claude" CLI — skipping MCP setup.');
+        console.log('   To register manually:');
+        console.log(`   ${manualCmd}\n`);
+        return;
+    }
+    try {
+        (0, child_process_1.execSync)(manualCmd, { stdio: 'pipe' });
+        console.log('✓ MCP server registered (user scope)\n');
+    }
+    catch (err) {
+        console.log('\n⚠  MCP registration failed.');
+        console.log('   To register manually:');
+        console.log(`   ${manualCmd}\n`);
+    }
 }
 function showInstallStatus() {
     const cfg = (0, config_1.readConfig)();

package/dist/mcp-server.d.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
 /**
  * mcp-server.ts — MCP (Model Context Protocol) server for claudestat
  *

package/dist/mcp-server.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
 "use strict";
 /**
  * mcp-server.ts — MCP (Model Context Protocol) server for claudestat
@@ -50,9 +50,10 @@ const readline = __importStar(require("readline"));
 const db_1 = require("./db");
 const quota_tracker_1 = require("./quota-tracker");
 const insights_1 = require("./insights");
+const config_1 = require("./config");
 const SERVER_NAME = 'claudestat';
-const SERVER_VERSION = '1.2.0';
-const PROTOCOL_VERSION = '2025-06-18';
+const SERVER_VERSION = '1.2.2';
+const PROTOCOL_VERSION = '2025-03-26';
 const TOOLS = [
     {
         name: 'get_quota_status',
@@ -104,6 +105,34 @@ const TOOLS = [
             required: []
         }
     },
+    {
+        name: 'get_usage_insights',
+        description: 'Get unique usage insights not available in /usage: cost per project, cache savings, output/input ratio, efficiency trend, and peak hours',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'number',
+                    description: 'Days to look back (default 7)'
+                }
+            },
+            required: []
+        }
+    },
+    {
+        name: 'get_model_breakdown',
+        description: 'Get cost and session count broken down by Claude model (Sonnet, Haiku, Opus) for the last N days',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'number',
+                    description: 'Days to look back (default 7)'
+                }
+            },
+            required: []
+        }
+    },
     {
         name: 'get_weekly_insight',
         description: 'Get the weekly usage summary with an actionable tip (same as claudestat weekly command)',
@@ -141,10 +170,13 @@ function toolGetQuotaStatus() {
         : `${resetMin}m`;
     const weeklyTotalHours = q.weeklyHoursSonnet + q.weeklyHoursOpus;
     const weeklyLimitTotal = q.weeklyLimitSonnet + q.weeklyLimitOpus;
+    const planLabel = q.planSource === 'inferred'
+        ? `${q.detectedPlan.toUpperCase()} plan (unverified — checking API...)`
+        : `${q.detectedPlan.toUpperCase()} plan`;
     const parts = [
-        `Quota status — ${q.detectedPlan.toUpperCase()} plan`,
+        `Quota status — ${planLabel}`,
         ``,
-        `5h cycle:    ${q.cyclePrompts}/${q.cycleLimit} prompts (${q.cyclePct}%)  ·  resets in ${resetLabel}`,
+        `5h cycle:    ${q.cyclePct}%  ·  ${q.cyclePrompts > q.cycleLimit ? `${q.cyclePrompts}/${q.cycleLimit} prompts (OVER LIMIT)` : `${q.cyclePrompts}/${q.cycleLimit} prompts`}  ·  resets in ${resetLabel}`,
         `Weekly:      ${weeklyTotalHours}h / ${weeklyLimitTotal}h (${q.weeklyPctAll}%)`,
     ];
     if (q.weeklyLimitOpus > 0) {
@@ -154,6 +186,33 @@ function toolGetQuotaStatus() {
     if (q.burnRateTokensPerMin > 0) {
         parts.push(`Burn rate:   ${q.burnRateTokensPerMin.toLocaleString()} tokens/min`);
     }
+    // Active alerts — only shown when thresholds are crossed
+    const cfg = (0, config_1.readConfig)();
+    if (cfg.alertsEnabled) {
+        const alerts = [];
+        const cycleLevel = (0, config_1.getWarnLevel)(q.cyclePct, cfg.warnThresholds);
+        const weeklyLevel = (0, config_1.getWarnLevel)(q.weeklyPctAll, cfg.weeklyWarnThresholds);
+        if (cycleLevel === 'red')
+            alerts.push(`🔴 5h cycle at ${q.cyclePct}% — critical, limit imminent`);
+        else if (cycleLevel)
+            alerts.push(`⚠️  5h cycle at ${q.cyclePct}% — approaching limit`);
+        if (weeklyLevel === 'red')
+            alerts.push(`🔴 Weekly at ${q.weeklyPctAll}% — critical`);
+        else if (weeklyLevel)
+            alerts.push(`⚠️  Weekly at ${q.weeklyPctAll}% — approaching weekly limit`);
+        if (q.cyclePrompts > q.cycleLimit) {
+            alerts.push(`⚠️  Prompt count (${q.cyclePrompts}) exceeds plan limit (${q.cycleLimit}) — plan may be mis-detected`);
+        }
+        const reminderMins = cfg.resetReminderMins ?? 10;
+        if (reminderMins > 0 && resetMin <= reminderMins && resetMin > 0) {
+            alerts.push(`⏰  Cycle resets in ${resetMin}m — good time to wrap up or start fresh`);
+        }
+        if (alerts.length > 0) {
+            parts.push(``);
+            parts.push(`─── ACTIVE ALERTS ───────────────────────`);
+            parts.push(...alerts);
+        }
+    }
     return parts.join('\n');
 }
 function toolGetCurrentSession() {
@@ -221,6 +280,71 @@ function toolGetTopTools(days, sortBy) {
     }
     return lines.join('\n');
 }
+function toolGetUsageInsights(days) {
+    const d = Math.max(1, Math.min(90, Math.floor(days || 7)));
+    const i = (0, insights_1.getUsageInsights)(d);
+    if (i.total_sessions === 0)
+        return `No data for the last ${d} days.`;
+    const bar = (pct, width = 20) => '█'.repeat(Math.round(pct / 100 * width)) + '░'.repeat(width - Math.round(pct / 100 * width));
+    const lines = [];
+    lines.push(`💡 Usage insights — last ${d} days`);
+    lines.push('━'.repeat(44));
+    lines.push(``);
+    lines.push(`  💰  ${fmtDollar(i.avg_cost_per_session)}/session  ·  ${i.total_sessions} sessions  ·  ${fmtDollar(i.total_cost)} total`);
+    if (i.project_costs.length > 0) {
+        lines.push(``);
+        lines.push(`  🗂  Top projects`);
+        const topTotal = i.project_costs.reduce((s, p) => s + p.total_cost, 0);
+        for (const p of i.project_costs.slice(0, 4)) {
+            const pct = topTotal > 0 ? Math.round(p.total_cost / topTotal * 100) : 0;
+            const name = (p.project.split('/').pop() ?? p.project).slice(0, 14).padEnd(14);
+            lines.push(`     ${name}  ${bar(pct)}  ${fmtDollar(p.total_cost)}  ${pct}%`);
+        }
+    }
+    lines.push(``);
+    lines.push(`  ⚡  Cache ~${fmtDollar(i.cache_savings_usd)} saved  ·  ${i.cache_hit_pct}% hit rate`);
+    lines.push(``);
+    lines.push(`  📊  ${i.output_input_ratio}× output/input  ·  ${i.ratio_label}`);
+    lines.push(``);
+    const effTrend = i.efficiency_delta !== -999
+        ? `  ${i.efficiency_delta > 0 ? `↑ +${i.efficiency_delta}` : i.efficiency_delta < 0 ? `↓ ${i.efficiency_delta}` : '→ same'} vs prev period`
+        : '';
+    lines.push(`  📈  Efficiency  ${i.avg_efficiency}/100${effTrend}  ·  ${i.total_loops} loops`);
+    if (i.hour_ranges.length > 0) {
+        lines.push(``);
+        lines.push(`  ⏰  Activity by time of day`);
+        const maxCount = Math.max(...i.hour_ranges.map(r => r.count));
+        for (let j = 0; j < i.hour_ranges.length; j++) {
+            const r = i.hour_ranges[j];
+            const pct = maxCount > 0 ? Math.round(r.count / maxCount * 100) : 0;
+            lines.push(`     ${r.emoji}  ${r.from}–${r.to}  ${bar(pct)}  ${r.count} sessions`);
+            if (j < i.hour_ranges.length - 1)
+                lines.push('');
+        }
+    }
+    lines.push(``);
+    lines.push('━'.repeat(44));
+    return lines.join('\n');
+}
+function toolGetModelBreakdown(days) {
+    const d = Math.max(1, Math.min(90, Math.floor(days || 7)));
+    const models = db_1.dbOps.getModelBreakdown(d);
+    if (models.length === 0)
+        return `No model data in the last ${d} days.`;
+    const totalCost = models.reduce((s, m) => s + m.total_cost, 0);
+    const lines = [
+        `Model breakdown — last ${d} days`,
+        '',
+    ];
+    for (const m of models) {
+        const pct = totalCost > 0 ? Math.round(m.total_cost / totalCost * 100) : 0;
+        const rawName = (m.model ?? 'unknown').replace(/^<|>$/g, '');
+        const name = rawName.padEnd(30);
+        const cost = fmtDollar(m.total_cost).padEnd(10);
+        lines.push(`  ${name}${cost}${pct}%   ${m.session_count} sessions`);
+    }
+    return lines.join('\n');
+}
 function toolGetWeeklyInsight(days) {
     const d = Math.max(1, Math.min(90, Math.floor(days || 7)));
     const data = (0, insights_1.getWeeklyInsightData)(d);
@@ -239,25 +363,25 @@ function toolGetWeeklyInsight(days) {
         `Tip: ${(0, insights_1.generateTip)(data)}`,
     ].join('\n');
 }
-function handleToolCall(name, args) {
-    const days = typeof args.days === 'number' ? args.days : 7;
+async function handleToolCall(name, args) {
     const sortBy = typeof args.sort_by === 'string' ? args.sort_by : 'cost';
     switch (name) {
-        case 'get_quota_status': return toolGetQuotaStatus();
+        case 'get_quota_status':
+            await (0, quota_tracker_1.refreshFromApi)();
+            return toolGetQuotaStatus();
         case 'get_current_session': return toolGetCurrentSession();
-        case 'get_session_stats': return toolGetSessionStats(days);
-        case 'get_top_tools': return toolGetTopTools(days, sortBy);
-        case 'get_weekly_insight': return toolGetWeeklyInsight(days);
+        case 'get_session_stats': return toolGetSessionStats(typeof args.days === 'number' ? args.days : 7);
+        case 'get_top_tools': return toolGetTopTools(typeof args.days === 'number' ? args.days : 30, sortBy);
+        case 'get_usage_insights': return toolGetUsageInsights(typeof args.days === 'number' ? args.days : 7);
+        case 'get_model_breakdown': return toolGetModelBreakdown(typeof args.days === 'number' ? args.days : 7);
+        case 'get_weekly_insight': return toolGetWeeklyInsight(typeof args.days === 'number' ? args.days : 7);
         default: return `Unknown tool: ${name}`;
     }
 }
-function handleRequest(msg) {
+async function handleRequest(msg) {
     const { id, method, params } = msg;
-    if (id === undefined) {
-        if (method === 'notifications/initialized')
-            return null;
+    if (id === undefined)
         return null;
-    }
     try {
         switch (method) {
             case 'initialize':
@@ -274,7 +398,7 @@ function handleRequest(msg) {
             case 'tools/call': {
                 const toolName = params?.name;
                 const toolArgs = (params?.arguments ?? {});
-                const text = handleToolCall(toolName, toolArgs);
+                const text = await handleToolCall(toolName, toolArgs);
                 return {
                     jsonrpc: '2.0', id,
                     result: { content: [{ type: 'text', text }], isError: false }
@@ -301,10 +425,12 @@ rl.on('line', (line) => {
         return;
     try {
         const msg = JSON.parse(trimmed);
-        const response = handleRequest(msg);
-        if (response) {
-            process.stdout.write(JSON.stringify(response) + '\n');
-        }
+        handleRequest(msg).then(response => {
+            if (response)
+                process.stdout.write(JSON.stringify(response) + '\n');
+        }).catch((e) => {
+            process.stderr.write(`[claudestat-mcp] Handler error: ${e.message}\n`);
+        });
     }
     catch (e) {
         process.stderr.write(`[claudestat-mcp] Parse error: ${e.message}\n`);
@@ -312,4 +438,5 @@ rl.on('line', (line) => {
 });
 process.on('SIGTERM', () => process.exit(0));
 process.on('SIGINT', () => process.exit(0));
+// API quota is refreshed on-demand per get_quota_status call (disk cache throttles to 1 call/5min)
 process.stderr.write(`[claudestat-mcp] Server ready (stdio, protocol ${PROTOCOL_VERSION})\n`);

package/dist/notifier.js

@@ -8,15 +8,33 @@ const child_process_1 = require("child_process");
 const os_1 = __importDefault(require("os"));
 function sendDesktopNotification(title, body) {
     try {
-        if (os_1.default.platform() === 'darwin') {
-            const escaped = body.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-            (0, child_process_1.execSync)(`osascript -e 'display notification "${escaped}" with title "${title}"'`, { stdio: 'ignore' });
+        const platform = os_1.default.platform();
+        if (platform === 'darwin') {
+            const t = title.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+            const b = body.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+            (0, child_process_1.execSync)(`osascript -e 'display notification "${b}" with title "${t}"'`, { stdio: 'ignore', timeout: 5000 });
         }
-        else if (os_1.default.platform() === 'linux') {
-            (0, child_process_1.execSync)(`notify-send "${title}" "${body}"`, { stdio: 'ignore' });
+        else if (platform === 'linux') {
+            (0, child_process_1.execSync)(`notify-send "${title}" "${body}"`, { stdio: 'ignore', timeout: 5000 });
+        }
+        else if (platform === 'win32') {
+            // UTF-16LE base64-encoded PowerShell to handle any special characters safely
+            const script = [
+                `Add-Type -AssemblyName System.Windows.Forms`,
+                `$n = New-Object System.Windows.Forms.NotifyIcon`,
+                `$n.Icon = [System.Drawing.SystemIcons]::Information`,
+                `$n.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::Info`,
+                `$n.BalloonTipTitle = '${title.replace(/'/g, "''")}'`,
+                `$n.BalloonTipText  = '${body.replace(/'/g, "''")}'`,
+                `$n.Visible = $true`,
+                `$n.ShowBalloonTip(5000)`,
+                `Start-Sleep -Milliseconds 200`,
+            ].join('; ');
+            const encoded = Buffer.from(script, 'utf16le').toString('base64');
+            (0, child_process_1.execSync)(`powershell -NoProfile -NonInteractive -EncodedCommand ${encoded}`, { stdio: 'ignore', timeout: 8000 });
         }
     }
     catch {
-        // notification not available — already logged to console
+        // notification unavailable — silent fallback
     }
 }

package/dist/pattern-analyzer.d.ts

@@ -12,6 +12,7 @@
  *   - High cache ratio → positive: great cost efficiency
  *   - High avg cost    → consider Haiku for simpler tasks
  *   - Low efficiency   → linked to loops
+ *   - Write vs Edit    → suggest Edit for incremental changes
  */
 export type InsightLevel = 'tip' | 'warning' | 'positive';
 export interface PatternInsight {

package/dist/pattern-analyzer.js

@@ -13,6 +13,7 @@
  *   - High cache ratio → positive: great cost efficiency
  *   - High avg cost    → consider Haiku for simpler tasks
  *   - Low efficiency   → linked to loops
+ *   - Write vs Edit    → suggest Edit for incremental changes
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzePatterns = analyzePatterns;
@@ -52,6 +53,18 @@ function analyzePatterns(toolCounts, stats) {
             metric: `${bashPct}% Bash (${bashCount}) vs ${readGrep} Read+Grep+Glob`,
         });
     }
+    // ── Heavy Write vs Edit ────────────────────────────────────────────────────
+    const writeCount = get('Write');
+    const editCount = get('Edit');
+    const writePct = Math.round(writeCount / totalTools * 100);
+    if (writeCount > editCount * 3 && writeCount >= 10) {
+        insights.push({
+            level: 'tip',
+            title: 'Heavy Write vs Edit usage',
+            description: 'More than 3× Write calls vs Edit calls. Editing existing files is cheaper in tokens than writing from scratch. Consider using Edit for incremental changes instead of rewriting entire files.',
+            metric: `${writePct}% Write (${writeCount} writes vs ${editCount} edits)`,
+        });
+    }
     // ── High loop rate ────────────────────────────────────────────────────────
     if (stats.avg_loops >= 1.5) {
         insights.push({

package/dist/quota-tracker.d.ts

@@ -38,6 +38,12 @@ export interface QuotaData {
     planSource: 'config' | 'keychain' | 'inferred';
     computedAt: number;
 }
+/**
+ * Llama a la API de Anthropic para obtener los % de quota exactos que muestra claude.ai.
+ * Actualiza apiCache si la llamada tiene éxito; de lo contrario, no hace nada (silent fallback).
+ * Debe llamarse periódicamente desde el daemon y al inicio del MCP server.
+ */
+export declare function refreshFromApi(): Promise<void>;
 /**
  * Calcula y retorna QuotaData.
  * Usa caché de 30s para no re-leer todos los JSONL en cada request del dashboard.