@mushi-mushi/core 1.14.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/dist/index.cjs

@@ -579,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;
@@ -617,7 +624,8 @@ function buildLogger(scope, minLevel, baseMeta, formatter) {
         `${scope}:${childScope}`,
         currentLevel,
         { ...baseMeta, ...childMeta },
-        formatter
+        formatter,
+        emit
       );
     },
     setLevel(level) {
@@ -630,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: () => {