@mushi-mushi/mcp 0.11.0 → 0.13.0

package/dist/index.js

@@ -183,14 +183,35 @@ var TOOL_CATALOG = [
   {
     name: "transition_status",
     title: "Move report between states",
-    description: "Move a report between workflow states (new \u2192 classified \u2192 grouped \u2192 fixing \u2192 fixed \u2192 dismissed). Enforces the same transition rules as the admin UI.",
+    description: "Move a report between workflow states (new \u2192 classified \u2192 grouped \u2192 fixing \u2192 fixed \u2192 verified \u2192 reopened \u2192 dismissed). Enforces the same transition rules as the admin UI.",
     scope: "mcp:write",
-    // Transitioning to `dismissed` is destructive by intent — it removes the
-    // report from triage queues. Flag the whole tool as destructive so the
-    // client prompts the user on every call.
     hints: { readOnly: false, destructive: true, idempotent: true, openWorld: true },
     useCase: "Dismiss this duplicate / mark it fixed."
   },
+  {
+    name: "merge_fix",
+    title: "Merge fix PR",
+    description: "Squash-merge a fix attempt PR and mark the linked report fixed.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: true, idempotent: true, openWorld: true },
+    useCase: "Merge the draft PR and notify the reporter."
+  },
+  {
+    name: "refresh_ci",
+    title: "Refresh fix CI status",
+    description: "Pull the latest GitHub check-run status for a fix attempt.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "Check whether CI is green before merging."
+  },
+  {
+    name: "reopen_report",
+    title: "Reopen report (operator)",
+    description: "Move a report to reopened for regression triage.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: true, openWorld: true },
+    useCase: "Reopen a regression the reporter flagged as not fixed."
+  },
   // --- Rewards (P3) -------------------------------------------------------
   {
     name: "list_top_contributors",
@@ -330,6 +351,47 @@ var TDD_TOOL_CATALOG = [
     hints: { readOnly: false, destructive: false, idempotent: false, openWorld: true },
     useCase: 'Did "Add to Slack" work? Send a test ping to confirm.'
   },
+  // ── Skill Pipeline tools ─────────────────────────────────────────────────────
+  {
+    name: "list_skills",
+    title: "List agent skills",
+    description: "List the agent skills available in the catalog, optionally filtered by category. Returns slug, title, description, category, and chain_slugs for each skill. Use before start_skill_pipeline to find the right skill slug for a given type of work.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What skills are available for debugging production errors?"
+  },
+  {
+    name: "get_skill",
+    title: "Get skill detail",
+    description: "Fetch the full detail for a single agent skill by slug, including the complete SKILL.md body and resolved chain. Use before executing a step to understand what the skill expects you to do.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "What does workflow-fix-and-ship actually instruct me to do?"
+  },
+  {
+    name: "start_skill_pipeline",
+    title: "Start a skill pipeline",
+    description: "Start a new skill pipeline run for a report. Pass root_skill_slug and optionally report_id. Returns run_id, context_packet (full instructions + report context), and step list. Read the context_packet \u2014 it contains skill instructions plus full report context (repro steps, root cause, RAG files). After executing each step, call checkin_pipeline_step. The PM watching the console sees progress live.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: false, openWorld: true },
+    useCase: "Start the workflow-fix-and-ship pipeline for this bug report."
+  },
+  {
+    name: "get_pipeline_run",
+    title: "Get pipeline run detail",
+    description: "Fetch the full detail for a skill pipeline run: status, context_packet, and all step statuses. Call to retrieve the context_packet after a pipeline was started from the console or another agent.",
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: true },
+    useCase: "Give me the context packet and step status for this pipeline run."
+  },
+  {
+    name: "checkin_pipeline_step",
+    title: "Check in a pipeline step",
+    description: "Report the completion status of a pipeline step (passed, failed, running, or skipped). Optionally include notes, a PR URL, or the Cursor agentId. Updates the live React Flow canvas in the Mushi console so PMs see real-time progress.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: true, openWorld: true },
+    useCase: "I just opened the PR \u2014 mark step 2 as passed and link the PR."
+  },
   // ── Full-Stack Audit tools (Phase 5) ────────────────────────────────────────
   {
     name: "run_fullstack_audit",
@@ -795,12 +857,15 @@ function createMushiServer(config) {
         prUrl: z.string().optional().describe("GitHub PR URL"),
         filesChanged: z.array(z.string()).describe("Files modified"),
         linesChanged: z.number().describe("Total lines changed"),
-        summary: z.string().describe("Fix summary")
+        summary: z.string().describe("Fix summary"),
+        idempotencyKey: z.string().uuid().optional().describe("Optional UUID \u2014 resend the same key to safely retry without creating duplicate fix rows")
       }
     },
     async (args) => {
+      const idemKey = args.idempotencyKey ?? crypto.randomUUID();
       const created = await apiCall("/v1/admin/fixes", {
         method: "POST",
+        headers: { "Idempotency-Key": idemKey },
         body: JSON.stringify({ reportId: args.reportId, agent: "mcp" })
       });
       await apiCall(`/v1/admin/fixes/${created.fixId}`, {
@@ -906,6 +971,59 @@ function createMushiServer(config) {
       return jsonText(data);
     }
   );
+  server.registerTool(
+    "merge_fix",
+    {
+      title: "Merge fix PR",
+      description: "Squash-merge a fix attempt PR and mark the linked report fixed.",
+      annotations: annotationsFor("merge_fix"),
+      inputSchema: {
+        fixId: z.string().describe("Fix attempt UUID"),
+        mergeMethod: z.enum(["squash", "merge", "rebase"]).optional().describe("GitHub merge method")
+      }
+    },
+    async (args) => {
+      const data = await apiCall(`/v1/admin/fixes/${args.fixId}/merge`, {
+        method: "POST",
+        body: JSON.stringify({ mergeMethod: args.mergeMethod ?? "squash" })
+      });
+      return jsonText(data);
+    }
+  );
+  server.registerTool(
+    "refresh_ci",
+    {
+      title: "Refresh fix CI status",
+      description: "Pull the latest GitHub check-run status for a fix attempt.",
+      annotations: annotationsFor("refresh_ci"),
+      inputSchema: {
+        fixId: z.string().describe("Fix attempt UUID")
+      }
+    },
+    async (args) => {
+      const data = await apiCall(`/v1/admin/fixes/${args.fixId}/refresh-ci`, { method: "POST" });
+      return jsonText(data);
+    }
+  );
+  server.registerTool(
+    "reopen_report",
+    {
+      title: "Reopen report (operator)",
+      description: "Operator alias to move a report back to new for regression triage.",
+      annotations: annotationsFor("reopen_report"),
+      inputSchema: {
+        reportId: z.string().describe("Report UUID"),
+        note: z.string().optional().describe("Triage note")
+      }
+    },
+    async (args) => {
+      const data = await apiCall(`/v1/sync/reports/${args.reportId}`, {
+        method: "PATCH",
+        body: JSON.stringify({ status: "reopened", note: args.note })
+      });
+      return jsonText(data);
+    }
+  );
   server.registerTool(
     "transition_status",
     {
@@ -914,7 +1032,7 @@ function createMushiServer(config) {
       annotations: annotationsFor("transition_status"),
       inputSchema: {
         reportId: z.string().describe("Report UUID"),
-        status: z.enum(["pending", "classified", "grouped", "fixing", "fixed", "dismissed"]).describe("Target status"),
+        status: z.enum(["pending", "classified", "grouped", "fixing", "fixed", "resolved", "verified", "reopened", "dismissed"]).describe("Target status"),
         reason: z.string().optional().describe("Reason for the transition (audit trail)")
       }
     },
@@ -1468,6 +1586,107 @@ Prefer items that are bottlenecks or critical severity. Skip filler.`
       return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
   );
+  server.registerTool(
+    "list_skills",
+    {
+      title: titleOf("list_skills"),
+      description: descOf("list_skills"),
+      annotations: annotationsFor("list_skills"),
+      inputSchema: {
+        category: z.string().optional().describe("Filter by category: workflow, debug, test, audit, enhance, \u2026"),
+        search: z.string().optional().describe("Free-text search across slug, title, description"),
+        page: z.number().optional().describe("Page number (default 1)"),
+        limit: z.number().optional().describe("Max results per page (default 200, max 200)")
+      }
+    },
+    async (args) => {
+      const qs = new URLSearchParams();
+      if (args.category) qs.set("category", args.category);
+      if (args.search) qs.set("q", args.search);
+      if (args.page) qs.set("page", String(args.page));
+      qs.set("limit", String(Math.min(args.limit ?? 200, 200)));
+      const data = await apiCall(`/v1/admin/skills?${qs}`);
+      const skills = Array.isArray(data) ? data : [];
+      return jsonText({ skills, count: skills.length });
+    }
+  );
+  server.registerTool(
+    "get_skill",
+    {
+      title: titleOf("get_skill"),
+      description: descOf("get_skill"),
+      annotations: annotationsFor("get_skill"),
+      inputSchema: {
+        slug: z.string().describe('Skill slug, e.g. "workflow-fix-and-ship"')
+      }
+    },
+    async (args) => {
+      const data = await apiCall(`/v1/admin/skills/${args.slug}`);
+      return jsonText(data);
+    }
+  );
+  server.registerTool(
+    "start_skill_pipeline",
+    {
+      title: titleOf("start_skill_pipeline"),
+      description: descOf("start_skill_pipeline"),
+      annotations: annotationsFor("start_skill_pipeline"),
+      inputSchema: {
+        root_skill_slug: z.string().describe('Root skill slug to run, e.g. "workflow-fix-and-ship"'),
+        report_id: z.string().optional().describe("Report UUID to attach the pipeline to"),
+        mode: z.enum(["handoff", "cloud"]).optional().describe("handoff (default): get context packet for local agent. cloud: auto-dispatch via Cursor Cloud."),
+        project_id: z.string().optional().describe("Project UUID. Falls back to the configured project.")
+      }
+    },
+    async (args) => {
+      const resolvedProjectId = args.project_id ?? projectId;
+      if (!resolvedProjectId) return jsonText({ error: "No project_id provided or configured." });
+      const data = await apiCall(
+        "/v1/admin/skills/pipelines",
+        { method: "POST", body: JSON.stringify({ ...args, project_id: resolvedProjectId }) }
+      );
+      return jsonText(data);
+    }
+  );
+  server.registerTool(
+    "get_pipeline_run",
+    {
+      title: titleOf("get_pipeline_run"),
+      description: descOf("get_pipeline_run"),
+      annotations: annotationsFor("get_pipeline_run"),
+      inputSchema: {
+        run_id: z.string().describe("Pipeline run UUID")
+      }
+    },
+    async (args) => {
+      const data = await apiCall(`/v1/admin/skills/pipelines/${args.run_id}`);
+      return jsonText(data);
+    }
+  );
+  server.registerTool(
+    "checkin_pipeline_step",
+    {
+      title: titleOf("checkin_pipeline_step"),
+      description: descOf("checkin_pipeline_step"),
+      annotations: annotationsFor("checkin_pipeline_step"),
+      inputSchema: {
+        run_id: z.string().describe("Pipeline run UUID"),
+        step_index: z.number().describe("Step index (0-based)"),
+        status: z.enum(["running", "passed", "failed", "skipped"]).describe("Step status"),
+        notes: z.string().optional().describe("Optional notes or output summary"),
+        pr_url: z.string().optional().describe("PR URL opened during this step"),
+        agent_ref: z.string().optional().describe("Cursor agentId or external agent reference")
+      }
+    },
+    async (args) => {
+      const { run_id, step_index, ...body } = args;
+      await apiCall(
+        `/v1/admin/skills/pipelines/${run_id}/steps/${step_index}/checkin`,
+        { method: "POST", body: JSON.stringify(body) }
+      );
+      return jsonText({ ok: true, message: `Step ${step_index} \u2192 ${args.status}` });
+    }
+  );
   const grantedScopes = config.scopes;
   if (grantedScopes !== void 0) {
     const toolRegistry = server._registeredTools;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mushi-mushi/mcp",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "license": "MIT",
   "description": "MCP server exposing Mushi Mushi reports to coding agents",
   "type": "module",
@@ -25,7 +25,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@mushi-mushi/core": "^1.9.0",
+    "@mushi-mushi/core": "^1.11.0",
     "zod": "^4.4.2"
   },
   "devDependencies": {