resource-control/tests/test_control_cycle.py

import json
import sys
import unittest
from pathlib import Path

sys.path.insert(0, str(Path(__file__).parents[1] / "tools"))
from control_cycle import compare


def record(kind="forecast", resource_class="storage"):
    result = {
        "record_id": f"test:{kind}", "record_type": kind,
        "resource_id": "resource:test", "resource_class": resource_class,
        "period": "2026-09", "usage_proxies": {"stored_gb": {"value": 100, "unit": "GB-month"}},
        "costs": {"currency": "EUR", "infrastructure": 10, "internal_labor": 60, "external_labor": 0, "total": 70},
        "allocation": {"method": "direct", "driver": "stored_gb", "method_version": "1", "unattributed_eur": 0},
    }
    if kind == "actual":
        result["forecast_ref"] = "test:forecast"
    return result


class ControlCycleTest(unittest.TestCase):
    def test_same_mechanism_supports_required_resource_classes(self):
        for resource_class in ("storage", "cluster_compute", "shared_platform_service"):
            forecast = record(resource_class=resource_class)
            actual = record("actual", resource_class)
            actual["usage_proxies"]["stored_gb"]["value"] = 120
            result = compare(forecast, actual)
            self.assertEqual(resource_class, result["resource_class"])
            self.assertEqual("demand", result["usage_proxies"]["stored_gb"]["category"])

    def test_explicit_attribution_and_cost_split_are_preserved(self):
        forecast, actual = record(), record("actual")
        actual["costs"].update(infrastructure=12, internal_labor=90, total=102)
        actual["variance_attribution"] = {"costs.infrastructure": "model", "costs.internal_labor": "labor"}
        result = compare(forecast, actual)
        self.assertEqual("model", result["costs"]["infrastructure"]["category"])
        self.assertEqual(30, result["costs"]["internal_labor"]["error"])

    def test_rejects_wrong_forecast_reference(self):
        forecast, actual = record(), record("actual")
        actual["forecast_ref"] = "test:other"
        with self.assertRaisesRegex(ValueError, "immutable forecast"):
            compare(forecast, actual)

    def test_missing_proxy_is_data_quality_error(self):
        forecast, actual = record(), record("actual")
        actual["usage_proxies"] = {"cpu_hours": {"value": 4, "unit": "vCPU-hour"}}
        result = compare(forecast, actual)
        self.assertEqual("data_quality", result["usage_proxies"]["stored_gb"]["category"])


class UnknownCostTest(unittest.TestCase):
    """Schema 0.2: a cost the authoritative repository has not supplied is
    unknown, not zero, and must not produce a fabricated variance."""

    def test_unknown_cost_reports_status_rather_than_an_error_figure(self):
        forecast, actual = record(), record("actual")
        forecast["costs"].update(infrastructure=None, total=None)
        actual["costs"].update(infrastructure=None, total=None)
        result = compare(forecast, actual)["costs"]["infrastructure"]
        self.assertEqual("unknown", result["status"])
        self.assertNotIn("error", result)

    def test_unknown_cost_is_a_data_quality_gap_not_a_price_movement(self):
        forecast, actual = record(), record("actual")
        actual["costs"].update(infrastructure=None, total=None)
        actual["variance_attribution"] = {"costs.infrastructure": "provider_price"}
        result = compare(forecast, actual)["costs"]["infrastructure"]
        self.assertEqual("data_quality", result["category"])

    def test_known_components_still_compute_beside_an_unknown_one(self):
        forecast, actual = record(), record("actual")
        forecast["costs"].update(infrastructure=None, total=None)
        actual["costs"].update(infrastructure=None, internal_labor=90, total=None)
        result = compare(forecast, actual)["costs"]
        self.assertEqual("unknown", result["infrastructure"]["status"])
        self.assertEqual(30, result["internal_labor"]["error"])

    def test_one_sided_unknown_does_not_subtract_against_a_missing_amount(self):
        forecast, actual = record(), record("actual")
        actual["costs"].update(infrastructure=None, total=None)
        result = compare(forecast, actual)["costs"]["infrastructure"]
        self.assertEqual("unknown", result["status"])
        self.assertEqual(10, result["forecast"])
        self.assertIsNone(result["actual"])


class OperationalRecordTest(unittest.TestCase):
    """The first real apps-pg record, folded in from RAILIANCE-WP-0016."""

    def setUp(self):
        path = Path(__file__).parents[1] / "data" / "control-cycle" / "apps-pg-2026-09-base.json"
        self.record = json.loads(path.read_text())

    def test_usage_is_known_while_infrastructure_cost_is_not(self):
        costs = self.record["costs"]
        self.assertIsNone(costs["infrastructure"])
        self.assertIsNone(costs["total"])
        self.assertEqual(30.0, costs["internal_labor"])
        self.assertTrue(self.record["usage_proxies"])

    def test_total_is_not_the_sum_of_the_known_parts(self):
        costs = self.record["costs"]
        known = costs["internal_labor"] + costs["external_labor"]
        self.assertNotEqual(known, costs["total"])
        self.assertIsNone(costs["total"])

    def test_shared_overhead_is_recorded_as_a_share_before_any_eur_exists(self):
        allocation = self.record["allocation"]
        self.assertEqual("apps-pg-dbbytes-v1", allocation["method_version"])
        self.assertIsNone(allocation["unattributed_eur"])
        self.assertEqual(0.948, allocation["unattributed_share"])

    def test_absent_recovery_objectives_are_null_not_optimistic_defaults(self):
        constraints = self.record["service_constraints"]
        self.assertIsNone(constraints["rpo_minutes"]["value"])
        self.assertIsNone(constraints["rto_minutes"]["value"])

    def test_record_cites_the_authoritative_platform_evidence(self):
        self.assertIn("RAILIANCE-WP-0016", self.record["evidence"])
        self.assertEqual("high", self.record["uncertainty"]["level"])


if __name__ == "__main__":
    unittest.main()