@deeeed/metamask-harness 0.14.0 → 0.14.2

package/adapters/extension/sidepanel-toggle.sh

@@ -36,6 +36,11 @@ fi
 shift || true
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+for _hp in "$SCRIPT_DIR/lib/harness-path.sh" "$SCRIPT_DIR/../../adapters/shared/harness-path.sh" "$SCRIPT_DIR/../shared/harness-path.sh"; do
+  [ -f "$_hp" ] && { . "$_hp"; break; }
+done
+unset _hp
 REPO="${REPO:-}"
 if [ -z "$REPO" ]; then
   d="$SCRIPT_DIR"
@@ -52,6 +57,12 @@ if [ -z "$REPO" ]; then
   exit 1
 fi
 cd "$REPO"
+if command -v recipe_runtime_dir >/dev/null 2>&1; then
+  RUNTIME_DIR="$(recipe_runtime_dir)"
+else
+  RUNTIME_DIR="${RECIPE_RUNTIME_DIR:-temp/recipe/runtime}"
+fi
+RUNTIME_DIST_DIR="${RECIPE_RUNTIME_DIST_DIR:-runtime-dist}"
 
 CDP_PORT="${CDP_PORT:-}"
 EXT_ID="${EXT_ID:-}"
@@ -94,14 +105,33 @@ find_sidepanel_id() {
 }
 
 resolve_ext_id() {
-  if [ -n "$EXT_ID" ]; then
+  if [[ "$EXT_ID" =~ ^[a-p]{32}$ ]]; then
     printf '%s\n' "$EXT_ID"
     return
   fi
-  for idf in "$AGENT_DIR/extension.id" "$REPO/temp/recipe/runtime/extension.id"; do
+
+  local manifest_id
+  manifest_id="$(
+    SCRIPT_DIR="$SCRIPT_DIR" REPO="$REPO" RUNTIME_DIR="$RUNTIME_DIR" RUNTIME_DIST_DIR="$RUNTIME_DIST_DIR" node <<'NODE' 2>/dev/null || true
+const path = require('node:path');
+const { extensionIdFromManifestFile } = require(path.join(process.env.SCRIPT_DIR, 'lib/extension-id.cjs'));
+const id = extensionIdFromManifestFile(path.join(process.env.REPO, process.env.RUNTIME_DIR, process.env.RUNTIME_DIST_DIR, 'manifest.json'));
+if (id) process.stdout.write(id);
+NODE
+  )"
+  if [[ "$manifest_id" =~ ^[a-p]{32}$ ]]; then
+    printf '%s\n' "$manifest_id"
+    return
+  fi
+
+  for idf in "$REPO/$RUNTIME_DIR/extension.id" "$AGENT_DIR/extension.id"; do
     if [ -f "$idf" ]; then
-      tr -d '[:space:]' < "$idf"
-      return
+      local marker_id
+      marker_id="$(tr -d '[:space:]' < "$idf")"
+      if [[ "$marker_id" =~ ^[a-p]{32}$ ]]; then
+        printf '%s\n' "$marker_id"
+        return
+      fi
     fi
   done
   json_list | python3 -c "import json,re,sys; d=json.load(sys.stdin); ids=[]; [ids.extend(re.findall(r'^chrome-extension://([^/]+)/', t.get('url',''))) for t in d]; print(ids[0] if ids else '')"
@@ -142,6 +172,32 @@ print_targets() {
   json_list | python3 -c "import json,sys; d=json.load(sys.stdin); [print(f'  {t.get(\"type\",\"?\")[:18]:18s} {t.get(\"url\",\"\")[:100]}') for t in d]"
 }
 
