# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/where-must-an-instance-reject-a-write-that-arrives-under-an-expired-retention-scope-before-it-can-be-forgotten.md
# Remnant Warrant:    https://corpusfetch.com/c/where-must-an-instance-reject-a-write-that-arrives-under-an-expired-retention-scope-before-it-can-be-forgotten.warrant.json
# Markdown SHA-256:   afe2b2ddfffc0bd601905dd8403684595a995e0550b0a70959ed75515e186e1c
# Code AST SHA-256:   d394bb9dcc58628413c13a001787239ad9d3bbb3d22ab2368ac11170cd524a75
# Verified Classes:   ScopeDischargedError, TombstonedObjectError
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class ScopeDischargedError(RuntimeError):
    """Raised when a write targets a scope whose forget sweep has completed."""
    pass


class TombstonedObjectError(RuntimeError):
    """Raised when a write replays an object already purged under a discharged scope."""
    pass


DISCHARGED = "DISCHARGED"
EXPIRING = "EXPIRING"
LIVE = "LIVE"


def admit_write(scope, write):
    if scope.state == DISCHARGED:
        if write.is_idempotent_replay_of_purged():
            raise TombstonedObjectError(
                f"object {write.object_id!r} was purged under discharged scope "
                f"{scope.id!r} at {scope.swept_at}; replay refused"
            )
        if write.has_valid_retention_override():
            return re_scope(write, write.retention_override)
        raise ScopeDischargedError(
            f"write to scope {scope.id!r} refused: sweep completed at "
            f"{scope.swept_at}, guarantee already discharged; post-sweep writes "
            f"are uncovered by the forgetting promise"
        )
    if scope.state == EXPIRING:
        # Dying but not dead: accept only if we can sweep inline before transition.
        return accept_and_sweep_inline(write, scope)
    if scope.state == LIVE:
        return store(write)
    raise ScopeDischargedError(f"unknown scope state {scope.state!r} for {scope.id!r}")
