Enum SemanticAvailability 

pub enum SemanticAvailability {
    Ready {
        embedder_id: String,
    },
    NotInstalled,
    NeedsConsent,
    Downloading {
        progress_pct: u8,
        bytes_downloaded: u64,
        total_bytes: u64,
    },
    Verifying,
    IndexBuilding {
        embedder_id: String,
        progress_pct: Option<u8>,
        items_indexed: u64,
        total_items: u64,
    },
    HashFallback,
    Disabled {
        reason: String,
    },
    ModelMissing {
        model_dir: PathBuf,
        missing_files: Vec<String>,
    },
    IndexMissing {
        index_path: PathBuf,
    },
    DatabaseUnavailable {
        db_path: PathBuf,
        error: String,
    },
    LoadFailed {
        context: String,
    },
    UpdateAvailable {
        embedder_id: String,
        current_revision: String,
        latest_revision: String,
    },
}

Unified TUI state machine for semantic search availability.

This enum tracks the full lifecycle of semantic search from the user’s perspective:

• Model installation flow (NotInstalled → NeedsConsent → Downloading → Verifying → Ready)
• Index building flow (Ready → IndexBuilding → Ready)
• User preferences (HashFallback, Disabled)
• Error states (LoadFailed, ModelMissing, etc.)

Variants

Ready

Model is ready for use.

Fields

embedder_id: String

NotInstalled

Model not installed - semantic not available. TUI should show option to download or use hash fallback.

NeedsConsent

User needs to consent before downloading model. TUI should show consent dialog.

Downloading

Model download in progress.

Fields

progress_pct: u8

Progress percentage (0-100).

bytes_downloaded: u64

Bytes downloaded so far.

total_bytes: u64

Total bytes to download.

Verifying

Verifying downloaded model (SHA256 check).

IndexBuilding

Index is being built or rebuilt.

Fields

embedder_id: String

progress_pct: Option<u8>

Optional progress percentage (0-100).

items_indexed: u64

Number of items indexed so far.

total_items: u64

Total items to index.

HashFallback

User opted for hash-based fallback (no ML model).

Disabled

Semantic search disabled by policy or user.

Fields

reason: String

ModelMissing

Model files are missing.

Fields

model_dir: PathBuf

missing_files: Vec<String>

IndexMissing

Vector index is missing.

Fields

index_path: PathBuf

DatabaseUnavailable

Database is unavailable.

Fields

db_path: PathBuf

error: String

LoadFailed

Failed to load semantic context.

Fields

context: String

UpdateAvailable

Model update available - index rebuild needed.

Fields

embedder_id: String

current_revision: String

latest_revision: String

Implementations

impl SemanticAvailability

pub fn is_ready(&self) -> bool

Check if semantic search is ready to use.

pub fn has_update(&self) -> bool

Check if a model update is available.

pub fn is_building(&self) -> bool

Check if the index is being rebuilt.

pub fn is_downloading(&self) -> bool

Check if a download is in progress.

pub fn needs_consent(&self) -> bool

Check if user consent is needed.

pub fn is_hash_fallback(&self) -> bool

Check if hash fallback is active.

pub fn is_disabled(&self) -> bool

Check if semantic search is disabled.

pub fn is_not_installed(&self) -> bool

Check if the model is not installed.

pub fn is_error(&self) -> bool

Check if any error state is active.

pub fn can_search(&self) -> bool

Check if semantic can be used (ready or hash fallback).

pub fn download_progress(&self) -> Option<(u8, u64, u64)>

Get download progress if downloading.

pub fn index_progress(&self) -> Option<(Option<u8>, u64, u64)>

Get index building progress if building.

pub fn status_label(&self) -> &'static str

Get a short status label for display in status bar.

pub fn summary(&self) -> String

Get a detailed summary for display.

Trait Implementations

impl Clone for SemanticAvailability

fn clone(&self) -> SemanticAvailability

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SemanticAvailability

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

Formats the value using the given formatter.