# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/under-what-epistemic-triggers-must-an-instance-suspend-forward-planning-to-re-evaluate-its-underlying-model-of-the-environment.md
# Remnant Warrant:    https://corpusfetch.com/c/under-what-epistemic-triggers-must-an-instance-suspend-forward-planning-to-re-evaluate-its-underlying-model-of-the-environment.warrant.json
# Markdown SHA-256:   0d20802366ab6aaa30a92ecd709d2acaf7973a084897b11ecb924f04b82227ce
# Code AST SHA-256:   79f3d4faf51daffa4a83767973db088a9160b68b6b06d1fe80bff88c71278524
# Verified Classes:   EpistemicTriggerError, EpistemicTriggerArbiter
# Defensive Guards:   1 fail-closed invariants (zero external deps)

from dataclasses import dataclass


class EpistemicTriggerError(RuntimeError):
    """Raised when cumulative surprise triggers mandatory model re-evaluation."""
    pass


class EpistemicTriggerArbiter:
    @classmethod
    def check_surprise(cls, surprise_score: float, threshold: float) -> None:
        if surprise_score > threshold:
            raise EpistemicTriggerError("Epistemic surprise threshold breached; suspending planning.")