cargo-governor 2.0.0

Machine-First, LLM-Ready, CI/CD-Native release automation tool for Rust crates
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

//! Version bump determination logic

use super::analysis::Analysis;
use governor_core::domain::version::BumpType;

/// Determine bump type from analysis
#[must_use]
pub const fn analyze_bump_type(analysis: &Analysis) -> BumpType {
    if !analysis.breaking.is_empty() {
        BumpType::Major
    } else if !analysis.features.is_empty() {
        BumpType::Minor
    } else if !analysis.fixes.is_empty() {
        BumpType::Patch
    } else {
        BumpType::None
    }
}

/// Calculate confidence score for bump type
#[must_use]
pub fn calculate_confidence(analysis: &Analysis, bump_type: BumpType) -> f64 {
    let total_changeloggable =
        analysis.breaking.len() + analysis.features.len() + analysis.fixes.len();

    if total_changeloggable == 0 {
        return 0.5;
    }

    let base_confidence = match bump_type {
        BumpType::Major if !analysis.breaking.is_empty() => 0.95,
        BumpType::Minor if !analysis.features.is_empty() => 0.90,
        BumpType::Patch if !analysis.fixes.is_empty() => 0.85,
        _ => 0.70,
    };

    let total = total_changeloggable + analysis.other;
    let conventional_ratio = if total == 0 {
        0.0
    } else {
        #[allow(clippy::cast_precision_loss)]
        {
            let total_changeloggable_f64 = total_changeloggable as f64;
            let total_f64 = total as f64;
            total_changeloggable_f64 / total_f64
        }
    };
    base_confidence * 0.5f64.mul_add(conventional_ratio, 0.5)
}

/// Generate reasoning text for version bump
#[must_use]
pub fn generate_reasoning(
    analysis: &Analysis,
    bump_type: BumpType,
    current: &governor_core::domain::version::SemanticVersion,
    recommended: &governor_core::domain::version::SemanticVersion,
) -> String {
    match bump_type {
        BumpType::Major if !analysis.breaking.is_empty() => {
            format!(
                "Breaking changes detected ({}). Bumping from {} to {}.",
                analysis.breaking.len(),
                current,
                recommended
            )
        }
        BumpType::Minor if !analysis.features.is_empty() => {
            format!(
                "New features detected ({}). Bumping from {} to {}.",
                analysis.features.len(),
                current,
                recommended
            )
        }
        BumpType::Patch if !analysis.fixes.is_empty() => {
            format!(
                "Bug fixes detected ({}). Bumping from {} to {}.",
                analysis.fixes.len(),
                current,
                recommended
            )
        }
        _ => {
            format!("No significant changes detected. Version remains at {current}.")
        }
    }
}