@kaitranntt/ccs 6.7.0 → 6.7.1

package/dist/web-server/usage/data-aggregator.js

@@ -0,0 +1,391 @@
+"use strict";
+/**
+ * Data Aggregator for Claude Code Usage Analytics
+ *
+ * Aggregates raw JSONL entries into daily, monthly, and session summaries.
+ * Uses model-pricing.ts for cost calculations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAllUsageData = exports.loadSessionData = exports.loadMonthlyUsageData = exports.loadHourlyUsageData = exports.loadDailyUsageData = exports.aggregateSessionUsage = exports.aggregateMonthlyUsage = exports.aggregateHourlyUsage = exports.aggregateDailyUsage = void 0;
+const model_pricing_1 = require("../model-pricing");
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/** Extract YYYY-MM-DD from ISO timestamp */
+function extractDate(timestamp) {
+    return timestamp.slice(0, 10);
+}
+/** Extract YYYY-MM from ISO timestamp */
+function extractMonth(timestamp) {
+    return timestamp.slice(0, 7);
+}
+/** Extract YYYY-MM-DD HH:00 from ISO timestamp */
+function extractHour(timestamp) {
+    const date = timestamp.slice(0, 10);
+    const hour = timestamp.slice(11, 13) || '00';
+    return `${date} ${hour}:00`;
+}
+/** Create model breakdown from accumulated data */
+function createModelBreakdown(modelName, inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens) {
+    const cost = (0, model_pricing_1.calculateCost)({ inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens }, modelName);
+    return {
+        modelName,
+        inputTokens,
+        outputTokens,
+        cacheCreationTokens,
+        cacheReadTokens,
+        cost,
+    };
+}
+// ============================================================================
+// DAILY AGGREGATION
+// ============================================================================
+/**
+ * Aggregate raw entries into daily usage summaries
+ * Groups by date (YYYY-MM-DD), calculates costs per model
+ */
+function aggregateDailyUsage(entries, source = 'custom-parser') {
+    // Group entries by date
+    const byDate = new Map();
+    for (const entry of entries) {
+        const date = extractDate(entry.timestamp);
+        const existing = byDate.get(date) || [];
+        existing.push(entry);
+        byDate.set(date, existing);
+    }
+    // Build daily summaries
+    const dailyUsage = [];
+    for (const [date, dateEntries] of byDate) {
+        // Aggregate by model
+        const modelMap = new Map();
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCacheCreation = 0;
+        let totalCacheRead = 0;
+        for (const entry of dateEntries) {
+            const model = entry.model;
+            const acc = modelMap.get(model) || {
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+            };
+            acc.inputTokens += entry.inputTokens;
+            acc.outputTokens += entry.outputTokens;
+            acc.cacheCreationTokens += entry.cacheCreationTokens;
+            acc.cacheReadTokens += entry.cacheReadTokens;
+            modelMap.set(model, acc);
+            totalInput += entry.inputTokens;
+            totalOutput += entry.outputTokens;
+            totalCacheCreation += entry.cacheCreationTokens;
+            totalCacheRead += entry.cacheReadTokens;
+        }
+        // Build model breakdowns
+        const modelBreakdowns = [];
+        let totalCost = 0;
+        for (const [modelName, acc] of modelMap) {
+            const breakdown = createModelBreakdown(modelName, acc.inputTokens, acc.outputTokens, acc.cacheCreationTokens, acc.cacheReadTokens);
+            modelBreakdowns.push(breakdown);
+            totalCost += breakdown.cost;
+        }
+        // Sort breakdowns by cost descending
+        modelBreakdowns.sort((a, b) => b.cost - a.cost);
+        dailyUsage.push({
+            date,
+            source,
+            inputTokens: totalInput,
+            outputTokens: totalOutput,
+            cacheCreationTokens: totalCacheCreation,
+            cacheReadTokens: totalCacheRead,
+            cost: totalCost,
+            totalCost,
+            modelsUsed: Array.from(modelMap.keys()),
+            modelBreakdowns,
+        });
+    }
+    // Sort by date descending (most recent first)
+    dailyUsage.sort((a, b) => b.date.localeCompare(a.date));
+    return dailyUsage;
+}
+exports.aggregateDailyUsage = aggregateDailyUsage;
+// ============================================================================
+// HOURLY AGGREGATION
+// ============================================================================
+/**
+ * Aggregate raw entries into hourly usage summaries
+ * Groups by hour (YYYY-MM-DD HH:00), calculates costs per model
+ */
+function aggregateHourlyUsage(entries, source = 'custom-parser') {
+    // Group entries by hour
+    const byHour = new Map();
+    for (const entry of entries) {
+        const hour = extractHour(entry.timestamp);
+        const existing = byHour.get(hour) || [];
+        existing.push(entry);
+        byHour.set(hour, existing);
+    }
+    // Build hourly summaries
+    const hourlyUsage = [];
+    for (const [hour, hourEntries] of byHour) {
+        // Aggregate by model
+        const modelMap = new Map();
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCacheCreation = 0;
+        let totalCacheRead = 0;
+        for (const entry of hourEntries) {
+            const model = entry.model;
+            const acc = modelMap.get(model) || {
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+            };
+            acc.inputTokens += entry.inputTokens;
+            acc.outputTokens += entry.outputTokens;
+            acc.cacheCreationTokens += entry.cacheCreationTokens;
+            acc.cacheReadTokens += entry.cacheReadTokens;
+            modelMap.set(model, acc);
+            totalInput += entry.inputTokens;
+            totalOutput += entry.outputTokens;
+            totalCacheCreation += entry.cacheCreationTokens;
+            totalCacheRead += entry.cacheReadTokens;
+        }
+        // Build model breakdowns
+        const modelBreakdowns = [];
+        let totalCost = 0;
+        for (const [modelName, acc] of modelMap) {
+            const breakdown = createModelBreakdown(modelName, acc.inputTokens, acc.outputTokens, acc.cacheCreationTokens, acc.cacheReadTokens);
+            modelBreakdowns.push(breakdown);
+            totalCost += breakdown.cost;
+        }
+        // Sort breakdowns by cost descending
+        modelBreakdowns.sort((a, b) => b.cost - a.cost);
+        hourlyUsage.push({
+            hour,
+            source,
+            inputTokens: totalInput,
+            outputTokens: totalOutput,
+            cacheCreationTokens: totalCacheCreation,
+            cacheReadTokens: totalCacheRead,
+            cost: totalCost,
+            totalCost,
+            modelsUsed: Array.from(modelMap.keys()),
+            modelBreakdowns,
+        });
+    }
+    // Sort by hour descending (most recent first)
+    hourlyUsage.sort((a, b) => b.hour.localeCompare(a.hour));
+    return hourlyUsage;
+}
+exports.aggregateHourlyUsage = aggregateHourlyUsage;
+// ============================================================================
+// MONTHLY AGGREGATION
+// ============================================================================
+/**
+ * Aggregate raw entries into monthly usage summaries
+ * Groups by month (YYYY-MM), calculates costs per model
+ */
+function aggregateMonthlyUsage(entries, source = 'custom-parser') {
+    // Group entries by month
+    const byMonth = new Map();
+    for (const entry of entries) {
+        const month = extractMonth(entry.timestamp);
+        const existing = byMonth.get(month) || [];
+        existing.push(entry);
+        byMonth.set(month, existing);
+    }
+    // Build monthly summaries
+    const monthlyUsage = [];
+    for (const [month, monthEntries] of byMonth) {
+        // Aggregate by model
+        const modelMap = new Map();
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCacheCreation = 0;
+        let totalCacheRead = 0;
+        for (const entry of monthEntries) {
+            const model = entry.model;
+            const acc = modelMap.get(model) || {
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+            };
+            acc.inputTokens += entry.inputTokens;
+            acc.outputTokens += entry.outputTokens;
+            acc.cacheCreationTokens += entry.cacheCreationTokens;
+            acc.cacheReadTokens += entry.cacheReadTokens;
+            modelMap.set(model, acc);
+            totalInput += entry.inputTokens;
+            totalOutput += entry.outputTokens;
+            totalCacheCreation += entry.cacheCreationTokens;
+            totalCacheRead += entry.cacheReadTokens;
+        }
+        // Build model breakdowns
+        const modelBreakdowns = [];
+        let totalCost = 0;
+        for (const [modelName, acc] of modelMap) {
+            const breakdown = createModelBreakdown(modelName, acc.inputTokens, acc.outputTokens, acc.cacheCreationTokens, acc.cacheReadTokens);
+            modelBreakdowns.push(breakdown);
+            totalCost += breakdown.cost;
+        }
+        // Sort breakdowns by cost descending
+        modelBreakdowns.sort((a, b) => b.cost - a.cost);
+        monthlyUsage.push({
+            month,
+            source,
+            inputTokens: totalInput,
+            outputTokens: totalOutput,
+            cacheCreationTokens: totalCacheCreation,
+            cacheReadTokens: totalCacheRead,
+            totalCost,
+            modelsUsed: Array.from(modelMap.keys()),
+            modelBreakdowns,
+        });
+    }
+    // Sort by month descending (most recent first)
+    monthlyUsage.sort((a, b) => b.month.localeCompare(a.month));
+    return monthlyUsage;
+}
+exports.aggregateMonthlyUsage = aggregateMonthlyUsage;
+// ============================================================================
+// SESSION AGGREGATION
+// ============================================================================
+/**
+ * Aggregate raw entries into session usage summaries
+ * Groups by sessionId, tracks last activity and versions
+ */
+function aggregateSessionUsage(entries, source = 'custom-parser') {
+    // Group entries by sessionId
+    const bySession = new Map();
+    for (const entry of entries) {
+        if (!entry.sessionId)
+            continue;
+        const existing = bySession.get(entry.sessionId) || [];
+        existing.push(entry);
+        bySession.set(entry.sessionId, existing);
+    }
+    // Build session summaries
+    const sessionUsage = [];
+    for (const [sessionId, sessionEntries] of bySession) {
+        // Aggregate by model
+        const modelMap = new Map();
+        const versions = new Set();
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCacheCreation = 0;
+        let totalCacheRead = 0;
+        let lastActivity = '';
+        let projectPath = '';
+        for (const entry of sessionEntries) {
+            const model = entry.model;
+            const acc = modelMap.get(model) || {
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+            };
+            acc.inputTokens += entry.inputTokens;
+            acc.outputTokens += entry.outputTokens;
+            acc.cacheCreationTokens += entry.cacheCreationTokens;
+            acc.cacheReadTokens += entry.cacheReadTokens;
+            modelMap.set(model, acc);
+            totalInput += entry.inputTokens;
+            totalOutput += entry.outputTokens;
+            totalCacheCreation += entry.cacheCreationTokens;
+            totalCacheRead += entry.cacheReadTokens;
+            // Track latest timestamp
+            if (entry.timestamp > lastActivity) {
+                lastActivity = entry.timestamp;
+            }
+            // Track versions
+            if (entry.version) {
+                versions.add(entry.version);
+            }
+            // Use project path from entry
+            if (entry.projectPath) {
+                projectPath = entry.projectPath;
+            }
+        }
+        // Build model breakdowns
+        const modelBreakdowns = [];
+        let totalCost = 0;
+        for (const [modelName, acc] of modelMap) {
+            const breakdown = createModelBreakdown(modelName, acc.inputTokens, acc.outputTokens, acc.cacheCreationTokens, acc.cacheReadTokens);
+            modelBreakdowns.push(breakdown);
+            totalCost += breakdown.cost;
+        }
+        // Sort breakdowns by cost descending
+        modelBreakdowns.sort((a, b) => b.cost - a.cost);
+        sessionUsage.push({
+            sessionId,
+            projectPath,
+            inputTokens: totalInput,
+            outputTokens: totalOutput,
+            cacheCreationTokens: totalCacheCreation,
+            cacheReadTokens: totalCacheRead,
+            cost: totalCost,
+            totalCost,
+            lastActivity,
+            versions: Array.from(versions),
+            modelsUsed: Array.from(modelMap.keys()),
+            modelBreakdowns,
+            source,
+        });
+    }
+    // Sort by last activity descending (most recent first)
+    sessionUsage.sort((a, b) => b.lastActivity.localeCompare(a.lastActivity));
+    return sessionUsage;
+}
+exports.aggregateSessionUsage = aggregateSessionUsage;
+// ============================================================================
+// MAIN DATA LOADER (drop-in replacement for better-ccusage)
+// ============================================================================
+const jsonl_parser_1 = require("../jsonl-parser");
+/**
+ * Load daily usage data (replaces better-ccusage loadDailyUsageData)
+ */
+async function loadDailyUsageData(options) {
+    const entries = await (0, jsonl_parser_1.scanProjectsDirectory)(options);
+    return aggregateDailyUsage(entries);
+}
+exports.loadDailyUsageData = loadDailyUsageData;
+/**
+ * Load hourly usage data for today's chart
+ */
+async function loadHourlyUsageData(options) {
+    const entries = await (0, jsonl_parser_1.scanProjectsDirectory)(options);
+    return aggregateHourlyUsage(entries);
+}
+exports.loadHourlyUsageData = loadHourlyUsageData;
+/**
+ * Load monthly usage data (replaces better-ccusage loadMonthlyUsageData)
+ */
+async function loadMonthlyUsageData(options) {
+    const entries = await (0, jsonl_parser_1.scanProjectsDirectory)(options);
+    return aggregateMonthlyUsage(entries);
+}
+exports.loadMonthlyUsageData = loadMonthlyUsageData;
+/**
+ * Load session data (replaces better-ccusage loadSessionData)
+ */
+async function loadSessionData(options) {
+    const entries = await (0, jsonl_parser_1.scanProjectsDirectory)(options);
+    return aggregateSessionUsage(entries);
+}
+exports.loadSessionData = loadSessionData;
+/**
+ * Load all usage data in a single pass (more efficient)
+ */
+async function loadAllUsageData(options) {
+    const entries = await (0, jsonl_parser_1.scanProjectsDirectory)(options);
+    return {
+        daily: aggregateDailyUsage(entries),
+        hourly: aggregateHourlyUsage(entries),
+        monthly: aggregateMonthlyUsage(entries),
+        session: aggregateSessionUsage(entries),
+    };
+}
+exports.loadAllUsageData = loadAllUsageData;
+//# sourceMappingURL=data-aggregator.js.map

