@mushi-mushi/cli 0.17.2 → 0.18.0

package/CONTRIBUTING.md

@@ -63,7 +63,7 @@ packages/
   verify/        Fix verification (BSL)
 apps/
   admin/         Admin dashboard (React + Tailwind)
-  docs/          Documentation site (planned)
+  docs/          Documentation site (Nextra — apps/docs)
 tooling/
   eslint-config/ Shared ESLint flat config
   tsconfig/      Shared TypeScript configs
@@ -81,6 +81,28 @@ tooling/
    ```
 6. Open a pull request
 
+### Documentation (docs-as-code)
+
+If your PR changes **user-visible SDK or CLI behavior**, update docs in the **same PR**:
+
+| Surface | When to update |
+| --- | --- |
+| `packages/*/README.md` | npm-facing install/API/config changes for that package |
+| `apps/docs/content/**/*.mdx` | Long-form guides, quickstarts, admin console docs |
+| Root `README.md` | Marketing stats only when counts change — run `pnpm check:docs-stats` |
+
+Guardrails (run locally before pushing):
+
+```bash
+pnpm check:docs-stats          # root README stat badges
+pnpm check:sdk-version-matrix  # apps/docs/content/sdks/index.mdx versions
+pnpm check:internal-doc-links  # dead /foo links in MDX
+pnpm check:bundle-docs         # @mushi-mushi/web size-limit vs README
+pnpm gen:llms-txt              # regenerate apps/docs/public/llms.txt after nav changes
+```
+
+README changes on npm packages only appear on [npmjs.com](https://www.npmjs.com) after the next **Changesets publish**.
+
 ## Changesets
 
 We use [Changesets](https://github.com/changesets/changesets) for versioning. If your PR modifies a published package (`core`, `web`, `react`, `vue`, `svelte`, `angular`, `react-native`, `cli`, `mcp`), add a changeset:

package/README.md

@@ -306,6 +306,16 @@ mushi slack test
 - The `--api-key` flag leaks into `ps -ef` — prefer the interactive prompt on shared machines.
 - Full stack traces on error: `DEBUG=mushi mushi init`.
 
+## Programmatic imports
+
+The CLI is also importable for tooling (used by `create-mushi-mushi`):
+
+| Subpath | Exports |
+| --- | --- |
+| `@mushi-mushi/cli/init` | `runInit`, `InitOptions` |
+| `@mushi-mushi/cli/detect` | Framework / package-manager detection |
+| `@mushi-mushi/cli/version` | `MUSHI_CLI_VERSION` |
+
 ## License
 
 MIT

package/dist/chunk-ZB6ITDCQ.js

@@ -0,0 +1,6 @@
+// src/version.ts
+var MUSHI_CLI_VERSION = true ? "0.18.0" : "0.0.0-dev";
+
+export {
+  MUSHI_CLI_VERSION
+};

package/dist/index.js

@@ -83,7 +83,7 @@ function getAbortSignal(external) {
 }
 
 // src/version.ts
-var MUSHI_CLI_VERSION = true ? "0.17.2" : "0.0.0-dev";
+var MUSHI_CLI_VERSION = true ? "0.18.0" : "0.0.0-dev";
 
 // src/config.ts
 import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "fs";
@@ -2247,9 +2247,10 @@ Typical first-time flow:
 
 // src/commands/setup.ts
 function registerSetupCommands(program2) {
-  program2.command("setup").description("Wire Mushi into your IDE with one command").option("--ide <ide>", "Target IDE: cursor | claude | continue | zed", "cursor").option("--project-slug <slug>", "Override the project slug in the server name (default: project ID prefix)").option("--with-rules", "Also write the .cursorrules / .claude/rules/mushi.md lesson-library hook").option("--dry-run", "Print what would be written without making changes").addHelpText("after", `
+  program2.command("setup").description("Wire Mushi into your IDE with one command").option("--ide <ide>", "Target IDE: cursor | claude | continue | zed", "cursor").option("--project-slug <slug>", "Override the project slug in the server name (default: fetched from API or ID prefix)").option("--all-projects", "Write a separate mushi-<name> server entry for every accessible project").option("--with-rules", "Also write the .cursorrules / .claude/rules/mushi.md lesson-library hook").option("--dry-run", "Print what would be written without making changes").addHelpText("after", `
 Examples:
   mushi setup                         # wire Cursor (default)
+  mushi setup --all-projects          # one server entry per accessible project
   mushi setup --ide claude            # wire Claude Code
   mushi setup --ide cursor --with-rules  # also write .cursorrules
 
@@ -2265,6 +2266,42 @@ The command reads credentials from ~/.mushirc (run \`mushi login\` first).`).act
     const nodePath = await import("path");
     const os = await import("os");
     const config = requireConfig({ needsProject: true });
