@smilintux/skcapstone 0.3.1 → 0.3.2

package/src/skcapstone/mcp_server.py

@@ -55,6 +55,16 @@ Tools:
     kms_list_keys   — List all KMS keys
     kms_rotate      — Rotate a KMS key
     model_route     — Route task to optimal model tier/name
+    itil_incident_create — Create ITIL incident
+    itil_incident_update — Update incident status/severity
+    itil_incident_list   — List/filter incidents
+    itil_problem_create  — Create problem record
+    itil_problem_update  — Update problem/root cause
+    itil_change_propose  — Propose change (RFC)
+    itil_change_update   — Update change status
+    itil_cab_vote        — Submit CAB vote
+    itil_status          — ITIL dashboard
+    itil_kedb_search     — Search Known Error Database
 
 Invocation (all equivalent):
     skcapstone mcp serve                     # CLI entry point
@@ -2470,6 +2480,180 @@ async def list_tools() -> list[Tool]:
                 "required": ["name"],
             },
         ),
+        # ── ITIL Service Management ─────────────────────────────
+        Tool(
+            name="itil_incident_create",
+            description=(
+                "Create a new ITIL incident for a service disruption. "
+                "Auto-creates a linked GTD item (next-action for sev1/sev2, inbox for sev3/sev4)."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "title": {"type": "string", "description": "Brief description of the incident"},
+                    "severity": {"type": "string", "enum": ["sev1", "sev2", "sev3", "sev4"], "description": "Severity level (default: sev3)"},
+                    "source": {"type": "string", "enum": ["service_health", "dreaming", "manual", "daemon_error", "heartbeat"], "description": "Detection source (default: manual)"},
+                    "affected_services": {"type": "array", "items": {"type": "string"}, "description": "List of affected service names"},
+                    "impact": {"type": "string", "description": "Business impact description"},
+                    "managed_by": {"type": "string", "description": "Agent responsible for managing this incident"},
+                    "tags": {"type": "array", "items": {"type": "string"}, "description": "Tags for categorization"},
+                },
+                "required": ["title"],
+            },
+        ),
+        Tool(
+            name="itil_incident_update",
+            description=(
+                "Update an incident: transition status, escalate severity, "
+                "add timeline notes, or resolve. Valid status transitions: "
+                "detected->acknowledged->investigating->resolved->closed."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "incident_id": {"type": "string", "description": "Incident ID (e.g. inc-a1b2c3d4)"},
+                    "agent": {"type": "string", "description": "Agent making the update"},
+                    "new_status": {"type": "string", "enum": ["acknowledged", "investigating", "escalated", "resolved", "closed"], "description": "New status"},
+                    "severity": {"type": "string", "enum": ["sev1", "sev2", "sev3", "sev4"], "description": "New severity"},
+                    "note": {"type": "string", "description": "Timeline note"},
+                    "resolution_summary": {"type": "string", "description": "Resolution summary (when resolving)"},
+                    "related_problem_id": {"type": "string", "description": "Link to a related problem record"},
+                },
+                "required": ["incident_id", "agent"],
+            },
+        ),
+        Tool(
+            name="itil_incident_list",
+            description="List ITIL incidents filtered by status, severity, or affected service.",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "status": {"type": "string", "enum": ["detected", "acknowledged", "investigating", "escalated", "resolved", "closed"], "description": "Filter by status"},
+                    "severity": {"type": "string", "enum": ["sev1", "sev2", "sev3", "sev4"], "description": "Filter by severity"},
+                    "service": {"type": "string", "description": "Filter by affected service name"},
+                },
+                "required": [],
+            },
+        ),
+        Tool(
+            name="itil_problem_create",
+            description=(
+                "Create a new ITIL problem record to investigate root cause. "
+                "Links to related incidents and auto-creates a GTD project."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "title": {"type": "string", "description": "Problem title"},
+                    "managed_by": {"type": "string", "description": "Agent responsible for investigation"},
+                    "related_incident_ids": {"type": "array", "items": {"type": "string"}, "description": "Related incident IDs"},
+                    "workaround": {"type": "string", "description": "Known workaround if any"},
+                    "tags": {"type": "array", "items": {"type": "string"}, "description": "Tags for categorization"},
+                },
+                "required": ["title"],
+            },
+        ),
+        Tool(
+            name="itil_problem_update",
+            description=(
+                "Update a problem record: transition status, set root cause, "
+                "add workaround, optionally create a KEDB entry. "
+                "Valid transitions: identified->analyzing->known_error->resolved."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "problem_id": {"type": "string", "description": "Problem ID (e.g. prb-e5f6g7h8)"},
+                    "agent": {"type": "string", "description": "Agent making the update"},
+                    "new_status": {"type": "string", "enum": ["analyzing", "known_error", "resolved"], "description": "New status"},
+                    "root_cause": {"type": "string", "description": "Root cause description"},
+                    "workaround": {"type": "string", "description": "Workaround description"},
+                    "note": {"type": "string", "description": "Timeline note"},
+                    "create_kedb": {"type": "boolean", "description": "Create a KEDB entry from this problem"},
+                },
+                "required": ["problem_id", "agent"],
+            },
+        ),
+        Tool(
+            name="itil_change_propose",
+            description=(
+                "Propose a change (RFC). Standard changes auto-approve. "
+                "Normal changes require CAB approval. Emergency changes have a "
+                "15-min timeout before auto-approval."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "title": {"type": "string", "description": "Change title"},
+                    "change_type": {"type": "string", "enum": ["standard", "normal", "emergency"], "description": "Type of change (default: normal)"},
+                    "risk": {"type": "string", "enum": ["low", "medium", "high"], "description": "Risk level (default: medium)"},
+                    "rollback_plan": {"type": "string", "description": "How to roll back if the change fails"},
+                    "test_plan": {"type": "string", "description": "How to verify the change works"},
+                    "managed_by": {"type": "string", "description": "Agent managing the change"},
+                    "implementer": {"type": "string", "description": "Agent who will implement the change"},
+                    "related_problem_id": {"type": "string", "description": "Related problem ID if applicable"},
+                    "tags": {"type": "array", "items": {"type": "string"}, "description": "Tags for categorization"},
+                },
+                "required": ["title"],
+            },
+        ),
+        Tool(
+            name="itil_change_update",
+            description=(
+                "Update a change: transition status (implementing, deployed, "
+                "verified, failed, closed) or add timeline notes."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "change_id": {"type": "string", "description": "Change ID (e.g. chg-i1j2k3l4)"},
+                    "agent": {"type": "string", "description": "Agent making the update"},
+                    "new_status": {"type": "string", "enum": ["reviewing", "approved", "rejected", "implementing", "deployed", "verified", "failed", "closed"], "description": "New status"},
+                    "note": {"type": "string", "description": "Timeline note"},
+                },
+                "required": ["change_id", "agent"],
+            },
+        ),
+        Tool(
+            name="itil_cab_vote",
+            description=(
+                "Submit a CAB (Change Advisory Board) vote for a proposed change. "
+                "Each agent writes its own vote file (conflict-free). "
+                "A human rejection blocks the change; a human approval unblocks it."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "change_id": {"type": "string", "description": "Change ID to vote on"},
+                    "agent": {"type": "string", "description": "Voting agent name"},
+                    "decision": {"type": "string", "enum": ["approved", "rejected", "abstain"], "description": "Vote decision (default: abstain)"},
+                    "conditions": {"type": "string", "description": "Conditions for approval"},
+                },
+                "required": ["change_id", "agent"],
+            },
+        ),
+        Tool(
+            name="itil_status",
+            description=(
+                "ITIL dashboard: open incidents by severity, active problems, "
+                "pending changes, and KEDB count."
+            ),
+            inputSchema={"type": "object", "properties": {}, "required": []},
+        ),
+        Tool(
+            name="itil_kedb_search",
+            description=(
+                "Search the Known Error Database by symptoms, service name, "
+                "or keywords. Returns matching entries with workarounds."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "query": {"type": "string", "description": "Search query (matches title, symptoms, root cause, tags)"},
+                },
+                "required": ["query"],
+            },
+        ),
     ]
 
 
