@statforge/claudestat 1.5.0 → 1.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Deiby Gorrin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/daemon.js

@@ -167,7 +167,7 @@ function shutdown(server) {
         alertInterval = null;
     }
     cleanPid();
-    server.close();
+    server.close(() => { });
 }
 const LEVEL_RANK = { yellow: 1, orange: 2, red: 3 };
 const LEVEL_COLOR = {

package/dist/enricher.js

@@ -123,7 +123,7 @@ function startEnricher(onUpdate, onCompact) {
                 // cleanup per-adapter state if needed
             }
         }
-    }, 5 * 60000);
+    }, 5 * 60000).unref();
 }
 function stopEnricher() {
     if (watcher) {

package/dist/paths.js

@@ -79,7 +79,7 @@ function getDashboardDir() {
  * Empirically verified: Claude Code CLI stores settings at ~/.claude on macOS, Linux, and Windows.
  */
 function getClaudeDir() {
-    return path_1.default.join(os_1.default.homedir(), '.claude');
+    return process.env.CLAUDE_DIR ?? path_1.default.join(os_1.default.homedir(), '.claude');
 }
 // ─── ClaudeStat data directory ─────────────────────────────────────────────────
 /**

package/dist/routes/events.d.ts

@@ -5,8 +5,6 @@ export declare const lastAgentByCwd: Map<string, {
     session_id: string;
 }>;
 export declare const taggedSessionParents: Set<string>;
-/** Sube el árbol desde un file_path hasta encontrar HANDOFF.md → directorio del proyecto */
-export declare function findProjectCwdForFile(filePath: string): string | undefined;
 /**
  * Cuando el enricher detecta nuevos tokens en un JSONL:
  * 1. Corre el análisis de inteligencia

package/dist/routes/events.js

@@ -5,9 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processLatestForSession = exports.onCompactDetected = exports.onCostUpdate = exports.taggedSessionParents = exports.lastAgentByCwd = exports.eventsRouter = void 0;
-exports.findProjectCwdForFile = findProjectCwdForFile;
 const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
 const express_1 = require("express");
 const db_1 = require("../db");
 const intelligence_1 = require("../intelligence");
@@ -18,6 +16,7 @@ const config_1 = require("../config");
 const rate_limiter_1 = require("../middleware/rate-limiter");
 const stream_1 = require("./stream");
 const notifier_1 = require("../notifier");
+const helpers_1 = require("./helpers");
 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) ─────────────────
@@ -56,19 +55,6 @@ function shouldFireAlert(level, pct) {
     alertCooldown.set(level, Date.now());
     return true;
 }
-/** Sube el árbol desde un file_path hasta encontrar HANDOFF.md → directorio del proyecto */
-function findProjectCwdForFile(filePath) {
-    let dir = path_1.default.dirname(filePath);
-    for (let i = 0; i < 6; i++) {
-        if (fs_1.default.existsSync(path_1.default.join(dir, 'HANDOFF.md')))
-            return dir;
-        const parent = path_1.default.dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return undefined;
-}
 exports.eventsRouter.post('/event', (req, res) => {
     const ip = req.ip ?? '127.0.0.1';
     if ((0, rate_limiter_1.isRateLimited)(ip)) {
@@ -132,7 +118,7 @@ exports.eventsRouter.post('/event', (req, res) => {
             const inp = typeof tool_input === 'string' ? JSON.parse(tool_input) : (tool_input ?? {});
             const filePath = inp?.file_path ?? inp?.path;
             if (typeof filePath === 'string' && path_1.default.isAbsolute(filePath)) {
-                const projectCwd = findProjectCwdForFile(filePath);
+                const projectCwd = (0, helpers_1.findProjectCwdForFile)(filePath);
                 if (projectCwd)
                     db_1.dbOps.updateSessionProject(session_id, projectCwd);
             }

package/dist/routes/helpers.d.ts

@@ -0,0 +1,2 @@
+/** Sube el árbol desde un file_path hasta encontrar HANDOFF.md → directorio del proyecto */
+export declare function findProjectCwdForFile(filePath: string): string | undefined;

package/dist/routes/helpers.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findProjectCwdForFile = findProjectCwdForFile;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+/** Sube el árbol desde un file_path hasta encontrar HANDOFF.md → directorio del proyecto */
+function findProjectCwdForFile(filePath) {
+    let dir = path_1.default.dirname(filePath);
+    for (let i = 0; i < 6; i++) {
+        if (fs_1.default.existsSync(path_1.default.join(dir, 'HANDOFF.md')))
+            return dir;
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}

package/dist/routes/projects.d.ts

@@ -1,7 +1,5 @@
 import { type EventRow } from '../db';
 export declare const projectsRouter: import("express-serve-static-core").Router;
-/** Sube el árbol desde un file_path hasta encontrar HANDOFF.md → directorio del proyecto */
-export declare function findProjectCwdForFile(filePath: string): string | undefined;
 /** Infiere el proyecto activo mirando los eventos de archivo de una sesión */
 export declare function inferProjectCwd(events: EventRow[]): string | undefined;
 /**

package/dist/routes/projects.js

@@ -5,29 +5,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectsRouter = void 0;
-exports.findProjectCwdForFile = findProjectCwdForFile;
 exports.inferProjectCwd = inferProjectCwd;
 exports.inferActiveProjectByMajority = inferActiveProjectByMajority;
 const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
 const express_1 = require("express");
 const db_1 = require("../db");
 const projects_cache_1 = require("../cache/projects-cache");
 const pattern_analyzer_1 = require("../pattern-analyzer");
+const helpers_1 = require("./helpers");
 exports.projectsRouter = (0, express_1.Router)();
-/** Sube el árbol desde un file_path hasta encontrar HANDOFF.md → directorio del proyecto */
-function findProjectCwdForFile(filePath) {
-    let dir = path_1.default.dirname(filePath);
-    for (let i = 0; i < 6; i++) {
-        if (fs_1.default.existsSync(path_1.default.join(dir, 'HANDOFF.md')))
-            return dir;
-        const parent = path_1.default.dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return undefined;
-}
 /** Infiere el proyecto activo mirando los eventos de archivo de una sesión */
 function inferProjectCwd(events) {
     const FILE_TOOLS = new Set(['Read', 'Write', 'Edit', 'Glob', 'Grep']);
@@ -41,7 +27,7 @@ function inferProjectCwd(events) {
             const filePath = (inp.file_path || inp.path);
             if (!filePath || !path_1.default.isAbsolute(filePath))
                 continue;
-            const cwd = findProjectCwdForFile(filePath);
+            const cwd = (0, helpers_1.findProjectCwdForFile)(filePath);
             if (cwd)
                 return cwd;
         }
@@ -73,7 +59,7 @@ function inferActiveProjectByMajority(events, windowMs) {
             const filePath = (inp.file_path || inp.path);
             if (!filePath || !path_1.default.isAbsolute(filePath))
                 continue;
-            const project = findProjectCwdForFile(filePath);
+            const project = (0, helpers_1.findProjectCwdForFile)(filePath);
             if (!project)
                 continue;
             const entry = hits.get(project) ?? { count: 0, lastTs: 0 };

package/dist/watch.js

@@ -80,7 +80,6 @@ async function startWatch() {
     }
     fetchQuota().then(pct => { state.cyclePct = pct; });
     setInterval(async () => { state.cyclePct = await fetchQuota(); }, 30000);
-    // Refrescar stats semanales cada 5 minutos
     setInterval(() => { state.weekly = (0, weekly_1.readWeeklyStats)(); }, 5 * 60 * 1000);
     function draw() {
         if (state.sessionId) {

package/dist/watchdog.d.ts

@@ -1,6 +1,11 @@
 /**
  * watchdog.ts — Daemon auto-restart mechanism
  *
+ * NOTE: The watchdog currently runs in the same process as the daemon.
+ * This means it cannot restart the daemon if the process crashes.
+ * For true resilience, the watchdog should be spawned as a separate
+ * process via `child_process.spawn()` with `detached: true`.
+ *
  * If the daemon process crashes or is killed unexpectedly, the watchdog
  * detects the stale PID file and relaunches the daemon automatically.
  *

package/dist/watchdog.js

@@ -2,6 +2,11 @@
 /**
  * watchdog.ts — Daemon auto-restart mechanism
  *
+ * NOTE: The watchdog currently runs in the same process as the daemon.
+ * This means it cannot restart the daemon if the process crashes.
+ * For true resilience, the watchdog should be spawned as a separate
+ * process via `child_process.spawn()` with `detached: true`.
+ *
  * If the daemon process crashes or is killed unexpectedly, the watchdog
  * detects the stale PID file and relaunches the daemon automatically.
  *
@@ -69,7 +74,7 @@ function startWatchdog() {
             catch { }
             restartDaemon();
         }
-    }, CHECK_INTERVAL_MS);
+    }, CHECK_INTERVAL_MS).unref();
     process.on('SIGTERM', () => { clearInterval(interval); process.exit(0); });
     process.on('SIGINT', () => { clearInterval(interval); process.exit(0); });
 }

package/dist/watchers/claude-code.js

@@ -19,7 +19,7 @@ const fs_1 = __importDefault(require("fs"));
 const adapter_1 = require("./adapter");
 const paths_1 = require("../paths");
 const pricing_1 = require("../pricing");
-const PROJECTS_DIR = path_1.default.join((0, paths_1.getClaudeDir)(), 'projects');
+function projectsDir() { return path_1.default.join((0, paths_1.getClaudeDir)(), 'projects'); }
 const KNOWN_CONTEXT_WINDOWS = {
     'claude-opus-4-6': 200000,
     'claude-sonnet-4-6': 200000,
@@ -119,14 +119,14 @@ exports.claudeCodeAdapter = {
     get shortName() { return 'CC'; },
     detect() {
         try {
-            return fs_1.default.existsSync(PROJECTS_DIR);
+            return fs_1.default.existsSync(projectsDir());
         }
         catch {
             return false;
         }
     },
     getWatchPaths() {
-        return [`${PROJECTS_DIR}/**/*.jsonl`];
+        return [`${projectsDir()}/**/*.jsonl`];
     },
     parseEvent(raw, _filePath) {
         try {
@@ -164,11 +164,11 @@ async function getAllBlockCostsForSession(sessionId) {
         return cached?.data ?? [];
     costCacheLocks.set(sessionId, true);
     try {
-        if (!fs_1.default.existsSync(PROJECTS_DIR))
+        if (!fs_1.default.existsSync(projectsDir()))
             return [];
-        const dirs = await promises_1.default.readdir(PROJECTS_DIR);
+        const dirs = await promises_1.default.readdir(projectsDir());
         for (const dir of dirs) {
-            const dirPath = path_1.default.join(PROJECTS_DIR, dir);
+            const dirPath = path_1.default.join(projectsDir(), dir);
             try {
                 const stat = await promises_1.default.stat(dirPath);
                 if (!stat.isDirectory())
@@ -241,11 +241,11 @@ async function getAllBlockCostsForSession(sessionId) {
 }
 async function getSessionPrompts(sessionId) {
     try {
-        if (!fs_1.default.existsSync(PROJECTS_DIR))
+        if (!fs_1.default.existsSync(projectsDir()))
             return [];
-        const dirs = await promises_1.default.readdir(PROJECTS_DIR);
+        const dirs = await promises_1.default.readdir(projectsDir());
         for (const dir of dirs) {
-            const dirPath = path_1.default.join(PROJECTS_DIR, dir);
+            const dirPath = path_1.default.join(projectsDir(), dir);
             try {
                 const stat = await promises_1.default.stat(dirPath);
                 if (!stat.isDirectory())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statforge/claudestat",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -51,6 +51,8 @@
     "hooks/",
     "dashboard/dist/"
   ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
     "claudestat": "dist/index.js",
     "claudestat-mcp": "dist/mcp-server.js"
@@ -61,7 +63,6 @@
     "build:bun": "bun run scripts/build-binary.ts",
     "build:bun:all": "bun run scripts/build-binary.ts --all",
     "prepublishOnly": "npm run build",
-    "prepack": "npm run build",
     "dev": "tsx src/index.ts",
     "dev:full": "tsx src/index.ts start & sleep 1 && cd dashboard && npm run dev",
     "start": "node dist/index.js",