automated-qa 0.11.0

package/schemas/coherence-observed.schema.json

@@ -0,0 +1,1171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://frontend-verify.dev/schemas/coherence-observed.schema.json",
+  "title": "coherence-observed.json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "status",
+    "runId",
+    "base",
+    "lane",
+    "provenance",
+    "counts",
+    "cases",
+    "findings"
+  ],
+  "oneOf": [
+    { "required": ["schemaVersion"], "properties": { "schemaVersion": { "const": 1 } } },
+    { "required": ["schemaVersion", "cases", "findings"], "properties": { "schemaVersion": { "enum": [2, 3] }, "cases": { "type": "array", "items": { "$ref": "#/$defs/currentCaseV3" } }, "findings": { "type": "array", "items": { "$ref": "#/$defs/currentFinding" } }, "plan": { "$ref": "#/$defs/currentPlan" } } },
+    { "required": ["schemaVersion", "cases", "findings"], "properties": { "schemaVersion": { "const": 4 }, "cases": { "type": "array", "items": { "$ref": "#/$defs/currentCase" } }, "findings": { "type": "array", "items": { "$ref": "#/$defs/currentFinding" } }, "plan": { "$ref": "#/$defs/currentPlan" } } }
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "enum": [1, 2, 3, 4]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "measured",
+        "partial",
+        "unmeasured",
+        "invalid"
+      ]
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "base": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lane": {
+      "type": "string",
+      "minLength": 1
+    },
+    "reason": {
+      "type": "string"
+    },
+    "provenance": {
+      "type": "array"
+    },
+    "cases": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/case"
+      }
+    },
+    "findings": {
+      "type": "array"
+    },
+    "counts": {
+      "$ref": "#/$defs/counts"
+    },
+    "plan": {
+      "$ref": "#/$defs/plan"
+    },
+    "parallelism": {
+      "$ref": "#/$defs/parallelism"
+    },
+    "resume": {
+      "$ref": "#/$defs/resume"
+    },
+    "envelope": {
+      "$ref": "#/$defs/envelope"
+    }
+  },
+  "$defs": {
+    "currentObserver": { "type": "object", "required": ["persona", "expect", "identity"], "additionalProperties": false, "properties": { "persona": { "type": "string", "minLength": 1 }, "expect": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] }, "identity": { "$ref": "#/$defs/principalIdentity" } } },
+    "currentCellMaterial": { "type": "object", "required": ["namespace", "version", "mutation", "target", "surface", "principal", "context", "invariant", "expectation"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/observation-cell" }, "version": { "const": 1 }, "mutation": { "$ref": "#/$defs/mutationIdentity" }, "target": { "$ref": "#/$defs/targetIdentity" }, "surface": { "$ref": "#/$defs/surfaceIdentity" }, "principal": { "$ref": "#/$defs/principalIdentity" }, "context": { "$ref": "#/$defs/contextIdentity" }, "invariant": { "$ref": "#/$defs/invariantIdentity" }, "expectation": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] } } },
+    "currentCell": { "type": "object", "required": ["cellId", "material"], "additionalProperties": false, "properties": { "cellId": { "$ref": "#/$defs/coherenceId" }, "material": { "$ref": "#/$defs/currentCellMaterial" } } },
+    "currentWarmObservation": { "type": "object", "required": ["persona", "principalId", "context", "contextId", "transition", "invariant", "invariantId", "expectation", "status", "agreed", "reason", "comparisonReason", "refetched", "typed", "authoritative", "observed"], "additionalProperties": false, "properties": { "persona": { "type": "string" }, "principalId": { "$ref": "#/$defs/coherenceId" }, "context": { "enum": ["warm-cache", "fresh-context"] }, "contextId": { "$ref": "#/$defs/coherenceId" }, "transition": { "type": ["string", "null"] }, "invariant": { "enum": ["field-parity", "visibility-policy"] }, "invariantId": { "$ref": "#/$defs/coherenceId" }, "expectation": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] }, "status": { "enum": ["measured", "unmeasured"] }, "agreed": { "type": ["boolean", "null"] }, "reason": { "type": ["string", "null"] }, "comparisonReason": { "type": ["string", "null"] }, "refetched": { "type": "boolean" }, "typed": { "type": "boolean" }, "authoritative": { "$ref": "#/$defs/stateDigest" }, "observed": { "$ref": "#/$defs/stateDigest" } } },
+    "currentFreshObservation": { "type": "object", "required": ["persona", "principalId", "context", "contextId", "invariants", "invariantIds", "expectation", "status", "agreed", "reason", "authoritative", "observed"], "additionalProperties": false, "properties": { "persona": { "type": "string" }, "principalId": { "$ref": "#/$defs/coherenceId" }, "context": { "const": "fresh-context" }, "contextId": { "$ref": "#/$defs/coherenceId" }, "invariants": { "type": "array", "items": { "enum": ["field-parity", "durability"] } }, "invariantIds": { "type": "array", "items": { "$ref": "#/$defs/coherenceId" } }, "expectation": { "const": "visible" }, "status": { "enum": ["measured", "unmeasured"] }, "agreed": { "type": ["boolean", "null"] }, "reason": { "type": ["string", "null"] }, "authoritative": { "$ref": "#/$defs/stateDigest" }, "observed": { "$ref": "#/$defs/stateDigest" } } },
+    "currentObservationCase": { "type": "object", "required": ["targetId", "surfaceId", "route", "observations", "fresh", "status", "comparison"], "additionalProperties": false, "properties": { "targetId": { "$ref": "#/$defs/coherenceId" }, "surfaceId": { "$ref": "#/$defs/coherenceId" }, "route": { "type": ["string", "null"] }, "observations": { "type": "array", "items": { "$ref": "#/$defs/currentWarmObservation" } }, "fresh": { "$ref": "#/$defs/currentFreshObservation" }, "status": { "enum": ["measured", "unmeasured"] }, "reason": { "type": "string" }, "comparison": { "anyOf": [{ "type": "null" }, { "type": "object", "required": ["agreed", "authoritative", "fresh"], "additionalProperties": false, "properties": { "agreed": { "type": "boolean" }, "authoritative": { "$ref": "#/$defs/stateDigest" }, "fresh": { "$ref": "#/$defs/stateDigest" } } }] } } },
+    "currentFinding": { "type": "object", "required": ["kind", "severity", "targetId", "surfaceId"], "additionalProperties": false, "properties": { "kind": { "type": "string" }, "severity": { "enum": ["P0", "P1", "P2", "P3"] }, "rootCauseId": { "type": "string", "pattern": "^crc:[a-f0-9]{64}$" }, "targetId": { "$ref": "#/$defs/coherenceId" }, "surfaceId": { "$ref": "#/$defs/coherenceId" }, "route": { "type": ["string", "null"] }, "persona": { "type": "string" } } },
+    "causalEvidence": { "type": "object", "required": ["status", "reason", "accepted", "fixture", "effect", "convergence", "observers"], "additionalProperties": false, "properties": { "status": { "enum": ["measured", "unmeasured", "invalid"] }, "reason": { "type": ["string", "null"] }, "accepted": { "type": "boolean" }, "fixture": { "anyOf": [{ "type": "null" }, { "type": "object", "required": ["namespace", "entity", "entityId"], "additionalProperties": false, "properties": { "namespace": { "type": "string", "minLength": 1 }, "entity": { "type": "string", "minLength": 1 }, "entityId": { "$ref": "#/$defs/sha256Digest" } } }] }, "effect": { "anyOf": [{ "type": "null" }, { "type": "object", "required": ["kind", "field", "verified", "beforeHash", "expectedHash", "afterHash", "settledHash", "beforeVersionHash", "afterVersionHash", "versionAdvanced"], "additionalProperties": false, "properties": { "kind": { "enum": ["field-change", "version-advance"] }, "field": { "type": "string", "minLength": 1 }, "verified": { "const": true }, "beforeHash": { "$ref": "#/$defs/sha256Digest" }, "expectedHash": { "$ref": "#/$defs/sha256Digest" }, "afterHash": { "$ref": "#/$defs/sha256Digest" }, "settledHash": { "$ref": "#/$defs/sha256Digest" }, "beforeVersionHash": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/sha256Digest" }] }, "afterVersionHash": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/sha256Digest" }] }, "versionAdvanced": { "type": ["boolean", "null"] } } }] }, "convergence": { "anyOf": [{ "type": "null" }, { "type": "object", "required": ["deadlineMs", "elapsedMs", "converged"], "additionalProperties": false, "properties": { "deadlineMs": { "type": "integer", "minimum": 1, "maximum": 120000 }, "elapsedMs": { "type": "number", "minimum": 0 }, "converged": { "const": true } } }] }, "observers": { "type": "array", "items": { "type": "object", "required": ["targetId", "surfaceId", "route", "persona", "context", "status", "agreed", "projection"], "additionalProperties": false, "properties": { "targetId": { "type": ["string", "null"] }, "surfaceId": { "type": ["string", "null"] }, "route": { "type": ["string", "null"] }, "persona": { "type": "string", "minLength": 1 }, "context": { "enum": ["warm-cache", "fresh-context"] }, "status": { "enum": ["measured", "unmeasured"] }, "agreed": { "type": ["boolean", "null"] }, "projection": { "$ref": "#/$defs/stateDigest" } } } } } },
+    "currentCaseV3": { "type": "object", "required": ["id", "flow", "flowExecutionId", "flowExecutionMaterial", "cells", "status", "counts", "findings"], "additionalProperties": false, "properties": { "id": { "type": "string" }, "flow": { "type": "string" }, "observers": { "type": "array", "items": { "$ref": "#/$defs/currentObserver" } }, "rootCauseId": { "type": "string", "pattern": "^crc:[a-f0-9]{64}$" }, "flowExecutionId": { "$ref": "#/$defs/coherenceId" }, "flowExecutionMaterial": { "$ref": "#/$defs/flowExecutionMaterial" }, "cells": { "type": "array", "items": { "$ref": "#/$defs/currentCell" } }, "status": { "enum": ["measured", "invalid"] }, "reason": { "type": "string" }, "counts": { "$ref": "#/$defs/caseCounts" }, "findings": { "type": "array", "items": { "$ref": "#/$defs/currentFinding" } }, "cases": { "type": "array", "items": { "$ref": "#/$defs/currentObservationCase" } }, "mutationAccepted": { "type": "boolean" }, "timing": { "$ref": "#/$defs/caseTiming" } } },
+    "currentCase": { "type": "object", "required": ["id", "flow", "flowExecutionId", "flowExecutionMaterial", "cells", "status", "counts", "findings"], "additionalProperties": false, "properties": { "id": { "type": "string" }, "flow": { "type": "string" }, "observers": { "type": "array", "items": { "$ref": "#/$defs/currentObserver" } }, "rootCauseId": { "type": "string", "pattern": "^crc:[a-f0-9]{64}$" }, "flowExecutionId": { "$ref": "#/$defs/coherenceId" }, "flowExecutionMaterial": { "$ref": "#/$defs/flowExecutionMaterial" }, "cells": { "type": "array", "items": { "$ref": "#/$defs/currentCell" } }, "status": { "enum": ["measured", "invalid"] }, "reason": { "type": "string" }, "counts": { "$ref": "#/$defs/caseCounts" }, "findings": { "type": "array", "items": { "$ref": "#/$defs/currentFinding" } }, "cases": { "type": "array", "items": { "$ref": "#/$defs/currentObservationCase" } }, "causal": { "$ref": "#/$defs/causalEvidence" }, "mutationAccepted": { "type": "boolean" }, "timing": { "$ref": "#/$defs/caseTiming" } } },
+    "currentPlanObligation": { "type": "object", "required": ["id", "mutationId", "targetId", "surfaceId", "principalId", "contextId", "invariantId", "expectation", "status"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "mutationId": { "$ref": "#/$defs/coherenceId" }, "targetId": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }, "surfaceId": { "$ref": "#/$defs/coherenceId" }, "principalId": { "$ref": "#/$defs/coherenceId" }, "contextId": { "$ref": "#/$defs/coherenceId" }, "invariantId": { "$ref": "#/$defs/coherenceId" }, "expectation": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] }, "status": { "enum": ["unmeasured", "reached", "agreed", "disagreed"] }, "reason": { "type": "string" } } },
+    "currentPlanTarget": { "type": "object", "required": ["surfaceId", "route", "status", "counts", "obligations"], "additionalProperties": false, "properties": { "targetId": { "$ref": "#/$defs/coherenceId" }, "surfaceId": { "$ref": "#/$defs/coherenceId" }, "route": { "type": "string" }, "status": { "enum": ["unmeasured", "partial", "agreed", "disagreed"] }, "reason": { "type": "string" }, "counts": { "$ref": "#/$defs/planTargetCounts" }, "obligations": { "type": "array", "items": { "$ref": "#/$defs/currentPlanObligation" } } } },
+    "currentPlanJourney": { "type": "object", "required": ["journeyId", "flow", "status", "targets"], "additionalProperties": false, "properties": { "journeyId": { "type": "string" }, "flow": { "type": ["string", "null"] }, "flowId": { "$ref": "#/$defs/coherenceId" }, "status": { "enum": ["matched", "unmeasured"] }, "reason": { "type": "string" }, "targets": { "type": "array", "items": { "$ref": "#/$defs/currentPlanTarget" } } } },
+    "currentPlan": { "type": "object", "oneOf": [{ "required": ["status", "reason"], "additionalProperties": false, "properties": { "status": { "const": "unmeasured" }, "reason": { "type": "string" } } }, { "required": ["status", "source", "journeys", "obligations", "coverage", "needed"], "additionalProperties": false, "properties": { "status": { "const": "measured" }, "source": { "type": "string" }, "runId": { "type": ["string", "null"] }, "journeys": { "type": "array", "items": { "$ref": "#/$defs/currentPlanJourney" } }, "obligations": { "type": "array", "items": { "$ref": "#/$defs/currentPlanObligation" } }, "coverage": { "$ref": "#/$defs/planCoverage" }, "needed": { "type": "array", "items": { "$ref": "#/$defs/planNeeded" } }, "order": { "type": "array", "items": { "type": "string" } } } }] },
+    "funnel": {
+      "type": "object",
+      "required": [
+        "planned",
+        "completed",
+        "unmeasured"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "planned": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "completed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "unmeasured": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "targets": {
+      "type": "object",
+      "required": [
+        "planned",
+        "reached",
+        "compared",
+        "agreed",
+        "unmeasured"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "planned": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reached": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "compared": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "agreed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "unmeasured": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "obligations": {
+      "type": "object",
+      "required": [
+        "discovered",
+        "resolved",
+        "unresolved",
+        "planned",
+        "reached",
+        "compared",
+        "agreed"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "discovered": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "resolved": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "unresolved": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "planned": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reached": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "compared": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "agreed": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "mutations": {
+      "type": "object",
+      "required": [
+        "declared",
+        "executed"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "declared": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "executed": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "counts": {
+      "type": "object",
+      "required": [
+        "cases",
+        "targets",
+        "personas",
+        "contexts",
+        "cleanups",
+        "obligations",
+        "mutations"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "cases": {
+          "$ref": "#/$defs/funnel"
+        },
+        "targets": {
+          "$ref": "#/$defs/targets"
+        },
+        "personas": {
+          "$ref": "#/$defs/funnel"
+        },
+        "contexts": {
+          "$ref": "#/$defs/funnel"
+        },
+        "cleanups": {
+          "$ref": "#/$defs/funnel"
+        },
+        "obligations": {
+          "$ref": "#/$defs/obligations"
+        },
+        "mutations": {
+          "$ref": "#/$defs/mutations"
+        }
+      }
+    },
+    "planTargetStatus": {
+      "type": "object",
+      "required": [
+        "surfaceId",
+        "route",
+        "status"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "surfaceId": {
+          "type": "string"
+        },
+        "route": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "agreed",
+            "disagreed",
+            "unmeasured"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    },
+    "planJourney": {
+      "type": "object",
+      "required": [
+        "journeyId",
+        "flow",
+        "status",
+        "targets"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "journeyId": {
+          "type": "string"
+        },
+        "flow": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "flowId": { "$ref": "#/$defs/coherenceId" },
+        "status": {
+          "type": "string",
+          "enum": [
+            "matched",
+            "unmeasured"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "targets": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/planTarget"
+          }
+        }
+      }
+    },
+    "planCoverage": {
+      "type": "object",
+      "required": [
+        "discovered",
+        "resolved",
+        "unresolved",
+        "planned",
+        "reached",
+        "compared",
+        "agreed",
+        "disagreed"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "discovered": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "resolved": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "unresolved": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "planned": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reached": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "compared": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "agreed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "disagreed": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "plan": {
+      "type": "object",
+      "oneOf": [
+        {
+          "required": [
+            "status",
+            "reason"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "status": {
+              "const": "unmeasured"
+            },
+            "reason": {
+              "type": "string"
+            }
+          }
+        },
+        {
+          "required": [
+            "status",
+            "source",
+            "journeys",
+            "obligations",
+            "coverage",
+            "needed"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "status": {
+              "const": "measured"
+            },
+            "source": {
+              "type": "string"
+            },
+            "runId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "journeys": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/planJourney"
+              }
+            },
+            "coverage": {
+              "$ref": "#/$defs/planCoverage"
+            },
+            "obligations": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/planObligation"
+              }
+            },
+            "needed": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/planNeeded"
+              }
+            },
+            "order": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      ]
+    },
+    "parallelism": {
+      "type": "object",
+      "required": [
+        "requested",
+        "used",
+        "reason"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "requested": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "used": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    },
+    "resume": {
+      "type": "object",
+      "required": [
+        "journal",
+        "replayed",
+        "invalid"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "journal": {
+          "type": "string"
+        },
+        "replayed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "invalid": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/journalInvalid" }
+          ]
+        }
+      }
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "digestPair": {
+      "type": "object",
+      "required": ["material", "digest"],
+      "additionalProperties": false,
+      "properties": {
+        "material": {},
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "sha256Digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "sourceIdentity": {
+      "type": "object",
+      "required": ["repoRealPath", "gitSha", "dirtyDigest", "clean"],
+      "additionalProperties": false,
+      "properties": {
+        "repoRealPath": { "type": "string", "minLength": 1 },
+        "gitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "dirtyDigest": { "$ref": "#/$defs/sha256Digest" },
+        "clean": { "type": "boolean" }
+      }
+    },
+    "servedIdentity": {
+      "type": "object",
+      "required": ["repoRealPath", "gitSha", "dirtyDigest", "clean", "buildId"],
+      "additionalProperties": false,
+      "properties": {
+        "repoRealPath": { "type": "string", "minLength": 1 },
+        "gitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "dirtyDigest": { "$ref": "#/$defs/sha256Digest" },
+        "clean": { "type": "boolean" },
+        "buildId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "representation": {
+      "type": "object",
+      "required": ["selector", "field", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "selector": { "type": "string", "minLength": 1 },
+        "field": { "type": "string", "minLength": 1 },
+        "type": { "enum": ["string", "number", "boolean", "count", "enum", "money", "date", "datetime", "duration", "unit"] },
+        "source": { "enum": ["text", "value", "attribute", "aria"] },
+        "attribute": { "type": "string" },
+        "locale": { "type": "string" },
+        "timezone": { "type": "string" },
+        "currency": { "type": "string", "pattern": "^[A-Z]{3}$" },
+        "scale": { "type": "integer", "minimum": 0, "maximum": 6 },
+        "inputUnit": { "type": "string" },
+        "canonicalUnit": { "type": "string" },
+        "factor": { "type": "number" },
+        "optional_on_summary": { "type": "boolean" }
+      }
+    },
+    "coherenceId": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "identitySourceRef": { "type": "object", "required": ["file", "line"], "additionalProperties": false, "properties": { "file": { "type": ["string", "null"] }, "line": { "type": "integer", "minimum": 0 } } },
+    "mutationIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "sourceRef", "endpoint"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/mutation" }, "version": { "const": 1 }, "sourceRef": { "$ref": "#/$defs/identitySourceRef" }, "endpoint": { "type": ["string", "null"] } } } } },
+    "surfaceIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "route", "component", "sourceRef"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/surface" }, "version": { "const": 1 }, "route": { "type": "string" }, "component": { "type": ["string", "null"] }, "sourceRef": { "$ref": "#/$defs/identitySourceRef" } } } } },
+    "targetIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "flow", "route", "transition", "role", "representation"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/target" }, "version": { "const": 1 }, "flow": { "$ref": "#/$defs/flowIdentity" }, "route": { "type": "string" }, "transition": { "type": ["string", "null"] }, "role": { "type": ["string", "null"] }, "representation": { "type": "object", "required": ["field", "type"], "additionalProperties": false, "properties": { "field": { "type": "string" }, "type": { "type": "string" }, "source": { "type": "string" }, "attribute": { "type": "string" }, "locale": { "type": "string" }, "timezone": { "type": "string" }, "currency": { "type": "string" }, "scale": { "type": "integer" }, "inputUnit": { "type": "string" }, "canonicalUnit": { "type": "string" }, "factor": { "type": "number" }, "optional_on_summary": { "type": "boolean" } } } } } } },
+    "principalIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "name"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/principal" }, "version": { "const": 1 }, "name": { "type": "string" } } } } },
+    "entityIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "name"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/entity" }, "version": { "const": 1 }, "name": { "type": "string" } } } } },
+    "flowIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "route", "declaredEndpoint"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/flow" }, "version": { "const": 1 }, "route": { "type": "string" }, "declaredEndpoint": { "type": "string" } } } } },
+    "contextIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "kind", "transition"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/context" }, "version": { "const": 1 }, "kind": { "enum": ["warm-cache", "fresh-context"] }, "transition": { "type": ["string", "null"] } } } } },
+    "invariantIdentity": { "type": "object", "required": ["id", "material"], "additionalProperties": false, "properties": { "id": { "$ref": "#/$defs/coherenceId" }, "material": { "type": "object", "required": ["namespace", "version", "name"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/invariant" }, "version": { "const": 1 }, "name": { "enum": ["field-parity", "visibility-policy", "durability"] } } } } },
+    "observer": {
+      "type": "object",
+      "required": ["persona", "expect"],
+      "additionalProperties": false,
+      "properties": {
+        "persona": { "type": "string", "minLength": 1 },
+        "expect": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] },
+        "identity": { "$ref": "#/$defs/principalIdentity" }
+      }
+    },
+    "semanticTarget": {
+      "type": "object",
+      "required": ["id", "route", "transition", "representation"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "route": { "type": "string", "minLength": 1 },
+        "role": { "type": "string" },
+        "transition": { "enum": ["same-surface", "client-navigation", "reload", "fresh-context", "history-back", "history-forward", "direct-url", "offline-replay"] },
+        "representation": { "$ref": "#/$defs/representation" }
+        ,"identity": { "$ref": "#/$defs/targetIdentity" }
+        ,"surfaceMatch": { "type": "object", "required": ["surface", "evidence"], "additionalProperties": false, "properties": { "surface": { "$ref": "#/$defs/surfaceIdentity" }, "evidence": { "type": "object", "required": ["source", "kind"], "additionalProperties": false, "properties": { "source": { "type": "string", "minLength": 1 }, "kind": { "const": "declared" } } } } }
+      }
+    },
+    "causalContract": { "type": "object", "required": ["entity", "effect", "convergence"], "additionalProperties": false, "properties": { "entity": { "type": "string", "minLength": 1 }, "effect": { "type": "object", "required": ["kind", "field"], "additionalProperties": false, "properties": { "kind": { "enum": ["field-change", "version-advance"] }, "field": { "type": "string", "minLength": 1 } } }, "convergence": { "type": "object", "required": ["deadlineMs"], "additionalProperties": false, "properties": { "deadlineMs": { "type": "integer", "minimum": 1, "maximum": 120000 } } } } },
+    "crosscheck": {
+      "type": "object",
+      "required": ["entity", "writer", "authoritative_readback", "observers", "targets"],
+      "additionalProperties": false,
+      "properties": {
+        "entity": { "type": "string", "minLength": 1 },
+        "entityIdentity": { "$ref": "#/$defs/entityIdentity" },
+        "mutationIdentity": { "$ref": "#/$defs/mutationIdentity" },
+        "writer": { "type": "string", "minLength": 1 },
+        "writerIdentity": { "$ref": "#/$defs/principalIdentity" },
+        "authoritative_readback": { "type": "string", "minLength": 1 },
+        "plan_journey": { "type": "string", "minLength": 1 },
+        "isolation": { "const": "per-flow" },
+        "causal": { "$ref": "#/$defs/causalContract" },
+        "observers": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/observer" } },
+        "targets": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/semanticTarget" } }
+      }
+    },
+    "rawFlowDeclaration": {
+      "type": "object",
+      "required": ["name", "production", "crosscheck"],
+      "additionalProperties": true,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "route": { "type": "string" },
+        "declared_endpoint": { "type": "string" },
+        "cleanup_required": { "type": "boolean" },
+        "production": { "const": false },
+        "identity": { "$ref": "#/$defs/flowIdentity" },
+        "crosscheck": { "$ref": "#/$defs/crosscheck" }
+      }
+    },
+    "selectedFlowDeclarations": {
+      "type": "object",
+      "required": ["namespace", "version", "schemaVersion", "flows"],
+      "additionalProperties": false,
+      "properties": {
+        "namespace": { "const": "coherence/selected-flow-declarations" },
+        "version": { "const": 1 },
+        "schemaVersion": { "enum": [1, 2, 3] },
+        "flows": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/rawFlowDeclaration" } }
+      }
+    },
+    "cleanupPermit": {
+      "type": "object",
+      "required": ["required", "allowed"],
+      "additionalProperties": false,
+      "properties": {
+        "required": { "type": "boolean" },
+        "allowed": { "type": "boolean" }
+      }
+    },
+    "mutationPermit": {
+      "type": "object",
+      "required": ["namespace", "version", "allowed", "mutateRequested", "overrideNonLocalRequested", "base", "lane", "maxMutations", "cleanupCapable", "fixtureNamespaceRule", "selectedFlows", "cleanup"],
+      "additionalProperties": false,
+      "properties": {
+        "namespace": { "const": "coherence/mutation-permit" },
+        "version": { "const": 1 },
+        "allowed": { "const": true },
+        "mutateRequested": { "const": true },
+        "overrideNonLocalRequested": { "type": "boolean" },
+        "base": { "type": "string", "minLength": 1 },
+        "lane": { "type": "string", "minLength": 1 },
+        "maxMutations": { "type": "integer", "minimum": 1 },
+        "cleanupCapable": { "const": true },
+        "fixtureNamespaceRule": { "const": "fixtureNamespaceFor(runId,flowName)/v1" },
+        "selectedFlows": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "cleanup": { "$ref": "#/$defs/cleanupPermit" }
+      }
+    },
+    "measurementConfiguration": {
+      "type": "object",
+      "required": ["namespace", "version", "measurementConfig", "autoFlags", "prod"],
+      "additionalProperties": false,
+      "properties": {
+        "namespace": { "const": "marathon/measurement-configuration" },
+        "version": { "const": 1 },
+        "measurementConfig": {
+          "type": "object",
+          "required": ["widthsGiven", "states", "dark", "extraFlags", "autonomous"],
+          "additionalProperties": false,
+          "properties": {
+            "widthsGiven": { "type": "boolean" },
+            "states": { "type": "boolean" },
+            "dark": { "type": "boolean" },
+            "extraFlags": { "type": "array", "items": { "type": "string" } },
+            "autonomous": { "type": "boolean" }
+          }
+        },
+        "autoFlags": { "type": "array", "items": { "type": "string" } },
+        "prod": { "type": "boolean" }
+      }
+    },
+    "outerEvidenceIdentity": {
+      "type": "object",
+      "required": ["marathonRunId", "repoRealPath", "sourceDigest", "base", "lane", "flowWorkers", "planDigest", "flowDeclarationDigest", "principalDigest", "configurationDigest", "toolProtocol"],
+      "additionalProperties": false,
+      "properties": {
+        "marathonRunId": { "type": "string", "minLength": 1 },
+        "repoRealPath": { "type": "string", "minLength": 1 },
+        "sourceDigest": { "$ref": "#/$defs/sha256Digest" },
+        "base": { "type": "string", "minLength": 1 },
+        "lane": { "type": "string", "minLength": 1 },
+        "flowWorkers": { "type": "integer", "minimum": 1 },
+        "planDigest": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/sha256Digest" }] },
+        "flowDeclarationDigest": { "$ref": "#/$defs/sha256Digest" },
+        "principalDigest": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/sha256Digest" }] },
+        "configurationDigest": { "$ref": "#/$defs/sha256Digest" },
+        "toolProtocol": { "const": "marathon-adapter/v1" }
+      }
+    },
+    "documentCoordinate": {
+      "type": "object",
+      "required": ["status", "kind"],
+      "additionalProperties": false,
+      "properties": {
+        "status": { "enum": ["absent", "present"] },
+        "kind": { "enum": ["coherence-plan", "principal-declaration"] },
+        "document": { "type": "object" }
+      }
+    },
+    "envelope": {
+      "type": "object",
+      "required": ["namespace", "version", "outerEvidenceIdentity", "coordinates", "digest"],
+      "additionalProperties": false,
+      "properties": {
+        "namespace": { "const": "coherence-evidence-envelope" },
+        "version": { "const": 1 },
+        "outerEvidenceIdentity": {
+          "type": "object",
+          "required": ["material", "digest"],
+          "additionalProperties": false,
+          "properties": { "material": { "$ref": "#/$defs/outerEvidenceIdentity" }, "digest": { "$ref": "#/$defs/digest" } }
+        },
+        "coordinates": {
+          "type": "object",
+          "required": ["runId", "repoRealPath", "source", "base", "served", "lane", "flowWorkers", "plan", "flowDeclaration", "principal", "mutationPermit", "configuration", "protocol", "toolBuild"],
+          "additionalProperties": false,
+          "properties": {
+            "runId": { "$ref": "#/$defs/stringCoordinate" },
+            "repoRealPath": { "$ref": "#/$defs/stringCoordinate" },
+            "source": { "$ref": "#/$defs/sourceCoordinate" },
+            "base": { "$ref": "#/$defs/stringCoordinate" },
+            "served": { "$ref": "#/$defs/servedCoordinate" },
+            "lane": { "$ref": "#/$defs/stringCoordinate" },
+            "flowWorkers": { "$ref": "#/$defs/integerCoordinate" },
+            "plan": { "$ref": "#/$defs/documentDigestCoordinate" },
+            "flowDeclaration": { "$ref": "#/$defs/flowDeclarationCoordinate" },
+            "principal": { "$ref": "#/$defs/documentDigestCoordinate" },
+            "mutationPermit": { "$ref": "#/$defs/mutationPermitCoordinate" },
+            "configuration": { "$ref": "#/$defs/configurationCoordinate" },
+            "protocol": { "$ref": "#/$defs/protocolCoordinate" },
+            "toolBuild": { "$ref": "#/$defs/toolBuildCoordinate" }
+          }
+        },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "stringCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "integerCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "type": "integer", "minimum": 1 }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "sourceCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "$ref": "#/$defs/sourceIdentity" }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "servedCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "$ref": "#/$defs/servedIdentity" }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "documentDigestCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "$ref": "#/$defs/documentCoordinate" }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "flowDeclarationCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "$ref": "#/$defs/selectedFlowDeclarations" }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "mutationPermitCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "$ref": "#/$defs/mutationPermit" }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "configurationCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": { "material": { "$ref": "#/$defs/measurementConfiguration" }, "digest": { "$ref": "#/$defs/digest" } }
+    },
+    "protocolCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": {
+        "material": { "type": "object", "required": ["namespace", "version", "outer"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/runtime-protocol" }, "version": { "const": 1 }, "outer": { "const": "marathon-adapter/v1" } } },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "toolBuildCoordinate": {
+      "type": "object", "required": ["material", "digest"], "additionalProperties": false,
+      "properties": {
+        "material": { "type": "object", "required": ["namespace", "version", "files"], "additionalProperties": false, "properties": { "namespace": { "const": "coherence/tool-build" }, "version": { "const": 1 }, "files": { "type": "object", "additionalProperties": { "$ref": "#/$defs/digest" } } } },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "cell": {
+      "type": "object",
+      "required": ["cellId", "material"],
+      "additionalProperties": false,
+      "properties": {
+        "cellId": { "$ref": "#/$defs/digest" },
+        "material": {
+          "type": "object",
+          "required": ["namespace", "version", "mutation", "target", "surface", "principal", "context", "invariant"],
+          "additionalProperties": false,
+          "properties": {
+            "namespace": { "const": "coherence/observation-cell" },
+            "version": { "const": 1 },
+            "mutation": { "anyOf": [{
+              "type": "object",
+              "required": ["flow", "matchedPlanMutation", "entity", "writer", "authoritativeReadback"],
+              "additionalProperties": false,
+              "properties": {
+                "flow": { "type": "string", "minLength": 1 },
+                "matchedPlanMutation": {
+                  "type": "object",
+                  "oneOf": [
+                    { "required": ["status"], "additionalProperties": false, "properties": { "status": { "const": "absent" } } },
+                    { "required": ["status", "id"], "additionalProperties": false, "properties": { "status": { "const": "resolved" }, "id": { "type": "string", "minLength": 1 } } }
+                  ]
+                },
+                "entity": { "type": "string", "minLength": 1 },
+                "writer": { "type": "string", "minLength": 1 },
+                "authoritativeReadback": { "type": "string", "minLength": 1 }
+              }
+            }, { "$ref": "#/$defs/mutationIdentity" }] },
+            "target": { "anyOf": [{ "$ref": "#/$defs/semanticTarget" }, { "$ref": "#/$defs/targetIdentity" }] },
+            "surface": { "anyOf": [{
+              "type": "object",
+              "required": ["status", "reason"],
+              "additionalProperties": false,
+              "properties": { "status": { "const": "unresolved" }, "reason": { "const": "logical-surface-not-resolved" } }
+            }, { "$ref": "#/$defs/surfaceIdentity" }] },
+            "principal": { "anyOf": [{
+              "type": "object",
+              "required": ["persona", "expect"],
+              "additionalProperties": false,
+              "properties": { "persona": { "type": "string", "minLength": 1 }, "expect": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] } }
+            }, { "$ref": "#/$defs/principalIdentity" }] },
+            "context": { "anyOf": [{
+              "type": "object",
+              "required": ["kind", "transition"],
+              "additionalProperties": false,
+              "properties": {
+                "kind": { "enum": ["warm-cache", "fresh-context"] },
+                "transition": { "anyOf": [{ "type": "null" }, { "enum": ["same-surface", "client-navigation", "reload", "fresh-context", "history-back", "history-forward", "direct-url", "offline-replay"] }] }
+              }
+            }, { "$ref": "#/$defs/contextIdentity" }] },
+            "invariant": { "anyOf": [{ "enum": ["field-parity", "visibility-policy", "durability"] }, { "$ref": "#/$defs/invariantIdentity" }] },
+            "expectation": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] }
+          }
+        }
+      }
+    },
+    "canonicalFlowDeclaration": {
+      "type": "object",
+      "required": ["name", "route", "declaredEndpoint", "cleanupRequired", "crosscheck"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "route": { "type": ["string", "null"] },
+        "declaredEndpoint": { "type": ["string", "null"] },
+        "cleanupRequired": { "type": "boolean" },
+        "identity": { "$ref": "#/$defs/flowIdentity" },
+        "crosscheck": { "$ref": "#/$defs/crosscheck" }
+      }
+    },
+    "flowMutationPolicy": {
+      "type": "object",
+      "required": ["namespace", "version", "permit", "selectedFlow"],
+      "additionalProperties": false,
+      "properties": {
+        "namespace": { "const": "coherence/flow-mutation-policy" },
+        "version": { "const": 1 },
+        "permit": { "$ref": "#/$defs/mutationPermit" },
+        "selectedFlow": { "type": "string", "minLength": 1 }
+      }
+    },
+    "flowPlanJourney": {
+      "type": "object",
+      "oneOf": [
+        { "required": ["status"], "additionalProperties": false, "properties": { "status": { "const": "absent" } } },
+        { "required": ["status", "journey"], "additionalProperties": false, "properties": { "status": { "const": "matched" }, "journey": { "type": "object" } } }
+      ]
+    },
+    "flowExecutionCell": {
+      "type": "object",
+      "required": ["cellId", "materialDigest"],
+      "additionalProperties": false,
+      "properties": { "cellId": { "$ref": "#/$defs/digest" }, "materialDigest": { "$ref": "#/$defs/digest" } }
+    },
+    "flowExecutionMaterial": {
+      "type": "object",
+      "required": ["namespace", "version", "declaration", "mutationPolicy", "planJourney", "cells"],
+      "additionalProperties": false,
+      "properties": {
+        "namespace": { "const": "coherence/flow-execution" },
+        "version": { "const": 1 },
+        "declaration": { "$ref": "#/$defs/canonicalFlowDeclaration" },
+        "mutationPolicy": { "$ref": "#/$defs/flowMutationPolicy" },
+        "planJourney": { "$ref": "#/$defs/flowPlanJourney" },
+        "cells": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/flowExecutionCell" } }
+      }
+    },
+    "caseCounts": {
+      "type": "object",
+      "required": ["targets", "personas", "contexts", "cleanups"],
+      "additionalProperties": false,
+      "properties": {
+        "targets": { "$ref": "#/$defs/targets" },
+        "personas": { "$ref": "#/$defs/funnel" },
+        "contexts": { "$ref": "#/$defs/funnel" },
+        "cleanups": { "$ref": "#/$defs/funnel" }
+      }
+    },
+    "stateDigest": {
+      "type": "object",
+      "required": ["status", "state", "hash", "reason"],
+      "additionalProperties": false,
+      "properties": {
+        "status": { "enum": ["measured", "unmeasured"] },
+        "state": { "anyOf": [{ "type": "null" }, { "enum": ["value", "empty", "absent", "failed", "withheld", "redacted", "forbidden", "loading"] }] },
+        "hash": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/sha256Digest" }] },
+        "reason": { "type": ["string", "null"] }
+      }
+    },
+    "warmObservation": {
+      "type": "object",
+      "required": ["persona", "context", "transition", "invariant", "status", "agreed", "reason", "comparisonReason", "refetched", "typed", "authoritative", "observed"],
+      "additionalProperties": false,
+      "properties": {
+        "persona": { "type": "string", "minLength": 1 },
+        "context": { "enum": ["warm-cache", "fresh-context"] },
+        "transition": { "anyOf": [{ "type": "null" }, { "enum": ["same-surface", "client-navigation", "reload", "fresh-context", "history-back", "history-forward", "direct-url", "offline-replay"] }] },
+        "invariant": { "enum": ["field-parity", "visibility-policy"] },
+        "principalId": { "$ref": "#/$defs/coherenceId" },
+        "contextId": { "$ref": "#/$defs/coherenceId" },
+        "invariantId": { "$ref": "#/$defs/coherenceId" },
+        "expectation": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] },
+        "status": { "enum": ["measured", "unmeasured"] },
+        "agreed": { "type": ["boolean", "null"] },
+        "reason": { "type": ["string", "null"] },
+        "comparisonReason": { "type": ["string", "null"] },
+        "refetched": { "type": "boolean" },
+        "typed": { "type": "boolean" },
+        "authoritative": { "$ref": "#/$defs/stateDigest" },
+        "observed": { "$ref": "#/$defs/stateDigest" }
+      }
+    },
+    "freshObservation": {
+      "type": "object",
+      "required": ["persona", "context", "invariants", "status", "agreed", "reason", "authoritative", "observed"],
+      "additionalProperties": false,
+      "properties": {
+        "persona": { "type": "string", "minLength": 1 },
+        "context": { "const": "fresh-context" },
+        "invariants": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "enum": ["field-parity", "durability"] } },
+        "principalId": { "$ref": "#/$defs/coherenceId" },
+        "contextId": { "$ref": "#/$defs/coherenceId" },
+        "invariantIds": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "$ref": "#/$defs/coherenceId" } },
+        "expectation": { "const": "visible" },
+        "status": { "enum": ["measured", "unmeasured"] },
+        "agreed": { "type": ["boolean", "null"] },
+        "reason": { "type": ["string", "null"] },
+        "authoritative": { "$ref": "#/$defs/stateDigest" },
+        "observed": { "$ref": "#/$defs/stateDigest" }
+      }
+    },
+    "observationCase": {
+      "type": "object",
+      "required": ["targetId", "route", "observations", "fresh", "status", "comparison"],
+      "additionalProperties": false,
+      "properties": {
+        "targetId": { "type": ["string", "null"] },
+        "surfaceId": { "type": ["string", "null"] },
+        "route": { "type": ["string", "null"] },
+        "observations": { "type": "array", "items": { "$ref": "#/$defs/warmObservation" } },
+        "fresh": { "$ref": "#/$defs/freshObservation" },
+        "status": { "enum": ["measured", "unmeasured"] },
+        "reason": { "type": "string" },
+        "comparison": {
+          "anyOf": [
+            { "type": "null" },
+            {
+              "type": "object", "required": ["agreed", "authoritative", "fresh"], "additionalProperties": false,
+              "properties": { "agreed": { "type": "boolean" }, "authoritative": { "$ref": "#/$defs/stateDigest" }, "fresh": { "$ref": "#/$defs/stateDigest" } }
+            }
+          ]
+        }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "required": ["kind", "severity"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "severity": { "enum": ["P0", "P1", "P2", "P3"] },
+        "rootCauseId": { "type": "string", "pattern": "^crc:[a-f0-9]{64}$" },
+        "targetId": { "type": ["string", "null"] },
+        "surfaceId": { "type": ["string", "null"] },
+        "route": { "type": ["string", "null"] },
+        "persona": { "type": "string" }
+      }
+    },
+    "caseTiming": {
+      "type": "object",
+      "required": ["startedAt", "endedAt", "durationMs"],
+      "additionalProperties": false,
+      "properties": {
+        "startedAt": { "type": "string", "minLength": 1 },
+        "endedAt": { "type": "string", "minLength": 1 },
+        "durationMs": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "case": {
+      "type": "object",
+      "required": ["id", "flow", "flowExecutionId", "flowExecutionMaterial", "cells", "status", "counts", "findings"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string" },
+        "flow": { "type": "string" },
+        "observers": { "type": "array", "items": { "$ref": "#/$defs/observer" } },
+        "rootCauseId": { "type": "string", "pattern": "^crc:[a-f0-9]{64}$" },
+        "flowExecutionId": { "$ref": "#/$defs/digest" },
+        "flowExecutionMaterial": { "$ref": "#/$defs/flowExecutionMaterial" },
+        "cells": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/cell" } },
+        "status": { "enum": ["measured", "invalid"] },
+        "reason": { "type": "string" },
+        "counts": { "$ref": "#/$defs/caseCounts" },
+        "findings": { "type": "array", "items": { "$ref": "#/$defs/finding" } },
+        "cases": { "type": "array", "items": { "$ref": "#/$defs/observationCase" } },
+        "causal": { "$ref": "#/$defs/causalEvidence" },
+        "mutationAccepted": { "type": "boolean" },
+        "timing": { "$ref": "#/$defs/caseTiming" }
+      }
+    },
+    "journalInvalid": {
+      "type": "object",
+      "required": ["reason", "detail", "quarantinePath", "quarantineDigest", "at"],
+      "additionalProperties": false,
+      "properties": {
+        "reason": { "type": "string", "minLength": 1 },
+        "detail": { "type": ["string", "null"] },
+        "quarantinePath": { "type": "string", "minLength": 1 },
+        "quarantineDigest": { "$ref": "#/$defs/digest" },
+        "at": { "type": "string", "minLength": 1 }
+      }
+    },
+    "planObligation": {
+      "type": "object",
+      "required": [
+        "id",
+        "status"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mutationId": { "$ref": "#/$defs/coherenceId" },
+        "targetId": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+        "surfaceId": { "$ref": "#/$defs/coherenceId" },
+        "principalId": { "$ref": "#/$defs/coherenceId" },
+        "contextId": { "$ref": "#/$defs/coherenceId" },
+        "invariantId": { "$ref": "#/$defs/coherenceId" },
+        "expectation": { "enum": ["visible", "absent", "redacted", "withheld", "forbidden"] },
+        "status": {
+          "type": "string",
+          "enum": [
+            "unmeasured",
+            "reached",
+            "agreed",
+            "disagreed"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    },
+    "planTargetCounts": {
+      "type": "object",
+      "required": [
+        "planned",
+        "reached",
+        "compared",
+        "agreed",
+        "disagreed",
+        "unmeasured"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "planned": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reached": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "compared": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "agreed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "disagreed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "unmeasured": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "planTarget": {
+      "type": "object",
+      "required": [
+        "surfaceId",
+        "route",
+        "status",
+        "counts",
+        "obligations"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "targetId": { "$ref": "#/$defs/coherenceId" },
+        "surfaceId": {
+          "type": "string"
+        },
+        "route": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "unmeasured",
+            "partial",
+            "agreed",
+            "disagreed"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "counts": {
+          "$ref": "#/$defs/planTargetCounts"
+        },
+        "obligations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/planObligation"
+          }
+        }
+      }
+    },
+    "planNeeded": {
+      "type": "object",
+      "required": [
+        "journeyId",
+        "reason",
+        "contract"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "journeyId": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "contract": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}