From 2b401c6d8000a6f0e97532f44b19b3790d280c61 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Mon, 11 May 2026 23:03:27 -0500
Subject: [PATCH 1/7] =?UTF-8?q?chore(release):=20v1.0.1=20=E2=80=94=20sync?=
 =?UTF-8?q?=20version=20pins=20for=20README=20install=20variants?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR #24 added pnpm + yarn install commands and excluded plugin/*.png from
the tarball, which required bumping the npm version (1.0.0 -> 1.0.1) to
publish. This commit syncs all release-gate-enforced version pins to 1.0.1
so main matches what's on npm.

Files synced:
- package.json + package-lock.json
- server.json (3 places)
- plugin/widget-meta.json
- plugins/memoire/.codex-plugin/plugin.json
- 12 examples/**/registry.json
- examples/presets/starter/README.md
- preview/changelog.html (regenerated from CHANGELOG.md)

CHANGELOG: v1.0.1 entry covering the install-variants and pack-size-fix
changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                                  |  8 +++++++
 examples/presets/ai-chat/registry.json        |  2 +-
 examples/presets/auth-flow/registry.json      |  2 +-
 examples/presets/dashboard/registry.json      |  2 +-
 examples/presets/docs-blog/registry.json      |  2 +-
 examples/presets/ecommerce/registry.json      |  2 +-
 examples/presets/landing-page/registry.json   |  2 +-
 examples/presets/starter-saas/registry.json   |  2 +-
 examples/presets/starter/README.md            |  2 +-
 examples/presets/starter/registry.json        |  2 +-
 examples/presets/tweakcn-linear/registry.json |  2 +-
 .../presets/tweakcn-supabase/registry.json    |  2 +-
 examples/presets/tweakcn-vercel/registry.json |  2 +-
 examples/starter-registry/registry.json       |  2 +-
 package-lock.json                             |  4 ++--
 package.json                                  |  2 +-
 plugin/widget-meta.json                       |  4 ++--
 plugins/memoire/.codex-plugin/plugin.json     |  2 +-
 preview/changelog.html                        | 22 ++++++++++++++-----
 server.json                                   |  6 ++---
 20 files changed, 47 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 529c7fd..477f6af 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,14 @@ This changelog tracks Mémoire itself: every version, commit, and architectural
 
 ## Unreleased
 
+## v1.0.1 — 2026-05-12
+
+### Docs
+- README install section now lists pnpm and yarn variants alongside npm (single bash block, three lines).
+
+### Packaging
+- Exclude `plugin/*.png` from the npm tarball — prevents stray local screenshots in the plugin folder from blowing past the size gate.
+
 ## v1.0.0 — 2026-05-10
 
 ### Rebrand and stability commitment
diff --git a/examples/presets/ai-chat/registry.json b/examples/presets/ai-chat/registry.json
index 66c7f53..9a3fd37 100644
--- a/examples/presets/ai-chat/registry.json
+++ b/examples/presets/ai-chat/registry.json
@@ -73,6 +73,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/auth-flow/registry.json b/examples/presets/auth-flow/registry.json
index add9108..fcf15ef 100644
--- a/examples/presets/auth-flow/registry.json
+++ b/examples/presets/auth-flow/registry.json
@@ -63,6 +63,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/dashboard/registry.json b/examples/presets/dashboard/registry.json
index 25c847a..76ef8a9 100644
--- a/examples/presets/dashboard/registry.json
+++ b/examples/presets/dashboard/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/docs-blog/registry.json b/examples/presets/docs-blog/registry.json
index 4138ae9..07e5778 100644
--- a/examples/presets/docs-blog/registry.json
+++ b/examples/presets/docs-blog/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/ecommerce/registry.json b/examples/presets/ecommerce/registry.json
index 873002f..e70c1ab 100644
--- a/examples/presets/ecommerce/registry.json
+++ b/examples/presets/ecommerce/registry.json
@@ -63,6 +63,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/landing-page/registry.json b/examples/presets/landing-page/registry.json
index d0f8d6f..026c71f 100644
--- a/examples/presets/landing-page/registry.json
+++ b/examples/presets/landing-page/registry.json
@@ -63,6 +63,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/starter-saas/registry.json b/examples/presets/starter-saas/registry.json
index e4b6b35..95dc84a 100644
--- a/examples/presets/starter-saas/registry.json
+++ b/examples/presets/starter-saas/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/starter/README.md b/examples/presets/starter/README.md
index d110a6e..20d928f 100644
--- a/examples/presets/starter/README.md
+++ b/examples/presets/starter/README.md
@@ -30,4 +30,4 @@ memi add Button --from @yourscope/your-ds
 - Four real React components using CSS variables, not hardcoded hex
 - `Button.loading` prop that swaps the label for a spinner
 
-Generated for Memoire v1.0.0.
+Generated for Memoire v1.0.1.
diff --git a/examples/presets/starter/registry.json b/examples/presets/starter/registry.json
index ff6fefe..6e0040c 100644
--- a/examples/presets/starter/registry.json
+++ b/examples/presets/starter/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/tweakcn-linear/registry.json b/examples/presets/tweakcn-linear/registry.json
index 0fc208b..29fef17 100644
--- a/examples/presets/tweakcn-linear/registry.json
+++ b/examples/presets/tweakcn-linear/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/tweakcn-supabase/registry.json b/examples/presets/tweakcn-supabase/registry.json
index 0a51090..53382ed 100644
--- a/examples/presets/tweakcn-supabase/registry.json
+++ b/examples/presets/tweakcn-supabase/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/presets/tweakcn-vercel/registry.json b/examples/presets/tweakcn-vercel/registry.json
index 80a790c..28d065b 100644
--- a/examples/presets/tweakcn-vercel/registry.json
+++ b/examples/presets/tweakcn-vercel/registry.json
@@ -53,6 +53,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/examples/starter-registry/registry.json b/examples/starter-registry/registry.json
index 84d2cee..b8efbac 100644
--- a/examples/starter-registry/registry.json
+++ b/examples/starter-registry/registry.json
@@ -23,6 +23,6 @@
   ],
   "meta": {
     "extractedAt": "2026-04-15T00:00:00.000Z",
-    "memoireVersion": "1.0.0"
+    "memoireVersion": "1.0.1"
   }
 }
diff --git a/package-lock.json b/package-lock.json
index e8e00e9..3eea619 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@memi-design/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@memi-design/cli",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "license": "MIT",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.39.0",
diff --git a/package.json b/package.json
index 1a6845b..67d91f5 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@memi-design/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "mcpName": "io.github.sarveshsea/memi",
   "description": "Design-system memory for coding agents — give Claude Code, Cursor, and Codex memory of your tokens, components, and Figma so they edit your app without breaking the design.",
   "type": "module",
