# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/under-what-conditions-must-an-instance-defer-quorum-derived-action-commitment-when-the-commitment-certificate-s-witness-set-is-intersection-valid-but.md
# Remnant Warrant:    https://corpusfetch.com/c/under-what-conditions-must-an-instance-defer-quorum-derived-action-commitment-when-the-commitment-certificate-s-witness-set-is-intersection-valid-but.warrant.json
# Markdown SHA-256:   3fc753178504f41feddc874a65c44f00ff6a70d054255405cd52050efaa5f949
# Code AST SHA-256:   c002aba348223985ba12b6b3e342f4766155f4332bc94d7679a1eca8902c782a
# Verified Classes:   StaleCommitmentError, Witness, QuorumCertificate
# Defensive Guards:   3 fail-closed invariants (zero external deps)

from dataclasses import dataclass
from typing import FrozenSet


class StaleCommitmentError(RuntimeError):
    """Raised when an intersection-valid QC fails the causal-currency check."""


@dataclass(frozen=True)
class Witness:
    node_id: str
    committed_view: int  # highest view this witness had acknowledged at signing time


@dataclass(frozen=True)
class QuorumCertificate:
    action_hash: str
    view: int
    witnesses: FrozenSet[Witness]


def commit_action(
    qc: QuorumCertificate,
    threshold: int,
    max_committed_view: int,
    delta: int,
) -> str:
    if len(qc.witnesses) < threshold:
        raise StaleCommitmentError(
            f"QC for {qc.action_hash} has {len(qc.witnesses)} witnesses, "
            f"below threshold {threshold}"
        )

    # Condition 3: causal currency. Intersection validity alone is insufficient.
    if qc.view <= max_committed_view:
        raise StaleCommitmentError(
            f"QC view {qc.view} is not newer than executor's committed view "
            f"{max_committed_view}; deferring to consensus log ordering"
        )

    stale = [w for w in qc.witnesses if w.committed_view < qc.view - delta]
    if stale:
        raise StaleCommitmentError(
            f"QC for {qc.action_hash} at view {qc.view} has causally stale "
            f"witnesses {[w.node_id for w in stale]}; quarantine and re-order"
        )

    return qc.action_hash
