@disclosureos/schema 2.0.0-beta.0 → 2.0.0-beta.2

package/dist/experimental/v2/index.js

@@ -1,4 +1,4 @@
-import { parseExperimentalClaimHistory, compareUtcInstants } from '@disclosureos/records/experimental/v2';
+import { parseExperimentalClaimHistory, compareUtcInstants, parseContextClaimHistory, parseObservationContext, parseExperimentalObservation, parseResearchClaimHistory, parseResearchEntities, researchEntityAssertions, researchEntityContextReferences, contextAssertions } from '@disclosureos/records/experimental/v2';
 import { z } from 'zod';
 import { parseAcquisitionContext } from '@disclosureos/instruments/experimental/v2';
 
@@ -4526,7 +4526,856 @@ function migrationCompatibilityJsonSchema() {
     $id: MIGRATION_COMPATIBILITY_SCHEMA_ID
   };
 }
+var CONTEXT_MEASUREMENT_ROLES = {
+  size: {
+    entities: ["reported_object"],
+    quantities: ["size", "length"],
+    units: ["m", "km"]
+  },
+  count: { entities: ["reported_object"], quantities: ["count"], units: ["1"] },
+  speed: {
+    entities: ["reported_object", "platform"],
+    quantities: ["speed"],
+    units: ["m/s", "km/h"]
+  },
+  altitude: {
+    entities: ["reported_object", "platform", "place"],
+    quantities: ["altitude", "elevation"],
+    units: ["m", "km"]
+  },
+  heading: {
+    entities: ["reported_object", "platform"],
+    quantities: ["heading"],
+    units: ["deg"]
+  },
+  ambient_temperature: {
+    entities: ["environment"],
+    quantities: ["temperature", "ambient_temperature"],
+    units: ["Cel", "K"]
+  },
+  relative_humidity: {
+    entities: ["environment"],
+    quantities: ["relative_humidity"],
+    units: ["%"]
+  },
+  wind_speed: {
+    entities: ["environment"],
+    quantities: ["wind_speed"],
+    units: ["m/s", "km/h"]
+  },
+  moon_illumination: {
+    entities: ["environment"],
+    quantities: ["moon_illumination"],
+    units: ["%", "1"]
+  },
+  duration: {
+    entities: ["temporal", "collection"],
+    quantities: ["duration"],
+    units: ["s", "min", "h"]
+  },
+  distance: {
+    entities: ["place"],
+    quantities: ["distance"],
+    units: ["m", "km"]
+  },
+  bearing: { entities: ["place"], quantities: ["bearing"], units: ["deg"] },
+  water_depth: {
+    entities: ["place"],
+    quantities: ["water_depth"],
+    units: ["m"]
+  },
+  coordinate_precision: {
+    entities: ["place"],
+    quantities: ["coordinate_precision"],
+    units: ["m"]
+  },
+  time_alignment: {
+    entities: ["collection"],
+    quantities: ["time_alignment_uncertainty"],
+    units: ["s", "ms"]
+  }
+};
+function equal(a, b) {
+  if (a === b) return true;
+  if (!a || !b || typeof a !== "object" || typeof b !== "object") return false;
+  if (Array.isArray(a) || Array.isArray(b))
+    return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((v, i) => equal(v, b[i]));
+  const x = a, y = b;
+  return Object.keys(x).length === Object.keys(y).length && Object.keys(x).every(
+    (k) => Object.prototype.hasOwnProperty.call(y, k) && equal(x[k], y[k])
+  );
+}
+async function evaluateContextClaimHistory(input, options) {
+  const history = parseContextClaimHistory(input);
+  const issues = history.issues.map((i) => ({
+    code: i.code,
+    stage: i.stage,
+    pointer: i.pointer,
+    message: i.message
+  }));
+  const snapshots = [];
+  const contexts = /* @__PURE__ */ new Map();
+  const problem = (code, pointer6, message, stage = "semantic") => issues.push({ code, pointer: pointer6, message, stage });
+  async function load(ref5, pointer6) {
+    const supplied = options.documents.get(ref5.sha256);
+    const bytes = supplied ? Uint8Array.from(supplied) : void 0;
+    if (!bytes) {
+      snapshots.push({ ...ref5, status: "unavailable" });
+      problem(
+        "SNAPSHOT.UNAVAILABLE",
+        pointer6,
+        "Required snapshot bytes were not supplied.",
+        "external"
+      );
+      return;
+    }
+    if ([
+      ...new Uint8Array(
+        await globalThis.crypto.subtle.digest("SHA-256", bytes)
+      )
+    ].map((b) => b.toString(16).padStart(2, "0")).join("") !== ref5.sha256) {
+      snapshots.push({ ...ref5, status: "failed" });
+      problem(
+        "SNAPSHOT.DIGEST",
+        pointer6,
+        "Supplied bytes do not match the reference digest.",
+        "external"
+      );
+      return;
+    }
+    let value;
+    try {
+      value = JSON.parse(
+        new TextDecoder("utf-8", { fatal: true }).decode(bytes)
+      );
+    } catch {
+      snapshots.push({ ...ref5, status: "failed" });
+      problem(
+        "SNAPSHOT.JSON",
+        pointer6,
+        "Snapshot is not a UTF-8 JSON document.",
+        "external"
+      );
+      return;
+    }
+    snapshots.push({ ...ref5, status: "passed" });
+    if (!value || typeof value !== "object" || value.id !== ref5.documentId) {
+      problem(
+        "SNAPSHOT.IDENTITY",
+        pointer6,
+        "Snapshot document ID does not match its reference."
+      );
+      return;
+    }
+    return value;
+  }
+  async function checkContext(context, observation, p) {
+    const sources = new Map([
+      ...observation.sources.map((s) => [`source:${s.id}`, s]),
+      ...observation.products.map((s) => [`product:${s.id}`, s])
+    ]);
+    const methods = new Map(
+      observation.methods.map((m) => [`method:${m.id}`, m])
+    );
+    const measurements = new Map(
+      observation.measurements.map((m) => [m.id, m])
+    );
+    let acquisitionIds;
+    if (context.acquisitionRef) {
+      const value = await load(context.acquisitionRef, `${p}/acquisitionRef`);
+      if (value !== void 0) {
+        const acquisition = parseAcquisitionContext(value);
+        if (!acquisition.success)
+          problem(
+            "CONTEXT.ACQUISITION",
+            `${p}/acquisitionRef`,
+            "Acquisition snapshot does not satisfy its declared contract.",
+            acquisition.checks.structural === "failed" ? "structural" : "semantic"
+          );
+        else
+          acquisitionIds = new Set(
+            acquisition.data.acquisitions.map((a) => a.id)
+          );
+      }
+    }
+    for (const [index, entity] of context.entities.entries()) {
+      const ep = `${p}/entities/${index}`;
+      for (const { field, assertion } of contextAssertions(entity)) {
+        const prov = assertion.content.provenance;
+        if (prov) {
+          const source = sources.get(prov.sourceRef);
+          if (!source)
+            problem(
+              "REF.LOCAL_RESOLUTION",
+              ep,
+              "Context source is absent from the scoped observation."
+            );
+          else if (source.digest && prov.sourceDigest && source.digest.value !== prov.sourceDigest.value)
+            problem(
+              "SOURCE.DIGEST_MISMATCH",
+              ep,
+              "Source digest declarations differ."
+            );
+        }
+        const value = assertion.content.value;
+        if (value === void 0) continue;
+        if (field === "productRefs") {
+          for (const ref5 of value)
+            if (!sources.has(ref5))
+              problem(
+                "REF.LOCAL_RESOLUTION",
+                ep,
+                "Collection artifact is not declared."
+              );
+        }
+        if (field === "acquisitionIds") {
+          for (const id12 of value)
+            if (!acquisitionIds?.has(id12))
+              problem(
+                "REF.ACQUISITION",
+                ep,
+                "Acquisition ID needs a supplied, valid acquisition snapshot."
+              );
+        }
+        if (field === "position") {
+          const checked = parseExperimentalObservation({
+            ...observation,
+            position: { state: "known", value, sourceRefs: [prov.sourceRef] }
+          });
+          if (!checked.success)
+            problem(
+              "CONTEXT.POSITION",
+              ep,
+              "Context position must satisfy the observation frame, unit and source-reference rules."
+            );
+        }
+      }
+      for (const selection of entity.selections ?? []) {
+        if (methods.get(selection.methodRef)?.version !== selection.methodVersion)
+          problem(
+            "METHOD.VERSION_MISMATCH",
+            ep,
+            "Selection method/version must match the observation inventory."
+          );
+      }
+      const proximityLinks = contextAssertions(entity).flatMap(
+        ({ field, assertion }) => {
+          if (field !== "proximity" || !assertion.content.value) return [];
+          const value = assertion.content.value;
+          return [
+            ...value.distanceMeasurementId ? [
+              {
+                id: assertion.id,
+                role: "distance",
+                measurementId: value.distanceMeasurementId,
+                relatedPlaceId: value.targetPlaceId
+              }
+            ] : [],
+            ...value.bearingMeasurementId ? [
+              {
+                id: assertion.id,
+                role: "bearing",
+                measurementId: value.bearingMeasurementId,
+                relatedPlaceId: value.targetPlaceId
+              }
+            ] : []
+          ];
+        }
+      );
+      for (const link of [...entity.measurements ?? [], ...proximityLinks]) {
+        const role = CONTEXT_MEASUREMENT_ROLES[link.role];
+        const measurement = measurements.get(link.measurementId);
+        if (!measurement) {
+          problem(
+            "REF.MEASUREMENT",
+            ep,
+            "Measurement is absent from the scoped observation."
+          );
+          continue;
+        }
+        if (!role.entities.includes(entity.kind) || !role.quantities.includes(
+          measurement.quantity
+        ) || !role.units.includes(measurement.value.unit))
+          problem(
+            "CONTEXT.MEASUREMENT_ROLE",
+            ep,
+            "Measurement entity, quantity and unit must match the declared role."
+          );
+        const value = measurement.value.value;
+        if ([
+          "count",
+          "size",
+          "speed",
+          "wind_speed",
+          "duration",
+          "distance",
+          "water_depth",
+          "coordinate_precision",
+          "time_alignment"
+        ].includes(link.role) && value < 0)
+          problem(
+            "CONTEXT.MEASUREMENT_RANGE",
+            ep,
+            "This role cannot be negative."
+          );
+        if (link.role === "count" && !Number.isInteger(value))
+          problem("CONTEXT.MEASUREMENT_RANGE", ep, "Count must be an integer.");
+        if (["heading", "bearing"].includes(link.role) && (value < 0 || value > 360))
+          problem(
+            "CONTEXT.MEASUREMENT_RANGE",
+            ep,
+            "Direction must lie between zero and 360 degrees."
+          );
+        if (["relative_humidity", "moon_illumination"].includes(link.role) && (value < 0 || value > (measurement.value.unit === "1" ? 1 : 100)))
+          problem(
+            "CONTEXT.MEASUREMENT_RANGE",
+            ep,
+            "Fraction lies outside its unit range."
+          );
+        if (["distance", "bearing"].includes(link.role) && !link.relatedPlaceId)
+          problem(
+            "CONTEXT.RELATED_PLACE",
+            ep,
+            "Distance and bearing must identify the other place."
+          );
+      }
+    }
+  }
+  if (history.success) {
+    let resolve2 = function(reference, pointer6, assertionId) {
+      const context = contexts.get(reference.document.sha256);
+      if (!context) return;
+      const entity = context.entities.find(
+        (e) => e.kind === reference.target.kind && e.id === reference.target.id
+      );
+      if (!entity) {
+        problem(
+          "REF.ENTITY",
+          pointer6,
+          "Typed entity is absent from the selected snapshot."
+        );
+        return;
+      }
+      const assertions = contextAssertions(entity);
+      if (reference.target.field && !assertions.some((a) => a.field === reference.target.field))
+        problem(
+          "REF.FIELD",
+          pointer6,
+          "Target field has no supplied assertions."
+        );
+      if (assertionId && (!reference.target.field || !assertions.some(
+        (a) => a.field === reference.target.field && a.assertion.id === assertionId
+      )))
+        problem(
+          "REF.ASSERTION",
+          pointer6,
+          "Assessment input must select an existing assertion on its named field."
+        );
+    };
+    for (const [i, ref5] of history.data.contextRefs.entries()) {
+      const p = `/contextRefs/${i}`;
+      const value = await load(ref5, p);
+      if (value === void 0) continue;
+      const parsed = parseObservationContext(value);
+      if (!parsed.success) {
+        issues.push(
+          ...parsed.issues.map((i2) => ({ ...i2, pointer: p + i2.pointer }))
+        );
+        continue;
+      }
+      const context = parsed.data;
+      const observationBytes = await load(
+        context.observationRef,
+        `${p}/observationRef`
+      );
+      if (observationBytes === void 0) continue;
+      const observation = parseExperimentalObservation(observationBytes);
+      if (!observation.success || !equal(observationBytes, history.data.observation)) {
+        problem(
+          "CONTEXT.OBSERVATION_SCOPE",
+          p,
+          "Context must select the same complete observation snapshot as the history.",
+          observation.checks.structural === "failed" ? "structural" : "semantic"
+        );
+        continue;
+      }
+      await checkContext(context, observation.data, p);
+      contexts.set(ref5.sha256, context);
+    }
+    for (const [i, claim] of history.data.claims.entries()) {
+      if (claim.subject.kind === "context")
+        resolve2(claim.subject.reference, `/claims/${i}/subject`);
+      if (claim.kind === "assessment")
+        for (const [j, ref5] of (claim.contextInputRefs ?? []).entries())
+          resolve2(ref5, `/claims/${i}/contextInputRefs/${j}`, ref5.assertionId);
+    }
+  }
+  const external = snapshots.some((s) => s.status === "failed") ? "failed" : snapshots.some((s) => s.status === "unavailable") || !snapshots.length ? "not_checked" : "passed";
+  return {
+    success: history.success && issues.length === 0,
+    issues,
+    snapshots,
+    checks: {
+      structural: issues.some((i) => i.stage === "structural") ? "failed" : history.checks.structural,
+      semantic: history.checks.structural === "failed" || issues.some((i) => i.stage === "structural") ? "not_checked" : issues.some((i) => i.stage !== "external") ? "failed" : issues.length ? "not_checked" : "passed",
+      profile: "not_checked",
+      external
+    },
+    currentClaimRefs: history.success && issues.length === 0 ? history.currentClaimRefs : [],
+    integrityScope: "supplied_context_observation_and_acquisition_snapshot_bytes",
+    temporalNormalization: "not_checked",
+    sourceArtifactIntegrity: "not_checked",
+    scientificInterpretation: "not_checked",
+    multiSensorFusion: "not_checked"
+  };
+}
+function equal2(a, b) {
+  if (a === b) return true;
+  if (!a || !b || typeof a !== "object" || typeof b !== "object") return false;
+  if (Array.isArray(a) || Array.isArray(b))
+    return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((v, i) => equal2(v, b[i]));
+  const x = a, y = b;
+  return Object.keys(x).length === Object.keys(y).length && Object.keys(x).every(
+    (k) => Object.prototype.hasOwnProperty.call(y, k) && equal2(x[k], y[k])
+  );
+}
+async function evaluateResearchClaimHistory(input, options) {
+  const history = parseResearchClaimHistory(input);
+  const issues = history.issues.map((i) => ({
+    code: i.code,
+    stage: i.stage,
+    pointer: i.pointer,
+    message: i.message
+  }));
+  const snapshots = [];
+  const contexts = /* @__PURE__ */ new Map();
+  const entityDocuments = /* @__PURE__ */ new Map();
+  const problem = (code, pointer6, message, stage = "semantic") => issues.push({ code, pointer: pointer6, message, stage });
+  async function load(ref5, pointer6) {
+    const supplied = options.documents.get(ref5.sha256);
+    const bytes = supplied ? Uint8Array.from(supplied) : void 0;
+    if (!bytes) {
+      snapshots.push({ ...ref5, status: "unavailable" });
+      problem(
+        "SNAPSHOT.UNAVAILABLE",
+        pointer6,
+        "Required snapshot bytes were not supplied.",
+        "external"
+      );
+      return;
+    }
+    if ([
+      ...new Uint8Array(
+        await globalThis.crypto.subtle.digest("SHA-256", bytes)
+      )
+    ].map((b) => b.toString(16).padStart(2, "0")).join("") !== ref5.sha256) {
+      snapshots.push({ ...ref5, status: "failed" });
+      problem(
+        "SNAPSHOT.DIGEST",
+        pointer6,
+        "Supplied bytes do not match the reference digest.",
+        "external"
+      );
+      return;
+    }
+    let value;
+    try {
+      value = JSON.parse(
+        new TextDecoder("utf-8", { fatal: true }).decode(bytes)
+      );
+    } catch {
+      snapshots.push({ ...ref5, status: "failed" });
+      problem(
+        "SNAPSHOT.JSON",
+        pointer6,
+        "Snapshot is not a UTF-8 JSON document.",
+        "external"
+      );
+      return;
+    }
+    snapshots.push({ ...ref5, status: "passed" });
+    if (!value || typeof value !== "object" || value.id !== ref5.documentId) {
+      problem(
+        "SNAPSHOT.IDENTITY",
+        pointer6,
+        "Snapshot document ID does not match its reference."
+      );
+      return;
+    }
+    return value;
+  }
+  async function checkContext(context, observation, p) {
+    const sources = new Map([
+      ...observation.sources.map((s) => [`source:${s.id}`, s]),
+      ...observation.products.map((s) => [`product:${s.id}`, s])
+    ]);
+    const methods = new Map(
+      observation.methods.map((m) => [`method:${m.id}`, m])
+    );
+    const measurements = new Map(
+      observation.measurements.map((m) => [m.id, m])
+    );
+    let acquisitionIds;
+    if (context.acquisitionRef) {
+      const value = await load(context.acquisitionRef, `${p}/acquisitionRef`);
+      if (value !== void 0) {
+        const acquisition = parseAcquisitionContext(value);
+        if (!acquisition.success)
+          problem(
+            "CONTEXT.ACQUISITION",
+            `${p}/acquisitionRef`,
+            "Acquisition snapshot does not satisfy its declared contract.",
+            acquisition.checks.structural === "failed" ? "structural" : "semantic"
+          );
+        else
+          acquisitionIds = new Set(
+            acquisition.data.acquisitions.map((a) => a.id)
+          );
+      }
+    }
+    for (const [index, entity] of context.entities.entries()) {
+      const ep = `${p}/entities/${index}`;
+      for (const { field, assertion } of contextAssertions(entity)) {
+        const prov = assertion.content.provenance;
+        if (prov) {
+          const source = sources.get(prov.sourceRef);
+          if (!source)
+            problem(
+              "REF.LOCAL_RESOLUTION",
+              ep,
+              "Context source is absent from the scoped observation."
+            );
+          else if (source.digest && prov.sourceDigest && source.digest.value !== prov.sourceDigest.value)
+            problem(
+              "SOURCE.DIGEST_MISMATCH",
+              ep,
+              "Source digest declarations differ."
+            );
+        }
+        const value = assertion.content.value;
+        if (value === void 0) continue;
+        if (field === "productRefs") {
+          for (const ref5 of value)
+            if (!sources.has(ref5))
+              problem(
+                "REF.LOCAL_RESOLUTION",
+                ep,
+                "Collection artifact is not declared."
+              );
+        }
+        if (field === "acquisitionIds") {
+          for (const id12 of value)
+            if (!acquisitionIds?.has(id12))
+              problem(
+                "REF.ACQUISITION",
+                ep,
+                "Acquisition ID needs a supplied, valid acquisition snapshot."
+              );
+        }
+        if (field === "position") {
+          const checked = parseExperimentalObservation({
+            ...observation,
+            position: { state: "known", value, sourceRefs: [prov.sourceRef] }
+          });
+          if (!checked.success)
+            problem(
+              "CONTEXT.POSITION",
+              ep,
+              "Context position must satisfy the observation frame, unit and source-reference rules."
+            );
+        }
+      }
+      for (const selection of entity.selections ?? []) {
+        if (methods.get(selection.methodRef)?.version !== selection.methodVersion)
+          problem(
+            "METHOD.VERSION_MISMATCH",
+            ep,
+            "Selection method/version must match the observation inventory."
+          );
+      }
+      const proximityLinks = contextAssertions(entity).flatMap(
+        ({ field, assertion }) => {
+          if (field !== "proximity" || !assertion.content.value) return [];
+          const value = assertion.content.value;
+          return [
+            ...value.distanceMeasurementId ? [
+              {
+                id: assertion.id,
+                role: "distance",
+                measurementId: value.distanceMeasurementId,
+                relatedPlaceId: value.targetPlaceId
+              }
+            ] : [],
+            ...value.bearingMeasurementId ? [
+              {
+                id: assertion.id,
+                role: "bearing",
+                measurementId: value.bearingMeasurementId,
+                relatedPlaceId: value.targetPlaceId
+              }
+            ] : []
+          ];
+        }
+      );
+      for (const link of [...entity.measurements ?? [], ...proximityLinks]) {
+        const role = CONTEXT_MEASUREMENT_ROLES[link.role];
+        const measurement = measurements.get(link.measurementId);
+        if (!measurement) {
+          problem(
+            "REF.MEASUREMENT",
+            ep,
+            "Measurement is absent from the scoped observation."
+          );
+          continue;
+        }
+        if (!role.entities.includes(entity.kind) || !role.quantities.includes(
+          measurement.quantity
+        ) || !role.units.includes(measurement.value.unit))
+          problem(
+            "CONTEXT.MEASUREMENT_ROLE",
+            ep,
+            "Measurement entity, quantity and unit must match the declared role."
+          );
+        const value = measurement.value.value;
+        if ([
+          "count",
+          "size",
+          "speed",
+          "wind_speed",
+          "duration",
+          "distance",
+          "water_depth",
+          "coordinate_precision",
+          "time_alignment"
+        ].includes(link.role) && value < 0)
+          problem(
+            "CONTEXT.MEASUREMENT_RANGE",
+            ep,
+            "This role cannot be negative."
+          );
+        if (link.role === "count" && !Number.isInteger(value))
+          problem("CONTEXT.MEASUREMENT_RANGE", ep, "Count must be an integer.");
+        if (["heading", "bearing"].includes(link.role) && (value < 0 || value > 360))
+          problem(
+            "CONTEXT.MEASUREMENT_RANGE",
+            ep,
+            "Direction must lie between zero and 360 degrees."
+          );
+        if (["relative_humidity", "moon_illumination"].includes(link.role) && (value < 0 || value > (measurement.value.unit === "1" ? 1 : 100)))
+          problem(
+            "CONTEXT.MEASUREMENT_RANGE",
+            ep,
+            "Fraction lies outside its unit range."
+          );
+        if (["distance", "bearing"].includes(link.role) && !link.relatedPlaceId)
+          problem(
+            "CONTEXT.RELATED_PLACE",
+            ep,
+            "Distance and bearing must identify the other place."
+          );
+      }
+    }
+  }
+  if (history.success) {
+    let resolveEntity2 = function(reference, pointer6, assertionId) {
+      const document = entityDocuments.get(reference.document.sha256);
+      if (!document) return;
+      const entity = document.entities.find(
+        (e) => e.kind === reference.target.kind && e.id === reference.target.id
+      );
+      if (!entity) {
+        problem(
+          "REF.ENTITY",
+          pointer6,
+          "Typed entity is absent from the selected snapshot."
+        );
+        return;
+      }
+      const assertions = researchEntityAssertions(entity);
+      if (reference.target.field && !assertions.some((a) => a.field === reference.target.field))
+        problem(
+          "REF.FIELD",
+          pointer6,
+          "Target field has no supplied assertions."
+        );
+      if (assertionId && (!reference.target.field || !assertions.some(
+        (a) => a.field === reference.target.field && a.assertion.id === assertionId
+      )))
+        problem(
+          "REF.ASSERTION",
+          pointer6,
+          "Input must select an existing assertion on its named field."
+        );
+    }, resolve2 = function(reference, pointer6, assertionId) {
+      const context = contexts.get(reference.document.sha256);
+      if (!context) return;
+      const entity = context.entities.find(
+        (e) => e.kind === reference.target.kind && e.id === reference.target.id
+      );
+      if (!entity) {
+        problem(
+          "REF.ENTITY",
+          pointer6,
+          "Typed entity is absent from the selected snapshot."
+        );
+        return;
+      }
+      const assertions = contextAssertions(entity);
+      if (reference.target.field && !assertions.some((a) => a.field === reference.target.field))
+        problem(
+          "REF.FIELD",
+          pointer6,
+          "Target field has no supplied assertions."
+        );
+      if (assertionId && (!reference.target.field || !assertions.some(
+        (a) => a.field === reference.target.field && a.assertion.id === assertionId
+      )))
+        problem(
+          "REF.ASSERTION",
+          pointer6,
+          "Assessment input must select an existing assertion on its named field."
+        );
+    };
+    for (const [i, ref5] of history.data.contextRefs.entries()) {
+      const p = `/contextRefs/${i}`;
+      const value = await load(ref5, p);
+      if (value === void 0) continue;
+      const parsed = parseObservationContext(value);
+      if (!parsed.success) {
+        issues.push(
+          ...parsed.issues.map((i2) => ({ ...i2, pointer: p + i2.pointer }))
+        );
+        continue;
+      }
+      const context = parsed.data;
+      const observationBytes = await load(
+        context.observationRef,
+        `${p}/observationRef`
+      );
+      if (observationBytes === void 0) continue;
+      const observation = parseExperimentalObservation(observationBytes);
+      if (!observation.success || !equal2(observationBytes, history.data.observation)) {
+        problem(
+          "CONTEXT.OBSERVATION_SCOPE",
+          p,
+          "Context must select the same complete observation snapshot as the history.",
+          observation.checks.structural === "failed" ? "structural" : "semantic"
+        );
+        continue;
+      }
+      await checkContext(context, observation.data, p);
+      contexts.set(ref5.sha256, context);
+    }
+    for (const [i, ref5] of history.data.entityRefs.entries()) {
+      const p = `/entityRefs/${i}`;
+      const value = await load(ref5, p);
+      if (value === void 0) continue;
+      const parsed = parseResearchEntities(value);
+      if (!parsed.success) {
+        issues.push(
+          ...parsed.issues.map((i2) => ({ ...i2, pointer: p + i2.pointer }))
+        );
+        continue;
+      }
+      const entities = parsed.data;
+      const raw = await load(entities.observationRef, `${p}/observationRef`);
+      if (raw === void 0) continue;
+      const observation = parseExperimentalObservation(raw);
+      if (!observation.success || !equal2(raw, history.data.observation)) {
+        problem(
+          "ENTITIES.OBSERVATION_SCOPE",
+          p,
+          "Research entities must select the same complete observation snapshot as the history."
+        );
+        continue;
+      }
+      const contextSnapshots = new Set(
+        history.data.contextRefs.map((r) => JSON.stringify(r))
+      );
+      for (const r of entities.contextRefs)
+        if (!contextSnapshots.has(JSON.stringify(r)))
+          problem(
+            "REF.LOCAL_RESOLUTION",
+            p,
+            "Entity context dependency must be declared in the history and checked."
+          );
+      const sources = new Map([
+        ...observation.data.sources.map((x) => [`source:${x.id}`, x]),
+        ...observation.data.products.map(
+          (x) => [`product:${x.id}`, x]
+        )
+      ]);
+      for (const [j, entity] of entities.entities.entries()) {
+        const ep = `${p}/entities/${j}`;
+        for (const { field, assertion } of researchEntityAssertions(entity)) {
+          const prov = assertion.content.provenance;
+          if (prov) {
+            const source = sources.get(prov.sourceRef);
+            if (!source)
+              problem(
+                "REF.LOCAL_RESOLUTION",
+                ep,
+                "Entity source is absent from the scoped observation."
+              );
+            else if (source.digest && prov.sourceDigest && source.digest.value !== prov.sourceDigest.value)
+              problem(
+                "SOURCE.DIGEST_MISMATCH",
+                ep,
+                "Source digest declarations differ."
+              );
+          }
+          const value2 = assertion.content.value;
+          const refs = field === "sourceDocument" && typeof value2 === "string" ? [value2] : field === "supportRefs" && Array.isArray(value2) ? value2 : [];
+          for (const r of refs)
+            if (!sources.has(r))
+              problem(
+                "REF.LOCAL_RESOLUTION",
+                ep,
+                "Account or procedure artifact is not declared in the observation."
+              );
+        }
+        for (const reference of researchEntityContextReferences(entity))
+          resolve2(reference, ep);
+      }
+      entityDocuments.set(ref5.sha256, entities);
+    }
+    for (const [i, claim] of history.data.claims.entries()) {
+      if (claim.subject.kind === "entity")
+        resolveEntity2(claim.subject.reference, `/claims/${i}/subject`);
+      if (claim.kind === "assessment")
+        for (const [j, ref5] of (claim.entityInputRefs ?? []).entries())
+          resolveEntity2(
+            ref5,
+            `/claims/${i}/entityInputRefs/${j}`,
+            ref5.assertionId
+          );
+      if (claim.subject.kind === "context")
+        resolve2(claim.subject.reference, `/claims/${i}/subject`);
+      if (claim.kind === "assessment")
+        for (const [j, ref5] of (claim.contextInputRefs ?? []).entries())
+          resolve2(ref5, `/claims/${i}/contextInputRefs/${j}`, ref5.assertionId);
+    }
+  }
+  const external = snapshots.some((s) => s.status === "failed") ? "failed" : snapshots.some((s) => s.status === "unavailable") || !snapshots.length ? "not_checked" : "passed";
+  return {
+    success: history.success && issues.length === 0,
+    issues,
+    snapshots,
+    checks: {
+      structural: issues.some((i) => i.stage === "structural") ? "failed" : history.checks.structural,
+      semantic: history.checks.structural === "failed" || issues.some((i) => i.stage === "structural") ? "not_checked" : issues.some((i) => i.stage !== "external") ? "failed" : issues.length ? "not_checked" : "passed",
+      profile: "not_checked",
+      external
+    },
+    currentClaimRefs: history.success && issues.length === 0 ? history.currentClaimRefs : [],
+    integrityScope: "supplied_entities_context_observation_and_acquisition_snapshot_bytes",
+    temporalNormalization: "not_checked",
+    sourceArtifactIntegrity: "not_checked",
+    scientificInterpretation: "not_checked",
+    multiSensorFusion: "not_checked"
+  };
+}
 
