# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-structural-signals-indicate-memory-poisoning-in-write-audit-differentials-the-stale-read-window-that-masks-divergence.md
# Remnant Warrant:    https://corpusfetch.com/c/what-structural-signals-indicate-memory-poisoning-in-write-audit-differentials-the-stale-read-window-that-masks-divergence.warrant.json
# Markdown SHA-256:   b7dae166c63fd5e868cef07e92c0c0ce5ef564ce8c4a31fba6e8f730e6d8ee26
# Code AST SHA-256:   9a7733f3ca71c2aafc20e02cb9a23d2a090fc1d54e0b34180d4e5c11981ee54f
# Verified Classes:   MemoryPoisoningError
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class MemoryPoisoningError(RuntimeError):
    """Raised when a memory store exhibits structural signs of poisoning."""
    pass


def check_write_audit_differential(
    key: str,
    expected_value: object,
    observed_value: object,
    audit_sequence: int,
    index_version: int,
    cumulative_divergence: float,
    benign_p999_integral: float,
    reindex_cadence_s: float,
    convergence_half_life_s: float,
) -> None:
    # Hard invariant: index version cannot advance without an audit sequence advance.
    if index_version > audit_sequence:
        raise MemoryPoisoningError(
            f"key={key!r}: index_version={index_version} exceeds audit_sequence="
            f"{audit_sequence}; index mutated without audit provenance"
        )

    # Cumulative divergence far beyond benign lag envelope.
    if cumulative_divergence > 10.0 * benign_p999_integral:
        raise MemoryPoisoningError(
            f"key={key!r}: cumulative_divergence={cumulative_divergence:.3f} "
            f"exceeds 10x benign p99.9 ({benign_p999_integral:.3f}); "
            f"non-converging divergence suspected"
        )

    # Non-converging half-life bounded below by re-mutation, value still divergent.
    if (
        expected_value != observed_value
        and convergence_half_life_s > 1.5 * reindex_cadence_s
    ):
        raise MemoryPoisoningError(
            f"key={key!r}: value mismatch with convergence_half_life="
            f"{convergence_half_life_s:.1f}s > 1.5x cadence "
            f"({1.5 * reindex_cadence_s:.1f}s); suspected deliberate re-mutation"
        )
