sdivi-cli 0.2.12

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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

//! `sdivi check` — capture a snapshot, compare to prior, and evaluate thresholds.

use std::path::Path;

use anyhow::{Context, Result};
use sdivi_config::Config;
use sdivi_core::input::{ThresholdOverrideInput, ThresholdsInput};
use sdivi_core::{compute_thresholds_check, ExitCode};
use sdivi_pipeline::store::latest_snapshot;
use sdivi_pipeline::{current_timestamp, Pipeline, WriteMode};

use crate::output;

/// Runs `sdivi check`.
///
/// Captures a fresh snapshot, computes the delta against the most recent stored
/// prior, evaluates thresholds via [`sdivi_core::compute_thresholds_check`], and
/// prints results.  Returns [`ExitCode::ThresholdExceeded`] (10) if any
/// threshold was exceeded, [`ExitCode::Success`] (0) otherwise.
///
/// When `no_write` is true, the fresh snapshot is not persisted and retention
/// is not enforced — useful for CI gates that must not pollute history.
///
/// # Errors
///
/// Returns an error if the pipeline fails or snapshot I/O fails.
pub fn run(repo_root: &Path, config: &Config, no_write: bool, format: &str) -> Result<ExitCode> {
    let snapshot_dir = repo_root.join(&config.snapshots.dir);
    let prior = latest_snapshot(&snapshot_dir)
        .with_context(|| format!("failed to read snapshot dir: {}", snapshot_dir.display()))?;

    let pipeline = Pipeline::new(config.clone(), super::all_adapters());
    let timestamp = current_timestamp();
    let mode = if no_write {
        WriteMode::EphemeralForCheck
    } else {
        WriteMode::Persist
    };

    eprintln!("sdivi: checking repository at {}", repo_root.display());
    let current = pipeline.snapshot_with_mode(repo_root, None, &timestamp, mode)?;

    let summary = Pipeline::delta(prior.as_ref(), &current);

    let today = chrono::Local::now().date_naive();
    let thresholds = thresholds_input(config, today);
    let check_result = compute_thresholds_check(&summary, &thresholds);

    match format {
        "json" => output::json::print_check(&check_result, &summary)?,
        _ => output::text::print_check(&check_result, &summary),
    }

    if check_result.breached {
        Ok(ExitCode::ThresholdExceeded)
    } else {
        Ok(ExitCode::Success)
    }
}

/// Builds [`ThresholdsInput`] from [`Config`] with the caller-supplied `today`.
///
/// The clock is read in the CLI, not in `sdivi-core` (Rule 21).
fn thresholds_input(config: &Config, today: chrono::NaiveDate) -> ThresholdsInput {
    let t = &config.thresholds;
    let overrides = t
        .overrides
        .iter()
        .map(|(k, v)| {
            (
                k.clone(),
                ThresholdOverrideInput {
                    pattern_entropy_rate: v.pattern_entropy_rate,
                    convention_drift_rate: v.convention_drift_rate,
                    coupling_delta_rate: v.coupling_delta_rate,
                    boundary_violation_rate: v.boundary_violation_rate,
                    expires: v.expires.clone(),
                },
            )
        })
        .collect();

    ThresholdsInput {
        pattern_entropy_rate: t.pattern_entropy_rate,
        convention_drift_rate: t.convention_drift_rate,
        coupling_delta_rate: t.coupling_delta_rate,
        boundary_violation_rate: t.boundary_violation_rate,
        overrides,
        today,
    }
}