@deeeed/metamask-harness 0.34.3 → 0.35.0

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## Unreleased
 
+## 0.35.0 - 2026-08-12
+
+### Fixed
+
+- Make Extension and Mobile launch verification fail when their in-app EVM network client cannot complete a live RPC, with exact Infura configuration and retry guidance.
+- Make Extension doctor require checkout-pinned Playwright Chromium and report the exact install command when it is missing.
+- Make doctor report the exact dependency-install command when `--fix` finds stale or missing dependencies instead of implying they were repaired.
+- Make the setup prompt reuse configured skill sources and require consent before cloning or editing shell startup files.
+- Keep installed overlays delegated to the source runner that installed them before falling back to a potentially stale global runner.
+
+## 0.34.4 - 2026-08-12
+
+### Changed
+
+- Split the site quick start into one-time setup and task-focused workflow tabs.
+
+### Fixed
+
+- Update the transitive `tar` dependency from 7.5.19 to 7.5.22.
+- Update transitive `js-yaml`, `nanoid`, and `postcss` dependencies.
+
 ## 0.34.3 - 2026-08-12
 
 ### Added

package/adapters/core/inject.sh

@@ -88,11 +88,11 @@ install_v1_runner_assets() {
     if [ -n "$METAMASK_RUNNER_PROTOCOL_ROOT" ]; then
       printf 'export FARMSLOT_ROOT=${FARMSLOT_ROOT:-%s}\n' "$runner_protocol_root_q"
     fi
-    # Resolve the runner at run time (override > global install > install-time
-    # record); the recorded path is last resort so a moved checkout is not pinned.
+    # The recorded runner owns the installed overlay and must remain ahead of an
+    # unrelated global version. MM_HARNESS_BIN is the explicit override.
     printf '%s\n' 'if [ -n "${MM_HARNESS_BIN:-}" ] && [ -x "${MM_HARNESS_BIN}" ]; then exec "${MM_HARNESS_BIN}" "$@"; fi'
-    printf '%s\n' 'if command -v mm-harness >/dev/null 2>&1; then exec mm-harness "$@"; fi'
     printf 'if [ -x %s ]; then exec %s "$@"; fi\n' "$runner_exec_q" "$runner_exec_q"
+    printf '%s\n' 'if command -v mm-harness >/dev/null 2>&1; then exec mm-harness "$@"; fi'
     printf '%s\n' 'echo "mm-harness not found. Next: npm i -g @deeeed/metamask-harness" >&2'
     printf '%s\n' 'exit 127'
   } > "$HARNESS_DIR/runner/bin/mm-harness"

package/adapters/extension/inject.mjs

@@ -69,17 +69,16 @@ fs.mkdirSync(path.join(harnessDir, 'runner/recipes'), { recursive: true });
 fs.rmSync(path.join(harnessDir, 'scripts'), { recursive: true, force: true });
 fs.mkdirSync(path.join(harnessDir, 'scripts/lib'), { recursive: true });
 
-// Resolve the runner at run time so a moved or shared checkout is never bound to
-// an install-time absolute path: explicit override, then a global install, then
-// the runner recorded at install time as a last resort; teach install on miss.
+// Prefer the runner that installed the overlay so its runtime checks match the
+// installed scripts. Explicit overrides still support controlled delegation.
 const pinnedBin = shellQuote(path.join(runnerDir, 'bin/mm-harness'));
 const delegate = [
   '#!/usr/bin/env bash',
   'set -euo pipefail',
   protocolRoot ? `export FARMSLOT_ROOT=\${FARMSLOT_ROOT:-${shellQuote(protocolRoot)}}` : null,
   'if [ -n "${MM_HARNESS_BIN:-}" ] && [ -x "${MM_HARNESS_BIN}" ]; then exec "${MM_HARNESS_BIN}" "$@"; fi',
-  'if command -v mm-harness >/dev/null 2>&1; then exec mm-harness "$@"; fi',
   `if [ -x ${pinnedBin} ]; then exec ${pinnedBin} "$@"; fi`,
+  'if command -v mm-harness >/dev/null 2>&1; then exec mm-harness "$@"; fi',
   'echo "mm-harness not found. Next: npm i -g @deeeed/metamask-harness" >&2',
   'exit 127',
 ].filter(Boolean).join('\n') + '\n';

