@deeeed/metamask-harness 0.33.2 → 0.34.0

package/library/recipes/mobile/perps/performance.homepage.ios-cold-disk-cache.recipe.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "iOS Homepage Perps cold disk-cache proof",
+  "description": "Warms the Perps disk cache without creating exchange state, restarts the assigned iOS app, and validates disk hydration plus fresh trending content at the visible Homepage endpoint.",
+  "workflow": {
+    "entry": "ensure-wallet",
+    "nodes": {
+      "ensure-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Use the existing simulator fixture",
+        "next": "open-wallet-home-before"
+      },
+      "open-wallet-home-before": {
+        "action": "ui.navigate",
+        "page": "home",
+        "intent": "Open Wallet Home so current Perps streams are cached",
+        "timeout_ms": 30000,
+        "next": "wait-perps-before"
+      },
+      "wait-perps-before": {
+        "action": "ui.wait_for",
+        "test_id": "homepage-section-title-perps",
+        "expected": "present",
+        "intent": "Require Perps content before restart",
+        "timeout_ms": 30000,
+        "next": "show-perps-before"
+      },
+      "show-perps-before": {
+        "action": "ui.scroll",
+        "test_id": "homepage-section-title-perps",
+        "scroll_into_view": true,
+        "animated": true,
+        "settle": true,
+        "intent": "Make current Perps data visible and cacheable",
+        "timeout_ms": 30000,
+        "next": "warm-disk-cache"
+      },
+      "warm-disk-cache": {
+        "action": "wait",
+        "duration_ms": 2500,
+        "intent": "Allow persisted stream cache writes to settle",
+        "next": "start-performance-capture"
+      },
+      "start-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "start",
+        "intent": "Start evidence before cold process restart",
+        "next": "restart-app"
+      },
+      "restart-app": {
+        "action": "app.lifecycle",
+        "command": "restart",
+        "settle_ms": 15000,
+        "runtime_ready_timeout_ms": 60000,
+        "intent": "Cold-restart while preserving persisted app data",
+        "next": "unlock-after-restart"
+      },
+      "unlock-after-restart": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Restore the same fixture after cold launch",
+        "next": "open-wallet-home-after"
+      },
+      "open-wallet-home-after": {
+        "action": "ui.navigate",
+        "page": "home",
+        "intent": "Return to Wallet Home after disk hydration",
+        "timeout_ms": 30000,
+        "next": "wait-perps-after"
+      },
+      "wait-perps-after": {
+        "action": "ui.wait_for",
+        "test_id": "homepage-section-title-perps",
+        "expected": "present",
+        "intent": "Require the Perps section after cold launch",
+        "timeout_ms": 30000,
+        "next": "show-perps-after"
+      },
+      "show-perps-after": {
+        "action": "ui.scroll",
+        "test_id": "homepage-section-title-perps",
+        "scroll_into_view": true,
+        "animated": true,
+        "settle": true,
+        "intent": "Bring disk-hydrated/fresh content into the viewport",
+        "timeout_ms": 30000,
+        "next": "capture-after"
+      },
+      "capture-after": {
+        "action": "ui.screenshot",
+        "path": "screenshots/ios-homepage-perps-cold-disk-cache.png",
+        "intent": "Preserve visible cold disk-cache content",
+        "next": "settle-frame"
+      },
+      "settle-frame": {
+        "action": "wait",
+        "duration_ms": 2500,
+        "intent": "Allow the visible next-frame checkpoint to finish",
+        "next": "finish-performance-capture"
+      },
+      "finish-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "required_stages": [
+          "disk_cache_hydrated",
+          "viewport_demand",
+          "socket_received",
+          "react_commit",
+          "next_frame_checkpoint"
+        ],
+        "required_lifecycles": ["cold_disk_cache"],
+        "required_sources": ["disk_cache", "fresh_socket"],
+        "required_fresh_content_variants": ["trending"],
+        "intent": "Require cold disk hydration and fresh visible content",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/performance.homepage.ios-cold-no-cache.recipe.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "iOS Homepage Perps cold start without cache proof",
+  "description": "Clears only Perps performance caches, restarts the assigned iOS app without replacing wallet state, and validates fresh trending content at the visible Homepage endpoint.",
+  "workflow": {
+    "entry": "ensure-wallet",
+    "nodes": {
+      "ensure-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Preserve and unlock the existing simulator fixture",
+        "next": "start-performance-capture"
+      },
+      "start-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "start",
+        "intent": "Start evidence before cache removal and process restart",
+        "next": "clear-perps-caches"
+      },
+      "clear-perps-caches": {
+        "action": "metamask.perps.clear_performance_caches",
+        "intent": "Remove only Perps persisted market and user snapshots",
+        "next": "restart-app"
+      },
+      "restart-app": {
+        "action": "app.lifecycle",
+        "command": "restart",
+        "settle_ms": 15000,
+        "runtime_ready_timeout_ms": 60000,
+        "intent": "Cold-restart the assigned iOS app without deleting wallet state",
+        "next": "unlock-after-restart"
+      },
+      "unlock-after-restart": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Restore the same fixture after the cold process launch",
+        "next": "open-wallet-home"
+      },
+      "open-wallet-home": {
+        "action": "ui.navigate",
+        "page": "home",
+        "intent": "Open Wallet Home after the no-cache cold launch",
+        "timeout_ms": 30000,
+        "next": "wait-perps-section"
+      },
+      "wait-perps-section": {
+        "action": "ui.wait_for",
+        "test_id": "homepage-section-title-perps",
+        "expected": "present",
+        "intent": "Require the Perps section after cold launch",
+        "timeout_ms": 30000,
+        "next": "show-perps-section"
+      },
+      "show-perps-section": {
+        "action": "ui.scroll",
+        "test_id": "homepage-section-title-perps",
+        "scroll_into_view": true,
+        "animated": true,
+        "settle": true,
+        "intent": "Bring fresh Perps content into the viewport",
+        "timeout_ms": 30000,
+        "next": "capture-after"
+      },
+      "capture-after": {
+        "action": "ui.screenshot",
+        "path": "screenshots/ios-homepage-perps-cold-no-cache.png",
+        "intent": "Preserve visible cold-no-cache content",
+        "next": "settle-frame"
+      },
+      "settle-frame": {
+        "action": "wait",
+        "duration_ms": 2500,
+        "intent": "Allow the visible next-frame checkpoint to finish",
+        "next": "finish-performance-capture"
+      },
+      "finish-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "required_stages": [
+          "viewport_demand",
+          "socket_received",
+          "react_commit",
+          "next_frame_checkpoint"
+        ],
+        "required_lifecycles": ["cold_no_cache"],
+        "required_sources": ["fresh_socket"],
+        "required_fresh_content_variants": ["trending"],
+        "intent": "Require cold-no-cache lifecycle and fresh visible trending content",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.33.2",
+  "version": "0.34.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"

