govctl 0.10.1

Project governance CLI for RFC, ADR, and Work Item management
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use super::canonical_json::canonicalize_json;
use super::*;
use crate::model::{
    ChangelogEntry, ClauseEntry, ClauseKind, ClauseSpec, ClauseStatus, RfcIndex, RfcPhase, RfcSpec,
    RfcStatus, SectionSpec,
};
use serde_json::Value;
use std::path::PathBuf;

#[test]
fn test_canonicalize_sorts_keys() -> Result<(), Box<dyn std::error::Error>> {
    let json: Value = serde_json::from_str(r#"{"z": 1, "a": 2, "m": 3}"#)?;
    let canonical = canonicalize_json(&json);
    assert_eq!(canonical, r#"{"a":2,"m":3,"z":1}"#);
    Ok(())
}

#[test]
fn test_canonicalize_nested_objects() -> Result<(), Box<dyn std::error::Error>> {
    let json: Value = serde_json::from_str(r#"{"outer": {"z": 1, "a": 2}, "inner": {"b": 3}}"#)?;
    let canonical = canonicalize_json(&json);
    assert_eq!(canonical, r#"{"inner":{"b":3},"outer":{"a":2,"z":1}}"#);
    Ok(())
}

#[test]
fn test_extract_signature() {
    let md = r#"---
status: normative
---

<!-- GENERATED: do not edit. Source: RFC-0000 -->
<!-- SIGNATURE: sha256:abcd1234 -->

# RFC-0000
"#;
    assert_eq!(extract_signature(md), Some("abcd1234".to_string()));
}

#[test]
fn test_extract_signature_not_found() {
    let md = "# Just a plain markdown file";
    assert_eq!(extract_signature(md), None);
}

#[test]
fn test_rfc_content_signature_ignores_bump_bookkeeping() -> Result<(), Diagnostic> {
    let mut rfc = test_rfc_index();
    let baseline = compute_rfc_content_signature(&rfc)?;

    rfc.rfc.version = "0.1.1".to_string();
    rfc.rfc.signature = Some("legacy-or-current-signature".to_string());
    rfc.rfc.changelog.push(ChangelogEntry {
        version: "0.1.1".to_string(),
        date: "2026-06-15".to_string(),
        notes: Some("Bookkeeping only".to_string()),
        added: vec![],
        changed: vec![],
        deprecated: vec![],
        removed: vec![],
        fixed: vec!["no content change".to_string()],
        security: vec![],
    });

    assert_eq!(compute_rfc_content_signature(&rfc)?, baseline);
    assert_ne!(compute_rfc_signature(&rfc)?, baseline);
    Ok(())
}

#[test]
fn test_rfc_content_signature_includes_clause_content() -> Result<(), Diagnostic> {
    let mut rfc = test_rfc_index();
    let baseline = compute_rfc_content_signature(&rfc)?;

    rfc.clauses[0].spec.text = "Updated normative behavior.".to_string();

    assert_ne!(compute_rfc_content_signature(&rfc)?, baseline);
    Ok(())
}

#[test]
fn test_rfc_amended_accepts_legacy_full_signature_baseline() -> Result<(), Diagnostic> {
    let mut rfc = test_rfc_index();
    rfc.rfc.signature = Some(compute_rfc_signature(&rfc)?);

    assert!(!is_rfc_amended(&rfc));
    Ok(())
}

fn test_rfc_index() -> RfcIndex {
    RfcIndex {
        rfc: RfcSpec {
            rfc_id: "RFC-0001".to_string(),
            title: "Test RFC".to_string(),
            version: "0.1.0".to_string(),
            status: RfcStatus::Normative,
            phase: RfcPhase::Impl,
            owners: vec!["@test-user".to_string()],
            created: "2026-06-15".to_string(),
            updated: None,
            supersedes: None,
            refs: vec![],
            tags: vec![],
            sections: vec![SectionSpec {
                title: "Specification".to_string(),
                clauses: vec!["C-TEST".to_string()],
            }],
            changelog: vec![],
            signature: None,
        },
        clauses: vec![ClauseEntry {
            spec: ClauseSpec {
                clause_id: "C-TEST".to_string(),
                title: "Test Clause".to_string(),
                kind: ClauseKind::Normative,
                status: ClauseStatus::Active,
                text: "Original normative behavior.".to_string(),
                anchors: vec![],
                superseded_by: None,
                since: Some("0.1.0".to_string()),
                tags: vec![],
            },
            path: PathBuf::from("gov/rfc/RFC-0001/clauses/C-TEST.toml"),
        }],
        path: PathBuf::from("gov/rfc/RFC-0001/rfc.toml"),
    }
}