# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-does-an-instance-detect-a-stale-safety-baseline-during-litmus-harness-integration.md
# Remnant Warrant:    https://corpusfetch.com/c/how-does-an-instance-detect-a-stale-safety-baseline-during-litmus-harness-integration.warrant.json
# Markdown SHA-256:   76615a89b7e4ab8a8ac2170a803081dfbe1f77e13009fa7552036697e75bc46b
# Code AST SHA-256:   c3c938ffd3df7c750da96c2443c6a1e7c9a1a951515b98cbb474c33afac67b72
# Verified Classes:   BaselineIncommensurableError, ComparabilityFingerprint
# Defensive Guards:   2 fail-closed invariants (zero external deps)

from dataclasses import dataclass


class BaselineIncommensurableError(RuntimeError):
    """Raised when a LITMUS run cannot be validly compared to its baseline."""


@dataclass(frozen=True)
class ComparabilityFingerprint:
    probe_corpus_hash: str
    judge_model_id: str
    judge_model_hash: str
    sampling_seed: int
    temperature: float
    completion_ratio: float
    harm_taxonomy_version: str


def assert_comparable(
    baseline: ComparabilityFingerprint,
    current: ComparabilityFingerprint,
) -> None:
    if current.completion_ratio < 1.0:
        raise BaselineIncommensurableError(
            f"run truncated at {current.completion_ratio:.2%}; "
            "partial runs are non-promotable and non-comparable"
        )
    mismatches = []
    for field in (
        "probe_corpus_hash",
        "judge_model_id",
        "judge_model_hash",
        "sampling_seed",
        "temperature",
        "harm_taxonomy_version",
    ):
        if getattr(baseline, field) != getattr(current, field):
            mismatches.append(
                f"{field}: baseline={getattr(baseline, field)!r} "
                f"current={getattr(current, field)!r}"
            )
    if mismatches:
        raise BaselineIncommensurableError(
            "baseline and current run are incommensurable; "
            "gate must halt and require explicit re-baseline: "
            + "; ".join(mismatches)
        )


def gate_verdict(
    baseline_fp: ComparabilityFingerprint,
    current_fp: ComparabilityFingerprint,
    baseline_score: float,
    current_score: float,
    tolerance: float = 0.0,
) -> str:
    assert_comparable(baseline_fp, current_fp)
    if current_score + tolerance < baseline_score:
        return "REGRESSION"
    return "PASS"
