spec-driven-docs 0.8.1

Spec-driven documentation: current specs, immutable decision records, and executable gates kept coherent for people and coding agents.
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

//! `ki` subcommand: runtime-shape.
//!
//! Resolves the target, asks the known-issues service, and renders text or
//! JSON. The listing is a report: a record stating no axis is listed with
//! the value missing, because judging it belongs to `ki-state` and
//! `ki-filing`.

use crate::cli::ki::{KiArgs, KiCommand, ListArgs};
use crate::context::AppContext;
use crate::error::AppError;
use crate::output;
use crate::services::known_issues::cases;

/// Run one `sdd ki` verb.
///
/// # Errors
///
/// [`AppError::Usage`] when the target is neither absolute nor `.`, and
/// [`AppError::Io`] when a record cannot be read.
pub fn run(ctx: &AppContext, args: KiArgs) -> Result<(), AppError> {
    match args.command {
        KiCommand::List(args) => list(ctx, args),
    }
}

fn list(ctx: &AppContext, args: ListArgs) -> Result<(), AppError> {
    let target = if args.target.is_absolute() {
        args.target
    } else if args.target == "." {
        ctx.cwd.clone()
    } else {
        return Err(AppError::Usage("target must be absolute or .".to_string()));
    };
    if !target.is_dir() {
        return Err(AppError::Usage(format!("no directory at {target}")));
    }
    let cases = cases(&target)?;
    if args.json {
        return output::json(&cases);
    }
    let width = cases.iter().map(|case| case.id.len()).max().unwrap_or(0);
    for case in &cases {
        output::line(format!(
            "{:width$}  {:<13}  {:<10}  {:<9}  {}",
            case.id,
            case.state.as_deref().unwrap_or("-"),
            case.checked.as_deref().unwrap_or("-"),
            case.filing.as_deref().unwrap_or("-"),
            case.upstream.as_deref().unwrap_or("-"),
        ));
    }
    Ok(())
}