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

package/config/api-extractor.json

@@ -1,343 +0,0 @@
-/**
- * Config file for API Extractor.  For more info, please visit: https://api-extractor.com
- */
-{
-  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
-  /**
-   * Optionally specifies another JSON config file that this file extends from.  This provides a way for
-   * standard settings to be shared across multiple projects.
-   *
-   * If the path starts with "./" or "../", the path is resolved relative to the folder of the file that contains
-   * the "extends" field.  Otherwise, the first path segment is interpreted as an NPM package name, and will be
-   * resolved using NodeJS require().
-   *
-   * SUPPORTED TOKENS: none
-   * DEFAULT VALUE: ""
-   */
-  // "extends": "./shared/api-extractor-base.json"
-  // "extends": "my-package/include/api-extractor-base.json"
-  /**
-   * Determines the "<projectFolder>" token that can be used with other config file settings.  The project folder
-   * typically contains the tsconfig.json and package.json config files, but the path is user-defined.
-   *
-   * The path is resolved relative to the folder of the config file that contains the setting.
-   *
-   * The default value for "projectFolder" is the token "<lookup>", which means the folder is determined by traversing
-   * parent folders, starting from the folder containing api-extractor.json, and stopping at the first folder
-   * that contains a tsconfig.json file.  If a tsconfig.json file cannot be found in this way, then an error
-   * will be reported.
-   *
-   * SUPPORTED TOKENS: <lookup>
-   * DEFAULT VALUE: "<lookup>"
-   */
-  "projectFolder": "..",
-  /**
-   * (REQUIRED) Specifies the .d.ts file to be used as the starting point for analysis.  API Extractor
-   * analyzes the symbols exported by this module.
-   *
-   * The file extension must be ".d.ts" and not ".ts".
-   *
-   * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-   * prepend a folder token such as "<projectFolder>".
-   *
-   * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-   */
-  "mainEntryPointFilePath": "<projectFolder>/lib/index.d.ts",
-  /**
-   * A list of NPM package names whose exports should be treated as part of this package.
-   *
-   * For example, suppose that Webpack is used to generate a distributed bundle for the project "library1",
-   * and another NPM package "library2" is embedded in this bundle.  Some types from library2 may become part
-   * of the exported API for library1, but by default API Extractor would generate a .d.ts rollup that explicitly
-   * imports library2.  To avoid this, we can specify:
-   *
-   *   "bundledPackages": [ "library2" ],
-   *
-   * This would direct API Extractor to embed those types directly in the .d.ts rollup, as if they had been
-   * local files for library1.
-   */
-  "bundledPackages": [],
-  /**
-   * Determines how the TypeScript compiler engine will be invoked by API Extractor.
-   */
-  "compiler": {
-    /**
-     * Specifies the path to the tsconfig.json file to be used by API Extractor when analyzing the project.
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * Note: This setting will be ignored if "overrideTsconfig" is used.
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<projectFolder>/tsconfig.json"
-     */
-    // "tsconfigFilePath": "<projectFolder>/tsconfig.json",
-    /**
-     * Provides a compiler configuration that will be used instead of reading the tsconfig.json file from disk.
-     * The object must conform to the TypeScript tsconfig schema:
-     *
-     * http://json.schemastore.org/tsconfig
-     *
-     * If omitted, then the tsconfig.json file will be read from the "projectFolder".
-     *
-     * DEFAULT VALUE: no overrideTsconfig section
-     */
-    // "overrideTsconfig": {
-    //   . . .
-    // }
-    /**
-     * This option causes the compiler to be invoked with the --skipLibCheck option. This option is not recommended
-     * and may cause API Extractor to produce incomplete or incorrect declarations, but it may be required when
-     * dependencies contain declarations that are incompatible with the TypeScript engine that API Extractor uses
-     * for its analysis.  Where possible, the underlying issue should be fixed rather than relying on skipLibCheck.
-     *
-     * DEFAULT VALUE: false
-     */
-    // "skipLibCheck": true,
-  },
-  /**
-   * Configures how the API report file (*.api.md) will be generated.
-   */
-  "apiReport": {
-    /**
-     * (REQUIRED) Whether to generate an API report.
-     */
-    "enabled": true
-    /**
-     * The filename for the API report files.  It will be combined with "reportFolder" or "reportTempFolder" to produce
-     * a full file path.
-     *
-     * The file extension should be ".api.md", and the string should not contain a path separator such as "\" or "/".
-     *
-     * SUPPORTED TOKENS: <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<unscopedPackageName>.api.md"
-     */
-    // "reportFileName": "<unscopedPackageName>.api.md",
-    /**
-     * Specifies the folder where the API report file is written.  The file name portion is determined by
-     * the "reportFileName" setting.
-     *
-     * The API report file is normally tracked by Git.  Changes to it can be used to trigger a branch policy,
-     * e.g. for an API review.
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<projectFolder>/etc/"
-     */
-    // "reportFolder": "<projectFolder>/etc/",
-    /**
-     * Specifies the folder where the temporary report file is written.  The file name portion is determined by
-     * the "reportFileName" setting.
-     *
-     * After the temporary file is written to disk, it is compared with the file in the "reportFolder".
-     * If they are different, a production build will fail.
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<projectFolder>/temp/"
-     */
-    // "reportTempFolder": "<projectFolder>/temp/"
-  },
-  /**
-   * Configures how the doc model file (*.api.json) will be generated.
-   */
-  "docModel": {
-    /**
-     * (REQUIRED) Whether to generate a doc model file.
-     */
-    "enabled": true
-    /**
-     * The output path for the doc model file.  The file extension should be ".api.json".
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<projectFolder>/temp/<unscopedPackageName>.api.json"
-     */
-    // "apiJsonFilePath": "<projectFolder>/temp/<unscopedPackageName>.api.json"
-  },
-  /**
-   * Configures how the .d.ts rollup file will be generated.
-   */
-  "dtsRollup": {
-    /**
-     * (REQUIRED) Whether to generate the .d.ts rollup file.
-     */
-    "enabled": true
-    /**
-     * Specifies the output path for a .d.ts rollup file to be generated without any trimming.
-     * This file will include all declarations that are exported by the main entry point.
-     *
-     * If the path is an empty string, then this file will not be written.
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<projectFolder>/dist/<unscopedPackageName>.d.ts"
-     */
-    // "untrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.d.ts",
-    /**
-     * Specifies the output path for a .d.ts rollup file to be generated with trimming for a "beta" release.
-     * This file will include only declarations that are marked as "@public" or "@beta".
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: ""
-     */
-    // "betaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-beta.d.ts",
-    /**
-     * Specifies the output path for a .d.ts rollup file to be generated with trimming for a "public" release.
-     * This file will include only declarations that are marked as "@public".
-     *
-     * If the path is an empty string, then this file will not be written.
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: ""
-     */
-    // "publicTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-public.d.ts",
-    /**
-     * When a declaration is trimmed, by default it will be replaced by a code comment such as
-     * "Excluded from this release type: exampleMember".  Set "omitTrimmingComments" to true to remove the
-     * declaration completely.
-     *
-     * DEFAULT VALUE: false
-     */
-    // "omitTrimmingComments": true
-  },
-  /**
-   * Configures how the tsdoc-metadata.json file will be generated.
-   */
-  "tsdocMetadata": {
-    /**
-     * Whether to generate the tsdoc-metadata.json file.
-     *
-     * DEFAULT VALUE: true
-     */
-    // "enabled": true,
-    /**
-     * Specifies where the TSDoc metadata file should be written.
-     *
-     * The path is resolved relative to the folder of the config file that contains the setting; to change this,
-     * prepend a folder token such as "<projectFolder>".
-     *
-     * The default value is "<lookup>", which causes the path to be automatically inferred from the "tsdocMetadata",
-     * "typings" or "main" fields of the project's package.json.  If none of these fields are set, the lookup
-     * falls back to "tsdoc-metadata.json" in the package folder.
-     *
-     * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
-     * DEFAULT VALUE: "<lookup>"
-     */
-    // "tsdocMetadataFilePath": "<projectFolder>/dist/tsdoc-metadata.json"
-  },
-  /**
-   * Specifies what type of newlines API Extractor should use when writing output files.  By default, the output files
-   * will be written with Windows-style newlines.  To use POSIX-style newlines, specify "lf" instead.
-   * To use the OS's default newline kind, specify "os".
-   *
-   * DEFAULT VALUE: "crlf"
-   */
-  // "newlineKind": "crlf",
-  /**
-   * Configures how API Extractor reports error and warning messages produced during analysis.
-   *
-   * There are three sources of messages:  compiler messages, API Extractor messages, and TSDoc messages.
-   */
-  "messages": {
-    /**
-     * Configures handling of diagnostic messages reported by the TypeScript compiler engine while analyzing
-     * the input .d.ts files.
-     *
-     * TypeScript message identifiers start with "TS" followed by an integer.  For example: "TS2551"
-     *
-     * DEFAULT VALUE:  A single "default" entry with logLevel=warning.
-     */
-    "compilerMessageReporting": {
-      /**
-       * Configures the default routing for messages that don't match an explicit rule in this table.
-       */
-      "default": {
-        /**
-         * Specifies whether the message should be written to the the tool's output log.  Note that
-         * the "addToApiReportFile" property may supersede this option.
-         *
-         * Possible values: "error", "warning", "none"
-         *
-         * Errors cause the build to fail and return a nonzero exit code.  Warnings cause a production build fail
-         * and return a nonzero exit code.  For a non-production build (e.g. when "api-extractor run" includes
-         * the "--local" option), the warning is displayed but the build will not fail.
-         *
-         * DEFAULT VALUE: "warning"
-         */
-        "logLevel": "warning"
-        /**
-         * When addToApiReportFile is true:  If API Extractor is configured to write an API report file (.api.md),
-         * then the message will be written inside that file; otherwise, the message is instead logged according to
-         * the "logLevel" option.
-         *
-         * DEFAULT VALUE: false
-         */
-        // "addToApiReportFile": false
-      }
-      // "TS2551": {
-      //   "logLevel": "warning",
-      //   "addToApiReportFile": true
-      // },
-      //
-      // . . .
-    },
-    /**
-     * Configures handling of messages reported by API Extractor during its analysis.
-     *
-     * API Extractor message identifiers start with "ae-".  For example: "ae-extra-release-tag"
-     *
-     * DEFAULT VALUE: See api-extractor-defaults.json for the complete table of extractorMessageReporting mappings
-     */
-    "extractorMessageReporting": {
-      "default": {
-        "logLevel": "warning"
-        // "addToApiReportFile": false
-      },
-      "ae-unresolved-link": {
-        "logLevel": "none",
-        "addToApiReportFile": true
-      }
-      // "ae-extra-release-tag": {
-      //   "logLevel": "warning",
-      //   "addToApiReportFile": true
-      // },
-      //
-      // . . .
-    },
-    /**
-     * Configures handling of messages reported by the TSDoc parser when analyzing code comments.
-     *
-     * TSDoc message identifiers start with "tsdoc-".  For example: "tsdoc-link-tag-unescaped-text"
-     *
-     * DEFAULT VALUE:  A single "default" entry with logLevel=warning.
-     */
-    "tsdocMessageReporting": {
-      "default": {
-        "logLevel": "warning"
-        // "addToApiReportFile": false
-      }
-      // "tsdoc-link-tag-unescaped-text": {
-      //   "logLevel": "warning",
-      //   "addToApiReportFile": true
-      // },
-      //
-      // . . .
-    }
-  }
-}

