govctl 0.9.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

const RFC_METADATA_KEYS: &[&str] = &[
    "title",
    "version",
    "status",
    "phase",
    "owners",
    "created",
    "updated",
    "supersedes",
    "refs",
    "signature",
];

const CLAUSE_METADATA_KEYS: &[&str] = &[
    "title",
    "kind",
    "status",
    "anchors",
    "superseded_by",
    "since",
];

fn move_toml_keys(
    source: &mut toml::map::Map<String, toml::Value>,
    target: &mut toml::map::Map<String, toml::Value>,
    keys: &[&str],
) {
    for key in keys {
        if let Some(v) = source.remove(*key) {
            target.insert(key.to_string(), v);
        }
    }
}

fn extract_toml_govctl(
    root: &mut toml::map::Map<String, toml::Value>,
    id_key: &str,
    metadata_keys: &[&str],
) -> Option<toml::Value> {
    if root.contains_key("govctl") {
        return None;
    }
    let id = root.remove(id_key)?;

    let mut govctl = toml::map::Map::new();
    govctl.insert("schema".to_string(), toml::Value::Integer(1));
    govctl.insert("id".to_string(), id);
    move_toml_keys(root, &mut govctl, metadata_keys);
    Some(toml::Value::Table(govctl))
}

/// Normalize a flat RFC TOML value into the `[govctl]` wire layout.
/// If the value already has a `govctl` key, it's left untouched.
pub fn normalize_rfc_value(raw: &mut toml::Value) {
    let Some(root) = raw.as_table_mut() else {
        return;
    };
    if let Some(govctl) = extract_toml_govctl(root, "rfc_id", RFC_METADATA_KEYS) {
        root.insert("govctl".to_string(), govctl);
    }
}

/// Normalize a flat clause TOML value into the `[govctl]` + `[content]` wire layout.
/// If the value already has a `govctl` key, it's left untouched.
pub fn normalize_clause_value(raw: &mut toml::Value) {
    let Some(root) = raw.as_table_mut() else {
        return;
    };
    let Some(govctl) = extract_toml_govctl(root, "clause_id", CLAUSE_METADATA_KEYS) else {
        return;
    };
    root.insert("govctl".to_string(), govctl);

    let mut content = toml::map::Map::new();
    if let Some(text) = root.remove("text") {
        content.insert("text".to_string(), text);
    }
    root.insert("content".to_string(), toml::Value::Table(content));
}