@mushi-mushi/core 1.13.0 → 1.15.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

@@ -69,4 +69,4 @@ MIT
 <!-- mushi-readme-stats-footer -->
 ---
 
-<sub>Monorepo scale (June 2026): 43 edge functions · 234 SQL migrations · 13 outbound plugins · 11 inbound adapters. 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 (June 2026): 47 edge functions · 256 SQL migrations · 13 outbound plugins · 11 inbound adapters · 18 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/index.cjs

@@ -57,7 +57,7 @@ function createApiClient(options) {
     maxRetries = DEFAULT_MAX_RETRIES
   } = options;
   let baseUrl = apiEndpoint.replace(/\/$/, "");
-  async function request(method, path, body, retries = maxRetries, internalKind) {
+  async function request(method, path, body, retries = maxRetries, internalKind, extraHeaders) {
     const url = `${baseUrl}${path}`;
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeout);
@@ -68,7 +68,8 @@ function createApiClient(options) {
           "Content-Type": "application/json",
           "X-Mushi-Api-Key": apiKey,
           "X-Mushi-Project": projectId,
-          ...internalKind ? { [MUSHI_INTERNAL_HEADER]: internalKind } : {}
+          ...internalKind ? { [MUSHI_INTERNAL_HEADER]: internalKind } : {},
+          ...extraHeaders
         },
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal,
@@ -81,7 +82,7 @@ function createApiClient(options) {
           const targetBase = target.replace(/\/v1\/.*$/, "").replace(/\/$/, "");
           if (targetBase !== baseUrl) {
             baseUrl = targetBase;
-            return request(method, path, body, retries - 1, internalKind);
+            return request(method, path, body, retries - 1, internalKind, extraHeaders);
           }
         }
       }
@@ -89,7 +90,7 @@ function createApiClient(options) {
         const errorBody = await response.json().catch(() => ({}));
         if (response.status >= 500 && retries > 0) {
           await sleep(getBackoffDelay(maxRetries - retries));
-          return request(method, path, body, retries - 1, internalKind);
+          return request(method, path, body, retries - 1, internalKind, extraHeaders);
         }
         return {
           ok: false,
@@ -297,6 +298,69 @@ function createApiClient(options) {
         1,
         "reporter-poll"
       );
+    },
+    // ─── Cross-app community (in-widget tester identity) ──────────
+    async sendMagicLink(email) {
+      return request(
+        "POST",
+        "/v1/tester/magic-link",
+        { email },
+        1,
+        "community"
+      );
+    },
+    async linkReporterToken(reporterTokenHash, jwt) {
+      return request(
+        "POST",
+        "/v1/tester/link-reporter",
+        { reporter_token_hash: reporterTokenHash },
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
+    },
+    async getCrossAppReports(jwt, opts) {
+      const qs = new URLSearchParams();
+      if (opts?.limit) qs.set("limit", String(opts.limit));
+      if (opts?.offset) qs.set("offset", String(opts.offset));
+      const suffix = qs.size ? `?${qs.toString()}` : "";
+      return request(
+        "GET",
+        `/v1/tester/cross-app-reports${suffix}`,
+        void 0,
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
+    },
+    async getMyReputation(jwt) {
+      return request(
+        "GET",
+        "/v1/tester/reputation",
+        void 0,
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
+    },
+    async getPublicLeaderboard(limit = 20) {
+      return request(
+        "GET",
+        `/v1/public/tester-leaderboard?limit=${limit}`,
+        void 0,
+        1,
+        "reporter-poll"
+      );
+    },
+    async getTesterStatus(jwt) {
+      return request(
+        "GET",
+        "/v1/me/tester-status",
+        void 0,
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
     }
   };
 }
@@ -515,20 +579,27 @@ function formatPretty(entry) {
 function formatJson(entry) {
   return JSON.stringify(entry);
 }
-function emit(level, formatted) {
-  switch (level) {
-    case "error":
-    case "fatal":
+function makeEmitter(destination) {
+  if (destination === "stderr") {
+    return (level, formatted) => {
       console.error(formatted);
-      break;
-    case "warn":
-      console.warn(formatted);
-      break;
-    default:
-      console.log(formatted);
+    };
   }
+  return (level, formatted) => {
+    switch (level) {
+      case "error":
+      case "fatal":
+        console.error(formatted);
+        break;
+      case "warn":
+        console.warn(formatted);
+        break;
+      default:
+        console.log(formatted);
+    }
+  };
 }
-function buildLogger(scope, minLevel, baseMeta, formatter) {
+function buildLogger(scope, minLevel, baseMeta, formatter, emit) {
   let currentLevel = minLevel;
   function log(level, msg, meta) {
     if (LEVEL_VALUE[level] < LEVEL_VALUE[currentLevel]) return;
@@ -553,7 +624,8 @@ function buildLogger(scope, minLevel, baseMeta, formatter) {
         `${scope}:${childScope}`,
         currentLevel,
         { ...baseMeta, ...childMeta },
-        formatter
+        formatter,
+        emit
       );
     },
     setLevel(level) {
@@ -566,11 +638,13 @@ function createLogger(options) {
     scope,
     level = "info",
     meta = {},
-    format = "auto"
+    format = "auto",
+    destination = "stdout"
   } = options;
   const resolvedFormat = format === "auto" ? detectFormat() : format;
   const formatter = resolvedFormat === "json" ? formatJson : formatPretty;
-  return buildLogger(scope, level, meta, formatter);
+  const emit = makeEmitter(destination);
+  return buildLogger(scope, level, meta, formatter, emit);
 }
 var noopLogger = {
   debug: () => {