Struct ScheduledSemanticRefresh 

pub struct ScheduledSemanticRefresh { /* private fields */ }

Explicit periodic schedule for verified semantic memory refresh.

The schedule always requires atomic global index-revision CAS. This prevents independently constructed session runtimes from silently falling back to a process-local ordering guarantee. Construction is inert; a worker starts only after the schedule is installed in super::MemoryMaintenanceOptions and an asynchronous session is built. Clones form one ownership family, so only one active maintenance runtime can publish its shared receipt and metrics epoch at once.

Implementations

impl ScheduledSemanticRefresh

pub fn try_new(interval: Duration) -> Result<Self, MemoryMaintenanceError>

pub fn try_new_with_checkpoint( interval: Duration, checkpoint: DurableMemorySemanticRefreshCheckpoint, ) -> Result<Self, MemoryMaintenanceError>

Construct a schedule that verifies and adopts persisted refresh evidence.

The checkpoint never authorizes the repository-token fast path. Its first run reads a complete bounded Active snapshot and checks the current index before it can become this ownership epoch’s successful receipt.

pub fn interval(&self) -> Duration

pub fn required_consistency(&self) -> VectorMutationConsistency

pub fn last_receipt(&self) -> Option<DurableMemorySemanticRefreshReceipt>

Return the most recent successful, secret-free refresh receipt.

Clones share this observation state for one active ownership epoch. A failed later run leaves the last successful receipt intact while generic maintenance health records the failure. A replacement owner starts a new epoch and clears the process-local receipt before its first run, so an optional source change token is never reused across repository owners.

pub fn metrics(&self) -> SemanticRefreshMetrics

Return bounded, non-sensitive evidence for the current ownership epoch.

A never-owned schedule reports epoch zero. Clean close retains the last epoch for inspection; a successful replacement claim increments the epoch and clears all prior counters and recent runs.

Trait Implementations

impl Clone for ScheduledSemanticRefresh

fn clone(&self) -> ScheduledSemanticRefresh

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScheduledSemanticRefresh

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

Formats the value using the given formatter.