npm - @deeeed/metamask-harness - Versions diffs - 0.34.4 → 0.36.0 - Mend

@deeeed/metamask-harness 0.34.4 → 0.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (65) hide show

package/CHANGELOG.md +25 -0
package/README.md +9 -1
package/adapters/core/inject.sh +3 -3
package/adapters/extension/check-infura-readiness.cjs +102 -0
package/adapters/extension/inject.mjs +4 -4
package/adapters/extension/live.sh +25 -10
package/adapters/extension/start-watch.sh +15 -0
package/adapters/extension/wallet-fixture-state.cjs +3 -1
package/adapters/manifest.json +16 -0
package/adapters/mobile/bridge-runtime/cdp-bridge.cjs +73 -42
package/adapters/mobile/inject.sh +4 -3
package/adapters/mobile/reset-app-data.sh +154 -0
package/adapters/mobile/verify.sh +37 -0
package/dist/adapters/extension/product-config.js +29 -1
package/dist/adapters/extension/runtime.js +60 -15
package/dist/adapters/extension/surface.js +6 -1
package/dist/adapters/mobile/surface.js +6 -1
package/dist/adapters.js +18 -0
package/dist/cli-commands.js +1 -1
package/dist/cli.js +2 -2
package/dist/command-contract.js +1 -1
package/dist/commands/device-target.js +5 -0
package/dist/commands/fixtures.js +106 -31
package/dist/commands/launch/extension.js +39 -3
package/dist/commands/launch/index.js +13 -0
package/dist/doctor.js +30 -1
package/dist/mm-harness-cli.js +6 -3
package/dist/recipe-security.js +3 -0
package/docs/RECIPES.md +29 -0
package/library/actions/extension/wallet/import.mjs +234 -0
package/library/actions/extension/wallet/reset.mjs +98 -0
package/library/actions/extension/wallet/state.mjs +1 -0
package/library/actions/mobile/analytics/consent-settings.mjs +112 -0
package/library/actions/mobile/analytics/set_consent.mjs +4 -112
package/library/actions/mobile/platform/bridge.mjs +8 -0
package/library/actions/mobile/wallet/import.mjs +259 -0
package/library/actions/mobile/wallet/reset-helper.mjs +99 -0
package/library/actions/mobile/wallet/reset.mjs +7 -0
package/library/actions/shared/wallet/import-source.mjs +101 -0
package/library/manifests/extension.action-manifest.json +112 -0
package/library/manifests/mobile.action-manifest.json +108 -0
package/library/recipes/wallet/import.recipe.json +83 -0
package/library/recipes/wallet/reset-import.recipe.json +88 -0
package/package.json +1 -1
package/scripts/completions.sh +2 -2
package/scripts/site-contrast.mjs +7 -0
package/site/architecture.html +14 -7
package/site/assets/metamask-fox.svg +24 -0
package/site/assets/progress.mjs +6 -0
package/site/assets/style.css +88 -29
package/site/cheatsheet.html +5 -6
package/site/ecosystem.html +162 -0
package/site/how-it-works.html +8 -9
package/site/index.html +17 -12
package/site/perps.html +103 -45
package/site/recipes.html +5 -6
package/site/reviewers.html +5 -6
package/site/tutorials/index.html +5 -6
package/site/tutorials/v1.html +5 -6
package/site/tutorials/v2.html +6 -8
package/site/tutorials/v3.html +5 -6
package/site/tutorials/v4.html +5 -6
package/site/tutorials/v5.html +5 -6
package/site/tutorials/v6.html +5 -6
package/site/tutorials/v7.html +5 -6

package/site/ecosystem.html ADDED Viewed

