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

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2.0.0-beta.1
+
+### Minor Changes
+
+- 9e7c76a: Add experimental observation-context 0.1.0 and an explicit claim-history 0.2.0 parser for typed context entity/field subjects and assertion inputs. Resolve caller-supplied exact document snapshots, preserve descriptive vocabularies and missingness, and link contextual quantities to existing measurements. Existing schema identities and claim-history 0.1.0 remain unchanged. No source authentication, time normalization or sensor-fusion validation is implied.
+
+### Patch Changes
+
+- Updated dependencies [9e7c76a]
+  - @disclosureos/records@2.0.0-beta.1
+  - @disclosureos/instruments@2.0.0-beta.1
+  - @disclosureos/observables@2.0.0-beta.1
+  - @disclosureos/origins@2.0.0-beta.1
+
 ## 2.0.0-beta.0
 
 ### Major Changes

package/dist/experimental/v2/index.d.ts

@@ -1,4 +1,4 @@
-import { ClaimHistoryIssueCode, parseExperimentalClaimHistory, ClaimSubject } from '@disclosureos/records/experimental/v2';
+import { ClaimHistoryIssueCode, parseExperimentalClaimHistory, ClaimSubject, ContextIssue, DocumentSnapshotRef } from '@disclosureos/records/experimental/v2';
 import { z } from 'zod';
 import { parseAcquisitionContext, AcquisitionContextIssueCode } from '@disclosureos/instruments/experimental/v2';
 
