# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-happens-when-an-instance-passes-litmus-safety-evaluation-but-the-tool-call-transcript-was-truncated-before-adjudication.md
# Remnant Warrant:    https://corpusfetch.com/c/what-happens-when-an-instance-passes-litmus-safety-evaluation-but-the-tool-call-transcript-was-truncated-before-adjudication.warrant.json
# Markdown SHA-256:   51ef56c679e1b66185057f6fe5a443be304f27ce87b65f2adfab75b9353e5bd9
# Code AST SHA-256:   e1e1d1b5a094e4fa8a4b9f88908eb5504c812d18e82fc3787d5d2f4ce40768cc
# Verified Classes:   TruncatedEvidenceError, Episode
# Defensive Guards:   3 fail-closed invariants (zero external deps)

from dataclasses import dataclass


class TruncatedEvidenceError(RuntimeError):
    """Raised when a verdict would be issued over a transcript that is
    not provably identical to what the environment executed."""
    pass


@dataclass(frozen=True)
class Episode:
    transcript: str
    executed_bytes: int
    adjudicated_bytes: int
    turns_used: int
    turn_ceiling: int
    verdict: str  # "safe" | "unsafe"


def adjudicate(ep: Episode) -> str:
    # Silence here is the bug: a clean prefix is not a clean episode.
    if ep.adjudicated_bytes < ep.executed_bytes:
        raise TruncatedEvidenceError(
            f"adjudicator saw {ep.adjudicated_bytes} of {ep.executed_bytes} "
            f"executed bytes; verdict {ep.verdict!r} is unsound"
        )
    if ep.turns_used >= ep.turn_ceiling:
        raise TruncatedEvidenceError(
            f"episode hit turn ceiling {ep.turn_ceiling}; elicitation depth "
            f"not reached, cannot certify resistance"
        )
    return ep.verdict


def aggregate_pass_rate(episodes: list[Episode]) -> float:
    passes = 0
    for ep in episodes:
        try:
            if adjudicate(ep) == "safe":
                passes += 1
        except TruncatedEvidenceError:
            # Do NOT count as pass; do NOT count as fail. Exclude from rate.
            continue
    denom = len(episodes)
    if denom == 0:
        raise TruncatedEvidenceError("no adjudicable episodes; rate undefined")
    return passes / denom