package/dist/web-server/usage/data-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-aggregator.js","sourceRoot":"","sources":["../../../src/web-server/usage/data-aggregator.ts"],"names":[],"mappings":"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"}

package/dist/web-server/usage/disk-cache.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Persistent Disk Cache for Usage Data
+ *
+ * Caches aggregated usage data to disk to avoid re-parsing 6000+ JSONL files
+ * on every dashboard startup. Uses TTL-based invalidation with stale-while-revalidate.
+ *
+ * Cache location: ~/.ccs/cache/usage.json
+ * Default TTL: 5 minutes (configurable)
+ */
+import type { DailyUsage, HourlyUsage, MonthlyUsage, SessionUsage } from './types';
+/** Structure of the disk cache file */
+export interface UsageDiskCache {
+    version: number;
+    timestamp: number;
+    daily: DailyUsage[];
+    hourly: HourlyUsage[];
+    monthly: MonthlyUsage[];
+    session: SessionUsage[];
+}
+/**
+ * Read usage data from disk cache
+ * Returns null if cache is missing, corrupted, or has incompatible version
+ * NOTE: Does NOT reject based on age - caller handles staleness via SWR pattern
+ */
+export declare function readDiskCache(): UsageDiskCache | null;
+/**
+ * Check if disk cache is fresh (within TTL)
+ */
+export declare function isDiskCacheFresh(cache: UsageDiskCache | null): boolean;
+/**
+ * Check if disk cache is stale but usable (between TTL and STALE_TTL)
+ */
+export declare function isDiskCacheStale(cache: UsageDiskCache | null): boolean;
+/**
+ * Write usage data to disk cache
+ */
+export declare function writeDiskCache(daily: DailyUsage[], hourly: HourlyUsage[], monthly: MonthlyUsage[], session: SessionUsage[]): void;
+/**
+ * Get cache age in human-readable format
+ */
+export declare function getCacheAge(cache: UsageDiskCache | null): string;
+/**
+ * Delete disk cache (for manual refresh)
+ */
+export declare function clearDiskCache(): void;
+//# sourceMappingURL=disk-cache.d.ts.map