@@ -0,0 +1,162 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Ecosystem — which repo is which</title>
+<meta name="description" content="A dependency map of the repositories and packages behind the recipe workflow: skills, mm-harness, the spec and engine, team recipe libraries, the product repos, and the learnings inbox.">
+<link rel="icon" href="assets/metamask-fox.svg" type="image/svg+xml">
+<link rel="stylesheet" href="assets/style.css?v=4">
+</head>
+<body>
+<a class="skip" href="#map">Skip to the map</a>
+<header class="topbar">
+  <div class="wrap topbar-inner">
+    <a class="brand" href="index.html">
+      <img class="brand-mark" src="assets/metamask-fox.svg" alt="" width="22" height="22">
+      <span class="brand-name">recipes</span>
+    </a>
+    <nav class="nav" aria-label="Main">
+      <a class="nav-cta" href="index.html#prompt">Quick start</a>
+      <a href="how-it-works.html">How it works</a>
+      <a href="perps.html">Team / Perps</a>
+      <a href="cheatsheet.html">Cheatsheet</a>
+      <a href="architecture.html">Architecture</a>
+      <a href="tutorials/index.html">Tutorials</a>
+    </nav>
+  </div>
+</header>
+<main>
+<section class="wrap hero" style="padding-bottom:0.5rem">
+  <span class="eyebrow">Repositories</span>
+  <h1>Which repo is which</h1>
+  <p class="lede">
+    Six things sit behind a recipe run, and it is not obvious from the outside which one you install,
+    which one you contribute to, and which one is just a dependency. This is the dependency map — not
+    a pitch.
+  </p>
+</section>
+<section class="wrap-wide">
+  <div class="map" id="map">
+    <article class="node">
+      <span class="node-tag">You invoke this</span>
+      <h2 class="node-name">Skills</h2>
+      <p class="node-what">
+        The workflows — <code>mms-recipe-cook</code>, <code>mms-recipe-pr-qa-review</code> and the rest.
+        They call <code>mm-harness</code>; they are not a dependency of it.
+      </p>
+      <a class="node-url" href="https://github.com/Consensys/skills">github.com/Consensys/skills</a>
+      <span class="badge">internal</span>
+    </article>
+    <p class="map-edge">calls ↓</p>
+    <article class="node node-key">
+      <span class="node-tag">The runner</span>
+      <h2 class="node-name">mm-harness</h2>
+      <p class="node-what">
+        Launch, typed actions, graph execution, artifacts. Installed from npm as
+        <code>@deeeed/metamask-harness</code>; the MetaMask-specific layer lives here.
+      </p>
+      <a class="node-url" href="https://github.com/MetaMask/experimental-metamask-harness">github.com/MetaMask/experimental-metamask-harness</a>
+      <span class="badge">private</span>
+      <span class="badge">npm @deeeed/metamask-harness</span>
+    </article>
+    <div class="map-split">
+      <p class="map-edge">depends on ↓</p>
+      <p class="map-edge">runs recipes from ↓</p>
+    </div>
+    <div class="map-row">
+      <article class="node">
+        <span class="node-tag">Spec &amp; engine</span>
+        <h2 class="node-name">farmslot packages</h2>
+        <p class="node-what">
+          The recipe protocol and the execution engine, as pinned by mm-harness.
+          <code>recipe-harness</code> depends on <code>protocol</code>.
+        </p>
+        <ul class="node-list">
+          <li><code>@farmslot/protocol</code> 0.18.0</li>
+          <li><code>@farmslot/recipe-harness</code> 0.14.0</li>
+          <li><code>@farmslot/agent-runtime</code> 0.7.0</li>
+          <li><code>@farmslot/handoff</code> 0.3.1</li>
+          <li><code>@farmslot/expo-recipe</code> 0.7.1</li>
+        </ul>
+        <span class="badge">npm</span>
+      </article>
+      <article class="node">
+        <span class="node-tag">Your customization</span>
+        <h2 class="node-name">Recipe libraries</h2>
+        <p class="node-what">
+          One per team, pointed at with <code>RECIPE_LIBRARY_PATH</code>, resolved ahead of the small
+          bundled MetaMask library. Perps is the worked example.
+        </p>
+        <a class="node-url" href="https://github.com/MetaMask/experimental-metamask-recipe-perps">github.com/MetaMask/experimental-metamask-recipe-perps</a>
+        <span class="badge">private</span>
+        <a class="node-more" href="perps.html">How to point at one →</a>
+      </article>
+    </div>
+    <p class="map-edge">drives ↓</p>
+    <article class="node">
+      <span class="node-tag">What gets proved</span>
+      <h2 class="node-name">Product repos</h2>
+      <p class="node-what">
+        The real builds a recipe drives. Each also installs the skills — every one of the three has a
+        <code>skills</code> script running <code>metamask-skills sync</code>.
+      </p>
+      <a class="node-url" href="https://github.com/MetaMask/metamask-extension">github.com/MetaMask/metamask-extension</a>
+      <a class="node-url" href="https://github.com/MetaMask/metamask-mobile">github.com/MetaMask/metamask-mobile</a>
+      <a class="node-url" href="https://github.com/MetaMask/core">github.com/MetaMask/core</a>
+      <span class="badge">public</span>
+    </article>
+    <p class="map-edge">promoted learnings, via <code>@farmslot/handoff</code> ↓</p>
+    <article class="node">
+      <span class="node-tag">Opt-in output</span>
+      <h2 class="node-name">Learnings inbox</h2>
+      <p class="node-what">
+        Scrubbed learning packages staged from finished runs, for later review. A terminal mark stages
+        locally; sharing centrally is a separate, explicit step.
+      </p>
+      <a class="node-url" href="https://github.com/MetaMask/experimental-distributed-learnings">github.com/MetaMask/experimental-distributed-learnings</a>
+      <span class="badge">private</span>
+    </article>
+  </div>
+</section>
+<section class="wrap">
+  <div class="note">
+    <span class="note-title">Standing disclosure</span>
+    <p>
+      The farmslot <strong>control plane</strong> is experimental and sole-maintained. What is adopted
+      here is the spec and the engine — the npm packages above — not the control plane. Weigh that
+      before depending on anything beyond them.
+    </p>
+  </div>
+  <div class="btn-row">
+    <a class="btn btn-primary" href="perps.html">Customize it for your team →</a>
+    <a class="btn btn-ghost" href="architecture.html">How the layers fit</a>
+  </div>
+</section>
+</main>
+<footer class="footer">
+  <div class="wrap">
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Versions are the ones mm-harness pins today; check <code>package.json</code> over this page.</p>
+  </div>
+</footer>
+<script type="module" src="assets/progress.mjs?v=4"></script>
+</body>
+</html>

