@animalabs/context-manager 0.3.0 → 0.4.0

package/dist/test/search.test.js

@@ -0,0 +1,141 @@
+/**
+ * Tests for the search API (audit gap #7).
+ *
+ * Substring + regex search over summary content, plus single-summary
+ * lookup by id. Exposed through ContextManager passthrough so callers
+ * (e.g. agent-framework MCPL host) can build `memory_search` /
+ * `memory_read` agent tools on top.
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../src/index.js';
+const TEST_STORE_PATH = './test-search';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function textBlock(text) {
+    return [{ type: 'text', text }];
+}
+class SeedableStrategy extends AutobiographicalStrategy {
+    seedSummary(content, level = 1, mergedInto) {
+        const entry = {
+            id: `L${level}-${this.nextSummaryIdCounter()}`,
+            level,
+            content,
+            tokens: Math.ceil(content.length / 4),
+            sourceLevel: 0,
+            sourceIds: ['x'],
+            sourceRange: { first: 'x', last: 'x' },
+            created: Date.now(),
+            ...(mergedInto ? { mergedInto } : {}),
+        };
+        this.pushSummary(entry);
+        return entry;
+    }
+}
+describe('AutobiographicalStrategy — search (gap #7)', () => {
+    before(cleanup);
+    after(cleanup);
+    beforeEach(cleanup);
+    it('returns empty when no summaries match the substring', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        strategy.seedSummary('first memory about cats');
+        strategy.seedSummary('second memory about dogs');
+        const results = manager.searchSummaries({ text: 'unicorns' });
+        assert.equal(results.length, 0);
+        manager.close();
+    });
+    it('case-insensitive substring search returns matches sorted by hit count', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        strategy.seedSummary('a meditation on cats and CATS and cats'); // 3 hits
+        strategy.seedSummary('one note about Cats'); // 1 hit
+        strategy.seedSummary('something about dogs'); // 0 hits
+        const results = manager.searchSummaries({ text: 'cats' });
+        assert.equal(results.length, 2, 'two summaries should match');
+        assert.equal(results[0].matches, 3, 'highest hit count first');
+        assert.equal(results[1].matches, 1);
+        manager.close();
+    });
+    it('regex search supports patterns and counts global matches', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        strategy.seedSummary('found errors at 14:23 and 16:45 and 18:00');
+        strategy.seedSummary('no times here');
+        const results = manager.searchSummaries({ regex: /\d{2}:\d{2}/ });
+        assert.equal(results.length, 1);
+        assert.equal(results[0].matches, 3, 'should count all 3 timestamps');
+        manager.close();
+    });
+    it('level filter restricts to chosen levels', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        strategy.seedSummary('shared word here', 1);
+        strategy.seedSummary('shared word also', 2);
+        strategy.seedSummary('shared word too', 3);
+        const l2only = manager.searchSummaries({ text: 'shared', levels: [2] });
+        assert.equal(l2only.length, 1);
+        assert.equal(l2only[0].summary.level, 2);
+        const l1andL3 = manager.searchSummaries({ text: 'shared', levels: [1, 3] });
+        assert.equal(l1andL3.length, 2);
+        assert.ok(l1andL3.every(r => r.summary.level === 1 || r.summary.level === 3));
+        manager.close();
+    });
+    it('excludes merged summaries by default; includeMerged opts in', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        strategy.seedSummary('alive content', 1);
+        strategy.seedSummary('folded content', 1, 'L2-99'); // already merged
+        const live = manager.searchSummaries({ text: 'content' });
+        assert.equal(live.length, 1, 'merged summaries hidden by default');
+        assert.equal(live[0].summary.content, 'alive content');
+        const all = manager.searchSummaries({ text: 'content', includeMerged: true });
+        assert.equal(all.length, 2, 'includeMerged should reveal both');
+        manager.close();
+    });
+    it('limit caps the result count', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        for (let i = 0; i < 10; i++) {
+            strategy.seedSummary(`hit ${i} hit hit`);
+        }
+        const results = manager.searchSummaries({ text: 'hit', limit: 3 });
+        assert.equal(results.length, 3);
+    });
+    it('getSummary returns an entry by id', async () => {
+        const strategy = new SeedableStrategy();
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const seeded = strategy.seedSummary('lookup me');
+        const got = manager.getSummary(seeded.id);
+        assert.ok(got, 'should find the seeded summary');
+        assert.equal(got?.content, 'lookup me');
+        assert.equal(manager.getSummary('nonexistent'), null);
+        manager.close();
+    });
+});
+//# sourceMappingURL=search.test.js.map

package/dist/test/search.test.js.map

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

package/dist/test/speculation-cap.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tests for speculation cap + preflight hook (audit gap #8).
+ *
+ * Pre-fix: every new message triggered an auto-tick that compressed any
+ * pending chunk, regardless of how many speculative L1s the strategy was
+ * already holding. Lena's archive on Hermes ended up with dozens of
+ * speculatively-built L1s before there was any real budget pressure.
+ *
+ * Post-fix:
+ *  - `maxSpeculativeL1s` caps the count of (unmerged L1s + queued chunks).
+ *    When at cap, `onNewMessage` defers auto-tick — chunks still queue,
+ *    but compression doesn't fire until an explicit tick() / compile().
+ *  - `shouldCompressPreflight()` is overridable so subclasses can add
+ *    custom predictive scheduling.
+ */
+export {};
+//# sourceMappingURL=speculation-cap.test.d.ts.map

