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

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 2.0.0-beta.3
+
+### Minor Changes
+
+- 4f80b20: Add research-entities 0.2.0 and claim-history 0.4.0 with exact document editions, digital artifact custody, scoped identifiers and attributable artifact reviews. Validate supplied snapshot references and edition-specific citations without inferring source authenticity or complete custody. Keep existing contract schemas and explicit entry points unchanged.
+
+### Patch Changes
+
+- Updated dependencies [4f80b20]
+  - @disclosureos/records@2.0.0-beta.3
+  - @disclosureos/instruments@2.0.0-beta.3
+  - @disclosureos/observables@2.0.0-beta.3
+  - @disclosureos/origins@2.0.0-beta.3
+
+## 2.0.0-beta.2
+
+### Minor Changes
+
+- 25d01be: Add versioned public witness/account/procedure declarations and entity-addressed claim history with supplied-snapshot review. Preserve sourced qualifications, historical precision, missingness and attributable credibility vocabulary without calculating credibility scores. Existing contracts and profile dispatch remain unchanged.
+
+### Patch Changes
+
+- Updated dependencies [25d01be]
+  - @disclosureos/records@2.0.0-beta.2
+  - @disclosureos/instruments@2.0.0-beta.2
+  - @disclosureos/observables@2.0.0-beta.2
+  - @disclosureos/origins@2.0.0-beta.2
+
 ## 2.0.0-beta.1
 
 ### Minor Changes

package/README.md

@@ -187,3 +187,26 @@ Start with the [developer compatibility guide](../../docs/experimental/migration
 for breaking changes, parser/version boundaries, supported migration workflows,
 exit handling, profile differences and non-destructive local rollback. This is an
 experimental checkout workflow; merging package changes does not deploy the Index.
+
+
+## Witnesses and accounts: C2a
+
+The source tree adds public witness/account/procedure declarations, entity-addressed
+claim history 0.3.0 and supplied-snapshot review, published in 2.0.0-beta.2.
+See the [contract, worked example and
+verification boundaries](../../docs/c2/README.md). Qualifications and reviewer
+judgments remain separate; no credibility score is calculated.
+
+## Document editions and digital custody: C2b candidate
+
+The source tree adds research-entities 0.2.0 and claim-history 0.4.0 with exact
+edition citations, digital custody actions, scoped identifiers and attributable
+artifact reviews. These additions are not in published 2.0.0-beta.2. Existing
+contract schemas and versioned entry points remain unchanged.
+
+Use `parseArchivalEntities` / `parseArchivalClaimHistory` from records and
+`evaluateArchivalClaimHistory` from schema through their `/experimental/v2`
+entries. A successful supplied-document check does not authenticate source
+artifacts, complete custody or certify a scientific profile.
+See the [contract guide](../../docs/c2/archival.md) and
+[worked example](../../examples/v2/archival-editions-demo/README.md).

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

@@ -1702,4 +1702,35 @@ declare const CONTEXT_MEASUREMENT_ROLES: {
 };
 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 };
+interface ResearchReviewOptions {
+    /** Exact UTF-8 document bytes keyed by SHA-256. Nothing is fetched or normalized. */
+    documents: ReadonlyMap<string, Uint8Array>;
+}
+interface ResearchReviewResult {
+    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_entities_context_observation_and_acquisition_snapshot_bytes";
+    temporalNormalization: "not_checked";
+    sourceArtifactIntegrity: "not_checked";
+    scientificInterpretation: "not_checked";
+    multiSensorFusion: "not_checked";
+}
+
+declare function evaluateResearchClaimHistory(input: unknown, options: ResearchReviewOptions): Promise<ResearchReviewResult>;
+
+type ArchivalReviewOptions = ResearchReviewOptions;
+type ArchivalReviewResult = ResearchReviewResult;
+/** Checks 0.4 histories and exact 0.2 entity snapshots; never fetches source files or authenticates them. */
+declare function evaluateArchivalClaimHistory(input: unknown, options: ArchivalReviewOptions): Promise<ArchivalReviewResult>;
+
+export { ACQUISITION_BINDINGS_PROFILE, ACQUISITION_BINDINGS_SCHEMA_ID, ASSESSMENT_DOCUMENTATION_PROFILE, type AcquisitionBindingOptions, type AcquisitionBindingResult, type AcquisitionBindings, AcquisitionBindingsSchema, type ArchivalReviewOptions, type ArchivalReviewResult, 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, type ResearchReviewOptions, type ResearchReviewResult, SOURCE_INTAKE_PROFILE, SOURCE_INTAKE_SCHEMA_ID, type SourceIntake, type SourceIntakeResult, SourceIntakeSchema, acquisitionBindingsJsonSchema, datasetReleaseJsonSchema, evaluateAcquisitionBindings, evaluateArchivalClaimHistory, 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 };

