@fgv/ts-agent-memory 5.1.0-41 → 5.1.0-43

package/dist/test/unit/store/fragmentEmbedOnWrite.test.js

@@ -0,0 +1,255 @@
+/*
+ * Copyright (c) 2026 Erik Fortune
+ * SPDX-License-Identifier: MIT
+ */
+import '@fgv/ts-utils-jest';
+import { Converters, Logging, fail, succeed } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+import { BodyConverterRegistry, FileTreeMemoryStore, FragmentSemanticRetriever, InMemoryFragmentCosineIndex, KnowledgeIdentityCodec, MemoryCapCullPolicy, MtmIdentityCodec, envelopeConverter } from '../../../index';
+const knowledgeKind = 'knowledge';
+const mtmKind = 'mtm';
+function mutableRoot() {
+    const tree = FileTree.inMemory([], { mutable: true }).orThrow();
+    const root = tree.getDirectory('/').orThrow();
+    if (!FileTree.isMutableDirectoryItem(root)) {
+        throw new Error('expected a mutable root directory');
+    }
+    return root;
+}
+function makeRecord(id, body, kind = 'knowledge', entityId) {
+    return {
+        envelope: envelopeConverter
+            .convert({
+            id,
+            entityId: entityId !== null && entityId !== void 0 ? entityId : id,
+            kind,
+            tags: [],
+            links: [],
+            created: 0,
+            updated: 0,
+            seq: 0,
+            contentHash: '',
+            provenance: { source: 'agent' }
+        })
+            .orThrow(),
+        body
+    };
+}
+/** Deterministic keyword-count feature space (no network), shared with the query side. */
+const MARKERS = ['cat', 'dog', 'fish'];
+function featureVector(text) {
+    const lower = text.toLowerCase();
+    return Float32Array.from(MARKERS.map((m) => lower.split(m).length - 1));
+}
+/**
+ * Fragment embedder: chunks the body into whitespace-delimited words, emitting one
+ * fragment per word with its true `[start, end)` character offsets and a feature
+ * vector for that word. Models the consumer-owned chunking policy.
+ */
+const fragmentEmbed = (r) => Promise.resolve(Converters.string
+    .convert(r.body)
+    .withErrorFormat((msg) => `cannot embed fragments: body is not a string: ${msg}`)
+    .onSuccess((body) => {
+    const fragments = [];
+    const re = /\S+/g;
+    let m = re.exec(body);
+    while (m !== null) {
+        fragments.push({
+            locator: { start: m.index, end: m.index + m[0].length },
+            vector: featureVector(m[0])
+        });
+        m = re.exec(body);
+    }
+    return succeed(fragments);
+}));
+const queryEmbed = (text) => Promise.resolve(succeed(featureVector(text)));
+/** Records addFragments/remove call order and can be configured to fail either op. */
+class SpyFragmentIndex {
+    constructor() {
+        this.calls = [];
+        this.failAdd = false;
+        this.failRemove = false;
+        this._inner = InMemoryFragmentCosineIndex.create().orThrow();
+    }
+    async addFragments(target, fragments) {
+        this.calls.push(`add:${target.id}:${fragments.length}`);
+        return this.failAdd ? fail('add boom') : this._inner.addFragments(target, fragments);
+    }
+    async remove(target) {
+        this.calls.push(`remove:${target.id}`);
+        return this.failRemove ? fail('remove boom') : this._inner.remove(target);
+    }
+    query(vector, topK, maxPerRecord) {
+        return this._inner.query(vector, topK, maxPerRecord);
+    }
+}
+function knowledgeStore(params) {
+    const registry = BodyConverterRegistry.create().orThrow();
+    registry.register(knowledgeKind, Converters.string);
+    return FileTreeMemoryStore.create({
+        root: mutableRoot(),
+        registry,
+        codecs: new Map([[knowledgeKind, new KnowledgeIdentityCodec()]]),
+        fragmentIndex: params.fragmentIndex,
+        fragmentEmbedder: params.fragmentEmbedder,
+        logger: params.logger
+    }).orThrow();
+}
+describe('FileTreeMemoryStore fragment-embed-on-write', () => {
+    describe('when wired', () => {
+        test('embeds fragments on write and indexes them (queryable by span)', async () => {
+            const index = InMemoryFragmentCosineIndex.create().orThrow();
+            const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: fragmentEmbed });
+            expect(await store.put(makeRecord('doc-a', 'cat dog'))).toSucceed();
+            // Two words → two fragments.
+            expect(index.recordCount).toBe(1);
+            expect(index.fragmentCount).toBe(2);
+            // A query for 'cat' surfaces the 'cat' span [0,3], not the 'dog' span.
+            expect(await index.query(featureVector('cat'), 1)).toSucceedAndSatisfy((hits) => {
+                expect(hits[0].target.id).toBe('doc-a');
+                expect(hits[0].locator).toEqual({ start: 0, end: 3 });
+            });
+        });
+        test('stamps nothing on the record (fragments have no per-record embeddingRef)', async () => {
+            const index = InMemoryFragmentCosineIndex.create().orThrow();
+            const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: fragmentEmbed });
+            expect(await store.put(makeRecord('doc-a', 'cat dog'))).toSucceedAndSatisfy((record) => {
+                expect(record.envelope.embeddingRef).toBeUndefined();
+            });
+        });
+        test('re-embeds on a content change via whole-record replace', async () => {
+            const spy = new SpyFragmentIndex();
+            const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed });
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            (await store.put(makeRecord('doc-a', 'dog fish'))).orThrow();
+            // First write: 1 fragment; second: 2 fragments, replacing the first.
+            expect(spy.calls).toEqual(['add:doc-a:1', 'add:doc-a:2']);
+            // The 'cat' fragment is gone — the new 'dog'/'fish' spans are orthogonal to a
+            // 'cat' query (best score 0), proving the whole-record replace dropped it.
+            expect(await spy.query(featureVector('cat'), 5)).toSucceedAndSatisfy((hits) => {
+                expect(hits.every((h) => h.score === 0)).toBe(true);
+            });
+            expect(await spy.query(featureVector('fish'), 1)).toSucceedAndSatisfy((hits) => {
+                expect(hits[0].score).toBeCloseTo(1);
+            });
+        });
+        test('does not re-embed a dedup no-op (identical content)', async () => {
+            const spy = new SpyFragmentIndex();
+            const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed });
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            expect(spy.calls).toEqual(['add:doc-a:1']);
+        });
+        test('removes the fragments on delete', async () => {
+            const spy = new SpyFragmentIndex();
+            const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed });
+            (await store.put(makeRecord('doc-a', 'cat dog'))).orThrow();
+            expect(await store.delete(knowledgeKind, 'doc-a')).toSucceedWith('doc-a');
+            expect(spy.calls).toEqual(['add:doc-a:2', 'remove:doc-a']);
+            expect(await spy.query(featureVector('cat'), 5)).toSucceedWith([]);
+        });
+        test('removes evicted fragments on cap-cull eviction', async () => {
+            const index = InMemoryFragmentCosineIndex.create().orThrow();
+            const capCull = MemoryCapCullPolicy.create({
+                maxRecords: 2,
+                mutableFields: ['body', 'tags', 'links', 'provenance', 'embeddingRef']
+            }).orThrow();
+            const registry = BodyConverterRegistry.create().orThrow();
+            registry.register(mtmKind, Converters.string);
+            const store = FileTreeMemoryStore.create({
+                root: mutableRoot(),
+                registry,
+                codecs: new Map([[mtmKind, new MtmIdentityCodec()]]),
+                writePolicies: new Map([[mtmKind, capCull]]),
+                fragmentIndex: index,
+                fragmentEmbedder: fragmentEmbed
+            }).orThrow();
+            (await store.put(makeRecord('turn-0', 'cat', 'mtm', 'conv-1:0'))).orThrow();
+            (await store.put(makeRecord('turn-1', 'dog', 'mtm', 'conv-1:1'))).orThrow();
+            (await store.put(makeRecord('turn-2', 'fish', 'mtm', 'conv-1:2'))).orThrow();
+            // turn-0 evicted from the store AND its fragments from the index.
+            expect(index.recordCount).toBe(2);
+            expect(await index.query(featureVector('cat'), 5)).toSucceedAndSatisfy((hits) => {
+                expect(hits.map((h) => h.target.id)).not.toContain('turn-0');
+            });
+        });
+        test('persists the record (best-effort) and logs when fragment embedding fails', async () => {
+            const index = InMemoryFragmentCosineIndex.create().orThrow();
+            const logger = new Logging.InMemoryLogger();
+            const failEmbed = () => Promise.resolve(fail('no model'));
+            const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: failEmbed, logger });
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();
+            expect(await store.getById('knowledge', 'doc-a')).toSucceedAndSatisfy((record) => {
+                expect(record === null || record === void 0 ? void 0 : record.envelope.id).toBe('doc-a');
+            });
+            expect(index.recordCount).toBe(0);
+            expect(logger.logged.some((m) => /fragment embedding 'doc-a' failed.*no model/i.test(m))).toBe(true);
+        });
+        test('persists the record (best-effort) and logs when the fragment add fails', async () => {
+            const spy = new SpyFragmentIndex();
+            spy.failAdd = true;
+            const logger = new Logging.InMemoryLogger();
+            const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed, logger });
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();
+            expect(await store.getById('knowledge', 'doc-a')).toSucceedAndSatisfy((record) => {
+                expect(record === null || record === void 0 ? void 0 : record.envelope.id).toBe('doc-a');
+            });
+            expect(logger.logged.some((m) => /fragment add for 'doc-a' failed.*add boom/i.test(m))).toBe(true);
+        });
+        test('best-effort embed survives a throwing/rejecting fragment embedder', async () => {
+            const index = InMemoryFragmentCosineIndex.create().orThrow();
+            const logger = new Logging.InMemoryLogger();
+            const throwingEmbed = () => Promise.reject(new Error('embedder kaboom'));
+            const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: throwingEmbed, logger });
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();
+            expect(index.recordCount).toBe(0);
+            expect(logger.logged.some((m) => /fragment embedding 'doc-a' threw.*embedder kaboom/i.test(m))).toBe(true);
+        });
+        test('a committed delete succeeds (best-effort) and logs when fragment removal fails', async () => {
+            const spy = new SpyFragmentIndex();
+            const logger = new Logging.InMemoryLogger();
+            const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed, logger });
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            spy.failRemove = true;
+            expect(await store.delete(knowledgeKind, 'doc-a')).toSucceedWith('doc-a');
+            expect(await store.getById('knowledge', 'doc-a')).toSucceedWith(undefined);
+            expect(logger.logged.some((m) => /fragment removal for 'doc-a' failed.*remove boom/i.test(m))).toBe(true);
+        });
+    });
+    describe('when unwired', () => {
+        test('a store without a fragment index or embedder does no fragment work', async () => {
+            const store = knowledgeStore({});
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy((record) => {
+                expect(record.envelope.embeddingRef).toBeUndefined();
+            });
+        });
+        test('a fragment index without an embedder is fully inert (no add or remove)', async () => {
+            const spy = new SpyFragmentIndex();
+            const store = knowledgeStore({ fragmentIndex: spy });
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            (await store.delete(knowledgeKind, 'doc-a')).orThrow();
+            expect(spy.calls).toEqual([]);
+        });
+    });
+    describe('fragment discovery end-to-end', () => {
+        test('a wired store + InMemoryFragmentCosineIndex + FragmentSemanticRetriever returns per-span hits', async () => {
+            const index = InMemoryFragmentCosineIndex.create().orThrow();
+            const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: fragmentEmbed });
+            (await store.put(makeRecord('doc-a', 'cat cat dog'))).orThrow();
+            (await store.put(makeRecord('doc-b', 'fish fish'))).orThrow();
+            const retriever = FragmentSemanticRetriever.create({
+                backend: { fragmentIndex: index, embedQuery: queryEmbed }
+            }).orThrow();
+            expect(retriever.capabilities.supportsFragmentRecall).toBe(true);
+            // maxPerRecord=1 keeps doc-a's two 'cat' spans from crowding out the field.
+            expect(await retriever.retrieve({ semantic: 'cat', topK: 5, maxPerRecord: 1 })).toSucceedAndSatisfy((hits) => {
+                // The top hit is a 'cat' span in doc-a; the doc-a cap is honored.
+                expect(hits[0].target.id).toBe('doc-a');
+                expect(hits[0].locator).toEqual({ start: 0, end: 3 });
+                const perRecord = hits.filter((h) => h.target.id === 'doc-a');
+                expect(perRecord).toHaveLength(1);
+            });
+        });
+    });
+});
+//# sourceMappingURL=fragmentEmbedOnWrite.test.js.map

