@deeeed/metamask-harness 0.34.2 → 0.34.3

package/library/actions/extension/performance/compare_idle_navigation_memory.mjs

@@ -0,0 +1,18 @@
+import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+import {
+  compareIdleNavigation,
+  idleControlBound,
+  navigationMemoryOptions,
+} from './_navigation-memory.mjs';
+
+runAdapter((input) =>
+  withExtensionPage(input, async (page) => ({
+    action: input.action,
+    status: 'pass',
+    ...(await compareIdleNavigation(
+      page,
+      navigationMemoryOptions(input.node, 'rounds', 8),
+      idleControlBound(input.node),
+    )),
+  })),
+);

package/library/actions/extension/performance/measure_detached_dom.mjs

@@ -0,0 +1,18 @@
+import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+import {
+  detachedDomBound,
+  measureDetachedDom,
+  navigationMemoryOptions,
+} from './_navigation-memory.mjs';
+
+runAdapter((input) =>
+  withExtensionPage(input, async (page) => ({
+    action: input.action,
+    status: 'pass',
+    ...(await measureDetachedDom(
+      page,
+      navigationMemoryOptions(input.node, 'cycles', 5),
+      detachedDomBound(input.node),
+    )),
+  })),
+);

package/library/actions/extension/performance/measure_navigation_memory.mjs

@@ -0,0 +1,18 @@
+import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+import {
+  measureNavigationSlope,
+  navigationMemoryOptions,
+  navigationSlopeBounds,
+} from './_navigation-memory.mjs';
+
+runAdapter((input) =>
+  withExtensionPage(input, async (page) => ({
+    action: input.action,
+    status: 'pass',
+    ...(await measureNavigationSlope(
+      page,
+      navigationMemoryOptions(input.node),
+      navigationSlopeBounds(input.node),
+    )),
+  })),
+);

package/library/actions/mobile/app/network-control.mjs

@@ -42,6 +42,12 @@ async function defaultRun(file, args) {
   return execFileAsync(file, args, { timeout: 15_000, encoding: 'utf8' });
 }
 
