rigg 1.4.3

Configuration-as-code CLI for Azure AI Search and Microsoft Foundry
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

//! `rigg concepts` — print rigg's workspace/project mental model.
//!
//! Single-sourced from the repo-root `CONCEPTS.md`, embedded at build time so
//! the CLI and the docs cannot drift.

use std::io::IsTerminal;

use anyhow::Result;
use serde_json::json;

use crate::commands::GlobalContext;

/// The canonical concept guide. Embedding `CONCEPTS.md` guarantees CLI/docs parity.
const CONCEPTS_MD: &str = include_str!("../../CONCEPTS.md");

pub fn run(ctx: &GlobalContext) -> Result<()> {
    if ctx.json() {
        println!(
            "{}",
            serde_json::to_string_pretty(&json!({ "concepts": CONCEPTS_MD }))?
        );
        return Ok(());
    }

    let styled = std::io::stdout().is_terminal() && !ctx.no_color;
    let skin = if styled {
        termimad::MadSkin::default()
    } else {
        termimad::MadSkin::no_style()
    };
    skin.print_text(CONCEPTS_MD);
    Ok(())
}

#[cfg(test)]
mod tests {
    use super::CONCEPTS_MD;

    /// Parity guard: the core invariant must survive any future doc rewrite.
    #[test]
    fn concepts_md_states_the_core_invariant() {
        assert!(
            CONCEPTS_MD.contains("A resource belongs to exactly one project."),
            "CONCEPTS.md must state the one-resource-one-project invariant verbatim"
        );
    }
}