Skip to content

💫 Toolkit to help you get started with SDD or any other process!

3.2 KB
Raw Blame
"""MCP registration and inventory for the ``specify artifact`` hierarchy."""

from __future__ import annotations

from dataclasses import dataclass
from pathlib import Path
from typing import Literal

from mcp.server import MCPServer

from ._operation_info import ARTIFACT_INFO_OPERATION
from ._operation_list import ARTIFACT_LIST_OPERATION
from .mcp_info import register as register_info
from .mcp_list import register as register_list

ArtifactOperationId = Literal["artifact.list", "artifact.info", "artifact.lookup"]
ArtifactCliPath = Literal[
    "specify artifact list",
    "specify artifact info",
    "specify artifact lookup",
]
ArtifactToolName = Literal[
    "specify_artifact_list",
    "specify_artifact_info",
    "specify_artifact_lookup",
]
ArtifactDisposition = Literal["available", "unavailable"]


@dataclass(frozen=True)
class ArtifactToolInventory:
    """One authoritative MCP disposition for an artifact CLI leaf."""

    operation_id: ArtifactOperationId
    cli_path: ArtifactCliPath
    mcp_tool_name: ArtifactToolName
    contract_version: str | None
    disposition: ArtifactDisposition
    disposition_reason: str | None
    capabilities: frozenset[Literal["local-read"]]
    network_access: Literal["none"]


ARTIFACT_TOOLS = (
    ArtifactToolInventory(
        operation_id=ARTIFACT_LIST_OPERATION.operation_id,
        cli_path="specify artifact list",
        mcp_tool_name="specify_artifact_list",
        contract_version=ARTIFACT_LIST_OPERATION.contract_version,
        disposition="available",
        disposition_reason=None,
        capabilities=ARTIFACT_LIST_OPERATION.capabilities,
        network_access=ARTIFACT_LIST_OPERATION.network_access,
    ),
    ArtifactToolInventory(
        operation_id=ARTIFACT_INFO_OPERATION.operation_id,
        cli_path="specify artifact info",
        mcp_tool_name="specify_artifact_info",
        contract_version=ARTIFACT_INFO_OPERATION.contract_version,
        disposition="available",
        disposition_reason=None,
        capabilities=ARTIFACT_INFO_OPERATION.capabilities,
        network_access=ARTIFACT_INFO_OPERATION.network_access,
    ),
    ArtifactToolInventory(
        operation_id="artifact.lookup",
        cli_path="specify artifact lookup",
        mcp_tool_name="specify_artifact_lookup",
        contract_version=None,
        disposition="unavailable",
        disposition_reason=(
            "The artifact.lookup CLI leaf does not yet have a shared typed operation."
        ),
        capabilities=frozenset({"local-read"}),
        network_access="none",
    ),
)


def register(server: MCPServer, *, launch_directory: Path) -> None:
    """Register every available artifact tool from the explicit inventory."""
    available = {
        item.operation_id: item
        for item in ARTIFACT_TOOLS
        if item.disposition == "available"
    }
    list_tool = available[ARTIFACT_LIST_OPERATION.operation_id]
    register_list(
        server,
        launch_directory=launch_directory,
        tool_name=list_tool.mcp_tool_name,
    )
    info_tool = available[ARTIFACT_INFO_OPERATION.operation_id]
    register_info(
        server,
        launch_directory=launch_directory,
        tool_name=info_tool.mcp_tool_name,
    )