-export { ACQUISITION_BINDINGS_PROFILE, ACQUISITION_BINDINGS_SCHEMA_ID, ASSESSMENT_DOCUMENTATION_PROFILE, AcquisitionBindingsSchema, DATASET_RELEASE_PROFILE, DATASET_RELEASE_SCHEMA_ID, DOCUMENTATION_COMPLETION_POLICY, DOCUMENTATION_REQUIREMENTS, DatasetReleaseSchema, HISTORICAL_TESTIMONY_PROFILE, HISTORICAL_TESTIMONY_REQUIREMENTS, HISTORICAL_TESTIMONY_SELECTION_SCHEMA_ID, HistoricalTestimonySelectionSchema, INSTRUMENT_RESEARCH_COMPLETION_POLICY, INSTRUMENT_RESEARCH_PREREQUISITES_PROFILE, INSTRUMENT_RESEARCH_REQUIREMENTS, INSTRUMENT_RESEARCH_REVIEW_SCHEMA_ID, InstrumentResearchReviewSchema, MEASUREMENT_BINDINGS_PROFILE, MEASUREMENT_BINDINGS_SCHEMA_ID, MIGRATION_COMPATIBILITY_SCHEMA_ID, MIGRATION_LEGACY_SCORES_SCHEMA_ID, MIGRATION_RESOLUTION_SCHEMA_ID, MIGRATION_REVIEW_SCHEMA_ID, MeasurementBindingsSchema, MigrationCompatibilitySchema, MigrationLegacyScoresSchema, MigrationResolutionSchema, MigrationReviewSchema, PHYSICAL_SAMPLE_PROFILE, PHYSICAL_SAMPLE_REQUIREMENTS, PHYSICAL_SAMPLE_SELECTION_SCHEMA_ID, PROFILE_EVALUATION_POLICY, PROFILE_EVALUATION_SCHEMA_ID, PROFILE_PREPARATION_SCHEMA_ID, PhysicalSampleSelectionSchema, ProfileEvaluationSchema, ProfilePreparationSchema, RELEASED_DOCUMENT_PROFILE, RELEASED_DOCUMENT_REQUIREMENTS, RELEASED_DOCUMENT_SELECTION_SCHEMA_ID, REPRODUCTION_PACKET_PROFILE, REPRODUCTION_PACKET_SCHEMA_ID, RESEARCH_EVALUATION_POLICY, RESEARCH_EVALUATION_SCHEMA_ID, ReleasedDocumentSelectionSchema, ReproductionPacketSchema, ResearchEvaluationSchema, SOURCE_INTAKE_PROFILE, SOURCE_INTAKE_SCHEMA_ID, SourceIntakeSchema, acquisitionBindingsJsonSchema, datasetReleaseJsonSchema, evaluateAcquisitionBindings, evaluateAssessmentDocumentation, evaluateDatasetRelease, evaluateDocumentationCompletion, evaluateHistoricalTestimony, evaluateInstrumentResearchCompletion, evaluateInstrumentResearchPrerequisites, evaluateMeasurementBindings, evaluatePhysicalSamples, evaluateProfileEvaluation, evaluateReleasedDocuments, evaluateReproductionPacket, evaluateResearchEvaluation, evaluateSourceIntake, historicalTestimonySelectionJsonSchema, instrumentResearchReviewJsonSchema, measurementBindingsJsonSchema, migrationCompatibilityJsonSchema, migrationLegacyScoresJsonSchema, migrationResolutionJsonSchema, migrationReviewJsonSchema, physicalSampleSelectionJsonSchema, profileEvaluationJsonSchema, profilePreparationJsonSchema, releasedDocumentSelectionJsonSchema, reproductionPacketJsonSchema, researchEvaluationJsonSchema, sourceIntakeJsonSchema };
+export { ACQUISITION_BINDINGS_PROFILE, ACQUISITION_BINDINGS_SCHEMA_ID, ASSESSMENT_DOCUMENTATION_PROFILE, AcquisitionBindingsSchema, CONTEXT_MEASUREMENT_ROLES, DATASET_RELEASE_PROFILE, DATASET_RELEASE_SCHEMA_ID, DOCUMENTATION_COMPLETION_POLICY, DOCUMENTATION_REQUIREMENTS, DatasetReleaseSchema, HISTORICAL_TESTIMONY_PROFILE, HISTORICAL_TESTIMONY_REQUIREMENTS, HISTORICAL_TESTIMONY_SELECTION_SCHEMA_ID, HistoricalTestimonySelectionSchema, INSTRUMENT_RESEARCH_COMPLETION_POLICY, INSTRUMENT_RESEARCH_PREREQUISITES_PROFILE, INSTRUMENT_RESEARCH_REQUIREMENTS, INSTRUMENT_RESEARCH_REVIEW_SCHEMA_ID, InstrumentResearchReviewSchema, MEASUREMENT_BINDINGS_PROFILE, MEASUREMENT_BINDINGS_SCHEMA_ID, MIGRATION_COMPATIBILITY_SCHEMA_ID, MIGRATION_LEGACY_SCORES_SCHEMA_ID, MIGRATION_RESOLUTION_SCHEMA_ID, MIGRATION_REVIEW_SCHEMA_ID, MeasurementBindingsSchema, MigrationCompatibilitySchema, MigrationLegacyScoresSchema, MigrationResolutionSchema, MigrationReviewSchema, PHYSICAL_SAMPLE_PROFILE, PHYSICAL_SAMPLE_REQUIREMENTS, PHYSICAL_SAMPLE_SELECTION_SCHEMA_ID, PROFILE_EVALUATION_POLICY, PROFILE_EVALUATION_SCHEMA_ID, PROFILE_PREPARATION_SCHEMA_ID, PhysicalSampleSelectionSchema, ProfileEvaluationSchema, ProfilePreparationSchema, RELEASED_DOCUMENT_PROFILE, RELEASED_DOCUMENT_REQUIREMENTS, RELEASED_DOCUMENT_SELECTION_SCHEMA_ID, REPRODUCTION_PACKET_PROFILE, REPRODUCTION_PACKET_SCHEMA_ID, RESEARCH_EVALUATION_POLICY, RESEARCH_EVALUATION_SCHEMA_ID, ReleasedDocumentSelectionSchema, ReproductionPacketSchema, ResearchEvaluationSchema, SOURCE_INTAKE_PROFILE, SOURCE_INTAKE_SCHEMA_ID, SourceIntakeSchema, acquisitionBindingsJsonSchema, datasetReleaseJsonSchema, evaluateAcquisitionBindings, evaluateAssessmentDocumentation, evaluateContextClaimHistory, evaluateDatasetRelease, evaluateDocumentationCompletion, evaluateHistoricalTestimony, evaluateInstrumentResearchCompletion, evaluateInstrumentResearchPrerequisites, evaluateMeasurementBindings, evaluatePhysicalSamples, evaluateProfileEvaluation, evaluateReleasedDocuments, evaluateReproductionPacket, evaluateResearchClaimHistory, evaluateResearchEvaluation, evaluateSourceIntake, historicalTestimonySelectionJsonSchema, instrumentResearchReviewJsonSchema, measurementBindingsJsonSchema, migrationCompatibilityJsonSchema, migrationLegacyScoresJsonSchema, migrationResolutionJsonSchema, migrationReviewJsonSchema, physicalSampleSelectionJsonSchema, profileEvaluationJsonSchema, profilePreparationJsonSchema, releasedDocumentSelectionJsonSchema, reproductionPacketJsonSchema, researchEvaluationJsonSchema, sourceIntakeJsonSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map