sdivi-cli 0.2.16

Command-line interface for the Structural Divergence Indexer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! `sdivi snapshot` — run the full analysis pipeline and write a snapshot.

use std::path::Path;

use anyhow::Result;
use sdivi_config::Config;
use sdivi_pipeline::{current_timestamp, Pipeline};

use crate::output;

/// Runs `sdivi snapshot` against `repo_root` using the given configuration.
///
/// Executes all five pipeline stages (parsing, graph, detection, patterns,
/// snapshot assembly), writes the snapshot atomically to `.sdivi/snapshots/`,
/// and prints a summary to stdout.  Logs and progress go to stderr per
/// CLAUDE.md Rule 8.
///
/// # Errors
///
/// Returns an error if the pipeline fails or if output serialization fails.
pub fn run(repo_root: &Path, config: &Config, commit: Option<&str>, format: &str) -> Result<()> {
    let adapters = super::all_adapters();
    let pipeline = Pipeline::new(config.clone(), adapters);

    let timestamp = current_timestamp();

    eprintln!("sdivi: snapshotting repository at {}", repo_root.display());

    let snapshot = pipeline.snapshot(repo_root, commit, &timestamp)?;

    eprintln!(
        "sdivi: snapshot complete — nodes={} edges={} communities={}",
        snapshot.graph.node_count,
        snapshot.graph.edge_count,
        snapshot.partition.community_count(),
    );

    match format {
        "json" => output::json::print_snapshot(&snapshot)?,
        _ => output::text::print_snapshot(&snapshot),
    }

    Ok(())
}