Struct ContextIndex 

pub struct ContextIndex { /* private fields */ }

Dedicated cross-structure inverted index for context search.

Uses a reverse index (entity_id → keys) so that removal is O(k) where k is the number of tokens for that entity, instead of O(total_tokens).

Implementations

impl ContextIndex

pub fn new() -> Self

Create a new empty context index.

pub fn set_collection_enabled(&self, collection: &str, enabled: bool)

Opt a collection in or out of context indexing. Driven by CREATE TABLE ... WITH context_index = true at DDL time.

pub fn is_collection_enabled(&self, collection: &str) -> bool

Whether writes to this collection should land in the index.

pub fn index_entity(&self, collection: &str, entity: &UnifiedEntity)

Index an entity — extracts tokens and field:value pairs into posting lists.

pub fn index_entities<'a, I>(&self, collection: &str, entities: I)

where I: IntoIterator<Item = &'a UnifiedEntity>,

Batch variant of index_entity that amortizes lock traffic across multiple rewrites.

pub fn remove_entity(&self, entity_id: EntityId)

Remove all postings for an entity. O(k) where k = entity’s token count.

pub fn search( &self, query: &str, limit: usize, allowed_collections: Option<&BTreeSet<String>>, ) -> Vec<ContextSearchHit>

Search by tokens — tokenizes the query, looks up posting lists, and scores by overlap.

pub fn search_bm25( &self, query: &str, limit: usize, allowed_collections: Option<&BTreeSet<String>>, ) -> Vec<ContextSearchHit>

Search by tokens using BM25-style sparse ranking.

The index stores one posting per unique entity token, so term frequency is binary. IDF and document-length normalization still give ASK/text retrieval a real sparse ranker instead of the legacy overlap fraction.

pub fn search_field( &self, field: &str, value: &str, exact: bool, limit: usize, allowed_collections: Option<&BTreeSet<String>>, ) -> Vec<ContextSearchHit>

Search by field:value — direct lookup in the field-value index.

pub fn stats(&self) -> ContextIndexStats

Return index statistics.

Trait Implementations

impl Default for ContextIndex

fn default() -> Self

Returns the “default value” for a type.