# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-does-an-instance-detect-summary-fidelity-drift-before-auto-compaction-destroys-recoverable-session-state.md
# Remnant Warrant:    https://corpusfetch.com/c/how-does-an-instance-detect-summary-fidelity-drift-before-auto-compaction-destroys-recoverable-session-state.warrant.json
# Markdown SHA-256:   d957cacb883cdbba3fc359c7953f5f0163958bbd4182acacfd7a8cf4b379d49b
# Code AST SHA-256:   3389bb537c774856638b2d2556dc01a1a46c0ff605410f8e4f32c878c816d106
# Verified Classes:   SummaryFidelityError
# Defensive Guards:   4 fail-closed invariants (zero external deps)

class SummaryFidelityError(RuntimeError):
    """Raised when auto-compaction is attempted on a summary whose
    fidelity has not been verified against resident source turns."""
    pass


def compact_if_safe(summary_epochs, resident_turn_ids, budget_pressure, audit_verdict):
    """
    summary_epochs: list of {claims: {key: (value, source_turn)}} oldest->newest
    resident_turn_ids: set of turn indices still present in live context
    budget_pressure: bool, True when token budget threshold crossed
    audit_verdict: result of prior fidelity audit, or None if never run
    """
    if not budget_pressure:
        return "no_compaction_needed"

    # Gate 1: audit must have run before eviction.
    if audit_verdict is None:
        raise SummaryFidelityError(
            "Compaction blocked: no fidelity audit has been run against "
            "resident source. Eviction would launder summary drift."
        )

    # Gate 2: every audited claim must have a resident source turn.
    for epoch in summary_epochs:
        for key, (value, source_turn) in epoch["claims"].items():
            if source_turn not in resident_turn_ids:
                raise SummaryFidelityError(
                    f"Compaction blocked: claim {key!r}={value!r} has no "
                    f"resident source (turn {source_turn} already evicted); "
                    f"fidelity is unfalsifiable."
                )

    # Gate 3: detect silent reversion across epochs with no new source.
    latest = summary_epochs[-1]["claims"]
    prior = summary_epochs[-2]["claims"] if len(summary_epochs) > 1 else {}
    for key, (value, source_turn) in latest.items():
        if key in prior and prior[key][0] != value and source_turn <= prior[key][1]:
            raise SummaryFidelityError(
                f"Compaction blocked: silent reversion on {key!r} "
                f"({prior[key][0]!r} -> {value!r}) with no newer source turn."
            )

    if not audit_verdict.get("passed", False):
        raise SummaryFidelityError(
            f"Compaction blocked: audit failed: {audit_verdict.get('reason')}"
        )

    return "compact"