package/dist/test/speculation-cap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculation-cap.test.d.ts","sourceRoot":"","sources":["../../test/speculation-cap.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/test/speculation-cap.test.js

@@ -0,0 +1,157 @@
+/**
+ * Tests for speculation cap + preflight hook (audit gap #8).
+ *
+ * Pre-fix: every new message triggered an auto-tick that compressed any
+ * pending chunk, regardless of how many speculative L1s the strategy was
+ * already holding. Lena's archive on Hermes ended up with dozens of
+ * speculatively-built L1s before there was any real budget pressure.
+ *
+ * Post-fix:
+ *  - `maxSpeculativeL1s` caps the count of (unmerged L1s + queued chunks).
+ *    When at cap, `onNewMessage` defers auto-tick — chunks still queue,
+ *    but compression doesn't fire until an explicit tick() / compile().
+ *  - `shouldCompressPreflight()` is overridable so subclasses can add
+ *    custom predictive scheduling.
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../src/index.js';
+const TEST_STORE_PATH = './test-speculation-cap';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function textBlock(text) {
+    return [{ type: 'text', text }];
+}
+class TickCountingStrategy extends AutobiographicalStrategy {
+    tickCalls = 0;
+    async tick(ctx) {
+        this.tickCalls++;
+        // Do NOT call super.tick — we don't have a real membrane in tests
+        // and we just want to count whether onNewMessage decided to fire.
+    }
+    seedL1(content) {
+        const entry = {
+            id: `L1-${this.nextSummaryIdCounter()}`,
+            level: 1,
+            content,
+            tokens: Math.ceil(content.length / 4),
+            sourceLevel: 0,
+            sourceIds: ['x'],
+            sourceRange: { first: 'x', last: 'x' },
+            created: Date.now(),
+        };
+        this.pushSummary(entry);
+        return entry;
+    }
+    /** True if there's an unprocessed chunk eligible for compression. */
+    hasQueuedChunk() {
+        return this.compressionQueue.length > 0;
+    }
+}
+/**
+ * Add enough small messages to force ≥1 chunk to form in the
+ * compressible region. With targetChunkTokens=20 and chunkOnMessageBoundary,
+ * 5 messages of ~6 tokens each will close one chunk after 4 msgs.
+ */
+async function setupWithQueuedChunk(strategy) {
+    const manager = await ContextManager.open({
+        path: TEST_STORE_PATH,
+        strategy,
+    });
+    // recentWindowTokens=5 (small) means only the latest message stays in recent;
+    // the rest are compressible and will form chunks once we hit targetChunkTokens.
+    // 5 padding messages of ~6 tokens, plus one trailing recent message.
+    for (let i = 0; i < 5; i++) {
+        manager.addMessage('user', textBlock(`m-${i} hello world`));
+    }
+    manager.addMessage('user', textBlock('latest one ' + 'X'.repeat(20)));
+    // Wait for any onNewMessage handlers to settle
+    await new Promise(r => setTimeout(r, 30));
+    return manager;
+}
+describe('AutobiographicalStrategy — speculation cap (gap #8)', () => {
+    before(cleanup);
+    after(cleanup);
+    beforeEach(cleanup);
+    it('default: auto-tick fires whenever a chunk is queued', async () => {
+        const strategy = new TickCountingStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 5,
+            targetChunkTokens: 20,
+            autoTickOnNewMessage: true,
+        });
+        const manager = await setupWithQueuedChunk(strategy);
+        assert.ok(strategy.hasQueuedChunk(), 'sanity: chunk should have formed in compressible region');
+        assert.ok(strategy.tickCalls >= 1, `default behavior must auto-tick (got ${strategy.tickCalls})`);
+        manager.close();
+    });
+    it('with maxSpeculativeL1s, auto-tick is deferred when at cap', async () => {
+        const strategy = new TickCountingStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 5,
+            targetChunkTokens: 20,
+            autoTickOnNewMessage: true,
+            maxSpeculativeL1s: 2,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        // Seed AFTER open so initialize() doesn't wipe the seeds.
+        strategy.seedL1('summary 1');
+        strategy.seedL1('summary 2');
+        strategy.seedL1('summary 3');
+        const ticksBefore = strategy.tickCalls;
+        for (let i = 0; i < 5; i++) {
+            manager.addMessage('user', textBlock(`m-${i} hello world`));
+        }
+        manager.addMessage('user', textBlock('latest one ' + 'X'.repeat(20)));
+        await new Promise(r => setTimeout(r, 30));
+        assert.ok(strategy.hasQueuedChunk(), 'sanity: chunk formed');
+        assert.equal(strategy.tickCalls, ticksBefore, 'auto-tick must NOT fire when unmerged L1s already exceed maxSpeculativeL1s');
+        manager.close();
+    });
+    it('cap allows auto-tick when count is under the limit', async () => {
+        const strategy = new TickCountingStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 5,
+            targetChunkTokens: 20,
+            autoTickOnNewMessage: true,
+            maxSpeculativeL1s: 5,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        strategy.seedL1('summary 1');
+        const ticksBefore = strategy.tickCalls;
+        for (let i = 0; i < 5; i++) {
+            manager.addMessage('user', textBlock(`m-${i} hello world`));
+        }
+        manager.addMessage('user', textBlock('latest one ' + 'X'.repeat(20)));
+        await new Promise(r => setTimeout(r, 30));
+        assert.ok(strategy.hasQueuedChunk(), 'sanity: chunk formed');
+        assert.ok(strategy.tickCalls > ticksBefore, 'auto-tick should fire when under cap');
+        manager.close();
+    });
+    it('shouldCompressPreflight=false defers auto-tick', async () => {
+        class DeferAlways extends TickCountingStrategy {
+            shouldCompressPreflight() { return false; }
+        }
+        const strategy = new DeferAlways({
+            headWindowTokens: 0,
+            recentWindowTokens: 5,
+            targetChunkTokens: 20,
+            autoTickOnNewMessage: true,
+        });
+        const manager = await setupWithQueuedChunk(strategy);
+        assert.ok(strategy.hasQueuedChunk(), 'sanity: chunk formed');
+        assert.equal(strategy.tickCalls, 0, 'preflight=false must block auto-tick');
+        manager.close();
+    });
+});
+//# sourceMappingURL=speculation-cap.test.js.map

