@cairn-tool/cairn 2.0.0

package/dist/usage/providers/gemini-cli.js

@@ -0,0 +1,466 @@
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import { createReadStream } from "node:fs";
+import { addTokens, emptyBucket, emptyTokens, utcDay } from "../events.js";
+/**
+ * Google Gemini CLI chat transcripts.
+ *
+ * ```
+ * tmp/<slug>/chats/session-<local stamp>-<short id>.jsonl   main
+ * tmp/<slug>/chats/<parent session uuid>/<short id>.jsonl   subagent
+ * tmp/<slug>/.project_root                                  the absolute project root
+ * tmp/<slug>/logs.json                                      prompts and slash commands
+ * ```
+ *
+ * **This provider shares `~/.gemini` with `antigravity` and must not collide
+ * with it.** That one roots at `~/.gemini/antigravity-cli`; this one roots at
+ * `~/.gemini` and guards on `tmp/`, so neither can claim the other's tree.
+ *
+ * Line 1 is normally a header — `{sessionId, projectHash, startTime,
+ * lastUpdated, kind}`, plus `directories` on a subagent — but not always: at
+ * least one file in a real corpus begins with an ordinary record, so the header
+ * is detected rather than assumed. Later lines are either
+ * `{id, timestamp, type, content, toolCalls?, model, tokens?}` or a `$set`
+ * patch record.
+ *
+ * **It is the only provider that has to undo two distortions at once**, and a
+ * third on top:
+ *
+ * 1. `tokens.cached` is contained *inside* `tokens.input`, as Codex's is, so
+ *    the cached part is subtracted out and reported as a cache read. Left
+ *    merged, input reads several times high.
+ * 2. `tokens.input` is a **per-request context size and not a running total**,
+ *    as Antigravity's is — it falls whenever context is trimmed, so it is
+ *    summed. Differencing it produces nonsense.
+ * 3. One assistant turn is written **two to five times under a single `id`**,
+ *    each copy carrying identical `tokens`. Counting every copy roughly doubles
+ *    every figure, so tokens are deduplicated on `id`.
+ *
+ * `total === input + output + thoughts` holds on every record of a real corpus
+ * and is used as a validity guard. Unlike Antigravity's — where a wholesale
+ * protobuf renumbering would poison every field at once, so the whole file's
+ * token column is abandoned — these fields are *named*, so a record that fails
+ * the guard is only ever one bad record. It contributes no tokens and the rest
+ * of the file is kept.
+ */
+/** The discovery root under the Gemini home; also what `root()` guards on. */
+const TMP = "tmp";
+const CHATS = "chats";
+const PROJECT_ROOT = ".project_root";
+const LOGS = "logs.json";
+/**
+ * The guard's upper bound on one request's context.
+ *
+ * Comfortably above any real Gemini context window, and low enough that a
+ * misread field is caught rather than summed into the totals.
+ */
+const MAX_CONTEXT_TOKENS = 4_000_000;
+/** A finite number, or null when the field is absent or the wrong shape. */
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function text(value) {
+    return typeof value === "string" && value ? value : null;
+}
+/**
+ * Normalizes one record's `tokens`, or returns null when it fails the guard.
+ *
+ * `cached` is subtracted out of `input` because Gemini counts a cache read
+ * inside its input figure, and reported separately. There is no cache-*write*
+ * counter anywhere on disk, so `cacheWrite` is always zero — the same shape
+ * Codex reports for a request that wrote no cache.
+ */
+function readUsage(raw) {
+    const input = num(raw.input);
+    const output = num(raw.output);
+    const thoughts = num(raw.thoughts);
+    const cached = num(raw.cached);
+    const total = num(raw.total);
+    if (input === null || output === null || thoughts === null || total === null)
+        return null;
+    if (cached === null || cached < 0 || cached > input)
+        return null;
+    if (input < 0 || output < 0 || thoughts < 0)
+        return null;
+    if (input > MAX_CONTEXT_TOKENS)
+        return null;
+    if (total !== input + output + thoughts)
+        return null;
+    return {
+        input: input - cached,
+        output,
+        cacheRead: cached,
+        cacheWrite: 0,
+        cacheWrite5m: 0,
+        cacheWrite1h: 0,
+        thinking: thoughts,
+        webSearch: 0,
+        webFetch: 0,
+        requests: 1,
+    };
+}
+function emit(state, event) {
+    state.events.push({ ts: state.ts, ...event });
+}
+function bucketFor(state, timestamp) {
+    const day = timestamp ? utcDay(timestamp) : null;
+    if (!day)
+        return null;
+    const aggregate = state.aggregate;
+    if (!aggregate.firstTs || timestamp < aggregate.firstTs)
+        aggregate.firstTs = timestamp;
+    if (!aggregate.lastTs || timestamp > aggregate.lastTs)
+        aggregate.lastTs = timestamp;
+    return (aggregate.days[day] ??= emptyBucket());
+}
+/**
+ * Counts one flushed tool call.
+ *
+ * The name is kept exactly as Gemini wrote it. `invoke_agent` and
+ * `activate_skill` are this assistant's own builtins and are counted as such in
+ * `tools`, while also filling `agents` and `skills` — the same split
+ * `claude-code.ts` makes for `Agent` and `Skill`, and `codex.ts` for
+ * `spawn_agent`. Renaming them to Claude Code's vocabulary would print a tool
+ * that does not appear in the transcript.
+ */
+function applyToolCall(state, bucket, call) {
+    const name = text(call.name);
+    if (!name)
+        return;
+    bucket.tools[name] = (bucket.tools[name] ?? 0) + 1;
+    emit(state, { kind: "tool_use", tool: name });
+    if (name === "invoke_agent") {
+        const role = text(call.args?.agent_name) ?? "(unrecorded)";
+        const totals = (bucket.agents[role] ??= { count: 0, maxDepth: 0 });
+        totals.count += 1;
+        emit(state, { kind: "agent", name: role });
+    }
+    else if (name === "activate_skill") {
+        const skill = text(call.args?.name);
+        if (skill) {
+            bucket.skills[skill] = (bucket.skills[skill] ?? 0) + 1;
+            emit(state, { kind: "skill", name: skill });
+        }
+    }
+    // `cancelled` is deliberately not counted: `DayBucket` has no cancelled
+    // counter outside `hooks`, and folding one into `errors` would report a
+    // user's interruption as a failure.
+    if (text(call.status) === "error") {
+        bucket.errors += 1;
+        emit(state, { kind: "error" });
+    }
+}
+function flushTools(state) {
+    for (const pending of state.pendingTools.values()) {
+        const bucket = bucketFor(state, pending.ts);
+        if (!bucket)
+            continue;
+        state.ts = pending.ts;
+        for (const call of pending.calls)
+            applyToolCall(state, bucket, call);
+    }
+    state.pendingTools.clear();
+}
+function applyRecord(state, record) {
+    // A `$set` patch never carries tokens or tool calls — only `lastUpdated`,
+    // `summary` (the session title, not a context reset), and `memoryScratchpad`.
+    // Its timestamp would otherwise open a spurious day bucket.
+    if (record.$set)
+        return;
+    const timestamp = text(record.timestamp);
+    const bucket = bucketFor(state, timestamp ?? undefined);
+    if (!bucket)
+        return;
+    state.ts = timestamp;
+    const id = text(record.id);
+    if (record.tokens && id && !state.tokenIds.has(id)) {
+        state.tokenIds.add(id);
+        const tokens = readUsage(record.tokens);
+        if (tokens) {
+            const model = text(record.model) ?? "(unknown)";
+            addTokens((bucket.models[model] ??= emptyTokens()), tokens);
+            emit(state, { kind: "response", model, tokens });
+        }
+    }
+    if (Array.isArray(record.toolCalls) && id) {
+        state.pendingTools.set(id, { ts: timestamp, calls: record.toolCalls });
+    }
+    // A subagent transcript's `user` record is the spawn instruction its parent
+    // injected, not a human turn. On a real corpus those outnumber real prompts
+    // fourteen to one, so counting them would make the prompt figure meaningless.
+    if (record.type === "user" && state.aggregate.kind === "main") {
+        bucket.prompts += 1;
+        emit(state, { kind: "prompt" });
+    }
+}
+/** Applies line 1 when it is a header rather than an ordinary record. */
+function applyHeader(aggregate, record) {
+    const session = text(record.sessionId);
+    if (session)
+        aggregate.sessionId = session;
+    if (Array.isArray(record.directories)) {
+        const first = text(record.directories[0]);
+        if (first)
+            aggregate.project = first;
+    }
+}
+function isHeader(record) {
+    return typeof record.sessionId === "string" && record.type === undefined;
+}
+function listDirectory(directory) {
+    try {
+        return fs.readdirSync(directory, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+function statOf(file) {
+    try {
+        const stats = fs.statSync(file);
+        return stats.isFile() ? stats : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The absolute project root for one slug directory, memoized.
+ *
+ * `.project_root` is exact where Claude Code's directory slug is lossy, so
+ * there is no need to reconstruct anything. `projectHash` in the header is a
+ * sha256 of this same path — a cross-check, not a source, since a hash cannot
+ * be read back — and `~/.gemini/projects.json` duplicates it from outside the
+ * shard, so neither is used.
+ */
+const projectRoots = new Map();
+function readProjectRoot(shardDirectory) {
+    const cached = projectRoots.get(shardDirectory);
+    if (cached !== undefined)
+        return cached;
+    let value = "";
+    try {
+        value = fs.readFileSync(path.join(shardDirectory, PROJECT_ROOT), "utf-8").trim();
+    }
+    catch {
+        // No `.project_root`: the project is left unattributed rather than guessed
+        // at from the slug, which is lossy.
+    }
+    projectRoots.set(shardDirectory, value);
+    return value;
+}
+/**
+ * Slash commands for one slug directory, memoized, keyed by session id.
+ *
+ * The transcript keeps only the *expanded* prompt: `/opplan-convert foo`
+ * reaches the chat as `foo`, so the command's name survives nowhere but
+ * `logs.json`. Each entry carries its own timestamp, so a command lands on the
+ * day it was used rather than on the session's first day.
+ *
+ * Two limits worth knowing, both inherent rather than defects. A cached
+ * aggregate keys on the *chat file's* size and mtime, so a command written
+ * after that file last changed is not seen until it changes again. And
+ * `logs.json` outlives the transcripts — `/clear` keeps the session id while
+ * truncating the chat — so commands belonging to a session with no surviving
+ * transcript have no aggregate to attach to and are dropped.
+ */
+const projectCommands = new Map();
+function readProjectCommands(shardDirectory) {
+    const cached = projectCommands.get(shardDirectory);
+    if (cached)
+        return cached;
+    const found = new Map();
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(shardDirectory, LOGS), "utf-8"));
+        for (const entry of Array.isArray(parsed) ? parsed : []) {
+            const record = entry;
+            const session = text(record.sessionId);
+            const message = text(record.message);
+            const ts = text(record.timestamp);
+            if (!session || !message || !ts || !message.startsWith("/"))
+                continue;
+            const name = message.trim().split(/\s+/)[0];
+            if (!name || name === "/")
+                continue;
+            const list = found.get(session) ?? [];
+            list.push({ ts, name });
+            found.set(session, list);
+        }
+    }
+    catch {
+        // No history, or a torn file. Commands are one counter among many.
+    }
+    projectCommands.set(shardDirectory, found);
+    return found;
+}
+export const geminiCliProvider = {
+    name: "gemini-cli",
+    title: "Gemini CLI",
+    // No environment override exists: the CLI was checked for one and none is
+    // honoured for the data root, so `--logs` is the only way to point it elsewhere.
+    source: "Chat transcripts under ~/.gemini/tmp (no environment override; use --logs)",
+    capabilities: {
+        tokens: true,
+        // `cached` is a real, measured cache read, contained inside `input` and
+        // subtracted back out. No cache-*write* figure exists anywhere on disk, so
+        // that counter is always zero.
+        cacheTokens: true,
+        tools: true,
+        // `activate_skill` names the skill in `args.name`.
+        skills: true,
+        // Subagent transcripts nest one level under `chats/`, and outnumber main
+        // transcripts by more than an order of magnitude.
+        subagents: true,
+        // Hooks are configured in ~/.gemini/settings.json, but no execution of one
+        // is written to any transcript record.
+        hooks: false,
+        // A tool call records a bare name and nothing else, so an MCP tool cannot
+        // be told from a builtin and there is no server to attribute it to.
+        mcp: false,
+        // From logs.json, which is the only place a command is named.
+        slashCommands: true,
+        projects: true,
+    },
+    root(context) {
+        const candidate = context.override?.trim() || path.join(context.home, ".gemini");
+        try {
+            return fs.statSync(path.join(candidate, TMP)).isDirectory() ? candidate : null;
+        }
+        catch {
+            return null;
+        }
+    },
+    discover(root, options) {
+        const tmp = path.join(root, TMP);
+        const found = [];
+        const accept = (file, shard, kind, stats) => {
+            if (options.modifiedSince !== undefined && stats.mtimeMs < options.modifiedSince)
+                return;
+            found.push({
+                file,
+                relative: path.relative(tmp, file),
+                shard,
+                kind,
+                size: stats.size,
+                mtimeMs: stats.mtimeMs,
+            });
+        };
+        for (const slug of listDirectory(tmp)) {
+            if (!slug.isDirectory())
+                continue;
+            // Requiring a `chats/` directory is what keeps `tmp/bin/` out: the CLI
+            // downloads helper binaries there, beside the projects.
+            const chats = path.join(tmp, slug.name, CHATS);
+            for (const entry of listDirectory(chats)) {
+                const full = path.join(chats, entry.name);
+                if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+                    const stats = statOf(full);
+                    if (stats)
+                        accept(full, slug.name, "main", stats);
+                    continue;
+                }
+                if (!entry.isDirectory() || !options.subagents)
+                    continue;
+                for (const agent of listDirectory(full)) {
+                    if (!agent.isFile() || !agent.name.endsWith(".jsonl"))
+                        continue;
+                    const agentFile = path.join(full, agent.name);
+                    const stats = statOf(agentFile);
+                    if (stats)
+                        accept(agentFile, slug.name, "subagent", stats);
+                }
+            }
+        }
+        // Byte comparison, never localeCompare: the order must not depend on the
+        // ICU build of the machine that ran the scan.
+        found.sort((a, b) => (a.relative < b.relative ? -1 : a.relative > b.relative ? 1 : 0));
+        return found;
+    },
+    async read(file) {
+        return (await geminiCliProvider.parse(file)).aggregate;
+    },
+    async parse(file) {
+        const subagent = file.kind === "subagent";
+        // A subagent's parent is its containing directory, exactly as it is for
+        // Claude Code, so neither id needs reading out of the file.
+        const sessionId = path.basename(file.file, ".jsonl");
+        const shardDirectory = subagent
+            ? path.dirname(path.dirname(path.dirname(file.file)))
+            : path.dirname(path.dirname(file.file));
+        const aggregate = {
+            file: file.file,
+            size: file.size,
+            mtimeMs: file.mtimeMs,
+            provider: geminiCliProvider.name,
+            sessionId,
+            kind: file.kind,
+            project: readProjectRoot(shardDirectory),
+            firstTs: "",
+            lastTs: "",
+            days: {},
+            malformedLines: 0,
+        };
+        if (subagent) {
+            aggregate.parentSessionId = path.basename(path.dirname(file.file));
+            // `agentType` is deliberately left unset. A subagent transcript records
+            // no role of its own; the role lives in the parent's `invoke_agent` call,
+            // which a single-transcript parse cannot reach. The spawn counts and
+            // names are still exact, because the parent fills `agents` from that same
+            // call — this only means `usage agents --by role` has nothing extra to
+            // learn from the child. Claude Code has the same gap when a subagent's
+            // `.meta.json` is missing.
+            aggregate.agentId = sessionId;
+        }
+        const state = {
+            aggregate,
+            events: [],
+            ts: "",
+            tokenIds: new Set(),
+            pendingTools: new Map(),
+        };
+        const lines = readline.createInterface({
+            input: createReadStream(file.file, { encoding: "utf-8" }),
+            crlfDelay: Infinity,
+        });
+        let first = true;
+        for await (const line of lines) {
+            if (!line)
+                continue;
+            let record;
+            try {
+                record = JSON.parse(line);
+            }
+            catch {
+                aggregate.malformedLines += 1;
+                continue;
+            }
+            if (!record || typeof record !== "object")
+                continue;
+            if (first) {
+                first = false;
+                // Not every file has one: at least one transcript in a real corpus
+                // begins with an ordinary record, so the header is detected rather
+                // than assumed and a file without one parses normally.
+                if (isHeader(record)) {
+                    applyHeader(aggregate, record);
+                    continue;
+                }
+            }
+            applyRecord(state, record);
+        }
+        flushTools(state);
+        if (!subagent) {
+            for (const command of readProjectCommands(shardDirectory).get(aggregate.sessionId) ?? []) {
+                const bucket = bucketFor(state, command.ts);
+                if (!bucket)
+                    continue;
+                state.ts = command.ts;
+                bucket.commands[command.name] = (bucket.commands[command.name] ?? 0) + 1;
+                emit(state, { kind: "command", name: command.name });
+            }
+        }
+        return { aggregate, events: state.events };
+    },
+};
+//# sourceMappingURL=gemini-cli.js.map

package/dist/usage/providers/gemini-cli.js.map

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

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

@@ -0,0 +1,23 @@
+import type { UsageProvider } from "./types.js";
+/**
+ * Every provider whose logs `usage` can report on.
+ *
+ * Registering another assistant is a new module plus a line here. Nothing in
+ * `src/commands/usage.ts` may branch on a provider's name: what a provider can
+ * answer is read from its `capabilities`, the same rule that keeps
+ * `src/agent/render.ts` free of per-target conditionals.
+ */
+export declare const PROVIDERS: readonly UsageProvider[];
+export declare const DEFAULT_PROVIDER: string;
+/** Selects every registered provider rather than one. */
+export declare const ALL_PROVIDERS = "all";
+export declare function providerNames(): string[];
+/**
+ * Resolves `--provider` to the providers a report covers.
+ *
+ * `all` returns every registered provider; whether each has anything on this
+ * machine is decided later, by `root()`, so that an unavailable one is simply
+ * absent from the results rather than an error.
+ */
+export declare function resolveProviders(name: string | undefined): UsageProvider[];
+export type { UsageProvider } from "./types.js";

package/dist/usage/providers/index.js

@@ -0,0 +1,46 @@
+import { antigravityProvider } from "./antigravity.js";
+import { claudeCodeProvider } from "./claude-code.js";
+import { codexProvider } from "./codex.js";
+import { geminiCliProvider } from "./gemini-cli.js";
+import { opencodeProvider } from "./opencode.js";
+/**
+ * Every provider whose logs `usage` can report on.
+ *
+ * Registering another assistant is a new module plus a line here. Nothing in
+ * `src/commands/usage.ts` may branch on a provider's name: what a provider can
+ * answer is read from its `capabilities`, the same rule that keeps
+ * `src/agent/render.ts` free of per-target conditionals.
+ */
+export const PROVIDERS = [
+    claudeCodeProvider,
+    codexProvider,
+    antigravityProvider,
+    // Appended, never inserted: `usage providers` reports in registry order and
+    // the e2e suite pins the earlier entries by position.
+    geminiCliProvider,
+    opencodeProvider,
+];
+export const DEFAULT_PROVIDER = claudeCodeProvider.name;
+/** Selects every registered provider rather than one. */
+export const ALL_PROVIDERS = "all";
+export function providerNames() {
+    return PROVIDERS.map((provider) => provider.name);
+}
+/**
+ * Resolves `--provider` to the providers a report covers.
+ *
+ * `all` returns every registered provider; whether each has anything on this
+ * machine is decided later, by `root()`, so that an unavailable one is simply
+ * absent from the results rather than an error.
+ */
+export function resolveProviders(name) {
+    const wanted = name ?? DEFAULT_PROVIDER;
+    if (wanted === ALL_PROVIDERS)
+        return [...PROVIDERS];
+    const provider = PROVIDERS.find((candidate) => candidate.name === wanted);
+    if (!provider) {
+        throw new Error(`Unknown provider: ${wanted} (known: ${[...providerNames(), ALL_PROVIDERS].join(", ")})`);
+    }
+    return [provider];
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usage/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAA6B;IACjD,kBAAkB;IAClB,aAAa;IACb,mBAAmB;IACnB,4EAA4E;IAC5E,sDAAsD;IACtD,iBAAiB;IACjB,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC;AAExD,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,MAAM,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAAC;IACxC,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,YAAY,CAAC,GAAG,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { UsageProvider } from "./types.js";
+export declare const opencodeProvider: UsageProvider;