Struct CommandHistory 

pub struct CommandHistory { /* private fields */ }

Manages a persistent, deduplicated command history with a configurable max size.

Implementations

impl CommandHistory

pub fn new(max_entries: usize) -> Self

Create a new command history with the given max entries and persistence path.

pub fn load(&mut self)

Load history from disk, merging with any existing in-memory entries.

pub fn save(&mut self)

Save history to disk.

SEC-021: written through crate::atomic_save at mode 0o600. Command history routinely captures secrets typed on the command line (tokens in curl -H, export API_KEY=…), so it must not be readable by other users; and a truncated file parses as an error, discarding the history.

pub fn save_background(&mut self)

Serialize history and spawn a background thread to write it to disk. Used during shutdown to avoid blocking the main thread.

pub fn add( &mut self, command: String, exit_code: Option<i32>, duration_ms: Option<u64>, )

Add a command to history, deduplicating by command text. If the command already exists, it is moved to the front with updated metadata.

pub fn entries(&self) -> &VecDeque<CommandHistoryEntry>

Get all entries (newest first).

pub fn set_max_entries(&mut self, max: usize)

Update max entries and truncate if needed.

pub fn is_dirty(&self) -> bool

Whether the history has been modified since last save.

pub fn update_exit_code_if_unknown( &mut self, command: &str, exit_code: Option<i32>, duration_ms: Option<u64>, )

Update the exit code of an existing entry when a newer value is available.

Scrollback marks are returned oldest-first, so the same command may appear multiple times (one per execution). synced_commands prevents add() from being called more than once per command per session, so subsequent marks (which may have a more recent exit code) arrive here instead. We update whenever the new exit code is Some and differs from what is stored, so the most-recently- executed instance always wins.

pub fn len(&self) -> usize

Get number of entries.

pub fn is_empty(&self) -> bool

Check if empty.

Trait Implementations

impl Debug for CommandHistory

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

Formats the value using the given formatter.