Struct TickEngine 

pub struct TickEngine { /* private fields */ }

Single-threaded tick engine for Lockstep mode.

Owns all simulation state and executes ticks synchronously. Each execute_tick() call runs the full propagator pipeline, publishes a snapshot, and returns receipts for any submitted commands.

Implementations

impl TickEngine

pub fn new(config: WorldConfig) -> Result<Self, ConfigError>

Construct a new tick engine from a WorldConfig.

Validates the configuration, builds the read resolution plan, constructs the arena, and pre-computes the base field set. Consumes the WorldConfig.

pub fn submit_commands(&mut self, commands: Vec<Command>) -> Vec<Receipt>

Submit commands to be processed in the next tick.

Returns one receipt per command indicating acceptance or rejection.

pub fn execute_tick(&mut self) -> Result<TickResult, TickError>

Execute one tick.

Runs the full propagator pipeline, publishes the snapshot, and returns receipts plus metrics. On propagator failure, the tick is rolled back atomically (the staging buffer is abandoned).

pub fn reset(&mut self) -> Result<(), ConfigError>

Reset the engine to its initial state.

pub fn snapshot(&self) -> Snapshot<'_>

Get a read-only snapshot of the current published generation.

pub fn owned_snapshot(&self) -> OwnedSnapshot

Get an owned, thread-safe snapshot of the current published generation.

Unlike TickEngine::snapshot(), the returned OwnedSnapshot owns clones of the segment data and can be sent across thread boundaries.

pub fn current_tick(&self) -> TickId

Current tick ID.

pub fn is_tick_disabled(&self) -> bool

Whether ticking is disabled due to consecutive rollbacks.

pub fn consecutive_rollback_count(&self) -> u32

Number of consecutive rollbacks since the last successful tick.

pub fn last_metrics(&self) -> &StepMetrics

Metrics from the most recent successful tick.

pub fn space(&self) -> &dyn Space

The spatial topology for this engine.