Struct SemanticGraph 

pub struct SemanticGraph { /* private fields */ }

The unified knowledge graph: every entity and relationship produced by any kopitiam_ontology-speaking provider, merged into one structure.

This type is storage-agnostic on purpose. It holds no file handles and makes no assumptions about where it is persisted — it derives Serialize/Deserialize so kopitiam-index (or anything else) can snapshot it without kopitiam-knowledge depending on a storage engine.

Implementations

impl SemanticGraph

pub fn new() -> Self

pub fn insert_entity(&mut self, entity: Entity) -> EntityId

Inserts one entity, keyed by its own EntityId. Re-inserting an id already present overwrites the previous entity.

pub fn insert_relationship( &mut self, relationship: Relationship, ) -> RelationshipId

Inserts one relationship and indexes it for traversal in both directions.

pub fn extend( &mut self, entities: impl IntoIterator<Item = Entity>, relationships: impl IntoIterator<Item = Relationship>, )

Merges a batch of facts from a provider run in one call — the usual entry point after calling a kopitiam_semantic::KnowledgeProvider.

pub fn entity(&self, id: EntityId) -> Option<&Entity>

pub fn relationship(&self, id: RelationshipId) -> Option<&Relationship>

pub fn entity_count(&self) -> usize

pub fn relationship_count(&self) -> usize

pub fn entities(&self) -> impl Iterator<Item = &Entity>

pub fn entities_of_kind( &self, kind: EntityKind, ) -> impl Iterator<Item = &Entity>

pub fn relationships_from( &self, id: EntityId, ) -> impl Iterator<Item = &Relationship>

Relationships whose from is id.

pub fn relationships_to( &self, id: EntityId, ) -> impl Iterator<Item = &Relationship>

Relationships whose to is id.

Trait Implementations

impl Clone for SemanticGraph

fn clone(&self) -> SemanticGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticGraph

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

Formats the value using the given formatter.

impl Default for SemanticGraph

fn default() -> SemanticGraph

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SemanticGraph

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SemanticGraph

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.