@fortemi/core 2026.9.4 → 2026.9.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fortemi/core",
-  "version": "2026.9.4",
+  "version": "2026.9.6",
   "description": "Browser-only knowledge management core: PGlite (PostgreSQL WASM), MCP tools, hybrid search, and profile-scoped Knowledge Shard interchange.",
   "keywords": [
     "fortemi",
@@ -53,6 +53,7 @@
       "import": "./dist/aiwg-index-shard.js"
     },
     "./schemas/dataset-execution-capabilities/v1": "./schemas/dataset-execution-capabilities/v1.schema.json",
+    "./schemas/dataset-execution-capabilities/validation/1.0.1": "./schemas/dataset-execution-capabilities/validation/1.0.1/schema.json",
     "./schemas/dataset-ingest/v1": "./schemas/dataset-ingest/v1.schema.json",
     "./schemas/dataset-lineage/v1": "./schemas/dataset-lineage/v1.schema.json",
     "./schemas/dataset-materialization/v1": "./schemas/dataset-materialization/v1.schema.json",
@@ -68,6 +69,7 @@
     "schemas/dataset-lineage",
     "schemas/dataset-materialization",
     "schemas/source-note-upsert",
+    "schemas/metadata-search/candidate",
     "benchmarks/dataset-materialization",
     "tools",
     "README.md",
@@ -89,12 +91,12 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^4.1.1",
+    "@vitest/coverage-v8": "4.1.1",
     "esbuild": "0.27.4",
     "fake-indexeddb": "^6.2.5",
     "tsup": "^8.3.5",
     "typescript": "^5.8.0",
-    "vitest": "^4.1.0"
+    "vitest": "4.1.1"
   },
   "scripts": {
     "build": "tsup && node scripts/canonicalize-declarations.mjs dist/index.d.ts dist/aiwg-index.d.ts dist/aiwg-index-schema.d.ts dist/aiwg-index-shard.d.ts",

package/schemas/dataset-execution-capabilities/validation/1.0.1/manifest.json

@@ -0,0 +1,29 @@
+{
+  "contract": "fortemi.dataset-capability-validation/v1",
+  "revision": "1.0.1",
+  "wireContract": "fortemi.dataset-execution-capabilities/v1",
+  "authority": {
+    "repository": "Fortemi/fortemi-react",
+    "issue": 422
+  },
+  "files": [
+    {
+      "path": "schema.json",
+      "sha256": "a4e9b427da669a02e83db00d39f48c2e106770d6cd2ec1b717938c57793b754c"
+    },
+    {
+      "path": "negotiation-vectors.json",
+      "sha256": "2793990a842d5969f1f64c90170ab97ca4ffc4b93d1302a2f358fae54631a6dc"
+    },
+    {
+      "path": "wire-vectors.json",
+      "sha256": "c52d32d0b1d0d312cf8b242f11fc116c47d104a74112cbd5d0019e6d39df9744"
+    }
+  ],
+  "consumers": [
+    "Fortemi/fortemi-react Core and materialization negotiation",
+    "Fortemi/fortemi MCP dataset execution",
+    "roctinam/aiwg dataset execution"
+  ],
+  "qualification": "Core source and local built entry only; exact consumer pins and clean installed/live acceptance remain required"
+}

package/schemas/dataset-execution-capabilities/validation/1.0.1/negotiation-vectors.json

@@ -0,0 +1,127 @@
+{
+  "revision": "1.0.1",
+  "authority": "Fortemi/fortemi-react#422",
+  "scope": "Capability SemVer negotiation, not runtime qualification",
+  "versions": [
+    {
+      "id": "prerelease-stable",
+      "offered": "1.0.0-alpha",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "numeric-prerelease",
+      "offered": "1.0.0-beta.2",
+      "minimum": "1.0.0-beta.11",
+      "accepted": false
+    },
+    {
+      "id": "numeric-before-text",
+      "offered": "1.0.0-9",
+      "minimum": "1.0.0-alpha",
+      "accepted": false
+    },
+    {
+      "id": "shorter-prerelease",
+      "offered": "1.0.0-alpha",
+      "minimum": "1.0.0-alpha.1",
+      "accepted": false
+    },
+    {
+      "id": "stable-prerelease",
+      "offered": "1.0.0",
+      "minimum": "1.0.0-rc.1",
+      "accepted": true
+    },
+    {
+      "id": "build-ignored",
+      "offered": "1.0.0+001",
+      "minimum": "1.0.0+999",
+      "accepted": true
+    },
+    {
+      "id": "prerelease-and-build",
+      "offered": "1.0.0-alpha+001",
+      "minimum": "1.0.0-alpha+999",
+      "accepted": true
+    },
+    {
+      "id": "multi-digit",
+      "offered": "1.10.0",
+      "minimum": "1.9.0",
+      "accepted": true
+    },
+    {
+      "id": "ascii-order",
+      "offered": "1.0.0-Z",
+      "minimum": "1.0.0-a",
+      "accepted": false
+    },
+    {
+      "id": "large-numeric-prerelease",
+      "offered": "1.0.0-9007199254740992",
+      "minimum": "1.0.0-9007199254740993",
+      "accepted": false
+    },
+    {
+      "id": "leading-zero-core",
+      "offered": "01.0.0",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "leading-zero-pre",
+      "offered": "1.0.0-01",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "empty-build",
+      "offered": "1.0.0+",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "empty-pre-segment",
+      "offered": "1.0.0-a..b",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "unsafe-core",
+      "offered": "9007199254740992.0.0",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "unsafe-request",
+      "offered": "1.0.0",
+      "minimum": "9007199254740992.0.0",
+      "accepted": false
+    },
+    {
+      "id": "empty-minimum",
+      "offered": "1.0.0",
+      "minimum": "",
+      "accepted": false
+    },
+    {
+      "id": "malformed-minimum",
+      "offered": "1.0.0",
+      "minimum": "broken",
+      "accepted": false
+    },
+    {
+      "id": "trailing-newline",
+      "offered": "1.0.0\n",
+      "minimum": "1.0.0",
+      "accepted": false
+    },
+    {
+      "id": "maximum-safe-core",
+      "offered": "9007199254740991.0.0",
+      "minimum": "1.0.0",
+      "accepted": true
+    }
+  ]
+}

package/schemas/dataset-execution-capabilities/validation/1.0.1/schema.json

@@ -0,0 +1,469 @@
+{
+  "$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"
+          }
+        }
+      }
+    }
+  }
+}