Struct Snapshot 

pub struct Snapshot {
    pub snapshot_version: String,
    pub timestamp: String,
    pub commit: Option<String>,
    pub graph: GraphMetrics,
    pub partition: LeidenPartition,
    pub catalog: PatternCatalog,
    pub pattern_metrics: PatternMetricsResult,
    pub intent_divergence: Option<IntentDivergenceInfo>,
    pub path_partition: BTreeMap<String, u32>,
    pub change_coupling: Option<ChangeCouplingResult>,
}

A versioned snapshot of all pipeline stage outputs for one point in time.

Examples

use std::collections::BTreeMap;
use sdivi_snapshot::snapshot::{assemble_snapshot, PatternMetricsResult, SNAPSHOT_VERSION};
use sdivi_graph::metrics::GraphMetrics;
use sdivi_detection::partition::LeidenPartition;
use sdivi_patterns::PatternCatalog;

let graph = GraphMetrics {
    node_count: 0, edge_count: 0, density: 0.0,
    cycle_count: 0, top_hubs: vec![], component_count: 0,
};
let partition = LeidenPartition {
    assignments: BTreeMap::new(), stability: BTreeMap::new(),
    modularity: 0.0, seed: 42,
};
let snap = assemble_snapshot(
    graph, partition, PatternCatalog::default(),
    PatternMetricsResult::default(), None,
    "2026-04-29T00:00:00Z", None, None, 0,
);
assert_eq!(snap.snapshot_version, SNAPSHOT_VERSION);

Fields

snapshot_version: String

Always "1.0" for sdivi-rust output.

timestamp: String

ISO 8601 UTC timestamp at which the snapshot was taken.

commit: Option<String>

Git commit SHA at the time of the snapshot, when available.

graph: GraphMetrics

Graph metrics computed from the dependency graph.

partition: LeidenPartition

Leiden community detection result.

catalog: PatternCatalog

Pattern fingerprint catalog with per-category entropy.

pattern_metrics: PatternMetricsResult

Pattern metrics (entropy, convention drift) for this snapshot.

intent_divergence: Option<IntentDivergenceInfo>

Intent divergence against the caller-declared boundaries.

None (omitted from JSON) when no boundary count was supplied to assemble_snapshot (typically because .sdivi/boundaries.yaml was not present).

path_partition: BTreeMap<String, u32>

File-path → community-ID assignments for boundary inference.

Maps each source file’s repo-relative path to its community ID from the Leiden partition at snapshot time. Populated by sdivi-pipeline from the DependencyGraph + LeidenPartition. Absent (empty) in snapshots produced without path context (e.g., pure-compute path); boundary inference from such snapshots yields no proposals.

change_coupling: Option<ChangeCouplingResult>

Change-coupling analysis result.

None when the repo has no git history or history_depth = 0. #[serde(default)] ensures M14-era snapshots deserialize as None.

Trait Implementations

impl Clone for Snapshot

fn clone(&self) -> Snapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Snapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Snapshot

fn deserialize<__D>( __deserializer: __D, ) -> Result<Snapshot, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Snapshot

fn eq(&self, other: &Snapshot) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Snapshot

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Snapshot