@statforge/claudestat 1.3.0 → 1.5.0

package/dist/paths.d.ts

@@ -10,6 +10,23 @@
  * Claude Code encodes project paths by replacing path separators AND colons with '-'.
  * This module provides helpers to encode/decode those paths cross-platform.
  */
+/**
+ * Detecta si claudestat está corriendo como binario standalone (Bun compile)
+ * vs desde npm (node dist/index.js).
+ */
+export declare function isBinary(): boolean;
+/**
+ * Retorna el directorio base del binario o del proyecto.
+ * En binario: directorio donde está el ejecutable.
+ * En npm: root del proyecto (unimos dist/..).
+ */
+export declare function getBinaryDir(): string;
+/**
+ * Retorna el directorio del dashboard build (dashboard/dist/).
+ * En binario: busca relativo al binario o en CLAUDESTAT_DATA_DIR.
+ * En npm: usa __dirname para encontrar dist/.
+ */
+export declare function getDashboardDir(): string;
 /**
  * Returns the Claude Code data directory (~/.claude on all platforms).
  * Empirically verified: Claude Code CLI stores settings at ~/.claude on macOS, Linux, and Windows.

package/dist/paths.js

@@ -16,6 +16,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isWindows = void 0;
+exports.isBinary = isBinary;
+exports.getBinaryDir = getBinaryDir;
+exports.getDashboardDir = getDashboardDir;
 exports.getClaudeDir = getClaudeDir;
 exports.getClaudestatDir = getClaudestatDir;
 exports.getPidFile = getPidFile;
@@ -28,7 +31,48 @@ exports.whichAllCmd = whichAllCmd;
 exports.portCheckCmd = portCheckCmd;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
 const isWin = process.platform === 'win32';
+// ─── Binary detection ──────────────────────────────────────────────────────────
+/**
+ * Detecta si claudestat está corriendo como binario standalone (Bun compile)
+ * vs desde npm (node dist/index.js).
+ */
+function isBinary() {
+    const arg1 = process.argv[1] ?? '';
+    return !arg1.includes('node_modules') && !arg1.includes('dist/index.js')
+        && !arg1.includes('tsx') && arg1.includes('claudestat');
+}
+/**
+ * Retorna el directorio base del binario o del proyecto.
+ * En binario: directorio donde está el ejecutable.
+ * En npm: root del proyecto (unimos dist/..).
+ */
+function getBinaryDir() {
+    if (isBinary()) {
+        return path_1.default.dirname(process.argv[1]);
+    }
+    return path_1.default.join(__dirname, '..');
+}
+/**
+ * Retorna el directorio del dashboard build (dashboard/dist/).
+ * En binario: busca relativo al binario o en CLAUDESTAT_DATA_DIR.
+ * En npm: usa __dirname para encontrar dist/.
+ */
+function getDashboardDir() {
+    if (isBinary()) {
+        const candidates = [
+            path_1.default.join(getBinaryDir(), 'dashboard'),
+            path_1.default.join(getClaudestatDir(), 'dashboard'),
+            path_1.default.join(getBinaryDir(), '..', 'dashboard', 'dist'),
+        ];
+        for (const c of candidates) {
+            if (fs_1.default.existsSync(path_1.default.join(c, 'index.html')))
+                return c;
+        }
+    }
+    return path_1.default.join(__dirname, '..', 'dashboard', 'dist');
+}
 // ─── Claude Code data directory ────────────────────────────────────────────────
 /**
  * Returns the Claude Code data directory (~/.claude on all platforms).

package/dist/quota-tracker.js

@@ -298,7 +298,6 @@ function computeQuota(forcePlan) {
     const cycleEntries = entries.filter(e => e.ts >= fiveHAgo);
     const cycleTokens = cycleEntries.reduce((sum, e) => sum + (e.inputTokens ?? 0) + (e.outputTokens ?? 0), 0);
     const cyclePct = Math.min(100, Math.round(cycleTokens / limits.tokens5h * 100));
-    const cycleResetMs = Math.max(0, cycleResetAt - now);
     // ─ Semanal por modelo: ventanas de 5 min con actividad ─
     // Contamos ventanas de 5 min distintas con al menos 1 respuesta por modelo
     const sonnetWindows = new Set();

package/dist/roast.js

@@ -79,8 +79,6 @@ async function runRoast(opts) {
     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) => {
         const filled = Math.round(Math.min(pct, 100) / 100 * width);
         const color = pct >= 90 ? '\x1b[31m' : pct >= 70 ? '\x1b[33m' : '\x1b[32m';

package/dist/routes/events.js

@@ -17,8 +17,14 @@ const quota_tracker_1 = require("../quota-tracker");
 const config_1 = require("../config");
 const rate_limiter_1 = require("../middleware/rate-limiter");
 const stream_1 = require("./stream");
+const notifier_1 = require("../notifier");
 const enricher_1 = require("../enricher");
 Object.defineProperty(exports, "processLatestForSession", { enumerable: true, get: function () { return enricher_1.processLatestForSession; } });
+// ─── Loop alert cooldown (toolName:sessionId → last alert ts) ─────────────────
+const loopAlertCooldown = new Map();
+const LOOP_ALERT_COOLDOWN_MS = 120000; // coincide con LOOP_COOLDOWN_MS en intelligence.ts
+// ─── Session cost alert: sesiones que ya recibieron notificación ───────────────
+const sessionCostAlertFired = new Set();
 exports.eventsRouter = (0, express_1.Router)();
 // Skill activa por sesión — se setea tras Skill Done, se limpia en Stop.
 // Permite taggear los eventos siguientes con skill_parent para agruparlos en la UI.
@@ -69,14 +75,14 @@ exports.eventsRouter.post('/event', (req, res) => {
         res.status(429).json({ error: 'Too many requests — wait 1 minute' });
         return;
     }
-    const { type, session_id, tool_name, tool_input, tool_response, ts, cwd, transcript_path } = req.body;
+    const { type, session_id, tool_name, tool_input, tool_response, ts, cwd, transcript_path, source } = req.body;
     if (!session_id || !type) {
         res.status(400).json({ error: 'Missing session_id or type' });
         return;
     }
     const resolvedCwd = cwd
         ?? (transcript_path ? path_1.default.dirname(transcript_path) || undefined : undefined);
-    db_1.dbOps.upsertSession({ id: session_id, cwd: resolvedCwd, started_at: ts, last_event_at: ts });
+    db_1.dbOps.upsertSession({ id: session_id, cwd: resolvedCwd, started_at: ts, last_event_at: ts, source });
     // Skill grouping: get current parent BEFORE processing this event
     // (the Skill Done event itself is NOT tagged — only its subsequent sub-calls are)
     const skillParent = (tool_name !== 'Skill' && type !== 'Stop')
@@ -106,7 +112,7 @@ exports.eventsRouter.post('/event', (req, res) => {
             session_id, type,
             tool_name: tool_name ?? undefined,
             tool_input: tool_input ? JSON.stringify(tool_input) : undefined,
-            ts, cwd: resolvedCwd, skill_parent: skillParent
+            ts, cwd: resolvedCwd, skill_parent: skillParent, source
         });
         (0, stream_1.broadcast)({ type: 'event', payload: { ...req.body, skill_parent: skillParent } });
         // Stop limpia el skill activo para esta sesión
@@ -202,12 +208,12 @@ exports.eventsRouter.post('/event', (req, res) => {
  * 2. Guarda el coste + score en DB
  * 3. Hace broadcast vía SSE para que el watch muestre el coste actualizado
  */
