Module cascade 

cast cascade — visualize cascade event streams, and verify they relayed.

Subcommands:

• tree <TRACE_FILE> replay a JSONL trace file and render it
• verify <TRACE_FILE> assert a trace is a real peer-to-peer relay
• live run a fresh scenario and render it

Renderers + sinks come from crate::event_render; the relay assertion comes from consortium_nix::cascade_tree, next to the CascadeEvent type that produces the stream. This module is the library half of the old cascade-viz binary, so it stays testable without spawning a process.

Structs

LiveArgs

RenderArgs

Flags shared by the subcommands that render a tree.

TreeArgs

VerifyArgs

Enums

CascadeCommands

The cast cascade subcommands.

Functions

dispatch

Run one cast cascade subcommand. Render output goes to stdout; errors bubble up so the caller can print error: … and exit non-zero.

render_trace_file

Replay a JSONL trace file and render it. The jsonl format streams the events back one per line; every other format delegates to render_events.

run_live

Run a fresh scenario and render it. Live tree re-rendering is the default when the format is tree, stdout is a TTY, and –no-watch wasn’t passed; everything else batches.

verify_trace_file

Verify a trace relayed peer-to-peer and return the topology summary as JSON — the same {"nodes", "rounds", "relay_depth", "relayed_nodes"} the harness’s verify_cascade_relay produced. Every failure — unreadable file, malformed line, truncated stream, star-shaped tree, wrong fleet size — exits non-zero with a specific diagnostic.