Struct SimTrace 

pub struct SimTrace { /* private fields */ }

Collects trace events during a simulation run.

Single-threaded by design — the simulation loop is single-threaded.

Implementations

impl SimTrace

pub fn new() -> Self

Create an empty trace.

pub fn record(&mut self, tick: u64, node_id: NodeId, kind: TraceEventKind)

Record a new event.

pub fn len(&self) -> usize

Number of events recorded.

pub fn is_empty(&self) -> bool

Whether the trace is empty.

pub fn events(&self) -> &[TraceEvent]

Get all events.

pub fn events_for_node(&self, node_id: NodeId) -> Vec<&TraceEvent>

Get events filtered by node ID.

pub fn events_matching<F: Fn(&TraceEventKind) -> bool>( &self, f: F, ) -> Vec<&TraceEvent>

Get events matching a predicate.

pub fn events_between(&self, start_tick: u64, end_tick: u64) -> Vec<&TraceEvent>

Filter events by tick range [start, end] (inclusive).

pub fn last_n(&self, n: usize) -> &[TraceEvent]

Get the last N events.

pub fn causal_chain(&self, event_id: EventId) -> Vec<&TraceEvent>

Follow the causal chain backward from an event.

pub fn dump_text(&self) -> String

Dump as human-readable text.

pub fn dump_json(&self) -> String

Dump as JSON.

pub fn dump_jsonl(&self) -> String

Dump as JSON Lines (one JSON object per line).

pub fn clear(&mut self)

Clear the trace.

Trait Implementations

impl Default for SimTrace

fn default() -> Self

Returns the “default value” for a type.