@deeeed/metamask-harness 0.34.4 → 0.36.0

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

@@ -1237,6 +1237,45 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.wallet.validate_import": {
+      "description": "Validate wallet recovery credentials and derive the expected primary address without launching or mutating the app.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "credential_source": {
+            "type": "string",
+            "enum": ["auto", "environment", "fixture"]
+          },
+          "srp_env": {
+            "type": "string"
+          },
+          "password_env": {
+            "type": "string"
+          },
+          "metametrics": {
+            "type": "boolean"
+          },
+          "interests": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.validate_import",
+          "credential_source": "auto",
+          "intent": "Validate recovery credentials before resetting a wallet",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "host-read-export"
+      ]
+    },
     "metamask.wallet.setup": {
       "description": "Import the wallet fixture accounts and password so the app starts from a known signed-in state.",
       "schema": {
@@ -1253,6 +1292,75 @@
       ],
       "execution_capabilities": ["app-mutation"]
     },
+    "metamask.wallet.import": {
+      "description": "Make the wallet ready by reusing a fixture-backed profile or importing the primary mnemonic through visible onboarding UI.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "method": {
+            "type": "string",
+            "enum": ["auto", "profile", "ui"]
+          },
+          "credential_source": {
+            "type": "string",
+            "enum": ["auto", "environment", "fixture"]
+          },
+          "srp_env": {
+            "type": "string"
+          },
+          "password_env": {
+            "type": "string"
+          },
+          "metametrics": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable MetaMetrics during visible onboarding."
+          },
+          "interests": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+            },
+            "default": [],
+            "description": "Select optional onboarding interests; an empty list skips the questionnaire."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.import",
+          "method": "auto",
+          "intent": "Use an existing fixture profile or import through onboarding",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.wallet.reset": {
+      "description": "Delete the current wallet through the visible client reset flow and reach fresh onboarding.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.reset",
+          "intent": "Reset the wallet through visible UI before importing it again",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.wallet.ensure_unlocked": {
       "description": "Unlock the wallet with the fixture password when it is currently locked.",
       "schema": {

package/library/recipes/wallet/import.recipe.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Import or reuse a MetaMask wallet",
+  "description": "Make a Mobile or Extension wallet ready by reusing its fixture-backed profile or importing the primary mnemonic through visible onboarding UI.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "method": {
+        "type": "string",
+        "enum": ["auto", "profile", "ui"],
+        "default": "auto",
+        "description": "Choose automatically from visible wallet state, require an existing profile, or require real-user onboarding UI."
+      },
+      "credential_source": {
+        "type": "string",
+        "enum": ["auto", "environment", "fixture"],
+        "default": "auto",
+        "description": "Read secrets from the named environment variables first, or require one source explicitly."
+      },
+      "srp_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_SRP",
+        "description": "Environment variable containing the Secret Recovery Phrase; the value is never stored in the recipe or evidence."
+      },
+      "password_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_PASSWORD",
+        "description": "Environment variable containing the wallet password; the value is never stored in the recipe or evidence."
+      },
+      "metametrics": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable MetaMetrics during visible onboarding; defaults off."
+      },
+      "interests": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+        },
+        "default": [],
+        "description": "Mobile-only onboarding interests; an empty list skips the optional questionnaire."
+      },
+      "timeout_ms": {
+        "type": "number",
+        "default": 120000,
+        "description": "Maximum time for each onboarding transition and final wallet readiness."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "fixture-status",
+    "nodes": {
+      "fixture-status": {
+        "action": "metamask.wallet.fixture_status",
+        "intent": "Record whether a canonical fixture is available without exposing its secrets",
+        "next": "import"
+      },
+      "import": {
+        "action": "metamask.wallet.import",
+        "method": "{{params.method}}",
+        "credential_source": "{{params.credential_source}}",
+        "srp_env": "{{params.srp_env}}",
+        "password_env": "{{params.password_env}}",
+        "metametrics": "{{params.metametrics}}",
+        "interests": "{{params.interests}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Reuse the fixture-backed wallet or import it through the visible onboarding flow",
+        "next": "state"
+      },
+      "state": {
+        "action": "metamask.wallet.read_state",
+        "intent": "Prove the wallet has a selected account after setup",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/wallet/reset-import.recipe.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Reset and import a MetaMask wallet through visible UI",
+  "description": "Delete the current Mobile or Extension wallet through its visible reset flow, import the primary mnemonic through onboarding, and prove a selected account is ready.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "credential_source": {
+        "type": "string",
+        "enum": ["auto", "environment", "fixture"],
+        "default": "auto",
+        "description": "Read secrets from the named environment variables first, or require one source explicitly."
+      },
+      "srp_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_SRP",
+        "description": "Environment variable containing the Secret Recovery Phrase; the value is never stored in the recipe or evidence."
+      },
+      "password_env": {
+        "type": "string",
+        "default": "MM_HARNESS_WALLET_PASSWORD",
+        "description": "Environment variable containing the wallet password; the value is never stored in the recipe or evidence."
+      },
+      "metametrics": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable MetaMetrics during visible onboarding; defaults off."
+      },
+      "interests": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+        },
+        "default": [],
+        "description": "Mobile-only onboarding interests; an empty list skips the optional questionnaire."
+      },
+      "timeout_ms": {
+        "type": "number",
+        "default": 120000,
+        "description": "Maximum time for each reset/import transition and final wallet readiness."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "validate_import",
+    "nodes": {
+      "validate_import": {
+        "action": "metamask.wallet.validate_import",
+        "credential_source": "{{params.credential_source}}",
+        "srp_env": "{{params.srp_env}}",
+        "password_env": "{{params.password_env}}",
+        "metametrics": "{{params.metametrics}}",
+        "interests": "{{params.interests}}",
+        "intent": "Validate recovery credentials before deleting the current wallet",
+        "next": "reset"
+      },
+      "reset": {
+        "action": "metamask.wallet.reset",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Delete the current wallet through the client-visible reset flow and reach fresh onboarding",
+        "next": "import"
+      },
+      "import": {
+        "action": "metamask.wallet.import",
+        "method": "ui",
+        "credential_source": "{{params.credential_source}}",
+        "srp_env": "{{params.srp_env}}",
+        "password_env": "{{params.password_env}}",
+        "metametrics": "{{params.metametrics}}",
+        "interests": "{{params.interests}}",
+        "timeout_ms": "{{params.timeout_ms}}",
+        "intent": "Import the primary mnemonic through visible onboarding UI",
+        "next": "state"
+      },
+      "state": {
+        "action": "metamask.wallet.read_state",
+        "intent": "Prove the imported wallet has a selected account",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/package.json

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

package/scripts/completions.sh

@@ -77,7 +77,7 @@ if [ -n "${BASH_VERSION:-}" ]; then
 
     case "$cmd" in
       launch)      [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "ios android" -- "$cur")) ;;
-      fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "init sync set generate finalize" -- "$cur")) ;;
+      fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "init sync set reset generate finalize" -- "$cur")) ;;
       checklist)   [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "mark closeout" -- "$cur")) ;;
       completions) [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "install bash zsh status" -- "$cur")) ;;
       call)        [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "$(_mmh_actions)" -- "$cur")) ;;
