@deeeed/metamask-harness 0.74.0 → 0.75.0

package/dist/cli-commands.js

@@ -19,6 +19,7 @@ const SPEC = {
     { name: "ports", desc: "Slot ports and runtime paths", flags: ["--json"] },
     { name: "up", desc: "Decide + run minimum work to reach ready", flags: ["--json", "--dry-run"] },
     { name: "sync", desc: "Refresh harness + canonicalize wallet fixture", flags: ["--json"] },
+    { name: "pin", desc: "Copy this install into an immutable store for a task to run", flags: ["--json"] },
     { name: "logs", aliases: ["tail"], desc: "Compact build events or full log", flags: ["--full", "-f", "--window", "--events", "--source", "--json"] },
     { name: "debug", aliases: ["devtools", "inspect"], desc: "Open DevTools UI", flags: ["--json", "--no-open"] },
     { name: "reload", desc: "Reload the connected app runtime", flags: ["--json"] },

package/dist/command-contract.js

@@ -398,6 +398,9 @@ const PUBLIC_COMMAND_CONTRACTS = {
   update: {
     options: options(HELP, JSON, { "--check": bool() })
   },
+  pin: {
+    options: options(HELP, JSON)
+  },
   fixtures: {
     options: options(HELP, JSON, TARGET, ADAPTER, ADAPTER_OR_MOBILE_PLATFORM, DEVICE, {
       "--from": value(),

package/dist/commands/call.js

@@ -28,7 +28,6 @@ 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,
@@ -40,7 +39,6 @@ import {
   synthesizeOneNodeRecipe,
   validateRecipeAdapterAware
 } from "./run-engine.js";
-import { readMobileReleaseArtifactState } from "../adapters/mobile/release-artifact-state.js";
 import { acquireCheckoutLock } from "../checkout-lock.js";
 import { formatRunDiagnosticsForHuman, readRunDiagnosticsDocument } from "../run-diagnostics.js";
 import {
@@ -178,7 +176,7 @@ async function handleCall(argv) {
   const resolvedAction = resolution.resolved;
   const describedAction = describeManifestActions(manifest, actionSources).find((entry) => entry.name === resolvedAction);
   const defaultsUsed = actionDefaultsUsed(describedAction, args);
-  const depsBlock = adapter === "core" && resolvedAction.startsWith("metamask.perps.") ? coreDependencyBlock(target) : null;
+  const depsBlock = await getAdapterSurface(adapter).run?.dependencyBlock?.(target, { action: resolvedAction }) ?? null;
   if (depsBlock) {
     if (json) {
       console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, status: "fail", exitCode: EXIT.usage, error: depsBlock }, null, 2));
@@ -286,9 +284,8 @@ async function handleCall(argv) {
     return checkoutBusyOut(json, "call", lock.message, lock.path);
   }
   try {
-    const authoredMobileRestart = adapter === "mobile" && resolvedAction === "app.lifecycle" && args.command === "restart";
     const prepared = await prepareHeal(adapter, target, options, json, {
-      skipMobileSourceFreshness: authoredMobileRestart || adapter === "mobile" && readMobileReleaseArtifactState(target) !== null
+      appRestartAuthored: resolvedAction === "app.lifecycle" && args.command === "restart"
     });
     if (typeof prepared === "number") return prepared;
     const { state } = prepared;

package/dist/commands/launch/device.js

@@ -17,6 +17,7 @@ import {
   remoteFlagRequestFor
 } from "../../feature-flags.js";
 import { terminalOnlyLaunchFlags } from "../../adapters/terminal/launch.js";
+import { shellQuote } from "./quote.js";
 async function runDeviceLaunch(context, profile) {
   const { adapter, options, target, heal, jsonOutput, machine, stream, usage } = context;
   const terminalOnly = terminalOnlyLaunchFlags(options);
@@ -182,10 +183,6 @@ function readinessBlockFailure(result) {
     exitCode: result.status
   };
 }
-function shellQuote(value) {
-  if (/^[A-Za-z0-9_./:@%+=,-]+$/u.test(value)) return value;
-  return `'${value.replace(/'/gu, `'"'"'`)}'`;
-}
 function nativeInputsChanged(target, paths) {
   const baselineFile = recipeRuntimePath(target, ".last-build-ref");
   let baseline;
@@ -341,6 +338,5 @@ ${failure.originalError}` : "") + `
   return failure.exitCode;
 }
 export {
-  runDeviceLaunch,
-  shellQuote
+  runDeviceLaunch
 };

package/dist/commands/launch/extension.js

@@ -12,8 +12,7 @@ import {
   importRecipeHarnessRuntimeCdp,
   recipeHarnessPath,
   recipeRuntimeDir,
-  runnerDir,
-  walletFixturePath
+  runnerDir
 } from "../../paths.js";
 import { extensionIdFromKey } from "../../adapters/extension/extension-id.js";
 import {
@@ -30,16 +29,9 @@ import {
 import { checkExtensionRuntimeHealth } from "../../adapters/extension/runtime.js";
 import { ensureHarnessFresh } from "../../adapters/harness-freshness.js";
 import { isExtensionWatcherLive, stopExtensionWatcher } from "../../adapters/slot-ports.js";
-import { EXIT, spawnScript, spawnScriptStreaming } from "../shared.js";
+import { EXIT, spawnScriptStreaming } from "../shared.js";
 import { readExtensionPinnedFlags } from "../../adapters/extension/feature-flags.js";
-import { ensureExtensionConsoleCapture } from "../../adapters/extension/console-capture.js";
-import {
-  fixtureFeatureFlags,
-  sameFeatureFlags,
-  toRemoteFlagSpec
-} from "../../feature-flags.js";
-import { RECOVERY_CODE } from "../../heal-bounds.js";
-import { shellQuote } from "./device.js";
+import { sameFeatureFlags } from "../../feature-flags.js";
 const { CdpSession } = await importRecipeHarnessRuntimeCdp();
 const { RUNTIME_IDENTITY_FILENAME, RUNTIME_NONCE_PREFIX } = createRequire(import.meta.url)(
   path.join(runnerDir, "adapters/extension/lib/chrome-args.cjs")
@@ -487,301 +479,9 @@ async function extensionRebuild(target, remoteFlags) {
   }
   return result;
 }
-const DEFAULT_EXTENSION_DAPP_URL = "https://metamask.github.io/test-dapp/";
-function verifyExtensionPin(target, requested) {
-  const pinned = readExtensionPinnedFlags(target);
-  if (pinned.error) {
-    return {
-      ok: false,
-      flags: {},
-      code: "RUNTIME_MANIFEST_UNREADABLE",
-      message: `the launched dist snapshot manifest could not be read (${pinned.sourcePath ?? "unknown path"}): ${pinned.error}`
-    };
-  }
-  if (pinned.overrides !== null && pinned.pinned === null) {
-    return {
-      ok: false,
-      flags: {},
-      code: "REMOTE_FLAG_NOT_APPLIED",
-      message: `the launched dist snapshot manifest (${pinned.sourcePath ?? "unknown path"}) carries no harness pin record; it was not written by this launch.`
-    };
-  }
-  const actual = pinned.pinned ?? {};
-  if (!sameFeatureFlags(actual, requested)) {
-    const mismatched = [.../* @__PURE__ */ new Set([...Object.keys(requested), ...Object.keys(actual)])].filter(
-      (key) => JSON.stringify(actual[key]) !== JSON.stringify(requested[key])
-    );
-    return {
-      ok: false,
-      flags: {},
-      code: "REMOTE_FLAG_NOT_APPLIED",
-      message: `the remote feature-flag pin ${toRemoteFlagSpec(requested) || "(none)"} does not match the launched snapshot manifest: ` + mismatched.map((key) => `${key} expected ${JSON.stringify(requested[key])}, got ${JSON.stringify(actual[key])}`).join("; ")
-    };
-  }
-  return { ok: true, flags: actual, message: "" };
-}
-function extensionQuickReattachFailed(output) {
-  return /\[reattach\]|extension quick reattach|mm-harness launch --build/u.test(output);
-}
-function extensionRuntimeBlocked(output) {
-  return /ERR_BLOCKED_BY_CLIENT|has been blocked by Chromium/u.test(output);
-}
-function extensionBrowserMissing(output) {
-  return /Playwright Chromium is not installed|No compatible Chromium binary selected/u.test(output);
-}
-function extensionProductConfigMissing(output) {
-  return /EXTENSION_PRODUCT_CONFIG_REQUIRED:/u.test(output);
-}
-function extensionEvmRpcUnreachable(output) {
-  return /EVM_RPC_UNREACHABLE|EVM RPC readiness probe failed|Infura configured ≠ RPC reachable/u.test(output);
-}
-const extensionLaunchProfile = {
-  refuseFlags({ target }, { watch, runway, clearMetro, remoteFlagSpec }) {
-    if (runway) return { message: "runway is mobile-only.", userAction: "drop --runway for the extension" };
-    if (clearMetro) return { message: "--clear-metro is mobile-only.", userAction: "drop --clear-metro for the extension" };
-    if (remoteFlagSpec !== void 0 && watch) {
-      return {
-        message: "--remote-flag cannot be applied with --watch: the watcher never re-creates the dist snapshot that carries the pin.",
-        userAction: `mm-harness launch --adapter extension --remote-flag ${remoteFlagSpec} --target ${shellQuote(target)}`
-      };
-    }
-    return void 0;
-  },
-  // --url: initial main-tab page for extension launches (dapp beside the
-  // sidepanel); travels to live.sh/launch-browser via env. Sidepanel mode has a
-  // useful default so `mm-harness launch --sidepanel` opens a working dapp, not
-  // just a wallet panel with no page to connect from.
-  start({ options, displayMode, machine, wantWatch, tier }) {
-    const requestedUrl = typeof options["url"] === "string" && options["url"] ? options["url"] : "";
-    if (requestedUrl || displayMode === "sidepanel") {
-      process.env.EXTENSION_START_URL = requestedUrl || DEFAULT_EXTENSION_DAPP_URL;
-    }
-    if (machine) return;
-    const modeNote = displayMode === "sidepanel" ? `sidepanel \xB7 dapp ${process.env.EXTENSION_START_URL ?? DEFAULT_EXTENSION_DAPP_URL}` : "fullscreen";
-    const workNote = wantWatch ? "watch only" : tier === "build" ? "clean build" : "quick reuse probe";
-    console.error(colorHumanMessage(
-      `\u2192 extension launch \u2014 ${modeNote} \xB7 CDP :${process.env.CDP_PORT ?? "default"} \xB7 ${workNote}`
-    ));
-  },
-  nativeInputs: ["package.json", "yarn.lock", "webpack.config.js"],
-  rebuildCommand: () => "mm-harness launch --build",
-  // Source-development launch paths require checkout tooling. A verified local
-  // release artifact can reuse its healthy browser without building or watching.
-  async healthcheck(launch, state) {
-    const { target, tier, wantWatch, heal, stream } = launch;
-    const artifact = releaseArtifactState(target);
-    const reusable = !wantWatch && tier !== "build" && await extensionRuntimeReusable(target, artifact);
-    const verifiedReleaseReuse = artifact.status === "valid" && reusable;
-    const verifiedReleaseLaunch = !wantWatch && tier !== "build" && artifact.status === "valid" && runtimeDistCheck(target, artifact).status === "fresh";
-    const willBuild = !reusable;
-    if (willBuild) {
-      const productConfigBlock = extensionProductConfigBlock(target);
-      if (productConfigBlock) {
-        return launch.fail(state, {
-          code: "EXTENSION_PRODUCT_CONFIG_REQUIRED",
-          message: productConfigBlock.message,
-          recoverable: false,
-          userAction: productConfigBlock.userAction,
-          exitCode: EXIT.infra
-        });
-      }
-    }
-    const depsBlock = verifiedReleaseReuse || verifiedReleaseLaunch ? null : extensionDepsBlock(target);
-    if (depsBlock) {
-      if (heal === "off") return launch.usage(depsBlock.message, depsBlock.userAction);
-      const recoveryCode = "deps.installed";
-      state.attemptedRecoveries.push(recoveryCode);
-      stream.phase("recover");
-      const repaired = await installExtensionDeps(target);
-      if (repaired.status !== 0 || extensionDepsBlock(target)) {
-        return launch.fail(state, {
-          code: "DEPENDENCY_INSTALL_FAILED",
-          message: depsBlock.message,
-          recoverable: false,
-          userAction: "install the checkout-pinned Node version, then re-run mm-harness launch",
-          originalError: repaired.output,
-          exitCode: EXIT.infra
-        });
-      }
-      state.recovered.push(recoveryCode);
-      state.mutations.push({ type: "dependencies", action: "installed", path: target });
-    }
-    return void 0;
-  },
-  compose: ({ target, wantWatch, displayMode, remoteFlagRequest }, tier) => launchExtension(target, tier, wantWatch, displayMode, remoteFlagRequest),
-  classify({ target, remoteFlagRequest }, output) {
-    if (output.includes("REMOTE_FLAG_NOT_PINNABLE:")) {
-      return {
-        code: "REMOTE_FLAG_NOT_PINNABLE",
-        message: `a verified release artifact cannot carry a remote feature-flag pin (${remoteFlagRequest?.spec ?? ""}); its manifest is signed evidence and is never rewritten. Validate the artifact as shipped (drop --remote-flag and the fixture's remoteFeatureFlags) or validate the variant on a source build.`,
-        recoverable: false,
-        // The next step must leave the artifact alone: a --build here would replace
-        // the artifact under validation with a source build.
-        userAction: Object.keys(fixtureFeatureFlags(walletFixturePath(target))).length > 0 ? `remove remoteFeatureFlags from ${shellQuote(walletFixturePath(target))}, then: mm-harness launch --adapter extension --target ${shellQuote(target)}` : `mm-harness launch --adapter extension --target ${shellQuote(target)}`,
-        exitCode: EXIT.infra,
-        originalError: output.trim() || void 0
-      };
-    }
-    if (extensionProductConfigMissing(output)) {
-      const block = extensionProductConfigBlock(target);
-      return {
-        code: "EXTENSION_PRODUCT_CONFIG_REQUIRED",
-        message: block?.message ?? "Extension product configuration was not ready when the build started.",
-        recoverable: false,
-        userAction: block?.userAction ?? `mm-harness launch --adapter extension --target ${shellQuote(target)}`,
-        exitCode: EXIT.infra
-      };
-    }
-    if (extensionBrowserMissing(output)) {
-      return {
-        code: "EXTENSION_BROWSER_REQUIRED",
-        message: "the checkout Playwright browser is not installed; system Chrome is not a compatible unpacked-extension fallback. Installing the browser cache requires user approval.",
-        recoverable: false,
-        userAction: `ask the user for approval, then run: cd ${shellQuote(target)} && yarn playwright install chromium`,
-        exitCode: EXIT.infra
-      };
-    }
-    if (output.includes("EXTENSION_BACKGROUND_UNRESPONSIVE:") || output.includes("EXTENSION_STARTUP_UNVERIFIED:")) {
-      return {
-        code: output.includes("EXTENSION_BACKGROUND_UNRESPONSIVE:") ? "EXTENSION_BACKGROUND_UNRESPONSIVE" : "EXTENSION_STARTUP_UNVERIFIED",
-        message: "Extension startup is not healthy; inspect the background error before restarting or resetting wallet state.",
-        recoverable: false,
-        userAction: `mm-harness logs --target ${shellQuote(target)} --full`,
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      };
-    }
-    if (output.includes("EVM_RPC_EXECUTION_FAILED:")) {
-      return {
-        code: "EVM_RPC_EXECUTION_FAILED",
-        message: "Background RPC fetch failed during JavaScript execution; this does not establish an Infura authentication or connectivity failure.",
-        recoverable: false,
-        userAction: `mm-harness logs --target ${shellQuote(target)} --full`,
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      };
-    }
-    if (extensionEvmRpcUnreachable(output)) {
-      return {
-        code: "EVM_RPC_UNREACHABLE",
-        message: "EVM RPC readiness failed; Infura configured does not mean RPC reachable.",
-        recoverable: false,
-        userAction: `Check the effective INFURA_PROJECT_ID from the environment, .metamaskprodrc, or ${shellQuote(path.join(target, ".metamaskrc"))}, then rerun: mm-harness launch --verify --target ${shellQuote(target)}`,
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      };
-    }
-    return void 0;
-  },
-  async beforeHeal(launch, attempt, state) {
-    if (launch.tier !== "quick" || !extensionQuickReattachFailed(attempt.output)) return void 0;
-    const recoveryCode = "chrome.relaunched";
-    state.attemptedRecoveries.push(recoveryCode);
-    launch.stream.phase("recover");
-    const rebuildAttempt = await launch.compose("build");
-    if (rebuildAttempt.status === 0) {
-      state.recovered.push(recoveryCode);
-      return await launch.settle(state, rebuildAttempt.remoteFeatureFlags);
-    }
-    return launch.fail(state, {
-      code: "EXTENSION_RELAUNCH_FAILED",
-      message: "quick reattach failed, and clean relaunch failed too.",
-      recoverable: false,
-      exitCode: EXIT.infra,
-      originalError: rebuildAttempt.output.trim() || void 0
-    });
-  },
-  recovery: () => ({ code: RECOVERY_CODE.extension, restartApp: false }),
-  // --watch only restarts the webpack watcher; the snapshot, and its pin, are
-  // untouched, so the live record is reported rather than verified against a
-  // request the watcher could never apply (--remote-flag is refused with it;
-  // the fixture baseline stays whatever the last launch pinned).
-  provenFlags({ target, wantWatch, remoteFlagRequest }, requested) {
-    if (wantWatch) return { flags: readExtensionPinnedFlags(target).pinned };
-    const pinned = verifyExtensionPin(target, requested);
-    if (pinned.ok) return { flags: pinned.flags };
-    const spec = remoteFlagRequest?.spec;
-    return {
-      code: pinned.code ?? "REMOTE_FLAG_NOT_APPLIED",
-      message: pinned.message,
-      recoverable: false,
-      // A rebuild re-creates the snapshot; the flag is repeated only when one was asked for.
-      userAction: `mm-harness launch --adapter extension --build${spec ? ` --remote-flag ${spec}` : ""} --target ${shellQuote(target)}`,
-      exitCode: EXIT.runtime
-    };
-  },
-  async finish(launch, state, sidepanelRecoveryAllowed) {
-    const { target, machine, displayMode, tier, stream } = launch;
-    const sidepanelSh = path.join(runnerDir, "adapters/extension/sidepanel-toggle.sh");
-    if (displayMode === "fullscreen") {
-      const sidepanelArgs = ["close"];
-      if (process.env.CDP_PORT) sidepanelArgs.push("--cdp-port", process.env.CDP_PORT);
-      const fullscreen = spawnScript(sidepanelSh, sidepanelArgs, target, machine, { REPO: target });
-      if (fullscreen.status !== 0) {
-        return launch.fail(state, {
-          code: "FULLSCREEN_OPEN_FAILED",
-          message: "app launched but restoring the fullscreen Extension surface failed.",
-          recoverable: false,
-          userAction: `bash adapters/extension/sidepanel-toggle.sh close --cdp-port ${process.env.CDP_PORT ?? "<CDP_PORT>"}`,
-          exitCode: EXIT.runtime,
-          originalError: fullscreen.output.trim() || void 0
-        });
-      }
-    }
-    if (displayMode === "sidepanel") {
-      const sidepanelArgs = ["open"];
-      if (process.env.CDP_PORT) sidepanelArgs.push("--cdp-port", process.env.CDP_PORT);
-      if (!machine) {
-        console.error(
-          `[sidepanel] opening panel beside ${process.env.EXTENSION_START_URL ?? DEFAULT_EXTENSION_DAPP_URL}`
-        );
-      }
-      const sidepanel = spawnScript(sidepanelSh, sidepanelArgs, target, machine, { REPO: target });
-      if (sidepanel.status !== 0) {
-        const recoveryCode = "chrome.relaunched";
-        if (sidepanelRecoveryAllowed && tier === "quick" && extensionRuntimeBlocked(sidepanel.output) && !state.attemptedRecoveries.includes(recoveryCode)) {
-          state.attemptedRecoveries.push(recoveryCode);
-          stream.phase("recover");
-          const rebuildAttempt = await launch.compose("build");
-          if (rebuildAttempt.status === 0) {
-            state.recovered.push(recoveryCode);
-            return await launch.settle(state, void 0, false);
-          }
-          return launch.fail(state, {
-            code: "EXTENSION_RELAUNCH_FAILED",
-            message: "sidepanel open found a blocked extension runtime, and clean relaunch failed too.",
-            recoverable: false,
-            exitCode: EXIT.infra,
-            originalError: rebuildAttempt.output.trim() || void 0
-          });
-        }
-        return launch.fail(state, {
-          code: "SIDEPANEL_OPEN_FAILED",
-          message: "app launched but opening the side panel failed.",
-          recoverable: false,
-          userAction: `bash adapters/extension/sidepanel-toggle.sh open --cdp-port ${process.env.CDP_PORT ?? "<CDP_PORT>"}`,
-          exitCode: EXIT.runtime,
-          originalError: sidepanel.output.trim() || void 0
-        });
-      }
-    }
-    try {
-      await ensureExtensionConsoleCapture(target);
-    } catch (error) {
-      if (!machine) {
-        console.error(`WARN: Extension console capture unavailable: ${error instanceof Error ? error.message : String(error)}`);
-      }
-    }
-    return void 0;
-  },
-  verifyArgs: () => process.env.CDP_PORT ? ["--cdp-port", process.env.CDP_PORT] : [],
-  platformLabel: ({ mobileTarget, displayMode }) => mobileTarget ?? displayMode,
-  deviceLabel: ({ displayMode }) => displayMode
-};
 export {
   extensionDepsBlock,
   extensionLaunchDevelopment,
-  extensionLaunchProfile,
   extensionReattach,
   extensionRebuild,
   extensionRuntimeReusable,

package/dist/commands/launch/index.js

@@ -14,7 +14,7 @@ import {
 import { parseHeal } from "../../heal-bounds.js";
 import { acquireCheckoutLock } from "../../checkout-lock.js";
 import { JsonStreamWriter } from "../../json-stream.js";
-import { shellQuote } from "./device.js";
+import { shellQuote } from "./quote.js";
 const LAUNCH_BOOLEANS = /* @__PURE__ */ new Set([
   "build",
   "watch",

package/dist/commands/launch/mobile.js

@@ -1,4 +1,3 @@
-import fs from "node:fs";
 import { prepareMobile } from "../../adapters/mobile/prepare.js";
 import {
   mobileSourceCheck,
@@ -8,11 +7,7 @@ import { ensureHarnessFresh } from "../../adapters/harness-freshness.js";
 import { pinMobileFeatureFlags } from "../../adapters/mobile/feature-flags.js";
 import { toRemoteFlagSpec } from "../../feature-flags.js";
 import { clearMobileReleaseArtifactState } from "../../adapters/mobile/release-artifact-state.js";
-import { EXIT, str, writeInteractiveProgress } from "../shared.js";
-import { applyDeviceTargeting } from "../device-target.js";
-import { RECOVERY_CODE } from "../../heal-bounds.js";
-import { recipeRuntimePath } from "../../paths.js";
-import { shellQuote } from "./device.js";
+import { EXIT } from "../shared.js";
 async function launchMobile(target, mobileTarget, tier, json, restartApp = false, clearMetro = false, remoteFlags) {
   clearMobileReleaseArtifactState(target);
   await ensureHarnessFresh(target, "mobile");
@@ -59,189 +54,6 @@ async function launchMobile(target, mobileTarget, tier, json, restartApp = false
   }
   return { ...result, remoteFeatureFlags: provenFlags };
 }
-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);
-}
-function missingConfiguredIosSimulator(output) {
-  return /open-device: configured iOS simulator '([^']+)' does not exist/u.exec(output)?.[1];
-}
-function ambiguousConfiguredIosSimulator(output) {
-  return /open-device: iOS simulator target ("[^"]+") is ambiguous/u.exec(output)?.[1];
-}
-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";
-  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));
-  return parts.join(" ");
-}
-function isIosSimulatorUdid(value) {
-  return /^[0-9A-Fa-f-]{36}$/u.test(value);
-}
-function launchDeviceLabel(mobileTarget) {
-  if (mobileTarget === "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") {
-    return process.env.IOS_SIMULATOR || process.env.SIM_UDID || "iOS simulator";
-  }
-  return process.env.IOS_SIMULATOR || process.env.ADB_SERIAL || "booted device";
-}
-function metroLaunchEvidence(target) {
-  const evidencePath = recipeRuntimePath(target, "metro-generation.json");
-  let descriptor;
-  try {
-    descriptor = fs.openSync(evidencePath, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
-    const stat = fs.fstatSync(descriptor);
-    if (!stat.isFile() || stat.size > 256 * 1024) return void 0;
-    return JSON.parse(fs.readFileSync(descriptor, "utf8"));
-  } catch {
-    return void 0;
-  } finally {
-    if (descriptor !== void 0) fs.closeSync(descriptor);
-  }
-}
-const mobileLaunchProfile = {
-  refuseFlags({ mobileTarget }) {
-    if (!mobileTarget) {
-      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 }) {
-    const device = str(options, "device");
-    if (!device && mobileTarget !== "ios" && mobileTarget !== "android") return void 0;
-    const targetingOptions = {
-      ...options,
-      ...mobileTarget ? { platform: mobileTarget } : {}
-    };
-    const result = applyDeviceTargeting("launch", adapter, targetingOptions, { gate: false, rerun: "" });
-    if ("code" in result) {
-      if (mobileTarget === "ios" && result.code === "DEVICE_NOT_FOUND") {
-        process.env.IOS_SIMULATOR = device;
-        process.env.SIM_UDID = isIosSimulatorUdid(device) ? device : "";
-        process.env.ADB_SERIAL = "";
-        process.env.ANDROID_SERIAL = "";
-        process.env.ANDROID_DEVICE = "";
-        process.env.ANDROID_TARGET_DEVICE_NAME = "";
-      } else {
-        return result;
-      }
-    }
-    if (mobileTarget === "android" && device && !process.env.ADB_SERIAL && !process.env.ANDROID_SERIAL) {
-      return {
-        ok: false,
-        code: "DEVICE_WRONG_PLATFORM",
-        message: `--device ${device} did not resolve to an Android device for launch android.`,
-        userAction: `mm-harness status --target ${shellQuote(target)} --all-devices --json`
-      };
-    }
-    if (mobileTarget === "ios" && device && !process.env.IOS_SIMULATOR) {
-      return {
-        ok: false,
-        code: "DEVICE_WRONG_PLATFORM",
-        message: `--device ${device} did not resolve to an iOS simulator for launch ios.`,
-        userAction: `mm-harness status --target ${shellQuote(target)} --all-devices --json`
-      };
-    }
-    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";
-    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" : ""}`
-    );
-  },
-  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),
-  classify(_launch, output) {
-    if (output.includes("open-device: Android device is locked.")) {
-      return {
-        code: "MOBILE_DEVICE_LOCKED",
-        message: "the selected Android device is locked.",
-        recoverable: false,
-        userAction: "Unlock the selected Android device, then retry the launch.",
-        exitCode: EXIT.runtime,
-        originalError: output.trim()
-      };
-    }
-    if (/open-device: Android (?:lock state unavailable|display preparation failed)\./u.test(output)) {
-      return {
-        code: "MOBILE_DEVICE_UI_UNAVAILABLE",
-        message: "the selected Android display could not be prepared.",
-        recoverable: false,
-        userAction: "Check adb access and the selected device screen, then retry the launch.",
-        exitCode: EXIT.runtime,
-        originalError: output.trim()
-      };
-    }
-    return void 0;
-  },
-  async beforeHeal(launch, attempt, state) {
-    const { target, mobileTarget, tier } = launch;
-    const output = attempt.output;
-    const missingIosSimulator = missingConfiguredIosSimulator(output);
-    const ambiguousIosSimulator = ambiguousConfiguredIosSimulator(output);
-    if (ambiguousIosSimulator) {
-      return launch.fail(state, {
-        code: "MOBILE_DEVICE_AMBIGUOUS",
-        message: `more than one iOS simulator matches ${ambiguousIosSimulator}.`,
-        recoverable: false,
-        userAction: `mm-harness status --adapter mobile --target ${shellQuote(target)} --all-devices --json`,
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      });
-    }
-    if (missingIosSimulator && isIosSimulatorUdid(missingIosSimulator)) {
-      return launch.fail(state, {
-        code: "MOBILE_DEVICE_NOT_FOUND",
-        message: `the configured iOS simulator ${missingIosSimulator} no longer exists.`,
-        recoverable: false,
-        userAction: `mm-harness status --adapter mobile --target ${shellQuote(target)} --all-devices --json`,
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      });
-    }
-    if (mobileProvisioningBlocked(output)) {
-      return launch.fail(state, {
-        code: "MOBILE_PROVISION_REQUIRED",
-        message: `mobile ${mobileTarget ?? "runtime"} is not provisioned for this slot.`,
-        recoverable: false,
-        userAction: mobileProvisionCommand(target, mobileTarget),
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      });
-    }
-    if (tier === "build" && /open-device: (?:Android|iOS) native build failed/u.test(output)) {
-      return launch.fail(state, {
-        code: "MOBILE_NATIVE_BUILD_FAILED",
-        message: "the selected Mobile native build failed; refusing to repeat the expensive build as a Metro recovery.",
-        recoverable: false,
-        exitCode: EXIT.runtime,
-        originalError: output.trim() || void 0
-      });
-    }
-    return void 0;
-  },
-  recovery(_launch, output) {
-    const restartApp = mobileBridgeTargetMissing(output);
-    return { code: restartApp ? "mobile.app-restarted" : RECOVERY_CODE.mobile, 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),
-  evidence: metroLaunchEvidence
-};
 export {
-  launchMobile,
-  mobileLaunchProfile
+  launchMobile
 };

package/dist/commands/launch/quote.js

@@ -0,0 +1,7 @@
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:@%+=,-]+$/u.test(value)) return value;
+  return `'${value.replace(/'/gu, `'"'"'`)}'`;
+}
+export {
+  shellQuote
+};