Enum Backend 

pub enum Backend {
    Sqlite(SqliteBackend),
}

Runtime backend dispatcher.

Wraps either SqliteBackend or NativeV3Backend and delegates Backend trait methods to the appropriate implementation based on database format detection.

Variants

Sqlite(SqliteBackend)

SQLite storage backend (traditional, always available)

Implementations

impl Backend

pub fn detect_and_open(db_path: &Path) -> Result<Self, LlmError>

Detect backend format from database file and open appropriate backend.

Checks file header magic bytes to distinguish between:

• V3 backend: “SQLTGF” header (SQLiteGraph native format)
• SQLite backend: “SQLite format 3\0” header

Arguments

• db_path - Path to the database file

Returns

• Ok(Backend) - Appropriate backend variant based on file header detection
• Err(LlmError::NativeV3BackendNotSupported) - Native-V3 detected but feature not enabled
• Err(LlmError::BackendDetectionFailed) - Detection failed

pub fn search_symbols( &self, options: SearchOptions<'_>, ) -> Result<(SearchResponse, bool, bool), LlmError>

Delegate search_symbols to inner backend.

pub fn search_references( &self, options: SearchOptions<'_>, ) -> Result<(ReferenceSearchResponse, bool), LlmError>

Delegate search_references to inner backend.

pub fn search_calls( &self, options: SearchOptions<'_>, ) -> Result<(CallSearchResponse, bool), LlmError>

Delegate search_calls to inner backend.

pub fn ast( &self, file: &Path, position: Option<usize>, limit: usize, ) -> Result<Value, LlmError>

Delegate ast to inner backend.

pub fn find_ast(&self, kind: &str) -> Result<Value, LlmError>

Delegate find_ast to inner backend.

pub fn complete( &self, prefix: &str, limit: usize, ) -> Result<Vec<String>, LlmError>

Get FQN completions for a prefix.

This method is only available with native-v3 backend. SQLite backend returns RequiresNativeV3Backend error.

pub fn lookup(&self, fqn: &str, db_path: &str) -> Result<SymbolMatch, LlmError>

Lookup symbol by exact FQN.

This method is only available with native-v3 backend. SQLite backend returns RequiresNativeV3Backend error.

pub fn search_by_label( &self, label: &str, limit: usize, db_path: &str, ) -> Result<(SearchResponse, bool, bool), LlmError>

Search for symbols by label.

This method is only available with native-v3 backend. SQLite backend returns RequiresNativeV3Backend error.

Trait Implementations

impl Debug for Backend

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

Formats the value using the given formatter.