Struct LocalWorkspaceManifest 

pub struct LocalWorkspaceManifest { /* private fields */ }

Shared in-memory workspace manifest.

Implementations

impl LocalWorkspaceManifest

pub fn start(root: impl Into<PathBuf>) -> Arc<Self>

Start the manifest scanner/watcher for root.

pub fn start_deferred(root: impl Into<PathBuf>) -> Arc<Self>

Create an empty manifest whose scanner and watcher start only after Self::activate is called.

Search-capable hosts can use this during a latency-sensitive bootstrap: manifest-backed operations retain their local filesystem fallback while the initial snapshot is empty, so deferring discovery does not make the workspace inaccessible.

pub fn activate(&self) -> bool

Open a deferred manifest’s one-way startup gate.

Returns true only for the call that transitions the manifest from deferred to active. Calling this on an eagerly started or already active manifest is harmless and returns false.

pub fn is_active(&self) -> bool

Whether discovery has been activated for this manifest.

pub fn snapshot(&self) -> LocalWorkspaceManifestSnapshot

pub fn subscribe(&self) -> Receiver<LocalWorkspaceManifestSnapshot>

pub fn subscribe_changes(&self) -> Receiver<WorkspaceFileChange>

Subscribe to debounced, workspace-relative filesystem changes.

pub fn shutdown(&self)

Stop background discovery without waiting for an in-flight synchronous scan.

Hosts with an explicit lifecycle should call this before shutting down their Tokio runtime. Drop is only a fallback because other background services may retain an Arc to the manifest until runtime teardown.

pub fn touch_file(&self, path: impl AsRef<str>) -> bool

Record that a workspace-relative file was opened, read, or written.

This intentionally does not require the initial manifest scan to have completed. The public recent-file views filter against the current manifest index, so early touches become visible after the file is indexed and deleted files disappear automatically.

pub fn recent_file_entries(&self, limit: usize) -> Vec<RecentWorkspaceFile>

Return the hottest known files, newest/frequently used first.

pub fn recent_file_paths(&self, limit: usize) -> Vec<String>

Return recent file paths only, preserving hot-file order.

Trait Implementations

impl Drop for LocalWorkspaceManifest

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.