Struct RecentsStore 

pub struct RecentsStore {
    buffer: VecDeque<RecentLocation>,
    cap: usize,
    pub path: PathBuf,
}

Ring buffer (cap 50) of recent locations.

De-duplicates consecutive identical (profile_id, bucket, prefix) triples so rapid re-navigation to the same folder does not pollute the list.

Persisted as ${app_config_dir}/recents.json.

Fields

buffer: VecDeque<RecentLocation>

cap: usize

Maximum number of entries. Kept as a field so tests can override.

path: PathBuf

Implementations

impl RecentsStore

const DEFAULT_CAP: usize = 50

pub fn new(path: PathBuf) -> Self

pub fn load(path: PathBuf) -> Self

Load from path. Returns an empty store if the file does not exist.

fn clamp(&mut self)

pub fn track(&mut self, profile_id: ProfileId, bucket: BucketId, prefix: String)

Record a navigation. De-duplicates consecutive identical locations (same profile, bucket, prefix). Evicts the oldest entry when at cap.

pub fn list(&self) -> Vec<RecentLocation>

Return all recent locations (newest first).

pub fn clear(&mut self)

Clear all entries.

pub fn flush(&self) -> Result<(), AppError>

Flush to disk atomically (tmp + rename).

Returns AppError::Internal on serialization, mkdir, write, or rename failure so callers (e.g. recents_clear) can surface the failure to the user. Previously this used let _ = ... everywhere and silently dropped failures, which meant a “Clear recents” click could leave the stale on-disk list intact and reappear on the next launch.