Struct SessionGraph 

pub struct SessionGraph { /* private fields */ }

A delta-based semantic graph for a single session workspace.

Lookups resolve in order: removed -> modified -> added -> base. This gives each session a consistent, isolated view of the symbol graph without copying the entire base.

Implementations

impl SessionGraph

pub fn fork_from(base: Arc<ArcSwap<HashMap<SymbolId, Symbol>>>) -> Self

Fork from a shared base symbol table.

pub fn empty() -> Self

Create an empty session graph (no shared base).

pub fn get_symbol(&self, id: SymbolId) -> Option<Symbol>

Look up a symbol by ID, respecting the session delta.

Resolution order:

1. If removed in this session, return None.
2. If modified in this session, return the modified version.
3. If added in this session, return it.
4. Fall through to the shared base.

pub fn add_symbol(&self, symbol: Symbol)

Add a new symbol to this session.

pub fn modify_symbol(&self, symbol: Symbol)

Modify an existing symbol (base or previously added).

pub fn remove_symbol(&self, id: SymbolId)

Remove a symbol from the session view.

pub fn add_edge(&self, edge: CallEdge)

Add a call edge.

pub fn remove_edge(&self, edge_id: Uuid)

Remove a call edge.

pub fn get_edge(&self, edge_id: Uuid) -> Option<CallEdge>

Look up an added edge by ID.

Returns None if the edge was not added in this session or has been removed.

pub fn is_edge_removed(&self, edge_id: Uuid) -> bool

Returns true if the given edge ID is marked as removed in this session.

pub fn changed_symbol_names(&self) -> Vec<String>

Return the names of all symbols changed in this session (added, modified, or removed).

Used by the conflict detector to find overlapping changes.

pub fn update_from_parse( &self, _file_path: &str, new_symbols: Vec<Symbol>, base_symbols_for_file: &[Symbol], )

Update the session graph from a parse result for a single file.

Compares the new symbols against the base symbols for that file, and classifies each as added, modified, or removed within the session delta.

base_symbols_for_file should contain all symbols from the base that belong to the given file path.

pub fn changed_symbols_for_file(&self, file_path: &str) -> Vec<String>

Return the names of symbols changed in this session that belong to the given file path. Useful for cross-session file awareness.

pub fn change_count(&self) -> usize

Number of symbols changed (added + modified + removed).

pub fn to_msgpack(&self) -> Result<Vec<u8>>

Serialize the session delta (modified/added/removed symbols and edges) to MessagePack bytes.

The shared base_symbols table is NOT included — it is repo-wide state managed independently of individual sessions.

pub fn from_msgpack(bytes: &[u8]) -> Result<Self>

Deserialize a session delta from MessagePack bytes produced by Self::to_msgpack.

The returned graph has no shared base (base_symbols is None). Callers that need base-symbol lookups must call Self::fork_from and replay the delta on top.