feat: add typed tier assurance guardrails

projects/coulomb-pricing/tests/test_boundary_engine.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from dataclasses import replace
 from decimal import Decimal
 from pathlib import Path
 
@@ -9,6 +10,7 @@ from adaptive_pricing_core.boundary_engine import (
     PricingConfiguration,
     validate_pricing_configuration,
 )
+from adaptive_pricing_core.pricing_models import AssuranceClaim
 from observatory.load import load_pricing_models
 
 DATA_DIR = Path(__file__).resolve().parent.parent / "data"
@@ -18,6 +20,106 @@ def _model(model_id: str):
     return next(item for item in load_pricing_models(DATA_DIR) if item.id == model_id)
 
 
+def _configuration_with_claim(claim: AssuranceClaim) -> PricingConfiguration:
+    return PricingConfiguration(
+        model=replace(_model("flat-899-eur-monthly"), assurance_claims=(claim,)),
+        segment="coulomb-social-members",
+        allocated_fixed_cost=Decimal("1.00"),
+        payment_fee_rate_pct=Decimal("5"),
+    )
+
+
+def _claim(**changes) -> AssuranceClaim:
+    defaults = {
+        "id": "isolation-tier",
+        "kind": "isolation",
+        "customer_wording": "Other tenants cannot reach your data.",
+        "minimum_levels": {"E": 4, "P": 3},
+        "delivering_service": "tenant-engine",
+        "evidence_ref": "evidence/isolation-review.json",
+    }
+    defaults.update(changes)
+    return AssuranceClaim(**defaults)
+
+
+def test_valid_assurance_claim_passes_with_explainable_result() -> None:
+    result = validate_pricing_configuration(
+        _configuration_with_claim(_claim()),
+        BoundaryPolicy(),
+    )
+
+    assurance = next(item for item in result.constraints if item.id == "assurance-claims")
+    assert assurance.status == "pass"
+    assert assurance.details["claim_ids"] == ["isolation-tier"]
+
+
+def test_isolation_wording_requires_e4_and_coupled_p3() -> None:
+    result = validate_pricing_configuration(
+        _configuration_with_claim(_claim(minimum_levels={"E": 3, "P": 2})),
+        BoundaryPolicy(),
+    )
+
+    assurance = next(item for item in result.constraints if item.id == "assurance-claims")
+    assert assurance.status == "fail"
+    assert "E §11.4" in assurance.reason
+
+
+def test_retention_claim_requires_bounded_shared_horizon() -> None:
+    result = validate_pricing_configuration(
+        _configuration_with_claim(
+            _claim(
+                id="retention-tier",
+                kind="retention",
+                customer_wording="Deleted data is gone.",
+                minimum_levels={"R": 3, "P": 1},
+            )
+        ),
+        BoundaryPolicy(),
+    )
+
+    assurance = next(item for item in result.constraints if item.id == "assurance-claims")
+    assert assurance.status == "fail"
+    assert "R §4.5.4/§11.1" in assurance.reason
+    assert "P §4.5.4" in assurance.reason
+    assert "R §11.4" in assurance.reason
+
+
+def test_performance_claim_requires_p2_or_resource_governor() -> None:
+    result = validate_pricing_configuration(
+        _configuration_with_claim(
+            _claim(
+                id="performance-tier",
+                kind="performance",
+                customer_wording="Predictable performance under neighbour load.",
+                minimum_levels={"P": 1},
+            )
+        ),
+        BoundaryPolicy(),
+    )
+
+    assurance = next(item for item in result.constraints if item.id == "assurance-claims")
+    assert assurance.status == "fail"
+    assert "P §8.3.1/§11.6" in assurance.reason
+
+
+def test_availability_wording_requires_matching_failure_scope() -> None:
+    result = validate_pricing_configuration(
+        _configuration_with_claim(
+            _claim(
+                id="availability-tier",
+                kind="availability",
+                customer_wording="High availability survives regional loss.",
+                minimum_levels={"V": 3},
+            )
+        ),
+        BoundaryPolicy(),
+    )
+
+    assurance = next(item for item in result.constraints if item.id == "assurance-claims")
+    assert assurance.status == "fail"
+    assert "V §11.4" in assurance.reason
+
+
 def test_commitment_backed_discount_is_accepted_when_economics_stay_strong() -> None:
     result = validate_pricing_configuration(
         PricingConfiguration(