@fortemi/core 2026.7.15 → 2026.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fortemi/core",
-  "version": "2026.7.15",
+  "version": "2026.9.0",
   "description": "Browser-only knowledge management core: PGlite (PostgreSQL WASM), MCP tools, hybrid search, and profile-scoped Knowledge Shard interchange.",
   "keywords": [
     "fortemi",
@@ -52,12 +52,21 @@
       "types": "./dist/aiwg-index-shard.d.ts",
       "import": "./dist/aiwg-index-shard.js"
     },
+    "./schemas/dataset-execution-capabilities/v1": "./schemas/dataset-execution-capabilities/v1.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",
     "./worker/pglite-worker": "./dist/worker/pglite-worker.js",
     "./service-worker/sw": "./dist/service-worker/sw.js",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "schemas/dataset-execution-capabilities",
+    "schemas/dataset-ingest",
+    "schemas/dataset-lineage",
+    "schemas/dataset-materialization",
+    "benchmarks/dataset-materialization",
     "tools",
     "README.md",
     "LICENSE"

package/schemas/dataset-execution-capabilities/fixtures/browser-local.json

@@ -0,0 +1,14 @@
+{
+  "contract": "fortemi.dataset-execution-capabilities/v1",
+  "schemaVersion": "1.0.0",
+  "runtime": { "id": "fortemi-browser", "version": "2026.8.0", "plane": "browser-local-archive", "dataClass": "canonical", "maturity": "stable" },
+  "guarantees": { "transaction": "atomic-batch", "isolation": "serializable", "durability": "wal", "availability": "local-process", "ordering": "backend-cursor" },
+  "capabilities": [
+    { "id": "ingest.full", "version": "1.0.0", "status": "supported", "limits": { "maxBatchRecords": 1000, "maxConcurrency": 1 }, "evidence": ["browser-conformance"] },
+    { "id": "identity.record", "version": "1.0.0", "status": "supported", "evidence": ["browser-conformance"] },
+    { "id": "mutation.upsert", "version": "1.0.0", "status": "supported", "evidence": ["browser-conformance"] },
+    { "id": "transaction.atomic-batch", "version": "1.0.0", "status": "supported", "evidence": ["browser-conformance"] },
+    { "id": "ordering.deterministic", "version": "1.0.0", "status": "supported", "evidence": ["browser-conformance"] }
+  ],
+  "evidence": [{ "id": "browser-conformance", "kind": "conformance-report", "uri": "fixture://browser-local" }]
+}

package/schemas/dataset-execution-capabilities/fixtures/invalid-field-lineage-without-evidence.json

@@ -0,0 +1,10 @@
+{
+  "contract": "fortemi.dataset-execution-capabilities/v1",
+  "schemaVersion": "1.0.0",
+  "runtime": { "id": "invalid-lineage", "version": "1.0.0", "plane": "portable-shard", "dataClass": "portable-projection", "maturity": "experimental" },
+  "guarantees": { "transaction": "none", "isolation": "snapshot", "durability": "filesystem", "availability": "local-process", "ordering": "stable-identity" },
+  "capabilities": [
+    { "id": "lineage.field", "version": "1.0.0", "status": "supported", "evidence": ["synthetic"] }
+  ],
+  "evidence": [{ "id": "synthetic", "kind": "fixture", "uri": "fixture://invalid-lineage" }]
+}

package/schemas/dataset-execution-capabilities/fixtures/invalid-incremental-without-checkpoint.json

@@ -0,0 +1,10 @@
+{
+  "contract": "fortemi.dataset-execution-capabilities/v1",
+  "schemaVersion": "1.0.0",
+  "runtime": { "id": "invalid-incremental", "version": "1.0.0", "plane": "server-process", "dataClass": "regenerable-index", "maturity": "experimental" },
+  "guarantees": { "transaction": "none", "isolation": "none", "durability": "process", "availability": "single-host", "ordering": "unspecified" },
+  "capabilities": [
+    { "id": "ingest.incremental", "version": "1.0.0", "status": "supported", "evidence": ["synthetic"] }
+  ],
+  "evidence": [{ "id": "synthetic", "kind": "fixture", "uri": "fixture://invalid-incremental" }]
+}

