Struct CallGraph 

pub struct CallGraph { /* private fields */ }

Worktree-scoped call graph with lazy per-file construction.

Files are parsed and analyzed on first access, then cached. The graph can resolve cross-file call edges using the import engine.

Implementations

impl CallGraph

pub fn new(project_root: PathBuf) -> Self

Create a new call graph for a project.

pub fn project_root(&self) -> &Path

Get the project root directory.

pub fn build_file(&mut self, path: &Path) -> Result<&FileCallData, AftError>

Get or build the call data for a file.

pub fn resolve_cross_file_edge( &mut self, full_callee: &str, short_name: &str, caller_file: &Path, import_block: &ImportBlock, ) -> EdgeResolution

Resolve a cross-file call edge.

Given a callee expression and the calling file’s import block, determines which file and symbol the call targets.

pub fn forward_tree( &mut self, file: &Path, symbol: &str, max_depth: usize, ) -> Result<CallTreeNode, AftError>

Depth-limited forward call tree traversal.

Starting from a (file, symbol) pair, recursively follows calls up to max_depth levels. Uses a visited set for cycle detection.

pub fn project_files(&mut self) -> &[PathBuf]

Get all project files (lazily discovered).

pub fn callers_of( &mut self, file: &Path, symbol: &str, depth: usize, ) -> Result<CallersResult, AftError>

Get callers of a symbol in a file, grouped by calling file.

Builds the reverse index on first call (scans all project files). Supports recursive depth expansion: depth=1 returns direct callers, depth=2 returns callers-of-callers, etc. depth=0 is treated as 1.

pub fn trace_to( &mut self, file: &Path, symbol: &str, max_depth: usize, ) -> Result<TraceToResult, AftError>

Trace backward from a symbol to all entry points.

Returns complete paths (top-down: entry point first, target last). Uses BFS backward through the reverse index, with per-path cycle detection and depth limiting.

pub fn impact( &mut self, file: &Path, symbol: &str, depth: usize, ) -> Result<ImpactResult, AftError>

Impact analysis: enriched callers query.

Returns all call sites affected by a change to the given symbol, annotated with each caller’s signature, entry point status, the source line at the call site, and extracted parameter names.

pub fn trace_data( &mut self, file: &Path, symbol: &str, expression: &str, max_depth: usize, ) -> Result<TraceDataResult, AftError>

Trace how an expression flows through variable assignments within a function body and across function boundaries via argument-to-parameter matching.

Algorithm:

1. Parse the function body, find the expression text.
2. Walk AST for assignments that reference the tracked name.
3. When the tracked name appears as a call argument, resolve the callee, match argument position to parameter name, recurse.
4. Destructuring, spread, and unresolved calls produce approximate hops.

pub fn invalidate_file(&mut self, path: &Path)

Invalidate a file: remove its cached data and clear the reverse index.

Called by the file watcher when a file changes on disk. The reverse index is rebuilt lazily on the next callers_of call.