@cairn-tool/cairn 2.0.0

package/dist/usage/providers/types.d.ts

@@ -0,0 +1,74 @@
+import type { FileAggregate, ParsedFile, TranscriptKind } from "../events.js";
+/**
+ * What a provider can report on.
+ *
+ * This is data the renderer reads, exactly as `TargetProfile` is for
+ * `src/agent/render.ts`. `src/commands/usage.ts` must never branch on
+ * `provider.name`: a report a provider cannot serve is decided here, so adding
+ * a second LLM's logs is a new module plus a registry line and nothing else.
+ */
+export interface ProviderCapabilities {
+    tokens: boolean;
+    /** Cache read and cache write counters, separately from plain input tokens. */
+    cacheTokens: boolean;
+    tools: boolean;
+    skills: boolean;
+    subagents: boolean;
+    hooks: boolean;
+    mcp: boolean;
+    slashCommands: boolean;
+    /** Whether records carry the working directory a session ran in. */
+    projects: boolean;
+}
+/** A transcript found on disk, described without opening it. */
+export interface TranscriptFile {
+    /** Absolute path. */
+    file: string;
+    /** Path relative to the provider root; the index shard keys on this. */
+    relative: string;
+    /** Shard the aggregate belongs to; a filesystem-safe slug. */
+    shard: string;
+    kind: TranscriptKind;
+    size: number;
+    mtimeMs: number;
+}
+export interface DiscoverOptions {
+    /** Include subagent transcripts. */
+    subagents: boolean;
+    /**
+     * Drop files last modified before this instant.
+     *
+     * A transcript is append-only, so an mtime older than the window start cannot
+     * contain a record inside it. This is the difference between opening a handful
+     * of files and opening every one of them.
+     */
+    modifiedSince?: number;
+}
+export interface ProviderEnvironment {
+    env: NodeJS.ProcessEnv;
+    home: string;
+    /** Explicit `--logs <dir>` override, which wins over every discovery rule. */
+    override?: string;
+}
+export interface UsageProvider {
+    readonly name: string;
+    readonly title: string;
+    /** One line describing where this provider's logs come from. */
+    readonly source: string;
+    readonly capabilities: ProviderCapabilities;
+    /** The log root, or null when this provider has left nothing on this machine. */
+    root(context: ProviderEnvironment): string | null;
+    /** Enumerate candidate transcripts under a root, without parsing them. */
+    discover(root: string, options: DiscoverOptions): TranscriptFile[];
+    /** Reduce one transcript to its aggregate. Never throws on malformed content. */
+    read(file: TranscriptFile): Promise<FileAggregate>;
+    /**
+     * The same single pass as {@link read}, also returning the per-occurrence
+     * event decomposition the usage store keeps.
+     *
+     * `read` is the aggregate half of this and stays on the interface because
+     * every rollup wants only that; a caller that needs neither the events nor a
+     * second pass should keep calling it.
+     */
+    parse(file: TranscriptFile): Promise<ParsedFile>;
+}

package/dist/usage/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/usage/providers/types.js.map

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

package/dist/usage/scan.d.ts

@@ -0,0 +1,54 @@
+import type { FileAggregate } from "./events.js";
+import type { ProjectSelector, Window } from "./filter.js";
+import type { UsageProvider } from "./providers/types.js";
+export interface ScanOptions {
+    provider: UsageProvider;
+    root: string;
+    subagents: boolean;
+    window: Window;
+    projects: readonly ProjectSelector[];
+    /** Keep only the n most recent sessions. Applied after aggregation. */
+    last?: number;
+    /** When false the store is neither read nor written. */
+    useIndex: boolean;
+    /** Re-parse every file even on a hit, then rewrite its rows. */
+    rebuild?: boolean;
+    /** Overrides the discovered store path. */
+    databasePath?: string;
+    concurrency?: number;
+}
+export interface ScanCounters {
+    /** Transcripts the provider found, after the mtime prune. */
+    discovered: number;
+    /** Served from the index without opening the file. */
+    cached: number;
+    /** Opened and parsed. */
+    parsed: number;
+    /** Found but unreadable. */
+    skipped: number;
+    /** Lines that were not valid JSON, across every file parsed. */
+    malformed: number;
+    /** Aggregates left after the project and window filters. */
+    selected: number;
+}
+export interface ScanFailure {
+    file: string;
+    reason: string;
+}
+export interface ScanResult {
+    files: FileAggregate[];
+    counters: ScanCounters;
+    failures: ScanFailure[];
+    /** The store this scan read and wrote, or null under `--no-index`. */
+    cacheRoot: string | null;
+}
+export declare function defaultScanConcurrency(): number;
+export declare function scan(options: ScanOptions): Promise<ScanResult>;
+/**
+ * Keeps every aggregate belonging to the n most recently active sessions.
+ *
+ * Sessions rather than files: a session's subagent transcripts are part of it,
+ * and `--last 10` that silently dropped nine tenths of the tokens would be
+ * worse than useless.
+ */
+export declare function keepRecentSessions(files: FileAggregate[], last: number): FileAggregate[];

