scc-cli 0.2.7

System Context Compiler CLI, daemon, MCP server, and Claude Code plugin
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
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
85
86
87
88
89

//! CLI-surface extraction integration tests (cli-service fixture): the
//! exported System IR must expose cli-subcommand entrypoints and `cli_flags`
//! symbol attributes (argparse/click, clap, cobra, package.json), and
//! `scc flows` must mention the subcommands.

use std::collections::BTreeMap;

mod common;

#[test]
fn cli_surface_export_and_flows() {
    let repo = common::copy_fixture("cli-service");
    let dir = common::workdir(repo.path());
    common::run_ok(&dir, &["index", "--quiet"]);

    // export: entity name -> attributes
    let ir = common::run_ok(&dir, &["export", "system-ir.json"]);
    let v: serde_json::Value =
        serde_json::from_str(&ir).expect("system-ir.json parses");
    let entities = v["entities"].as_array().expect("entities array");
    let mut attrs: BTreeMap<(String, String), serde_json::Value> = BTreeMap::new();
    for e in entities {
        let kind = e["kind"].as_str().unwrap_or("").to_string();
        let name = e["name"].as_str().unwrap_or("").to_string();
        attrs.insert((kind, name), e["attributes"].clone());
    }
    let eps_of = |kind: &str, name: &str| -> Vec<String> {
        attrs
            .get(&(kind.to_string(), name.to_string()))
            .and_then(|a| a.get("entrypoints"))
            .and_then(|v| serde_json::from_value(v.clone()).ok())
            .unwrap_or_default()
    };
    let flags_of = |kind: &str, name: &str| -> Vec<String> {
        attrs
            .get(&(kind.to_string(), name.to_string()))
            .and_then(|a| a.get("cli_flags"))
            .and_then(|v| serde_json::from_value(v.clone()).ok())
            .unwrap_or_default()
    };

    // python argparse: subcommand entrypoints on the command functions
    assert_eq!(eps_of("symbol", "serve"), vec!["cli-subcommand"]);
    assert_eq!(eps_of("symbol", "deploy"), vec!["cli-subcommand"]);
    // flags attach to the parser-owning function (sorted, deduped)
    assert_eq!(
        flags_of("symbol", "build_parser"),
        vec!["--env", "--paging", "--port", "--verbose"]
    );

    // rust clap: Parser/Subcommand structs own their flags
    assert_eq!(flags_of("symbol", "Cli"), vec!["--format", "--paging"]);
    assert_eq!(flags_of("symbol", "Command"), vec!["--env", "--port"]);
    // subcommand entrypoints land on the file entity (no variant symbols)
    let cli_rs_eps = eps_of("file", "cli.rs");
    assert!(
        cli_rs_eps.iter().filter(|k| *k == "cli-subcommand").count() >= 2,
        "cli.rs file entrypoints: {cli_rs_eps:?}"
    );

    // rust clap builder API: `Command::new(..).arg(Arg::new(..).long(..))`
    // chains attach flags to the function that builds the Command; each
    // registered subcommand emits a cli-subcommand entrypoint there.
    assert_eq!(
        flags_of("symbol", "build_cli"),
        vec!["--paging", "--port", "--theme", "-p", "-t"]
    );
    assert_eq!(
        eps_of("symbol", "build_cli"),
        vec!["cli-subcommand", "cli-subcommand"]
    );

    // go cobra: flags on the function that owns the parser (init)
    assert_eq!(flags_of("symbol", "init"), vec!["--env", "--paging", "--port"]);
    let go_eps = eps_of("file", "main.go");
    assert!(
        go_eps.iter().filter(|k| *k == "cli-subcommand").count() >= 2,
        "main.go file entrypoints: {go_eps:?}"
    );

    // package.json bin/main -> entrypoint entities
    assert_eq!(eps_of("symbol", "cli-service"), vec!["entrypoint"]);
    assert_eq!(eps_of("symbol", "dist/index.js"), vec!["entrypoint"]);

    // flows mention the subcommands (entrypoint symbols become flows)
    let flows = common::run_ok(&dir, &["flows"]);
    assert!(flows.contains("serve"), "flows must mention serve: {flows}");
    assert!(flows.contains("deploy"), "flows must mention deploy: {flows}");
}