Struct FileHistory 

pub struct FileHistory { /* private fields */ }

Reads history from shell history files on disk.

Supports:

• zsh: ~/.zsh_history (extended format with timestamps)
• bash: ~/.bash_history (plain text, one command per line)
• fish: ~/.local/share/fish/fish_history (custom format)

Implementations

impl FileHistory

pub fn new(shell: Shell) -> Self

pub fn with_path(shell: Shell, path: PathBuf) -> Self

pub fn shell(&self) -> Shell

pub fn entries(&self) -> &[HistoryEntry]

Get all history entries (for context in other tiers like CloudTier)

pub fn reload_if_changed(&mut self)

Check if history file changed since last load, reload if so. Returns silently on any error (file locked, inaccessible, etc.) — uses cached results.

Note: There is an inherent TOCTOU race between stat and read. This is acceptable because worst case we read newer data but record older metadata, which self-corrects on the next request.

pub fn command_names(&self) -> Vec<&str>

Return unique first-token command names from history, in frequency order. Used for fuzzy matching when prefix search fails.

Trait Implementations

impl ShellHistory for FileHistory

fn load(&mut self) -> Result<(), Box<dyn Error + Send + Sync>>

Load or refresh history entries from the source.

fn search_prefix(&self, prefix: &str, limit: usize) -> Vec<HistoryEntry>

Find commands matching the given prefix, ranked by recency/frequency.