feat: add explicit retrospective v2 computation contracts (#20)

2026-09-09 01:31:46 +08:00
parent 68dd68392a
commit 861c1e97a8
19 changed files with 7688 additions and 4 deletions
@@ -0,0 +1,120 @@
+{
+  "contract_name": "researchhub.dataset-snapshot",
+  "schema_version": "2.0.0",
+  "evidence_scope": "synthetic_fixture",
+  "descriptor": {
+    "dataset": {
+      "dataset_id": "rhdataset:market:44444444444444444444444444444444",
+      "dataset_kind": "market",
+      "record_schema_version": "2.0.0",
+      "dimensions": [
+        "instrument_id",
+        "effective_time"
+      ]
+    },
+    "published_at": "2026-09-08T01:03:00Z",
+    "time_semantics": {
+      "effective_time": {
+        "start_inclusive": "2018-01-02T07:00:00Z",
+        "end_inclusive": "2018-01-02T07:00:00Z"
+      },
+      "observation_cutoff": "2026-09-08T01:01:00Z",
+      "earliest_external_knowledge": {
+        "status": "unknown"
+      },
+      "historical_availability": "not_established"
+    },
+    "content": {
+      "digest_algorithm": "sha256",
+      "canonicalization": "RFC8785",
+      "record_order": "canonical-record-byte-order",
+      "content_digest": "sha256:b1c0e47b94ffd57e1d34394138d966803c049afc75e1dc0a1a80fea82de5c54a",
+      "logical_manifest": {
+        "record_count": 2,
+        "chunks": [
+          {
+            "chunk_index": 0,
+            "content_digest": "sha256:b1c0e47b94ffd57e1d34394138d966803c049afc75e1dc0a1a80fea82de5c54a",
+            "record_count": 2
+          }
+        ]
+      },
+      "manifest_digest": "sha256:1c847123277f7973f117b21e597eefdadc93a401e2bec99c94dbb1fb2e3d31c7",
+      "record_count": 2
+    },
+    "observation_manifest": {
+      "batches": [
+        {
+          "chunk_index": 0,
+          "content_digest": "sha256:b1c0e47b94ffd57e1d34394138d966803c049afc75e1dc0a1a80fea82de5c54a",
+          "record_count": 2,
+          "observation_kind": "observed_by",
+          "observed_by": "2026-09-08T01:00:00Z",
+          "evidence_digest": "sha256:6f35f19a2ede0610d461b458a0f2cbc96f40cee6e90fa6592fd66daf617d3ec0"
+        }
+      ]
+    },
+    "lineage": {
+      "publisher": {
+        "id": "researchhub.data",
+        "version": "2.0.0"
+      },
+      "transformation": {
+        "id": "rhtransform:55555555555555555555555555555555",
+        "version": "2.0.0"
+      },
+      "upstream_snapshot_ids": [],
+      "upstream_content_digests": []
+    },
+    "quality": {
+      "status": "passed",
+      "checks": [
+        {
+          "check_id": "completeness",
+          "status": "passed",
+          "severity": "blocking",
+          "evidence_digest": "sha256:519b01c60ad85c2b03d6c4f29027fe9b3672a8f6ae3ca8a2d831b281a61c5095"
+        },
+        {
+          "check_id": "duplicate_identity",
+          "status": "passed",
+          "severity": "blocking",
+          "evidence_digest": "sha256:7c585c7471ab45886fce037061b5ab0d5f981aede5d5190021963676b0ec0fcc"
+        },
+        {
+          "check_id": "observation_coverage",
+          "status": "passed",
+          "severity": "blocking",
+          "evidence_digest": "sha256:dde5693c3ad79a01a162f9fc5a40c69d3c284965e283c91c5cd456904e0ef737"
+        },
+        {
+          "check_id": "historical_claim_policy",
+          "status": "passed",
+          "severity": "blocking",
+          "evidence_digest": "sha256:f4cf8da48f92e03d75bb28b2569061e649f382ba360d879fef8e41e35169c228"
+        },
+        {
+          "check_id": "range_validity",
+          "status": "passed",
+          "severity": "blocking",
+          "evidence_digest": "sha256:6af08355c5e29d846e1c48783dccde791e8a3f48f8416149413217b7c2cbb52a"
+        },
+        {
+          "check_id": "schema_conformance",
+          "status": "passed",
+          "severity": "blocking",
+          "evidence_digest": "sha256:fefdc5b81eba128af92f15a60feb7bb6f40b2e7277bf2beb48c1bb9399ee564b"
+        }
+      ]
+    },
+    "qualification": {
+      "status": "qualified",
+      "usage": "retrospective_research",
+      "policy_id": "researchhub.dataset-snapshot.retrospective",
+      "policy_version": "2.0.0",
+      "evaluated_at": "2026-09-08T01:02:00Z",
+      "evidence_digest": "sha256:70c3ddcadf095877f17a1365c8d75a2e5a7078a27722fb8b698e61d350c6bb2d"
+    }
+  },
+  "snapshot_id": "rhdsv2:sha256:fff0c2f4721407dd8264dacaaec389047fe5533258e940611bd61fb9c8a90905"
+}