@statforge/claudestat 1.6.1 → 1.8.0

package/dist/config.js

@@ -43,6 +43,13 @@ const DEFAULTS = {
     reportDay: 1,
     reportTime: '09:00',
     alertsEnabled: true,
+    killSwitchForce: false,
+    logLevel: 'info',
+    port: 7337,
+    loopThreshold: 8,
+    loopWindowSecs: 120,
+    projectAliases: {},
+    webhookUrl: null,
 };
 /** Lee la config del disco. Valores ausentes se rellenan con defaults. */
 function readConfig() {
@@ -100,6 +107,30 @@ function validateConfig(raw) {
     }
     if ('alertsEnabled' in cfg && typeof cfg.alertsEnabled !== 'boolean')
         return 'alertsEnabled debe ser boolean';
+    if ('killSwitchForce' in cfg && typeof cfg.killSwitchForce !== 'boolean')
+        return 'killSwitchForce must be boolean';
+    if ('logLevel' in cfg && !['debug', 'info', 'warn', 'error'].includes(cfg.logLevel))
+        return 'logLevel must be: debug, info, warn, error';
+    if ('loopThreshold' in cfg) {
+        const v = cfg.loopThreshold;
+        if (typeof v !== 'number' || !Number.isInteger(v) || v < 2 || v > 50)
+            return 'loopThreshold must be an integer between 2 and 50';
+    }
+    if ('loopWindowSecs' in cfg) {
+        const v = cfg.loopWindowSecs;
+        if (typeof v !== 'number' || !Number.isInteger(v) || v < 10 || v > 600)
+            return 'loopWindowSecs must be an integer between 10 and 600';
+    }
+    if ('projectAliases' in cfg) {
+        const v = cfg.projectAliases;
+        if (typeof v !== 'object' || v === null || Array.isArray(v))
+            return 'projectAliases must be an object { "/path": "Alias" }';
+    }
+    if ('webhookUrl' in cfg) {
+        const v = cfg.webhookUrl;
+        if (v !== null && (typeof v !== 'string' || (!v.startsWith('http://') && !v.startsWith('https://'))))
+            return 'webhookUrl must be null or a valid http/https URL';
+    }
     if ('reportsEnabled' in cfg && typeof cfg.reportsEnabled !== 'boolean')
         return 'reportsEnabled debe ser boolean';
     if ('reportFrequency' in cfg && !['weekly', 'biweekly', 'monthly'].includes(cfg.reportFrequency))
@@ -113,6 +144,11 @@ function validateConfig(raw) {
         if (typeof cfg.reportTime !== 'string' || !/^\d{2}:\d{2}$/.test(cfg.reportTime))
             return 'reportTime debe tener formato HH:MM';
     }
+    if ('port' in cfg) {
+        const v = cfg.port;
+        if (typeof v !== 'number' || !Number.isInteger(v) || v < 1024 || v > 65535)
+            return 'port must be an integer between 1024 and 65535';
+    }
     return null;
 }
 /** Devuelve el nivel de warning para un % dado, o null si no alcanza ningún threshold. */

package/dist/daemon.js

