@esankhan3/anvil-agent-core 0.1.0

package/dist/checkpoint/__tests__/blob-store.test.js

@@ -0,0 +1,82 @@
+/**
+ * Tests for BlobStore — content-addressed blob storage.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync, existsSync, readFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BlobStore } from '../blob-store.js';
+import { blobPath } from '../key.js';
+describe('BlobStore', () => {
+    let home;
+    let store;
+    beforeEach(() => {
+        home = mkdtempSync(join(tmpdir(), 'anvil-blobs-'));
+        store = new BlobStore(home);
+    });
+    afterEach(() => {
+        rmSync(home, { recursive: true, force: true });
+    });
+    it('write() returns the sha of the content and the fan-out path', () => {
+        const result = store.write('hello world');
+        assert.match(result.sha, /^[0-9a-f]{64}$/);
+        assert.equal(result.bytes, Buffer.byteLength('hello world'));
+        assert.equal(result.path, blobPath(home, result.sha));
+        assert.ok(existsSync(result.path));
+    });
+    it('read() returns the stored bytes', () => {
+        const { sha } = store.write('hello world');
+        const buf = store.read(sha);
+        assert.ok(buf);
+        assert.equal(buf.toString('utf-8'), 'hello world');
+    });
+    it('read() returns null for unknown shas', () => {
+        const missing = store.read('0'.repeat(64));
+        assert.equal(missing, null);
+    });
+    it('exists() reports presence without reading bytes', () => {
+        const { sha } = store.write('x');
+        assert.equal(store.exists(sha), true);
+        assert.equal(store.exists('1'.repeat(64)), false);
+    });
+    it('write() dedupes identical content (no rewrite, same sha)', () => {
+        const a = store.write('same content');
+        const mtimeA = readFileSync(a.path).toString('utf-8');
+        const b = store.write('same content');
+        assert.equal(a.sha, b.sha);
+        assert.equal(a.path, b.path);
+        const mtimeB = readFileSync(b.path).toString('utf-8');
+        assert.equal(mtimeA, mtimeB);
+    });
+    it('write() distinguishes different content', () => {
+        const a = store.write('one');
+        const b = store.write('two');
+        assert.notEqual(a.sha, b.sha);
+    });
+    it('write() accepts Buffer directly', () => {
+        const buf = Buffer.from([0x01, 0x02, 0x03]);
+        const { sha } = store.write(buf);
+        const read = store.read(sha);
+        assert.ok(read);
+        assert.deepEqual(Array.from(read), [0x01, 0x02, 0x03]);
+    });
+    it('gc() removes orphan blobs and keeps referenced ones', () => {
+        const keep = store.write('keep me');
+        const drop1 = store.write('drop 1');
+        const drop2 = store.write('drop 2');
+        const referenced = new Set([keep.sha]);
+        const result = store.gc(referenced);
+        assert.equal(result.deleted, 2);
+        assert.ok(result.bytes > 0);
+        assert.equal(store.exists(keep.sha), true);
+        assert.equal(store.exists(drop1.sha), false);
+        assert.equal(store.exists(drop2.sha), false);
+    });
+    it('gc() on empty store returns zero counts', () => {
+        const result = store.gc(new Set());
+        assert.equal(result.deleted, 0);
+        assert.equal(result.bytes, 0);
+    });
+});
+//# sourceMappingURL=blob-store.test.js.map

package/dist/checkpoint/__tests__/blob-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.test.js","sourceRoot":"","sources":["../../../src/checkpoint/__tests__/blob-store.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,IAAI,IAAY,CAAC;IACjB,IAAI,KAAgB,CAAC;IAErB,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QACnD,KAAK,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,GAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEpC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QAEpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/checkpoint/__tests__/key.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for checkpoint-key: computeFingerprint + computeKey.
+ *
+ * node:test + node:assert/strict, no third-party deps.
+ */
+export {};
+//# sourceMappingURL=key.test.d.ts.map