package/config/jest.config.json

@@ -1,14 +0,0 @@
-{
-  "extends": "@fgv/heft-dual-rig/profiles/default/config/jest.config.json",
-  "coveragePathIgnorePatterns": ["index.js"],
-  "coverageThreshold": {
-    "global": {
-      "branches": 100,
-      "functions": 100,
-      "lines": 100,
-      "statements": 100
-    }
-  },
-  "collectCoverage": true,
-  "coverageReporters": ["text", "lcov", "html"]
-}

package/config/rig.json

@@ -1,4 +0,0 @@
-{
-  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
-  "rigPackageName": "@fgv/heft-dual-rig"
-}

package/dist/test/unit/converters/antagonistRoundTrip.test.js

@@ -1,95 +0,0 @@
-/*
- * Copyright (c) 2026 Erik Fortune
- * SPDX-License-Identifier: MIT
- */
-/**
- * Antagonist torture test — convert/validate round-trip symmetry (target class
- * 7): every OPTIONAL field the envelope/edge/provenance shapes carry must
- * survive a full on-disk round-trip (serialize → YAML text → parse), not just a
- * single `Converter.convert` pass in memory. This exercises the exact path a
- * corrupted or field-dropping serializer/parser pair would break, mirroring the
- * `aiClientToolConfig`/`annotations` field-drop class named in the brief.
- */
-import '@fgv/ts-utils-jest';
-import { Converters } from '@fgv/ts-utils';
-import { BodyConverterRegistry, parseMemoryFile, serializeMemoryFile } from '../../../index';
-const kind = 'note';
-function registry() {
-    const reg = BodyConverterRegistry.create().orThrow();
-    reg.register(kind, Converters.string);
-    return reg;
-}
-describe('antagonist — full on-disk round-trip preserves every optional field', () => {
-    // Wrong impl this catches: a serializer/parser pair where one side silently
-    // drops an optional field (the exact class of bug the brief calls out for
-    // `aiClientToolConfig`/`annotations`-shaped converters) — e.g. omitting
-    // `temporal.invalid_at: null`, an edge's `valid_at`/`invalid_at`/`provenance`,
-    // a `null` `embeddingRef`, or a provenance extension key, because the author
-    // forgot to thread it through both the YAML emit AND the envelope Converter.
-    test('every optional envelope/edge/provenance field set simultaneously survives a full YAML round-trip', () => {
-        const envelope = {
-            id: 'doc-1',
-            entityId: 'doc-1',
-            kind,
-            tags: ['t1', 't2'],
-            links: [
-                {
-                    type: 'rel',
-                    target: { scope: 'knowledge', id: 'doc-2' },
-                    confidence: 0.42,
-                    provenance: { source: 'agent', by: 'curator', extra: { nested: true } },
-                    valid_at: 111,
-                    invalid_at: null
-                }
-            ],
-            created: 1000,
-            updated: 2000,
-            seq: 7,
-            contentHash: 'abc123',
-            provenance: {
-                source: 'host-ingest',
-                by: 'erik',
-                model: 'gpt-5',
-                confidence: 0.87,
-                derivedFrom: { scope: 'conversations/c1', id: 'turn-3' },
-                // Opaque extension keys (per IProvenance's `[key: string]: unknown` arm).
-                sentiment: { score: 0.5 },
-                epistemic: 'belief'
-            },
-            temporal: { valid_at: 500, invalid_at: null },
-            embeddingRef: null
-        };
-        const raw = serializeMemoryFile(envelope, 'the body text').orThrow();
-        expect(parseMemoryFile(raw, registry())).toSucceedAndSatisfy((record) => {
-            // Deep-equal the ENTIRE envelope, not field-by-field — a partial assertion
-            // list is exactly how a single dropped field slips through review.
-            expect(record.envelope).toEqual(envelope);
-            expect(record.body).toBe('the body text');
-        });
-    });
-    test('an absent temporal/embeddingRef/edge-optionals round-trips to fully absent (no null-vs-undefined drift)', () => {
-        const envelope = {
-            id: 'doc-2',
-            entityId: 'doc-2',
-            kind,
-            tags: [],
-            links: [{ type: 'rel', target: { scope: 'knowledge', id: 'doc-3' } }],
-            created: 0,
-            updated: 0,
-            seq: 0,
-            contentHash: '',
-            provenance: { source: 'agent' }
-        };
-        const raw = serializeMemoryFile(envelope, 'body').orThrow();
-        expect(parseMemoryFile(raw, registry())).toSucceedAndSatisfy((record) => {
-            expect(record.envelope.temporal).toBeUndefined();
-            expect(record.envelope.embeddingRef).toBeUndefined();
-            expect(record.envelope.links[0].confidence).toBeUndefined();
-            expect(record.envelope.links[0].provenance).toBeUndefined();
-            expect(record.envelope.links[0].valid_at).toBeUndefined();
-            expect(record.envelope.links[0].invalid_at).toBeUndefined();
-            expect(record.envelope).toEqual(envelope);
-        });
-    });
-});
-//# sourceMappingURL=antagonistRoundTrip.test.js.map

