Struct AmpThreadIndex 

pub struct AmpThreadIndex { /* private fields */ }

Pre-sorted, in-memory index of all Amp thread summaries.

Built once at startup by scanning ~/.local/share/amp/threads/, then kept up-to-date via notify file-system events. The inner ArcSwap allows lock-free reads from HTTP handlers while the watcher task atomically swaps in a new snapshot on every change.

Implementations

impl AmpThreadIndex

pub fn build() -> Self

Build the initial index by scanning the threads directory.

This performs synchronous filesystem I/O and should be called from within spawn_blocking or at startup before the server binds. Build the initial index by scanning the threads directory.

This performs synchronous filesystem I/O and should be called from within spawn_blocking or at startup before the server binds.

pub fn empty() -> Self

Create an empty index (for tests or when the directory is absent).

pub fn list(&self) -> Guard<Arc<Vec<AmpThreadSummary>>>

Return a snapshot of all cached summaries (sorted by created desc).

pub fn watch(self: &Arc<Self>)

Start background file watching.

Watches ~/.local/share/amp/threads/ for create / modify / remove events and rebuilds the index on each change. Events are debounced (500 ms) so rapid writes from Amp don’t cause redundant re-scans.

Panics

Panics if the OS file watcher cannot be created or the directory cannot be registered for watching.