test_config_contract.py

from cli.algorithms import ModelRef
from cli.config_contract import (
    LEGACY_SIGNAL_KEY_TO_CANONICAL,
    build_projection_reference_index,
    build_signal_reference_index,
    signal_reference_exists,
)
from cli.models import Decision, Projections, Signals


def test_legacy_signal_inventory_covers_flat_authz_and_context_blocks():
    assert LEGACY_SIGNAL_KEY_TO_CANONICAL["role_bindings"] == "role_bindings"
    assert LEGACY_SIGNAL_KEY_TO_CANONICAL["context_rules"] == "context"
    assert LEGACY_SIGNAL_KEY_TO_CANONICAL["events"] == "events"
    assert "session_metrics" not in LEGACY_SIGNAL_KEY_TO_CANONICAL


def test_build_signal_reference_index_expands_complexity_levels_and_authz_names():
    signals = Signals(
        complexity=[
            {
                "name": "difficulty",
                "easy": {"candidates": ["simple"]},
                "hard": {"candidates": ["complex"]},
            }
        ],
        role_bindings=[
            {
                "name": "admin-access",
                "role": "admin",
                "subjects": [{"kind": "User", "name": "alice"}],
            }
        ],
        events=[
            {
                "name": "critical_event",
                "event_types": ["payment_failed"],
                "severities": ["critical"],
            }
        ],
    )

    signal_names = build_signal_reference_index(signals)

    assert "difficulty:easy" in signal_names
    assert "difficulty:medium" in signal_names
    assert "difficulty:hard" in signal_names
    assert "admin-access" in signal_names
    assert "critical_event" in signal_names


def test_signal_reference_exists_strips_suffixes_for_non_complexity_signals():
    signal_names = {"security", "admin-access"}

    assert signal_reference_exists(signal_names, "keyword", "security:match")
    assert signal_reference_exists(signal_names, "authz", "admin-access")
    assert not signal_reference_exists(signal_names, "complexity", "security:match")


def test_projection_reference_index_collects_mapping_outputs():
    projections = Projections(
        mappings=[
            {
                "name": "difficulty_band",
                "source": "difficulty_score",
                "method": "threshold_bands",
                "outputs": [
                    {"name": "balance_simple", "lt": 0.15},
                    {"name": "balance_medium", "gte": 0.15, "lt": 0.45},
                ],
            }
        ]
    )

    assert build_projection_reference_index(projections) == {
        "balance_simple",
        "balance_medium",
    }


def test_decision_accepts_typed_output_contract_spec():
    decision = Decision(
        name="gpqa",
        description="strict choice route",
        priority=100,
        rules={"operator": "AND", "conditions": []},
        output_contract="Return exactly one answer letter: A, B, C, or D.",
        output_contract_spec={
            "type": "choice",
            "choice_set": {"values": ["A", "B", "C", "D"]},
            "render": {"mode": "value"},
            "extract": {"mode": "exact", "sources": ["content"]},
        },
        modelRefs=[{"model": "model-a", "use_reasoning": False}],
    )

    assert decision.output_contract_spec is not None
    assert decision.output_contract_spec.choice_set is not None
    assert decision.output_contract_spec.choice_set.values == ["A", "B", "C", "D"]


def test_model_ref_preserves_optional_quality_score_and_explicit_zero():
    assert ModelRef(model="model-a").quality_score is None
    assert ModelRef(model="model-a", quality_score=0).quality_score == 0
    assert ModelRef(model="model-a", quality_score=0.92).quality_score == 0.92


def test_decision_accepts_terminal_action_output_contract_spec():
    decision = Decision(
        name="terminal",
        description="terminal action route",
        priority=100,
        rules={"operator": "AND", "conditions": []},
        output_contract="Return one terminal action JSON object.",
        output_contract_spec={
            "type": "structured_json",
            "json_schema": {"schema_ref": "terminal_action_v1"},
            "extract": {
                "mode": "json_object",
                "sources": ["content", "candidate_responses"],
            },
        },
        modelRefs=[{"model": "model-a", "use_reasoning": False}],
    )

    assert decision.output_contract_spec is not None
    assert decision.output_contract_spec.json_schema is not None
    assert decision.output_contract_spec.json_schema.schema_ref == "terminal_action_v1"