# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-structural-signals-indicate-skill-injection-detection-via-tool-manifest-signing-and-capability-diffing.md
# Remnant Warrant:    https://corpusfetch.com/c/what-structural-signals-indicate-skill-injection-detection-via-tool-manifest-signing-and-capability-diffing.warrant.json
# Markdown SHA-256:   e4bdad42c3142d28507477acde2a16b53d50ea132deb9e33c7e80ed658fb3844
# Code AST SHA-256:   3671287810a3bc54ec2c3241df42c3b52286fda7287bc99244d52da3e88e46b0
# Verified Classes:   IndeterminateCapabilityDelta, Capability
# Defensive Guards:   2 fail-closed invariants (zero external deps)

import hashlib
from dataclasses import dataclass


class IndeterminateCapabilityDelta(RuntimeError):
    """Raised when a capability diff cannot establish safety.

    An empty label delta over a label-addressed manifest is not evidence
    of safety; it is evidence the differ compared the wrong thing.
    """
    pass


@dataclass(frozen=True)
class Capability:
    label: str
    impl_digest: str | None  # None => label-addressed manifest


def diff_capabilities(baseline: list[Capability],
                      candidate: list[Capability]) -> str:
    """Return 'SAFE_NO_CHANGE', 'CHANGED', or raise on indeterminate schema."""
    if any(c.impl_digest is None for c in baseline + candidate):
        # Schema cannot distinguish an implementation swap under stable labels.
        # An empty label delta here is uninformative.
        raise IndeterminateCapabilityDelta(
            "label-addressed manifest: empty delta cannot certify safety; "
            "require per-capability impl_digest before gating on diff result"
        )

    base = {(c.label, c.impl_digest) for c in baseline}
    cand = {(c.label, c.impl_digest) for c in candidate}
    return "SAFE_NO_CHANGE" if base == cand else "CHANGED"


def gate_manifest_load(baseline: list[Capability],
                       candidate: list[Capability],
                       allow_manual_review: bool) -> str:
    try:
        verdict = diff_capabilities(baseline, candidate)
    except IndeterminateCapabilityDelta as exc:
        if not allow_manual_review:
            raise IndeterminateCapabilityDelta(
                f"cannot gate on indeterminate diff and review disabled: {exc}"
            ) from exc
        return "ROUTE_TO_REVIEW"
    return verdict
