@deeeed/metamask-harness 0.33.2 → 0.34.0

package/site/tutorials/v3.html

@@ -19,6 +19,7 @@
     <nav class="nav" aria-label="Main">
       <a href="../index.html">Start Here</a>
       <a href="../recipes.html">Recipes</a>
+      <a href="../perps.html">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
       <a href="index.html" aria-current="page">Tutorials</a>
@@ -84,6 +85,46 @@
 <section class="wrap">
   <h2 id="steps">Set it up</h2>
 
+  <div class="agent-card">
+    <h3 style="margin-top:0">Paste this into your agent</h3>
+    <div class="cmd cmd-hero"><pre><code>Task: install the latest recipe skills and shared MetaMask Perps recipe library,
+then prove one real recipe runs end to end.
+
+1. Work from the MetaMask product checkout I started you in. Run
+   `npm i -g @deeeed/metamask-harness@latest` and `mm-harness --version`.
+2. Install the latest Consensys recipe skills into this checkout:
+   `yarn skills --maturity experimental --include
+   agentic/recipe-cook,agentic/recipe-quality --save`
+   This command updates the skills sources before syncing. Show me that
+   recipe-cook and recipe-quality were installed.
+3. Use this exact library directory:
+   `$HOME/shared-library/metamask-recipe-perps`.
+   If it does not exist, clone
+   `git@github.com:MetaMask/experimental-metamask-recipe-perps.git` there.
+   If it exists and is clean, update it with `git pull --ff-only`; if it is
+   dirty, preserve it and report that instead of changing its files.
+   If cloning reports 404 or permission denied, stop and tell me that repository
+   access is missing; do not search for a substitute repository.
+4. Run `mm-harness run --list --library
+   "perps=$HOME/shared-library/metamask-recipe-perps"` and show me the recipes
+   tagged `[perps]`. Use this explicit `--library` on every later command; do not
+   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.
+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.
+   For a Perps recipe use `network=testnet market=BTC`. Never place an order or
+   use mainnet in this setup proof.
+8. Show me summary.json status, every trace.json node result, and all artifact
+   paths. Then confirm the checkout is ready for a bug-fix task using the
+   installed recipe-cook skill.</code></pre></div>
+  </div>
+
   <ol class="steps">
     <li class="step" data-step="skills">
       <div class="step-head">
@@ -91,7 +132,7 @@
         <h3 class="step-title" id="t3-skills">Install the skills into your checkout</h3>
       </div>
       <p class="step-why">Run this from the product checkout you work in.</p>
-      <div class="cmd"><pre><code><span class="p">$ </span>yarn skills --include agentic/recipe-cook,agentic/recipe-quality --save</code></pre></div>
+      <div class="cmd"><pre><code><span class="p">$ </span>yarn skills --maturity experimental --include agentic/recipe-cook,agentic/recipe-quality --save</code></pre></div>
       <p class="step-why">
         The agentic skills carry <code>experimental</code> maturity, so they are visible only when
         experimental skills are enabled. <code>recipe-cook</code> is the one you want first — it owns
@@ -205,7 +246,7 @@ 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.26+.</p>
+    <p>Verified against mm-harness 0.33+.</p>
   </div>
 </footer>
 

package/site/tutorials/v4.html

@@ -19,6 +19,7 @@
     <nav class="nav" aria-label="Main">
       <a href="../index.html">Start Here</a>
       <a href="../recipes.html">Recipes</a>
+      <a href="../perps.html">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
       <a href="index.html" aria-current="page">Tutorials</a>
@@ -186,7 +187,7 @@
 <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.26+.</p>
+    <p>Verified against mm-harness 0.33+.</p>
   </div>
 </footer>
 

package/site/tutorials/v5.html

@@ -19,6 +19,7 @@
     <nav class="nav" aria-label="Main">
       <a href="../index.html">Start Here</a>
       <a href="../recipes.html">Recipes</a>
+      <a href="../perps.html">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
       <a href="index.html" aria-current="page">Tutorials</a>
@@ -154,7 +155,7 @@
 <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.26+.</p>
+    <p>Verified against mm-harness 0.33+.</p>
   </div>
 </footer>
 

package/site/tutorials/v6.html

@@ -19,6 +19,7 @@
     <nav class="nav" aria-label="Main">
       <a href="../index.html">Start Here</a>
       <a href="../recipes.html">Recipes</a>
+      <a href="../perps.html">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
       <a href="index.html" aria-current="page">Tutorials</a>
@@ -156,7 +157,7 @@
 <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.26+.</p>
+    <p>Verified against mm-harness 0.33+.</p>
   </div>
 </footer>
 

package/site/tutorials/v7.html

@@ -19,6 +19,7 @@
     <nav class="nav" aria-label="Main">
       <a href="../index.html">Start Here</a>
       <a href="../recipes.html">Recipes</a>
+      <a href="../perps.html">Perps</a>
       <a href="../cheatsheet.html">Cheatsheet</a>
       <a href="../architecture.html">Architecture</a>
       <a href="index.html" aria-current="page">Tutorials</a>
@@ -175,7 +176,7 @@
 <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.26+.</p>
+    <p>Verified against mm-harness 0.33+.</p>
   </div>
 </footer>