package/dist/test/unit/converters/antagonistRoundTrip.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"antagonistRoundTrip.test.js","sourceRoot":"","sources":["../../../../src/test/unit/converters/antagonistRoundTrip.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,qBAAqB,EAGrB,eAAe,EACf,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB,MAAM,IAAI,GAAG,MAAiC,CAAC;AAE/C,SAAS,QAAQ;IACf,MAAM,GAAG,GAAG,qBAAqB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACrD,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,QAAQ,CAAC,qEAAqE,EAAE,GAAG,EAAE;IACnF,4EAA4E;IAC5E,0EAA0E;IAC1E,wEAAwE;IACxE,+EAA+E;IAC/E,6EAA6E;IAC7E,6EAA6E;IAC7E,IAAI,CAAC,kGAAkG,EAAE,GAAG,EAAE;QAC5G,MAAM,QAAQ,GAAoB;YAChC,EAAE,EAAE,OAAgC;YACpC,QAAQ,EAAE,OAAsC;YAChD,IAAI;YACJ,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAuC;YACxD,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,KAAc;oBACpB,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAW;oBACpD,UAAU,EAAE,IAAI;oBAChB,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;oBACvE,QAAQ,EAAE,GAAG;oBAEb,UAAU,EAAE,IAAI;iBACjB;aACF;YACD,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,CAAC;YACN,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE;gBACV,MAAM,EAAE,aAAa;gBACrB,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,EAAE,QAAQ,EAAW;gBACjE,0EAA0E;gBAC1E,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;gBACzB,SAAS,EAAE,QAAQ;aACpB;YAED,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;YAE7C,YAAY,EAAE,IAAI;SACnB,CAAC;QAEF,MAAM,GAAG,GAAG,mBAAmB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,EAAE,EAAE;YACtE,2EAA2E;YAC3E,mEAAmE;YACnE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yGAAyG,EAAE,GAAG,EAAE;QACnH,MAAM,QAAQ,GAAoB;YAChC,EAAE,EAAE,OAAgC;YACpC,QAAQ,EAAE,OAAsC;YAChD,IAAI;YACJ,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAW,EAAE,CAAC;YACvF,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;QACF,MAAM,GAAG,GAAG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5D,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,EAAE,EAAE;YACtE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;YACrD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;YAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,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\n/**\n * Antagonist torture test — convert/validate round-trip symmetry (target class\n * 7): every OPTIONAL field the envelope/edge/provenance shapes carry must\n * survive a full on-disk round-trip (serialize → YAML text → parse), not just a\n * single `Converter.convert` pass in memory. This exercises the exact path a\n * corrupted or field-dropping serializer/parser pair would break, mirroring the\n * `aiClientToolConfig`/`annotations` field-drop class named in the brief.\n */\n\nimport '@fgv/ts-utils-jest';\nimport { Converters } from '@fgv/ts-utils';\nimport {\n  BodyConverterRegistry,\n  IBodyConverterRegistry,\n  IMemoryEnvelope,\n  parseMemoryFile,\n  serializeMemoryFile\n} from '../../../index';\n\nconst kind = 'note' as IMemoryEnvelope['kind'];\n\nfunction registry(): IBodyConverterRegistry {\n  const reg = BodyConverterRegistry.create().orThrow();\n  reg.register(kind, Converters.string);\n  return reg;\n}\n\ndescribe('antagonist — full on-disk round-trip preserves every optional field', () => {\n  // Wrong impl this catches: a serializer/parser pair where one side silently\n  // drops an optional field (the exact class of bug the brief calls out for\n  // `aiClientToolConfig`/`annotations`-shaped converters) — e.g. omitting\n  // `temporal.invalid_at: null`, an edge's `valid_at`/`invalid_at`/`provenance`,\n  // a `null` `embeddingRef`, or a provenance extension key, because the author\n  // forgot to thread it through both the YAML emit AND the envelope Converter.\n  test('every optional envelope/edge/provenance field set simultaneously survives a full YAML round-trip', () => {\n    const envelope: IMemoryEnvelope = {\n      id: 'doc-1' as IMemoryEnvelope['id'],\n      entityId: 'doc-1' as IMemoryEnvelope['entityId'],\n      kind,\n      tags: ['t1', 't2'] as unknown as IMemoryEnvelope['tags'],\n      links: [\n        {\n          type: 'rel' as never,\n          target: { scope: 'knowledge', id: 'doc-2' } as never,\n          confidence: 0.42,\n          provenance: { source: 'agent', by: 'curator', extra: { nested: true } },\n          valid_at: 111,\n\n          invalid_at: null\n        }\n      ],\n      created: 1000,\n      updated: 2000,\n      seq: 7,\n      contentHash: 'abc123',\n      provenance: {\n        source: 'host-ingest',\n        by: 'erik',\n        model: 'gpt-5',\n        confidence: 0.87,\n        derivedFrom: { scope: 'conversations/c1', id: 'turn-3' } as never,\n        // Opaque extension keys (per IProvenance's `[key: string]: unknown` arm).\n        sentiment: { score: 0.5 },\n        epistemic: 'belief'\n      },\n\n      temporal: { valid_at: 500, invalid_at: null },\n\n      embeddingRef: null\n    };\n\n    const raw = serializeMemoryFile(envelope, 'the body text').orThrow();\n    expect(parseMemoryFile(raw, registry())).toSucceedAndSatisfy((record) => {\n      // Deep-equal the ENTIRE envelope, not field-by-field — a partial assertion\n      // list is exactly how a single dropped field slips through review.\n      expect(record.envelope).toEqual(envelope);\n      expect(record.body).toBe('the body text');\n    });\n  });\n\n  test('an absent temporal/embeddingRef/edge-optionals round-trips to fully absent (no null-vs-undefined drift)', () => {\n    const envelope: IMemoryEnvelope = {\n      id: 'doc-2' as IMemoryEnvelope['id'],\n      entityId: 'doc-2' as IMemoryEnvelope['entityId'],\n      kind,\n      tags: [],\n      links: [{ type: 'rel' as never, target: { scope: 'knowledge', id: 'doc-3' } as never }],\n      created: 0,\n      updated: 0,\n      seq: 0,\n      contentHash: '',\n      provenance: { source: 'agent' }\n    };\n    const raw = serializeMemoryFile(envelope, 'body').orThrow();\n    expect(parseMemoryFile(raw, registry())).toSucceedAndSatisfy((record) => {\n      expect(record.envelope.temporal).toBeUndefined();\n      expect(record.envelope.embeddingRef).toBeUndefined();\n      expect(record.envelope.links[0].confidence).toBeUndefined();\n      expect(record.envelope.links[0].provenance).toBeUndefined();\n      expect(record.envelope.links[0].valid_at).toBeUndefined();\n      expect(record.envelope.links[0].invalid_at).toBeUndefined();\n      expect(record.envelope).toEqual(envelope);\n    });\n  });\n});\n"]}