package/dist/experimental/v2/index.js

@@ -1,4 +1,4 @@
-import { parseExperimentalClaimHistory, compareUtcInstants, parseContextClaimHistory, parseObservationContext, parseExperimentalObservation, contextAssertions } from '@disclosureos/records/experimental/v2';
+import { parseExperimentalClaimHistory, compareUtcInstants, parseContextClaimHistory, parseObservationContext, parseExperimentalObservation, contextAssertions, parseArchivalClaimHistory, parseResearchClaimHistory, parseArchivalEntities, parseResearchEntities, researchEntityAssertions, archivalArtifactReferences, researchEntityContextReferences } from '@disclosureos/records/experimental/v2';
 import { z } from 'zod';
 import { parseAcquisitionContext } from '@disclosureos/instruments/experimental/v2';
 
@@ -4929,7 +4929,523 @@ async function evaluateContextClaimHistory(input, options) {
     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 evaluateEntityHistory(input, options, archival) {
+  const history = archival ? parseArchivalClaimHistory(input) : 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."
+        );
+    }, resolveCitation2 = function(citation, pointer6) {
+      const document = entityDocuments.get(citation.document.sha256);
+      if (!document) return;
+      const edition = document.entities.find(
+        (e) => e.kind === "source_edition" && e.id === citation.editionId
+      );
+      if (!edition || edition.kind !== "source_edition") {
+        problem(
+          "REF.ENTITY",
+          pointer6,
+          "Citation edition is absent from the selected entity snapshot."
+        );
+        return;
+      }
+      if (edition.artifact.sourceRef !== citation.artifact.sourceRef || edition.artifact.digest.value !== citation.artifact.digest.value)
+        problem(
+          "ARCHIVE.CITATION_SCOPE",
+          pointer6,
+          "Citation artifact differs from the selected edition, even if titles or page numbers match."
+        );
+      const pages = edition.fields.pageCount;
+      if (citation.locator.kind === "page" && pages?.length === 1 && pages[0].content.state === "known" && citation.locator.page > pages[0].content.value)
+        problem(
+          "ARCHIVE.PAGE_BOUNDS",
+          pointer6,
+          "Citation exceeds the edition's explicitly declared page count."
+        );
+    };
+    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 = archival ? parseArchivalEntities(value) : 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."
+              );
+        }
+        if (archival) {
+          for (const ref6 of archivalArtifactReferences(entity)) {
+            const source = sources.get(ref6.sourceRef);
+            if (!source?.digest || source.digest.value !== ref6.digest.value)
+              problem(
+                "ARCHIVE.ARTIFACT_IDENTITY",
+                ep,
+                "Archival artifact must name the same SHA-256 declaration as the scoped observation inventory."
+              );
+          }
+          if (entity.kind === "digital_artifact") {
+            for (const assertion of entity.fields.declaredHashes ?? [])
+              if ("value" in assertion.content) {
+                for (const declaration2 of assertion.content.value)
+                  if (declaration2.hash.algorithm === "sha256" && declaration2.appliesTo.kind === "artifact" && declaration2.hash.value.toLowerCase() !== declaration2.appliesTo.reference.digest.value)
+                    problem(
+                      "ARCHIVE.HASH_DECLARATION",
+                      ep,
+                      "Declared SHA-256 differs from the selected artifact identity. No original-file or legacy hash verification is implied."
+                    );
+              }
+          }
+        }
+        for (const reference of researchEntityContextReferences(entity))
+          resolve2(reference, ep);
+      }
+      entityDocuments.set(ref5.sha256, entities);
+    }
+    for (const [i, claim] of history.data.claims.entries()) {
+      if (archival) {
+        if ("editionCitation" in claim && claim.editionCitation)
+          resolveCitation2(
+            claim.editionCitation,
+            `/claims/${i}/editionCitation`
+          );
+        if ("editionInputRefs" in claim)
+          for (const [j, citation] of (claim.editionInputRefs ?? []).entries())
+            resolveCitation2(citation, `/claims/${i}/editionInputRefs/${j}`);
+      }
+      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"
+  };
+}
+
+// src/experimental/v2/research-entities-review.ts
+async function evaluateResearchClaimHistory(input, options) {
+  return evaluateEntityHistory(input, options, false);
+}
+
+// src/experimental/v2/archival-review.ts
+async function evaluateArchivalClaimHistory(input, options) {
+  return evaluateEntityHistory(input, options, true);
+}
 
-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 };
+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, evaluateArchivalClaimHistory, 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