package/dist/test/speculation-cap.test.js.map

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

package/dist/test/strategy-persistence.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tests for AutobiographicalStrategy persistence + branch fork.
+ *
+ * Strategy state (summaries, summaryIdCounter, mergeQueue) was previously
+ * in-memory only — first process restart wiped the entire L1/L2/L3 pyramid.
+ * Forking the underlying chronicle branch silently shared state across
+ * branches because nothing was actually branch-scoped.
+ *
+ * These tests cover:
+ *  1. restart-and-resume: state survives close/reopen of the same path.
+ *  2. branch fork: a forked branch has its own summary timeline.
+ *  3. branch switch: switching back picks up the right branch's state.
+ */
+export {};
+//# sourceMappingURL=strategy-persistence.test.d.ts.map

package/dist/test/strategy-persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-persistence.test.d.ts","sourceRoot":"","sources":["../../test/strategy-persistence.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/test/strategy-persistence.test.js

@@ -0,0 +1,244 @@
+/**
+ * Tests for AutobiographicalStrategy persistence + branch fork.
+ *
+ * Strategy state (summaries, summaryIdCounter, mergeQueue) was previously
+ * in-memory only — first process restart wiped the entire L1/L2/L3 pyramid.
+ * Forking the underlying chronicle branch silently shared state across
+ * branches because nothing was actually branch-scoped.
+ *
+ * These tests cover:
+ *  1. restart-and-resume: state survives close/reopen of the same path.
+ *  2. branch fork: a forked branch has its own summary timeline.
+ *  3. branch switch: switching back picks up the right branch's state.
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../src/index.js';
+const TEST_STORE_PATH = './test-strategy-persistence';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function textBlock(text) {
+    return [{ type: 'text', text }];
+}
+/**
+ * Test subclass that exposes the protected persistence helpers + lets the
+ * test seed summaries through the same code path that production uses.
+ */
+class TestableStrategy extends AutobiographicalStrategy {
+    seedL1(content, sourceIds) {
+        const entry = {
+            id: `L1-${this.nextSummaryIdCounter()}`,
+            level: 1,
+            content,
+            tokens: Math.ceil(content.length / 4),
+            sourceLevel: 0,
+            sourceIds,
+            sourceRange: {
+                first: sourceIds[0] ?? '',
+                last: sourceIds[sourceIds.length - 1] ?? '',
+            },
+            created: Date.now(),
+        };
+        this.pushSummary(entry);
+        return entry;
+    }
+    seedL2(sourceL1Ids, content = 'merged') {
+        const entry = {
+            id: `L2-${this.nextSummaryIdCounter()}`,
+            level: 2,
+            content,
+            tokens: Math.ceil(content.length / 4),
+            sourceLevel: 1,
+            sourceIds: sourceL1Ids,
+            sourceRange: { first: 'a', last: 'z' },
+            created: Date.now(),
+        };
+        this.pushSummary(entry);
+        for (const id of sourceL1Ids) {
+            const src = this.summaries.find(s => s.id === id);
+            if (src)
+                this.setMergedInto(src, entry.id);
+        }
+        return entry;
+    }
+    seedMerge(level, sourceIds) {
+        this.enqueueMerge({ level, sourceIds });
+    }
+    // Read-only views for assertions
+    getSummariesView() { return [...this.summaries]; }
+    getCounter() { return this.summaryIdCounter; }
+    getMergeQueueView() {
+        return [...this.mergeQueue];
+    }
+}
+describe('AutobiographicalStrategy — persistence', () => {
+    before(cleanup);
+    after(cleanup);
+    beforeEach(cleanup);
+    it('restores summaries, counter, and merge queue across close/reopen', async () => {
+        // Phase 1: build state
+        {
+            const strategy = new TestableStrategy({ targetChunkTokens: 300 });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+            });
+            manager.addMessage('User', textBlock('hello'));
+            const m2 = manager.addMessage('Claude', textBlock('hi back'));
+            strategy.seedL1('summary one', ['a', 'b']);
+            strategy.seedL1('summary two', ['c', 'd']);
+            strategy.seedMerge(2, ['L1-0', 'L1-1']);
+            assert.equal(strategy.getSummariesView().length, 2);
+            assert.equal(strategy.getCounter(), 2);
+            assert.equal(strategy.getMergeQueueView().length, 1);
+            manager.sync();
+            manager.close();
+        }
+        // Phase 2: reopen, verify reload
+        {
+            const strategy2 = new TestableStrategy({ targetChunkTokens: 300 });
+            const manager2 = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy: strategy2,
+            });
+            const summaries = strategy2.getSummariesView();
+            assert.equal(summaries.length, 2, 'summaries should reload from chronicle');
+            assert.equal(summaries[0].content, 'summary one');
+            assert.equal(summaries[1].content, 'summary two');
+            assert.equal(strategy2.getCounter(), 2, 'counter should reload');
+            const queue = strategy2.getMergeQueueView();
+            assert.equal(queue.length, 1, 'merge queue should reload');
+            assert.equal(queue[0].level, 2);
+            assert.deepEqual(queue[0].sourceIds, ['L1-0', 'L1-1']);
+            manager2.close();
+        }
+    });
+    it('persists mergedInto edits so merged sources stay merged after restart', async () => {
+        {
+            const strategy = new TestableStrategy({ targetChunkTokens: 300 });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+            });
+            const a = strategy.seedL1('a', ['m1']);
+            const b = strategy.seedL1('b', ['m2']);
+            const merged = strategy.seedL2([a.id, b.id], 'merged a+b');
+            const summaries = strategy.getSummariesView();
+            assert.ok(summaries[0].mergedInto === merged.id);
+            assert.ok(summaries[1].mergedInto === merged.id);
+            manager.sync();
+            manager.close();
+        }
+        {
+            const strategy = new TestableStrategy({ targetChunkTokens: 300 });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+            });
+            const summaries = strategy.getSummariesView();
+            assert.equal(summaries.length, 3);
+            assert.equal(summaries[0].mergedInto, 'L2-2', 'L1 mergedInto must persist');
+            assert.equal(summaries[1].mergedInto, 'L2-2');
+            assert.equal(summaries[2].mergedInto, undefined);
+            manager.close();
+        }
+    });
+    it('isolates summary state per chronicle branch (fork)', async () => {
+        const strategy = new TestableStrategy({ targetChunkTokens: 300 });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        // Build pre-fork state, then fork at current head so the forked branch
+        // inherits everything we've written so far.
+        manager.addMessage('User', textBlock('m1'));
+        manager.addMessage('Claude', textBlock('m2'));
+        strategy.seedL1('common L1 (pre-fork)', ['m1', 'm2']);
+        const mainBranchName = manager.currentBranch().name;
+        const forkedName = await manager.fork('experimental');
+        assert.equal(forkedName, 'experimental');
+        assert.notEqual(forkedName, mainBranchName);
+        // On the forked branch, add a divergent summary
+        const strategyAfterFork = manager.getStrategy();
+        assert.equal(strategyAfterFork.getSummariesView().length, 1, 'forked branch should start with the pre-fork summary');
+        strategyAfterFork.seedL1('divergent on fork', ['x', 'y']);
+        assert.equal(strategyAfterFork.getSummariesView().length, 2);
+        // Switch back to main: should see only the pre-fork summary
+        await manager.switchBranch(mainBranchName);
+        const mainStrategy = manager.getStrategy();
+        const mainSummaries = mainStrategy.getSummariesView();
+        assert.equal(mainSummaries.length, 1, 'main branch must NOT see summaries created on fork');
+        assert.equal(mainSummaries[0].content, 'common L1 (pre-fork)');
+        // Add a summary unique to main
+        mainStrategy.seedL1('unique to main', ['p', 'q']);
+        assert.equal(mainStrategy.getSummariesView().length, 2);
+        // Switch back to fork: should still have its own divergent state
+        await manager.switchBranch(forkedName);
+        const forkStrategy = manager.getStrategy();
+        const forkSummaries = forkStrategy.getSummariesView();
+        assert.equal(forkSummaries.length, 2, 'fork branch should still have 2 summaries');
+        assert.equal(forkSummaries[1].content, 'divergent on fork');
+        assert.ok(!forkSummaries.some(s => s.content === 'unique to main'), 'fork must not see main-only summary');
+        manager.close();
+    });
+    it('keeps merge queue intact when executeMerge throws (no eager dequeue)', async () => {
+        // Regression test for the eager-dequeue footgun: dequeueMerge() used to
+        // run *before* the LLM call, so a transient failure (429, network drop,
+        // timeout) would silently drop the merge from the persisted queue
+        // forever. The fix is peek + shift-on-success — these assertions lock
+        // that contract in.
+        class FailingMergeStrategy extends TestableStrategy {
+            executeMergeError = new Error('simulated LLM failure');
+            async executeMerge(_level, _sourceIds, _ctx) {
+                throw this.executeMergeError;
+            }
+        }
+        const stubMembrane = {};
+        // Phase 1: enqueue a merge, force tick to fail, verify queue intact
+        {
+            const strategy = new FailingMergeStrategy({
+                targetChunkTokens: 300,
+                hierarchical: true,
+            });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+                membrane: stubMembrane,
+            });
+            strategy.seedMerge(2, ['L1-0', 'L1-1']);
+            assert.equal(strategy.getMergeQueueView().length, 1, 'merge enqueued');
+            // tick() will pick up the merge, invoke (our failing) executeMerge,
+            // and surface the error. The queue must still be intact afterward.
+            await assert.rejects(() => manager.tick(), /simulated LLM failure/, 'tick should propagate the LLM failure');
+            const queue = strategy.getMergeQueueView();
+            assert.equal(queue.length, 1, 'merge MUST remain in queue after failure');
+            assert.equal(queue[0].level, 2);
+            assert.deepEqual(queue[0].sourceIds, ['L1-0', 'L1-1']);
+            manager.sync();
+            manager.close();
+        }
+        // Phase 2: reopen the store; the un-merged entry must still be there.
+        // This is the part that mattered most pre-fix — the failure was *durable*
+        // because dequeueMerge persisted the shorter queue before the LLM call.
+        {
+            const strategy = new TestableStrategy({
+                targetChunkTokens: 300,
+                hierarchical: true,
+            });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+            });
+            const queue = strategy.getMergeQueueView();
+            assert.equal(queue.length, 1, 'merge MUST survive close/reopen');
+            assert.equal(queue[0].level, 2);
+            assert.deepEqual(queue[0].sourceIds, ['L1-0', 'L1-1']);
+            manager.close();
+        }
+    });
+});
+//# sourceMappingURL=strategy-persistence.test.js.map