package/site/how-it-works.html CHANGED Viewed

@@ -5,7 +5,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>How it works — proving a change with a recipe</title>
 <meta name="description" content="How a recipe proves a change on a real MetaMask build, checks itself before handoff, and stays behind as a regression guard. The full walkthrough, step by step.">
-<link rel="stylesheet" href="assets/style.css">
+<link rel="icon" href="assets/metamask-fox.svg" type="image/svg+xml">
+<link rel="stylesheet" href="assets/style.css?v=4">
 </head>
 <body data-progress-page="start">
 <a class="skip" href="#steps">Skip to the walkthrough</a>
@@ -13,18 +14,16 @@
 <header class="topbar">
   <div class="wrap topbar-inner">
     <a class="brand" href="index.html">
-      <span class="brand-mark" aria-hidden="true"></span>
+      <img class="brand-mark" src="assets/metamask-fox.svg" alt="" width="22" height="22">
       <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
       <a class="nav-cta" href="index.html#prompt">Quick start</a>
       <a href="how-it-works.html" aria-current="page">How it works</a>
-      <a href="recipes.html">Recipe anatomy</a>
-      <a href="perps.html">Perps</a>
+      <a href="perps.html">Team / Perps</a>
       <a href="cheatsheet.html">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
       <a href="tutorials/index.html">Tutorials</a>
-      <a href="reviewers.html">For Reviewers</a>
     </nav>
   </div>
 </header>
@@ -55,7 +54,7 @@
     <span>progress saves in this browser</span>
   </div>
   <p style="margin-top:.9rem;opacity:.7;font-size:.9rem;max-width:60ch">
