Struct Db 

pub struct Db { /* private fields */ }

SQLite tracking database. Same schema as the bash version.

Implementations

impl Db

pub fn open(data_dir: &Path) -> Result<Self>

Open (or create) the tracking database.

pub fn track(&self, record: &TrackRecord) -> Result<()>

Record a command execution.

pub fn record_invocation(&self, rec: &InvocationRecord) -> Result<()>

Record an invocation for the usage-history ranking. Evicts oldest rows once the table grows past INVOCATIONS_CAP.

pub fn prune_invocations( &self, filter: &PruneFilter, dry_run: bool, ) -> Result<u64>

Prune invocation rows matching filter. With dry_run=true, returns the count that would be removed without touching the table. Gain stats in the commands table are lifetime counters and are never pruned here.

pub fn export_invocations(&self) -> Result<Vec<InvocationExport>>

Export all invocation rows (oldest first) for user-driven backup. Returns (timestamp, command, subcommand, raw_tokens, filtered_tokens, had_plugin, exit_code).

pub fn history_ranking(&self, limit: usize) -> Result<Vec<HistoryRow>>

Rank command+subcommand pairs as plugin candidates. Score = runs × avg_raw_tokens × (1 − savings_ratio) — i.e. called often, produces a lot, and lowfat is not yet shrinking it much.

pub fn gain_summary(&self) -> Result<GainSummary>

Lifetime gain summary.

pub fn top_commands(&self, limit: usize) -> Result<Vec<TopCommand>>

Top commands by tokens saved.

pub fn session_summary(&self, since: &str) -> Result<SessionSummary>

Session summary since a given timestamp.

pub fn audit( &self, plugin_name: &str, runtime_type: &str, command: &str, action: &str, checksum: &str, details: &str, ) -> Result<()>

Record an audit event (plugin load, security check, etc.).

pub fn audit_log(&self, limit: usize) -> Result<Vec<AuditEntry>>

Get recent audit entries.