@deeeed/metamask-harness 0.79.0 → 0.81.0

package/dist/adapters/mobile/fixtures.js

@@ -1,5 +1,5 @@
+import { EXIT, spawnScriptStreaming } from "@farmslot/recipe-cli/harness";
 import path from "node:path";
-import { EXIT, spawnScriptStreaming } from "../../commands/shared.js";
 import { runnerDir } from "../../paths.js";
 import { FIXTURE_STREAM_TIMEOUT_MS } from "../../commands/fixtures.js";
 const FIXTURE_BRIDGE_READY_TIMEOUT_MS = 18e4;

package/dist/adapters/mobile/launch.js

@@ -1,10 +1,9 @@
 import fs from "node:fs";
+import { recipeRuntimePath, EXIT, str, writeInteractiveProgress } from "@farmslot/recipe-cli/harness";
 import { applyDeviceTargeting } from "../../commands/device-target.js";
 import { launchMobile } from "../../commands/launch/mobile.js";
 import { shellQuote } from "../../commands/launch/quote.js";
-import { EXIT, str, writeInteractiveProgress } from "../../commands/shared.js";
-import { RECOVERY_CODE } from "../../heal-bounds.js";
-import { recipeRuntimePath } from "../../paths.js";
+const METRO_RESTARTED = "metro.restarted";
 function mobileProvisioningBlocked(output) {
   return /open-device: configured iOS simulator '.+' does not exist|open-device: no MetaMask bundle found|fast mode requires an installed (?:iOS dev client|Android dev client)/u.test(output);
 }
