@deeeed/metamask-harness 0.75.0 → 0.76.0

package/dist/commands/doctor.js

@@ -1,28 +1,16 @@
 import { execFileSync } from "node:child_process";
-import { randomUUID } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
-import { readExtensionPinnedFlags } from "../adapters/extension/feature-flags.js";
 import { featureFlagReport } from "../feature-flags.js";
 import { color } from "../cli-color.js";
 import { collectCheckoutView, renderCheckoutView } from "../checkout-view.js";
 import { createDoctorReport, fixtureSummary, requiredDoctorCheckSummary } from "../doctor.js";
-import { terminalAppPort, terminalCdpPort } from "../adapters/terminal/surface.js";
 import { detectAdapter, resolveRuntimeContextPath } from "../harness.js";
 import { assertAdapter, runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { extensionProductConfigBlock } from "../adapters/extension/product-config.js";
-import { ensureMobilePerpsEnvironment, mobilePerpsEnvironment } from "../adapters/mobile/perps-env.js";
 import { loadActionManifest, validateManifest } from "../manifest.js";
 import { ensureOverlay, newHealState, recipeRunning } from "../heal-bounds.js";
 import { applyDeviceTargeting } from "./device-target.js";
-import {
-  mobileDeviceView,
-  mobileDeviceLiveView,
-  renderAdditionalReachableDevices,
-  renderMobileDeviceList,
-  renderMobileLiveBlock
-} from "./mobile-device-view.js";
 import { farmslotReadyIndicator } from "./farmslot-ready.js";
 import { updateStatus } from "./update.js";
 import { ensureRuntimeContext } from "../runtime-context.js";
@@ -63,6 +51,7 @@ async function handleDoctor({ options }) {
     return usageOut(json, "doctor", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
   }
   assertAdapter(adapter);
+  const { readiness } = getAdapterSurface(adapter);
   if (!fs.existsSync(target)) {
     return usageOut(
       json,
@@ -110,10 +99,9 @@ async function handleDoctor({ options }) {
       runtimeProbeError2 = error2 instanceof Error ? error2.message : String(error2);
     }
     const ready = runtime2?.decision === "ready";
-    if (adapter === "extension" && runtime2?.reasonCode === "product-config-required") {
-      failed.push("extension-product-config");
-    }
-    const nextActions = doctorFixNextActions(failed, result2.fixture, adapter, target);
+    const block = readiness.runtimeBlock?.(target, runtime2);
+    if (block) failed.push(block.id);
+    const nextActions = doctorFixNextActions(failed, result2.fixture, adapter, target, block);
     if (failed.length === 0 && !ready && runtime2?.nextAction) nextActions.push(runtime2.nextAction);
     const status = result2.status === "pass" && failed.length === 0 ? "pass" : "fail";
     const retryDoctor = `mm-harness doctor --fix --adapter ${adapter} --target ${shellQuote(target)} --json`;
@@ -136,13 +124,12 @@ async function handleDoctor({ options }) {
     }
     return status === "pass" ? 0 : 1;
   }
-  const mobilePlatform = adapter === "mobile" && (platformOption === "ios" || platformOption === "android") ? platformOption : void 0;
   const result = createDoctorReport(
     adapter,
     target,
     manifestValidation,
     actionManifestPath,
-    mobilePlatform
+    platformOption
   );
   const view = collectCheckoutView(target, adapter);
   const missingRequiredTool = result.checks.find(
@@ -183,7 +170,7 @@ async function handleDoctor({ options }) {
   const checks = [
     ...result.checks,
     runtimeCheck,
-    ...adapter === "terminal" ? await terminalDoctorChecks(target) : []
+    ...await readiness.liveChecks?.(target) ?? []
   ];
   const requiredChecks = requiredDoctorCheckSummary(checks);
   const doctorResult = {
@@ -192,10 +179,11 @@ async function handleDoctor({ options }) {
     checks,
     requiredChecks
   };
-  const orphanMetros = adapter === "mobile" ? detectOrphanMetros(target, process.env.WATCHER_PORT) : [];
-  const capture = captureHealth(adapter);
-  const deviceView = adapter === "mobile" ? mobileDeviceView(allDevices) : null;
-  const liveView = deviceView ? await mobileDeviceLiveView(target, deviceView) : null;
+  const orphanMetros = readiness.orphanDevServers?.(target, process.env.WATCHER_PORT) ?? [];
+  const capture = captureHealth(readiness.captureProviders);
+  const deviceSource = await readiness.devices?.();
+  const deviceView = deviceSource ? deviceSource.view(allDevices) : null;
+  const liveView = deviceSource && deviceView ? await deviceSource.live(target, deviceView) : null;
   const devices = liveView?.devicesWithLive ?? deviceView?.devices ?? [];
   const additionalReachableDevices = liveView?.additionalReachableDevices ?? [];
   const discovery = deviceView?.deviceDiscoveryErrors.length ? { deviceDiscoveryErrors: deviceView.deviceDiscoveryErrors } : {};
@@ -216,8 +204,8 @@ async function handleDoctor({ options }) {
   }
   const skills = skillsView(target);
   const update = updateStatus();
-  const extensionFlags = adapter === "extension" ? readExtensionPinnedFlags(target) : null;
-  const featureFlags = extensionFlags ? featureFlagReport(extensionFlags.overrides, extensionFlags) : featureFlagReport(liveView?.featureFlagOverrides ?? null);
+  const pinnedFlags = readiness.pinnedFlags?.(target) ?? null;
+  const featureFlags = pinnedFlags ? featureFlagReport(pinnedFlags.overrides, pinnedFlags) : featureFlagReport(liveView?.featureFlagOverrides ?? null);
   const doctorUserAction = doctorResult.checks.find(
     (check) => check.required && check.status === "fail" && check.userAction
   )?.userAction ?? `mm-harness doctor --fix --adapter ${adapter} --target ${shellQuote(target)} --json`;
@@ -249,12 +237,7 @@ async function handleDoctor({ options }) {
       featureFlags.error || (featureFlags.overrideCount ?? 0) > 0 ? "warn" : "dim",
       featureFlags.summary.replace(/^feature flags: /u, "")
     )}`);
-    if (adapter === "mobile") {
-      const perps = mobilePerpsEnvironment(target);
-      console.log(
-        `mobile-perps: ${perps.status} (${perps.file}; MM_PERPS_ENABLED=${perps.perpsEnabled.value ?? "missing"}; OVERRIDE_REMOTE_FEATURE_FLAGS=${perps.remoteFeatureFlagOverride.value ?? "missing"})`
-      );
-    }
+    for (const line of readiness.lines?.(target) ?? []) console.log(line);
     if (orphanMetros.length > 0) {
       console.log(
         `${out("warn", "orphan Metro:")} ${orphanMetros.length} leaked bundler(s) for this checkout (pids ${orphanMetros.join(", ")})`
@@ -264,33 +247,15 @@ async function handleDoctor({ options }) {
     if (capture) renderCaptureHealth(capture, out);
     renderSkillsView(skills, out);
     renderUpdateStatus(update, out);
-    if (adapter === "mobile") {
-      if (deviceView) renderMobileDeviceList(deviceView, out);
-      if (additionalReachableDevices.length > 0) renderAdditionalReachableDevices(additionalReachableDevices, out);
-      if (liveView) renderMobileLiveBlock(deviceView?.devices ?? [], liveView.liveMap, out);
+    if (deviceSource) {
+      if (deviceView) deviceSource.renderList(deviceView, out);
+      if (additionalReachableDevices.length > 0) deviceSource.renderAdditional(additionalReachableDevices, out);
+      if (liveView) deviceSource.renderLive(deviceView?.devices ?? [], liveView.liveMap, out);
     }
     if (next) console.log(`  ${out("dim", `Next: ${next}`)}`);
   }
   return doctorResult.status === "pass" ? 0 : 1;
 }
-async function terminalDoctorChecks(target) {
-  const { terminalReadiness } = await import("../../adapters/terminal/lib/readiness.mjs");
-  const { resolveBrowser } = await import("../../adapters/terminal/launch.mjs");
-  const report = await terminalReadiness({
-    target,
-    appPort: terminalAppPort(),
-    cdpPort: terminalCdpPort(),
-    signer: process.env.TERMINAL_SIGNER || "extension",
-    account: process.env.TERMINAL_ACCOUNT || "dev1",
-    probeBrowser: resolveBrowser
-  });
-  return report.checks.map((check) => ({
-    id: `terminal-${check.id}`,
-    status: check.status === "pass" ? "pass" : "fail",
-    required: check.required,
-    message: check.detail
-  }));
-}
 function doctorRuntimeCheck(runtime, error, expectLive) {
   if (error) {
     return {
@@ -310,7 +275,7 @@ function doctorRuntimeCheck(runtime, error, expectLive) {
     detail: runtime?.reasons.join(" | ") || "Runtime readiness probe returned no result."
   };
 }
-function doctorFixNextActions(failed, fixture, adapter, target) {
+function doctorFixNextActions(failed, fixture, adapter, target, block) {
   const actions = [];
   const executable = process.env.MM_HARNESS_EXECUTABLE ? shellQuote(process.env.MM_HARNESS_EXECUTABLE) : "mm-harness";
   const scope = `--adapter ${adapter} --target ${shellQuote(target)}`;
@@ -325,10 +290,7 @@ function doctorFixNextActions(failed, fixture, adapter, target) {
     );
   }
   if (failed.includes("overlay")) actions.push(`${executable} install ${scope}`);
-  if (adapter === "extension" && failed.includes("extension-product-config")) {
-    const block = extensionProductConfigBlock(target);
-    if (block) actions.push(block.userAction);
-  }
+  if (block?.userAction && failed.includes(block.id)) actions.push(block.userAction);
   return actions;
 }
 function emitExpectLiveVerdict(adapter, target, runtime, verdict) {
@@ -367,9 +329,9 @@ function emitExpectLive(adapter, target, runtime, result, orphanMetros, capture,
   emitExpectLiveVerdict(adapter, target, runtime, "not-live");
   return EXIT.runtime;
 }
-function captureHealth(adapter) {
-  if (adapter === "core") return null;
-  const fallback = adapter === "extension" ? ["cdp"] : ["simctl", "adb"];
+function captureHealth(providers) {
+  if (!providers) return null;
+  const fallback = [...providers];
   const helper = captureHelperHealth();
   if (!helper) {
     return {
@@ -445,18 +407,6 @@ function renderUpdateStatus(status, out) {
     status.updateAvailable ? `${out("label", "update:")} ${out("warn", `${status.current} \u2192 ${status.latest} available`)} ${out("dim", "(mm-harness update)")}` : status.latest && status.latest !== status.current ? `${out("label", "update:")} ${out("ok", status.current)} ${out("dim", `ahead of registry ${status.latest}`)}` : `${out("label", "update:")} ${out("ok", `${status.current} is latest`)}`
   );
 }
-function detectOrphanMetros(target, livePort) {
-  try {
-    const script = path.join(runnerDir, "adapters/shared/reap-checkout-metros.sh");
-    const out = execFileSync("bash", ["-c", `. "$1"; detect_checkout_metros "$2" "$3"`, "mm-harness-doctor", script, target, livePort ?? ""], {
-      encoding: "utf8",
-      timeout: 5e3
-    });
-    return out.split("\n").map((line) => line.trim()).filter((line) => /^\d+$/u.test(line));
-  } catch {
-    return [];
-  }
-}
 async function runDoctorFix(adapter, target, manifestValidation, json) {
   const fixed = [];
   const failed = [];
@@ -473,18 +423,11 @@ async function runDoctorFix(adapter, target, manifestValidation, json) {
   } catch {
     failed.push("runtime-context");
   }
-  if (adapter === "extension") {
-    try {
-      if (ensureExtensionPerpsBuildFlag(target)) fixed.push("extension-perps-build");
-    } catch {
-      failed.push("extension-perps-build");
-    }
-  }
-  if (adapter === "mobile") {
+  for (const fix of getAdapterSurface(adapter).readiness.fixes ?? []) {
     try {
-      if (ensureMobilePerpsEnvironment(target).length > 0) fixed.push("mobile-perps-env");
+      if (fix.apply(target)) fixed.push(fix.id);
     } catch {
-      failed.push("mobile-perps-env");
+      failed.push(fix.id);
     }
   }
   const state = newHealState();
@@ -508,62 +451,8 @@ async function runDoctorFix(adapter, target, manifestValidation, json) {
   }
   return { fixed, failed };
 }
-function ensureExtensionPerpsBuildFlag(target) {
-  const configPath = path.join(target, ".metamaskrc");
-  const templatePath = path.join(target, ".metamaskrc.dist");
-  const config = readTextSnapshot(configPath);
-  const template = config.kind === "file" ? null : readTextSnapshot(templatePath);
-  const source = config.kind === "file" ? config : template?.kind === "file" ? template : config.kind === "symlink" ? { kind: "file", text: "", mode: 438 } : null;
-  if (!source) return false;
-  const before = source.text;
-  if (/^\s*PERPS_ENABLED\s*=\s*(['"]?)true\1\s*$/mu.test(before)) return false;
-  const line = "PERPS_ENABLED='true'";
-  const after = /^\s*PERPS_ENABLED\s*=.*$/mu.test(before) ? before.replace(/^\s*PERPS_ENABLED\s*=.*$/mu, line) : `${before.replace(/\s*$/u, "")}
-${line}
-`;
-  const temporary = `${configPath}.${process.pid}.${randomUUID()}.tmp`;
-  let descriptor = null;
-  try {
-    const mode = config.kind === "file" ? config.mode : 438;
-    descriptor = fs.openSync(
-      temporary,
-      fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL,
-      mode
-    );
-    fs.writeFileSync(descriptor, after);
-    if (config.kind === "file") fs.fchmodSync(descriptor, config.mode);
-    fs.closeSync(descriptor);
-    descriptor = null;
-    fs.renameSync(temporary, configPath);
-  } finally {
-    if (descriptor !== null) fs.closeSync(descriptor);
-    fs.rmSync(temporary, { force: true });
-  }
-  return true;
-}
-function readTextSnapshot(file) {
-  let descriptor;
-  try {
-    descriptor = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
-  } catch (error) {
-    const code = error.code;
-    if (code === "ENOENT") return { kind: "missing" };
-    if (code === "ELOOP") return { kind: "symlink" };
-    throw error;
-  }
-  try {
-    return {
-      kind: "file",
-      text: fs.readFileSync(descriptor, "utf8"),
-      mode: fs.fstatSync(descriptor).mode & 511
-    };
-  } finally {
-    fs.closeSync(descriptor);
-  }
-}
 export {
   doctorFixNextActions,
-  ensureExtensionPerpsBuildFlag,
   handleDoctor,
   skillsView
 };

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/logs.js

@@ -68,7 +68,7 @@ async function handleLogs(argv) {
   if (flag(options, "window")) {
     surface.resolveSlotPorts(target);
     const port = process.env.WATCHER_PORT ?? process.env.METRO_PORT ?? "default";
-    const windowName = adapter === "mobile" ? `metro-${port}` : `webpack-${port}`;
+    const windowName = `${surface.devServer.label}-${port}`;
     const devLog = logSources[0].path;
     const leaf = path.join(runnerDir, "adapters/shared/open-log-window.sh");
     const result = spawnScript(

package/dist/commands/parse-args.js

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { detectAdapter } from "../harness.js";
-import { assertAdapter, manifestPath } from "../paths.js";
+import { adapterRegistry } from "../adapters/registry.js";
+import { assertAdapter } from "../paths.js";
 import { explicitRecipeTrustOptions } from "../recipe-security.js";
 import { ADAPTER_DETECT_NEXT } from "./shared.js";
 import { EXIT } from "./shared.js";
@@ -179,12 +180,16 @@ function requiredOption(options, key, message) {
   if (!value) throw usageError(message);
   return value;
 }
+function adapterUsageError(error) {
+  if (error instanceof Error && error.message.startsWith("internal:")) return error;
+  return usageError(error instanceof Error ? error.message : String(error));
+}
 function adapterOption(options) {
   const adapter = optionString(options, "adapter");
   try {
     assertAdapter(adapter);
   } catch (error) {
-    throw usageError(error instanceof Error ? error.message : String(error));
+    throw adapterUsageError(error);
   }
   return adapter;
 }
@@ -193,7 +198,7 @@ function targetPath(options) {
 }
 function actionManifestPathOption(options, adapter) {
   const configured = optionString(options, "actionManifest");
-  return configured ? path.resolve(configured) : manifestPath(adapter);
+  return configured ? path.resolve(configured) : adapterRegistry.get(adapter).actions.manifestPath();
 }
 function parsePort(value, errorMessage) {
   const port = Number(value);
@@ -238,7 +243,7 @@ function resolveAdapter(options) {
   try {
     assertAdapter(adapter);
   } catch (error) {
-    throw usageError(error instanceof Error ? error.message : String(error));
+    throw adapterUsageError(error);
   }
   return { adapter, target };
 }