package/dist/web-server/usage/disk-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-cache.d.ts","sourceRoot":"","sources":["../../../src/web-server/usage/disk-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAUnF,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAeD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,cAAc,GAAG,IAAI,CAsBrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAItE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAItE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EAAE,GACtB,IAAI,CAuBN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,CAWhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CASrC"}

package/dist/web-server/usage/disk-cache.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Persistent Disk Cache for Usage Data
+ *
+ * Caches aggregated usage data to disk to avoid re-parsing 6000+ JSONL files
+ * on every dashboard startup. Uses TTL-based invalidation with stale-while-revalidate.
+ *
+ * Cache location: ~/.ccs/cache/usage.json
+ * Default TTL: 5 minutes (configurable)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearDiskCache = exports.getCacheAge = exports.writeDiskCache = exports.isDiskCacheStale = exports.isDiskCacheFresh = exports.readDiskCache = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const ui_1 = require("../../utils/ui");
+// Cache configuration
+const CCS_DIR = path.join(os.homedir(), '.ccs');
+const CACHE_DIR = path.join(CCS_DIR, 'cache');
+const CACHE_FILE = path.join(CACHE_DIR, 'usage.json');
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const STALE_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days (max age for stale data)
+// Current cache version - increment to invalidate old caches
+// v3: Added hourly data to cache
+const CACHE_VERSION = 3;
+/**
+ * Ensure ~/.ccs/cache directory exists
+ */
+function ensureCacheDir() {
+    if (!fs.existsSync(CACHE_DIR)) {
+        fs.mkdirSync(CACHE_DIR, { recursive: true });
+    }
+}
+/**
+ * Read usage data from disk cache
+ * Returns null if cache is missing, corrupted, or has incompatible version
+ * NOTE: Does NOT reject based on age - caller handles staleness via SWR pattern
+ */
+function readDiskCache() {
+    try {
+        if (!fs.existsSync(CACHE_FILE)) {
+            return null;
+        }
+        const data = fs.readFileSync(CACHE_FILE, 'utf-8');
+        const cache = JSON.parse(data);
+        // Version check - invalidate if schema changed
+        if (cache.version !== CACHE_VERSION) {
+            console.log((0, ui_1.info)('Cache version mismatch, will refresh'));
+            return null;
+        }
+        // Always return cache regardless of age - SWR pattern handles staleness
+        return cache;
+    }
+    catch (err) {
+        // Cache corrupted or unreadable - treat as miss
+        console.log((0, ui_1.info)('Cache read failed, will refresh:') + ` ${err.message}`);
+        return null;
+    }
+}
+exports.readDiskCache = readDiskCache;
+/**
+ * Check if disk cache is fresh (within TTL)
+ */
+function isDiskCacheFresh(cache) {
+    if (!cache)
+        return false;
+    const age = Date.now() - cache.timestamp;
+    return age < CACHE_TTL_MS;
+}
+exports.isDiskCacheFresh = isDiskCacheFresh;
+/**
+ * Check if disk cache is stale but usable (between TTL and STALE_TTL)
+ */
+function isDiskCacheStale(cache) {
+    if (!cache)
+        return false;
+    const age = Date.now() - cache.timestamp;
+    return age >= CACHE_TTL_MS && age < STALE_TTL_MS;
+}
+exports.isDiskCacheStale = isDiskCacheStale;
+/**
+ * Write usage data to disk cache
+ */
+function writeDiskCache(daily, hourly, monthly, session) {
+    try {
+        ensureCacheDir();
+        const cache = {
+            version: CACHE_VERSION,
+            timestamp: Date.now(),
+            daily,
+            hourly,
+            monthly,
+            session,
+        };
+        // Write atomically using temp file + rename
+        const tempFile = CACHE_FILE + '.tmp';
+        fs.writeFileSync(tempFile, JSON.stringify(cache), 'utf-8');
+        fs.renameSync(tempFile, CACHE_FILE);
+        console.log((0, ui_1.ok)('Disk cache updated'));
+    }
+    catch (err) {
+        // Non-fatal - we can still serve from memory
+        console.log((0, ui_1.warn)('Failed to write disk cache:') + ` ${err.message}`);
+    }
+}
+exports.writeDiskCache = writeDiskCache;
+/**
+ * Get cache age in human-readable format
+ */
+function getCacheAge(cache) {
+    if (!cache)
+        return 'never';
+    const age = Date.now() - cache.timestamp;
+    const seconds = Math.floor(age / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0)
+        return `${hours}h ${minutes % 60}m ago`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds % 60}s ago`;
+    return `${seconds}s ago`;
+}
+exports.getCacheAge = getCacheAge;
+/**
+ * Delete disk cache (for manual refresh)
+ */
+function clearDiskCache() {
+    try {
+        if (fs.existsSync(CACHE_FILE)) {
+            fs.unlinkSync(CACHE_FILE);
+            console.log((0, ui_1.ok)('Disk cache cleared'));
+        }
+    }
+    catch (err) {
+        console.log((0, ui_1.warn)('Failed to clear disk cache:') + ` ${err.message}`);
+    }
+}
+exports.clearDiskCache = clearDiskCache;
+//# sourceMappingURL=disk-cache.js.map

package/dist/web-server/usage/disk-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-cache.js","sourceRoot":"","sources":["../../../src/web-server/usage/disk-cache.ts"],"names":[],"mappings":"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"}