package/schemas/dataset-execution-capabilities/fixtures/portable-shard.json

@@ -0,0 +1,12 @@
+{
+  "contract": "fortemi.dataset-execution-capabilities/v1",
+  "schemaVersion": "1.0.0",
+  "runtime": { "id": "fortemi-shard", "version": "2026.8.0", "plane": "portable-shard", "dataClass": "portable-projection", "maturity": "stable" },
+  "guarantees": { "transaction": "none", "isolation": "snapshot", "durability": "filesystem", "availability": "local-process", "ordering": "stable-identity" },
+  "capabilities": [
+    { "id": "schema.inspect", "version": "1.0.0", "status": "supported", "evidence": ["shard-fixture"] },
+    { "id": "lineage.dataset", "version": "1.0.0", "status": "experimental", "evidence": ["shard-fixture"] },
+    { "id": "ordering.deterministic", "version": "1.0.0", "status": "supported", "evidence": ["shard-fixture"] }
+  ],
+  "evidence": [{ "id": "shard-fixture", "kind": "fixture", "uri": "fixture://portable-shard" }]
+}

package/schemas/dataset-execution-capabilities/fixtures/remote-alpha.json

@@ -0,0 +1,12 @@
+{
+  "contract": "fortemi.dataset-execution-capabilities/v1",
+  "schemaVersion": "1.0.0",
+  "runtime": { "id": "fortemi-server", "version": "0.1.0", "plane": "live-remote-persistence", "dataClass": "remote-persistence", "maturity": "alpha" },
+  "guarantees": { "transaction": "single-record", "isolation": "none", "durability": "replicated", "availability": "remote-service", "ordering": "backend-cursor" },
+  "capabilities": [
+    { "id": "ingest.full", "version": "1.0.0", "status": "experimental", "limits": { "maxBatchRecords": 100 }, "evidence": ["server-contract"] },
+    { "id": "identity.record", "version": "1.0.0", "status": "experimental", "evidence": ["server-contract"] },
+    { "id": "mutation.upsert", "version": "1.0.0", "status": "experimental", "evidence": ["server-contract"] }
+  ],
+  "evidence": [{ "id": "server-contract", "kind": "fixture", "uri": "fixture://remote-alpha" }]
+}

package/schemas/dataset-execution-capabilities/fixtures/static-cache.json

@@ -0,0 +1,12 @@
+{
+  "contract": "fortemi.dataset-execution-capabilities/v1",
+  "schemaVersion": "1.0.0",
+  "runtime": { "id": "fortemi-static", "version": "2026.8.0", "plane": "static-cache", "dataClass": "static-cache", "maturity": "stable" },
+  "guarantees": { "transaction": "none", "isolation": "snapshot", "durability": "filesystem", "availability": "local-process", "ordering": "stable-identity" },
+  "capabilities": [
+    { "id": "index.lexical", "version": "1.0.0", "status": "supported", "limits": { "maxPageSize": 1000 }, "evidence": ["static-fixture"] },
+    { "id": "pagination.cursor", "version": "1.0.0", "status": "supported", "evidence": ["static-fixture"] },
+    { "id": "ordering.deterministic", "version": "1.0.0", "status": "supported", "evidence": ["static-fixture"] }
+  ],
+  "evidence": [{ "id": "static-fixture", "kind": "fixture", "uri": "fixture://static-cache" }]
+}

package/schemas/dataset-execution-capabilities/v1.schema.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://fortemi.dev/schemas/dataset-execution-capabilities/v1.schema.json",
+  "title": "Fortemi Dataset Execution Capability Contract v1",
+  "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", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "digest": { "type": "string", "pattern": "^[a-z0-9]+:[a-f0-9]+$" },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxInputBytes": { "type": "integer", "minimum": 0 },
+        "maxRecordBytes": { "type": "integer", "minimum": 0 },
+        "maxBatchRecords": { "type": "integer", "minimum": 0 },
+        "maxConcurrency": { "type": "integer", "minimum": 0 },
+        "maxPageSize": { "type": "integer", "minimum": 0 },
+        "maxTraversalDepth": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "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" } }
+      }
+    }
+  }
+}