-    A proposal for how agents can code at MetaMask — offered for teams to try, not an official standard.
+    A proposal for how agents can code at MetaMask — offered for teams to try.
   </p>
 </section>
@@ -663,9 +662,9 @@ artifacts (6):
   <h2>Next</h2>
   <div class="grid grid-3">
     <div class="card">
-      <h3>What a recipe is</h3>
+      <h3>Recipe anatomy</h3>
       <p>The graph, the intents, the assertions, and the test of whether yours is worth keeping.</p>
-      <p><a href="recipes.html">Recipes →</a></p>
+      <p><a href="recipes.html">Read the anatomy →</a></p>
     </div>
     <div class="card">
       <h3>Your team's library</h3>
@@ -688,6 +687,6 @@ artifacts (6):
   </div>
 </footer>
-<script type="module" src="assets/progress.mjs"></script>
+<script type="module" src="assets/progress.mjs?v=4"></script>
 </body>
 </html>

package/site/index.html CHANGED Viewed

@@ -5,14 +5,15 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Recipes — build with proof, not hope</title>
 <meta name="description" content="A skill drives the change. The recipe proves it on a real MetaMask build as it is written, self-checked in the same context and kept as a regression guard.">
-<link rel="stylesheet" href="assets/style.css">
+<link rel="icon" href="assets/metamask-fox.svg" type="image/svg+xml">
+<link rel="stylesheet" href="assets/style.css?v=4">
 </head>
 <body>
 <a class="skip" href="#prompt">Skip to the prompt</a>
 <main class="lobby">
   <div class="lobby-inner">
-    <span class="lobby-mark" aria-hidden="true"></span>
+    <img class="lobby-mark" src="assets/metamask-fox.svg" alt="" width="52" height="52">
     <span class="eyebrow">Proven as it's built</span>
     <h1>Build agentically, with confidence.</h1>
@@ -64,14 +65,18 @@ instead of improvising.
    `--preflight-mode` is an internal adapter flag, not a public launch flag.
 6. On Extension run `mm-harness fixtures set`. On Mobile include the same
    `--device &lt;UUID-or-serial&gt;` used for launch. Wait for it to succeed.
-7. Install the skills — they are how the work actually gets driven. The
-   installer reads from LOCAL CLONES, so clone the sources first and add both
-   exports to my shell rc:
+7. Install the skills — they are how the work actually gets driven. First
+   inspect `METAMASK_SKILLS_DIR` and `CONSENSYS_SKILLS_DIR`, then check the
+   expected local layout below. Reuse every valid existing clone. For each
+   missing source, show me the proposed path and ask before cloning:
      `git clone https://github.com/MetaMask/skills.git ~/dev/metamask/skills`
-     `export METAMASK_SKILLS_DIR=~/dev/metamask/skills`
-   Then the internal overlay, which needs access to the Consensys org:
      `git clone git@github.com:Consensys/skills.git ~/dev/Consensys/skills`
+   The internal overlay needs access to the Consensys org. Export the paths in
+   the current shell for setup:
+     `export METAMASK_SKILLS_DIR=~/dev/metamask/skills`
      `export CONSENSYS_SKILLS_DIR=~/dev/Consensys/skills`
+   Never edit `.zshrc`, `.bashrc`, or another shell startup file unless I
+   explicitly consent; ask separately if I want these exports persisted.
    If that clone fails, tell me — I may not have access, and the next step
    depends on it. Then, from inside the checkout:
      `yarn metamask-skills list --maturity experimental`   everything installable
@@ -107,7 +112,7 @@ exact error.</code></pre></div>
         </p>
         <div class="tabs">
-          <div class="tablist" role="tablist" aria-label="Choose what to do">
+          <div class="tablist" role="tablist" aria-label="Choose what to do" hidden>
             <button type="button" role="tab" id="tab-review" class="tab" aria-controls="panel-review" aria-selected="true" tabindex="0">Review a PR</button>
             <button type="button" role="tab" id="tab-fix" class="tab" aria-controls="panel-fix" aria-selected="false" tabindex="-1">Fix a bug</button>
             <button type="button" role="tab" id="tab-build" class="tab" aria-controls="panel-build" aria-selected="false" tabindex="-1">Build a feature</button>