@@ -111,7 +111,7 @@ if [ -n "${ZSH_VERSION:-}" ]; then
 
     case "$cmd" in
       launch)      (( CURRENT == 3 )) && { candidates=(ios android); compadd -a candidates; } ;;
-      fixtures)    (( CURRENT == 3 )) && { candidates=(init sync set generate finalize); compadd -a candidates; } ;;
+      fixtures)    (( CURRENT == 3 )) && { candidates=(init sync set reset generate finalize); compadd -a candidates; } ;;
       checklist)   (( CURRENT == 3 )) && { candidates=(mark closeout); compadd -a candidates; } ;;
       completions) (( CURRENT == 3 )) && { candidates=(install bash zsh status); compadd -a candidates; } ;;
       call)        (( CURRENT == 3 )) && { candidates=("${(@f)$(_mmh_actions)}"); compadd -a candidates; } ;;

package/scripts/site-contrast.mjs

@@ -358,6 +358,13 @@ async function checkBehavior(browserEndpoint, port, pages) {
           tab.click();
           const panel = document.getElementById(tab.getAttribute('aria-controls'));
           if (!panel || panel.hidden) throw new Error('tab ' + tab.id + ' did not reveal its panel');
+          // Panels ship visible so a dead module degrades to readable prompts
+          // rather than dead controls — which also means "revealed" alone
+          // proves nothing. Selecting one has to hide the others.
+          const shown = [...document.querySelectorAll('[role="tabpanel"]')].filter((p) => !p.hidden);
+          if (shown.length !== 1) {
+            throw new Error('tab ' + tab.id + ' left ' + shown.length + ' panels visible');
+          }
           out.work.push(await grab(panel.querySelector('.cmd .copy')));
         }
         return out;

