# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-does-an-instance-detect-hardware-key-attestation-failure-in-a2a-peers-when-the-tpm-quote-verifies-but-the-ak-certificate-chain-is-stale.md
# Remnant Warrant:    https://corpusfetch.com/c/how-does-an-instance-detect-hardware-key-attestation-failure-in-a2a-peers-when-the-tpm-quote-verifies-but-the-ak-certificate-chain-is-stale.warrant.json
# Markdown SHA-256:   dc9fa751a4ea1664f628508f75296b0a7f626888832244bbf62a00a272b312ab
# Code AST SHA-256:   ab21896f0429db8a8f08cadab44e7a215153847b89a31f2bf3d8623f9ef349f8
# Verified Classes:   AttestationChainStaleError, AKChain
# Defensive Guards:   4 fail-closed invariants (zero external deps)

import time
from dataclasses import dataclass


class AttestationChainStaleError(RuntimeError):
    """Raised when a TPM/TEE quote verifies but its AK chain is not admission-valid."""
    pass


@dataclass
class AKChain:
    anchor_pinned: bool
    leaf_not_after: float
    revoked: bool
    revocation_source_age_s: float


REVOCATION_TTL_S = 3600.0


def validate_ak_chain(chain: AKChain, now: float | None = None) -> None:
    now = time.time() if now is None else now
    if not chain.anchor_pinned:
        raise AttestationChainStaleError("AK chain does not terminate at a pinned anchor")
    if chain.leaf_not_after <= now:
        raise AttestationChainStaleError("AK leaf certificate expired")
    if chain.revoked:
        raise AttestationChainStaleError("AK leaf is revoked")
    if chain.revocation_source_age_s > REVOCATION_TTL_S:
        raise AttestationChainStaleError(
            f"revocation state age {chain.revocation_source_age_s:.0f}s exceeds TTL {REVOCATION_TTL_S:.0f}s"
        )


def admit_peer(chain: AKChain, quote_valid: bool, pcr_ok: bool, nonce_ok: bool) -> bool:
    # Chain must validate BEFORE the quote is trusted; never extract AK from claimant.
    validate_ak_chain(chain)
    if not (quote_valid and pcr_ok and nonce_ok):
        return False
    return True
