@mushi-mushi/mcp 0.22.1 → 0.23.0

package/README.md

@@ -132,7 +132,7 @@ The Mushi backend now exposes the same tool catalog over the **Streamable HTTP**
 
 ### Feature groups (`?features=` / `MUSHI_FEATURES`)
 
-Full catalog is **76 tools** (stdio / `MUSHI_FEATURES=all`). The hosted HTTP
+Full catalog is **80 tools** (stdio / `MUSHI_FEATURES=all`). The hosted HTTP
 endpoint exposes a leaner subset filtered by feature groups (see
 `mcp-hosted-tool-manifest.json`). New installs now default to the lean
 `triage,fixes,inventory,setup,docs` set automatically (stdio: when
@@ -399,7 +399,7 @@ Spawns `dist/index.js` with a dummy unreachable endpoint and confirms it adverti
 pnpm --filter @mushi-mushi/mcp build
 pnpm --filter @mushi-mushi/mcp test:smoke
 # OK; prints live tool/resource/prompt counts from the catalog
-# (see packages/mcp/src/catalog.ts — currently 76 tools / 8 resources / 4 prompts)
+# (see packages/mcp/src/catalog.ts — currently 80 tools / 8 resources / 4 prompts)
 ```
 
 ### Layer 3; Full localhost E2E (real binary + real backend behaviour)
@@ -493,4 +493,4 @@ MIT
 <!-- mushi-readme-stats-footer -->
 ---
 
-<sub>Monorepo scale (July 2026): 59 edge functions · 376 SQL migrations · 13 outbound plugins · 11 inbound adapters · 19 pipeline agents. Canonical counts: <a href="https://github.com/kensaurus/mushi-mushi/blob/master/docs/stats.md">docs/stats.md</a> · <code>pnpm docs-stats</code></sub>
+<sub>Monorepo scale (July 2026): 60 edge functions · 383 SQL migrations · 13 outbound plugins · 11 inbound adapters · 19 pipeline agents. Canonical counts: <a href="https://github.com/kensaurus/mushi-mushi/blob/master/docs/stats.md">docs/stats.md</a> · <code>pnpm docs-stats</code></sub>

package/dist/catalog.js

@@ -8,7 +8,7 @@ import {
   TOOL_CATALOG,
   USE_MUSHI_INTENTS,
   routeUseMushiIntent
-} from "./chunk-RPSPV4FC.js";
+} from "./chunk-EFENR3EA.js";
 export {
   ALL_SCOPES,
   CODEBASE_TOOL_CATALOG,

package/dist/{chunk-LFSAKI6Z.js → chunk-CXSLU5V5.js}

@@ -40,6 +40,7 @@ var TOOL_FEATURE_MAP = {
   run_nl_query: "triage",
   get_report_evidence: "triage",
   triage_issue: "triage",
+  import_sentry_issues: "triage",
   query_lessons: "triage",
   list_lessons: "triage",
   suggest_fix: "triage",
@@ -64,6 +65,9 @@ var TOOL_FEATURE_MAP = {
   refresh_ci: "fixes",
   reopen_report: "fixes",
   reply_to_reporter: "fixes",
+  request_reporter_info: "fixes",
+  list_reporter_outbox: "fixes",
+  release_reporter_update: "fixes",
   // rewards
   list_top_contributors: "rewards",
   award_bonus_points: "rewards",

package/dist/{chunk-RPSPV4FC.js → chunk-EFENR3EA.js}

@@ -213,7 +213,7 @@ var TOOL_CATALOG = [
   {
     name: "transition_status",
     title: "Move report between states",
-    description: "Move a report to a new workflow state, enforcing the same transition rules as the admin UI. Valid targets: classified, grouped, fixing, fixed, verified, reopened, dismissed. Returns { report } with the updated status. Write; idempotent (setting the current status is a no-op); rejects illegal transitions. Use to dismiss a duplicate or mark fixed; use merge_fix to mark fixed via a merged PR, or reopen_report for the reopened path.",
+    description: "Move a report to a new workflow state, enforcing the same transition rules as the admin UI. Valid targets: classified, grouped, fixing, fixed, verified, reopened, dismissed. When dismissing, closedReason (duplicate, not_reproducible, wont_fix, working_as_intended, spam) sets what the reporter is told \u2014 spam closes silently, and duplicate needs the report grouped under another one first; reporterMessage posts your note to the reporter verbatim. Returns { ok }. Write; idempotent (setting the current status is a no-op); rejects illegal transitions. Use to dismiss a duplicate or mark fixed; use merge_fix to mark fixed via a merged PR, or reopen_report for the reopened path.",
     scope: "mcp:write",
     hints: { readOnly: false, destructive: true, idempotent: true, openWorld: true },
     useCase: "Dismiss this duplicate / mark it fixed."
@@ -319,6 +319,14 @@ var TOOL_CATALOG = [
     returnsUntrusted: true,
     useCase: "Analyze this bug report end-to-end and tell me what to do."
   },
+  {
+    name: "import_sentry_issues",
+    title: "Import Sentry issues",
+    description: "Pull existing Sentry issues into Mushi's report queue: by issueIds (numeric ids or short ids like WEB-12, at most 10) or by a Sentry search query (default is:unresolved) within the project's configured Sentry project, limit 1-10. Each issue goes through the same path as a Sentry webhook delivery: deduped per issue, linked, classified. An issue already linked to a report answers linked and is never reopened. Returns { items: [{ input, issueId, shortId, outcome, reportId, error? }], created, linked, failed, indexing }. Write; idempotent; spends classification budget per new report. Needs the Sentry org slug, project slug and an auth token (event:read, project:read) in Integrations \u2192 Sentry. Use for issues that existed before the webhook was wired; then call triage_issue on a created report.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: true, openWorld: true },
+    useCase: "Pull my open Sentry issues into Mushi so I can triage and fix them."
+  },
   {
     name: "triage_next_steps",
     title: "What should I work on now?",
@@ -563,6 +571,31 @@ var TDD_TOOL_CATALOG = [
     hints: { readOnly: false, destructive: false, idempotent: false, openWorld: false },
     useCase: "Reply to a reporter asking for more info or confirming a fix."
   },
+  {
+    name: "request_reporter_info",
+    title: "Ask the reporter a question",
+    description: 'Ask the end-user who filed a report a question: it appears in their in-app "Your reports" thread, marks the report "Waiting on you", and the waiting state clears when they answer (their reply reaches Slack and the console). Returns { comment_id, awaiting_reporter }. Write; messages a real end user and is NOT idempotent \u2014 each call posts another question, so confirm the wording with the user first. Fails with NO_REPORTER for reports that came from an integration. Use when you need reproduction details; use reply_to_reporter for a plain reply.',
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: false, openWorld: false },
+    useCase: "Ask the reporter which page or device this happened on."
+  },
+  {
+    name: "list_reporter_outbox",
+    title: "List held reporter updates",
+    description: 'List pipeline messages waiting for review before they reach reporters (projects in review mode hold "fix in progress", "fixed", "shipped in vX" and "closed" messages). Each row has { id, report_id, report_title, notification_type, text, body_override, created_at }; text is exactly what the reporter will see. Read-only. Use before release_reporter_update; an empty list means nothing is waiting (or the project sends updates automatically).',
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: false },
+    returnsUntrusted: true,
+    useCase: "What reporter updates are waiting for my review?"
+  },
+  {
+    name: "release_reporter_update",
+    title: "Release or discard a held reporter update",
+    description: "Send (action=release, the default) or drop (action=discard) one held reporter message from list_reporter_outbox; bodyOverride replaces its text before sending. Returns { delivered, skipped, failed }. Write; messages a real end user \u2014 confirm with the user first. Idempotent in effect: a message that is no longer held returns CONFLICT instead of sending twice.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: true, openWorld: false },
+    useCase: 'Send the "fixed in v1.4" update to the reporter.'
+  },
   {
     name: "get_two_way_comms_health",
     title: "Two-way communication health",

package/dist/clients.d.ts

@@ -46,7 +46,7 @@ import { FeatureGroup } from './feature-groups.js';
  * editor launch. Synced to package.json by `scripts/sync-mcp-pin.mjs` — never
  * hand-edit the version.
  */
-declare const MCP_PIN_SPEC = "@mushi-mushi/mcp@0.22.1";
+declare const MCP_PIN_SPEC = "@mushi-mushi/mcp@0.23.0";
 interface StdioConfig {
     command: string;
     args: string[];

package/dist/clients.js

@@ -5,10 +5,10 @@ import {
   DEFAULT_FEATURE_GROUPS,
   appendFeaturesToUrl,
   featuresQueryString
-} from "./chunk-LFSAKI6Z.js";
+} from "./chunk-CXSLU5V5.js";
 
 // src/clients.ts
-var MCP_PIN_SPEC = "@mushi-mushi/mcp@0.22.1";
+var MCP_PIN_SPEC = "@mushi-mushi/mcp@0.23.0";
 function projectServerName(projectId, projectName) {
   const nameSlug = projectName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 22);
   const idSuffix = projectId.replace(/-/g, "").slice(0, 6);

package/dist/feature-groups.js

@@ -9,7 +9,7 @@ import {
   parseFeaturesCsv,
   parseFeaturesParam,
   toolMatchesFeatures
-} from "./chunk-LFSAKI6Z.js";
+} from "./chunk-CXSLU5V5.js";
 export {
   ALL_FEATURE_GROUPS,
   DEFAULT_FEATURE_GROUPS,

package/dist/index.js

@@ -289,7 +289,7 @@ var TOOL_CATALOG = [
   {
     name: "transition_status",
     title: "Move report between states",
-    description: "Move a report to a new workflow state, enforcing the same transition rules as the admin UI. Valid targets: classified, grouped, fixing, fixed, verified, reopened, dismissed. Returns { report } with the updated status. Write; idempotent (setting the current status is a no-op); rejects illegal transitions. Use to dismiss a duplicate or mark fixed; use merge_fix to mark fixed via a merged PR, or reopen_report for the reopened path.",
+    description: "Move a report to a new workflow state, enforcing the same transition rules as the admin UI. Valid targets: classified, grouped, fixing, fixed, verified, reopened, dismissed. When dismissing, closedReason (duplicate, not_reproducible, wont_fix, working_as_intended, spam) sets what the reporter is told \u2014 spam closes silently, and duplicate needs the report grouped under another one first; reporterMessage posts your note to the reporter verbatim. Returns { ok }. Write; idempotent (setting the current status is a no-op); rejects illegal transitions. Use to dismiss a duplicate or mark fixed; use merge_fix to mark fixed via a merged PR, or reopen_report for the reopened path.",
     scope: "mcp:write",
     hints: { readOnly: false, destructive: true, idempotent: true, openWorld: true },
     useCase: "Dismiss this duplicate / mark it fixed."
@@ -395,6 +395,14 @@ var TOOL_CATALOG = [
     returnsUntrusted: true,
     useCase: "Analyze this bug report end-to-end and tell me what to do."
   },
+  {
+    name: "import_sentry_issues",
+    title: "Import Sentry issues",
+    description: "Pull existing Sentry issues into Mushi's report queue: by issueIds (numeric ids or short ids like WEB-12, at most 10) or by a Sentry search query (default is:unresolved) within the project's configured Sentry project, limit 1-10. Each issue goes through the same path as a Sentry webhook delivery: deduped per issue, linked, classified. An issue already linked to a report answers linked and is never reopened. Returns { items: [{ input, issueId, shortId, outcome, reportId, error? }], created, linked, failed, indexing }. Write; idempotent; spends classification budget per new report. Needs the Sentry org slug, project slug and an auth token (event:read, project:read) in Integrations \u2192 Sentry. Use for issues that existed before the webhook was wired; then call triage_issue on a created report.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: true, openWorld: true },
+    useCase: "Pull my open Sentry issues into Mushi so I can triage and fix them."
+  },
   {
     name: "triage_next_steps",
     title: "What should I work on now?",
@@ -555,6 +563,31 @@ var TDD_TOOL_CATALOG = [
     hints: { readOnly: false, destructive: false, idempotent: false, openWorld: false },
     useCase: "Reply to a reporter asking for more info or confirming a fix."
   },
+  {
+    name: "request_reporter_info",
+    title: "Ask the reporter a question",
+    description: 'Ask the end-user who filed a report a question: it appears in their in-app "Your reports" thread, marks the report "Waiting on you", and the waiting state clears when they answer (their reply reaches Slack and the console). Returns { comment_id, awaiting_reporter }. Write; messages a real end user and is NOT idempotent \u2014 each call posts another question, so confirm the wording with the user first. Fails with NO_REPORTER for reports that came from an integration. Use when you need reproduction details; use reply_to_reporter for a plain reply.',
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: false, openWorld: false },
+    useCase: "Ask the reporter which page or device this happened on."
+  },
+  {
+    name: "list_reporter_outbox",
+    title: "List held reporter updates",
+    description: 'List pipeline messages waiting for review before they reach reporters (projects in review mode hold "fix in progress", "fixed", "shipped in vX" and "closed" messages). Each row has { id, report_id, report_title, notification_type, text, body_override, created_at }; text is exactly what the reporter will see. Read-only. Use before release_reporter_update; an empty list means nothing is waiting (or the project sends updates automatically).',
+    scope: "mcp:read",
+    hints: { readOnly: true, idempotent: true, openWorld: false },
+    returnsUntrusted: true,
+    useCase: "What reporter updates are waiting for my review?"
+  },
+  {
+    name: "release_reporter_update",
+    title: "Release or discard a held reporter update",
+    description: "Send (action=release, the default) or drop (action=discard) one held reporter message from list_reporter_outbox; bodyOverride replaces its text before sending. Returns { delivered, skipped, failed }. Write; messages a real end user \u2014 confirm with the user first. Idempotent in effect: a message that is no longer held returns CONFLICT instead of sending twice.",
+    scope: "mcp:write",
+    hints: { readOnly: false, destructive: false, idempotent: true, openWorld: false },
+    useCase: 'Send the "fixed in v1.4" update to the reporter.'
+  },
   {
     name: "get_two_way_comms_health",
     title: "Two-way communication health",
@@ -865,6 +898,7 @@ var TOOL_FEATURE_MAP = {
   run_nl_query: "triage",
   get_report_evidence: "triage",
   triage_issue: "triage",
+  import_sentry_issues: "triage",
   query_lessons: "triage",
   list_lessons: "triage",
   suggest_fix: "triage",
@@ -889,6 +923,9 @@ var TOOL_FEATURE_MAP = {
   refresh_ci: "fixes",
   reopen_report: "fixes",
   reply_to_reporter: "fixes",
+  request_reporter_info: "fixes",
+  list_reporter_outbox: "fixes",
+  release_reporter_update: "fixes",
   // rewards
   list_top_contributors: "rewards",
   award_bonus_points: "rewards",
@@ -1016,7 +1053,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/",
     markdown: "index.md",
     keywords: ["know", "ai-built", "app", "broke", "fix", "ready"],
-    headings: ["See it in action", "What this is (and is not)", "Get started with the SDK", "Install in your framework", "One queue. Sentry flows in, fixes flow out."],
+    headings: ["This is what a diagnosis looks like", "See it in action", "What this is (and is not)", "Get started with the SDK", "Install in your framework", "One queue. Sentry flows in, fixes flow out."],
     excerpt: "Your AI shipped it. Mushi tells you why it broke: a plain-English diagnosis and a ready fix in your editor. Open source, Sentry optional."
   },
   {
@@ -2027,6 +2064,15 @@ var MUSHI_DOCS_INDEX = [
     headings: ["What changes (high level)", "API mapping (Mushi-specific)", "Migration checklist", "Common gotchas", "Mushi behaviour during the migration", "References"],
     excerpt: "Upgrade a Vue 2 app to Vue 3 and move from the vanilla Mushi web SDK to the @mushi-mushi/vue plugin, with an interactive migration checklist."
   },
+  {
+    title: "Open metrics",
+    url: docUrl("/open"),
+    route: "/open",
+    markdown: "open.md",
+    keywords: ["open", "metrics"],
+    headings: ["What is not on this page, and why", "Where the numbers come from"],
+    excerpt: "Mushi Mushi's public numbers (releases, commits, contributors, npm downloads), fetched from public APIs at build time, with what each one does not mean."
+  },
   {
     title: "Operating (maintainers)",
     url: docUrl("/operating"),
@@ -2591,7 +2637,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/react-native",
     markdown: "sdks/react-native.md",
     keywords: ["sdks", "react-native", "react", "native", "@mushi-mushi/react-native"],
-    headings: ["Install", "Mount the provider", "Submit a report from a screen", "Offline queue", "What gets captured (v0.19+)", "Screenshots (react-native-view-shot)", "Manual breadcrumbs", "Reporter identity contract"],
+    headings: ["Install", "Mount the provider", "Submit a report from a screen", "Offline queue", "What gets captured (v0.19+)", "Screenshots (react-native-view-shot)", "Theming the report sheet", "Manual breadcrumbs"],
     excerpt: "Reference for @mushi-mushi/react-native \u2014 MushiProvider, hooks, shake-to-report, screenshots, identity and the offline queue for React Native and Expo."
   },
   {
@@ -4839,6 +4885,44 @@ function createMushiServer(config) {
       return jsonResult({ report });
     }
   );
+  server.registerTool(
+    "import_sentry_issues",
+    {
+      title: titleOf("import_sentry_issues"),
+      description: descOf("import_sentry_issues"),
+      annotations: annotationsFor("import_sentry_issues"),
+      inputSchema: z.object({
+        issueIds: z.array(z.string().regex(/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/)).max(10).optional().describe('Sentry issue ids or short ids (e.g. "4501", "WEB-12"), at most 10'),
+        query: z.string().max(200).optional().describe("Sentry search query within the configured Sentry project (default is:unresolved). Not with issueIds."),
+        limit: z.number().int().min(1).max(10).optional().describe("How many issues a query imports (1-10, default 5)"),
+        projectId: z.string().optional().describe("Project UUID. Defaults to configured project.")
+      }),
+      outputSchema: z.object({
+        items: z.array(
+          z.looseObject({
+            input: z.string(),
+            issueId: z.string().nullable(),
+            shortId: z.string().nullable(),
+            outcome: z.string().describe("created | linked | deduped | ignored | error"),
+            reportId: z.string().nullable(),
+            error: z.string().optional()
+          })
+        ).describe("One entry per requested or matched issue"),
+        created: z.array(z.string().nullable()).describe("Report ids created by this import"),
+        linked: z.array(z.string().nullable()).describe("Report ids that already existed for these issues"),
+        failed: z.number().describe("Issues that could not be imported"),
+        indexing: z.looseObject({ queued: z.boolean(), paths: z.number() }).describe("Whether stack-frame files were queued for codebase indexing")
+      })
+    },
+    async (args) => {
+      const pid = await resolveProjectId(args.projectId);
+      const data = await apiCall(`/v1/admin/projects/${pid}/sentry/import`, {
+        method: "POST",
+        body: JSON.stringify({ issueIds: args.issueIds, query: args.query, limit: args.limit })
+      });
+      return jsonResult(data);
+    }
+  );
   server.registerTool(
     "transition_status",
     {
@@ -4863,13 +4947,20 @@ function createMushiServer(config) {
           "reopened",
           "dismissed"
         ]).describe("Target status (resolved is stored as fixed)"),
-        reason: z.string().optional().describe("Reason for the transition (audit trail)")
+        reason: z.string().optional().describe("Reason for the transition (audit trail)"),
+        closedReason: z.enum(["duplicate", "not_reproducible", "wont_fix", "working_as_intended", "spam"]).optional().describe("When dismissing: what the reporter is told (spam closes silently)"),
+        reporterMessage: z.string().max(1e4).optional().describe("Optional note posted to the reporter verbatim")
       })
     },
     async (args) => {
       const data = await apiCall(`/v1/admin/reports/${args.reportId}`, {
         method: "PATCH",
-        body: JSON.stringify({ status: args.status, reason: args.reason })
+        body: JSON.stringify({
+          status: args.status,
+          reason: args.reason,
+          closed_reason: args.closedReason,
+          reporter_message: args.reporterMessage
+        })
       });
       return jsonText(data);
     }
@@ -5613,6 +5704,65 @@ Be specific. No generic advice.`
       return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
     }
   );
