govctl 0.15.0

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

//! Describe command implementation - machine-readable CLI metadata for agents.

mod catalog;
mod context;

use crate::cmd::output::print_json;
use crate::config::Config;
use crate::diagnostic::{DiagnosticCode, DiagnosticResult, Diagnostics};
use serde::Serialize;

use catalog::{CommandInfo, WorkflowInfo, command_catalog, workflow_info};
use context::{ProjectState, load_context};

/// Versioned wire contract defined by [[RFC-0002:C-DESCRIBE-COMMAND]].
#[derive(Serialize)]
struct DescribeOutput {
    schema_version: u32,
    tool_version: String,
    purpose: String,
    commands: Vec<CommandInfo>,
    workflow: WorkflowInfo,
    #[serde(skip_serializing_if = "Option::is_none")]
    project_state: Option<ProjectState>,
    #[serde(skip_serializing_if = "Option::is_none")]
    suggested_actions: Option<Vec<String>>,
}

/// Execute describe command
pub fn describe(config: &Config, include_context: bool) -> DiagnosticResult<Diagnostics> {
    let mut output = DescribeOutput {
        schema_version: 1,
        tool_version: env!("CARGO_PKG_VERSION").to_string(),
        purpose: "Governance-as-code CLI for AI coding agents".to_string(),
        commands: command_catalog(),
        workflow: workflow_info(),
        project_state: None,
        suggested_actions: None,
    };

    if include_context {
        let context = match load_context(config) {
            Ok(context) => context,
            Err(diagnostics) => return Ok(diagnostics),
        };
        output.project_state = Some(context.project_state);
        output.suggested_actions = Some(context.suggested_actions);
    }

    print_json(
        &output,
        DiagnosticCode::E0903UnexpectedError,
        "Failed to serialize command description",
        "describe",
    )?;

    Ok(vec![])
}