# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/where-must-an-instance-of-a-deleted-memory-be-proven-absent-before-forget-compliance-can-be-attested.md
# Remnant Warrant:    https://corpusfetch.com/c/where-must-an-instance-of-a-deleted-memory-be-proven-absent-before-forget-compliance-can-be-attested.warrant.json
# Markdown SHA-256:   855280b925e5adc5d3b64b223e06cf4a17c653407c280cef361d38911e02679d
# Code AST SHA-256:   02e8ef76e3683b1f5c565259935461d977c8664b80398caedcd35f20d33d0c44
# Verified Classes:   ForgetComplianceError, Invertibility, Media, Derivation, ClosureAttestation
# Defensive Guards:   4 fail-closed invariants (zero external deps)

from __future__ import annotations

from dataclasses import dataclass, field
from enum import Enum


class ForgetComplianceError(RuntimeError):
    """Raised when a forget request cannot be attested under the closure invariant."""


class Invertibility(Enum):
    HIGH = "high"      # verbatim embeddings, unredacted summaries, KV blocks
    LOW = "low"        # aggregates, hashed ids, dedup counts


class Media(Enum):
    PRIMARY = "primary"
    WAL = "wal"
    ANN_INDEX = "ann_index"
    KV_CACHE = "kv_cache"
    SUMMARY = "summary"


@dataclass(frozen=True)
class Derivation:
    media: Media
    invertibility: Invertibility
    present: bool
    expiry_bounded: bool = False


@dataclass
class ClosureAttestation:
    record_id: str
    derivations: list[Derivation] = field(default_factory=list)
    blocking: bool = False


def attest_forget(record_id: str, derivations: list[Derivation]) -> ClosureAttestation:
    """
    Build a closure attestation. Blocking is required iff any HIGH-invertibility
    derivation is still present and not bounded by a monitored retention expiry.
    """
    if not derivations:
        raise ForgetComplianceError(
            f"record {record_id!r}: empty derivation set; cannot distinguish "
            f"'no derivations' from 'derivation graph not enumerated'"
        )

    att = ClosureAttestation(record_id=record_id, derivations=list(derivations))

    for d in derivations:
        if d.present and d.invertibility is Invertibility.HIGH:
            if not d.expiry_bounded:
                # WAL segment not yet rotated, live ANN entry, unredacted summary.
                att.blocking = True
                raise ForgetComplianceError(
                    f"record {record_id!r}: HIGH-invertibility derivation present "
                    f"in {d.media.value} with no bounded expiry; "
                    f"forget cannot be attested until compaction completes"
                )
            # Present but under a monitored, bounded retention policy.
            # Attestation must record this as deferred, not as deleted.
            att.blocking = True

    return att


def assert_attestable(att: ClosureAttestation) -> None:
    if att.blocking:
        raise ForgetComplianceError(
            f"record {att.record_id!r}: attestation is deferred, not final; "
            f"do not emit a boolean 'deleted' claim"
        )
    for d in att.derivations:
        if d.present and not d.expiry_bounded:
            raise ForgetComplianceError(
                f"record {att.record_id!r}: {d.media.value} still present, "
                f"unbounded; closure invariant violated"
            )
