@mushi-mushi/mcp 0.3.6 → 0.3.8

package/dist/index.js

@@ -83,6 +83,55 @@ var TOOL_CATALOG = [
     hints: { readOnly: true, idempotent: true, openWorld: true },
     useCase: "Which components had the most critical bugs this week?"
   },
+  // --- Inventory v2 (whitepaper §6.8) -------------------------------------
+  {
+    name: "inventory_get",
+    title: "Inventory snapshot",
+    description: "Current inventory.yaml snapshot for a project (latest ingest, validation errors, per-action status summary). Requires inventory_v2 on the project plan.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What does the live inventory claim for this repo right now?"
+  },
+  {
+    name: "inventory_diff",
+    title: "Inventory diff",
+    description: "Diff two ingested inventory commits (fromSha \u2192 toSha) \u2014 added/removed nodes and edges. Use before merging a PR that touches inventory.yaml.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What changed in inventory between these two SHAs?"
+  },
+  {
+    name: "inventory_findings",
+    title: "Gate findings",
+    description: "Latest gate runs + findings (dead-handler, mock-leak, crawl, status-claim, \u2026). Filter by gate name or severity.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "Show me what CI gates failed on the last run."
+  },
+  {
+    name: "graph_neighborhood",
+    title: "Graph neighborhood",
+    description: 'BFS neighborhood around a graph node id or label \u2014 nodes + edges within a depth budget (max 4). Same backend as knowledge-graph traversal, tuned for "what touches this action?".',
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What nodes connect to this inventory Action within 2 hops?"
+  },
+  {
+    name: "graph_node_status",
+    title: "Graph node detail",
+    description: "Fetch a single graph node row (label, type, metadata \u2014 includes v2 derived status on Action nodes).",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What status does the graph store on this node id?"
+  },
+  {
+    name: "fix_suggest",
+    title: "Suggested fix (from triage)",
+    description: "Read-only slice of a report focused on Stage 2 suggested fix + root cause + reproduction \u2014 faster than pulling the full blob when you only need the human-readable hint.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What did Stage 2 say we should try for this report?"
+  },
   // --- Write / agentic ----------------------------------------------------
   {
     name: "submit_fix_result",
@@ -109,6 +158,14 @@ var TOOL_CATALOG = [
     hints: { readOnly: false, destructive: false, idempotent: true, openWorld: true },
     useCase: "Grade the latest batch of fixes before I ship."
   },
+  {
+    name: "test_gen_from_report",
+    title: "Generate Playwright test from report",
+    description: "POST to inventory test-gen: uses the project BYOK LLM to author a Playwright spec from a classified report and opens a draft PR (internal service orchestration). Requires inventory_v2 + GitHub + LLM keys.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: false, openWorld: true },
+    useCase: "Turn this regression report into an E2E test PR."
+  },
   {
     name: "transition_status",
     title: "Move report between states",
@@ -347,6 +404,129 @@ function createMushiServer(config) {
       return jsonText(await apiCall(`/v1/admin/graph/traverse?${params}`));
     }
   );
+  server.registerTool(
+    "graph_neighborhood",
+    {
+      title: titleOf("graph_neighborhood"),
+      description: descOf("graph_neighborhood"),
+      annotations: annotationsFor("graph_neighborhood"),
+      inputSchema: {
+        seed: z.string().describe("Starting node id or label"),
+        depth: z.number().optional().describe("Traversal depth (default 2, max 4)")
+      }
+    },
+    async (args) => {
+      const params = new URLSearchParams({
+        seed: args.seed,
+        depth: String(Math.min(args.depth ?? 2, 4))
+      });
+      return jsonText(await apiCall(`/v1/admin/graph/traverse?${params}`));
+    }
+  );
+  server.registerTool(
+    "graph_node_status",
+    {
+      title: titleOf("graph_node_status"),
+      description: descOf("graph_node_status"),
+      annotations: annotationsFor("graph_node_status"),
+      inputSchema: { nodeId: z.string().describe("graph_nodes.id") }
+    },
+    async (args) => jsonText(await apiCall(`/v1/admin/graph/node/${args.nodeId}`))
+  );
+  server.registerTool(
+    "inventory_get",
+    {
+      title: titleOf("inventory_get"),
+      description: descOf("inventory_get"),
+      annotations: annotationsFor("inventory_get"),
+      inputSchema: {
+        projectId: z.string().optional().describe("Project UUID \u2014 defaults to the server-configured project when omitted")
+      }
+    },
+    async (args) => {
+      const pid = args.projectId ?? projectId;
+      if (!pid) throw new MushiApiError(400, "MISSING_PROJECT", "projectId is required for inventory_get");
+      return jsonText(await apiCall(`/v1/admin/inventory/${pid}`));
+    }
+  );
+  server.registerTool(
+    "inventory_diff",
+    {
+      title: titleOf("inventory_diff"),
+      description: descOf("inventory_diff"),
+      annotations: annotationsFor("inventory_diff"),
+      inputSchema: {
+        projectId: z.string().optional().describe("Project UUID \u2014 defaults to configured project"),
+        fromSha: z.string().describe("Older commit SHA (baseline)"),
+        toSha: z.string().describe("Newer commit SHA (candidate)")
+      }
+    },
+    async (args) => {
+      const pid = args.projectId ?? projectId;
+      if (!pid) throw new MushiApiError(400, "MISSING_PROJECT", "projectId is required for inventory_diff");
+      const q = new URLSearchParams({ from: args.fromSha, to: args.toSha });
+      return jsonText(await apiCall(`/v1/admin/inventory/${pid}/diff?${q}`));
+    }
+  );
+  server.registerTool(
+    "inventory_findings",
+    {
+      title: titleOf("inventory_findings"),
+      description: descOf("inventory_findings"),
+      annotations: annotationsFor("inventory_findings"),
+      inputSchema: {
+        projectId: z.string().optional().describe("Project UUID \u2014 defaults to configured project"),
+        gate: z.string().optional().describe("Filter by gate id (e.g. dead_handler, status_claim)"),
+        severity: z.string().optional().describe("Filter findings by severity")
+      }
+    },
+    async (args) => {
+      const pid = args.projectId ?? projectId;
+      if (!pid) throw new MushiApiError(400, "MISSING_PROJECT", "projectId is required for inventory_findings");
+      const q = new URLSearchParams();
+      if (args.gate) q.set("gate", args.gate);
+      if (args.severity) q.set("severity", args.severity);
+      const suffix = q.toString() ? `?${q}` : "";
+      return jsonText(await apiCall(`/v1/admin/inventory/${pid}/findings${suffix}`));
+    }
+  );
+  server.registerTool(
+    "fix_suggest",
+    {
+      title: titleOf("fix_suggest"),
+      description: descOf("fix_suggest"),
+      annotations: annotationsFor("fix_suggest"),
+      inputSchema: { reportId: z.string().describe("Report UUID") }
+    },
+    async (args) => {
+      const report = await apiCall(`/v1/admin/reports/${args.reportId}`);
+      const s2 = report.stage2_analysis;
+      return jsonText({
+        reportId: args.reportId,
+        rootCause: s2?.rootCause ?? null,
+        suggestedFix: s2?.suggestedFix ?? null,
+        reproductionSteps: report.reproduction_steps ?? [],
+        summary: report.summary ?? null,
+        component: report.component ?? null
+      });
+    }
+  );
+  server.registerTool(
+    "run_nl_query",
+    {
+      title: titleOf("run_nl_query"),
+      description: descOf("run_nl_query"),
+      annotations: annotationsFor("run_nl_query"),
+      inputSchema: { question: z.string().describe('Question in plain English, e.g. "Which components had the most critical bugs this week?"') }
+    },
+    async (args) => {
+      const data = await apiCall("/v1/admin/query", {
+        method: "POST",
+        body: JSON.stringify({ question: args.question })
+      });
+      return jsonText(data);
+    }
+  );
   server.registerTool(
     "submit_fix_result",
     {
@@ -441,6 +621,27 @@ function createMushiServer(config) {
       return jsonText(data);
     }
   );
+  server.registerTool(
+    "test_gen_from_report",
+    {
+      title: titleOf("test_gen_from_report"),
+      description: descOf("test_gen_from_report"),
+      annotations: annotationsFor("test_gen_from_report"),
+      inputSchema: {
+        reportId: z.string().describe("Report UUID to turn into a Playwright PR"),
+        projectId: z.string().optional().describe("Project UUID \u2014 defaults to configured project")
+      }
+    },
+    async (args) => {
+      const pid = args.projectId ?? projectId;
+      if (!pid) throw new MushiApiError(400, "MISSING_PROJECT", "projectId is required for test_gen_from_report");
+      const data = await apiCall(`/v1/admin/inventory/${pid}/test-gen/from-report/${args.reportId}`, {
+        method: "POST",
+        body: JSON.stringify({})
+      });
+      return jsonText(data);
+    }
+  );
   server.registerTool(
     "transition_status",
     {
@@ -461,22 +662,6 @@ function createMushiServer(config) {
       return jsonText(data);
     }
   );
-  server.registerTool(
-    "run_nl_query",
-    {
-      title: titleOf("run_nl_query"),
-      description: descOf("run_nl_query"),
-      annotations: annotationsFor("run_nl_query"),
-      inputSchema: { question: z.string().describe('Question in plain English, e.g. "Which components had the most critical bugs this week?"') }
-    },
-    async (args) => {
-      const data = await apiCall("/v1/admin/query", {
-        method: "POST",
-        body: JSON.stringify({ question: args.question })
-      });
-      return jsonText(data);
-    }
-  );
   server.resource(
     "project_stats",
     "project://stats",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mushi-mushi/mcp",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "license": "MIT",
   "description": "MCP server exposing Mushi Mushi reports to coding agents",
   "type": "module",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^4.3.6",
-    "@mushi-mushi/core": "^0.7.0"
+    "@mushi-mushi/core": "^0.9.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",