Struct KnowledgeBaseBuilder 

pub struct KnowledgeBaseBuilder { /* private fields */ }

Incrementally builds and maintains a semantic knowledge base.

Supports entities, directed semantic relations, concept co-occurrence graphs, and document ingestion.

Implementations

impl KnowledgeBaseBuilder

pub fn new() -> Self

Create an empty KnowledgeBaseBuilder.

pub fn add_entity(&mut self, entity: KbBuilderEntity) -> Result<(), KbError>

Add a new entity to the knowledge base.

Returns KbError::EntityAlreadyExists if an entity with the same ID was previously registered. Also registers all aliases in the alias index.

pub fn update_entity( &mut self, entity_id: &str, update_fn: impl FnOnce(&mut KbBuilderEntity), ) -> Result<(), KbError>

Apply an in-place mutation to an existing entity.

Returns KbError::EntityNotFound if the ID is not registered. After mutation, re-indexes all aliases (including the primary name).

pub fn remove_entity(&mut self, entity_id: &str) -> bool

Remove an entity and all relations that involve it.

Returns true if the entity existed.

pub fn add_relation( &mut self, triple: KbTriple, confidence: f64, source: String, now: u64, ) -> Result<String, KbError>

Add a semantic relation from a triple.

Validates that both subject and object entities exist. The relation ID is the FNV-1a hash of subject_id + predicate + object_id.

Returns the relation ID on success. Returns KbError::RelationAlreadyExists if the same triple was already added.

pub fn remove_relation(&mut self, relation_id: &str) -> bool

Remove the relation with the given ID.

Returns true if it existed.

pub fn add_document(&mut self, doc: KbDocument) -> Result<(), KbError>

Ingest a document into the knowledge base.

Updates the concept graph for each concept in the document: increments frequency, records the document ID, and adds co-occurrence edges to every other concept in the same document.

Returns KbError::DocumentAlreadyExists if the doc_id is taken.

pub fn find_entity_by_name(&self, name: &str) -> Option<&KbBuilderEntity>

Look up an entity by its primary name or any registered alias.

The comparison is case-insensitive.

pub fn find_entity_by_alias(&self, alias: &str) -> Option<&KbBuilderEntity>

Look up an entity via the alias index (case-insensitive).

pub fn relations_for_entity(&self, entity_id: &str) -> Vec<&KbRelation>

All relations where the entity is the subject or the object.

pub fn outgoing_relations(&self, entity_id: &str) -> Vec<&KbRelation>

Relations where entity_id is the subject (outgoing).

pub fn incoming_relations(&self, entity_id: &str) -> Vec<&KbRelation>

Relations where entity_id is the object (incoming).

pub fn entity_neighbors(&self, entity_id: &str) -> Vec<&KbBuilderEntity>

Entities directly connected to entity_id via any relation (neighbours).

pub fn path_between( &self, from_id: &str, to_id: &str, max_hops: usize, ) -> Option<Vec<String>>

Find the shortest path between two entities via BFS over relations.

Returns a sequence of entity IDs (inclusive of from_id and to_id), or None if no path exists within max_hops.

pub fn top_concepts(&self, n: usize) -> Vec<&KbConceptNode>

Return the top n concept nodes by frequency, descending.

pub fn concept_cooccurrence(&self, concept_a: &str, concept_b: &str) -> usize

Count how many documents mention both concept_a and concept_b.

pub fn entity_count(&self) -> usize

Number of entities in the knowledge base.

pub fn relation_count(&self) -> usize

Number of relations in the knowledge base.

pub fn document_count(&self) -> usize

Number of documents ingested.

pub fn stats(&self) -> KbStats

Compute aggregate statistics for the knowledge base.

pub fn entities(&self) -> &HashMap<String, KbBuilderEntity>

Direct read access to the entity map.

pub fn relations(&self) -> &[KbRelation]

Direct read access to the relation list.

pub fn concept_graph(&self) -> &HashMap<String, KbConceptNode>

Direct read access to the concept graph.

pub fn documents(&self) -> &HashMap<String, KbDocument>

Direct read access to the document map.

Trait Implementations

impl Debug for KnowledgeBaseBuilder

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

Formats the value using the given formatter.

impl Default for KnowledgeBaseBuilder

fn default() -> KnowledgeBaseBuilder

Returns the “default value” for a type.