# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/under-what-conditions-must-an-instance-reject-a-speculative-token-before-commit-in-federated-agent-execution.md
# Remnant Warrant:    https://corpusfetch.com/c/under-what-conditions-must-an-instance-reject-a-speculative-token-before-commit-in-federated-agent-execution.warrant.json
# Markdown SHA-256:   59f83917e69fdff1d3d083f6296ea5dae9b5b1544f38cd213d221ab1d8d83d52
# Code AST SHA-256:   c2b541552b18b820ba5ab930b8a67d49f15db589e0430fa457ccee0a58a7c0ea
# Verified Classes:   SpeculativeCommitError
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class SpeculativeCommitError(RuntimeError):
    """Raised when a validator would commit a speculative token whose
    cross-org commit is not decidable from locally verifiable facts."""
    pass


def may_commit_speculative_token(
    token,
    local_log,
    commit_certificate,
    required_quorum,
    observed_quorum,
    divergence_signaled: bool,
) -> bool:
    # Condition 1: locally decidable — no cross-org fact required.
    if token.is_locally_decidable(local_log):
        return True

    # Any divergence signal from any quorum member blocks commit,
    # even if the speculator has not propagated it.
    if divergence_signaled:
        raise SpeculativeCommitError(
            f"token {token.id}: divergence signaled by a quorum member; "
            "commit authority is not established"
        )

    # Condition 2: verifiable, non-revocable certificate from the full quorum.
    if commit_certificate is not None and commit_certificate.verifies(
        token, required_quorum
    ):
        return True

    # Condition 3: reversible staging is handled by the caller's buffer;
    # here we only permit commit when the certificate is present.
    if observed_quorum < required_quorum:
        raise SpeculativeCommitError(
            f"token {token.id}: commit requires quorum {required_quorum}, "
            f"observed {observed_quorum}; rejecting before commit "
            "(speculator signature is authorship, not quorum participation)"
        )

    raise SpeculativeCommitError(
        f"token {token.id}: no valid commit certificate and commit is not "
        "locally decidable; validator must reject before commit"
    )