@@ -51,9 +51,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startDaemon = startDaemon;
+const crypto_1 = __importDefault(require("crypto"));
 const express_1 = __importDefault(require("express"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
 const db_1 = require("./db");
 const enricher_1 = require("./enricher");
 const config_1 = require("./config");
@@ -67,11 +69,14 @@ const misc_1 = require("./routes/misc");
 const reports_1 = require("./routes/reports");
 const top_1 = require("./routes/top");
 const opencode_reader_1 = require("./routes/opencode-reader");
+const replay_1 = require("./routes/replay");
+const intents_1 = require("./routes/intents");
 const projects_cache_1 = require("./cache/projects-cache");
 const rate_limiter_1 = require("./middleware/rate-limiter");
 const summarizer_1 = require("./summarizer");
 const paths_1 = require("./paths");
-const PORT = 7337;
+const logger_1 = require("./logger");
+const PORT = (0, config_1.readConfig)().port;
 const app = (0, express_1.default)();
 app.use(express_1.default.json());
 // ─── Shutdown graceful (cross-platform, no depende de SIGTERM) ────────────────
@@ -91,6 +96,8 @@ app.use(misc_1.miscRouter);
 app.use(reports_1.reportsRouter);
 app.use(top_1.topRouter);
 app.use(opencode_reader_1.opencodeReaderRouter);
+app.use(replay_1.replayRouter);
+app.use(intents_1.intentsRouter);
 // ─── GET /health — necesita acceso al tamaño del pool SSE ─────────────────────
 app.get('/health', (_req, res) => {
     res.json({ status: 'ok', port: PORT, clients: (0, stream_1.getSseClientsSize)() });
@@ -112,9 +119,10 @@ app.get('*', (_req, res) => {
 // ─── Migración de arranque: etiquetar sesiones históricas ────────────────────
 function migrateSessionProjects() {
     const sessions = db_1.dbOps.getAllSessions();
+    const HOME = os_1.default.homedir();
     let tagged = 0;
     for (const session of sessions) {
-        if (session?.project_path)
+        if (session?.project_path && session.project_path !== HOME)
             continue;
         const events = db_1.dbOps.getSessionEvents(session.id);
         const projectCwd = (0, projects_1.inferProjectCwd)(events);
@@ -124,7 +132,7 @@ function migrateSessionProjects() {
         }
     }
     if (tagged > 0)
-        console.log(`[daemon] ${tagged} sessions tagged with project`);
+        logger_1.logger.info(`${tagged} sessions tagged with project`);
 }
 /**
  * Genera summaries IA para las últimas N sesiones que no tienen uno.
@@ -141,18 +149,22 @@ async function migrateSessionSummaries(limit = 5) {
             const summary = await (0, summarizer_1.summarizeSession)(events, s.total_cost_usd ?? 0, projectName);
             if (summary) {
                 db_1.dbOps.updateSessionSummary(s.id, summary);
-                console.log(`[daemon] Summary generated for session ${s.id.slice(0, 8)}: "${summary}"`);
+                logger_1.logger.info(`Summary generated for session ${s.id.slice(0, 8)}: "${summary}"`);
             }
         }
         catch (err) {
-            console.error('[daemon] Error generating summary:', err);
+            logger_1.logger.error(`Error generating summary: ${err}`);
         }
     }
 }
+// ─── Previous hashes map for external change detection ──────────────────────────
+let _prevHashes = new Map();
 // ─── Interval refs for cleanup ────────────────────────────────────────────────
 let projectCacheInterval = null;
 let reportInterval = null;
 let alertInterval = null;
+let intentCleanupInterval = null;
+let intentWatchInterval = null;
 function shutdown(server) {
     (0, enricher_1.stopEnricher)();
     (0, rate_limiter_1.stopRateLimiter)();
@@ -168,6 +180,15 @@ function shutdown(server) {
         clearInterval(alertInterval);
         alertInterval = null;
     }
+    if (intentCleanupInterval) {
+        clearInterval(intentCleanupInterval);
+        intentCleanupInterval = null;
+    }
+    if (intentWatchInterval) {
+        clearInterval(intentWatchInterval);
+        intentWatchInterval = null;
+    }
+    _prevHashes.clear();
     cleanPid();
     server.close(() => { });
 }
@@ -186,6 +207,7 @@ function checkAlertLevel(level, lastLevel, logMsg, notifTitle, notifBody) {
     const prevRank = lastLevel ? LEVEL_RANK[lastLevel] ?? 0 : 0;
     const currRank = LEVEL_RANK[level];
     if (currRank > prevRank) {
+        logger_1.logger.warn(logMsg);
         process.stderr.write(`${LEVEL_COLOR[level]}${logMsg}\x1b[0m\n`);
         (0, notifier_1.sendDesktopNotification)(notifTitle, notifBody);
     }
@@ -200,9 +222,37 @@ function startAlertPolling() {
             const data = (0, quota_tracker_1.computeQuota)(cfg.plan ?? undefined);
             const resetMins = Math.ceil(data.cycleResetMs / 60000);
             // ── Cycle 5h alerts ──────────────────────────────────────────────────────
-            _lastCycleAlertLevel = checkAlertLevel((0, config_1.getWarnLevel)(data.cyclePct, cfg.warnThresholds), _lastCycleAlertLevel, `[claudestat] ⚠️  5h cycle at ${data.cyclePct}% (${data.cyclePrompts}/${data.cycleLimit} prompts)`, 'claudestat — 5h cycle alert', `${data.cyclePct}% of cycle used · resets in ${resetMins}m`);
+            const cycleLevel = (0, config_1.getWarnLevel)(data.cyclePct, cfg.warnThresholds);
+            if (cycleLevel && cycleLevel !== _lastCycleAlertLevel) {
+                const webhookUrl = (0, config_1.readConfig)().webhookUrl;
+                if (webhookUrl) {
+                    (0, notifier_1.sendWebhookAlert)(webhookUrl, {
+                        title: 'claudestat — 5h cycle alert',
+                        body: `${data.cyclePct}% of cycle used · resets in ${resetMins}m`,
+                        level: cycleLevel,
+                        cyclePct: data.cyclePct,
+                        resetInMins: resetMins,
+                        burnRate: data.burnRateTokensPerMin,
+                    });
+                }
+            }
+            _lastCycleAlertLevel = checkAlertLevel(cycleLevel, _lastCycleAlertLevel, `[claudestat] ⚠️  5h cycle at ${data.cyclePct}% (${data.cyclePrompts}/${data.cycleLimit} prompts)`, 'claudestat — 5h cycle alert', `${data.cyclePct}% of cycle used · resets in ${resetMins}m`);
             // ── Weekly alerts ────────────────────────────────────────────────────────
-            _lastWeeklyAlertLevel = checkAlertLevel((0, config_1.getWarnLevel)(data.weeklyPctAll, cfg.weeklyWarnThresholds), _lastWeeklyAlertLevel, `[claudestat] ⚠️  Weekly usage at ${data.weeklyPctAll}%`, 'claudestat — Weekly usage alert', `${data.weeklyPctAll}% of weekly quota used`);
+            const weeklyLevel = (0, config_1.getWarnLevel)(data.weeklyPctAll, cfg.weeklyWarnThresholds);
+            if (weeklyLevel && weeklyLevel !== _lastWeeklyAlertLevel) {
+                const webhookUrl = (0, config_1.readConfig)().webhookUrl;
+                if (webhookUrl) {
+                    (0, notifier_1.sendWebhookAlert)(webhookUrl, {
+                        title: 'claudestat — Weekly usage alert',
+                        body: `${data.weeklyPctAll}% of weekly quota used`,
+                        level: weeklyLevel,
+                        cyclePct: data.cyclePct,
+                        weeklyPct: data.weeklyPctAll,
+                        resetInMins: resetMins,
+                    });
+                }
+            }
+            _lastWeeklyAlertLevel = checkAlertLevel(weeklyLevel, _lastWeeklyAlertLevel, `[claudestat] ⚠️  Weekly usage at ${data.weeklyPctAll}%`, 'claudestat — Weekly usage alert', `${data.weeklyPctAll}% of weekly quota used`);
             // ── Reset reminder ───────────────────────────────────────────────────────
             const reminderMs = (cfg.resetReminderMins ?? 10) * 60000;
             if (reminderMs > 0) {
@@ -211,11 +261,28 @@ function startAlertPolling() {
                 }
                 else if (data.cycleResetMs <= reminderMs && data.cycleResetMs > 0 && !_resetReminderFired) {
                     const mins = Math.ceil(data.cycleResetMs / 60000);
+                    logger_1.logger.info(`Quota resets in ${mins}m — good time to wrap up`);
                     process.stderr.write(`\x1b[36m[claudestat] ⏰  Quota resets in ${mins}m — good time to wrap up\x1b[0m\n`);
                     (0, notifier_1.sendDesktopNotification)('claudestat — Quota reset soon', `Your 5h cycle resets in ${mins} min — good time to start a new task`);
                     _resetReminderFired = true;
                 }
             }
+            // Write or remove pause signal file based on kill switch state
+            const signalFile = (0, paths_1.getPauseSignalFile)();
+            if (cfg.killSwitchEnabled && data.cyclePct >= cfg.killSwitchThreshold) {
+                const msg = `Quota at ${data.cyclePct}% — threshold is ${cfg.killSwitchThreshold}%. Resets in ${Math.ceil(data.cycleResetMs / 60000)}m.`;
+                try {
+                    fs_1.default.writeFileSync(signalFile, msg);
+                }
+                catch { }
+                (0, stream_1.broadcast)({ type: 'kill_switch', payload: { blocked: true, reason: msg } });
+            }
+            else {
+                try {
+                    fs_1.default.unlinkSync(signalFile);
+                }
+                catch { }
+            }
         }
         catch {
             // quota read failed — ignore
@@ -242,6 +309,7 @@ function cleanPid() {
 function startDaemon() {
     _server = app.listen(PORT, '127.0.0.1', () => {
         writePid();
+        (0, paths_1.writePortFile)(PORT);
         process.on('exit', cleanPid);
         process.on('SIGTERM', () => { if (_server)
             shutdown(_server); process.exit(0); });
@@ -269,7 +337,7 @@ function startDaemon() {
         // Se ejecuta en background para no retrasar el inicio del servidor
         setImmediate(() => {
             const projects = (0, projects_cache_1.getProjectsCached)();
-            console.log(`[daemon] ${projects?.length ?? 0} projects scanned`);
+            logger_1.logger.info(`${projects?.length ?? 0} projects scanned`);
         });
         // Refresh automático del cache de proyectos cada 2 minutos
         // Recoge cambios en HANDOFF.md aunque el daemon lleve horas corriendo
@@ -291,8 +359,44 @@ function startDaemon() {
                 return; // ya existe
             const markdown = (0, reports_1.generateReport)(dateLabel, cfg);
             db_1.dbOps.insertWeeklyReport(dateLabel, markdown);
-            console.log(`[daemon] Report auto-generated: ${dateLabel}`);
+            logger_1.logger.info(`Report auto-generated: ${dateLabel}`);
         }, 60000);
+        // Al arrancar: liberar intents activos de sesiones anteriores (ya no hay nadie que los use)
+        db_1.dbOps.releaseOrphanedIntents();
+        // Cleanup de intents — cada 2min marca stale los sin heartbeat > 10min, borra viejos > 1h
+        intentCleanupInterval = setInterval(() => {
+            db_1.dbOps.markStaleIntents();
+            db_1.dbOps.deleteOldStaleIntents();
+        }, 2 * 60000);
+        // Watcher de cambios externos — cada 10s compara hashes de archivos en intents activos
+        intentWatchInterval = setInterval(() => {
+            const active = db_1.dbOps.getActiveIntents();
+            if (active.length === 0)
+                return;
+            const fileSet = new Set(active.map(a => a.file_path));
+            for (const filePath of fileSet) {
+                try {
+                    if (!fs_1.default.existsSync(filePath))
+                        continue;
+                    const content = fs_1.default.readFileSync(filePath);
+                    const hash = crypto_1.default.createHash('sha256').update(content).digest('hex');
+                    const prev = _prevHashes.get(filePath);
+                    if (prev && prev !== hash) {
+                        // Check if any active intent covers this file
+                        const coveringIntent = active.find(a => a.file_path === filePath);
+                        const tool = coveringIntent?.tool ?? 'unknown';
+                        (0, stream_1.broadcast)({ type: 'external_change', payload: { file: filePath, tool, hash_prev: prev, hash_now: hash } });
+                    }
+                    _prevHashes.set(filePath, hash);
+                }
+                catch { }
+            }
+            // Cleanup stale entries from prevHashes
+            for (const [fp] of _prevHashes) {
+                if (!fileSet.has(fp))
+                    _prevHashes.delete(fp);
+            }
+        }, 10000);
         // Summaries IA solo si opt-in explícito (CLAUDESTAT_AI_SUMMARY=true)
         if (process.env.CLAUDESTAT_AI_SUMMARY === 'true') {
             migrateSessionSummaries(5).catch(() => { });

package/dist/db.d.ts

@@ -9,6 +9,8 @@
  * El warning "ExperimentalWarning" se suprime en index.ts.
  */
 export declare const CLAUDESTAT_DIR: string;
+export declare const TOOL_RESPONSE_MAX_BYTES = 8192;
+export declare function capToolResponse(raw: string): string;
 export interface SessionRow {
     id: string;
     cwd?: string;
@@ -26,6 +28,22 @@ export interface SessionRow {
     dominant_model?: string;
     parent_session_id?: string;
     source?: string;
+    exact_retries?: number;
+    error_rate?: number;
+    file_churn_score?: number;
+    seq_cycle_count?: number;
+    avg_output_chars?: number;
+    error_block_count?: number;
+    semantic_loop_count?: number;
+}
+export interface AssistantTurnRow {
+    turn_index: number;
+    ts?: number;
+    text_preview?: string;
+    tool_calls?: string[];
+    error_count: number;
+    output_chars: number;
+    context_used: number;
 }
 export interface EventRow {
     id?: number;
@@ -58,17 +76,20 @@ export interface CostUpdate {
     lastEntry?: BlockCostEntry;
     lastModel?: string;
     firstTs?: number;
+    lastTs?: number;
 }
 export declare const dbOps: {
     upsertSession(s: SessionRow): void;
     insertEvent(e: EventRow): number;
+    insertOcEvent(sessionId: string, toolName: string, ts: number, externalId: string): void;
+    insertSessionIfAbsent(s: SessionRow): void;
     /**
      * Al llegar PostToolUse, actualizamos el PreToolUse pendiente más reciente
      * del mismo tool para esta sesión. Esto convierte el par Pre+Post en
      * un único registro de tipo 'Done' con duration_ms calculado.
      */
     pairPostWithPre(sessionId: string, toolName: string, response: string, postTs: number): number | null;
-    updateSessionCost(sessionId: string, cost: CostUpdate, efficiencyScore: number, loopsDetected: number): void;
+    updateSessionCost(sessionId: string, cost: CostUpdate, efficiencyScore: number, loopsDetected: number, exactRetries?: number, errorRate?: number, fileChurnScore?: number, seqCycleCount?: number): void;
     getSessionEvents(sessionId: string): EventRow[];
     getSession(sessionId: string): SessionRow | undefined;
     getLatestSession(): SessionRow | undefined;
@@ -83,6 +104,11 @@ export declare const dbOps: {
         count: number;
     }[];
     getProjectSessionStats(projectPath: string): any;
+    getProjectCliHours(): {
+        project_path: string;
+        source: string;
+        total_ms: number;
+    }[];
     updateSessionSummary(sessionId: string, summary: string): void;
     updateSessionParent(sessionId: string, parentId: string): void;
     getChildSessions(parentSessionId: string): {
@@ -125,8 +151,16 @@ export declare const dbOps: {
     getAnalyticsDaily(since: number): any[];
     getAnalyticsByModel(since: number): any[];
     getProjectHours(since: number): any[];
-    getTopTools(days?: number, by?: "cost" | "count" | "duration", limit?: number): {
+    getCoachEvents(sessionIds: string[]): {
+        session_id: string;
+        type: string;
+        tool_name: string | null;
+        tool_input: string | null;
+        ts: number;
+    }[];
+    getTopTools(days?: number, by?: "cost" | "count" | "duration", limit?: number, source?: "all" | "claude-code" | "opencode"): {
         tool_name: string;
+        source: string;
         count: number;
         total_duration_ms: number;
         total_cost_usd: number;
@@ -142,6 +176,17 @@ export declare const dbOps: {
         week_start: number;
         week_end: number;
     };
+    getPrevWeekInsight(): {
+        total_sessions: any;
+        total_cost: any;
+        input_tokens: any;
+        output_tokens: any;
+        cache_read: any;
+        total_loops: any;
+        avg_efficiency: any;
+        week_start: any;
+        week_end: any;
+    };
     setMeta(key: string, value: string): void;
     getMeta(key: string): string | undefined;
     getCostProjection(days?: number): {
@@ -158,6 +203,9 @@ export declare const dbOps: {
         hour: number;
         session_count: number;
     }[];
+    updateSessionSemantic(sessionId: string, avgOutputChars: number, errorBlockCount: number, semanticLoopCount?: number): void;
+    upsertAssistantTurns(sessionId: string, turns: AssistantTurnRow[]): void;
+    getAssistantTurns(sessionId: string): AssistantTurnRow[];
     getCacheReadByModel(days: number): {
         model: string;
         cache_read: number;
@@ -167,4 +215,41 @@ export declare const dbOps: {
         total_cost: number;
         session_count: number;
     }[];
+    insertIntent(tool: string, sessionId: string, taskDesc: string | undefined): number;
+    insertIntentFile(intentId: number, filePath: string, operation: string, lineStart?: number, lineEnd?: number): void;
+    getWriteConflicts(filePaths: string[], excludeTool: string): {
+        file_path: string;
+        tool: string;
+        session_id: string;
+        task_desc: string | null;
+        acquired_at: number;
+    }[];
+    getIntent(id: number): {
+        tool: string;
+        session_id: string;
+        task_desc: string | null;
+    } | undefined;
+    releaseIntent(id: number): void;
+    heartbeatIntent(id: number): void;
+    getIntentFiles(id: number): {
+        file_path: string;
+        operation: string;
+    }[];
+    getActiveToolsInProject(projectPath: string, excludeTool: string): {
+        source: string;
+        last_event_at: number;
+    }[];
+    releaseOrphanedIntents(): void;
+    markStaleIntents(): {
+        id: number;
+        tool: string;
+        task_desc: string | null;
+    }[];
+    deleteOldStaleIntents(): void;
+    hasActiveIntent(tool: string, filePath: string): boolean;
+    getActiveIntents(): {
+        id: number;
+        tool: string;
+        file_path: string;
+    }[];
 };