Struct ComparativeQueryDb 

pub struct ComparativeQueryDb { /* private fields */ }

A lightweight wrapper holding two GraphSnapshots for cross-snapshot operations like semantic_diff.

Comparative queries are NOT cached (they are inherently one-shot cross-snapshot operations), so this type bypasses the ShardedCache entirely.

Usage

use sqry_db::comparative::{ComparativeQueryDb, DiffOptions};

let cmp = ComparativeQueryDb::new(old_snapshot, new_snapshot);
let out = cmp.diff(&DiffOptions::default()); // uncached, one-shot

Implementations

impl ComparativeQueryDb

pub fn new(old: Arc<GraphSnapshot>, new: Arc<GraphSnapshot>) -> Self

Creates a new comparative DB from two snapshots.

pub fn old(&self) -> &GraphSnapshot

Returns the “before” snapshot.

pub fn new_snapshot(&self) -> &GraphSnapshot

Returns the “after” snapshot.

pub fn old_arc(&self) -> Arc<GraphSnapshot>

Returns the “before” snapshot as an Arc.

pub fn new_arc(&self) -> Arc<GraphSnapshot>

Returns the “after” snapshot as an Arc.

pub fn diff(&self, opts: &DiffOptions) -> DiffOutput

Computes the semantic diff between the two snapshots.

This is an uncached, one-shot operation. Results are NOT memoized by the ShardedCache because cross-snapshot results have no meaningful invalidation criterion (the two snapshots are immutable, and no single-snapshot dependency bump would ever reinvalidate their diff).

Pass the worktree roots via DiffOptions so per-file paths are prefixed back to absolute worktree locations. Callers that do not need worktree prefixing (e.g. unit tests or CLI callers that already hold workspace-relative paths) may use Self::diff_default.

pub fn diff_default(&self) -> DiffOutput

Computes the semantic diff using default options (no worktree prefixing). See Self::diff for the full semantics.