@kaitranntt/ccs 6.7.0 → 6.7.1

package/dist/web-server/usage/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Usage Module Barrel Export
+ *
+ * Re-exports all usage analytics functionality for convenient imports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeAnomalies = exports.detectAnomalies = exports.fillHourlyGaps = exports.calculateTokenBreakdownCosts = exports.filterByDateRange = exports.validateOffset = exports.validateLimit = exports.validateDate = exports.usageRoutes = exports.mergeSessionData = exports.mergeHourlyData = exports.mergeMonthlyData = exports.mergeDailyData = exports.getLastFetchTimestamp = exports.prewarmUsageCache = exports.clearUsageCache = exports.getCachedHourlyData = exports.getCachedSessionData = exports.getCachedMonthlyData = exports.getCachedDailyData = exports.loadAllUsageData = exports.loadSessionData = exports.loadMonthlyUsageData = exports.loadHourlyUsageData = exports.loadDailyUsageData = exports.aggregateSessionUsage = exports.aggregateMonthlyUsage = exports.aggregateHourlyUsage = exports.aggregateDailyUsage = exports.getCacheAge = exports.clearDiskCache = exports.isDiskCacheStale = exports.isDiskCacheFresh = exports.writeDiskCache = exports.readDiskCache = void 0;
+// Disk cache
+var disk_cache_1 = require("./disk-cache");
+Object.defineProperty(exports, "readDiskCache", { enumerable: true, get: function () { return disk_cache_1.readDiskCache; } });
+Object.defineProperty(exports, "writeDiskCache", { enumerable: true, get: function () { return disk_cache_1.writeDiskCache; } });
+Object.defineProperty(exports, "isDiskCacheFresh", { enumerable: true, get: function () { return disk_cache_1.isDiskCacheFresh; } });
+Object.defineProperty(exports, "isDiskCacheStale", { enumerable: true, get: function () { return disk_cache_1.isDiskCacheStale; } });
+Object.defineProperty(exports, "clearDiskCache", { enumerable: true, get: function () { return disk_cache_1.clearDiskCache; } });
+Object.defineProperty(exports, "getCacheAge", { enumerable: true, get: function () { return disk_cache_1.getCacheAge; } });
+// Data aggregator - aggregation functions
+var data_aggregator_1 = require("./data-aggregator");
+Object.defineProperty(exports, "aggregateDailyUsage", { enumerable: true, get: function () { return data_aggregator_1.aggregateDailyUsage; } });
+Object.defineProperty(exports, "aggregateHourlyUsage", { enumerable: true, get: function () { return data_aggregator_1.aggregateHourlyUsage; } });
+Object.defineProperty(exports, "aggregateMonthlyUsage", { enumerable: true, get: function () { return data_aggregator_1.aggregateMonthlyUsage; } });
+Object.defineProperty(exports, "aggregateSessionUsage", { enumerable: true, get: function () { return data_aggregator_1.aggregateSessionUsage; } });
+Object.defineProperty(exports, "loadDailyUsageData", { enumerable: true, get: function () { return data_aggregator_1.loadDailyUsageData; } });
+Object.defineProperty(exports, "loadHourlyUsageData", { enumerable: true, get: function () { return data_aggregator_1.loadHourlyUsageData; } });
+Object.defineProperty(exports, "loadMonthlyUsageData", { enumerable: true, get: function () { return data_aggregator_1.loadMonthlyUsageData; } });
+Object.defineProperty(exports, "loadSessionData", { enumerable: true, get: function () { return data_aggregator_1.loadSessionData; } });
+Object.defineProperty(exports, "loadAllUsageData", { enumerable: true, get: function () { return data_aggregator_1.loadAllUsageData; } });
+// Usage aggregator service - caching layer
+var aggregator_1 = require("./aggregator");
+Object.defineProperty(exports, "getCachedDailyData", { enumerable: true, get: function () { return aggregator_1.getCachedDailyData; } });
+Object.defineProperty(exports, "getCachedMonthlyData", { enumerable: true, get: function () { return aggregator_1.getCachedMonthlyData; } });
+Object.defineProperty(exports, "getCachedSessionData", { enumerable: true, get: function () { return aggregator_1.getCachedSessionData; } });
+Object.defineProperty(exports, "getCachedHourlyData", { enumerable: true, get: function () { return aggregator_1.getCachedHourlyData; } });
+Object.defineProperty(exports, "clearUsageCache", { enumerable: true, get: function () { return aggregator_1.clearUsageCache; } });
+Object.defineProperty(exports, "prewarmUsageCache", { enumerable: true, get: function () { return aggregator_1.prewarmUsageCache; } });
+Object.defineProperty(exports, "getLastFetchTimestamp", { enumerable: true, get: function () { return aggregator_1.getLastFetchTimestamp; } });
+Object.defineProperty(exports, "mergeDailyData", { enumerable: true, get: function () { return aggregator_1.mergeDailyData; } });
+Object.defineProperty(exports, "mergeMonthlyData", { enumerable: true, get: function () { return aggregator_1.mergeMonthlyData; } });
+Object.defineProperty(exports, "mergeHourlyData", { enumerable: true, get: function () { return aggregator_1.mergeHourlyData; } });
+Object.defineProperty(exports, "mergeSessionData", { enumerable: true, get: function () { return aggregator_1.mergeSessionData; } });
+// Routes
+var routes_1 = require("./routes");
+Object.defineProperty(exports, "usageRoutes", { enumerable: true, get: function () { return routes_1.usageRoutes; } });
+// Handlers (for testing)
+var handlers_1 = require("./handlers");
+Object.defineProperty(exports, "validateDate", { enumerable: true, get: function () { return handlers_1.validateDate; } });
+Object.defineProperty(exports, "validateLimit", { enumerable: true, get: function () { return handlers_1.validateLimit; } });
+Object.defineProperty(exports, "validateOffset", { enumerable: true, get: function () { return handlers_1.validateOffset; } });
+Object.defineProperty(exports, "filterByDateRange", { enumerable: true, get: function () { return handlers_1.filterByDateRange; } });
+Object.defineProperty(exports, "calculateTokenBreakdownCosts", { enumerable: true, get: function () { return handlers_1.calculateTokenBreakdownCosts; } });
+Object.defineProperty(exports, "fillHourlyGaps", { enumerable: true, get: function () { return handlers_1.fillHourlyGaps; } });
+Object.defineProperty(exports, "detectAnomalies", { enumerable: true, get: function () { return handlers_1.detectAnomalies; } });
+Object.defineProperty(exports, "summarizeAnomalies", { enumerable: true, get: function () { return handlers_1.summarizeAnomalies; } });
+//# sourceMappingURL=index.js.map

