# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/where-must-an-instance-diverge-from-a-shared-conformance-oracle-when-mcp-a2a-and-aaif-capability-matrices-overlap.md
# Remnant Warrant:    https://corpusfetch.com/c/where-must-an-instance-diverge-from-a-shared-conformance-oracle-when-mcp-a2a-and-aaif-capability-matrices-overlap.warrant.json
# Markdown SHA-256:   ecce3e11e9817bc84fcf9e8148a67e620a49c5bc27dae418041ccd7c6bd11aa8
# Code AST SHA-256:   122a7c057a00ee51df7f8592d2719762429738f3fbae89e2962c4a00663d4377
# Verified Classes:   MatrixConformanceError
# Defensive Guards:   5 fail-closed invariants (zero external deps)

class MatrixConformanceError(RuntimeError):
    """Raised when an instance cannot be soundly certified against the
    MCP/A2A/AAIF interoperability matrix."""


SHARED_REGISTRIES = {"session_store", "identity_issuer", "event_bus", "error_normalizer"}


def certify_matrix(instance) -> bool:
    # 1. Capability isolation invariant: no capability may mutate another
    #    protocol's observable surface without a declared cross-effect.
    for cap in instance.advertised_capabilities:
        if cap.cross_protocol_effect and not cap.isolation_declared:
            raise MatrixConformanceError(
                f"capability {cap.name!r} under {cap.protocol} mutates "
                f"{cap.cross_protocol_effect} without isolation declaration"
            )

    # 2. Identity disjointness: shared identifiers across protocols are a
    #    conformance hazard, not an optimization.
    ids = instance.identifier_namespaces
    if not ids.is_disjoint():
        raise MatrixConformanceError(
            f"identifier namespaces overlap across protocols: {ids.overlaps()}"
        )

    # 3. Deterministic replay: without a recorded total order, a green run
    #    is not evidence.
    if not instance.has_recorded_total_order():
        raise MatrixConformanceError(
            "no recorded interleaving; matrix verdict cannot be computed"
        )

    # 4. Error taxonomy stability: no protocol may remap another's errors.
    for proto, handler in instance.error_handlers.items():
        if handler.remaps_foreign_errors:
            raise MatrixConformanceError(
                f"error handler for {proto} remaps foreign protocol errors"
            )

    # 5. Shared registries require the lifted oracle; if the lift is absent,
    #    fail closed rather than emit a marginal-product green.
    if instance.active_registries & SHARED_REGISTRIES:
        if not instance.has_lifted_oracle():
            raise MatrixConformanceError(
                "shared registries present but no lifted matrix oracle; "
                "refusing to certify on marginals"
            )

    return instance.lifted_oracle.evaluate()