package/dist/test/unit/converters/bodyConverterRegistry.test.js

@@ -1,72 +0,0 @@
-/*
- * Copyright (c) 2026 Erik Fortune
- * SPDX-License-Identifier: MIT
- */
-import '@fgv/ts-utils-jest';
-import { Converters } from '@fgv/ts-utils';
-import { JsonSchema } from '@fgv/ts-json-base';
-import { BodyConverterRegistry } from '../../../packlets/converters';
-const knowledgeKind = 'knowledge';
-const profileKind = 'profile';
-describe('BodyConverterRegistry', () => {
-    let registry;
-    beforeEach(() => {
-        registry = BodyConverterRegistry.create().orThrow();
-    });
-    test('create succeeds', () => {
-        expect(BodyConverterRegistry.create()).toSucceed();
-    });
-    describe('register / has / convert', () => {
-        test('registers a Converter and converts a matching body', () => {
-            registry.register(knowledgeKind, Converters.string);
-            expect(registry.has(knowledgeKind)).toBe(true);
-            expect(registry.convert(knowledgeKind, 'a knowledge doc')).toSucceedWith('a knowledge doc');
-        });
-        test('a registered Converter rejects an invalid body', () => {
-            registry.register(knowledgeKind, Converters.string);
-            expect(registry.convert(knowledgeKind, 42)).toFail();
-        });
-        test('has returns false for an unregistered kind', () => {
-            expect(registry.has(knowledgeKind)).toBe(false);
-        });
-        test('convert fails for an unregistered kind', () => {
-            expect(registry.convert(knowledgeKind, 'x')).toFailWith(/no converter registered for kind 'knowledge'/i);
-        });
-        test('register replaces a prior registration for the same kind', () => {
-            registry.register(knowledgeKind, Converters.string);
-            registry.register(knowledgeKind, Converters.number);
-            expect(registry.convert(knowledgeKind, 7)).toSucceedWith(7);
-            expect(registry.convert(knowledgeKind, 'x')).toFail();
-        });
-    });
-    describe('getConverter', () => {
-        test('returns the registered converter', () => {
-            registry.register(knowledgeKind, Converters.string);
-            expect(registry.getConverter(knowledgeKind)).toSucceedAndSatisfy((converter) => {
-                expect(converter.convert('hello')).toSucceedWith('hello');
-            });
-        });
-        test('fails for an unregistered kind', () => {
-            expect(registry.getConverter(knowledgeKind)).toFailWith(/no converter registered for kind/i);
-        });
-    });
-    describe('registerSchema', () => {
-        const profileSchema = JsonSchema.object({
-            name: JsonSchema.string(),
-            age: JsonSchema.integer()
-        });
-        test('registers a JsonSchema validator and validates a matching body', () => {
-            registry.registerSchema(profileKind, profileSchema);
-            expect(registry.has(profileKind)).toBe(true);
-            expect(registry.convert(profileKind, { name: 'Ada', age: 36 })).toSucceedWith({
-                name: 'Ada',
-                age: 36
-            });
-        });
-        test('a registered schema rejects an invalid body', () => {
-            registry.registerSchema(profileKind, profileSchema);
-            expect(registry.convert(profileKind, { name: 'Ada' })).toFail();
-        });
-    });
-});
-//# sourceMappingURL=bodyConverterRegistry.test.js.map

