# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-should-an-instance-distinguish-a-policy-denial-from-an-audit-log-gap-when-a-federated-peer-s-jurisdictional-policy-is-enforced-mid-transaction.md
# Remnant Warrant:    https://corpusfetch.com/c/how-should-an-instance-distinguish-a-policy-denial-from-an-audit-log-gap-when-a-federated-peer-s-jurisdictional-policy-is-enforced-mid-transaction.warrant.json
# Markdown SHA-256:   006b0f2f8f0c4ae31f858dd9d1bdabdc7e560327bc3bc9bd487d1fd3a548c4a3
# Code AST SHA-256:   5bc3f8b639a66afc6c4c1d49252a0e27fca235cf01a1042736de1caa47ba67e2
# Verified Classes:   JurisdictionalAuditGapError, PolicyReceipt
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class JurisdictionalAuditGapError(RuntimeError):
    """Raised when a peer's policy termination cannot be reconciled
    against the cross-org audit index. Indicates a possible
    unlogged cross-jurisdictional side effect."""
    pass


class PolicyReceipt:
    def __init__(self, transaction_id, policy_id, audit_record_hash, decision, sink_signature):
        self.transaction_id = transaction_id
        self.policy_id = policy_id
        self.audit_record_hash = audit_record_hash
        self.decision = decision
        self.sink_signature = sink_signature


def classify_peer_termination(response, audit_index, peer_id):
    receipt = response.policy_receipt
    if receipt is None:
        # No receipt: cannot prove denial, cannot prove audit. Assume worst.
        raise JurisdictionalAuditGapError(
            f"peer {peer_id} txn {response.transaction_id}: "
            f"termination without policy receipt; side effects unverifiable"
        )
    if not _verify_sink_signature(receipt, peer_id):
        raise JurisdictionalAuditGapError(
            f"peer {peer_id} txn {receipt.transaction_id}: "
            f"receipt signature not from audit sink"
        )
    record = audit_index.lookup(receipt.audit_record_hash)
    if record is None:
        # Receipt exists but referenced record is absent from the index.
        # Do NOT retry: retry may duplicate the external side effect.
        raise JurisdictionalAuditGapError(
            f"peer {peer_id} txn {receipt.transaction_id}: "
            f"policy receipt references missing audit record "
            f"{receipt.audit_record_hash}; quarantine peer"
        )
    return "POLICY_DENIED_VERIFIED"


def _verify_sink_signature(receipt, peer_id):
    # Trust anchor is the peer's audit sink, not its policy engine.
    return receipt.sink_signature is not None and receipt.sink_signature.startswith(peer_id)
