@fgv/ts-agent-memory 5.1.0-47 → 5.1.0-48

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

@@ -1,239 +0,0 @@
-/*
- * 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, KnowledgeIdentityCodec, MemoryCapCullPolicy, MemoryObservationStore, MtmIdentityCodec, envelopeConverter } from '../../../index';
-const knowledgeKind = 'knowledge';
-function makeRecord(id, body = `body for ${id}`) {
-    return {
-        envelope: envelopeConverter
-            .convert({
-            id,
-            entityId: id,
-            kind: 'knowledge',
-            tags: [],
-            links: [],
-            created: 0,
-            updated: 0,
-            seq: 0,
-            contentHash: '',
-            provenance: { source: 'agent' }
-        })
-            .orThrow(),
-        body
-    };
-}
-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 knowledgeRegistry() {
-    const registry = BodyConverterRegistry.create().orThrow();
-    registry.register(knowledgeKind, Converters.string);
-    return registry;
-}
-const knowledgeCodecs = new Map([
-    [knowledgeKind, new KnowledgeIdentityCodec()]
-]);
-let clockValue;
-const clock = () => clockValue;
-function createStore(observers, logger) {
-    return FileTreeMemoryStore.create({
-        root: mutableRoot(),
-        registry: knowledgeRegistry(),
-        codecs: knowledgeCodecs,
-        clock,
-        observers,
-        logger
-    }).orThrow();
-}
-describe('FileTreeMemoryStore observations', () => {
-    beforeEach(() => {
-        clockValue = 1000;
-    });
-    describe('when no observers are wired (B1 behavior unchanged)', () => {
-        test('put / get / delete still succeed and produce no records', async () => {
-            const store = createStore();
-            expect(await store.put(makeRecord('doc-a'))).toSucceed();
-            expect(await store.get(knowledgeKind, 'doc-a')).toSucceedAndSatisfy((rec) => {
-                expect(rec === null || rec === void 0 ? void 0 : rec.envelope.id).toBe('doc-a');
-            });
-            expect(await store.delete(knowledgeKind, 'doc-a')).toSucceedWith('doc-a');
-        });
-    });
-    describe('when an observation store is wired', () => {
-        let observations;
-        let store;
-        beforeEach(() => {
-            observations = MemoryObservationStore.create().orThrow();
-            store = createStore([observations]);
-        });
-        test('fires a write observation on put', async () => {
-            await store.put(makeRecord('doc-a'));
-            const records = observations.query({ phase: 'write' });
-            expect(records).toHaveLength(1);
-            expect(records[0]).toMatchObject({
-                seq: 1,
-                timestamp: 1000,
-                phase: 'write',
-                scope: 'knowledge',
-                id: 'doc-a',
-                kind: 'knowledge',
-                outcome: 'success'
-            });
-            expect(records[0].provenance).toEqual({ source: 'agent' });
-        });
-        test('fires a read observation on get (found and not-found)', async () => {
-            await store.put(makeRecord('doc-a'));
-            await store.get(knowledgeKind, 'doc-a');
-            await store.get(knowledgeKind, 'missing');
-            const reads = observations.query({ phase: 'read' });
-            expect(reads).toHaveLength(2);
-            expect(reads[0]).toMatchObject({ outcome: 'success', id: 'doc-a' });
-            expect(reads[1]).toMatchObject({ outcome: 'success', scope: 'knowledge' });
-            expect(reads[1].id).toBeUndefined();
-        });
-        test('fires a delete observation on delete', async () => {
-            await store.put(makeRecord('doc-a'));
-            await store.delete(knowledgeKind, 'doc-a');
-            const deletes = observations.query({ phase: 'delete' });
-            expect(deletes).toHaveLength(1);
-            expect(deletes[0]).toMatchObject({ outcome: 'success', id: 'doc-a', kind: 'knowledge' });
-        });
-        test('records a failure outcome with the error message', async () => {
-            const result = await store.delete(knowledgeKind, 'never-written');
-            expect(result).toFail();
-            const deletes = observations.query({ phase: 'delete' });
-            expect(deletes).toHaveLength(1);
-            expect(deletes[0].outcome).toBe('failure');
-            expect(deletes[0].error).toMatch(/no record found/i);
-        });
-        test('assigns strictly increasing observation seq across ops', async () => {
-            await store.put(makeRecord('doc-a'));
-            await store.get(knowledgeKind, 'doc-a');
-            await store.delete(knowledgeKind, 'doc-a');
-            expect(observations.query().map((r) => r.seq)).toEqual([1, 2, 3]);
-            expect(observations.lastSeq).toBe(3);
-        });
-    });
-    describe('cap-cull eviction observations', () => {
-        const mtmKind = 'mtm';
-        function mtmRegistry() {
-            const registry = BodyConverterRegistry.create().orThrow();
-            registry.register(mtmKind, Converters.string);
-            return registry;
-        }
-        function makeMtmRecord(turn, body) {
-            return {
-                envelope: envelopeConverter
-                    .convert({
-                    id: `turn-${turn}`,
-                    entityId: `conv-1:${turn}`,
-                    kind: 'mtm',
-                    tags: [],
-                    links: [],
-                    created: 0,
-                    updated: 0,
-                    seq: 0,
-                    contentHash: '',
-                    provenance: { source: 'agent' }
-                })
-                    .orThrow(),
-                body
-            };
-        }
-        test('fires a delete observation for each record evicted by cap-cull', async () => {
-            const observations = MemoryObservationStore.create().orThrow();
-            const capCull = MemoryCapCullPolicy.create({
-                maxRecords: 2,
-                mutableFields: ['body', 'tags', 'links', 'provenance', 'embeddingRef']
-            }).orThrow();
-            const store = FileTreeMemoryStore.create({
-                root: mutableRoot(),
-                registry: mtmRegistry(),
-                codecs: new Map([[mtmKind, new MtmIdentityCodec()]]),
-                writePolicies: new Map([[mtmKind, capCull]]),
-                clock,
-                observers: [observations]
-            }).orThrow();
-            for (let turn = 0; turn < 3; turn++) {
-                clockValue = 1000 + turn; // distinct `created` so turn-0 is unambiguously oldest.
-                (await store.put(makeMtmRecord(turn, `turn ${turn}`))).orThrow();
-            }
-            // The third put admits turn-2 and evicts the oldest (turn-0): the audit
-            // stream must carry a `'delete'` observation naming the evicted record,
-            // in the same (scope, kind) as the write that triggered it.
-            const deletes = observations.query({ phase: 'delete' });
-            expect(deletes).toHaveLength(1);
-            expect(deletes[0]).toMatchObject({
-                phase: 'delete',
-                outcome: 'success',
-                id: 'turn-0',
-                kind: 'mtm',
-                scope: 'conversations/conv-1'
-            });
-            // Three writes + one eviction delete = four observations, strictly
-            // increasing seq (the store is the single seq authority).
-            expect(observations.query({ phase: 'write' })).toHaveLength(3);
-            expect(observations.query().map((r) => r.seq)).toEqual([1, 2, 3, 4]);
-        });
-    });
-    describe('observer error handling', () => {
-        test('a failing observer never affects the store op and is logged', async () => {
-            const logger = new Logging.InMemoryLogger();
-            const failing = {
-                observe: () => Promise.resolve(fail('observer boom'))
-            };
-            const store = createStore([failing], logger);
-            expect(await store.put(makeRecord('doc-a'))).toSucceed();
-            expect(logger.logged.some((m) => /observer failed \(swallowed\): observer boom/i.test(m))).toBe(true);
-        });
-        test('a throwing observer never affects the store op and is logged', async () => {
-            const logger = new Logging.InMemoryLogger();
-            const throwing = {
-                observe: () => {
-                    throw new Error('observer kaboom');
-                }
-            };
-            const store = createStore([throwing], logger);
-            expect(await store.put(makeRecord('doc-a'))).toSucceed();
-            expect(logger.logged.some((m) => /observer threw \(swallowed\): .*kaboom/i.test(m))).toBe(true);
-        });
-        test('a logger that throws while reporting a failed observer never breaks the store op', async () => {
-            class ThrowingWarnLogger extends Logging.NoOpLogger {
-                warn() {
-                    throw new Error('logger down');
-                }
-            }
-            const failing = {
-                observe: () => Promise.resolve(fail('observer boom'))
-            };
-            const store = createStore([failing], new ThrowingWarnLogger());
-            expect(await store.put(makeRecord('doc-a'))).toSucceed();
-        });
-        test('a fire-and-forget observer is dispatched without blocking and errors are swallowed', async () => {
-            const seen = [];
-            const observer = {
-                fireAndForget: true,
-                observe: (record) => {
-                    seen.push(record);
-                    return Promise.resolve(succeed(record));
-                }
-            };
-            const store = createStore([observer]);
-            expect(await store.put(makeRecord('doc-a'))).toSucceed();
-            // Allow the detached dispatch to run.
-            await Promise.resolve();
-            expect(seen).toHaveLength(1);
-            expect(seen[0].phase).toBe('write');
-        });
-    });
-});
-//# sourceMappingURL=observations.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"observations.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/observations.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, 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  IMemoryObservationRecord,\n  IMemoryObserver,\n  IMemoryRecord,\n  IWritePolicy,\n  Kind,\n  KnowledgeIdentityCodec,\n  MemoryCapCullPolicy,\n  MemoryId,\n  MemoryObservationStore,\n  MtmIdentityCodec,\n  envelopeConverter\n} from '../../../index';\n\nconst knowledgeKind: Kind = 'knowledge' as Kind;\n\nfunction makeRecord(id: string, body: string = `body for ${id}`): IMemoryRecord<unknown> {\n  return {\n    envelope: envelopeConverter\n      .convert({\n        id,\n        entityId: id,\n        kind: 'knowledge',\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\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 knowledgeRegistry(): IBodyConverterRegistry {\n  const registry = BodyConverterRegistry.create().orThrow();\n  registry.register(knowledgeKind, Converters.string);\n  return registry;\n}\n\nconst knowledgeCodecs: ReadonlyMap<Kind, IIdentityCodec> = new Map<Kind, IIdentityCodec>([\n  [knowledgeKind, new KnowledgeIdentityCodec()]\n]);\n\nlet clockValue: number;\nconst clock = (): number => clockValue;\n\nfunction createStore(\n  observers?: ReadonlyArray<IMemoryObserver>,\n  logger?: Logging.ILogger\n): FileTreeMemoryStore {\n  return FileTreeMemoryStore.create({\n    root: mutableRoot(),\n    registry: knowledgeRegistry(),\n    codecs: knowledgeCodecs,\n    clock,\n    observers,\n    logger\n  }).orThrow();\n}\n\ndescribe('FileTreeMemoryStore observations', () => {\n  beforeEach(() => {\n    clockValue = 1000;\n  });\n\n  describe('when no observers are wired (B1 behavior unchanged)', () => {\n    test('put / get / delete still succeed and produce no records', async () => {\n      const store = createStore();\n      expect(await store.put(makeRecord('doc-a'))).toSucceed();\n      expect(await store.get(knowledgeKind, 'doc-a' as EntityId)).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown> | undefined) => {\n          expect(rec?.envelope.id).toBe('doc-a');\n        }\n      );\n      expect(await store.delete(knowledgeKind, 'doc-a' as EntityId)).toSucceedWith(\n        'doc-a' as unknown as MemoryId\n      );\n    });\n  });\n\n  describe('when an observation store is wired', () => {\n    let observations: MemoryObservationStore;\n    let store: FileTreeMemoryStore;\n\n    beforeEach(() => {\n      observations = MemoryObservationStore.create().orThrow();\n      store = createStore([observations]);\n    });\n\n    test('fires a write observation on put', async () => {\n      await store.put(makeRecord('doc-a'));\n      const records: ReadonlyArray<IMemoryObservationRecord> = observations.query({ phase: 'write' });\n      expect(records).toHaveLength(1);\n      expect(records[0]).toMatchObject({\n        seq: 1,\n        timestamp: 1000,\n        phase: 'write',\n        scope: 'knowledge',\n        id: 'doc-a',\n        kind: 'knowledge',\n        outcome: 'success'\n      });\n      expect(records[0].provenance).toEqual({ source: 'agent' });\n    });\n\n    test('fires a read observation on get (found and not-found)', async () => {\n      await store.put(makeRecord('doc-a'));\n      await store.get(knowledgeKind, 'doc-a' as EntityId);\n      await store.get(knowledgeKind, 'missing' as EntityId);\n      const reads: ReadonlyArray<IMemoryObservationRecord> = observations.query({ phase: 'read' });\n      expect(reads).toHaveLength(2);\n      expect(reads[0]).toMatchObject({ outcome: 'success', id: 'doc-a' });\n      expect(reads[1]).toMatchObject({ outcome: 'success', scope: 'knowledge' });\n      expect(reads[1].id).toBeUndefined();\n    });\n\n    test('fires a delete observation on delete', async () => {\n      await store.put(makeRecord('doc-a'));\n      await store.delete(knowledgeKind, 'doc-a' as EntityId);\n      const deletes: ReadonlyArray<IMemoryObservationRecord> = observations.query({ phase: 'delete' });\n      expect(deletes).toHaveLength(1);\n      expect(deletes[0]).toMatchObject({ outcome: 'success', id: 'doc-a', kind: 'knowledge' });\n    });\n\n    test('records a failure outcome with the error message', async () => {\n      const result = await store.delete(knowledgeKind, 'never-written' as EntityId);\n      expect(result).toFail();\n      const deletes: ReadonlyArray<IMemoryObservationRecord> = observations.query({ phase: 'delete' });\n      expect(deletes).toHaveLength(1);\n      expect(deletes[0].outcome).toBe('failure');\n      expect(deletes[0].error).toMatch(/no record found/i);\n    });\n\n    test('assigns strictly increasing observation seq across ops', async () => {\n      await store.put(makeRecord('doc-a'));\n      await store.get(knowledgeKind, 'doc-a' as EntityId);\n      await store.delete(knowledgeKind, 'doc-a' as EntityId);\n      expect(observations.query().map((r) => r.seq)).toEqual([1, 2, 3]);\n      expect(observations.lastSeq).toBe(3);\n    });\n  });\n\n  describe('cap-cull eviction observations', () => {\n    const mtmKind: Kind = 'mtm' as Kind;\n\n    function mtmRegistry(): IBodyConverterRegistry {\n      const registry = BodyConverterRegistry.create().orThrow();\n      registry.register(mtmKind, Converters.string);\n      return registry;\n    }\n\n    function makeMtmRecord(turn: number, body: string): IMemoryRecord<unknown> {\n      return {\n        envelope: envelopeConverter\n          .convert({\n            id: `turn-${turn}`,\n            entityId: `conv-1:${turn}`,\n            kind: 'mtm',\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    test('fires a delete observation for each record evicted by cap-cull', async () => {\n      const observations = MemoryObservationStore.create().orThrow();\n      const capCull: IWritePolicy = MemoryCapCullPolicy.create({\n        maxRecords: 2,\n        mutableFields: ['body', 'tags', 'links', 'provenance', 'embeddingRef']\n      }).orThrow();\n      const store = FileTreeMemoryStore.create({\n        root: mutableRoot(),\n        registry: mtmRegistry(),\n        codecs: new Map<Kind, IIdentityCodec>([[mtmKind, new MtmIdentityCodec()]]),\n        writePolicies: new Map<Kind, IWritePolicy>([[mtmKind, capCull]]),\n        clock,\n        observers: [observations]\n      }).orThrow();\n\n      for (let turn = 0; turn < 3; turn++) {\n        clockValue = 1000 + turn; // distinct `created` so turn-0 is unambiguously oldest.\n        (await store.put(makeMtmRecord(turn, `turn ${turn}`))).orThrow();\n      }\n\n      // The third put admits turn-2 and evicts the oldest (turn-0): the audit\n      // stream must carry a `'delete'` observation naming the evicted record,\n      // in the same (scope, kind) as the write that triggered it.\n      const deletes: ReadonlyArray<IMemoryObservationRecord> = observations.query({ phase: 'delete' });\n      expect(deletes).toHaveLength(1);\n      expect(deletes[0]).toMatchObject({\n        phase: 'delete',\n        outcome: 'success',\n        id: 'turn-0',\n        kind: 'mtm',\n        scope: 'conversations/conv-1'\n      });\n\n      // Three writes + one eviction delete = four observations, strictly\n      // increasing seq (the store is the single seq authority).\n      expect(observations.query({ phase: 'write' })).toHaveLength(3);\n      expect(observations.query().map((r) => r.seq)).toEqual([1, 2, 3, 4]);\n    });\n  });\n\n  describe('observer error handling', () => {\n    test('a failing observer never affects the store op and is logged', async () => {\n      const logger = new Logging.InMemoryLogger();\n      const failing: IMemoryObserver = {\n        observe: () => Promise.resolve(fail('observer boom'))\n      };\n      const store = createStore([failing], logger);\n      expect(await store.put(makeRecord('doc-a'))).toSucceed();\n      expect(logger.logged.some((m) => /observer failed \\(swallowed\\): observer boom/i.test(m))).toBe(true);\n    });\n\n    test('a throwing observer never affects the store op and is logged', async () => {\n      const logger = new Logging.InMemoryLogger();\n      const throwing: IMemoryObserver = {\n        observe: () => {\n          throw new Error('observer kaboom');\n        }\n      };\n      const store = createStore([throwing], logger);\n      expect(await store.put(makeRecord('doc-a'))).toSucceed();\n      expect(logger.logged.some((m) => /observer threw \\(swallowed\\): .*kaboom/i.test(m))).toBe(true);\n    });\n\n    test('a logger that throws while reporting a failed observer never breaks the store op', async () => {\n      class ThrowingWarnLogger extends Logging.NoOpLogger {\n        public warn(): never {\n          throw new Error('logger down');\n        }\n      }\n      const failing: IMemoryObserver = {\n        observe: () => Promise.resolve(fail('observer boom'))\n      };\n      const store = createStore([failing], new ThrowingWarnLogger());\n      expect(await store.put(makeRecord('doc-a'))).toSucceed();\n    });\n\n    test('a fire-and-forget observer is dispatched without blocking and errors are swallowed', async () => {\n      const seen: IMemoryObservationRecord[] = [];\n      const observer: IMemoryObserver = {\n        fireAndForget: true,\n        observe: (record) => {\n          seen.push(record);\n          return Promise.resolve(succeed(record));\n        }\n      };\n      const store = createStore([observer]);\n      expect(await store.put(makeRecord('doc-a'))).toSucceed();\n      // Allow the detached dispatch to run.\n      await Promise.resolve();\n      expect(seen).toHaveLength(1);\n      expect(seen[0].phase).toBe('write');\n    });\n  });\n});\n"]}

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

@@ -1,254 +0,0 @@
-/*
- * Copyright (c) 2026 Erik Fortune
- * SPDX-License-Identifier: MIT
- */
-import '@fgv/ts-utils-jest';
-import { Converters, Logging } from '@fgv/ts-utils';
-import { FileTree } from '@fgv/ts-json-base';
-import { BodyConverterRegistry, FileTreeMemoryStore, KnowledgeIdentityCodec, MemoryIndex, RecencyRetriever, TemporalIdentityCodec, TemporalVersionedPolicy, parseMemoryFile } from '../../../index';
-const knowledgeKind = 'knowledge';
-const plainKind = 'plain';
-const factKind = 'fact';
-/** Host projector: rank = body length. Generic numeric ordering — the store never interprets meaning. */
-const lengthProjector = (record) => record.body.length;
-/** A projector that always throws — exercises the guard-host-callback path. */
-const throwingProjector = () => {
-    throw new Error('projector boom');
-};
-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;
-}
-function registry() {
-    const reg = BodyConverterRegistry.create().orThrow();
-    reg.register(knowledgeKind, Converters.string);
-    reg.register(plainKind, Converters.string);
-    reg.register(factKind, Converters.string);
-    return reg;
-}
-const codecs = new Map([
-    [knowledgeKind, new KnowledgeIdentityCodec()],
-    [plainKind, new KnowledgeIdentityCodec()],
-    [factKind, TemporalIdentityCodec.create('facts').orThrow()]
-]);
-const temporalPolicies = new Map([
-    [factKind, TemporalVersionedPolicy.create().orThrow()]
-]);
-function makeRecord(spec) {
-    var _a, _b, _c;
-    return {
-        envelope: {
-            id: spec.id,
-            entityId: ((_a = spec.entityId) !== null && _a !== void 0 ? _a : spec.id),
-            kind: (_b = spec.kind) !== null && _b !== void 0 ? _b : knowledgeKind,
-            tags: ((_c = spec.tags) !== null && _c !== void 0 ? _c : []),
-            links: [],
-            created: 0,
-            updated: 0,
-            seq: 0,
-            contentHash: '',
-            provenance: { source: 'agent' }
-        },
-        body: spec.body
-    };
-}
-describe('FileTreeMemoryStore rank axis', () => {
-    let clockValue;
-    const clock = () => clockValue;
-    beforeEach(() => {
-        clockValue = 1000;
-    });
-    function createStore(params = {}) {
-        var _a;
-        return FileTreeMemoryStore.create({
-            root: (_a = params.root) !== null && _a !== void 0 ? _a : mutableRoot(),
-            registry: registry(),
-            codecs,
-            writePolicies: params.writePolicies,
-            rankProjectors: params.rankProjectors,
-            logger: params.logger,
-            clock
-        });
-    }
-    const knowledgeProjectors = new Map([
-        [knowledgeKind, lengthProjector]
-    ]);
-    describe('put stamps rank (flat / non-versioned path)', () => {
-        test('runs the kind projector and stamps the numeric result', async () => {
-            const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(4);
-            });
-        });
-        test('leaves rank absent for a kind with no projector', async () => {
-            const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();
-            expect(await store.put(makeRecord({ id: 'p-1', kind: plainKind, body: 'anything' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBeUndefined();
-            });
-        });
-        test('is byte-identical (rank absent) when no projector map is wired', async () => {
-            const store = createStore().orThrow();
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBeUndefined();
-            });
-        });
-    });
-    describe('body revision re-stamps rank (staleness contract)', () => {
-        test('a body-only revision recomputes rank against the current body', async () => {
-            const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'ab' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(2);
-            });
-            clockValue = 2000;
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcdef' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(6);
-                expect(rec.envelope.updated).toBe(2000);
-            });
-        });
-    });
-    describe('throwing projector degrades to rank-absent', () => {
-        test('logs a warn and leaves rank absent without failing the write', async () => {
-            const logger = new Logging.InMemoryLogger();
-            const store = createStore({
-                rankProjectors: new Map([[knowledgeKind, throwingProjector]]),
-                logger
-            }).orThrow();
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBeUndefined();
-            });
-            expect(logger.logged.some((m) => /rank projector threw/i.test(m))).toBe(true);
-        });
-        test('an UPDATE whose projector throws CLEARS the prior rank (flat path staleness contract)', async () => {
-            let shouldThrow = false;
-            const flakyProjector = (record) => {
-                if (shouldThrow) {
-                    throw new Error('projector boom');
-                }
-                return record.body.length;
-            };
-            const store = createStore({
-                rankProjectors: new Map([[knowledgeKind, flakyProjector]])
-            }).orThrow();
-            // First write succeeds → rank stamped to a nonzero value.
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(4);
-            });
-            // Update with a body revision while the projector now throws → the prior
-            // rank (4) must NOT survive; the record is stamped rank-absent.
-            shouldThrow = true;
-            clockValue = 2000;
-            expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcdefgh' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBeUndefined();
-                expect(rec.envelope.updated).toBe(2000);
-            });
-        });
-        test('an UPDATE whose projector throws CLEARS the prior rank (versioned path staleness contract)', async () => {
-            let shouldThrow = false;
-            const flakyProjector = (record) => {
-                if (shouldThrow) {
-                    throw new Error('projector boom');
-                }
-                return record.body.length;
-            };
-            const store = createStore({
-                rankProjectors: new Map([[factKind, flakyProjector]]),
-                writePolicies: temporalPolicies
-            }).orThrow();
-            expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aa' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(2);
-            });
-            shouldThrow = true;
-            clockValue = 2000;
-            // The new version merges over the current version (which carried rank 2);
-            // the throwing projector must clear it so the new version is rank-absent.
-            expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aaaaa' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBeUndefined();
-            });
-        });
-    });
-    describe('put stamps rank (versioned / temporal path)', () => {
-        const factProjectors = new Map([
-            [factKind, lengthProjector]
-        ]);
-        test('stamps rank on the first version and re-stamps on a subsequent version', async () => {
-            const store = createStore({
-                rankProjectors: factProjectors,
-                writePolicies: temporalPolicies
-            }).orThrow();
-            expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aa' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(2);
-            });
-            clockValue = 2000;
-            expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aaaaa' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(5);
-            });
-        });
-        test('leaves rank absent on the versioned path when the kind has no projector', async () => {
-            const store = createStore({ writePolicies: temporalPolicies }).orThrow();
-            expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aa' }))).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBeUndefined();
-            });
-        });
-    });
-    describe('persistence round-trip', () => {
-        test('rank serializes to frontmatter and reloads on rebuild (no recompute-on-load)', async () => {
-            const root = mutableRoot();
-            const store = createStore({ root, rankProjectors: knowledgeProjectors }).orThrow();
-            await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }));
-            // Read the raw persisted file and confirm rank is in the frontmatter.
-            const scopeDir = root
-                .getChildren()
-                .orThrow()
-                .find((c) => c.type === 'directory' && c.name === 'knowledge');
-            expect(scopeDir).toBeDefined();
-            const file = scopeDir
-                .getChildren()
-                .orThrow()
-                .find((c) => c.type === 'file' && c.name === 'doc-a.md');
-            expect(file).toBeDefined();
-            const raw = file.getRawContents().orThrow();
-            expect(parseMemoryFile(raw, registry())).toSucceedAndSatisfy((rec) => {
-                expect(rec.envelope.rank).toBe(4);
-            });
-            // A brand-new store over the same root reloads rank from frontmatter WITHOUT any projector wired.
-            const reloaded = createStore({ root }).orThrow();
-            expect(await reloaded.getById('knowledge', 'doc-a')).toSucceedAndSatisfy((rec) => {
-                expect(rec === null || rec === void 0 ? void 0 : rec.envelope.rank).toBe(4);
-            });
-        });
-    });
-    describe('orderBy: rank retrieval (store-stamped ranks flow end-to-end)', () => {
-        async function indexFromStore(store) {
-            const records = (await store.list()).orThrow();
-            const index = MemoryIndex.create().orThrow();
-            // Scope is not returned by `list`; a per-id synthetic scope keeps the
-            // (scope, id) index keys distinct, which is all ordering needs here.
-            index
-                .rebuild(records.map((record) => ({ scope: record.envelope.id, record })))
-                .orThrow();
-            return index;
-        }
-        test('orders by store-stamped rank descending, honoring kinds + limit + offset', async () => {
-            const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();
-            // ranks: a=1, bbb=3, cc=2 (by body length)
-            await store.put(makeRecord({ id: 'a', body: 'a' }));
-            await store.put(makeRecord({ id: 'bbb', body: 'bbb' }));
-            await store.put(makeRecord({ id: 'cc', body: 'cc' }));
-            // A plain-kind record has no projector → rank absent → sorts last.
-            await store.put(makeRecord({ id: 'p', kind: plainKind, body: 'zzzz' }));
-            const retriever = RecencyRetriever.create(await indexFromStore(store)).orThrow();
-            expect(await retriever.retrieve({ orderBy: 'rank' })).toSucceedAndSatisfy((records) => {
-                expect(records.map((r) => r.envelope.id)).toEqual(['bbb', 'cc', 'a', 'p']);
-            });
-            // Kind-set scoped, rank-ordered, paged: skip the top, take one.
-            expect(await retriever.retrieve({ kinds: [knowledgeKind], orderBy: 'rank', limit: 1, offset: 1 })).toSucceedAndSatisfy((records) => {
-                expect(records.map((r) => r.envelope.id)).toEqual(['cc']);
-            });
-        });
-    });
-});
-//# sourceMappingURL=rankAxis.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rankAxis.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/rankAxis.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 } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  BodyConverterRegistry,\n  EntityId,\n  FileTreeMemoryStore,\n  IBodyConverterRegistry,\n  IIdentityCodec,\n  IMemoryRecord,\n  IWritePolicy,\n  Kind,\n  KnowledgeIdentityCodec,\n  MemoryIndex,\n  MemoryScopeKey,\n  RankProjector,\n  RecencyRetriever,\n  TemporalIdentityCodec,\n  TemporalVersionedPolicy,\n  parseMemoryFile\n} from '../../../index';\n\nconst knowledgeKind: Kind = 'knowledge' as Kind;\nconst plainKind: Kind = 'plain' as Kind;\nconst factKind: Kind = 'fact' as Kind;\n\n/** Host projector: rank = body length. Generic numeric ordering — the store never interprets meaning. */\nconst lengthProjector: RankProjector = (record) => (record.body as string).length;\n\n/** A projector that always throws — exercises the guard-host-callback path. */\nconst throwingProjector: RankProjector = () => {\n  throw new Error('projector boom');\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\nfunction registry(): IBodyConverterRegistry {\n  const reg = BodyConverterRegistry.create().orThrow();\n  reg.register(knowledgeKind, Converters.string);\n  reg.register(plainKind, Converters.string);\n  reg.register(factKind, Converters.string);\n  return reg;\n}\n\nconst codecs: ReadonlyMap<Kind, IIdentityCodec> = new Map<Kind, IIdentityCodec>([\n  [knowledgeKind, new KnowledgeIdentityCodec()],\n  [plainKind, new KnowledgeIdentityCodec()],\n  [factKind, TemporalIdentityCodec.create('facts').orThrow()]\n]);\n\nconst temporalPolicies: ReadonlyMap<Kind, IWritePolicy> = new Map<Kind, IWritePolicy>([\n  [factKind, TemporalVersionedPolicy.create().orThrow()]\n]);\n\ninterface IRecordSpec {\n  readonly id: string;\n  readonly entityId?: string;\n  readonly kind?: Kind;\n  readonly body: string;\n  readonly tags?: ReadonlyArray<string>;\n}\n\nfunction makeRecord(spec: IRecordSpec): IMemoryRecord<unknown> {\n  return {\n    envelope: {\n      id: spec.id as unknown as IMemoryRecord<unknown>['envelope']['id'],\n      entityId: (spec.entityId ?? spec.id) as EntityId,\n      kind: spec.kind ?? knowledgeKind,\n      tags: (spec.tags ?? []) as unknown as IMemoryRecord<unknown>['envelope']['tags'],\n      links: [],\n      created: 0,\n      updated: 0,\n      seq: 0,\n      contentHash: '',\n      provenance: { source: 'agent' }\n    },\n    body: spec.body\n  };\n}\n\ndescribe('FileTreeMemoryStore rank axis', () => {\n  let clockValue: number;\n  const clock = (): number => clockValue;\n\n  beforeEach(() => {\n    clockValue = 1000;\n  });\n\n  function createStore(\n    params: {\n      root?: FileTree.IMutableFileTreeDirectoryItem;\n      rankProjectors?: ReadonlyMap<Kind, RankProjector>;\n      writePolicies?: ReadonlyMap<Kind, IWritePolicy>;\n      logger?: Logging.ILogger;\n    } = {}\n  ): Result<FileTreeMemoryStore> {\n    return FileTreeMemoryStore.create({\n      root: params.root ?? mutableRoot(),\n      registry: registry(),\n      codecs,\n      writePolicies: params.writePolicies,\n      rankProjectors: params.rankProjectors,\n      logger: params.logger,\n      clock\n    });\n  }\n\n  const knowledgeProjectors: ReadonlyMap<Kind, RankProjector> = new Map<Kind, RankProjector>([\n    [knowledgeKind, lengthProjector]\n  ]);\n\n  describe('put stamps rank (flat / non-versioned path)', () => {\n    test('runs the kind projector and stamps the numeric result', async () => {\n      const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBe(4);\n        }\n      );\n    });\n\n    test('leaves rank absent for a kind with no projector', async () => {\n      const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();\n      expect(\n        await store.put(makeRecord({ id: 'p-1', kind: plainKind, body: 'anything' }))\n      ).toSucceedAndSatisfy((rec: IMemoryRecord<unknown>) => {\n        expect(rec.envelope.rank).toBeUndefined();\n      });\n    });\n\n    test('is byte-identical (rank absent) when no projector map is wired', async () => {\n      const store = createStore().orThrow();\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBeUndefined();\n        }\n      );\n    });\n  });\n\n  describe('body revision re-stamps rank (staleness contract)', () => {\n    test('a body-only revision recomputes rank against the current body', async () => {\n      const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'ab' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBe(2);\n        }\n      );\n      clockValue = 2000;\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcdef' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBe(6);\n          expect(rec.envelope.updated).toBe(2000);\n        }\n      );\n    });\n  });\n\n  describe('throwing projector degrades to rank-absent', () => {\n    test('logs a warn and leaves rank absent without failing the write', async () => {\n      const logger = new Logging.InMemoryLogger();\n      const store = createStore({\n        rankProjectors: new Map<Kind, RankProjector>([[knowledgeKind, throwingProjector]]),\n        logger\n      }).orThrow();\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBeUndefined();\n        }\n      );\n      expect(logger.logged.some((m) => /rank projector threw/i.test(m))).toBe(true);\n    });\n\n    test('an UPDATE whose projector throws CLEARS the prior rank (flat path staleness contract)', async () => {\n      let shouldThrow: boolean = false;\n      const flakyProjector: RankProjector = (record) => {\n        if (shouldThrow) {\n          throw new Error('projector boom');\n        }\n        return (record.body as string).length;\n      };\n      const store = createStore({\n        rankProjectors: new Map<Kind, RankProjector>([[knowledgeKind, flakyProjector]])\n      }).orThrow();\n      // First write succeeds → rank stamped to a nonzero value.\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBe(4);\n        }\n      );\n      // Update with a body revision while the projector now throws → the prior\n      // rank (4) must NOT survive; the record is stamped rank-absent.\n      shouldThrow = true;\n      clockValue = 2000;\n      expect(await store.put(makeRecord({ id: 'doc-a', body: 'abcdefgh' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBeUndefined();\n          expect(rec.envelope.updated).toBe(2000);\n        }\n      );\n    });\n\n    test('an UPDATE whose projector throws CLEARS the prior rank (versioned path staleness contract)', async () => {\n      let shouldThrow: boolean = false;\n      const flakyProjector: RankProjector = (record) => {\n        if (shouldThrow) {\n          throw new Error('projector boom');\n        }\n        return (record.body as string).length;\n      };\n      const store = createStore({\n        rankProjectors: new Map<Kind, RankProjector>([[factKind, flakyProjector]]),\n        writePolicies: temporalPolicies\n      }).orThrow();\n      expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aa' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBe(2);\n        }\n      );\n      shouldThrow = true;\n      clockValue = 2000;\n      // The new version merges over the current version (which carried rank 2);\n      // the throwing projector must clear it so the new version is rank-absent.\n      expect(\n        await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aaaaa' }))\n      ).toSucceedAndSatisfy((rec: IMemoryRecord<unknown>) => {\n        expect(rec.envelope.rank).toBeUndefined();\n      });\n    });\n  });\n\n  describe('put stamps rank (versioned / temporal path)', () => {\n    const factProjectors: ReadonlyMap<Kind, RankProjector> = new Map<Kind, RankProjector>([\n      [factKind, lengthProjector]\n    ]);\n\n    test('stamps rank on the first version and re-stamps on a subsequent version', async () => {\n      const store = createStore({\n        rankProjectors: factProjectors,\n        writePolicies: temporalPolicies\n      }).orThrow();\n      expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aa' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBe(2);\n        }\n      );\n      clockValue = 2000;\n      expect(\n        await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aaaaa' }))\n      ).toSucceedAndSatisfy((rec: IMemoryRecord<unknown>) => {\n        expect(rec.envelope.rank).toBe(5);\n      });\n    });\n\n    test('leaves rank absent on the versioned path when the kind has no projector', async () => {\n      const store = createStore({ writePolicies: temporalPolicies }).orThrow();\n      expect(await store.put(makeRecord({ id: 'fact-1', kind: factKind, body: 'aa' }))).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown>) => {\n          expect(rec.envelope.rank).toBeUndefined();\n        }\n      );\n    });\n  });\n\n  describe('persistence round-trip', () => {\n    test('rank serializes to frontmatter and reloads on rebuild (no recompute-on-load)', async () => {\n      const root = mutableRoot();\n      const store = createStore({ root, rankProjectors: knowledgeProjectors }).orThrow();\n      await store.put(makeRecord({ id: 'doc-a', body: 'abcd' }));\n\n      // Read the raw persisted file and confirm rank is in the frontmatter.\n      const scopeDir = root\n        .getChildren()\n        .orThrow()\n        .find((c): c is FileTree.IFileTreeDirectoryItem => c.type === 'directory' && c.name === 'knowledge');\n      expect(scopeDir).toBeDefined();\n      const file = scopeDir!\n        .getChildren()\n        .orThrow()\n        .find((c): c is FileTree.IFileTreeFileItem => c.type === 'file' && c.name === 'doc-a.md');\n      expect(file).toBeDefined();\n      const raw = file!.getRawContents().orThrow();\n      expect(parseMemoryFile(raw, registry())).toSucceedAndSatisfy((rec: IMemoryRecord<unknown>) => {\n        expect(rec.envelope.rank).toBe(4);\n      });\n\n      // A brand-new store over the same root reloads rank from frontmatter WITHOUT any projector wired.\n      const reloaded = createStore({ root }).orThrow();\n      expect(await reloaded.getById('knowledge' as MemoryScopeKey, 'doc-a' as never)).toSucceedAndSatisfy(\n        (rec: IMemoryRecord<unknown> | undefined) => {\n          expect(rec?.envelope.rank).toBe(4);\n        }\n      );\n    });\n  });\n\n  describe('orderBy: rank retrieval (store-stamped ranks flow end-to-end)', () => {\n    async function indexFromStore(store: FileTreeMemoryStore): Promise<MemoryIndex> {\n      const records = (await store.list()).orThrow();\n      const index = MemoryIndex.create().orThrow();\n      // Scope is not returned by `list`; a per-id synthetic scope keeps the\n      // (scope, id) index keys distinct, which is all ordering needs here.\n      index\n        .rebuild(\n          records.map((record) => ({ scope: record.envelope.id as unknown as MemoryScopeKey, record }))\n        )\n        .orThrow();\n      return index;\n    }\n\n    test('orders by store-stamped rank descending, honoring kinds + limit + offset', async () => {\n      const store = createStore({ rankProjectors: knowledgeProjectors }).orThrow();\n      // ranks: a=1, bbb=3, cc=2 (by body length)\n      await store.put(makeRecord({ id: 'a', body: 'a' }));\n      await store.put(makeRecord({ id: 'bbb', body: 'bbb' }));\n      await store.put(makeRecord({ id: 'cc', body: 'cc' }));\n      // A plain-kind record has no projector → rank absent → sorts last.\n      await store.put(makeRecord({ id: 'p', kind: plainKind, body: 'zzzz' }));\n\n      const retriever = RecencyRetriever.create(await indexFromStore(store)).orThrow();\n      expect(await retriever.retrieve({ orderBy: 'rank' })).toSucceedAndSatisfy(\n        (records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n          expect(records.map((r) => r.envelope.id)).toEqual(['bbb', 'cc', 'a', 'p']);\n        }\n      );\n\n      // Kind-set scoped, rank-ordered, paged: skip the top, take one.\n      expect(\n        await retriever.retrieve({ kinds: [knowledgeKind], orderBy: 'rank', limit: 1, offset: 1 })\n      ).toSucceedAndSatisfy((records: ReadonlyArray<IMemoryRecord<unknown>>) => {\n        expect(records.map((r) => r.envelope.id)).toEqual(['cc']);\n      });\n    });\n  });\n});\n"]}

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