package/site/architecture.html

@@ -5,7 +5,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Architecture — how the pieces fit</title>
 <meta name="description" content="Skills, mm-harness, team recipe libraries, product repos: what lives where, the three workflows, and the mistakes newcomers make.">
-<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="architecture">
 <a class="skip" href="#stack">Skip to the stack map</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">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" aria-current="page">Architecture</a>
       <a href="tutorials/index.html">Tutorials</a>
-      <a href="reviewers.html">For Reviewers</a>
     </nav>
   </div>
 </header>
@@ -471,8 +470,16 @@
   </ol>
 
   <hr class="sep">
+  <h2>Which repo is which</h2>
+  <p>
+    The layers above are the design. The <a href="ecosystem.html">Ecosystem map</a> is the concrete
+    version: the six repositories and packages behind a run, each with its URL, and which way the
+    dependencies point.
+  </p>
+
   <div class="btn-row">
-    <a class="btn btn-primary" href="how-it-works.html#steps">Do the walkthrough →</a>
+    <a class="btn btn-primary" href="ecosystem.html">See the repo map →</a>
+    <a class="btn btn-ghost" 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>
@@ -485,6 +492,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/assets/metamask-fox.svg

@@ -0,0 +1,24 @@
+<svg width="35" height="34" viewBox="0 0 35 34" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M32.7077 32.7522L25.1688 30.5174L19.4833 33.9008L15.5167 33.8991L9.82793 30.5174L2.29225 32.7522L0 25.0489L2.29225 16.4993L0 9.27094L2.29225 0.312256L14.0674 7.31554H20.9326L32.7077 0.312256L35 9.27094L32.7077 16.4993L35 25.0489L32.7077 32.7522Z" fill="#FF5C16"/>
+<path d="M2.29395 0.312256L14.0691 7.32047L13.6008 12.1301L2.29395 0.312256Z" fill="#FF5C16"/>
+<path d="M9.82959 25.0522L15.0106 28.9811L9.82959 30.5175V25.0522Z" fill="#FF5C16"/>
+<path d="M14.5966 18.5565L13.6009 12.1333L7.22692 16.5009L7.22363 16.4993V16.5025L7.24335 20.9983L9.82809 18.5565H9.82974H14.5966Z" fill="#FF5C16"/>
+<path d="M32.7077 0.312256L20.9326 7.32047L21.3993 12.1301L32.7077 0.312256Z" fill="#FF5C16"/>
+<path d="M25.1722 25.0522L19.9912 28.9811L25.1722 30.5175V25.0522Z" fill="#FF5C16"/>
+<path d="M27.7766 16.5025H27.7783H27.7766V16.4993L27.775 16.5009L21.401 12.1333L20.4053 18.5565H25.1722L27.7586 20.9983L27.7766 16.5025Z" fill="#FF5C16"/>
+<path d="M9.82793 30.5175L2.29225 32.7522L0 25.0522H9.82793V30.5175Z" fill="#E34807"/>
+<path d="M14.5947 18.5549L16.0341 27.8406L14.0393 22.6777L7.23975 20.9984L9.82613 18.5549H14.593H14.5947Z" fill="#E34807"/>
+<path d="M25.1721 30.5175L32.7078 32.7522L35.0001 25.0522H25.1721V30.5175Z" fill="#E34807"/>
+<path d="M20.4053 18.5549L18.9658 27.8406L20.9607 22.6777L27.7602 20.9984L25.1722 18.5549H20.4053Z" fill="#E34807"/>
+<path d="M0 25.0488L2.29225 16.4993H7.22183L7.23991 20.9967L14.0394 22.676L16.0343 27.8389L15.0089 28.976L9.82793 25.0472H0V25.0488Z" fill="#FF8D5D"/>
+<path d="M35.0001 25.0488L32.7078 16.4993H27.7783L27.7602 20.9967L20.9607 22.676L18.9658 27.8389L19.9912 28.976L25.1722 25.0472H35.0001V25.0488Z" fill="#FF8D5D"/>
+<path d="M20.9325 7.31543H17.4999H14.0673L13.6006 12.1251L16.0342 27.834H18.9656L21.4008 12.1251L20.9325 7.31543Z" fill="#FF8D5D"/>
+<path d="M2.29225 0.312256L0 9.27094L2.29225 16.4993H7.22183L13.5991 12.1301L2.29225 0.312256Z" fill="#661800"/>
+<path d="M13.17 20.4199H10.9369L9.72095 21.6062L14.0409 22.6727L13.17 20.4182V20.4199Z" fill="#661800"/>
+<path d="M32.7077 0.312256L34.9999 9.27094L32.7077 16.4993H27.7781L21.4009 12.1301L32.7077 0.312256Z" fill="#661800"/>
+<path d="M21.833 20.4199H24.0694L25.2853 21.6079L20.9604 22.676L21.833 20.4182V20.4199Z" fill="#661800"/>
+<path d="M19.4817 30.8362L19.9911 28.9794L18.9658 27.8423H16.0327L15.0073 28.9794L15.5167 30.8362" fill="#661800"/>
+<path d="M19.4816 30.8359V33.9021H15.5166V30.8359H19.4816Z" fill="#C0C4CD"/>
+<path d="M9.82959 30.5142L15.52 33.9008V30.8346L15.0106 28.9778L9.82959 30.5142Z" fill="#E7EBF6"/>
+<path d="M25.1721 30.5142L19.4817 33.9008V30.8346L19.9911 28.9778L25.1721 30.5142Z" fill="#E7EBF6"/>
+</svg>

