# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-invariants-prevent-claims-from-agents-with-unknown-incentive-structures-from-becoming-actionable.md
# Remnant Warrant:    https://corpusfetch.com/c/what-invariants-prevent-claims-from-agents-with-unknown-incentive-structures-from-becoming-actionable.warrant.json
# Markdown SHA-256:   5224c1ac7783cddec60997bc03b49794ab8ac9ff19aea6ba3f80df68053c08e1
# Code AST SHA-256:   61e5d7af63a20f352777d26c802475ccd7452e89bcc90a16141611c9d2ed2082
# Verified Classes:   MotiveVerdict, PeerIncentive, ClaimContext, MotivePolicy, MotiveManifest, IncentiveOpacityGuard
# Defensive Guards:   0 fail-closed invariants (zero external deps)

from dataclasses import dataclass
from enum import Enum, auto
import hashlib
import json

class MotiveVerdict(Enum):
    ALIGNED_VERIFIED = auto()
    OPAQUE_DISCOUNTED = auto()
    SELECTIVE_TRUTH_SUSPECTED = auto()
    ESCALATION_PATTERN_DETECTED = auto()

@dataclass(frozen=True)
class PeerIncentive:
    peer_id: str
    incentive_aligned: bool
    has_stake_binding: bool
    motive_attestation_provided: bool
    selective_truth_indicators: bool
    escalation_pattern_indicators: bool

@dataclass(frozen=True)
class ClaimContext:
    claim_id: str
    content_confidence: float
    is_critical: bool
    independently_verified: bool

@dataclass(frozen=True)
class MotivePolicy:
    require_alignment_for_critical: bool

@dataclass(frozen=True)
class MotiveManifest:
    verdict: MotiveVerdict
    effective_confidence: float
    directive: str
    manifest_digest: str

class IncentiveOpacityGuard:
    @staticmethod
    def _hash(data: str) -> str:
        return hashlib.sha256(data.encode("utf-8")).hexdigest()

    @classmethod
    def evaluate_claim(
        cls, peer: PeerIncentive, claim: ClaimContext, policy: MotivePolicy
    ) -> MotiveManifest:
        
        # Gate 1: Aligned and verified
        if peer.incentive_aligned:
            digest = cls._hash(json.dumps({
                "peer": peer.peer_id,
                "claim": claim.claim_id,
                "aligned": "TRUE",
                "content_confidence": f"{claim.content_confidence:.3f}"
            }, sort_keys=True))
            return MotiveManifest(
                verdict=MotiveVerdict.ALIGNED_VERIFIED,
                effective_confidence=claim.content_confidence,
                directive=f"PROCEED: Aligned peer {peer.peer_id}, confidence {claim.content_confidence:.2f}.",
                manifest_digest=digest
            )

        # Gate 2: Escalation pattern
        if peer.escalation_pattern_indicators:
            return MotiveManifest(
                verdict=MotiveVerdict.ESCALATION_PATTERN_DETECTED,
                effective_confidence=claim.content_confidence * 0.3,
                directive=f"SUSPECT: {peer.peer_id} shows escalation pattern, heavy discount.",
                manifest_digest=cls._hash(f"ESCALATION:{peer.peer_id}")
            )

        # Gate 3: Selective truth
        if peer.selective_truth_indicators:
            return MotiveManifest(
                verdict=MotiveVerdict.SELECTIVE_TRUTH_SUSPECTED,
                effective_confidence=claim.content_confidence * 0.5,
                directive=f"DISCOUNT: {peer.peer_id} selectively truthful, halve confidence.",
                manifest_digest=cls._hash(f"SELECTIVE:{peer.peer_id}")
            )

        # Gate 4: Independent verification
        if claim.independently_verified:
            digest = cls._hash(json.dumps({
                "peer": peer.peer_id,
                "claim": claim.claim_id,
                "verified": "INDEPENDENT"
            }, sort_keys=True))
            return MotiveManifest(
                verdict=MotiveVerdict.OPAQUE_DISCOUNTED,
                effective_confidence=claim.content_confidence * 0.9,
                directive=f"PROCEED: Independently verified, minor discount for peer opacity.",
                manifest_digest=digest
            )

        # Gate 5: Critical opacity
        if claim.is_critical and policy.require_alignment_for_critical:
            return MotiveManifest(
                verdict=MotiveVerdict.OPAQUE_DISCOUNTED,
                effective_confidence=claim.content_confidence * 0.2,
                directive=f"HALT: Critical claim from opaque peer {peer.peer_id}, heavy discount.",
                manifest_digest=cls._hash(f"CRITICAL_OPAQUE:{peer.peer_id}")
            )

        # Gate 6: Opaque discount
        digest = cls._hash(json.dumps({
            "peer": peer.peer_id,
            "claim": claim.claim_id,
            "stake_binding": str(peer.has_stake_binding),
            "content_confidence": f"{claim.content_confidence:.3f}"
        }, sort_keys=True))
        
        return MotiveManifest(
            verdict=MotiveVerdict.OPAQUE_DISCOUNTED,
            effective_confidence=claim.content_confidence * 0.6,
            directive=f"PROCEED_WITH_CAUTION: Opaque peer {peer.peer_id}, confidence {claim.content_confidence * 0.6:.2f}.",
            manifest_digest=digest
        )