+    const redactKeyForDisplay = (text2) => {
+      const key = config.apiKey;
+      if (!key) return text2;
+      const masked = key.length > 12 ? `${key.slice(0, 10)}\u2026${key.slice(-2)}` : "\u2022\u2022\u2022\u2022";
+      return text2.split(key).join(masked);
+    };
+    let slug;
+    if (opts.projectSlug) {
+      slug = opts.projectSlug;
+    } else {
+      try {
+        const res = await fetch(
+          `${config.endpoint?.replace(/\/$/, "")}/v1/admin/mcp/projects`,
+          {
+            headers: {
+              "X-Mushi-Api-Key": config.apiKey ?? "",
+              "X-Mushi-Project": config.projectId ?? ""
+            },
+            signal: AbortSignal.timeout(5e3)
+          }
+        );
+        if (res.ok) {
+          const body = await res.json();
+          const project = body?.data?.projects?.find((p3) => p3.id === config.projectId);
+          if (project?.name) {
+            slug = project.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 24);
+          } else {
+            slug = config.projectId?.slice(0, 8) ?? "mushi";
+          }
+        } else {
+          slug = config.projectId?.slice(0, 8) ?? "mushi";
+        }
+      } catch {
+        slug = config.projectId?.slice(0, 8) ?? "mushi";
+      }
+    }
     const IDE_CONFIG = {
       cursor: { dir: ".cursor", file: "mcp.json", format: "mcp-json" },
       claude: { dir: ".claude", file: "mcp.json", format: "mcp-json" },
@@ -2278,7 +2315,23 @@ The command reads credentials from ~/.mushirc (run \`mushi login\` first).`).act
       process.exit(2);
     }
     const cwd = process.cwd();
-    const slug = opts.projectSlug ?? (config.projectId?.slice(0, 8) ?? "mushi");
+    let allProjectsList = null;
+    if (opts.allProjects && config.endpoint && config.apiKey) {
+      try {
+        const res = await fetch(
+          `${config.endpoint.replace(/\/$/, "")}/v1/admin/mcp/projects`,
+          {
+            headers: { "X-Mushi-Api-Key": config.apiKey, "X-Mushi-Project": config.projectId ?? "" },
+            signal: AbortSignal.timeout(8e3)
+          }
+        );
+        if (res.ok) {
+          const body = await res.json();
+          allProjectsList = body?.data?.projects ?? [];
+        }
+      } catch {
+      }
+    }
     const serverName = `mushi-${slug}`;
     const mcpServerBlock = {
       command: "npx",
@@ -2301,16 +2354,37 @@ The command reads credentials from ~/.mushirc (run \`mushi login\` first).`).act
         }
       }
       const servers = merged.mcpServers ?? {};
