@fortemi/core 2026.8.0 → 2026.9.1

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 }
+}

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

@@ -0,0 +1,11 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.chunk.fixed", "version": "1.0.0", "kind": "chunking", "status": "supported",
+  "operations": ["build"], "inputTypes": ["text/plain"],
+  "implementation": { "id": "fixed-chunker", "version": "1.0.0", "digest": "sha256:4444444444444444444444444444444444444444444444444444444444444444" },
+  "configurationSchema": { "type": "object", "properties": { "size": { "type": "integer" } } }, "requiredRuntimeCapabilities": [{ "id": "index.chunk" }, { "id": "ordering.deterministic" }],
+  "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 }
+}

package/schemas/dataset-materialization/fixtures/external-adapter.json

@@ -0,0 +1,11 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.external.graphrag-rs", "version": "1.0.0", "kind": "graph-retrieval", "status": "experimental",
+  "operations": ["build", "query"], "inputTypes": ["application/fortemi-derived-graph"],
+  "implementation": { "id": "graphrag-rs-adapter", "version": "0.1.0", "digest": "sha256:8888888888888888888888888888888888888888888888888888888888888888" },
+  "configurationSchema": { "type": "object", "additionalProperties": false }, "requiredRuntimeCapabilities": [{ "id": "index.graph" }, { "id": "lineage.relationship-evidence" }],
+  "determinism": { "class": "deterministic" },
+  "privacy": { "behavior": "policy-filtered-external", "authorizationRequired": true, "filtersBefore": ["chunking", "model-invocation", "index-persistence"] },
+  "resourceLimits": { "maxInputBytes": 10485760, "maxRecords": 10000, "maxConcurrency": 2 },
+  "output": { "dataClass": "regenerable-index", "canonicalMutation": false }
+}

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

@@ -0,0 +1,11 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.extract.generative", "version": "1.0.0", "kind": "entity-relationship-extraction", "status": "experimental",
+  "operations": ["build"], "inputTypes": ["text/plain"],
+  "implementation": { "id": "remote-extractor", "version": "2.1.0", "digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555", "model": { "id": "example-model", "version": "2026-08", "digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } },
+  "configurationSchema": { "type": "object" }, "requiredRuntimeCapabilities": [{ "id": "index.graph" }],
+  "determinism": { "class": "nondeterministic" },
+  "privacy": { "behavior": "policy-filtered-external", "authorizationRequired": true, "filtersBefore": ["chunking", "model-invocation", "index-persistence"] },
+  "resourceLimits": { "maxInputBytes": 262144, "maxRecords": 100, "maxConcurrency": 2, "timeoutMs": 30000 },
+  "output": { "dataClass": "regenerable-index", "canonicalMutation": false }
+}

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

@@ -0,0 +1,11 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.server.community", "version": "1.0.0", "kind": "community", "status": "supported",
+  "operations": ["build", "query"], "inputTypes": ["application/fortemi-graph"],
+  "implementation": { "id": "fortemi-server-community", "version": "2026.8.0", "digest": "sha256:7777777777777777777777777777777777777777777777777777777777777777" },
+  "configurationSchema": { "type": "object" }, "requiredRuntimeCapabilities": [{ "id": "index.community" }, { "id": "privacy.pre-materialization-filter" }],
+  "determinism": { "class": "seeded", "seedRequired": true },
+  "privacy": { "behavior": "policy-filtered-external", "authorizationRequired": true, "filtersBefore": ["chunking", "model-invocation", "index-persistence"] },
+  "resourceLimits": { "maxInputBytes": 1073741824, "maxRecords": 1000000, "maxConcurrency": 8, "maxMemoryBytes": 8589934592 },
+  "output": { "dataClass": "regenerable-index", "canonicalMutation": false }
+}

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

