Struct KnowledgeStore 

pub struct KnowledgeStore<S, V, E> { /* private fields */ }

Composes a [Store], a [VectorIndex], and an [Embedder] into one retrieval surface keyed by RecordKey.

Implementations

impl<S: Store, V: VectorIndex, E: Embedder> KnowledgeStore<S, V, E>

pub fn new(store: S, index: V, embedder: E) -> Self

pub fn store(&self) -> &S

Borrow the underlying store (e.g. to put records before ingesting them).

pub async fn ingest(&self, key: &RecordKey) -> Result<bool>

Ingest the record at key: split it into per-kind chunks, embed each, and index it under a derived per-chunk key. Returns Ok(false) (without indexing) if the record is absent or its kind is definitionally not knowledge-bearing; returns Err if a knowledge-bearing body fails to parse — a corrupt record is a real failure, not “not indexable” (#139).

pub async fn remove(&self, key: &RecordKey) -> Result<()>

De-index the record at key: remove every chunk vector it contributed to the index and forget its chunk count. This is the counterpart to a record being deleted from the store — without it, the record’s chunk vectors are orphaned, still matching in [query] but de-duping to a parent that no longer resolves, so they silently shrink the result set (#150).

Idempotent: removing a record that was never ingested (chunk count 0) removes nothing. Uses the same [chunk_key] derivation as [ingest].

pub async fn query( &self, text: &str, k: usize, filter: &KeyPrefix, ) -> Result<Vec<Hit>>

Semantic query, one hit per record. Embed text, over-fetch chunk matches (restricted to filter), collapse them to their parent records keeping each record’s best chunk score, and return the top-k records.

Because a record with many matching chunks can crowd the over-fetch window, pathological cases may return fewer than k hits.

pub async fn query_chunks( &self, text: &str, k: usize, filter: &KeyPrefix, ) -> Result<Vec<ChunkHit>>

Chunk-granular query: the top-k matching chunks (restricted to filter), not de-duped to their parents. Each hit carries the parent record, the chunk’s ordinal, and the chunk’s text.