package/schemas/dataset-ingest/v1.schema.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://fortemi.dev/schemas/dataset-ingest/v1.schema.json",
+  "title": "Fortemi Dataset Ingest Contract v1",
+  "oneOf": [
+    { "$ref": "#/$defs/plan" },
+    { "$ref": "#/$defs/checkpoint" },
+    { "$ref": "#/$defs/batch" },
+    { "$ref": "#/$defs/receipt" }
+  ],
+  "$defs": {
+    "semver": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "digest": { "type": "string", "pattern": "^[a-z0-9]+:[a-f0-9]+$" },
+    "contract": { "const": "fortemi.dataset-ingest/v1" },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tenant", "dataset", "sourceBinding", "stream"],
+      "properties": {
+        "tenant": { "type": "string", "minLength": 1 },
+        "dataset": { "type": "string", "minLength": 1 },
+        "sourceBinding": { "type": "string", "minLength": 1 },
+        "stream": { "type": "string", "minLength": 1 },
+        "partition": { "type": "string", "minLength": 1 }
+      }
+    },
+    "checkpoint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "scope", "opaque", "sequence"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/contract" },
+        "schemaVersion": { "$ref": "#/$defs/semver" },
+        "scope": { "$ref": "#/$defs/scope" },
+        "opaque": { "type": "string", "minLength": 1 },
+        "sequence": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "plan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "planId", "planDigest", "sourceRevision", "configurationDigest", "transformationDigest", "destination", "mode", "rejectionPolicy", "reconciliation"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/contract" },
+        "schemaVersion": { "$ref": "#/$defs/semver" },
+        "planId": { "type": "string", "minLength": 1 },
+        "planDigest": { "$ref": "#/$defs/digest" },
+        "sourceRevision": { "type": "string", "minLength": 1 },
+        "configurationDigest": { "$ref": "#/$defs/digest" },
+        "transformationDigest": { "$ref": "#/$defs/digest" },
+        "destination": { "$ref": "#/$defs/scope" },
+        "mode": { "enum": ["full", "snapshot", "incremental"] },
+        "rejectionPolicy": {
+          "type": "object", "additionalProperties": false,
+          "required": ["mode", "maxRejectedRecords"],
+          "properties": {
+            "mode": { "enum": ["fail-fast", "bounded-reject", "dlq"] },
+            "maxRejectedRecords": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "reconciliation": {
+          "type": "object", "additionalProperties": false,
+          "required": ["enabled", "maxTombstones"],
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "maxTombstones": { "type": "integer", "minimum": 0 }
+          }
+        }
+      }
+    },
+    "mutation": {
+      "oneOf": [
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["operation", "logicalId", "revision", "digest", "value"],
+          "properties": {
+            "operation": { "const": "upsert" }, "logicalId": { "type": "string", "minLength": 1 },
+            "revision": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" },
+            "value": {}, "locator": { "type": "string", "minLength": 1 }
+          }
+        },
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["operation", "logicalId", "revision", "digest"],
+          "properties": {
+            "operation": { "const": "tombstone" }, "logicalId": { "type": "string", "minLength": 1 },
+            "revision": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" },
+            "locator": { "type": "string", "minLength": 1 }
+          }
+        }
+      ]
+    },
+    "batch": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "sequence", "mutations", "checkpointAfter"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/contract" }, "schemaVersion": { "$ref": "#/$defs/semver" },
+        "sequence": { "type": "integer", "minimum": 0 }, "idempotencyKey": { "type": "string", "minLength": 1 },
+        "mutations": { "type": "array", "items": { "$ref": "#/$defs/mutation" } },
+        "checkpointBefore": { "$ref": "#/$defs/checkpoint" }, "checkpointAfter": { "$ref": "#/$defs/checkpoint" },
+        "enumeration": {
+          "type": "object", "additionalProperties": false, "required": ["complete"],
+          "properties": { "complete": { "type": "boolean" }, "approvalId": { "type": "string", "minLength": 1 } }
+        }
+      }
+    },
+    "rejection": {
+      "type": "object", "additionalProperties": false, "required": ["logicalIdDigest", "code", "message"],
+      "properties": {
+        "logicalIdDigest": { "$ref": "#/$defs/digest" }, "locator": { "type": "string" },
+        "code": { "type": "string", "minLength": 1 }, "message": { "type": "string", "minLength": 1 }
+      }
+    },
+    "effect": {
+      "type": "object", "additionalProperties": false, "required": ["operation", "logicalId", "revision", "digest"],
+      "properties": {
+        "operation": { "enum": ["upsert", "tombstone"] }, "logicalId": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "receipt": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "runId", "idempotencyKey", "requestDigest", "planId", "planDigest", "sourceRevision", "destination", "mode", "state", "effects", "acceptedRecords", "rejectedRecords", "rejections", "outputDigest", "checkpointAfter", "verification"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/contract" }, "schemaVersion": { "$ref": "#/$defs/semver" },
+        "runId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "idempotencyKey": { "type": "string", "minLength": 1 },
+        "requestDigest": { "$ref": "#/$defs/digest" }, "planId": { "type": "string", "minLength": 1 },
+        "planDigest": { "$ref": "#/$defs/digest" }, "sourceRevision": { "type": "string", "minLength": 1 }, "destination": { "$ref": "#/$defs/scope" },
+        "mode": { "enum": ["full", "snapshot", "incremental"] }, "state": { "enum": ["committed", "degraded"] },
+        "effects": { "type": "array", "items": { "$ref": "#/$defs/effect" } },
+        "acceptedRecords": { "type": "integer", "minimum": 0 }, "rejectedRecords": { "type": "integer", "minimum": 0 },
+        "rejections": { "type": "array", "items": { "$ref": "#/$defs/rejection" } },
+        "outputDigest": { "$ref": "#/$defs/digest" }, "checkpointBefore": { "$ref": "#/$defs/checkpoint" },
+        "checkpointAfter": { "$ref": "#/$defs/checkpoint" }, "verification": { "const": "verified" }
+      }
+    }
+  }
+}