+activate_dapp_tab() {
+  local target_id
+  target_id="$(
+    json_list | python3 -c "import json,sys; d=json.load(sys.stdin); pages=[t for t in d if t.get('type')=='page']; target=next((t for t in pages if t.get('url','').startswith('http://') or t.get('url','').startswith('https://')), None); print(target.get('id','') if target else '')"
+  )"
+  if [ -n "$target_id" ]; then
+    curl -s "http://127.0.0.1:${CDP_PORT}/json/activate/${target_id}" >/dev/null || true
+  fi
+}
+
+cleanup_sidepanel_tabs() {
+  local ext_id close_ids
+  ext_id="$(resolve_ext_id)"
+  [ -n "$ext_id" ] || return 0
+  close_ids="$(
+    json_list | EXT_ID="$ext_id" python3 -c "import json,os,sys; d=json.load(sys.stdin); ext=os.environ.get('EXT_ID',''); has_panel=any(t.get('type')=='page' and t.get('url','').startswith('chrome-extension://'+ext+'/') and 'sidepanel.html' in t.get('url','') for t in d); has_dapp=any(t.get('type')=='page' and (t.get('url','').startswith('http://') or t.get('url','').startswith('https://')) for t in d); print('\\n'.join(t.get('id','') for t in d if has_panel and has_dapp and t.get('type')=='page' and t.get('url','').startswith('chrome-extension://'+ext+'/') and 'home.html' in t.get('url','')))"
+  )"
+  if [ -n "$close_ids" ]; then
+    while IFS= read -r target_id; do
+      [ -n "$target_id" ] || continue
+      curl -s "http://127.0.0.1:${CDP_PORT}/json/close/${target_id}" >/dev/null || true
+    done <<< "$close_ids"
+  fi
+  activate_dapp_tab
+}
+
 status_sidepanel() {
   local sp
   sp="$(find_sidepanel_id)"
@@ -165,6 +221,7 @@ close_sidepanel() {
 
 open_sidepanel() {
   if [ -n "$(find_sidepanel_id)" ]; then
+    cleanup_sidepanel_tabs
     echo "[sidepanel] already open"
     return 0
   fi
@@ -186,7 +243,6 @@ const { chromium } = require('playwright');
   const extId = process.env.EXT_ID;
   const browser = await chromium.connectOverCDP(`http://127.0.0.1:${port}`);
   const context = browser.contexts()[0];
-  let createdPage = false;
   let page = context
     .pages()
     .find(
@@ -197,7 +253,6 @@ const { chromium } = require('playwright');
 
   if (!page) {
     page = await context.newPage();
-    createdPage = true;
     await page.goto(`chrome-extension://${extId}/home.html`, {
       waitUntil: 'domcontentloaded',
       timeout: 15000,
@@ -241,23 +296,35 @@ const { chromium } = require('playwright');
     document.getElementById('__recipe_open_sidepanel__')?.remove();
   });
 
-  // The wallet now lives in the sidepanel: leftover extension home tabs would
-  // show it twice and steal the foreground from the dapp tab. Close every
-  // non-sidepanel extension page (not just one this helper created), then
-  // bring the first http(s) tab back to front.
-  for (const candidate of context.pages()) {
-    if (
-      candidate.url().startsWith(`chrome-extension://${extId}/`) &&
-      !candidate.url().includes('/sidepanel.html')
-    ) {
-      try {
-        await candidate.close();
-      } catch (error) {
-        console.warn(
-          `[sidepanel] extension page close failed after successful open: ${
-            error && error.message ? error.message : error
-          }`,
-        );
+  const deadline = Date.now() + 5000;
+  let sidepanelPage;
+  while (Date.now() < deadline) {
+    sidepanelPage = context
+      .pages()
+      .find((candidate) => candidate.url().startsWith(`chrome-extension://${extId}/`) && candidate.url().includes('/sidepanel.html'));
+    if (sidepanelPage) break;
+    await new Promise((resolve) => setTimeout(resolve, 200));
+  }
+
+  // Only collapse fullscreen extension tabs after Chrome exposes the sidepanel
+  // target. chrome.sidePanel.open can return before the panel page appears; if we
+  // close home first, a slow/failed panel leaves the operator with no visible
+  // wallet page and the next readiness probe has to reopen from scratch.
+  if (sidepanelPage) {
+    for (const candidate of context.pages()) {
+      if (
+        candidate.url().startsWith(`chrome-extension://${extId}/`) &&
+        !candidate.url().includes('/sidepanel.html')
+      ) {
+        try {
+          await candidate.close();
+        } catch (error) {
+          console.warn(
+            `[sidepanel] extension page close failed after successful open: ${
+              error && error.message ? error.message : error
+            }`,
+          );
+        }
       }
     }
   }
@@ -271,7 +338,11 @@ const { chromium } = require('playwright');
       // focus is cosmetic; the panel is already open
     }
   }
-  await browser.close();
+  if (typeof browser.disconnect === 'function') {
+    await browser.disconnect();
+  } else {
+    await browser.close();
+  }
 })().catch((error) => {
   console.error(`FAIL: ${error.message || error}`);
   process.exit(4);
@@ -279,6 +350,7 @@ const { chromium } = require('playwright');
 NODE
 
   if wait_for_sidepanel; then
+    cleanup_sidepanel_tabs
     echo "[sidepanel] opened"
     return 0
   fi

package/adapters/extension/verify.sh

@@ -385,6 +385,14 @@ if [ "$STATIC_ONLY" = false ]; then
   else
     live_mode="live"
     cdp_holder_json "$CDP_PORT" > "$ARTIFACTS/logs/cdp-holder.json"
+    if "$RUNNER_BIN" ensure-ready --adapter extension --target "$TARGET" --cdp-port "$CDP_PORT" --json > "$ARTIFACTS/logs/extension-ensure-ready.json" 2>&1; then
+      checks+=("{\"name\":\"home-tab convergence\",\"status\":\"pass\",\"detail\":\"see logs/extension-ensure-ready.json\"}")
+      refresh_extension_id
+    else
+      checks+=("{\"name\":\"home-tab convergence\",\"status\":\"fail\",\"detail\":\"see logs/extension-ensure-ready.json\"}")
+      status="fail"
+    fi
+
     if node "$READINESS_MJS" --target "$TARGET" --cdp-port "$CDP_PORT" --json > "$ARTIFACTS/logs/extension-readiness.json" 2>&1; then
       checks+=("{\"name\":\"live extension readiness\",\"status\":\"pass\"}")
       # extension-readiness.mjs may repair $RUNTIME_DIR/extension.id when the
@@ -438,6 +446,8 @@ try { distFreshness = JSON.parse(fs.readFileSync(path.join(artifacts, 'logs/dist
 try { fixtureStatus = JSON.parse(fs.readFileSync(path.join(artifacts, 'logs/fixture-status.json'), 'utf8')); } catch {}
 try { cdpHolder = JSON.parse(fs.readFileSync(path.join(artifacts, 'logs/cdp-holder.json'), 'utf8')); } catch {}
 try { readinessReport = JSON.parse(fs.readFileSync(path.join(artifacts, 'logs/extension-readiness.json'), 'utf8')); } catch {}
+let ensureReadyReport = null;
+try { ensureReadyReport = JSON.parse(fs.readFileSync(path.join(artifacts, 'logs/extension-ensure-ready.json'), 'utf8')); } catch {}
 function runGit(args) {
   try {
     return cp.execFileSync('git', ['-C', target, ...args], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
@@ -498,6 +508,7 @@ fs.writeFileSync(path.join(artifacts, 'summary.json'), `${JSON.stringify({
   },
   fixtureStatus,
   cdpHolder,
+  ensureReady: ensureReadyReport,
   cdpTarget,
   checks: parsedChecks,
   generatedAt: new Date().toISOString(),

package/adapters/extension/wallet-fixture-state.cjs

@@ -20,6 +20,7 @@ const crypto = require('node:crypto');
 const fs = require('node:fs');
 const http = require('node:http');
 const path = require('node:path');
+const { extensionIdFromManifestKey } = require('./lib/extension-id.cjs');
 
 const EOA_METHODS = [
   'personal_sign',
@@ -573,16 +574,6 @@ function extensionIdFromUrl(url) {
   return String(url).split('/')[2] || '';
 }
 
-function extensionIdFromManifestKey(key) {
-  if (!key) {
-    return '';
-  }
-  const digest = crypto.createHash('sha256').update(Buffer.from(key, 'base64')).digest();
-  return [...digest.subarray(0, 16)]
-    .map((byte) => `${'abcdefghijklmnop'[byte >> 4]}${'abcdefghijklmnop'[byte & 0x0f]}`)
-    .join('');
-}
-
 function versionedStorageState(fixtureState) {
   return fixtureState.data
     ? { data: fixtureState.data, meta: { ...(fixtureState.meta || {}), storageKind: 'data' } }
@@ -639,6 +630,10 @@ async function detectExtension(context, extensionDir, extensionIdFile) {
   const expectedServiceWorker = manifest.background?.service_worker || '';
   const manifestId = extensionIdFromManifestKey(manifest.key);
   const rejected = new Set();
+  if (manifestId && extensionIdFile) {
+    fs.mkdirSync(path.dirname(extensionIdFile), { recursive: true });
+    fs.writeFileSync(extensionIdFile, `${manifestId}\n`);
+  }
 
   for (let attempt = 0; attempt < 30; attempt += 1) {
     const candidates = [];
@@ -648,10 +643,10 @@ async function detectExtension(context, extensionDir, extensionIdFile) {
       }
       candidates.push({ id, reason });
     };
+    push(manifestId, 'manifest key');
     if (extensionIdFile && fs.existsSync(extensionIdFile)) {
       push(fs.readFileSync(extensionIdFile, 'utf8').trim(), 'extension id marker');
     }
-    push(manifestId, 'manifest key');
     for (const worker of context.serviceWorkers()) {
       const id = extensionIdFromUrl(worker.url());
       if (expectedServiceWorker && worker.url().endsWith(`/${expectedServiceWorker}`)) {

package/adapters/mobile/open-device.sh

@@ -106,20 +106,47 @@ sim_udid_for_target() {
   if printf '%s' "$target" | grep -Eq '^[0-9A-Fa-f-]{36}$'; then
     printf '%s\n' "$target"; return 0
   fi
-  xcrun simctl list devices available 2>/dev/null \
-    | sed -n "s/.*${target} (\([0-9A-Fa-f-]*\)) (.*/\1/p" | head -1
+  xcrun simctl list devices available --json 2>/dev/null | TARGET_SIMULATOR="$target" node -e '
+let input = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => { input += chunk; });
+process.stdin.on("end", () => {
+  const target = process.env.TARGET_SIMULATOR || "";
+  try {
+    const parsed = JSON.parse(input);
+    for (const devices of Object.values(parsed.devices || {})) {
+      const found = Array.isArray(devices)
+        ? devices.find((device) => device && device.isAvailable !== false && device.name === target)
+        : null;
+      if (found && found.udid) {
+        process.stdout.write(`${found.udid}\n`);
+        return;
+      }
+    }
+  } catch {
+    // Empty stdout means unresolved; callers print the teaching error.
+  }
+});
+'
 }
 
 boot_simulator_if_needed() {
   local target="$1" state=""
   [ "$target" != "booted" ] || return 0
+  local udid=""
+  udid="$(sim_udid_for_target "$target")"
+  if [ -z "$udid" ]; then
+    printf "open-device: configured iOS simulator '%s' does not exist.\n" "$target" >&2
+    printf "Next: mm-harness provision runway ios --adapter mobile --target '%s' --device '%s'\n" "$TARGET" "$target" >&2
+    return 1
+  fi
   local line=""
   line="$(xcrun simctl list devices available 2>/dev/null | grep -F "${target} (" | head -1 || true)"
   case "$line" in *"(Booted)"*) state="Booted" ;; *"(Shutdown)"*) state="Shutdown" ;; esac
   [ "$state" = "Booted" ] && return 0
   printf 'Booting iOS simulator %s%s\n' "$target" "${state:+ ($state)}" >&2
-  xcrun simctl boot "$target" 2>/dev/null || true
-  xcrun simctl bootstatus "$target" -b >/dev/null
+  xcrun simctl boot "$udid" 2>/dev/null || true
+  xcrun simctl bootstatus "$udid" -b >/dev/null
 }
 
 show_simulator() {
@@ -192,7 +219,7 @@ if [ "$PLATFORM" = "ios" ]; then
   # Expo dev-client URL scheme — drives both the deep link and the scheme-approval key.
   DEV_CLIENT_SCHEME="${IOS_DEV_CLIENT_SCHEME:-expo-metamask}"
 
-  boot_simulator_if_needed "$SIM_TARGET"
+  boot_simulator_if_needed "$SIM_TARGET" || exit 1
   show_simulator "$SIM_TARGET"
 
   LAUNCHED=false

package/adapters/shared/resolve-slot-ports-core.mjs

@@ -31,6 +31,8 @@ export function formatKvLines(kv) {
   if (kv.WATCHER_PORT !== undefined) lines.push(`WATCHER_PORT=${kv.WATCHER_PORT}`);
   if (kv.SLOT_ID) lines.push(`SLOT_ID=${kv.SLOT_ID}`);
   if (kv.IOS_SIMULATOR) lines.push(`IOS_SIMULATOR=${kv.IOS_SIMULATOR}`);
+  if (kv.ADB_SERIAL) lines.push(`ADB_SERIAL=${kv.ADB_SERIAL}`);
+  if (kv.ANDROID_DEVICE) lines.push(`ANDROID_DEVICE=${kv.ANDROID_DEVICE}`);
   return lines.length ? `${lines.join('\n')}\n` : '';
 }
 
@@ -54,6 +56,8 @@ function scoreSlot(slot, slotSuffix) {
   const cdp = resources.browser?.cdp_port;
   const port = resources['dev-server']?.port;
   const simulator = resources['ios-sim']?.simulator;
+  const adbSerial = resources['android-emu']?.adb_serial ?? resources.android?.adb_serial;
+  const androidDevice = resources['android-emu']?.device ?? resources.android?.device;
   const session = slot.session ?? '';
   const slotId = slot.id ?? '';
   let score = 0;
@@ -64,7 +68,7 @@ function scoreSlot(slot, slotSuffix) {
     if (slotId.endsWith(`mme-${slotSuffix}`) || slotId.includes(`-mme-${slotSuffix}`)) score += 40;
   }
   if (!slotId.toLowerCase().includes('demo')) score += 5;
-  return [score, cdp, port, slotId, simulator];
+  return [score, cdp, port, slotId, simulator, adbSerial, androidDevice];
 }
 
 export function resolveSlotPortsByRepo(repo) {
@@ -111,12 +115,14 @@ export function resolveSlotPortsByRepo(repo) {
     }
 
     if (best) {
-      const [, cdp, port, slotId, simulator] = best;
+      const [, cdp, port, slotId, simulator, adbSerial, androidDevice] = best;
       return formatKvLines({
         ...(cdp !== undefined ? { CDP_PORT: cdp } : {}),
         ...(port !== undefined ? { WATCHER_PORT: port } : {}),
         ...(slotId ? { SLOT_ID: slotId } : {}),
         ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
+        ...(adbSerial ? { ADB_SERIAL: adbSerial } : {}),
+        ...(androidDevice ? { ANDROID_DEVICE: androidDevice } : {}),
       });
     }
   }
@@ -152,10 +158,14 @@ export function resolveMobileRuntimeContext(repo) {
   if (fs.existsSync(ctxPath)) {
     try {
       const c = JSON.parse(fs.readFileSync(ctxPath, 'utf8'));
-      if (c.simulator || (c.metroPort != null && c.metroPort !== '')) {
+      const adbSerial = c.adbSerial ?? c.androidSerial;
+      const androidDevice = c.androidDevice;
+      if (c.simulator || adbSerial || androidDevice || (c.metroPort != null && c.metroPort !== '')) {
         return formatKvLines({
           ...(c.metroPort != null && c.metroPort !== '' ? { WATCHER_PORT: c.metroPort } : {}),
           ...(c.simulator ? { IOS_SIMULATOR: c.simulator } : {}),
+          ...(adbSerial ? { ADB_SERIAL: adbSerial } : {}),
+          ...(androidDevice ? { ANDROID_DEVICE: androidDevice } : {}),
           ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
         });
       }
@@ -210,4 +220,4 @@ export const cliFns = {
   resolve_mobile_runtime_context: resolveMobileRuntimeContext,
   resolve_mobile_slot_defaults: resolveMobileSlotDefaults,
   resolve_mobile_runtime_ports: (repo) => resolveMobileRuntimePorts(repo) || null,
-};
+};

package/dist/adapters/core/surface.js

@@ -31,6 +31,7 @@ const coreSurface = {
     }
   },
   devServer: {
+    label: "dev-server",
     describe: () => "no dev server (headless)",
     stop() {
       return {

package/dist/adapters/extension/runtime.js

@@ -25,7 +25,8 @@ async function prepareExtensionRuntime(options) {
   const health = await assertHealthyExtensionRuntime({
     projectRoot,
     cdpPort,
-    timeoutMs: options.healthTimeoutMs
+    timeoutMs: options.healthTimeoutMs,
+    pageMode: options.pageMode
   });
   return { launch, health };
 }
@@ -34,14 +35,16 @@ async function assertHealthyExtensionRuntime(options) {
   const deadline = Date.now() + timeoutMs;
   let lastReport = null;
   while (Date.now() <= deadline) {
-    lastReport = await checkExtensionRuntimeHealth(options.projectRoot, options.cdpPort);
+    lastReport = await checkExtensionRuntimeHealth(options.projectRoot, options.cdpPort, {
+      pageMode: options.pageMode
+    });
     if (lastReport.status === "PASS") return lastReport;
     await sleep(500);
   }
   const report = lastReport ?? failReport(options.cdpPort, ["CDP runtime was not probed."], {});
   throw new Error(formatHealthFailure(report, options.projectRoot));
 }
-async function checkExtensionRuntimeHealth(projectRoot, cdpPort) {
+async function checkExtensionRuntimeHealth(projectRoot, cdpPort, options = {}) {
   const findings = [];
   const warnings = [];
   let targets = [];
@@ -52,11 +55,17 @@ async function checkExtensionRuntimeHealth(projectRoot, cdpPort) {
   } catch (error) {
     return failReport(cdpPort, [`CDP is not reachable on port ${cdpPort}: ${messageOf(error)}`], {});
   }
-  const extensionTargets = targets.filter(
+  const pageMode = options.pageMode ?? "home";
+  const homeTargets = targets.filter(
     (target2) => target2.type === "page" && String(target2.url ?? "").startsWith("chrome-extension://") && String(target2.url ?? "").includes("/home.html") && Boolean(target2.webSocketDebuggerUrl)
   );
+  const sidepanelTargets = targets.filter(
+    (target2) => target2.type === "page" && String(target2.url ?? "").startsWith("chrome-extension://") && String(target2.url ?? "").includes("/sidepanel.html") && Boolean(target2.webSocketDebuggerUrl)
+  );
+  const extensionTargets = pageMode === "home-or-sidepanel" && homeTargets.length === 0 ? sidepanelTargets : homeTargets;
   if (extensionTargets.length !== 1) {
-    findings.push(`Expected exactly one MetaMask extension home page target, found ${extensionTargets.length}.`);
+    const expected = pageMode === "home-or-sidepanel" ? "exactly one MetaMask extension home page target, or one sidepanel target when home is intentionally closed" : "exactly one MetaMask extension home page target";
+    findings.push(`Expected ${expected}, found ${extensionTargets.length}.`);
   }
   const target = extensionTargets[0];
   if (!target?.webSocketDebuggerUrl) {

package/dist/adapters/extension/surface.js

@@ -43,6 +43,7 @@ const extensionSurface = {
     }
   },
   devServer: {
+    label: "webpack",
     describe: () => "webpack watcher",
     stop(target) {
       const signalled = stopExtensionWatcher(target);

package/dist/adapters/mobile/provision.js

@@ -457,11 +457,13 @@ function preapproveDeepLinkScheme(device, bundleId, options) {
 function ensureSimulator(name, runtime, deviceType) {
   const existing = findSimulator(name);
   if (existing) return { name, udid: existing, created: false, runtime, deviceType };
-  if (!runtime || !deviceType) {
-    throw new Error(`simulator ${name} is missing and runtime/device type could not be resolved. Pass --runtime and --device-type, or write them to agentic-runtime.json.`);
+  const resolvedRuntime = runtime || latestIosRuntime();
+  const resolvedDeviceType = deviceType || preferredIphoneDeviceType();
+  if (!resolvedRuntime || !resolvedDeviceType) {
+    throw new Error(`simulator ${name} is missing and no available iOS simulator runtime/device type could be resolved from xcrun simctl.`);
   }
-  const udid = execFileSync("xcrun", ["simctl", "create", name, deviceType, runtime], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
-  return { name, udid: udid || name, created: true, runtime, deviceType };
+  const udid = execFileSync("xcrun", ["simctl", "create", name, resolvedDeviceType, resolvedRuntime], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+  return { name, udid: udid || name, created: true, runtime: resolvedRuntime, deviceType: resolvedDeviceType };
 }
 function findSimulator(name) {
   const data = execJson("xcrun", ["simctl", "list", "devices", "--json"]);
@@ -471,6 +473,49 @@ function findSimulator(name) {
   }
   return void 0;
 }
+function latestIosRuntime() {
+  const data = execJson(
+    "xcrun",
+    ["simctl", "list", "runtimes", "--json"]
+  );
+  const runtimes = (data.runtimes ?? []).filter((runtime) => runtime.isAvailable !== false && runtime.identifier && (runtime.platform === "iOS" || /(^|[.-])iOS([.-]|$)/u.test(runtime.identifier) || /^iOS\b/u.test(runtime.name ?? ""))).sort((a, b) => compareVersions(runtimeVersion(b), runtimeVersion(a)));
+  return runtimes[0]?.identifier;
+}
+function preferredIphoneDeviceType() {
+  const data = execJson("xcrun", ["simctl", "list", "devicetypes", "--json"]);
+  const devices = (data.devicetypes ?? []).filter((device) => device.identifier && /^iPhone\b/u.test(device.name ?? "")).sort((a, b) => {
+    const generation = iphoneGeneration(b) - iphoneGeneration(a);
+    if (generation !== 0) return generation;
+    const proScore = iphoneProScore(b) - iphoneProScore(a);
+    if (proScore !== 0) return proScore;
+    return String(b.name ?? "").localeCompare(String(a.name ?? ""));
+  });
+  return devices[0]?.identifier;
+}
+function runtimeVersion(runtime) {
+  const raw = runtime.version || /iOS[-. ]([0-9][0-9A-Za-z_.-]*)/u.exec(runtime.identifier ?? "")?.[1] || runtime.name || "";
+  const parts = raw.match(/\d+/gu)?.map((part) => Number(part)) ?? [];
+  return parts.length ? parts : [0];
+}
+function compareVersions(a, b) {
+  const length = Math.max(a.length, b.length);
+  for (let i = 0; i < length; i += 1) {
+    const diff = (a[i] ?? 0) - (b[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+function iphoneGeneration(device) {
+  const match = /^iPhone\s+(\d+)/u.exec(device.name ?? "");
+  return match ? Number(match[1]) : 0;
+}
+function iphoneProScore(device) {
+  const name = device.name ?? "";
+  if (/\bPro Max\b/u.test(name)) return 3;
+  if (/\bPro\b/u.test(name)) return 2;
+  if (/\bPlus\b/u.test(name)) return 1;
+  return 0;
+}
 function baselineSimulatorCandidates(data, current) {
   const candidates = [];
   if (current.simulator) candidates.push(current.simulator);

package/dist/adapters/mobile/surface.js

@@ -29,6 +29,7 @@ const mobileSurface = {
     }
   },
   devServer: {
+    label: "metro",
     describe: () => "Metro dev server",
     stop(target) {
       const leaf = path.join(runnerDir, "adapters", "mobile", "stop-metro.sh");

package/dist/adapters/slot-ports.js

@@ -10,10 +10,8 @@ import {
   resolveMobileSlotDefaults
 } from "./resolve-slot-ports.js";
 function applyKVLines(output, overwrite) {
-  for (const line of output.split("\n")) {
-    const m = /^([A-Z_]+)=(.+)$/u.exec(line.trim());
-    if (!m) continue;
-    const [, key, val] = m;
+  const entries = output.split("\n").map((line) => /^([A-Z_]+)=(.+)$/u.exec(line.trim())).filter((match) => match !== null).map((match) => ({ key: match[1], val: match[2] }));
+  for (const { key, val } of entries) {
     if (val === "null" || val === "undefined" || val === "") continue;
     switch (key) {
       case "WATCHER_PORT":
@@ -26,6 +24,15 @@ function applyKVLines(output, overwrite) {
       case "IOS_SIMULATOR":
         if (overwrite || !process.env["IOS_SIMULATOR"]) process.env["IOS_SIMULATOR"] = val;
         break;
+      case "ADB_SERIAL":
+        if (overwrite || !process.env["ADB_SERIAL"]) {
+          process.env["ADB_SERIAL"] = val;
+          process.env["ANDROID_SERIAL"] = val;
+        }
+        break;
+      case "ANDROID_DEVICE":
+        if (overwrite || !process.env["ANDROID_DEVICE"]) process.env["ANDROID_DEVICE"] = val;
+        break;
       case "SLOT_ID":
         if (overwrite || !process.env["RECIPE_SLOT_ID"]) process.env["RECIPE_SLOT_ID"] = val;
         break;

package/dist/cli.js

@@ -19,6 +19,7 @@ import { handleDebug } from "./commands/debug.js";
 import { handleFixtures } from "./commands/fixtures.js";
 import { handleRecipeQuality } from "./commands/recipe-quality.js";
 import { handleStatus } from "./commands/status.js";
+import { handleCheck } from "./commands/check.js";
 import { parseArgs, targetPath } from "./commands/parse-args.js";
 import { runOneNode } from "./commands/run-engine.js";
 const COMMANDS = {
@@ -56,6 +57,8 @@ PROVE \u2014 run recipes and inspect capabilities:
                mm-harness flows list
   doctor     Readiness check for a checkout (no app launch).
                mm-harness doctor
+  check      Run bounded repo-local checks for an active diff.
+               mm-harness check diff --profile fast --artifacts-dir artifacts/validation
   actions    Describe the actions a manifest declares.
                mm-harness actions --adapter mobile
   manifest   Print/validate the action manifest for an adapter.
@@ -127,6 +130,7 @@ async function main(argv) {
   if (command === "debug") return handleDebug(argv.slice(1));
   if (command === "fixtures") return handleFixtures(argv.slice(1), { runOneNode });
   if (command === "recipe-quality") return handleRecipeQuality(argv.slice(1));
+  if (command === "check") return handleCheck(argv.slice(1));
   const handler = COMMANDS[command];
   if (!handler) throw new Error(`Unknown command: ${command}`);
   return handler(parseArgs(argv.slice(1), command));

package/dist/commands/call.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { loadActionManifest } from "../manifest.js";
 import { importRecipeProtocol } from "../paths.js";
 import { recipeRunning } from "../heal-bounds.js";
+import { color } from "../cli-color.js";
 import { EXIT } from "./shared.js";
 import { describeManifestActions, fuzzyResolveActions } from "./manifest.js";
 import {
@@ -19,6 +20,7 @@ import {
 import { getAdapterSurface } from "../adapters/surface.js";
 import { handleListExecutables } from "./list-executables.js";
 import { applyDeviceTargeting } from "./device-target.js";
+import { coreDependencyBlock } from "./core-readiness.js";
 import {
   emitHealViolation,
   executeWithHealBounds,
@@ -96,6 +98,16 @@ async function handleCall(argv) {
     return EXIT.usage;
   }
   const resolvedAction = resolution.resolved;
+  const depsBlock = adapter === "core" && resolvedAction.startsWith("metamask.perps.") ? coreDependencyBlock(target) : null;
+  if (depsBlock) {
+    if (json) {
+      console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, status: "fail", exitCode: EXIT.usage, error: depsBlock }, null, 2));
+    } else {
+      console.error(`\u2717 call: ${depsBlock.message}`);
+      console.error(`  Next: ${depsBlock.userAction}`);
+    }
+    return EXIT.usage;
+  }
   const recipe = synthesizeOneNodeRecipe(resolvedAction, args);
   const validation = await validateRecipeAdapterAware(recipe, manifest);
   if (validation.status === "invalid") {
@@ -157,8 +169,13 @@ async function handleCall(argv) {
     const rendered = callOutput !== void 0 ? `
 Result:
 ${formatCallOutput(callOutput)}` : "";
-    console.log(`call ${resolvedAction}: ${result.status}${rendered}
-Artifacts: ${result.artifactManifestPath}`);
+    const out = (style, text) => color(style, text, { stream: process.stdout });
+    console.log(
+      `${out("label", "call")} ${out("cmd", resolvedAction)}: ${out(result.status === "pass" ? "ok" : "err", result.status)}${rendered ? `
+${out("label", "Result:")}
+${formatCallOutput(callOutput)}` : ""}
+${out("label", "Artifacts:")} ${out("path", result.artifactManifestPath)}`
+    );
   }
   return result.status === "pass" ? EXIT.ok : EXIT.runtime;
 }