+  server.registerTool(
+    "request_reporter_info",
+    {
+      title: titleOf("request_reporter_info", TDD_TOOL_CATALOG),
+      description: descOf("request_reporter_info", TDD_TOOL_CATALOG),
+      annotations: annotationsFor("request_reporter_info", TDD_TOOL_CATALOG),
+      inputSchema: z.object({
+        reportId: z.string().describe("Report id to ask about"),
+        question: z.string().min(1).max(2e3).describe("The question, shown to the reporter verbatim"),
+        authorName: z.string().optional().describe('Display name for the sender (default: "Developer")')
+      })
+    },
+    async ({ reportId, question, authorName }) => {
+      const data = await apiCall(`/v1/admin/reports/${reportId}/request-info`, {
+        method: "POST",
+        body: JSON.stringify({ question, author_name: authorName })
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "list_reporter_outbox",
+    {
+      title: titleOf("list_reporter_outbox", TDD_TOOL_CATALOG),
+      description: descOf("list_reporter_outbox", TDD_TOOL_CATALOG),
+      annotations: annotationsFor("list_reporter_outbox", TDD_TOOL_CATALOG),
+      inputSchema: z.object({
+        projectId: z.string().optional().describe("Project UUID. Defaults to configured project.")
+      })
+    },
+    async ({ projectId: pid }) => {
+      const scoped = pid ?? config.projectId;
+      const data = await apiCall(
+        `/v1/admin/reporter-outbox${scoped ? `?project_id=${encodeURIComponent(scoped)}` : ""}`
+      );
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "release_reporter_update",
+    {
+      title: titleOf("release_reporter_update", TDD_TOOL_CATALOG),
+      description: descOf("release_reporter_update", TDD_TOOL_CATALOG),
+      annotations: annotationsFor("release_reporter_update", TDD_TOOL_CATALOG),
+      inputSchema: z.object({
+        messageId: z.string().describe("Held message id from list_reporter_outbox"),
+        action: z.enum(["release", "discard"]).optional().describe("release (default) sends it; discard drops it"),
+        bodyOverride: z.string().min(1).max(1e3).optional().describe("Replacement text to send instead")
+      })
+    },
+    async ({ messageId, action, bodyOverride }) => {
+      const verb = action === "discard" ? "discard" : "release";
+      const data = await apiCall(`/v1/admin/reporter-outbox/${messageId}/${verb}`, {
+        method: "POST",
+        body: JSON.stringify(verb === "release" && bodyOverride ? { body_override: bodyOverride } : {})
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+  );
   server.registerTool(
     "list_qa_story_runs",
     {

package/dist/server.js

@@ -4,7 +4,7 @@ import {
   TDD_TOOL_CATALOG,
   TOOL_CATALOG,
   routeUseMushiIntent
-} from "./chunk-RPSPV4FC.js";
+} from "./chunk-EFENR3EA.js";
 import {
   MUSHI_SERVER_METADATA
 } from "./chunk-FJRPC4VR.js";
@@ -12,7 +12,7 @@ import {
   DEPRECATED_TOOL_ALIASES,
   TOOL_FEATURE_MAP,
   toolMatchesFeatures
-} from "./chunk-LFSAKI6Z.js";
+} from "./chunk-CXSLU5V5.js";
 
 // src/server.ts
 import { AsyncLocalStorage } from "async_hooks";
@@ -32,7 +32,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/",
     markdown: "index.md",
     keywords: ["know", "ai-built", "app", "broke", "fix", "ready"],
-    headings: ["See it in action", "What this is (and is not)", "Get started with the SDK", "Install in your framework", "One queue. Sentry flows in, fixes flow out."],
+    headings: ["This is what a diagnosis looks like", "See it in action", "What this is (and is not)", "Get started with the SDK", "Install in your framework", "One queue. Sentry flows in, fixes flow out."],
     excerpt: "Your AI shipped it. Mushi tells you why it broke: a plain-English diagnosis and a ready fix in your editor. Open source, Sentry optional."
   },
   {
@@ -1043,6 +1043,15 @@ var MUSHI_DOCS_INDEX = [
     headings: ["What changes (high level)", "API mapping (Mushi-specific)", "Migration checklist", "Common gotchas", "Mushi behaviour during the migration", "References"],
     excerpt: "Upgrade a Vue 2 app to Vue 3 and move from the vanilla Mushi web SDK to the @mushi-mushi/vue plugin, with an interactive migration checklist."
   },
+  {
+    title: "Open metrics",
+    url: docUrl("/open"),
+    route: "/open",
+    markdown: "open.md",
+    keywords: ["open", "metrics"],
+    headings: ["What is not on this page, and why", "Where the numbers come from"],
+    excerpt: "Mushi Mushi's public numbers (releases, commits, contributors, npm downloads), fetched from public APIs at build time, with what each one does not mean."
+  },
   {
     title: "Operating (maintainers)",
     url: docUrl("/operating"),
@@ -1607,7 +1616,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/react-native",
     markdown: "sdks/react-native.md",
     keywords: ["sdks", "react-native", "react", "native", "@mushi-mushi/react-native"],
-    headings: ["Install", "Mount the provider", "Submit a report from a screen", "Offline queue", "What gets captured (v0.19+)", "Screenshots (react-native-view-shot)", "Manual breadcrumbs", "Reporter identity contract"],
+    headings: ["Install", "Mount the provider", "Submit a report from a screen", "Offline queue", "What gets captured (v0.19+)", "Screenshots (react-native-view-shot)", "Theming the report sheet", "Manual breadcrumbs"],
     excerpt: "Reference for @mushi-mushi/react-native \u2014 MushiProvider, hooks, shake-to-report, screenshots, identity and the offline queue for React Native and Expo."
   },
   {
@@ -3921,6 +3930,44 @@ function createMushiServer(config) {
       return jsonResult({ report });
     }
   );
+  server.registerTool(
+    "import_sentry_issues",
+    {
+      title: titleOf("import_sentry_issues"),
+      description: descOf("import_sentry_issues"),
+      annotations: annotationsFor("import_sentry_issues"),
+      inputSchema: z.object({
+        issueIds: z.array(z.string().regex(/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/)).max(10).optional().describe('Sentry issue ids or short ids (e.g. "4501", "WEB-12"), at most 10'),
+        query: z.string().max(200).optional().describe("Sentry search query within the configured Sentry project (default is:unresolved). Not with issueIds."),
+        limit: z.number().int().min(1).max(10).optional().describe("How many issues a query imports (1-10, default 5)"),
+        projectId: z.string().optional().describe("Project UUID. Defaults to configured project.")
+      }),
+      outputSchema: z.object({
+        items: z.array(
+          z.looseObject({
+            input: z.string(),
+            issueId: z.string().nullable(),
+            shortId: z.string().nullable(),
+            outcome: z.string().describe("created | linked | deduped | ignored | error"),
+            reportId: z.string().nullable(),
+            error: z.string().optional()
+          })
+        ).describe("One entry per requested or matched issue"),
+        created: z.array(z.string().nullable()).describe("Report ids created by this import"),
+        linked: z.array(z.string().nullable()).describe("Report ids that already existed for these issues"),
+        failed: z.number().describe("Issues that could not be imported"),
+        indexing: z.looseObject({ queued: z.boolean(), paths: z.number() }).describe("Whether stack-frame files were queued for codebase indexing")
+      })
+    },
+    async (args) => {
+      const pid = await resolveProjectId(args.projectId);
+      const data = await apiCall(`/v1/admin/projects/${pid}/sentry/import`, {
+        method: "POST",
+        body: JSON.stringify({ issueIds: args.issueIds, query: args.query, limit: args.limit })
+      });
+      return jsonResult(data);
+    }
+  );
   server.registerTool(
     "transition_status",
     {
@@ -3945,13 +3992,20 @@ function createMushiServer(config) {
           "reopened",
           "dismissed"
         ]).describe("Target status (resolved is stored as fixed)"),
-        reason: z.string().optional().describe("Reason for the transition (audit trail)")
+        reason: z.string().optional().describe("Reason for the transition (audit trail)"),
+        closedReason: z.enum(["duplicate", "not_reproducible", "wont_fix", "working_as_intended", "spam"]).optional().describe("When dismissing: what the reporter is told (spam closes silently)"),
+        reporterMessage: z.string().max(1e4).optional().describe("Optional note posted to the reporter verbatim")
       })
     },
     async (args) => {
       const data = await apiCall(`/v1/admin/reports/${args.reportId}`, {
         method: "PATCH",
-        body: JSON.stringify({ status: args.status, reason: args.reason })
+        body: JSON.stringify({
+          status: args.status,
+          reason: args.reason,
+          closed_reason: args.closedReason,
+          reporter_message: args.reporterMessage
+        })
       });
       return jsonText(data);
     }
@@ -4695,6 +4749,65 @@ Be specific. No generic advice.`
       return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
     }
   );
+  server.registerTool(
+    "request_reporter_info",
+    {
+      title: titleOf("request_reporter_info", TDD_TOOL_CATALOG),
+      description: descOf("request_reporter_info", TDD_TOOL_CATALOG),
+      annotations: annotationsFor("request_reporter_info", TDD_TOOL_CATALOG),
+      inputSchema: z.object({
+        reportId: z.string().describe("Report id to ask about"),
+        question: z.string().min(1).max(2e3).describe("The question, shown to the reporter verbatim"),
+        authorName: z.string().optional().describe('Display name for the sender (default: "Developer")')
+      })
+    },
+    async ({ reportId, question, authorName }) => {
+      const data = await apiCall(`/v1/admin/reports/${reportId}/request-info`, {
+        method: "POST",
+        body: JSON.stringify({ question, author_name: authorName })
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "list_reporter_outbox",
+    {
+      title: titleOf("list_reporter_outbox", TDD_TOOL_CATALOG),
+      description: descOf("list_reporter_outbox", TDD_TOOL_CATALOG),
+      annotations: annotationsFor("list_reporter_outbox", TDD_TOOL_CATALOG),
+      inputSchema: z.object({
+        projectId: z.string().optional().describe("Project UUID. Defaults to configured project.")
+      })
+    },
+    async ({ projectId: pid }) => {
+      const scoped = pid ?? config.projectId;
+      const data = await apiCall(
+        `/v1/admin/reporter-outbox${scoped ? `?project_id=${encodeURIComponent(scoped)}` : ""}`
+      );
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "release_reporter_update",
+    {
+      title: titleOf("release_reporter_update", TDD_TOOL_CATALOG),
+      description: descOf("release_reporter_update", TDD_TOOL_CATALOG),
+      annotations: annotationsFor("release_reporter_update", TDD_TOOL_CATALOG),
+      inputSchema: z.object({
+        messageId: z.string().describe("Held message id from list_reporter_outbox"),
+        action: z.enum(["release", "discard"]).optional().describe("release (default) sends it; discard drops it"),
+        bodyOverride: z.string().min(1).max(1e3).optional().describe("Replacement text to send instead")
+      })
+    },
+    async ({ messageId, action, bodyOverride }) => {
+      const verb = action === "discard" ? "discard" : "release";
+      const data = await apiCall(`/v1/admin/reporter-outbox/${messageId}/${verb}`, {
+        method: "POST",
+        body: JSON.stringify(verb === "release" && bodyOverride ? { body_override: bodyOverride } : {})
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+  );
   server.registerTool(
     "list_qa_story_runs",
     {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mushi-mushi/mcp",
   "mcpName": "io.github.kensaurus/mushi-mushi",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "license": "MIT",
   "description": "MCP server for Cursor, Claude Code and Copilot. The bug mediator for AI-built apps: plain-English diagnosis + a ready fix, in your editor.",
   "type": "module",
@@ -45,7 +45,7 @@
     "@modelcontextprotocol/core": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "zod": "^4.4.3",
-    "@mushi-mushi/core": "^1.29.0"
+    "@mushi-mushi/core": "^1.30.0"
   },
   "peerDependencies": {
     "@sentry/node": "^10.57.0"