diff --git a/plugin/widget-meta.json b/plugin/widget-meta.json
index 85cdd9d..a6f4c13 100644
--- a/plugin/widget-meta.json
+++ b/plugin/widget-meta.json
@@ -1,7 +1,7 @@
 {
   "widgetVersion": "2",
-  "packageVersion": "1.0.0",
-  "builtAt": "2026-05-10T20:29:00.481Z",
+  "packageVersion": "1.0.1",
+  "builtAt": "2026-05-12T03:53:41.174Z",
   "bundleHash": "ffd143c9b7a1a1ea878b03322940525eb1f53db395572b46e3cc7bbf4f2e69aa",
   "manifest": {
     "path": "/Users/sarveshchidambaram/Desktop/Projects/Other/ark/plugin/manifest.json",
diff --git a/plugins/memoire/.codex-plugin/plugin.json b/plugins/memoire/.codex-plugin/plugin.json
index 7fc5778..e626728 100644
--- a/plugins/memoire/.codex-plugin/plugin.json
+++ b/plugins/memoire/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "memoire",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Design memory and UI quality tools for Codex: MCP tools, design-system context, Figma workflows, shadcn/ui, Tailwind, and Atomic Design.",
   "author": {
     "name": "Sarvesh Chidambaram",
diff --git a/preview/changelog.html b/preview/changelog.html
index a2dee10..17c48f3 100644
--- a/preview/changelog.html
+++ b/preview/changelog.html
@@ -391,8 +391,8 @@
     </nav>
     <div class="hdr-stats">
       <span><span class="n" id="stat-commits">242</span> commits</span>
-      <span><span class="n" id="stat-versions">24</span> versions</span>
-      <span><span class="n" id="stat-latest">2026-05-10</span> latest</span>
+      <span><span class="n" id="stat-versions">25</span> versions</span>
+      <span><span class="n" id="stat-latest">2026-05-12</span> latest</span>
     </div>
   </header>
 
@@ -407,8 +407,8 @@ <h1 class="hero-title">Real release history, not placeholder demo copy.</h1>
         <div class="hero-kpis">
           <div class="summary-card">
             <span class="summary-kicker">Current release</span>
-            <strong class="summary-value">v1.0.0</strong>
-            <div class="summary-caption">0 commits tracked in v1.0.0 from CHANGELOG.md.</div>
+            <strong class="summary-value">v1.0.1</strong>
+            <div class="summary-caption">0 commits tracked in v1.0.1 from CHANGELOG.md.</div>
           </div>
           <div class="summary-card">
             <span class="summary-kicker">Biggest theme</span>
@@ -434,10 +434,22 @@ <h1 class="hero-title">Real release history, not placeholder demo copy.</h1>
     <section class="release-list" id="release-list"></section>
   </main>
 
-  <footer class="footer">memoire changelog - synced with CHANGELOG.md through v1.0.0</footer>
+  <footer class="footer">memoire changelog - synced with CHANGELOG.md through v1.0.1</footer>
 
 <script>
 const releases = [
+  {
+    "version": "v1.0.1",
+    "date": "2026-05-12",
+    "tag": "fix",
+    "summary": "README install section now lists pnpm and yarn variants alongside npm (single bash block, three lines); Exclude plugin/*.png from the npm tarball — prevents stray local screenshots in the plugin folder from blowing past the size gate.",
+    "commits": [],
+    "decisions": [],
+    "changes": [
+      "README install section now lists pnpm and yarn variants alongside npm (single bash block, three lines).",
+      "Exclude plugin/*.png from the npm tarball — prevents stray local screenshots in the plugin folder from blowing past the size gate."
+    ]
+  },
   {
     "version": "v1.0.0",
     "date": "2026-05-10",
diff --git a/server.json b/server.json
index 167f119..a451c01 100644
--- a/server.json
+++ b/server.json
@@ -3,7 +3,7 @@
   "name": "io.github.sarveshsea/memi",
   "title": "memi",
   "description": "Design-system memory for coding agents — Figma tokens, shadcn/ui codegen, Tailwind audits.",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "websiteUrl": "https://memoire.cv",
   "repository": {
     "url": "https://github.com/sarveshsea/memi",
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@memi-design/cli",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "transport": {
         "type": "stdio"
       },
@@ -37,7 +37,7 @@
   "_meta": {
     "io.modelcontextprotocol.registry/publisher-provided": {
       "tool": "memi-release",
-      "version": "1.0.0"
+      "version": "1.0.1"
     }
   }
 }

From 9ac7ce2ac04a306c17ec6a08a8991fc99d37cc19 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Mon, 11 May 2026 23:14:58 -0500
Subject: [PATCH 2/7] =?UTF-8?q?docs(readme):=20scrub=20stale=20Memoire/M?=
 =?UTF-8?q?=C3=A9moire=20prose=20+=200.16.3=20version=20pins?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hero was already on the new brand from PR #21, but 32 references below
the fold still said "Memoire" or "Mémoire" — anyone scrolling the npm
page sees inconsistent branding. Also dropped two stale "0.16.3 ships..."
prose pins that made the README look unmaintained.

Preserved on purpose:
- Two `Mémoire Studio_0.16.3_aarch64.dmg` filename examples — these
  are the actual Tauri-bundled DMG names; updating prose without
  rebuilding the app would create a misleading reference.
- All `~/.codex/skills/memoire/`, `~/.hermes/skills/memoire/`,
  `plugins/memoire/`, `memoire.agent.yaml` paths — these are
  installed in user environments and renaming would break installs.

`check:release` still passes (requiredReadmeTerms substrings all live in
the unchanged hero).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md | 64 +++++++++++++++++++++++++++----------------------------
 1 file changed, 32 insertions(+), 32 deletions(-)

diff --git a/README.md b/README.md
index b9bed3e..0420be8 100644
--- a/README.md
+++ b/README.md
@@ -39,9 +39,9 @@ memi shadcn export --out public/r   # publish a shadcn-native registry
 
 ---
 
-### Install Mémoire into your AI agent
+### Install memi into your AI agent
 
-`0.16.3` ships native agent kits and the first native-runtime trust patch inside the npm package. Install Memoire once, initialize the workspace suite manifest, warm the shared daemon, then give Hermes agents, OpenClaw bots, Claude Code, Cursor, Codex, and OpenCode the same design-system memory, Figma bridge context, Atomic Design rules, shadcn/ui codegen, Tailwind diagnostics, and research-backed UI audit flow.
+memi ships native agent kits and the first native-runtime trust patch inside the npm package. Install memi once, initialize the workspace suite manifest, warm the shared daemon, then give Hermes agents, OpenClaw bots, Claude Code, Cursor, Codex, and OpenCode the same design-system memory, Figma bridge context, Atomic Design rules, shadcn/ui codegen, Tailwind diagnostics, and research-backed UI audit flow.
 
 ```bash
 npm i -g @memi-design/cli
@@ -68,23 +68,23 @@ Hermes and OpenClaw receive `memoire-design-tooling` `SKILL.md` packages. Claude
 
 | Agent | Native install target | What it unlocks |
 |-------|-----------------------|-----------------|
-| Hermes | `~/.hermes/skills/memoire/memoire-design-tooling/SKILL.md` | Hermes loads Memoire as a design-system skill for UI, Figma, specs, and research runs. |
+| Hermes | `~/.hermes/skills/memoire/memoire-design-tooling/SKILL.md` | Hermes loads memi as a design-system skill for UI, Figma, specs, and research runs. |
 | OpenClaw | `<workspace>/skills/memoire/memoire-design-tooling/SKILL.md` | OpenClaw picks up a workspace skill with `memi` install metadata for ClawHub-style agent use. |
 | Claude Code | `.mcp.json` | Project MCP config for `memi mcp start --no-figma`; Claude Code asks to approve project MCP servers from `.mcp.json`. |
-| Cursor | `.cursor/mcp.json` | Cursor MCP config for Memoire design-system tools. |
+| Cursor | `.cursor/mcp.json` | Cursor MCP config for memi design-system tools. |
 | Codex skill | `~/.codex/skills/memoire/memoire-design-tooling/SKILL.md` | Skill-only instructions for design audits, Figma context, specs, and Tailwind/shadcn workflows. |
-| Codex plugin | `~/plugins/memoire` + `~/.agents/plugins/marketplace.json` | Full Codex plugin with the Memoire skill and MCP server wiring. |
+| Codex plugin | `~/plugins/memoire` + `~/.agents/plugins/marketplace.json` | Full Codex plugin with the memi skill and MCP server wiring. |
 | OpenCode | workspace skill pack | Agent-native instructions for design audits, Figma context, specs, and Tailwind/shadcn workflows. |
 
 #### Public Codex plugin marketplace
 
-Memoire also ships as a Git-backed Codex marketplace so users can install it from `/plugins` without waiting for the official Codex Plugin Directory:
+memi also ships as a Git-backed Codex marketplace so users can install it from `/plugins` without waiting for the official Codex Plugin Directory:
 
 ```bash
 codex plugin marketplace add sarveshsea/memi --ref main --sparse .agents/plugins --sparse plugins/memoire
 ```
 
-Then open `/plugins` in Codex and install Memoire from the marketplace list. The same plugin is available through npm for users who already have `memi`:
+Then open `/plugins` in Codex and install memi from the marketplace list. The same plugin is available through npm for users who already have `memi`:
 
 ```bash
 npm i -g @memi-design/cli
@@ -93,9 +93,9 @@ memi agent install codex-plugin
 
 See [`docs/CODEX_PLUGIN.md`](./docs/CODEX_PLUGIN.md) and the public plugin page at `https://www.memoire.cv/codex-plugin`.
 
-### Mémoire Studio for macOS
+### memi Studio for macOS
 
-`0.16.3` includes Mémoire Studio: a macOS agent workbench and local web shell for Claude Code, Codex, Hermes, OpenCode, Ollama, Gemini, Mémoire Native, project memory, the Figma bridge, and an in-app Marketplace for Mémoire Notes. The desktop app includes a native Agent Kits panel so you can dry-run, install, and force-refresh Hermes/OpenClaw/Claude/Cursor/Codex/OpenCode kits without leaving Studio. Studio and the CLI share the same daemon-aware install path, suite manifest, project memory, harness metadata, and MCP startup guidance.
+memi includes a Studio app: a macOS agent workbench and local web shell for Claude Code, Codex, Hermes, OpenCode, Ollama, Gemini, memi Native, project memory, the Figma bridge, and an in-app Marketplace for memi Notes. The desktop app includes a native Agent Kits panel so you can dry-run, install, and force-refresh Hermes/OpenClaw/Claude/Cursor/Codex/OpenCode kits without leaving Studio. Studio and the CLI share the same daemon-aware install path, suite manifest, project memory, harness metadata, and MCP startup guidance.
 
 ```bash
 # web/TUI workflows from npm
@@ -118,7 +118,7 @@ Tagged GitHub Releases attach signed and notarized DMGs when Apple release secre
 
 ### Product Scenario Lab
 
-Memoire includes a clean-room product simulation layer for research-backed spec work. `memi simulate` maps `research/store.v2.json` into personas, variables, graph edges, model-swarm transcripts, interviews, reports, and spec-impact artifacts. Studio exposes the same flow through the `simulate` action and Scenario Lab so Codex, Claude Code, Hermes, OpenCode, Ollama, OpenAI-compatible providers, and deterministic fallback can operate from the macOS workbench.
+memi includes a clean-room product simulation layer for research-backed spec work. `memi simulate` maps `research/store.v2.json` into personas, variables, graph edges, model-swarm transcripts, interviews, reports, and spec-impact artifacts. Studio exposes the same flow through the `simulate` action and Scenario Lab so Codex, Claude Code, Hermes, OpenCode, Ollama, OpenAI-compatible providers, and deterministic fallback can operate from the macOS workbench.
 
 ```bash
 memi research synthesize
@@ -142,7 +142,7 @@ The npm package does not vendor MiroFish source. The optional `--adapter mirofis
 
 ### Research Vibe Design + FigJam Export
 
-Product agents can now turn `research/store.v2.json` and optional Scenario Lab reports into full Atomic Design specs plus Mermaid Jam-ready FigJam source. The first delivery path is source + open: Memoire writes Mermaid/markdown artifacts under `.memoire/mermaid-jam/<package-id>/` and opens Mermaid Jam when requested; it does not automate clipboard or direct paste.
+Product agents can now turn `research/store.v2.json` and optional Scenario Lab reports into full Atomic Design specs plus Mermaid Jam-ready FigJam source. The first delivery path is source + open: memi writes Mermaid/markdown artifacts under `.memoire/mermaid-jam/<package-id>/` and opens Mermaid Jam when requested; it does not automate clipboard or direct paste.
 
 ```bash
 memi research synthesize
@@ -164,14 +164,14 @@ npx shadcn@latest add https://your-site.com/r/button.json
 # v0 / AI-editor context
 memi shadcn serve --port 4014
 
-# Mémoire install path with aliases, npm packages, URLs, GitHub, or local paths
+# memi install path with aliases, npm packages, URLs, GitHub, or local paths
 memi registry install Button --from @you/ds
 memi add Button --from ./public/r
 ```
 
 ## No Figma required
 
-Most developer teams do not start in Figma. Memoire reads the codebase directly: Tailwind classes, shadcn usage, CSS variables, routes, markup, repeated literals, dark-mode coverage, token aliases, component targets, and registry shape.
+Most developer teams do not start in Figma. memi reads the codebase directly: Tailwind classes, shadcn usage, CSS variables, routes, markup, repeated literals, dark-mode coverage, token aliases, component targets, and registry shape.
 
 ```bash
 # Diagnose an existing app from code
@@ -194,7 +194,7 @@ Reports are written to `.memoire/app-quality/diagnosis.{json,md}` and token extr
 
 ## Trust defaults
 
-The public npm package does not run install-time lifecycle scripts. Figma plugin installation is explicit with `memi setup plugin`, and repairs are explicit with `memi doctor --repair-plugin`. The default packaged Figma plugin disables raw JavaScript execution; agents should use typed Memoire Figma tools, MCP tools, suite recipes, and local commands that the user can inspect.
+The public npm package does not run install-time lifecycle scripts. Figma plugin installation is explicit with `memi setup plugin`, and repairs are explicit with `memi doctor --repair-plugin`. The default packaged Figma plugin disables raw JavaScript execution; agents should use typed memi Figma tools, MCP tools, suite recipes, and local commands that the user can inspect.
 
 ## Registry workflow
 
@@ -212,7 +212,7 @@ memi publish --name @you/ds
 memi add Button --from @you/ds
 ```
 
-Point Memoire at `src/`, `app/globals.css`, a built CSS file, `http://localhost:3000`, or a public URL.
+Point memi at `src/`, `app/globals.css`, a built CSS file, `http://localhost:3000`, or a public URL.
 
 ### Published registry -> shadcn/v0/AI editors
 
@@ -223,7 +223,7 @@ npx shadcn@latest add https://cdn.example.com/r/button.json
 # Use the same registry as AI design-system context
 memi shadcn serve --from @you/ds
 
-# Install through Memoire when you want alias/package/URL/GitHub resolution
+# Install through memi when you want alias/package/URL/GitHub resolution
 memi registry install Button --from @you/ds
 ```
 
@@ -266,9 +266,9 @@ A registry bundles tokens (W3C DTCG JSON + Tailwind v4 `@theme` CSS), component
 
 More examples and the featured fallback catalog live in [`examples/`](./examples/README.md).
 
-### Designed in tweakcn? Publish with Memoire.
+### Designed in tweakcn? Publish with memi.
 
-[tweakcn](https://tweakcn.com) is the visual theme editor for shadcn/ui. Memoire now treats tweakcn as a full workflow, not just a publish flag:
+[tweakcn](https://tweakcn.com) is the visual theme editor for shadcn/ui. memi now treats tweakcn as a full workflow, not just a publish flag:
 
 ```bash
 # Import from a tweakcn CSS export or share URL
@@ -288,11 +288,11 @@ memi theme publish "Acme Theme" --package @you/theme
 Theme import handles both Tailwind v3 (`:root { --primary: ... }`) and v4 (`@theme { --color-primary: ... }`) exports, including `:root` + `.dark` multi-mode themes. If you want the one-shot path, `memi publish --theme <path-or-url>` still works.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/sarveshsea/memi/main/assets/demo.gif" alt="Memoire terminal publish and install flow" width="720" />
+  <img src="https://raw.githubusercontent.com/sarveshsea/memi/main/assets/demo.gif" alt="memi terminal publish and install flow" width="720" />
 </p>
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/sarveshsea/memi/main/assets/theme-workflow-demo.svg" alt="Memoire tweakcn theme workflow" width="720" />
+  <img src="https://raw.githubusercontent.com/sarveshsea/memi/main/assets/theme-workflow-demo.svg" alt="memi tweakcn theme workflow" width="720" />
 </p>
 
 Demo scripts for recording and reuse live in [`docs/DEMOS.md`](./docs/DEMOS.md).
@@ -300,23 +300,23 @@ No-Figma proof examples live in [`docs/PROOF.md`](./docs/PROOF.md).
 
 ---
 
-## Why teams keep Memoire in the stack
+## Why teams keep memi in the stack
 
-Claude Design, Figma Make, Lovable, Bolt, Replit Agent, and v0 are useful for fast first passes. Memoire is for the part after that first pass, when the output has to survive beyond a single prompt or canvas session.
+Claude Design, Figma Make, Lovable, Bolt, Replit Agent, and v0 are useful for fast first passes. memi is for the part after that first pass, when the output has to survive beyond a single prompt or canvas session.
 
-- App builders: strong for creating the first version. Memoire diagnoses the design debt that shows up once the app is real.
-- Claude Design and Figma Make: strong for visual exploration. Memoire keeps the reusable system portable across code, registries, and AI tools.
-- v0: strong for generating screens and using registries. Memoire helps infer, improve, and publish the registry from the app you already have.
+- App builders: strong for creating the first version. memi diagnoses the design debt that shows up once the app is real.
+- Claude Design and Figma Make: strong for visual exploration. memi keeps the reusable system portable across code, registries, and AI tools.
+- v0: strong for generating screens and using registries. memi helps infer, improve, and publish the registry from the app you already have.
 
-If your team needs better visual quality, versioned tokens, installable components, tweakcn theme packaging, and cross-tool design system context, that is the Memoire wedge.
+If your team needs better visual quality, versioned tokens, installable components, tweakcn theme packaging, and cross-tool design system context, that is the memi wedge.
 
 ---
 
 ## Studio interface references and adapted components
 
-Memoire Studio is a desktop-first agent workbench for design runs. Its interface uses Hermes WebUI and Hermes Agent as MIT-licensed references for the transcript-first console, three-pane workbench, event normalization, and supervised local sessions.
+memi Studio is a desktop-first agent workbench for design runs. Its interface uses Hermes WebUI and Hermes Agent as MIT-licensed references for the transcript-first console, three-pane workbench, event normalization, and supervised local sessions.
 
-Studio runs Claude Code, Codex, Hermes, Ollama, OpenCode, Gemini, and Memoire Native through a shared harness manifest. External coding agents receive a Memoire design/research envelope before execution, so their runs start from project memory, specs, references, Figma state, accessibility, and Atomic Design rather than a generic coding prompt. The macOS app also has an Agent Kits panel for dry-run planning, installation, and force-refresh of Hermes, OpenClaw, Claude Code, Cursor, Codex, and OpenCode kit targets. `memi studio tui` and `memi studio logs` expose the same persisted JSONL events for terminal-first visibility into package logs, Claude/Codex output, harness status, approvals, artifacts, and final results.
+Studio runs Claude Code, Codex, Hermes, Ollama, OpenCode, Gemini, and memi Native through a shared harness manifest. External coding agents receive a memi design/research envelope before execution, so their runs start from project memory, specs, references, Figma state, accessibility, and Atomic Design rather than a generic coding prompt. The macOS app also has an Agent Kits panel for dry-run planning, installation, and force-refresh of Hermes, OpenClaw, Claude Code, Cursor, Codex, and OpenCode kit targets. `memi studio tui` and `memi studio logs` expose the same persisted JSONL events for terminal-first visibility into package logs, Claude/Codex output, harness status, approvals, artifacts, and final results.
 
 Studio also includes a Notes Marketplace that lists built-in Notes, installed workspace Notes, and installable packages from the repo-owned `notes/*/note.json` manifests. The Marketplace uses the same Notes installer logic as `memi notes`, so installed packs become normal `.memoire/notes` project memory and agent context.
 
@@ -330,7 +330,7 @@ For public direct-download DMGs, use the signed/notarized release gate in [docs/
 
 Motion/video work is native in 0.15 through optional Remotion and HyperFrames adapters. `memi video create|preview|render` stores projects under `.memoire/videos` without making either video tool a hard dependency.
 
-Warp is used as a product reference for terminal blocks and grouped command output. Only MIT-licensed Warp UI framework pieces such as `warpui_core` and `warpui` are considered for adaptation; Warp AGPL application/client code is not copied into Memoire.
+Warp is used as a product reference for terminal blocks and grouped command output. Only MIT-licensed Warp UI framework pieces such as `warpui_core` and `warpui` are considered for adaptation; Warp AGPL application/client code is not copied into memi.
 
 See [`NOTICE`](./NOTICE) for source links and attribution details.
 
@@ -394,13 +394,13 @@ memi upgrade
 | Linux (x86_64)          | `memi-linux-x64.tar.gz`          |
 | Windows (x64)           | `memi-win-x64.zip`               |
 
-Verify with `SHA256SUMS.txt` (attached to every release). Extract, add `memi` to PATH, run `memi connect`. The `skills/`, `notes/`, `plugin/`, `preview/` directories must stay next to the binary — Mémoire loads them at runtime.
+Verify with `SHA256SUMS.txt` (attached to every release). Extract, add `memi` to PATH, run `memi connect`. The `skills/`, `notes/`, `plugin/`, `preview/` directories must stay next to the binary — memi loads them at runtime.
 
 ---
 
 ## Advanced: Use with AI agents
 
-Memoire can install native agent kits and also run as an MCP server, so your AI assistant can work directly with your design system after the registry workflow is in place. Use `memi agent install --dry-run --json` to inspect every write before installing. For copy-paste prompts and client-specific setup, see [`docs/AGENT_RECIPES.md`](./docs/AGENT_RECIPES.md).
+memi can install native agent kits and also run as an MCP server, so your AI assistant can work directly with your design system after the registry workflow is in place. Use `memi agent install --dry-run --json` to inspect every write before installing. For copy-paste prompts and client-specific setup, see [`docs/AGENT_RECIPES.md`](./docs/AGENT_RECIPES.md).
 
 ```bash
 memi suite init --project .              # writes memoire.agent.yaml
@@ -501,7 +501,7 @@ npm run check:public-release
 | `memi sync` | Full sync: Figma + specs + code |
 | `memi sync --live` | Watch and sync continuously |
 | `memi compose "<intent>"` | Agent orchestrator: classify, plan, execute |
-| `memi agent install [target]` | Install Memoire agent kits for Hermes, OpenClaw, Claude Code, Cursor, Codex, Codex plugin, or OpenCode |
+| `memi agent install [target]` | Install memi agent kits for Hermes, OpenClaw, Claude Code, Cursor, Codex, Codex plugin, or OpenCode |
 | `memi agent spawn <role>` | Spawn a persistent agent worker |
 | `memi daemon start|status|stop` | Manage the shared local runtime for CLI, Studio, MCP, and agent adapters |
 | `memi suite init|doctor|run <recipe>` | Manage `memoire.agent.yaml` product-team suite recipes |

From f000d6eaefcc34820a4aa08f84a2c87b956ad5b4 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Mon, 11 May 2026 23:18:06 -0500
Subject: [PATCH 3/7] fix(cli): rename Commander program from "memoire" to
 "memi"
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

\`memi --help\` was printing \`Usage: memoire [options] [command]\` because
the Commander program name was never updated during the rebrand. First-time
users running --help after \`npm i -g @memi-design/cli\` saw the old brand.

Also updated the program description from the old "Diagnose and improve real
web apps..." to the new tagline that matches package.json:
"Design-system memory for coding agents — pull tokens from Figma, generate
shadcn-native components, audit Tailwind apps".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 src/index.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/index.ts b/src/index.ts
index 7012fd8..1e0a130 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -160,8 +160,8 @@ process.on("unhandledRejection", (reason) => {
 const program = new Command();
 
 program
-  .name("memoire")
-  .description("Diagnose and improve real web apps, then package the design system as an installable registry")
+  .name("memi")
+  .description("Design-system memory for coding agents — pull tokens from Figma, generate shadcn-native components, audit Tailwind apps")
   .version(packageVersion);
 
 // Create engine instance (shared across commands)

From 3ec6fcbe4d2b7e654a17f5571f3ac03c87198514 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Tue, 12 May 2026 21:50:48 -0500
Subject: [PATCH 4/7] chore(release): prepare memi 1.0.1 distribution

---
 .github/workflows/release-binaries.yml        |   6 +-
 README.md                                     |  27 +-
 docs/GITHUB_ACHIEVEMENTS.md                   |   4 +-
 docs/GROWTH_TO_1M_NPM.md                      |  88 ++++
 docs/OFFICIAL_MCP_REGISTRY.md                 |   6 +-
 docs/README.md                                |   1 +
 docs/STARSTRUCK.md                            |   4 +-
 scripts/check-public-release-gate.mjs         |   2 +-
 scripts/growth-status.mjs                     | 202 +--------
 scripts/homebrew/memoire.rb.template          |  10 +-
 scripts/install.ps1                           |   2 +-
 scripts/install.sh                            |   4 +-
 scripts/lib/growth-status.mjs                 | 406 ++++++++++++++++++
 scripts/publish-ready.mjs                     |   2 +-
 scripts/verify-npm-release.mjs                |   2 +-
 src/studio/__tests__/config.test.ts           |   5 +-
 .../__tests__/growth-status-script.test.ts    | 113 +++++
 src/studio/__tests__/harness-manifest.test.ts |  19 +
 src/studio/__tests__/harnesses.test.ts        |   5 +-
 src/studio/__tests__/server.test.ts           |  63 ++-
 src/studio/harness-manifest.json              |  10 +-
 src/studio/rpc/server.ts                      |   2 +
 src/studio/server.ts                          | 145 +++++++
 src/studio/types.ts                           |   2 +
 24 files changed, 889 insertions(+), 241 deletions(-)
 create mode 100644 docs/GROWTH_TO_1M_NPM.md
 create mode 100644 scripts/lib/growth-status.mjs
 create mode 100644 src/studio/__tests__/growth-status-script.test.ts

diff --git a/.github/workflows/release-binaries.yml b/.github/workflows/release-binaries.yml
index a388df8..38735d1 100644
--- a/.github/workflows/release-binaries.yml
+++ b/.github/workflows/release-binaries.yml
@@ -122,8 +122,8 @@ jobs:
           build-args: |
             VERSION=${{ github.ref_name }}
           tags: |
-            ghcr.io/sarveshsea/memoire:latest
-            ghcr.io/sarveshsea/memoire:${{ github.ref_name }}
+            ghcr.io/sarveshsea/memi:latest
+            ghcr.io/sarveshsea/memi:${{ github.ref_name }}
 
   publish-homebrew:
     needs: publish-checksums
@@ -150,7 +150,7 @@ jobs:
             echo "HOMEBREW_TAP_TOKEN secret not configured — skipping tap push"
             exit 0
           fi
-          git clone "https://x-access-token:${GH_TOKEN}@github.com/sarveshsea/homebrew-memoire.git" tap
+          git clone "https://x-access-token:${GH_TOKEN}@github.com/sarveshsea/homebrew-memi.git" tap
           mkdir -p tap/Formula
           cp memoire.rb tap/Formula/memoire.rb
           cd tap
diff --git a/README.md b/README.md
index 0420be8..8bdc5f8 100644
--- a/README.md
+++ b/README.md
@@ -95,26 +95,23 @@ See [`docs/CODEX_PLUGIN.md`](./docs/CODEX_PLUGIN.md) and the public plugin page
 
 ### memi Studio for macOS
 
-memi includes a Studio app: a macOS agent workbench and local web shell for Claude Code, Codex, Hermes, OpenCode, Ollama, Gemini, memi Native, project memory, the Figma bridge, and an in-app Marketplace for memi Notes. The desktop app includes a native Agent Kits panel so you can dry-run, install, and force-refresh Hermes/OpenClaw/Claude/Cursor/Codex/OpenCode kits without leaving Studio. Studio and the CLI share the same daemon-aware install path, suite manifest, project memory, harness metadata, and MCP startup guidance.
+The macOS app now lives in its own repo: [github.com/sarveshsea/memi-studio](https://github.com/sarveshsea/memi-studio). This npm package owns the engine/runtime it embeds: harness metadata, project memory, the Figma bridge, Agent Kits, and the local Studio web/TUI surfaces. The desktop app stays minimalist; the engine stays powerful and scriptable.
 
 ```bash
-# web/TUI workflows from npm
+# engine-backed web/TUI workflows from npm
 memi studio web --port 1422
 memi studio tui
 memi studio logs --follow
 memi studio run --harness codex --action design-doc --prompt "Audit this UI and generate a design spec"
 
-# local macOS app build
-npm run studio:build
-open "apps/studio/src-tauri/target/release/bundle/dmg/Mémoire Studio_0.16.3_aarch64.dmg"
-
-# signed and notarized direct DMG release
-npm run studio:release:macos
-
 memi video create "Launch story" --adapter remotion --prompt "Product motion system"
 ```
 
-Tagged GitHub Releases attach signed and notarized DMGs when Apple release secrets are configured. See [docs/STUDIO_MACOS_RELEASE.md](docs/STUDIO_MACOS_RELEASE.md).
+Download the signed macOS app from [memi-studio releases](https://github.com/sarveshsea/memi-studio/releases/latest), or install it with Homebrew:
+
+```bash
+brew install --cask sarveshsea/memi/memi-studio
+```
 
 ### Product Scenario Lab
 
@@ -320,14 +317,12 @@ Studio runs Claude Code, Codex, Hermes, Ollama, OpenCode, Gemini, and memi Nativ
 
 Studio also includes a Notes Marketplace that lists built-in Notes, installed workspace Notes, and installable packages from the repo-owned `notes/*/note.json` manifests. The Marketplace uses the same Notes installer logic as `memi notes`, so installed packs become normal `.memoire/notes` project memory and agent context.
 
-The desktop app source lives in `apps/studio`. Build output stays out of git under `apps/studio/src-tauri/target`; tagged GitHub Releases attach the downloadable macOS DMGs, for example `Mémoire Studio_0.16.3_aarch64.dmg`. For a local build, run:
+The desktop app source lives in [sarveshsea/memi-studio](https://github.com/sarveshsea/memi-studio). This repo keeps the packaged runtime, harness contract, CLI commands, and `memi studio web|tui|logs|run` compatibility layer. Public DMGs are attached to [memi-studio releases](https://github.com/sarveshsea/memi-studio/releases/latest), and the cask is maintained in [sarveshsea/homebrew-memi](https://github.com/sarveshsea/homebrew-memi).
 
 ```bash
-npm run studio:build
+brew install --cask sarveshsea/memi/memi-studio
 ```
 
-For public direct-download DMGs, use the signed/notarized release gate in [docs/STUDIO_MACOS_RELEASE.md](docs/STUDIO_MACOS_RELEASE.md).
-
 Motion/video work is native in 0.15 through optional Remotion and HyperFrames adapters. `memi video create|preview|render` stores projects under `.memoire/videos` without making either video tool a hard dependency.
 
 Warp is used as a product reference for terminal blocks and grouped command output. Only MIT-licensed Warp UI framework pieces such as `warpui_core` and `warpui` are considered for adaptation; Warp AGPL application/client code is not copied into memi.
@@ -376,10 +371,10 @@ curl -fsSL https://memoire.cv/install.sh | sh
 irm https://memoire.cv/install.ps1 | iex
 
 # Homebrew (macOS / Linux)
-brew install sarveshsea/memoire/memoire
+brew install sarveshsea/memi/memoire
 
 # Docker (air-gapped envs where only ghcr.io is reachable)
-docker run --rm -it -v "$PWD:/work" -w /work ghcr.io/sarveshsea/memoire --help
+docker run --rm -it -v "$PWD:/work" -w /work ghcr.io/sarveshsea/memi --help
 
 # Self-update once installed
 memi upgrade
diff --git a/docs/GITHUB_ACHIEVEMENTS.md b/docs/GITHUB_ACHIEVEMENTS.md
index 557e855..7e2cb1a 100644
--- a/docs/GITHUB_ACHIEVEMENTS.md
+++ b/docs/GITHUB_ACHIEVEMENTS.md
@@ -51,8 +51,8 @@ Immediate sequence:
 
 The official MCP Registry verifies npm package ownership through `package.json#mcpName`. The already-published `0.14.3` package includes this field; `0.14.4` adds trust hardening before registry submission.
 
-- `package.json#mcpName`: `io.github.sarveshsea/memoire`
-- `server.json#name`: `io.github.sarveshsea/memoire`
+- `package.json#mcpName`: `io.github.sarveshsea/memi`
+- `server.json#name`: `io.github.sarveshsea/memi`
 - `server.json#packages[0].identifier`: `@memi-design/cli`
 - `server.json#packages[0].packageArguments`: `mcp`
 
diff --git a/docs/GROWTH_TO_1M_NPM.md b/docs/GROWTH_TO_1M_NPM.md
new file mode 100644
index 0000000..f53c64e
--- /dev/null
+++ b/docs/GROWTH_TO_1M_NPM.md
@@ -0,0 +1,88 @@
+# Growth To 1M Weekly NPM Downloads
+
+Updated: 2026-05-13
+
+## North Star
+
+Get `@memi-design/cli` to 1,000,000 npm downloads per week by making the engine the thing people install, script, embed, and recommend. Studio should demonstrate the engine and make agent work calmer; it should not become the main product surface or the main source of complexity.
+
+## Current Truth
+
+- Public npm package: `@memi-design/cli@1.0.0`; local release branch: `1.0.1`.
+- npm downloads: 128 in the last reported week, 2026-05-05 through 2026-05-11.
+- Legacy alias: `@sarveshsea/memoire@0.18.0` still exists and receives more traffic than the new package.
+- GitHub repo: `sarveshsea/memi`, 10 stars, 2 forks, 2 open issues.
+- Studio repo: `sarveshsea/memi-studio`, public app repo with v1.0.0 release assets.
+- Homebrew cask: `sarveshsea/homebrew-memi`, `memi-studio` cask at v1.0.0.
+- Official MCP Registry: not listed for `io.github.sarveshsea/memi`.
+- Active leak: old `m-moire` and `@sarveshsea/memoire` references confuse discovery, install paths, and trust.
+
+Run the live check:
+
+```bash
+node scripts/growth-status.mjs --json
+```
+
+## Product Posture
+
+The engine must be the default answer:
+
+- `memi diagnose` for existing apps.
+- `memi tokens --from ./src --report` for token extraction.
+- `memi shadcn export --out public/r` for installable registries.
+- `memi agent install ...` for agent-native design-system memory.
+- `memi mcp start --no-figma` for MCP discovery.
+
+The macOS app should be minimalist:
+
+- One primary job: run and supervise agent harnesses clearly.
+- Two primary harnesses: Codex and Claude Code.
+- Everything else is advanced until users ask for it.
+- Surfaces should collapse toward transcript, artifacts, status, and project memory.
+- No feature earns first-screen space unless it helps the first successful engine-backed run.
+
+## Growth Loops
+
+1. Release correctness
+
+Publish `1.0.1`, verify npm metadata, verify binary install URLs, and keep Homebrew formulas pointed at `sarveshsea/memi`.
+
+2. Naming cleanup
+
+Remove or quarantine stale `m-moire` and `@sarveshsea/memoire` references across docs, install scripts, package metadata, and the Studio repo. The old package should clearly redirect people to `@memi-design/cli`.
+
+3. Registry distribution
+
+Submit `server.json` to the Official MCP Registry once npm is current. Keep merged directory PRs accurate, close stale ones, and resubmit with the `memi` name where needed.
+
+4. Agent-native adoption
+
+Make Codex, Claude Code, Cursor, and shadcn/v0 workflows the shortest path in README examples. The README should sell the engine wedge before Studio.
+
+5. Repeatable proof
+
+Ship examples that users can run in under two minutes:
+
+```bash
+memi diagnose
+memi tokens --from ./src --report
+memi shadcn export --out public/r
+```
+
+## Milestone Ladder
+
+- 1,000 weekly downloads: release/package/install paths are clean; README examples work from a fresh machine.
+- 10,000 weekly downloads: MCP registry, shadcn/v0 examples, Codex plugin, and Homebrew paths all agree on naming.
+- 100,000 weekly downloads: templates and starter registries are discoverable from npm, GitHub, and docs without Studio.
+- 1,000,000 weekly downloads: downstream agents, templates, registries, and docs install `@memi-design/cli` as infrastructure.
+
+## Keep The App Tidy
+
+Do not let Studio compete with the engine. Treat it as a native workbench for the same runtime:
+
+- Primary navigation: Workbench, Artifacts, Memory, Settings.
+- Primary session path: choose harness, choose workspace, send prompt, watch events, review artifacts.
+- Advanced drawers: marketplace, scenario lab, video, Figma, automations, local model setup.
+- Default harness visibility: Codex and Claude Code only.
+- Every advanced feature needs a CLI/runtime equivalent.
+
diff --git a/docs/OFFICIAL_MCP_REGISTRY.md b/docs/OFFICIAL_MCP_REGISTRY.md
index f590e6e..68486a9 100644
--- a/docs/OFFICIAL_MCP_REGISTRY.md
+++ b/docs/OFFICIAL_MCP_REGISTRY.md
@@ -8,7 +8,7 @@ The Official MCP Registry hosts metadata, not package artifacts. For npm package
 
 Memoire uses:
 
-- MCP server name: `io.github.sarveshsea/memoire`
+- MCP server name: `io.github.sarveshsea/memi`
 - npm package: `@memi-design/cli`
 - transport: `stdio`
 - package argument: `mcp`
@@ -34,7 +34,7 @@ npm view @memi-design/cli version mcpName --json
 
 mcp-publisher login github
 mcp-publisher publish server.json
-curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memoire"
+curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memi"
 ```
 
 Expected registry result after publish:
@@ -43,7 +43,7 @@ Expected registry result after publish:
 {
   "servers": [
     {
-      "name": "io.github.sarveshsea/memoire"
+      "name": "io.github.sarveshsea/memi"
     }
   ]
 }
diff --git a/docs/README.md b/docs/README.md
index 5153459..af89e41 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -83,6 +83,7 @@ memi add Button --from @you/theme
 - Launch copy: [`docs/LAUNCH.md`](./LAUNCH.md)
 - Social launch posts: [`docs/SOCIAL.md`](./SOCIAL.md)
 - Weekly growth scorecard: [`docs/METRICS.md`](./METRICS.md)
+- 1M/week npm operating brief: [`docs/GROWTH_TO_1M_NPM.md`](./GROWTH_TO_1M_NPM.md)
 - Full package overview: [`README.md`](../README.md)
 
 ## Advanced
diff --git a/docs/STARSTRUCK.md b/docs/STARSTRUCK.md
index c884edf..8210a67 100644
--- a/docs/STARSTRUCK.md
+++ b/docs/STARSTRUCK.md
@@ -47,7 +47,7 @@ Then publish to the official MCP Registry:
 ```bash
 mcp-publisher login github
 mcp-publisher publish server.json
-curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memoire"
+curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memi"
 ```
 
 Why this matters: the official registry only hosts metadata, but MCP directories and aggregators use it as a trust source. Once this is live, submit or refresh every MCP directory with the same npm/GitHub links.
@@ -90,7 +90,7 @@ Why this matters: the official registry only hosts metadata, but MCP directories
 ## Launch Sequence For 12 Stars
 
 1. Publish `0.14.4` with security hardening, `mcpName`, and `server.json`.
-2. Publish to the official MCP Registry and verify search returns `io.github.sarveshsea/memoire`.
+2. Publish to the official MCP Registry and verify search returns `io.github.sarveshsea/memi`.
 3. Submit MCP.Directory, refresh Glama, submit Smithery, confirm PulseMCP and mcp.so indexing.
 4. Follow up on open PRs only with new proof: official registry link, security hardening, or maintainer-requested fixes.
 5. Ship one 60-second terminal demo: install, `memi diagnose`, `memi shadcn export`, `memi mcp config --install`.
diff --git a/scripts/check-public-release-gate.mjs b/scripts/check-public-release-gate.mjs
index d08c2bb..0b4faef 100644
--- a/scripts/check-public-release-gate.mjs
+++ b/scripts/check-public-release-gate.mjs
@@ -9,7 +9,7 @@ const pkg = JSON.parse(await readFile(new URL("../package.json", import.meta.url
 
 const packageName = process.env.PACKAGE_NAME || pkg.name;
 const expectedVersion = process.env.EXPECTED_VERSION || pkg.version;
-const expectedPhrase = process.env.EXPECTED_README_PHRASE || "Shadcn-native Design CI for Tailwind apps";
+const expectedPhrase = process.env.EXPECTED_README_PHRASE || "Design-system memory for coding agents";
 const expectedInstall = process.env.EXPECTED_INSTALL_COMMAND || `npm i -g ${packageName}`;
 const skipInstall = process.env.SKIP_INSTALL_SMOKE === "1";
 
diff --git a/scripts/growth-status.mjs b/scripts/growth-status.mjs
index 40df6a1..2b407ac 100644
--- a/scripts/growth-status.mjs
+++ b/scripts/growth-status.mjs
@@ -3,214 +3,16 @@
 import { readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { buildGrowthStatus, printHuman } from "./lib/growth-status.mjs";
 
 const root = join(dirname(fileURLToPath(import.meta.url)), "..");
 const packageJson = JSON.parse(await readFile(join(root, "package.json"), "utf-8"));
 const json = process.argv.includes("--json");
-const now = new Date().toISOString();
 
-const directoryPullRequests = [
-  ["punkpeye/awesome-mcp-servers", 4373],
-  ["TensorBlock/awesome-mcp-servers", 455],
-  ["YuzeHao2023/Awesome-MCP-Servers", 208],
-  ["MobinX/awesome-mcp-list", 241],
-  ["toolsdk-ai/toolsdk-mcp-registry", 296],
-  ["bytefer/awesome-shadcn-ui", 18],
-  ["birobirobiro/awesome-shadcn-ui", 493],
-];
-
-const [
-  npmMetadata,
-  weeklyDownloads,
-  monthlyDownloads,
-  githubRepo,
-  registrySearch,
-  safeSkillPr,
-  directoryStatuses,
-] = await Promise.all([
-  getNpmMetadata(),
-  fetchJson("https://api.npmjs.org/downloads/point/last-week/%40sarveshsea%2Fmemoire"),
-  fetchJson("https://api.npmjs.org/downloads/point/last-month/%40sarveshsea%2Fmemoire"),
-  fetchJson("https://api.github.com/repos/sarveshsea/memi"),
-  fetchJson("https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memoire"),
-  fetchJson("https://api.github.com/repos/sarveshsea/memi/pulls/2"),
-  Promise.all(directoryPullRequests.map(async ([repo, number]) => {
-    const pull = await fetchJson(`https://api.github.com/repos/${repo}/pulls/${number}`);
-    return {
-      repo,
-      number,
-      url: `https://github.com/${repo}/pull/${number}`,
-      state: summarizePullState(pull),
-      title: pull.ok === false ? null : pull.title,
-      updatedAt: pull.ok === false ? null : pull.updated_at,
-    };
-  })),
-]);
-
-const status = {
-  generatedAt: now,
-  package: {
-    name: packageJson.name,
-    localVersion: packageJson.version,
-    mcpName: packageJson.mcpName,
-  },
-  npm: normalizeNpmMetadata(npmMetadata),
-  downloads: {
-    weekly: normalizeDownloadPoint(weeklyDownloads),
-    monthly: normalizeDownloadPoint(monthlyDownloads),
-  },
-  github: normalizeRepo(githubRepo),
-  officialMcpRegistry: normalizeRegistry(registrySearch),
-  safeSkill: normalizeSafeSkillPr(safeSkillPr),
-  directoryPullRequests: directoryStatuses,
-  nextActions: buildNextActions({ npmMetadata, registrySearch, safeSkillPr, githubRepo }),
-};
+const status = await buildGrowthStatus({ packageJson, root });
 
 if (json) {
   console.log(JSON.stringify(status, null, 2));
 } else {
   printHuman(status);
 }
-
-async function getNpmMetadata() {
-  const encoded = encodeURIComponent(packageJson.name).replace(/^%40/, "%40");
-  return fetchJson(`https://registry.npmjs.org/${encoded}`);
-}
-
-async function fetchJson(url) {
-  try {
-    const headers = {
-      "Accept": "application/json",
-      "User-Agent": "Memoire-GrowthStatus/1.0",
-    };
-    if (process.env.GITHUB_TOKEN && url.includes("api.github.com")) {
-      headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
-    }
-    const response = await fetch(url, {
-      headers,
-      signal: AbortSignal.timeout(12_000),
-    });
-    const body = await response.text();
-    const payload = body ? JSON.parse(body) : null;
-    if (!response.ok) {
-      return { ok: false, status: response.status, error: payload?.message ?? response.statusText, url };
-    }
-    return payload;
-  } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err), url };
-  }
-}
-
-function normalizeNpmMetadata(metadata) {
-  if (metadata.ok === false) return { ok: false, error: metadata.error };
-  const latest = metadata["dist-tags"]?.latest;
-  const version = latest ? metadata.versions?.[latest] : null;
-  return {
-    ok: true,
-    latest,
-    mcpName: version?.mcpName ?? null,
-    description: version?.description ?? metadata.description ?? null,
-    npmUrl: "https://www.npmjs.com/package/@memi-design/cli",
-  };
-}
-
-function normalizeDownloadPoint(point) {
-  if (point.ok === false) return { ok: false, error: point.error };
-  return {
-    ok: true,
-    downloads: point.downloads,
-    start: point.start,
-    end: point.end,
-  };
-}
-
-function normalizeRepo(repo) {
-  if (repo.ok === false) return { ok: false, error: repo.error };
-  return {
-    ok: true,
-    stars: repo.stargazers_count,
-    forks: repo.forks_count,
-    openIssues: repo.open_issues_count,
-    description: repo.description,
-    topics: repo.topics ?? [],
-    url: repo.html_url,
-  };
-}
-
-function normalizeRegistry(search) {
-  if (search.ok === false) return { ok: false, listed: false, count: 0, error: search.error };
-  const servers = Array.isArray(search.servers) ? search.servers : [];
-  return {
-    ok: true,
-    listed: servers.some((server) => server.name === "io.github.sarveshsea/memoire"),
-    count: search.metadata?.count ?? servers.length,
-    url: "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memoire",
-  };
-}
-
-function normalizeSafeSkillPr(pull) {
-  if (pull.ok === false) return { ok: false, error: pull.error };
-  const scoreMatch = `${pull.title ?? ""}\n${pull.body ?? ""}`.match(/(\d+)\/100/);
-  return {
-    ok: true,
-    number: pull.number,
-    state: summarizePullState(pull),
-    title: pull.title,
-    score: scoreMatch ? Number(scoreMatch[1]) : null,
-    url: pull.html_url,
-  };
-}
-
-function summarizePullState(pull) {
-  if (pull.ok === false) return "unknown";
-  if (pull.merged_at) return "merged";
-  return pull.state ?? "unknown";
-}
-
-function buildNextActions({ npmMetadata, registrySearch, safeSkillPr, githubRepo }) {
-  const actions = [];
-  const npm = normalizeNpmMetadata(npmMetadata);
-  const registry = normalizeRegistry(registrySearch);
-  const safeSkill = normalizeSafeSkillPr(safeSkillPr);
-  const repo = normalizeRepo(githubRepo);
-
-  if (npm.ok && npm.latest !== packageJson.version) {
-    actions.push(`Publish ${packageJson.version} to npm; npm latest is ${npm.latest}.`);
-  }
-  if (registry.ok && !registry.listed) {
-    actions.push("Publish server.json to the Official MCP Registry after npm is current.");
-  }
-  if (safeSkill.ok && safeSkill.state === "open") {
-    actions.push("Do not merge the SafeSkill blocked badge; address findings or close after replacement proof.");
-  }
-  if (repo.ok && repo.stars < 16) {
-    actions.push(`Starstruck needs ${16 - repo.stars} more real stars.`);
-  }
-  return actions;
-}
-
-function printHuman(status) {
-  console.log(`Memoire Growth Status (${status.generatedAt})`);
-  console.log("");
-  console.log(`Package: ${status.package.name}@${status.package.localVersion}`);
-  console.log(`npm: ${status.npm.ok ? `${status.npm.latest} · ${status.npm.mcpName ?? "no mcpName"}` : `error: ${status.npm.error}`}`);
-  console.log(`Downloads: ${formatDownloads(status.downloads.weekly, "weekly")} · ${formatDownloads(status.downloads.monthly, "monthly")}`);
-  console.log(`GitHub: ${status.github.ok ? `${status.github.stars} stars · ${status.github.forks} forks · ${status.github.openIssues} open issues` : `error: ${status.github.error}`}`);
-  console.log(`Official MCP Registry: ${status.officialMcpRegistry.listed ? "listed" : "not listed"} (${status.officialMcpRegistry.count} result${status.officialMcpRegistry.count === 1 ? "" : "s"})`);
-  console.log(`SafeSkill PR: ${status.safeSkill.ok ? `#${status.safeSkill.number} ${status.safeSkill.state}${status.safeSkill.score !== null ? ` · ${status.safeSkill.score}/100` : ""}` : `error: ${status.safeSkill.error}`}`);
-  console.log("");
-  console.log("Directory PRs:");
-  for (const pull of status.directoryPullRequests) {
-    console.log(`- ${pull.repo}#${pull.number}: ${pull.state}${pull.title ? ` · ${pull.title}` : ""}`);
-  }
-  console.log("");
-  console.log("Next:");
-  for (const action of status.nextActions) {
-    console.log(`- ${action}`);
-  }
-}
-
-function formatDownloads(point, label) {
-  if (!point.ok) return `${label} error`;
-  return `${point.downloads} ${label} (${point.start}..${point.end})`;
-}
diff --git a/scripts/homebrew/memoire.rb.template b/scripts/homebrew/memoire.rb.template
index 67bffc4..86f698f 100644
--- a/scripts/homebrew/memoire.rb.template
+++ b/scripts/homebrew/memoire.rb.template
@@ -1,8 +1,8 @@
 # Homebrew formula template for Mémoire
 #
 # This file is a TEMPLATE. CI fills in @VERSION@ and @SHA_*@ placeholders on
-# every release and pushes the result to the homebrew-memoire tap repo.
-# Users install with:  brew install sarveshsea/memoire/memoire
+# every release and pushes the result to the homebrew-memi tap repo.
+# Users install with:  brew install sarveshsea/memi/memoire
 #
 class Memoire < Formula
   desc "Registry-first CLI for publishing Figma design systems as installable packages"
@@ -12,18 +12,18 @@ class Memoire < Formula
 
   on_macos do
     on_arm do
-      url "https://github.com/sarveshsea/m-moire/releases/download/v@VERSION@/memi-darwin-arm64.tar.gz"
+      url "https://github.com/sarveshsea/memi/releases/download/v@VERSION@/memi-darwin-arm64.tar.gz"
       sha256 "@SHA_DARWIN_ARM64@"
     end
     on_intel do
-      url "https://github.com/sarveshsea/m-moire/releases/download/v@VERSION@/memi-darwin-x64.tar.gz"
+      url "https://github.com/sarveshsea/memi/releases/download/v@VERSION@/memi-darwin-x64.tar.gz"
       sha256 "@SHA_DARWIN_X64@"
     end
   end
 
   on_linux do
     on_intel do
-      url "https://github.com/sarveshsea/m-moire/releases/download/v@VERSION@/memi-linux-x64.tar.gz"
+      url "https://github.com/sarveshsea/memi/releases/download/v@VERSION@/memi-linux-x64.tar.gz"
       sha256 "@SHA_LINUX_X64@"
     end
   end
diff --git a/scripts/install.ps1 b/scripts/install.ps1
index 17e25b2..db22dc7 100644
--- a/scripts/install.ps1
+++ b/scripts/install.ps1
@@ -13,7 +13,7 @@ param(
 
 $ErrorActionPreference = "Stop"
 
-$repo = "sarveshsea/m-moire"
+$repo = "sarveshsea/memi"
 $target = "win-x64"
 $archive = "memi-$target.zip"
 
diff --git a/scripts/install.sh b/scripts/install.sh
index 603ebb8..9dd497e 100755
--- a/scripts/install.sh
+++ b/scripts/install.sh
@@ -11,7 +11,7 @@
 
 set -eu
 
-REPO="sarveshsea/m-moire"
+REPO="sarveshsea/memi"
 INSTALL_DIR="${HOME}/.memoire"
 VERSION="latest"
 PATCH_PATH=1
@@ -36,7 +36,7 @@ case "${uname_s}-${uname_m}" in
   Linux-x86_64)            target="linux-x64" ;;
   Linux-aarch64|Linux-arm64)
     echo "error: linux-arm64 not yet published." >&2
-    echo "  Try:  docker run --rm -it ghcr.io/sarveshsea/memoire --help" >&2
+    echo "  Try:  docker run --rm -it ghcr.io/sarveshsea/memi --help" >&2
     exit 1 ;;
   *)
     echo "error: unsupported platform ${uname_s}-${uname_m}" >&2
diff --git a/scripts/lib/growth-status.mjs b/scripts/lib/growth-status.mjs
new file mode 100644
index 0000000..defc4a6
--- /dev/null
+++ b/scripts/lib/growth-status.mjs
@@ -0,0 +1,406 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+
+export const LEGACY_PACKAGE_ALIASES = ["@sarveshsea/memoire"];
+export const STUDIO_REPO = "sarveshsea/memi-studio";
+export const ENGINE_REPO = "sarveshsea/memi";
+export const HOMEBREW_STUDIO_CASK_URL = "https://raw.githubusercontent.com/sarveshsea/homebrew-memi/main/Casks/memi-studio.rb";
+export const DEFAULT_STALE_REFERENCE_PATTERNS = ["m-moire", "@sarveshsea/memoire", "MiroFish"];
+export const WEEKLY_NPM_DOWNLOAD_TARGET = 1_000_000;
+
+export const DEFAULT_DIRECTORY_PULL_REQUESTS = [
+  ["punkpeye/awesome-mcp-servers", 4373],
+  ["TensorBlock/awesome-mcp-servers", 455],
+  ["YuzeHao2023/Awesome-MCP-Servers", 208],
+  ["MobinX/awesome-mcp-list", 241],
+  ["toolsdk-ai/toolsdk-mcp-registry", 296],
+  ["bytefer/awesome-shadcn-ui", 18],
+  ["birobirobiro/awesome-shadcn-ui", 493],
+];
+
+export function actualDownloadPointUrl(packageName, period) {
+  return `https://api.npmjs.org/downloads/point/${period}/${encodeURIComponent(packageName).replace(/^%40/, "%40")}`;
+}
+
+export async function buildGrowthStatus(options = {}) {
+  const packageJson = options.packageJson;
+  if (!packageJson?.name || !packageJson?.version) {
+    throw new Error("buildGrowthStatus requires packageJson.name and packageJson.version");
+  }
+
+  const fetchJson = options.fetchJson ?? defaultFetchJson;
+  const fetchText = options.fetchText ?? defaultFetchText;
+  const now = options.now ?? (() => new Date());
+  const directoryPullRequests = options.directoryPullRequests ?? DEFAULT_DIRECTORY_PULL_REQUESTS;
+
+  const [
+    npmMetadata,
+    weeklyDownloads,
+    monthlyDownloads,
+    githubRepo,
+    registrySearch,
+    safeSkillPr,
+    directoryStatuses,
+    studioLatestRelease,
+    homebrewCaskRaw,
+    legacyAliasDownloads,
+    staleReferenceSources,
+  ] = await Promise.all([
+    fetchJson(`https://registry.npmjs.org/${encodeURIComponent(packageJson.name).replace(/^%40/, "%40")}`),
+    fetchJson(actualDownloadPointUrl(packageJson.name, "last-week")),
+    fetchJson(actualDownloadPointUrl(packageJson.name, "last-month")),
+    fetchJson(`https://api.github.com/repos/${ENGINE_REPO}`),
+    fetchJson(`https://registry.modelcontextprotocol.io/v0.1/servers?search=${encodeURIComponent(packageJson.mcpName ?? packageJson.name)}`),
+    fetchJson(`https://api.github.com/repos/${ENGINE_REPO}/pulls/2`),
+    Promise.all(directoryPullRequests.map(async ([repo, number]) => {
+      const pull = await fetchJson(`https://api.github.com/repos/${repo}/pulls/${number}`);
+      return {
+        repo,
+        number,
+        url: `https://github.com/${repo}/pull/${number}`,
+        state: summarizePullState(pull),
+        title: pull.ok === false ? null : pull.title,
+        updatedAt: pull.ok === false ? null : pull.updated_at,
+      };
+    })),
+    fetchJson(`https://api.github.com/repos/${STUDIO_REPO}/releases/latest`),
+    fetchText(HOMEBREW_STUDIO_CASK_URL),
+    Promise.all(LEGACY_PACKAGE_ALIASES.map(async (name) => ({
+      name,
+      weekly: normalizeDownloadPoint(await fetchJson(actualDownloadPointUrl(name, "last-week"))),
+      monthly: normalizeDownloadPoint(await fetchJson(actualDownloadPointUrl(name, "last-month"))),
+    }))),
+    options.staleReferenceSources ?? loadDefaultStaleReferenceSources(options.root),
+  ]);
+
+  const actualPackageDownloads = {
+    name: packageJson.name,
+    weekly: normalizeDownloadPoint(weeklyDownloads),
+    monthly: normalizeDownloadPoint(monthlyDownloads),
+  };
+  const npm = normalizeNpmMetadata(npmMetadata, packageJson.name);
+  const officialMcpRegistry = normalizeRegistry(registrySearch, packageJson.mcpName);
+  const safeSkill = normalizeSafeSkillPr(safeSkillPr);
+  const github = normalizeRepo(githubRepo);
+  const studio = normalizeStudioRelease(studioLatestRelease);
+  const homebrewStudioCask = parseHomebrewStudioCask(homebrewCaskRaw);
+  const staleReferences = collectStaleReferenceMetrics(staleReferenceSources);
+  const weeklyNpmDownloads = buildWeeklyNpmDownloadGoal(
+    actualPackageDownloads.weekly,
+    options.weeklyNpmDownloadTarget ?? WEEKLY_NPM_DOWNLOAD_TARGET,
+  );
+
+  return {
+    generatedAt: now().toISOString(),
+    package: {
+      name: packageJson.name,
+      localVersion: packageJson.version,
+      mcpName: packageJson.mcpName,
+    },
+    npm,
+    downloads: {
+      weekly: actualPackageDownloads.weekly,
+      monthly: actualPackageDownloads.monthly,
+      actualPackage: actualPackageDownloads,
+      legacyAliases: legacyAliasDownloads,
+    },
+    growth: {
+      weeklyNpmDownloads,
+    },
+    github,
+    studio,
+    homebrewStudioCask,
+    officialMcpRegistry,
+    safeSkill,
+    directoryPullRequests: directoryStatuses,
+    staleReferences,
+    nextActions: buildNextActions({
+      packageJson,
+      npm,
+      officialMcpRegistry,
+      safeSkill,
+      github,
+      staleReferences,
+      homebrewStudioCask,
+      studio,
+      weeklyNpmDownloads,
+    }),
+  };
+}
+
+export function printHuman(status) {
+  console.log(`Memoire Growth Status (${status.generatedAt})`);
+  console.log("");
+  console.log(`Package: ${status.package.name}@${status.package.localVersion}`);
+  console.log(`npm: ${status.npm.ok ? `${status.npm.latest} · ${status.npm.mcpName ?? "no mcpName"}` : `error: ${status.npm.error}`}`);
+  console.log(`Downloads: ${formatDownloads(status.downloads.actualPackage.weekly, "weekly")} · ${formatDownloads(status.downloads.actualPackage.monthly, "monthly")}`);
+  if (status.growth?.weeklyNpmDownloads) {
+    const goal = status.growth.weeklyNpmDownloads;
+    console.log(`1M/week target: ${formatNumber(goal.current)} / ${formatNumber(goal.target)} (${formatPercent(goal.percentToTarget)} · ${formatNumber(goal.gap)} gap · ${formatMultiple(goal.multipleToTarget)} to target)`);
+  }
+  for (const alias of status.downloads.legacyAliases) {
+    console.log(`Legacy alias ${alias.name}: ${formatDownloads(alias.weekly, "weekly")} · ${formatDownloads(alias.monthly, "monthly")}`);
+  }
+  console.log(`GitHub: ${status.github.ok ? `${status.github.stars} stars · ${status.github.forks} forks · ${status.github.openIssues} open issues` : `error: ${status.github.error}`}`);
+  console.log(`Studio release: ${status.studio.ok ? `${status.studio.latestRelease.tag} · ${status.studio.latestRelease.totalDownloads} downloads` : `error: ${status.studio.error}`}`);
+  console.log(`Homebrew Studio cask: ${status.homebrewStudioCask.version ?? "unknown"}`);
+  console.log(`Official MCP Registry: ${status.officialMcpRegistry.listed ? "listed" : "not listed"} (${status.officialMcpRegistry.count} result${status.officialMcpRegistry.count === 1 ? "" : "s"})`);
+  console.log(`SafeSkill PR: ${status.safeSkill.ok ? `#${status.safeSkill.number} ${status.safeSkill.state}${status.safeSkill.score !== null ? ` · ${status.safeSkill.score}/100` : ""}` : `error: ${status.safeSkill.error}`}`);
+  console.log(`Stale references: ${status.staleReferences.total}`);
+  console.log("");
+  console.log("Directory PRs:");
+  for (const pull of status.directoryPullRequests) {
+    console.log(`- ${pull.repo}#${pull.number}: ${pull.state}${pull.title ? ` · ${pull.title}` : ""}`);
+  }
+  console.log("");
+  console.log("Next:");
+  for (const action of status.nextActions) {
+    console.log(`- ${action}`);
+  }
+}
+
+export function parseHomebrewStudioCask(raw) {
+  const name = raw.match(/cask\s+"([^"]+)"/)?.[1] ?? null;
+  const version = raw.match(/version\s+"([^"]+)"/)?.[1] ?? null;
+  const releaseUrls = [...raw.matchAll(/url\s+"([^"]+)"/g)].map((match) => match[1]);
+  return { name, version, releaseUrls };
+}
+
+export function collectStaleReferenceMetrics(sources = {}) {
+  const byPattern = Object.fromEntries(DEFAULT_STALE_REFERENCE_PATTERNS.map((pattern) => [pattern, 0]));
+  const byFile = {};
+  let total = 0;
+
+  for (const [file, content] of Object.entries(sources)) {
+    let fileTotal = 0;
+    for (const pattern of DEFAULT_STALE_REFERENCE_PATTERNS) {
+      const count = countOccurrences(String(content), pattern);
+      byPattern[pattern] += count;
+      fileTotal += count;
+    }
+    if (fileTotal > 0) byFile[file] = fileTotal;
+    total += fileTotal;
+  }
+
+  return { total, byPattern, byFile };
+}
+
+export function buildWeeklyNpmDownloadGoal(point, target = WEEKLY_NPM_DOWNLOAD_TARGET) {
+  const current = point?.ok ? Number(point.downloads ?? 0) : 0;
+  const normalizedTarget = Math.max(0, Number(target) || 0);
+  const gap = Math.max(0, normalizedTarget - current);
+  return {
+    target: normalizedTarget,
+    current,
+    gap,
+    achieved: current >= normalizedTarget,
+    percentToTarget: normalizedTarget > 0 ? current / normalizedTarget : null,
+    multipleToTarget: current > 0 ? normalizedTarget / current : null,
+    start: point?.start ?? null,
+    end: point?.end ?? null,
+  };
+}
+
+async function loadDefaultStaleReferenceSources(root) {
+  if (!root) return {};
+  const candidates = [
+    "README.md",
+    "docs/README.md",
+    "docs/SUBMISSIONS.md",
+    "scripts/install.sh",
+    "scripts/install.ps1",
+    "src/studio/agent-envelope.ts",
+    "src/simulation/mirofish-adapter.ts",
+  ];
+  const entries = await Promise.all(candidates.map(async (file) => {
+    try {
+      return [file, await readFile(join(root, file), "utf-8")];
+    } catch {
+      return [file, ""];
+    }
+  }));
+  return Object.fromEntries(entries);
+}
+
+async function defaultFetchJson(url) {
+  try {
+    const headers = {
+      "Accept": "application/json",
+      "User-Agent": "Memoire-GrowthStatus/1.1",
+    };
+    if (process.env.GITHUB_TOKEN && url.includes("api.github.com")) {
+      headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+    }
+    const response = await fetch(url, {
+      headers,
+      signal: AbortSignal.timeout(12_000),
+    });
+    const body = await response.text();
+    const payload = body ? JSON.parse(body) : null;
+    if (!response.ok) {
+      return { ok: false, status: response.status, error: payload?.message ?? response.statusText, url };
+    }
+    return payload;
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err), url };
+  }
+}
+
+async function defaultFetchText(url) {
+  try {
+    const response = await fetch(url, {
+      headers: { "User-Agent": "Memoire-GrowthStatus/1.1" },
+      signal: AbortSignal.timeout(12_000),
+    });
+    if (!response.ok) return "";
+    return response.text();
+  } catch {
+    return "";
+  }
+}
+
+function normalizeNpmMetadata(metadata, packageName) {
+  if (metadata.ok === false) return { ok: false, error: metadata.error };
+  const latest = metadata["dist-tags"]?.latest;
+  const version = latest ? metadata.versions?.[latest] : null;
+  return {
+    ok: true,
+    latest,
+    mcpName: version?.mcpName ?? null,
+    description: version?.description ?? metadata.description ?? null,
+    npmUrl: `https://www.npmjs.com/package/${packageName}`,
+  };
+}
+
+function normalizeDownloadPoint(point) {
+  if (point.ok === false) return { ok: false, error: point.error };
+  return {
+    ok: true,
+    downloads: Number(point.downloads ?? 0),
+    start: point.start ?? null,
+    end: point.end ?? null,
+  };
+}
+
+function normalizeRepo(repo) {
+  if (repo.ok === false) return { ok: false, error: repo.error };
+  return {
+    ok: true,
+    stars: repo.stargazers_count,
+    forks: repo.forks_count,
+    openIssues: repo.open_issues_count,
+    description: repo.description,
+    topics: repo.topics ?? [],
+    url: repo.html_url,
+  };
+}
+
+function normalizeRegistry(search, serverName) {
+  if (search.ok === false) return { ok: false, listed: false, count: 0, error: search.error };
+  const servers = Array.isArray(search.servers) ? search.servers : [];
+  return {
+    ok: true,
+    listed: servers.some((server) => server.name === serverName),
+    count: search.metadata?.count ?? servers.length,
+    url: `https://registry.modelcontextprotocol.io/v0.1/servers?search=${encodeURIComponent(serverName ?? "")}`,
+  };
+}
+
+function normalizeSafeSkillPr(pull) {
+  if (pull.ok === false) return { ok: false, error: pull.error };
+  const scoreMatch = `${pull.title ?? ""}\n${pull.body ?? ""}`.match(/(\d+)\/100/);
+  return {
+    ok: true,
+    number: pull.number,
+    state: summarizePullState(pull),
+    title: pull.title,
+    score: scoreMatch ? Number(scoreMatch[1]) : null,
+    url: pull.html_url,
+  };
+}
+
+function normalizeStudioRelease(release) {
+  if (release.ok === false) return { ok: false, error: release.error };
+  const assets = (release.assets ?? []).map((asset) => ({
+    name: asset.name,
+    size: asset.size,
+    downloadCount: asset.download_count ?? 0,
+    url: asset.browser_download_url,
+  }));
+  return {
+    ok: true,
+    latestRelease: {
+      tag: release.tag_name,
+      name: release.name,
+      publishedAt: release.published_at,
+      totalDownloads: assets.reduce((sum, asset) => sum + asset.downloadCount, 0),
+      assets,
+    },
+  };
+}
+
+function summarizePullState(pull) {
+  if (pull.ok === false) return "unknown";
+  if (pull.merged_at) return "merged";
+  return pull.state ?? "unknown";
+}
+
+function buildNextActions(input) {
+  const actions = [];
+  if (input.npm.ok && input.npm.latest !== input.packageJson.version) {
+    actions.push(`Publish ${input.packageJson.version} to npm; npm latest is ${input.npm.latest}.`);
+  }
+  if (input.officialMcpRegistry.ok && !input.officialMcpRegistry.listed) {
+    actions.push("Publish server.json to the Official MCP Registry after npm is current.");
+  }
+  if (input.safeSkill.ok && input.safeSkill.state === "open") {
+    actions.push("Do not merge the SafeSkill blocked badge; address findings or close after replacement proof.");
+  }
+  if (input.github.ok && input.github.stars < 16) {
+    actions.push(`Starstruck needs ${16 - input.github.stars} more real stars.`);
+  }
+  if (input.staleReferences.total > 0) {
+    actions.push(`Clear or intentionally quarantine ${input.staleReferences.total} stale naming/reference hit${input.staleReferences.total === 1 ? "" : "s"}.`);
+  }
+  if (input.homebrewStudioCask.version && input.studio.ok && input.studio.latestRelease.tag && `v${input.homebrewStudioCask.version}` !== input.studio.latestRelease.tag) {
+    actions.push(`Update the Homebrew Studio cask from ${input.homebrewStudioCask.version} to ${input.studio.latestRelease.tag}.`);
+  }
+  if (input.weeklyNpmDownloads && !input.weeklyNpmDownloads.achieved) {
+    actions.push(`Close the 1M/week npm gap: ${formatNumber(input.weeklyNpmDownloads.gap)} more weekly downloads needed for ${input.packageJson.name}.`);
+  }
+  return actions;
+}
+
+function formatDownloads(point, label) {
+  if (!point.ok) return `${label} error`;
+  return `${point.downloads} ${label} (${point.start}..${point.end})`;
+}
+
+function formatNumber(value) {
+  return Number(value ?? 0).toLocaleString("en-US");
+}
+
+function formatPercent(value) {
+  if (value === null || value === undefined) return "n/a";
+  if (value === 0) return "0%";
+  const percentage = value * 100;
+  return `${percentage < 0.01 ? percentage.toFixed(4) : percentage.toFixed(2)}%`;
+}
+
+function formatMultiple(value) {
+  if (value === null || value === undefined) return "n/a";
+  return `${value >= 100 ? Math.round(value).toLocaleString("en-US") : value.toFixed(1)}x`;
+}
+
+function countOccurrences(value, needle) {
+  if (!needle) return 0;
+  let count = 0;
+  let offset = 0;
+  while (offset < value.length) {
+    const index = value.indexOf(needle, offset);
+    if (index === -1) break;
+    count += 1;
+    offset = index + needle.length;
+  }
+  return count;
+}
diff --git a/scripts/publish-ready.mjs b/scripts/publish-ready.mjs
index 7441fe7..230853e 100644
--- a/scripts/publish-ready.mjs
+++ b/scripts/publish-ready.mjs
@@ -18,7 +18,7 @@ const serverJson = await readJson("server.json");
 
 check(packageJson.name === "@memi-design/cli", `package name is ${packageJson.name}`);
 check(packageJson.version === serverJson.version, `server.json version ${serverJson.version} does not match package.json ${packageJson.version}`);
-check(packageJson.mcpName === "io.github.sarveshsea/memoire", `package.json mcpName is ${packageJson.mcpName}`);
+check(packageJson.mcpName === "io.github.sarveshsea/memi", `package.json mcpName is ${packageJson.mcpName}`);
 check(serverJson.name === packageJson.mcpName, `server.json name ${serverJson.name} does not match package.json mcpName ${packageJson.mcpName}`);
 for (const lifecycle of ["preinstall", "install", "postinstall", "prepare"]) {
   check(!packageJson.scripts?.[lifecycle], `package.json must not define npm lifecycle script "${lifecycle}" for the public package`);
diff --git a/scripts/verify-npm-release.mjs b/scripts/verify-npm-release.mjs
index 0074d2e..3f01e04 100644
--- a/scripts/verify-npm-release.mjs
+++ b/scripts/verify-npm-release.mjs
@@ -9,7 +9,7 @@ const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf-8"));
 
 const packageName = process.env.PACKAGE_NAME || pkg.name;
 const expectedVersion = process.env.EXPECTED_VERSION || pkg.version;
-const expectedPhrase = process.env.EXPECTED_README_PHRASE || "Design CI for shadcn/Tailwind apps";
+const expectedPhrase = process.env.EXPECTED_README_PHRASE || "Design-system memory for coding agents";
 const expectedInstall = process.env.EXPECTED_INSTALL_COMMAND || `npm i -g ${packageName}`;
 const attempts = Number.parseInt(process.env.NPM_VERIFY_ATTEMPTS || "12", 10);
 const delayMs = Number.parseInt(process.env.NPM_VERIFY_DELAY_MS || "10000", 10);
diff --git a/src/studio/__tests__/config.test.ts b/src/studio/__tests__/config.test.ts
index e977af8..af15b9c 100644
--- a/src/studio/__tests__/config.test.ts
+++ b/src/studio/__tests__/config.test.ts
@@ -42,7 +42,10 @@ describe("studio config", () => {
       expect(config.harnesses.filter((harness) => harness.enabled).map((harness) => harness.id)).toEqual([
         "claude-code",
         "codex",
-        "hermes",
+      ]);
+      expect(config.harnesses.filter((harness) => harness.visibility === "primary").map((harness) => harness.id)).toEqual([
+        "claude-code",
+        "codex",
       ]);
       expect(config.permissions).toMatchObject({
         workspaceWrite: "allow",
diff --git a/src/studio/__tests__/growth-status-script.test.ts b/src/studio/__tests__/growth-status-script.test.ts
new file mode 100644
index 0000000..af056b9
--- /dev/null
+++ b/src/studio/__tests__/growth-status-script.test.ts
@@ -0,0 +1,113 @@
+// @ts-nocheck
+import { describe, expect, it } from "vitest";
+import {
+  actualDownloadPointUrl,
+  buildWeeklyNpmDownloadGoal,
+  buildGrowthStatus,
+  collectStaleReferenceMetrics,
+  parseHomebrewStudioCask,
+} from "../../../scripts/lib/growth-status.mjs";
+
+describe("growth status script contract", () => {
+  it("tracks downloads for the real public npm package, not the legacy alias", () => {
+    expect(actualDownloadPointUrl("@memi-design/cli", "last-week")).toBe("https://api.npmjs.org/downloads/point/last-week/%40memi-design%2Fcli");
+    expect(actualDownloadPointUrl("@sarveshsea/memoire", "last-week")).toBe("https://api.npmjs.org/downloads/point/last-week/%40sarveshsea%2Fmemoire");
+  });
+
+  it("parses the Studio Homebrew cask version and release URLs", () => {
+    const cask = parseHomebrewStudioCask(`
+      cask "memi-studio" do
+        version "1.0.0"
+        url "https://github.com/sarveshsea/memi-studio/releases/download/v#{version}/Memoire.Studio_#{version}_aarch64.dmg"
+      end
+    `);
+
+    expect(cask).toEqual({
+      name: "memi-studio",
+      version: "1.0.0",
+      releaseUrls: ["https://github.com/sarveshsea/memi-studio/releases/download/v#{version}/Memoire.Studio_#{version}_aarch64.dmg"],
+    });
+  });
+
+  it("reports actual package, Studio release, Homebrew, and stale aliases separately", async () => {
+    const calls: string[] = [];
+    const status = await buildGrowthStatus({
+      packageJson: {
+        name: "@memi-design/cli",
+        version: "1.0.1",
+        mcpName: "io.github.sarveshsea/memi",
+      },
+      now: () => new Date("2026-05-13T00:00:00.000Z"),
+      fetchJson: async (url: string) => {
+        calls.push(url);
+        if (url.includes("registry.npmjs.org")) {
+          return { "dist-tags": { latest: "1.0.0" }, versions: { "1.0.0": { mcpName: "io.github.sarveshsea/memi" } } };
+        }
+        if (url.includes("downloads/point/last-week/%40memi-design%2Fcli")) return { downloads: 128, start: "2026-05-05", end: "2026-05-11" };
+        if (url.includes("downloads/point/last-month/%40memi-design%2Fcli")) return { downloads: 256, start: "2026-04-12", end: "2026-05-11" };
+        if (url.includes("downloads/point/last-week/%40sarveshsea%2Fmemoire")) return { downloads: 979, start: "2026-05-05", end: "2026-05-11" };
+        if (url.includes("downloads/point/last-month/%40sarveshsea%2Fmemoire")) return { downloads: 2232, start: "2026-04-12", end: "2026-05-11" };
+        if (url.includes("repos/sarveshsea/memi-studio/releases/latest")) {
+          return {
+            tag_name: "v1.0.0",
+            published_at: "2026-05-10T20:58:22Z",
+            assets: [{ name: "Memoire.Studio_1.0.0_aarch64.dmg", download_count: 3 }],
+          };
+        }
+        if (url.includes("repos/sarveshsea/memi")) return { stargazers_count: 10, forks_count: 2, open_issues_count: 2, html_url: "https://github.com/sarveshsea/memi", topics: [] };
+        if (url.includes("registry.modelcontextprotocol.io")) return { servers: [], metadata: { count: 0 } };
+        if (url.includes("/pulls/")) return { state: "open", number: 1, title: "PR", html_url: url, updated_at: "2026-05-13T00:00:00Z" };
+        return {};
+      },
+      fetchText: async () => `cask "memi-studio" do\n  version "1.0.0"\nend\n`,
+      directoryPullRequests: [],
+      staleReferenceSources: {
+        "README.md": "m-moire @sarveshsea/memoire MiroFish",
+        "docs/README.md": "clean",
+      },
+    });
+
+    expect(calls).toContain("https://api.npmjs.org/downloads/point/last-week/%40memi-design%2Fcli");
+    expect(status.downloads.actualPackage.weekly.downloads).toBe(128);
+    expect(status.growth.weeklyNpmDownloads).toMatchObject({
+      target: 1_000_000,
+      current: 128,
+      gap: 999_872,
+      achieved: false,
+    });
+    expect(status.downloads.legacyAliases[0].weekly.downloads).toBe(979);
+    expect(status.studio.latestRelease).toMatchObject({ tag: "v1.0.0", totalDownloads: 3 });
+    expect(status.homebrewStudioCask).toMatchObject({ version: "1.0.0" });
+    expect(status.staleReferences.total).toBe(3);
+  });
+
+  it("counts stale package and repo references without mixing them into downloads", () => {
+    expect(collectStaleReferenceMetrics({
+      "README.md": "m-moire @sarveshsea/memoire MiroFish",
+      "docs/ok.md": "memi-studio",
+    })).toEqual({
+      total: 3,
+      byPattern: {
+        "m-moire": 1,
+        "@sarveshsea/memoire": 1,
+        "MiroFish": 1,
+      },
+      byFile: {
+        "README.md": 3,
+      },
+    });
+  });
+
+  it("computes the weekly npm download gap without hiding zero-download launches", () => {
+    expect(buildWeeklyNpmDownloadGoal({ ok: true, downloads: 0, start: "2026-05-05", end: "2026-05-11" }, 1_000_000)).toEqual({
+      target: 1_000_000,
+      current: 0,
+      gap: 1_000_000,
+      achieved: false,
+      percentToTarget: 0,
+      multipleToTarget: null,
+      start: "2026-05-05",
+      end: "2026-05-11",
+    });
+  });
+});
diff --git a/src/studio/__tests__/harness-manifest.test.ts b/src/studio/__tests__/harness-manifest.test.ts
index e41db67..3554ea0 100644
--- a/src/studio/__tests__/harness-manifest.test.ts
+++ b/src/studio/__tests__/harness-manifest.test.ts
@@ -40,7 +40,26 @@ describe("studio harness manifest", () => {
     expect(manifest.harnesses.filter((harness) => harness.enabledByDefault).map((harness) => harness.id)).toEqual([
       "claude-code",
       "codex",
+    ]);
+  });
+
+  it("marks Codex and Claude Code as the only primary Studio harnesses", () => {
+    const manifest = getHarnessManifest();
+    const primaryHarnesses = manifest.harnesses.filter((harness) => harness.visibility === "primary");
+    const advancedHarnesses = manifest.harnesses.filter((harness) => harness.visibility === "advanced");
+
+    expect(primaryHarnesses.map((harness) => harness.id)).toEqual(["claude-code", "codex"]);
+    expect(advancedHarnesses.map((harness) => harness.id)).toEqual([
+      "memoire",
+      "opencode",
+      "gemini",
+      "ollama",
       "hermes",
+      "shell",
+    ]);
+    expect(defaultStudioConfig("/tmp/project").harnesses.filter((harness) => harness.visibility === "primary").map((harness) => harness.id)).toEqual([
+      "claude-code",
+      "codex",
     ]);
   });
 
diff --git a/src/studio/__tests__/harnesses.test.ts b/src/studio/__tests__/harnesses.test.ts
index 73291e0..e823467 100644
--- a/src/studio/__tests__/harnesses.test.ts
+++ b/src/studio/__tests__/harnesses.test.ts
@@ -219,7 +219,10 @@ describe("studio harnesses", () => {
 
   it("enables Hermes toolsets for memory, skills, terminal, and file-backed design work", () => {
     const root = "/tmp/project";
-    const config = defaultStudioConfig(root);
+    const config = {
+      ...defaultStudioConfig(root),
+      harnesses: defaultStudioConfig(root).harnesses.map((harness) => harness.id === "hermes" ? { ...harness, enabled: true } : harness),
+    };
     const command = buildHarnessCommand(config, {
       harnessId: "hermes",
       cwd: root,
diff --git a/src/studio/__tests__/server.test.ts b/src/studio/__tests__/server.test.ts
index 167ac77..1bf0523 100644
--- a/src/studio/__tests__/server.test.ts
+++ b/src/studio/__tests__/server.test.ts
@@ -1,4 +1,4 @@
-import { mkdtemp, rm } from "node:fs/promises";
+import { chmod, mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { afterEach, describe, expect, it } from "vitest";
@@ -89,4 +89,65 @@ describe("studio runtime server", () => {
       await rm(root, { recursive: true, force: true });
     }
   });
+
+  it("journals Codex sessions as ProviderRuntimeEvents and replays them through /api/rpc", async () => {
+    const root = await mkdtemp(join(tmpdir(), "memoire-studio-rpc-"));
+    const bin = join(root, "bin");
+    const oldPath = process.env.PATH;
+    try {
+      await mkdir(bin, { recursive: true });
+      const codex = join(bin, "codex");
+      await writeFile(codex, "#!/bin/sh\necho '{\"type\":\"agent_message\",\"message\":\"done\"}'\n");
+      await chmod(codex, 0o755);
+      process.env.PATH = `${bin}:${oldPath ?? ""}`;
+
+      const server = new StudioRuntimeServer({ projectRoot: root, port: 0 });
+      servers.push(server);
+      const runtime = await server.start();
+
+      const created = await fetch(`${runtime.url}/api/sessions`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          harness: "codex",
+          cwd: root,
+          prompt: "hello",
+          action: "raw",
+        }),
+      }).then((res) => res.json());
+
+      await waitFor(() => server.getSession(created.session.id)?.status === "completed");
+      const rpc = await fetch(`${runtime.url}/api/rpc`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          op: "replayEvents",
+          requestId: "r1",
+          sessionId: created.session.id,
+        }),
+      }).then((res) => res.json());
+
+      const eventTypes = rpc.responses
+        .filter((response: { kind: string }) => response.kind === "event")
+        .map((response: { event: { type: string } }) => response.event.type);
+      expect(eventTypes).toEqual(expect.arrayContaining([
+        "message.user",
+        "session.created",
+        "turn.completed",
+      ]));
+      expect(rpc.responses.some((response: { kind: string }) => response.kind === "end")).toBe(true);
+    } finally {
+      process.env.PATH = oldPath;
+      await rm(root, { recursive: true, force: true });
+    }
+  });
 });
+
+async function waitFor(check: () => boolean, timeoutMs = 3_000): Promise<void> {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (check()) return;
+    await new Promise((resolve) => setTimeout(resolve, 20));
+  }
+  throw new Error("Timed out waiting for condition");
+}
diff --git a/src/studio/harness-manifest.json b/src/studio/harness-manifest.json
index 430e0bc..467ca54 100644
--- a/src/studio/harness-manifest.json
+++ b/src/studio/harness-manifest.json
@@ -26,6 +26,7 @@
       "provider": "memoire",
       "command": "memi",
       "description": "Run the current Mémoire design intelligence engine.",
+      "visibility": "advanced",
       "enabledByDefault": false,
       "installProbe": ["memi", "memoire"],
       "capabilities": ["compose", "design-doc", "audit", "references", "video", "raw", "app-build", "self-design", "research", "simulate", "fix", "browser-audit", "handoff"],
@@ -57,6 +58,7 @@
       "provider": "anthropic",
       "command": "claude",
       "description": "Delegate to Claude Code when installed.",
+      "visibility": "primary",
       "docsUrl": "https://code.claude.com/docs/en/cli-reference",
       "enabledByDefault": true,
       "installProbe": ["claude"],
@@ -118,6 +120,7 @@
       "provider": "openai",
       "command": "codex",
       "description": "Run OpenAI Codex as the primary GPT-5.5 design-oriented repository agent.",
+      "visibility": "primary",
       "docsUrl": "https://developers.openai.com/codex/cli",
       "enabledByDefault": true,
       "installProbe": ["codex"],
@@ -180,6 +183,7 @@
       "provider": "openai",
       "command": "opencode",
       "description": "Delegate to OpenCode when installed.",
+      "visibility": "advanced",
       "enabledByDefault": false,
       "installProbe": ["opencode"],
       "capabilities": ["compose", "audit", "raw", "app-build", "self-design", "research", "simulate", "fix", "browser-audit", "handoff"],
@@ -201,6 +205,7 @@
       "provider": "google",
       "command": "gemini",
       "description": "Delegate to Gemini CLI when installed.",
+      "visibility": "advanced",
       "enabledByDefault": false,
       "installProbe": ["gemini"],
       "capabilities": ["compose", "audit", "raw", "app-build", "self-design", "research", "simulate", "fix", "browser-audit", "handoff"],
@@ -222,6 +227,7 @@
       "provider": "local",
       "command": "ollama",
       "description": "Run a local Ollama model as an agent harness.",
+      "visibility": "advanced",
       "enabledByDefault": false,
       "installProbe": ["ollama"],
       "capabilities": ["compose", "raw", "app-build", "self-design", "research", "simulate", "fix", "browser-audit", "handoff"],
@@ -243,7 +249,8 @@
       "provider": "local",
       "command": "hermes",
       "description": "Run Hermes Agent in one-shot mode with local workspace context.",
-      "enabledByDefault": true,
+      "visibility": "advanced",
+      "enabledByDefault": false,
       "installProbe": ["hermes"],
       "capabilities": ["compose", "audit", "raw", "app-build", "self-design", "research", "simulate", "fix", "browser-audit", "handoff"],
       "commandTemplates": {
@@ -264,6 +271,7 @@
       "provider": "shell",
       "command": "sh",
       "description": "Trusted shell execution, disabled by default.",
+      "visibility": "advanced",
       "enabledByDefault": false,
       "installProbe": ["sh"],
       "capabilities": ["raw"],
diff --git a/src/studio/rpc/server.ts b/src/studio/rpc/server.ts
index 7848dc2..4546f9d 100644
--- a/src/studio/rpc/server.ts
+++ b/src/studio/rpc/server.ts
@@ -227,12 +227,14 @@ export class RpcServer {
           sub.push({ kind: "event", requestId: req.requestId, event });
         }
         sub.push({ kind: "end", requestId: req.requestId, reason: "replay-complete" });
+        sub.close();
       } catch (error) {
         sub.push({
           kind: "error",
           requestId: req.requestId,
           error: `replay failed: ${error instanceof Error ? error.message : String(error)}`,
         });
+        sub.close();
       }
     })();
     return sub;
diff --git a/src/studio/server.ts b/src/studio/server.ts
index 0a13511..a7ad5f0 100644
--- a/src/studio/server.ts
+++ b/src/studio/server.ts
@@ -74,6 +74,10 @@ import { StudioDownloadStore } from "./downloads.js";
 import { StudioToolBroker } from "./tool-broker.js";
 import { buildSessionReferenceTrace } from "./reference-trace.js";
 import { createStudioTraceSnapshot } from "./view-model.js";
+import { asId, makeId } from "./contracts/ids.js";
+import type { ProviderRuntimeEvent } from "./contracts/provider-runtime.js";
+import { FileEventJournal } from "./journal/event-journal.js";
+import { RpcServer } from "./rpc/server.js";
 import { FileSimulationStore } from "../simulation/index.js";
 import type { ResearchStore } from "../research/engine.js";
 import {
@@ -162,7 +166,9 @@ export class StudioRuntimeServer {
   private readonly toolBroker: StudioToolBroker;
   private readonly automations: StudioAutomationStore;
   private readonly downloads: StudioDownloadStore;
+  private readonly eventJournal: FileEventJournal;
   private readonly toolCalls = new Map<string, StudioToolCallResult>();
+  private readonly providerEventSeq = new Map<string, number>();
   private readonly startedAt = Date.now();
   private readonly activeStreams = new Set<string>();
   private eventBufferSize = 0;
@@ -177,6 +183,7 @@ export class StudioRuntimeServer {
     this.sessionStore = new StudioSessionStore(this.projectRoot);
     this.automations = new StudioAutomationStore(this.projectRoot);
     this.downloads = new StudioDownloadStore(this.projectRoot);
+    this.eventJournal = new FileEventJournal(this.projectRoot);
     this.browser = new StudioBrowserAdapter({ projectRoot: this.projectRoot });
     this.computer = new StudioComputerAdapter({ projectRoot: this.projectRoot });
     this.figma = options.figma ?? new StudioFigmaController({
@@ -421,6 +428,28 @@ export class StudioRuntimeServer {
       return;
     }
 
+    if (req.method === "POST" && url.pathname === "/api/rpc") {
+      const body = normalizeRpcRequestSessionId(await readJSON(req));
+      const rpc = new RpcServer({
+        journal: this.eventJournal,
+        resolver: {
+          resolveDriver: () => null,
+          resolveHarnessId: (sessionId) => {
+            const key = studioSessionKeyFromProviderSessionId(sessionId as unknown as string);
+            const session = this.sessions.get(key) ?? this.sessionStore.getSession(key);
+            return session ? asId("HarnessId", `hns_${session.harness}`) : null;
+          },
+          createDriver: () => {
+            throw new Error("Live ProviderRuntime drivers are not mounted on the legacy Studio server yet");
+          },
+        },
+      });
+      const responses: unknown[] = [];
+      for await (const response of rpc.dispatch(body)) responses.push(response);
+      this.sendJSON(res, 200, { responses });
+      return;
+    }
+
     if (req.method === "POST" && url.pathname === "/api/tools/call") {
       const body = await readJSON<StudioToolCallRequest>(req);
       const call = await this.toolBroker.call(body);
@@ -1585,6 +1614,10 @@ export class StudioRuntimeServer {
     if (session.events.length > this.maxInMemoryEvents) session.events.splice(0, session.events.length - this.maxInMemoryEvents);
     this.eventBufferSize = Math.min(200_000, this.eventBufferSize + event.message.length);
     this.sessionStore.appendEvent(session, event);
+    const providerEvent = this.providerRuntimeEventFromStudioEvent(session, event);
+    if (providerEvent) {
+      void this.eventJournal.append(providerEvent.sessionId, providerEvent).catch(() => undefined);
+    }
     if (shouldCaptureKnowledgeEvent(event)) {
       void captureKnowledgeEvent(this.projectRoot, event, {
         harness: session.harness,
@@ -1619,6 +1652,81 @@ export class StudioRuntimeServer {
     }
   }
 
+  private providerRuntimeEventFromStudioEvent(session: StudioSession, event: StudioEvent): ProviderRuntimeEvent | null {
+    if (session.harness !== "codex" && session.harness !== "claude-code") return null;
+    const base = {
+      eventId: providerRuntimeId("EventId", event.id),
+      seq: this.nextProviderEventSeq(session.id),
+      harnessId: asId("HarnessId", `hns_${session.harness}`),
+      providerInstanceId: asId("ProviderInstanceId", `prv_${session.id}`),
+      sessionId: providerRuntimeId("SessionId", session.id),
+      createdAt: event.timestamp,
+    };
+    const message = redactSecrets(event.message ?? "");
+
+    if (event.type === "session_started") {
+      return {
+        ...base,
+        type: "session.created",
+        harnessConfigSummary: {
+          harness: base.harnessId,
+          model: session.harness === "codex" ? "gpt-5.5" : undefined,
+        },
+      };
+    }
+    if (event.type === "chat_message") return { ...base, type: "message.user", text: message };
+    if (event.type === "reasoning") return { ...base, type: "reasoning.complete", text: message };
+    if (event.type === "tool_call") {
+      const data = isRecord(event.data) ? event.data : {};
+      return {
+        ...base,
+        type: "tool.call.started",
+        toolCallId: providerRuntimeId("ToolCallId", data.id ?? data.callId),
+        tool: String(data.name ?? data.tool ?? data.toolId ?? (message || "tool")),
+        args: data.input ?? data.args ?? data,
+      };
+    }
+    if (event.type === "tool_result") {
+      const data = isRecord(event.data) ? event.data : {};
+      return {
+        ...base,
+        type: "tool.call.completed",
+        toolCallId: providerRuntimeId("ToolCallId", data.id ?? data.callId ?? data.toolUseId),
+        ok: data.ok !== false,
+        result: data.output ?? data.result ?? message,
+        error: typeof data.error === "string" ? data.error : undefined,
+        elapsedMs: numberField(data.elapsedMs) ?? 0,
+      };
+    }
+    if (event.type === "token_usage") {
+      const data = isRecord(event.data) ? event.data : {};
+      return {
+        ...base,
+        type: "usage.updated",
+        inputTokens: numberField(data.inputTokens) ?? numberField(data.input_tokens) ?? 0,
+        outputTokens: numberField(data.outputTokens) ?? numberField(data.output_tokens) ?? 0,
+        reasoningTokens: numberField(data.reasoningTokens) ?? numberField(data.reasoning_tokens) ?? undefined,
+        estimatedCostUsd: numberField(data.estimatedCostUsd) ?? numberField(data.estimated_cost_usd) ?? undefined,
+      };
+    }
+    if (event.type === "session_done") {
+      return { ...base, type: "turn.completed", outcome: session.status === "cancelled" ? "cancelled" : "success" };
+    }
+    if (event.type === "session_error" || event.type === "stderr") {
+      return { ...base, type: "diagnostic.error", message, data: event.data };
+    }
+    if (event.type === "stdout" || event.type === "harness_log" || event.type === "package_log") {
+      return { ...base, type: "diagnostic.warn", message, data: event.data };
+    }
+    return null;
+  }
+
+  private nextProviderEventSeq(sessionId: string): number {
+    const next = (this.providerEventSeq.get(sessionId) ?? 0) + 1;
+    this.providerEventSeq.set(sessionId, next);
+    return next;
+  }
+
   private emitToolCallEvents(request: StudioToolCallRequest, call: StudioToolCallResult): void {
     if (!request.sessionId || !this.sessions.has(request.sessionId)) return;
     this.addEvent(request.sessionId, "tool_call", request.toolId, {
@@ -1828,6 +1936,43 @@ function canonicalPath(path: string): string {
   }
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function numberField(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function normalizeRpcRequestSessionId(body: unknown): unknown {
+  if (!isRecord(body) || typeof body.sessionId !== "string") return body;
+  return { ...body, sessionId: providerRuntimeId("SessionId", body.sessionId) };
+}
+
+function studioSessionKeyFromProviderSessionId(sessionId: string): string {
+  return sessionId.startsWith("ses_") ? sessionId.slice("ses_".length) : sessionId;
+}
+
+const RUNTIME_ID_PREFIXES = {
+  EventId: "evt",
+  SessionId: "ses",
+  ToolCallId: "tcl",
+} as const;
+
+function providerRuntimeId<K extends keyof typeof RUNTIME_ID_PREFIXES>(kind: K, raw: unknown): ReturnType<typeof makeId<K>> {
+  const prefix = RUNTIME_ID_PREFIXES[kind];
+  if (typeof raw === "string" && raw.startsWith(`${prefix}_`)) {
+    return asId(kind, raw) as ReturnType<typeof makeId<K>>;
+  }
+  if (typeof raw !== "string" || !raw.trim()) return makeId(kind);
+  return asId(kind, `${prefix}_${safeRuntimeIdSuffix(raw)}`) as ReturnType<typeof makeId<K>>;
+}
+
+function safeRuntimeIdSuffix(raw: string): string {
+  const suffix = raw.trim().replace(/[^A-Za-z0-9._:-]/g, "_").slice(0, 160);
+  return suffix || randomUUID().replace(/-/g, "");
+}
+
 function summarySession(
   session: StudioSession,
   source: "live" | "persisted" = "live",
diff --git a/src/studio/types.ts b/src/studio/types.ts
index a83023c..d231634 100644
--- a/src/studio/types.ts
+++ b/src/studio/types.ts
@@ -9,6 +9,7 @@ export type StudioHarnessId =
   | "shell";
 
 export type StudioHarnessKind = "memoire" | "external-cli" | "local-model" | "shell";
+export type StudioHarnessVisibility = "primary" | "advanced";
 export type StudioRunAction =
   | "compose"
   | "design-doc"
@@ -135,6 +136,7 @@ export interface StudioHarnessManifestEntry {
   provider: StudioHarnessProvider;
   command: string;
   description: string;
+  visibility: StudioHarnessVisibility;
   enabledByDefault: boolean;
   installProbe: string[];
   capabilities: StudioRunAction[];

From a17823ee83bd1083341884d040465c54fd146824 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Tue, 12 May 2026 21:51:30 -0500
Subject: [PATCH 5/7] ci: add MCP registry publish workflow

---
 .github/workflows/publish-mcp-registry.yml | 41 ++++++++++++++++++++++
 docs/OFFICIAL_MCP_REGISTRY.md              |  2 ++
 2 files changed, 43 insertions(+)
 create mode 100644 .github/workflows/publish-mcp-registry.yml

diff --git a/.github/workflows/publish-mcp-registry.yml b/.github/workflows/publish-mcp-registry.yml
new file mode 100644
index 0000000..e7ef5c6
--- /dev/null
+++ b/.github/workflows/publish-mcp-registry.yml
@@ -0,0 +1,41 @@
+name: Publish to MCP Registry
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Verify npm package is published
+        run: |
+          LOCAL_VERSION="$(node -p "require('./package.json').version")"
+          PUBLISHED_VERSION="$(npm view @memi-design/cli@"${LOCAL_VERSION}" version)"
+          if [ "${PUBLISHED_VERSION}" != "${LOCAL_VERSION}" ]; then
+            echo "::error::@memi-design/cli@${LOCAL_VERSION} is not available on npm"
+            exit 1
+          fi
+          node -e "const p=require('./package.json'); const s=require('./server.json'); if (p.mcpName !== s.name) throw new Error('mcpName/server.json mismatch');"
+
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+          ./mcp-publisher --help
+
+      - name: Validate server.json
+        run: ./mcp-publisher validate server.json
+
+      - name: Authenticate to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish server.json
+        run: ./mcp-publisher publish server.json
diff --git a/docs/OFFICIAL_MCP_REGISTRY.md b/docs/OFFICIAL_MCP_REGISTRY.md
index 68486a9..88ff16f 100644
--- a/docs/OFFICIAL_MCP_REGISTRY.md
+++ b/docs/OFFICIAL_MCP_REGISTRY.md
@@ -37,6 +37,8 @@ mcp-publisher publish server.json
 curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sarveshsea/memi"
 ```
 
+CI can publish without a local registry token through the `Publish to MCP Registry` GitHub Actions workflow. It uses GitHub OIDC, validates `server.json`, and refuses to publish until the matching `@memi-design/cli` version exists on npm.
+
 Expected registry result after publish:
 
 ```json

From 9da753014d2a85445c4470ef614a9e26849d6537 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Wed, 13 May 2026 12:51:31 -0500
Subject: [PATCH 6/7] feat(studio): stabilize e2e runtime contracts

---
 src/studio/__tests__/server.test.ts           |  35 ++
 src/studio/__tests__/simulation-tools.test.ts |  78 +++
 src/studio/config.ts                          |  16 +
 src/studio/server.ts                          |  79 +++
 src/studio/tool-broker.ts                     | 488 ++++++++++++++++++
 src/studio/types.ts                           |  15 +
 6 files changed, 711 insertions(+)

diff --git a/src/studio/__tests__/server.test.ts b/src/studio/__tests__/server.test.ts
index 1bf0523..f813f42 100644
--- a/src/studio/__tests__/server.test.ts
+++ b/src/studio/__tests__/server.test.ts
@@ -33,6 +33,41 @@ describe("studio runtime server", () => {
     }
   });
 
+  it("serves a stable empty usage snapshot", async () => {
+    const root = await mkdtemp(join(tmpdir(), "memoire-studio-usage-"));
+    try {
+      const server = new StudioRuntimeServer({ projectRoot: root, port: 0 });
+      servers.push(server);
+      const runtime = await server.start();
+
+      const response = await fetch(`${runtime.url}/api/usage`);
+      const payload = await response.json();
+
+      expect(response.status).toBe(200);
+      expect(payload.usage).toMatchObject({
+        sessions: [],
+        totals: {
+          inputTokens: 0,
+          outputTokens: 0,
+          totalTokens: 0,
+          cachedInputTokens: 0,
+          reasoningTokens: 0,
+          estimatedCostUsd: 0,
+        },
+        byHarness: {},
+        byProvider: {},
+        rateLimits: [],
+        budgets: {
+          warningThreshold: 0.8,
+          providers: {},
+          harnesses: {},
+        },
+      });
+    } finally {
+      await rm(root, { recursive: true, force: true });
+    }
+  });
+
   it("rejects session starts outside configured workspace roots", async () => {
     const root = await mkdtemp(join(tmpdir(), "memoire-studio-server-"));
     try {
diff --git a/src/studio/__tests__/simulation-tools.test.ts b/src/studio/__tests__/simulation-tools.test.ts
index b7638b7..7b376a1 100644
--- a/src/studio/__tests__/simulation-tools.test.ts
+++ b/src/studio/__tests__/simulation-tools.test.ts
@@ -32,6 +32,15 @@ describe("studio simulation tools", () => {
         "research.design_package",
         "research.generate_specs",
         "mermaid_jam.export",
+        "board.create",
+        "board.add_node",
+        "board.update_node",
+        "board.connect",
+        "board.layout",
+        "board.capture_ia",
+        "board.export_mermaid_jam",
+        "board.apply_template",
+        "board.sync_figjam",
       ]));
 
       const planned = await broker.call({
@@ -193,6 +202,75 @@ describe("studio simulation tools", () => {
       });
       const exportedPath = ((figjamExport.data as { exports: Array<{ outputPath: string }> }).exports[0].outputPath);
       await expect(readFile(exportedPath, "utf-8")).resolves.toContain("journey");
+
+      const boardCreate = await broker.call({
+        toolId: "board.create",
+        cwd: root,
+        input: {
+          id: "studio-e2e-board",
+          prompt: "Create a designer-friendly onboarding research board.",
+        },
+      });
+      expect(boardCreate).toMatchObject({
+        status: "completed",
+        data: {
+          board: {
+            id: "studio-e2e-board",
+            mode: "pm-brainstorm",
+            nodes: expect.any(Array),
+          },
+        },
+      });
+
+      const boardAdd = await broker.call({
+        toolId: "board.add_node",
+        cwd: root,
+        input: {
+          boardId: "studio-e2e-board",
+          kind: "risk",
+          laneId: "risks",
+          title: "Friction risk",
+          body: "The onboarding flow may hide source evidence from designers.",
+        },
+      });
+      expect(boardAdd).toMatchObject({
+        status: "completed",
+        data: {
+          board: {
+            nodes: expect.arrayContaining([expect.objectContaining({ title: "Friction risk" })]),
+          },
+        },
+      });
+
+      const boardExport = await broker.call({
+        toolId: "board.export_mermaid_jam",
+        cwd: root,
+        input: { boardId: "studio-e2e-board" },
+      });
+      expect(boardExport).toMatchObject({
+        status: "completed",
+        data: {
+          exports: expect.arrayContaining([expect.objectContaining({
+            outputPath: expect.stringContaining(".memoire/mermaid-jam/boards"),
+          })]),
+        },
+      });
+      const boardExportPath = ((boardExport.data as { exports: Array<{ outputPath: string }> }).exports[0].outputPath);
+      await expect(readFile(boardExportPath, "utf-8")).resolves.toContain("Friction risk");
+
+      await expect(broker.call({
+        toolId: "board.sync_figjam",
+        cwd: root,
+        input: { boardId: "studio-e2e-board" },
+      })).resolves.toMatchObject({
+        status: "completed",
+        data: {
+          sync: {
+            status: "fallback",
+            createdNodeCount: 0,
+          },
+        },
+      });
     } finally {
       await rm(root, { recursive: true, force: true });
     }
diff --git a/src/studio/config.ts b/src/studio/config.ts
index 7dc2aac..e2a0482 100644
--- a/src/studio/config.ts
+++ b/src/studio/config.ts
@@ -70,6 +70,11 @@ export function defaultStudioConfig(projectRoot: string): StudioConfig {
       lastCheckedAt: null,
       downloadReadyAcknowledged: false,
     },
+    usageBudgets: {
+      warningThreshold: 0.8,
+      providers: {},
+      harnesses: {},
+    },
     harnesses: getHarnessManifest().harnesses.map((harness) => ({
       ...harness,
       enabled: harness.enabledByDefault,
@@ -157,6 +162,17 @@ function mergeStudioConfig(defaults: StudioConfig, raw: Partial<StudioConfig>):
       ...(raw.setup ?? {}),
       wizardVersion: 1,
     },
+    usageBudgets: {
+      warningThreshold: raw.usageBudgets?.warningThreshold ?? defaults.usageBudgets.warningThreshold,
+      providers: {
+        ...defaults.usageBudgets.providers,
+        ...(raw.usageBudgets?.providers ?? {}),
+      },
+      harnesses: {
+        ...defaults.usageBudgets.harnesses,
+        ...(raw.usageBudgets?.harnesses ?? {}),
+      },
+    },
     figma: {
       autoStartBridge: raw.figma?.autoStartBridge ?? defaults.figma?.autoStartBridge ?? false,
       preferredPort: raw.figma?.preferredPort ?? defaults.figma?.preferredPort ?? null,
diff --git a/src/studio/server.ts b/src/studio/server.ts
index a7ad5f0..d551538 100644
--- a/src/studio/server.ts
+++ b/src/studio/server.ts
@@ -125,6 +125,7 @@ import type {
   StudioAutomationDefinition,
   StudioAutomationRun,
   StudioCodexConfig,
+  StudioUsageProviderId,
 } from "./types.js";
 
 interface StudioRuntimeServerOptions {
@@ -413,6 +414,11 @@ export class StudioRuntimeServer {
       return;
     }
 
+    if (req.method === "GET" && url.pathname === "/api/usage") {
+      this.sendJSON(res, 200, { usage: await this.usageSnapshot() });
+      return;
+    }
+
     if (req.method === "GET" && url.pathname === "/api/harnesses") {
       this.sendJSON(res, 200, { harnesses: await this.listHarnessSnapshot(isRefreshRequest(url)) });
       return;
@@ -1856,6 +1862,58 @@ export class StudioRuntimeServer {
     };
   }
 
+  private async usageSnapshot() {
+    const config = await this.getConfig();
+    const emptyTotals = () => ({
+      inputTokens: 0,
+      outputTokens: 0,
+      totalTokens: 0,
+      cachedInputTokens: 0,
+      reasoningTokens: 0,
+      estimatedCostUsd: 0,
+    });
+    const totals = emptyTotals();
+    const byHarness: Record<string, ReturnType<typeof emptyTotals>> = {};
+    const byProvider: Record<string, ReturnType<typeof emptyTotals>> = {};
+    const sessions = this.listSessionSummaries().map((session) => {
+      const sessionTotals = emptyTotals();
+      for (const event of this.readSessionRecord(session.id)?.events ?? []) {
+        if (event.type !== "token_usage" || !event.data || typeof event.data !== "object") continue;
+        const data = event.data as Record<string, unknown>;
+        sessionTotals.inputTokens += numberField(data.inputTokens) ?? numberField(data.input_tokens) ?? 0;
+        sessionTotals.outputTokens += numberField(data.outputTokens) ?? numberField(data.output_tokens) ?? 0;
+        sessionTotals.cachedInputTokens += numberField(data.cachedInputTokens) ?? numberField(data.cached_input_tokens) ?? 0;
+        sessionTotals.reasoningTokens += numberField(data.reasoningTokens) ?? numberField(data.reasoning_tokens) ?? 0;
+        sessionTotals.estimatedCostUsd += numberField(data.estimatedCostUsd) ?? numberField(data.estimated_cost_usd) ?? 0;
+      }
+      sessionTotals.totalTokens = sessionTotals.inputTokens + sessionTotals.outputTokens + sessionTotals.reasoningTokens;
+      addUsageTotals(totals, sessionTotals);
+      const provider = usageProviderForHarness(session.harness as StudioHarnessId);
+      byHarness[session.harness] ??= emptyTotals();
+      byProvider[provider] ??= emptyTotals();
+      addUsageTotals(byHarness[session.harness], sessionTotals);
+      addUsageTotals(byProvider[provider], sessionTotals);
+      return {
+        id: session.id,
+        harness: session.harness,
+        provider,
+        status: session.status,
+        startedAt: session.startedAt,
+        completedAt: session.completedAt ?? null,
+        totals: sessionTotals,
+      };
+    });
+    return {
+      generatedAt: new Date().toISOString(),
+      sessions,
+      totals,
+      byHarness,
+      byProvider,
+      rateLimits: [],
+      budgets: config.usageBudgets,
+    };
+  }
+
   private setBaseHeaders(res: ServerResponse): void {
     res.setHeader("access-control-allow-origin", "*");
     res.setHeader("access-control-allow-methods", "GET,POST,PUT,PATCH,DELETE,OPTIONS");
@@ -1944,6 +2002,27 @@ function numberField(value: unknown): number | null {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 
+function addUsageTotals(
+  target: { inputTokens: number; outputTokens: number; totalTokens: number; cachedInputTokens: number; reasoningTokens: number; estimatedCostUsd: number },
+  source: { inputTokens: number; outputTokens: number; totalTokens: number; cachedInputTokens: number; reasoningTokens: number; estimatedCostUsd: number },
+): void {
+  target.inputTokens += source.inputTokens;
+  target.outputTokens += source.outputTokens;
+  target.totalTokens += source.totalTokens;
+  target.cachedInputTokens += source.cachedInputTokens;
+  target.reasoningTokens += source.reasoningTokens;
+  target.estimatedCostUsd += source.estimatedCostUsd;
+}
+
+function usageProviderForHarness(harness: StudioHarnessId): StudioUsageProviderId {
+  if (harness === "codex" || harness === "opencode") return "openai";
+  if (harness === "claude-code") return "anthropic";
+  if (harness === "gemini") return "google";
+  if (harness === "ollama") return "local";
+  if (harness === "shell") return "shell";
+  return "memoire";
+}
+
 function normalizeRpcRequestSessionId(body: unknown): unknown {
   if (!isRecord(body) || typeof body.sessionId !== "string") return body;
   return { ...body, sessionId: providerRuntimeId("SessionId", body.sessionId) };
diff --git a/src/studio/tool-broker.ts b/src/studio/tool-broker.ts
index 2f9383b..70b5f38 100644
--- a/src/studio/tool-broker.ts
+++ b/src/studio/tool-broker.ts
@@ -46,6 +46,64 @@ export interface StudioToolBrokerOptions {
   runFigmaAction?: (request: StudioFigmaActionRequest) => Promise<StudioFigmaActionResult>;
 }
 
+type BoardNodeKind = "mermaid" | "sticky" | "evidence" | "persona" | "risk" | "metric" | "spec" | "comment";
+type BoardMode = "pm-brainstorm" | "ia" | "sandbox";
+
+interface BoardNode {
+  id: string;
+  kind: BoardNodeKind;
+  title: string;
+  body: string;
+  mermaidSource?: string;
+  researchBacking: string[];
+  sourceEventIds: string[];
+  author: "human" | "agent";
+  laneId?: string;
+  priority?: "low" | "medium" | "high";
+  confidence?: number;
+  decisionStatus?: "open" | "recommended" | "decided" | "blocked";
+  position: { x: number; y: number; width: number; height: number };
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface BoardEdge {
+  id: string;
+  fromNodeId: string;
+  toNodeId: string;
+  label: string;
+  sourceEventIds: string[];
+  author: "human" | "agent";
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface BoardState {
+  schemaVersion: 1;
+  id: string;
+  title: string;
+  description: string;
+  mode: BoardMode;
+  templateId: string;
+  brief: { problem: string; targetUser: string; outcome: string; constraints: string[]; prompt?: string };
+  lastFigJamSync?: {
+    status: "idle" | "synced" | "fallback" | "unavailable" | "failed";
+    message: string;
+    syncedAt: string;
+    integration: string;
+    outputPaths: string[];
+    createdNodeCount: number;
+    artifactPath: string | null;
+    diagnostics: string[];
+    fallbackReason?: string;
+  } | null;
+  nodes: BoardNode[];
+  edges: BoardEdge[];
+  frames: Array<{ id: string; title: string; nodeIds: string[]; laneId?: string; position: { x: number; y: number; width: number; height: number } }>;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export class StudioToolBroker {
   private readonly projectRoot: string;
   private readonly getConfig: () => Promise<StudioConfig>;
@@ -84,6 +142,15 @@ export class StudioToolBroker {
       tool("research.design_package", "Research design", "research", "Preview research-backed vibe design specs and Mermaid Jam source.", false),
       tool("research.generate_specs", "Research specs", "research", "Write research-backed Atomic Design specs through the Memoire registry.", true),
       tool("mermaid_jam.export", "FigJam export", "research", "Write Mermaid Jam source artifacts for FigJam from research or simulation output.", false),
+      tool("board.create", "Board create", "board", "Create a local PM/FigJam-ready board from prompt or research context.", false),
+      tool("board.add_node", "Board node", "board", "Add a local board card with evidence metadata.", false),
+      tool("board.update_node", "Board update", "board", "Update a local board card.", false),
+      tool("board.connect", "Board connect", "board", "Connect two local board cards.", false),
+      tool("board.layout", "Board layout", "board", "Lay out local board cards into product-design lanes.", false),
+      tool("board.capture_ia", "IA capture", "board", "Capture an IA board from the current agent trace.", false),
+      tool("board.export_mermaid_jam", "Board export", "board", "Write local Mermaid Jam source files for a board without syncing externally.", false),
+      tool("board.apply_template", "Board template", "board", "Apply the product brainstorm template to a local board.", false),
+      tool("board.sync_figjam", "FigJam source", "board", "Prepare local FigJam source and report sync readiness without external writes.", false),
       tool("simulation.models", "Simulation models", "simulation", "List Codex-first model profiles available to Scenario Lab.", false),
       tool("simulation.generate_agents", "Simulation agents", "simulation", "Generate a 20-60 agent model-swarm cohort from research evidence.", false),
       tool("simulation.plan", "Simulation plan", "simulation", "Plan a local or model-swarm product simulation from research evidence.", false),
@@ -188,6 +255,24 @@ export class StudioToolBroker {
         return this.generateResearchSpecs(input);
       case "mermaid_jam.export":
         return this.exportMermaidJam(input);
+      case "board.create":
+        return this.createBoard(input);
+      case "board.add_node":
+        return this.addBoardNode(input);
+      case "board.update_node":
+        return this.updateBoardNode(input);
+      case "board.connect":
+        return this.connectBoardNodes(input);
+      case "board.layout":
+        return this.layoutBoard(input);
+      case "board.capture_ia":
+        return this.captureIABoard(input, request);
+      case "board.export_mermaid_jam":
+        return this.exportBoardMermaidJam(input);
+      case "board.apply_template":
+        return this.applyBoardTemplate(input);
+      case "board.sync_figjam":
+        return this.syncBoardFigJam(input);
       case "simulation.models":
         return this.listSimulationModels();
       case "simulation.generate_agents":
@@ -454,6 +539,260 @@ export class StudioToolBroker {
     return { spec: exportProductSpecFromRun(report) };
   }
 
+  private async createBoard(input: Record<string, unknown>): Promise<unknown> {
+    const board = this.applyBoardTemplateDefaults(this.newBoard(input, normalizeBoardMode(input.mode, "pm-brainstorm")));
+    await this.saveBoard(board);
+    return { board };
+  }
+
+  private async applyBoardTemplate(input: Record<string, unknown>): Promise<unknown> {
+    const board = this.applyBoardTemplateDefaults(await this.loadOrCreateBoard(input, "pm-brainstorm"));
+    await this.saveBoard(board);
+    return { board };
+  }
+
+  private async addBoardNode(input: Record<string, unknown>): Promise<unknown> {
+    const board = await this.loadOrCreateBoard(input, normalizeBoardMode(input.mode, "pm-brainstorm"));
+    const now = new Date().toISOString();
+    board.nodes.push({
+      id: optionalStringInput(input.nodeId ?? input.id) ?? `node-${Date.now().toString(36)}-${randomUUID().slice(0, 6)}`,
+      kind: normalizeBoardNodeKind(input.kind),
+      title: optionalStringInput(input.title) ?? titleForBoardNodeKind(normalizeBoardNodeKind(input.kind)),
+      body: optionalStringInput(input.body ?? input.text ?? input.prompt) ?? "Captured board note.",
+      mermaidSource: optionalStringInput(input.mermaidSource ?? input.source),
+      researchBacking: stringListInput(input.researchBacking ?? input.evidence),
+      sourceEventIds: stringListInput(input.sourceEventIds),
+      author: input.author === "human" ? "human" : "agent",
+      laneId: optionalStringInput(input.laneId) ?? laneForBoardNodeKind(normalizeBoardNodeKind(input.kind), board.mode),
+      priority: normalizePriority(input.priority),
+      confidence: numberInput(input.confidence, undefined),
+      decisionStatus: normalizeDecisionStatus(input.decisionStatus),
+      position: { x: 0, y: 0, width: 220, height: 128 },
+      createdAt: now,
+      updatedAt: now,
+    });
+    const laidOut = layoutBoardNodes(board);
+    await this.saveBoard(laidOut);
+    return { board: laidOut };
+  }
+
+  private async updateBoardNode(input: Record<string, unknown>): Promise<unknown> {
+    const board = await this.loadBoardOrThrow(boardIdFromInput(input));
+    const nodeId = stringInput(input.nodeId ?? input.id, "nodeId");
+    const node = board.nodes.find((candidate) => candidate.id === nodeId);
+    if (!node) throw Object.assign(new Error(`Unknown board node: ${nodeId}`), { statusCode: 404 });
+    node.title = optionalStringInput(input.title) ?? node.title;
+    node.body = optionalStringInput(input.body ?? input.text) ?? node.body;
+    node.mermaidSource = optionalStringInput(input.mermaidSource ?? input.source) ?? node.mermaidSource;
+    node.laneId = optionalStringInput(input.laneId) ?? node.laneId;
+    node.priority = normalizePriority(input.priority) ?? node.priority;
+    node.confidence = numberInput(input.confidence, undefined) ?? node.confidence;
+    node.decisionStatus = normalizeDecisionStatus(input.decisionStatus) ?? node.decisionStatus;
+    node.updatedAt = new Date().toISOString();
+    board.updatedAt = node.updatedAt;
+    await this.saveBoard(board);
+    return { board, node };
+  }
+
+  private async connectBoardNodes(input: Record<string, unknown>): Promise<unknown> {
+    const board = await this.loadBoardOrThrow(boardIdFromInput(input));
+    const fromNodeId = stringInput(input.fromNodeId ?? input.from, "fromNodeId");
+    const toNodeId = stringInput(input.toNodeId ?? input.to, "toNodeId");
+    if (!board.nodes.some((node) => node.id === fromNodeId)) throw Object.assign(new Error(`Unknown board node: ${fromNodeId}`), { statusCode: 404 });
+    if (!board.nodes.some((node) => node.id === toNodeId)) throw Object.assign(new Error(`Unknown board node: ${toNodeId}`), { statusCode: 404 });
+    const now = new Date().toISOString();
+    const edge: BoardEdge = {
+      id: optionalStringInput(input.edgeId ?? input.id) ?? `edge-${Date.now().toString(36)}-${randomUUID().slice(0, 6)}`,
+      fromNodeId,
+      toNodeId,
+      label: optionalStringInput(input.label) ?? "relates to",
+      sourceEventIds: stringListInput(input.sourceEventIds),
+      author: input.author === "human" ? "human" : "agent",
+      createdAt: now,
+      updatedAt: now,
+    };
+    board.edges.push(edge);
+    board.updatedAt = now;
+    await this.saveBoard(board);
+    return { board, edge };
+  }
+
+  private async layoutBoard(input: Record<string, unknown>): Promise<unknown> {
+    const board = layoutBoardNodes(await this.loadBoardOrThrow(boardIdFromInput(input)));
+    await this.saveBoard(board);
+    return { board };
+  }
+
+  private async captureIABoard(input: Record<string, unknown>, request: StudioToolCallRequest): Promise<unknown> {
+    const board = this.applyBoardTemplateDefaults(this.newBoard({ ...input, id: optionalStringInput(input.boardId ?? input.id) ?? "studio-ia-board" }, "ia"));
+    const events = Array.isArray(input.events) ? input.events.filter((event): event is StudioEvent => Boolean(event && typeof event === "object")) : [];
+    const sourceEventIds = events.map((event) => event.id).filter(Boolean).slice(0, 8);
+    const now = new Date().toISOString();
+    const prompt = optionalStringInput(input.prompt) ?? "Capture IA from current run.";
+    board.nodes.push({
+      id: `ia-source-${randomUUID().slice(0, 8)}`,
+      kind: "evidence",
+      title: "Run evidence",
+      body: events.slice(-3).map((event) => event.message).join("\n") || prompt,
+      researchBacking: [],
+      sourceEventIds: sourceEventIds.length ? sourceEventIds : request.sessionId ? [request.sessionId] : [],
+      author: "agent",
+      laneId: "evidence",
+      position: { x: 0, y: 0, width: 240, height: 140 },
+      createdAt: now,
+      updatedAt: now,
+    });
+    const laidOut = layoutBoardNodes(board);
+    await this.saveBoard(laidOut);
+    return { board: laidOut };
+  }
+
+  private async exportBoardMermaidJam(input: Record<string, unknown>): Promise<unknown> {
+    const board = await this.loadBoardOrThrow(boardIdFromInput(input));
+    const exports = await this.writeBoardExports(board);
+    return { board, exports, integration: await resolveMermaidJamIntegration({ projectRoot: this.projectRoot }) };
+  }
+
+  private async syncBoardFigJam(input: Record<string, unknown>): Promise<unknown> {
+    const board = await this.loadBoardOrThrow(boardIdFromInput(input));
+    const exports = await this.writeBoardExports(board);
+    const sync = {
+      status: "fallback" as const,
+      message: "Local Mermaid Jam source is ready. Direct FigJam writes were not executed.",
+      syncedAt: new Date().toISOString(),
+      integration: exports[0]?.integration ?? "mermaid-jam",
+      outputPaths: exports.map((item) => item.outputPath),
+      createdNodeCount: 0,
+      artifactPath: exports[0]?.outputPath ?? null,
+      diagnostics: ["External FigJam sync requires an explicit approval and connected bridge."],
+      fallbackReason: "No external FigJam write was requested.",
+    };
+    board.lastFigJamSync = sync;
+    board.updatedAt = sync.syncedAt;
+    await this.saveBoard(board);
+    return { board, exports, sync };
+  }
+
+  private newBoard(input: Record<string, unknown>, mode: BoardMode): BoardState {
+    const now = new Date().toISOString();
+    const prompt = optionalStringInput(input.prompt);
+    const id = optionalStringInput(input.id ?? input.boardId) ?? (mode === "ia" ? "studio-ia-board" : "studio-mermaid-board");
+    return {
+      schemaVersion: 1,
+      id,
+      title: optionalStringInput(input.title) ?? (mode === "ia" ? "IA Board" : "Product Design Board"),
+      description: optionalStringInput(input.description) ?? "Local Studio board for product design planning and FigJam source export.",
+      mode,
+      templateId: optionalStringInput(input.templateId) ?? (mode === "ia" ? "ia-journeys" : "pm-brainstorm"),
+      brief: {
+        problem: optionalStringInput(input.problem) ?? prompt ?? "Clarify the product design direction.",
+        targetUser: optionalStringInput(input.targetUser) ?? "Product designers and PMs",
+        outcome: optionalStringInput(input.outcome) ?? "A board of editable, evidence-linked design decisions.",
+        constraints: stringListInput(input.constraints),
+        ...(prompt ? { prompt } : {}),
+      },
+      lastFigJamSync: null,
+      nodes: [],
+      edges: [],
+      frames: [],
+      createdAt: now,
+      updatedAt: now,
+    };
+  }
+
+  private applyBoardTemplateDefaults(board: BoardState): BoardState {
+    if (board.nodes.length > 0) return layoutBoardNodes(board);
+    const now = new Date().toISOString();
+    const defaults = board.mode === "ia"
+      ? [
+          ["sitemap", "spec", "Sitemap hypothesis", "Top-level routes and product areas to validate."],
+          ["navigation", "sticky", "Navigation model", "Primary wayfinding, labels, and hierarchy."],
+          ["journeys", "mermaid", "Journey flow", "flowchart TD\n  Start[Open product] --> Decide[Choose task]\n  Decide --> Done[Complete flow]"],
+          ["screens", "spec", "Screen inventory", "Screens and states required for the next prototype."],
+        ]
+      : [
+          ["problem", "sticky", "Problem", board.brief.problem],
+          ["users", "persona", "User", board.brief.targetUser],
+          ["journey", "mermaid", "Journey map", "journey\n  title Product design review\n  section Discover\n    Gather evidence: 5: Designer\n  section Decide\n    Compare options: 4: PM\n  section Ship\n    Export FigJam source: 5: Designer"],
+          ["opportunities", "spec", "Opportunity", board.brief.outcome],
+          ["risks", "risk", "Risk", "Source evidence can get lost if the board is not kept local and editable."],
+          ["metrics", "metric", "Metric", "Decision confidence and handoff completeness."],
+        ];
+    board.nodes = defaults.map(([laneId, kind, title, body], index) => ({
+      id: `node-${safeSlug(laneId)}-${index + 1}`,
+      kind: normalizeBoardNodeKind(kind),
+      title,
+      body,
+      mermaidSource: kind === "mermaid" ? body : undefined,
+      researchBacking: [],
+      sourceEventIds: [],
+      author: "agent",
+      laneId,
+      priority: index === 0 ? "high" : "medium",
+      decisionStatus: kind === "risk" ? "open" : undefined,
+      position: { x: 0, y: 0, width: 220, height: 128 },
+      createdAt: now,
+      updatedAt: now,
+    }));
+    board.updatedAt = now;
+    return layoutBoardNodes(board);
+  }
+
+  private async loadOrCreateBoard(input: Record<string, unknown>, mode: BoardMode): Promise<BoardState> {
+    const id = optionalStringInput(input.boardId ?? input.id);
+    if (id) {
+      const loaded = await this.loadBoard(id);
+      if (loaded) return loaded;
+    }
+    return this.newBoard(input, mode);
+  }
+
+  private async loadBoardOrThrow(id: string): Promise<BoardState> {
+    const board = await this.loadBoard(id);
+    if (!board) throw Object.assign(new Error(`Unknown board: ${id}`), { statusCode: 404 });
+    return board;
+  }
+
+  private async loadBoard(id: string): Promise<BoardState | null> {
+    try {
+      return JSON.parse(await readFile(this.boardPath(id), "utf-8")) as BoardState;
+    } catch {
+      return null;
+    }
+  }
+
+  private async saveBoard(board: BoardState): Promise<void> {
+    await mkdir(dirname(this.boardPath(board.id)), { recursive: true });
+    await writeFile(this.boardPath(board.id), JSON.stringify(board, null, 2) + "\n", "utf-8");
+  }
+
+  private boardPath(id: string): string {
+    return join(this.projectRoot, ".memoire", "studio", "boards", `${safeSlug(id)}.json`);
+  }
+
+  private async writeBoardExports(board: BoardState) {
+    const integration = await resolveMermaidJamIntegration({ projectRoot: this.projectRoot });
+    const outputDir = join(this.projectRoot, ".memoire", "mermaid-jam", "boards", safeSlug(board.id));
+    await mkdir(outputDir, { recursive: true });
+    const markdownSource = boardMarkdownSource(board);
+    const mermaidSource = boardMermaidSource(board);
+    const jsonSource = JSON.stringify(board, null, 2);
+    const outputs = [
+      { id: `${board.id}-summary`, title: `${board.title} summary`, format: "markdown" as const, kind: "board-summary" as const, source: markdownSource, outputPath: join(outputDir, "board.md") },
+      { id: `${board.id}-source`, title: `${board.title} Mermaid`, format: "mermaid" as const, kind: "board-source" as const, source: mermaidSource, outputPath: join(outputDir, "board.mmd") },
+      { id: `${board.id}-json`, title: `${board.title} JSON`, format: "json" as const, kind: "board-json" as const, source: jsonSource, outputPath: join(outputDir, "board.json") },
+    ];
+    for (const output of outputs) await writeFile(output.outputPath, output.source, "utf-8");
+    return outputs.map((output) => ({
+      ...output,
+      integration: integration.id,
+      nextSteps: [
+        `Open Mermaid Jam in FigJam using ${integration.local.ready && integration.local.manifestPath ? integration.local.manifestPath : integration.communityUrl}.`,
+        `Paste the saved source from ${output.outputPath}; no external sync was executed by Studio.`,
+      ],
+    }));
+  }
+
   private async simulationTranscript(input: Record<string, unknown>): Promise<unknown> {
     const store = new FileSimulationStore(this.projectRoot);
     const run = await store.loadRun(stringInput(input.runId, "runId"));
@@ -538,6 +877,15 @@ const MEMOIRE_MCP_TOOL_NAMES = [
   "research.design_package",
   "research.generate_specs",
   "mermaid_jam.export",
+  "board.create",
+  "board.add_node",
+  "board.update_node",
+  "board.connect",
+  "board.layout",
+  "board.capture_ia",
+  "board.export_mermaid_jam",
+  "board.apply_template",
+  "board.sync_figjam",
   "simulation.models",
   "simulation.generate_agents",
   "simulation.plan",
@@ -577,6 +925,146 @@ function optionalStringInput(value: unknown): string | undefined {
   return typeof value === "string" && value.length > 0 ? value : undefined;
 }
 
+function stringListInput(value: unknown): string[] {
+  if (Array.isArray(value)) return value.filter((item): item is string => typeof item === "string" && item.length > 0);
+  if (typeof value === "string" && value.length > 0) return [value];
+  return [];
+}
+
+function boardIdFromInput(input: Record<string, unknown>): string {
+  return optionalStringInput(input.boardId ?? input.id) ?? "studio-mermaid-board";
+}
+
+function normalizeBoardMode(value: unknown, fallback: BoardMode): BoardMode {
+  if (value === "pm-brainstorm" || value === "ia" || value === "sandbox") return value;
+  return fallback;
+}
+
+function normalizeBoardNodeKind(value: unknown): BoardNodeKind {
+  if (value === "mermaid" || value === "sticky" || value === "evidence" || value === "persona" || value === "risk" || value === "metric" || value === "spec" || value === "comment") return value;
+  return "sticky";
+}
+
+function titleForBoardNodeKind(kind: BoardNodeKind): string {
+  if (kind === "persona") return "Persona";
+  if (kind === "risk") return "Risk";
+  if (kind === "metric") return "Metric";
+  if (kind === "spec") return "Spec";
+  if (kind === "evidence") return "Evidence";
+  if (kind === "comment") return "Decision";
+  if (kind === "mermaid") return "Flow";
+  return "Note";
+}
+
+function laneForBoardNodeKind(kind: BoardNodeKind, mode: BoardMode): string {
+  if (mode === "ia") {
+    if (kind === "mermaid") return "journeys";
+    if (kind === "spec") return "screens";
+    return "evidence";
+  }
+  if (kind === "persona") return "users";
+  if (kind === "mermaid") return "journey";
+  if (kind === "spec") return "opportunities";
+  if (kind === "comment") return "decisions";
+  if (kind === "risk") return "risks";
+  if (kind === "metric") return "metrics";
+  if (kind === "evidence") return "next-steps";
+  return "problem";
+}
+
+function normalizePriority(value: unknown): BoardNode["priority"] | undefined {
+  if (value === "low" || value === "medium" || value === "high") return value;
+  return undefined;
+}
+
+function normalizeDecisionStatus(value: unknown): BoardNode["decisionStatus"] | undefined {
+  if (value === "open" || value === "recommended" || value === "decided" || value === "blocked") return value;
+  return undefined;
+}
+
+function layoutBoardNodes(board: BoardState): BoardState {
+  const laneOrder = board.mode === "ia"
+    ? ["sitemap", "navigation", "journeys", "screens", "evidence"]
+    : ["problem", "users", "journey", "opportunities", "decisions", "risks", "metrics", "next-steps"];
+  const laneIndex = new Map(laneOrder.map((lane, index) => [lane, index]));
+  const counts = new Map<string, number>();
+  const now = new Date().toISOString();
+  board.nodes = board.nodes.map((node) => {
+    const laneId = node.laneId ?? laneForBoardNodeKind(node.kind, board.mode);
+    const index = counts.get(laneId) ?? 0;
+    counts.set(laneId, index + 1);
+    return {
+      ...node,
+      laneId,
+      position: {
+        x: (laneIndex.get(laneId) ?? laneOrder.length) * 260,
+        y: index * 160,
+        width: node.position?.width ?? 220,
+        height: node.position?.height ?? 128,
+      },
+      updatedAt: node.updatedAt ?? now,
+    };
+  });
+  board.frames = laneOrder.map((lane, index) => ({
+    id: `frame-${lane}`,
+    title: lane.replace(/-/g, " "),
+    laneId: lane,
+    nodeIds: board.nodes.filter((node) => node.laneId === lane).map((node) => node.id),
+    position: { x: index * 260 - 16, y: -48, width: 248, height: Math.max(180, (counts.get(lane) ?? 1) * 160) },
+  }));
+  board.updatedAt = now;
+  return board;
+}
+
+function boardMarkdownSource(board: BoardState): string {
+  return [
+    `# ${board.title}`,
+    "",
+    board.description,
+    "",
+    `Problem: ${board.brief.problem}`,
+    `Target user: ${board.brief.targetUser}`,
+    `Outcome: ${board.brief.outcome}`,
+    "",
+    "## Cards",
+    ...board.nodes.map((node) => [
+      "",
+      `### ${node.title}`,
+      `Lane: ${node.laneId ?? laneForBoardNodeKind(node.kind, board.mode)} / ${node.kind}`,
+      node.body,
+      node.mermaidSource ? `\n\`\`\`mermaid\n${node.mermaidSource}\n\`\`\`` : "",
+    ].filter(Boolean).join("\n")),
+  ].join("\n");
+}
+
+function boardMermaidSource(board: BoardState): string {
+  const lines = ["flowchart LR"];
+  for (const node of board.nodes) {
+    lines.push(`  ${safeMermaidId(node.id)}["${escapeMermaidLabel(node.title)}"]`);
+  }
+  for (const edge of board.edges) {
+    lines.push(`  ${safeMermaidId(edge.fromNodeId)} -->|${escapeMermaidLabel(edge.label)}| ${safeMermaidId(edge.toNodeId)}`);
+  }
+  if (board.edges.length === 0) {
+    for (let index = 0; index < board.nodes.length - 1; index += 1) {
+      lines.push(`  ${safeMermaidId(board.nodes[index].id)} --> ${safeMermaidId(board.nodes[index + 1].id)}`);
+    }
+  }
+  return `${lines.join("\n")}\n`;
+}
+
+function safeSlug(value: string): string {
+  return value.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 96) || "board";
+}
+
+function safeMermaidId(value: string): string {
+  return `n_${value.replace(/[^A-Za-z0-9_]/g, "_")}`;
+}
+
+function escapeMermaidLabel(value: string): string {
+  return value.replace(/"/g, "'");
+}
+
 function normalizeSimulationAdapter(value: unknown, fallback: SimulationAdapterKind): SimulationAdapterKind {
   if (value === "model-swarm" || value === "mirofish" || value === "local") return value;
   return fallback;
diff --git a/src/studio/types.ts b/src/studio/types.ts
index d231634..c77f37c 100644
--- a/src/studio/types.ts
+++ b/src/studio/types.ts
@@ -62,6 +62,7 @@ export type StudioFigmaAction =
   | "pushTokens"
   | "fullSync";
 export type StudioHarnessProvider = "memoire" | "anthropic" | "openai" | "google" | "local" | "shell";
+export type StudioUsageProviderId = "anthropic" | "openai" | "openai-compatible" | "google" | "local" | "memoire" | "shell";
 export type StudioHarnessAuthStatus = "missing" | "needs_login" | "signed_in" | "ready" | "not_required";
 export type StudioEnvPolicy = "provider" | "local-model" | "safe-inherit" | "shell";
 export type StudioWorkspacePolicy = "workspace-required" | "trusted-shell";
@@ -249,6 +250,18 @@ export interface StudioSetupConfig {
   downloadReadyAcknowledged: boolean;
 }
 
+export interface StudioUsageBudget {
+  dailyTokenLimit?: number | null;
+  dailyCostLimitUsd?: number | null;
+  warningThreshold?: number | null;
+}
+
+export interface StudioUsageBudgetConfig {
+  warningThreshold: number;
+  providers: Partial<Record<StudioUsageProviderId, StudioUsageBudget>>;
+  harnesses: Partial<Record<StudioHarnessId, StudioUsageBudget>>;
+}
+
 export interface StudioConfig {
   schemaVersion: 1;
   workspaceRoots: string[];
@@ -262,6 +275,7 @@ export interface StudioConfig {
   permissions: StudioPermissionConfig;
   computer: StudioComputerConfig;
   setup: StudioSetupConfig;
+  usageBudgets: StudioUsageBudgetConfig;
   enabledTools: {
     shell: boolean;
     browser: boolean;
@@ -481,6 +495,7 @@ export type StudioToolCategory =
   | "mcp"
   | "knowledge"
   | "research"
+  | "board"
   | "simulation";
 
 export interface StudioToolDefinition {

From b439a6b17becd7a9fe522d7adb149c4365a8c966 Mon Sep 17 00:00:00 2001
From: sarveshsea <sarveshjax@gmail.com>
Date: Wed, 13 May 2026 12:58:50 -0500
Subject: [PATCH 7/7] fix(plugin): stabilize widget metadata

---
 plugin/widget-meta.json                   |  6 ++---
 scripts/build-plugin.mjs                  | 27 +++++++++++++++++------
 src/plugin/__tests__/build-plugin.test.ts | 20 +++++++++++++++++
 3 files changed, 43 insertions(+), 10 deletions(-)

diff --git a/plugin/widget-meta.json b/plugin/widget-meta.json
index a6f4c13..3a711e0 100644
--- a/plugin/widget-meta.json
+++ b/plugin/widget-meta.json
@@ -4,19 +4,19 @@
   "builtAt": "2026-05-12T03:53:41.174Z",
   "bundleHash": "ffd143c9b7a1a1ea878b03322940525eb1f53db395572b46e3cc7bbf4f2e69aa",
   "manifest": {
-    "path": "/Users/sarveshchidambaram/Desktop/Projects/Other/ark/plugin/manifest.json",
+    "path": "manifest.json",
     "exists": true,
     "bytes": 1746,
     "sha256": "93e5420e7a2b359a345cd7af9c552e9d66171df1bf976090229e224fdb1c13ab"
   },
   "code": {
-    "path": "/Users/sarveshchidambaram/Desktop/Projects/Other/ark/plugin/code.js",
+    "path": "code.js",
     "exists": true,
     "bytes": 48064,
     "sha256": "1bb461e5c6d934cc810a5d459a1ab852cca577efafc1f35c2591b9945d018977"
   },
   "ui": {
-    "path": "/Users/sarveshchidambaram/Desktop/Projects/Other/ark/plugin/ui.html",
+    "path": "ui.html",
     "exists": true,
     "bytes": 93930,
     "sha256": "8e61e42da2825c1d2afbbbc285aaf02c86c66f2751b1b9538b59fb8ca2a4f192"
diff --git a/scripts/build-plugin.mjs b/scripts/build-plugin.mjs
index 4d250c7..22ea073 100644
--- a/scripts/build-plugin.mjs
+++ b/scripts/build-plugin.mjs
@@ -115,21 +115,26 @@ async function inlineAssets(html, outDir) {
 
 async function writeWidgetMeta(rootDir, outDir) {
   const packageJson = JSON.parse(await readFile(join(rootDir, "package.json"), "utf-8"));
-  const manifest = await createAsset(join(outDir, "manifest.json"));
-  const code = await createAsset(join(outDir, "code.js"));
-  const ui = await createAsset(join(outDir, "ui.html"));
+  const metaPath = join(outDir, "widget-meta.json");
+  const previousMeta = await readJson(metaPath);
+  const manifest = await createAsset(outDir, join(outDir, "manifest.json"));
+  const code = await createAsset(outDir, join(outDir, "code.js"));
+  const ui = await createAsset(outDir, join(outDir, "ui.html"));
   const bundleHash = sha256(JSON.stringify([
     manifest.sha256 || "missing",
     code.sha256 || "missing",
     ui.sha256 || "missing",
   ]));
+  const builtAt = previousMeta?.bundleHash === bundleHash && typeof previousMeta.builtAt === "string"
+    ? previousMeta.builtAt
+    : new Date().toISOString();
 
   await writeFile(
-    join(outDir, "widget-meta.json"),
+    metaPath,
     JSON.stringify({
       widgetVersion,
       packageVersion: packageJson.version ?? null,
-      builtAt: new Date().toISOString(),
+      builtAt,
       bundleHash,
       manifest,
       code,
@@ -139,16 +144,24 @@ async function writeWidgetMeta(rootDir, outDir) {
   );
 }
 
-async function createAsset(path) {
+async function createAsset(bundleRoot, path) {
   const buffer = await readFile(path);
   return {
-    path,
+    path: relative(bundleRoot, path).replace(/\\/g, "/"),
     exists: true,
     bytes: buffer.byteLength,
     sha256: sha256(buffer),
   };
 }
 
+async function readJson(path) {
+  try {
+    return JSON.parse(await readFile(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+
 function sha256(value) {
   return createHash("sha256").update(value).digest("hex");
 }
diff --git a/src/plugin/__tests__/build-plugin.test.ts b/src/plugin/__tests__/build-plugin.test.ts
index db2d33c..2d6c59c 100644
--- a/src/plugin/__tests__/build-plugin.test.ts
+++ b/src/plugin/__tests__/build-plugin.test.ts
@@ -17,6 +17,13 @@ describe("plugin build pipeline", () => {
       const code = await readFile(result.codePath, "utf8");
       const html = await readFile(result.htmlPath, "utf8");
       const meta = await readFile(result.metaPath, "utf8");
+      const parsedMeta = JSON.parse(meta) as {
+        builtAt: string;
+        bundleHash: string;
+        manifest: { path: string };
+        code: { path: string };
+        ui: { path: string };
+      };
 
       expect(code).toContain("figma.showUI");
       expect(code).toContain("height: 600");
@@ -58,6 +65,19 @@ describe("plugin build pipeline", () => {
       expect(hasRawObjectSpread(html)).toBe(false);
       expect(meta).toContain('"widgetVersion": "2"');
       expect(meta).toContain(`"packageVersion": "${version}"`);
+      expect(parsedMeta.manifest.path).toBe("manifest.json");
+      expect(parsedMeta.code.path).toBe("code.js");
+      expect(parsedMeta.ui.path).toBe("ui.html");
+      expect(meta).not.toContain(process.cwd());
+      expect(meta).not.toContain(tempDir);
+
+      const rebuilt = await buildPluginBundle({ rootDir: process.cwd(), outDir: pluginDir });
+      const rebuiltMeta = JSON.parse(await readFile(rebuilt.metaPath, "utf8")) as {
+        builtAt: string;
+        bundleHash: string;
+      };
+      expect(rebuiltMeta.bundleHash).toBe(parsedMeta.bundleHash);
+      expect(rebuiltMeta.builtAt).toBe(parsedMeta.builtAt);
     } finally {
       await rm(tempDir, { recursive: true, force: true });
     }