package/dist/web-server/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web-server/usage/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAkBH,aAAa;AACb,2CAQsB;AAPpB,2GAAA,aAAa,OAAA;AACb,4GAAA,cAAc,OAAA;AACd,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,4GAAA,cAAc,OAAA;AACd,yGAAA,WAAW,OAAA;AAIb,0CAA0C;AAC1C,qDAU2B;AATzB,sHAAA,mBAAmB,OAAA;AACnB,uHAAA,oBAAoB,OAAA;AACpB,wHAAA,qBAAqB,OAAA;AACrB,wHAAA,qBAAqB,OAAA;AACrB,qHAAA,kBAAkB,OAAA;AAClB,sHAAA,mBAAmB,OAAA;AACnB,uHAAA,oBAAoB,OAAA;AACpB,kHAAA,eAAe,OAAA;AACf,mHAAA,gBAAgB,OAAA;AAGlB,2CAA2C;AAC3C,2CAYsB;AAXpB,gHAAA,kBAAkB,OAAA;AAClB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AACpB,iHAAA,mBAAmB,OAAA;AACnB,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,mHAAA,qBAAqB,OAAA;AACrB,4GAAA,cAAc,OAAA;AACd,8GAAA,gBAAgB,OAAA;AAChB,6GAAA,eAAe,OAAA;AACf,8GAAA,gBAAgB,OAAA;AAGlB,SAAS;AACT,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAEpB,yBAAyB;AACzB,uCAUoB;AATlB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,wHAAA,4BAA4B,OAAA;AAC5B,0GAAA,cAAc,OAAA;AACd,2GAAA,eAAe,OAAA;AACf,8GAAA,kBAAkB,OAAA"}

package/dist/web-server/usage/routes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Usage Analytics API Routes
+ *
+ * Provides REST endpoints for Claude Code usage analytics.
+ * Supports daily, monthly, and session-based usage data aggregation.
+ *
+ * Route handlers are in ./handlers.ts
+ */
+export { prewarmUsageCache, clearUsageCache, getLastFetchTimestamp } from './aggregator';
+export declare const usageRoutes: import("express-serve-static-core").Router;
+//# sourceMappingURL=routes.d.ts.map

package/dist/web-server/usage/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/web-server/usage/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzF,eAAO,MAAM,WAAW,4CAAW,CAAC"}