package/dist/checkpoint/__tests__/key.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.test.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/__tests__/key.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/checkpoint/__tests__/key.test.js

@@ -0,0 +1,130 @@
+/**
+ * Tests for checkpoint-key: computeFingerprint + computeKey.
+ *
+ * node:test + node:assert/strict, no third-party deps.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { blobPath, checkpointPath, computeFingerprint, computeKey, } from '../key.js';
+describe('computeFingerprint', () => {
+    it('produces the same hash for identical inputs', () => {
+        const a = computeFingerprint({ foo: 1, bar: 'baz' });
+        const b = computeFingerprint({ foo: 1, bar: 'baz' });
+        assert.equal(a, b);
+        assert.match(a, /^[0-9a-f]{64}$/);
+    });
+    it('is stable across key reorderings', () => {
+        const a = computeFingerprint({ foo: 1, bar: 'baz', nested: { x: 1, y: 2 } });
+        const b = computeFingerprint({ nested: { y: 2, x: 1 }, bar: 'baz', foo: 1 });
+        assert.equal(a, b);
+    });
+    it('changes when any value changes', () => {
+        const a = computeFingerprint({ foo: 1 });
+        const b = computeFingerprint({ foo: 2 });
+        assert.notEqual(a, b);
+    });
+    it('treats missing keys differently from keys with undefined values', () => {
+        // Both omit the field from the serialization — they should hash the same.
+        const a = computeFingerprint({ foo: 1 });
+        const b = computeFingerprint({ foo: 1, bar: undefined });
+        assert.equal(a, b);
+    });
+    it('distinguishes null from undefined', () => {
+        const a = computeFingerprint({ x: null });
+        const b = computeFingerprint({ x: undefined });
+        assert.notEqual(a, b);
+    });
+    it('handles primitives', () => {
+        assert.match(computeFingerprint('hello'), /^[0-9a-f]{64}$/);
+        assert.match(computeFingerprint(42), /^[0-9a-f]{64}$/);
+        assert.match(computeFingerprint(true), /^[0-9a-f]{64}$/);
+        assert.match(computeFingerprint(null), /^[0-9a-f]{64}$/);
+        // Different primitives hash differently.
+        assert.notEqual(computeFingerprint(1), computeFingerprint('1'));
+        assert.notEqual(computeFingerprint(true), computeFingerprint(1));
+    });
+    it('handles arrays order-sensitively', () => {
+        const a = computeFingerprint([1, 2, 3]);
+        const b = computeFingerprint([3, 2, 1]);
+        assert.notEqual(a, b);
+    });
+    it('handles Dates deterministically', () => {
+        const d = new Date('2025-01-01T00:00:00Z');
+        const a = computeFingerprint({ t: d });
+        const b = computeFingerprint({ t: new Date('2025-01-01T00:00:00Z') });
+        assert.equal(a, b);
+    });
+    it('handles unknown / exotic values (bigint, NaN, Infinity) without throwing', () => {
+        assert.doesNotThrow(() => computeFingerprint(BigInt(10)));
+        assert.doesNotThrow(() => computeFingerprint(NaN));
+        assert.doesNotThrow(() => computeFingerprint(Infinity));
+        assert.doesNotThrow(() => computeFingerprint(() => 1));
+        // NaN !== Infinity
+        assert.notEqual(computeFingerprint(NaN), computeFingerprint(Infinity));
+    });
+});
+describe('computeKey', () => {
+    const baseInputs = {
+        stage: 'plan',
+        taskId: 'plan:root',
+        promptVersion: 'v1',
+        model: 'claude-opus-4-5',
+        toolVersions: { tsc: '5.3.3' },
+        inputs: { feature: 'login' },
+    };
+    it('returns identical hash for identical inputs', () => {
+        const a = computeKey('run-1', baseInputs);
+        const b = computeKey('run-1', baseInputs);
+        assert.equal(a.hash, b.hash);
+        assert.equal(a.runFamily, 'run-1');
+        assert.equal(a.stage, 'plan');
+        assert.equal(a.taskId, 'plan:root');
+    });
+    it('hash changes when promptVersion changes', () => {
+        const a = computeKey('run-1', baseInputs);
+        const b = computeKey('run-1', { ...baseInputs, promptVersion: 'v2' });
+        assert.notEqual(a.hash, b.hash);
+    });
+    it('hash changes when model changes', () => {
+        const a = computeKey('run-1', baseInputs);
+        const b = computeKey('run-1', { ...baseInputs, model: 'gpt-4' });
+        assert.notEqual(a.hash, b.hash);
+    });
+    it('hash changes when toolVersions change', () => {
+        const a = computeKey('run-1', baseInputs);
+        const b = computeKey('run-1', { ...baseInputs, toolVersions: { tsc: '5.4.0' } });
+        assert.notEqual(a.hash, b.hash);
+    });
+    it('hash changes when runFamily changes', () => {
+        const a = computeKey('run-1', baseInputs);
+        const b = computeKey('run-2', baseInputs);
+        assert.notEqual(a.hash, b.hash);
+    });
+    it('hash changes when inputs payload changes', () => {
+        const a = computeKey('run-1', baseInputs);
+        const b = computeKey('run-1', { ...baseInputs, inputs: { feature: 'logout' } });
+        assert.notEqual(a.hash, b.hash);
+    });
+    it('is stable when input object keys are reordered', () => {
+        const a = computeKey('run-1', {
+            ...baseInputs,
+            inputs: { feature: 'login', locale: 'en' },
+        });
+        const b = computeKey('run-1', {
+            ...baseInputs,
+            inputs: { locale: 'en', feature: 'login' },
+        });
+        assert.equal(a.hash, b.hash);
+    });
+});
+describe('path helpers', () => {
+    it('checkpointPath returns the expected layout', () => {
+        const p = checkpointPath('/tmp/home', 'demo', 'run-1', 'plan', 'abcd1234');
+        assert.equal(p, '/tmp/home/checkpoints/demo/run-1/plan/abcd1234.json');
+    });
+    it('blobPath fans out by first 2 hex chars', () => {
+        const p = blobPath('/tmp/home', 'abcdef1234567890');
+        assert.equal(p, '/tmp/home/checkpoints/_blobs/ab/abcdef1234567890');
+    });
+});
+//# sourceMappingURL=key.test.js.map

package/dist/checkpoint/__tests__/key.test.js.map

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

package/dist/checkpoint/__tests__/runner.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tests for runWithCheckpoint — verifies cache-miss → fresh run, cache-hit
+ * → skip, and SIGTERM → interrupted transition.
+ *
+ * We avoid actually sending signals to the test process by passing a
+ * `__signalHook` into the wrapper options. The hook captures the handler
+ * the wrapper registers, and the test invokes it directly to simulate a
+ * SIGTERM. This matches real signal semantics (handler is called with the
+ * signal name) without polluting global `process` listeners.
+ */
+export {};
+//# sourceMappingURL=runner.test.d.ts.map