package/dist/test/strategy-persistence.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-persistence.test.js","sourceRoot":"","sources":["../../test/strategy-persistence.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAI3E,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAEtD,SAAS,OAAO;IACd,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,gBAAiB,SAAQ,wBAAwB;IACrD,MAAM,CAAC,OAAe,EAAE,SAAmB;QACzC,MAAM,KAAK,GAAiB;YAC1B,EAAE,EAAE,MAAM,IAAI,CAAC,oBAAoB,EAAE,EAAE;YACvC,KAAK,EAAE,CAAC;YACR,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACrC,WAAW,EAAE,CAAC;YACd,SAAS;YACT,WAAW,EAAE;gBACX,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE;gBACzB,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;aAC5C;YACD,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;SACpB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,WAAqB,EAAE,OAAO,GAAG,QAAQ;QAC9C,MAAM,KAAK,GAAiB;YAC1B,EAAE,EAAE,MAAM,IAAI,CAAC,oBAAoB,EAAE,EAAE;YACvC,KAAK,EAAE,CAAC;YACR,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACrC,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,WAAW;YACtB,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;YACtC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;SACpB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,GAAG;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAmB,EAAE,SAAmB;QAChD,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,iCAAiC;IACjC,gBAAgB,KAAqB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAClE,UAAU,KAAa,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACtD,iBAAiB;QACf,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,MAAM,CAAC,OAAO,CAAC,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,CAAC;IACf,UAAU,CAAC,OAAO,CAAC,CAAC;IAEpB,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,uBAAuB;QACvB,CAAC;YACC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;gBACxC,IAAI,EAAE,eAAe;gBACrB,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;YAE9D,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3C,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3C,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAExC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAErD,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAED,iCAAiC;QACjC,CAAC;YACC,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;gBACzC,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,SAAS,CAAC,gBAAgB,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,wCAAwC,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,uBAAuB,CAAC,CAAC;YAEjE,MAAM,KAAK,GAAG,SAAS,CAAC,iBAAiB,EAAE,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,2BAA2B,CAAC,CAAC;YAC3D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAEvD,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,CAAC;YACC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;gBACxC,IAAI,EAAE,eAAe;gBACrB,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;YAE3D,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC9C,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;YAEjD,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAED,CAAC;YACC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;gBACxC,IAAI,EAAE,eAAe;gBACrB,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,4BAA4B,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAEjD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;YACxC,IAAI,EAAE,eAAe;YACrB,QAAQ;SACT,CAAC,CAAC;QAEH,uEAAuE;QACvE,4CAA4C;QAC5C,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAEtD,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC;QAEpD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAE5C,gDAAgD;QAChD,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAsB,CAAC;QACpE,MAAM,CAAC,KAAK,CACV,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAC3C,CAAC,EACD,sDAAsD,CACvD,CAAC;QACF,iBAAiB,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE7D,4DAA4D;QAC5D,MAAM,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAsB,CAAC;QAC/D,MAAM,aAAa,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CACV,aAAa,CAAC,MAAM,EACpB,CAAC,EACD,oDAAoD,CACrD,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QAE/D,+BAA+B;QAC/B,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAExD,iEAAiE;QACjE,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAsB,CAAC;QAC/D,MAAM,aAAa,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,2CAA2C,CAAC,CAAC;QACnF,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC5D,MAAM,CAAC,EAAE,CACP,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,gBAAgB,CAAC,EACxD,qCAAqC,CACtC,CAAC;QAEF,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,wEAAwE;QACxE,wEAAwE;QACxE,kEAAkE;QAClE,sEAAsE;QACtE,oBAAoB;QACpB,MAAM,oBAAqB,SAAQ,gBAAgB;YACjD,iBAAiB,GAAG,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAEpC,KAAK,CAAC,YAAY,CACnC,MAAoB,EACpB,UAAoB,EACpB,IAAqD;gBAErD,MAAM,IAAI,CAAC,iBAAiB,CAAC;YAC/B,CAAC;SACF;QAED,MAAM,YAAY,GAAG,EAAuD,CAAC;QAE7E,oEAAoE;QACpE,CAAC;YACC,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC;gBACxC,iBAAiB,EAAE,GAAG;gBACtB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;gBACxC,IAAI,EAAE,eAAe;gBACrB,QAAQ;gBACR,QAAQ,EAAE,YAAY;aACvB,CAAC,CAAC;YAEH,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAEvE,oEAAoE;YACpE,mEAAmE;YACnE,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EACpB,uBAAuB,EACvB,uCAAuC,CACxC,CAAC;YAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,0CAA0C,CAAC,CAAC;YAC1E,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAEvD,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAED,sEAAsE;QACtE,0EAA0E;QAC1E,wEAAwE;QACxE,CAAC;YACC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC;gBACpC,iBAAiB,EAAE,GAAG;gBACtB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC;gBACxC,IAAI,EAAE,eAAe;gBACrB,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,iCAAiC,CAAC,CAAC;YACjE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAEvD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/tool-pruning.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for tool-result pruning + tool_use input truncation (audit gap #4).
+ *
+ * For tool-heavy sessions, dozens or hundreds of repeated tool calls can
+ * dominate context. This pruning pass keeps the most recent N results per
+ * tool name (older ones get a brief marker), and optionally truncates
+ * tool_use input blobs whose serialized JSON exceeds a token cap.
+ */
+export {};
+//# sourceMappingURL=tool-pruning.test.d.ts.map

package/dist/test/tool-pruning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pruning.test.d.ts","sourceRoot":"","sources":["../../test/tool-pruning.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}