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<Self>

new — see implementation.

pub fn in_memory() -> Result<Self>

in_memory — see implementation.

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>

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<()>

Update the duration and exit code of the last command

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

Search history with FTS5 (fuzzy/substring matching)

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

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

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

Case-SENSITIVE prefix probe for the per-keystroke ZLE paths (autosuggest, up-arrow search). Uses GLOB, which is case-sensitive and therefore eligible for the SQLite prefix optimization over idx_history_command (BINARY collation). search_prefix’s LIKE is case-insensitive by default and CANNOT use that index — at 500k+ rows it full-scans, which is far too slow to run on every keystroke.

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

Get recent history entries

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

Get history for a specific directory

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

Delete a history entry

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

Clear all history

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

Get total history count

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

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

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

Get entry by absolute history number (like !123)