Struct GraphSnapshot 

pub struct GraphSnapshot { /* private fields */ }

Immutable snapshot of a CodeGraph for long-running queries.

GraphSnapshot holds Arc references to the graph components, providing a consistent view that is isolated from concurrent mutations.

Design

Snapshots are created via CodeGraph::snapshot() or ConcurrentCodeGraph::snapshot(). They are:

• Immutable: No mutation methods available
• Isolated: Independent of future graph mutations
• Cheap: Only Arc clones, no data copying
• Self-contained: Can outlive the original graph/lock

Usage

use sqry_core::graph::unified::concurrent::{ConcurrentCodeGraph, GraphSnapshot};

let graph = ConcurrentCodeGraph::new();

// Create snapshot for a long query
let snapshot: GraphSnapshot = graph.snapshot();

// Snapshot can be used independently
let _epoch = snapshot.epoch();

Implementations

impl GraphSnapshot

pub fn nodes(&self) -> &NodeArena

Returns a reference to the node arena.

pub fn edges(&self) -> &BidirectionalEdgeStore

Returns a reference to the bidirectional edge store.

pub fn strings(&self) -> &StringInterner

Returns a reference to the string interner.

pub fn files(&self) -> &FileRegistry

Returns a reference to the file registry.

pub fn indices(&self) -> &AuxiliaryIndices

Returns a reference to the auxiliary indices.

pub fn epoch(&self) -> u64

Returns the epoch at which this snapshot was taken.

This can be compared against the current graph epoch to detect if the graph has changed since the snapshot.

pub fn epoch_matches(&self, other_epoch: u64) -> bool

Returns true if this snapshot’s epoch matches the given epoch.

Use this to validate cursors before continuing pagination.

pub fn find_by_pattern(&self, pattern: &str) -> Vec<NodeId>

Finds nodes matching a pattern.

Performs a simple substring match on node names and qualified names. Returns all matching node IDs.

Performance

Optimized to iterate over unique strings in the interner (smaller set) rather than all nodes in the arena.

Arguments

• pattern - The pattern to match (substring search)

Returns

A vector of NodeIds for all matching nodes.

pub fn get_callees(&self, node: NodeId) -> Vec<NodeId>

Gets all callees of a node (functions called by this node).

Queries the forward edge store for all Calls edges from this node.

Arguments

• node - The node ID to query

Returns

A vector of NodeIds representing functions called by this node.

pub fn get_callers(&self, node: NodeId) -> Vec<NodeId>

Gets all callers of a node (functions that call this node).

Queries the reverse edge store for all Calls edges to this node.

Arguments

• node - The node ID to query

Returns

A vector of NodeIds representing functions that call this node.

pub fn iter_nodes(&self) -> impl Iterator<Item = (NodeId, &NodeEntry)>

Iterates over all nodes in the graph.

Returns an iterator yielding (NodeId, &NodeEntry) pairs for all occupied slots in the arena.

Returns

An iterator over (NodeId, &NodeEntry) pairs.

pub fn iter_edges( &self, ) -> impl Iterator<Item = (NodeId, NodeId, EdgeKind)> + '_

Iterates over all edges in the graph.

Returns an iterator yielding (source, target, EdgeKind) tuples for all edges in the forward edge store.

Returns

An iterator over edge tuples.

pub fn get_node(&self, id: NodeId) -> Option<&NodeEntry>

Gets a node entry by ID.

Returns a reference to the NodeEntry if the ID is valid, or None if the ID is invalid or stale.

Arguments

• id - The node ID to look up

Returns

A reference to the NodeEntry, or None if not found.

impl GraphSnapshot

pub fn resolve_symbol(&self, query: &SymbolQuery<'_>) -> SymbolResolutionOutcome

Resolves one symbol with explicit file-aware outcome classification.

pub fn find_symbol_candidates( &self, query: &SymbolQuery<'_>, ) -> SymbolCandidateOutcome

Finds ordered candidates from the first eligible non-empty bucket.

pub fn resolve_file_scope( &self, file_scope: &FileScope<'_>, ) -> Result<ResolvedFileScope, FileScopeError>

Resolves an external file scope into an indexed file scope.

Errors

Returns FileScopeError::FileNotIndexed when the requested file scope is not present in the loaded graph indices.

pub fn normalize_symbol_query( &self, query: &SymbolQuery<'_>, file_scope: &ResolvedFileScope, ) -> NormalizedSymbolQuery

Normalizes a raw symbol query into canonical graph form.

Trait Implementations

impl Clone for GraphSnapshot

fn clone(&self) -> GraphSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphSnapshot

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

Formats the value using the given formatter.