@mushi-mushi/mcp 0.2.1 → 0.3.0

package/README.md

@@ -52,11 +52,28 @@ The server speaks stdio MCP transport by default — your client launches it as
 
 ## Tools
 
+### Read
+
 | Tool | What it does |
 |---|---|
 | `get_recent_reports` | Fetch the N most recent reports, with optional `status` / `category` / `severity` filters |
 | `get_report_detail` | Full payload for a single report — description, console logs, network requests, screenshot URL, classification result, fix history |
-| `search_reports` | Keyword + semantic search across reports for the configured project |
+| `search_reports` | Semantic + keyword search (server-side pgvector; falls back to keyword match when embeddings aren't available) |
+| `get_similar_bugs` | Embedding-nearest neighbours for a component, page, or description |
+| `get_fix_context` | One-shot brief for a coding agent: report + repro + root-cause + ontology tags |
+| `get_fix_timeline` | Ordered timeline of a fix attempt (dispatched → started → branch → commit → PR → CI → completed/failed) |
+| `get_blast_radius` | Graph traversal showing other components a bug group touches |
+| `get_knowledge_graph` | Traverse the knowledge graph from a seed component or page |
+
+### Write / agentic
+
+| Tool | What it does |
+|---|---|
+| `submit_fix_result` | Record a fix outcome (branch, PR, files, lines) from an external agent |
+| `dispatch_fix` | Kick off the agentic fix orchestrator for a report — returns a `fix_attempt` id |
+| `trigger_judge` | Run the Sonnet-as-Judge over a batch of classified reports |
+| `transition_status` | Move a report between workflow states (enforces the same rules as the UI) |
+| `run_nl_query` | Natural-language → read-only SQL against your project data (60/hour rate-limited) |
 
 > Need a tool that isn't here? Open an issue at [github.com/kensaurus/mushi-mushi/issues](https://github.com/kensaurus/mushi-mushi/issues) and tag it `mcp`.
 
@@ -64,8 +81,19 @@ The server speaks stdio MCP transport by default — your client launches it as
 
 | URI | Returns |
 |---|---|
-| `project://settings` | Project config (name, autofix settings, plugins enabled, ontology) |
 | `project://stats` | Counts of new / classified / fixed reports + last 7-day trend |
+| `project://settings` | Project config — autofix agent, plugins enabled, ontology, LLM budgets |
+| `project://dashboard` | PDCA health snapshot — stage counts, bottleneck, recent activity (the same payload the admin console polls every 15 s) |
+
+## Prompts
+
+Named templates the MCP client surfaces in its slash-menu. Each one bakes in the house voice ("lead with the fix, skip the preamble") so agents produce consistent outputs across editors.
+
+| Prompt | When to use |
+|---|---|
+| `summarize_report_for_fix` | Before asking the agent to write the patch — produces a one-line root cause, smallest file set, repro steps, and blast-radius warnings |
+| `explain_judge_result` | After the judge scores a fix — turns the raw scores into ship / iterate / dismiss guidance |
+| `triage_next_steps` | "What should I focus on right now?" — five-item markdown list drawn from the dashboard + recent classified queue |
 
 ## Environment variables
 

package/dist/index.js

@@ -170,6 +170,82 @@ server.tool(
     };
   }
 );
+server.tool(
+  "trigger_judge",
+  "Run the Sonnet-as-Judge over a batch of classified reports. Returns batch id; results land in judge_results.",
+  {
+    limit: z.number().optional().describe("Max reports to judge in this batch (default 25, max 100)"),
+    projectId: z.string().optional().describe("Restrict to one project when the API key owns multiple")
+  },
+  async (args) => {
+    const data = await apiCall("/v1/admin/judge/run", {
+      method: "POST",
+      body: JSON.stringify({ limit: Math.min(args.limit ?? 25, 100), projectId: args.projectId })
+    });
+    return { content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }] };
+  }
+);
+server.tool(
+  "dispatch_fix",
+  "Dispatch the agentic fix orchestrator for a classified report. Returns fix_attempt id; stream progress via get_fix_progress.",
+  {
+    reportId: z.string().describe("Report UUID to fix"),
+    agent: z.enum(["claude_code", "codex", "rest_worker", "mcp"]).optional().describe("Override the agent adapter")
+  },
+  async (args) => {
+    const data = await apiCall("/v1/admin/fixes/dispatch", {
+      method: "POST",
+      body: JSON.stringify({ reportId: args.reportId, agent: args.agent })
+    });
+    return { content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }] };
+  }
+);
+server.tool(
+  "transition_status",
+  "Move a report between workflow states. Enforces the same transition rules as the admin UI.",
+  {
+    reportId: z.string().describe("Report UUID"),
+    status: z.enum(["pending", "classified", "grouped", "fixing", "fixed", "dismissed"]).describe("Target status"),
+    reason: z.string().optional().describe("Reason for the transition (audit trail)")
+  },
+  async (args) => {
+    const data = await apiCall(`/v1/admin/reports/${args.reportId}`, {
+      method: "PATCH",
+      body: JSON.stringify({ status: args.status, reason: args.reason })
+    });
+    return { content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }] };
+  }
+);
+server.tool(
+  "run_nl_query",
+  "Natural-language question \u2192 SQL query run against your project data. Read-only, 60/hour rate-limited, no privileged schemas.",
+  {
+    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 { content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }] };
+  }
+);
+server.tool(
+  "get_knowledge_graph",
+  "Traverse the knowledge graph from a seed component or page. Returns nodes + edges within a depth budget.",
+  {
+    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))
+    });
+    const data = await apiCall(`/v1/admin/graph/traverse?${params}`);
+    return { content: [{ type: "text", text: JSON.stringify(data.data, null, 2) }] };
+  }
+);
 server.resource(
   "project_stats",
   "project://stats",

package/package.json

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