package/dist/checkpoint/__tests__/runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/__tests__/runner.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/checkpoint/__tests__/runner.test.js

@@ -0,0 +1,201 @@
+/**
+ * Tests for runWithCheckpoint — verifies cache-miss → fresh run, cache-hit
+ * → skip, and SIGTERM → interrupted transition.
+ *
+ * We avoid actually sending signals to the test process by passing a
+ * `__signalHook` into the wrapper options. The hook captures the handler
+ * the wrapper registers, and the test invokes it directly to simulate a
+ * SIGTERM. This matches real signal semantics (handler is called with the
+ * signal name) without polluting global `process` listeners.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BlobStore } from '../blob-store.js';
+import { CheckpointStore } from '../store.js';
+import { runWithCheckpoint } from '../runner.js';
+import { computeKey } from '../key.js';
+function makeInputs(payload, over = {}) {
+    return {
+        stage: 'plan',
+        taskId: 'plan:root',
+        promptVersion: 'v1',
+        model: 'claude',
+        inputs: payload,
+        ...over,
+    };
+}
+function makeSignalHook() {
+    const handlers = [];
+    return {
+        on(sig, fn) { handlers.push({ sig, fn }); },
+        off(sig, fn) {
+            const idx = handlers.findIndex((h) => h.sig === sig && h.fn === fn);
+            if (idx >= 0)
+                handlers.splice(idx, 1);
+        },
+        fire(sig) {
+            for (const h of [...handlers]) {
+                if (h.sig === sig)
+                    h.fn(sig);
+            }
+        },
+        handlerCount: () => handlers.length,
+    };
+}
+describe('runWithCheckpoint', () => {
+    let home;
+    let blobs;
+    let store;
+    beforeEach(() => {
+        home = mkdtempSync(join(tmpdir(), 'anvil-wrapper-'));
+        blobs = new BlobStore(home);
+        store = new CheckpointStore({ anvilHome: home, blobStore: blobs });
+    });
+    afterEach(() => {
+        rmSync(home, { recursive: true, force: true });
+    });
+    it('cache miss: runs the agent, persists output, returns it', async () => {
+        let ran = 0;
+        const onMiss = () => { };
+        const result = await runWithCheckpoint(store, blobs, {
+            project: 'demo',
+            runFamily: 'run-1',
+            inputs: makeInputs({ feature: 'x' }),
+            run: async () => { ran += 1; return { greeting: 'hi' }; },
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+            onMiss,
+        });
+        assert.equal(ran, 1);
+        assert.deepEqual(result, { greeting: 'hi' });
+        const key = computeKey('run-1', makeInputs({ feature: 'x' }));
+        const record = store.get('demo', 'run-1', key);
+        assert.ok(record);
+        assert.equal(record.status, 'completed');
+    });
+    it('cache hit: skips the agent and returns deserialized output', async () => {
+        const inputs = makeInputs({ feature: 'x' });
+        let runs = 0;
+        const runFn = async () => { runs += 1; return { greeting: 'hi' }; };
+        // First call: miss.
+        await runWithCheckpoint(store, blobs, {
+            project: 'demo',
+            runFamily: 'run-1',
+            inputs,
+            run: runFn,
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+        });
+        // Second call: hit — run should NOT be invoked.
+        let hitFired = false;
+        const result = await runWithCheckpoint(store, blobs, {
+            project: 'demo',
+            runFamily: 'run-1',
+            inputs,
+            run: runFn,
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+            onHit: () => { hitFired = true; },
+        });
+        assert.equal(runs, 1, 'run() must not fire on cache hit');
+        assert.equal(hitFired, true);
+        assert.deepEqual(result, { greeting: 'hi' });
+    });
+    it('drifted inputs → different hash → cache miss', async () => {
+        let runs = 0;
+        const runFn = async () => { runs += 1; return { greeting: 'hi' }; };
+        await runWithCheckpoint(store, blobs, {
+            project: 'demo', runFamily: 'run-1', inputs: makeInputs({ feature: 'x' }),
+            run: runFn, serialize: (o) => JSON.stringify(o), deserialize: (b) => JSON.parse(b.toString('utf-8')),
+        });
+        await runWithCheckpoint(store, blobs, {
+            project: 'demo', runFamily: 'run-1', inputs: makeInputs({ feature: 'y' }),
+            run: runFn, serialize: (o) => JSON.stringify(o), deserialize: (b) => JSON.parse(b.toString('utf-8')),
+        });
+        assert.equal(runs, 2);
+    });
+    it('SIGTERM during run → record transitions to interrupted', async () => {
+        const hook = makeSignalHook();
+        let onInterruptCalled = null;
+        // Agent that waits a tick — gives us time to fire the signal.
+        const slowRun = () => new Promise((resolve) => {
+            setTimeout(() => resolve({ greeting: 'late' }), 20);
+        });
+        const promise = runWithCheckpoint(store, blobs, {
+            project: 'demo',
+            runFamily: 'run-1',
+            inputs: makeInputs({ feature: 'slow' }),
+            run: slowRun,
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+            onInterrupt: (sig) => { onInterruptCalled = sig; },
+            __signalHook: hook,
+        });
+        // Fire SIGTERM while the run is in-flight.
+        await new Promise((r) => setTimeout(r, 5));
+        hook.fire('SIGTERM');
+        await promise;
+        assert.equal(onInterruptCalled, 'SIGTERM');
+        const key = computeKey('run-1', makeInputs({ feature: 'slow' }));
+        const record = store.get('demo', 'run-1', key);
+        assert.ok(record);
+        assert.equal(record.status, 'interrupted');
+        assert.match(record.errorMessage ?? '', /SIGTERM/);
+        // All handlers must be removed in finally.
+        assert.equal(hook.handlerCount(), 0, 'signal handlers must be cleaned up');
+    });
+    it('agent throws → record transitions to failed and error is rethrown', async () => {
+        await assert.rejects(runWithCheckpoint(store, blobs, {
+            project: 'demo',
+            runFamily: 'run-1',
+            inputs: makeInputs({ feature: 'bad' }),
+            run: async () => { throw new Error('agent exploded'); },
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+        }), /agent exploded/);
+        const key = computeKey('run-1', makeInputs({ feature: 'bad' }));
+        const record = store.get('demo', 'run-1', key);
+        assert.ok(record);
+        assert.equal(record.status, 'failed');
+        assert.match(record.errorMessage ?? '', /agent exploded/);
+    });
+    it('signal handlers are cleaned up after a successful run', async () => {
+        const hook = makeSignalHook();
+        await runWithCheckpoint(store, blobs, {
+            project: 'demo',
+            runFamily: 'run-1',
+            inputs: makeInputs({ feature: 'ok' }),
+            run: async () => ({ greeting: 'hi' }),
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+            __signalHook: hook,
+        });
+        assert.equal(hook.handlerCount(), 0);
+    });
+    it('concurrent wrappers do not cross-contaminate signal handlers', async () => {
+        const hook = makeSignalHook();
+        const p1 = runWithCheckpoint(store, blobs, {
+            project: 'demo', runFamily: 'run-1', inputs: makeInputs({ n: 1 }),
+            run: () => new Promise((r) => setTimeout(() => r({ greeting: '1' }), 20)),
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+            __signalHook: hook,
+        });
+        const p2 = runWithCheckpoint(store, blobs, {
+            project: 'demo', runFamily: 'run-1', inputs: makeInputs({ n: 2 }),
+            run: () => new Promise((r) => setTimeout(() => r({ greeting: '2' }), 20)),
+            serialize: (o) => JSON.stringify(o),
+            deserialize: (b) => JSON.parse(b.toString('utf-8')),
+            __signalHook: hook,
+        });
+        // Both wrappers install their own SIGTERM + SIGINT handlers → 4 total.
+        await new Promise((r) => setTimeout(r, 5));
+        assert.equal(hook.handlerCount(), 4);
+        await Promise.all([p1, p2]);
+        assert.equal(hook.handlerCount(), 0);
+    });
+});
+//# sourceMappingURL=runner.test.js.map

package/dist/checkpoint/__tests__/runner.test.js.map

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

package/dist/checkpoint/__tests__/store.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tests for CheckpointStore — record lifecycle, get/write atomicity,
+ * stats math.
+ */
+export {};
+//# sourceMappingURL=store.test.d.ts.map

