Struct IndexState 

pub struct IndexState {
    pub root: PathBuf,
    pub files: HashMap<FileId, IndexedFile>,
    pub path_to_id: HashMap<String, FileId>,
    pub trigrams: TrigramIndex,
    pub words: WordIndex,
    pub deps: DepGraph,
    pub versions: VersionLog,
    pub agents: AgentRegistry,
    pub last_built_unix_ms: i64,
    pub git_head: Option<String>,
    /* private fields */
}

In-memory index for one workspace. Composed from the per-file table, the trigram + word sub-indexes, the dep graph, the append-only version log, and the agent registry.

Fields

root: PathBuf

Canonicalised workspace root.

files: HashMap<FileId, IndexedFile>

File table keyed on stable id.

path_to_id: HashMap<String, FileId>

Workspace-relative path → stable id.

trigrams: TrigramIndex

Trigram posting list.

words: WordIndex

Identifier-token inverted index.

deps: DepGraph

Forward + reverse import graph.

versions: VersionLog

Append-only log of file mutations.

agents: AgentRegistry

Live agents + advisory locks.

last_built_unix_ms: i64

Wall-clock timestamp (ms since epoch) of the most recent rebuild.

git_head: Option<String>

Best-effort HEAD SHA, or None if the workspace isn’t a git repo.

Implementations

impl IndexState

pub fn snapshot(&self) -> CodeIndexSnapshot

Capture the current state as a CodeIndexSnapshot.

pub fn from_snapshot(snap: CodeIndexSnapshot) -> Self

Restore an IndexState from a snapshot. The workspace root is taken from the snapshot meta; callers can then call Self::reap_after_recovery to drop stale agent records.

pub fn reap_after_recovery(&mut self, now_ms: i64)

Drop stale agent records and release any locks held by agents whose last_seen_ms is older than the configured timeout. Called at startup after restoring from a snapshot.

impl IndexState

pub fn build_from_root(root: &Path) -> (Self, BuildOutcome)

Build a fresh index over root. Returns the populated state plus a summary of how many files were indexed vs skipped.

pub fn reindex_file(&mut self, abs: &Path) -> Option<FileId>

Re-index a single file by its absolute path. Returns the id of the affected file (newly assigned or existing). If the file no longer exists or fails the indexability/sensitivity filter, any existing entry under that path is removed and None is returned.

pub fn remove_file_path(&mut self, abs: &Path)

Remove an existing file from every sub-index. No-op when the file isn’t tracked.

pub fn lookup_path(&self, raw: &str) -> Option<FileId>

Look up a file by either its workspace-relative path or its absolute path inside the workspace root.

pub fn estimated_bytes(&self) -> usize

Estimate the resident memory footprint of every sub-index. Cheap order-of-magnitude figure surfaced by the stats builtin.

pub fn absolute_path(&self, rel_or_abs: &str) -> PathBuf

Resolve a workspace-relative path against the canonical root. Used by host builtins that take a path argument and need to open the underlying file (e.g. read_range, file_hash).