package/dist/usage/scan.js

@@ -0,0 +1,216 @@
+import os from "node:os";
+import { sessionKey } from "./events.js";
+import { clipToWindow, matchesProject, modifiedSinceFor } from "./filter.js";
+import { getUsageDatabasePath, openUsageDatabase } from "./db/open.js";
+import { deleteMissing, prepareWrites, selectFiles, storedFiles, writeParsedFile, } from "./db/store.js";
+/**
+ * Discovery, store reconciliation, and parsing.
+ *
+ * This is the only module in `src/usage` that both reads the filesystem and
+ * writes the store; `filter.ts` and `aggregate.ts` stay pure so their rules can
+ * be tested without fixtures on disk.
+ *
+ * The store is a SQLite database rather than the directory of JSON shards this
+ * used to keep, but the reconciliation rules are unchanged and deliberately so:
+ * freshness is still `(size, mtime)`, and a walk that discovery pruned still may
+ * not delete. What the database adds is the per-event grain, which no report
+ * reads today and no shard could have held.
+ */
+/** How many files one transaction covers, so a large import is not one lock. */
+const BATCH = 200;
+/**
+ * Bounded worker pool, in the shape already used by `src/commands/audit.ts` and
+ * `src/commands/check-urls.ts`.
+ */
+async function concurrent(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < items.length) {
+            const index = next++;
+            results[index] = await fn(items[index]);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(Math.max(1, limit), items.length || 1) }, worker));
+    return results;
+}
+export function defaultScanConcurrency() {
+    return Math.max(2, Math.min(8, os.cpus().length));
+}
+function isFresh(entry, file) {
+    return entry !== undefined && entry.size === file.size && entry.mtimeMs === file.mtimeMs;
+}
+export async function scan(options) {
+    const counters = {
+        discovered: 0,
+        cached: 0,
+        parsed: 0,
+        skipped: 0,
+        malformed: 0,
+        selected: 0,
+    };
+    const failures = [];
+    const modifiedSince = modifiedSinceFor(options.window);
+    const discovered = options.provider.discover(options.root, {
+        subagents: options.subagents,
+        modifiedSince,
+    });
+    counters.discovered = discovered.length;
+    /**
+     * Whether discovery deliberately looked at only part of the corpus.
+     *
+     * A pruned walk must merge into the stored shard rather than replace it:
+     * rebuilding a shard from a `--since 7d` or `--no-subagents` discovery would
+     * evict every entry the walk never considered, so the next full scan would
+     * re-parse everything it had already done. Only a complete walk is entitled to
+     * drop entries, because only then does an entry's absence prove the transcript
+     * is gone.
+     */
+    const partial = modifiedSince !== undefined || !options.subagents;
+    const databasePath = options.useIndex ? (options.databasePath ?? getUsageDatabasePath()) : null;
+    const aggregates = [];
+    if (!databasePath) {
+        // `--no-index`: parse everything found and keep nothing.
+        const parsed = await concurrent(discovered, options.concurrency ?? defaultScanConcurrency(), async (file) => {
+            try {
+                return await options.provider.read(file);
+            }
+            catch (error) {
+                failures.push({ file: file.file, reason: error.message });
+                return null;
+            }
+        });
+        for (const aggregate of parsed) {
+            if (!aggregate) {
+                counters.skipped += 1;
+                continue;
+            }
+            counters.parsed += 1;
+            counters.malformed += aggregate.malformedLines;
+            aggregates.push(aggregate);
+        }
+    }
+    else {
+        const opened = openUsageDatabase({ path: databasePath });
+        const db = opened.db;
+        try {
+            const stored = storedFiles(db, options.provider.name);
+            const misses = [];
+            const seen = new Set();
+            for (const file of discovered) {
+                seen.add(file.relative);
+                if (!options.rebuild && isFresh(stored.get(file.relative), file))
+                    counters.cached += 1;
+                else
+                    misses.push(file);
+            }
+            if (misses.length > 0) {
+                const statements = prepareWrites(db);
+                const importedAt = new Date().toISOString();
+                // Parsing is the slow half and runs concurrently; writing is serial,
+                // because one SQLite connection has one writer.
+                for (let offset = 0; offset < misses.length; offset += BATCH) {
+                    const batch = misses.slice(offset, offset + BATCH);
+                    const parsed = await concurrent(batch, options.concurrency ?? defaultScanConcurrency(), async (file) => {
+                        try {
+                            return { file, parsed: await options.provider.parse(file) };
+                        }
+                        catch (error) {
+                            failures.push({ file: file.file, reason: error.message });
+                            return null;
+                        }
+                    });
+                    db.exec("BEGIN");
+                    try {
+                        for (const result of parsed) {
+                            if (!result) {
+                                counters.skipped += 1;
+                                continue;
+                            }
+                            counters.parsed += 1;
+                            counters.malformed += result.parsed.aggregate.malformedLines;
+                            writeParsedFile(statements, result.parsed, result.file.relative, importedAt, stored.get(result.file.relative)?.id);
+                        }
+                        db.exec("COMMIT");
+                    }
+                    catch (error) {
+                        db.exec("ROLLBACK");
+                        throw error;
+                    }
+                }
+            }
+            // Only a complete walk may delete: absence proves the transcript is gone
+            // only when the walk would have found it.
+            if (!partial) {
+                db.exec("BEGIN");
+                try {
+                    deleteMissing(db, options.provider.name, seen);
+                    db.exec("COMMIT");
+                }
+                catch (error) {
+                    db.exec("ROLLBACK");
+                    throw error;
+                }
+            }
+            aggregates.push(...selectFiles(db, {
+                providers: [options.provider.name],
+                subagents: options.subagents,
+                since: options.window.since ?? undefined,
+                until: options.window.until ?? undefined,
+            }));
+        }
+        finally {
+            closeQuietly(db);
+        }
+    }
+    let selected = [];
+    for (const aggregate of aggregates) {
+        // Only some providers can tell a subagent transcript from its path; the
+        // rest record it inside the file, so the filter is applied again here on
+        // the parsed value. Discovery has already pruned whatever it could.
+        if (!options.subagents && aggregate.kind === "subagent")
+            continue;
+        if (!matchesProject(aggregate.project, options.projects))
+            continue;
+        const clipped = clipToWindow(aggregate, options.window);
+        if (clipped)
+            selected.push(clipped);
+    }
+    if (options.last !== undefined && options.last > 0) {
+        selected = keepRecentSessions(selected, options.last);
+    }
+    counters.selected = selected.length;
+    return { files: selected, counters, failures, cacheRoot: databasePath };
+}
+function closeQuietly(db) {
+    try {
+        db.close();
+    }
+    catch {
+        // A store that will not close cleanly must not fail a report that already
+        // has its numbers.
+    }
+}
+/**
+ * Keeps every aggregate belonging to the n most recently active sessions.
+ *
+ * Sessions rather than files: a session's subagent transcripts are part of it,
+ * and `--last 10` that silently dropped nine tenths of the tokens would be
+ * worse than useless.
+ */
+export function keepRecentSessions(files, last) {
+    const latest = new Map();
+    for (const file of files) {
+        const key = sessionKey(file);
+        const current = latest.get(key);
+        if (current === undefined || file.lastTs > current)
+            latest.set(key, file.lastTs);
+    }
+    const ranked = [...latest.entries()]
+        .sort((a, b) => (a[1] < b[1] ? 1 : a[1] > b[1] ? -1 : 0))
+        .slice(0, last)
+        .map(([key]) => key);
+    const keep = new Set(ranked);
+    return files.filter((file) => keep.has(sessionKey(file)));
+}
+//# sourceMappingURL=scan.js.map