package/dist/checkpoint/__tests__/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/__tests__/store.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/checkpoint/__tests__/store.test.js

@@ -0,0 +1,150 @@
+/**
+ * Tests for CheckpointStore — record lifecycle, get/write atomicity,
+ * stats math.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdirSync, mkdtempSync, rmSync, existsSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BlobStore } from '../blob-store.js';
+import { CheckpointStore } from '../store.js';
+import { checkpointPath, computeKey } from '../key.js';
+function baseInputs(over = {}) {
+    return {
+        stage: 'plan',
+        taskId: 'plan:root',
+        promptVersion: 'v1',
+        model: 'claude',
+        toolVersions: { tsc: '5.3.3' },
+        inputs: { feature: 'login' },
+        ...over,
+    };
+}
+describe('CheckpointStore', () => {
+    let home;
+    let blobs;
+    let store;
+    beforeEach(() => {
+        home = mkdtempSync(join(tmpdir(), 'anvil-ckpt-'));
+        blobs = new BlobStore(home);
+        store = new CheckpointStore({ anvilHome: home, blobStore: blobs });
+    });
+    afterEach(() => {
+        rmSync(home, { recursive: true, force: true });
+    });
+    it('begin() writes a running record with startedAt', () => {
+        const inputs = baseInputs();
+        const rec = store.begin('demo', 'run-1', inputs);
+        assert.equal(rec.status, 'running');
+        assert.equal(rec.project, 'demo');
+        assert.ok(rec.startedAt);
+        assert.equal(rec.key.stage, 'plan');
+        const path = checkpointPath(home, 'demo', 'run-1', 'plan', rec.key.hash);
+        assert.ok(existsSync(path));
+    });
+    it('complete() transitions to completed, writes blob, and sets outputRef', () => {
+        const inputs = baseInputs();
+        const begun = store.begin('demo', 'run-1', inputs);
+        const completed = store.complete('demo', 'run-1', begun.key, 'result-payload', { usd: 0.25, tokensIn: 10, tokensOut: 20 });
+        assert.equal(completed.status, 'completed');
+        assert.ok(completed.outputRef);
+        assert.ok(blobs.exists(completed.outputRef));
+        assert.ok(completed.completedAt);
+        assert.ok(typeof completed.durationMs === 'number');
+        assert.equal(completed.cost?.usd, 0.25);
+    });
+    it('get() on a completed record increments the hit counter', () => {
+        const inputs = baseInputs();
+        const begun = store.begin('demo', 'run-1', inputs);
+        store.complete('demo', 'run-1', begun.key, 'output', { usd: 0.1, tokensIn: 1, tokensOut: 2 });
+        store.resetCounters();
+        const fetched = store.get('demo', 'run-1', begun.key);
+        assert.ok(fetched);
+        assert.equal(fetched.status, 'completed');
+        assert.equal(store.getCounters().hits, 1);
+    });
+    it('get() on a missing record returns null', () => {
+        const inputs = baseInputs();
+        const key = computeKey('run-1', inputs);
+        assert.equal(store.get('demo', 'run-1', key), null);
+    });
+    it('get() on a corrupt record returns null and does not throw', () => {
+        const inputs = baseInputs();
+        const key = computeKey('run-1', inputs);
+        const path = checkpointPath(home, 'demo', 'run-1', 'plan', key.hash);
+        mkdirSync(path.replace(/\/[^/]+$/, ''), { recursive: true });
+        writeFileSync(path, '{ not json ', 'utf-8');
+        assert.equal(store.get('demo', 'run-1', key), null);
+    });
+    it('interrupt() transitions to interrupted and stores partial output when present', () => {
+        const inputs = baseInputs();
+        const begun = store.begin('demo', 'run-1', inputs);
+        const interrupted = store.interrupt('demo', 'run-1', begun.key, 'partial-bytes', 'signal:SIGTERM');
+        assert.equal(interrupted.status, 'interrupted');
+        assert.ok(interrupted.outputRef);
+        assert.equal(interrupted.errorMessage, 'signal:SIGTERM');
+        assert.equal(blobs.read(interrupted.outputRef).toString('utf-8'), 'partial-bytes');
+    });
+    it('interrupt() without partial output omits outputRef', () => {
+        const inputs = baseInputs();
+        const begun = store.begin('demo', 'run-1', inputs);
+        const interrupted = store.interrupt('demo', 'run-1', begun.key, undefined, 'cancel');
+        assert.equal(interrupted.status, 'interrupted');
+        assert.equal(interrupted.outputRef, undefined);
+    });
+    it('fail() transitions to failed with errorMessage', () => {
+        const inputs = baseInputs();
+        const begun = store.begin('demo', 'run-1', inputs);
+        const failed = store.fail('demo', 'run-1', begun.key, 'boom');
+        assert.equal(failed.status, 'failed');
+        assert.equal(failed.errorMessage, 'boom');
+    });
+    it('listForRun() returns every record across stages', () => {
+        const a = store.begin('demo', 'run-1', baseInputs({ stage: 'plan', taskId: 'plan:root' }));
+        const b = store.begin('demo', 'run-1', baseInputs({ stage: 'implement', taskId: 'impl:a' }));
+        store.begin('demo', 'run-1', baseInputs({ stage: 'implement', taskId: 'impl:b' }));
+        store.complete('demo', 'run-1', a.key, 'a-out');
+        store.complete('demo', 'run-1', b.key, 'b-out');
+        const records = store.listForRun('demo', 'run-1');
+        assert.equal(records.length, 3);
+        const stages = records.map((r) => r.key.stage).sort();
+        assert.deepEqual(stages, ['implement', 'implement', 'plan']);
+    });
+    it('invalidateStage() deletes only records for that stage', () => {
+        const a = store.begin('demo', 'run-1', baseInputs({ stage: 'plan', taskId: 'plan:root' }));
+        const b = store.begin('demo', 'run-1', baseInputs({ stage: 'implement', taskId: 'impl:a' }));
+        store.complete('demo', 'run-1', a.key, 'a');
+        store.complete('demo', 'run-1', b.key, 'b');
+        const n = store.invalidateStage('demo', 'run-1', 'plan');
+        assert.equal(n, 1);
+        const remaining = store.listForRun('demo', 'run-1');
+        assert.equal(remaining.length, 1);
+        assert.equal(remaining[0].key.stage, 'implement');
+    });
+    it('stats() math: hits/misses/hitRate/costSaved', () => {
+        store.resetCounters();
+        const a = store.begin('demo', 'run-1', baseInputs({ taskId: 'a' }));
+        store.complete('demo', 'run-1', a.key, 'a', { usd: 0.5, tokensIn: 1, tokensOut: 2 });
+        // First get = hit.
+        store.get('demo', 'run-1', a.key);
+        // Second get = another hit.
+        store.get('demo', 'run-1', a.key);
+        // A fresh begin = miss.
+        store.begin('demo', 'run-1', baseInputs({ taskId: 'b' }));
+        const stats = store.stats('demo', 'run-1');
+        assert.equal(stats.hits, 2);
+        assert.equal(stats.misses, 2); // a + b begins
+        assert.ok(stats.hitRate > 0 && stats.hitRate < 1);
+        assert.equal(stats.costSavedUsd, 1.0); // 2 hits × $0.5
+        assert.equal(stats.total, 2);
+        assert.equal(stats.interrupted, 0);
+    });
+    it('stats() counts interrupted records', () => {
+        const a = store.begin('demo', 'run-1', baseInputs({ taskId: 'a' }));
+        store.interrupt('demo', 'run-1', a.key, undefined, 'cancel');
+        const stats = store.stats('demo', 'run-1');
+        assert.equal(stats.interrupted, 1);
+    });
+});
+//# sourceMappingURL=store.test.js.map