package/adapters/mobile/inject.sh

@@ -44,7 +44,7 @@ for rel in "$HARNESS_REL" "$HARNESS_REL/runner" "$HARNESS_REL/scripts"; do
   done
 done
 
-rm -rf "$HARNESS_DIR/runner" "$HARNESS_DIR/scripts"
+rm -rf "$HARNESS_DIR/runner" "$HARNESS_DIR/scripts" "$HARNESS_DIR/bridge-runtime"
 mkdir -p "$HARNESS_DIR/runner/bin" "$HARNESS_DIR/runner/manifests" "$HARNESS_DIR/runner/recipes" "$HARNESS_DIR/scripts/lib"
 
 RUNNER_EXEC_Q="$(printf '%q' "$RUNNER_DIR/bin/mm-harness")"
@@ -62,8 +62,8 @@ PROTOCOL_ROOT_Q="$(printf '%q' "$PROTOCOL_ROOT")"
     printf 'export METAMASK_RUNNER_PROTOCOL_ROOT=${METAMASK_RUNNER_PROTOCOL_ROOT:-%s}\n' "$PROTOCOL_ROOT_Q"
   fi
   printf '%s\n' 'if [ -n "${MM_HARNESS_BIN:-}" ] && [ -x "$MM_HARNESS_BIN" ]; then exec "$MM_HARNESS_BIN" "$@"; fi'
-  printf '%s\n' 'if command -v mm-harness >/dev/null 2>&1; then exec mm-harness "$@"; fi'
   printf 'if [ -x %s ]; then exec %s "$@"; fi\n' "$RUNNER_EXEC_Q" "$RUNNER_EXEC_Q"
+  printf '%s\n' 'if command -v mm-harness >/dev/null 2>&1; then exec mm-harness "$@"; fi'
   printf '%s\n' 'echo "mm-harness not found. Next: npm i -g @deeeed/metamask-harness@latest" >&2' 'exit 127'
 } > "$HARNESS_DIR/runner/bin/mm-harness"
 chmod +x "$HARNESS_DIR/runner/bin/mm-harness"
@@ -77,6 +77,7 @@ rsync -a --delete "$RUNNER_DIR/library/recipes/" "$HARNESS_DIR/runner/recipes/"
 rm -rf "$HARNESS_DIR/runner/flows"
 rm -f "$HARNESS_DIR/runner/library.json"
 cp "$RUNNER_DIR/adapters/mobile/verify.sh" "$HARNESS_DIR/scripts/verify.sh"
+cp -R "$RUNNER_DIR/adapters/mobile/bridge-runtime" "$HARNESS_DIR/bridge-runtime"
 cp "$RUNNER_DIR/adapters/shared/harness-path.sh" "$HARNESS_DIR/scripts/lib/harness-path.sh"
 cp "$RUNNER_DIR/adapters/shared/path-defaults.json" "$HARNESS_DIR/scripts/lib/path-defaults.json"
 chmod -R u+rwX,go+rX "$HARNESS_DIR"