@@ -128,7 +133,7 @@ per-AC verdict table, the overall verdict, and the artifact paths. Do not post
 anything on the PR.</code></pre></div>
           </div>
-          <div class="qs-panel" role="tabpanel" id="panel-fix" aria-labelledby="tab-fix" tabindex="0" hidden>
+          <div class="qs-panel" role="tabpanel" id="panel-fix" aria-labelledby="tab-fix" tabindex="0">
             <p class="qs-panel-why">
               <code>mms-recipe-cook</code>, classified as <code>fix-bug</code>. It lists the
               compatible checklist templates and stops for your pick, then works on a local task
@@ -144,7 +149,7 @@ Then fix it and re-run the same recipe until it passes. Show me the recipe
 status, the per-node results, and the artifact paths.</code></pre></div>
           </div>
-          <div class="qs-panel" role="tabpanel" id="panel-build" aria-labelledby="tab-build" tabindex="0" hidden>
+          <div class="qs-panel" role="tabpanel" id="panel-build" aria-labelledby="tab-build" tabindex="0">
             <p class="qs-panel-why">
               <code>mms-recipe-cook</code>, classified as <code>dev</code>. Same flow: it lists the
               compatible templates, stops for your pick, and keeps the diff uncommitted until you
@@ -169,11 +174,11 @@ results, and the artifact paths.</code></pre></div>
     </div>
     <p class="lobby-fine">
-      A proposal for how agents can code at MetaMask — offered for teams to try, not an official standard.
+      A proposal for how agents can code at MetaMask — offered for teams to try.
     </p>
   </div>
 </main>
-<script type="module" src="assets/progress.mjs"></script>
+<script type="module" src="assets/progress.mjs?v=4"></script>
 </body>
 </html>

package/site/perps.html CHANGED Viewed

@@ -3,9 +3,10 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Perps recipes — MetaMask recipe workflow</title>
-<meta name="description" content="Install the shared MetaMask Perps recipe library and run live, testnet-first proof across Extension, Mobile, and Core.">
-<link rel="stylesheet" href="assets/style.css">
+<title>Team / Perps — customize the harness for your team</title>
+<meta name="description" content="Every team points the harness at its own recipe library. The MetaMask Perps library is the worked example: recipes, actions, checklist templates, and the team's own knowledge.">
+<link rel="icon" href="assets/metamask-fox.svg" type="image/svg+xml">
+<link rel="stylesheet" href="assets/style.css?v=4">
 </head>
 <body>
 <a class="skip" href="#setup">Skip to setup</a>
@@ -13,42 +14,43 @@
 <header class="topbar">
   <div class="wrap topbar-inner">
     <a class="brand" href="index.html">
-      <span class="brand-mark" aria-hidden="true"></span>
+      <img class="brand-mark" src="assets/metamask-fox.svg" alt="" width="22" height="22">
       <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
       <a class="nav-cta" href="index.html#prompt">Quick start</a>
       <a href="how-it-works.html">How it works</a>
-      <a href="recipes.html">Recipe anatomy</a>
-      <a href="perps.html" aria-current="page">Perps</a>
+      <a href="perps.html" aria-current="page">Team / Perps</a>
       <a href="cheatsheet.html">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
       <a href="tutorials/index.html">Tutorials</a>
-      <a href="reviewers.html">For Reviewers</a>
     </nav>
   </div>
 </header>
 <main>
 <section class="wrap hero" style="padding-bottom:1rem">
-  <span class="eyebrow">Shared MetaMask recipe library</span>
-  <h1>Prove Perps changes in the real product</h1>
+  <span class="eyebrow">Customization</span>
+  <h1>Make it your team's harness</h1>
   <p class="lede">
