outline_capability_report

Instructions

Implementation Reference

• src/outline_wiki_mcp/server.py:124-128 (handler)

  The MCP tool handler that exposes outline_capability_report. It is decorated with @mcp.tool and calls the helper function capability_report().

  @mcp.tool(annotations=READ_ONLY)
  def outline_capability_report() -> dict[str, Any]:
      """Return v0.2 control-plane capability metadata."""
  
      return capability_report()

• src/outline_wiki_mcp/server.py:84-88 (helper)

  Helper function that resolves the config and calls build_capability_report() from the capability_report module, wrapping the result in a success response.

  def capability_report(config: Config | None = None) -> dict[str, Any]:
      """Return machine-readable component and tool metadata."""
  
      runtime_config = config or get_config()
      return success_response(build_capability_report(runtime_config))

• src/outline_wiki_mcp/capability_report.py:117-167 (helper)

  Core builder function that constructs the full capability report dictionary, including component metadata, tool contracts, risk classes, and warnings.

  def build_capability_report(config: Config) -> dict[str, Any]:
      """Build the control-plane capability report."""
  
      available_tools = [tool["toolName"] for tool in TOOL_CONTRACTS]
      hidden_full_mode_tools: list[str] = []
      return {
          "componentId": "outline-wiki-mcp",
          "componentName": "Outline Wiki MCP",
          "componentType": "individual_mcp",
          "version": __version__,
          "schemaVersion": "0.2",
          "environment": config.environment,
          "mode": config.mcp_mode,
          "readOnly": config.read_only,
          "controlPlaneProfile": config.control_plane_profile,
          "businessDomain": "knowledge",
          "systemOwner": "CEO",
          "technicalOwner": "CEO",
          "safeDefaultMode": "agentic",
          "readOnlyDefault": True,
          "killSwitchStatus": "planned",
          "productionUseAllowed": False,
          "supportedTransports": ["stdio"],
          "availableTools": available_tools,
          "hiddenFullModeTools": hidden_full_mode_tools,
          "toolContracts": TOOL_CONTRACTS,
          "riskClasses": ["READ_ONLY"],
          "reversibilityClasses": ["R0"],
          "dataClassifications": ["internal"],
          "knownNoGoGates": [
              "read_only",
              "confirmation_required",
              "missing_capability_metadata",
              "secrets_exposure",
          ],
          "openFailureModes": [
              "OW-FM-001",
              "OW-FM-002",
              "OW-FM-003",
              "OW-FM-004",
              "OW-FM-005",
              "OW-FM-009",
              "OW-FM-010",
          ],
          "thresholdRegistryStatus": "baseline_planned",
          "productionConfidenceStatus": "not_production_ready",
          "warnings": [
              "TASK-001 bootstrap only.",
              "No production readiness, W3/W4/W5 maturity, or C5 conformance claimed.",
          ],
      }

• src/outline_wiki_mcp/capability_report.py:44-80 (schema)

  The tool contract / schema definition for outline_capability_report in the TOOL_CONTRACTS list, specifying its metadata, risk class, allowed lanes, and governance attributes.

  {
      "toolName": "outline_capability_report",
      "description": "Report v0.2 control-plane metadata.",
      "category": "Diagnostics",
      "riskClass": "READ_ONLY",
      "reversibilityClass": "R0",
      "dataClassification": "internal",
      "externalEffect": False,
      "modeExposure": "agentic",
      "allowedLanes": [
          "direct_mcp_lane",
          "production_confidence_lane",
          "investigation_lane",
      ],
      "allowedOperatingModes": [
          "startup",
          "growth",
          "mature",
          "crisis_alert_state_read_only",
      ],
      "readOnlySafe": True,
      "dryRunDefault": None,
      "requiresConfirmation": False,
      "requiredApprovalLevel": "none",
      "requiresApprovalPack": False,
      "requiresDecisionRecord": False,
      "productionConfidenceRequired": True,
      "auditEvents": ["capability_report_read"],
      "policyGates": [],
      "noGoGates": ["missing_capability_metadata"],
      "rollbackAvailable": None,
      "compensationRequired": False,
      "killSwitchAffected": False,
      "owner": "CEO",
      "status": "implemented",
      "version": __version__,
  },

• src/outline_wiki_mcp/server.py:101-103 (registration)

  The tool is listed as an implemented tool in the diagnostics function output, representing its registration in the server.

  "implementedTools": [
      "outline_validate_connection",
      "outline_capability_report",