@deeeed/metamask-harness 0.34.2 → 0.34.4

package/site/perps.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="index.html">Start Here</a>
-      <a href="recipes.html">Recipes</a>
+      <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="cheatsheet.html">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
@@ -108,7 +109,7 @@
 <section class="wrap">
   <h2>Your first live proof</h2>
   <p>
-    Complete <a href="index.html#steps">Start Here</a> first so the app, device, and wallet fixture are
+    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.
   </p>
 
@@ -186,8 +187,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+ and the shared MetaMask Perps recipe library.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <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>

package/site/recipes.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="index.html">Start Here</a>
-      <a href="recipes.html" aria-current="page">Recipes</a>
+      <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="cheatsheet.html">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
@@ -30,10 +31,10 @@
 
 <main>
 <section class="wrap hero" style="padding-bottom:1rem">
-  <span class="eyebrow">The central idea</span>
+  <span class="eyebrow">The trust mechanism</span>
   <h1>What is a recipe?</h1>
   <p class="lede">
-    A recipe turns "I checked, it works" into something a reviewer can verify without trusting you —
+    A recipe turns "I checked, it works" into something proved on a device as the change is made —
     and something that objects later if the behaviour breaks.
   </p>
 </section>
@@ -67,16 +68,17 @@
     worth authoring rather than checking by hand: the check survives the task.
   </p>
   <p>
-    <strong>Trust.</strong> Proven, self-checked, and still proving. Review reads evidence rather than
-    extending credit, and every gate stays yours to steer.
+    <strong>Trust.</strong> Proven, self-checked, and still proving — so the change is trustworthy
+    while it is being built. Everything downstream, review included, inherits that, and every gate
+    stays yours to steer.
   </p>
 </section>
 
 <section class="wrap">
   <h2 id="anatomy">The anatomy of a real one</h2>
   <p>
-    <code>perps.lifecycle</code> ships with the harness. Abridged here — the full graph has eighteen
-    nodes — but nothing is invented; read it all with
+    <code>perps.lifecycle</code> ships with the harness. Abridged here — the full graph runs the whole
+    lifecycle, clean state through teardown — but nothing is invented; read it all with
     <code>mm-harness run perps.lifecycle --describe</code>.
   </p>
 
@@ -108,8 +110,10 @@
         "market": "ETH",
         "state": "none",
         "intent": "Confirm ETH position state is clean",
-        "next": "place-order"
+        "next": "assert-clean-orders"
       },