-    The private Perps library gives Extension, Mobile, and Core one set of small, parameterized
-    recipes for live UI journeys, controller state, analytics, performance, and testnet mutations.
+    The harness ships an execution standard and a deliberately small bundled library. Everything that
+    is specific to what <em>you</em> work on — the journeys, the assertions, the checklists, the review
+    knowledge — lives in a library you own and point the harness at. MetaMask Perps is the worked
+    example on this page.
   </p>
   <div class="hero-meta">
-    <span>library name: perps</span>
-    <span>defaults to testnet</span>
-    <span>requires repository access</span>
+    <span>per team</span>
+    <span>per engineer</span>
+    <span>one env var</span>
   </div>
 </section>
 <section class="wrap">
   <div class="doctrine">
     <p>
-      <span class="k">The harness supplies the execution standard; the Perps library supplies the domain proof.</span>
-      Keep the shared library small: compose or repair the closest recipe before creating another one.
+      <span class="k">The harness supplies the execution standard; your library supplies the domain.</span>
+      A team shares one library. An engineer can add their own on top. Neither requires a change to
+      the harness.
     </p>
   </div>
@@ -60,11 +62,11 @@
         <tr>
           <td><code>mm-harness</code></td>
           <td>Launch, typed actions, graph execution, screenshots, video, traces, and artifact contracts.</td>
-          <td>Ticket-specific Perps scenarios.</td>
+          <td>Anything specific to one team's domain.</td>
         </tr>
         <tr>
-          <td><code>perps</code> library</td>
-          <td>Reusable Perps setup, journeys, assertions, cleanup, and platform variants.</td>
+          <td>Your library</td>
+          <td>Reusable setup, journeys, assertions, cleanup, platform variants, and checklist templates.</td>
           <td>Wallet credentials, generated evidence, or product source.</td>
         </tr>
         <tr>
@@ -78,56 +80,102 @@
 </section>
 <section class="wrap">
-  <h2 id="setup">Install and discover it</h2>
+  <h2 id="setup">Point the harness at a library</h2>
   <p>
-    Run these commands from the MetaMask product checkout you want to exercise. The repository is
-    private; a clone failure means your GitHub account needs access.
+    One environment variable does it. The Perps library is private, so start by asking its owners for
+    access — a clone failure means your GitHub account does not have it yet.
   </p>
-  <div class="cmd"><pre><code><span class="p">$ </span>npm i -g @deeeed/metamask-harness@latest
-<span class="p">$ </span>git clone git@github.com:MetaMask/experimental-metamask-recipe-perps.git \
+  <div class="cmd"><pre><code><span class="p">$ </span>git clone git@github.com:MetaMask/experimental-metamask-recipe-perps.git \
     "$HOME/shared-library/metamask-recipe-perps"
-<span class="p">$ </span>mm-harness run --list \
-    --library "perps=$HOME/shared-library/metamask-recipe-perps"</code></pre></div>
+<span class="p">$ </span>export RECIPE_LIBRARY_PATH="perps=$HOME/shared-library/metamask-recipe-perps"
+<span class="p">$ </span>mm-harness run --list</code></pre></div>
   <p>
-    If the checkout already exists and is clean, update it with <code>git pull --ff-only</code>.
-    Preserve and report a dirty checkout instead of overwriting it. Keep <code>--library</code> on each
-    command so separate tool shells do not lose an exported variable.
+    <code>name=path</code> gives the source its alias; without one the directory name is used. Separate
+    several libraries with <code>:</code> — order is precedence, first wins:
   </p>
+  <div class="cmd"><pre><code><span class="p">$ </span>export RECIPE_LIBRARY_PATH="mine=$HOME/my-recipes:perps=$HOME/shared-library/metamask-recipe-perps"</code></pre></div>
+  <p>
+    Use <code>--library name=/path</code> for a single command instead — useful when a tool shell loses
+    an exported variable. Resolution follows your library order, then the bundled MetaMask library.
+  </p>
+  <div class="note blue">
+    <span class="note-title">Your own library, with no configuration</span>
+    <p>
+      A directory at <code>~/.farmslot/recipe-library</code> is picked up automatically as
+      <code>personal</code> when you set no library at all. It is a fallback, not an addition: as soon
+      as <code>RECIPE_LIBRARY_PATH</code> or <code>--library</code> is set, only those sources are used.
+      List it explicitly to keep both.
+    </p>
+  </div>
   <div class="note blue">
     <span class="note-title">Discovery is adapter-aware</span>
     <p>
       The list shows only recipes runnable in the current product checkout. A recipe marked
