From c9337a12e5a64087be760460259bdc747e49a2d6 Mon Sep 17 00:00:00 2001
From: main <main@swarm.moe>
Date: Fri, 20 Mar 2026 21:19:07 -0400
Subject: Bootstrap minimal issue MCP

---
 crates/jira-at-home/src/mcp/catalog.rs | 140 +++++++++++++++++++++++++++++++++
 1 file changed, 140 insertions(+)
 create mode 100644 crates/jira-at-home/src/mcp/catalog.rs

(limited to 'crates/jira-at-home/src/mcp/catalog.rs')

diff --git a/crates/jira-at-home/src/mcp/catalog.rs b/crates/jira-at-home/src/mcp/catalog.rs
new file mode 100644
index 0000000..2ff8e81
--- /dev/null
+++ b/crates/jira-at-home/src/mcp/catalog.rs
@@ -0,0 +1,140 @@
+use libmcp::ReplayContract;
+use serde_json::{Value, json};
+
+use crate::mcp::output::with_common_presentation;
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq)]
+pub(crate) enum DispatchTarget {
+    Host,
+    Worker,
+}
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq)]
+pub(crate) struct ToolSpec {
+    pub(crate) name: &'static str,
+    pub(crate) description: &'static str,
+    pub(crate) dispatch: DispatchTarget,
+    pub(crate) replay: ReplayContract,
+}
+
+impl ToolSpec {
+    fn annotation_json(self) -> Value {
+        json!({
+            "title": self.name,
+            "readOnlyHint": self.replay == ReplayContract::Convergent,
+            "destructiveHint": self.replay == ReplayContract::NeverReplay,
+            "jiraAtHome": {
+                "dispatch": match self.dispatch {
+                    DispatchTarget::Host => "host",
+                    DispatchTarget::Worker => "worker",
+                },
+                "replayContract": match self.replay {
+                    ReplayContract::Convergent => "convergent",
+                    ReplayContract::ProbeRequired => "probe_required",
+                    ReplayContract::NeverReplay => "never_replay",
+                },
+            }
+        })
+    }
+}
+
+const TOOL_SPECS: &[ToolSpec] = &[
+    ToolSpec {
+        name: "project.bind",
+        description: "Bind this MCP session to a project root or a nested path inside one.",
+        dispatch: DispatchTarget::Host,
+        replay: ReplayContract::NeverReplay,
+    },
+    ToolSpec {
+        name: "issue.save",
+        description: "Create or overwrite one issue note at `issues/<slug>.md`.",
+        dispatch: DispatchTarget::Worker,
+        replay: ReplayContract::NeverReplay,
+    },
+    ToolSpec {
+        name: "issue.list",
+        description: "List the currently open issues. There is no close state; all existing issue files are open.",
+        dispatch: DispatchTarget::Worker,
+        replay: ReplayContract::Convergent,
+    },
+    ToolSpec {
+        name: "issue.read",
+        description: "Read one issue note by slug.",
+        dispatch: DispatchTarget::Worker,
+        replay: ReplayContract::Convergent,
+    },
+    ToolSpec {
+        name: "system.health",
+        description: "Read MCP host health, binding state, worker generation, and rollout state.",
+        dispatch: DispatchTarget::Host,
+        replay: ReplayContract::Convergent,
+    },
+    ToolSpec {
+        name: "system.telemetry",
+        description: "Read aggregate MCP host telemetry and top hot methods for this session.",
+        dispatch: DispatchTarget::Host,
+        replay: ReplayContract::Convergent,
+    },
+];
+
+pub(crate) fn tool_spec(name: &str) -> Option<ToolSpec> {
+    TOOL_SPECS.iter().copied().find(|spec| spec.name == name)
+}
+
+pub(crate) fn tool_definitions() -> Vec<Value> {
+    TOOL_SPECS
+        .iter()
+        .map(|spec| {
+            json!({
+                "name": spec.name,
+                "description": spec.description,
+                "inputSchema": tool_schema(spec.name),
+                "annotations": spec.annotation_json(),
+            })
+        })
+        .collect()
+}
+
+fn tool_schema(name: &str) -> Value {
+    match name {
+        "project.bind" => with_common_presentation(json!({
+            "type": "object",
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "description": "Project root or any nested path inside the target project."
+                }
+            },
+            "required": ["path"]
+        })),
+        "issue.save" => with_common_presentation(json!({
+            "type": "object",
+            "properties": {
+                "slug": {
+                    "type": "string",
+                    "description": "Stable slug. Stored at `issues/<slug>.md`."
+                },
+                "body": {
+                    "type": "string",
+                    "description": "Freeform issue body. Markdown is fine."
+                }
+            },
+            "required": ["slug", "body"]
+        })),
+        "issue.list" | "system.health" | "system.telemetry" => with_common_presentation(json!({
+            "type": "object",
+            "properties": {}
+        })),
+        "issue.read" => with_common_presentation(json!({
+            "type": "object",
+            "properties": {
+                "slug": {
+                    "type": "string",
+                    "description": "Issue slug to read."
+                }
+            },
+            "required": ["slug"]
+        })),
+        _ => Value::Null,
+    }
+}
-- 
cgit v1.2.3