Struct GraphModule 

pub struct GraphModule { /* private fields */ }

Graph module for symbol and reference queries.

Examples

See crate-level documentation for usage examples.

Implementations

impl GraphModule

pub fn store(&self) -> &UnifiedGraphStore

Get the underlying store for advanced operations

pub async fn find_symbol(&self, name: &str) -> Result<Vec<Symbol>>

Finds symbols by name.

Arguments

• name - The symbol name to search for

Returns

A vector of matching symbols

pub async fn find_symbol_by_id(&self, id: SymbolId) -> Result<Symbol>

Finds a symbol by its stable ID.

Arguments

• id - The symbol identifier

Returns

The symbol with the given ID

pub async fn callers_of(&self, name: &str) -> Result<Vec<Reference>>

Finds all callers of a symbol.

Arguments

• name - The symbol name

Returns

A vector of references that call this symbol

pub async fn references(&self, name: &str) -> Result<Vec<Reference>>

Finds all references to a symbol.

Arguments

• name - The symbol name

Returns

A vector of all references (calls, uses, type refs). Uses SQL-based graph queries for accurate cross-file reference resolution.

pub async fn reachable_from(&self, id: SymbolId) -> Result<Vec<SymbolId>>

Finds all symbols reachable from a given symbol.

Uses BFS traversal to find all symbols that can be reached from the starting symbol through the call graph.

Arguments

• id - The starting symbol ID

Returns

A vector of reachable symbol IDs

pub async fn cycles(&self) -> Result<Vec<Cycle>>

Detects cycles in the call graph.

Uses DFS-based cycle detection to find all strongly connected components (cycles) in the call graph.

Returns

A vector of detected cycles

pub async fn symbol_count(&self) -> Result<usize>

Returns the number of symbols in the graph.

pub async fn impact_analysis( &self, symbol_name: &str, max_hops: Option<u32>, ) -> Result<Vec<ImpactedSymbol>>

Analyze the impact of changing a symbol.

Performs k-hop traversal to find all symbols that would be affected by modifying the given symbol.

Arguments

• symbol_name - The name of the symbol to analyze
• max_hops - Maximum traversal depth (default: 2)

Returns

A vector of impacted symbols with their hop distance from the target

pub async fn index(&self) -> Result<()>

Indexes the codebase using magellan.

This runs the magellan indexer to extract symbols and references from the codebase and populate the graph database.

For Native V3 backend, also indexes cross-file references using sqlitegraph directly (a capability SQLite doesn’t support).

Returns

Ok(()) on success, or an error if indexing fails.

Trait Implementations

impl Clone for GraphModule

fn clone(&self) -> GraphModule

Returns a duplicate of the value.

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

Performs copy-assignment from source.