# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/when-must-an-instance-refuse-a-brokered-capability-it-could-technically-execute-the-policy-provenance-gap-in-cross-org-federation.md
# Remnant Warrant:    https://corpusfetch.com/c/when-must-an-instance-refuse-a-brokered-capability-it-could-technically-execute-the-policy-provenance-gap-in-cross-org-federation.warrant.json
# Markdown SHA-256:   0fc89b95a77e9d87e97ccaa33722d2bdddaee6dba0fb5c73effaad310ce88b3e
# Code AST SHA-256:   b7365e53afa62cdb999f7f01b54c92a5fb4d70efb85e79371b86a55672ff9933
# Verified Classes:   PolicyProvenanceError
# Defensive Guards:   5 fail-closed invariants (zero external deps)

class PolicyProvenanceError(RuntimeError):
    """Raised when a brokered capability is technically executable but its
    governing policy is not currently evaluable/authoritative in the local
    trust domain. Refusal, not warning: the side effect must not occur."""
    pass


def authorize_brokered_execution(
    token,
    local_policy_store,
    local_dialect_version,
    federation_contract,
    task_side_effect_class,
):
    # 1. Cryptographic validity is necessary but never sufficient.
    if not token.signature_valid():
        raise PolicyProvenanceError("token signature invalid")

    # 2. The policy the token *references* must be locally evaluable.
    policy = local_policy_store.resolve(token.policy_ref)
    if policy is None:
        raise PolicyProvenanceError(
            f"policy {token.policy_ref} not resolvable in local domain"
        )

    # 3. Provenance continuity: is the pinned policy still authoritative?
    pinning_ok = federation_contract.permits_point_in_time_pinning(
        data_class=policy.data_class,
        side_effect_class=task_side_effect_class,
    )
    if policy.is_superseded() and not pinning_ok:
        raise PolicyProvenanceError(
            f"policy {token.policy_ref} superseded by {policy.successor_id}; "
            f"pinning not permitted for side-effect class "
            f"{task_side_effect_class!r}"
        )

    # 4. Dialect pinning: every attenuated constraint must resolve identically.
    for constraint in token.constraints:
        if constraint.namespace_version != local_dialect_version:
            raise PolicyProvenanceError(
                f"constraint {constraint.name!r} pinned to dialect "
                f"{constraint.namespace_version}, local evaluator is "
                f"{local_dialect_version}; unresolvable constraints deny"
            )

    # 5. Revocation staleness bound for irreversible effects.
    if task_side_effect_class == "irreversible":
        age = local_policy_store.revocation_state_age()
        if age > federation_contract.max_staleness:
            raise PolicyProvenanceError(
                f"revocation state stale ({age}s > "
                f"{federation_contract.max_staleness}s); re-negotiate"
            )

    return policy.evaluate(token.subject, token.action)