package/schemas/dataset-lineage/fixtures/golden-observed-field.json

@@ -0,0 +1,20 @@
+{
+  "contract": "fortemi.dataset-lineage/v1",
+  "schemaVersion": "1.0.0",
+  "snapshot": 6,
+  "entities": [
+    { "id": "field:source", "kind": "field", "schemaId": "urn:example:customer", "schemaVersion": "1.0.0", "createdAt": "2026-09-03T12:00:00.000Z" },
+    { "id": "field:target", "kind": "field", "schemaId": "urn:example:customer", "schemaVersion": "1.0.0", "createdAt": "2026-09-03T12:00:00.000Z" }
+  ],
+  "agents": [{ "id": "agent:fortemi", "kind": "software", "name": "Fortemi", "version": "2026.8.0" }],
+  "activities": [{ "id": "activity:run-1", "kind": "transform", "runId": "run:1", "startedAt": "2026-09-03T12:00:00.000Z", "endedAt": "2026-09-03T12:00:00.000Z", "agentIds": ["agent:fortemi"] }],
+  "evidence": [{ "id": "evidence:query", "revision": "1", "locator": "shard://runs/run-1/query.json", "digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000", "privacy": "internal", "capturedAt": "2026-09-03T12:00:00.000Z" }],
+  "assertions": [{
+    "id": "assertion:field", "revision": "1", "relationship": "field-derived-from", "assertionKind": "observed",
+    "sourceEntityId": "field:source", "targetEntityId": "field:target", "issuerAgentId": "agent:fortemi", "producingActivityId": "activity:run-1",
+    "method": "sql-expression", "evidence": [{ "evidenceId": "evidence:query", "revision": "1", "digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000" }],
+    "confidence": 1, "privacy": "internal", "schemaId": "urn:fortemi:lineage-assertion", "schemaVersion": "1.0.0", "assertedAt": "2026-09-03T12:00:00.000Z"
+  }],
+  "corrections": [],
+  "digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+}

package/schemas/dataset-lineage/v1.schema.json

@@ -0,0 +1,126 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://fortemi.dev/schemas/dataset-lineage/v1.schema.json",
+  "title": "Fortemi Dataset Lineage v1",
+  "description": "Canonical evidence-bearing dataset lineage archive, traversal, projection, and loss receipt contracts.",
+  "oneOf": [
+    { "$ref": "#/$defs/archive" },
+    { "$ref": "#/$defs/traversalResult" },
+    { "$ref": "#/$defs/projection" },
+    { "$ref": "#/$defs/lossReceipt" }
+  ],
+  "$defs": {
+    "id": { "type": "string", "minLength": 1, "pattern": "^\\S(?:.*\\S)?$" },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "timestamp": { "type": "string", "format": "date-time", "pattern": "Z$" },
+    "privacy": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "entityKind": { "enum": ["dataset", "dataset-revision", "distribution", "record", "field", "chunk", "index", "embedding-set", "graph-artifact", "community-artifact", "processing-plan", "run"] },
+    "relationshipKind": { "enum": ["derived-from", "field-derived-from", "extracted-from", "chunk-of", "indexed-from", "embedded-from", "graph-derived-from", "community-derived-from", "revision-of", "distributed-as", "join-influence", "filter-influence", "aggregation-influence", "ordering-influence", "similarity-influence"] },
+    "entity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "schemaId", "schemaVersion", "createdAt"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" }, "kind": { "$ref": "#/$defs/entityKind" },
+        "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "$ref": "#/$defs/version" },
+        "revision": { "$ref": "#/$defs/id" }, "datasetId": { "$ref": "#/$defs/id" },
+        "createdAt": { "$ref": "#/$defs/timestamp" }, "attributes": { "type": "object" }
+      }
+    },
+    "agent": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "kind", "name"],
+      "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["person", "service", "software", "organization"] }, "name": { "$ref": "#/$defs/id" }, "version": { "type": "string", "minLength": 1 } }
+    },
+    "activity": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "kind", "startedAt", "agentIds"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["ingest", "transform", "index", "query", "export", "import", "correction"] },
+        "planId": { "$ref": "#/$defs/id" }, "runId": { "$ref": "#/$defs/id" },
+        "startedAt": { "$ref": "#/$defs/timestamp" }, "endedAt": { "$ref": "#/$defs/timestamp" },
+        "agentIds": { "type": "array", "items": { "$ref": "#/$defs/id" }, "uniqueItems": true }
+      }
+    },
+    "evidence": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "revision", "locator", "digest", "privacy", "capturedAt"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" }, "revision": { "$ref": "#/$defs/id" }, "locator": { "$ref": "#/$defs/id" },
+        "digest": { "$ref": "#/$defs/digest" }, "mediaType": { "type": "string", "minLength": 1 },
+        "privacy": { "$ref": "#/$defs/privacy" }, "capturedAt": { "$ref": "#/$defs/timestamp" }, "payload": true
+      }
+    },
+    "evidenceReference": {
+      "type": "object", "additionalProperties": false,
+      "required": ["evidenceId", "revision", "digest"],
+      "properties": { "evidenceId": { "$ref": "#/$defs/id" }, "revision": { "$ref": "#/$defs/id" }, "digest": { "$ref": "#/$defs/digest" }, "locator": { "$ref": "#/$defs/id" } }
+    },
+    "assertion": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "revision", "relationship", "assertionKind", "sourceEntityId", "targetEntityId", "issuerAgentId", "method", "evidence", "confidence", "privacy", "schemaId", "schemaVersion", "assertedAt"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" }, "revision": { "$ref": "#/$defs/id" }, "relationship": { "$ref": "#/$defs/relationshipKind" },
+        "assertionKind": { "enum": ["declared", "observed"] }, "sourceEntityId": { "$ref": "#/$defs/id" }, "targetEntityId": { "$ref": "#/$defs/id" },
+        "issuerAgentId": { "$ref": "#/$defs/id" }, "producingActivityId": { "$ref": "#/$defs/id" }, "method": { "$ref": "#/$defs/id" },
+        "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidenceReference" } }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "privacy": { "$ref": "#/$defs/privacy" }, "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "$ref": "#/$defs/version" }, "assertedAt": { "$ref": "#/$defs/timestamp" }
+      },
+      "allOf": [{ "if": { "properties": { "assertionKind": { "const": "observed" } }, "required": ["assertionKind"] }, "then": { "required": ["producingActivityId"], "properties": { "producingActivityId": true, "evidence": { "type": "array", "minItems": 1 } } } }]
+    },
+    "correction": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "assertionId", "assertionRevision", "action", "issuerAgentId", "activityId", "reason", "recordedAt"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" }, "assertionId": { "$ref": "#/$defs/id" }, "assertionRevision": { "$ref": "#/$defs/id" }, "action": { "enum": ["correct", "retract", "supersede"] },
+        "issuerAgentId": { "$ref": "#/$defs/id" }, "activityId": { "$ref": "#/$defs/id" }, "reason": { "$ref": "#/$defs/id" },
+        "recordedAt": { "$ref": "#/$defs/timestamp" }, "replacementAssertionId": { "$ref": "#/$defs/id" }, "replacementRevision": { "$ref": "#/$defs/id" }
+      },
+      "allOf": [
+        { "if": { "properties": { "action": { "enum": ["correct", "supersede"] } }, "required": ["action"] }, "then": { "required": ["replacementAssertionId", "replacementRevision"], "properties": { "replacementAssertionId": true, "replacementRevision": true } } },
+        { "if": { "properties": { "action": { "const": "retract" } }, "required": ["action"] }, "then": { "not": { "anyOf": [{ "required": ["replacementAssertionId"] }, { "required": ["replacementRevision"] }] } } }
+      ]
+    },
+    "base": {
+      "type": "object",
+      "required": ["contract", "schemaVersion"],
+      "properties": { "contract": { "const": "fortemi.dataset-lineage/v1" }, "schemaVersion": { "$ref": "#/$defs/version" } }
+    },
+    "archive": {
+      "allOf": [
+        { "$ref": "#/$defs/base" },
+        { "type": "object", "additionalProperties": false, "required": ["contract", "schemaVersion", "snapshot", "entities", "agents", "activities", "evidence", "assertions", "corrections", "digest"],
+          "properties": {
+            "contract": true, "schemaVersion": true, "snapshot": { "type": "integer", "minimum": 0 },
+            "entities": { "type": "array", "items": { "$ref": "#/$defs/entity" } }, "agents": { "type": "array", "items": { "$ref": "#/$defs/agent" } },
+            "activities": { "type": "array", "items": { "$ref": "#/$defs/activity" } }, "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+            "assertions": { "type": "array", "items": { "$ref": "#/$defs/assertion" } }, "corrections": { "type": "array", "items": { "$ref": "#/$defs/correction" } }, "digest": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    },
+    "traversalNode": { "type": "object", "additionalProperties": false, "required": ["entity", "depth", "pathAssertionIds"], "properties": { "entity": { "$ref": "#/$defs/entity" }, "depth": { "type": "integer", "minimum": 0 }, "pathAssertionIds": { "type": "array", "items": { "$ref": "#/$defs/id" } } } },
+    "traversalEdge": { "type": "object", "additionalProperties": false, "required": ["assertion", "status"], "properties": { "assertion": { "$ref": "#/$defs/assertion" }, "status": { "enum": ["active", "corrected", "retracted", "superseded"] }, "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } } } },
+    "traversalResult": {
+      "allOf": [{ "$ref": "#/$defs/base" }, { "type": "object", "additionalProperties": false, "required": ["contract", "schemaVersion", "snapshot", "nodes", "edges", "truncated"], "properties": {
+        "contract": true, "schemaVersion": true, "snapshot": { "type": "integer", "minimum": 0 }, "nodes": { "type": "array", "items": { "$ref": "#/$defs/traversalNode" } },
+        "edges": { "type": "array", "items": { "$ref": "#/$defs/traversalEdge" } }, "nextCursor": { "type": "string", "minLength": 1 }, "truncated": { "type": "boolean" }
+      } }]
+    },
+    "loss": { "type": "object", "additionalProperties": false, "required": ["path", "reason", "canonicalDigest"], "properties": { "path": { "type": "string", "pattern": "^/" }, "reason": { "enum": ["unsupported-entity-kind", "unsupported-relationship-kind", "unsupported-assertion-kind", "evidence-omitted", "corrections-omitted"] }, "canonicalDigest": { "$ref": "#/$defs/digest" } } },
+    "lossReceipt": {
+      "allOf": [{ "$ref": "#/$defs/base" }, { "type": "object", "additionalProperties": false, "required": ["contract", "schemaVersion", "sourceDigest", "projectionDigest", "lossless", "losses"], "properties": {
+        "contract": true, "schemaVersion": true, "sourceDigest": { "$ref": "#/$defs/digest" }, "projectionDigest": { "$ref": "#/$defs/digest" }, "lossless": { "type": "boolean" }, "losses": { "type": "array", "items": { "$ref": "#/$defs/loss" } }
+      } }]
+    },
+    "projection": {
+      "allOf": [{ "$ref": "#/$defs/base" }, { "type": "object", "additionalProperties": false, "required": ["contract", "schemaVersion", "canonical", "regenerable", "sourceDigest", "entities", "assertions", "evidence", "corrections", "digest", "lossReceipt"], "properties": {
+        "contract": true, "schemaVersion": true, "canonical": { "const": false }, "regenerable": { "const": true }, "sourceDigest": { "$ref": "#/$defs/digest" },
+        "entities": { "type": "array", "items": { "$ref": "#/$defs/entity" } }, "assertions": { "type": "array", "items": { "$ref": "#/$defs/assertion" } },
+        "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } }, "corrections": { "type": "array", "items": { "$ref": "#/$defs/correction" } },
+        "digest": { "$ref": "#/$defs/digest" }, "lossReceipt": { "$ref": "#/$defs/lossReceipt" }
+      } }]
+    }
+  }
+}

package/schemas/dataset-materialization/fixtures/browser.json

@@ -0,0 +1,11 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.browser.vector", "version": "1.0.0", "kind": "vector", "status": "supported",
+  "operations": ["build", "query"], "inputTypes": ["text/plain"],
+  "implementation": { "id": "transformers-js", "version": "3.0.0", "digest": "sha256:6666666666666666666666666666666666666666666666666666666666666666", "model": { "id": "local-mini", "version": "1", "digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" } },
+  "configurationSchema": { "type": "object" }, "requiredRuntimeCapabilities": [{ "id": "index.vector" }],
+  "determinism": { "class": "deterministic" },
+  "privacy": { "behavior": "local-only", "authorizationRequired": true, "filtersBefore": ["chunking", "model-invocation", "index-persistence"] },
+  "resourceLimits": { "maxInputBytes": 1048576, "maxRecords": 500, "maxConcurrency": 1, "maxMemoryBytes": 536870912 },
+  "output": { "dataClass": "regenerable-index", "canonicalMutation": false }
+}

package/schemas/dataset-materialization/fixtures/degraded.json

@@ -0,0 +1,12 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.hybrid.preferred", "version": "1.0.0", "kind": "hybrid", "status": "supported",
+  "operations": ["query"], "inputTypes": ["application/fortemi-index"],
+  "implementation": { "id": "fortemi-hybrid", "version": "2026.8.0", "digest": "sha256:3333333333333333333333333333333333333333333333333333333333333333" },
+  "configurationSchema": { "type": "object" }, "requiredRuntimeCapabilities": [{ "id": "index.hybrid" }],
+  "optionalRuntimeCapabilities": [{ "id": "index.rerank", "fallback": ["index.lexical"] }],
+  "determinism": { "class": "deterministic" },
+  "privacy": { "behavior": "local-only", "authorizationRequired": true, "filtersBefore": ["chunking", "model-invocation", "index-persistence"] },
+  "resourceLimits": { "maxInputBytes": 1048576, "maxRecords": 1000, "maxConcurrency": 1 },
+  "output": { "dataClass": "regenerable-index", "canonicalMutation": false }
+}