Struct IndexStore 

pub struct IndexStore<S: SnapshotStore = DiskSnapshotStore> { /* private fields */ }

Index lifecycle orchestrator backed by a [SnapshotStore] for atomic persistence and coordination.

Implementations

impl IndexStore<DiskSnapshotStore>

pub const fn meta(&self) -> Option<&StoreMeta>

pub fn refresh_meta(&mut self, meta: &StoreMeta) -> Result<()>

Persist updated metadata and refresh the in-memory copy.

Errors

Returns an error if writing meta.json fails.

impl IndexStore<DiskSnapshotStore>

pub fn open(sift_dir: &Path) -> Result<Self>

Open an existing store at sift_dir.

Errors

Returns an error if CURRENT exists but cannot be read.

pub fn open_or_create(sift_dir: &Path, meta: &StoreMeta) -> Result<Self>

Open an existing store or create a new one at sift_dir.

Errors

Returns an error if the store directory cannot be created or metadata cannot be written.

pub fn snapshot_dir(&self, id: &str) -> PathBuf

impl<S: SnapshotStore> IndexStore<S>

pub fn current_id(&self) -> Option<&str>

pub fn build( &mut self, kinds: &[IndexKind], config: &IndexConfig<'_>, paths: &[PathBuf], ) -> Result<String>

Build a new snapshot using the given index kinds.

Acquires the writer session, builds each index kind as artifacts, and publishes the snapshot.

Returns the snapshot id.

Errors

Returns an error if the writer session cannot be acquired, the index build fails, or publishing fails.

pub fn update( &mut self, kinds: &[IndexKind], config: &IndexConfig<'_>, paths: &[PathBuf], ) -> Result<Option<String>>

Update the current snapshot, rebuilding only indexes whose corpus changed.

Acquires the writer session, checks for changes, copies unchanged artifacts from the current snapshot, and publishes a new one.

Returns the snapshot id if a new snapshot was published, or None if no index changed.

Errors

Returns an error if the writer session cannot be acquired, the current snapshot cannot be opened, the update check fails, or publishing fails.

pub fn reconcile(&mut self, meta: &StoreMeta, paths: &[PathBuf]) -> Result<()>

Rebuild or update index files.

paths empty → full corpus. Non-empty → partial rel-paths only.

Errors

Propagates build/update failures from the underlying index kinds.