Struct KnowledgeGraph 

pub struct KnowledgeGraph { /* private fields */ }

The main knowledge graph container.

Implementations

impl KnowledgeGraph

pub fn new() -> Self

Creates a new empty knowledge graph.

pub fn item_count(&self) -> usize

Returns the number of items in the graph.

pub fn relationship_count(&self) -> usize

Returns the number of relationships in the graph.

pub fn get(&self, id: &ItemId) -> Option<&Item>

Gets an item by ID.

pub fn get_mut(&mut self, id: &ItemId) -> Option<&mut Item>

Gets a mutable reference to an item by ID.

pub fn contains(&self, id: &ItemId) -> bool

Checks if an item exists in the graph.

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

Returns all items in the graph.

pub fn item_ids(&self) -> impl Iterator<Item = &ItemId>

Returns all item IDs in the graph.

pub fn items_by_type(&self, item_type: ItemType) -> Vec<&Item>

Returns all items of a specific type.

pub fn count_by_type(&self) -> HashMap<ItemType, usize>

Returns the count of items by type.

pub fn parents(&self, id: &ItemId) -> Vec<&Item>

Returns direct parents of an item (items that this item relates to upstream).

pub fn children(&self, id: &ItemId) -> Vec<&Item>

Returns direct children of an item (items that relate to this item downstream).

pub fn orphans(&self) -> Vec<&Item>

Returns all items with no upstream parents (potential orphans).

pub fn inner(&self) -> &DiGraph<Item, RelationshipType>

Returns the underlying petgraph for advanced operations.

pub fn inner_mut(&mut self) -> &mut DiGraph<Item, RelationshipType>

Returns a mutable reference to the underlying petgraph.

pub fn node_index(&self, id: &ItemId) -> Option<NodeIndex>

Returns the node index for an item ID.

pub fn relationships(&self) -> Vec<(ItemId, ItemId, RelationshipType)>

Returns all relationships in the graph.

pub fn lookup(&self, id: &str) -> LookupResult<'_>

Looks up an item by ID.

If the item is not found, returns suggestions for similar IDs.

pub fn lookup_or_suggest(&self, id: &str) -> Result<&Item, SaraError>

Looks up an item by ID, returning suggestions if not found.

Returns a SaraError::ItemNotFound with similar ID suggestions when the item is missing.

pub fn find_similar_ids( &self, query: &str, max_suggestions: usize, ) -> Vec<String>

Finds item IDs similar to the given query string using Levenshtein distance.

Returns up to max_suggestions similar item IDs, sorted by distance. Only includes suggestions with a reasonable edit distance.

pub fn check_parent_exists(&self, item_type: ItemType) -> Result<(), SaraError>

Checks if parent items exist for the given item type.

Solution has no parent requirement and always returns Ok.

Trait Implementations

impl Debug for KnowledgeGraph

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

Formats the value using the given formatter.

impl Default for KnowledgeGraph

fn default() -> Self

Returns the “default value” for a type.