Enum IndexProgress 

#[non_exhaustive]
pub enum IndexProgress {
    Started {
        total_files: usize,
    },
    FileProcessing {
        path: PathBuf,
        current: usize,
        total: usize,
    },
    FileCompleted {
        path: PathBuf,
        symbols: usize,
    },
    IngestProgress {
        files_processed: usize,
        total_files: usize,
        total_symbols: usize,
        counts: NodeIngestCounts,
        elapsed: Duration,
        eta: Option<Duration>,
    },
    IngestFileStarted {
        path: PathBuf,
        current: usize,
        total: usize,
    },
    IngestFileCompleted {
        path: PathBuf,
        symbols: usize,
        duration: Duration,
    },
    StageStarted {
        stage_name: &'static str,
    },
    StageCompleted {
        stage_name: &'static str,
        stage_duration: Duration,
    },
    GraphPhaseStarted {
        phase_number: u8,
        phase_name: &'static str,
        total_items: usize,
    },
    GraphPhaseProgress {
        phase_number: u8,
        items_processed: usize,
        total_items: usize,
    },
    GraphPhaseCompleted {
        phase_number: u8,
        phase_name: &'static str,
        phase_duration: Duration,
    },
    SavingStarted {
        component_name: &'static str,
    },
    SavingCompleted {
        component_name: &'static str,
        save_duration: Duration,
    },
    Completed {
        total_symbols: usize,
        duration: Duration,
    },
}

Progress events emitted during indexing operations.

Stability

This enum is marked #[non_exhaustive] to allow adding new progress events in future versions without breaking downstream code. Always include a wildcard arm (_ => {}) when matching on this enum.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Started

Indexing has started.

Fields

total_files: usize

Total number of files to process

FileProcessing

A file is currently being processed.

Fields

path: PathBuf

Path to the file being processed

current: usize

Current file number (1-based)

total: usize

Total number of files

FileCompleted

A file has been processed successfully.

Fields

path: PathBuf

Path to the completed file

symbols: usize

Number of items extracted from this file

IngestProgress

Progress while ingesting nodes and relations into the index.

Fields

files_processed: usize

Files ingested so far

total_files: usize

Total files to ingest

total_symbols: usize

Total items ingested so far

counts: NodeIngestCounts

Node-kind breakdown

elapsed: Duration

Elapsed time for ingestion

eta: Option<Duration>

Estimated remaining time (best-effort)

IngestFileStarted

A file is about to be ingested into the index.

Fields

path: PathBuf

Path to the file being ingested

current: usize

Current file number (1-based)

total: usize

Total number of files to ingest

IngestFileCompleted

A file has finished ingesting into the index.

Fields

path: PathBuf

Path to the ingested file

symbols: usize

Number of items ingested from this file

duration: Duration

Duration of the ingest work for this file

StageStarted

A coarse-grained indexing stage has started.

Fields

stage_name: &'static str

Human-readable stage name (e.g., “Resolve imports”) Uses &'static str to avoid allocations.

StageCompleted

A coarse-grained indexing stage has completed.

Fields

stage_name: &'static str

Human-readable stage name

stage_duration: Duration

Duration of the stage

GraphPhaseStarted

A graph build phase has started.

Fields

phase_number: u8

Phase number (1-4)

phase_name: &'static str

Human-readable phase name (e.g., “AST extraction”) Uses &'static str to avoid allocations in hot paths.

total_items: usize

Total items to process in this phase

GraphPhaseProgress

Progress within a graph build phase.

Fields

phase_number: u8

Phase number (1-4)

items_processed: usize

Number of items processed so far

total_items: usize

Total items in this phase

GraphPhaseCompleted

A graph build phase has completed.

Fields

phase_number: u8

Phase number (1-4)

phase_name: &'static str

Human-readable phase name

phase_duration: Duration

Duration of this phase

SavingStarted

Index save operation has started for a component.

Fields

component_name: &'static str

Component being saved (e.g., “symbols”, “trigrams”, “unified graph”) Uses &'static str to avoid allocations.

SavingCompleted

Index save operation has completed for a component.

Fields

component_name: &'static str

Component that was saved

save_duration: Duration

Duration of the save operation

Completed

Indexing has completed.

Fields

total_symbols: usize

Total number of items indexed

duration: Duration

Duration of the indexing operation

Trait Implementations

impl Clone for IndexProgress

fn clone(&self) -> IndexProgress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IndexProgress

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

Formats the value using the given formatter.