@animalabs/context-manager 0.2.0 → 0.4.0

package/dist/test/recent-window-eviction.test.js

@@ -0,0 +1,206 @@
+/**
+ * Regression tests for the postmortem 2026-05-04 (Triumvirate Conhost Silence)
+ * findings about AutobiographicalStrategy:
+ *
+ *   (A) Phase-4 recent-window emission iterated forward and broke on budget,
+ *       dropping the newest messages instead of the oldest. After a bloated
+ *       compaction ate most of the budget, May-4 messages addressed to the
+ *       clerk never reached the inference context, and the agent went silent.
+ *
+ *   (B) Synthesised summary turns bypassed `maxMessageTokens`. With L1+L2+L3
+ *       summary budgets defaulting to 30k each, a single assistant Q&A pair
+ *       could grow past 90k tokens, eating the inference budget and starving
+ *       recent messages.
+ *
+ * These tests construct minimal scenarios that fail under the pre-fix code
+ * and pass after the fixes in src/strategies/autobiographical.ts.
+ */
+import { describe, it, before, after } 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-recent-window-eviction';
+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 lets the test seed L1 summaries directly without a real LLM. */
+class SeedableStrategy extends AutobiographicalStrategy {
+    seedL1Summary(content, sourceIds) {
+        const entry = {
+            id: `L1-test-${this.summaries.length}`,
+            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.summaries.push(entry);
+    }
+}
+describe('Recent window newest-first eviction (postmortem bug A)', () => {
+    before(() => cleanup());
+    after(() => cleanup());
+    it('preserves the LATEST recent-window messages when budget is tight', async () => {
+        cleanup();
+        const strategy = new AutobiographicalStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 100_000, // big — keep all messages in the recent zone
+            maxMessageTokens: 0,
+            hierarchical: true,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        // 10 recent messages each padded to ~25 tokens (~100 chars) so that a
+        // tight budget forces eviction of some of them.
+        for (let i = 1; i <= 10; i++) {
+            const tag = String(i).padStart(2, '0');
+            manager.addMessage('user', textBlock(`msg-${tag} ${'.'.repeat(80)} body`));
+        }
+        // Tight budget: only ~3-4 messages worth of room out of 10.
+        const compiled = await manager.compile({ maxTokens: 80, reserveForResponse: 0 });
+        // The pre-fix loop iterated forward and emitted msg-01, msg-02, ... breaking
+        // when budget ran out. Post-fix should keep the NEWEST messages.
+        const lastEntry = compiled.messages[compiled.messages.length - 1];
+        assert.ok(lastEntry, 'should have at least one compiled entry');
+        const lastText = lastEntry.content
+            .filter((b) => b.type === 'text')
+            .map(b => b.text)
+            .join(' ');
+        assert.match(lastText, /msg-10/, `Latest compiled entry must contain msg-10, got: "${lastText}"`);
+        // And the compiled tail must be a strict tail: contain msg-10 but not the
+        // oldest entries that wouldn't fit.
+        const allText = compiled.messages
+            .flatMap(m => m.content)
+            .filter((b) => b.type === 'text')
+            .map(b => b.text)
+            .join(' ');
+        assert.ok(allText.includes('msg-10'), 'msg-10 (newest) must survive eviction');
+        // Expect SOME oldest message to have been evicted.
+        assert.ok(!allText.includes('msg-01'), 'msg-01 (oldest) should have been evicted');
+        manager.close();
+    });
+    it('emits surviving messages in chronological order (not reversed)', async () => {
+        cleanup();
+        const strategy = new AutobiographicalStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 100_000,
+            maxMessageTokens: 0,
+            hierarchical: true,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        for (let i = 1; i <= 5; i++) {
+            const tag = String(i).padStart(2, '0');
+            manager.addMessage('user', textBlock(`msg-${tag} body content`));
+        }
+        // Budget large enough to keep all 5.
+        const compiled = await manager.compile({ maxTokens: 1000, reserveForResponse: 0 });
+        const tags = compiled.messages
+            .map(m => m.content
+            .filter((b) => b.type === 'text')
+            .map(b => b.text)
+            .join(' '))
+            .map(t => {
+            const m = t.match(/msg-(\d+)/);
+            return m ? m[1] : null;
+        })
+            .filter((x) => x !== null);
+        assert.deepStrictEqual(tags, ['01', '02', '03', '04', '05'], 'compiled order must be chronological');
+        manager.close();
+    });
+});
+describe('Synthesised summary turn respects maxMessageTokens (postmortem bug B)', () => {
+    before(() => cleanup());
+    after(() => cleanup());
+    it('truncates a bloated combined-summaries answer entry to the configured cap', async () => {
+        cleanup();
+        const MSG_CAP = 200; // tokens
+        const strategy = new SeedableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 1000,
+            maxMessageTokens: MSG_CAP,
+            hierarchical: true,
+            // Generous summary budgets so the strategy WANTS to emit lots of summary text.
+            l1BudgetTokens: 30_000,
+            l2BudgetTokens: 30_000,
+            l3BudgetTokens: 30_000,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        // A few recent messages so the compile is non-trivial.
+        manager.addMessage('user', textBlock('hello'));
+        manager.addMessage('assistant', textBlock('hi back'));
+        // Seed an oversized summary that would otherwise blow past msgCap.
+        // sourceIds are synthetic so they don't intersect head/recent message IDs
+        // and trigger the anti-redundancy filter.
+        const bigContent = 'X'.repeat(20_000); // ≈ 5000 tokens of text
+        strategy.seedL1Summary(bigContent, ['synthetic-old-1', 'synthetic-old-2']);
+        const compiled = await manager.compile({
+            maxTokens: 200_000,
+            reserveForResponse: 4000,
+        });
+        // Find the synthesised summary answer turn. It is a Q&A pair: the question
+        // is participant 'Context Manager', the answer is the summary participant
+        // (default 'Claude').
+        const answerEntry = compiled.messages.find(m => m.participant === 'Claude' &&
+            m.content.some(b => b.type === 'text' && b.text.includes('XXXX')));
+        assert.ok(answerEntry, 'should find synthesised summary answer entry');
+        const answerText = answerEntry.content
+            .filter((b) => b.type === 'text')
+            .map(b => b.text)
+            .join('');
+        // truncateContent caps at maxTokens * 4 chars and appends a marker.
+        // Allow some slack for the marker text.
+        const expectedMaxChars = MSG_CAP * 4 + 200;
+        assert.ok(answerText.length <= expectedMaxChars, `answer entry must be truncated to ≈${MSG_CAP} tokens, got ${answerText.length} chars`);
+        assert.match(answerText, /\[truncated/, 'truncated answer should carry the truncation marker');
+        manager.close();
+    });
+    it('leaves the answer entry intact when content is within the cap', async () => {
+        cleanup();
+        const strategy = new SeedableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 1000,
+            maxMessageTokens: 5000,
+            hierarchical: true,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        manager.addMessage('user', textBlock('hello'));
+        const small = 'a small honest summary of earlier conversation';
+        strategy.seedL1Summary(small, ['synthetic-old-1']);
+        const compiled = await manager.compile({
+            maxTokens: 200_000,
+            reserveForResponse: 4000,
+        });
+        const answerEntry = compiled.messages.find(m => m.participant === 'Claude' &&
+            m.content.some(b => b.type === 'text' && b.text.includes('honest summary')));
+        assert.ok(answerEntry, 'should find synthesised summary answer entry');
+        const answerText = answerEntry.content
+            .filter((b) => b.type === 'text')
+            .map(b => b.text)
+            .join('');
+        assert.doesNotMatch(answerText, /\[truncated/, 'small summaries must not be truncated');
+        assert.ok(answerText.includes(small), 'small summary content must round-trip verbatim');
+        manager.close();
+    });
+});
+//# sourceMappingURL=recent-window-eviction.test.js.map

package/dist/test/recent-window-eviction.test.js.map

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

package/dist/test/search.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=search.test.d.ts.map

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

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

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"}