package/site/assets/progress.mjs

@@ -241,11 +241,17 @@
    * One tablist per group, roving tabindex: only the selected tab is in the
    * tab order, arrows move between them. Panels stay in the DOM so their
    * commands remain copyable the moment a tab is shown.
+   *
+   * The markup ships every panel visible and the tablist hidden; hiding is
+   * this function's first act. Without it — stale cache, blocked module,
+   * file:// — the reader gets all three prompts stacked instead of controls
+   * that do nothing.
    */
   function initTabs() {
     [].slice.call(document.querySelectorAll('[role="tablist"]')).forEach(function (list) {
       var tabs = [].slice.call(list.querySelectorAll('[role="tab"]'));
       if (!tabs.length) return;
+      list.hidden = false;
 
       function select(tab, focus) {
         tabs.forEach(function (other) {

package/site/assets/style.css

@@ -110,8 +110,10 @@ main { padding-bottom: 6rem; }
 .topbar-inner {
   display: flex;
   align-items: center;
-  gap: 1.5rem;
-  height: 60px;
+  flex-wrap: wrap;
+  gap: 0.5rem 1.5rem;
+  min-height: 60px;
+  padding: 0.5rem 0;
 }
 
 .brand {
@@ -125,31 +127,24 @@ main { padding-bottom: 6rem; }
 }
 .brand:hover { text-decoration: none; }
 
-/* Brand-adjacent mark: a geometric diamond, not a product logo. */
-.brand-mark {
-  width: 20px;
-  height: 20px;
-  flex: none;
-  border-radius: 5px;
-  background: linear-gradient(145deg, var(--accent) 0%, var(--accent-deep) 100%);
-  transform: rotate(45deg);
-  box-shadow: 0 0 0 1px rgba(246, 133, 27, 0.3), 0 3px 12px rgba(246, 133, 27, 0.22);
-}
+.brand-mark { width: 22px; height: 22px; flex: none; display: block; }
 
 .brand-name { font-family: var(--mono); font-size: 0.95rem; }
 
+/* Six items fit a laptop on one line; below that they wrap onto a second row
+   rather than scrolling a label out of sight. */
 .nav {
   display: flex;
   gap: 0.3rem;
   margin-left: auto;
   min-width: 0;
-  overflow-x: auto;
-  flex-wrap: nowrap;
-  scrollbar-width: thin;
+  flex-wrap: wrap;
+  justify-content: flex-end;
 }
 
 .nav a {
   flex: none;
+  white-space: nowrap;
   color: var(--text-dim);
   font-size: 0.885rem;
   font-weight: 500;
@@ -272,16 +267,7 @@ main { padding-bottom: 6rem; }
   text-align: center;
 }
 
-.lobby-mark {
-  display: block;
-  width: 26px;
-  height: 26px;
-  margin: 0 auto 2rem;
-  border-radius: 7px;
-  background: linear-gradient(145deg, var(--accent) 0%, var(--accent-deep) 100%);
-  transform: rotate(45deg);
-  box-shadow: 0 0 0 1px rgba(246, 133, 27, 0.3), 0 4px 18px rgba(246, 133, 27, 0.25);
-}
+.lobby-mark { display: block; width: 52px; height: 52px; margin: 0 auto 1.6rem; }
 
 .lobby h1 {
   font-size: clamp(2rem, 4.6vw, 2.85rem);
@@ -352,17 +338,19 @@ main { padding-bottom: 6rem; }
 .qs-title {
   display: flex;
   align-items: center;
-  gap: 0.65rem;
   font-size: 1.16rem;
   font-weight: 640;
   margin: 0 0 0.35rem;
 }
 
+/* The margin rather than a flex gap: the badge stays separated from the title
+   even when the flex layout does not apply. */
 .qs-num {
   flex: none;
-  width: 1.6rem;
-  height: 1.6rem;
-  display: grid;
+  width: 1.7rem;
+  height: 1.7rem;
+  margin-right: 0.75rem;
+  display: inline-grid;
   place-items: center;
   border-radius: 50%;
   background: var(--accent-soft);
@@ -370,6 +358,7 @@ main { padding-bottom: 6rem; }
   color: var(--accent);
   font-family: var(--mono);
   font-size: 0.8rem;
+  line-height: 1;
 }
 
 .qs-why { color: var(--text-dim); font-size: 0.95rem; margin-bottom: 0.9rem; }
@@ -960,6 +949,76 @@ tr[hidden], .filter-hidden { display: none !important; }
 .verdict.pass { color: var(--pass); }
 .verdict.fail { color: var(--fail); }
 
+/* ---------- dependency map ----------
+   A column of nodes with the edge label between them, so the direction reads
+   top to bottom without a diagram library. */
+
+.map { margin: 1.5rem 0 2.5rem; }
+
+.node {
+  background: linear-gradient(180deg, var(--surface) 0%, var(--bg-raised) 100%);
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  padding: 1.25rem 1.4rem;
+}
+.node:hover { border-color: var(--accent-line); }
+
+/* The one you install. */
+.node-key { border-color: var(--accent-line); }
+
+.node-tag {
+  display: block;
+  font-family: var(--mono);
+  font-size: 0.72rem;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--text-faint);
+  margin-bottom: 0.35rem;
+}
+
+.node-name { font-size: 1.12rem; font-weight: 640; margin: 0 0 0.4rem; }
+.node-what { font-size: 0.94rem; color: var(--text-dim); margin-bottom: 0.7rem; }
+
+.node-list {
+  list-style: none;
+  margin: 0 0 0.8rem;
+  padding: 0;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.35rem 0.5rem;
+  font-size: 0.86rem;
+}
+.node-list li { color: var(--text-dim); }
+
+.node-url {
+  display: block;
+  font-family: var(--mono);
+  font-size: 0.8rem;
+  word-break: break-all;
+  margin-bottom: 0.15rem;
+}
+
+.node .badge { margin: 0.55rem 0.4rem 0 0; display: inline-block; }
+.node-more { display: block; font-size: 0.88rem; margin-top: 0.6rem; }
+
+/* Edge labels carry the verb; the arrow alone would not say what flows. */
+.map-edge {
+  margin: 0.7rem 0;
+  text-align: center;
+  font-family: var(--mono);
+  font-size: 0.8rem;
+  color: var(--text-faint);
+}
+
+.map-split { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1rem; }
+.map-row { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1rem; align-items: start; }
+
+@media (max-width: 780px) {
+  .map-split { grid-template-columns: 1fr; }
+  .map-split .map-edge:last-child { margin-top: 0; }
+  .map-row { grid-template-columns: 1fr; }
+}
+
 /* ---------- misc ---------- */
 
 .btn-row { display: flex; flex-wrap: wrap; gap: 0.7rem; margin-top: 1.8rem; }

package/site/cheatsheet.html

@@ -5,7 +5,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Cheatsheet — mm-harness</title>
 <meta name="description" content="Every mm-harness command worth knowing, filterable by platform, with copy buttons.">
-<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="cheatsheet">
 <a class="skip" href="#daily">Skip to the commands</a>
@@ -13,18 +14,16 @@
 <header class="topbar">
   <div class="wrap-wide 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">Perps</a>
+      <a href="perps.html">Team / Perps</a>
       <a href="cheatsheet.html" aria-current="page">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>
@@ -303,6 +302,6 @@
   </div>
 </footer>
 
-<script type="module" src="assets/progress.mjs"></script>
+<script type="module" src="assets/progress.mjs?v=4"></script>
 </body>
 </html>