Struct TimeTravel 

pub struct TimeTravel { /* private fields */ }

Time-travel debugger state.

Implementations

impl TimeTravel

pub fn with_config(config: TimeTravelConfig) -> Self

Create a new time-travel debugger with the given configuration.

pub fn new(mode: CaptureMode, max_entries: usize) -> Self

Create a new time-travel debugger with the given capture mode and maximum history size.

This constructor preserves backward compatibility with the existing VirtualMachine API.

pub fn disabled() -> Self

Create a disabled (no-op) time-travel debugger.

pub fn should_capture( &mut self, ip: usize, _instruction_count: u64, is_call_or_return: bool, ) -> bool

Check whether a capture should happen at the current instruction.

Called from the dispatch loop. Returns true if a snapshot should be captured at this point.

Arguments

• ip - current instruction pointer
• instruction_count - total instructions executed so far (reserved)
• is_call_or_return - true if the current instruction is a Call/Return

pub fn on_function_entry(&mut self) -> bool

Notify that a function was entered. Captures if in FunctionBoundaries mode.

pub fn on_function_exit(&mut self) -> bool

Notify that a function was exited. Captures if in FunctionBoundaries mode.

pub fn record( &mut self, _snapshot: VmSnapshot, ip: usize, instruction_count: u64, call_depth: usize, ) -> usize

Record a shape_runtime::snapshot::VmSnapshot into the history.

This method wraps the runtime snapshot type used by dispatch.rs. The snapshot is stored in the ring buffer alongside metadata.

pub fn snapshot_store(&mut self) -> Result<&SnapshotStore, String>

Get the snapshot store, creating it lazily.

Used by dispatch.rs to obtain a SnapshotStore reference for serializing VM state before recording.

pub fn capture(&mut self, snapshot: VmSnapshot)

Store a snapshot.

pub fn build_snapshot( &self, ip: usize, sp: usize, call_depth: usize, function_id: Option<u16>, function_name: Option<String>, instruction_count: u64, stack: &[ValueWord], module_bindings: &[ValueWord], reason: CaptureReason, ) -> VmSnapshot

Build a snapshot from raw VM state.

pub fn step_back(&mut self) -> Option<&VmSnapshot>

Move to the previous snapshot. Returns the snapshot if available.

pub fn step_forward(&mut self) -> Option<&VmSnapshot>

Move to the next snapshot. Returns the snapshot if available.

pub fn goto(&mut self, index: u64) -> Option<&VmSnapshot>

Jump to a specific snapshot index.

pub fn current(&self) -> Option<&VmSnapshot>

Get the current snapshot (at cursor position).

pub fn latest(&self) -> Option<&VmSnapshot>

Get the most recent snapshot.

pub fn snapshot_count(&self) -> usize

Number of captured snapshots.

pub fn cursor_position(&self) -> usize

Current cursor position.

pub fn is_enabled(&self) -> bool

Whether the debugger is actively capturing.

pub fn clear(&mut self)

Clear all captured snapshots.

pub fn context_window(&self, radius: usize) -> Vec<&VmSnapshot>

Get a range of snapshots around the cursor for display.