Struct MonotonicTimestamp 

pub struct MonotonicTimestamp(/* private fields */);

A monotonic timestamp that counts during system sleep, used for drive-window heartbeat math (LD17 + Domain Pitfall: macOS/Linux suspend divergence).

Rust’s std::time::Instant is inconsistent across platforms for the sleep case: on macOS it uses mach_continuous_time (counts sleep), on Linux it uses CLOCK_MONOTONIC (does NOT count sleep). A laptop-sleep during a drive window must EXPIRE the window, so we standardize on the count-during-sleep semantic on both:

• Linux: clock_gettime(CLOCK_BOOTTIME).
• macOS: mach_continuous_time() converted to ns via mach_timebase_info.

Stored as nanoseconds since an unspecified epoch; only differences are meaningful. Wall-clock ts for human audit lives in events.jsonl, tracked independently (LD17).

Implementations

impl MonotonicTimestamp

pub fn now() -> Self

Read the current count-during-sleep monotonic clock.

pub fn duration_since(&self, earlier: MonotonicTimestamp) -> Duration

Nanoseconds elapsed since earlier. Saturates at 0 if earlier is in the future (clock readings are monotonic, so this only guards against a caller passing a later timestamp as earlier).

pub fn elapsed(&self) -> Duration

Convenience: elapsed since this timestamp until now.

pub fn as_nanos(&self) -> u64

Raw nanoseconds, for persisting the heartbeat baseline to state.json.

pub fn from_nanos(nanos: u64) -> Self

Reconstruct from raw nanoseconds previously read via as_nanos. Used by the daemon (Wave 3) to restore a persisted heartbeat baseline. Only meaningful when paired with a now() from the same daemon incarnation’s clock (the value is epoch-relative to the running clock).

Trait Implementations

impl Clone for MonotonicTimestamp

fn clone(&self) -> MonotonicTimestamp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MonotonicTimestamp

impl Debug for MonotonicTimestamp

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

Formats the value using the given formatter.

impl Eq for MonotonicTimestamp

impl Ord for MonotonicTimestamp

fn cmp(&self, other: &MonotonicTimestamp) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for MonotonicTimestamp

fn eq(&self, other: &MonotonicTimestamp) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for MonotonicTimestamp

fn partial_cmp(&self, other: &MonotonicTimestamp) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for MonotonicTimestamp