govctl 0.9.3

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

//! Governance artifact loading and project-index assembly.

use crate::diagnostic::{Diagnostic, DiagnosticCode};

mod project;
mod rfc;

pub use project::{load_project, load_project_with_warnings};
pub(crate) use rfc::split_clause_id;
pub use rfc::{find_clause_toml, find_rfc_toml, load_rfc, load_rfcs, reject_legacy_json_storage};

/// Result of loading a project: index plus any warnings encountered
pub struct ProjectLoadResult {
    pub index: crate::model::ProjectIndex,
    pub warnings: Vec<Diagnostic>,
}

/// Load error types
#[derive(Debug)]
pub enum LoadError {
    Io {
        file: String,
        action: &'static str,
        message: String,
    },
    InternalIo {
        file: String,
        message: String,
    },
    Json {
        file: String,
        message: String,
    },
    RfcSchema {
        file: String,
        message: String,
    },
    ClauseSchema {
        file: String,
        message: String,
    },
    ClausePathInvalid {
        file: String,
        clause: String,
    },
    Diagnostic(Diagnostic),
}

impl From<LoadError> for Diagnostic {
    fn from(err: LoadError) -> Self {
        match err {
            LoadError::Io {
                file,
                action,
                message,
            } => Diagnostic::io_error(action, message, file),
            LoadError::InternalIo { file, message } => {
                Diagnostic::new(DiagnosticCode::E0901IoError, message, file)
            }
            LoadError::Json { file, message } => {
                Diagnostic::new(DiagnosticCode::E0902JsonParseError, message, file)
            }
            LoadError::RfcSchema { file, message } => {
                Diagnostic::new(DiagnosticCode::E0101RfcSchemaInvalid, message, file)
            }
            LoadError::ClauseSchema { file, message } => {
                Diagnostic::new(DiagnosticCode::E0201ClauseSchemaInvalid, message, file)
            }
            LoadError::ClausePathInvalid { file, clause } => Diagnostic::new(
                DiagnosticCode::E0204ClausePathInvalid,
                format!("Invalid clause path: {clause}"),
                file,
            ),
            LoadError::Diagnostic(diagnostic) => diagnostic,
        }
    }
}

pub fn load_clause(
    config: &crate::config::Config,
    path: &std::path::Path,
) -> Result<crate::model::ClauseEntry, LoadError> {
    rfc::load_clause_file(config, path)
}