package/dist/web-server/usage/routes.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Usage Analytics API Routes
+ *
+ * Provides REST endpoints for Claude Code usage analytics.
+ * Supports daily, monthly, and session-based usage data aggregation.
+ *
+ * Route handlers are in ./handlers.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usageRoutes = exports.getLastFetchTimestamp = exports.clearUsageCache = exports.prewarmUsageCache = void 0;
+const express_1 = require("express");
+const handlers_1 = require("./handlers");
+var aggregator_1 = require("./aggregator");
+Object.defineProperty(exports, "prewarmUsageCache", { enumerable: true, get: function () { return aggregator_1.prewarmUsageCache; } });
+Object.defineProperty(exports, "clearUsageCache", { enumerable: true, get: function () { return aggregator_1.clearUsageCache; } });
+Object.defineProperty(exports, "getLastFetchTimestamp", { enumerable: true, get: function () { return aggregator_1.getLastFetchTimestamp; } });
+exports.usageRoutes = (0, express_1.Router)();
+// Summary endpoint
+exports.usageRoutes.get('/summary', handlers_1.handleSummary);
+// Daily usage endpoint
+exports.usageRoutes.get('/daily', handlers_1.handleDaily);
+// Hourly usage endpoint
+exports.usageRoutes.get('/hourly', handlers_1.handleHourly);
+// Models usage endpoint
+exports.usageRoutes.get('/models', handlers_1.handleModels);
+// Sessions endpoint
+exports.usageRoutes.get('/sessions', handlers_1.handleSessions);
+// Monthly usage endpoint
+exports.usageRoutes.get('/monthly', handlers_1.handleMonthly);
+// Cache refresh endpoint
+exports.usageRoutes.post('/refresh', handlers_1.handleRefresh);
+// Status endpoint
+exports.usageRoutes.get('/status', handlers_1.handleStatus);
+// Insights endpoint (anomaly detection)
+exports.usageRoutes.get('/insights', handlers_1.handleInsights);
+//# sourceMappingURL=routes.js.map

package/dist/web-server/usage/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/web-server/usage/routes.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,qCAAiC;AACjC,yCAUoB;AAEpB,2CAAyF;AAAhF,+GAAA,iBAAiB,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAErD,QAAA,WAAW,GAAG,IAAA,gBAAM,GAAE,CAAC;AAEpC,mBAAmB;AACnB,mBAAW,CAAC,GAAG,CAAC,UAAU,EAAE,wBAAa,CAAC,CAAC;AAE3C,uBAAuB;AACvB,mBAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,sBAAW,CAAC,CAAC;AAEvC,wBAAwB;AACxB,mBAAW,CAAC,GAAG,CAAC,SAAS,EAAE,uBAAY,CAAC,CAAC;AAEzC,wBAAwB;AACxB,mBAAW,CAAC,GAAG,CAAC,SAAS,EAAE,uBAAY,CAAC,CAAC;AAEzC,oBAAoB;AACpB,mBAAW,CAAC,GAAG,CAAC,WAAW,EAAE,yBAAc,CAAC,CAAC;AAE7C,yBAAyB;AACzB,mBAAW,CAAC,GAAG,CAAC,UAAU,EAAE,wBAAa,CAAC,CAAC;AAE3C,yBAAyB;AACzB,mBAAW,CAAC,IAAI,CAAC,UAAU,EAAE,wBAAa,CAAC,CAAC;AAE5C,kBAAkB;AAClB,mBAAW,CAAC,GAAG,CAAC,SAAS,EAAE,uBAAY,CAAC,CAAC;AAEzC,wCAAwC;AACxC,mBAAW,CAAC,GAAG,CAAC,WAAW,EAAE,yBAAc,CAAC,CAAC"}

