Struct GraphBuilder 

pub struct GraphBuilder { /* private fields */ }

Builder for incremental graph construction from extraction results.

Implementations

impl GraphBuilder

pub fn new(snapshot_id: SnapshotId) -> Self

Creates a new GraphBuilder for the given snapshot.

pub fn add_file(&mut self, path: PathBuf, language: LangId) -> FileId

Adds a file node to the graph.

If the file already exists (determined by path), returns the existing FileId.

pub fn add_symbol(&mut self, symbol: &Symbol) -> Result<NodeIndex, Error>

Adds a symbol node and its ownership edge to the containing file.

The containing file must already exist in the builder. The symbol’s file path is resolved against registered files.

Returns the NodeIndex for the symbol node.

pub fn add_import(&mut self, from: FileId, to: PathBuf)

Adds an import edge from one file to another.

If the target file exists in the project, creates an import edge. If the target is external (not in the project), creates an ExternalNode placeholder and an import edge to it.

pub fn add_reference(&mut self, from: SymbolId, to: SymbolId, confidence: f32)

Adds a reference edge between two symbols with a confidence score.

Both symbols must exist in the builder. If a duplicate edge already exists, the confidence is merged via max (the stronger signal is preserved).

pub fn file_id_for_path(&self, path: &PathBuf) -> Option<FileId>

Returns the FileId for a given file path, if registered.

pub fn import_adjacency(&self) -> HashMap<FileId, Vec<FileId>>

Builds and returns an adjacency map from FileId to the FileIds it imports.

Walks all Import edges in the graph to produce the relationship.

pub fn build(self) -> CodeGraph

Finalizes the graph and returns the constructed CodeGraph.

pub fn node_count(&self) -> usize

Returns the number of nodes in the graph so far.

pub fn edge_count(&self) -> usize

Returns the number of edges in the graph so far.

pub fn external_count(&self) -> usize

Returns the number of external dependency nodes.

pub fn from_extractions<F>( extractions: &[F], root: &Path, snapshot_id: SnapshotId, diagnostics: &mut Vec<Diagnostic>, ) -> (CodeGraph, SccAnalysis)

where F: Borrow<FileExtraction> + Sync,

Assemble a complete CodeGraph + SCC from parallel extraction results.

Replaces the manual multi-step wiring in pipeline.rs. Handles:

• File and symbol node registration
• Import edge resolution (via language-specific resolvers)
• Cross-file reference resolution via FlattenedScopeCache
• SCC analysis

Errors during symbol addition are non-fatal and appended to diagnostics.

pub fn from_extractions_with_scope<F>( extractions: &[F], root: &Path, snapshot_id: SnapshotId, diagnostics: &mut Vec<Diagnostic>, ) -> (CodeGraph, SccAnalysis, FlattenedScopeCache)

where F: Borrow<FileExtraction> + Sync,

Build the graph, the SCC, the scope cache, and the resolved references.

pub fn from_extractions_detailed<F>( extractions: &[F], root: &Path, snapshot_id: SnapshotId, diagnostics: &mut Vec<Diagnostic>, ) -> AnalysisParts

where F: Borrow<FileExtraction> + Sync,

Build everything one analysis pass produces from a set of extractions.

Stages: file and symbol node registration, import edge resolution, cross file reference resolution with the flattened scope cache, client-call edge injection, and SCC analysis. Errors during symbol addition are non-fatal and appended to diagnostics. Both the one-shot and the incremental entry point call this, so the analysis of a tree cannot depend on which entry point produced it.

Trait Implementations

impl Debug for GraphBuilder

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

Formats the value using the given formatter.