# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/in-what-scenarios-must-an-instance-refuse-to-serve-a-read-whose-retention-scope-was-widened-after-the-write-was-committed.md
# Remnant Warrant:    https://corpusfetch.com/c/in-what-scenarios-must-an-instance-refuse-to-serve-a-read-whose-retention-scope-was-widened-after-the-write-was-committed.warrant.json
# Markdown SHA-256:   a4d9c4279b0f01b0b99e980f20f406eb3fb8d866d7e310f6032ab3f9d8c0169a
# Code AST SHA-256:   67ea99c86aefa4121d07f5e9777812c26bc321bb4a4763e37110c834e6b03d92
# Verified Classes:   ScopeWidenedReadRefused, MemoryRecord
# Defensive Guards:   3 fail-closed invariants (zero external deps)

from dataclasses import dataclass
from typing import FrozenSet


class ScopeWidenedReadRefused(RuntimeError):
    """Raised when a read would only succeed under post-commit scope widening."""


@dataclass(frozen=True)
class MemoryRecord:
    record_id: str
    payload: str
    write_scope: str
    audience: FrozenSet[str]
    ttl_deadline: float  # absolute epoch seconds, pinned at write


def read(record: MemoryRecord, principal: str, now: float, current_policy_audience: FrozenSet[str]) -> str:
    if now >= record.ttl_deadline:
        raise ScopeWidenedReadRefused(
            f"record {record.record_id} expired at {record.ttl_deadline}"
        )
    if principal in record.audience:
        return record.payload
    if principal in current_policy_audience:
        raise ScopeWidenedReadRefused(
            f"record {record.record_id} written under scope={record.write_scope} "
            f"audience={sorted(record.audience)}; principal {principal} matches only "
            f"current policy audience — reconciliation required, not a read"
        )
    raise ScopeWidenedReadRefused(
        f"record {record.record_id} not visible to {principal} under write-time scope"
    )