package/dist/test/unit/store/fragmentEmbedOnWrite.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragmentEmbedOnWrite.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/fragmentEmbedOnWrite.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport '@fgv/ts-utils-jest';\nimport { Converters, Logging, Result, fail, succeed } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  BodyConverterRegistry,\n  EntityId,\n  FileTreeMemoryStore,\n  FragmentSemanticRetriever,\n  IBodyConverterRegistry,\n  IEdgeTarget,\n  IEmbeddedFragment,\n  IFragmentVectorIndex,\n  IIdentityCodec,\n  IMemoryRecord,\n  IVectorQueryHit,\n  InMemoryFragmentCosineIndex,\n  Kind,\n  KnowledgeIdentityCodec,\n  MemoryCapCullPolicy,\n  MemoryId,\n  MemoryScopeKey,\n  MtmIdentityCodec,\n  IWritePolicy,\n  envelopeConverter\n} from '../../../index';\n\nconst knowledgeKind: Kind = 'knowledge' as Kind;\nconst mtmKind: Kind = 'mtm' as Kind;\n\nfunction mutableRoot(): FileTree.IMutableFileTreeDirectoryItem {\n  const tree = FileTree.inMemory([], { mutable: true }).orThrow();\n  const root = tree.getDirectory('/').orThrow();\n  if (!FileTree.isMutableDirectoryItem(root)) {\n    throw new Error('expected a mutable root directory');\n  }\n  return root;\n}\n\nfunction makeRecord(\n  id: string,\n  body: string,\n  kind: string = 'knowledge',\n  entityId?: string\n): IMemoryRecord<unknown> {\n  return {\n    envelope: envelopeConverter\n      .convert({\n        id,\n        entityId: entityId ?? id,\n        kind,\n        tags: [],\n        links: [],\n        created: 0,\n        updated: 0,\n        seq: 0,\n        contentHash: '',\n        provenance: { source: 'agent' }\n      })\n      .orThrow(),\n    body\n  };\n}\n\n/** Deterministic keyword-count feature space (no network), shared with the query side. */\nconst MARKERS: ReadonlyArray<string> = ['cat', 'dog', 'fish'];\nfunction featureVector(text: string): Float32Array {\n  const lower: string = text.toLowerCase();\n  return Float32Array.from(MARKERS.map((m) => lower.split(m).length - 1));\n}\n\n/**\n * Fragment embedder: chunks the body into whitespace-delimited words, emitting one\n * fragment per word with its true `[start, end)` character offsets and a feature\n * vector for that word. Models the consumer-owned chunking policy.\n */\nconst fragmentEmbed = (r: IMemoryRecord<unknown>): Promise<Result<ReadonlyArray<IEmbeddedFragment>>> =>\n  Promise.resolve(\n    Converters.string\n      .convert(r.body)\n      .withErrorFormat((msg) => `cannot embed fragments: body is not a string: ${msg}`)\n      .onSuccess((body) => {\n        const fragments: IEmbeddedFragment[] = [];\n        const re: RegExp = /\\S+/g;\n        let m: RegExpExecArray | null = re.exec(body);\n        while (m !== null) {\n          fragments.push({\n            locator: { start: m.index, end: m.index + m[0].length },\n            vector: featureVector(m[0])\n          });\n          m = re.exec(body);\n        }\n        return succeed(fragments);\n      })\n  );\n\nconst queryEmbed = (text: string): Promise<Result<Float32Array>> =>\n  Promise.resolve(succeed(featureVector(text)));\n\n/** Records addFragments/remove call order and can be configured to fail either op. */\nclass SpyFragmentIndex implements IFragmentVectorIndex {\n  public readonly calls: string[] = [];\n  public failAdd: boolean = false;\n  public failRemove: boolean = false;\n  private readonly _inner: InMemoryFragmentCosineIndex = InMemoryFragmentCosineIndex.create().orThrow();\n\n  public async addFragments(\n    target: IEdgeTarget,\n    fragments: ReadonlyArray<IEmbeddedFragment>\n  ): Promise<Result<number>> {\n    this.calls.push(`add:${target.id}:${fragments.length}`);\n    return this.failAdd ? fail('add boom') : this._inner.addFragments(target, fragments);\n  }\n  public async remove(target: IEdgeTarget): Promise<Result<IEdgeTarget>> {\n    this.calls.push(`remove:${target.id}`);\n    return this.failRemove ? fail('remove boom') : this._inner.remove(target);\n  }\n  public query(\n    vector: Float32Array,\n    topK: number,\n    maxPerRecord?: number\n  ): Promise<Result<ReadonlyArray<IVectorQueryHit>>> {\n    return this._inner.query(vector, topK, maxPerRecord);\n  }\n}\n\nfunction knowledgeStore(params: {\n  fragmentIndex?: IFragmentVectorIndex;\n  fragmentEmbedder?: (r: IMemoryRecord<unknown>) => Promise<Result<ReadonlyArray<IEmbeddedFragment>>>;\n  logger?: Logging.ILogger;\n}): FileTreeMemoryStore {\n  const registry: IBodyConverterRegistry = BodyConverterRegistry.create().orThrow();\n  registry.register(knowledgeKind, Converters.string);\n  return FileTreeMemoryStore.create({\n    root: mutableRoot(),\n    registry,\n    codecs: new Map<Kind, IIdentityCodec>([[knowledgeKind, new KnowledgeIdentityCodec()]]),\n    fragmentIndex: params.fragmentIndex,\n    fragmentEmbedder: params.fragmentEmbedder,\n    logger: params.logger\n  }).orThrow();\n}\n\ndescribe('FileTreeMemoryStore fragment-embed-on-write', () => {\n  describe('when wired', () => {\n    test('embeds fragments on write and indexes them (queryable by span)', async () => {\n      const index = InMemoryFragmentCosineIndex.create().orThrow();\n      const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: fragmentEmbed });\n      expect(await store.put(makeRecord('doc-a', 'cat dog'))).toSucceed();\n      // Two words → two fragments.\n      expect(index.recordCount).toBe(1);\n      expect(index.fragmentCount).toBe(2);\n      // A query for 'cat' surfaces the 'cat' span [0,3], not the 'dog' span.\n      expect(await index.query(featureVector('cat'), 1)).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          expect(hits[0].target.id).toBe('doc-a');\n          expect(hits[0].locator).toEqual({ start: 0, end: 3 });\n        }\n      );\n    });\n\n    test('stamps nothing on the record (fragments have no per-record embeddingRef)', async () => {\n      const index = InMemoryFragmentCosineIndex.create().orThrow();\n      const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: fragmentEmbed });\n      expect(await store.put(makeRecord('doc-a', 'cat dog'))).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown>) => {\n          expect(record.envelope.embeddingRef).toBeUndefined();\n        }\n      );\n    });\n\n    test('re-embeds on a content change via whole-record replace', async () => {\n      const spy = new SpyFragmentIndex();\n      const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed });\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      (await store.put(makeRecord('doc-a', 'dog fish'))).orThrow();\n      // First write: 1 fragment; second: 2 fragments, replacing the first.\n      expect(spy.calls).toEqual(['add:doc-a:1', 'add:doc-a:2']);\n      // The 'cat' fragment is gone — the new 'dog'/'fish' spans are orthogonal to a\n      // 'cat' query (best score 0), proving the whole-record replace dropped it.\n      expect(await spy.query(featureVector('cat'), 5)).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          expect(hits.every((h) => h.score === 0)).toBe(true);\n        }\n      );\n      expect(await spy.query(featureVector('fish'), 1)).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          expect(hits[0].score).toBeCloseTo(1);\n        }\n      );\n    });\n\n    test('does not re-embed a dedup no-op (identical content)', async () => {\n      const spy = new SpyFragmentIndex();\n      const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed });\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      expect(spy.calls).toEqual(['add:doc-a:1']);\n    });\n\n    test('removes the fragments on delete', async () => {\n      const spy = new SpyFragmentIndex();\n      const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed });\n      (await store.put(makeRecord('doc-a', 'cat dog'))).orThrow();\n      expect(await store.delete(knowledgeKind, 'doc-a' as unknown as EntityId)).toSucceedWith(\n        'doc-a' as MemoryId\n      );\n      expect(spy.calls).toEqual(['add:doc-a:2', 'remove:doc-a']);\n      expect(await spy.query(featureVector('cat'), 5)).toSucceedWith([]);\n    });\n\n    test('removes evicted fragments on cap-cull eviction', async () => {\n      const index = InMemoryFragmentCosineIndex.create().orThrow();\n      const capCull: IWritePolicy = MemoryCapCullPolicy.create({\n        maxRecords: 2,\n        mutableFields: ['body', 'tags', 'links', 'provenance', 'embeddingRef']\n      }).orThrow();\n      const registry: IBodyConverterRegistry = BodyConverterRegistry.create().orThrow();\n      registry.register(mtmKind, Converters.string);\n      const store = FileTreeMemoryStore.create({\n        root: mutableRoot(),\n        registry,\n        codecs: new Map<Kind, IIdentityCodec>([[mtmKind, new MtmIdentityCodec()]]),\n        writePolicies: new Map<Kind, IWritePolicy>([[mtmKind, capCull]]),\n        fragmentIndex: index,\n        fragmentEmbedder: fragmentEmbed\n      }).orThrow();\n\n      (await store.put(makeRecord('turn-0', 'cat', 'mtm', 'conv-1:0'))).orThrow();\n      (await store.put(makeRecord('turn-1', 'dog', 'mtm', 'conv-1:1'))).orThrow();\n      (await store.put(makeRecord('turn-2', 'fish', 'mtm', 'conv-1:2'))).orThrow();\n      // turn-0 evicted from the store AND its fragments from the index.\n      expect(index.recordCount).toBe(2);\n      expect(await index.query(featureVector('cat'), 5)).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          expect(hits.map((h) => h.target.id)).not.toContain('turn-0');\n        }\n      );\n    });\n\n    test('persists the record (best-effort) and logs when fragment embedding fails', async () => {\n      const index = InMemoryFragmentCosineIndex.create().orThrow();\n      const logger = new Logging.InMemoryLogger();\n      const failEmbed = (): Promise<Result<ReadonlyArray<IEmbeddedFragment>>> =>\n        Promise.resolve(fail('no model'));\n      const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: failEmbed, logger });\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();\n      expect(await store.getById('knowledge' as MemoryScopeKey, 'doc-a' as MemoryId)).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown> | undefined) => {\n          expect(record?.envelope.id).toBe('doc-a');\n        }\n      );\n      expect(index.recordCount).toBe(0);\n      expect(logger.logged.some((m) => /fragment embedding 'doc-a' failed.*no model/i.test(m))).toBe(true);\n    });\n\n    test('persists the record (best-effort) and logs when the fragment add fails', async () => {\n      const spy = new SpyFragmentIndex();\n      spy.failAdd = true;\n      const logger = new Logging.InMemoryLogger();\n      const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed, logger });\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();\n      expect(await store.getById('knowledge' as MemoryScopeKey, 'doc-a' as MemoryId)).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown> | undefined) => {\n          expect(record?.envelope.id).toBe('doc-a');\n        }\n      );\n      expect(logger.logged.some((m) => /fragment add for 'doc-a' failed.*add boom/i.test(m))).toBe(true);\n    });\n\n    test('best-effort embed survives a throwing/rejecting fragment embedder', async () => {\n      const index = InMemoryFragmentCosineIndex.create().orThrow();\n      const logger = new Logging.InMemoryLogger();\n      const throwingEmbed = (): Promise<Result<ReadonlyArray<IEmbeddedFragment>>> =>\n        Promise.reject(new Error('embedder kaboom'));\n      const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: throwingEmbed, logger });\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();\n      expect(index.recordCount).toBe(0);\n      expect(logger.logged.some((m) => /fragment embedding 'doc-a' threw.*embedder kaboom/i.test(m))).toBe(\n        true\n      );\n    });\n\n    test('a committed delete succeeds (best-effort) and logs when fragment removal fails', async () => {\n      const spy = new SpyFragmentIndex();\n      const logger = new Logging.InMemoryLogger();\n      const store = knowledgeStore({ fragmentIndex: spy, fragmentEmbedder: fragmentEmbed, logger });\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      spy.failRemove = true;\n      expect(await store.delete(knowledgeKind, 'doc-a' as unknown as EntityId)).toSucceedWith(\n        'doc-a' as MemoryId\n      );\n      expect(await store.getById('knowledge' as MemoryScopeKey, 'doc-a' as MemoryId)).toSucceedWith(\n        undefined\n      );\n      expect(logger.logged.some((m) => /fragment removal for 'doc-a' failed.*remove boom/i.test(m))).toBe(\n        true\n      );\n    });\n  });\n\n  describe('when unwired', () => {\n    test('a store without a fragment index or embedder does no fragment work', async () => {\n      const store = knowledgeStore({});\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown>) => {\n          expect(record.envelope.embeddingRef).toBeUndefined();\n        }\n      );\n    });\n\n    test('a fragment index without an embedder is fully inert (no add or remove)', async () => {\n      const spy = new SpyFragmentIndex();\n      const store = knowledgeStore({ fragmentIndex: spy });\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      (await store.delete(knowledgeKind, 'doc-a' as unknown as EntityId)).orThrow();\n      expect(spy.calls).toEqual([]);\n    });\n  });\n\n  describe('fragment discovery end-to-end', () => {\n    test('a wired store + InMemoryFragmentCosineIndex + FragmentSemanticRetriever returns per-span hits', async () => {\n      const index = InMemoryFragmentCosineIndex.create().orThrow();\n      const store = knowledgeStore({ fragmentIndex: index, fragmentEmbedder: fragmentEmbed });\n      (await store.put(makeRecord('doc-a', 'cat cat dog'))).orThrow();\n      (await store.put(makeRecord('doc-b', 'fish fish'))).orThrow();\n\n      const retriever = FragmentSemanticRetriever.create({\n        backend: { fragmentIndex: index, embedQuery: queryEmbed }\n      }).orThrow();\n      expect(retriever.capabilities.supportsFragmentRecall).toBe(true);\n\n      // maxPerRecord=1 keeps doc-a's two 'cat' spans from crowding out the field.\n      expect(await retriever.retrieve({ semantic: 'cat', topK: 5, maxPerRecord: 1 })).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          // The top hit is a 'cat' span in doc-a; the doc-a cap is honored.\n          expect(hits[0].target.id).toBe('doc-a');\n          expect(hits[0].locator).toEqual({ start: 0, end: 3 });\n          const perRecord = hits.filter((h) => h.target.id === 'doc-a');\n          expect(perRecord).toHaveLength(1);\n        }\n      );\n    });\n  });\n});\n"]}

package/dist/test/unit/store/lenientOpen.test.js

@@ -0,0 +1,248 @@
+/*
+ * Copyright (c) 2026 Erik Fortune
+ * SPDX-License-Identifier: MIT
+ */
+import '@fgv/ts-utils-jest';
+import { Converters, Logging, fail, succeed } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+import { BodyConverterRegistry, FileTreeMemoryStore, joinFrontmatter } from '../../../index';
+/**
+ * The incident: one vault holds every kind (mtm, ltm, conversation, knowledge,
+ * claim) in ONE store. A required field was added to the `claim` body; every
+ * pre-existing `claim` failed validation; and because the initial walk collapsed
+ * per-record results with `mapResults` (fail-the-whole-array on any element),
+ * every OTHER valid record became unreadable behind the failed open. These tests
+ * reproduce that shape (a poison-rejecting body converter standing in for the
+ * migrated converter) and pin the lenient (`onRecordError: 'skip'`) behavior.
+ */
+const noteKind = 'note';
+const POISON = 'POISON';
+/**
+ * A permissive identity codec that treats the full `<scope>/<stem>` path as the
+ * entity id, so records can live at any nesting depth (the shipped codecs pin a
+ * fixed scope shape; this test needs arbitrary-depth scopes to prove the
+ * recursion threads skips out of nested subtrees).
+ */
+class PathIdentityCodec {
+    encode(entityId) {
+        const value = String(entityId);
+        const cut = value.lastIndexOf('/');
+        const scope = (cut >= 0 ? value.slice(0, cut) : '');
+        const idStem = cut >= 0 ? value.slice(cut + 1) : value;
+        return succeed({ scope, idStem, isVersioned: false });
+    }
+    decode(scope, encodedStem) {
+        return succeed(`${scope}/${encodedStem}`);
+    }
+    verifyRoundTrip() {
+        return succeed(true);
+    }
+}
+/** A body converter that rejects any body containing the poison marker. */
+const poisonRejectingConverter = Converters.string.map((body) => body.includes(POISON) ? fail(`note body rejected: contains ${POISON}`) : succeed(body));
+function registry(bodyConverter) {
+    const created = BodyConverterRegistry.create().orThrow();
+    created.register(noteKind, bodyConverter);
+    return created;
+}
+const codecs = new Map([
+    [noteKind, new PathIdentityCodec()]
+]);
+/** Serialize a note record at `<scope>/<stem>.md` with the given body. */
+function noteFile(scope, stem, body) {
+    const envelope = {
+        id: stem,
+        entityId: `${scope}/${stem}`,
+        kind: 'note',
+        tags: [],
+        links: [],
+        created: 1,
+        updated: 1,
+        seq: 4,
+        contentHash: 'seed',
+        provenance: { source: 'agent' }
+    };
+    const frontmatter = Object.entries(envelope)
+        .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+        .join('\n');
+    return { path: `${scope}/${stem}.md`, contents: joinFrontmatter(frontmatter, body) };
+}
+function mutableRoot(files) {
+    const tree = FileTree.inMemory([...files], { mutable: true }).orThrow();
+    const root = tree.getDirectory('/').orThrow();
+    if (!FileTree.isMutableDirectoryItem(root)) {
+        throw new Error('expected a mutable root directory');
+    }
+    return root;
+}
+describe('FileTreeMemoryStore lenient open (onRecordError)', () => {
+    test('incident: one bad record does not make the whole store unopenable in skip mode', async () => {
+        const files = [
+            noteFile('mtm', 'turn-1', 'valid mtm body'),
+            noteFile('ltm', 'summary', 'valid ltm body'),
+            noteFile('knowledge', 'doc-a', 'valid knowledge body'),
+            // The migrated `claim` converter now rejects the pre-existing record.
+            noteFile('claim', 'claim-1', `${POISON} missing required field`)
+        ];
+        // Default (== 'fail') still fails the whole open, exactly as it did before.
+        expect(FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs
+        })).toFailWith(/POISON/);
+        // 'skip' mode opens: every valid record loads; the bad one is quarantined.
+        const store = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(await store.list()).toSucceedAndSatisfy((listed) => {
+            expect(listed.map((r) => r.envelope.id).sort()).toEqual(['doc-a', 'summary', 'turn-1']);
+        });
+        expect(store.skippedRecords).toHaveLength(1);
+        const skip = store.skippedRecords[0];
+        expect(skip.path).toBe('claim/claim-1.md');
+        expect(skip.scope).toBe('claim');
+        expect(skip.error).toContain('claim/claim-1.md');
+        expect(skip.error).toContain(POISON);
+    });
+    test('default mode is byte-identical to explicit fail mode', () => {
+        const files = [noteFile('note', 'good', 'ok'), noteFile('note', 'bad', POISON)];
+        const asDefault = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs
+        });
+        const asFail = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'fail'
+        });
+        expect(asDefault).toFail();
+        expect(asFail).toFail();
+        // Same exact failure message — the load path is untouched in fail mode.
+        expect(asDefault.isFailure() && asFail.isFailure() && asDefault.message === asFail.message).toBe(true);
+        expect(asDefault).toFailWith(/POISON/);
+    });
+    test('a bad record in a nested scope is skipped while valid siblings load', async () => {
+        const files = [
+            noteFile('alpha/beta', 'ok-1', 'valid'),
+            noteFile('alpha/beta', 'bad-1', POISON),
+            noteFile('alpha/beta/gamma', 'ok-2', 'valid deep')
+        ];
+        const store = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(await store.list()).toSucceedAndSatisfy((listed) => {
+            expect(listed.map((r) => r.envelope.id).sort()).toEqual(['ok-1', 'ok-2']);
+        });
+        expect(store.skippedRecords.map((s) => s.path)).toEqual(['alpha/beta/bad-1.md']);
+        expect(store.skippedRecords[0].scope).toBe('alpha/beta');
+    });
+    test('multiple skips across different scopes all surface; all valid records load', async () => {
+        const files = [
+            noteFile('scope-a', 'good-a', 'a-ok'),
+            noteFile('scope-a', 'bad-a', POISON),
+            noteFile('scope-b', 'good-b', 'b-ok'),
+            noteFile('scope-b', 'bad-b', POISON)
+        ];
+        const store = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(await store.list()).toSucceedAndSatisfy((listed) => {
+            expect(listed.map((r) => r.envelope.id).sort()).toEqual(['good-a', 'good-b']);
+        });
+        expect(store.skippedRecords.map((s) => s.path).sort()).toEqual(['scope-a/bad-a.md', 'scope-b/bad-b.md']);
+    });
+    test('an all-invalid subtree opens with everything skipped (mapSuccess orDefault edge)', async () => {
+        const files = [
+            noteFile('bad-scope', 'x', POISON),
+            noteFile('bad-scope', 'y', POISON),
+            noteFile('good-scope', 'z', 'fine')
+        ];
+        const store = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(await store.list()).toSucceedAndSatisfy((listed) => {
+            expect(listed.map((r) => r.envelope.id)).toEqual(['z']);
+        });
+        expect(store.skippedRecords.map((s) => s.path).sort()).toEqual(['bad-scope/x.md', 'bad-scope/y.md']);
+    });
+    test('an empty vault opens with no skips in either mode', async () => {
+        const skip = FileTreeMemoryStore.create({
+            root: mutableRoot([]),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(await skip.list()).toSucceedWith([]);
+        expect(skip.skippedRecords).toEqual([]);
+        const strict = FileTreeMemoryStore.create({
+            root: mutableRoot([]),
+            registry: registry(poisonRejectingConverter),
+            codecs
+        }).orThrow();
+        expect(strict.skippedRecords).toEqual([]);
+    });
+    test('each skip is logged at warn; with the default NoOpLogger skippedRecords is still populated', async () => {
+        const files = [noteFile('note', 'good', 'ok'), noteFile('note', 'bad', POISON)];
+        const logger = new Logging.InMemoryLogger('warning');
+        const withLogger = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip',
+            logger
+        }).orThrow();
+        expect(withLogger.skippedRecords).toHaveLength(1);
+        expect(logger.logged.some((m) => m.includes('note/bad.md') && m.includes(POISON))).toBe(true);
+        // No logger wired (default NoOpLogger): create still succeeds and the
+        // structured collection is still populated (observable without a logger).
+        const silent = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(silent.skippedRecords.map((s) => s.path)).toEqual(['note/bad.md']);
+    });
+    test('re-open after the converter is fixed re-indexes the quarantined record (non-destructive)', async () => {
+        const files = [noteFile('note', 'good', 'ok'), noteFile('note', 'later', POISON)];
+        const root = mutableRoot(files);
+        // First open with the rejecting converter: the record is quarantined.
+        const before = FileTreeMemoryStore.create({
+            root,
+            registry: registry(poisonRejectingConverter),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(before.skippedRecords).toHaveLength(1);
+        expect(await before.list()).toSucceedAndSatisfy((listed) => {
+            expect(listed.map((r) => r.envelope.id)).toEqual(['good']);
+        });
+        // The file was never deleted or mutated, so a fresh open with the fixed
+        // (accept-all) converter re-indexes it — quarantine is non-destructive.
+        const after = FileTreeMemoryStore.create({
+            root: mutableRoot(files),
+            registry: registry(Converters.string),
+            codecs,
+            onRecordError: 'skip'
+        }).orThrow();
+        expect(after.skippedRecords).toEqual([]);
+        expect(await after.list()).toSucceedAndSatisfy((listed) => {
+            expect(listed.map((r) => r.envelope.id).sort()).toEqual(['good', 'later']);
+        });
+    });
+});
+//# sourceMappingURL=lenientOpen.test.js.map