+      <span class="dim">… assert clean orders …</span>
+
       "place-order": {
         "action": "metamask.perps.place_order",
         "market": "ETH", "side": "long",
@@ -244,9 +248,11 @@
   </div>
 
   <p>
-    <code>assert_positions</code> takes <code>expect_count</code>; <code>assert_orders</code> can also
-    assert a matching order's trigger price, execution mode, and reduce-only flag. Reach for the most
-    specific assertion the surface supports — a vague one passes for the wrong reasons.
+    On Core, <code>assert_positions</code> and <code>assert_orders</code> take
+    <code>expect_count</code>; the Extension and Mobile manifests do not declare it, and a recipe that
+    passes it there fails validation with exit 5. <code>assert_orders</code> can also assert a matching
+    order's trigger price, execution mode, and reduce-only flag. Reach for the most specific assertion
+    the surface supports — a vague one passes for the wrong reasons.
   </p>
 </section>
 
@@ -349,7 +355,7 @@
         <tr>
           <td>Presence check where a count belongs</td>
           <td>Still true when the bug fires the event twice, or leaves two positions open.</td>
-          <td>Use <code>exact</code> / <code>expect_count</code>.</td>
+          <td>Use <code>exact</code>; on Core, <code>expect_count</code>.</td>
         </tr>
         <tr>
           <td>No starting-state assertion</td>
@@ -399,7 +405,7 @@
   </div>
 
   <div class="btn-row">
-    <a class="btn btn-primary" href="index.html#steps">Run your first recipe →</a>
+    <a class="btn btn-primary" href="how-it-works.html#steps">Run your first recipe →</a>
     <a class="btn btn-ghost" href="reviewers.html">Read the evidence it produces</a>
     <a class="btn btn-ghost" href="architecture.html">Where skills fit</a>
   </div>
@@ -408,8 +414,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+. The annotated recipe is a bundled library recipe, abridged.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>The annotated recipe is a bundled library recipe, abridged. Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/reviewers.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="index.html">Start Here</a>
-      <a href="recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="cheatsheet.html">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
@@ -357,7 +358,7 @@ Nodes: 6/6 passed
 
   <hr class="sep">
   <div class="btn-row">
-    <a class="btn btn-primary" href="index.html#steps">Produce your own bundle →</a>
+    <a class="btn btn-primary" href="how-it-works.html#steps">Produce your own bundle →</a>
     <a class="btn btn-ghost" href="architecture.html">How the pieces fit</a>
   </div>
 </section>
@@ -365,8 +366,8 @@ Nodes: 6/6 passed
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+. Example bundle is a real run with identifying values redacted.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Example bundle is a real run with identifying values redacted. Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/index.html

@@ -14,11 +14,12 @@
   <div class="wrap-wide topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -164,15 +165,15 @@
 
   <div class="btn-row">
     <a class="btn btn-primary" href="v1.html">Start with V1 →</a>
-    <a class="btn btn-ghost" href="../index.html#steps">Or the Start Here walkthrough</a>
+    <a class="btn btn-ghost" href="../how-it-works.html#steps">Or the full walkthrough</a>
   </div>
 </section>
 </main>
 
 <footer class="footer">
   <div class="wrap-wide">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v1.html

@@ -4,7 +4,7 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>V1 — Getting started with recipes</title>
-<meta name="description" content="Video one of the series: one CLI drives the wallet and proves what happened. With the same checklist as Start Here.">
+<meta name="description" content="Video one of the series: one CLI drives the wallet and proves what happened. With the same checklist as the How it works walkthrough.">
 <link rel="stylesheet" href="../assets/style.css">
 </head>
 <body data-progress-page="start">
@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -48,7 +49,7 @@
   </p>
   <div class="hero-meta">
     <span>no prerequisites</span>
-    <span>checklist shared with Start Here</span>
+    <span>checklist shared with How it works</span>
   </div>
 </section>
 
@@ -65,8 +66,8 @@
     <p>
       Same eight steps, same commands, same expected output — it is genuinely useful before the
       recording exists, which is why it is here rather than a "coming soon" page. Your progress is
-      shared with <a href="../index.html">Start Here</a>: tick a step in either place and it is ticked
-      in both. Start Here carries the longer explanations and the full "if it fails" notes for each
+      shared with <a href="../how-it-works.html">How it works</a>: tick a step in either place and it is ticked
+      in both. How it works carries the longer explanations and the full "if it fails" notes for each
       step.
     </p>
   </div>
@@ -104,7 +105,7 @@
       <p class="step-why">Install globally, confirm it resolved, then work from inside a product checkout.</p>
       <div class="cmd"><pre><code><span class="p">$ </span>npm i -g @deeeed/metamask-harness@latest
 <span class="p">$ </span>mm-harness --version</code></pre></div>
-      <div class="out">0.33.x  <span class="dim">— any 0.33 or newer</span></div>
+      <div class="out">0.34.x  <span class="dim">— any 0.34 or newer</span></div>
     </li>
 
     <li class="step" data-step="doctor">
@@ -193,7 +194,7 @@
 
   <hr class="sep">
   <div class="btn-row">
-    <a class="btn btn-primary" href="../index.html#steps">Full walkthrough, with failure notes →</a>
+    <a class="btn btn-primary" href="../how-it-works.html#steps">Full walkthrough, with failure notes →</a>
     <a class="btn btn-ghost" href="../cheatsheet.html">The cheatsheet</a>
     <a class="btn btn-ghost" href="index.html">Back to the series</a>
   </div>
@@ -202,8 +203,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v2.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -116,7 +117,7 @@
 
 <section class="wrap">
   <h2 id="steps">Follow along</h2>
-  <p>Use a bundle you produced in <a href="../index.html#steps">Start Here</a>, or any run directory.</p>
+  <p>Use a bundle you produced in <a href="../how-it-works.html#steps">the walkthrough</a>, or any run directory.</p>
 
   <ol class="steps">
     <li class="step" data-step="open">
@@ -198,8 +199,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v3.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -47,7 +48,7 @@
     that carries the recipes. Both install into a checkout.
   </p>
   <div class="hero-meta">
-    <span>prerequisite: <a href="../index.html#steps">Start Here</a></span>
+    <span>prerequisite: <a href="../how-it-works.html#steps">the walkthrough</a></span>
     <span>worked example: the perps library</span>
   </div>
 </section>
@@ -111,10 +112,12 @@ then prove one real recipe runs end to end.
    assume an `export` survives between tool shells.
 5. Run `mm-harness status`. If the app is not ready, follow its public `Next:`
    command while preserving the same device UUID or serial used during setup.
-6. Choose only a recipe actually printed by step 4. Prefer
-   `perps.open-market` on Extension/Mobile or `perps.snapshot-market` on Core.
-   If that shared recipe has no variant for this checkout, use the listed bundled
-   `wallet.smoke` (Extension/Mobile) or `runner.smoke` (Core) recipe.
+6. Choose only a recipe actually printed by step 4 for THIS checkout — the
+   `[perps]` set differs per adapter, so do not copy a name from the docs.
+   `perps.snapshot-market` is a good non-mutating pick on Core;
+   `perps.open-market` is its Extension/Mobile counterpart. If neither is in
+   your list, use the bundled `wallet.smoke` (Extension/Mobile) or
+   `runner.smoke` (Core).
 7. Run the chosen recipe with `--describe`, then `--plan`, then for real with
    `--artifacts-dir ./first-team-recipe-artifacts`. Include
    `--library "perps=$HOME/shared-library/metamask-recipe-perps"` each time.
@@ -199,7 +202,8 @@ Inspect: mm-harness run &lt;recipe&gt; --describe
   runner.smoke <span class="dim">[metamask]</span> variant=core — Proves the headless Core runner…</div>
       <p class="step-why">
         The tag is the proof: <code>[perps]</code> came from your library, <code>[metamask]</code> ships
-        with the harness. No tags from your library means it was not loaded.
+        with the harness. No tags from your library means it was not loaded. This example is a Core
+        checkout; Extension and Mobile print their own variants, so work from your list, not this one.
       </p>
       <details class="fail">
         <summary>If it fails</summary>
@@ -245,8 +249,8 @@ Inspect: mm-harness run &lt;recipe&gt; --describe
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v4.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -186,8 +187,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v5.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -154,8 +155,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v6.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -156,8 +157,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>
 

package/site/tutorials/v7.html

@@ -14,11 +14,12 @@
   <div class="wrap topbar-inner">
     <a class="brand" href="../index.html">
       <span class="brand-mark" aria-hidden="true"></span>
-      <span class="brand-name">mm-harness</span>
+      <span class="brand-name">recipes</span>
     </a>
     <nav class="nav" aria-label="Main">
-      <a href="../index.html">Start Here</a>
-      <a href="../recipes.html">Recipes</a>
+      <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">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
@@ -175,8 +176,8 @@
 
 <footer class="footer">
   <div class="wrap">
-    <p>Internal getting-started guide for the MetaMask agentic coding workflow. Not official MetaMask product documentation.</p>
-    <p>Verified against mm-harness 0.33+.</p>
+    <p>Internal getting-started guide for proving MetaMask changes with recipes. Not official MetaMask product documentation.</p>
+    <p>Sample output moves between releases; trust your terminal over this page.</p>
   </div>
 </footer>