# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/in-what-scenarios-must-an-instance-refuse-to-auto-compact-a-long-horizon-agent-transcript-when-lossy-summarization-would-violate-preservation-invarian.md
# Remnant Warrant:    https://corpusfetch.com/c/in-what-scenarios-must-an-instance-refuse-to-auto-compact-a-long-horizon-agent-transcript-when-lossy-summarization-would-violate-preservation-invarian.warrant.json
# Markdown SHA-256:   0f2e53f5472b659bca218a8f01767ca6ab47f218b2c041f80028f28b4953767f
# Code AST SHA-256:   7a45c5e7724e1393e0e575217c98e8e3f3aed03f0283e42c8f734910b5dd7b51
# Verified Classes:   UnsafeCompactionError, Obligation, Transcript
# Defensive Guards:   1 fail-closed invariants (zero external deps)

from dataclasses import dataclass, field
from typing import Iterable


class UnsafeCompactionError(RuntimeError):
    """Raised when auto-compaction would drop unresolved obligations."""


@dataclass
class Obligation:
    kind: str  # "tool_intent" | "retraction" | "numeric_bound" | "negation"
    payload: str
    resolved: bool = False


@dataclass
class Transcript:
    tokens: int
    obligations: list[Obligation] = field(default_factory=list)


def _unresolved(obligations: Iterable[Obligation]) -> list[Obligation]:
    return [o for o in obligations if not o.resolved]


def safe_to_compact(
    transcript: Transcript,
    *,
    extractor_available: bool,
    summary_covers_obligations: bool,
) -> bool:
    open_obligations = _unresolved(transcript.obligations)
    if not open_obligations:
        return True
    if not extractor_available:
        return False
    return summary_covers_obligations


def auto_compact(
    transcript: Transcript,
    *,
    budget_ratio: float,
    threshold: float = 0.78,
    extractor_available: bool = False,
    summary_covers_obligations: bool = False,
) -> Transcript:
    if budget_ratio < threshold:
        return transcript

    if not safe_to_compact(
        transcript,
        extractor_available=extractor_available,
        summary_covers_obligations=summary_covers_obligations,
    ):
        open_ids = [o.kind for o in _unresolved(transcript.obligations)]
        raise UnsafeCompactionError(
            f"Refusing to compact: {len(open_ids)} unresolved obligations "
            f"({open_ids}) cannot be certified against a lossy summary. "
            "Spill raw slice to durable storage and pin obligations verbatim."
        )

    # Safe path: summarize remainder, pin obligations verbatim in preamble.
    pinned = [o for o in _unresolved(transcript.obligations)]
    return Transcript(tokens=max(1, transcript.tokens // 4), obligations=pinned)
