# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/which-invariants-prevent-self-editing-context-windows-from-rewriting-the-evidence-they-are-about-to-be-judged-on.md
# Remnant Warrant:    https://corpusfetch.com/c/which-invariants-prevent-self-editing-context-windows-from-rewriting-the-evidence-they-are-about-to-be-judged-on.warrant.json
# Markdown SHA-256:   791f0ea62613e84867bc3ca8c2f8cc4b12ee69503127a6216a579f9b2ef65682
# Code AST SHA-256:   99570c7a9029687e8addd9d3f02b36c089f108a6b77abea532978971bbb898d7
# Verified Classes:   EvidenceRewriteViolation, Span, RewriteRecord
# Defensive Guards:   1 fail-closed invariants (zero external deps)

import hashlib
from dataclasses import dataclass, field
from typing import Iterable


class EvidenceRewriteViolation(RuntimeError):
    """Raised when a model-driven rewrite removes or alters a span that
    must be preserved verbatim for downstream verification."""


@dataclass(frozen=True)
class Span:
    byte_range: tuple[int, int]
    text: str
    cited: bool = False
    decisive: bool = False

    def digest(self) -> str:
        return hashlib.sha256(self.text.encode()).hexdigest()[:16]


@dataclass
class RewriteRecord:
    turn: int
    removed: list[Span] = field(default_factory=list)
    altered: list[Span] = field(default_factory=list)


DECISIVE_MARKERS = ("connection reset", "exhausted", "timeout", "denied", "panic")


def _is_decisive(span: Span) -> bool:
    if span.decisive or span.cited:
        return True
    low = span.text.lower()
    return any(m in low for m in DECISIVE_MARKERS)


def apply_rewrite(
    turn: int,
    original: Iterable[Span],
    retained_digests: set[str],
    hypothesis_formed_at: int | None,
) -> RewriteRecord:
    """Apply a model-proposed rewrite, refusing to drop evidence spans.

    The rewrite is rejected if (a) it drops a cited or decisive span, or
    (b) a hypothesis already exists and the dropped span is not provably
    irrelevant under the task spec alone (we approximate this by refusing
    any decisive drop once a hypothesis is live).
    """
    record = RewriteRecord(turn=turn)
    for span in original:
        if span.digest() in retained_digests:
            continue
        if _is_decisive(span):
            if hypothesis_formed_at is not None and turn >= hypothesis_formed_at:
                raise EvidenceRewriteViolation(
                    f"turn {turn}: rewrite drops decisive span {span.digest()} "
                    f"('{span.text[:40]}...') after hypothesis formed at "
                    f"turn {hypothesis_formed_at}; relevance was hypothesis-conditional"
                )
            record.removed.append(span)
        else:
            record.removed.append(span)
    return record
