@deeeed/metamask-harness 0.74.0 → 0.76.0

package/dist/commands/fixtures.js

@@ -5,15 +5,11 @@ import { runnerDir, walletFixturePath } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { fixtureFileSummary, fixtureSummary } from "../doctor.js";
 import { acquireCheckoutLock } from "../checkout-lock.js";
-import { colorHumanMessage } from "../cli-color.js";
 import { applyDeviceTargeting } from "./device-target.js";
 import { ADAPTER_DETECT_NEXT, checkoutBusyOut, EXIT, flag, parseFlags, resolveAdapter, scriptOverride, spawnScript, spawnScriptStreaming, str, targetOf, usageOut } from "./shared.js";
-import { FeatureFlagSpecError, fixtureFeatureFlags, parseRemoteFlagSpec, sameFeatureFlags } from "../feature-flags.js";
-import { readExtensionPinnedFlags } from "../adapters/extension/feature-flags.js";
+import { FeatureFlagSpecError, fixtureFeatureFlags, parseRemoteFlagSpec } from "../feature-flags.js";
 const FIXTURES_BOOLEANS = /* @__PURE__ */ new Set(["dev", "force", "json"]);
 const FIXTURE_STREAM_TIMEOUT_MS = 12e4;
-const FIXTURE_BRIDGE_READY_TIMEOUT_MS = 18e4;
-const MOBILE_SETUP_WALLET_TIMEOUT_MS = 36e4;
 async function handleFixtures(argv) {
   const { positional, options } = parseFlags(argv, FIXTURES_BOOLEANS);
   if (!positional[0]) return fixturesStatus(options);
@@ -52,7 +48,7 @@ function fixturesStatus(options) {
   const fixture = { ...summary, path: canonical };
   const ready = summary.status === "ready";
   const nextCommand = ready ? "mm-harness fixtures set" : "mm-harness fixtures init --from <path>   # or: mm-harness fixtures init --dev";
-  const operations = adapter === "extension" ? ["init", "sync", "set", "reset", "generate", "finalize"] : adapter === "mobile" ? ["init", "sync", "set", "reset"] : ["init", "sync", "set"];
+  const operations = [...getAdapterSurface(adapter).fixtures.operations];
   if (json) {
     console.log(JSON.stringify({
       schemaVersion: 1,
@@ -191,217 +187,16 @@ async function handleFixturesLocked(argv) {
     if (!(error instanceof FeatureFlagSpecError)) throw error;
     return usageOut(json, "fixtures", error.message, error.userAction);
   }
-  const fixtureFlagsJson = JSON.stringify(fixtureFlags);
-  if (adapter === "extension") {
-    return applyExtensionFixture(target, fixturePath, canonicalFixture, json, sub, fixtureFlags);
-  }
-  const reset = sub === "reset";
-  process.stderr.write(`\u2192 fixtures ${sub} ${adapter} \u2014 ${reset ? "resetting selected app data, relaunching, then applying" : "connecting bridge + applying"} wallet fixture (can take ~30s)\u2026
-`);
-  let status;
-  let mobileSetupResult;
-  let resetError;
-  if (adapter === "mobile") {
-    const setupWalletSh = path.join(runnerDir, "adapters/mobile/bridge-runtime/setup-wallet.sh");
-    const previousAppRoot = process.env.APP_ROOT;
-    process.env.APP_ROOT = target;
-    try {
-      if (reset) {
-        const platform = process.env.PLATFORM === "android" || process.env.ADB_SERIAL || process.env.ANDROID_SERIAL ? "android" : "ios";
-        const port = process.env.WATCHER_PORT ?? process.env.METRO_PORT ?? "8081";
-        const resetAppData = path.join(runnerDir, "adapters/mobile/reset-app-data.sh");
-        const resetArgs = ["--platform", platform, "--target", target];
-        if (platform === "ios") {
-          resetArgs.push("--simulator", process.env.SIM_UDID || process.env.IOS_SIMULATOR || "booted");
-        } else if (process.env.ADB_SERIAL || process.env.ANDROID_SERIAL) {
-          resetArgs.push("--adb-serial", process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || "");
-        }
-        const resetResult = await spawnScriptStreaming(resetAppData, resetArgs, target, {
-          timeoutMs: FIXTURE_STREAM_TIMEOUT_MS
-        });
-        if (resetResult.status !== 0) {
-          resetError = new Error("Mobile app data reset failed.");
-        } else {
-          const prewarmBundle = path.join(runnerDir, "adapters/mobile/prewarm-bundle.sh");
-          const prewarmResult = await spawnScriptStreaming(
-            prewarmBundle,
-            ["--platform", platform, "--target", target, "--port", port],
-            target,
-            {
-              timeoutMs: FIXTURE_STREAM_TIMEOUT_MS
-            }
-          );
-          if (prewarmResult.status !== 0) {
-            resetError = new Error("Mobile bundle prewarm failed after app data reset.");
-          }
-        }
-        if (!resetError) {
-          const openDevice = path.join(runnerDir, "adapters/mobile/open-device.sh");
-          const openArgs = ["--platform", platform, "--target", target, "--port", port, "--preflight-mode", "fast", "--restart"];
-          if (platform === "ios") {
-            openArgs.push("--simulator", process.env.SIM_UDID || process.env.IOS_SIMULATOR || "booted");
-          } else if (process.env.ADB_SERIAL || process.env.ANDROID_SERIAL) {
-            openArgs.push("--adb-serial", process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || "");
-          }
-          const openResult = await spawnScriptStreaming(openDevice, openArgs, target, {
-            timeoutMs: FIXTURE_STREAM_TIMEOUT_MS
-          });
-          if (openResult.status !== 0) {
-            resetError = new Error("Mobile app relaunch after data reset failed.");
-          } else {
-            const waitForBridge = path.join(runnerDir, "adapters/mobile/wait-for-bridge.sh");
-            const waitResult = await spawnScriptStreaming(
-              waitForBridge,
-              ["--target", target, "--port", port, "--platform", platform, "--timeout-ms", String(FIXTURE_BRIDGE_READY_TIMEOUT_MS)],
-              target,
-              { timeoutMs: FIXTURE_BRIDGE_READY_TIMEOUT_MS + 1e4 }
-            );
-            if (waitResult.status !== 0) {
-              resetError = new Error("Mobile bridge did not return after app data reset.");
-            }
-          }
-        }
-      }
-      const configuredTimeout = Number(process.env.MM_HARNESS_FIXTURES_SET_TIMEOUT_MS ?? MOBILE_SETUP_WALLET_TIMEOUT_MS);
-      const timeoutMs = Number.isFinite(configuredTimeout) && configuredTimeout > 0 ? configuredTimeout : MOBILE_SETUP_WALLET_TIMEOUT_MS;
-      if (!resetError) {
-        mobileSetupResult = await spawnScriptStreaming(
-          setupWalletSh,
-          ["--fixture", fixturePath, "--remote-flags-json", fixtureFlagsJson],
-          target,
-          {
-            env: {
-              APP_ROOT: target,
-              WATCHER_PORT: process.env.WATCHER_PORT ?? "8081",
-              METRO_PORT: process.env.METRO_PORT ?? process.env.WATCHER_PORT ?? "8081"
-            },
-            timeoutMs
-          }
-        );
-      }
-      status = !resetError && mobileSetupResult?.status === 0 ? "pass" : "fail";
-    } finally {
-      if (previousAppRoot === void 0) delete process.env.APP_ROOT;
-      else process.env.APP_ROOT = previousAppRoot;
-    }
-    if (!json && status === "fail") {
-      console.error(`  Next: ${retryHint}`);
-    }
-  }
-  const teaching = status === "pass" ? `Wallet fixture applied.  Want different accounts? Edit: ${canonicalFixture}` : "Wallet fixture was not applied.";
-  if (json) {
-    console.log(
-      JSON.stringify(
-        {
-          schemaVersion: 1,
-          command: "fixtures",
-          action: sub,
-          adapter,
-          fixture: fixturePath,
-          canonicalFixture,
-          status,
-          exitCode: status === "pass" ? EXIT.ok : EXIT.runtime,
-          walletReset: reset && status === "pass",
-          message: teaching,
-          error: status === "fail" ? {
-            code: resetError ? "MOBILE_WALLET_RESET_FAILED" : mobileSetupResult?.timedOut ? "SETUP_WALLET_TIMEOUT" : "SETUP_WALLET_FAILED",
-            message: resetError ? `wallet reset failed: ${resetError instanceof Error ? resetError.message : String(resetError)}` : mobileSetupResult?.timedOut ? `wallet fixture setup exceeded its ${String(mobileSetupResult.timeoutMs)}ms bound on Metro port ${process.env.WATCHER_PORT ?? "8081"}` : `wallet fixture setup failed on ${process.env.WATCHER_PORT ?? "8081"}`,
-            userAction: retryHint
-          } : null
-        },
-        null,
-        2
-      )
+  const apply = surface.fixtures.apply;
+  if (!apply) {
+    return usageOut(
+      json,
+      "fixtures",
+      `fixtures ${sub} has no wallet to apply on ${adapter}.`,
+      surface.hints.launch
     );
-  } else if (status === "pass") {
-    console.error(teaching);
-  }
-  return status === "pass" ? EXIT.ok : EXIT.runtime;
-}
-async function applyExtensionFixture(target, fixturePath, canonicalFixture, json, action, fixtureFlags) {
-  const distManifest = path.join(target, "dist/chrome/manifest.json");
-  const userAction = `mm-harness launch --build --verify --target ${JSON.stringify(target)}`;
-  if (!fs.existsSync(distManifest)) {
-    const message2 = `Extension fixture needs an existing dist/chrome build; no manifest was found at ${distManifest}.`;
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "fixtures",
-        action,
-        adapter: "extension",
-        fixture: fixturePath,
-        canonicalFixture,
-        status: "fail",
-        exitCode: EXIT.runtime,
-        error: { code: "EXTENSION_FIXTURE_BUILD_REQUIRED", message: message2, userAction }
-      }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness fixtures ${action}: ${message2}
-  Next: ${userAction}`);
-    }
-    return EXIT.runtime;
   }
-  process.stderr.write(`${colorHumanMessage(`\u2192 fixtures ${action} extension \u2014 resetting and seeding the slot-owned profile from the existing build\u2026`)}
-`);
-  const liveScript = path.join(runnerDir, "adapters/extension/live.sh");
-  const args = ["--target", target, "--launch-existing-dist", "--launch-only", "--reset-profile"];
-  const flagKeys = Object.keys(fixtureFlags);
-  if (flagKeys.length > 0) args.push("--remote-flags-json", JSON.stringify(fixtureFlags));
-  if (process.env.CDP_PORT) args.push("--cdp-port", process.env.CDP_PORT);
-  const result = await spawnScriptStreaming(liveScript, args, target, {
-    env: { RECIPE_WALLET_FIXTURE: fixturePath },
-    timeoutMs: FIXTURE_STREAM_TIMEOUT_MS
-  });
-  const pinned = readExtensionPinnedFlags(target);
-  const pinnedFlags = pinned.pinned ?? {};
-  const flagMismatch = result.status === 0 && !pinned.error && (pinned.pinned === null || !sameFeatureFlags(pinnedFlags, fixtureFlags)) ? [.../* @__PURE__ */ new Set([...flagKeys, ...Object.keys(pinnedFlags)])].filter(
-    (key) => JSON.stringify(pinnedFlags[key]) !== JSON.stringify(fixtureFlags[key])
-  ) : [];
-  if (result.status === 0 && (pinned.error || flagMismatch.length > 0)) {
-    const detail = pinned.error ? `the launched snapshot manifest could not be read (${pinned.sourcePath ?? "unknown path"}): ${pinned.error}` : `snapshot pin disagrees with the fixture for: ${flagMismatch.join(", ")}`;
-    const flagNext = `mm-harness launch --adapter extension --build --target ${JSON.stringify(target)}`;
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "fixtures",
-        action,
-        adapter: "extension",
-        fixture: fixturePath,
-        canonicalFixture,
-        status: "fail",
-        exitCode: EXIT.runtime,
-        error: { code: "EXTENSION_FIXTURE_FLAGS_NOT_APPLIED", message: detail, userAction: flagNext }
-      }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness fixtures ${action}: ${detail}
-  Next: ${flagNext}`);
-    }
-    return EXIT.runtime;
-  }
-  const status = result.status === 0 ? "pass" : "fail";
-  const exitCode = status === "pass" ? EXIT.ok : EXIT.runtime;
-  const message = status === "pass" ? `Wallet fixture applied and validated. Want different accounts? Edit: ${canonicalFixture}` : "Extension wallet fixture could not be applied and validated.";
-  if (json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "fixtures",
-      action,
-      adapter: "extension",
-      fixture: fixturePath,
-      canonicalFixture,
-      status,
-      exitCode,
-      profileReset: status === "pass",
-      message,
-      error: status === "fail" ? { code: "EXTENSION_FIXTURE_APPLY_FAILED", message, userAction } : null
-    }, null, 2));
-  } else if (status === "pass") {
-    console.error(message);
-  } else {
-    console.error(`\u2717 mm-harness fixtures ${action}: ${message}
-  Next: ${userAction}`);
-  }
-  return exitCode;
+  return apply({ target, sub, fixturePath, canonicalFixture, fixtureFlags, json, retryHint });
 }
 const EXT_FIXTURE_LEAF = "adapters/extension/wallet-fixture-state.cjs";
 function emitLeafMissing(json, action, fields, leaf) {
@@ -422,7 +217,7 @@ function emitLeafMissing(json, action, fields, leaf) {
   return EXIT.runtime;
 }
 function fixturesGenerate(adapter, target, options, json) {
-  if (adapter !== "extension") {
+  if (!getAdapterSurface(adapter).fixtures.operations.includes("generate")) {
     return usageOut(
       json,
       "fixtures",
@@ -486,7 +281,7 @@ function fixturesGenerate(adapter, target, options, json) {
   return exitCode;
 }
 async function fixturesFinalize(adapter, target, options, json) {
-  if (adapter !== "extension") {
+  if (!getAdapterSurface(adapter).fixtures.operations.includes("finalize")) {
     return usageOut(
       json,
       "fixtures",
@@ -678,5 +473,6 @@ Wallet fixture: ${canonical}`);
   return EXIT.ok;
 }
 export {
+  FIXTURE_STREAM_TIMEOUT_MS,
   handleFixtures
 };

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",