# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/in-what-scenarios-must-an-instance-treat-forget-memory-compliance-hooks-as-non-atomic-with-respect-to-right-to-erasure-propagation.md
# Remnant Warrant:    https://corpusfetch.com/c/in-what-scenarios-must-an-instance-treat-forget-memory-compliance-hooks-as-non-atomic-with-respect-to-right-to-erasure-propagation.warrant.json
# Markdown SHA-256:   e874111cb417b1b4c69d787fb8eb69c8c6288515c44ee9b22250d567a035a119
# Code AST SHA-256:   2ea35b66ad886e06313ffc25b24ac6c6a56a1d6711292f18130452f1c835465f
# Verified Classes:   ErasureConvergenceError, Artifact, ErasureTicket
# Defensive Guards:   3 fail-closed invariants (zero external deps)

import time
from dataclasses import dataclass, field
from typing import Callable


class ErasureConvergenceError(RuntimeError):
    """Raised when a forget-memory hook cannot prove erasure convergence within T."""
    pass


@dataclass
class Artifact:
    name: str
    apply_and_confirm: Callable[[str], bool]  # subject_id -> confirmed applied
    convergence_seconds: float


@dataclass
class ErasureTicket:
    subject_id: str
    deadline_seconds: float
    artifacts: list[Artifact] = field(default_factory=list)
    confirmed: set[str] = field(default_factory=set)


def execute_forget_hook(ticket: ErasureTicket) -> None:
    """
    Event-shaped hook over a convergence-shaped obligation.
    Success is returned only when every registered artifact confirms
    application within the deadline; otherwise a hard exception is raised.
    """
    if not ticket.artifacts:
        raise ErasureConvergenceError(
            f"no artifacts registered for subject {ticket.subject_id!r}; "
            "erasure scope is unenumerated and cannot be proven"
        )

    start = time.monotonic()
    for art in ticket.artifacts:
        if art.convergence_seconds > ticket.deadline_seconds:
            raise ErasureConvergenceError(
                f"artifact {art.name!r} convergence {art.convergence_seconds}s "
                f"exceeds deadline {ticket.deadline_seconds}s; "
                "deletion alone cannot satisfy obligation (need purge-on-demand "
                "or crypto-shredding)"
            )
        if art.apply_and_confirm(ticket.subject_id):
            ticket.confirmed.add(art.name)

    elapsed = time.monotonic() - start
    missing = {a.name for a in ticket.artifacts} - ticket.confirmed
    if missing:
        raise ErasureConvergenceError(
            f"erasure for {ticket.subject_id!r} did not converge within "
            f"{ticket.deadline_seconds}s; unconfirmed artifacts: {sorted(missing)}; "
            f"elapsed={elapsed:.2f}s"
        )
