# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-structural-signals-indicate-spiffe-trust-domain-drift-in-agent-to-agent-mutual-tls-before-handshake-failure.md
# Remnant Warrant:    https://corpusfetch.com/c/what-structural-signals-indicate-spiffe-trust-domain-drift-in-agent-to-agent-mutual-tls-before-handshake-failure.warrant.json
# Markdown SHA-256:   cab756a631b18fdffd3cb3586ec18188ccdd78e4db59effa7a2059fe71e0dbda
# Code AST SHA-256:   53d975f34f25f8d98b42980ac91b716405da591cd1b2ef393d4a3b09252f01c3
# Verified Classes:   TrustDomainDriftError, LoadedBundle, PeerSVID
# Defensive Guards:   2 fail-closed invariants (zero external deps)

class TrustDomainDriftError(RuntimeError):
    """Raised when a peer SVID verifies against a stale federated bundle,
    meaning the asserted SPIFFE ID may not correspond to the live
    registration entry on the peer's SPIRE server."""
    pass


class LoadedBundle:
    def __init__(self, fetched_at, ca_fingerprints, etag):
        self.fetched_at = fetched_at
        self.ca_fingerprints = set(ca_fingerprints)
        self.etag = etag


class PeerSVID:
    def __init__(self, spiffe_id, not_before, issuer_fingerprint, serial):
        self.spiffe_id = spiffe_id
        self.not_before = not_before
        self.issuer_fingerprint = issuer_fingerprint
        self.serial = serial


def assert_bundle_currency(peer: PeerSVID, loaded: LoadedBundle) -> None:
    """Gate peer admission on bundle currency, not chain validity alone."""
    if peer.not_before > loaded.fetched_at:
        raise TrustDomainDriftError(
            f"peer SVID {peer.spiffe_id} (serial {peer.serial}) has NotBefore "
            f"{peer.not_before} which postdates loaded bundle fetch "
            f"{loaded.fetched_at} (etag {loaded.etag}); chain may verify "
            f"against a superseded CA. Force synchronous bundle refresh "
            f"before admitting."
        )
    if peer.issuer_fingerprint not in loaded.ca_fingerprints:
        raise TrustDomainDriftError(
            f"peer SVID {peer.spiffe_id} issuer {peer.issuer_fingerprint} "
            f"absent from loaded bundle CA set {sorted(loaded.ca_fingerprints)}; "
            f"verification would rely on on-disk bundle not yet ingested."
        )


def admit_peer(peer: PeerSVID, loaded: LoadedBundle) -> bool:
    assert_bundle_currency(peer, loaded)
    return True
