invariant_visualization

Scope: Invariant visualization tooling.
Audience: External users and contributors.
Guarantees: Per-tick invariants are observable.
Non-Goals: GUI tooling.
Why: This doc exists to record its single responsibility for review.

Overview

This doc describes invariant visualization.
Architecture context lives in Conservation.
Metrics context lives in Metrics.

Contracts

Per-tick invariant snapshots are recorded by PathwayExecutor.
Violations are captured in the invariant log.
Visualization uses scripts/visualize_invariants.py.

Invariants

Invariant visibility aligns with Invariants.
Snapshot format aligns with tests/unit/test_execution_cost.py.
MPI meaning aligns with Mpi.

Failure Modes

Missing snapshots hide violations.
Drift in logs breaks Conservation.
Unlinked usage breaks Docs Style.

Extension Points

Extensions follow Experimental.
Review rules align with Triage.
MPI changes align with Surface Area.

Exit Criteria

This doc is obsolete when visualization is generated.
The replacement is Metrics.
Obsolete docs are removed.

Code refs: scripts/visualize_invariants.py.