@fgv/ts-agent-memory 5.1.0-36

package/lib/test/unit/retrieve/retrievers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrievers.test.js","sourceRoot":"","sources":["../../../../src/test/unit/retrieve/retrievers.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 { Result, fail, succeed } from '@fgv/ts-utils';\nimport {\n  HybridRetriever,\n  IIndexedMemoryRecord,\n  IMemoryQuery,\n  IMemoryRecord,\n  IMemoryRetriever,\n  IMemoryRetrieverCapabilities,\n  IVectorIndex,\n  IVectorQueryHit,\n  Kind,\n  MemoryId,\n  MemoryIndex,\n  MemoryScopeKey,\n  RecencyRetriever,\n  ScoreUnionMergeStrategy,\n  SemanticRetriever,\n  StructuredFilterRetriever,\n  Tag,\n  TagRetriever,\n  envelopeConverter,\n  guardRetrieverCapabilities,\n  limitRecords\n} from '../../../index';\n\ninterface IRecordSpec {\n  readonly id: string;\n  readonly scope?: string;\n  readonly kind?: string;\n  readonly tags?: ReadonlyArray<string>;\n  readonly updated?: number;\n  readonly seq?: number;\n}\n\nfunction makeEntry(spec: IRecordSpec): IIndexedMemoryRecord {\n  const record: IMemoryRecord<unknown> = {\n    envelope: envelopeConverter\n      .convert({\n        id: spec.id,\n        entityId: spec.id,\n        kind: spec.kind ?? 'knowledge',\n        tags: spec.tags ?? [],\n        links: [],\n        created: 0,\n        updated: spec.updated ?? 0,\n        seq: spec.seq ?? 0,\n        contentHash: 'h',\n        provenance: { source: 'agent' }\n      })\n      .orThrow(),\n    body: `body-${spec.id}`\n  };\n  return { scope: (spec.scope ?? 'knowledge') as MemoryScopeKey, record };\n}\n\nfunction buildIndex(specs: ReadonlyArray<IRecordSpec>): MemoryIndex {\n  const index = MemoryIndex.create().orThrow();\n  index.rebuild(specs.map(makeEntry)).orThrow();\n  return index;\n}\n\nfunction ids(records: ReadonlyArray<IMemoryRecord<unknown>>): ReadonlyArray<string> {\n  return records.map((r) => r.envelope.id as string);\n}\n\nconst knowledge: Kind = 'knowledge' as Kind;\n\ndescribe('retrieve helpers', () => {\n  describe('guardRetrieverCapabilities', () => {\n    const noCaps = {\n      supportsSemanticRecall: false,\n      supportsTemporalQuery: false,\n      supportsLinkTraversal: false\n    };\n\n    test('passes when no unsupported capability is requested', () => {\n      expect(guardRetrieverCapabilities({}, noCaps)).toSucceed();\n    });\n\n    test('fails loudly when semantic recall is requested but unsupported', () => {\n      expect(guardRetrieverCapabilities({ semantic: 'q' }, noCaps)).toFailWith(\n        /semantic recall requires a vector index; none configured/i\n      );\n    });\n\n    test('fails loudly when an as-of query is requested but unsupported', () => {\n      expect(guardRetrieverCapabilities({ asOf: 5 }, noCaps)).toFailWith(\n        /temporal query requires temporal index; none configured/i\n      );\n    });\n\n    test('names the kind in the temporal failure when present', () => {\n      expect(guardRetrieverCapabilities({ asOf: 5, kind: knowledge }, noCaps)).toFailWith(\n        /none configured for kind knowledge/i\n      );\n    });\n\n    test('fails loudly when a link-traversal axis is requested but unsupported', () => {\n      expect(guardRetrieverCapabilities({ linkedTo: 'x' as MemoryId }, noCaps)).toFailWith(\n        /link traversal requires a backlink index; none configured/i\n      );\n      expect(guardRetrieverCapabilities({ linkedFrom: 'x' as MemoryId }, noCaps)).toFailWith(\n        /link traversal requires/i\n      );\n      expect(guardRetrieverCapabilities({ hops: 2 }, noCaps)).toFailWith(/link traversal requires/i);\n    });\n\n    test('passes a link-traversal axis when the capability is supported', () => {\n      expect(\n        guardRetrieverCapabilities({ linkedTo: 'x' as MemoryId }, { ...noCaps, supportsLinkTraversal: true })\n      ).toSucceed();\n    });\n  });\n\n  describe('limitRecords', () => {\n    const records = buildIndex([{ id: 'a' }, { id: 'b' }, { id: 'c' }])\n      .entries()\n      .map((e) => e.record);\n\n    test('returns all records when no limit is supplied', () => {\n      expect(limitRecords(records)).toHaveLength(3);\n    });\n\n    test('truncates to the top-N for a positive limit', () => {\n      expect(limitRecords(records, 2)).toHaveLength(2);\n    });\n\n    test('returns an empty array for a zero or negative limit', () => {\n      expect(limitRecords(records, 0)).toEqual([]);\n      expect(limitRecords(records, -1)).toEqual([]);\n    });\n  });\n});\n\ndescribe('RecencyRetriever', () => {\n  test('reports all-false capabilities', () => {\n    const r = RecencyRetriever.create(buildIndex([])).orThrow();\n    expect(r.capabilities).toEqual({\n      supportsSemanticRecall: false,\n      supportsTemporalQuery: false,\n      supportsLinkTraversal: false\n    });\n  });\n\n  test('returns every record most-recently-updated first', async () => {\n    const r = RecencyRetriever.create(\n      buildIndex([\n        { id: 'a', updated: 10 },\n        { id: 'b', updated: 30 },\n        { id: 'c', updated: 20 }\n      ])\n    ).orThrow();\n    expect(await r.retrieve({})).toSucceedAndSatisfy((records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(ids(records)).toEqual(['b', 'c', 'a']);\n    });\n  });\n\n  test('breaks ties on seq descending', async () => {\n    const r = RecencyRetriever.create(\n      buildIndex([\n        { id: 'a', updated: 10, seq: 1 },\n        { id: 'b', updated: 10, seq: 3 },\n        { id: 'c', updated: 10, seq: 2 }\n      ])\n    ).orThrow();\n    expect(await r.retrieve({})).toSucceedAndSatisfy((records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(ids(records)).toEqual(['b', 'c', 'a']);\n    });\n  });\n\n  test('honors scope, kind, tag, predicate, and limit filters', async () => {\n    const index = buildIndex([\n      { id: 'a', scope: 'knowledge', kind: 'knowledge', tags: ['x'], updated: 50 },\n      { id: 'b', scope: 'knowledge', kind: 'knowledge', tags: ['y'], updated: 40 },\n      { id: 'c', scope: 'other', kind: 'knowledge', tags: ['x'], updated: 60 },\n      { id: 'd', scope: 'knowledge', kind: 'note', tags: ['x'], updated: 70 }\n    ]);\n    const r = RecencyRetriever.create(index).orThrow();\n    expect(\n      await r.retrieve({\n        scope: 'knowledge' as MemoryScopeKey,\n        kind: knowledge,\n        tag: 'x' as Tag,\n        filter: (rec) => rec.envelope.id !== ('skip' as MemoryId),\n        limit: 5\n      })\n    ).toSucceedAndSatisfy((records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(ids(records)).toEqual(['a']);\n    });\n  });\n\n  test('limit truncates to the top-N after ordering', async () => {\n    const r = RecencyRetriever.create(\n      buildIndex([\n        { id: 'a', updated: 10 },\n        { id: 'b', updated: 30 },\n        { id: 'c', updated: 20 }\n      ])\n    ).orThrow();\n    expect(await r.retrieve({ limit: 2 })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(ids(records)).toEqual(['b', 'c']);\n      }\n    );\n  });\n\n  test('degrades loudly on a semantic request', async () => {\n    const r = RecencyRetriever.create(buildIndex([{ id: 'a' }])).orThrow();\n    expect(await r.retrieve({ semantic: 'hello' })).toFailWith(/semantic recall requires a vector index/i);\n  });\n\n  test('degrades loudly on a link-traversal request', async () => {\n    const r = RecencyRetriever.create(buildIndex([{ id: 'a' }])).orThrow();\n    expect(await r.retrieve({ linkedTo: 'a' as MemoryId })).toFailWith(/link traversal requires/i);\n  });\n});\n\n/** A retriever with configurable capabilities that records the query it received. */\nclass RecordingRetriever implements IMemoryRetriever {\n  public lastQuery: IMemoryQuery | undefined;\n  public readonly capabilities: IMemoryRetrieverCapabilities;\n  public constructor(capabilities: IMemoryRetrieverCapabilities) {\n    this.capabilities = capabilities;\n  }\n  public retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>> {\n    this.lastQuery = query;\n    return Promise.resolve(succeed([]));\n  }\n}\n\ndescribe('TagRetriever', () => {\n  test('returns records carrying the tag, recency-ordered', async () => {\n    const r = TagRetriever.create(\n      buildIndex([\n        { id: 'a', tags: ['x'], updated: 10 },\n        { id: 'b', tags: ['x', 'y'], updated: 30 },\n        { id: 'c', tags: ['y'], updated: 20 }\n      ])\n    ).orThrow();\n    expect(await r.retrieve({ tag: 'x' as Tag })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(ids(records)).toEqual(['b', 'a']);\n      }\n    );\n  });\n\n  test('returns empty (not failure) when no tag is supplied', async () => {\n    const r = TagRetriever.create(buildIndex([{ id: 'a', tags: ['x'] }])).orThrow();\n    expect(await r.retrieve({})).toSucceedWith([]);\n  });\n\n  test('degrades loudly on a semantic request', async () => {\n    const r = TagRetriever.create(buildIndex([{ id: 'a', tags: ['x'] }])).orThrow();\n    expect(await r.retrieve({ tag: 'x' as Tag, semantic: 'q' })).toFailWith(/semantic recall requires/i);\n  });\n});\n\ndescribe('StructuredFilterRetriever', () => {\n  test('applies the predicate over the scope/kind/tag pre-filter', async () => {\n    const r = StructuredFilterRetriever.create(\n      buildIndex([\n        { id: 'keep-1', updated: 10 },\n        { id: 'drop-1', updated: 30 },\n        { id: 'keep-2', updated: 20 }\n      ])\n    ).orThrow();\n    expect(\n      await r.retrieve({ filter: (rec) => (rec.envelope.id as string).startsWith('keep') })\n    ).toSucceedAndSatisfy((records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(ids(records)).toEqual(['keep-2', 'keep-1']);\n    });\n  });\n\n  test('returns empty (not failure) when no predicate is supplied', async () => {\n    const r = StructuredFilterRetriever.create(buildIndex([{ id: 'a' }])).orThrow();\n    expect(await r.retrieve({})).toSucceedWith([]);\n  });\n});\n\n/** A scripted in-memory vector index returning canned hits. */\nclass FakeVectorIndex implements IVectorIndex {\n  private readonly _hits: ReadonlyArray<IVectorQueryHit>;\n  private readonly _failQuery: boolean;\n  /** The `topK` the most recent `query` call received — asserts forwarding. */\n  public lastTopK: number | undefined;\n  public constructor(hits: ReadonlyArray<IVectorQueryHit>, failQuery: boolean = false) {\n    this._hits = hits;\n    this._failQuery = failQuery;\n  }\n  public add(id: MemoryId): Promise<Result<string>> {\n    return Promise.resolve(succeed(`ref-${id}`));\n  }\n  public remove(id: MemoryId): Promise<Result<MemoryId>> {\n    return Promise.resolve(succeed(id));\n  }\n  public query(__vector: Float32Array, topK: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>> {\n    this.lastTopK = topK;\n    return Promise.resolve(this._failQuery ? fail('vector backend down') : succeed(this._hits));\n  }\n}\n\ndescribe('SemanticRetriever', () => {\n  const okEmbed = (): Promise<Result<Float32Array>> =>\n    Promise.resolve(succeed(Float32Array.from([0.1, 0.2])));\n\n  test('reports supportsSemanticRecall=false when no backend is wired', () => {\n    const r = SemanticRetriever.create({ index: buildIndex([]) }).orThrow();\n    expect(r.capabilities.supportsSemanticRecall).toBe(false);\n  });\n\n  test('reports supportsSemanticRecall=true when a backend is wired', () => {\n    const r = SemanticRetriever.create({\n      index: buildIndex([]),\n      backend: { vectorIndex: new FakeVectorIndex([]), embedQuery: okEmbed }\n    }).orThrow();\n    expect(r.capabilities.supportsSemanticRecall).toBe(true);\n  });\n\n  test('degrades loudly on a semantic request when no backend is wired', async () => {\n    const r = SemanticRetriever.create({ index: buildIndex([{ id: 'a' }]) }).orThrow();\n    expect(await r.retrieve({ semantic: 'hi' })).toFailWith(\n      /semantic recall requires a vector index; none configured/i\n    );\n  });\n\n  test('returns empty (not failure) when no semantic term is supplied', async () => {\n    const r = SemanticRetriever.create({ index: buildIndex([{ id: 'a' }]) }).orThrow();\n    expect(await r.retrieve({})).toSucceedWith([]);\n  });\n\n  test('degrades loudly on an as-of request', async () => {\n    const r = SemanticRetriever.create({ index: buildIndex([{ id: 'a' }]) }).orThrow();\n    expect(await r.retrieve({ asOf: 5 })).toFailWith(/temporal query requires temporal index/i);\n  });\n\n  test('resolves vector hits back to records in hit order', async () => {\n    const index = buildIndex([\n      { id: 'a', updated: 1 },\n      { id: 'b', updated: 99 },\n      { id: 'c', updated: 50 }\n    ]);\n    const r = SemanticRetriever.create({\n      index,\n      backend: {\n        vectorIndex: new FakeVectorIndex([\n          { id: 'b' as MemoryId, score: 0.9 },\n          { id: 'a' as MemoryId, score: 0.5 }\n        ]),\n        embedQuery: okEmbed\n      }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q' })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        // Hit order preserved (b before a), NOT recency order.\n        expect(ids(records)).toEqual(['b', 'a']);\n      }\n    );\n  });\n\n  test('drops hits not present in the index and applies query filters', async () => {\n    const index = buildIndex([\n      { id: 'a', tags: ['x'] },\n      { id: 'b', tags: ['y'] }\n    ]);\n    const r = SemanticRetriever.create({\n      index,\n      backend: {\n        vectorIndex: new FakeVectorIndex([\n          { id: 'gone' as MemoryId, score: 0.99 },\n          { id: 'b' as MemoryId, score: 0.8 },\n          { id: 'a' as MemoryId, score: 0.7 }\n        ]),\n        embedQuery: okEmbed\n      }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q', tag: 'x' as Tag })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(ids(records)).toEqual(['a']);\n      }\n    );\n  });\n\n  test('forwards topK to the vector index and applies the post-filter limit', async () => {\n    const index = buildIndex([{ id: 'a' }, { id: 'b' }, { id: 'c' }]);\n    const vectorIndex = new FakeVectorIndex([\n      { id: 'a' as MemoryId, score: 0.9 },\n      { id: 'b' as MemoryId, score: 0.8 },\n      { id: 'c' as MemoryId, score: 0.7 }\n    ]);\n    const r = SemanticRetriever.create({ index, backend: { vectorIndex, embedQuery: okEmbed } }).orThrow();\n    expect(await r.retrieve({ semantic: 'q', topK: 2, limit: 2 })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(ids(records)).toEqual(['a', 'b']);\n      }\n    );\n    // The retriever must forward the caller's topK to the vector backend, not its default.\n    expect(vectorIndex.lastTopK).toBe(2);\n  });\n\n  test('defaults topK to 10 when the query omits it', async () => {\n    const vectorIndex = new FakeVectorIndex([{ id: 'a' as MemoryId, score: 0.9 }]);\n    const r = SemanticRetriever.create({\n      index: buildIndex([{ id: 'a' }]),\n      backend: { vectorIndex, embedQuery: okEmbed }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q' })).toSucceed();\n    expect(vectorIndex.lastTopK).toBe(10);\n  });\n\n  test('fails loudly when the embedder fails', async () => {\n    const r = SemanticRetriever.create({\n      index: buildIndex([{ id: 'a' }]),\n      backend: {\n        vectorIndex: new FakeVectorIndex([]),\n        embedQuery: () => Promise.resolve(fail('no embed model'))\n      }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q' })).toFailWith(/query embedding failed: no embed model/i);\n  });\n\n  test('fails loudly when the vector backend fails', async () => {\n    const r = SemanticRetriever.create({\n      index: buildIndex([{ id: 'a' }]),\n      backend: { vectorIndex: new FakeVectorIndex([], true), embedQuery: okEmbed }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q' })).toFailWith(/vector query failed: vector backend down/i);\n  });\n\n  test('normalizes a rejecting embedder into a Failure (never escapes as a rejection)', async () => {\n    const r = SemanticRetriever.create({\n      index: buildIndex([{ id: 'a' }]),\n      backend: {\n        vectorIndex: new FakeVectorIndex([]),\n        embedQuery: () => Promise.reject(new Error('embedder blew up'))\n      }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q' })).toFailWith(/query embedding failed: .*embedder blew up/i);\n  });\n\n  test('normalizes a rejecting vector backend into a Failure', async () => {\n    // A vector index whose `query` rejects (throws) rather than returning a fail.\n    const rejectingIndex: IVectorIndex = {\n      add: (id: MemoryId) => Promise.resolve(succeed(`ref-${id}`)),\n      remove: (id: MemoryId) => Promise.resolve(succeed(id)),\n      query: () => Promise.reject(new Error('socket hangup'))\n    };\n    const r = SemanticRetriever.create({\n      index: buildIndex([{ id: 'a' }]),\n      backend: { vectorIndex: rejectingIndex, embedQuery: okEmbed }\n    }).orThrow();\n    expect(await r.retrieve({ semantic: 'q' })).toFailWith(/vector query failed: .*socket hangup/i);\n  });\n});\n\ndescribe('ScoreUnionMergeStrategy', () => {\n  test('unions, dedupes by id, and scores by retriever count', () => {\n    const strategy = ScoreUnionMergeStrategy.create().orThrow();\n    const [a, b, c] = [\n      makeEntry({ id: 'a', updated: 10 }).record,\n      makeEntry({ id: 'b', updated: 30 }).record,\n      makeEntry({ id: 'c', updated: 20 }).record\n    ];\n    // 'b' appears in two sets (score 2); 'a' and 'c' in one each (score 1) — among\n    // score-1 records, recency breaks the tie (c.updated 20 > a.updated 10).\n    expect(\n      strategy.merge([\n        [a, b],\n        [b, c]\n      ])\n    ).toSucceedAndSatisfy((records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n      expect(ids(records)).toEqual(['b', 'c', 'a']);\n    });\n  });\n\n  test('counts an id at most once per result set', () => {\n    const strategy = ScoreUnionMergeStrategy.create().orThrow();\n    const a = makeEntry({ id: 'a', updated: 10 }).record;\n    const b = makeEntry({ id: 'b', updated: 5 }).record;\n    // 'a' twice in one set still scores 1; 'b' in two sets scores 2 → b ranks first.\n    expect(strategy.merge([[a, a], [b], [b]])).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(ids(records)).toEqual(['b', 'a']);\n      }\n    );\n  });\n});\n\ndescribe('HybridRetriever', () => {\n  function build(): { index: MemoryIndex } {\n    return {\n      index: buildIndex([\n        { id: 'a', tags: ['x'], updated: 10 },\n        { id: 'b', tags: ['y'], updated: 30 },\n        { id: 'c', tags: ['x'], updated: 20 }\n      ])\n    };\n  }\n\n  test('requires at least one retriever', () => {\n    const strategy = ScoreUnionMergeStrategy.create().orThrow();\n    expect(HybridRetriever.create([], strategy)).toFailWith(/at least one retriever is required/i);\n  });\n\n  test('capabilities are the union of composed retrievers', () => {\n    const { index } = build();\n    const recency = RecencyRetriever.create(index).orThrow();\n    const semantic = SemanticRetriever.create({\n      index,\n      backend: {\n        vectorIndex: new FakeVectorIndex([]),\n        embedQuery: () => Promise.resolve(succeed(Float32Array.from([1])))\n      }\n    }).orThrow();\n    const hybrid = HybridRetriever.create(\n      [recency, semantic],\n      ScoreUnionMergeStrategy.create().orThrow()\n    ).orThrow();\n    expect(hybrid.capabilities).toEqual({\n      supportsSemanticRecall: true,\n      supportsTemporalQuery: false,\n      supportsLinkTraversal: false\n    });\n  });\n\n  test('merges the results of composed retrievers', async () => {\n    const { index } = build();\n    const recency = RecencyRetriever.create(index).orThrow();\n    const tag = TagRetriever.create(index).orThrow();\n    const hybrid = HybridRetriever.create(\n      [recency, tag],\n      ScoreUnionMergeStrategy.create().orThrow()\n    ).orThrow();\n    // recency returns a,b,c (with tag x filter: a,c); tag x returns a,c. Both\n    // surface a & c (score 2), b absent. Use tag:x so recency also filters to x.\n    expect(await hybrid.retrieve({ tag: 'x' as Tag })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect([...ids(records)].sort()).toEqual(['a', 'c']);\n      }\n    );\n  });\n\n  test('routes a semantic query only to the semantic-capable child', async () => {\n    const { index } = build();\n    const recency = RecencyRetriever.create(index).orThrow();\n    const semantic = SemanticRetriever.create({\n      index,\n      backend: {\n        vectorIndex: new FakeVectorIndex([{ id: 'b' as MemoryId, score: 0.9 }]),\n        embedQuery: () => Promise.resolve(succeed(Float32Array.from([1])))\n      }\n    }).orThrow();\n    const hybrid = HybridRetriever.create(\n      [recency, semantic],\n      ScoreUnionMergeStrategy.create().orThrow()\n    ).orThrow();\n    // recency (no semantic support) gets the semantic field stripped → returns all\n    // three; semantic returns just b. b therefore scores 2 and ranks first.\n    expect(await hybrid.retrieve({ semantic: 'q' })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(records[0].envelope.id).toBe('b');\n        expect([...ids(records)].sort()).toEqual(['a', 'b', 'c']);\n      }\n    );\n  });\n\n  test('routes link-traversal axes only to the link-capable child', async () => {\n    const linkChild = new RecordingRetriever({\n      supportsSemanticRecall: false,\n      supportsTemporalQuery: false,\n      supportsLinkTraversal: true\n    });\n    const plainChild = new RecordingRetriever({\n      supportsSemanticRecall: false,\n      supportsTemporalQuery: false,\n      supportsLinkTraversal: false\n    });\n    const hybrid = HybridRetriever.create(\n      [linkChild, plainChild],\n      ScoreUnionMergeStrategy.create().orThrow()\n    ).orThrow();\n    expect(hybrid.capabilities.supportsLinkTraversal).toBe(true);\n    // Union supports link traversal, so the hybrid does NOT loud-fail.\n    expect(await hybrid.retrieve({ linkedTo: 'a' as MemoryId, hops: 2 })).toSucceed();\n    // The link-capable child keeps the axes; the plain child has them stripped.\n    expect(linkChild.lastQuery?.linkedTo).toBe('a');\n    expect(linkChild.lastQuery?.hops).toBe(2);\n    expect(plainChild.lastQuery?.linkedTo).toBeUndefined();\n    expect(plainChild.lastQuery?.hops).toBeUndefined();\n  });\n\n  test('degrades loudly when its union does not support a requested capability', async () => {\n    const { index } = build();\n    const recency = RecencyRetriever.create(index).orThrow();\n    const hybrid = HybridRetriever.create([recency], ScoreUnionMergeStrategy.create().orThrow()).orThrow();\n    expect(await hybrid.retrieve({ semantic: 'q' })).toFailWith(/semantic recall requires/i);\n  });\n\n  test('propagates a child failure rather than dropping it silently', async () => {\n    const { index } = build();\n    const semantic = SemanticRetriever.create({\n      index,\n      backend: {\n        vectorIndex: new FakeVectorIndex([], true),\n        embedQuery: () => Promise.resolve(succeed(Float32Array.from([1])))\n      }\n    }).orThrow();\n    const hybrid = HybridRetriever.create([semantic], ScoreUnionMergeStrategy.create().orThrow()).orThrow();\n    expect(await hybrid.retrieve({ semantic: 'q' })).toFailWith(/vector query failed/i);\n  });\n\n  test('does not pre-truncate child result sets: limit is applied only post-merge', async () => {\n    // Recency full order is [d,c,b,a]; semantic surfaces [d,a]. With a correct\n    // (post-merge-only) limit, the merge sees BOTH full sets, so d and a each\n    // score 2 and the limit-2 result is [d,a]. If the limit leaked into the\n    // children, recency would pre-truncate to [d,c] and the result would wrongly\n    // be [d,c] — a never reaching the merge to score 2.\n    const index = buildIndex([\n      { id: 'a', updated: 10 },\n      { id: 'b', updated: 20 },\n      { id: 'c', updated: 30 },\n      { id: 'd', updated: 40 }\n    ]);\n    const recency = RecencyRetriever.create(index).orThrow();\n    const semantic = SemanticRetriever.create({\n      index,\n      backend: {\n        vectorIndex: new FakeVectorIndex([\n          { id: 'd' as MemoryId, score: 0.9 },\n          { id: 'a' as MemoryId, score: 0.8 }\n        ]),\n        embedQuery: () => Promise.resolve(succeed(Float32Array.from([1])))\n      }\n    }).orThrow();\n    const hybrid = HybridRetriever.create(\n      [recency, semantic],\n      ScoreUnionMergeStrategy.create().orThrow()\n    ).orThrow();\n    expect(await hybrid.retrieve({ semantic: 'q', limit: 2 })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(ids(records)).toEqual(['d', 'a']);\n      }\n    );\n  });\n\n  test('applies the hybrid-level limit after merge', async () => {\n    const { index } = build();\n    const recency = RecencyRetriever.create(index).orThrow();\n    const hybrid = HybridRetriever.create([recency], ScoreUnionMergeStrategy.create().orThrow()).orThrow();\n    expect(await hybrid.retrieve({ limit: 1 })).toSucceedAndSatisfy(\n      (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(records).toHaveLength(1);\n        expect(records[0].envelope.id).toBe('b');\n      }\n    );\n  });\n});\n"]}

package/lib/test/unit/store/embedOnWrite.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=embedOnWrite.test.d.ts.map

package/lib/test/unit/store/embedOnWrite.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedOnWrite.test.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/store/embedOnWrite.test.ts"],"names":[],"mappings":"AAKA,OAAO,oBAAoB,CAAC"}

package/lib/test/unit/store/embedOnWrite.test.js

@@ -0,0 +1,262 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@fgv/ts-utils-jest");
+const ts_utils_1 = require("@fgv/ts-utils");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const index_1 = require("../../../index");
+const knowledgeKind = 'knowledge';
+const mtmKind = 'mtm';
+function mutableRoot() {
+    const tree = ts_json_base_1.FileTree.inMemory([], { mutable: true }).orThrow();
+    const root = tree.getDirectory('/').orThrow();
+    if (!ts_json_base_1.FileTree.isMutableDirectoryItem(root)) {
+        throw new Error('expected a mutable root directory');
+    }
+    return root;
+}
+function makeRecord(id, body, kind = 'knowledge', entityId) {
+    return {
+        envelope: index_1.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 embedder (no network). Counts occurrences of three
+ * marker words, so a record's vector and a query's vector live in the same space
+ * and cosine ordering is fully predictable.
+ */
+const MARKERS = ['cat', 'dog', 'fish'];
+function featureVector(text) {
+    const lower = text.toLowerCase();
+    return Float32Array.from(MARKERS.map((m) => lower.split(m).length - 1));
+}
+const recordEmbed = (r) => 
+// A real embedder receives an `IMemoryRecord<unknown>` and must validate the
+// body through a Converter rather than casting — this models that idiom.
+Promise.resolve(ts_utils_1.Converters.string
+    .convert(r.body)
+    .withErrorFormat((msg) => `cannot embed: body is not a string: ${msg}`)
+    .onSuccess((body) => (0, ts_utils_1.succeed)(featureVector(body))));
+const queryEmbed = (text) => Promise.resolve((0, ts_utils_1.succeed)(featureVector(text)));
+/** Records add/remove call order and can be configured to fail either op. */
+class SpyVectorIndex {
+    constructor() {
+        this.calls = [];
+        this.failAdd = false;
+        this.failRemove = false;
+        this._inner = index_1.InMemoryCosineIndex.create().orThrow();
+    }
+    async add(id, vector) {
+        this.calls.push(`add:${id}`);
+        return this.failAdd ? (0, ts_utils_1.fail)('add boom') : this._inner.add(id, vector);
+    }
+    async remove(id) {
+        this.calls.push(`remove:${id}`);
+        return this.failRemove ? (0, ts_utils_1.fail)('remove boom') : this._inner.remove(id);
+    }
+    query(vector, topK) {
+        return this._inner.query(vector, topK);
+    }
+}
+function knowledgeStore(vectorIndex, embed, logger) {
+    const registry = index_1.BodyConverterRegistry.create().orThrow();
+    registry.register(knowledgeKind, ts_utils_1.Converters.string);
+    return index_1.FileTreeMemoryStore.create({
+        root: mutableRoot(),
+        registry,
+        codecs: new Map([[knowledgeKind, new index_1.KnowledgeIdentityCodec()]]),
+        vectorIndex,
+        embed,
+        logger
+    }).orThrow();
+}
+describe('FileTreeMemoryStore embed-on-write', () => {
+    describe('when wired', () => {
+        test('embeds on write, stamps embeddingRef, and indexes the vector', async () => {
+            const index = index_1.InMemoryCosineIndex.create().orThrow();
+            const store = knowledgeStore(index, recordEmbed);
+            expect(await store.put(makeRecord('doc-a', 'cat cat'))).toSucceedAndSatisfy((record) => {
+                // InMemoryCosineIndex keys entries by id, so the ref IS the id.
+                expect(record.envelope.embeddingRef).toBe('doc-a');
+            });
+            expect(index.size).toBe(1);
+            // The persisted file carries the embeddingRef (round-trips through disk).
+            expect(await store.getById('knowledge', 'doc-a')).toSucceedAndSatisfy((record) => {
+                expect(record === null || record === void 0 ? void 0 : record.envelope.embeddingRef).toBe('doc-a');
+            });
+            // The vector is queryable.
+            expect(await index.query(featureVector('cat'), 1)).toSucceedAndSatisfy((hits) => {
+                expect(hits[0].id).toBe('doc-a');
+            });
+        });
+        test('re-embeds on a content change by re-adding (replace semantics, no eager remove)', async () => {
+            const spy = new SpyVectorIndex();
+            const store = knowledgeStore(spy, recordEmbed);
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            (await store.put(makeRecord('doc-a', 'dog'))).orThrow();
+            // The content change re-adds (IVectorIndex.add replaces for a same id) —
+            // no redundant eager remove.
+            expect(spy.calls).toEqual(['add:doc-a', 'add:doc-a']);
+            // The index now reflects the new content ('dog'), not the original.
+            expect(await spy.query(featureVector('dog'), 1)).toSucceedAndSatisfy((hits) => {
+                expect(hits[0].score).toBeCloseTo(1);
+            });
+        });
+        test('does not re-embed a dedup no-op (identical content)', async () => {
+            const spy = new SpyVectorIndex();
+            const store = knowledgeStore(spy, recordEmbed);
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            // The second identical put is a content-dedup no-op — no second embedding.
+            expect(spy.calls).toEqual(['add:doc-a']);
+        });
+        test('removes the vector on delete', async () => {
+            const spy = new SpyVectorIndex();
+            const store = knowledgeStore(spy, recordEmbed);
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            expect(await store.delete(knowledgeKind, 'doc-a')).toSucceedWith('doc-a');
+            expect(spy.calls).toEqual(['add:doc-a', 'remove:doc-a']);
+            expect(await spy.query(featureVector('cat'), 5)).toSucceedWith([]);
+        });
+        test('removes evicted vectors on cap-cull eviction', async () => {
+            const index = index_1.InMemoryCosineIndex.create().orThrow();
+            const capCull = index_1.MemoryCapCullPolicy.create({
+                maxRecords: 2,
+                mutableFields: ['body', 'tags', 'links', 'provenance', 'embeddingRef']
+            }).orThrow();
+            const registry = index_1.BodyConverterRegistry.create().orThrow();
+            registry.register(mtmKind, ts_utils_1.Converters.string);
+            const store = index_1.FileTreeMemoryStore.create({
+                root: mutableRoot(),
+                registry,
+                codecs: new Map([[mtmKind, new index_1.MtmIdentityCodec()]]),
+                writePolicies: new Map([[mtmKind, capCull]]),
+                vectorIndex: index,
+                embed: recordEmbed
+            }).orThrow();
+            // Distinct bodies so each gets a distinct vector; maxRecords=2 evicts the
+            // oldest on the third write.
+            (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 was evicted from the store AND the vector index.
+            expect(index.size).toBe(2);
+            expect(await index.query(featureVector('cat'), 5)).toSucceedAndSatisfy((hits) => {
+                expect(hits.map((h) => h.id)).not.toContain('turn-0');
+            });
+        });
+        test('persists the record (best-effort) and logs when embedding fails', async () => {
+            const index = index_1.InMemoryCosineIndex.create().orThrow();
+            const logger = new ts_utils_1.Logging.InMemoryLogger();
+            const failEmbed = () => Promise.resolve((0, ts_utils_1.fail)('no model'));
+            const store = knowledgeStore(index, failEmbed, logger);
+            // The durable write succeeds; only the derived index is skipped (rebuildable).
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy((record) => {
+                expect(record.envelope.embeddingRef).toBeUndefined();
+            });
+            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.size).toBe(0);
+            expect(logger.logged.some((m) => /embedding 'doc-a' failed.*no model/i.test(m))).toBe(true);
+        });
+        test('persists the record (best-effort) and logs when the vector add fails', async () => {
+            const spy = new SpyVectorIndex();
+            spy.failAdd = true;
+            const logger = new ts_utils_1.Logging.InMemoryLogger();
+            const store = knowledgeStore(spy, recordEmbed, logger);
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy((record) => {
+                expect(record.envelope.embeddingRef).toBeUndefined();
+            });
+            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) => /vector add for 'doc-a' failed.*add boom/i.test(m))).toBe(true);
+        });
+        test('best-effort embed survives a throwing/rejecting embedder', async () => {
+            const index = index_1.InMemoryCosineIndex.create().orThrow();
+            const logger = new ts_utils_1.Logging.InMemoryLogger();
+            const throwingEmbed = () => Promise.reject(new Error('embedder kaboom'));
+            const store = knowledgeStore(index, throwingEmbed, logger);
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();
+            expect(index.size).toBe(0);
+            expect(logger.logged.some((m) => /embedding 'doc-a' threw.*embedder kaboom/i.test(m))).toBe(true);
+        });
+        test('a committed delete succeeds (best-effort) and logs when vector removal fails', async () => {
+            const spy = new SpyVectorIndex();
+            const logger = new ts_utils_1.Logging.InMemoryLogger();
+            const store = knowledgeStore(spy, recordEmbed, logger);
+            (await store.put(makeRecord('doc-a', 'cat'))).orThrow();
+            spy.failRemove = true;
+            // The record is already gone; vector cleanup failure must NOT fail the delete.
+            expect(await store.delete(knowledgeKind, 'doc-a')).toSucceedWith('doc-a');
+            expect(await store.getById('knowledge', 'doc-a')).toSucceedWith(undefined);
+            expect(logger.logged.some((m) => /vector removal for 'doc-a' failed.*remove boom/i.test(m))).toBe(true);
+        });
+    });
+    describe('when unwired', () => {
+        test('a store without a vector index or embedder leaves embeddingRef unset', async () => {
+            const store = knowledgeStore();
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy((record) => {
+                expect(record.envelope.embeddingRef).toBeUndefined();
+            });
+        });
+        test('a vector index without an embedder is fully inert (no add or remove)', async () => {
+            const spy = new SpyVectorIndex();
+            const store = knowledgeStore(spy, undefined);
+            expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy((record) => {
+                expect(record.envelope.embeddingRef).toBeUndefined();
+            });
+            // The vector lifecycle is wholly off without an embedder: neither put nor
+            // delete touches the index (a remove would target a record never embedded).
+            (await store.delete(knowledgeKind, 'doc-a')).orThrow();
+            expect(spy.calls).toEqual([]);
+        });
+    });
+    describe('semantic recall end-to-end', () => {
+        test('a wired store + InMemoryCosineIndex + SemanticRetriever returns cosine top-k', async () => {
+            const index = index_1.InMemoryCosineIndex.create().orThrow();
+            const store = knowledgeStore(index, recordEmbed);
+            (await store.put(makeRecord('cats', 'cat cat cat'))).orThrow();
+            (await store.put(makeRecord('dogs', 'dog dog dog'))).orThrow();
+            (await store.put(makeRecord('fishes', 'fish fish fish'))).orThrow();
+            // SemanticRetriever takes an IMemoryIndex separate from the store (the
+            // store's derived index is private and the two are intentionally
+            // decoupled), so build a record index mirroring the store — keyed by the
+            // shared vectorIndex instance — for hit hydration.
+            const listed = (await store.list()).orThrow();
+            const recordIndex = index_1.MemoryIndex.create().orThrow();
+            recordIndex
+                .rebuild(listed.map((record) => ({ scope: 'knowledge', record })))
+                .orThrow();
+            const retriever = index_1.SemanticRetriever.create({
+                index: recordIndex,
+                backend: { vectorIndex: index, embedQuery: queryEmbed }
+            }).orThrow();
+            expect(retriever.capabilities.supportsSemanticRecall).toBe(true);
+            expect(await retriever.retrieve({ semantic: 'cat', topK: 2 })).toSucceedAndSatisfy((records) => {
+                // 'cats' is the closest; 'dogs'/'fishes' are orthogonal (cosine 0) so
+                // only the cat record ranks above them — it is first.
+                expect(records[0].envelope.id).toBe('cats');
+            });
+        });
+    });
+});
+//# sourceMappingURL=embedOnWrite.test.js.map

package/lib/test/unit/store/embedOnWrite.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedOnWrite.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/embedOnWrite.test.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,8BAA4B;AAC5B,4CAA2E;AAC3E,oDAA6C;AAC7C,0CAqBwB;AAExB,MAAM,aAAa,GAAS,WAAmB,CAAC;AAChD,MAAM,OAAO,GAAS,KAAa,CAAC;AAEpC,SAAS,WAAW;IAClB,MAAM,IAAI,GAAG,uBAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9C,IAAI,CAAC,uBAAQ,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CACjB,EAAU,EACV,IAAY,EACZ,OAAe,WAAW,EAC1B,QAAiB;IAEjB,OAAO;QACL,QAAQ,EAAE,yBAAiB;aACxB,OAAO,CAAC;YACP,EAAE;YACF,QAAQ,EAAE,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE;YACxB,IAAI;YACJ,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,CAAC;YACN,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SAChC,CAAC;aACD,OAAO,EAAE;QACZ,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,GAA0B,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC9D,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAW,IAAI,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AACD,MAAM,WAAW,GAAG,CAAC,CAAyB,EAAiC,EAAE;AAC/E,6EAA6E;AAC7E,yEAAyE;AACzE,OAAO,CAAC,OAAO,CACb,qBAAU,CAAC,MAAM;KACd,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;KACf,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uCAAuC,GAAG,EAAE,CAAC;KACtE,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,kBAAO,EAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CACrD,CAAC;AACJ,MAAM,UAAU,GAAG,CAAC,IAAY,EAAiC,EAAE,CACjE,OAAO,CAAC,OAAO,CAAC,IAAA,kBAAO,EAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,cAAc;IAApB;QACkB,UAAK,GAAa,EAAE,CAAC;QAC9B,YAAO,GAAY,KAAK,CAAC;QACzB,eAAU,GAAY,KAAK,CAAC;QAClB,WAAM,GAAwB,2BAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IAaxF,CAAC;IAXQ,KAAK,CAAC,GAAG,CAAC,EAAY,EAAE,MAAoB;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,eAAI,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IACM,KAAK,CAAC,MAAM,CAAC,EAAY;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAA,eAAI,EAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACM,KAAK,CAAC,MAAoB,EAAE,IAAY;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;CACF;AAED,SAAS,cAAc,CACrB,WAA0B,EAC1B,KAAoE,EACpE,MAAwB;IAExB,MAAM,QAAQ,GAA2B,6BAAqB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAU,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,2BAAmB,CAAC,MAAM,CAAC;QAChC,IAAI,EAAE,WAAW,EAAE;QACnB,QAAQ;QACR,MAAM,EAAE,IAAI,GAAG,CAAuB,CAAC,CAAC,aAAa,EAAE,IAAI,8BAAsB,EAAE,CAAC,CAAC,CAAC;QACtF,WAAW;QACX,KAAK;QACL,MAAM;KACP,CAAC,CAAC,OAAO,EAAE,CAAC;AACf,CAAC;AAED,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;YAC9E,MAAM,KAAK,GAAG,2BAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACzE,CAAC,MAA8B,EAAE,EAAE;gBACjC,gEAAgE;gBAChE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrD,CAAC,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,0EAA0E;YAC1E,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,WAA6B,EAAE,OAAmB,CAAC,CAAC,CAAC,mBAAmB,CACjG,CAAC,MAA0C,EAAE,EAAE;gBAC7C,MAAM,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtD,CAAC,CACF,CAAC;YACF,2BAA2B;YAC3B,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACpE,CAAC,IAAoC,EAAE,EAAE;gBACvC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;YACjG,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC/C,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,yEAAyE;YACzE,6BAA6B;YAC7B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;YACtD,oEAAoE;YACpE,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAClE,CAAC,IAAoC,EAAE,EAAE;gBACvC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC/C,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,2EAA2E;YAC3E,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC/C,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,OAA8B,CAAC,CAAC,CAAC,aAAa,CACrF,OAAmB,CACpB,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,KAAK,GAAG,2BAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,OAAO,GAAiB,2BAAmB,CAAC,MAAM,CAAC;gBACvD,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC;aACvE,CAAC,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,QAAQ,GAA2B,6BAAqB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YAClF,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAU,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,2BAAmB,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,WAAW,EAAE;gBACnB,QAAQ;gBACR,MAAM,EAAE,IAAI,GAAG,CAAuB,CAAC,CAAC,OAAO,EAAE,IAAI,wBAAgB,EAAE,CAAC,CAAC,CAAC;gBAC1E,aAAa,EAAE,IAAI,GAAG,CAAqB,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAChE,WAAW,EAAE,KAAK;gBAClB,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC,OAAO,EAAE,CAAC;YAEb,0EAA0E;YAC1E,6BAA6B;YAC7B,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5E,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5E,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7E,0DAA0D;YAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACpE,CAAC,IAAoC,EAAE,EAAE;gBACvC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxD,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;YACjF,MAAM,KAAK,GAAG,2BAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,kBAAO,CAAC,cAAc,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,GAAkC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAA,eAAI,EAAC,UAAU,CAAC,CAAC,CAAC;YACzF,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACvD,+EAA+E;YAC/E,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACrE,CAAC,MAA8B,EAAE,EAAE;gBACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;YACvD,CAAC,CACF,CAAC;YACF,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,WAA6B,EAAE,OAAmB,CAAC,CAAC,CAAC,mBAAmB,CACjG,CAAC,MAA0C,EAAE,EAAE;gBAC7C,MAAM,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qCAAqC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;YACtF,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,kBAAO,CAAC,cAAc,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACrE,CAAC,MAA8B,EAAE,EAAE;gBACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;YACvD,CAAC,CACF,CAAC;YACF,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,WAA6B,EAAE,OAAmB,CAAC,CAAC,CAAC,mBAAmB,CACjG,CAAC,MAA0C,EAAE,EAAE;gBAC7C,MAAM,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC,CACF,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,0CAA0C,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnG,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,KAAK,GAAG,2BAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,kBAAO,CAAC,cAAc,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,GAAkC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACxG,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAChE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,2CAA2C,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpG,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;YAC9F,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,kBAAO,CAAC,cAAc,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YACvD,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACxD,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;YACtB,+EAA+E;YAC/E,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,OAA8B,CAAC,CAAC,CAAC,aAAa,CACrF,OAAmB,CACpB,CAAC;YACF,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,WAA6B,EAAE,OAAmB,CAAC,CAAC,CAAC,aAAa,CAC3F,SAAS,CACV,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iDAAiD,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1G,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,IAAI,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;YACtF,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;YAC/B,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACrE,CAAC,MAA8B,EAAE,EAAE;gBACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;YACvD,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;YACtF,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CACrE,CAAC,MAA8B,EAAE,EAAE;gBACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;YACvD,CAAC,CACF,CAAC;YACF,0EAA0E;YAC1E,4EAA4E;YAC5E,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,OAA8B,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC9E,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,IAAI,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;YAC9F,MAAM,KAAK,GAAG,2BAAmB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YACjD,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/D,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/D,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAEpE,uEAAuE;YACvE,iEAAiE;YACjE,yEAAyE;YACzE,mDAAmD;YACnD,MAAM,MAAM,GAA0C,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACrF,MAAM,WAAW,GAAG,mBAAW,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACnD,WAAW;iBACR,OAAO,CACN,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAwB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,WAA6B,EAAE,MAAM,EAAE,CAAC,CAAC,CACjG;iBACA,OAAO,EAAE,CAAC;YAEb,MAAM,SAAS,GAAG,yBAAiB,CAAC,MAAM,CAAC;gBACzC,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE;aACxD,CAAC,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjE,MAAM,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAChF,CAAC,OAA8C,EAAE,EAAE;gBACjD,sEAAsE;gBACtE,sDAAsD;gBACtD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","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  FileTreeMemoryStore,\n  IBodyConverterRegistry,\n  IIdentityCodec,\n  IIndexedMemoryRecord,\n  IMemoryRecord,\n  IVectorIndex,\n  IVectorQueryHit,\n  InMemoryCosineIndex,\n  Kind,\n  KnowledgeIdentityCodec,\n  MemoryCapCullPolicy,\n  EntityId,\n  MemoryId,\n  MemoryIndex,\n  MemoryScopeKey,\n  MtmIdentityCodec,\n  IWritePolicy,\n  SemanticRetriever,\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/**\n * Deterministic keyword-count embedder (no network). Counts occurrences of three\n * marker words, so a record's vector and a query's vector live in the same space\n * and cosine ordering is fully predictable.\n */\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}\nconst recordEmbed = (r: IMemoryRecord<unknown>): Promise<Result<Float32Array>> =>\n  // A real embedder receives an `IMemoryRecord<unknown>` and must validate the\n  // body through a Converter rather than casting — this models that idiom.\n  Promise.resolve(\n    Converters.string\n      .convert(r.body)\n      .withErrorFormat((msg) => `cannot embed: body is not a string: ${msg}`)\n      .onSuccess((body) => succeed(featureVector(body)))\n  );\nconst queryEmbed = (text: string): Promise<Result<Float32Array>> =>\n  Promise.resolve(succeed(featureVector(text)));\n\n/** Records add/remove call order and can be configured to fail either op. */\nclass SpyVectorIndex implements IVectorIndex {\n  public readonly calls: string[] = [];\n  public failAdd: boolean = false;\n  public failRemove: boolean = false;\n  private readonly _inner: InMemoryCosineIndex = InMemoryCosineIndex.create().orThrow();\n\n  public async add(id: MemoryId, vector: Float32Array): Promise<Result<string>> {\n    this.calls.push(`add:${id}`);\n    return this.failAdd ? fail('add boom') : this._inner.add(id, vector);\n  }\n  public async remove(id: MemoryId): Promise<Result<MemoryId>> {\n    this.calls.push(`remove:${id}`);\n    return this.failRemove ? fail('remove boom') : this._inner.remove(id);\n  }\n  public query(vector: Float32Array, topK: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>> {\n    return this._inner.query(vector, topK);\n  }\n}\n\nfunction knowledgeStore(\n  vectorIndex?: IVectorIndex,\n  embed?: (r: IMemoryRecord<unknown>) => Promise<Result<Float32Array>>,\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    vectorIndex,\n    embed,\n    logger\n  }).orThrow();\n}\n\ndescribe('FileTreeMemoryStore embed-on-write', () => {\n  describe('when wired', () => {\n    test('embeds on write, stamps embeddingRef, and indexes the vector', async () => {\n      const index = InMemoryCosineIndex.create().orThrow();\n      const store = knowledgeStore(index, recordEmbed);\n      expect(await store.put(makeRecord('doc-a', 'cat cat'))).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown>) => {\n          // InMemoryCosineIndex keys entries by id, so the ref IS the id.\n          expect(record.envelope.embeddingRef).toBe('doc-a');\n        }\n      );\n      expect(index.size).toBe(1);\n      // The persisted file carries the embeddingRef (round-trips through disk).\n      expect(await store.getById('knowledge' as MemoryScopeKey, 'doc-a' as MemoryId)).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown> | undefined) => {\n          expect(record?.envelope.embeddingRef).toBe('doc-a');\n        }\n      );\n      // The vector is queryable.\n      expect(await index.query(featureVector('cat'), 1)).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          expect(hits[0].id).toBe('doc-a');\n        }\n      );\n    });\n\n    test('re-embeds on a content change by re-adding (replace semantics, no eager remove)', async () => {\n      const spy = new SpyVectorIndex();\n      const store = knowledgeStore(spy, recordEmbed);\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      (await store.put(makeRecord('doc-a', 'dog'))).orThrow();\n      // The content change re-adds (IVectorIndex.add replaces for a same id) —\n      // no redundant eager remove.\n      expect(spy.calls).toEqual(['add:doc-a', 'add:doc-a']);\n      // The index now reflects the new content ('dog'), not the original.\n      expect(await spy.query(featureVector('dog'), 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 SpyVectorIndex();\n      const store = knowledgeStore(spy, recordEmbed);\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      // The second identical put is a content-dedup no-op — no second embedding.\n      expect(spy.calls).toEqual(['add:doc-a']);\n    });\n\n    test('removes the vector on delete', async () => {\n      const spy = new SpyVectorIndex();\n      const store = knowledgeStore(spy, recordEmbed);\n      (await store.put(makeRecord('doc-a', 'cat'))).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', 'remove:doc-a']);\n      expect(await spy.query(featureVector('cat'), 5)).toSucceedWith([]);\n    });\n\n    test('removes evicted vectors on cap-cull eviction', async () => {\n      const index = InMemoryCosineIndex.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        vectorIndex: index,\n        embed: recordEmbed\n      }).orThrow();\n\n      // Distinct bodies so each gets a distinct vector; maxRecords=2 evicts the\n      // oldest on the third write.\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 was evicted from the store AND the vector index.\n      expect(index.size).toBe(2);\n      expect(await index.query(featureVector('cat'), 5)).toSucceedAndSatisfy(\n        (hits: ReadonlyArray<IVectorQueryHit>) => {\n          expect(hits.map((h) => h.id)).not.toContain('turn-0');\n        }\n      );\n    });\n\n    test('persists the record (best-effort) and logs when embedding fails', async () => {\n      const index = InMemoryCosineIndex.create().orThrow();\n      const logger = new Logging.InMemoryLogger();\n      const failEmbed = (): Promise<Result<Float32Array>> => Promise.resolve(fail('no model'));\n      const store = knowledgeStore(index, failEmbed, logger);\n      // The durable write succeeds; only the derived index is skipped (rebuildable).\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown>) => {\n          expect(record.envelope.embeddingRef).toBeUndefined();\n        }\n      );\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.size).toBe(0);\n      expect(logger.logged.some((m) => /embedding 'doc-a' failed.*no model/i.test(m))).toBe(true);\n    });\n\n    test('persists the record (best-effort) and logs when the vector add fails', async () => {\n      const spy = new SpyVectorIndex();\n      spy.failAdd = true;\n      const logger = new Logging.InMemoryLogger();\n      const store = knowledgeStore(spy, recordEmbed, logger);\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown>) => {\n          expect(record.envelope.embeddingRef).toBeUndefined();\n        }\n      );\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) => /vector add for 'doc-a' failed.*add boom/i.test(m))).toBe(true);\n    });\n\n    test('best-effort embed survives a throwing/rejecting embedder', async () => {\n      const index = InMemoryCosineIndex.create().orThrow();\n      const logger = new Logging.InMemoryLogger();\n      const throwingEmbed = (): Promise<Result<Float32Array>> => Promise.reject(new Error('embedder kaboom'));\n      const store = knowledgeStore(index, throwingEmbed, logger);\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceed();\n      expect(index.size).toBe(0);\n      expect(logger.logged.some((m) => /embedding 'doc-a' threw.*embedder kaboom/i.test(m))).toBe(true);\n    });\n\n    test('a committed delete succeeds (best-effort) and logs when vector removal fails', async () => {\n      const spy = new SpyVectorIndex();\n      const logger = new Logging.InMemoryLogger();\n      const store = knowledgeStore(spy, recordEmbed, logger);\n      (await store.put(makeRecord('doc-a', 'cat'))).orThrow();\n      spy.failRemove = true;\n      // The record is already gone; vector cleanup failure must NOT fail the delete.\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) => /vector removal for 'doc-a' failed.*remove boom/i.test(m))).toBe(true);\n    });\n  });\n\n  describe('when unwired', () => {\n    test('a store without a vector index or embedder leaves embeddingRef unset', 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 vector index without an embedder is fully inert (no add or remove)', async () => {\n      const spy = new SpyVectorIndex();\n      const store = knowledgeStore(spy, undefined);\n      expect(await store.put(makeRecord('doc-a', 'cat'))).toSucceedAndSatisfy(\n        (record: IMemoryRecord<unknown>) => {\n          expect(record.envelope.embeddingRef).toBeUndefined();\n        }\n      );\n      // The vector lifecycle is wholly off without an embedder: neither put nor\n      // delete touches the index (a remove would target a record never embedded).\n      (await store.delete(knowledgeKind, 'doc-a' as unknown as EntityId)).orThrow();\n      expect(spy.calls).toEqual([]);\n    });\n  });\n\n  describe('semantic recall end-to-end', () => {\n    test('a wired store + InMemoryCosineIndex + SemanticRetriever returns cosine top-k', async () => {\n      const index = InMemoryCosineIndex.create().orThrow();\n      const store = knowledgeStore(index, recordEmbed);\n      (await store.put(makeRecord('cats', 'cat cat cat'))).orThrow();\n      (await store.put(makeRecord('dogs', 'dog dog dog'))).orThrow();\n      (await store.put(makeRecord('fishes', 'fish fish fish'))).orThrow();\n\n      // SemanticRetriever takes an IMemoryIndex separate from the store (the\n      // store's derived index is private and the two are intentionally\n      // decoupled), so build a record index mirroring the store — keyed by the\n      // shared vectorIndex instance — for hit hydration.\n      const listed: ReadonlyArray<IMemoryRecord<unknown>> = (await store.list()).orThrow();\n      const recordIndex = MemoryIndex.create().orThrow();\n      recordIndex\n        .rebuild(\n          listed.map((record): IIndexedMemoryRecord => ({ scope: 'knowledge' as MemoryScopeKey, record }))\n        )\n        .orThrow();\n\n      const retriever = SemanticRetriever.create({\n        index: recordIndex,\n        backend: { vectorIndex: index, embedQuery: queryEmbed }\n      }).orThrow();\n      expect(retriever.capabilities.supportsSemanticRecall).toBe(true);\n\n      expect(await retriever.retrieve({ semantic: 'cat', topK: 2 })).toSucceedAndSatisfy(\n        (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n          // 'cats' is the closest; 'dogs'/'fishes' are orthogonal (cosine 0) so\n          // only the cat record ranks above them — it is first.\n          expect(records[0].envelope.id).toBe('cats');\n        }\n      );\n    });\n  });\n});\n"]}

package/lib/test/unit/store/fileTreeMemoryStore.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=fileTreeMemoryStore.test.d.ts.map

package/lib/test/unit/store/fileTreeMemoryStore.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTreeMemoryStore.test.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/store/fileTreeMemoryStore.test.ts"],"names":[],"mappings":"AAKA,OAAO,oBAAoB,CAAC"}