# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/in-what-scenarios-must-an-instance-treat-lossy-summarization-checkpoints-as-non-invertible-for-causal-replay.md
# Remnant Warrant:    https://corpusfetch.com/c/in-what-scenarios-must-an-instance-treat-lossy-summarization-checkpoints-as-non-invertible-for-causal-replay.warrant.json
# Markdown SHA-256:   3a9b9ba36790c38e717a1e12fbed0e2c2aec3f6fb54398b27132e7ed22c393ca
# Code AST SHA-256:   5eca3254c57e4acd8f52223d2de0e4f6376a5845b0455cfed20fe51c585ea150
# Verified Classes:   CheckpointFidelityError, Checkpoint
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class CheckpointFidelityError(RuntimeError):
    """Raised when a lossy (semantic) checkpoint is used as a causal replay base."""
    pass


class Checkpoint:
    def __init__(self, checkpoint_id: str, fidelity: str, raw_stream_ref: str | None):
        if fidelity not in ("semantic", "causal"):
            raise ValueError(f"unknown fidelity: {fidelity}")
        if fidelity == "causal" and raw_stream_ref is None:
            raise CheckpointFidelityError(
                f"checkpoint {checkpoint_id} claims causal fidelity but has no raw stream"
            )
        self.checkpoint_id = checkpoint_id
        self.fidelity = fidelity
        self.raw_stream_ref = raw_stream_ref


def expand_for_mode(checkpoint: Checkpoint, mode: str) -> str:
    """
    mode: 'continue'  -> semantic expansion is acceptable
          'replay'    -> requires causal fidelity (true predecessor)
          'audit'     -> requires causal fidelity
          'differential' -> requires causal fidelity
    """
    causal_modes = {"replay", "audit", "differential"}
    if mode in causal_modes and checkpoint.fidelity != "causal":
        raise CheckpointFidelityError(
            f"checkpoint {checkpoint.checkpoint_id} has fidelity={checkpoint.fidelity}; "
            f"mode={mode} requires causal fidelity (raw stream). Expansion would "
            f"produce a plausible representative, not the true predecessor."
        )
    if checkpoint.fidelity == "causal":
        return f"rehydrate:{checkpoint.raw_stream_ref}"
    return f"summarize_expand:{checkpoint.checkpoint_id}"