-const onCostUpdate = (sessionId, cost) => {
+const onCostUpdate = (sessionId, cost, source) => {
     // Ensure session row exists — sub-agent JSONLs arrive from the enricher without a
     // prior hook event (Claude Code does not fire hooks for sub-agent sessions).
     let sessionRow = db_1.dbOps.getSession(sessionId);
     if (!sessionRow) {
-        db_1.dbOps.upsertSession({ id: sessionId, cwd: undefined, started_at: cost.firstTs ?? Date.now(), last_event_at: cost.firstTs ?? Date.now() });
+        db_1.dbOps.upsertSession({ id: sessionId, cwd: undefined, started_at: cost.firstTs ?? Date.now(), last_event_at: cost.firstTs ?? Date.now(), source });
         sessionRow = db_1.dbOps.getSession(sessionId);
     }
     // Sub-agent detection: first time we see a session, check if its firstTs falls after
@@ -248,6 +254,24 @@ const onCostUpdate = (sessionId, cost) => {
             projected_hourly_usd: projectedHourlyUsd,
         }
     });
+    // ─── Session cost alert: notificar si la sesión supera el límite configurado ──
+    const cfg = (0, config_1.readConfig)();
+    if (cfg.alertsEnabled && cfg.sessionCostLimitUsd > 0 && cost.cost_usd >= cfg.sessionCostLimitUsd && !sessionCostAlertFired.has(sessionId)) {
+        sessionCostAlertFired.add(sessionId);
+        (0, notifier_1.sendDesktopNotification)('claudestat — Session cost limit reached', `Session cost: $${cost.cost_usd.toFixed(2)} — limit $${cfg.sessionCostLimitUsd.toFixed(2)} reached`);
+    }
+    // ─── Loop alert: notificación de escritorio si hay loops activos ─────────────
+    if (cfg.alertsEnabled && report.loops.length > 0) {
+        const now = Date.now();
+        for (const loop of report.loops) {
+            const key = `${loop.toolName}:${sessionId}`;
+            const lastSent = loopAlertCooldown.get(key) ?? 0;
+            if (now - lastSent >= LOOP_ALERT_COOLDOWN_MS) {
+                loopAlertCooldown.set(key, now);
+                (0, notifier_1.sendDesktopNotification)('claudestat — Loop detected', `${loop.toolName} called ${loop.count}× in 2min — session may be stuck`);
+            }
+        }
+    }
     // Emitir desglose de costo del último bloque (input vs output) para el TracePanel
     if (cost.lastEntry) {
         (0, stream_1.broadcast)({

package/dist/routes/misc.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.miscRouter = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
 const express_1 = require("express");
 const db_1 = require("../db");
 const intelligence_1 = require("../intelligence");
@@ -23,6 +22,7 @@ const projects_1 = require("./projects");
 const session_state_1 = require("../session-state");
 const stream_1 = require("./stream");
 const paths_1 = require("../paths");
+const cost_projector_1 = require("../cost-projector");
 exports.miscRouter = (0, express_1.Router)();
 // ─── GET /git?path=... — git info para un proyecto ────────────────────────────
 exports.miscRouter.get('/git', (req, res) => {
@@ -90,7 +90,7 @@ exports.miscRouter.get('/kill-switch', (_req, res) => {
         const data = (0, quota_tracker_1.computeQuota)(cfg.plan ?? undefined);
         const blocked = cfg.killSwitchEnabled && data.cyclePct >= cfg.killSwitchThreshold;
         const reason = blocked
-            ? `5h quota at ${data.cyclePct}% (limit: ${cfg.killSwitchThreshold}%). Resets in ${formatMs(data.cycleResetMs)}.`
+            ? `Quota at ${data.cyclePct}% — kill switch threshold is ${cfg.killSwitchThreshold}%. Resets in ${formatMs(data.cycleResetMs)}.`
             : undefined;
         res.json({ blocked, reason, cyclePct: data.cyclePct });
     }
@@ -135,7 +135,6 @@ exports.miscRouter.get('/system-config', (_req, res) => {
         return;
     }
     try {
-        const home = os_1.default.homedir();
         const claudeDir = (0, paths_1.getClaudeDir)();
         let hooks = {};
         try {
@@ -257,24 +256,7 @@ exports.miscRouter.put('/config', (req, res) => {
         res.status(500).json({ error: String(e) });
     }
 });
-// ─── GET /cost-projection — weekly/monthly cost projection ──────────────────
+// ─── GET /cost-projection — linear regression cost projection ───────────────
 exports.miscRouter.get('/cost-projection', (_req, res) => {
-    const week = db_1.dbOps.getCostProjection(7);
-    const month = db_1.dbOps.getCostProjection(30);
-    const weekSpan = week.latest && week.earliest ? (week.latest - week.earliest) / 86400000 : 0;
-    const monthSpan = month.latest && month.earliest ? (month.latest - month.earliest) / 86400000 : 0;
-    const weeklyProjected = weekSpan > 0.5 ? (week.total_cost_usd ?? 0) / weekSpan * 7 : 0;
-    const monthlyProjected = monthSpan > 1 ? (month.total_cost_usd ?? 0) / monthSpan * 30 : 0;
-    res.json({
-        weekly: {
-            daysWithData: Math.round(weekSpan * 10) / 10,
-            costSoFar: week.total_cost_usd ?? 0,
-            projected: Math.round(weeklyProjected * 100) / 100,
-        },
-        monthly: {
-            daysWithData: Math.round(monthSpan * 10) / 10,
-            costSoFar: month.total_cost_usd ?? 0,
-            projected: Math.round(monthlyProjected * 100) / 100,
-        },
-    });
+    res.json((0, cost_projector_1.computeProjection)(90));
 });

package/dist/routes/stream.d.ts

@@ -5,4 +5,4 @@ export declare const sessionLastEvent: Map<string, {
 }>;
 export declare function broadcast(msg: object): void;
 export declare function getSseClientsSize(): number;
-export declare function setOnCostUpdateRef(cb: (sessionId: string, cost: any) => void): void;
+export declare function setOnCostUpdateRef(cb: (sessionId: string, cost: any, source?: string) => void): void;

package/dist/routes/stream.js

@@ -54,13 +54,13 @@ exports.streamRouter.get('/stream', (req, res) => {
             : allEvents;
         const lastEvt = exports.sessionLastEvent.get(latestSession.id);
         const state = (0, session_state_1.deriveSessionState)(lastEvt?.type, lastEvt?.ts ?? latestSession.last_event_at ?? latestSession.started_at);
-        (0, enricher_1.getAllBlockCostsForSession)(latestSession.id).then(blockCosts => {
+        (0, enricher_1.getAllBlockCostsForSession)(latestSession.id).then((blockCosts) => {
             const subAgentSessions = db_1.dbOps.getChildSessions(latestSession.id);
             res.write(`data: ${JSON.stringify({ type: 'init', session: { ...latestSession, state }, events, blockCosts, subAgentSessions })}\n\n`);
             if (_onCostUpdateRef) {
-                (0, enricher_1.processLatestForSession)(latestSession.id, _onCostUpdateRef).catch(err => console.error('[stream] Error processing latest session:', err));
+                (0, enricher_1.processLatestForSession)(latestSession.id, _onCostUpdateRef).catch((err) => console.error('[stream] Error processing latest session:', err));
             }
-        }).catch(err => {
+        }).catch((err) => {
             console.error('[stream] Error loading block costs:', err);
             const subAgentSessions = db_1.dbOps.getChildSessions(latestSession.id);
             res.write(`data: ${JSON.stringify({ type: 'init', session: { ...latestSession, state }, events, blockCosts: [], subAgentSessions })}\n\n`);

package/dist/service.js

@@ -12,9 +12,16 @@ const PLIST_LABEL = 'com.statforge.claudestat';
 const PLIST_PATH = path_1.default.join(process.env.HOME ?? '~', 'Library', 'LaunchAgents', `${PLIST_LABEL}.plist`);
 const SYSTEMD_DIR = path_1.default.join(process.env.HOME ?? '~', '.config', 'systemd', 'user');
 const SYSTEMD_PATH = path_1.default.join(SYSTEMD_DIR, 'claudestat.service');
+function isBinary() {
+    return process.argv[1]?.includes('claudestat') && !process.argv[1]?.includes('node_modules')
+        && !process.argv[1]?.includes('dist/index.js');
+}
+function serviceCommand() {
+    if (isBinary())
+        return process.argv[1];
+    return `${process.execPath} ${process.argv[1]}`;
+}
 function makePlist() {
-    const node = process.execPath;
-    const script = process.argv[1];
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -23,8 +30,7 @@ function makePlist() {
   <string>${PLIST_LABEL}</string>
   <key>ProgramArguments</key>
   <array>
-    <string>${node}</string>
-    <string>${script}</string>
+    <string>${serviceCommand()}</string>
     <string>start</string>
   </array>
   <key>EnvironmentVariables</key>
@@ -40,15 +46,13 @@ function makePlist() {
 </plist>`;
 }
 function makeUnit() {
-    const node = process.execPath;
-    const script = process.argv[1];
     return `[Unit]
 Description=ClaudeStat daemon — real-time Claude Code monitor
 After=default.target
 
 [Service]
 Type=simple
-ExecStart=${node} ${script} start
+ExecStart=${serviceCommand()} start
 Restart=on-failure
 RestartSec=5
 Environment=CLAUDESTAT_DAEMON=1

package/dist/watchers/adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * adapter.ts — WatcherAdapter interface + factory para Multi-CLI support
+ *
+ * Cada CLI coding (Claude Code, Codex, OpenCode, etc.) tiene su propio
+ * formato de trazas y ubicación de archivos. Este adapter pattern permite
+ * que claudestat las soporte todas con una interfaz común.
+ */
+import type { CostUpdate } from '../db';
+export interface ParsedEvent {
+    sessionId: string;
+    type: string;
+    toolName?: string;
+    toolInput?: string;
+    ts: number;
+    cwd?: string;
+}
+export interface WatcherAdapter {
+    /** Nombre único del CLI (claude-code, codex, opencode, etc.) */
+    readonly name: string;
+    /** Label legible mostrado en UI */
+    readonly label: string;
+    /** Detecta si este CLI está instalado y tiene trazas disponibles */
+    detect(): boolean;
+    /** Directorios/glob a observar con chokidar */
+    getWatchPaths(): string[];
+    /** Parsea una línea de traza en un ParsedEvent */
+    parseEvent(raw: string, filePath: string): ParsedEvent | null;
+    /** Lee y calcula costos acumulados de un archivo de sesión */
+    getSessionCost(filePath: string): Promise<CostUpdate | null>;
+    /** Nombre amigable para el badge de la CLI (ej: "CC", "Codex") */
+    get shortName(): string;
+}
+export declare function registerAdapter(adapter: WatcherAdapter): void;
+export declare function getAdapter(name: string): WatcherAdapter | undefined;
+export declare function getAllAdapters(): WatcherAdapter[];
+export declare function getActiveAdapters(): WatcherAdapter[];
+export declare function getAdapterNames(): string[];

package/dist/watchers/adapter.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * adapter.ts — WatcherAdapter interface + factory para Multi-CLI support
+ *
+ * Cada CLI coding (Claude Code, Codex, OpenCode, etc.) tiene su propio
+ * formato de trazas y ubicación de archivos. Este adapter pattern permite
+ * que claudestat las soporte todas con una interfaz común.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdapter = registerAdapter;
+exports.getAdapter = getAdapter;
+exports.getAllAdapters = getAllAdapters;
+exports.getActiveAdapters = getActiveAdapters;
+exports.getAdapterNames = getAdapterNames;
+// ─── Factory ───────────────────────────────────────────────────────────────────
+const registry = new Map();
+function registerAdapter(adapter) {
+    registry.set(adapter.name, adapter);
+}
+function getAdapter(name) {
+    return registry.get(name);
+}
+function getAllAdapters() {
+    return Array.from(registry.values());
+}
+function getActiveAdapters() {
+    return getAllAdapters().filter(a => a.detect());
+}
+function getAdapterNames() {
+    return Array.from(registry.keys());
+}

package/dist/watchers/amp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * amp.ts — WatcherAdapter para Amp (coding CLI agent)
+ *
+ * Amp stores traces in ~/.amp/logs/ as JSONL files.
+ * This is a scaffold — fill in parseEvent/getSessionCost with sample traces.
+ */
+import { type WatcherAdapter } from './adapter';
+export declare const ampAdapter: WatcherAdapter;

package/dist/watchers/amp.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * amp.ts — WatcherAdapter para Amp (coding CLI agent)
+ *
+ * Amp stores traces in ~/.amp/logs/ as JSONL files.
+ * This is a scaffold — fill in parseEvent/getSessionCost with sample traces.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ampAdapter = void 0;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const adapter_1 = require("./adapter");
+const AMP_DIR = path_1.default.join(os_1.default.homedir(), '.amp', 'logs');
+exports.ampAdapter = {
+    name: 'amp',
+    label: 'Amp',
+    get shortName() { return 'Amp'; },
+    detect() {
+        try {
+            return fs_1.default.existsSync(AMP_DIR);
+        }
+        catch {
+            return false;
+        }
+    },
+    getWatchPaths() {
+        return [`${AMP_DIR}/**/*.jsonl`];
+    },
+    parseEvent(_raw, _filePath) {
+        // TODO: implement when Amp trace format is known
+        return null;
+    },
+    async getSessionCost(_filePath) {
+        // TODO: implement when Amp trace format is known
+        return null;
+    },
+};
+(0, adapter_1.registerAdapter)(exports.ampAdapter);

package/dist/watchers/claude-code.d.ts

@@ -0,0 +1,17 @@
+/**
+ * claude-code.ts — WatcherAdapter para Claude Code
+ *
+ * Claude Code escribe trazas JSONL en ~/.claude/projects/{hash}/{session-id}.jsonl
+ * Cada línea "assistant" contiene usage tokens y modelo.
+ */
+import { type WatcherAdapter } from './adapter';
+import type { BlockCostEntry } from '../db';
+export declare function getContextWindow(model: string): number;
+export declare const claudeCodeAdapter: WatcherAdapter;
+export declare function getAllBlockCostsForSession(sessionId: string): Promise<BlockCostEntry[]>;
+export interface SessionPrompt {
+    index: number;
+    ts: number;
+    text: string;
+}
+export declare function getSessionPrompts(sessionId: string): Promise<SessionPrompt[]>;