@fortemi/core 2026.9.4 → 2026.9.5

package/dist/index.js

@@ -2,7 +2,7 @@ import { v7, v5 } from 'uuid';
 import { sha256 } from '@noble/hashes/sha256';
 import { blake3 } from '@noble/hashes/blake3';
 import { bytesToHex } from '@noble/hashes/utils';
-import Ajv20202 from 'ajv/dist/2020.js';
+import Ajv20203 from 'ajv/dist/2020.js';
 import { gzipSync, gunzipSync } from 'fflate';
 import { z } from 'zod';
 
@@ -4215,6 +4215,479 @@ function compareAssertions(left, right) {
 
 // src/dataset-execution-capabilities.ts
 init_geometry_buffer();
+
+// schemas/dataset-execution-capabilities/validation/1.0.1/schema.json
+var schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://fortemi.dev/schemas/dataset-execution-capabilities/validation/1.0.1.schema.json",
+  title: "Dataset Capability Validation Revision 1.0.1 (v1 wire)",
+  oneOf: [
+    {
+      $ref: "#/$defs/descriptor"
+    },
+    {
+      $ref: "#/$defs/request"
+    },
+    {
+      $ref: "#/$defs/result"
+    }
+  ],
+  $defs: {
+    capabilityId: {
+      enum: [
+        "ingest.full",
+        "ingest.snapshot",
+        "ingest.incremental",
+        "ingest.stream",
+        "schema.inspect",
+        "identity.stable-revision",
+        "identity.record",
+        "mutation.upsert",
+        "mutation.tombstone",
+        "mutation.reconcile",
+        "checkpoint.read",
+        "checkpoint.write",
+        "execution.cancel",
+        "rejection.record",
+        "index.lexical",
+        "index.chunk",
+        "index.vector",
+        "index.hybrid",
+        "index.rerank",
+        "index.graph",
+        "index.community",
+        "lineage.dataset",
+        "lineage.record",
+        "lineage.field",
+        "lineage.relationship-evidence",
+        "transaction.atomic-batch",
+        "privacy.pre-materialization-filter",
+        "pagination.cursor",
+        "ordering.deterministic"
+      ]
+    },
+    semver: {
+      type: "string",
+      maxLength: 256,
+      pattern: "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-((?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?$(?![\\s\\S])"
+    },
+    digest: {
+      type: "string",
+      pattern: "^[a-z0-9]+:[a-f0-9]+$"
+    },
+    limits: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        maxInputBytes: {
+          type: "integer",
+          minimum: 0,
+          maximum: 9007199254740991
+        },
+        maxRecordBytes: {
+          type: "integer",
+          minimum: 0,
+          maximum: 9007199254740991
+        },
+        maxBatchRecords: {
+          type: "integer",
+          minimum: 0,
+          maximum: 9007199254740991
+        },
+        maxConcurrency: {
+          type: "integer",
+          minimum: 0,
+          maximum: 9007199254740991
+        },
+        maxPageSize: {
+          type: "integer",
+          minimum: 0,
+          maximum: 9007199254740991
+        },
+        maxTraversalDepth: {
+          type: "integer",
+          minimum: 0,
+          maximum: 9007199254740991
+        }
+      }
+    },
+    evidence: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id",
+        "kind",
+        "uri"
+      ],
+      properties: {
+        id: {
+          type: "string",
+          minLength: 1
+        },
+        kind: {
+          enum: [
+            "fixture",
+            "conformance-report",
+            "live-qualification"
+          ]
+        },
+        uri: {
+          type: "string",
+          minLength: 1
+        },
+        digest: {
+          $ref: "#/$defs/digest"
+        }
+      }
+    },
+    capability: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id",
+        "version",
+        "status",
+        "evidence"
+      ],
+      properties: {
+        id: {
+          $ref: "#/$defs/capabilityId"
+        },
+        version: {
+          $ref: "#/$defs/semver"
+        },
+        status: {
+          enum: [
+            "supported",
+            "experimental",
+            "unsupported"
+          ]
+        },
+        limits: {
+          $ref: "#/$defs/limits"
+        },
+        evidence: {
+          type: "array",
+          items: {
+            type: "string",
+            minLength: 1
+          },
+          uniqueItems: true
+        }
+      }
+    },
+    runtime: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id",
+        "version",
+        "plane",
+        "dataClass",
+        "maturity"
+      ],
+      properties: {
+        id: {
+          type: "string",
+          minLength: 1
+        },
+        version: {
+          $ref: "#/$defs/semver"
+        },
+        plane: {
+          enum: [
+            "browser-local-archive",
+            "static-cache",
+            "portable-shard",
+            "server-process",
+            "live-remote-persistence"
+          ]
+        },
+        dataClass: {
+          enum: [
+            "canonical",
+            "regenerable-index",
+            "static-cache",
+            "portable-projection",
+            "remote-persistence"
+          ]
+        },
+        maturity: {
+          enum: [
+            "experimental",
+            "alpha",
+            "beta",
+            "stable"
+          ]
+        }
+      }
+    },
+    guarantees: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "transaction",
+        "isolation",
+        "durability",
+        "availability",
+        "ordering"
+      ],
+      properties: {
+        transaction: {
+          enum: [
+            "none",
+            "single-record",
+            "atomic-batch"
+          ]
+        },
+        isolation: {
+          enum: [
+            "none",
+            "snapshot",
+            "serializable"
+          ]
+        },
+        durability: {
+          enum: [
+            "process",
+            "memory",
+            "filesystem",
+            "wal",
+            "replicated"
+          ]
+        },
+        availability: {
+          enum: [
+            "local-process",
+            "single-host",
+            "remote-service"
+          ]
+        },
+        ordering: {
+          enum: [
+            "unspecified",
+            "stable-identity",
+            "backend-cursor"
+          ]
+        }
+      }
+    },
+    descriptor: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "contract",
+        "schemaVersion",
+        "runtime",
+        "guarantees",
+        "capabilities",
+        "evidence"
+      ],
+      properties: {
+        contract: {
+          const: "fortemi.dataset-execution-capabilities/v1"
+        },
+        schemaVersion: {
+          $ref: "#/$defs/semver"
+        },
+        runtime: {
+          $ref: "#/$defs/runtime"
+        },
+        guarantees: {
+          $ref: "#/$defs/guarantees"
+        },
+        capabilities: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/capability"
+          }
+        },
+        evidence: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/evidence"
+          }
+        }
+      }
+    },
+    requirement: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id"
+      ],
+      properties: {
+        id: {
+          $ref: "#/$defs/capabilityId"
+        },
+        minimumVersion: {
+          $ref: "#/$defs/semver"
+        },
+        minimumLimits: {
+          $ref: "#/$defs/limits"
+        }
+      }
+    },
+    optionalRequirement: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id"
+      ],
+      properties: {
+        id: {
+          $ref: "#/$defs/capabilityId"
+        },
+        minimumVersion: {
+          $ref: "#/$defs/semver"
+        },
+        minimumLimits: {
+          $ref: "#/$defs/limits"
+        },
+        fallback: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/capabilityId"
+          },
+          uniqueItems: true
+        }
+      }
+    },
+    request: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "contract",
+        "required"
+      ],
+      properties: {
+        contract: {
+          const: "fortemi.dataset-execution-capabilities/v1"
+        },
+        required: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/requirement"
+          }
+        },
+        optional: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/optionalRequirement"
+          }
+        }
+      }
+    },
+    diagnostic: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "code",
+        "message"
+      ],
+      properties: {
+        code: {
+          enum: [
+            "CONTRACT_MAJOR_UNSUPPORTED",
+            "SCHEMA_VERSION_UNSUPPORTED",
+            "DESCRIPTOR_INVALID",
+            "CAPABILITY_DUPLICATE",
+            "CAPABILITY_INCONSISTENT",
+            "REQUIRED_CAPABILITY_MISSING",
+            "CAPABILITY_VERSION_INSUFFICIENT",
+            "CAPABILITY_LIMIT_INSUFFICIENT"
+          ]
+        },
+        capability: {
+          $ref: "#/$defs/capabilityId"
+        },
+        path: {
+          type: "string"
+        },
+        message: {
+          type: "string",
+          minLength: 1
+        }
+      }
+    },
+    degradation: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "requested",
+        "reason",
+        "changedGuarantees"
+      ],
+      properties: {
+        requested: {
+          $ref: "#/$defs/capabilityId"
+        },
+        selected: {
+          $ref: "#/$defs/capabilityId"
+        },
+        reason: {
+          enum: [
+            "unsupported",
+            "version-insufficient",
+            "limit-insufficient"
+          ]
+        },
+        changedGuarantees: {
+          type: "array",
+          minItems: 1,
+          items: {
+            type: "string",
+            minLength: 1
+          }
+        }
+      }
+    },
+    result: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "contract",
+        "accepted",
+        "runtime",
+        "selected",
+        "degradations",
+        "diagnostics"
+      ],
+      properties: {
+        contract: {
+          const: "fortemi.dataset-execution-capabilities/v1"
+        },
+        accepted: {
+          type: "boolean"
+        },
+        runtime: {
+          $ref: "#/$defs/runtime"
+        },
+        selected: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/capabilityId"
+          },
+          uniqueItems: true
+        },
+        degradations: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/degradation"
+          }
+        },
+        diagnostics: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/diagnostic"
+          }
+        }
+      }
+    }
+  }
+};
+
+// src/dataset-execution-capabilities.ts
 var DATASET_EXECUTION_CONTRACT = "fortemi.dataset-execution-capabilities/v1";
 var DATASET_EXECUTION_SCHEMA_VERSION = "1.0.0";
 var DATASET_EXECUTION_CAPABILITY_IDS = [
@@ -4250,27 +4723,64 @@ var DATASET_EXECUTION_CAPABILITY_IDS = [
 ];
 var ID_SET = new Set(DATASET_EXECUTION_CAPABILITY_IDS);
 var LIMIT_KEYS = ["maxInputBytes", "maxRecordBytes", "maxBatchRecords", "maxConcurrency", "maxPageSize", "maxTraversalDepth"];
+var versionPattern = new RegExp(schema_default.$defs.semver.pattern);
+var ajv = new Ajv20203({ strict: true, allErrors: false });
+ajv.addSchema(schema_default);
+var descriptorStructure = ajv.compile({ $ref: schema_default.$id + "#/$defs/descriptor" });
+var requestStructure = ajv.compile({ $ref: schema_default.$id + "#/$defs/request" });
+function parseVersion(value) {
+  if (typeof value !== "string" || value.length > 256) return null;
+  const match = versionPattern.exec(value);
+  if (!match || match[0] !== value) return null;
+  const core = match.slice(1, 4).map(Number);
+  if (!core.every(Number.isSafeInteger)) return null;
+  return { core, prerelease: match[4]?.split(".") ?? [] };
+}
 function major(version) {
-  const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version);
-  return match ? Number(match[1]) : null;
+  const parsed = parseVersion(version);
+  return parsed && parsed.prerelease.length === 0 ? parsed.core[0] : null;
 }
 function compareVersions(left, right) {
-  const parse = (value) => {
-    const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(value);
-    return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
-  };
-  const a = parse(left);
-  const b = parse(right);
+  const a = parseVersion(left);
+  const b = parseVersion(right);
   if (!a || !b) return null;
   for (let index = 0; index < 3; index++) {
-    if (a[index] !== b[index]) return a[index] > b[index] ? 1 : -1;
+    if (a.core[index] !== b.core[index]) return a.core[index] > b.core[index] ? 1 : -1;
+  }
+  if (!a.prerelease.length || !b.prerelease.length) {
+    return a.prerelease.length ? -1 : b.prerelease.length ? 1 : 0;
+  }
+  for (let index = 0; index < Math.max(a.prerelease.length, b.prerelease.length); index++) {
+    const leftPart = a.prerelease[index];
+    const rightPart = b.prerelease[index];
+    if (leftPart === rightPart) continue;
+    if (leftPart === void 0) return -1;
+    if (rightPart === void 0) return 1;
+    const leftNumeric = /^[0-9]+$/.test(leftPart);
+    const rightNumeric = /^[0-9]+$/.test(rightPart);
+    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;
+    if (leftNumeric && leftPart.length !== rightPart.length) return leftPart.length > rightPart.length ? 1 : -1;
+    return leftPart > rightPart ? 1 : -1;
   }
   return 0;
 }
 function isSupported(capability) {
-  return capability !== void 0 && capability.status !== "unsupported";
+  return capability !== void 0 && (capability.status === "supported" || capability.status === "experimental");
+}
+function structuralDiagnostics(validate3, prefix = "") {
+  return (validate3.errors ?? []).slice(0, 8).map((error) => ({
+    code: "DESCRIPTOR_INVALID",
+    path: (prefix + error.instancePath).slice(0, 256),
+    message: "Invalid capability wire structure: " + error.keyword
+  }));
 }
 function validateDatasetExecutionDescriptor(descriptor) {
+  if (!descriptorStructure(descriptor)) {
+    if (descriptor && typeof descriptor === "object" && "contract" in descriptor && descriptor.contract !== DATASET_EXECUTION_CONTRACT) {
+      return [{ code: "CONTRACT_MAJOR_UNSUPPORTED", path: "/contract", message: "Unsupported descriptor contract" }];
+    }
+    return structuralDiagnostics(descriptorStructure);
+  }
   const diagnostics = [];
   if (descriptor.contract !== DATASET_EXECUTION_CONTRACT) {
     diagnostics.push({ code: "CONTRACT_MAJOR_UNSUPPORTED", path: "/contract", message: `Unsupported contract ${String(descriptor.contract)}` });
@@ -4278,6 +4788,9 @@ function validateDatasetExecutionDescriptor(descriptor) {
   if (major(descriptor.schemaVersion) !== 1) {
     diagnostics.push({ code: "SCHEMA_VERSION_UNSUPPORTED", path: "/schemaVersion", message: `Unsupported descriptor schema version ${descriptor.schemaVersion}` });
   }
+  if (!parseVersion(descriptor.runtime.version)) {
+    diagnostics.push({ code: "DESCRIPTOR_INVALID", path: "/runtime/version", message: "Invalid runtime semantic version" });
+  }
   const capabilities = /* @__PURE__ */ new Map();
   descriptor.capabilities.forEach((capability, index) => {
     if (!ID_SET.has(capability.id) || compareVersions(capability.version, capability.version) === null) {
@@ -4299,7 +4812,7 @@ function validateDatasetExecutionDescriptor(descriptor) {
     }
     for (const evidenceId of capability.evidence) {
       if (!descriptor.evidence.some((evidence) => evidence.id === evidenceId)) {
-        diagnostics.push({ code: "DESCRIPTOR_INVALID", capability: capability.id, path: `/capabilities/${index}/evidence`, message: `Unknown evidence ${evidenceId}` });
+        diagnostics.push({ code: "DESCRIPTOR_INVALID", capability: capability.id, path: `/capabilities/${index}/evidence`, message: "Capability references undeclared evidence" });
       }
     }
   });
@@ -4326,12 +4839,37 @@ function validateDatasetExecutionDescriptor(descriptor) {
   }
   return diagnostics;
 }
+function validateDatasetExecutionRequest(request) {
+  if (!requestStructure(request)) {
+    if (request && typeof request === "object" && "contract" in request && request.contract !== DATASET_EXECUTION_CONTRACT) {
+      return [{ code: "CONTRACT_MAJOR_UNSUPPORTED", path: "/request/contract", message: "Unsupported request contract" }];
+    }
+    return structuralDiagnostics(requestStructure, "/request");
+  }
+  const diagnostics = [];
+  for (const [group, requirements] of [["required", request.required], ["optional", request.optional ?? []]]) {
+    requirements.forEach((requirement, index) => {
+      if (requirement.minimumVersion !== void 0 && !parseVersion(requirement.minimumVersion)) {
+        diagnostics.push({ code: "DESCRIPTOR_INVALID", path: "/request/" + group + "/" + index + "/minimumVersion", message: "Invalid required semantic version" });
+      }
+    });
+  }
+  return diagnostics;
+}
+function negotiateDatasetExecutionCapabilitiesFromWire(descriptor, request) {
+  const diagnostics = [...validateDatasetExecutionDescriptor(descriptor), ...validateDatasetExecutionRequest(request)];
+  if (diagnostics.length) return { valid: false, diagnostics };
+  return {
+    valid: true,
+    result: negotiateDatasetExecutionCapabilities(descriptor, request)
+  };
+}
 function assessRequirement(requirement, capabilities) {
   const capability = capabilities.get(requirement.id);
   if (!isSupported(capability)) {
     return { ok: false, reason: "unsupported", diagnostics: [{ code: "REQUIRED_CAPABILITY_MISSING", capability: requirement.id, message: `Capability ${requirement.id} is unsupported` }] };
   }
-  if (requirement.minimumVersion) {
+  if (requirement.minimumVersion !== void 0) {
     const comparison = compareVersions(capability.version, requirement.minimumVersion);
     if (comparison === null || comparison < 0) {
       return { ok: false, reason: "version-insufficient", diagnostics: [{ code: "CAPABILITY_VERSION_INSUFFICIENT", capability: requirement.id, message: `${capability.version} does not satisfy ${requirement.minimumVersion}` }] };
@@ -4346,11 +4884,8 @@ function assessRequirement(requirement, capabilities) {
   return { ok: true, diagnostics: [] };
 }
 function negotiateDatasetExecutionCapabilities(descriptor, request) {
-  const diagnostics = validateDatasetExecutionDescriptor(descriptor);
-  if (request.contract !== DATASET_EXECUTION_CONTRACT) {
-    diagnostics.push({ code: "CONTRACT_MAJOR_UNSUPPORTED", path: "/contract", message: `Unsupported request contract ${String(request.contract)}` });
-  }
-  const capabilities = new Map(descriptor.capabilities.map((capability) => [capability.id, capability]));
+  const diagnostics = [...validateDatasetExecutionDescriptor(descriptor), ...validateDatasetExecutionRequest(request)];
+  const capabilities = new Map(diagnostics.length ? [] : descriptor.capabilities.map((capability) => [capability.id, capability]));
   const selected = [];
   const degradations = [];
   if (diagnostics.length === 0) {
@@ -4378,7 +4913,7 @@ function negotiateDatasetExecutionCapabilities(descriptor, request) {
   return {
     contract: DATASET_EXECUTION_CONTRACT,
     accepted: diagnostics.length === 0,
-    runtime: { ...descriptor.runtime },
+    runtime: { ...descriptor?.runtime },
     selected: [...new Set(selected)],
     degradations,
     diagnostics
@@ -4542,7 +5077,7 @@ async function executeDatasetMaterialization(request, runtime, adapter, authoriz
   }
   const selected = [request.profile, ...options.fallbackProfiles ?? []].find((item) => item.id === negotiation.selectedProfile);
   try {
-    const validateConfiguration = new Ajv20202({ strict: true, allErrors: true }).compile(selected.configurationSchema);
+    const validateConfiguration = new Ajv20203({ strict: true, allErrors: true }).compile(selected.configurationSchema);
     if (!validateConfiguration(request.configuration)) {
       throw new DatasetMaterializationError("CONFIGURATION_INVALID", `Configuration does not satisfy ${selected.id}: ${JSON.stringify(validateConfiguration.errors)}`);
     }
@@ -18704,15 +19239,15 @@ init_geometry_buffer();
 var CURRENT_SHARD_VERSION = "1.2.0";
 var MAX_SHARD_READER_VERSION = "2.0.0";
 var SHARD_FORMAT = "matric-shard";
-function parseVersion(value) {
+function parseVersion2(value) {
   return value.split(".").map((segment) => {
     const match = segment.match(/^\d+/);
     return match ? Number.parseInt(match[0], 10) : 0;
   });
 }
 function compareShardVersions(left, right) {
-  const leftParts = parseVersion(left);
-  const rightParts = parseVersion(right);
+  const leftParts = parseVersion2(left);
+  const rightParts = parseVersion2(right);
   const length = Math.max(leftParts.length, rightParts.length);
   for (let index = 0; index < length; index += 1) {
     const leftValue = leftParts[index] ?? 0;
@@ -19004,13 +19539,13 @@ function getKnowledgeShardSchema() {
 function getKnowledgeShardContractReceipt() {
   return knowledge_shard_schema_receipt_default;
 }
-function addCanonicalFormats(ajv) {
-  ajv.addFormat("uuid", /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-  ajv.addFormat("date-time", {
+function addCanonicalFormats(ajv2) {
+  ajv2.addFormat("uuid", /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
+  ajv2.addFormat("date-time", {
     type: "string",
     validate: (value) => /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(value) && !Number.isNaN(Date.parse(value))
   });
-  ajv.addFormat("uri", {
+  ajv2.addFormat("uri", {
     type: "string",
     validate: (value) => {
       try {
@@ -19023,7 +19558,7 @@ function addCanonicalFormats(ajv) {
 }
 function getLegacyAjv() {
   if (!legacyAjvInstance) {
-    legacyAjvInstance = new Ajv20202({
+    legacyAjvInstance = new Ajv20203({
       allErrors: true,
       strict: true,
       validateFormats: false
@@ -19034,7 +19569,7 @@ function getLegacyAjv() {
 }
 function getCoreAjv() {
   if (!coreAjvInstance) {
-    coreAjvInstance = new Ajv20202({
+    coreAjvInstance = new Ajv20203({
       allErrors: true,
       strict: true,
       validateFormats: true
@@ -19054,7 +19589,7 @@ function getCoreAjv() {
 }
 function getRecordAjv() {
   if (!recordAjvInstance) {
-    recordAjvInstance = new Ajv20202({
+    recordAjvInstance = new Ajv20203({
       allErrors: true,
       strict: true,
       validateFormats: true
@@ -19074,7 +19609,7 @@ function getRecordAjv() {
 }
 function getFullAjv() {
   if (!fullAjvInstance) {
-    fullAjvInstance = new Ajv20202({
+    fullAjvInstance = new Ajv20203({
       allErrors: true,
       strict: true,
       validateFormats: true
@@ -43361,7 +43896,7 @@ function getAiwgFortemiIndexExportSchema() {
 }
 function getAjv() {
   if (!ajvInstance) {
-    ajvInstance = new Ajv20202({
+    ajvInstance = new Ajv20203({
       allErrors: true,
       strict: false,
       validateFormats: false
@@ -46917,7 +47452,7 @@ async function purgeRecordStoreGraph(store, selector, operationKey) {
 }
 
 // src/index.ts
-var VERSION = "2026.9.4";
+var VERSION = "2026.9.5";
 /*! Bundled license information:
 
 ieee754/index.js:
@@ -46932,6 +47467,6 @@ buffer/index.js:
    *)
 */
 
-export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, BridgeInferenceProvider, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DATASET_EXECUTION_CAPABILITY_IDS, DATASET_EXECUTION_CONTRACT, DATASET_EXECUTION_SCHEMA_VERSION, DATASET_INGEST_CONTRACT, DATASET_INGEST_SCHEMA_VERSION, DATASET_LINEAGE_CONTRACT, DATASET_LINEAGE_SCHEMA_VERSION, DATASET_MATERIALIZATION_CONTRACT, DATASET_MATERIALIZATION_KINDS, DATASET_MATERIALIZATION_SCHEMA_VERSION, DB_SNAPSHOT_SCHEMA_VERSION, DEFAULT_LARGE_DOCUMENT_CHARS, DEFAULT_LARGE_DOCUMENT_CHUNKS, DatasetIngestError, DatasetIngestExecutor, DatasetLineageLedger, DatasetMaterializationError, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_BROWSER_LOCAL_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_PORTABLE_SHARD_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FORTEMI_SERVER_COMPATIBILITY_REVISION, FORTEMI_STATIC_CACHE_DATASET_EXECUTION_DESCRIPTOR, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LINEAGE_ENTITY_KINDS, LINEAGE_RELATIONSHIP_KINDS, LOCAL_ENDPOINTS, LifecyclePurgeRepository, LineageValidationError, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryDatasetIngestStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, REGISTERED_METADATA_PATHS, RemoteBackendError, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SOURCE_UPSERT_CONTRACT_VERSION, SOURCE_UPSERT_MAX_ITEMS, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, SourceUpsertRepository, TagsRepository, TemplatesRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, aiwgFortemiIndexToKnowledgeShardWithReport, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildMetadataPredicateConditions, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, compareDatasetIncrementalParity, computeBlobHash, computeHash, computeLineageDigest, computeSri, conceptTaggingHandler, configureInferenceRuntime, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createBridgeInferenceProviders, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createLocalProviderProfile, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, datasetDestinationScopeKey, defaultStorageBackendFactory, defineInferenceProvider, defineInferenceRuntime, defineLegacyInferenceProvider, defineOpenAICompatibleProvider, deriveDatasetIngestIdempotencyKey, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, digestDatasetMaterializationValue, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, executeDatasetMaterialization, executeDatasetRetrieval, exportFullV1Snapshot, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getAiwgFortemiIndexExportSchema, getConfiguredInferenceProviderId, getEmbedFunction, getEmbeddingTaskSelectionOptions, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, getProviderRouteRequirementIssue, handleEmbedRequests, hasFortemiSecureSecrets, importFullV1Snapshot, importShard, importShardToRecords, inferInferenceTaskCapability, inferLocalEmbeddingDimensions, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, mergeInferenceRuntimeConfigs, migrateLegacyBlobStore, negotiateDatasetExecutionCapabilities, negotiateDatasetMaterializationProfile, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, previewRecordStorePurge, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, providerSatisfiesRouteRequirements, purgeRecordStoreGraph, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectEmbeddingTask, selectLlmModel, setEmbedFunction, setEmbeddingTaskSelectionOptions, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, upsertRecordStoreRequest, upsertRecordStoreSources, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateDatasetBenchmarkEvidence, validateDatasetExecutionDescriptor, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateProviderRoute, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
+export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, BridgeInferenceProvider, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DATASET_EXECUTION_CAPABILITY_IDS, DATASET_EXECUTION_CONTRACT, DATASET_EXECUTION_SCHEMA_VERSION, DATASET_INGEST_CONTRACT, DATASET_INGEST_SCHEMA_VERSION, DATASET_LINEAGE_CONTRACT, DATASET_LINEAGE_SCHEMA_VERSION, DATASET_MATERIALIZATION_CONTRACT, DATASET_MATERIALIZATION_KINDS, DATASET_MATERIALIZATION_SCHEMA_VERSION, DB_SNAPSHOT_SCHEMA_VERSION, DEFAULT_LARGE_DOCUMENT_CHARS, DEFAULT_LARGE_DOCUMENT_CHUNKS, DatasetIngestError, DatasetIngestExecutor, DatasetLineageLedger, DatasetMaterializationError, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_BROWSER_LOCAL_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_PORTABLE_SHARD_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FORTEMI_SERVER_COMPATIBILITY_REVISION, FORTEMI_STATIC_CACHE_DATASET_EXECUTION_DESCRIPTOR, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LINEAGE_ENTITY_KINDS, LINEAGE_RELATIONSHIP_KINDS, LOCAL_ENDPOINTS, LifecyclePurgeRepository, LineageValidationError, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryDatasetIngestStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, REGISTERED_METADATA_PATHS, RemoteBackendError, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SOURCE_UPSERT_CONTRACT_VERSION, SOURCE_UPSERT_MAX_ITEMS, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, SourceUpsertRepository, TagsRepository, TemplatesRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, aiwgFortemiIndexToKnowledgeShardWithReport, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildMetadataPredicateConditions, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, compareDatasetIncrementalParity, computeBlobHash, computeHash, computeLineageDigest, computeSri, conceptTaggingHandler, configureInferenceRuntime, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createBridgeInferenceProviders, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createLocalProviderProfile, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, datasetDestinationScopeKey, defaultStorageBackendFactory, defineInferenceProvider, defineInferenceRuntime, defineLegacyInferenceProvider, defineOpenAICompatibleProvider, deriveDatasetIngestIdempotencyKey, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, digestDatasetMaterializationValue, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, executeDatasetMaterialization, executeDatasetRetrieval, exportFullV1Snapshot, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getAiwgFortemiIndexExportSchema, getConfiguredInferenceProviderId, getEmbedFunction, getEmbeddingTaskSelectionOptions, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, getProviderRouteRequirementIssue, handleEmbedRequests, hasFortemiSecureSecrets, importFullV1Snapshot, importShard, importShardToRecords, inferInferenceTaskCapability, inferLocalEmbeddingDimensions, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, mergeInferenceRuntimeConfigs, migrateLegacyBlobStore, negotiateDatasetExecutionCapabilities, negotiateDatasetExecutionCapabilitiesFromWire, negotiateDatasetMaterializationProfile, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, previewRecordStorePurge, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, providerSatisfiesRouteRequirements, purgeRecordStoreGraph, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectEmbeddingTask, selectLlmModel, setEmbedFunction, setEmbeddingTaskSelectionOptions, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, upsertRecordStoreRequest, upsertRecordStoreSources, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateDatasetBenchmarkEvidence, validateDatasetExecutionDescriptor, validateDatasetExecutionRequest, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateProviderRoute, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map