+function isAppFocused(output, appId) {
+  return String(output ?? '')
+    .split('\n')
+    .some((line) => line.includes('mCurrentFocus=') && line.includes(appId));
+}
+
 export async function setMobileNetworkState(input, deps = {}) {
   const state = String(input.node?.state ?? '').toLowerCase();
   if (state !== 'offline' && state !== 'online') {
@@ -87,19 +93,26 @@ export async function setMobileNetworkState(input, deps = {}) {
       `app.network requested ${state}, but Android airplane_mode_on was ${JSON.stringify(observed)} instead of ${expected}.`,
     );
   }
-
-
-  await run(adb, [
+  const focusBefore = await run(adb, [
     '-s',
     serial,
     'shell',
-    'monkey',
-    '-p',
-    appId,
-    '-c',
-    'android.intent.category.LAUNCHER',
-    '1',
+    'dumpsys',
+    'window',
   ]);
+  if (!isAppFocused(focusBefore.stdout, appId)) {
+    await run(adb, [
+      '-s',
+      serial,
+      'shell',
+      'monkey',
+      '-p',
+      appId,
+      '-c',
+      'android.intent.category.LAUNCHER',
+      '1',
+    ]);
+  }
 
   const fallbackSettleMs = state === 'offline' ? 3000 : 10000;
   const settleMs = Number(input.node?.settle_ms ?? fallbackSettleMs);
@@ -113,10 +126,9 @@ export async function setMobileNetworkState(input, deps = {}) {
     serial,
     'shell',
     'dumpsys',
-    'activity',
-    'activities',
+    'window',
   ]);
-  if (!String(foreground.stdout ?? '').includes(appId)) {
+  if (!isAppFocused(foreground.stdout, appId)) {
     throw new Error(
       `app.network changed Android networking but ${appId} was not foregrounded afterward.`,
     );

package/library/manifests/core.action-manifest.json

@@ -728,6 +728,61 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.perps.read_snapshot": {
+      "description": "Read global market and account snapshots through the public PerpsController API used by wallet clients.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "scope": {
+            "type": "string",
+            "enum": [
+              "markets",
+              "account",
+              "all"
+            ],
+            "default": "all",
+            "description": "Select the public controller snapshot calls to execute."
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name or EVM address; defaults to dev1."
+          },
+          "account_name": {
+            "type": "string",
+            "description": "Alias for a wallet fixture account name."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet"
+          },
+          "terminal_market_data_url": {
+            "type": "string",
+            "description": "Optional full URL for the legacy Terminal market-data endpoint."
+          },
+          "terminal_global_snapshot_url": {
+            "type": "string",
+            "description": "Optional full URL for the Terminal schema-v2 global snapshot endpoint."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_snapshot",
+          "scope": "all",
+          "intent": "Read coherent Perps snapshots through the public controller API",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
     "metamask.perps.place_order": {
       "description": "core Place a real Perps order on HyperLiquid testnet by driving the headless perps controller placeOrder() through the full signing/provider path. Supports market (default), resting limit orders (order_type=limit with price/offset_pct), and resting trigger placements (stop_market | stop_limit | take_profit_market | take_profit_limit with trigger_price/trigger_offset_pct), plus reduce_only and attached/partial TP/SL (take_profit_price/take_profit_size, stop_loss_price/stop_loss_size, tpsl_linkage). Venue is selected with network (testnet default; mainnet signs with REAL funds and also requires CORE_PERPS_ALLOW_MAINNET_WRITES=1). Plain limit orders accept time_in_force GTC | ALO (post-only).",
       "schema": {

package/library/manifests/extension.action-manifest.json

@@ -1221,6 +1221,106 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.performance.measure_navigation_memory": {
+      "description": "Measure retained DOM nodes and listeners across repeated Extension navigation after forced garbage collection, using least-squares slopes and separate declared bounds.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "screen_hash": { "type": "string" },
+          "screen_test_id": { "type": "string" },
+          "return_hash": { "type": "string", "default": "#/" },
+          "cycles": { "type": "integer", "minimum": 2, "default": 8 },
+          "max_nodes_per_cycle": { "type": "number", "default": 2 },
+          "max_listeners_per_cycle": { "type": "number", "default": 4 },
+          "settle_ms": { "type": "integer", "minimum": 0, "default": 1500 },
+          "gc_settle_ms": { "type": "integer", "minimum": 0, "default": 300 },
+          "screen_timeout_ms": { "type": "integer", "minimum": 1, "default": 15000 },
+          "timeout_ms": { "type": "integer", "minimum": 1, "default": 400000 }
+        },
+        "required": ["screen_hash", "screen_test_id"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.performance.measure_navigation_memory",
+          "screen_hash": "#/settings",
+          "screen_test_id": "settings-tab-bar-grouped",
+          "return_hash": "#/",
+          "cycles": 8,
+          "max_nodes_per_cycle": 2,
+          "max_listeners_per_cycle": 4,
+          "intent": "Measure post-GC retained-memory slopes across repeated navigation.",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
+    "metamask.performance.measure_detached_dom": {
+      "description": "Compare retained detached-DOM counts before and after repeated Extension navigation, with forced garbage collection before each heap snapshot.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "screen_hash": { "type": "string" },
+          "screen_test_id": { "type": "string" },
+          "return_hash": { "type": "string", "default": "#/" },
+          "cycles": { "type": "integer", "minimum": 2, "default": 5 },
+          "max_detached_growth": { "type": "number", "default": 50 },
+          "settle_ms": { "type": "integer", "minimum": 0, "default": 1500 },
+          "gc_settle_ms": { "type": "integer", "minimum": 0, "default": 300 },
+          "screen_timeout_ms": { "type": "integer", "minimum": 1, "default": 15000 },
+          "timeout_ms": { "type": "integer", "minimum": 1, "default": 400000 }
+        },
+        "required": ["screen_hash", "screen_test_id"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.performance.measure_detached_dom",
+          "screen_hash": "#/settings",
+          "screen_test_id": "settings-tab-bar-grouped",
+          "return_hash": "#/",
+          "cycles": 5,
+          "max_detached_growth": 50,
+          "intent": "Measure detached DOM retained after navigation and forced garbage collection.",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
+    "metamask.performance.compare_idle_navigation_memory": {
+      "description": "Compare equal-duration idle and navigating Extension arms to isolate navigation-attributable listener growth after forced garbage collection.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "screen_hash": { "type": "string" },
+          "screen_test_id": { "type": "string" },
+          "return_hash": { "type": "string", "default": "#/" },
+          "rounds": { "type": "integer", "minimum": 2, "default": 8 },
+          "round_duration_ms": { "type": "integer", "minimum": 1, "default": 10000 },
+          "max_attributable_listeners_per_cycle": { "type": "number", "default": 2 },
+          "settle_ms": { "type": "integer", "minimum": 0, "default": 1500 },
+          "gc_settle_ms": { "type": "integer", "minimum": 0, "default": 300 },
+          "screen_timeout_ms": { "type": "integer", "minimum": 1, "default": 15000 },
+          "timeout_ms": { "type": "integer", "minimum": 1, "default": 400000 }
+        },
+        "required": ["screen_hash", "screen_test_id"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.performance.compare_idle_navigation_memory",
+          "screen_hash": "#/settings",
+          "screen_test_id": "settings-tab-bar-grouped",
+          "return_hash": "#/",
+          "rounds": 8,
+          "round_duration_ms": 10000,
+          "max_attributable_listeners_per_cycle": 2,
+          "intent": "Separate navigation-attributable listener growth from equal-duration idle growth.",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
     "metamask.perps.read_positions": {
       "description": "extension Read live Perps positions; without a selector, return all live positions.",
       "schema": {

package/library/recipes/core/perps/snapshot.recipe.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "MetaMask core Perps snapshots",
+  "description": "Reads global market and account snapshots through the public PerpsController API used by wallet clients. Configure CORE_PERPS_TERMINAL_GLOBAL_SNAPSHOT_URL to exercise a Terminal schema-v2 endpoint.",
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "read_snapshot",
+        "intent": "Resolve the Core checkout and report headless compatibility"
+      },
+      "read_snapshot": {
+        "action": "metamask.perps.read_snapshot",
+        "scope": "all",
+        "next": "done",
+        "intent": "Read coherent market and account snapshots through public controller methods"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/extension/performance/navigation-memory.recipe.json

@@ -0,0 +1,175 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Extension navigation retained-memory audit",
+  "description": "Measures post-GC retained nodes and listeners across eight representative Extension screens, verifies detached DOM does not grow, and separates navigation-attributable listener growth from an equal-duration idle control.",
+  "proofTargets": [
+    {
+      "id": "screen-slopes",
+      "claim": "Eight representative Extension screens remain within separate post-GC retained-node and listener growth bounds during navigation churn."
+    },
+    {
+      "id": "detached-dom",
+      "claim": "Detached DOM retained after forced garbage collection does not grow beyond the declared bound."
+    },
+    {
+      "id": "idle-control",
+      "claim": "Navigation-attributable listener growth remains within its declared bound after subtracting an equal-duration idle control."
+    }
+  ],
+  "workflow": {
+    "entry": "require-cdp",
+    "nodes": {
+      "require-cdp": {
+        "action": "cdp.target",
+        "required": true,
+        "require_reachable": true,
+        "intent": "Confirm the live Extension CDP target is reachable before measuring retained memory.",
+        "next": "ensure-unlocked"
+      },
+      "ensure-unlocked": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Ensure the representative screens are reachable from an unlocked wallet.",
+        "next": "market-detail"
+      },
+      "market-detail": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/perps/market/ETH",
+        "screen_test_id": "perps-market-detail-page",
+        "return_hash": "#/",
+        "cycles": 8,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for Perps market detail.",
+        "proves": ["screen-slopes"],
+        "next": "order-entry"
+      },
+      "order-entry": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/perps/trade/ETH?direction=long&mode=new",
+        "screen_test_id": "perps-order-entry-page",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for Perps order entry.",
+        "proves": ["screen-slopes"],
+        "next": "perps-home"
+      },
+      "perps-home": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/perps-home",
+        "screen_test_id": "perps-home-page",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for Perps home.",
+        "proves": ["screen-slopes"],
+        "next": "market-list"
+      },
+      "market-list": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/perps/market-list",
+        "screen_test_id": "market-list-view",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for the Perps market list.",
+        "proves": ["screen-slopes"],
+        "next": "perps-activity"
+      },
+      "perps-activity": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/perps/activity",
+        "screen_test_id": "perps-activity-page",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for Perps activity.",
+        "proves": ["screen-slopes"],
+        "next": "asset-details"
+      },
+      "asset-details": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/asset/0x1/",
+        "screen_test_id": "asset-price-chart",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for asset details.",
+        "proves": ["screen-slopes"],
+        "next": "swaps-bridge"
+      },
+      "swaps-bridge": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/cross-chain/swaps/prepare-bridge-page",
+        "screen_test_id": "bridge-source-button",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure the post-GC navigation slope for Swaps and Bridge.",
+        "proves": ["screen-slopes"],
+        "next": "settings-control"
+      },
+      "settings-control": {
+        "action": "metamask.performance.measure_navigation_memory",
+        "screen_hash": "#/settings",
+        "screen_test_id": "settings-tab-bar-grouped",
+        "return_hash": "#/",
+        "cycles": 6,
+        "timeout_ms": 400000,
+        "max_nodes_per_cycle": 2,
+        "max_listeners_per_cycle": 4,
+        "intent": "Measure a non-Perps control screen with the same retained-memory gate.",
+        "proves": ["screen-slopes"],
+        "next": "detached-market-detail"
+      },
+      "detached-market-detail": {
+        "action": "metamask.performance.measure_detached_dom",
+        "screen_hash": "#/perps/market/ETH",
+        "screen_test_id": "perps-market-detail-page",
+        "return_hash": "#/",
+        "cycles": 5,
+        "timeout_ms": 400000,
+        "max_detached_growth": 50,
+        "intent": "Compare retained detached DOM before and after market-detail navigation churn.",
+        "proves": ["detached-dom"],
+        "next": "idle-control-market-detail"
+      },
+      "idle-control-market-detail": {
+        "action": "metamask.performance.compare_idle_navigation_memory",
+        "screen_hash": "#/perps/market/ETH",
+        "screen_test_id": "perps-market-detail-page",
+        "return_hash": "#/",
+        "rounds": 8,
+        "round_duration_ms": 10000,
+        "timeout_ms": 400000,
+        "max_attributable_listeners_per_cycle": 2,
+        "intent": "Subtract equal-duration idle growth from the market-detail navigation slope.",
+        "proves": ["idle-control"],
+        "next": "return-home"
+      },
+      "return-home": {
+        "action": "ui.navigate",
+        "page": "home",
+        "intent": "Leave the Extension on a known screen after the audit.",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/package.json

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

package/scripts/site-contrast.mjs

@@ -351,11 +351,33 @@ async function checkBehavior(browserEndpoint, port, pages) {
         return window.__siteCopied;
       })()
     `);
-    const expected = 'mm-harness run <recipe> --artifacts-dir ./first-recipe-artifacts';
-    if (!copied?.includes(expected)) {
-      throw new Error(`copy prompt omitted "${expected}"`);
+    // Both halves of the onboarding have to survive a copy: set up the harness
+    // and the skills, then drive real work through one.
+    const expected = ['npm i -g @deeeed/metamask-harness@latest', 'yarn skills', '/mms-recipe-cook'];
+    const missing = expected.filter((line) => !copied?.includes(line));
+    if (missing.length) {
+      throw new Error(`copy prompt omitted ${missing.map((m) => `"${m}"`).join(', ')}`);
     }
 
+    // The landing page is the lobby: one prompt, one way onward, nothing else.
+    const lobby = await page.evaluate(String.raw`
+      (() => ({
+        nav: document.querySelectorAll('.nav a').length,
+        steps: document.querySelectorAll('.step[data-step]').length,
+        depth: document.querySelector('a[href="how-it-works.html"]') !== null,
+        anchor: document.getElementById('prompt') !== null,
+      }))()
+    `);
+    if (lobby.nav || lobby.steps || !lobby.depth || !lobby.anchor) {
+      throw new Error(
+        `landing page is not a lobby: ${lobby.nav} nav links, ${lobby.steps} steps, ` +
+          `depth link ${lobby.depth}, prompt anchor ${lobby.anchor}`,
+      );
+    }
+  });
+
+  // The walkthrough and its saved progress live one click deeper.
+  await withPage(browserEndpoint, `${base}how-it-works.html`, async (page) => {
     const progress = await page.evaluate(String.raw`
       (() => {
         const box = document.querySelector('.step-check');
@@ -426,6 +448,20 @@ async function checkBehavior(browserEndpoint, port, pages) {
       if (broken.length) {
         throw new Error(`${relative} has broken internal links: ${broken.join(', ')}`);
       }
+      // Every page past the lobby owes the reader one click back to the prompt.
+      if (relative !== 'index.html') {
+        const back = await page.evaluate(String.raw`
+          (() => {
+            const link = document.querySelector('.nav a.nav-cta');
+            if (!link) return null;
+            const url = new URL(link.getAttribute('href'), location.href);
+            return url.pathname + url.hash;
+          })()
+        `);
+        if (back !== '/index.html#prompt') {
+          throw new Error(`${relative} has no nav link back to the setup prompt (found ${back})`);
+        }
+      }
       for (const width of [834, 390]) {
         await page.send('Emulation.setDeviceMetricsOverride', {
           width,

package/site/architecture.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" aria-current="page">Architecture</a>
@@ -30,11 +31,12 @@
 
 <main>
 <section class="wrap hero" style="padding-bottom:1rem">
-  <span class="eyebrow">The stack</span>
+  <span class="eyebrow">The stack behind a recipe</span>
   <h1>How the pieces fit together</h1>
   <p class="lede">
-    Four moving parts, two of which people routinely confuse. What each layer is, where it lives, which
-    workflow you are in, and the mistakes that cost newcomers their first afternoon.
+    The recipe is the unit of trust; the rest of the stack runs it. Four moving parts, two of which
+    people routinely confuse. What each layer is, where it lives, which workflow you are in, and the
+    mistakes that cost newcomers their first afternoon.
   </p>
 </section>
 
@@ -45,8 +47,9 @@
       <span class="k">A recipe proves a task with actions.</span> Recipes are JSON graphs of typed
       actions; <code>mm-harness</code> executes them against a real app and produces an evidence bundle
       a reviewer can trust. <strong>Skills</strong> teach an agent a workflow — author a recipe, review
-      a PR, validate a release. <strong>Recipe libraries</strong> hold each team's recipes and domain
-      actions. Compose in that order, against the product repo under test.
+      a PR, validate a release — and are the layer you work through; they call the harness, which runs
+      the recipe. <strong>Recipe libraries</strong> hold each team's recipes and domain actions.
+      Compose in that order, against the product repo under test.
     </p>
   </div>
 </section>
@@ -67,9 +70,12 @@
         release — turning "figure it out" into a procedure with gates you can steer.
       </p>
       <p>
-        Skills live in the internal <code>Consensys/skills</code> repo, installed per checkout with that
-        repo's tooling. <strong>You do not need skills to run a recipe</strong>, only to have an agent
-        follow a proven workflow instead of improvising one.
+        Skills come from the public <code>MetaMask/skills</code> repo plus the internal
+        <code>Consensys/skills</code> overlay, which needs access to that org; private skills override
+        public ones on a name collision. Clone each, point <code>METAMASK_SKILLS_DIR</code> and
+        <code>CONSENSYS_SKILLS_DIR</code> at them, then install per checkout with
+        <code>yarn skills</code>. <strong>You do not need skills to run a recipe</strong>, only to have
+        an agent follow a proven workflow instead of improvising one.
         <a href="tutorials/v3.html">V3 walks the install.</a>
       </p>
     </div>
@@ -129,8 +135,8 @@
       </p>
       <p style="margin-bottom:0">
         They differ, and the harness says so rather than pretending otherwise: Core is headless with
-        nothing to launch and no UI actions; Mobile carries video capture; Extension is screenshots
-        only.
+        nothing to launch and no UI actions; Extension and iOS can record full-run video; Android
+        replay video is not implemented yet, so use screenshot evidence there.
       </p>
     </div>
   </div>
@@ -466,7 +472,7 @@
 
   <hr class="sep">
   <div class="btn-row">
-    <a class="btn btn-primary" href="index.html#steps">Do the walkthrough →</a>
+    <a class="btn btn-primary" href="how-it-works.html#steps">Do the walkthrough →</a>
     <a class="btn btn-ghost" href="reviewers.html">Read an evidence bundle</a>
   </div>
 </section>
@@ -474,8 +480,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/assets/progress.mjs

@@ -3,7 +3,7 @@
  * buttons, platform filters, and the layer diagram. No dependencies, no
  * network, no tracking. Progress lives in localStorage under
  * `mmh.progress.<page>`, where <page> comes from body[data-progress-page].
- * Pages that share a namespace share their state (Start Here and the V1
+ * Pages that share a namespace share their state (the How it works walkthrough and the V1
  * tutorial are deliberately the same checklist).
  */
 (function () {