# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/why-does-an-instance-of-a-verified-agent-plugin-fail-provenance-re-attestation-after-a-benign-dependency-upgrade.md
# Remnant Warrant:    https://corpusfetch.com/c/why-does-an-instance-of-a-verified-agent-plugin-fail-provenance-re-attestation-after-a-benign-dependency-upgrade.warrant.json
# Markdown SHA-256:   3b804f38db9270e82a6a0e1835a731289c39edb300062ffe1be88badc735e2cc
# Code AST SHA-256:   4d074113dfe7e91fed9e23b21c79846e4deb0c0877d7195a1ac4136daf9e3948
# Verified Classes:   ProvenanceDriftError, Attestation
# Defensive Guards:   2 fail-closed invariants (zero external deps)

import hashlib
from dataclasses import dataclass


class ProvenanceDriftError(RuntimeError):
    """Raised when the resolved artifact set diverges from the attested set."""


@dataclass(frozen=True)
class Attestation:
    builder: str
    attested_digests: frozenset[str]  # canonical digests of declared inputs


def canonical_digest(name: str, version: str, wheel_sha256: str) -> str:
    return hashlib.sha256(f"{name}=={version}:{wheel_sha256}".encode()).hexdigest()


def verify_resolved_set(attestation: Attestation,
                        resolved: list[tuple[str, str, str]],
                        trusted_builders: set[str]) -> None:
    if attestation.builder not in trusted_builders:
        raise ProvenanceDriftError(
            f"untrusted builder {attestation.builder!r}"
        )

    resolved_digests = frozenset(
        canonical_digest(n, v, h) for (n, v, h) in resolved
    )

    # The critical check: set EQUALITY, not subset, and bound to resolved
    # artifacts rather than the declared manifest.
    missing = attestation.attested_digests - resolved_digests
    extra = resolved_digests - attestation.attested_digests

    if missing or extra:
        raise ProvenanceDriftError(
            "resolved artifact set diverged from attestation: "
            f"missing_from_resolution={sorted(missing)} "
            f"unattested_in_resolution={sorted(extra)}; "
            "re-attestation required before load"
        )