@@ -114,7 +115,7 @@ fs.writeFileSync(manifestPath, JSON.stringify({
   actionManifestPath: `${harnessRel}/action-manifest.json`,
   runnerEntrypoint: `${harnessRel}/runner/bin/mm-harness`,
   runtimeHelpers: { verify: `${harnessRel}/scripts/verify.sh` },
-  harnessInstalledPaths: [`${harnessRel}/runner`, `${harnessRel}/scripts`, `${harnessRel}/action-manifest.json`],
+  harnessInstalledPaths: [`${harnessRel}/runner`, `${harnessRel}/scripts`, `${harnessRel}/bridge-runtime`, `${harnessRel}/action-manifest.json`],
   productOwnedPaths: ['app/dev-tools/AgenticService', 'app/core/NavigationService/NavigationService.ts'],
   cleanupCommand,
   productDiffExcludes: [`:(exclude)${harnessRoot}`],

package/adapters/mobile/verify.sh

@@ -325,6 +325,35 @@ JSON
   ) > "$log_path" 2>&1
 }
 
+evm_rpc_ready() {
+  local log_path="$1"
+  local bridge="$HARNESS_DIR/bridge-runtime/cdp-bridge.cjs"
+  local expression
+  expression="(async function(){try{var engine=globalThis.Engine;var controller=engine&&engine.context&&engine.context.NetworkController;if(!controller||typeof controller.getSelectedNetworkClient!=='function')throw new Error('NetworkController selected client is unavailable');var client=controller.getSelectedNetworkClient();if(!client||!client.provider||typeof client.provider.request!=='function')throw new Error('selected EVM provider is unavailable');var result=await client.provider.request({method:'eth_blockNumber'});if(typeof result!=='string'||!/^0x[0-9a-f]+$/i.test(result))throw new Error('eth_blockNumber returned an invalid result');return {ok:true,result:result};}catch(error){return {ok:false,error:error&&(error.message||String(error))};}})()"
+  [ -f "$bridge" ] || {
+    printf 'Mobile bridge is missing at %s\n' "$bridge" > "$log_path"
+    return 1
+  }
+  if ! run_with_timeout "$log_path" 25 env \
+    APP_ROOT="$TARGET" \
+    WATCHER_PORT="$port" \
+    IOS_SIMULATOR="${IOS_SIMULATOR:-$ios_simulator_resolved}" \
+    ADB_SERIAL="${ADB_SERIAL:-$adb_serial_resolved}" \
+    ANDROID_SERIAL="${ANDROID_SERIAL:-$adb_serial_resolved}" \
+    node "$bridge" eval-async "$expression"; then
+    return 1
+  fi
+  node - "$log_path" <<'NODE'
+const fs = require('fs');
+try {
+  const result = JSON.parse(fs.readFileSync(process.argv[2], 'utf8'));
+  process.exit(result.ok === true ? 0 : 1);
+} catch {
+  process.exit(1);
+}
+NODE
+}
+
 ensure_live_runtime() {
   local device_target="$1"
   local attempt
@@ -419,6 +448,14 @@ JSON
     add_note "Runner v1 live bridge smoke failed; inspect logs/runner-live-smoke.log and runner-live-smoke/trace.json."
     status="fail"
   fi
+
+  if evm_rpc_ready "$ARTIFACTS/logs/evm-rpc-readiness.log"; then
+    checks+=("{\"name\":\"live EVM RPC readiness\",\"status\":\"pass\"}")
+  else
+    checks+=("{\"name\":\"live EVM RPC readiness\",\"status\":\"fail\",\"detail\":\"see logs/evm-rpc-readiness.log\"}")
+    add_note "EVM RPC readiness probe failed. Infura configured ≠ RPC reachable. Next: confirm $TARGET/.js.env has a real MM_INFURA_PROJECT_ID (not 00000000000), then rerun mm-harness launch $PLATFORM --verify --target '$TARGET'."
+    status="fail"
+  fi
 fi
 
 RECIPE_HARNESS_PREFLIGHT_MODE="$PREFLIGHT_MODE" RECIPE_HARNESS_ROOT_EXCLUDE="$HARNESS_ROOT" node - "$ARTIFACTS" "$TARGET" "$status" "${checks[@]}" <<'NODE'

package/dist/adapters/extension/runtime.js

@@ -153,12 +153,26 @@ async function checkExtensionRuntimeHealth(projectRoot, cdpPort, options = {}) {
     if (runtime.backgroundUnresponsive === true) {
       findings.push("Extension UI reports background connection unresponsive.");
     }
+    if (runtime.ethereumConnectionUnavailable === true) {
+      findings.push('Extension UI reports "Unable to connect to Ethereum".');
+    }
+    if (runtime.evmRpcProbeOk !== true) {
+      const probeError = String(runtime.evmRpcProbeError ?? "unknown error").replace(/[.\s]+$/u, "");
+      findings.push(
+        `EVM RPC readiness probe failed: ${probeError}. Infura configured \u2260 RPC reachable.`
+      );
+    }
     if (runtime.hasSubmitRequest === true && runtime.backgroundProbeOk !== true) {
       warnings.push(`Perps background read probe failed: ${runtime.backgroundProbeError ?? "unknown error"}.`);
     }
     const extensionId = safeExtensionId(target);
+    const evmRpcUnreachable = runtime.ethereumConnectionUnavailable === true || runtime.evmRpcProbeOk !== true;
     return {
       status: findings.length === 0 ? "PASS" : "FAIL",
+      ...evmRpcUnreachable ? {
+        errorCode: "EVM_RPC_UNREACHABLE",
+        userAction: evmRpcRecoveryAction(projectRoot)
+      } : {},
       warnings,
       cdpPort,
       targetUrl: target.url,
@@ -219,21 +233,42 @@ async function evaluateHealth(session, timeoutMs) {
       const storeState = hooks.store?.getState?.() || {};
       const manager = hooks.getPerpsStreamManager?.();
       const accountCache = manager?.account?.cache;
+      const networkConnectionBanner = storeState.metamask?.networkConnectionBanner;
+      const networkClientId = storeState.metamask?.selectedNetworkClientId || networkConnectionBanner?.networkClientId;
       return Promise.race([
         (async () => {
-          let backgroundProbeOk = false;
-          let backgroundProbeError = null;
-          if (typeof hooks.submitRequestToBackground === 'function') {
-            try {
-              const accountState = await hooks.submitRequestToBackground('perpsGetAccountState', []);
-              backgroundProbeOk = Boolean(accountState && typeof accountState === 'object');
-              if (!backgroundProbeOk) backgroundProbeError = 'perpsGetAccountState returned an empty result';
-            } catch (error) {
-              backgroundProbeError = String(error?.message || error);
-            }
-          } else {
-            backgroundProbeError = 'submitRequestToBackground is not a function';
-          }
+          const [backgroundProbe, evmRpcProbe] = await Promise.all([
+            (async () => {
+              if (typeof hooks.submitRequestToBackground !== 'function') {
+                return { ok: false, error: 'submitRequestToBackground is not a function' };
+              }
+              try {
+                const accountState = await hooks.submitRequestToBackground('perpsGetAccountState', []);
+                const ok = Boolean(accountState && typeof accountState === 'object');
+                return { ok, error: ok ? null : 'perpsGetAccountState returned an empty result' };
+              } catch (error) {
+                return { ok: false, error: String(error?.message || error) };
+              }
+            })(),
+            (async () => {
+              if (typeof hooks.submitRequestToBackground !== 'function') {
+                return { ok: false, error: 'submitRequestToBackground is not a function' };
+              }
+              if (typeof networkClientId !== 'string' || networkClientId.length === 0) {
+                return { ok: false, error: 'selected EVM network client is unavailable' };
+              }
+              try {
+                const code = await hooks.submitRequestToBackground('getCode', [
+                  '0x0000000000000000000000000000000000000000',
+                  networkClientId,
+                ]);
+                const ok = typeof code === 'string' && code.startsWith('0x');
+                return { ok, error: ok ? null : 'background EVM RPC returned an invalid result' };
+              } catch (error) {
+                return { ok: false, error: String(error?.message || error) };
+              }
+            })(),
+          ]);
           return {
             href: location.href,
             title: document.title,
@@ -242,14 +277,17 @@ async function evaluateHealth(session, timeoutMs) {
             hasStore: Boolean(hooks.store),
             hasPerpsStreamManager: typeof hooks.getPerpsStreamManager === 'function',
             backgroundUnresponsive: bodyText.includes('Background connection unresponsive') || bodyText.includes('MetaMask had trouble starting'),
+            ethereumConnectionUnavailable: bodyText.includes('Unable to connect to Ethereum'),
             activeProvider: storeState.metamask?.activeProvider || null,
             isTestnet: Boolean(storeState.metamask?.isTestnet),
             perpsManagerInitialized: Boolean(manager?.isInitialized?.()),
             positionsCacheIsArray: Array.isArray(manager?.positions?.cache),
             ordersCacheIsArray: Array.isArray(manager?.orders?.cache),
             accountCachePresent: Boolean(accountCache && typeof accountCache === 'object'),
-            backgroundProbeOk,
-            backgroundProbeError,
+            backgroundProbeOk: backgroundProbe.ok,
+            backgroundProbeError: backgroundProbe.error,
+            evmRpcProbeOk: evmRpcProbe.ok,
+            evmRpcProbeError: evmRpcProbe.error,
           };
         })(),
         new Promise((resolve) => setTimeout(() => resolve({
@@ -260,8 +298,11 @@ async function evaluateHealth(session, timeoutMs) {
           hasStore: Boolean(hooks.store),
           hasPerpsStreamManager: typeof hooks.getPerpsStreamManager === 'function',
           backgroundUnresponsive: bodyText.includes('Background connection unresponsive') || bodyText.includes('MetaMask had trouble starting'),
+          ethereumConnectionUnavailable: bodyText.includes('Unable to connect to Ethereum'),
           backgroundProbeOk: false,
           backgroundProbeError: 'perpsGetAccountState timed out after ${backgroundProbeTimeoutMs}ms',
+          evmRpcProbeOk: false,
+          evmRpcProbeError: 'background EVM RPC timed out after ${backgroundProbeTimeoutMs}ms',
         }), ${backgroundProbeTimeoutMs})),
       ]);
     })()`,
@@ -293,6 +334,9 @@ function compositorRecoveryAction(projectRoot) {
   const recovery = `mm-harness launch --verify --target ${JSON.stringify(projectRoot)}`;
   return process.platform === "darwin" ? `Unlock the macOS session, then rerun: ${recovery}` : `Restore an active display compositor, then rerun: ${recovery}`;
 }
+function evmRpcRecoveryAction(projectRoot) {
+  return `Confirm ${shellQuote(path.join(projectRoot, ".metamaskrc"))} has a real INFURA_PROJECT_ID (not 00000000000), then rerun: mm-harness launch --verify --target ${shellQuote(projectRoot)}`;
+}
 function resolveCdpPort(rawPort, slot) {
   const raw = rawPort ?? process.env.CDP_PORT ?? process.env.RECIPE_CDP_PORT ?? slot?.cdpPort;
   const port = Number(raw);
@@ -759,6 +803,7 @@ export {
   assertHealthyExtensionRuntime,
   checkExtensionRuntimeHealth,
   compositorRecoveryAction,
+  evmRpcRecoveryAction,
   extensionBackgroundProbeTimeoutMs,
   formatHealthFailure,
   prepareExtensionRuntime

package/dist/adapters/extension/surface.js

@@ -14,6 +14,10 @@ function watcherStatus(buildLog) {
   if (buildLog === "no-watch") return "down";
   return buildLog;
 }
+function extensionRuntimeNextAction(reasonCode, target) {
+  const resolved = shellQuote(path.resolve(target));
+  return reasonCode === "deps-missing" || reasonCode === "deps-stale" ? `cd ${resolved} && yarn install --immutable` : `mm-harness launch --adapter extension --target ${resolved}`;
+}
 const extensionSurface = {
   adapter: "extension",
   headless: false,
@@ -42,7 +46,7 @@ const extensionSurface = {
       decision: report.decision,
       reasonCode: report.reasonCode,
       reasons: report.reasons,
-      nextAction: report.decision === "ready" ? void 0 : `mm-harness launch --adapter extension --target ${shellQuote(path.resolve(target))}`,
+      nextAction: report.decision === "ready" ? void 0 : extensionRuntimeNextAction(report.reasonCode, target),
       deps: report.checks.deps.status,
       devServer: {
         label: "webpack",
@@ -96,5 +100,6 @@ const extensionSurface = {
   }
 };
 export {
+  extensionRuntimeNextAction,
   extensionSurface
 };

package/dist/adapters/mobile/source-freshness.js

@@ -21,20 +21,28 @@ const ENV_INPUTS = [".js.env", ".env", ".env.local"];
 const BASELINE_FILE = "mobile-source-baseline.json";
 function mobileSourceFingerprint(target) {
   const hash = createHash("sha256");
-  hash.update(git(target, ["rev-parse", "HEAD"]));
-  hash.update(git(target, ["diff", "--no-ext-diff", "--binary", "HEAD", "--", ...SOURCE_PATHS]));
-  const untracked = git(target, [
-    "ls-files",
-    "--others",
-    "--exclude-standard",
-    "-z",
-    "--",
-    ...SOURCE_PATHS
-  ]).toString("utf8").split("\0").filter(Boolean).sort();
-  for (const relative of untracked) {
-    hash.update(`untracked\0${relative}\0`);
-    hash.update(fs.readFileSync(path.join(target, relative)));
-    hash.update("\0");
+  const head = tryGit(target, ["rev-parse", "HEAD"]);
+  if (head === null) {
+    hash.update("non-git\0");
+    for (const relative of SOURCE_PATHS) {
+      hashPath(hash, target, relative);
+    }
+  } else {
+    hash.update(head);
+    hash.update(git(target, ["diff", "--no-ext-diff", "--binary", "HEAD", "--", ...SOURCE_PATHS]));
+    const untracked = git(target, [
+      "ls-files",
+      "--others",
+      "--exclude-standard",
+      "-z",
+      "--",
+      ...SOURCE_PATHS
+    ]).toString("utf8").split("\0").filter(Boolean).sort();
+    for (const relative of untracked) {
+      hash.update(`untracked\0${relative}\0`);
+      hash.update(fs.readFileSync(path.join(target, relative)));
+      hash.update("\0");
+    }
   }
   for (const relative of ENV_INPUTS) {
     const absolute = path.join(target, relative);
@@ -84,6 +92,35 @@ function git(target, args) {
     stdio: ["ignore", "pipe", "ignore"]
   });
 }
+function tryGit(target, args) {
+  try {
+    return git(target, args);
+  } catch {
+    return null;
+  }
+}
+function hashPath(hash, root, relative) {
+  const absolute = path.join(root, relative);
+  if (!fs.existsSync(absolute)) {
+    hash.update(`absent\0${relative}\0`);
+    return;
+  }
+  const stat = fs.lstatSync(absolute);
+  if (stat.isDirectory()) {
+    hash.update(`directory\0${relative}\0`);
+    for (const child of fs.readdirSync(absolute).sort()) {
+      hashPath(hash, root, path.join(relative, child));
+    }
+    return;
+  }
+  if (stat.isSymbolicLink()) {
+    hash.update(`symlink\0${relative}\0${fs.readlinkSync(absolute)}\0`);
+    return;
+  }
+  hash.update(`file\0${relative}\0`);
+  hash.update(fs.readFileSync(absolute));
+  hash.update("\0");
+}
 function readBaseline(target) {
   try {
     const parsed = JSON.parse(

package/dist/adapters/mobile/surface.js

@@ -5,6 +5,10 @@ import { shellQuote } from "../../commands/parse-args.js";
 import { resolveMobileSlotPorts } from "../slot-ports.js";
 import { mobileRuntimeStatus } from "./prepare.js";
 import { hasRunwayProvisionBaseline, provisionRunwayMobile } from "./provision.js";
+function mobileRuntimeNextAction(reasonCode, target, platform) {
+  const resolved = shellQuote(path.resolve(target));
+  return reasonCode === "deps-missing" || reasonCode === "deps-partial" || reasonCode === "deps-stale" ? `cd ${resolved} && yarn setup` : `mm-harness launch ${platform} --adapter mobile --target ${resolved}`;
+}
 const mobileSurface = {
   adapter: "mobile",
   headless: false,
@@ -21,7 +25,7 @@ const mobileSurface = {
       decision: depsPending ? "launch" : report.decision,
       reasonCode: depsPending ? "app-installed-deps-pending" : report.reasonCode,
       reasons: depsPending ? ["Runway app is installed; JavaScript dependencies are pending until dispatch-time launch."] : report.reasons,
-      nextAction: report.decision === "ready" && !depsPending ? void 0 : `mm-harness launch ${platform} --adapter mobile --target ${shellQuote(path.resolve(target))}`,
+      nextAction: report.decision === "ready" && !depsPending ? void 0 : mobileRuntimeNextAction(report.reasonCode, target, platform),
       deps: runwayProvisioned && report.checks?.deps?.status !== "current" ? "pending" : report.checks?.deps?.status,
       devServer: { label: "metro", status: report.checks?.metro?.status ?? "unprobed" }
     };
@@ -58,5 +62,6 @@ const mobileSurface = {
   }
 };
 export {
+  mobileRuntimeNextAction,
   mobileSurface
 };

package/dist/doctor.js

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import { createRequire } from "node:module";
 import path from "node:path";
 import { color } from "./cli-color.js";
 import {
@@ -148,7 +149,8 @@ function createDoctorReport(adapter, target, manifestValidation, actionManifestP
       required: false,
       message: mode === "unsupported/no bridge" ? `No ${adapter} bridge is available for this checkout.` : `${adapter} compatibility mode: ${mode}.`
     },
-    ...adapter === "mobile" ? mobileToolDoctorChecks(mobilePlatform) : []
+    ...adapter === "mobile" ? mobileToolDoctorChecks(mobilePlatform) : [],
+    ...adapter === "extension" ? [extensionBrowserDoctorCheck(target)] : []
   ];
   const requiredChecks = requiredDoctorCheckSummary(checks);
   return {
@@ -169,6 +171,32 @@ function createDoctorReport(adapter, target, manifestValidation, actionManifestP
     manifestValidation: manifestValidation.summary
   };
 }
+function extensionBrowserDoctorCheck(target) {
+  const requireFromTarget = createRequire(path.join(path.resolve(target), "package.json"));
+  for (const packageName of ["@playwright/test", "playwright"]) {
+    try {
+      const playwright = requireFromTarget(packageName);
+      const executable = playwright.chromium?.executablePath?.();
+      if (executable && fs.existsSync(executable)) {
+        return {
+          id: "playwright-chromium",
+          status: "pass",
+          required: true,
+          message: "Checkout-pinned Playwright Chromium is installed.",
+          detail: executable
+        };
+      }
+    } catch {
+    }
+  }
+  return {
+    id: "playwright-chromium",
+    status: "fail",
+    required: true,
+    message: "Checkout-pinned Playwright Chromium is not installed.",
+    userAction: "yarn playwright install chromium"
+  };
+}
 function mobileToolDoctorChecks(platform) {
   const specs = platform === "android" ? [{ tool: "adb", platform: "Android" }] : platform === "ios" ? [{ tool: "idb", platform: "iOS" }] : [
     { tool: "adb", platform: "Android" },
@@ -250,6 +278,7 @@ function readJsonObject(file) {
 export {
   compatibilityMode,
   createDoctorReport,
+  extensionBrowserDoctorCheck,
   fixtureFileSummary,
   fixtureSummary,
   mobileToolDoctorChecks,

package/package.json

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

package/scripts/site-contrast.mjs

@@ -146,6 +146,7 @@ const REVEAL = String.raw`
     const d = document.getElementById(l.getAttribute('aria-controls'));
     if (d) d.hidden = false;
   });
+  document.querySelectorAll('[role="tabpanel"][hidden]').forEach((p) => { p.hidden = false; });
   return true;
 })()
 `;
@@ -331,6 +332,9 @@ async function auditPage(browserEndpoint, url) {
 async function checkBehavior(browserEndpoint, port, pages) {
   const base = `http://127.0.0.1:${port}/`;
   await withPage(browserEndpoint, `${base}index.html`, async (page) => {
+    // Step 1 is the hero call to action; it was a collapsible before, so accept
+    // either shape. Step 2 is a tabbed set of prompts, one per kind of work —
+    // every one of them has to survive a copy, including the hidden panels.
     const copied = await page.evaluate(String.raw`
       (async () => {
         Object.defineProperty(navigator, 'clipboard', {
@@ -342,22 +346,45 @@ async function checkBehavior(browserEndpoint, port, pages) {
             },
           },
         });
-        // 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));
-        return window.__siteCopied;
+        async function grab(button) {
+          if (!button) throw new Error('copy button was not initialized');
+          window.__siteCopied = null;
+          button.click();
+          await new Promise((resolve) => setTimeout(resolve, 25));
+          return window.__siteCopied;
+        }
+        const out = { setup: await grab(document.querySelector('.cmd-hero .copy, .prompt .copy')), work: [] };
+        for (const tab of document.querySelectorAll('[role="tab"]')) {
+          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;
       })()
     `);
-    // 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));
+    // Setting up installs the harness and the skills; the work prompts invoke
+    // them by their exact installed names.
+    const expected = [
+      ['npm i -g @deeeed/metamask-harness@latest', copied.setup],
+      ['yarn skills', copied.setup],
+      ['/mms-recipe-pr-qa-review', copied.work.join('\n')],
+      ['/mms-recipe-cook', copied.work.join('\n')],
+    ];
+    const missing = expected.filter(([line, text]) => !text?.includes(line)).map(([line]) => line);
     if (missing.length) {
       throw new Error(`copy prompt omitted ${missing.map((m) => `"${m}"`).join(', ')}`);
     }
+    if (copied.work.length < 3) {
+      throw new Error(`expected three work prompts, copied ${copied.work.length}`);
+    }
 
     // The landing page is the lobby: one prompt, one way onward, nothing else.
     const lobby = await page.evaluate(String.raw`

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>