package/dist/test/unit/converters/bodyConverterRegistry.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bodyConverterRegistry.test.js","sourceRoot":"","sources":["../../../../src/test/unit/converters/bodyConverterRegistry.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 } from '@fgv/ts-utils';\nimport { JsonSchema } from '@fgv/ts-json-base';\nimport { BodyConverterRegistry } from '../../../packlets/converters';\nimport { Kind } from '../../../packlets/types';\n\nconst knowledgeKind: Kind = 'knowledge' as Kind;\nconst profileKind: Kind = 'profile' as Kind;\n\ndescribe('BodyConverterRegistry', () => {\n  let registry: BodyConverterRegistry;\n\n  beforeEach(() => {\n    registry = BodyConverterRegistry.create().orThrow();\n  });\n\n  test('create succeeds', () => {\n    expect(BodyConverterRegistry.create()).toSucceed();\n  });\n\n  describe('register / has / convert', () => {\n    test('registers a Converter and converts a matching body', () => {\n      registry.register(knowledgeKind, Converters.string);\n      expect(registry.has(knowledgeKind)).toBe(true);\n      expect(registry.convert(knowledgeKind, 'a knowledge doc')).toSucceedWith('a knowledge doc');\n    });\n\n    test('a registered Converter rejects an invalid body', () => {\n      registry.register(knowledgeKind, Converters.string);\n      expect(registry.convert(knowledgeKind, 42)).toFail();\n    });\n\n    test('has returns false for an unregistered kind', () => {\n      expect(registry.has(knowledgeKind)).toBe(false);\n    });\n\n    test('convert fails for an unregistered kind', () => {\n      expect(registry.convert(knowledgeKind, 'x')).toFailWith(\n        /no converter registered for kind 'knowledge'/i\n      );\n    });\n\n    test('register replaces a prior registration for the same kind', () => {\n      registry.register(knowledgeKind, Converters.string);\n      registry.register(knowledgeKind, Converters.number);\n      expect(registry.convert(knowledgeKind, 7)).toSucceedWith(7);\n      expect(registry.convert(knowledgeKind, 'x')).toFail();\n    });\n  });\n\n  describe('getConverter', () => {\n    test('returns the registered converter', () => {\n      registry.register(knowledgeKind, Converters.string);\n      expect(registry.getConverter(knowledgeKind)).toSucceedAndSatisfy((converter) => {\n        expect(converter.convert('hello')).toSucceedWith('hello');\n      });\n    });\n\n    test('fails for an unregistered kind', () => {\n      expect(registry.getConverter(knowledgeKind)).toFailWith(/no converter registered for kind/i);\n    });\n  });\n\n  describe('registerSchema', () => {\n    const profileSchema = JsonSchema.object({\n      name: JsonSchema.string(),\n      age: JsonSchema.integer()\n    });\n\n    test('registers a JsonSchema validator and validates a matching body', () => {\n      registry.registerSchema(profileKind, profileSchema);\n      expect(registry.has(profileKind)).toBe(true);\n      expect(registry.convert(profileKind, { name: 'Ada', age: 36 })).toSucceedWith({\n        name: 'Ada',\n        age: 36\n      });\n    });\n\n    test('a registered schema rejects an invalid body', () => {\n      registry.registerSchema(profileKind, profileSchema);\n      expect(registry.convert(profileKind, { name: 'Ada' })).toFail();\n    });\n  });\n});\n"]}