codesift-mcp 0.1.0

package/dist/storage/embedding-store.js

@@ -0,0 +1,149 @@
+import { readFile, writeFile, rename, mkdir, unlink } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Get the embedding file path from an index path.
+ * {hash}.index.json → {hash}.embeddings.ndjson
+ */
+export function getEmbeddingPath(indexPath) {
+    return indexPath.replace(/\.index\.json$/, ".embeddings.ndjson");
+}
+/**
+ * Get the embedding metadata file path.
+ * {hash}.index.json → {hash}.embeddings.meta.json
+ */
+export function getEmbeddingMetaPath(indexPath) {
+    return indexPath.replace(/\.index\.json$/, ".embeddings.meta.json");
+}
+/**
+ * Load all embeddings from an ndjson file.
+ * Returns a Map of symbolId → Float32Array vector.
+ */
+export async function loadEmbeddings(embeddingPath) {
+    const embeddings = new Map();
+    try {
+        const raw = await readFile(embeddingPath, "utf-8");
+        const lines = raw.split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                const entry = parsed;
+                if (entry.id && Array.isArray(entry.vec)) {
+                    embeddings.set(entry.id, new Float32Array(entry.vec));
+                }
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+    }
+    catch {
+        // File doesn't exist — return empty
+    }
+    return embeddings;
+}
+/**
+ * Save all embeddings atomically to an ndjson file.
+ */
+export async function saveEmbeddings(embeddingPath, embeddings) {
+    const dir = dirname(embeddingPath);
+    await mkdir(dir, { recursive: true });
+    const lines = [];
+    for (const [id, vec] of embeddings) {
+        lines.push(JSON.stringify({ id, vec: Array.from(vec) }));
+    }
+    const tmpPath = `${embeddingPath}.tmp.${Date.now()}`;
+    const data = lines.join("\n") + "\n";
+    try {
+        await writeFile(tmpPath, data, "utf-8");
+        await rename(tmpPath, embeddingPath);
+    }
+    catch (err) {
+        try {
+            await unlink(tmpPath);
+        }
+        catch { /* cleanup best-effort */ }
+        throw err;
+    }
+}
+/**
+ * Save embedding metadata atomically.
+ */
+export async function saveEmbeddingMeta(metaPath, meta) {
+    const dir = dirname(metaPath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${metaPath}.tmp.${Date.now()}`;
+    const data = JSON.stringify(meta);
+    try {
+        await writeFile(tmpPath, data, "utf-8");
+        await rename(tmpPath, metaPath);
+    }
+    catch (err) {
+        try {
+            await unlink(tmpPath);
+        }
+        catch { /* cleanup best-effort */ }
+        throw err;
+    }
+}
+/**
+ * Load embedding metadata.
+ * Returns null if not found or invalid.
+ */
+export async function loadEmbeddingMeta(metaPath) {
+    try {
+        const raw = await readFile(metaPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === "object" && parsed !== null &&
+            typeof parsed["model"] === "string" &&
+            typeof parsed["dimensions"] === "number") {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Batch-embed symbols using the given provider, appending to existing embeddings.
+ * Only embeds symbols that don't already have an embedding.
+ *
+ * @param symbolTexts - Map of symbolId → text to embed
+ * @param existing - Existing embeddings to skip
+ * @param embedFn - The provider's embed function
+ * @param batchSize - How many texts per API call
+ * @returns Map of symbolId → Float32Array (existing + new)
+ */
+export async function batchEmbed(symbolTexts, existing, embedFn, batchSize) {
+    const result = new Map(existing);
+    // Find symbols that need embedding
+    const toEmbed = [];
+    for (const [id, text] of symbolTexts) {
+        if (!existing.has(id)) {
+            toEmbed.push({ id, text });
+        }
+    }
+    // Process in batches (only symbols that need embedding)
+    for (let i = 0; i < toEmbed.length; i += batchSize) {
+        const batch = toEmbed.slice(i, i + batchSize);
+        const texts = batch.map((b) => b.text);
+        const vectors = await embedFn(texts);
+        for (let j = 0; j < batch.length; j++) {
+            const entry = batch[j];
+            const vec = vectors[j];
+            if (entry && vec) {
+                result.set(entry.id, new Float32Array(vec));
+            }
+        }
+    }
+    // Remove embeddings for symbols that no longer exist in the corpus
+    const stale = [...result.keys()].filter((id) => !symbolTexts.has(id));
+    for (const id of stale) {
+        result.delete(id);
+    }
+    return result;
+}
+//# sourceMappingURL=embedding-store.js.map

package/dist/storage/embedding-store.js.map

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

package/dist/storage/index-store.d.ts

@@ -0,0 +1,23 @@
+import type { CodeIndex, CodeSymbol, FileEntry } from "../types.js";
+/**
+ * Save a code index atomically.
+ * Writes to a temp file first, then renames to prevent partial reads.
+ */
+export declare function saveIndex(indexPath: string, index: CodeIndex): Promise<void>;
+/**
+ * Load a code index from disk.
+ * Returns null if file doesn't exist, is unreadable, or has invalid shape.
+ */
+export declare function loadIndex(indexPath: string): Promise<CodeIndex | null>;
+/**
+ * Incrementally update an index for a single changed file.
+ * Removes old symbols for the file, adds new ones, and saves atomically.
+ * Serialized per indexPath to prevent read-modify-write races.
+ */
+export declare function saveIncremental(indexPath: string, updatedFile: string, newSymbols: CodeSymbol[], fileEntry?: FileEntry): Promise<void>;
+/**
+ * Derive a deterministic index file path from a repo root.
+ * Uses a truncated SHA-256 hash of the root path.
+ */
+export declare function getIndexPath(dataDir: string, repoRoot: string): string;
+//# sourceMappingURL=index-store.d.ts.map

package/dist/storage/index-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-store.d.ts","sourceRoot":"","sources":["../../src/storage/index-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAKpE;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAa3B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,EAAE,EACxB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOtE"}

package/dist/storage/index-store.js

@@ -0,0 +1,95 @@
+import { readFile, writeFile, rename, mkdir, unlink } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { createHash } from "node:crypto";
+/** Serialize concurrent writes to the same index path. */
+const writeLocks = new Map();
+/**
+ * Save a code index atomically.
+ * Writes to a temp file first, then renames to prevent partial reads.
+ */
+export async function saveIndex(indexPath, index) {
+    const dir = dirname(indexPath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${indexPath}.tmp.${Date.now()}.json`;
+    const data = JSON.stringify(index);
+    try {
+        await writeFile(tmpPath, data, "utf-8");
+        await rename(tmpPath, indexPath);
+    }
+    catch (err) {
+        try {
+            await unlink(tmpPath);
+        }
+        catch { /* cleanup best-effort */ }
+        throw err;
+    }
+}
+/**
+ * Load a code index from disk.
+ * Returns null if file doesn't exist, is unreadable, or has invalid shape.
+ */
+export async function loadIndex(indexPath) {
+    try {
+        const raw = await readFile(indexPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!isValidIndex(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Incrementally update an index for a single changed file.
+ * Removes old symbols for the file, adds new ones, and saves atomically.
+ * Serialized per indexPath to prevent read-modify-write races.
+ */
+export async function saveIncremental(indexPath, updatedFile, newSymbols, fileEntry) {
+    const prev = writeLocks.get(indexPath) ?? Promise.resolve();
+    const next = prev.then(async () => {
+        const existing = await loadIndex(indexPath);
+        if (!existing) {
+            throw new Error(`Cannot incrementally update: index not found at ${indexPath}`);
+        }
+        // Update symbols
+        const filtered = existing.symbols.filter((symbol) => symbol.file !== updatedFile);
+        const merged = [...filtered, ...newSymbols];
+        existing.symbols = merged;
+        existing.symbol_count = merged.length;
+        existing.updated_at = Date.now();
+        // Update files[] to keep it in sync
+        if (fileEntry) {
+            existing.files = existing.files.filter((f) => f.path !== updatedFile);
+            existing.files.push(fileEntry);
+            existing.file_count = existing.files.length;
+        }
+        await saveIndex(indexPath, existing);
+    });
+    // Store the chain (swallow errors so next caller isn't blocked)
+    writeLocks.set(indexPath, next.catch(() => { }));
+    return next;
+}
+/**
+ * Derive a deterministic index file path from a repo root.
+ * Uses a truncated SHA-256 hash of the root path.
+ */
+export function getIndexPath(dataDir, repoRoot) {
+    const hash = createHash("sha256")
+        .update(repoRoot)
+        .digest("hex")
+        .slice(0, 12);
+    return join(dataDir, `${hash}.index.json`);
+}
+function isValidIndex(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const obj = value;
+    if (typeof obj["repo"] !== "string")
+        return false;
+    if (!Array.isArray(obj["symbols"]))
+        return false;
+    return true;
+}
+//# sourceMappingURL=index-store.js.map

package/dist/storage/index-store.js.map

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

package/dist/storage/registry.d.ts

@@ -0,0 +1,35 @@
+import type { Registry, RepoMeta } from "../types.js";
+/**
+ * Load the multi-repo registry from disk.
+ * Returns an empty registry if the file doesn't exist or is invalid.
+ */
+export declare function loadRegistry(registryPath: string): Promise<Registry>;
+/**
+ * Save the registry atomically.
+ * Writes to a temp file first, then renames to prevent partial reads.
+ */
+export declare function saveRegistry(registryPath: string, registry: Registry): Promise<void>;
+/**
+ * Register or update a repo in the registry.
+ */
+export declare function registerRepo(registryPath: string, meta: RepoMeta): Promise<void>;
+/**
+ * Get a single repo's metadata by name.
+ * Returns null if the repo is not registered.
+ */
+export declare function getRepo(registryPath: string, name: string): Promise<RepoMeta | null>;
+/**
+ * List all registered repos.
+ */
+export declare function listRepos(registryPath: string): Promise<RepoMeta[]>;
+/**
+ * Remove a repo from the registry.
+ * Returns true if the repo existed and was removed, false otherwise.
+ */
+export declare function removeRepo(registryPath: string, name: string): Promise<boolean>;
+/**
+ * Derive a repo name from its root path.
+ * Format: "local/{folder-name}"
+ */
+export declare function getRepoName(repoRoot: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/storage/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/storage/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAa1E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAG1B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGrB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/storage/registry.js

@@ -0,0 +1,99 @@
+import { readFile, writeFile, rename, mkdir, unlink } from "node:fs/promises";
+import { dirname, basename } from "node:path";
+/**
+ * Load the multi-repo registry from disk.
+ * Returns an empty registry if the file doesn't exist or is invalid.
+ */
+export async function loadRegistry(registryPath) {
+    try {
+        const raw = await readFile(registryPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (isValidRegistry(parsed)) {
+            return parsed;
+        }
+        return emptyRegistry();
+    }
+    catch {
+        return emptyRegistry();
+    }
+}
+/**
+ * Save the registry atomically.
+ * Writes to a temp file first, then renames to prevent partial reads.
+ */
+export async function saveRegistry(registryPath, registry) {
+    const dir = dirname(registryPath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${registryPath}.tmp.${Date.now()}.json`;
+    const data = JSON.stringify(registry);
+    try {
+        await writeFile(tmpPath, data, "utf-8");
+        await rename(tmpPath, registryPath);
+    }
+    catch (err) {
+        try {
+            await unlink(tmpPath);
+        }
+        catch { /* cleanup best-effort */ }
+        throw err;
+    }
+}
+/**
+ * Register or update a repo in the registry.
+ */
+export async function registerRepo(registryPath, meta) {
+    const registry = await loadRegistry(registryPath);
+    registry.repos[meta.name] = meta;
+    registry.updated_at = Date.now();
+    await saveRegistry(registryPath, registry);
+}
+/**
+ * Get a single repo's metadata by name.
+ * Returns null if the repo is not registered.
+ */
+export async function getRepo(registryPath, name) {
+    const registry = await loadRegistry(registryPath);
+    return registry.repos[name] ?? null;
+}
+/**
+ * List all registered repos.
+ */
+export async function listRepos(registryPath) {
+    const registry = await loadRegistry(registryPath);
+    return Object.values(registry.repos);
+}
+/**
+ * Remove a repo from the registry.
+ * Returns true if the repo existed and was removed, false otherwise.
+ */
+export async function removeRepo(registryPath, name) {
+    const registry = await loadRegistry(registryPath);
+    if (!(name in registry.repos)) {
+        return false;
+    }
+    delete registry.repos[name];
+    registry.updated_at = Date.now();
+    await saveRegistry(registryPath, registry);
+    return true;
+}
+/**
+ * Derive a repo name from its root path.
+ * Format: "local/{folder-name}"
+ */
+export function getRepoName(repoRoot) {
+    return `local/${basename(repoRoot)}`;
+}
+function emptyRegistry() {
+    return { repos: {}, updated_at: Date.now() };
+}
+function isValidRegistry(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const obj = value;
+    if (typeof obj["repos"] !== "object" || obj["repos"] === null)
+        return false;
+    if (typeof obj["updated_at"] !== "number")
+        return false;
+    return true;
+}
+//# sourceMappingURL=registry.js.map

package/dist/storage/registry.js.map

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

package/dist/storage/usage-stats.d.ts

@@ -0,0 +1,32 @@
+export interface ToolStats {
+    tool: string;
+    total_calls: number;
+    total_result_tokens: number;
+    avg_elapsed_ms: number;
+    avg_result_tokens: number;
+}
+export interface RepoStats {
+    repo: string;
+    call_count: number;
+}
+export interface DailyStats {
+    date: string;
+    call_count: number;
+    total_tokens: number;
+}
+export interface UsageStats {
+    total_calls: number;
+    total_sessions: number;
+    avg_calls_per_session: number;
+    tools: ToolStats[];
+    top_repos: RepoStats[];
+    daily: DailyStats[];
+    earliest_ts: number;
+    latest_ts: number;
+}
+export declare function getUsageStats(options?: {
+    since?: string;
+    repo?: string;
+}): Promise<UsageStats>;
+export declare function formatUsageReport(stats: UsageStats): string;
+//# sourceMappingURL=usage-stats.d.ts.map

package/dist/storage/usage-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-stats.d.ts","sourceRoot":"","sources":["../../src/storage/usage-stats.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AA6DD,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,UAAU,CAAC,CAyFtB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAoD3D"}

package/dist/storage/usage-stats.js

@@ -0,0 +1,180 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// ---------------------------------------------------------------------------
+// Loading
+// ---------------------------------------------------------------------------
+function getUsagePath() {
+    const dataDir = process.env["CODESIFT_DATA_DIR"] ?? join(homedir(), ".codesift");
+    return join(dataDir, "usage.jsonl");
+}
+function isValidEntry(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj["ts"] === "number" &&
+        typeof obj["tool"] === "string" &&
+        typeof obj["elapsed_ms"] === "number" &&
+        typeof obj["session_id"] === "string");
+}
+async function loadEntries(options) {
+    const usagePath = getUsagePath();
+    let raw;
+    try {
+        raw = await readFile(usagePath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const sinceTs = options?.since ? new Date(options.since).getTime() : 0;
+    const repoFilter = options?.repo ?? null;
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (!isValidEntry(parsed))
+                continue;
+            if (parsed.ts < sinceTs)
+                continue;
+            if (repoFilter && parsed.repo !== repoFilter)
+                continue;
+            entries.push(parsed);
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Aggregation
+// ---------------------------------------------------------------------------
+export async function getUsageStats(options) {
+    const entries = await loadEntries(options);
+    if (entries.length === 0) {
+        return {
+            total_calls: 0,
+            total_sessions: 0,
+            avg_calls_per_session: 0,
+            tools: [],
+            top_repos: [],
+            daily: [],
+            earliest_ts: 0,
+            latest_ts: 0,
+        };
+    }
+    // Per-tool aggregation
+    const toolMap = new Map();
+    const repoMap = new Map();
+    const sessionSet = new Set();
+    const dailyMap = new Map();
+    let earliest = Infinity;
+    let latest = 0;
+    for (const entry of entries) {
+        // Tool stats
+        const existing = toolMap.get(entry.tool) ?? { calls: 0, tokens: 0, elapsed: 0 };
+        existing.calls += 1;
+        existing.tokens += entry.result_tokens;
+        existing.elapsed += entry.elapsed_ms;
+        toolMap.set(entry.tool, existing);
+        // Repo stats (skip empty)
+        if (entry.repo) {
+            repoMap.set(entry.repo, (repoMap.get(entry.repo) ?? 0) + 1);
+        }
+        // Sessions
+        sessionSet.add(entry.session_id);
+        // Daily
+        const date = new Date(entry.ts).toISOString().slice(0, 10);
+        const dayStats = dailyMap.get(date) ?? { calls: 0, tokens: 0 };
+        dayStats.calls += 1;
+        dayStats.tokens += entry.result_tokens;
+        dailyMap.set(date, dayStats);
+        // Time range
+        if (entry.ts < earliest)
+            earliest = entry.ts;
+        if (entry.ts > latest)
+            latest = entry.ts;
+    }
+    // Build sorted arrays
+    const tools = [...toolMap.entries()]
+        .map(([tool, stats]) => ({
+        tool,
+        total_calls: stats.calls,
+        total_result_tokens: stats.tokens,
+        avg_elapsed_ms: Math.round(stats.elapsed / stats.calls),
+        avg_result_tokens: Math.round(stats.tokens / stats.calls),
+    }))
+        .sort((a, b) => b.total_calls - a.total_calls);
+    const top_repos = [...repoMap.entries()]
+        .map(([repo, call_count]) => ({ repo, call_count }))
+        .sort((a, b) => b.call_count - a.call_count)
+        .slice(0, 20);
+    const daily = [...dailyMap.entries()]
+        .map(([date, stats]) => ({
+        date,
+        call_count: stats.calls,
+        total_tokens: stats.tokens,
+    }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+    const totalSessions = sessionSet.size;
+    return {
+        total_calls: entries.length,
+        total_sessions: totalSessions,
+        avg_calls_per_session: Math.round((entries.length / totalSessions) * 10) / 10,
+        tools,
+        top_repos,
+        daily,
+        earliest_ts: earliest,
+        latest_ts: latest,
+    };
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+export function formatUsageReport(stats) {
+    if (stats.total_calls === 0) {
+        return "No usage data recorded yet.";
+    }
+    const lines = [];
+    // Header
+    const earliest = new Date(stats.earliest_ts).toISOString().slice(0, 10);
+    const latest = new Date(stats.latest_ts).toISOString().slice(0, 10);
+    lines.push("=== CodeSift Usage Report ===");
+    lines.push(`Period: ${earliest} to ${latest}`);
+    lines.push(`Total calls: ${stats.total_calls}`);
+    lines.push(`Total sessions: ${stats.total_sessions}`);
+    lines.push(`Avg calls/session: ${stats.avg_calls_per_session}`);
+    lines.push("");
+    // Tool breakdown
+    lines.push("--- Tool Breakdown ---");
+    const maxToolLen = Math.max(...stats.tools.map((t) => t.tool.length), 4);
+    lines.push(`${"Tool".padEnd(maxToolLen)}  ${"Calls".padStart(6)}  ${"Tokens".padStart(8)}  ${"Avg ms".padStart(7)}  ${"Avg tok".padStart(7)}`);
+    for (const t of stats.tools) {
+        lines.push(`${t.tool.padEnd(maxToolLen)}  ${String(t.total_calls).padStart(6)}  ${String(t.total_result_tokens).padStart(8)}  ${String(t.avg_elapsed_ms).padStart(7)}  ${String(t.avg_result_tokens).padStart(7)}`);
+    }
+    lines.push("");
+    // Top repos
+    if (stats.top_repos.length > 0) {
+        lines.push("--- Top Repos ---");
+        for (const r of stats.top_repos) {
+            lines.push(`  ${r.repo}: ${r.call_count} calls`);
+        }
+        lines.push("");
+    }
+    // Daily breakdown (last 14 days max)
+    if (stats.daily.length > 0) {
+        lines.push("--- Daily Usage ---");
+        const recentDays = stats.daily.slice(-14);
+        for (const d of recentDays) {
+            lines.push(`  ${d.date}: ${d.call_count} calls, ${d.total_tokens} tokens`);
+        }
+        if (stats.daily.length > 14) {
+            lines.push(`  ... and ${stats.daily.length - 14} earlier days`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=usage-stats.js.map

package/dist/storage/usage-stats.js.map

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