-      <code>[perps]</code> came from the shared library; <code>[metamask]</code> means it ships with the
+      <code>[perps]</code> came from that library; <code>[metamask]</code> means it ships with the
       harness. Read the selected platform variant with <code>--describe</code> before running it.
     </p>
   </div>
 </section>
+<section class="wrap">
+  <h2>What a team library actually holds</h2>
+  <p>
+    Every path below is real, from the Perps library. Copy the shape, not the contents — it is the
+    reference structure for a MetaMask team building its own.
+  </p>
+  <div class="cmd"><pre><code>manifests/extension.action-manifest.json     types the actions you add
+actions/extension/perps/                     domain actions the product needs
+recipes/mobile/perps/                        per-adapter journeys
+recipes/extension/perps/
+recipes/core/perps/
+checklists/dev/                              your own Recipe Cook checklist templates
+checklists/fix-bug/
+docs/                                        the knowledge: authoring rules,
+                                             performance evidence, analytics</code></pre></div>
+  <p>
+    The <code>docs/</code> and <code>checklists/</code> directories are the part teams underestimate.
+    They are how a team's hard-won conventions — how performance evidence is gathered here, which
+    analytics events matter, what a finished task looks like — stop living in one engineer's head.
+  </p>
+  <div class="note">
+    <span class="note-title">Review knowledge lives with the skills</span>
+    <p>
+      One team surface sits outside the recipe library: the static antipattern packs the PR QA review
+      reads, which ship with the skills as
+      <code>references/antipatterns/&lt;repo&gt;/&lt;pack&gt;.md</code>. Today there is a
+      <code>perps</code> pack for Mobile, Extension, and Core, and a Mobile-only
+      <code>unit-vs-cv</code> pack. A pack is advisory: it never changes an acceptance-criterion
+      verdict.
+    </p>
+  </div>
+</section>
 <section class="wrap">
   <h2>Your first live proof</h2>
   <p>
     Complete <a href="how-it-works.html#steps">the walkthrough</a> first so the app, device, and wallet fixture are
-    ready. Then use a read-only recipe as the first proof.
+    ready. With <code>RECIPE_LIBRARY_PATH</code> exported, the library's recipes are just names.
   </p>
   <h3>Extension or Mobile</h3>
-  <div class="cmd"><pre><code><span class="p">$ </span>mm-harness run perps.open-market --describe \
-    --library "perps=$HOME/shared-library/metamask-recipe-perps"
-<span class="p">$ </span>mm-harness run perps.open-market network=testnet market=BTC --plan \
-    --library "perps=$HOME/shared-library/metamask-recipe-perps"
+  <div class="cmd"><pre><code><span class="p">$ </span>mm-harness run perps.open-market --describe
+<span class="p">$ </span>mm-harness run perps.open-market network=testnet market=BTC --plan
 <span class="p">$ </span>mm-harness run perps.open-market network=testnet market=BTC \
-    --record-video=full-run --artifacts-dir ./perps-open-market-evidence \
-    --library "perps=$HOME/shared-library/metamask-recipe-perps"</code></pre></div>
+    --record-video=full-run --artifacts-dir ./perps-open-market-evidence</code></pre></div>
   <h3>Core</h3>
-  <div class="cmd"><pre><code><span class="p">$ </span>mm-harness run perps.snapshot-market --describe \
-    --library "perps=$HOME/shared-library/metamask-recipe-perps"
+  <div class="cmd"><pre><code><span class="p">$ </span>mm-harness run perps.snapshot-market --describe
 <span class="p">$ </span>mm-harness run perps.snapshot-market network=testnet market=BTC \
