Struct FileStore 

pub struct FileStore { /* private fields */ }

Process-local file content store.

Default constructs an empty store. Wrap in Arc<RwLock<>> for the shared ToolContext.file_store field; the lock is taken briefly per call (insert is one allocation + hash, peek is a HashMap lookup + substring slice).

Implementations

impl FileStore

pub fn new() -> Self

pub fn insert( &mut self, path: PathBuf, content: String, mtime: SystemTime, ) -> String

Push a file snapshot into the store. Returns the assigned store_id. Any prior entry for the same path is replaced — re-reading a file overwrites its slot rather than accumulating stale copies.

store_id shape: fs_<8-hex-of-content-hash>. Hash carries content+path so unrelated files can’t collide; the prefix disambiguates from other id namespaces in logs.

pub fn get(&self, store_id: &str) -> Option<&FileEntry>

Look up an entry by store_id. Returns None if invalidated or never inserted.

pub fn store_id_for_path(&self, path: &Path) -> Option<&str>

Look up the live store_id for a path (if any). Used by invalidate-on-edit and by read_file to detect “we already have this; reuse”.

pub fn is_stale(&self, store_id: &str, current_mtime: SystemTime) -> bool

Compare the entry’s recorded mtime to a freshly-stat’d one. Returns true when the disk has moved on and the entry should not serve. Caller (typically peek_file) returns a recovery hint pointing at re-read.

pub fn invalidate(&mut self, path: &Path)

Drop the entry (if any) for a path. Called by edit_file / write_file on success. No-op when the path was never in the store. Idempotent — calling twice with the same path is fine.

pub fn peek_lines( &self, store_id: &str, start: usize, end: usize, ) -> Option<String>

Extract a 1-indexed inclusive line range. [1, 1] returns the first line; out-of-range tails are clamped. Returns None only if the store_id is unknown — empty regions return Some("") so callers can distinguish “no such entry” from “valid request, nothing in that range”.

pub fn len(&self) -> usize

Number of live entries — used by tests and the /context rich snapshot.

pub fn is_empty(&self) -> bool

Trait Implementations

impl Debug for FileStore

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

Formats the value using the given formatter.

impl Default for FileStore

fn default() -> FileStore

Returns the “default value” for a type.