package/scripts/site-contrast.mjs

@@ -342,7 +342,9 @@ async function checkBehavior(browserEndpoint, port, pages) {
             },
           },
         });
-        const button = document.querySelector('.prompt .copy');
+        // The onboarding prompt is the hero call to action; it was a collapsible
+        // before, so accept either shape.
+        const button = document.querySelector('.cmd-hero .copy, .prompt .copy');
         if (!button) throw new Error('copy button was not initialized');
         button.click();
         await new Promise((resolve) => setTimeout(resolve, 25));
@@ -390,6 +392,17 @@ async function checkBehavior(browserEndpoint, port, pages) {
 
   for (const relative of pages) {
     await withPage(browserEndpoint, `${base}${relative}`, async (page) => {
+      const copyControls = await page.evaluate(String.raw`
+        (() => ({
+          blocks: document.querySelectorAll('.cmd').length,
+          buttons: document.querySelectorAll('.cmd > .copy').length,
+        }))()
+      `);
+      if (copyControls.blocks !== copyControls.buttons) {
+        throw new Error(
+          `${relative} initialized ${copyControls.buttons} copy buttons for ${copyControls.blocks} command blocks`,
+        );
+      }
       const broken = await page.evaluate(String.raw`
         (async () => {
           const links = [...document.querySelectorAll('a[href]')]
@@ -413,6 +426,26 @@ async function checkBehavior(browserEndpoint, port, pages) {
       if (broken.length) {
         throw new Error(`${relative} has broken internal links: ${broken.join(', ')}`);
       }
+      for (const width of [834, 390]) {
+        await page.send('Emulation.setDeviceMetricsOverride', {
+          width,
+          height: 1000,
+          deviceScaleFactor: 1,
+          mobile: false,
+        });
+        const layout = await page.evaluate(String.raw`
+          (() => {
+            const header = document.querySelector('.topbar')?.getBoundingClientRect();
+            const nav = document.querySelector('.nav')?.getBoundingClientRect();
+            return {
+              navOverflow: Boolean(header && nav && nav.bottom > header.bottom + 1),
+            };
+          })()
+        `);
+        if (layout.navOverflow) {
+          throw new Error(`${relative} navigation escapes its header at ${width}px`);
+        }
+      }
     });
   }
 }

package/site/architecture.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" aria-current="page">Architecture</a>
       <a href="tutorials/index.html">Tutorials</a>
@@ -177,6 +178,12 @@
     these contracts. Evidence returns in the same shape either way, so a fleet result is reviewable by
     whoever wrote the recipe. Parity is structural: one spec, both sides.
   </p>
+  <p>
+    That is what makes the trust layer scale. A proof written once becomes a permanent guard: it is
+    replayed by whoever changes that code next, it stays readable as evidence no matter who or what ran
+    it, and the bug it was written for cannot quietly return. Review does not get weaker as volume
+    grows.
+  </p>
   <p>The seam shows in the CLI's own help — the flags a control plane supplies:</p>
   <div class="out">managed trust boundary (not needed for normal runs; Farmslot supplies it):
   --source-trust, --source-kind, --source-name, --source-digest,
@@ -196,7 +203,10 @@
 
 <section class="wrap">
   <h2 id="loop">The improvement loop</h2>
-  <p>The stack is arranged so each run can leave the next one better informed.</p>
+  <p>
+    A recipe guards the regression it was written for. This is how a team catches the ones nobody has
+    written down yet — each run leaving the next one better informed.
+  </p>
 
   <div class="doctrine">
     <p>
@@ -465,7 +475,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/assets/style.css

@@ -136,9 +136,18 @@ main { padding-bottom: 6rem; }
 
 .brand-name { font-family: var(--mono); font-size: 0.95rem; }
 
-.nav { display: flex; gap: 0.3rem; margin-left: auto; flex-wrap: wrap; }
+.nav {
+  display: flex;
+  gap: 0.3rem;
+  margin-left: auto;
+  min-width: 0;
+  overflow-x: auto;
+  flex-wrap: nowrap;
+  scrollbar-width: thin;
+}
 
 .nav a {
+  flex: none;
   color: var(--text-dim);
   font-size: 0.885rem;
   font-weight: 500;
@@ -333,6 +342,16 @@ main { padding-bottom: 6rem; }
 
 @media (hover: none) { .copy { opacity: 1; } }
 
+/* The one-prompt block is a call to action: its copy control never hides, and
+   the prompt scrolls rather than pushing the page down. */
+.cmd-hero .copy { opacity: 1; }
+.cmd-hero pre {
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 22rem;
+  overflow-y: auto;
+}
+
 /* Expected-output block */
 .out {
   background: var(--bg-raised);

package/site/cheatsheet.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" aria-current="page">Cheatsheet</a>
       <a href="architecture.html">Architecture</a>
       <a href="tutorials/index.html">Tutorials</a>
@@ -37,8 +38,8 @@
     same command. Filter by what you actually work on.
   </p>
   <div class="hero-meta">
-    <span>mm-harness 0.26+</span>
-    <span>one bin, 20 commands</span>
+    <span>mm-harness 0.33+</span>
+    <span>one bin, 21 commands</span>
     <span>--json on everything</span>
   </div>
 </section>
@@ -146,15 +147,15 @@
           <tr data-platforms="all"><td>A recipe with parameters</td><td><code>mm-harness run perps.clean-market-testnet market=BTC</code></td></tr>
           <tr data-platforms="all"><td>A recipe file on disk</td><td><code>mm-harness run ./my-recipe.json</code></td></tr>
           <tr data-platforms="all"><td>Add a team recipe library</td><td><code>mm-harness run &lt;recipe&gt; --library perps=/path/to/library</code></td></tr>
-          <tr data-platforms="mobile"><td>Record video of the whole run</td><td><code>mm-harness run &lt;recipe&gt; --record-video=full-run</code></td></tr>
+          <tr data-platforms="extension mobile"><td>Record video of the whole run (Extension or iOS)</td><td><code>mm-harness run &lt;recipe&gt; --record-video=full-run</code></td></tr>
           <tr data-platforms="all"><td>Streaming progress for an agent</td><td><code>mm-harness run &lt;recipe&gt; --json-stream</code></td></tr>
           <tr data-platforms="all"><td>What did I last run, and how did it go</td><td><code>mm-harness last</code></td></tr>
         </tbody>
       </table>
     </div>
     <p class="step-why" style="font-size:.92rem">
-      iOS carries video; Extension capture is screenshots only. That asymmetry is real — do not promise
-      a reviewer a video of an extension run.
+      Extension and iOS can record full-run video through capture-helper. Android replay video is not
+      implemented yet; use screenshot evidence there.
     </p>
   </div>
 
@@ -296,7 +297,7 @@
 <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.26+.</p>
+    <p>Verified against mm-harness 0.33+.</p>
   </div>
 </footer>