@@ -1599,4 +1599,107 @@ declare const MigrationCompatibilitySchema: z.ZodObject<{
 type MigrationCompatibility = z.infer<typeof MigrationCompatibilitySchema>;
 declare function migrationCompatibilityJsonSchema(): Record<string, unknown>;
 
-export { ACQUISITION_BINDINGS_PROFILE, ACQUISITION_BINDINGS_SCHEMA_ID, ASSESSMENT_DOCUMENTATION_PROFILE, type AcquisitionBindingOptions, type AcquisitionBindingResult, type AcquisitionBindings, AcquisitionBindingsSchema, type AssessmentDocumentation, type AssessmentDocumentationCompletion, type AssetCheck, type BindingAssetCheck, type BindingIssue, type BindingIssueCode, type CompletionStatus, DATASET_RELEASE_PROFILE, DATASET_RELEASE_SCHEMA_ID, DOCUMENTATION_COMPLETION_POLICY, DOCUMENTATION_REQUIREMENTS, type DatasetIssue, type DatasetPacketInput, type DatasetRelease, type DatasetReleaseResult, DatasetReleaseSchema, type DocumentationAction, type DocumentationCompletionResult, type DocumentationIssue, type DocumentationIssueCode, type DocumentationOptions, type DocumentationRequirement, type DocumentationRequirementId, type DocumentationResult, HISTORICAL_TESTIMONY_PROFILE, HISTORICAL_TESTIMONY_REQUIREMENTS, HISTORICAL_TESTIMONY_SELECTION_SCHEMA_ID, type HistoricalTestimonyCompletionStatus, type HistoricalTestimonyIssue, type HistoricalTestimonyReport, type HistoricalTestimonyRequirement, type HistoricalTestimonyRequirementId, type HistoricalTestimonyResult, type HistoricalTestimonySelection, HistoricalTestimonySelectionSchema, INSTRUMENT_RESEARCH_COMPLETION_POLICY, INSTRUMENT_RESEARCH_PREREQUISITES_PROFILE, INSTRUMENT_RESEARCH_REQUIREMENTS, INSTRUMENT_RESEARCH_REVIEW_SCHEMA_ID, type InstrumentResearchCompletionResult, type InstrumentResearchOptions, type InstrumentResearchResult, type InstrumentResearchReview, 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, type MeasurementBindingIssue, type MeasurementBindingResult, type MeasurementBindings, MeasurementBindingsSchema, type MigrationCompatibility, MigrationCompatibilitySchema, type MigrationLegacyScores, MigrationLegacyScoresSchema, type MigrationResolution, MigrationResolutionSchema, type MigrationReview, MigrationReviewSchema, PHYSICAL_SAMPLE_PROFILE, PHYSICAL_SAMPLE_REQUIREMENTS, PHYSICAL_SAMPLE_SELECTION_SCHEMA_ID, PROFILE_EVALUATION_POLICY, PROFILE_EVALUATION_SCHEMA_ID, PROFILE_PREPARATION_SCHEMA_ID, type PhysicalSampleIssue, type PhysicalSampleRecordCheck, type PhysicalSampleReport, type PhysicalSampleRequirement, type PhysicalSampleRequirementId, type PhysicalSampleResult, type PhysicalSampleSelection, PhysicalSampleSelectionSchema, type ProductBindingCheck, type ProfileEvaluation, type ProfileEvaluationOptions, type ProfileEvaluationReceipt, type ProfileEvaluationResult, ProfileEvaluationSchema, type ProfilePreparation, 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, type ReleasedDocumentCompletionStatus, type ReleasedDocumentIssue, type ReleasedDocumentReport, type ReleasedDocumentRequirement, type ReleasedDocumentRequirementId, type ReleasedDocumentResult, type ReleasedDocumentSelection, ReleasedDocumentSelectionSchema, type ReproductionFileCheck, type ReproductionPacket, type ReproductionPacketResult, ReproductionPacketSchema, type ResearchCompletionAction, type ResearchCompletionRequirement, type ResearchCompletionStatus, type ResearchEvaluation, type ResearchEvaluationOptions, type ResearchEvaluationOutput, type ResearchEvaluationReceipt, type ResearchEvaluationResult, ResearchEvaluationSchema, type ResearchRequirementId, type ResearchReviewAssetCheck, SOURCE_INTAKE_PROFILE, SOURCE_INTAKE_SCHEMA_ID, type SourceIntake, type SourceIntakeResult, 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 };
+interface ContextReviewOptions {
+    /** Exact UTF-8 document bytes keyed by SHA-256. Nothing is fetched or normalized. */
+    documents: ReadonlyMap<string, Uint8Array>;
+}
+interface ContextReviewResult {
+    success: boolean;
+    issues: ContextIssue[];
+    snapshots: Array<DocumentSnapshotRef & {
+        status: "passed" | "failed" | "unavailable";
+    }>;
+    checks: {
+        structural: 'passed' | 'failed';
+        semantic: 'passed' | 'failed' | 'not_checked';
+        profile: 'not_checked';
+        external: 'passed' | 'failed' | 'not_checked';
+    };
+    currentClaimRefs: string[];
+    integrityScope: "supplied_context_observation_and_acquisition_snapshot_bytes";
+    temporalNormalization: "not_checked";
+    sourceArtifactIntegrity: "not_checked";
+    scientificInterpretation: "not_checked";
+    multiSensorFusion: "not_checked";
+}
+/** Closed C1 role table: no unit guessing, conversion or unrestricted quantity synonyms. */
+declare const CONTEXT_MEASUREMENT_ROLES: {
+    readonly size: {
+        readonly entities: readonly ["reported_object"];
+        readonly quantities: readonly ["size", "length"];
+        readonly units: readonly ["m", "km"];
+    };
+    readonly count: {
+        readonly entities: readonly ["reported_object"];
+        readonly quantities: readonly ["count"];
+        readonly units: readonly ["1"];
+    };
+    readonly speed: {
+        readonly entities: readonly ["reported_object", "platform"];
+        readonly quantities: readonly ["speed"];
+        readonly units: readonly ["m/s", "km/h"];
+    };
+    readonly altitude: {
+        readonly entities: readonly ["reported_object", "platform", "place"];
+        readonly quantities: readonly ["altitude", "elevation"];
+        readonly units: readonly ["m", "km"];
+    };
+    readonly heading: {
+        readonly entities: readonly ["reported_object", "platform"];
+        readonly quantities: readonly ["heading"];
+        readonly units: readonly ["deg"];
+    };
+    readonly ambient_temperature: {
+        readonly entities: readonly ["environment"];
+        readonly quantities: readonly ["temperature", "ambient_temperature"];
+        readonly units: readonly ["Cel", "K"];
+    };
+    readonly relative_humidity: {
+        readonly entities: readonly ["environment"];
+        readonly quantities: readonly ["relative_humidity"];
+        readonly units: readonly ["%"];
+    };
+    readonly wind_speed: {
+        readonly entities: readonly ["environment"];
+        readonly quantities: readonly ["wind_speed"];
+        readonly units: readonly ["m/s", "km/h"];
+    };
+    readonly moon_illumination: {
+        readonly entities: readonly ["environment"];
+        readonly quantities: readonly ["moon_illumination"];
+        readonly units: readonly ["%", "1"];
+    };
+    readonly duration: {
+        readonly entities: readonly ["temporal", "collection"];
+        readonly quantities: readonly ["duration"];
+        readonly units: readonly ["s", "min", "h"];
+    };
+    readonly distance: {
+        readonly entities: readonly ["place"];
+        readonly quantities: readonly ["distance"];
+        readonly units: readonly ["m", "km"];
+    };
+    readonly bearing: {
+        readonly entities: readonly ["place"];
+        readonly quantities: readonly ["bearing"];
+        readonly units: readonly ["deg"];
+    };
+    readonly water_depth: {
+        readonly entities: readonly ["place"];
+        readonly quantities: readonly ["water_depth"];
+        readonly units: readonly ["m"];
+    };
+    readonly coordinate_precision: {
+        readonly entities: readonly ["place"];
+        readonly quantities: readonly ["coordinate_precision"];
+        readonly units: readonly ["m"];
+    };
+    readonly time_alignment: {
+        readonly entities: readonly ["collection"];
+        readonly quantities: readonly ["time_alignment_uncertainty"];
+        readonly units: readonly ["s", "ms"];
+    };
+};
+declare function evaluateContextClaimHistory(input: unknown, options: ContextReviewOptions): Promise<ContextReviewResult>;
+
+export { ACQUISITION_BINDINGS_PROFILE, ACQUISITION_BINDINGS_SCHEMA_ID, ASSESSMENT_DOCUMENTATION_PROFILE, type AcquisitionBindingOptions, type AcquisitionBindingResult, type AcquisitionBindings, AcquisitionBindingsSchema, type AssessmentDocumentation, type AssessmentDocumentationCompletion, type AssetCheck, type BindingAssetCheck, type BindingIssue, type BindingIssueCode, CONTEXT_MEASUREMENT_ROLES, type CompletionStatus, type ContextReviewOptions, type ContextReviewResult, DATASET_RELEASE_PROFILE, DATASET_RELEASE_SCHEMA_ID, DOCUMENTATION_COMPLETION_POLICY, DOCUMENTATION_REQUIREMENTS, type DatasetIssue, type DatasetPacketInput, type DatasetRelease, type DatasetReleaseResult, DatasetReleaseSchema, type DocumentationAction, type DocumentationCompletionResult, type DocumentationIssue, type DocumentationIssueCode, type DocumentationOptions, type DocumentationRequirement, type DocumentationRequirementId, type DocumentationResult, HISTORICAL_TESTIMONY_PROFILE, HISTORICAL_TESTIMONY_REQUIREMENTS, HISTORICAL_TESTIMONY_SELECTION_SCHEMA_ID, type HistoricalTestimonyCompletionStatus, type HistoricalTestimonyIssue, type HistoricalTestimonyReport, type HistoricalTestimonyRequirement, type HistoricalTestimonyRequirementId, type HistoricalTestimonyResult, type HistoricalTestimonySelection, HistoricalTestimonySelectionSchema, INSTRUMENT_RESEARCH_COMPLETION_POLICY, INSTRUMENT_RESEARCH_PREREQUISITES_PROFILE, INSTRUMENT_RESEARCH_REQUIREMENTS, INSTRUMENT_RESEARCH_REVIEW_SCHEMA_ID, type InstrumentResearchCompletionResult, type InstrumentResearchOptions, type InstrumentResearchResult, type InstrumentResearchReview, 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, type MeasurementBindingIssue, type MeasurementBindingResult, type MeasurementBindings, MeasurementBindingsSchema, type MigrationCompatibility, MigrationCompatibilitySchema, type MigrationLegacyScores, MigrationLegacyScoresSchema, type MigrationResolution, MigrationResolutionSchema, type MigrationReview, MigrationReviewSchema, PHYSICAL_SAMPLE_PROFILE, PHYSICAL_SAMPLE_REQUIREMENTS, PHYSICAL_SAMPLE_SELECTION_SCHEMA_ID, PROFILE_EVALUATION_POLICY, PROFILE_EVALUATION_SCHEMA_ID, PROFILE_PREPARATION_SCHEMA_ID, type PhysicalSampleIssue, type PhysicalSampleRecordCheck, type PhysicalSampleReport, type PhysicalSampleRequirement, type PhysicalSampleRequirementId, type PhysicalSampleResult, type PhysicalSampleSelection, PhysicalSampleSelectionSchema, type ProductBindingCheck, type ProfileEvaluation, type ProfileEvaluationOptions, type ProfileEvaluationReceipt, type ProfileEvaluationResult, ProfileEvaluationSchema, type ProfilePreparation, 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, type ReleasedDocumentCompletionStatus, type ReleasedDocumentIssue, type ReleasedDocumentReport, type ReleasedDocumentRequirement, type ReleasedDocumentRequirementId, type ReleasedDocumentResult, type ReleasedDocumentSelection, ReleasedDocumentSelectionSchema, type ReproductionFileCheck, type ReproductionPacket, type ReproductionPacketResult, ReproductionPacketSchema, type ResearchCompletionAction, type ResearchCompletionRequirement, type ResearchCompletionStatus, type ResearchEvaluation, type ResearchEvaluationOptions, type ResearchEvaluationOutput, type ResearchEvaluationReceipt, type ResearchEvaluationResult, ResearchEvaluationSchema, type ResearchRequirementId, type ResearchReviewAssetCheck, SOURCE_INTAKE_PROFILE, SOURCE_INTAKE_SCHEMA_ID, type SourceIntake, type SourceIntakeResult, SourceIntakeSchema, acquisitionBindingsJsonSchema, datasetReleaseJsonSchema, evaluateAcquisitionBindings, evaluateAssessmentDocumentation, evaluateContextClaimHistory, 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 };

package/dist/experimental/v2/index.js

@@ -1,4 +1,4 @@
-import { parseExperimentalClaimHistory, compareUtcInstants } from '@disclosureos/records/experimental/v2';
+import { parseExperimentalClaimHistory, compareUtcInstants, parseContextClaimHistory, parseObservationContext, parseExperimentalObservation, contextAssertions } from '@disclosureos/records/experimental/v2';
 import { z } from 'zod';
 import { parseAcquisitionContext } from '@disclosureos/instruments/experimental/v2';
 
@@ -4526,7 +4526,410 @@ 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"
+  };
+}
 
-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, evaluateResearchEvaluation, evaluateSourceIntake, historicalTestimonySelectionJsonSchema, instrumentResearchReviewJsonSchema, measurementBindingsJsonSchema, migrationCompatibilityJsonSchema, migrationLegacyScoresJsonSchema, migrationResolutionJsonSchema, migrationReviewJsonSchema, physicalSampleSelectionJsonSchema, profileEvaluationJsonSchema, profilePreparationJsonSchema, releasedDocumentSelectionJsonSchema, reproductionPacketJsonSchema, researchEvaluationJsonSchema, sourceIntakeJsonSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map