@code-insights/cli 1.2.0 → 2.1.0

package/dist/commands/stats/data/cache.d.ts

@@ -0,0 +1,29 @@
+import type { ParsedSession } from '../../../types.js';
+import type { SessionRow } from './types.js';
+/**
+ * Transform the CLI's ParsedSession into the stats SessionRow shape.
+ * Uses a module-level cache for projectId to avoid repeated git spawns.
+ */
+export declare function parsedSessionToRow(session: ParsedSession): SessionRow;
+export declare class StatsCache {
+    private data;
+    private dirty;
+    constructor();
+    /**
+     * Refresh the cache by discovering and parsing sessions from all providers.
+     * Returns counts of new and total sessions.
+     */
+    refresh(): Promise<{
+        newSessions: number;
+        totalSessions: number;
+    }>;
+    /**
+     * Return all cached session rows with dates properly deserialized.
+     * JSON serialization turns Date objects into ISO strings — reconstruct them.
+     */
+    getAllRows(): SessionRow[];
+    private load;
+    private save;
+    private empty;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/commands/stats/data/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/commands/stats/data/cache.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA+C7C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CAoCrE;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,KAAK,CAAU;;IAOvB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IA2ExE;;;OAGG;IACH,UAAU,IAAI,UAAU,EAAE;IAkB1B,OAAO,CAAC,IAAI;IAgBZ,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,KAAK;CAGd"}

package/dist/commands/stats/data/cache.js

@@ -0,0 +1,197 @@
+// ──────────────────────────────────────────────────────
+// Stats cache — disk-based parsed session store
+//
+// Stores pre-parsed SessionRow[] keyed by source file path
+// with mtime-based invalidation. Lives at:
+//   ~/.code-insights/stats-cache.json
+// ──────────────────────────────────────────────────────
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { generateStableProjectId } from '../../../utils/device.js';
+import { ensureConfigDir } from '../../../utils/config.js';
+import { splitVirtualPath } from '../../../utils/paths.js';
+import { getAllProviders } from '../../../providers/registry.js';
+// ──────────────────────────────────────────────────────
+// Constants
+// ──────────────────────────────────────────────────────
+const CACHE_PATH = path.join(os.homedir(), '.code-insights', 'stats-cache.json');
+// ──────────────────────────────────────────────────────
+// Module-level projectId cache — avoids repeated git
+// process spawns for the same project path
+// ──────────────────────────────────────────────────────
+const projectIdCache = new Map();
+function getCachedProjectId(projectPath) {
+    const existing = projectIdCache.get(projectPath);
+    if (existing)
+        return existing;
+    const { projectId } = generateStableProjectId(projectPath);
+    projectIdCache.set(projectPath, projectId);
+    return projectId;
+}
+// ──────────────────────────────────────────────────────
+// Exported helpers
+// ──────────────────────────────────────────────────────
+/**
+ * Transform the CLI's ParsedSession into the stats SessionRow shape.
+ * Uses a module-level cache for projectId to avoid repeated git spawns.
+ */
+export function parsedSessionToRow(session) {
+    const projectId = getCachedProjectId(session.projectPath);
+    return {
+        // identity
+        id: session.id,
+        projectId,
+        projectName: session.projectName,
+        // timing
+        startedAt: session.startedAt,
+        endedAt: session.endedAt,
+        // counts
+        messageCount: session.messageCount,
+        userMessageCount: session.userMessageCount,
+        assistantMessageCount: session.assistantMessageCount,
+        toolCallCount: session.toolCallCount,
+        // cost / usage (optional)
+        estimatedCostUsd: session.usage?.estimatedCostUsd,
+        totalInputTokens: session.usage?.totalInputTokens,
+        totalOutputTokens: session.usage?.totalOutputTokens,
+        cacheCreationTokens: session.usage?.cacheCreationTokens,
+        cacheReadTokens: session.usage?.cacheReadTokens,
+        // metadata
+        primaryModel: session.usage?.primaryModel,
+        modelsUsed: session.usage?.modelsUsed,
+        generatedTitle: session.generatedTitle ?? undefined,
+        customTitle: session.customTitle,
+        summary: session.summary ?? undefined,
+        sessionCharacter: session.sessionCharacter ?? undefined,
+        sourceTool: session.sourceTool,
+        usageSource: session.usage?.usageSource,
+    };
+}
+// ──────────────────────────────────────────────────────
+// StatsCache class
+// ──────────────────────────────────────────────────────
+export class StatsCache {
+    data;
+    dirty;
+    constructor() {
+        this.dirty = false;
+        this.data = this.load();
+    }
+    /**
+     * Refresh the cache by discovering and parsing sessions from all providers.
+     * Returns counts of new and total sessions.
+     */
+    async refresh() {
+        const providers = getAllProviders();
+        let newSessions = 0;
+        // Collect all discovered file paths (keyed by provider name for metadata)
+        const allDiscoveredPaths = new Set();
+        for (const provider of providers) {
+            const providerName = provider.getProviderName();
+            let filePaths;
+            try {
+                filePaths = await provider.discover();
+            }
+            catch {
+                // If discovery fails for a provider, skip it
+                continue;
+            }
+            for (const filePath of filePaths) {
+                allDiscoveredPaths.add(filePath);
+                // Check mtime for cache invalidation
+                const { realPath } = splitVirtualPath(filePath);
+                let currentMtime;
+                try {
+                    currentMtime = fs.statSync(realPath).mtime.toISOString();
+                }
+                catch {
+                    // File no longer accessible, skip
+                    continue;
+                }
+                const cached = this.data.entries[filePath];
+                if (cached && cached.lastModified === currentMtime) {
+                    // Cache hit — mtime unchanged
+                    continue;
+                }
+                // Cache miss — parse the file
+                let session;
+                try {
+                    session = await provider.parse(filePath);
+                }
+                catch {
+                    // Parse error — skip this file
+                    continue;
+                }
+                if (!session)
+                    continue;
+                const row = parsedSessionToRow(session);
+                this.data.entries[filePath] = {
+                    lastModified: currentMtime,
+                    provider: providerName,
+                    rows: [row],
+                };
+                this.dirty = true;
+                newSessions++;
+            }
+        }
+        // Prune entries for file paths that no longer exist in any provider's discovery
+        for (const cachedPath of Object.keys(this.data.entries)) {
+            if (!allDiscoveredPaths.has(cachedPath)) {
+                delete this.data.entries[cachedPath];
+                this.dirty = true;
+            }
+        }
+        // Persist if anything changed
+        if (this.dirty) {
+            this.data.lastRefresh = new Date().toISOString();
+            this.save();
+        }
+        return { newSessions, totalSessions: this.getAllRows().length };
+    }
+    /**
+     * Return all cached session rows with dates properly deserialized.
+     * JSON serialization turns Date objects into ISO strings — reconstruct them.
+     */
+    getAllRows() {
+        const rows = [];
+        for (const entry of Object.values(this.data.entries)) {
+            for (const row of entry.rows) {
+                rows.push({
+                    ...row,
+                    startedAt: new Date(row.startedAt),
+                    endedAt: new Date(row.endedAt),
+                });
+            }
+        }
+        return rows;
+    }
+    // ──────────────────────────────────────────────────────
+    // Private methods
+    // ──────────────────────────────────────────────────────
+    load() {
+        try {
+            if (!fs.existsSync(CACHE_PATH)) {
+                return this.empty();
+            }
+            const content = fs.readFileSync(CACHE_PATH, 'utf-8');
+            const parsed = JSON.parse(content);
+            if (parsed.version !== 1) {
+                return this.empty();
+            }
+            return parsed;
+        }
+        catch {
+            return this.empty();
+        }
+    }
+    save() {
+        ensureConfigDir();
+        fs.writeFileSync(CACHE_PATH, JSON.stringify(this.data, null, 2));
+        this.dirty = false;
+    }
+    empty() {
+        return { version: 1, lastRefresh: '', entries: {} };
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/commands/stats/data/cache.js.map

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

package/dist/commands/stats/data/firestore.d.ts

@@ -0,0 +1,13 @@
+import type { ClaudeInsightConfig } from '../../../types.js';
+import type { StatsDataSource, SessionRow, SessionQueryOptions, UsageStatsDoc, ProjectResolution, PrepareResult, StatsFlags } from './types.js';
+export declare class FirestoreDataSource implements StatsDataSource {
+    private config;
+    readonly name = "firestore";
+    constructor(config: ClaudeInsightConfig);
+    prepare(flags: StatsFlags): Promise<PrepareResult>;
+    getSessions(opts: SessionQueryOptions): Promise<SessionRow[]>;
+    getUsageStats(): Promise<UsageStatsDoc | null>;
+    resolveProjectId(name: string): Promise<ProjectResolution>;
+    getLastSession(opts?: Pick<SessionQueryOptions, 'sourceTool' | 'projectId'>): Promise<SessionRow | null>;
+}
+//# sourceMappingURL=firestore.d.ts.map

package/dist/commands/stats/data/firestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.d.ts","sourceRoot":"","sources":["../../../../src/commands/stats/data/firestore.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AAgEpB,qBAAa,mBAAoB,YAAW,eAAe;IAG7C,OAAO,CAAC,MAAM;IAF1B,QAAQ,CAAC,IAAI,eAAe;gBAER,MAAM,EAAE,mBAAmB;IAEzC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBlD,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAiC7D,aAAa,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgB9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqB1D,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CA8B/G"}

package/dist/commands/stats/data/firestore.js

@@ -0,0 +1,170 @@
+// ──────────────────────────────────────────────────────
+// Firestore data source for stats commands
+// ──────────────────────────────────────────────────────
+import admin from 'firebase-admin';
+import { initializeFirebase, getDb, getProjects } from '../../../firebase/client.js';
+import { ProjectNotFoundError, FirestoreIndexError } from './types.js';
+import { findSimilarNames } from './fuzzy-match.js';
+// ──────────────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────────────
+/** Checks if error is a Firestore FAILED_PRECONDITION (missing composite index) */
+function isFirestoreIndexError(error) {
+    if (typeof error === 'object' && error !== null && 'code' in error) {
+        return error.code === 9;
+    }
+    return false;
+}
+/** Extracts the Firebase console index-creation URL from an error message */
+function extractIndexUrl(error) {
+    if (typeof error === 'object' && error !== null && 'message' in error) {
+        const message = error.message;
+        const match = message.match(/(https:\/\/console\.firebase\.google\.com\/[^\s"]+)/);
+        return match ? match[1] : null;
+    }
+    return null;
+}
+// ──────────────────────────────────────────────────────
+// Document mapper
+// ──────────────────────────────────────────────────────
+/** Maps a Firestore document to the universal SessionRow shape */
+function docToSessionRow(doc) {
+    const data = doc.data();
+    if (!data)
+        throw new Error(`Session document ${doc.id} has no data`);
+    return {
+        id: doc.id,
+        projectId: data.projectId,
+        projectName: data.projectName,
+        startedAt: data.startedAt?.toDate() ?? new Date(),
+        endedAt: data.endedAt?.toDate() ?? new Date(),
+        messageCount: data.messageCount ?? 0,
+        userMessageCount: data.userMessageCount ?? 0,
+        assistantMessageCount: data.assistantMessageCount ?? 0,
+        toolCallCount: data.toolCallCount ?? 0,
+        estimatedCostUsd: data.estimatedCostUsd,
+        totalInputTokens: data.totalInputTokens,
+        totalOutputTokens: data.totalOutputTokens,
+        cacheCreationTokens: data.cacheCreationTokens,
+        cacheReadTokens: data.cacheReadTokens,
+        primaryModel: data.primaryModel,
+        modelsUsed: data.modelsUsed,
+        generatedTitle: data.generatedTitle,
+        customTitle: data.customTitle,
+        summary: data.summary,
+        sessionCharacter: data.sessionCharacter,
+        sourceTool: data.sourceTool,
+        usageSource: data.usageSource,
+    };
+}
+// ──────────────────────────────────────────────────────
+// FirestoreDataSource
+// ──────────────────────────────────────────────────────
+export class FirestoreDataSource {
+    config;
+    name = 'firestore';
+    constructor(config) {
+        this.config = config;
+    }
+    async prepare(flags) {
+        initializeFirebase(this.config);
+        if (!flags.noSync) {
+            try {
+                const { runSync } = await import('../../sync.js');
+                const result = await runSync({ quiet: true });
+                if (result.syncedCount > 0) {
+                    return { message: `Synced ${result.syncedCount} new sessions`, dataChanged: true };
+                }
+                return { message: 'Up to date', dataChanged: false };
+            }
+            catch {
+                return { message: 'Sync failed (showing cached data)', dataChanged: false };
+            }
+        }
+        return { message: 'Sync skipped', dataChanged: false };
+    }
+    async getSessions(opts) {
+        const firestore = getDb();
+        let query = firestore.collection('sessions');
+        if (opts.projectId) {
+            query = query.where('projectId', '==', opts.projectId);
+        }
+        if (opts.sourceTool) {
+            query = query.where('sourceTool', '==', opts.sourceTool);
+        }
+        if (opts.periodStart) {
+            query = query.where('startedAt', '>=', admin.firestore.Timestamp.fromDate(opts.periodStart));
+        }
+        query = query.orderBy('startedAt', 'desc');
+        try {
+            const snapshot = await query.get();
+            return snapshot.docs.map(docToSessionRow);
+        }
+        catch (error) {
+            if (isFirestoreIndexError(error)) {
+                const url = extractIndexUrl(error);
+                throw new FirestoreIndexError(url
+                    ? `Missing Firestore index. Create it here: ${url}`
+                    : 'Missing Firestore composite index. Check the error details in Firebase console.', url ?? '');
+            }
+            throw error;
+        }
+    }
+    async getUsageStats() {
+        const firestore = getDb();
+        const doc = await firestore.collection('stats').doc('usage').get();
+        if (!doc.exists)
+            return null;
+        const data = doc.data();
+        return {
+            totalInputTokens: data.totalInputTokens ?? 0,
+            totalOutputTokens: data.totalOutputTokens ?? 0,
+            cacheCreationTokens: data.cacheCreationTokens ?? 0,
+            cacheReadTokens: data.cacheReadTokens ?? 0,
+            estimatedCostUsd: data.estimatedCostUsd ?? 0,
+            sessionsWithUsage: data.sessionsWithUsage ?? 0,
+            lastUpdatedAt: data.lastUpdatedAt?.toDate() ?? new Date(),
+        };
+    }
+    async resolveProjectId(name) {
+        const projects = await getProjects();
+        // Exact match (case-insensitive)
+        const exact = projects.find((p) => p.name.toLowerCase() === name.toLowerCase());
+        if (exact)
+            return { projectId: exact.id, projectName: exact.name };
+        // Substring match
+        const substring = projects.filter((p) => p.name.toLowerCase().includes(name.toLowerCase()));
+        if (substring.length === 1)
+            return { projectId: substring[0].id, projectName: substring[0].name };
+        // No match — throw with suggestions
+        const suggestions = findSimilarNames(name, projects.map((p) => p.name));
+        throw new ProjectNotFoundError(`Project "${name}" not found.`, name, projects.map((p) => ({ name: p.name })), suggestions);
+    }
+    async getLastSession(opts) {
+        const firestore = getDb();
+        let query = firestore.collection('sessions');
+        if (opts?.sourceTool) {
+            query = query.where('sourceTool', '==', opts.sourceTool);
+        }
+        if (opts?.projectId) {
+            query = query.where('projectId', '==', opts.projectId);
+        }
+        query = query.orderBy('startedAt', 'desc').limit(1);
+        try {
+            const snapshot = await query.get();
+            if (snapshot.empty)
+                return null;
+            return docToSessionRow(snapshot.docs[0]);
+        }
+        catch (error) {
+            if (isFirestoreIndexError(error)) {
+                const url = extractIndexUrl(error);
+                throw new FirestoreIndexError(url
+                    ? `Missing Firestore index. Create it here: ${url}`
+                    : 'Missing Firestore composite index. Check the error details in Firebase console.', url ?? '');
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=firestore.js.map

package/dist/commands/stats/data/firestore.js.map

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

package/dist/commands/stats/data/fuzzy-match.d.ts

@@ -0,0 +1,5 @@
+/** Standard Levenshtein distance between two strings */
+export declare function levenshtein(a: string, b: string): number;
+/** Returns candidate names within maxDistance, sorted by distance */
+export declare function findSimilarNames(input: string, candidates: string[], maxDistance?: number): string[];
+//# sourceMappingURL=fuzzy-match.d.ts.map

package/dist/commands/stats/data/fuzzy-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.d.ts","sourceRoot":"","sources":["../../../../src/commands/stats/data/fuzzy-match.ts"],"names":[],"mappings":"AAOA,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,SAAI,GAAG,MAAM,EAAE,CAO/F"}

package/dist/commands/stats/data/fuzzy-match.js

@@ -0,0 +1,36 @@
+// ──────────────────────────────────────────────────────
+// Fuzzy string matching utilities
+//
+// Shared between FirestoreDataSource and LocalDataSource
+// for --project name resolution.
+// ──────────────────────────────────────────────────────
+/** Standard Levenshtein distance between two strings */
+export function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, // deletion
+            dp[i][j - 1] + 1, // insertion
+            dp[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return dp[m][n];
+}
+/** Returns candidate names within maxDistance, sorted by distance */
+export function findSimilarNames(input, candidates, maxDistance = 3) {
+    const lower = input.toLowerCase();
+    return candidates
+        .map((name) => ({ name, distance: levenshtein(lower, name.toLowerCase()) }))
+        .filter(({ distance }) => distance <= maxDistance)
+        .sort((a, b) => a.distance - b.distance)
+        .map(({ name }) => name);
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/dist/commands/stats/data/fuzzy-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.js","sourceRoot":"","sources":["../../../../src/commands/stats/data/fuzzy-match.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,kCAAkC;AAClC,EAAE;AACF,yDAAyD;AACzD,iCAAiC;AACjC,yDAAyD;AAEzD,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACjB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAO,WAAW;YAClC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAO,YAAY;YACnC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe;aACxC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,UAAoB,EAAE,WAAW,GAAG,CAAC;IACnF,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;SAC3E,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,IAAI,WAAW,CAAC;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;SACvC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/commands/stats/data/local.d.ts

@@ -0,0 +1,12 @@
+import type { StatsDataSource, SessionRow, SessionQueryOptions, UsageStatsDoc, ProjectResolution, PrepareResult, StatsFlags } from './types.js';
+export declare class LocalDataSource implements StatsDataSource {
+    readonly name = "local";
+    private cache;
+    constructor();
+    prepare(flags: StatsFlags): Promise<PrepareResult>;
+    getSessions(opts: SessionQueryOptions): Promise<SessionRow[]>;
+    getUsageStats(): Promise<UsageStatsDoc | null>;
+    resolveProjectId(name: string): Promise<ProjectResolution>;
+    getLastSession(opts?: Pick<SessionQueryOptions, 'sourceTool' | 'projectId'>): Promise<SessionRow | null>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/commands/stats/data/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../src/commands/stats/data/local.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AASpB,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,KAAK,CAAa;;IAMpB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBlD,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAW7D,aAAa,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4B1D,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAO/G"}

package/dist/commands/stats/data/local.js

@@ -0,0 +1,81 @@
+// ──────────────────────────────────────────────────────
+// Local data source for stats commands
+//
+// Reads from the disk-based stats cache (no Firestore).
+// Zero-config: works out of the box by discovering and
+// parsing local session files from all providers.
+// ──────────────────────────────────────────────────────
+import { ProjectNotFoundError } from './types.js';
+import { findSimilarNames } from './fuzzy-match.js';
+import { StatsCache } from './cache.js';
+// ──────────────────────────────────────────────────────
+// LocalDataSource
+// ──────────────────────────────────────────────────────
+export class LocalDataSource {
+    name = 'local';
+    cache;
+    constructor() {
+        this.cache = new StatsCache();
+    }
+    async prepare(flags) {
+        if (flags.noSync) {
+            const total = this.cache.getAllRows().length;
+            return { message: `${total} sessions cached`, dataChanged: false };
+        }
+        const result = await this.cache.refresh();
+        if (result.newSessions > 0) {
+            return {
+                message: `Parsed ${result.newSessions} new sessions (${result.totalSessions} total)`,
+                dataChanged: true,
+            };
+        }
+        return { message: `${result.totalSessions} sessions cached`, dataChanged: false };
+    }
+    async getSessions(opts) {
+        let rows = this.cache.getAllRows();
+        if (opts.periodStart)
+            rows = rows.filter((r) => r.startedAt >= opts.periodStart);
+        if (opts.projectId)
+            rows = rows.filter((r) => r.projectId === opts.projectId);
+        if (opts.sourceTool)
+            rows = rows.filter((r) => r.sourceTool === opts.sourceTool);
+        rows.sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime());
+        return rows;
+    }
+    async getUsageStats() {
+        // Local source has no pre-computed aggregate
+        return null;
+    }
+    async resolveProjectId(name) {
+        const rows = this.cache.getAllRows();
+        const projects = new Map();
+        for (const row of rows) {
+            if (!projects.has(row.projectId)) {
+                projects.set(row.projectId, { id: row.projectId, name: row.projectName });
+            }
+        }
+        const projectList = [...projects.values()];
+        // Exact match (case-insensitive)
+        const exact = projectList.find((p) => p.name.toLowerCase() === name.toLowerCase());
+        if (exact)
+            return { projectId: exact.id, projectName: exact.name };
+        // Substring match
+        const substring = projectList.filter((p) => p.name.toLowerCase().includes(name.toLowerCase()));
+        if (substring.length === 1)
+            return { projectId: substring[0].id, projectName: substring[0].name };
+        // No match — throw with suggestions
+        const suggestions = findSimilarNames(name, projectList.map((p) => p.name));
+        throw new ProjectNotFoundError(`Project "${name}" not found.`, name, projectList.map((p) => ({ name: p.name })), suggestions);
+    }
+    async getLastSession(opts) {
+        let rows = this.cache.getAllRows();
+        if (opts?.sourceTool)
+            rows = rows.filter(r => r.sourceTool === opts.sourceTool);
+        if (opts?.projectId)
+            rows = rows.filter(r => r.projectId === opts.projectId);
+        if (rows.length === 0)
+            return null;
+        return rows.reduce((latest, row) => (row.startedAt > latest.startedAt ? row : latest));
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/commands/stats/data/local.js.map

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

package/dist/commands/stats/data/source.d.ts

@@ -0,0 +1,13 @@
+import type { StatsDataSource, StatsFlags } from './types.js';
+/**
+ * Resolve which data source to use based on flags and config.
+ *
+ * Priority (highest to lowest):
+ * 1. --local flag           -> always LocalDataSource
+ * 2. --remote flag          -> always FirestoreDataSource (error if not configured)
+ * 3. config.dataSource      -> as configured ('local' or 'firebase')
+ * 4. No config, Firebase creds present -> FirestoreDataSource (backward compat)
+ * 5. No config at all       -> LocalDataSource (zero-config first run)
+ */
+export declare function resolveDataSource(flags: StatsFlags): Promise<StatsDataSource>;
+//# sourceMappingURL=source.d.ts.map

package/dist/commands/stats/data/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/commands/stats/data/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI9D;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAoCnF"}