-    --artifacts-dir ./perps-market-evidence \
-    --library "perps=$HOME/shared-library/metamask-recipe-perps"</code></pre></div>
+    --artifacts-dir ./perps-market-evidence</code></pre></div>
   <p>
     A passing run writes <code>summary.json</code>, per-node results in <code>trace.json</code>, and an
@@ -137,7 +185,11 @@
 </section>
 <section class="wrap">
-  <h2>Choose the recipe that owns the claim</h2>
+  <h2>What the Perps team put in theirs</h2>
+  <p>
+    A sample of the library's recipes, as an idea of the granularity that works: small, parameterized,
+    composed rather than duplicated.
+  </p>
   <div class="table-scroll">
     <table>
       <thead><tr><th>Claim</th><th>Recipe</th><th>Platforms</th></tr></thead>
@@ -164,8 +216,9 @@
 </section>
 <section class="wrap">
-  <h2>Maintain the proof, not a pile of scenarios</h2>
+  <h2>Starting your team's library</h2>
   <ol>
+    <li>Create a repository with the directory shape above. It holds no accounts, fixtures, credentials, or generated evidence.</li>
     <li>Parameterize stable choices such as market, side, order type, and network.</li>
     <li>Compose existing setup, assertion, and cleanup recipes before adding a new top-level recipe.</li>
     <li>Add a platform variant only when the products genuinely differ.</li>
@@ -177,10 +230,15 @@
     <li>Re-run every caller after a shared node changes and attach the fresh evidence.</li>
   </ol>
+  <p>
+    Keep it small. Compose or repair the closest recipe before creating another one — a library that
+    grows a scenario per ticket stops being maintainable faster than the product does.
+  </p>
   <div class="btn-row">
     <a class="btn btn-primary" href="tutorials/v3.html">Install skills and the library →</a>
+    <a class="btn btn-ghost" href="ecosystem.html">Where this sits in the stack</a>
     <a class="btn btn-ghost" href="recipes.html">How recipes prove claims</a>
-    <a class="btn btn-ghost" href="reviewers.html">How to review evidence</a>
   </div>
 </section>
 </main>
@@ -191,6 +249,6 @@
     <p>Written against the shared MetaMask Perps recipe library. Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
-<script type="module" src="assets/progress.mjs"></script>
+<script type="module" src="assets/progress.mjs?v=4"></script>
 </body>
 </html>

package/site/recipes.html CHANGED Viewed

@@ -5,7 +5,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>What is a recipe?</title>
 <meta name="description" content="The anatomy of a recipe: a JSON graph of typed actions, human-authored intent, first-class assertions, and a verdict derived from the trace.">
-<link rel="stylesheet" href="assets/style.css">
+<link rel="icon" href="assets/metamask-fox.svg" type="image/svg+xml">
+<link rel="stylesheet" href="assets/style.css?v=4">
 </head>
 <body data-progress-page="recipes">
 <a class="skip" href="#anatomy">Skip to the anatomy</a>
@@ -13,18 +14,16 @@
 <header class="topbar">
   <div class="wrap topbar-inner">
     <a class="brand" href="index.html">
-      <span class="brand-mark" aria-hidden="true"></span>
+      <img class="brand-mark" src="assets/metamask-fox.svg" alt="" width="22" height="22">
       <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
       <a class="nav-cta" href="index.html#prompt">Quick start</a>
       <a href="how-it-works.html">How it works</a>
-      <a href="recipes.html" aria-current="page">Recipe anatomy</a>
-      <a href="perps.html">Perps</a>
+      <a href="perps.html">Team / Perps</a>
       <a href="cheatsheet.html">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
       <a href="tutorials/index.html">Tutorials</a>
-      <a href="reviewers.html">For Reviewers</a>
     </nav>
   </div>
 </header>
@@ -419,6 +418,6 @@
   </div>
 </footer>
-<script type="module" src="assets/progress.mjs"></script>
+<script type="module" src="assets/progress.mjs?v=4"></script>
 </body>
 </html>