package/dist/usage/scan.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const packageName: string;
+export declare const packageVersion: string;

package/dist/version.js

@@ -0,0 +1,8 @@
+import { createRequire } from "node:module";
+// Read the version at runtime rather than inlining it: semantic-release rewrites
+// package.json at release time, so a literal here would always be stale.
+// From dist/version.js, "../package.json" is the package root — always present in the tarball.
+const manifest = createRequire(import.meta.url)("../package.json");
+export const packageName = manifest.name;
+export const packageVersion = manifest.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,iFAAiF;AACjF,yEAAyE;AACzE,+FAA+F;AAC/F,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAGhE,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC"}

package/dist/workspace-index.d.ts

@@ -0,0 +1,39 @@
+import type { MarkdownDocument } from "./workspace.js";
+export interface FileFingerprint {
+    size: number;
+    mtimeMs: number;
+}
+export interface WorkspaceIndexStatus {
+    cachePath: string;
+    exists: boolean;
+    version: number;
+    indexed: number;
+    current: number;
+    stale: number;
+    missing: number;
+}
+export declare function getWorkspaceIndexPath(root: string, env?: NodeJS.ProcessEnv, home?: string): string;
+export declare function fingerprint(filePath: string): FileFingerprint;
+export declare class WorkspaceIndex {
+    readonly root: string;
+    readonly renderer: string;
+    readonly cachePath: string;
+    private loaded;
+    private exists;
+    private documents;
+    private readonly changed;
+    private readonly removed;
+    constructor(root: string, renderer: string, cachePath?: string);
+    private key;
+    private load;
+    get(filePath: string, current: FileFingerprint): MarkdownDocument | undefined;
+    set(filePath: string, current: FileFingerprint, document: MarkdownDocument): void;
+    invalidate(filePath: string): void;
+    replace(directory: string, records: Map<string, {
+        fingerprint: FileFingerprint;
+        document: MarkdownDocument;
+    }>): void;
+    status(files: string[]): WorkspaceIndexStatus;
+    clear(strict?: boolean): void;
+    flush(strict?: boolean): void;
+}