crc-framework 0.5.1__tar.gz → 0.5.2__tar.gz

{crc_framework-0.5.1 → crc_framework-0.5.2}/Cargo.lock

@@ -67,7 +67,7 @@ dependencies = [
 
 [[package]]
 name = "crc-framework-core"
-version = "0.5.1"
+version = "0.5.2"
 dependencies = [
  "h3o",
  "phf",
@@ -79,7 +79,7 @@ dependencies = [
 
 [[package]]
 name = "crc-framework-rs"
-version = "0.5.1"
+version = "0.5.2"
 dependencies = [
  "crc-framework-core",
  "h3o",
@@ -88,7 +88,7 @@ dependencies = [
 
 [[package]]
 name = "crc-framework-wasm"
-version = "0.5.1"
+version = "0.5.2"
 dependencies = [
  "crc-framework-core",
  "js-sys",

{crc_framework-0.5.1 → crc_framework-0.5.2}/Cargo.toml

@@ -12,7 +12,7 @@ readme = "README.md"
 members = ["crates/core"]
 
 [workspace.package]
-version = "0.5.1"
+version = "0.5.2"
 
 [lib]
 name = "_core"

{crc_framework-0.5.1 → crc_framework-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crc-framework
-Version: 0.5.1
+Version: 0.5.2
 Classifier: Development Status :: 3 - Alpha
 Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
 Classifier: Operating System :: OS Independent

{crc_framework-0.5.1 → crc_framework-0.5.2}/crates/core/src/impact/registry.rs

@@ -14,7 +14,7 @@ use crate::reference::climate::{
 };
 
 const REGISTRY_ID: &str = "crc-climate-impacts";
-const REGISTRY_REVISION: &str = "2026.10.0";
+const REGISTRY_REVISION: &str = "2026.10.1";
 const RESOLVER_VERSION: &str = "crc-impact-registry/1";
 const FWI_MIDPOINT: f64 = 35.65;
 const FWI_STEEPNESS: f64 = 0.2051873853077659;
@@ -114,7 +114,7 @@ const FACTORS: &[FactorMeta] = &[
     FactorMeta {
         factor: "rx1day",
         context: &["cell"],
-        calibration: ["rx1day", "mm", "damage_ratio", "1"],
+        calibration: ["rx1day", "mm/day", "damage_ratio", "1"],
         branches: &[],
     },
     FactorMeta {

{crc_framework-0.5.1 → crc_framework-0.5.2}/crates/core/tests/impact_registry_conformance.rs

@@ -7,7 +7,10 @@ use std::str::FromStr;
 
 use crc_framework_core::{
     ImpactContext, ImpactDefinition, ImpactRegistry,
-    impact::{RegistryImpactReference, ResolutionContext, manifest_json, manifest_sha256},
+    impact::{
+        RegistryImpactReference, ResolutionContext, manifest_json, manifest_sha256,
+        registry_identity,
+    },
 };
 use h3o::{CellIndex, Resolution};
 use serde_json::{Value, json};
@@ -29,7 +32,7 @@ fn reference(
     let text = json!({
         "schema_version": "1.0",
         "registry_id": "crc-climate-impacts",
-        "registry_revision": "2026.10.0",
+        "registry_revision": registry_identity().1,
         "registry_manifest_sha256": manifest_sha256(),
         "resolver_semantics_version": "crc-impact-registry/1",
         "factor": factor,
@@ -157,7 +160,10 @@ fn installed_manifest_is_stable() {
     );
     assert_eq!(manifest_sha256(), manifest_sha256());
     assert!(manifest_json().contains("\"registry_id\":\"crc-climate-impacts\""));
-    assert!(manifest_json().contains("\"registry_revision\":\"2026.10.0\""));
+    assert!(manifest_json().contains(&format!(
+        "\"registry_revision\":\"{}\"",
+        registry_identity().1
+    )));
     assert!(!manifest_json().contains(' '));
     let manifest: Value = serde_json::from_str(manifest_json()).unwrap();
     let cooling = manifest["factors"]
@@ -275,7 +281,7 @@ fn resolution_checks_identity_context_overrides_and_fallbacks() {
     assert_eq!(error.code, "registry_unavailable");
     assert_eq!(error.path, "/registry_revision");
 
-    wrong_revision["registry_revision"] = json!("2026.10.0");
+    wrong_revision["registry_revision"] = json!(registry_identity().1);
     wrong_revision["registry_id"] = json!("other-registry");
     let error = RegistryImpactReference::from_json(&wrong_revision.to_string())
         .unwrap()
@@ -318,7 +324,7 @@ fn resolution_checks_identity_context_overrides_and_fallbacks() {
         &json!({
             "schema_version": "1.0",
             "registry_id": "crc-climate-impacts",
-            "registry_revision": "2026.10.0",
+            "registry_revision": registry_identity().1,
             "registry_manifest_sha256": manifest_sha256(),
             "resolver_semantics_version": "crc-impact-registry/1",
             "factor": "spei",

crc_framework-0.5.2/python/crc_framework/contracts/impact/catalogs/hazard-exposures.json

@@ -0,0 +1,26 @@
+{
+  "description": "External hazard identifiers that denote a registry factor's exposure. Readers take the exposure variable and unit from that factor's calibration in the installed registry manifest. Names that are absent are unknown.",
+  "entries": [
+    {
+      "id": "rx1day",
+      "aliases": [
+        "Rx1day"
+      ],
+      "factor": "rx1day"
+    },
+    {
+      "id": "fd",
+      "aliases": [
+        "FD"
+      ],
+      "factor": "frost_days"
+    },
+    {
+      "id": "cdd",
+      "aliases": [
+        "CDD"
+      ],
+      "factor": "maximum_consecutive_dry_days"
+    }
+  ]
+}

{crc_framework-0.5.1 → crc_framework-0.5.2}/python/crc_framework/contracts/impact/fixtures/definitions.json

@@ -175,9 +175,9 @@
     {
       "name": "origin-registry-legacy-fallback",
       "description": "Registry origin with composite lookup keys, a recorded fallback, a null override and full context.",
-      "input_json": "{\"schema_version\":\"1.0\",\"semantics_version\":\"crc-impact/1\",\"calibration\":{\"exposure_variable\":\"rx1day\",\"exposure_unit\":\"mm\",\"impact_metric\":\"damage_ratio\",\"impact_unit\":\"1\"},\"model\":{\"kind\":\"sigmoid\",\"midpoint\":682.5,\"steepness\":0.007,\"origin_adjustment\":\"subtract_at_zero\"},\"provenance\":{\"origin\":{\"kind\":\"registry\",\"registry_id\":\"crc-climate-impacts\",\"registry_revision\":\"2026.10.0\",\"registry_manifest_sha256\":\"3333333333333333333333333333333333333333333333333333333333333333\",\"resolver_semantics_version\":\"crc-impact-registry/1\",\"factor\":\"rx1day\",\"context\":{\"cell\":\"8a2a1072b59ffff\",\"country\":null,\"continent\":null,\"building_type\":null,\"historic_mean\":null},\"overrides\":{\"zero_below\":null,\"steepness\":0.007},\"fallback_policy\":\"legacy_defaults\",\"lookups\":[{\"table_id\":\"precipitation.rx1day_threshold\",\"table_sha256\":\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"requested_key\":{\"h3_resolution\":\"4\",\"cell\":\"0842a107fffffff\"},\"resolved_key\":\"global_default\",\"status\":\"fallback\"}]}}}",
-      "canonical_json": "{\"calibration\":{\"exposure_unit\":\"mm\",\"exposure_variable\":\"rx1day\",\"impact_metric\":\"damage_ratio\",\"impact_unit\":\"1\"},\"clamp\":null,\"model\":{\"amplitude\":1.0,\"kind\":\"sigmoid\",\"midpoint\":682.5,\"offset\":0.0,\"origin_adjustment\":\"subtract_at_zero\",\"steepness\":0.007,\"zero_below\":null},\"provenance\":{\"derived_from\":[],\"origin\":{\"context\":{\"building_type\":null,\"cell\":\"8a2a1072b59ffff\",\"continent\":null,\"country\":null,\"historic_mean\":null},\"factor\":\"rx1day\",\"fallback_policy\":\"legacy_defaults\",\"kind\":\"registry\",\"lookups\":[{\"requested_key\":{\"cell\":\"0842a107fffffff\",\"h3_resolution\":\"4\"},\"resolved_key\":\"global_default\",\"status\":\"fallback\",\"table_id\":\"precipitation.rx1day_threshold\",\"table_sha256\":\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"}],\"overrides\":{\"steepness\":0.007,\"zero_below\":null},\"registry_id\":\"crc-climate-impacts\",\"registry_manifest_sha256\":\"3333333333333333333333333333333333333333333333333333333333333333\",\"registry_revision\":\"2026.10.0\",\"resolver_semantics_version\":\"crc-impact-registry/1\"},\"sources\":[]},\"schema_version\":\"1.0\",\"semantics_version\":\"crc-impact/1\"}",
-      "content_hash": "sha256:6f09aa8623198c6721d5046aade2318235a7aeaf3bd20051d139fe7254bfcf8f",
+      "input_json": "{\"schema_version\":\"1.0\",\"semantics_version\":\"crc-impact/1\",\"calibration\":{\"exposure_variable\":\"rx1day\",\"exposure_unit\":\"mm/day\",\"impact_metric\":\"damage_ratio\",\"impact_unit\":\"1\"},\"model\":{\"kind\":\"sigmoid\",\"midpoint\":682.5,\"steepness\":0.007,\"origin_adjustment\":\"subtract_at_zero\"},\"provenance\":{\"origin\":{\"kind\":\"registry\",\"registry_id\":\"crc-climate-impacts\",\"registry_revision\":\"2026.10.0\",\"registry_manifest_sha256\":\"3333333333333333333333333333333333333333333333333333333333333333\",\"resolver_semantics_version\":\"crc-impact-registry/1\",\"factor\":\"rx1day\",\"context\":{\"cell\":\"8a2a1072b59ffff\",\"country\":null,\"continent\":null,\"building_type\":null,\"historic_mean\":null},\"overrides\":{\"zero_below\":null,\"steepness\":0.007},\"fallback_policy\":\"legacy_defaults\",\"lookups\":[{\"table_id\":\"precipitation.rx1day_threshold\",\"table_sha256\":\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"requested_key\":{\"h3_resolution\":\"4\",\"cell\":\"0842a107fffffff\"},\"resolved_key\":\"global_default\",\"status\":\"fallback\"}]}}}",
+      "canonical_json": "{\"calibration\":{\"exposure_unit\":\"mm/day\",\"exposure_variable\":\"rx1day\",\"impact_metric\":\"damage_ratio\",\"impact_unit\":\"1\"},\"clamp\":null,\"model\":{\"amplitude\":1.0,\"kind\":\"sigmoid\",\"midpoint\":682.5,\"offset\":0.0,\"origin_adjustment\":\"subtract_at_zero\",\"steepness\":0.007,\"zero_below\":null},\"provenance\":{\"derived_from\":[],\"origin\":{\"context\":{\"building_type\":null,\"cell\":\"8a2a1072b59ffff\",\"continent\":null,\"country\":null,\"historic_mean\":null},\"factor\":\"rx1day\",\"fallback_policy\":\"legacy_defaults\",\"kind\":\"registry\",\"lookups\":[{\"requested_key\":{\"cell\":\"0842a107fffffff\",\"h3_resolution\":\"4\"},\"resolved_key\":\"global_default\",\"status\":\"fallback\",\"table_id\":\"precipitation.rx1day_threshold\",\"table_sha256\":\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"}],\"overrides\":{\"steepness\":0.007,\"zero_below\":null},\"registry_id\":\"crc-climate-impacts\",\"registry_manifest_sha256\":\"3333333333333333333333333333333333333333333333333333333333333333\",\"registry_revision\":\"2026.10.0\",\"resolver_semantics_version\":\"crc-impact-registry/1\"},\"sources\":[]},\"schema_version\":\"1.0\",\"semantics_version\":\"crc-impact/1\"}",
+      "content_hash": "sha256:dedd30a0a381474285018a0095c5cb29526305ca98041d8489f89ffe736fd442",
       "schema_valid": true
     },
     {

{crc_framework-0.5.1 → crc_framework-0.5.2}/python/crc_framework/contracts/impact/manifest.json

@@ -40,6 +40,11 @@
       "sha256": "0f34f334aafa2b56bb1897fe24c824888f3f88daec345ef84bbe7ae802733af7",
       "bytes": 4843
     },
+    {
+      "path": "catalogs/hazard-exposures.json",
+      "sha256": "114a9e2dc76e4b4f4d2fbb1f03bab21a5a35db28b003f566e2253074165128a4",
+      "bytes": 585
+    },
     {
       "path": "catalogs/native-capabilities.json",
       "sha256": "6f28fde56d640b4b21b2e9549061ff58fc9a0872624294891bf849050efa82ec",
@@ -67,8 +72,8 @@
     },
     {
       "path": "fixtures/definitions.json",
-      "sha256": "54460a41ab7446b017c6a9d353da6615037cbabaa9f223703ba4db9bad7085c4",
-      "bytes": 91026
+      "sha256": "970e1d95c574978e49233038b1db398cfc04ec5639cb1d6e697fd53defc77ea3",
+      "bytes": 91034
     },
     {
       "path": "fixtures/evaluation-records.json",

{crc_framework-0.5.1 → crc_framework-0.5.2}/tests/test_impact_expression.py

@@ -480,13 +480,13 @@ def test_registry_manifest_digest_matches_identity() -> None:
     assert manifest["registry_revision"] == revision
     assert manifest["resolver_semantics_version"] == resolver
     factors = {item["factor"]: item for item in manifest["factors"]}
-    assert factors["rx1day"]["calibration"]["exposure_unit"] == "mm"
+    assert factors["rx1day"]["calibration"]["exposure_unit"] == "mm/day"
     agricultural = factors["cooling_degree_days"]["branch_calibrations"]["agricultural"]
     assert agricultural["impact_metric"] == "crop_yield_change"
     with pytest.raises(TypeError):
         manifest["registry_id"] = "other"  # type: ignore[index]
     with pytest.raises(TypeError):
-        factors["rx1day"]["calibration"]["exposure_unit"] = "mm/day"  # type: ignore[index]
+        factors["rx1day"]["calibration"]["exposure_unit"] = "cm"  # type: ignore[index]
 
     impact_module = importlib.import_module("crc_framework.impacts")
     assert impact_module.impact_registry_manifest is impact_registry_manifest
@@ -494,6 +494,37 @@ def test_registry_manifest_digest_matches_identity() -> None:
     assert crc_framework.impact_registry_manifest is impact_registry_manifest
 
 
+def test_hazard_exposure_catalog_uses_factor_calibrations() -> None:
+    catalog = load_impact_contract_file("catalogs/hazard-exposures.json")
+    factors = {item["factor"]: item for item in impact_registry_manifest()["factors"]}
+    seen: set[str] = set()
+    expected = {
+        "rx1day": "rx1day",
+        "fd": "frost_days",
+        "cdd": "maximum_consecutive_dry_days",
+    }
+    found = {}
+    for entry in catalog["entries"]:
+        factor = factors[entry["factor"]]
+        calibration = factor["calibration"]
+        for branch in factor.get("branch_calibrations", {}).values():
+            assert branch["exposure_variable"] == calibration["exposure_variable"]
+            assert branch["exposure_unit"] == calibration["exposure_unit"]
+        for name in (entry["id"], *entry["aliases"]):
+            assert name not in seen
+            seen.add(name)
+        found[entry["id"]] = entry["factor"]
+        assert calibration["exposure_variable"]
+        assert calibration["exposure_unit"]
+    assert found == expected
+    assert factors["rx1day"]["calibration"] == {
+        "exposure_variable": "rx1day",
+        "exposure_unit": "mm/day",
+        "impact_metric": "damage_ratio",
+        "impact_unit": "1",
+    }
+
+
 def test_empirical_and_point_mass_expectations_are_exact() -> None:
     expression = ImpactExpression.linear(2.0, calibration=CALIBRATION)
     # Empirical quantiles are piecewise linear through the order statistics,

{crc_framework-0.5.1 → crc_framework-0.5.2}/tools/impact_contracts/cases.py

@@ -218,7 +218,7 @@ def definition_cases() -> Dict[str, List[Dict[str, Any]]]:
         "Registry origin with composite lookup keys, a recorded fallback, a null override and full context.",
         definition(
             {"kind": "sigmoid", "midpoint": 682.5, "steepness": 0.007, "origin_adjustment": "subtract_at_zero"},
-            calibration={"exposure_variable": "rx1day", "exposure_unit": "mm", "impact_metric": "damage_ratio", "impact_unit": "1"},
+            calibration={"exposure_variable": "rx1day", "exposure_unit": "mm/day", "impact_metric": "damage_ratio", "impact_unit": "1"},
             provenance={
                 "origin": {
                     "kind": "registry",

{crc_framework-0.5.1 → crc_framework-0.5.2}/tools/impact_contracts/generate.py

@@ -79,6 +79,22 @@ UNIT_ALIASES = {
     "aliases": {"metre": "m", "metres": "m", "meter": "m", "meters": "m", "day": "d", "days": "d", "fraction": "1", "ratio": "1", "dimensionless": "1"},
 }
 
+# External hazard ids that denote a registry factor. Exposure variable and unit
+# are read from that factor's calibration; this catalog does not copy them.
+# Unlisted hazards are unknown and need an explicit caller declaration.
+HAZARD_EXPOSURES = {
+    "description": (
+        "External hazard identifiers that denote a registry factor's exposure. "
+        "Readers take the exposure variable and unit from that factor's calibration "
+        "in the installed registry manifest. Names that are absent are unknown."
+    ),
+    "entries": [
+        {"id": "rx1day", "aliases": ["Rx1day"], "factor": "rx1day"},
+        {"id": "fd", "aliases": ["FD"], "factor": "frost_days"},
+        {"id": "cdd", "aliases": ["CDD"], "factor": "maximum_consecutive_dry_days"},
+    ],
+}
+
 OVERRIDE_MEANINGS = {
     "sigmoid": "minimum_damage and maximum_damage set curve levels (offset and offset + amplitude), not a final clamp.",
     "hot_days": "minimum_damage and maximum_damage set the final clamp; null clears a limit.",
@@ -123,6 +139,19 @@ def _override_catalog() -> Dict[str, Any]:
     return {"resolver_semantics_version": ref.RESOLVER_SEMANTICS_VERSION, "factors": factors}
 
 
+def _check_hazard_exposures(catalog: Dict[str, Any]) -> None:
+    """Names are unique and every factor is one the reference registry knows."""
+    seen: set[str] = set()
+    for entry in catalog["entries"]:
+        factor = entry["factor"]
+        if factor not in ref.REGISTRY_FACTORS:
+            raise AssertionError(f"hazard exposure factor {factor} is not a registry factor")
+        for name in (entry["id"], *entry["aliases"]):
+            if name in seen:
+                raise AssertionError(f"hazard exposure name {name} is repeated")
+            seen.add(name)
+
+
 def _json(value: Any) -> bytes:
     return (json.dumps(value, indent=2, ensure_ascii=False) + "\n").encode("utf-8")
 
@@ -218,6 +247,8 @@ def build() -> Dict[str, bytes]:
         {"codes": {code: {"stage": stage, "meaning": meaning} for code, (stage, meaning) in ERROR_CODES.items()}}
     )
     files["catalogs/unit-aliases.json"] = _json(UNIT_ALIASES)
+    files["catalogs/hazard-exposures.json"] = _json(HAZARD_EXPOSURES)
+    _check_hazard_exposures(HAZARD_EXPOSURES)
     used = {
         case["error"]["code"]
         for path in FIXTURE_CONTRACTS