@openagentsy/ledger 0.0.0-stage → 0.2.1

package/dist/ingest.test.js

@@ -0,0 +1,245 @@
+import { Database } from 'bun:sqlite';
+import { mkdir, mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { closeLedger, openLedger } from './db.js';
+import { backfillFromOpencode, normalizeOcMessage, recordAssistantMessage, recordWaste, } from './ingest.js';
+import { perRoleTotals } from './query.js';
+let root;
+beforeEach(async () => {
+    root = await mkdtemp(join(tmpdir(), 'openagentsy-ingest-'));
+});
+afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+});
+const CTX = {
+    rootSessionId: 'ses_root',
+    role: 'builder',
+    latencyMs: 1200,
+    activeTaskId: 'oa-2b-1',
+    ts: '2026-10-26T10:00:00.000Z',
+};
+const MESSAGE = {
+    id: 'msg_1',
+    sessionID: 'ses_child',
+    providerID: 'anthropic',
+    modelID: 'claude-sonnet-4-5',
+    tokens: { input: 100, output: 40, reasoning: 10, cache: { read: 900, write: 5 } },
+    cost: 0.25,
+};
+describe('the normalizer', () => {
+    it('reads the flat shape of V1', () => {
+        const message = normalizeOcMessage(MESSAGE);
+        expect(message.id).toBe('msg_1');
+        expect(message.providerID).toBe('anthropic');
+        expect(message.modelID).toBe('claude-sonnet-4-5');
+        expect(message.tokens?.cache?.read).toBe(900);
+    });
+    it('reads the nested shape of V2', () => {
+        const message = normalizeOcMessage({
+            id: 'msg_2',
+            sessionID: 'ses_child',
+            model: { providerID: 'anthropic', id: 'claude-sonnet-4-5' },
+            tokens: { input: 100, output: 40, reasoning: 10, cache: { read: 900, write: 5 } },
+            cost: 0.25,
+        });
+        expect(message.id).toBe('msg_2');
+        expect(message.providerID).toBe('anthropic');
+        expect(message.modelID).toBe('claude-sonnet-4-5');
+        expect(message.tokens?.input).toBe(100);
+    });
+    it('reads a message nested under a message', () => {
+        const message = normalizeOcMessage({
+            message: {
+                id: 'msg_3',
+                sessionID: 'ses_child',
+                model: { providerID: 'ollama-cloud', id: 'beam' },
+                tokens: { input: 1, output: 2 },
+            },
+        });
+        expect(message.id).toBe('msg_3');
+        expect(message.providerID).toBe('ollama-cloud');
+        expect(message.modelID).toBe('beam');
+    });
+    it('refuses a message without an id', () => {
+        expect(() => normalizeOcMessage({ providerID: 'anthropic' })).toThrow(/no id/);
+    });
+});
+describe('the ingest', () => {
+    it('writes one row per message', () => {
+        const db = openLedger(root);
+        try {
+            recordAssistantMessage(db, MESSAGE, CTX);
+            recordAssistantMessage(db, MESSAGE, CTX);
+            const rows = db.query('SELECT COUNT(*) AS count FROM usage').get();
+            expect(rows.count).toBe(1);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('stores the role it is given, without resolving it', () => {
+        const db = openLedger(root);
+        try {
+            recordAssistantMessage(db, MESSAGE, { ...CTX, role: 'agentsy' });
+            const row = db.query('SELECT role, role_raw FROM usage').get();
+            expect(row.role).toBe('agentsy');
+            expect(row.role_raw).toBe(null);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('counts the reasoning once for a provider that folds it into the output', () => {
+        const db = openLedger(root);
+        try {
+            recordAssistantMessage(db, { ...MESSAGE, id: 'msg_codex', providerID: 'codex' }, CTX);
+            const row = db
+                .query('SELECT output, reasoning FROM usage WHERE message_id = ?')
+                .get('msg_codex');
+            expect(row.output).toBe(30);
+            expect(row.reasoning).toBe(10);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('leaves the cost empty when the host reported none', () => {
+        const db = openLedger(root);
+        try {
+            const { cost: _cost, ...withoutCost } = MESSAGE;
+            recordAssistantMessage(db, withoutCost, CTX);
+            const row = db.query('SELECT cost_reported, cost_estimated FROM usage').get();
+            expect(row.cost_reported).toBe(null);
+            expect(row.cost_estimated).toBe(null);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('redacts a secret in a waste detail', () => {
+        const db = openLedger(root);
+        try {
+            const secret = ['sk', 'abcdefghijklmnopqrstuvwx'].join('-');
+            recordWaste(db, {
+                rootSessionId: 'ses_root',
+                kind: 'retry',
+                tokens: 10,
+                detail: `the key was ${secret}`,
+                ts: CTX.ts,
+            });
+            const row = db.query('SELECT detail FROM waste').get();
+            expect(row.detail).not.toContain(secret);
+            expect(row.detail).toContain('redacted');
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+});
+describe('the backfill', () => {
+    async function fixture(dataDir) {
+        await mkdir(dataDir, { recursive: true });
+        const source = new Database(join(dataDir, 'opencode.db'), { create: true });
+        source.exec('CREATE TABLE message (id text PRIMARY KEY, session_id text NOT NULL, time_created integer NOT NULL, data text NOT NULL)');
+        source.exec('CREATE TABLE session (id text PRIMARY KEY, parent_id text)');
+        source.query('INSERT INTO session (id, parent_id) VALUES (?, ?)').run('ses_root', null);
+        source.query('INSERT INTO session (id, parent_id) VALUES (?, ?)').run('ses_child', 'ses_root');
+        source.query('INSERT INTO message (id, session_id, time_created, data) VALUES (?,?,?,?)').run('msg_old', 'ses_child', 1_700_000_000_000, JSON.stringify({
+            role: 'assistant',
+            agent: 'oa-builder',
+            providerID: 'anthropic',
+            modelID: 'claude-sonnet-4-5',
+            tokens: { input: 10, output: 20, reasoning: 0, cache: { read: 5, write: 1 } },
+            cost: 0.5,
+        }));
+        // A provider of the Codex family folds the reasoning into the output.
+        source.query('INSERT INTO message (id, session_id, time_created, data) VALUES (?,?,?,?)').run('msg_codex', 'ses_child', 1_600_000_000_000, JSON.stringify({
+            role: 'assistant',
+            agent: 'oa-builder',
+            providerID: 'codex',
+            modelID: 'gpt-codex',
+            tokens: { input: 5, output: 40, reasoning: 10, cache: { read: 0, write: 0 } },
+        }));
+        source.close();
+    }
+    it('is off unless it is asked for', async () => {
+        const dataDir = join(root, 'opencode');
+        await fixture(dataDir);
+        const db = openLedger(root);
+        try {
+            const result = backfillFromOpencode(db, { dataDir });
+            expect(result.enabled).toBe(false);
+            expect(result.imported).toBe(0);
+            const rows = db.query('SELECT COUNT(*) AS count FROM usage').get();
+            expect(rows.count).toBe(0);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('imports the past messages with the role unresolved', async () => {
+        const dataDir = join(root, 'opencode');
+        await fixture(dataDir);
+        const db = openLedger(root);
+        try {
+            const result = backfillFromOpencode(db, { enabled: true, dataDir });
+            expect(result.errors).toEqual([]);
+            expect(result.imported).toBe(2);
+            const row = db.query('SELECT role, role_raw, root_session_id, input FROM usage').get();
+            expect(row.role).toBe(null);
+            expect(row.role_raw).toBe('oa-builder');
+            expect(row.root_session_id).toBe('ses_root');
+            expect(row.input).toBe(10);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('counts the reasoning once for a backfilled codex message', async () => {
+        const dataDir = join(root, 'opencode');
+        await fixture(dataDir);
+        const db = openLedger(root);
+        try {
+            backfillFromOpencode(db, { enabled: true, dataDir });
+            const row = db
+                .query('SELECT output, reasoning FROM usage WHERE message_id = ?')
+                .get('msg_codex');
+            expect(row.reasoning).toBe(10);
+            expect(row.output).toBe(30);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('leaves an imported row out of the per-role report', async () => {
+        const dataDir = join(root, 'opencode');
+        await fixture(dataDir);
+        const db = openLedger(root);
+        try {
+            backfillFromOpencode(db, { enabled: true, dataDir });
+            expect(perRoleTotals(db)).toEqual([]);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('refuses a file whose tables differ, and says what it found', async () => {
+        const dataDir = join(root, 'opencode');
+        await mkdir(dataDir, { recursive: true });
+        const source = new Database(join(dataDir, 'opencode.db'), { create: true });
+        source.exec('CREATE TABLE blobs (id text PRIMARY KEY, value text)');
+        source.close();
+        const db = openLedger(root);
+        try {
+            const result = backfillFromOpencode(db, { enabled: true, dataDir });
+            expect(result.imported).toBe(0);
+            expect(result.errors[0]).toMatch(/no "message" table/);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+});
+//# sourceMappingURL=ingest.test.js.map

package/dist/ingest.test.js.map

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

package/dist/outcomes.d.ts

@@ -0,0 +1,81 @@
+import type { Database } from 'bun:sqlite';
+import { type OutcomeKind } from './schema.js';
+/**
+ * The outcomes of §6.5 — what the tokens of the work produced.
+ *
+ * Three sources fill the outcome table: the task transitions of the tasks
+ * store, the `Refs:` trailers of the commits and the merges of the pull
+ * requests. The first two are scanned here; the third is seen by the `pr`
+ * integration mode.
+ *
+ * The two scanners that read another package's data take it through an
+ * injected reader instead of importing it: the ledger holds no dependency on
+ * the tasks store, and the caller that knows the store injects it.
+ */
+/** An outcome, ready to be written. */
+export type OutcomeCandidate = {
+    kind: OutcomeKind;
+    ts: string;
+    taskId?: string | undefined;
+    commitSha?: string | undefined;
+    rootSessionId?: string | undefined;
+};
+/** What a caller hands to `recordOutcome`. */
+export type OutcomeInput = {
+    kind: OutcomeKind;
+    taskId?: string | undefined;
+    commitSha?: string | undefined;
+    rootSessionId?: string | undefined;
+    /** The moment the outcome happened; the clock when it is not given. */
+    ts?: string | undefined;
+};
+/**
+ * Record one outcome.
+ *
+ * The kind is checked against the four of §6.1 before the row is written, so
+ * a mistake is a message and not a constraint violation. The write is
+ * idempotent: an outcome that is already there — the same kind, the same
+ * task and the same commit — is not written twice, because the scanners are
+ * commands that run over the same history again and again.
+ *
+ * Returns whether a row was written.
+ */
+export declare function recordOutcome(db: Database, outcome: OutcomeInput): boolean;
+/**
+ * The outcomes of the commits that carry a `Refs:` trailer (§6.5).
+ *
+ * The trailer is what the pre-commit hook requires of an agent commit, so
+ * the commits of the agents are the ones this finds. A commit without a
+ * trailer names no task and becomes no outcome.
+ */
+export declare function scanRefsTrailers(gitDir: string, since: string): OutcomeCandidate[];
+/**
+ * A task, as the transition scan needs to see it.
+ *
+ * The shape is the one the tasks store has, and only the three fields the
+ * scan reads: the id, the status and the moment the task last changed.
+ */
+export type LedgerTask = {
+    id: string;
+    status: string;
+    updated_at?: string | undefined;
+};
+/**
+ * The reader of the tasks store.
+ *
+ * The ledger does not import the tasks package: the store is another
+ * program's data, and the caller that knows where it lives injects a reader
+ * for it. The reader is given the root it is to read and hands back the
+ * tasks it found.
+ */
+export type TaskReader = (root: string) => Promise<LedgerTask[]>;
+/**
+ * The outcomes of the task transitions (§6.5).
+ *
+ * A task that reached `completed` or `scrapped` is an outcome. The moment of
+ * the transition is the moment the task last changed; a task that carries no
+ * timestamp is taken as it is now, because the store says its status and
+ * the time of the change is not in it.
+ */
+export declare function scanTaskTransitions(root: string, since: string, reader: TaskReader): Promise<OutcomeCandidate[]>;
+//# sourceMappingURL=outcomes.d.ts.map

package/dist/outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.d.ts","sourceRoot":"","sources":["../src/outcomes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;GAWG;AAEH,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB,CAAC;AAMF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAiB1E;AAcD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAalF;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAc7B"}

package/dist/outcomes.js

@@ -0,0 +1,85 @@
+import { withBusyRetry } from './db.js';
+import { gitCommits, refsTrailers } from './git.js';
+import { OUTCOME_KINDS } from './schema.js';
+const OUTCOME_INSERT = `INSERT INTO outcome
+  (root_session_id, task_id, commit_sha, kind, ts)
+  VALUES (?,?,?,?,?)`;
+/**
+ * Record one outcome.
+ *
+ * The kind is checked against the four of §6.1 before the row is written, so
+ * a mistake is a message and not a constraint violation. The write is
+ * idempotent: an outcome that is already there — the same kind, the same
+ * task and the same commit — is not written twice, because the scanners are
+ * commands that run over the same history again and again.
+ *
+ * Returns whether a row was written.
+ */
+export function recordOutcome(db, outcome) {
+    if (!OUTCOME_KINDS.includes(outcome.kind)) {
+        throw new Error(`unknown outcome kind: ${outcome.kind}`);
+    }
+    if (outcomeExists(db, outcome))
+        return false;
+    const ts = outcome.ts ?? new Date().toISOString();
+    withBusyRetry(() => {
+        db.query(OUTCOME_INSERT).run(outcome.rootSessionId ?? null, outcome.taskId ?? null, outcome.commitSha ?? null, outcome.kind, ts);
+    });
+    return true;
+}
+/** Whether the ledger already holds this outcome. */
+function outcomeExists(db, outcome) {
+    const found = db
+        .query(`SELECT 1 FROM outcome
+       WHERE kind = ? AND task_id IS ? AND commit_sha IS ?
+       LIMIT 1`)
+        .get(outcome.kind, outcome.taskId ?? null, outcome.commitSha ?? null);
+    return found !== null;
+}
+/**
+ * The outcomes of the commits that carry a `Refs:` trailer (§6.5).
+ *
+ * The trailer is what the pre-commit hook requires of an agent commit, so
+ * the commits of the agents are the ones this finds. A commit without a
+ * trailer names no task and becomes no outcome.
+ */
+export function scanRefsTrailers(gitDir, since) {
+    const candidates = [];
+    for (const commit of gitCommits(gitDir, since)) {
+        for (const taskId of refsTrailers(commit.message)) {
+            candidates.push({
+                kind: 'commit',
+                taskId,
+                commitSha: commit.sha,
+                ts: new Date(commit.at * 1000).toISOString(),
+            });
+        }
+    }
+    return candidates;
+}
+/**
+ * The outcomes of the task transitions (§6.5).
+ *
+ * A task that reached `completed` or `scrapped` is an outcome. The moment of
+ * the transition is the moment the task last changed; a task that carries no
+ * timestamp is taken as it is now, because the store says its status and
+ * the time of the change is not in it.
+ */
+export async function scanTaskTransitions(root, since, reader) {
+    const tasks = await reader(root);
+    const candidates = [];
+    for (const task of tasks) {
+        if (task.status !== 'completed' && task.status !== 'scrapped')
+            continue;
+        const ts = task.updated_at ?? new Date().toISOString();
+        if (since.length > 0 && ts < since)
+            continue;
+        candidates.push({
+            kind: task.status === 'completed' ? 'task_completed' : 'task_scrapped',
+            taskId: task.id,
+            ts,
+        });
+    }
+    return candidates;
+}
+//# sourceMappingURL=outcomes.js.map

package/dist/outcomes.js.map

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

package/dist/outcomes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=outcomes.test.d.ts.map

package/dist/outcomes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.test.d.ts","sourceRoot":"","sources":["../src/outcomes.test.ts"],"names":[],"mappings":""}

package/dist/outcomes.test.js

@@ -0,0 +1,160 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { closeLedger, openLedger } from './db.js';
+import { runGit } from './git.js';
+import { recordAssistantMessage } from './ingest.js';
+import { recordOutcome, scanRefsTrailers, scanTaskTransitions } from './outcomes.js';
+import { tokensPerCommit, tokensPerCompletedTask, tokensPerResult } from './query.js';
+let root;
+beforeEach(async () => {
+    root = await mkdtemp(join(tmpdir(), 'openagentsy-outcomes-'));
+});
+afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+});
+describe('the outcome recorder', () => {
+    it('writes the outcome once', () => {
+        const db = openLedger(root);
+        try {
+            expect(recordOutcome(db, { kind: 'task_completed', taskId: 'task-1' })).toBe(true);
+            expect(recordOutcome(db, { kind: 'task_completed', taskId: 'task-1' })).toBe(false);
+            const rows = db.query('SELECT COUNT(*) AS count FROM outcome').get();
+            expect(rows.count).toBe(1);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('refuses a kind the schema does not know', () => {
+        const db = openLedger(root);
+        try {
+            expect(() => recordOutcome(db, { kind: 'nonsense' })).toThrow(/unknown outcome kind/);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('keeps the task and the commit of an outcome', () => {
+        const db = openLedger(root);
+        try {
+            recordOutcome(db, {
+                kind: 'commit',
+                taskId: 'task-1',
+                commitSha: 'abc1234',
+                rootSessionId: 'ses_root',
+            });
+            const row = db
+                .query('SELECT kind, task_id, commit_sha, root_session_id FROM outcome')
+                .get();
+            expect(row.kind).toBe('commit');
+            expect(row.task_id).toBe('task-1');
+            expect(row.commit_sha).toBe('abc1234');
+            expect(row.root_session_id).toBe('ses_root');
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+});
+describe('the refs trailer scanner', () => {
+    it('finds the commits that name a task', async () => {
+        const repo = await mkdtemp(join(tmpdir(), 'openagentsy-repo-'));
+        await seedRepo(repo);
+        const outcomes = scanRefsTrailers(repo, '30 days ago');
+        expect(outcomes).toHaveLength(1);
+        expect(outcomes[0]?.kind).toBe('commit');
+        expect(outcomes[0]?.taskId).toBe('task-1');
+        expect(outcomes[0]?.commitSha).toMatch(/^[0-9a-f]{40}$/);
+    });
+});
+describe('the task transition scanner', () => {
+    it('turns the finished tasks into outcomes', async () => {
+        const outcomes = await scanTaskTransitions('/beans', '2026-01-01T00:00:00.000Z', async () => [
+            { id: 'task-1', status: 'completed', updated_at: '2026-01-02T00:00:00.000Z' },
+            { id: 'task-2', status: 'scrapped', updated_at: '2026-01-02T00:00:00.000Z' },
+            { id: 'task-3', status: 'in-progress', updated_at: '2026-01-02T00:00:00.000Z' },
+        ]);
+        expect(outcomes).toHaveLength(2);
+        expect(outcomes.find((outcome) => outcome.taskId === 'task-1')?.kind).toBe('task_completed');
+        expect(outcomes.find((outcome) => outcome.taskId === 'task-2')?.kind).toBe('task_scrapped');
+    });
+    it('leaves the tasks that finished before the window alone', async () => {
+        const outcomes = await scanTaskTransitions('/beans', '2026-02-01T00:00:00.000Z', async () => [
+            { id: 'task-1', status: 'completed', updated_at: '2026-01-02T00:00:00.000Z' },
+        ]);
+        expect(outcomes).toHaveLength(0);
+    });
+    it('reads the store through the reader it is given', async () => {
+        const seen = [];
+        await scanTaskTransitions('/beans', '2026-01-01T00:00:00.000Z', async (root) => {
+            seen.push(root);
+            return [];
+        });
+        expect(seen).toEqual(['/beans']);
+    });
+});
+describe('the outcome joins', () => {
+    it('counts the tokens of a completed task', () => {
+        const db = openLedger(root);
+        try {
+            recordAssistantMessage(db, {
+                id: 'm1',
+                sessionID: 'ses_1',
+                providerID: 'anthropic',
+                modelID: 'claude-sonnet-4-5',
+                tokens: { input: 100, output: 40, reasoning: 10, cache: { write: 5 } },
+            }, {
+                rootSessionId: 'ses_1',
+                role: 'builder',
+                activeTaskId: 'task-1',
+                ts: '2026-01-02T00:00:00.000Z',
+            });
+            recordOutcome(db, { kind: 'task_completed', taskId: 'task-1' });
+            const rows = tokensPerCompletedTask(db);
+            expect(rows).toHaveLength(1);
+            expect(rows[0]?.taskId).toBe('task-1');
+            expect(rows[0]?.tokens).toBe(155);
+            recordOutcome(db, { kind: 'commit', taskId: 'task-1', commitSha: 'abc1234' });
+            const commits = tokensPerCommit(db);
+            expect(commits).toHaveLength(1);
+            expect(commits[0]?.commitSha).toBe('abc1234');
+            expect(commits[0]?.tokens).toBe(155);
+            const result = tokensPerResult(db);
+            expect(result.tasksCompleted).toBe(1);
+            expect(result.tokensPerTask).toBe(155);
+            expect(result.commits).toBe(1);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+});
+/** A repository with one commit that names a task and one that does not. */
+async function seedRepo(repo) {
+    const git = (...args) => {
+        const result = runGit(repo, [
+            '-c',
+            'user.email=test@example.com',
+            '-c',
+            'user.name=Test',
+            '-c',
+            'commit.gpgsign=false',
+            ...args,
+        ]);
+        if (!result.ok)
+            throw new Error(result.stderr);
+    };
+    git('init', '-q');
+    git('config', 'user.email', 'test@example.com');
+    git('config', 'user.name', 'Test');
+    git('config', 'commit.gpgsign', 'false');
+    await writeFile(join(repo, 'a.txt'), 'one\n');
+    git('add', 'a.txt');
+    git('commit', '-q', '-m', 'feat: add\n\nRefs: task-1');
+    await writeFile(join(repo, 'b.txt'), 'two\n');
+    git('add', 'b.txt');
+    git('commit', '-q', '-m', 'chore: add');
+}
+//# sourceMappingURL=outcomes.test.js.map

package/dist/outcomes.test.js.map

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