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

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

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

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

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

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

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

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

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

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

@@ -1,111 +0,0 @@
-"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 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 mtmRecord(entityId, idStem, body) {
-    return {
-        envelope: index_1.envelopeConverter
-            .convert({
-            id: idStem,
-            entityId,
-            kind: 'mtm',
-            tags: [],
-            links: [],
-            created: 0,
-            updated: 0,
-            seq: 0,
-            contentHash: '',
-            provenance: { source: 'agent' }
-        })
-            .orThrow(),
-        body
-    };
-}
-// Deterministic keyword-count embedder (no network): the record's vector and a
-// query's vector live in the same space so cosine ordering is 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) => Promise.resolve(ts_utils_1.Converters.string.convert(r.body).onSuccess((body) => (0, ts_utils_1.succeed)(featureVector(body))));
-function mtmStore() {
-    const registry = index_1.BodyConverterRegistry.create().orThrow();
-    registry.register(mtmKind, ts_utils_1.Converters.string);
-    return index_1.FileTreeMemoryStore.create({
-        root: mutableRoot(),
-        registry,
-        codecs: new Map([[mtmKind, new index_1.MtmIdentityCodec()]])
-    }).orThrow();
-}
-describe('FileTreeMemoryStore.listScoped', () => {
-    test('yields an empty list for an empty store', async () => {
-        expect(await mtmStore().listScoped()).toSucceedWith([]);
-    });
-    test('pairs each record with its scope-qualified (scope, id) address', async () => {
-        const store = mtmStore();
-        (await store.put(mtmRecord('conv-1:3', 'turn-3', 'cat cat'))).orThrow();
-        expect(await store.listScoped()).toSucceedAndSatisfy((scoped) => {
-            expect(scoped).toHaveLength(1);
-            expect(scoped[0].target).toEqual({ scope: 'conversations/conv-1', id: 'turn-3' });
-            expect(scoped[0].record.envelope.id).toBe('turn-3');
-            expect(scoped[0].record.body).toBe('cat cat');
-        });
-    });
-    test('lists two same-stem records in different scopes as distinct entries', async () => {
-        // conv-1:3 and conv-2:3 both mint the idStem 'turn-3' but under different
-        // scopes — exactly the ambiguity a bare MemoryId could not disambiguate.
-        const store = mtmStore();
-        (await store.put(mtmRecord('conv-1:3', 'turn-3', 'cat'))).orThrow();
-        (await store.put(mtmRecord('conv-2:3', 'turn-3', 'dog'))).orThrow();
-        expect(await store.listScoped()).toSucceedAndSatisfy((scoped) => {
-            expect(scoped).toHaveLength(2);
-            const byScope = new Map(scoped.map((s) => [s.target.scope, s.target]));
-            expect(byScope.get('conversations/conv-1')).toEqual({
-                scope: 'conversations/conv-1',
-                id: 'turn-3'
-            });
-            expect(byScope.get('conversations/conv-2')).toEqual({
-                scope: 'conversations/conv-2',
-                id: 'turn-3'
-            });
-        });
-    });
-});
-describe('FileTreeMemoryStore.asRecordSource — drives an IVectorIndex rebuild', () => {
-    test('a real store re-indexes an InMemoryCosineIndex on the scoped key', async () => {
-        const store = mtmStore();
-        (await store.put(mtmRecord('conv-1:3', 'turn-3', 'cat'))).orThrow();
-        (await store.put(mtmRecord('conv-2:3', 'turn-3', 'dog'))).orThrow();
-        const index = index_1.InMemoryCosineIndex.create().orThrow();
-        // The store satisfies IMemoryRecordSource via asRecordSource(); rebuild
-        // re-embeds every record and keys each vector on the scoped (scope, id).
-        expect(await index.rebuild(store.asRecordSource(), recordEmbed)).toSucceedWith(2);
-        expect(index.size).toBe(2);
-        // The two same-stem records occupy DISTINCT vector entries: a query for 'cat'
-        // resolves the conv-1 record; a query for 'dog' resolves conv-2 — each hit
-        // carries the full scoped target, not a bare (colliding) id.
-        expect(await index.query(featureVector('cat'), 1)).toSucceedAndSatisfy((hits) => {
-            expect(hits[0].target).toEqual({ scope: 'conversations/conv-1', id: 'turn-3' });
-        });
-        expect(await index.query(featureVector('dog'), 1)).toSucceedAndSatisfy((hits) => {
-            expect(hits[0].target).toEqual({ scope: 'conversations/conv-2', id: 'turn-3' });
-        });
-    });
-});
-//# sourceMappingURL=listScoped.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"listScoped.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/listScoped.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, Result, succeed } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  BodyConverterRegistry,\n  FileTreeMemoryStore,\n  IBodyConverterRegistry,\n  IIdentityCodec,\n  IMemoryRecord,\n  IScopedMemoryRecord,\n  IVectorQueryHit,\n  InMemoryCosineIndex,\n  Kind,\n  MemoryScopeKey,\n  MtmIdentityCodec,\n  envelopeConverter\n} from '../../../index';\n\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 mtmRecord(entityId: string, idStem: string, body: string): IMemoryRecord<unknown> {\n  return {\n    envelope: envelopeConverter\n      .convert({\n        id: idStem,\n        entityId,\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// Deterministic keyword-count embedder (no network): the record's vector and a\n// query's vector live in the same space so cosine ordering is predictable.\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  Promise.resolve(Converters.string.convert(r.body).onSuccess((body) => succeed(featureVector(body))));\n\nfunction mtmStore(): FileTreeMemoryStore {\n  const registry: IBodyConverterRegistry = BodyConverterRegistry.create().orThrow();\n  registry.register(mtmKind, Converters.string);\n  return FileTreeMemoryStore.create({\n    root: mutableRoot(),\n    registry,\n    codecs: new Map<Kind, IIdentityCodec>([[mtmKind, new MtmIdentityCodec()]])\n  }).orThrow();\n}\n\ndescribe('FileTreeMemoryStore.listScoped', () => {\n  test('yields an empty list for an empty store', async () => {\n    expect(await mtmStore().listScoped()).toSucceedWith([]);\n  });\n\n  test('pairs each record with its scope-qualified (scope, id) address', async () => {\n    const store = mtmStore();\n    (await store.put(mtmRecord('conv-1:3', 'turn-3', 'cat cat'))).orThrow();\n    expect(await store.listScoped()).toSucceedAndSatisfy((scoped: ReadonlyArray<IScopedMemoryRecord>) => {\n      expect(scoped).toHaveLength(1);\n      expect(scoped[0].target).toEqual({ scope: 'conversations/conv-1', id: 'turn-3' });\n      expect(scoped[0].record.envelope.id).toBe('turn-3');\n      expect(scoped[0].record.body).toBe('cat cat');\n    });\n  });\n\n  test('lists two same-stem records in different scopes as distinct entries', async () => {\n    // conv-1:3 and conv-2:3 both mint the idStem 'turn-3' but under different\n    // scopes — exactly the ambiguity a bare MemoryId could not disambiguate.\n    const store = mtmStore();\n    (await store.put(mtmRecord('conv-1:3', 'turn-3', 'cat'))).orThrow();\n    (await store.put(mtmRecord('conv-2:3', 'turn-3', 'dog'))).orThrow();\n    expect(await store.listScoped()).toSucceedAndSatisfy((scoped: ReadonlyArray<IScopedMemoryRecord>) => {\n      expect(scoped).toHaveLength(2);\n      const byScope = new Map(scoped.map((s) => [s.target.scope, s.target]));\n      expect(byScope.get('conversations/conv-1' as MemoryScopeKey)).toEqual({\n        scope: 'conversations/conv-1',\n        id: 'turn-3'\n      });\n      expect(byScope.get('conversations/conv-2' as MemoryScopeKey)).toEqual({\n        scope: 'conversations/conv-2',\n        id: 'turn-3'\n      });\n    });\n  });\n});\n\ndescribe('FileTreeMemoryStore.asRecordSource — drives an IVectorIndex rebuild', () => {\n  test('a real store re-indexes an InMemoryCosineIndex on the scoped key', async () => {\n    const store = mtmStore();\n    (await store.put(mtmRecord('conv-1:3', 'turn-3', 'cat'))).orThrow();\n    (await store.put(mtmRecord('conv-2:3', 'turn-3', 'dog'))).orThrow();\n\n    const index = InMemoryCosineIndex.create().orThrow();\n    // The store satisfies IMemoryRecordSource via asRecordSource(); rebuild\n    // re-embeds every record and keys each vector on the scoped (scope, id).\n    expect(await index.rebuild(store.asRecordSource(), recordEmbed)).toSucceedWith(2);\n    expect(index.size).toBe(2);\n\n    // The two same-stem records occupy DISTINCT vector entries: a query for 'cat'\n    // resolves the conv-1 record; a query for 'dog' resolves conv-2 — each hit\n    // carries the full scoped target, not a bare (colliding) id.\n    expect(await index.query(featureVector('cat'), 1)).toSucceedAndSatisfy(\n      (hits: ReadonlyArray<IVectorQueryHit>) => {\n        expect(hits[0].target).toEqual({ scope: 'conversations/conv-1', id: 'turn-3' });\n      }\n    );\n    expect(await index.query(featureVector('dog'), 1)).toSucceedAndSatisfy(\n      (hits: ReadonlyArray<IVectorQueryHit>) => {\n        expect(hits[0].target).toEqual({ scope: 'conversations/conv-2', id: 'turn-3' });\n      }\n    );\n  });\n});\n"]}

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

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

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

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