Struct SymbolLookupCache 

pub struct SymbolLookupCache { /* private fields */ }

In-memory symbol cache for O(1) lookups during Phase 2 resolution.

Built during Phase 1 INDEX stage by retaining symbols after Tantivy write. Provides lock-free concurrent reads for parallel resolution.

Key design:

• by_id: SymbolId → Symbol for direct lookups
• by_name: name → Vec<SymbolId> for candidate resolution
• by_file_id: FileId → Vec<SymbolId> for local symbol lookup

Memory: ~500 bytes/symbol, 600K symbols ≈ 300MB

Implementations

impl SymbolLookupCache

pub fn new() -> Self

Create a new empty cache.

pub fn with_capacity(symbols: usize) -> Self

Create with pre-allocated capacity.

pub fn insert(&self, symbol: Symbol)

Insert a symbol into the cache.

pub fn get(&self, id: SymbolId) -> Option<Symbol>

Get symbol by ID (O(1)).

pub fn get_ref(&self, id: SymbolId) -> Option<Ref<'_, SymbolId, Symbol>>

Get symbol reference by ID (O(1), no clone).

pub fn lookup_candidates(&self, name: &str) -> Vec<SymbolId>

Get candidate symbol IDs by name (O(1)).

pub fn symbols_in_file(&self, file_id: FileId) -> Vec<SymbolId>

Get symbol IDs defined in a file (O(1)).

Used by CONTEXT stage to find local symbols for a file.

pub fn file_count(&self) -> usize

Number of files in cache.

pub fn len(&self) -> usize

Number of symbols in cache.

pub fn is_empty(&self) -> bool

Check if cache is empty.

pub fn unique_names(&self) -> usize

Number of unique names in cache.

impl SymbolLookupCache

pub fn from_index(index: &DocumentIndex) -> PipelineResult<Self>

Build cache from all symbols in a DocumentIndex.

[PIPELINE API] Used for single-file indexing when we need a complete cache for Phase 2 resolution but don’t have symbols in memory.

Note: This queries Tantivy for all symbols, which is expensive for large indexes. For bulk indexing, prefer building the cache during INDEX stage.

Trait Implementations

impl Debug for SymbolLookupCache

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

Formats the value using the given formatter.

impl Default for SymbolLookupCache

fn default() -> Self

Returns the “default value” for a type.

impl PipelineSymbolCache for SymbolLookupCache

fn resolve( &self, name: &str, caller: &CallerContext, to_range: Option<&Range>, imports: &[Import], ) -> ResolveResult

Multi-tier symbol resolution with proper priority order.

fn get(&self, id: SymbolId) -> Option<Symbol>

Direct lookup by ID for metadata access.

fn symbols_in_file(&self, file_id: FileId) -> Vec<SymbolId>

Get all symbols in a file (for local scope building).

fn lookup_candidates(&self, name: &str) -> Vec<SymbolId>

Get candidate symbol IDs by name.