package/dist/web-server/usage/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Usage Data Types
+ *
+ * Type definitions for aggregated usage data.
+ * Compatible with better-ccusage interfaces for drop-in replacement.
+ */
+/** Per-model token and cost breakdown */
+export interface ModelBreakdown {
+    modelName: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+}
+/** Daily usage aggregation (YYYY-MM-DD) */
+export interface DailyUsage {
+    date: string;
+    source: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+    totalCost: number;
+    modelsUsed: string[];
+    modelBreakdowns: ModelBreakdown[];
+}
+/** Hourly usage aggregation (YYYY-MM-DD HH:00) */
+export interface HourlyUsage {
+    hour: string;
+    source: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+    totalCost: number;
+    modelsUsed: string[];
+    modelBreakdowns: ModelBreakdown[];
+}
+/** Monthly usage aggregation (YYYY-MM) */
+export interface MonthlyUsage {
+    month: string;
+    source: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    totalCost: number;
+    modelsUsed: string[];
+    modelBreakdowns: ModelBreakdown[];
+}
+/** Session-level usage aggregation */
+export interface SessionUsage {
+    sessionId: string;
+    projectPath: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+    totalCost: number;
+    lastActivity: string;
+    versions: string[];
+    modelsUsed: string[];
+    modelBreakdowns: ModelBreakdown[];
+    source: string;
+}
+/** Token category with count and cost */
+export interface TokenCategoryCost {
+    tokens: number;
+    cost: number;
+}
+/** Breakdown of tokens by type with individual costs */
+export interface TokenBreakdown {
+    input: TokenCategoryCost;
+    output: TokenCategoryCost;
+    cacheCreation: TokenCategoryCost;
+    cacheRead: TokenCategoryCost;
+}
+/** Anomaly types for usage pattern detection */
+export type AnomalyType = 'high_input' | 'high_io_ratio' | 'cost_spike' | 'high_cache_read';
+/** Single anomaly detection result */
+export interface Anomaly {
+    date: string;
+    type: AnomalyType;
+    model?: string;
+    value: number;
+    threshold: number;
+    message: string;
+}
+/** Summary of all detected anomalies */
+export interface AnomalySummary {
+    totalAnomalies: number;
+    highInputDays: number;
+    highIoRatioDays: number;
+    costSpikeDays: number;
+    highCacheReadDays: number;
+}
+/** Insights API response */
+export interface UsageInsights {
+    anomalies: Anomaly[];
+    summary: AnomalySummary;
+}
+/** Extended model usage with cost breakdown */
+export interface ExtendedModelUsage {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    tokens: number;
+    cost: number;
+    percentage: number;
+    costBreakdown: TokenBreakdown;
+    ioRatio: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web-server/usage/types.d.ts.map

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

package/dist/web-server/usage/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Usage Data Types
+ *
+ * Type definitions for aggregated usage data.
+ * Compatible with better-ccusage interfaces for drop-in replacement.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/web-server/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/web-server/usage/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

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

@@ -1,46 +1,7 @@
 /**
- * Persistent Disk Cache for Usage Data
+ * Usage Disk Cache - Re-export from modularized location
  *
- * 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 './usage-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)
+ * @deprecated Import from './usage/disk-cache' instead
  */
-export declare function clearDiskCache(): void;
+export * from './usage/disk-cache';
 //# sourceMappingURL=usage-disk-cache.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"usage-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,eAAe,CAAC;AAUzF,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"}
+{"version":3,"file":"usage-disk-cache.d.ts","sourceRoot":"","sources":["../../src/web-server/usage-disk-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC"}

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

@@ -1,12 +1,8 @@
 "use strict";
 /**
- * Persistent Disk Cache for Usage Data
+ * Usage Disk Cache - Re-export from modularized location
  *
- * 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)
+ * @deprecated Import from './usage/disk-cache' instead
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -19,144 +15,9 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     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;
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 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;
+__exportStar(require("./usage/disk-cache"), exports);
 //# sourceMappingURL=usage-disk-cache.js.map

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

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

package/dist/web-server/usage-routes.d.ts

@@ -1,35 +1,7 @@
 /**
- * Usage Analytics API Routes
+ * Usage Analytics API Routes - Re-export from modularized location
  *
- * Provides REST endpoints for Claude Code usage analytics.
- * Supports daily, monthly, and session-based usage data aggregation.
- *
- * Performance optimizations:
- * - Persistent disk cache to avoid re-parsing JSONL files on startup
- * - TTL-based in-memory caching for fast repeated requests
- * - Request coalescing to prevent duplicate concurrent requests
- * - Non-blocking prewarm with instant stale data serving
- */
-export declare const usageRoutes: import("express-serve-static-core").Router;
-/** Get timestamp of last successful data fetch */
-export declare function getLastFetchTimestamp(): number | null;
-/**
- * Clear all cached data (useful for manual refresh)
- */
-export declare function clearUsageCache(): void;
-/**
- * Pre-warm usage caches on server startup
- *
- * Strategy:
- * 1. Check disk cache - if fresh, use it (instant startup)
- * 2. If stale, use it immediately but trigger background refresh
- * 3. If no cache, return immediately and let first request trigger load
- *
- * This ensures dashboard opens in <1s regardless of cache state
+ * @deprecated Import from './usage/routes' instead
  */
-export declare function prewarmUsageCache(): Promise<{
-    timestamp: number;
-    elapsed: number;
-    source: string;
-}>;
+export { usageRoutes, prewarmUsageCache, clearUsageCache, getLastFetchTimestamp, } from './usage/routes';
 //# sourceMappingURL=usage-routes.d.ts.map

package/dist/web-server/usage-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-routes.d.ts","sourceRoot":"","sources":["../../src/web-server/usage-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmOH,eAAO,MAAM,WAAW,4CAAW,CAAC;AAsCpC,kDAAkD;AAClD,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAsHD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAmGD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAgED"}
+{"version":3,"file":"usage-routes.d.ts","sourceRoot":"","sources":["../../src/web-server/usage-routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,gBAAgB,CAAC"}