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

//! Context7 real-protocol integration test (P0 §16): starts the ACTUAL
//! `@upstash/context7-mcp` server (via npx) and exercises the full MCP stdio
//! handshake + tool calls through the SCC adapter's own client — protocol
//! fakes in the adapter unit tests are not a substitute for compatibility
//! with the real server.
//!
//! Optional suite: requires network + npx. Run with:
//!
//! ```sh
//! SCC_CONTEXT7_LIVE=1 cargo test -p scc-cli --test context7_live -- --ignored
//! ```

use std::process::Command;

const SERVER_CMD: &str = "npx -y @upstash/context7-mcp";

fn live_enabled() -> bool {
    std::env::var("SCC_CONTEXT7_LIVE").map(|v| v == "1").unwrap_or(false)
}

#[test]
#[ignore = "needs network + npx; run with SCC_CONTEXT7_LIVE=1"]
fn real_context7_server_protocol_compatibility() {
    if !live_enabled() {
        eprintln!("skipping: set SCC_CONTEXT7_LIVE=1 to run the live Context7 suite");
        return;
    }
    // the server must actually be spawnable
    let probe = Command::new("sh")
        .arg("-c")
        .arg(format!("{SERVER_CMD} --help"))
        .output()
        .expect("spawn context7");
    assert!(
        probe.status.success(),
        "context7 server must launch: {}",
        String::from_utf8_lossy(&probe.stderr)
    );

    let mut client = scc_indexer::adapters::context7::start(
        SERVER_CMD,
        &std::env::current_dir().expect("cwd"),
    )
    .expect("MCP handshake with the real server");

    // docs_for exercises: initialize, notifications/initialized, tools/call
    // (library-search + query-docs) over real Content-Length framing
    let docs = client
        .docs_for("react")
        .expect("library-search + query-docs must succeed against the real server");
    assert!(
        docs.contains("CONTEXT7 EXTERNAL DOCUMENTATION"),
        "labeled external docs marker: {docs}"
    );
    assert!(
        docs.to_ascii_lowercase().contains("react"),
        "docs must mention the library: {docs}"
    );
}

#[test]
#[ignore = "needs network + npx; run with SCC_CONTEXT7_LIVE=1"]
fn real_context7_server_rejects_unknown_library_gracefully() {
    if !live_enabled() {
        return;
    }
    let mut client = scc_indexer::adapters::context7::start(
        SERVER_CMD,
        &std::env::current_dir().expect("cwd"),
    )
    .expect("MCP handshake with the real server");
    // an impossible library name must not crash the client or hang it
    let result = client.docs_for("this-library-does-not-exist-xyz-12345");
    // either a clean error or empty docs — never a hang (client has a
    // 30s timeout) and never a panic
    let _ = result;
}