Struct UnifiedGraphStore 

pub struct UnifiedGraphStore {
    pub codebase_path: PathBuf,
    pub db_path: PathBuf,
    pub backend_kind: BackendKind,
    /* private fields */
}

Unified graph store supporting dual backends.

This provides graph storage for symbols and references with the user’s choice of SQLite or Native V3 backend. Both backends expose the same functionality through a unified API.

Fields

codebase_path: PathBuf

Path to codebase

db_path: PathBuf

Path to database file

backend_kind: BackendKind

Active backend kind

Implementations

impl UnifiedGraphStore

pub async fn open( codebase_path: impl AsRef<Path>, backend_kind: BackendKind, ) -> Result<Self>

Opens a graph store with the specified backend.

Arguments

• codebase_path - Path to codebase directory
• backend_kind - Which backend to use (SQLite or NativeV3)

Returns

A UnifiedGraphStore instance or an error if initialization fails

pub async fn open_with_path( codebase_path: impl AsRef<Path>, db_path: impl AsRef<Path>, backend_kind: BackendKind, ) -> Result<Self>

Opens a graph store with a custom database path.

Arguments

• codebase_path - Path to codebase directory
• db_path - Custom path for database file
• backend_kind - Which backend to use

pub fn backend_kind(&self) -> BackendKind

Returns the backend kind currently in use.

pub fn db_path(&self) -> &Path

Returns the path to the database file.

pub fn is_connected(&self) -> bool

Returns true if the database file exists.

pub async fn insert_symbol(&self, _symbol: &Symbol) -> Result<SymbolId>

Insert a symbol into the graph.

Arguments

• symbol - The symbol to insert

Returns

The assigned symbol ID

pub async fn insert_reference(&self, reference: &Reference) -> Result<()>

Insert a reference between symbols.

Arguments

• reference - The reference to insert

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

Query symbols by name pattern.

Arguments

• name - Name pattern to search for

Returns

List of matching symbols

pub async fn get_symbol(&self, _id: SymbolId) -> Result<Symbol>

Get a symbol by ID.

Arguments

• id - The symbol ID

Returns

The symbol or an error if not found

pub async fn symbol_exists(&self, _id: SymbolId) -> Result<bool>

Check if a symbol exists.

Arguments

• id - The symbol ID to check

pub async fn query_references( &self, symbol_id: SymbolId, ) -> Result<Vec<Reference>>

Query references for a specific symbol.

Arguments

• symbol_id - The symbol to find references for

Returns

List of references where this symbol is the target. For Native V3 backend, this includes cross-file references.

pub async fn get_all_symbols(&self) -> Result<Vec<Symbol>>

Get all symbols in the graph.

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

Get count of symbols in the graph.

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

Scans and indexes cross-file references for Native V3 backend.

This is a capability that Native V3 enables over SQLite. It uses magellan’s native cross-file reference indexing.

Note: With the updated magellan, cross-file references are automatically indexed during the normal index_references call. This method is kept for API compatibility but delegates to magellan.

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

Query references by symbol name (for Native V3 backend). This enables cross-file references that magellan doesn’t support.

Trait Implementations

impl Clone for UnifiedGraphStore

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnifiedGraphStore

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

Formats the value using the given formatter.