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

"""SCC plugin — registration: wire schemas to handlers, bundle the skill.

Hermes loads this via `register(ctx)` at startup. The plugin provides the
ten semantic context tools backed by the local `scc` CLI.
"""

import logging
from pathlib import Path

from . import schemas, tools

logger = logging.getLogger(__name__)

# trace:v1 id=impl.scc.hermes work=WORK-SCC-014 satisfies=REQ-SCC-IR


# trace:exempt reason=internal-detail  # plugin registration glue; behavior traced at impl.scc.hermes.tools
def register(ctx):
    """Wire schemas to handlers and register the bundled skill."""
    ctx.register_tool(
        name="system_overview",
        toolset="scc",
        schema=schemas.SYSTEM_OVERVIEW,
        handler=tools.system_overview,
    )
    ctx.register_tool(
        name="system_atlas",
        toolset="scc",
        schema=schemas.SYSTEM_ATLAS,
        handler=tools.system_atlas,
    )
    ctx.register_tool(
        name="task_context",
        toolset="scc",
        schema=schemas.TASK_CONTEXT,
        handler=tools.task_context,
    )
    ctx.register_tool(
        name="component_context",
        toolset="scc",
        schema=schemas.COMPONENT_CONTEXT,
        handler=tools.component_context,
    )
    ctx.register_tool(
        name="flow_context",
        toolset="scc",
        schema=schemas.FLOW_CONTEXT,
        handler=tools.flow_context,
    )
    ctx.register_tool(
        name="impact_context",
        toolset="scc",
        schema=schemas.IMPACT_CONTEXT,
        handler=tools.impact_context,
    )
    ctx.register_tool(
        name="verify_context",
        toolset="scc",
        schema=schemas.VERIFY_CONTEXT,
        handler=tools.verify_context,
    )
    ctx.register_tool(
        name="system_context",
        toolset="scc",
        schema=schemas.SYSTEM_CONTEXT,
        handler=tools.system_context,
    )
    ctx.register_tool(
        name="surface_map",
        toolset="scc",
        schema=schemas.SURFACE_MAP,
        handler=tools.surface_map,
    )
    ctx.register_tool(
        name="structural_source",
        toolset="scc",
        schema=schemas.STRUCTURAL_SOURCE,
        handler=tools.structural_source,
    )

    # Bundled skill: when to use which SCC operation.
    skills_dir = Path(__file__).parent / "skills"
    for child in sorted(skills_dir.iterdir()):
        skill_md = child / "SKILL.md"
        if child.is_dir() and skill_md.exists():
            ctx.register_skill(child.name, skill_md)

    logger.info("scc plugin registered: 10 tools, 1 skill")