# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-does-an-instance-detect-revocation-of-a-peer-agent-identity-when-the-aaif-trust-registry-partition-heals-after-a-split-brain-window.md
# Remnant Warrant:    https://corpusfetch.com/c/how-does-an-instance-detect-revocation-of-a-peer-agent-identity-when-the-aaif-trust-registry-partition-heals-after-a-split-brain-window.warrant.json
# Markdown SHA-256:   124e98e686651c0ff4db97bd85fb599882441ab9027a9a615f9c47f7ed713ed9
# Code AST SHA-256:   35652182d4c84f9193db9e7212daf2d231ba253eebf06d24cd7b2ec14b1fcc47
# Verified Classes:   RevocationLineageError, PeerAssertion, MergeManifest
# Defensive Guards:   2 fail-closed invariants (zero external deps)

from dataclasses import dataclass
from datetime import datetime


class RevocationLineageError(RuntimeError):
    """Raised when a peer assertion cannot be causally tied to the last
    observed revocation for its key lineage across a healed partition."""


@dataclass(frozen=True)
class PeerAssertion:
    agent_id: str
    key_id: str
    issued_at: datetime


@dataclass(frozen=True)
class MergeManifest:
    partition_start: datetime
    healed_at: datetime
    cross_partition_quorum: bool


def admit_peer(
    assertion: PeerAssertion,
    held_key_pre_partition: str,
    revoked_keys: set[str],
    manifest: MergeManifest,
) -> bool:
    if assertion.key_id in revoked_keys:
        raise RevocationLineageError(
            f"key {assertion.key_id} for {assertion.agent_id} is revoked"
        )

    straddles_heal = (
        manifest.partition_start <= assertion.issued_at <= manifest.healed_at
    )
    rotated = assertion.key_id != held_key_pre_partition

    if straddles_heal and rotated:
        if not manifest.cross_partition_quorum:
            raise RevocationLineageError(
                f"assertion for {assertion.agent_id} key {assertion.key_id} "
                f"minted during partition [{manifest.partition_start}.."
                f"{manifest.healed_at}] under rotated key, and merge manifest "
                f"lacks cross-partition quorum; lineage replay required"
            )
        # Quorum-signed manifest: provisional admission only.
        return False  # caller must replay lineage before mutating ops

    return True
