# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/why-does-an-instance-lose-the-summarization-invariant-at-the-compaction-horizon-boundary.md
# Remnant Warrant:    https://corpusfetch.com/c/why-does-an-instance-lose-the-summarization-invariant-at-the-compaction-horizon-boundary.warrant.json
# Markdown SHA-256:   3491614656133c1786f2571f62cd94b583b36ef4e3dfacdc64a39f98c7400216
# Code AST SHA-256:   f0dbcff1c4e5a3ea222b9ee937bb302af2f18dccc8683fe8ac40004978ad8255
# Verified Classes:   SummaryInvariantViolation
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class SummaryInvariantViolation(RuntimeError):
    """Raised when a compaction generation would evict a fact below its redundancy floor."""
    pass


REDUNDANCY_FLOOR = 3.0  # tokens of representation per atomic fact


def compact(history_tokens: int, summary_tokens: int, fact_count: int,
            generation: int) -> int:
    """
    Decide whether re-summarizing the current summary is safe.
    Returns the new generation index on success; raises on invariant breach.
    """
    if fact_count <= 0:
        raise SummaryInvariantViolation(
            f"gen {generation}: fact ledger empty; cannot verify recoverability"
        )

    redundancy = summary_tokens / fact_count
    if redundancy < REDUNDANCY_FLOOR:
        # Signature: summary shrinking while history grows means the next
        # summarizer has no slack and will spend the invariant.
        raise SummaryInvariantViolation(
            f"gen {generation}: redundancy {redundancy:.2f} < floor "
            f"{REDUNDANCY_FLOOR}; re-summarization would evict marginal facts. "
            f"Expand from source transcript instead of compressing the summary."
        )

    if summary_tokens >= history_tokens:
        raise SummaryInvariantViolation(
            f"gen {generation}: summary ({summary_tokens}) not smaller than "
            f"history ({history_tokens}); compaction is a no-op, check trigger."
        )

    return generation + 1