-      servers[serverName] = mcpServerBlock;
+      if (allProjectsList && allProjectsList.length > 0) {
+        for (const p3 of allProjectsList) {
+          const pSlug = p3.name ? p3.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 24) : p3.id.slice(0, 8);
+          const pServerName = `mushi-${pSlug}`;
+          servers[pServerName] = {
+            command: "npx",
+            args: ["-y", "@mushi-mushi/mcp@latest"],
+            env: {
+              MUSHI_API_ENDPOINT: config.endpoint,
+              MUSHI_PROJECT_ID: p3.id,
+              MUSHI_API_KEY: config.apiKey
+            }
+          };
+        }
+        if (opts.dryRun) {
+          console.log(`[dry-run] Would add ${allProjectsList.length} mushi-* entries to ${configPath}`);
+        } else {
+          console.log(`\u2713 Added ${allProjectsList.length} mushi-* server entries (${allProjectsList.map((p3) => p3.name ?? p3.id.slice(0, 8)).join(", ")})`);
+        }
+      } else {
+        servers[serverName] = mcpServerBlock;
+      }
       merged.mcpServers = servers;
       const output = JSON.stringify(merged, null, 2) + "\n";
       if (opts.dryRun) {
         console.log(`[dry-run] Would write ${configPath}:`);
-        console.log(output);
+        console.log(redactKeyForDisplay(output));
       } else {
         await mkdir2(configDir, { recursive: true });
         await writeFile2(configPath, output, "utf8");
-        console.log(`\u2713 Written ${configPath}`);
+        if (!allProjectsList) console.log(`\u2713 Written ${configPath}`);
       }
     } else if (ideEntry.format === "zed") {
       let settings = {};
@@ -2338,7 +2412,7 @@ The command reads credentials from ~/.mushirc (run \`mushi login\` first).`).act
       const output = JSON.stringify(settings, null, 2) + "\n";
       if (opts.dryRun) {
         console.log(`[dry-run] Would write ${configPath}:`);
-        console.log(output);
+        console.log(redactKeyForDisplay(output));
       } else {
         await mkdir2(configDir, { recursive: true });
         await writeFile2(configPath, output, "utf8");
@@ -2900,18 +2974,128 @@ async function checkHostAppWiring(cwd) {
   }
   return checks;
 }
+async function checkMcpConfig(config, cwd, doFetch = globalThis.fetch) {
+  const checks = [];
+  const { readFile: readFile3 } = await import("fs/promises");
+  const { join: join7, resolve: resolve4 } = await import("path");
+  const { homedir: homedir2 } = await import("os");
+  const root = resolve4(cwd);
+  const candidates = [
+    join7(root, ".cursor", "mcp.json"),
+    join7(homedir2(), ".cursor", "mcp.json")
+  ];
+  let mcpPath = null;
+  let mcpRaw = null;
+  for (const candidate of candidates) {
+    try {
+      mcpRaw = await readFile3(candidate, "utf8");
+      mcpPath = candidate;
+      break;
+    } catch {
+    }
+  }
+  if (!mcpPath || !mcpRaw) {
+    checks.push({
+      name: "[mcp] mcp.json present",
+      ok: false,
+      detail: "No .cursor/mcp.json found in cwd or ~/.cursor/. Run `mushi setup` to create it."
+    });
+    return checks;
+  }
+  checks.push({
+    name: "[mcp] mcp.json present",
+    ok: true,
+    detail: `Found at ${mcpPath}`
+  });
+  let mcpConfig = {};
+  try {
+    mcpConfig = JSON.parse(mcpRaw);
+  } catch {
+    checks.push({ name: "[mcp] mcp.json valid JSON", ok: false, detail: "mcp.json is not valid JSON \u2014 regenerate with `mushi setup`." });
+    return checks;
+  }
+  const servers = mcpConfig.mcpServers ?? {};
+  const mushiEntries = Object.entries(servers).filter(([k]) => k === "mushi" || k.startsWith("mushi-"));
+  if (mushiEntries.length === 0) {
+    checks.push({
+      name: "[mcp] mushi server entry",
+      ok: false,
+      detail: "No mushi or mushi-* server found in mcpServers. Run `mushi setup` to add one."
+    });
+    return checks;
+  }
+  checks.push({
+    name: "[mcp] mushi server entry",
+    ok: true,
+    detail: `Found: ${mushiEntries.map(([k]) => k).join(", ")}`
+  });
+  let anyKeyValid = false;
+  let anyEndpointSet = false;
+  for (const [, srv] of mushiEntries) {
+    const s = srv;
+    const env = s.env ?? {};
+    const key = env["MUSHI_API_KEY"] ?? "";
+    const endpoint = env["MUSHI_API_ENDPOINT"] ?? "";
+    if (key.startsWith("mushi_")) anyKeyValid = true;
+    if (endpoint.includes("supabase.co") || endpoint.includes("localhost")) anyEndpointSet = true;
+  }
+  checks.push({
+    name: "[mcp] MUSHI_API_KEY set",
+    ok: anyKeyValid,
+    detail: anyKeyValid ? "At least one mushi server has a valid mushi_* API key" : "No mushi_* API key found in any mushi server env. Re-run `mushi setup` to regenerate."
+  });
+  checks.push({
+    name: "[mcp] MUSHI_API_ENDPOINT set",
+    ok: anyEndpointSet,
+    detail: anyEndpointSet ? "MUSHI_API_ENDPOINT is present and looks valid" : "MUSHI_API_ENDPOINT missing or not a Supabase URL. Re-run `mushi setup`."
+  });
+  if (anyKeyValid && anyEndpointSet && config.apiKey && config.endpoint) {
+    try {
+      const { endpoint, apiKey } = sanitizeCliCredentials(config);
+      const res = await doFetch(`${endpoint}/v1/admin/mcp/account-overview`, {
+        headers: apiKeyHeaders(apiKey, config.projectId),
+        signal: AbortSignal.timeout(6e3)
+      });
+      if (res.ok) {
+        const body = await res.json();
+        const projectCount = body?.data?.total ?? 0;
+        checks.push({
+          name: "[mcp] account-overview reachable",
+          ok: true,
+          detail: `Key is valid; ${projectCount} accessible project${projectCount === 1 ? "" : "s"}`
+        });
+      } else {
+        checks.push({
+          name: "[mcp] account-overview reachable",
+          ok: false,
+          detail: `GET /v1/admin/mcp/account-overview \u2192 HTTP ${res.status}. Verify the API key is active.`
+        });
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      checks.push({
+        name: "[mcp] account-overview reachable",
+        ok: false,
+        detail: `Probe failed: ${msg}. Check MUSHI_API_ENDPOINT and network connectivity.`
+      });
+    }
+  }
+  return checks;
+}
 var FIX_HINTS = {
   "CLI config file": "Run `mushi connect --endpoint <url> --project-id <uuid> --api-key mushi_xxx` or `mushi config endpoint <url>`.",
   "API key configured": "Mint a key in the console (Projects \u2192 API Keys) then `mushi login --api-key mushi_xxx`.",
   "Project ID configured": "Copy the project UUID from the console Projects page \u2192 `mushi config projectId <uuid>`.",
   "Endpoint reachable": "Check your network and that MUSHI_API_ENDPOINT points at `\u2026/functions/v1/api`.",
   "[ingest]": "Open the console Onboarding wizard \u2192 Install SDK \u2192 submit a test report, or run `mushi connect --wait`.",
-  "[server]": "Open Settings \u2192 Integrations: connect GitHub, index codebase, add Anthropic BYOK key, enable autofix."
+  "[server]": "Open Settings \u2192 Integrations: connect GitHub, index codebase, add Anthropic BYOK key, enable autofix.",
+  "[mcp]": "Run `mushi setup` to regenerate .cursor/mcp.json with a fresh API key and endpoint."
 };
 function fixHintForCheck(name) {
   if (FIX_HINTS[name]) return FIX_HINTS[name];
   if (name.startsWith("[ingest]")) return FIX_HINTS["[ingest]"];
   if (name.startsWith("[server]") || name.startsWith("[preflight]")) return FIX_HINTS["[server]"];
+  if (name.startsWith("[mcp]")) return FIX_HINTS["[mcp]"];
   return void 0;
 }
 async function runDoctor(config, options = {}) {
@@ -2941,6 +3125,10 @@ async function runDoctor(config, options = {}) {
     const hostChecks = await checkHostAppWiring(options.cwd ?? process.cwd());
     checks.push(...hostChecks);
   }
+  if (options.mcp) {
+    const mcpChecks = await checkMcpConfig(config, options.cwd ?? process.cwd(), doFetch);
+    checks.push(...mcpChecks);
+  }
   return { checks, ready: checks.every((c) => c.ok) };
 }
 function formatDoctorResult(result) {
@@ -3379,12 +3567,15 @@ Examples:
   ).option(
     "--host-app",
     "Verify host-app wiring: Mushi env vars, Cursor MCP config, Capacitor hybrid SDK notes."
+  ).option(
+    "--mcp",
+    "Check Cursor MCP config: verify mushi-* server entry, credentials, and probe account-overview connectivity."
   ).option(
     "--fix",
     "Apply safe local fixes when checks fail: write missing .env.local lines and wire Cursor MCP config."
   ).action(async (opts) => {
     const config = loadConfig();
-    const doctorOpts = { cwd: opts.cwd, server: opts.server, ingest: opts.ingest, qaStories: opts.qaStories, hostApp: opts.hostApp };
+    const doctorOpts = { cwd: opts.cwd, server: opts.server, ingest: opts.ingest, qaStories: opts.qaStories, hostApp: opts.hostApp, mcp: opts.mcp };
     let result = await runDoctor(config, doctorOpts);
     if (!result.ready && opts.fix && config.apiKey && config.projectId && config.endpoint) {
       const connectResult = await runConnect({
@@ -3396,7 +3587,7 @@ Examples:
         wireIde: true
       }, config);
       for (const msg of connectResult.messages) console.log(msg);
-      result = await runDoctor(config, doctorOpts);
+      result = await runDoctor(config, { ...doctorOpts, mcp: opts.mcp });
     }
     const { checks } = result;
     if (opts.json) {

package/dist/init.js

@@ -8,7 +8,7 @@ import {
 } from "./chunk-S4WQHEGH.js";
 import {
   MUSHI_CLI_VERSION
-} from "./chunk-EEQI5AFX.js";
+} from "./chunk-ZB6ITDCQ.js";
 
 // src/init.ts
 import * as p from "@clack/prompts";

package/dist/version.js

@@ -1,6 +1,6 @@
 import {
   MUSHI_CLI_VERSION
-} from "./chunk-EEQI5AFX.js";
+} from "./chunk-ZB6ITDCQ.js";
 export {
   MUSHI_CLI_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mushi-mushi/cli",
-  "version": "0.17.2",
+  "version": "0.18.0",
   "license": "MIT",
   "description": "CLI for Mushi Mushi — `mushi init` wizard installs the right SDK for your framework, plus report triage and pipeline health commands",
   "bin": {

package/dist/chunk-EEQI5AFX.js

@@ -1,6 +0,0 @@
-// src/version.ts
-var MUSHI_CLI_VERSION = true ? "0.17.2" : "0.0.0-dev";
-
-export {
-  MUSHI_CLI_VERSION
-};