@statforge/claudestat 1.4.0 → 1.5.0

package/dist/enricher.js

@@ -1,347 +1,129 @@
 "use strict";
 /**
- * enricher.ts — Enriquecedor de coste desde JSONL de Claude Code
+ * enricher.ts — Watcher multi-CLI usando adapters
  *
- * Claude Code escribe los tokens de cada respuesta en:
- *   ~/.claude/projects/{project-hash}/{session-id}.jsonl
+ * En lugar de hardcodear la lógica de Claude Code, usa el adapter pattern
+ * para soportar múltiples coding CLIs (Claude Code, Codex, OpenCode, etc.).
  *
- * Cada línea de tipo "assistant" contiene:
- *   message.usage.input_tokens
- *   message.usage.output_tokens
- *   message.usage.cache_read_input_tokens
- *   message.usage.cache_creation_input_tokens
- *   message.model
- *
- * El enricher observa cambios en esos archivos (con chokidar),
- * calcula el coste acumulado por sesión y llama al callback
- * para que el daemon actualice la DB y haga broadcast via SSE.
+ * Cada adapter implementa WatcherAdapter (src/watchers/adapter.ts):
+ * - detect()      → si el CLI está instalado
+ * - getWatchPaths() → qué archivos observar
+ * - parseEvent()   → parsear una línea de trace
+ * - getSessionCost() → calcular costos acumulados
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getContextWindow = getContextWindow;
-exports.getAllBlockCostsForSession = getAllBlockCostsForSession;
-exports.getSessionPrompts = getSessionPrompts;
+exports.getSessionPrompts = exports.getContextWindow = exports.getAllBlockCostsForSession = void 0;
 exports.startEnricher = startEnricher;
 exports.stopEnricher = stopEnricher;
 exports.cleanupSession = cleanupSession;
 exports.processLatestForSession = processLatestForSession;
-const promises_1 = __importDefault(require("fs/promises"));
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
 const chokidar_1 = __importDefault(require("chokidar"));
-const paths_1 = require("./paths");
-const pricing_1 = require("./pricing");
-// ─── Context window dinámico ──────────────────────────────────────────────────
-const KNOWN_CONTEXT_WINDOWS = {
-    'claude-opus-4-6': 200000,
-    'claude-sonnet-4-6': 200000,
-    'claude-haiku-4-5': 200000,
-};
-function getContextWindow(model) {
-    return KNOWN_CONTEXT_WINDOWS[model] ?? 200000;
-}
-const fileOffsets = new Map();
-const fileLocks = new Map(); // Lock per file
-const FILE_OFFSET_TTL = 30 * 60000; // 30 minutos
-function cleanupStaleOffsets() {
-    const now = Date.now();
-    for (const [key, entry] of fileOffsets) {
-        if (now - entry.lastAccess > FILE_OFFSET_TTL)
-            fileOffsets.delete(key);
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const adapter_1 = require("./watchers/adapter");
+require("./watchers/claude-code");
+require("./watchers/codex");
+require("./watchers/opencode");
+require("./watchers/amp");
+require("./watchers/droid");
+require("./watchers/codebuff");
+// Re-export Claude Code-specific utilities for routes/stream and routes/misc
+var claude_code_1 = require("./watchers/claude-code");
+Object.defineProperty(exports, "getAllBlockCostsForSession", { enumerable: true, get: function () { return claude_code_1.getAllBlockCostsForSession; } });
+Object.defineProperty(exports, "getContextWindow", { enumerable: true, get: function () { return claude_code_1.getContextWindow; } });
+Object.defineProperty(exports, "getSessionPrompts", { enumerable: true, get: function () { return claude_code_1.getSessionPrompts; } });
+const prevContextBySession = new Map();
+let watcher = null;
+const pendingFiles = new Map();
+const fileLocks = new Map();
+// ─── Adapter lookup por filePath ───────────────────────────────────────────────
+const adapterByDir = new Map();
+function findAdapter(filePath) {
+    for (const [dir, adapter] of adapterByDir) {
+        if (filePath.startsWith(dir))
+            return adapter;
     }
+    return undefined;
 }
-async function processJSONL(filePath) {
-    // Skip if already processing this file
+// ─── Procesamiento de archivos ─────────────────────────────────────────────────
+async function processFile(filePath) {
     if (fileLocks.has(filePath))
         return null;
     fileLocks.set(filePath, Promise.resolve());
-    let fileContent;
     try {
-        fileContent = await promises_1.default.readFile(filePath, 'utf8');
-    }
-    catch {
-        return null;
-    }
-    const currentSize = Buffer.byteLength(fileContent, 'utf8');
-    const knownEntry = fileOffsets.get(filePath);
-    const knownOffset = knownEntry?.offset ?? 0;
-    if (currentSize < knownOffset)
-        fileOffsets.set(filePath, { offset: 0, lastAccess: Date.now() });
-    const totals = {
-        input_tokens: 0, output_tokens: 0,
-        cache_read: 0, cache_creation: 0, cost_usd: 0,
-        context_used: 0, context_window: 200000
-    };
-    let lastInputUsd = 0;
-    let lastOutputUsd = 0;
-    let lastInputTokens = 0;
-    let lastOutputTokens = 0;
-    let lastModel = undefined;
-    let firstTs = undefined;
-    for (const raw of fileContent.split('\n')) {
-        const line = raw.trim();
-        if (!line)
-            continue;
-        try {
-            const obj = JSON.parse(line);
-            if (obj.type !== 'assistant')
-                continue;
-            const msg = obj.message;
-            if (!msg?.usage)
-                continue;
-            const usage = msg.usage;
-            const model = msg.model ?? 'claude-sonnet-4-6';
-            if (firstTs === undefined && obj.timestamp) {
-                try {
-                    firstTs = new Date(obj.timestamp).getTime();
-                }
-                catch (e) { /* ignore invalid timestamp */ }
-            }
-            totals.input_tokens += usage.input_tokens ?? 0;
-            totals.output_tokens += usage.output_tokens ?? 0;
-            totals.cache_read += usage.cache_read_input_tokens ?? 0;
-            totals.cache_creation += usage.cache_creation_input_tokens ?? 0;
-            const resolvedModel = model ?? 'claude-sonnet-4-6';
-            totals.cost_usd += (0, pricing_1.calcCost)(resolvedModel, usage);
-            totals.context_used = (usage.input_tokens ?? 0)
-                + (usage.cache_read_input_tokens ?? 0)
-                + (usage.cache_creation_input_tokens ?? 0);
-            totals.context_window = getContextWindow(resolvedModel);
-            const price = pricing_1.PRICING[resolvedModel] ?? pricing_1.DEFAULT_PRICING;
-            const M = 1000000;
-            lastInputUsd = ((usage.input_tokens ?? 0) * price.input +
-                (usage.cache_read_input_tokens ?? 0) * price.cacheRead +
-                (usage.cache_creation_input_tokens ?? 0) * price.cacheCreate) / M;
-            lastOutputUsd = ((usage.output_tokens ?? 0) * price.output) / M;
-            lastInputTokens = (usage.input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
-            lastOutputTokens = usage.output_tokens ?? 0;
-            lastModel = model ?? lastModel;
-        }
-        catch (e) {
-            console.warn('[enricher] Error calculating cost:', e);
-        }
-    }
-    if (lastInputUsd + lastOutputUsd > 0) {
-        totals.lastEntry = {
-            inputUsd: lastInputUsd,
-            outputUsd: lastOutputUsd,
-            totalUsd: lastInputUsd + lastOutputUsd,
-            inputTokens: lastInputTokens,
-            outputTokens: lastOutputTokens,
-        };
-    }
-    totals.lastModel = lastModel;
-    totals.firstTs = firstTs;
-    fileOffsets.set(filePath, { offset: currentSize, lastAccess: Date.now() });
-    fileLocks.delete(filePath);
-    return totals;
-}
-const blockCostCache = new Map();
-const costCacheLocks = new Map(); // Simple lock flag
-const BLOCK_COST_TTL = 5 * 60000;
-async function getAllBlockCostsForSession(sessionId) {
-    // Return cached if available and not expired
-    const cached = blockCostCache.get(sessionId);
-    if (cached && Date.now() - cached.ts < BLOCK_COST_TTL)
-        return cached.data;
-    // Skip if already calculating for this session
-    if (costCacheLocks.get(sessionId))
-        return cached?.data ?? [];
-    costCacheLocks.set(sessionId, true);
-    try {
-        if (!fs_1.default.existsSync(PROJECTS_DIR))
-            return [];
-        const dirs = await promises_1.default.readdir(PROJECTS_DIR);
-        for (const dir of dirs) {
-            const dirPath = path_1.default.join(PROJECTS_DIR, dir);
-            try {
-                const stat = await promises_1.default.stat(dirPath);
-                if (!stat.isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            const filePath = path_1.default.join(dirPath, `${sessionId}.jsonl`);
-            try {
-                await promises_1.default.access(filePath);
-            }
-            catch {
-                continue;
-            }
-            const result = [];
-            let current = null;
-            const content = await promises_1.default.readFile(filePath, 'utf8');
-            for (const raw of content.split('\n')) {
-                const line = raw.trim();
-                if (!line)
-                    continue;
-                try {
-                    const obj = JSON.parse(line);
-                    if (obj.type === 'human' || obj.type === 'user') {
-                        const msgContent = obj.message?.content;
-                        if (Array.isArray(msgContent) && msgContent[0]?.type === 'tool_result')
-                            continue;
-                        const text = typeof msgContent === 'string' ? msgContent
-                            : Array.isArray(msgContent)
-                                ? (msgContent.find((c) => c?.type === 'text')?.text ?? '')
-                                : '';
-                        if (text.includes('<system-reminder>') || text.includes('<command-name>'))
-                            continue;
-                        current = { inputUsd: 0, outputUsd: 0, totalUsd: 0, inputTokens: 0, outputTokens: 0 };
-                        result.push(current);
-                    }
-                    if (obj.type === 'assistant' && current) {
-                        const usage = obj.message?.usage;
-                        const model = obj.message?.model ?? 'claude-sonnet-4-6';
-                        if (!usage)
-                            continue;
-                        const price = pricing_1.PRICING[model] ?? pricing_1.DEFAULT_PRICING;
-                        const M = 1000000;
-                        const inUsd = ((usage.input_tokens ?? 0) * price.input +
-                            (usage.cache_read_input_tokens ?? 0) * price.cacheRead +
-                            (usage.cache_creation_input_tokens ?? 0) * price.cacheCreate) / M;
-                        const outUsd = ((usage.output_tokens ?? 0) * price.output) / M;
-                        const inTok = (usage.input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
-                        const outTok = usage.output_tokens ?? 0;
-                        current.inputUsd += inUsd;
-                        current.outputUsd += outUsd;
-                        current.totalUsd += inUsd + outUsd;
-                        current.inputTokens += inTok;
-                        current.outputTokens += outTok;
-                    }
-                }
-                catch (e) {
-                    console.warn('[enricher] Error reading JSONL block:', e);
-                }
-            }
-            const filtered = result.filter(b => b.totalUsd > 0);
-            blockCostCache.set(sessionId, { data: filtered, ts: Date.now() });
-            return filtered;
-        }
-    }
-    catch (e) {
-        console.warn('[enricher] Error calculating block costs:', e);
+        const adapter = findAdapter(filePath);
+        if (!adapter)
+            return null;
+        const sessionId = path_1.default.basename(filePath, '.jsonl');
+        if (!sessionId.includes('-') || sessionId.length < 10)
+            return null;
+        const cost = await adapter.getSessionCost(filePath);
+        if (!cost || cost.cost_usd < 0)
+            return null;
+        return { sessionId, cost, source: adapter.name };
     }
     finally {
-        costCacheLocks.delete(sessionId);
+        fileLocks.delete(filePath);
     }
-    return cached?.data ?? [];
 }
-async function getSessionPrompts(sessionId) {
-    try {
-        if (!fs_1.default.existsSync(PROJECTS_DIR))
-            return [];
-        const dirs = await promises_1.default.readdir(PROJECTS_DIR);
-        for (const dir of dirs) {
-            const dirPath = path_1.default.join(PROJECTS_DIR, dir);
-            try {
-                const stat = await promises_1.default.stat(dirPath);
-                if (!stat.isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            const candidates = [
-                path_1.default.join(dirPath, `${sessionId}.jsonl`),
-            ];
-            for (const file of candidates) {
-                try {
-                    await promises_1.default.access(file);
-                }
-                catch {
-                    continue;
-                }
-                const results = [];
-                const content = await promises_1.default.readFile(file, 'utf8');
-                let index = 0;
-                for (const raw of content.split('\n')) {
-                    const line = raw.trim();
-                    if (!line)
-                        continue;
-                    try {
-                        const obj = JSON.parse(line);
-                        if (obj.type !== 'human' && obj.type !== 'user')
-                            continue;
-                        const ts = obj.timestamp ? new Date(obj.timestamp).getTime() : 0;
-                        if (!ts || isNaN(ts))
-                            continue;
-                        const msgContent = obj.message?.content;
-                        let text = '';
-                        if (typeof msgContent === 'string') {
-                            text = msgContent;
-                        }
-                        else if (Array.isArray(msgContent)) {
-                            const textBlocks = msgContent.filter(c => c?.type === 'text');
-                            if (textBlocks.length === 0)
-                                continue;
-                            text = textBlocks.map((c) => c.text ?? '').join('\n').trim();
-                        }
-                        if (text.includes('<command-name>') ||
-                            text.includes('<local-command-stdout>') ||
-                            text.includes('<system-reminder>') ||
-                            text.length === 0)
-                            continue;
-                        index++;
-                        results.push({ index, ts, text });
-                    }
-                    catch { }
-                }
-                return results;
-            }
-        }
-    }
-    catch { }
-    return [];
-}
-// ─── Watcher ─────────────────────────────────────────────────────────────────
-const PROJECTS_DIR = path_1.default.join((0, paths_1.getClaudeDir)(), 'projects');
-const prevContextBySession = new Map();
-let watcher = null;
-const pendingFiles = new Map();
+// ─── Start / Stop ──────────────────────────────────────────────────────────────
 let offsetCleanupInterval = null;
-function startEnricher(onUpdate, onCompact, onSessionEnd) {
-    if (!fs_1.default.existsSync(PROJECTS_DIR)) {
-        console.warn(`[enricher] Directory not found: ${PROJECTS_DIR}`);
+function startEnricher(onUpdate, onCompact) {
+    const adapters = (0, adapter_1.getActiveAdapters)();
+    if (adapters.length === 0) {
+        console.warn('[enricher] No supported CLI tools detected');
         return;
     }
-    watcher = chokidar_1.default.watch(`${PROJECTS_DIR}/**/*.jsonl`, {
+    // Index directories for adapter lookup
+    for (const a of adapters) {
+        for (const watchPath of a.getWatchPaths()) {
+            // Extract base directory from glob pattern
+            const baseDir = watchPath.split('/**')[0];
+            if (baseDir)
+                adapterByDir.set(baseDir, a);
+        }
+    }
+    const watchPaths = adapters.flatMap(a => a.getWatchPaths());
+    console.log(`[enricher] Watching ${adapters.map(a => a.label).join(', ')}`);
+    watcher = chokidar_1.default.watch(watchPaths, {
         persistent: true,
         ignoreInitial: true,
         awaitWriteFinish: {
             stabilityThreshold: 200,
-            pollInterval: 100
-        }
+            pollInterval: 100,
+        },
     });
     const handleFile = (filePath) => {
-        const sessionId = path_1.default.basename(filePath, '.jsonl');
-        if (!sessionId.includes('-') || sessionId.length < 10)
-            return;
         const existing = pendingFiles.get(filePath);
         if (existing)
             clearTimeout(existing);
-        const timer = setTimeout(() => {
+        const timer = setTimeout(async () => {
             pendingFiles.delete(filePath);
-            processJSONL(filePath).then(cost => {
-                if (cost && cost.cost_usd >= 0) {
-                    const prev = prevContextBySession.get(sessionId);
-                    if (onCompact && prev !== undefined && prev > 140000 && cost.context_used < prev * 0.5) {
-                        onCompact(sessionId);
-                    }
-                    prevContextBySession.set(sessionId, cost.context_used);
-                    onUpdate(sessionId, cost);
-                }
-            }).catch(err => console.error('[enricher] Error processing JSONL:', err));
+            const result = await processFile(filePath);
+            if (!result)
+                return;
+            const { sessionId, cost, source } = result;
+            const prev = prevContextBySession.get(sessionId);
+            if (onCompact && prev !== undefined && prev > 140000 && cost.context_used < prev * 0.5) {
+                onCompact(sessionId);
+            }
+            prevContextBySession.set(sessionId, cost.context_used);
+            onUpdate(sessionId, cost, source);
         }, 100);
         pendingFiles.set(filePath, timer);
     };
     watcher.on('change', handleFile);
     watcher.on('add', handleFile);
-    offsetCleanupInterval = setInterval(cleanupStaleOffsets, 5 * 60000);
-    console.log(`[enricher] Watching ${PROJECTS_DIR}`);
+    offsetCleanupInterval = setInterval(() => {
+        for (const [, adapter] of adapterByDir) {
+            if (typeof adapter.constructor?.name === 'undefined') {
+                // cleanup per-adapter state if needed
+            }
+        }
+    }, 5 * 60000);
 }
 function stopEnricher() {
     if (watcher) {
@@ -355,46 +137,44 @@ function stopEnricher() {
     for (const [, timer] of pendingFiles)
         clearTimeout(timer);
     pendingFiles.clear();
-    fileOffsets.clear();
     prevContextBySession.clear();
-    blockCostCache.clear();
+    adapterByDir.clear();
     console.log('[enricher] Stopped');
 }
 function cleanupSession(sessionId) {
-    blockCostCache.delete(sessionId);
     prevContextBySession.delete(sessionId);
-    for (const [key, entry] of fileOffsets) {
-        if (key.includes(sessionId))
-            fileOffsets.delete(key);
-    }
 }
-async function processLatestForSession(sessionId, onUpdate) {
-    try {
-        if (!fs_1.default.existsSync(PROJECTS_DIR))
-            return;
-        const dirs = await promises_1.default.readdir(PROJECTS_DIR);
-        for (const dir of dirs) {
-            const dirPath = path_1.default.join(PROJECTS_DIR, dir);
-            try {
-                const stat = await promises_1.default.stat(dirPath);
-                if (!stat.isDirectory())
-                    continue;
-            }
-            catch {
+// ─── Legacy: processLatestForSession (now adapter-agnostic) ─────────────────────
+async function processLatestForSession(sessionId, onUpdate, source) {
+    const adapters = source
+        ? [(0, adapter_1.getAdapter)(source)].filter(Boolean)
+        : (0, adapter_1.getActiveAdapters)();
+    for (const adapter of adapters) {
+        for (const watchPath of adapter.getWatchPaths()) {
+            const baseDir = watchPath.split('/**')[0];
+            if (!baseDir)
                 continue;
-            }
-            const filePath = path_1.default.join(dirPath, `${sessionId}.jsonl`);
-            try {
-                await promises_1.default.access(filePath);
-            }
-            catch {
+            if (!fs_1.default.existsSync(baseDir))
                 continue;
+            const dirs = fs_1.default.readdirSync(baseDir);
+            for (const dir of dirs) {
+                const dirPath = path_1.default.join(baseDir, dir);
+                try {
+                    if (!fs_1.default.statSync(dirPath).isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                const filePath = path_1.default.join(dirPath, `${sessionId}.jsonl`);
+                if (!fs_1.default.existsSync(filePath))
+                    continue;
+                const cost = await adapter.getSessionCost(filePath);
+                if (cost && cost.cost_usd >= 0) {
+                    onUpdate(sessionId, cost, adapter.name);
+                }
+                return;
             }
-            const cost = await processJSONL(filePath);
-            if (cost && cost.cost_usd >= 0)
-                onUpdate(sessionId, cost);
-            return;
         }
     }
-    catch { }
 }

package/dist/index.js

@@ -29,6 +29,7 @@ const export_1 = require("./export");
 const config_1 = require("./config");
 const doctor_1 = require("./doctor");
 const roast_1 = require("./roast");
+const cost_projector_1 = require("./cost-projector");
 const insights_1 = require("./insights");
 const paths_1 = require("./paths");
 const quota_tracker_1 = require("./quota-tracker");
@@ -247,14 +248,13 @@ program
     .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([
+        const [quotaRes] = await Promise.all([
             fetch('http://localhost:7337/quota'),
             fetch('http://localhost:7337/health'),
         ]);
         if (!quotaRes.ok)
             throw new Error('Daemon unavailable');
         const q = await quotaRes.json();
-        const _h = await healthRes.json().catch(() => ({}));
         if (opts.json) {
             console.log(JSON.stringify({
                 cyclePrompts: q.cyclePrompts,
@@ -556,4 +556,25 @@ program
         process.exit(1);
     }
 });
+program
+    .command('project')
+    .description('Show cost projection with linear regression')
+    .option('--days <number>', 'Look back N days for data (default 90)')
+    .option('--json', 'Output raw JSON')
+    .action((opts) => {
+    try {
+        const days = Math.max(7, Math.min(365, parseInt(opts.days ?? '90', 10) || 90));
+        const p = (0, cost_projector_1.computeProjection)(days);
+        if (opts.json) {
+            console.log(JSON.stringify(p, null, 2));
+            process.exit(0);
+        }
+        console.log((0, cost_projector_1.formatProjection)(p));
+        process.exit(0);
+    }
+    catch (err) {
+        console.error('\n❌ Error:', err.message);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/insights.js

@@ -223,8 +223,6 @@ function renderWeeklyInsight(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 bar = (pct, width = 20) => {
         const filled = Math.round(Math.min(pct, 100) / 100 * width);

package/dist/meta-stats.js

@@ -74,7 +74,7 @@ function fmtTok(n) {
  *   - {project}/AGENTS.md         — instructions for agent mode
  *   - {project}/.claude/CLAUDE.md — alternative project-level location
  */
-function resolveContextCandidates(homeDir, projectCwd) {
+function resolveContextCandidates(_homeDir, projectCwd) {
     const claudeDir = (0, paths_1.getClaudeDir)();
     const candidates = [
         { label: 'CLAUDE.md (global)', filePath: path_1.default.join(claudeDir, 'CLAUDE.md') },

package/dist/middleware/rate-limiter.js

@@ -23,7 +23,7 @@ const rateLimitCleanupInterval = setInterval(() => {
     const now = Date.now();
     rateLimitMap.forEach((v, k) => { if (now - v.windowStart > RATE_LIMIT_WINDOW_MS)
         rateLimitMap.delete(k); });
-}, 5 * 60000);
+}, 5 * 60000).unref();
 function stopRateLimiter() {
     clearInterval(rateLimitCleanupInterval);
     rateLimitMap.clear();

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.