Struct FileHistory 

pub struct FileHistory { /* private fields */ }

File version history tracker

Thread-safe storage for file snapshots. Each file maintains an ordered list of versions. Old versions are evicted when max_snapshots is reached.

Implementations

impl FileHistory

pub fn new(max_snapshots: usize) -> Self

Create a new file history tracker

max_snapshots limits the total number of snapshots stored. When exceeded, the oldest snapshots (across all files) are evicted.

pub fn save_snapshot(&self, path: &str, content: &str, tool_name: &str) -> usize

Save a snapshot of a file’s content before modification

Returns the version number assigned to this snapshot.

pub fn list_versions(&self, path: &str) -> Vec<VersionSummary>

List all versions of a specific file

pub fn list_files(&self) -> Vec<(String, usize)>

List all tracked files with their version counts

pub fn get_version(&self, path: &str, version: usize) -> Option<FileSnapshot>

Get a specific version’s content

pub fn get_latest(&self, path: &str) -> Option<FileSnapshot>

Get the latest version of a file

pub fn diff( &self, path: &str, from_version: usize, to_version: usize, ) -> Option<String>

Generate a unified diff between two versions of a file

Returns None if either version doesn’t exist.

pub fn diff_with_current( &self, path: &str, version: usize, current_content: &str, ) -> Option<String>

Generate a diff between a version and the current file content

pub fn total_snapshots(&self) -> usize

Get the total number of snapshots across all files

pub fn clear_file(&self, path: &str)

Clear all history for a specific file

pub fn clear_all(&self)

Clear all history