@mushi-mushi/mcp 0.29.1 → 0.29.2

package/README.md

@@ -9,6 +9,8 @@
 
 The [Model Context Protocol](https://modelcontextprotocol.io/) server for [Mushi Mushi](https://github.com/kensaurus/mushi-mushi). It lets Cursor, Claude Code, VS Code or any MCP client read your app's bug reports, get a plain-English diagnosis with a fix to start from, and dispatch or merge fixes. Your editor's own model does the work, so you need no second LLM key.
 
+Docs: [MCP guide](https://kensaur.us/mushi-mushi/docs/sdks/mcp) · [tool reference](https://kensaur.us/mushi-mushi/docs/sdks/mcp-tools)
+
 ```mermaid
 flowchart LR
     A["Bug reports<br/>in Mushi"] --> B["This MCP server"] --> C["Your editor<br/>'what's broken in prod?'"] --> D["Fix: you, or a<br/>draft PR from an agent"]
@@ -29,7 +31,7 @@ Restart the editor and ask *"what's broken in prod?"*. For Cursor and Claude, `s
   "mcpServers": {
     "mushi-mushi": {
       "command": "npx",
-      "args": ["-y", "@mushi-mushi/mcp@0.29.1"],
+      "args": ["-y", "@mushi-mushi/mcp@0.29.2"],
       "env": {
         "MUSHI_API_KEY": "mushi_xxxxxxxxxxxxxxxxxxxx",
         "MUSHI_PROJECT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

package/dist/clients.d.ts

@@ -49,7 +49,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.29.1";
+declare const MCP_PIN_SPEC = "@mushi-mushi/mcp@0.29.2";
 interface StdioConfig {
     command: string;
     args: string[];

package/dist/clients.js

@@ -8,7 +8,7 @@ import {
 } from "./chunk-7RWHDJPZ.js";
 
 // src/clients.ts
-var MCP_PIN_SPEC = "@mushi-mushi/mcp@0.29.1";
+var MCP_PIN_SPEC = "@mushi-mushi/mcp@0.29.2";
 var PIN_SPEC_RE = /^@mushi-mushi\/mcp@\d+\.\d+\.\d+$/;
 function pinOf(pinSpec) {
   return pinSpec && PIN_SPEC_RE.test(pinSpec) ? pinSpec : MCP_PIN_SPEC;

package/dist/index.js

@@ -1861,6 +1861,15 @@ var MUSHI_DOCS_INDEX = [
     headings: ["What you see", "Data source", "Related"],
     excerpt: "The Overview page is the organization-wide portfolio view \u2014 seven-day activity and open tickets for every connected project at a glance."
   },
+  {
+    title: "Pipeline",
+    url: docUrl("/admin/pipeline"),
+    route: "/admin/pipeline",
+    markdown: "admin/pipeline.md",
+    keywords: ["admin", "pipeline"],
+    headings: ["Stages", "Who opens fixes", "Stuck groups", "Release trains", "Intake and deploys"],
+    excerpt: "The console Pipeline page shows every bug from report to deploy, where it is stuck and why, with one-click fixes."
+  },
   {
     title: "Portfolio",
     url: docUrl("/admin/portfolio"),
@@ -2686,8 +2695,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/bugsnag",
     markdown: "plugins/bugsnag.md",
     keywords: ["plugins", "bugsnag"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Mirror Mushi bug reports into Bugsnag and close the Bugsnag error when the fix PR merges \u2014 install from the marketplace and map release stages."
+    headings: ["Setup (self-hosted Mushi)", "Package", "Events"],
+    excerpt: "Copy triaged Mushi bug reports into Bugsnag and mark the error fixed when Mushi applies a fix \u2014 a self-hosted plugin with a Data API token."
   },
   {
     title: "Building a plugin",
@@ -2704,8 +2713,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/crashlytics",
     markdown: "plugins/crashlytics.md",
     keywords: ["plugins", "crashlytics"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Push Mushi mobile bug reports into Firebase Crashlytics issues and close them when fixes merge \u2014 service account setup and app ID mapping."
+    headings: ["Setup (self-hosted Mushi)", "Package", "Events"],
+    excerpt: "Flag fixed Mushi reports in Firebase Remote Config so your mobile app can hide stale crash notices \u2014 a self-hosted plugin with a Google access token."
   },
   {
     title: "Cursor Cloud Agent",
@@ -2713,7 +2722,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/cursor-cloud",
     markdown: "plugins/cursor-cloud.md",
     keywords: ["plugins", "cursor-cloud", "cursor", "cloud", "agent"],
-    headings: ["Prerequisites", "Setup", "Behaviour", "Fixes view integration", "Common tasks", "Limiting dispatch to critical reports only", "Triggering manually", "Reviewing what the agent did"],
+    headings: ["Prerequisites", "Setup", "Behaviour", "Fixes view integration", "Common tasks", "Which reports start an agent", "Triggering manually", "Reviewing what the agent did"],
     excerpt: "Dispatch a Cursor Cloud Agent automatically when a Mushi report qualifies \u2014 it investigates, drafts a fix and opens a PR that links back to Mushi."
   },
   {
@@ -2722,8 +2731,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/discord",
     markdown: "plugins/discord.md",
     keywords: ["plugins", "discord"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Post Mushi report and fix events to a Discord channel through a webhook \u2014 create the webhook, install the plugin, and choose which events to send."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Post Mushi report and fix events to a Discord channel \u2014 paste a channel webhook on the Integrations page, or run the self-hosted Discord plugin."
   },
   {
     title: "Webhook events",
@@ -2740,8 +2749,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/github-issues",
     markdown: "plugins/github-issues.md",
     keywords: ["plugins", "github-issues", "github", "issues"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Open a labelled GitHub issue for every classified Mushi report, with a link back to the report \u2014 target repo, default labels and assignee settings."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Open a GitHub issue for every triaged Mushi report and close it when the fix lands \u2014 set it up on the Integrations page, or self-host the plugin."
   },
   {
     title: "Jira Cloud",
@@ -2749,8 +2758,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/jira",
     markdown: "plugins/jira.md",
     keywords: ["plugins", "jira", "cloud"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Two-way sync between Mushi reports and Jira Cloud issues \u2014 create issues on classification, sync status, and comment fix summaries when fixes land."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Open Jira Cloud issues from Mushi bug reports and keep their status in step \u2014 set it up on the Integrations page, or self-host the Jira plugin."
   },
   {
     title: "Linear",
@@ -2758,8 +2767,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/linear",
     markdown: "plugins/linear.md",
     keywords: ["plugins", "linear"],
-    headings: ["Setup", "Behaviour", "Label mapping example", "Troubleshooting"],
-    excerpt: "File a Linear issue automatically when Mushi classifies a bug report \u2014 create a Linear API key, install the plugin, and choose the team and filters."
+    headings: ["Setup (self-run plugin)", "Behaviour", "Troubleshooting"],
+    excerpt: "File Linear issues from Mushi bug reports \u2014 connect Linear on the Integrations page, or run the self-hosted Linear plugin with an API key and team id."
   },
   {
     title: "Microsoft Teams",
@@ -2767,8 +2776,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/msteams",
     markdown: "plugins/msteams.md",
     keywords: ["plugins", "msteams", "microsoft", "teams"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Send Adaptive Cards to a Microsoft Teams channel when Mushi classifies a report or a fix lands \u2014 incoming webhook setup and severity filters."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Send cards to a Microsoft Teams channel when Mushi triages a report or a fix lands \u2014 paste a webhook on the Integrations page, or self-host the plugin."
   },
   {
     title: "PagerDuty",
@@ -2776,8 +2785,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/pagerduty",
     markdown: "plugins/pagerduty.md",
     keywords: ["plugins", "pagerduty"],
-    headings: ["Setup", "Behaviour", "Troubleshooting"],
-    excerpt: "Page your on-call rotation through PagerDuty when a P0 or P1 bug report lands in Mushi \u2014 Events API v2 integration key setup and filters."
+    headings: ["Setup (self-run plugin)", "Behaviour", "Troubleshooting"],
+    excerpt: "Page your on-call rotation through PagerDuty when Mushi triages a bug as critical, and resolve it when the fix lands \u2014 Events API v2 routing key setup."
   },
   {
     title: "Rollbar",
@@ -2785,8 +2794,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/rollbar",
     markdown: "plugins/rollbar.md",
     keywords: ["plugins", "rollbar"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Mirror Mushi bug reports into Rollbar items and resolve them when fixes ship \u2014 access token, environment name, and dedup key mapping."
+    headings: ["Setup (self-hosted Mushi)", "Package", "Events"],
+    excerpt: "Copy triaged Mushi bug reports into Rollbar items and resolve them when fixes ship \u2014 a self-hosted plugin with an access token and project id."
   },
   {
     title: "Sentry",
@@ -2794,7 +2803,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/sentry",
     markdown: "plugins/sentry.md",
     keywords: ["plugins", "sentry"],
-    headings: ["Route Sentry errors into Mushi (inbound)", "Setup (outbound plugin)", "Package", "Events"],
+    headings: ["Route Sentry errors into Mushi (inbound)", "Copy Mushi reports into Sentry (outbound plugin)", "Package", "Events"],
     excerpt: "Two-way Sentry integration \u2014 Sentry errors flow into Mushi's queue, merging a Mushi fix resolves the Sentry issue, and critical reports mirror back."
   },
   {
@@ -2803,8 +2812,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/slack",
     markdown: "plugins/slack.md",
     keywords: ["plugins", "slack", "app"],
-    headings: ["Setup", "What's on the card", "Acting from the channel", "Slash commands", "Package", "Events", "Troubleshooting"],
-    excerpt: "Triage Mushi bug reports from Slack \u2014 each classified report posts as a card with its root cause and buttons to dispatch a fix, resolve or dismiss."
+    headings: ["Setup", "What's on the card", "Acting from the channel", "Slash commands", "Package", "What gets posted", "Troubleshooting"],
+    excerpt: "Triage Mushi bug reports from Slack \u2014 add the app from the Integrations page, and each report posts as a card with buttons to fix, resolve or dismiss."
   },
   {
     title: "Zapier",
@@ -2812,7 +2821,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/zapier",
     markdown: "plugins/zapier.md",
     keywords: ["plugins", "zapier"],
-    headings: ["Setup", "Signature verification in Zapier", "Common Zaps", "Troubleshooting"],
+    headings: ["Setup (no server)", "Setup (with the relay package)", "Common Zaps", "Troubleshooting"],
     excerpt: "Send every Mushi event to Zapier and on to thousands of apps such as Notion, Google Sheets and HubSpot \u2014 Catch Hook setup and event filters."
   },
   {
@@ -2849,7 +2858,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "quickstart/angular.md",
     keywords: ["quickstart", "angular"],
     headings: [],
-    excerpt: "Add Mushi to an Angular 17+ app \u2014 register the Mushi service and error handler as factory providers so uncaught errors and user bug reports reach your queue."
+    excerpt: "Add Mushi to an Angular 17+ app: one provideMushi() call registers the Mushi service and error handler, so uncaught errors and bug reports reach your queue."
   },
   {
     title: "Capacitor quickstart",
@@ -3011,7 +3020,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "sdks/angular.md",
     keywords: ["sdks", "angular", "@mushi-mushi/angular"],
     headings: ["API surface", "Setup (standalone bootstrap)", "Submitting a report", "Identifying users"],
-    excerpt: "API reference for @mushi-mushi/angular \u2014 MushiService, MushiErrorHandler and the MUSHI_CONFIG token, wired with factory providers in an Angular 17+ app."
+    excerpt: "API reference for @mushi-mushi/angular \u2014 provideMushi(), MushiService, MushiErrorHandler and the MUSHI_CONFIG token in an Angular 17+ app."
   },
   {
     title: "In-SDK Ask assistant",
@@ -3055,7 +3064,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/core",
     markdown: "sdks/core.md",
     keywords: ["sdks", "core", "@mushi-mushi/core"],
-    headings: ["Install", "API", "Mushi.init(config) (web) / MushiProvider (React Native)", "MushiWidgetConfig (selected keys)", "submitReport(input)", "flushOfflineQueueNow()", "PII scrubbing utilities (1.27+)", "Region resolution"],
+    headings: ["Install", "API", "Mushi.init(config) (web) / MushiProvider (React Native)", "MushiWidgetConfig (selected keys)", "captureEvent(input)", "Offline queue", "PII scrubbing utilities (1.27+)", "Region resolution"],
     excerpt: "Reference for @mushi-mushi/core \u2014 the MushiConfig shape, widget options, PII scrubbing helpers and region resolution shared by every Mushi JavaScript SDK."
   },
   {
@@ -3064,7 +3073,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/eslint-plugin",
     markdown: "sdks/eslint-plugin.md",
     keywords: ["sdks", "eslint-plugin", "eslint", "plugin", "eslint-plugin-mushi-mushi"],
-    headings: ["Install", "Recommended preset", "Rules", "mushi-mushi/no-dead-handler", "mushi-mushi/no-mock-leak", "Combining with the gates action"],
+    headings: ["Install", "Turn on the two rules", "The recommended preset", "Rules", "mushi-mushi/no-dead-handler", "mushi-mushi/no-mock-leak", "In CI"],
     excerpt: "eslint-plugin-mushi-mushi flags empty event handlers and leftover mock data in production code \u2014 the no-dead-handler and no-mock-leak rules and preset."
   },
   {
@@ -3101,7 +3110,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "sdks/inventory-schema.md",
     keywords: ["sdks", "inventory-schema", "inventory", "schema", "@mushi-mushi/inventory-schema"],
     headings: ["Install", "What inventory.yaml looks like", "Programmatic use", "JSON Schema"],
-    excerpt: "The Zod schema, JSON Schema and TypeScript types for inventory.yaml \u2014 the contract that Mushi's gates, crawler, ESLint plugin and CLI all read."
+    excerpt: "The Zod schema, JSON Schema and TypeScript types for inventory.yaml: your app's pages, the buttons and forms on each, what they do, and the tests that prove it."
   },
   {
     title: "MushiMushi (iOS)",
@@ -3127,7 +3136,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/mcp",
     markdown: "sdks/mcp.md",
     keywords: ["sdks", "mcp", "bug", "report", "server", "cursor", "claude", "code", "@mushi-mushi/mcp"],
-    headings: ["Two transports", "Spec traceability for dispatchfix"],
+    headings: ["Quick start", "Two transports", "Spec traceability for dispatchfix"],
     excerpt: "Reference for @mushi-mushi/mcp, the Mushi MCP server for Cursor, Claude Code, VS Code and Windsurf \u2014 stdio and hosted HTTP transports, scopes and setup."
   },
   {
@@ -3136,8 +3145,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/mcp-ci",
     markdown: "sdks/mcp-ci.md",
     keywords: ["sdks", "mcp-ci", "mcp", "@mushi-mushi/mcp-ci"],
-    headings: ["Quick start", "Commands", "In your IDE", "Inputs"],
-    excerpt: "@mushi-mushi/mcp-ci is Mushi's GitHub Action \u2014 run the five-gate composite check on pull requests, draft inventory entries, and bootstrap crawler auth."
+    headings: ["Quick start", "Gates on every PR", "Commands", "In your IDE", "Inputs", "Outputs"],
+    excerpt: "@mushi-mushi/mcp-ci is Mushi's GitHub Action: fail a PR while reports wait for triage, dispatch a fix, run the pre-release gates and refresh crawler sign-in."
   },
   {
     title: "MCP tools reference",
@@ -3172,7 +3181,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/node",
     markdown: "sdks/node.md",
     keywords: ["sdks", "node", "node.js", "server", "error", "reporting", "sdk", "@mushi-mushi/node"],
-    headings: ["Install", "Express", "Fastify", "Hono", "Process-level fallbacks", "Programmatic submit", "PII and credential scrubbing"],
+    headings: ["Install", "Create a client", "Express", "Fastify", "Hono", "Process-level fallbacks", "Programmatic submit", "PII and credential scrubbing"],
     excerpt: "Report server errors from Node with @mushi-mushi/node \u2014 Express, Fastify and Hono error handlers that tag each report with route, request ID and user."
   },
   {
@@ -3182,7 +3191,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "sdks/plugin-sdk.md",
     keywords: ["sdks", "plugin-sdk", "plugin", "sdk", "@mushi-mushi/plugin-sdk"],
     headings: ["Install", "Express adapter", "Hono adapter", "Verify a signature manually", "Wire format", "See also"],
-    excerpt: "Build a Mushi plugin in TypeScript with @mushi-mushi/plugin-sdk \u2014 verify webhook signatures, dedupe deliveries and handle lifecycle events in Express."
+    excerpt: "Build a Mushi plugin in TypeScript with @mushi-mushi/plugin-sdk \u2014 verify webhook signatures, dedupe deliveries and handle lifecycle events in Express or Hono."
   },
   {
     title: "SDK presets",
@@ -3238,6 +3247,15 @@ var MUSHI_DOCS_INDEX = [
     headings: ["API surface", "Setup", "Submitting a report"],
     excerpt: "Reference for @mushi-mushi/svelte \u2014 initMushi, getMushi and the SvelteKit error hooks that forward client and server errors to your Mushi queue."
   },
+  {
+    title: "@mushi-mushi/ux",
+    url: docUrl("/sdks/ux"),
+    route: "/sdks/ux",
+    markdown: "sdks/ux.md",
+    keywords: ["sdks", "ux", "@mushi-mushi/ux"],
+    headings: ["Quick start", "From studio to merge", "What a run does", "Safety", "Agents", "Commands", "Audit and explore signed-in screens", "On GitHub Actions"],
+    excerpt: "@mushi-mushi/ux runs your coding agent over each screen of your app, measures every change and keeps only the ones that help, on a branch you review."
+  },
   {
     title: "@mushi-mushi/vue",
     url: docUrl("/sdks/vue"),
@@ -3253,8 +3271,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/wasm-classifier",
     markdown: "sdks/wasm-classifier.md",
     keywords: ["sdks", "wasm-classifier", "wasm", "classifier", "@mushi-mushi/wasm-classifier"],
-    headings: [],
-    excerpt: "@mushi-mushi/wasm-classifier runs a small on-device model in the browser to drop junk bug reports before they reach your LLM, cutting classification cost."
+    headings: ["Use it with the web SDK", "Call it directly", "ONNX backend (experimental)"],
+    excerpt: "@mushi-mushi/wasm-classifier filters junk bug reports in the browser, before they reach the server or your LLM."
   },
   {
     title: "JavaScript bug reporting SDK for the browser",

package/dist/server.js

@@ -404,6 +404,15 @@ var MUSHI_DOCS_INDEX = [
     headings: ["What you see", "Data source", "Related"],
     excerpt: "The Overview page is the organization-wide portfolio view \u2014 seven-day activity and open tickets for every connected project at a glance."
   },
+  {
+    title: "Pipeline",
+    url: docUrl("/admin/pipeline"),
+    route: "/admin/pipeline",
+    markdown: "admin/pipeline.md",
+    keywords: ["admin", "pipeline"],
+    headings: ["Stages", "Who opens fixes", "Stuck groups", "Release trains", "Intake and deploys"],
+    excerpt: "The console Pipeline page shows every bug from report to deploy, where it is stuck and why, with one-click fixes."
+  },
   {
     title: "Portfolio",
     url: docUrl("/admin/portfolio"),
@@ -1229,8 +1238,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/bugsnag",
     markdown: "plugins/bugsnag.md",
     keywords: ["plugins", "bugsnag"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Mirror Mushi bug reports into Bugsnag and close the Bugsnag error when the fix PR merges \u2014 install from the marketplace and map release stages."
+    headings: ["Setup (self-hosted Mushi)", "Package", "Events"],
+    excerpt: "Copy triaged Mushi bug reports into Bugsnag and mark the error fixed when Mushi applies a fix \u2014 a self-hosted plugin with a Data API token."
   },
   {
     title: "Building a plugin",
@@ -1247,8 +1256,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/crashlytics",
     markdown: "plugins/crashlytics.md",
     keywords: ["plugins", "crashlytics"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Push Mushi mobile bug reports into Firebase Crashlytics issues and close them when fixes merge \u2014 service account setup and app ID mapping."
+    headings: ["Setup (self-hosted Mushi)", "Package", "Events"],
+    excerpt: "Flag fixed Mushi reports in Firebase Remote Config so your mobile app can hide stale crash notices \u2014 a self-hosted plugin with a Google access token."
   },
   {
     title: "Cursor Cloud Agent",
@@ -1256,7 +1265,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/cursor-cloud",
     markdown: "plugins/cursor-cloud.md",
     keywords: ["plugins", "cursor-cloud", "cursor", "cloud", "agent"],
-    headings: ["Prerequisites", "Setup", "Behaviour", "Fixes view integration", "Common tasks", "Limiting dispatch to critical reports only", "Triggering manually", "Reviewing what the agent did"],
+    headings: ["Prerequisites", "Setup", "Behaviour", "Fixes view integration", "Common tasks", "Which reports start an agent", "Triggering manually", "Reviewing what the agent did"],
     excerpt: "Dispatch a Cursor Cloud Agent automatically when a Mushi report qualifies \u2014 it investigates, drafts a fix and opens a PR that links back to Mushi."
   },
   {
@@ -1265,8 +1274,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/discord",
     markdown: "plugins/discord.md",
     keywords: ["plugins", "discord"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Post Mushi report and fix events to a Discord channel through a webhook \u2014 create the webhook, install the plugin, and choose which events to send."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Post Mushi report and fix events to a Discord channel \u2014 paste a channel webhook on the Integrations page, or run the self-hosted Discord plugin."
   },
   {
     title: "Webhook events",
@@ -1283,8 +1292,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/github-issues",
     markdown: "plugins/github-issues.md",
     keywords: ["plugins", "github-issues", "github", "issues"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Open a labelled GitHub issue for every classified Mushi report, with a link back to the report \u2014 target repo, default labels and assignee settings."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Open a GitHub issue for every triaged Mushi report and close it when the fix lands \u2014 set it up on the Integrations page, or self-host the plugin."
   },
   {
     title: "Jira Cloud",
@@ -1292,8 +1301,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/jira",
     markdown: "plugins/jira.md",
     keywords: ["plugins", "jira", "cloud"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Two-way sync between Mushi reports and Jira Cloud issues \u2014 create issues on classification, sync status, and comment fix summaries when fixes land."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Open Jira Cloud issues from Mushi bug reports and keep their status in step \u2014 set it up on the Integrations page, or self-host the Jira plugin."
   },
   {
     title: "Linear",
@@ -1301,8 +1310,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/linear",
     markdown: "plugins/linear.md",
     keywords: ["plugins", "linear"],
-    headings: ["Setup", "Behaviour", "Label mapping example", "Troubleshooting"],
-    excerpt: "File a Linear issue automatically when Mushi classifies a bug report \u2014 create a Linear API key, install the plugin, and choose the team and filters."
+    headings: ["Setup (self-run plugin)", "Behaviour", "Troubleshooting"],
+    excerpt: "File Linear issues from Mushi bug reports \u2014 connect Linear on the Integrations page, or run the self-hosted Linear plugin with an API key and team id."
   },
   {
     title: "Microsoft Teams",
@@ -1310,8 +1319,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/msteams",
     markdown: "plugins/msteams.md",
     keywords: ["plugins", "msteams", "microsoft", "teams"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Send Adaptive Cards to a Microsoft Teams channel when Mushi classifies a report or a fix lands \u2014 incoming webhook setup and severity filters."
+    headings: ["Setup (Mushi Cloud, no code)", "Self-hosted plugin"],
+    excerpt: "Send cards to a Microsoft Teams channel when Mushi triages a report or a fix lands \u2014 paste a webhook on the Integrations page, or self-host the plugin."
   },
   {
     title: "PagerDuty",
@@ -1319,8 +1328,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/pagerduty",
     markdown: "plugins/pagerduty.md",
     keywords: ["plugins", "pagerduty"],
-    headings: ["Setup", "Behaviour", "Troubleshooting"],
-    excerpt: "Page your on-call rotation through PagerDuty when a P0 or P1 bug report lands in Mushi \u2014 Events API v2 integration key setup and filters."
+    headings: ["Setup (self-run plugin)", "Behaviour", "Troubleshooting"],
+    excerpt: "Page your on-call rotation through PagerDuty when Mushi triages a bug as critical, and resolve it when the fix lands \u2014 Events API v2 routing key setup."
   },
   {
     title: "Rollbar",
@@ -1328,8 +1337,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/rollbar",
     markdown: "plugins/rollbar.md",
     keywords: ["plugins", "rollbar"],
-    headings: ["Setup", "Package", "Events"],
-    excerpt: "Mirror Mushi bug reports into Rollbar items and resolve them when fixes ship \u2014 access token, environment name, and dedup key mapping."
+    headings: ["Setup (self-hosted Mushi)", "Package", "Events"],
+    excerpt: "Copy triaged Mushi bug reports into Rollbar items and resolve them when fixes ship \u2014 a self-hosted plugin with an access token and project id."
   },
   {
     title: "Sentry",
@@ -1337,7 +1346,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/sentry",
     markdown: "plugins/sentry.md",
     keywords: ["plugins", "sentry"],
-    headings: ["Route Sentry errors into Mushi (inbound)", "Setup (outbound plugin)", "Package", "Events"],
+    headings: ["Route Sentry errors into Mushi (inbound)", "Copy Mushi reports into Sentry (outbound plugin)", "Package", "Events"],
     excerpt: "Two-way Sentry integration \u2014 Sentry errors flow into Mushi's queue, merging a Mushi fix resolves the Sentry issue, and critical reports mirror back."
   },
   {
@@ -1346,8 +1355,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/slack",
     markdown: "plugins/slack.md",
     keywords: ["plugins", "slack", "app"],
-    headings: ["Setup", "What's on the card", "Acting from the channel", "Slash commands", "Package", "Events", "Troubleshooting"],
-    excerpt: "Triage Mushi bug reports from Slack \u2014 each classified report posts as a card with its root cause and buttons to dispatch a fix, resolve or dismiss."
+    headings: ["Setup", "What's on the card", "Acting from the channel", "Slash commands", "Package", "What gets posted", "Troubleshooting"],
+    excerpt: "Triage Mushi bug reports from Slack \u2014 add the app from the Integrations page, and each report posts as a card with buttons to fix, resolve or dismiss."
   },
   {
     title: "Zapier",
@@ -1355,7 +1364,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/plugins/zapier",
     markdown: "plugins/zapier.md",
     keywords: ["plugins", "zapier"],
-    headings: ["Setup", "Signature verification in Zapier", "Common Zaps", "Troubleshooting"],
+    headings: ["Setup (no server)", "Setup (with the relay package)", "Common Zaps", "Troubleshooting"],
     excerpt: "Send every Mushi event to Zapier and on to thousands of apps such as Notion, Google Sheets and HubSpot \u2014 Catch Hook setup and event filters."
   },
   {
@@ -1392,7 +1401,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "quickstart/angular.md",
     keywords: ["quickstart", "angular"],
     headings: [],
-    excerpt: "Add Mushi to an Angular 17+ app \u2014 register the Mushi service and error handler as factory providers so uncaught errors and user bug reports reach your queue."
+    excerpt: "Add Mushi to an Angular 17+ app: one provideMushi() call registers the Mushi service and error handler, so uncaught errors and bug reports reach your queue."
   },
   {
     title: "Capacitor quickstart",
@@ -1554,7 +1563,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "sdks/angular.md",
     keywords: ["sdks", "angular", "@mushi-mushi/angular"],
     headings: ["API surface", "Setup (standalone bootstrap)", "Submitting a report", "Identifying users"],
-    excerpt: "API reference for @mushi-mushi/angular \u2014 MushiService, MushiErrorHandler and the MUSHI_CONFIG token, wired with factory providers in an Angular 17+ app."
+    excerpt: "API reference for @mushi-mushi/angular \u2014 provideMushi(), MushiService, MushiErrorHandler and the MUSHI_CONFIG token in an Angular 17+ app."
   },
   {
     title: "In-SDK Ask assistant",
@@ -1598,7 +1607,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/core",
     markdown: "sdks/core.md",
     keywords: ["sdks", "core", "@mushi-mushi/core"],
-    headings: ["Install", "API", "Mushi.init(config) (web) / MushiProvider (React Native)", "MushiWidgetConfig (selected keys)", "submitReport(input)", "flushOfflineQueueNow()", "PII scrubbing utilities (1.27+)", "Region resolution"],
+    headings: ["Install", "API", "Mushi.init(config) (web) / MushiProvider (React Native)", "MushiWidgetConfig (selected keys)", "captureEvent(input)", "Offline queue", "PII scrubbing utilities (1.27+)", "Region resolution"],
     excerpt: "Reference for @mushi-mushi/core \u2014 the MushiConfig shape, widget options, PII scrubbing helpers and region resolution shared by every Mushi JavaScript SDK."
   },
   {
@@ -1607,7 +1616,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/eslint-plugin",
     markdown: "sdks/eslint-plugin.md",
     keywords: ["sdks", "eslint-plugin", "eslint", "plugin", "eslint-plugin-mushi-mushi"],
-    headings: ["Install", "Recommended preset", "Rules", "mushi-mushi/no-dead-handler", "mushi-mushi/no-mock-leak", "Combining with the gates action"],
+    headings: ["Install", "Turn on the two rules", "The recommended preset", "Rules", "mushi-mushi/no-dead-handler", "mushi-mushi/no-mock-leak", "In CI"],
     excerpt: "eslint-plugin-mushi-mushi flags empty event handlers and leftover mock data in production code \u2014 the no-dead-handler and no-mock-leak rules and preset."
   },
   {
@@ -1644,7 +1653,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "sdks/inventory-schema.md",
     keywords: ["sdks", "inventory-schema", "inventory", "schema", "@mushi-mushi/inventory-schema"],
     headings: ["Install", "What inventory.yaml looks like", "Programmatic use", "JSON Schema"],
-    excerpt: "The Zod schema, JSON Schema and TypeScript types for inventory.yaml \u2014 the contract that Mushi's gates, crawler, ESLint plugin and CLI all read."
+    excerpt: "The Zod schema, JSON Schema and TypeScript types for inventory.yaml: your app's pages, the buttons and forms on each, what they do, and the tests that prove it."
   },
   {
     title: "MushiMushi (iOS)",
@@ -1670,7 +1679,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/mcp",
     markdown: "sdks/mcp.md",
     keywords: ["sdks", "mcp", "bug", "report", "server", "cursor", "claude", "code", "@mushi-mushi/mcp"],
-    headings: ["Two transports", "Spec traceability for dispatchfix"],
+    headings: ["Quick start", "Two transports", "Spec traceability for dispatchfix"],
     excerpt: "Reference for @mushi-mushi/mcp, the Mushi MCP server for Cursor, Claude Code, VS Code and Windsurf \u2014 stdio and hosted HTTP transports, scopes and setup."
   },
   {
@@ -1679,8 +1688,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/mcp-ci",
     markdown: "sdks/mcp-ci.md",
     keywords: ["sdks", "mcp-ci", "mcp", "@mushi-mushi/mcp-ci"],
-    headings: ["Quick start", "Commands", "In your IDE", "Inputs"],
-    excerpt: "@mushi-mushi/mcp-ci is Mushi's GitHub Action \u2014 run the five-gate composite check on pull requests, draft inventory entries, and bootstrap crawler auth."
+    headings: ["Quick start", "Gates on every PR", "Commands", "In your IDE", "Inputs", "Outputs"],
+    excerpt: "@mushi-mushi/mcp-ci is Mushi's GitHub Action: fail a PR while reports wait for triage, dispatch a fix, run the pre-release gates and refresh crawler sign-in."
   },
   {
     title: "MCP tools reference",
@@ -1715,7 +1724,7 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/node",
     markdown: "sdks/node.md",
     keywords: ["sdks", "node", "node.js", "server", "error", "reporting", "sdk", "@mushi-mushi/node"],
-    headings: ["Install", "Express", "Fastify", "Hono", "Process-level fallbacks", "Programmatic submit", "PII and credential scrubbing"],
+    headings: ["Install", "Create a client", "Express", "Fastify", "Hono", "Process-level fallbacks", "Programmatic submit", "PII and credential scrubbing"],
     excerpt: "Report server errors from Node with @mushi-mushi/node \u2014 Express, Fastify and Hono error handlers that tag each report with route, request ID and user."
   },
   {
@@ -1725,7 +1734,7 @@ var MUSHI_DOCS_INDEX = [
     markdown: "sdks/plugin-sdk.md",
     keywords: ["sdks", "plugin-sdk", "plugin", "sdk", "@mushi-mushi/plugin-sdk"],
     headings: ["Install", "Express adapter", "Hono adapter", "Verify a signature manually", "Wire format", "See also"],
-    excerpt: "Build a Mushi plugin in TypeScript with @mushi-mushi/plugin-sdk \u2014 verify webhook signatures, dedupe deliveries and handle lifecycle events in Express."
+    excerpt: "Build a Mushi plugin in TypeScript with @mushi-mushi/plugin-sdk \u2014 verify webhook signatures, dedupe deliveries and handle lifecycle events in Express or Hono."
   },
   {
     title: "SDK presets",
@@ -1781,6 +1790,15 @@ var MUSHI_DOCS_INDEX = [
     headings: ["API surface", "Setup", "Submitting a report"],
     excerpt: "Reference for @mushi-mushi/svelte \u2014 initMushi, getMushi and the SvelteKit error hooks that forward client and server errors to your Mushi queue."
   },
+  {
+    title: "@mushi-mushi/ux",
+    url: docUrl("/sdks/ux"),
+    route: "/sdks/ux",
+    markdown: "sdks/ux.md",
+    keywords: ["sdks", "ux", "@mushi-mushi/ux"],
+    headings: ["Quick start", "From studio to merge", "What a run does", "Safety", "Agents", "Commands", "Audit and explore signed-in screens", "On GitHub Actions"],
+    excerpt: "@mushi-mushi/ux runs your coding agent over each screen of your app, measures every change and keeps only the ones that help, on a branch you review."
+  },
   {
     title: "@mushi-mushi/vue",
     url: docUrl("/sdks/vue"),
@@ -1796,8 +1814,8 @@ var MUSHI_DOCS_INDEX = [
     route: "/sdks/wasm-classifier",
     markdown: "sdks/wasm-classifier.md",
     keywords: ["sdks", "wasm-classifier", "wasm", "classifier", "@mushi-mushi/wasm-classifier"],
-    headings: [],
-    excerpt: "@mushi-mushi/wasm-classifier runs a small on-device model in the browser to drop junk bug reports before they reach your LLM, cutting classification cost."
+    headings: ["Use it with the web SDK", "Call it directly", "ONNX backend (experimental)"],
+    excerpt: "@mushi-mushi/wasm-classifier filters junk bug reports in the browser, before they reach the server or your LLM."
   },
   {
     title: "JavaScript bug reporting SDK for the browser",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mushi-mushi/mcp",
   "mcpName": "io.github.kensaurus/mushi-mushi",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "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.3.1",
     "@modelcontextprotocol/server": "^2.3.1",
     "zod": "^4.6.7",
-    "@mushi-mushi/core": "^1.33.2"
+    "@mushi-mushi/core": "^1.33.3"
   },
   "peerDependencies": {
     "@sentry/node": "^10.57.0"