ssot-mcp 0.1.2.dev1__tar.gz → 0.1.3.dev1__tar.gz

{ssot_mcp-0.1.2.dev1 → ssot_mcp-0.1.3.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-mcp
-Version: 0.1.2.dev1
+Version: 0.1.3.dev1
 Summary: MCP server for optional SSOT pull-worker control-plane coordination.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -28,7 +28,7 @@ Classifier: Topic :: Utilities
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: mcp>=1.0
-Requires-Dist: ssot-core<0.3.0,>=0.2.20.dev1
+Requires-Dist: ssot-core<0.3.0,>=0.2.21.dev1
 
 <div align="center">
   <h1>ssot-mcp</h1>
@@ -122,8 +122,9 @@ Workers and MCP clients should not hand-edit `.ssot/registry.json`. When a clien
 - `registry_entity_unlink`
 - `get_ssot_cli_surface`
 - `run_ssot_cli`
+- mirrored `ssot_cli__*` tools for each live CLI command path
 
-The structured entity tools use the same core registry mutation APIs as the CLI, validate before saving, and emit `registry_updated` events. `run_ssot_cli` delegates to the repo-local CLI parser in process and supports global flags, help/version requests, commands, subcommands, command flags, and subcommand flags as argv tokens.
+The structured entity tools use the same core registry mutation APIs as the CLI, validate before saving, and emit `registry_updated` events. `get_ssot_cli_surface` exposes the live parser inventory, `run_ssot_cli` remains the generic delegation fallback, and `ssot-mcp` also registers mirrored `ssot_cli__*` MCP tools for every current CLI command path. Together they keep the CLI and MCP surfaces aligned across global flags, help/version requests, commands, subcommands, command flags, and subcommand flags.
 
 ## Pull-worker campaign model
 

{ssot_mcp-0.1.2.dev1 → ssot_mcp-0.1.3.dev1}/README.md

@@ -90,8 +90,9 @@ Workers and MCP clients should not hand-edit `.ssot/registry.json`. When a clien
 - `registry_entity_unlink`
 - `get_ssot_cli_surface`
 - `run_ssot_cli`
+- mirrored `ssot_cli__*` tools for each live CLI command path
 
-The structured entity tools use the same core registry mutation APIs as the CLI, validate before saving, and emit `registry_updated` events. `run_ssot_cli` delegates to the repo-local CLI parser in process and supports global flags, help/version requests, commands, subcommands, command flags, and subcommand flags as argv tokens.
+The structured entity tools use the same core registry mutation APIs as the CLI, validate before saving, and emit `registry_updated` events. `get_ssot_cli_surface` exposes the live parser inventory, `run_ssot_cli` remains the generic delegation fallback, and `ssot-mcp` also registers mirrored `ssot_cli__*` MCP tools for every current CLI command path. Together they keep the CLI and MCP surfaces aligned across global flags, help/version requests, commands, subcommands, command flags, and subcommand flags.
 
 ## Pull-worker campaign model
 

{ssot_mcp-0.1.2.dev1 → ssot_mcp-0.1.3.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssot-mcp"
-version = "0.1.2.dev1"
+version = "0.1.3.dev1"
 description = "MCP server for optional SSOT pull-worker control-plane coordination."
 readme = "README.md"
 requires-python = ">=3.10,<3.15"
@@ -12,7 +12,7 @@ license = "Apache-2.0"
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 dependencies = [
   "mcp>=1.0",
-  "ssot-core>=0.2.20.dev1,<0.3.0",
+  "ssot-core>=0.2.21.dev1,<0.3.0",
 ]
 keywords = ["ssot", "mcp", "model-context-protocol", "codex", "workers", "leases", "control-plane", "registry", "developer-tools", "automation"]
 classifiers = [

{ssot_mcp-0.1.2.dev1 → ssot_mcp-0.1.3.dev1}/src/ssot_mcp/server.py

@@ -6,6 +6,56 @@ from typing import Any
 from . import resources, tools
 
 
+def _make_cli_mirror_tool(path: str):
+    prefix = path.split()
+
+    def cli_mirror_tool(
+        repo: str | None = None,
+        global_args: list[str] | None = None,
+        args: list[str] | None = None,
+    ) -> dict[str, Any]:
+        """Run one fixed ssot-registry command path through MCP.
+
+        `global_args` are inserted before the fixed command path so callers can
+        supply root-level flags such as `--output-format`.
+        `args` are appended after the fixed command path for command and
+        subcommand flags plus positional arguments.
+        """
+
+        argv: list[str] = []
+        if global_args:
+            argv.extend(global_args)
+        argv.extend(prefix)
+        if args:
+            argv.extend(args)
+        return tools.run_ssot_cli(repo=repo, args=argv)
+
+    cli_mirror_tool.__name__ = tools.mcp_cli_tool_name_for_path(path)
+    return cli_mirror_tool
+
+
+def _register_cli_mirror_tools(mcp: Any) -> None:
+    surface = tools.get_ssot_cli_surface()
+    mcp.tool(
+        name=tools.MCP_CLI_ROOT_TOOL_NAME,
+        title="ssot-registry root",
+        description="Mirror of the root ssot-registry CLI surface through MCP. Pass argv tokens after `ssot-registry` in `args`.",
+    )(tools.run_ssot_cli)
+
+    for path in surface["subcommand_paths"]:
+        flags = surface["flags_by_path"].get(path, [])
+        flags_text = ", ".join(f"`{flag}`" for flag in flags) if flags else "none"
+        mcp.tool(
+            name=surface["tool_name_by_path"][path],
+            title=f"ssot-registry {path}",
+            description=(
+                f"Mirror of `ssot-registry {path}` through MCP. "
+                f"Supported path-local flags: {flags_text}. "
+                "Pass root/global flags in `global_args` and path-local flags or positionals in `args`."
+            ),
+        )(_make_cli_mirror_tool(path))
+
+
 def build_server() -> Any:
     try:
         from mcp.server.fastmcp import FastMCP
@@ -36,6 +86,7 @@ def build_server() -> Any:
     mcp.tool()(tools.registry_entity_link)
     mcp.tool()(tools.registry_entity_unlink)
     mcp.tool()(tools.run_ssot_cli)
+    _register_cli_mirror_tools(mcp)
 
     mcp.resource("ssot://registry/{repo}")(resources.registry_resource)
     mcp.resource("ssot://campaign/{repo}/{campaign_id}")(resources.campaign_status_resource)

{ssot_mcp-0.1.2.dev1 → ssot_mcp-0.1.3.dev1}/src/ssot_mcp/tools.py

@@ -25,6 +25,7 @@ from ssot_registry.control.service import ControlPlane
 
 _PINNED_REPO: Path | None = None
 _CLI_LOCK = RLock()
+MCP_CLI_ROOT_TOOL_NAME = "ssot_cli__root"
 
 
 def configure_repo(repo: str | Path | None) -> None:
@@ -139,6 +140,17 @@ def _cli_surface() -> dict[str, Any]:
     }
 
 
+def mcp_cli_tool_name_for_path(path: str) -> str:
+    tokens = [token.strip().lower().replace("-", "_") for token in path.split() if token.strip()]
+    if not tokens:
+        return MCP_CLI_ROOT_TOOL_NAME
+    return "ssot_cli__" + "__".join(tokens)
+
+
+def _mcp_cli_tool_map(surface: dict[str, Any]) -> dict[str, str]:
+    return {path: mcp_cli_tool_name_for_path(path) for path in surface["subcommand_paths"]}
+
+
 def _is_cli_metadata_request(args: list[str]) -> bool:
     return not args or any(token in {"-h", "--help", "--version"} for token in args)
 
@@ -283,7 +295,12 @@ def get_ssot_cli_surface(repo: str | None = None) -> dict[str, Any]:
     if repo is not None or _PINNED_REPO is not None:
         _resolve_repo_for_cli(repo, ["--help"])
     surface = _cli_surface()
-    return {"passed": True, **surface}
+    return {
+        "passed": True,
+        **surface,
+        "root_tool_name": MCP_CLI_ROOT_TOOL_NAME,
+        "tool_name_by_path": _mcp_cli_tool_map(surface),
+    }
 
 
 def get_blocked_transitions(repo: str | None = None, campaign_id: str | None = None, status: str | None = "open") -> dict[str, Any]:

{ssot_mcp-0.1.2.dev1 → ssot_mcp-0.1.3.dev1}/src/ssot_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssot-mcp
-Version: 0.1.2.dev1
+Version: 0.1.3.dev1
 Summary: MCP server for optional SSOT pull-worker control-plane coordination.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License-Expression: Apache-2.0
@@ -28,7 +28,7 @@ Classifier: Topic :: Utilities
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: mcp>=1.0
-Requires-Dist: ssot-core<0.3.0,>=0.2.20.dev1
+Requires-Dist: ssot-core<0.3.0,>=0.2.21.dev1
 
 <div align="center">
   <h1>ssot-mcp</h1>
@@ -122,8 +122,9 @@ Workers and MCP clients should not hand-edit `.ssot/registry.json`. When a clien
 - `registry_entity_unlink`
 - `get_ssot_cli_surface`
 - `run_ssot_cli`
+- mirrored `ssot_cli__*` tools for each live CLI command path
 
-The structured entity tools use the same core registry mutation APIs as the CLI, validate before saving, and emit `registry_updated` events. `run_ssot_cli` delegates to the repo-local CLI parser in process and supports global flags, help/version requests, commands, subcommands, command flags, and subcommand flags as argv tokens.
+The structured entity tools use the same core registry mutation APIs as the CLI, validate before saving, and emit `registry_updated` events. `get_ssot_cli_surface` exposes the live parser inventory, `run_ssot_cli` remains the generic delegation fallback, and `ssot-mcp` also registers mirrored `ssot_cli__*` MCP tools for every current CLI command path. Together they keep the CLI and MCP surfaces aligned across global flags, help/version requests, commands, subcommands, command flags, and subcommand flags.
 
 ## Pull-worker campaign model
 

ssot_mcp-0.1.3.dev1/src/ssot_mcp.egg-info/requires.txt

@@ -0,0 +1,2 @@
+mcp>=1.0
+ssot-core<0.3.0,>=0.2.21.dev1

ssot_mcp-0.1.2.dev1/src/ssot_mcp.egg-info/requires.txt

@@ -1,2 +0,0 @@
-mcp>=1.0
-ssot-core<0.3.0,>=0.2.20.dev1