@@ -2618,6 +2802,17 @@ async def call_tool(name: str, arguments: dict) -> list[TextContent]:
         # Soul Blueprint Registry
         "soul_registry_search": _handle_soul_registry_search,
         "soul_registry_publish": _handle_soul_registry_publish,
+        # ITIL Service Management
+        "itil_incident_create": _handle_itil_incident_create,
+        "itil_incident_update": _handle_itil_incident_update,
+        "itil_incident_list": _handle_itil_incident_list,
+        "itil_problem_create": _handle_itil_problem_create,
+        "itil_problem_update": _handle_itil_problem_update,
+        "itil_change_propose": _handle_itil_change_propose,
+        "itil_change_update": _handle_itil_change_update,
+        "itil_cab_vote": _handle_itil_cab_vote,
+        "itil_status": _handle_itil_status,
+        "itil_kedb_search": _handle_itil_kedb_search,
     }
     handler = handlers.get(name)
     if handler is None:
@@ -4679,6 +4874,69 @@ async def _handle_soul_registry_publish(args: dict) -> list[TextContent]:
         return _error_response(f"Registry publish failed: {exc}")
 
 
+# ── ITIL handlers ─────────────────────────────────────────
+
+
+async def _handle_itil_incident_create(args: dict) -> list[TextContent]:
+    """Create a new ITIL incident."""
+    from .mcp_tools.itil_tools import _handle_itil_incident_create as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_incident_update(args: dict) -> list[TextContent]:
+    """Update an ITIL incident."""
+    from .mcp_tools.itil_tools import _handle_itil_incident_update as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_incident_list(args: dict) -> list[TextContent]:
+    """List ITIL incidents."""
+    from .mcp_tools.itil_tools import _handle_itil_incident_list as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_problem_create(args: dict) -> list[TextContent]:
+    """Create a new ITIL problem."""
+    from .mcp_tools.itil_tools import _handle_itil_problem_create as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_problem_update(args: dict) -> list[TextContent]:
+    """Update an ITIL problem."""
+    from .mcp_tools.itil_tools import _handle_itil_problem_update as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_change_propose(args: dict) -> list[TextContent]:
+    """Propose a change (RFC)."""
+    from .mcp_tools.itil_tools import _handle_itil_change_propose as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_change_update(args: dict) -> list[TextContent]:
+    """Update a change status."""
+    from .mcp_tools.itil_tools import _handle_itil_change_update as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_cab_vote(args: dict) -> list[TextContent]:
+    """Submit a CAB vote."""
+    from .mcp_tools.itil_tools import _handle_itil_cab_vote as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_status(args: dict) -> list[TextContent]:
+    """ITIL dashboard status."""
+    from .mcp_tools.itil_tools import _handle_itil_status as _impl
+    return await _impl(args)
+
+
+async def _handle_itil_kedb_search(args: dict) -> list[TextContent]:
+    """Search the Known Error Database."""
+    from .mcp_tools.itil_tools import _handle_itil_kedb_search as _impl
+    return await _impl(args)
+
+
 # ═══════════════════════════════════════════════════════════
 # Entry Point
 # ═══════════════════════════════════════════════════════════

package/src/skcapstone/mcp_tools/__init__.py

@@ -29,6 +29,7 @@ from . import (
     gtd_tools,
     health_tools,
     heartbeat_tools,
+    itil_tools,
     kms_tools,
     memory_tools,
     model_tools,
@@ -63,6 +64,7 @@ _MODULES = [
     heartbeat_tools,
     file_tools,
     gtd_tools,
+    itil_tools,
     pubsub_tools,
     fortress_tools,
     promoter_tools,

package/src/skcapstone/mcp_tools/gtd_tools.py

@@ -21,7 +21,7 @@ _GTD_LISTS = {
     "someday-maybe": "someday-maybe.json",
 }
 
-_VALID_SOURCES = {"manual", "telegram", "email", "voice"}
+_VALID_SOURCES = {"manual", "telegram", "email", "voice", "itil"}
 _VALID_PRIVACY = {"private", "team", "community", "public"}
 _VALID_STATUSES = {"inbox", "next", "project", "waiting", "someday", "reference", "done"}
 _VALID_PRIORITIES = {"critical", "high", "medium", "low"}