package/dist/test/unit/store/lenientOpen.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lenientOpen.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/lenientOpen.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport '@fgv/ts-utils-jest';\nimport { Converter, Converters, Logging, Result, fail, succeed } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  BodyConverterRegistry,\n  EntityId,\n  FileTreeMemoryStore,\n  IBodyConverterRegistry,\n  IIdentityCodec,\n  IIdentityCodecResult,\n  IMemoryRecord,\n  ISkippedRecord,\n  Kind,\n  MemoryScopeKey,\n  joinFrontmatter\n} from '../../../index';\n\n/**\n * The incident: one vault holds every kind (mtm, ltm, conversation, knowledge,\n * claim) in ONE store. A required field was added to the `claim` body; every\n * pre-existing `claim` failed validation; and because the initial walk collapsed\n * per-record results with `mapResults` (fail-the-whole-array on any element),\n * every OTHER valid record became unreadable behind the failed open. These tests\n * reproduce that shape (a poison-rejecting body converter standing in for the\n * migrated converter) and pin the lenient (`onRecordError: 'skip'`) behavior.\n */\n\nconst noteKind: Kind = 'note' as Kind;\nconst POISON: string = 'POISON';\n\n/**\n * A permissive identity codec that treats the full `<scope>/<stem>` path as the\n * entity id, so records can live at any nesting depth (the shipped codecs pin a\n * fixed scope shape; this test needs arbitrary-depth scopes to prove the\n * recursion threads skips out of nested subtrees).\n */\nclass PathIdentityCodec implements IIdentityCodec {\n  public encode(entityId: EntityId): Result<IIdentityCodecResult> {\n    const value: string = String(entityId);\n    const cut: number = value.lastIndexOf('/');\n    const scope: MemoryScopeKey = (cut >= 0 ? value.slice(0, cut) : '') as MemoryScopeKey;\n    const idStem: string = cut >= 0 ? value.slice(cut + 1) : value;\n    return succeed({ scope, idStem, isVersioned: false });\n  }\n  public decode(scope: MemoryScopeKey, encodedStem: string): Result<EntityId> {\n    return succeed(`${scope}/${encodedStem}` as EntityId);\n  }\n  public verifyRoundTrip(): Result<true> {\n    return succeed(true);\n  }\n}\n\n/** A body converter that rejects any body containing the poison marker. */\nconst poisonRejectingConverter: Converter<string> = Converters.string.map((body) =>\n  body.includes(POISON) ? fail(`note body rejected: contains ${POISON}`) : succeed(body)\n);\n\nfunction registry(bodyConverter: Converter<string>): IBodyConverterRegistry {\n  const created = BodyConverterRegistry.create().orThrow();\n  created.register(noteKind, bodyConverter);\n  return created;\n}\n\nconst codecs: ReadonlyMap<Kind, IIdentityCodec> = new Map<Kind, IIdentityCodec>([\n  [noteKind, new PathIdentityCodec()]\n]);\n\n/** Serialize a note record at `<scope>/<stem>.md` with the given body. */\nfunction noteFile(scope: string, stem: string, body: string): { path: string; contents: string } {\n  const envelope = {\n    id: stem,\n    entityId: `${scope}/${stem}`,\n    kind: 'note',\n    tags: [],\n    links: [],\n    created: 1,\n    updated: 1,\n    seq: 4,\n    contentHash: 'seed',\n    provenance: { source: 'agent' }\n  };\n  const frontmatter = Object.entries(envelope)\n    .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)\n    .join('\\n');\n  return { path: `${scope}/${stem}.md`, contents: joinFrontmatter(frontmatter, body) };\n}\n\nfunction mutableRoot(\n  files: ReadonlyArray<{ path: string; contents: string }>\n): FileTree.IMutableFileTreeDirectoryItem {\n  const tree = FileTree.inMemory([...files], { mutable: true }).orThrow();\n  const root = tree.getDirectory('/').orThrow();\n  if (!FileTree.isMutableDirectoryItem(root)) {\n    throw new Error('expected a mutable root directory');\n  }\n  return root;\n}\n\ndescribe('FileTreeMemoryStore lenient open (onRecordError)', () => {\n  test('incident: one bad record does not make the whole store unopenable in skip mode', async () => {\n    const files = [\n      noteFile('mtm', 'turn-1', 'valid mtm body'),\n      noteFile('ltm', 'summary', 'valid ltm body'),\n      noteFile('knowledge', 'doc-a', 'valid knowledge body'),\n      // The migrated `claim` converter now rejects the pre-existing record.\n      noteFile('claim', 'claim-1', `${POISON} missing required field`)\n    ];\n\n    // Default (== 'fail') still fails the whole open, exactly as it did before.\n    expect(\n      FileTreeMemoryStore.create({\n        root: mutableRoot(files),\n        registry: registry(poisonRejectingConverter),\n        codecs\n      })\n    ).toFailWith(/POISON/);\n\n    // 'skip' mode opens: every valid record loads; the bad one is quarantined.\n    const store = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n\n    expect(await store.list()).toSucceedAndSatisfy((listed: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(listed.map((r) => r.envelope.id).sort()).toEqual(['doc-a', 'summary', 'turn-1']);\n    });\n    expect(store.skippedRecords).toHaveLength(1);\n    const skip: ISkippedRecord = store.skippedRecords[0];\n    expect(skip.path).toBe('claim/claim-1.md');\n    expect(skip.scope).toBe('claim');\n    expect(skip.error).toContain('claim/claim-1.md');\n    expect(skip.error).toContain(POISON);\n  });\n\n  test('default mode is byte-identical to explicit fail mode', () => {\n    const files = [noteFile('note', 'good', 'ok'), noteFile('note', 'bad', POISON)];\n    const asDefault = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs\n    });\n    const asFail = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'fail'\n    });\n    expect(asDefault).toFail();\n    expect(asFail).toFail();\n    // Same exact failure message — the load path is untouched in fail mode.\n    expect(asDefault.isFailure() && asFail.isFailure() && asDefault.message === asFail.message).toBe(true);\n    expect(asDefault).toFailWith(/POISON/);\n  });\n\n  test('a bad record in a nested scope is skipped while valid siblings load', async () => {\n    const files = [\n      noteFile('alpha/beta', 'ok-1', 'valid'),\n      noteFile('alpha/beta', 'bad-1', POISON),\n      noteFile('alpha/beta/gamma', 'ok-2', 'valid deep')\n    ];\n    const store = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n\n    expect(await store.list()).toSucceedAndSatisfy((listed: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(listed.map((r) => r.envelope.id).sort()).toEqual(['ok-1', 'ok-2']);\n    });\n    expect(store.skippedRecords.map((s) => s.path)).toEqual(['alpha/beta/bad-1.md']);\n    expect(store.skippedRecords[0].scope).toBe('alpha/beta');\n  });\n\n  test('multiple skips across different scopes all surface; all valid records load', async () => {\n    const files = [\n      noteFile('scope-a', 'good-a', 'a-ok'),\n      noteFile('scope-a', 'bad-a', POISON),\n      noteFile('scope-b', 'good-b', 'b-ok'),\n      noteFile('scope-b', 'bad-b', POISON)\n    ];\n    const store = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n\n    expect(await store.list()).toSucceedAndSatisfy((listed: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(listed.map((r) => r.envelope.id).sort()).toEqual(['good-a', 'good-b']);\n    });\n    expect(store.skippedRecords.map((s) => s.path).sort()).toEqual(['scope-a/bad-a.md', 'scope-b/bad-b.md']);\n  });\n\n  test('an all-invalid subtree opens with everything skipped (mapSuccess orDefault edge)', async () => {\n    const files = [\n      noteFile('bad-scope', 'x', POISON),\n      noteFile('bad-scope', 'y', POISON),\n      noteFile('good-scope', 'z', 'fine')\n    ];\n    const store = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n\n    expect(await store.list()).toSucceedAndSatisfy((listed: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(listed.map((r) => r.envelope.id)).toEqual(['z']);\n    });\n    expect(store.skippedRecords.map((s) => s.path).sort()).toEqual(['bad-scope/x.md', 'bad-scope/y.md']);\n  });\n\n  test('an empty vault opens with no skips in either mode', async () => {\n    const skip = FileTreeMemoryStore.create({\n      root: mutableRoot([]),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n    expect(await skip.list()).toSucceedWith([]);\n    expect(skip.skippedRecords).toEqual([]);\n\n    const strict = FileTreeMemoryStore.create({\n      root: mutableRoot([]),\n      registry: registry(poisonRejectingConverter),\n      codecs\n    }).orThrow();\n    expect(strict.skippedRecords).toEqual([]);\n  });\n\n  test('each skip is logged at warn; with the default NoOpLogger skippedRecords is still populated', async () => {\n    const files = [noteFile('note', 'good', 'ok'), noteFile('note', 'bad', POISON)];\n    const logger = new Logging.InMemoryLogger('warning');\n    const withLogger = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip',\n      logger\n    }).orThrow();\n    expect(withLogger.skippedRecords).toHaveLength(1);\n    expect(logger.logged.some((m) => m.includes('note/bad.md') && m.includes(POISON))).toBe(true);\n\n    // No logger wired (default NoOpLogger): create still succeeds and the\n    // structured collection is still populated (observable without a logger).\n    const silent = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n    expect(silent.skippedRecords.map((s) => s.path)).toEqual(['note/bad.md']);\n  });\n\n  test('re-open after the converter is fixed re-indexes the quarantined record (non-destructive)', async () => {\n    const files = [noteFile('note', 'good', 'ok'), noteFile('note', 'later', POISON)];\n    const root = mutableRoot(files);\n\n    // First open with the rejecting converter: the record is quarantined.\n    const before = FileTreeMemoryStore.create({\n      root,\n      registry: registry(poisonRejectingConverter),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n    expect(before.skippedRecords).toHaveLength(1);\n    expect(await before.list()).toSucceedAndSatisfy((listed: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(listed.map((r) => r.envelope.id)).toEqual(['good']);\n    });\n\n    // The file was never deleted or mutated, so a fresh open with the fixed\n    // (accept-all) converter re-indexes it — quarantine is non-destructive.\n    const after = FileTreeMemoryStore.create({\n      root: mutableRoot(files),\n      registry: registry(Converters.string),\n      codecs,\n      onRecordError: 'skip'\n    }).orThrow();\n    expect(after.skippedRecords).toEqual([]);\n    expect(await after.list()).toSucceedAndSatisfy((listed: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(listed.map((r) => r.envelope.id).sort()).toEqual(['good', 'later']);\n    });\n  });\n});\n"]}