@@ -0,0 +1,12 @@
+{
+  "contract": "fortemi.dataset-materialization-profile/v1", "schemaVersion": "1.0.0",
+  "id": "fortemi.lexical.default", "version": "1.0.0", "kind": "lexical", "status": "supported",
+  "operations": ["build", "query"], "inputTypes": ["text/plain"],
+  "implementation": { "id": "fortemi-core-lexical", "version": "2026.8.0", "digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111" },
+  "configurationSchema": { "type": "object", "additionalProperties": false, "properties": { "language": { "type": "string" } } },
+  "requiredRuntimeCapabilities": [{ "id": "index.lexical", "minimumVersion": "1.0.0" }],
+  "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 }
+}

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

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

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

@@ -0,0 +1,169 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fortemi.dev/dataset-materialization/v1.schema.json",
+  "title": "Fortemi dataset materialization profiles and evidence",
+  "oneOf": [
+    { "$ref": "#/$defs/profile" },
+    { "$ref": "#/$defs/receipt" },
+    { "$ref": "#/$defs/retrievalResponse" },
+    { "$ref": "#/$defs/benchmarkEvidence" }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "semver": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "implementation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "digest"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "model": {
+          "type": "object", "additionalProperties": false,
+          "required": ["id", "version", "digest"],
+          "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }
+        }
+      }
+    },
+    "capabilityRequirement": {
+      "type": "object", "additionalProperties": false, "required": ["id"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "minimumVersion": { "$ref": "#/$defs/semver" },
+        "minimumLimits": {
+          "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 }
+          }
+        },
+        "fallback": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "id", "version", "kind", "status", "operations", "inputTypes", "implementation", "configurationSchema", "requiredRuntimeCapabilities", "determinism", "privacy", "resourceLimits", "output"],
+      "properties": {
+        "contract": { "const": "fortemi.dataset-materialization-profile/v1" },
+        "schemaVersion": { "$ref": "#/$defs/semver" },
+        "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+        "version": { "$ref": "#/$defs/semver" },
+        "kind": { "enum": ["chunking", "lexical", "vector", "hybrid", "rerank", "entity-relationship-extraction", "graph-retrieval", "community"] },
+        "status": { "enum": ["supported", "experimental", "unsupported"] },
+        "operations": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["build", "query"] } },
+        "inputTypes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "implementation": { "$ref": "#/$defs/implementation" },
+        "configurationSchema": { "type": "object" },
+        "requiredRuntimeCapabilities": { "type": "array", "items": { "$ref": "#/$defs/capabilityRequirement" } },
+        "optionalRuntimeCapabilities": { "type": "array", "items": { "$ref": "#/$defs/capabilityRequirement" } },
+        "determinism": {
+          "type": "object", "additionalProperties": false, "required": ["class"],
+          "properties": { "class": { "enum": ["deterministic", "seeded", "nondeterministic"] }, "seedRequired": { "type": "boolean" } },
+          "if": { "properties": { "class": { "const": "seeded" } } }, "then": { "required": ["seedRequired"], "properties": { "seedRequired": { "const": true } } }
+        },
+        "privacy": {
+          "type": "object", "additionalProperties": false, "required": ["behavior", "authorizationRequired", "filtersBefore"],
+          "properties": {
+            "behavior": { "enum": ["local-only", "policy-filtered-external"] }, "authorizationRequired": { "const": true },
+            "filtersBefore": { "type": "array", "uniqueItems": true, "allOf": [
+              { "contains": { "const": "chunking" } }, { "contains": { "const": "model-invocation" } }, { "contains": { "const": "index-persistence" } }
+            ], "items": { "enum": ["chunking", "model-invocation", "index-persistence"] } }
+          }
+        },
+        "resourceLimits": {
+          "type": "object", "additionalProperties": false, "required": ["maxInputBytes", "maxRecords", "maxConcurrency"],
+          "properties": {
+            "maxInputBytes": { "type": "integer", "minimum": 0 }, "maxRecords": { "type": "integer", "minimum": 0 },
+            "maxConcurrency": { "type": "integer", "minimum": 1 }, "maxMemoryBytes": { "type": "integer", "minimum": 0 }, "timeoutMs": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "output": {
+          "type": "object", "additionalProperties": false, "required": ["dataClass", "canonicalMutation"],
+          "properties": { "dataClass": { "const": "regenerable-index" }, "canonicalMutation": { "const": false } }
+        }
+      }
+    },
+    "degradation": {
+      "type": "object", "additionalProperties": false, "required": ["requested", "reason", "changedGuarantees"],
+      "properties": {
+        "requested": { "type": "string" }, "selected": { "type": "string" },
+        "reason": { "enum": ["unsupported", "version-insufficient", "limit-insufficient"] },
+        "changedGuarantees": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "runtime": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version", "plane", "dataClass", "maturity"],
+      "properties": {
+        "id": { "type": "string" }, "version": { "type": "string" },
+        "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"] }
+      }
+    },
+    "privacyDecision": {
+      "type": "object", "additionalProperties": false, "required": ["policyId", "policyVersion", "policyDigest", "allowedRecordDigests", "deniedRecordDigests", "evaluatedAt"],
+      "properties": {
+        "policyId": { "type": "string" }, "policyVersion": { "type": "string" }, "policyDigest": { "$ref": "#/$defs/digest" },
+        "allowedRecordDigests": { "type": "array", "items": { "$ref": "#/$defs/digest" } }, "deniedRecordDigests": { "type": "array", "items": { "$ref": "#/$defs/digest" } },
+        "evaluatedAt": { "type": "string", "minLength": 1 }
+      }
+    },
+    "artifact": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "logicalId", "sourceRecordDigests", "digest"],
+      "properties": {
+        "kind": { "enum": ["chunk", "lexical-entry", "vector", "reranked-hit", "entity", "relationship", "graph-result", "community"] },
+        "logicalId": { "type": "string" }, "sourceRecordDigests": { "type": "array", "items": { "$ref": "#/$defs/digest" } },
+        "digest": { "$ref": "#/$defs/digest" }, "payload": {}, "score": { "type": "number" }
+      }
+    },
+    "receipt": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "receiptId", "runId", "processingRunId", "source", "schema", "profile", "runtime", "negotiation", "mode", "affected", "output", "privacy", "resources", "createdAt"],
+      "properties": {
+        "contract": { "const": "fortemi.dataset-materialization-profile/v1" }, "schemaVersion": { "$ref": "#/$defs/semver" }, "receiptId": { "$ref": "#/$defs/digest" },
+        "runId": { "type": "string" }, "processingRunId": { "type": "string" },
+        "source": { "type": "object", "additionalProperties": false, "required": ["datasetId", "revision", "digests"], "properties": { "datasetId": { "type": "string" }, "revision": { "type": "string" }, "digests": { "type": "array", "items": { "$ref": "#/$defs/digest" } } } },
+        "schema": { "type": "object", "additionalProperties": false, "required": ["id", "version", "digest"], "properties": { "id": { "type": "string" }, "version": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" } } },
+        "profile": { "type": "object", "additionalProperties": false, "required": ["id", "version", "digest", "configurationDigest", "implementation"], "properties": { "id": { "type": "string" }, "version": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" }, "configurationDigest": { "$ref": "#/$defs/digest" }, "implementation": { "$ref": "#/$defs/implementation" } } },
+        "runtime": { "$ref": "#/$defs/runtime" },
+        "negotiation": { "type": "object", "additionalProperties": false, "required": ["requestedProfile", "selectedProfile", "degraded", "degradations"], "properties": { "requestedProfile": { "type": "string" }, "selectedProfile": { "type": "string" }, "degraded": { "type": "boolean" }, "degradations": { "type": "array", "items": { "$ref": "#/$defs/degradation" } } } },
+        "mode": { "enum": ["full", "incremental"] },
+        "affected": { "type": "object", "additionalProperties": false, "required": ["sourceRevisions", "recordDigests", "chunkDigests"], "properties": { "sourceRevisions": { "type": "array", "items": { "type": "string" } }, "recordDigests": { "type": "array", "items": { "$ref": "#/$defs/digest" } }, "chunkDigests": { "type": "array", "items": { "$ref": "#/$defs/digest" } } } },
+        "output": { "type": "object", "additionalProperties": false, "required": ["counts", "digests", "aggregateDigest"], "properties": { "counts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "digests": { "type": "array", "items": { "$ref": "#/$defs/digest" } }, "aggregateDigest": { "$ref": "#/$defs/digest" } } },
+        "privacy": { "$ref": "#/$defs/privacyDecision" },
+        "resources": { "type": "object", "additionalProperties": false, "required": ["elapsedMs", "inputBytes", "modelInvocations", "persistedBytes"], "properties": { "elapsedMs": { "type": "number", "minimum": 0 }, "inputBytes": { "type": "integer", "minimum": 0 }, "peakMemoryBytes": { "type": "integer", "minimum": 0 }, "modelInvocations": { "type": "integer", "minimum": 0 }, "persistedBytes": { "type": "integer", "minimum": 0 } } },
+        "createdAt": { "type": "string", "minLength": 1 }
+      }
+    },
+    "retrievalResponse": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "queryId", "requestedProfile", "actualProfile", "actualBackend", "degraded", "scoreSemantics", "results", "receiptId"],
+      "properties": {
+        "contract": { "const": "fortemi.dataset-materialization-profile/v1" }, "schemaVersion": { "$ref": "#/$defs/semver" }, "queryId": { "type": "string" },
+        "requestedProfile": { "type": "string" }, "actualProfile": { "type": "string" },
+        "actualBackend": { "type": "object", "additionalProperties": false, "required": ["id", "version", "plane"], "properties": { "id": { "type": "string" }, "version": { "type": "string" }, "plane": { "enum": ["browser-local-archive", "static-cache", "portable-shard", "server-process", "live-remote-persistence"] } } },
+        "degraded": { "type": "boolean" }, "fallbackReason": { "type": "string" },
+        "scoreSemantics": { "type": "object", "additionalProperties": false, "required": ["implementationScoped", "comparableAcrossImplementations"], "properties": { "implementationScoped": { "const": true }, "comparableAcrossImplementations": { "const": false } } },
+        "results": { "type": "array", "items": { "$ref": "#/$defs/artifact" } }, "receiptId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "benchmarkEvidence": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contract", "schemaVersion", "evidenceType", "benchmarkId", "corpus", "hardware", "implementation", "profile", "correctness", "freshness", "measurements", "claims"],
+      "properties": {
+        "contract": { "const": "fortemi.dataset-materialization-profile/v1" }, "schemaVersion": { "$ref": "#/$defs/semver" }, "evidenceType": { "const": "benchmark" }, "benchmarkId": { "type": "string" },
+        "corpus": { "type": "object", "additionalProperties": false, "required": ["id", "revision", "digest", "records", "bytes"], "properties": { "id": { "type": "string" }, "revision": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" }, "records": { "type": "integer", "minimum": 0 }, "bytes": { "type": "integer", "minimum": 0 } } },
+        "hardware": { "type": "object", "additionalProperties": false, "required": ["runtime", "cpu", "memoryBytes"], "properties": { "runtime": { "type": "string" }, "cpu": { "type": "string" }, "memoryBytes": { "type": "integer", "minimum": 0 }, "accelerator": { "type": "string" } } },
+        "implementation": { "$ref": "#/$defs/implementation" },
+        "profile": { "type": "object", "additionalProperties": false, "required": ["id", "version", "digest", "configurationDigest"], "properties": { "id": { "type": "string" }, "version": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" }, "configurationDigest": { "$ref": "#/$defs/digest" } } },
+        "correctness": { "type": "object", "additionalProperties": false, "required": ["passed", "suite", "receiptDigest"], "properties": { "passed": { "type": "boolean" }, "suite": { "type": "string" }, "receiptDigest": { "$ref": "#/$defs/digest" } } },
+        "freshness": { "type": "object", "additionalProperties": false, "required": ["measuredAt", "sourceRevision"], "properties": { "measuredAt": { "type": "string" }, "sourceRevision": { "type": "string" } } },
+        "measurements": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["name", "value", "unit"], "properties": { "name": { "type": "string" }, "value": { "type": "number", "minimum": 0 }, "unit": { "enum": ["ms", "bytes", "records/s", "queries/s"] } } } },
+        "claims": { "type": "object", "additionalProperties": false, "required": ["corpusScoped", "universalScaleLimit"], "properties": { "corpusScoped": { "const": true }, "universalScaleLimit": { "const": false } } }
+      }
+    }
+  }
+}

package/schemas/source-note-upsert/contract.receipt.json

@@ -0,0 +1,78 @@
+{
+  "schemaVersion": "fortemi.source-note-upsert.consumer-receipt.v1",
+  "status": "consumer-conformance-passed",
+  "generatedAt": "2026-09-03T21:54:11Z",
+  "contract": {
+    "name": "source-note-upsert",
+    "version": "1.0.0",
+    "plane": "live-persistence",
+    "authorityRepository": "https://git.integrolabs.net/Fortemi/fortemi.git",
+    "authorityCommit": "d073159911e629583fd518062f2d8d247aa160e6",
+    "producerImplementationCommit": "54f5e64470291b06630549f5157af754ee388b7b",
+    "contractRevision": "1",
+    "requestSchemaSha256": "2461758debe121f06d78705e67f14426ea441b09ea53115fa7a168e79c83b017",
+    "responseSchemaSha256": "5eabe8c9974a720a943c6b5144dfae0882ff9894851a80e8742dc4fa3ef751da",
+    "fixture": {
+      "authorityPath": "contracts/source-note-upsert/conformance/v1.json",
+      "consumerPath": "packages/core/schemas/source-note-upsert/v1.conformance.json",
+      "sha256": "181b64c819c7d8d5492edbab187d71750de86c4e4bc74a2888ed5da163cb6266",
+      "bytes": 3440,
+      "cases": 7,
+      "byteIdentical": true
+    }
+  },
+  "producerEvidence": {
+    "repository": "Fortemi/fortemi",
+    "issue": "https://git.integrolabs.net/Fortemi/fortemi/issues/1090",
+    "commit": "54f5e64470291b06630549f5157af754ee388b7b",
+    "ciRun": "https://git.integrolabs.net/Fortemi/fortemi/actions/runs/51944",
+    "conclusion": "success",
+    "postgresVersion": "18.4",
+    "freshDestinationMigrationsPassed": true,
+    "sharedFixturePassed": true
+  },
+  "consumerEvidence": {
+    "repository": "Fortemi/fortemi-react",
+    "issue": "https://git.integrolabs.net/Fortemi/fortemi-react/issues/404",
+    "pullRequest": "https://git.integrolabs.net/Fortemi/fortemi-react/pulls/416",
+    "implementationCommit": "90f3341b4f4cc2463cfcd5e33bc144194fd55b0e",
+    "ciRun": "https://git.integrolabs.net/Fortemi/fortemi-react/actions/runs/51949",
+    "conclusion": "success",
+    "coreTestResult": {
+      "filesPassed": 80,
+      "testsPassed": 1341,
+      "failed": 0
+    },
+    "implementations": [
+      {
+        "id": "fortemi-react-pglite",
+        "cleanDestination": true,
+        "sharedFixturePassed": true,
+        "atomicRollbackPassed": true,
+        "memoryScopeIsolationPassed": true
+      },
+      {
+        "id": "fortemi-react-recordstore",
+        "cleanDestination": true,
+        "sharedFixturePassed": true,
+        "atomicCommitPassed": true,
+        "replayJournalStable": true
+      }
+    ]
+  },
+  "knowledgeShardBoundary": {
+    "profilesChanged": false,
+    "profiles": ["core-v1", "full-v1", "record-v1"],
+    "sourceIdentityPortable": false,
+    "typedLossCode": "source-identity-outside-profile",
+    "implementationReceiptSha256": "4018f6d1ac2640604377d34a1d0e36461e7d9a0382beca342164459cd236c6f1",
+    "presenceReceiptSha256": "573fc5eb0c580f90e5e7312647967af333f31c7e6986ab0f5ebc3be103b72a8b"
+  },
+  "claimBoundary": {
+    "exactContractOnly": true,
+    "fullSuiteParity": false,
+    "completeBackup": false,
+    "portableSourceIdentity": false,
+    "suiteAudit": "NO-GO"
+  }
+}

package/schemas/source-note-upsert/v1.conformance.json

@@ -0,0 +1,100 @@
+{
+  "schema": "fortemi.source-note-upsert.conformance/v1",
+  "contract_version": "1.0.0",
+  "scope": {
+    "tenant_id": "00000000-0000-0000-0000-000000000000",
+    "memory": "public"
+  },
+  "source": {
+    "source_namespace": "conformance.example",
+    "source_id": "fixture-source",
+    "source_schema_version": "1"
+  },
+  "cases": [
+    {
+      "id": "insert",
+      "request": {
+        "import_run_id": "run-insert",
+        "batch_id": "batch-insert",
+        "checkpoint": {"cursor": "1"},
+        "items": [
+          {
+            "external_id": "fixture-a",
+            "content": "alpha",
+            "content_digest": "sha256:8ed3f6ad685b959ead7022518e1af76cd816f8e8ec7ccdda1ed4018e8f2223f8",
+            "caller_stable_id": "018f05a7-cafe-7def-8000-000000000001",
+            "metadata": {"fixture": true}
+          }
+        ]
+      },
+      "expected": {"batch": "committed", "items": ["inserted"], "material_changes": 1}
+    },
+    {
+      "id": "exact-batch-replay",
+      "repeat": "insert",
+      "expected": {"batch": "duplicate", "items": ["unchanged"], "material_changes": 0}
+    },
+    {
+      "id": "changed-version",
+      "request": {
+        "import_run_id": "run-version",
+        "batch_id": "batch-version",
+        "policy": "version",
+        "items": [{"external_id": "fixture-a", "content": "alpha version two"}]
+      },
+      "expected": {"batch": "committed", "items": ["versioned"], "material_changes": 1}
+    },
+    {
+      "id": "changed-conflict",
+      "request": {
+        "import_run_id": "run-conflict",
+        "batch_id": "batch-conflict",
+        "policy": "conflict",
+        "items": [{"external_id": "fixture-a", "content": "must not replace"}]
+      },
+      "expected": {"batch": "committed", "items": ["conflict"], "material_changes": 0}
+    },
+    {
+      "id": "changed-replace",
+      "request": {
+        "import_run_id": "run-replace",
+        "batch_id": "batch-replace",
+        "policy": "replace",
+        "items": [{"external_id": "fixture-a", "content": "alpha replacement"}]
+      },
+      "expected": {"batch": "committed", "items": ["replaced"], "material_changes": 1}
+    },
+    {
+      "id": "dry-run",
+      "request": {
+        "import_run_id": "run-preview",
+        "batch_id": "batch-preview",
+        "dry_run": true,
+        "items": [{"external_id": "fixture-preview", "content": "preview only"}]
+      },
+      "expected": {"batch": "preview", "items": ["inserted"], "material_changes": 0}
+    },
+    {
+      "id": "digest-rejection",
+      "request": {
+        "import_run_id": "run-rejected",
+        "batch_id": "batch-rejected",
+        "items": [
+          {
+            "external_id": "fixture-rejected",
+            "content": "will not commit",
+            "content_digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+          }
+        ]
+      },
+      "expected": {"batch": "rejected", "items": ["rejected"], "material_changes": 0, "reason_code": "content_digest_mismatch"}
+    }
+  ],
+  "required_invariants": [
+    "exact replay adds zero note, revision, activity, job, blob, outbox, and import-journal rows",
+    "database failure rolls back all persistence and event layers",
+    "equal source keys in another tenant or memory do not collide",
+    "operation logs and receipts exclude raw external IDs and content",
+    "Knowledge Shard export emits source-identity-outside-profile when identities are omitted"
+  ]
+}