Struct WatchpointObserver 

pub struct WatchpointObserver { /* private fields */ }

A WriteObserver that watches a fixed set of global slot indices and records a hit whenever one is written — the entire watchpoint implementation. Reuses the existing production WriteObserver/ ObservedContext seam (state.rs) rather than a second observer mechanism, per the issue’s own instruction: this struct is the only piece of new plumbing watchpoints need.

Composes with crate::Story::debug_run_watching for pausing mid-step-loop on a hit, or with the existing Story::continue_single_observed (unaffected by this feature) for production-path logging without pausing — the observer doesn’t care which loop drives it.

Implementations

impl WatchpointObserver

pub fn new(watched_globals: Vec<u32>) -> Self

pub fn watches(&self, global_idx: u32) -> bool

pub fn hits(&self) -> &[WatchHit]

Every hit recorded since the last take_hits/take_hit call.

pub fn take_hits(&mut self) -> Vec<WatchHit>

Drain every hit recorded since the last take_hits/clear call, in the order they were recorded. The public counterpart to take_hit — for a consumer that composes this observer with Story::continue_single_observed/continue_maximally_observed (non-pausing logging, per this module’s doc), take_hit’s pub(crate) FIFO pop is not reachable from outside the crate, so without this method pending would accumulate for the observer’s entire lifetime with no way for a consumer to clear it — the unbounded-growth guard this method (and clear) close.

pub fn clear(&mut self)

Discard every pending hit without returning them — the other half of the unbounded-growth guard take_hits provides.

Trait Implementations

impl Clone for WatchpointObserver

fn clone(&self) -> WatchpointObserver

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WatchpointObserver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WatchpointObserver

fn default() -> WatchpointObserver

Returns the “default value” for a type.

impl WriteObserver for WatchpointObserver

fn on_set_global(&mut self, idx: u32, _value: &Value)

fn on_increment_visit(&mut self, id: DefinitionId, new_count: u32)

fn on_set_visit_count(&mut self, id: DefinitionId, count: u32)

fn on_set_turn_count(&mut self, id: DefinitionId, turn: u32)

fn on_increment_turn_index(&mut self, new_value: u32)

fn on_set_turn_index(&mut self, index: u32)

fn on_set_rng_seed(&mut self, new_seed: i32)

fn on_set_previous_random(&mut self, new_val: i32)