@@ -1,24 +0,0 @@
-/*
- * Copyright (c) 2026 Erik Fortune
- * SPDX-License-Identifier: MIT
- */
-import '@fgv/ts-utils-jest';
-import { defaultMemoryScopeEncoding } from '../../../index';
-describe('defaultMemoryScopeEncoding', () => {
-    test('passes a single portable segment through', () => {
-        expect(defaultMemoryScopeEncoding('knowledge')).toSucceedWith('knowledge');
-    });
-    test('validates and rejoins a multi-segment scope', () => {
-        expect(defaultMemoryScopeEncoding('conversations/conv-1')).toSucceedWith('conversations/conv-1');
-    });
-    test('rejects a segment outside the portable filename set', () => {
-        expect(defaultMemoryScopeEncoding('conversations/bad:seg')).toFailWith(/portable filename set/i);
-    });
-    test('rejects an empty path segment', () => {
-        expect(defaultMemoryScopeEncoding('conversations//c1')).toFailWith(/empty path segment/i);
-    });
-    test('rejects a reserved Windows device segment', () => {
-        expect(defaultMemoryScopeEncoding('conversations/CON')).toFailWith(/reserved Windows device/i);
-    });
-});
-//# sourceMappingURL=scopeEncoding.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"scopeEncoding.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/scopeEncoding.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,EAAkB,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5E,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,0BAA0B,CAAC,WAA6B,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,0BAA0B,CAAC,sBAAwC,CAAC,CAAC,CAAC,aAAa,CACxF,sBAAsB,CACvB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,0BAA0B,CAAC,uBAAyC,CAAC,CAAC,CAAC,UAAU,CACtF,wBAAwB,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,0BAA0B,CAAC,mBAAqC,CAAC,CAAC,CAAC,UAAU,CAClF,qBAAqB,CACtB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,0BAA0B,CAAC,mBAAqC,CAAC,CAAC,CAAC,UAAU,CAClF,0BAA0B,CAC3B,CAAC;IACJ,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 { MemoryScopeKey, defaultMemoryScopeEncoding } from '../../../index';\n\ndescribe('defaultMemoryScopeEncoding', () => {\n  test('passes a single portable segment through', () => {\n    expect(defaultMemoryScopeEncoding('knowledge' as MemoryScopeKey)).toSucceedWith('knowledge');\n  });\n\n  test('validates and rejoins a multi-segment scope', () => {\n    expect(defaultMemoryScopeEncoding('conversations/conv-1' as MemoryScopeKey)).toSucceedWith(\n      'conversations/conv-1'\n    );\n  });\n\n  test('rejects a segment outside the portable filename set', () => {\n    expect(defaultMemoryScopeEncoding('conversations/bad:seg' as MemoryScopeKey)).toFailWith(\n      /portable filename set/i\n    );\n  });\n\n  test('rejects an empty path segment', () => {\n    expect(defaultMemoryScopeEncoding('conversations//c1' as MemoryScopeKey)).toFailWith(\n      /empty path segment/i\n    );\n  });\n\n  test('rejects a reserved Windows device segment', () => {\n    expect(defaultMemoryScopeEncoding('conversations/CON' as MemoryScopeKey)).toFailWith(\n      /reserved Windows device/i\n    );\n  });\n});\n"]}