@@ -17,8 +16,8 @@ function ambiguousConfiguredIosSimulator(output) {
 function mobileBridgeTargetMissing(output) {
   return /no bridge target matched|wait-for-bridge: readiness deadline expired/iu.test(output);
 }
-function mobileProvisionCommand(target, mobileTarget) {
-  const platform = mobileTarget === "android" ? "android" : "ios";
+function mobileProvisionCommand(target, platformTarget) {
+  const platform = platformTarget === "android" ? "android" : "ios";
   const device = platform === "ios" ? process.env.SIM_UDID || process.env.IOS_SIMULATOR : process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || process.env.ANDROID_DEVICE;
   const parts = ["mm-harness", "provision", "runway", platform, "--adapter", "mobile", "--target", shellQuote(target)];
   if (device) parts.push("--device", shellQuote(device));
@@ -27,11 +26,11 @@ function mobileProvisionCommand(target, mobileTarget) {
 function isIosSimulatorUdid(value) {
   return /^[0-9A-Fa-f-]{36}$/u.test(value);
 }
-function launchDeviceLabel(mobileTarget) {
-  if (mobileTarget === "android") {
+function launchDeviceLabel(platformTarget) {
+  if (platformTarget === "android") {
     return process.env.ANDROID_TARGET_DEVICE_NAME || process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || process.env.ANDROID_DEVICE || "android device";
   }
-  if (mobileTarget === "ios") {
+  if (platformTarget === "ios") {
     return process.env.IOS_SIMULATOR || process.env.SIM_UDID || "iOS simulator";
   }
   return process.env.IOS_SIMULATOR || process.env.ADB_SERIAL || "booted device";
@@ -51,22 +50,22 @@ function metroLaunchEvidence(target) {
   }
 }
 const mobileLaunchProfile = {
-  refuseFlags({ mobileTarget }) {
-    if (!mobileTarget) {
+  refuseFlags({ platformTarget }) {
+    if (!platformTarget) {
       return { message: "target is required for mobile.", userAction: "mm-harness launch ios   or   mm-harness launch android" };
     }
     return void 0;
   },
-  applyEnv({ adapter, options, mobileTarget, target }) {
+  applyEnv({ adapter, options, platformTarget, target }) {
     const device = str(options, "device");
-    if (!device && mobileTarget !== "ios" && mobileTarget !== "android") return void 0;
+    if (!device && platformTarget !== "ios" && platformTarget !== "android") return void 0;
     const targetingOptions = {
       ...options,
-      ...mobileTarget ? { platform: mobileTarget } : {}
+      ...platformTarget ? { platform: platformTarget } : {}
     };
     const result = applyDeviceTargeting("launch", adapter, targetingOptions, { gate: false, rerun: "" });
     if ("code" in result) {
-      if (mobileTarget === "ios" && result.code === "DEVICE_NOT_FOUND") {
+      if (platformTarget === "ios" && result.code === "DEVICE_NOT_FOUND") {
         process.env.IOS_SIMULATOR = device;
         process.env.SIM_UDID = isIosSimulatorUdid(device) ? device : "";
         process.env.ADB_SERIAL = "";
@@ -77,7 +76,7 @@ const mobileLaunchProfile = {
         return result;
       }
     }
-    if (mobileTarget === "android" && device && !process.env.ADB_SERIAL && !process.env.ANDROID_SERIAL) {
+    if (platformTarget === "android" && device && !process.env.ADB_SERIAL && !process.env.ANDROID_SERIAL) {
       return {
         ok: false,
         code: "DEVICE_WRONG_PLATFORM",
@@ -85,7 +84,7 @@ const mobileLaunchProfile = {
         userAction: `mm-harness status --target ${shellQuote(target)} --all-devices --json`
       };
     }
-    if (mobileTarget === "ios" && device && !process.env.IOS_SIMULATOR) {
+    if (platformTarget === "ios" && device && !process.env.IOS_SIMULATOR) {
       return {
         ok: false,
         code: "DEVICE_WRONG_PLATFORM",
@@ -95,17 +94,17 @@ const mobileLaunchProfile = {
     }
     return void 0;
   },
-  start({ options, mobileTarget, machine, tier, wantClearMetro }) {
-    const device = str(options, "device") ?? (mobileTarget === "android" ? process.env.ADB_SERIAL ?? process.env.ANDROID_SERIAL : process.env.IOS_SIMULATOR ?? process.env.SIM_UDID) ?? "configured device";
+  start({ options, platformTarget, machine, tier, wantClearMetro }) {
+    const device = str(options, "device") ?? (platformTarget === "android" ? process.env.ADB_SERIAL ?? process.env.ANDROID_SERIAL : process.env.IOS_SIMULATOR ?? process.env.SIM_UDID) ?? "configured device";
     const watcherPort = str(options, "watcherPort") ?? process.env.WATCHER_PORT ?? "auto";
     writeInteractiveProgress(
       machine,
-      `\u2192 mobile launch \u2014 ${mobileTarget} \xB7 ${tier === "build" ? "native build" : "quick readiness"} \xB7 ${device} \xB7 Metro ${watcherPort === "auto" ? "auto" : `:${watcherPort}`}${wantClearMetro ? " \xB7 clear cache" : ""}`
+      `\u2192 mobile launch \u2014 ${platformTarget} \xB7 ${tier === "build" ? "native build" : "quick readiness"} \xB7 ${device} \xB7 Metro ${watcherPort === "auto" ? "auto" : `:${watcherPort}`}${wantClearMetro ? " \xB7 clear cache" : ""}`
     );
   },
   nativeInputs: ["ios", "android", "package.json", "yarn.lock"],
-  rebuildCommand: ({ mobileTarget }) => `mm-harness launch ${mobileTarget} --build`,
-  compose: ({ target, mobileTarget, machine, remoteFlagRequest }, tier, restartApp, clearMetro) => launchMobile(target, mobileTarget, tier, machine, restartApp, clearMetro, remoteFlagRequest?.flags),
+  rebuildCommand: ({ platformTarget }) => `mm-harness launch ${platformTarget} --build`,
+  compose: ({ target, platformTarget, machine, remoteFlagRequest }, tier, restartApp, clearMetro) => launchMobile(target, platformTarget, tier, machine, restartApp, clearMetro, remoteFlagRequest?.flags),
   classify(_launch, output) {
     if (output.includes("open-device: Android device is locked.")) {
       return {
@@ -130,7 +129,7 @@ const mobileLaunchProfile = {
     return void 0;
   },
   async beforeHeal(launch, attempt, state) {
-    const { target, mobileTarget, tier } = launch;
+    const { target, platformTarget, tier } = launch;
     const output = attempt.output;
     const missingIosSimulator = missingConfiguredIosSimulator(output);
     const ambiguousIosSimulator = ambiguousConfiguredIosSimulator(output);
@@ -157,9 +156,9 @@ const mobileLaunchProfile = {
     if (mobileProvisioningBlocked(output)) {
       return launch.fail(state, {
         code: "MOBILE_PROVISION_REQUIRED",
-        message: `mobile ${mobileTarget ?? "runtime"} is not provisioned for this slot.`,
+        message: `mobile ${platformTarget ?? "runtime"} is not provisioned for this slot.`,
         recoverable: false,
-        userAction: mobileProvisionCommand(target, mobileTarget),
+        userAction: mobileProvisionCommand(target, platformTarget),
         exitCode: EXIT.runtime,
         originalError: output.trim() || void 0
       });
@@ -177,14 +176,14 @@ const mobileLaunchProfile = {
   },
   recovery(_launch, output) {
     const restartApp = mobileBridgeTargetMissing(output);
-    return { code: restartApp ? "mobile.app-restarted" : RECOVERY_CODE.mobile, restartApp };
+    return { code: restartApp ? "mobile.app-restarted" : METRO_RESTARTED, restartApp };
   },
   // Mobile proved its set inside launchMobile (null: nothing requested and no
   // runtime answered).
   provenFlags: (_launch, requested, proven) => ({ flags: proven === void 0 ? requested : proven }),
-  verifyArgs: ({ mobileTarget }) => mobileTarget ? ["--platform", mobileTarget] : [],
-  platformLabel: ({ mobileTarget }) => mobileTarget ?? null,
-  deviceLabel: ({ mobileTarget }) => launchDeviceLabel(mobileTarget),
+  verifyArgs: ({ platformTarget }) => platformTarget ? ["--platform", platformTarget] : [],
+  platformLabel: ({ platformTarget }) => platformTarget ?? null,
+  deviceLabel: ({ platformTarget }) => launchDeviceLabel(platformTarget),
   evidence: metroLaunchEvidence
 };
 export {

package/dist/adapters/mobile/lifecycle.js

@@ -3,7 +3,7 @@ import {
   bridgeCommand,
   MOBILE_BRIDGE_ERROR_CODES
 } from "../../../library/actions/mobile/platform/bridge.mjs";
-import { resolveMobileToolPath } from "../../../library/actions/mobile/platform/tool-paths.mjs";
+import { resolveMobileToolPath } from "@farmslot/adapter-rn";
 import {
   MOBILE_LIFECYCLE_DEADLINE_FIELD,
   MOBILE_LIFECYCLE_PREPARED

package/dist/adapters/mobile/metro-env.js

@@ -1,68 +1,18 @@
-import { createHash } from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-import { recipeRuntimePath } from "../../paths.js";
-const ENV_INPUTS = [".js.env", ".env", ".env.local"];
-const PROCESS_ENV_INPUTS = [
-  "SEGMENT_PROXY_URL",
-  "SEGMENT_WRITE_KEY",
-  "SEGMENT_FLUSH_INTERVAL",
-  "SEGMENT_FLUSH_EVENT_LIMIT"
-];
+import { metroEnvCheck, metroEnvFingerprint, recordMetroEnvBaseline } from "@farmslot/adapter-rn";
+import { recipeRuntimePath } from "@farmslot/recipe-cli/harness";
+const MOBILE_METRO_ENV_INPUTS = {
+  files: [".js.env", ".env", ".env.local"],
+  env: ["SEGMENT_PROXY_URL", "SEGMENT_WRITE_KEY", "SEGMENT_FLUSH_INTERVAL", "SEGMENT_FLUSH_EVENT_LIMIT"]
+};
 const BASELINE_FILE = "metro-env-baseline.json";
 function mobileMetroEnvFingerprint(target) {
-  const hash = createHash("sha256");
-  for (const relative of ENV_INPUTS) {
-    const absolute = path.join(target, relative);
-    hash.update(`${relative}\0`);
-    if (fs.existsSync(absolute)) hash.update(fs.readFileSync(absolute));
-    else hash.update("<absent>");
-    hash.update("\0");
-  }
-  for (const name of PROCESS_ENV_INPUTS) {
-    hash.update(`${name}\0${process.env[name] ?? "<absent>"}\0`);
-  }
-  return hash.digest("hex");
+  return metroEnvFingerprint(target, MOBILE_METRO_ENV_INPUTS);
 }
 function mobileMetroEnvCheck(target) {
-  const fingerprint = mobileMetroEnvFingerprint(target);
-  const marker = readBaseline(target);
-  return {
-    fingerprint,
-    status: marker === null ? "missing" : marker.fingerprint === fingerprint ? "current" : "changed"
-  };
+  return metroEnvCheck(target, MOBILE_METRO_ENV_INPUTS, recipeRuntimePath(target, BASELINE_FILE));
 }
 function recordMobileMetroEnvBaseline(target, expectedFingerprint) {
-  if (mobileMetroEnvFingerprint(target) !== expectedFingerprint) return false;
-  const marker = recipeRuntimePath(target, BASELINE_FILE);
-  const temporary = `${marker}.${process.pid}.${Date.now()}.tmp`;
-  const baseline = {
-    schemaVersion: 1,
-    fingerprint: expectedFingerprint,
-    recordedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  fs.mkdirSync(path.dirname(marker), { recursive: true });
-  try {
-    fs.writeFileSync(temporary, `${JSON.stringify(baseline, null, 2)}
-`, { mode: 384 });
-    if (mobileMetroEnvFingerprint(target) !== expectedFingerprint) return false;
-    fs.renameSync(temporary, marker);
-    if (mobileMetroEnvFingerprint(target) !== expectedFingerprint) {
-      if (readBaseline(target)?.fingerprint === expectedFingerprint) fs.rmSync(marker, { force: true });
-      return false;
-    }
-  } finally {
-    fs.rmSync(temporary, { force: true });
-  }
-  return true;
-}
-function readBaseline(target) {
-  try {
-    const parsed = JSON.parse(fs.readFileSync(recipeRuntimePath(target, BASELINE_FILE), "utf8"));
-    return parsed.schemaVersion === 1 && typeof parsed.fingerprint === "string" ? parsed : null;
-  } catch {
-    return null;
-  }
+  return recordMetroEnvBaseline(target, MOBILE_METRO_ENV_INPUTS, recipeRuntimePath(target, BASELINE_FILE), expectedFingerprint);
 }
 export {
   mobileMetroEnvCheck,

package/dist/adapters/mobile/network-observer.js

@@ -0,0 +1,68 @@
+import path from "node:path";
+import brokerModule from "@farmslot/recipe-runner/cdp-broker";
+import configModule from "@farmslot/adapter-rn/bridge-runtime/lib/config.cjs";
+const { brokerSocketPath, createBrokerClient } = brokerModule;
+const { resolvePort } = configModule;
+async function createMobileNetworkBackend(target, env) {
+  const { client } = await connectMobileBroker(target, env);
+  return {
+    start(params) {
+      return client.control("capture-start", params, 1e4);
+    },
+    async end(id) {
+      return asRecord(await client.control("capture-end", { id }, 1e4));
+    },
+    async close() {
+      client.close();
+    }
+  };
+}
+async function connectMobileBroker(target, env) {
+  const runtimeDir = env.RECIPE_RUNTIME_DIR ? path.resolve(target, env.RECIPE_RUNTIME_DIR) : path.join(target, "temp", "recipe", "runtime");
+  const socketPath = brokerSocketPath(
+    runtimeDir,
+    resolvePort(env, target)
+  );
+  const discoveryClient = await createBrokerClient(socketPath, "", 1e4);
+  let targets;
+  try {
+    targets = await discoveryClient.control(
+      "resolve-targets",
+      { nameIncludes: mobileTargetPin(env) },
+      1e4
+    );
+  } finally {
+    discoveryClient.close();
+  }
+  const deviceId = selectMobileBrokerTarget(targets, env);
+  const client = await createBrokerClient(socketPath, deviceId, 1e4);
+  return { client, deviceId };
+}
+function selectMobileBrokerTarget(value, env) {
+  const targets = Array.isArray(value) ? value.map(asRecord).filter((target) => target.deviceId) : [];
+  const pin = mobileTargetPin(env);
+  const candidates = pin ? targets.filter(
+    (target) => String(target.name ?? "").toLowerCase().includes(pin.toLowerCase())
+  ) : targets;
+  if (candidates.length !== 1) {
+    throw new Error(
+      `Mobile network observation requires one broker target; found ${candidates.length}.`
+    );
+  }
+  return String(candidates[0].deviceId);
+}
+function mobileTargetPin(env) {
+  const platform = String(
+    env.RECIPE_RN_EXPLICIT_PLATFORM ?? env.RECIPE_HARNESS_PLATFORM ?? ""
+  ).toLowerCase();
+  return String(
+    platform === "android" ? env.ANDROID_TARGET_DEVICE_NAME ?? env.ANDROID_DEVICE ?? "" : platform === "ios" ? env.IOS_SIMULATOR ?? "" : env.IOS_SIMULATOR ?? env.ANDROID_TARGET_DEVICE_NAME ?? env.ANDROID_DEVICE ?? ""
+  ).trim();
+}
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+export {
+  connectMobileBroker,
+  createMobileNetworkBackend
+};

package/dist/adapters/mobile/performance-observer.js

@@ -1,9 +1,7 @@
 import {
   createCdpTraceCollector
 } from "../performance/cdp-trace.js";
-import {
-  connectMobileBroker
-} from "../../network-observation.js";
+import { connectMobileBroker } from "./network-observer.js";
 import { createAndroidGfxinfoPerformanceBackend } from "./android-gfxinfo-performance.js";
 async function createMobilePerformanceBackend(target, env) {
   if (resolvePlatform(env) === "android") {
@@ -37,7 +35,7 @@ async function markRuntime(client, name) {
 }
 function resolvePlatform(env) {
   const explicit = String(
-    env.MM_HARNESS_EXPLICIT_PLATFORM ?? env.RECIPE_HARNESS_PLATFORM ?? ""
+    env.RECIPE_RN_EXPLICIT_PLATFORM ?? env.RECIPE_HARNESS_PLATFORM ?? ""
   ).toLowerCase();
   if (explicit === "android" || explicit === "ios") return explicit;
   return env.ADB_SERIAL || env.ANDROID_SERIAL || env.ANDROID_DEVICE ? "android" : "ios";

package/dist/adapters/mobile/prepare-target.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { recipeRuntimeDir } from "../../paths.js";
+import { recipeRuntimeDir } from "@farmslot/recipe-cli/harness";
 function readRuntimeContextTarget(target) {
   const file = path.join(target, recipeRuntimeDir(), "agentic-runtime.json");
   let parsed;

package/dist/adapters/mobile/prepare.js

@@ -1,9 +1,8 @@
+import { EXIT, spawnScriptStreaming, shellQuote } from "@farmslot/recipe-cli/harness";
 import { execFileSync } from "node:child_process";
 import path from "node:path";
 import { recordDepsBaseline } from "@farmslot/recipe-runner/runtime/deps-readiness";
-import { resolveAndExportMobileToolPaths } from "../../../library/actions/mobile/platform/tool-paths.mjs";
-import { EXIT, spawnScriptStreaming } from "../../commands/shared.js";
-import { shellQuote } from "../../commands/parse-args.js";
+import { resolveAndExportMobileToolPaths } from "@farmslot/adapter-rn";
 import { runnerDir } from "../../paths.js";
 import {
   decideMobileReadiness,
@@ -401,7 +400,7 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
         leaf,
         withWatcherPort(["--target", cwd, ...extra], watcherPort),
         target,
-        { MM_HARNESS_METRO_ENV_FINGERPRINT: metroEnvFingerprint ?? mobileMetroEnvCheck(path.resolve(target)).fingerprint }
+        { RECIPE_RN_METRO_ENV_FINGERPRINT: metroEnvFingerprint ?? mobileMetroEnvCheck(path.resolve(target)).fingerprint }
       );
     }
     case "start-console-forwarder": {

package/dist/adapters/mobile/provision.js

@@ -1,9 +1,9 @@
+import { recipeRuntimeDir } from "@farmslot/recipe-cli/harness";
 import { execFileSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { recipeRuntimeDir } from "../../paths.js";
 import { resolveSlotPortsByRepo } from "../../../adapters/shared/resolve-slot-ports-core.mjs";
 const RUNWAY_IOS_METADATA = {
   artifactName: "ios-app-main-dev-expo",

package/dist/adapters/mobile/readiness.js

@@ -1,4 +1,4 @@
-import { optionFlag, optionString, parsePort } from "../../commands/parse-args.js";
+import { optionFlag, optionString, parsePort } from "@farmslot/recipe-cli/harness";
 import { detectOrphanMetros, mobileToolDoctorChecks } from "./doctor-checks.js";
 import { ensureMobilePerpsEnvironment, mobilePerpsEnvironment } from "./perps-env.js";
 const mobileReadiness = {

package/dist/adapters/mobile/recording-target.js

@@ -0,0 +1,15 @@
+function resolveAndroidDeviceSerial(env = process.env) {
+  return env.ADB_SERIAL?.trim() || process.env.ADB_SERIAL?.trim() || void 0;
+}
+function resolveMobileIosSimulatorName(env = process.env) {
+  const explicit = env.IOS_SIMULATOR?.trim() || env.SIM_UDID?.trim();
+  if (explicit) return explicit;
+  const slot = env.FARMSLOT_SLOT_ID?.trim() || env.SLOT_ID?.trim();
+  if (!slot) return void 0;
+  const suffix = slot.includes("-") ? slot.slice(slot.lastIndexOf("-") + 1) : slot;
+  return suffix || void 0;
+}
+export {
+  resolveAndroidDeviceSerial,
+  resolveMobileIosSimulatorName
+};

package/dist/adapters/mobile/release-artifact-state.js

@@ -1,7 +1,7 @@
+import { recipeRuntimePath } from "@farmslot/recipe-cli/harness";
 import { randomBytes } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
-import { recipeRuntimePath } from "../../paths.js";
 import {
   assertAndroidReleaseArtifactRuntime
 } from "./release-artifact.js";

package/dist/adapters/mobile/reload.js

@@ -1,5 +1,5 @@
+import { EXIT, spawnScript } from "@farmslot/recipe-cli/harness";
 import path from "node:path";
-import { EXIT, spawnScript } from "../../commands/shared.js";
 import { runnerDir } from "../../paths.js";
 function reloadMobile(target, json) {
   const script = path.join(runnerDir, "adapters/mobile/reload-app.mjs");

package/dist/adapters/mobile/run.js

@@ -1,17 +1,19 @@
+import { EXIT, isRecord } from "@farmslot/recipe-cli/harness";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
-import { isRecord } from "../../commands/parse-args.js";
+import { IOS_SIMULATOR_RECORDING_TARGET_PREFIX } from "@farmslot/adapter-rn";
 import { runnerDir } from "../../paths.js";
 import { devicePlatformFromEnv } from "../performance/device-platform.js";
 import {
-  IOS_SIMULATOR_RECORDING_TARGET_PREFIX,
   resolveAndroidDeviceSerial,
   resolveMobileIosSimulatorName
-} from "../../recording-target.js";
+} from "./recording-target.js";
+import { emitProofFailure } from "../proof-failure.js";
+import { mobileAppIdentityEnv } from "./app-identity.js";
 import { requireCurrentMobileReleaseArtifactState } from "./release-artifact-state.js";
 const EXPLICIT_DEVICE_KEYS = [
   "PLATFORM",
-  "MM_HARNESS_EXPLICIT_PLATFORM",
+  "RECIPE_RN_EXPLICIT_PLATFORM",
   "IOS_SIMULATOR",
   "SIM_UDID",
   "ADB_SERIAL",
@@ -21,7 +23,7 @@ const EXPLICIT_DEVICE_KEYS = [
 ];
 const mobileRun = {
   pinnedEnv() {
-    if (!process.env.MM_HARNESS_EXPLICIT_PLATFORM) return void 0;
+    if (!process.env.RECIPE_RN_EXPLICIT_PLATFORM) return void 0;
     return Object.fromEntries(EXPLICIT_DEVICE_KEYS.map((key) => [key, process.env[key]]));
   },
   envKeys: ["METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME", "ANDROID_PACKAGE_ID", "ADB_SERIAL", "ANDROID_SERIAL"],
@@ -49,8 +51,11 @@ const mobileRun = {
     ANDROID_TARGET_DEVICE_NAME: process.env.ANDROID_TARGET_DEVICE_NAME,
     ADB_SERIAL: process.env.ADB_SERIAL,
     ANDROID_SERIAL: process.env.ANDROID_SERIAL,
-    ANDROID_PACKAGE_ID: process.env.ANDROID_PACKAGE_ID,
-    METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME: process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME
+    ...mobileAppIdentityEnv(),
+    METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME: process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME,
+    // The platform `--platform`/`--device` pinned; the React Native bridge
+    // matches its target against it.
+    RECIPE_RN_EXPLICIT_PLATFORM: process.env.RECIPE_RN_EXPLICIT_PLATFORM
   }),
   // An installed release artifact is opaque: no harness HUD inside it.
   autoHud: () => process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME !== "1",
@@ -64,12 +69,28 @@ const mobileRun = {
   // source only matters for a development build the caller did not restart.
   runtimeCheck({ target, heal, state, json, appRestartAuthored }) {
     if (requireCurrentMobileReleaseArtifactState(target) !== null || appRestartAuthored) return void 0;
-    return async () => {
-      const { ensureMobileProofRuntime } = await import("../../commands/run-engine.js");
-      return ensureMobileProofRuntime(target, heal, state, json);
-    };
+    return () => ensureMobileProofRuntime(target, heal, state, json);
   }
 };
+async function ensureMobileProofRuntime(target, _heal, state, json, deps = {}) {
+  const source = await import("./source-freshness.js");
+  const check = deps.check ?? (() => source.mobileSourceCheck(target));
+  const initial = check();
+  if (initial.status === "unavailable") {
+    emitProofFailure(json, { recoverable: false, error: initial.error });
+    return EXIT.usage;
+  }
+  if (initial.status === "current") return null;
+  const targetArg = JSON.stringify(path.resolve(target));
+  const userAction = `mm-harness call app.lifecycle --arg command=restart --adapter mobile --target ${targetArg}`;
+  const message = `Mobile loaded source is not current (${initial.status}).`;
+  emitProofFailure(json, {
+    recoverable: true,
+    mutations: state.mutations,
+    error: { code: "MOBILE_SOURCE_NOT_LOADED", message, userAction }
+  });
+  return EXIT.infra;
+}
 const mobileRecording = {
   target: (context) => resolveMobileRecordingTarget(context),
   // An Android device records through the mirror, with screenrecord as the
@@ -78,7 +99,7 @@ const mobileRecording = {
     const androidSerial = resolveAndroidDeviceSerial();
     const iosSimulator = androidSerial ? void 0 : resolveMobileIosSimulatorName();
     if (!androidSerial && !iosSimulator) return void 0;
-    const { createAndroidVideoRecorder, createIosSimulatorVideoRecorder } = await import("./video-recorder.js");
+    const { createAndroidVideoRecorder, createIosSimulatorVideoRecorder } = await import("@farmslot/adapter-rn");
     if (androidSerial) {
       const { createAndroidMirrorVideoRecorder } = await import("@farmslot/recipe-runner");
       return createAndroidMirrorVideoRecorder({ serial: androidSerial, fallback: createAndroidVideoRecorder(androidSerial) });
@@ -126,11 +147,13 @@ const mobileDiagnostics = {
 };
 const mobileObservation = {
   network: {
-    backend: async (target, env) => (await import("../../network-observation.js")).createMobileNetworkBackend(target, env)
+    backend: async (target, env) => (await import("./network-observer.js")).createMobileNetworkBackend(target, env)
   },
   performance: {
-    backend: async (target, env) => (await import("./performance-observer.js")).createMobilePerformanceBackend(target, env),
-    platform: (env) => devicePlatformFromEnv(env)
+    start: async (context) => (await import("../../performance-observation.js")).startRunPerformanceObservation({
+      backend: async (target, env) => (await import("./performance-observer.js")).createMobilePerformanceBackend(target, env),
+      platform: (env) => devicePlatformFromEnv(env)
+    }, context)
   }
 };
 function runMobileIssueCommand(projectRoot, command) {
@@ -149,6 +172,7 @@ function runMobileIssueCommand(projectRoot, command) {
   }
 }
 export {
+  ensureMobileProofRuntime,
   mobileDiagnostics,
   mobileObservation,
   mobileRecording,

package/dist/adapters/mobile/runtime-decision.js

@@ -11,10 +11,8 @@ import {
   supersededErrorCapture
 } from "@farmslot/recipe-runner/runtime/log-analysis";
 import { probeMetroPackager } from "@farmslot/recipe-runner/runtime/metro-probe";
-import { color } from "../../cli-color.js";
-import { shellQuote } from "../../commands/parse-args.js";
-import { recipeRuntimePath } from "../../paths.js";
-import { resolveMobileToolPath } from "../../../library/actions/mobile/platform/tool-paths.mjs";
+import { color, recipeRuntimePath, shellQuote } from "@farmslot/recipe-cli/harness";
+import { resolveMobileToolPath } from "@farmslot/adapter-rn";
 import { mobileProductMarkers } from "./deps-markers.js";
 import { mobileMetroEnvCheck } from "./metro-env.js";
 const BUNDLE_ERR = /Bundling failed|Unable to resolve /u;