Struct ActivityMonitor 

pub struct ActivityMonitor {
    pub activity_log: Vec<DateTime<Utc>>,
    pub detected_sleep_hour: Option<u8>,
    pub last_deep_dream: Option<DateTime<Utc>>,
    pub deep_dream_cooldown: Duration,
    pub deep_dream_inactivity_mins: u64,
}

Tracks user activity to detect idle periods and ideal times for deep dreaming.

Fields

activity_log: Vec<DateTime<Utc>>

Sampled activity timestamps (rounded to 10 min, retained 7 days)

detected_sleep_hour: Option<u8>

Automatically detected typical sleep hour (0-23)

last_deep_dream: Option<DateTime<Utc>>

When the last deep dream was successfully completed

deep_dream_cooldown: Duration

Minimum time between deep dreams

deep_dream_inactivity_mins: u64

Inactivity threshold (minutes) before deep dream can trigger

Implementations

impl ActivityMonitor

pub fn record_activity(&mut self)

Record a sample of user activity.

pub fn compute_sleep_hour(&self) -> Option<u8>

Compute the most likely sleep hour from the activity log.

Counts activity samples per UTC hour (0–23) and returns the hour with the fewest samples — the user is typically away. Returns None when the log has fewer than 14 entries (insufficient data).

pub fn should_deep_dream(&self) -> bool

Check if deep dream conditions are met.

Returns false if no activity samples exist (fresh install), if within cooldown since the last deep dream, or if insufficient inactivity time. When detected_sleep_hour matches the current hour (±2h window), the inactivity threshold is relaxed to one-third of the configured value (minimum 10 minutes) since the user is likely away during their sleep window.

pub fn persistence_path() -> PathBuf

Default path for global activity monitor persistence.

pub fn load() -> Self

Load from disk.

pub fn save(&self) -> Result<()>

Save to disk.

Trait Implementations

impl Clone for ActivityMonitor

fn clone(&self) -> ActivityMonitor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActivityMonitor

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

Formats the value using the given formatter.

impl Default for ActivityMonitor

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ActivityMonitor

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ActivityMonitor

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.