Struct HistoryEngine 

pub struct HistoryEngine { /* private fields */ }

SQLite-backed history engine. Replaces the in-memory histent doubly-linked list + histfile flat-file pair from Src/hist.c — same logical history but with FTS5 search, frequency tracking, and per-directory context.

Implementations

impl HistoryEngine

pub fn new() -> Result<HistoryEngine, Error>

pub fn in_memory() -> Result<HistoryEngine, Error>

pub fn text_path() -> PathBuf

$ZSHRS_HOME/zshrs_history — flat text mirror, one line per command in zsh extended-history format:

: <unix_ts>:<duration>;<command>

Newlines inside multi-line commands are escaped as the literal two-character sequence \\n (matches setopt EXTENDED_HISTORY — zsh/Src/hist.c:gethistent). Every add appends one line; update_last rewrites the trailing line in place when the duration becomes known. The sqlite index at zshrs_history.db is the query-side mirror of this file — they’re kept in lockstep by the writer, and a divergence-repair pass on open re-reads the text file if the sqlite is missing or older.

pub fn add(&self, command: &str, cwd: Option<&str>) -> Result<i64, Error>

Add a command to history, updating frequency if it already exists

pub fn update_last( &self, id: i64, duration_ms: i64, exit_code: i32, ) -> Result<(), Error>

Update the duration and exit code of the last command

pub fn search( &self, query: &str, limit: usize, ) -> Result<Vec<HistoryEntry>, Error>

Search history with FTS5 (fuzzy/substring matching)

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

Search history with prefix matching (for up-arrow completion)

pub fn recent(&self, limit: usize) -> Result<Vec<HistoryEntry>, Error>

Get recent history entries

pub fn for_directory( &self, cwd: &str, limit: usize, ) -> Result<Vec<HistoryEntry>, Error>

Get history for a specific directory

pub fn delete(&self, id: i64) -> Result<(), Error>

Delete a history entry

pub fn clear(&self) -> Result<(), Error>

Clear all history

pub fn count(&self) -> Result<i64, Error>

Get total history count

pub fn get_by_offset( &self, offset: usize, ) -> Result<Option<HistoryEntry>, Error>

Get entry by index from end (0 = most recent, like !-1)

pub fn get_by_number(&self, num: i64) -> Result<Option<HistoryEntry>, Error>

Get entry by absolute history number (like !123)