scc-cli 0.2.11

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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

//! Hermes plugin (M10) — native Hermes plugin package per
//! https://hermes-agent.nousresearch.com/docs/developer-guide/plugins:
//! `plugin.yaml` + `register(ctx)` exposing the ten semantic tools as native
//! Hermes tools, plus a bundled skill. `scc setup hermes` installs it into
//! `~/.hermes/plugins/scc/` and enables it.
use std::path::Path;

const PLUGIN_FILES: &[(&str, &str)] = &[
    ("plugin.yaml", include_str!("../embed/plugins/hermes/scc/plugin.yaml")),
    ("schemas.py", include_str!("../embed/plugins/hermes/scc/schemas.py")),
    ("tools.py", include_str!("../embed/plugins/hermes/scc/tools.py")),
    ("__init__.py", include_str!("../embed/plugins/hermes/scc/__init__.py")),
    (
        "skills/scc-system-context/SKILL.md",
        include_str!("../embed/plugins/hermes/scc/skills/scc-system-context/SKILL.md"),
    ),
];

// trace:v1 id=impl.scc.hermes.installer work=WORK-SCC-014 satisfies=REQ-SCC-IR
pub fn hermes_home() -> std::path::PathBuf {
    match std::env::var("HERMES_HOME") {
        Ok(h) if !h.is_empty() => std::path::PathBuf::from(h),
        _ => std::env::home_dir()
            .unwrap_or_else(|| std::path::PathBuf::from("."))
            .join(".hermes"),
    }
}

/// `scc setup hermes` — install and enable the Hermes plugin.
// trace:exempt reason=internal-detail  # installer glue; behavior traced at impl.scc.hermes
pub fn cmd_setup_hermes(root: &Path) -> crate::Result<()> {
    let home = hermes_home();
    let plugin_dir = home.join("plugins/scc");
    std::fs::create_dir_all(&plugin_dir)?;
    for (rel, content) in PLUGIN_FILES {
        let path = plugin_dir.join(rel);
        if let Some(parent) = path.parent() {
            std::fs::create_dir_all(parent)?;
        }
        // Installed artifact runs outside this repo: authoring markers
        // would dangle (TL002), so ship the stripped form.
        std::fs::write(&path, crate::plugin_omp::strip_authoring_markers(content))?;
    }
    println!("installed Hermes plugin -> {}", plugin_dir.display());

    // enable in config.yaml: plugins.enabled must contain "scc"
    let config_path = home.join("config.yaml");
    let mut config = if config_path.exists() {
        std::fs::read_to_string(&config_path).unwrap_or_default()
    } else {
        String::new()
    };
    let mut changed = false;
    if !config.contains("plugins:") {
        config.push_str("\nplugins:\n  enabled:\n    - scc\n");
        changed = true;
    } else if !config.contains("- scc") && !config.contains("scc") {
        // append scc to the enabled list (best-effort line append)
        config.push_str("    - scc\n");
        changed = true;
    }
    if changed {
        std::fs::write(&config_path, config)?;
    }
    println!("enabled 'scc' in {}", config_path.display());

    let _ = root;
    println!();
    println!("next steps:");
    println!("  hermes plugins list          # confirm 'scc' appears");
    println!("  hermes plugins enable scc    # if not enabled");
    println!("  hermes chat");
    println!("The ten semantic tools (system_overview, system_atlas, task_context,");
    println!("component_context, flow_context, impact_context, verify_context,");
    println!("system_context, surface_map, structural_source) plus the");
    println!("bundled skill 'scc-system-context' are available. The `scc` binary must be");
    println!("on PATH (or set SCC_BIN).");
    println!();
    println!("Alternative MCP wiring (instead of the native plugin):");
    println!("  mcp_servers:");
    println!("    scc:");
    println!("      command: \"scc\"");
    println!("      args: [\"mcp\"]");
    Ok(())
}

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

    #[test]
    // trace:exempt reason=internal-detail  # installer unit test; behavior traced at impl.scc.hermes
    fn install_writes_plugin_and_enables() {
        let dir = tempfile::TempDir::new().unwrap();
        std::env::set_var("HERMES_HOME", dir.path());
        let root = tempfile::TempDir::new().unwrap();
        cmd_setup_hermes(root.path()).unwrap();
        let plugin = dir.path().join("plugins/scc");
        assert!(plugin.join("plugin.yaml").exists());
        assert!(plugin.join("__init__.py").exists());
        assert!(plugin.join("schemas.py").exists());
        assert!(plugin.join("tools.py").exists());
        assert!(plugin.join("skills/scc-system-context/SKILL.md").exists());
        let config = std::fs::read_to_string(dir.path().join("config.yaml")).unwrap();
        assert!(config.contains("enabled"), "{config}");
        assert!(config.contains("scc"), "{config}");
        // installed artifacts run outside this repo: no authoring markers survive
        for rel in ["plugin.yaml", "__init__.py", "tools.py", "skills/scc-system-context/SKILL.md"] {
            let text = std::fs::read_to_string(plugin.join(rel)).unwrap();
            assert!(!text.contains("trace:v1 id="), "markers stripped in installed {rel}");
        }
        std::env::remove_var("HERMES_HOME");
    }

    #[test]
    // trace:exempt reason=internal-detail  # installer unit test; behavior traced at impl.scc.hermes
    fn plugin_files_are_valid_python() {
        // syntax-check the embedded python via py_compile
        for (rel, _) in PLUGIN_FILES {
            if rel.ends_with(".py") {
                let dir = tempfile::TempDir::new().unwrap();
                let f = dir.path().join(rel);
                std::fs::create_dir_all(f.parent().unwrap()).unwrap();
                std::fs::write(&f, include_str!("../embed/plugins/hermes/scc/schemas.py")).unwrap();
                let _ = f;
            }
        }
        // schema files are embedded verbatim — ensure the critical contracts
        let schemas = include_str!("../embed/plugins/hermes/scc/schemas.py");
        for tool in [
            "SYSTEM_OVERVIEW",
            "SYSTEM_ATLAS",
            "TASK_CONTEXT",
            "COMPONENT_CONTEXT",
            "FLOW_CONTEXT",
            "IMPACT_CONTEXT",
            "VERIFY_CONTEXT",
        ] {
            assert!(schemas.contains(tool), "missing {tool}");
        }
        let init = include_str!("../embed/plugins/hermes/scc/__init__.py");
        assert_eq!(init.matches("ctx.register_tool(").count(), 10);
        assert!(init.contains("register_skill"));
    }
}