@deeeed/metamask-harness 0.75.0 → 0.77.0

package/dist/commands/status.js

@@ -1,6 +1,5 @@
 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";
@@ -10,15 +9,6 @@ import { getAdapterSurface } from "../adapters/surface.js";
 import {
   applyDeviceTargeting
 } from "./device-target.js";
-import {
-  mobileDeviceView,
-  mobileDeviceLiveView,
-  nextForLive,
-  renderAndroidPortHints,
-  renderMobileDeviceList,
-  renderAdditionalReachableDevices,
-  renderMobileLiveBlock
-} from "./mobile-device-view.js";
 import { ADAPTER_DETECT_NEXT, EXIT, usageOut } from "./shared.js";
 import { handleStatusTaskView, renderAcceptanceLines } from "./status-watch.js";
 import { collectTaskView, findTaskDir } from "../task-view.js";
@@ -45,23 +35,25 @@ async function handleStatus({ options }) {
   const view = collectCheckoutView(target, adapter);
   const surface = getAdapterSurface(adapter);
   surface.resolveSlotPorts(target);
-  if (adapter === "mobile") {
+  const { readiness } = surface;
+  const deviceSource = await readiness.devices?.();
+  if (deviceSource) {
     const dtResult = applyDeviceTargeting("status", adapter, options, { gate: false, rerun: "" });
     if ("code" in dtResult) {
       return usageOut(json, "status", dtResult.message, dtResult.userAction);
     }
   }
   const next = surface.hints.relaunch;
-  const extensionFlags = adapter === "extension" ? readExtensionPinnedFlags(target) : null;
-  const staticFeatureFlags = extensionFlags ? featureFlagReport(extensionFlags.overrides, extensionFlags) : featureFlagReport(null);
-  const deviceView = adapter === "mobile" ? mobileDeviceView(allDevices) : null;
+  const pinnedFlags = readiness.pinnedFlags?.(target) ?? null;
+  const staticFeatureFlags = pinnedFlags ? featureFlagReport(pinnedFlags.overrides, pinnedFlags) : featureFlagReport(null);
+  const deviceView = deviceSource ? deviceSource.view(allDevices) : null;
   const devices = deviceView?.devices ?? [];
   const discovery = deviceView?.deviceDiscoveryErrors.length ? { deviceDiscoveryErrors: deviceView.deviceDiscoveryErrors } : {};
   const discoveryNext = discovery.deviceDiscoveryErrors?.[0]?.userAction;
   if (json) {
-    const doProbe = !fast && adapter === "mobile" && deviceView !== null && deviceView.allConnectedDevices.length > 0;
+    const doProbe = !fast && deviceSource && deviceView !== null && deviceView.allConnectedDevices.length > 0;
     if (doProbe) {
-      const liveView = await mobileDeviceLiveView(target, deviceView);
+      const liveView = await deviceSource.live(target, deviceView);
       console.log(
         JSON.stringify(
           {
@@ -75,14 +67,14 @@ async function handleStatus({ options }) {
             ...discovery,
             ...liveView.additionalReachableDevices.length > 0 ? { additionalReachableDevices: liveView.additionalReachableDevices } : {},
             ...liveView.androidPortHints.length > 0 ? { androidPortHints: liveView.androidPortHints } : {},
-            next: discoveryNext ?? nextForLive(next, liveView.liveMap)
+            next: discoveryNext ?? deviceSource.nextForLive(next, liveView.liveMap)
           },
           null,
           2
         )
       );
     } else {
-      const runtime = !fast && adapter === "extension" ? await surface.runtimeStatus(target) : void 0;
+      const runtime = !fast && readiness.statusRuntime ? await surface.runtimeStatus(target) : void 0;
       console.log(
         JSON.stringify(
           {
@@ -113,21 +105,21 @@ async function handleStatus({ options }) {
       console.log(renderAcceptanceLines(taskView).join("\n"));
     }
   }
-  if (adapter !== "mobile") renderFeatureFlagLine(staticFeatureFlags, out);
-  if (deviceView) renderMobileDeviceList(deviceView, out);
-  if (!fast && adapter === "mobile" && deviceView !== null && deviceView.allConnectedDevices.length > 0) {
-    const liveView = await mobileDeviceLiveView(target, deviceView);
-    if (liveView.additionalReachableDevices.length > 0) renderAdditionalReachableDevices(liveView.additionalReachableDevices, out);
+  if (!deviceSource) renderFeatureFlagLine(staticFeatureFlags, out);
+  if (deviceSource && deviceView) deviceSource.renderList(deviceView, out);
+  if (!fast && deviceSource && deviceView !== null && deviceView.allConnectedDevices.length > 0) {
+    const liveView = await deviceSource.live(target, deviceView);
+    if (liveView.additionalReachableDevices.length > 0) deviceSource.renderAdditional(liveView.additionalReachableDevices, out);
     renderFeatureFlagLine(featureFlagReport(liveView.featureFlagOverrides), out);
-    renderMobileLiveBlock(devices, liveView.liveMap, out);
-    renderAndroidPortHints(liveView.androidPortHints, out);
-    console.log(`${out("label", "Next:")} ${out("cmd", discoveryNext ?? nextForLive(next, liveView.liveMap))}`);
-  } else if (!fast && adapter === "extension") {
+    deviceSource.renderLive(devices, liveView.liveMap, out);
+    deviceSource.renderPortHints(liveView.androidPortHints, out);
+    console.log(`${out("label", "Next:")} ${out("cmd", discoveryNext ?? deviceSource.nextForLive(next, liveView.liveMap))}`);
+  } else if (!fast && readiness.statusRuntime) {
     const runtime = await surface.runtimeStatus(target);
     renderRuntimeStatus(runtime, out);
     console.log(`${out("label", "Next:")} ${out("cmd", nextForRuntime(surface.hints.launch, surface.hints.relaunch, runtime))}`);
   } else {
-    if (adapter === "mobile") renderFeatureFlagLine(featureFlagReport(null), out);
+    if (deviceSource) renderFeatureFlagLine(featureFlagReport(null), out);
     console.log(`${out("label", "Next:")} ${out("cmd", discoveryNext ?? next)}`);
   }
   return EXIT.ok;

package/dist/commands/stop.js

@@ -27,7 +27,7 @@ async function handleStop(argv) {
   const collector = await stopProjectCollector(target);
   const signalled = (stop.signalled ?? 0) + (collector.stopped ? 1 : 0);
   const summary = collector.stopped ? `${stop.summary}; stopped analytics collector ${collector.pid}` : stop.summary;
-  const next = adapter === "extension" ? `${surface.hints.launch} --target ${shellQuote(target)}` : void 0;
+  const next = surface.devServer.afterStop?.(target);
   const userAction = `mm-harness status --target ${shellQuote(target)} --json`;
   if (json) {
     console.log(

package/dist/doctor.js

@@ -1,17 +1,11 @@
-import { spawnSync } from "node:child_process";
 import fs from "node:fs";
-import { createRequire } from "node:module";
 import path from "node:path";
 import { color } from "./cli-color.js";
 import { normalizeFeatureFlagRecord } from "./feature-flags.js";
-import {
-  mobileToolRecovery,
-  resolveMobileToolPath
-} from "../library/actions/mobile/platform/tool-paths.mjs";
-import { mobilePerpsEnvironment } from "./adapters/mobile/perps-env.js";
+import { getAdapterSurface } from "./adapters/surface.js";
 import { readRuntimeContextField, resolveRuntimeContextPath } from "./harness.js";
 import { isPin } from "./harness-pin.js";
-import { harnessExecutable, manifestPath, readJson, recipeHarnessRoot, recipeRuntimeDir, runnerDir } from "./paths.js";
+import { harnessExecutable, readJson, recipeHarnessRoot, recipeRuntimeDir, runnerDir } from "./paths.js";
 function requiredDoctorCheckSummary(checks) {
   const required = checks.filter((check) => check.required);
   const failed = required.filter((check) => check.status === "fail").map((check) => check.id);
@@ -42,21 +36,7 @@ function repoShape(target) {
   };
 }
 function compatibilityMode(adapter, target) {
-  const shape = repoShape(target);
-  if (adapter === "core") {
-    return fs.existsSync(path.join(target, "packages/perps-controller/src/index.ts")) ? "headless controller (no bridge)" : "unsupported/no bridge";
-  }
-  if (adapter === "terminal") {
-    return fs.existsSync(path.join(target, "src/features/perpetuals")) ? "slot browser over CDP (website; no product bridge)" : "unsupported/no bridge";
-  }
-  if (adapter === "mobile") {
-    if (shape.injectedHarness && shape.agenticService) return "runner bridge with injected app bridge";
-    if (shape.agenticService) return "runner bridge with app bridge";
-    return "runner bridge available; app bridge not installed";
-  }
-  if (!shape.extensionProject) return "unsupported/no bridge";
-  if (shape.extensionRuntime || shape.injectedHarness) return "bridge present";
-  return "bridge injectable";
+  return getAdapterSurface(adapter).readiness.compatibilityMode(target, repoShape(target));
 }
 function readPackageInfo(target) {
   const packageJsonPath = path.join(target, "package.json");
@@ -97,7 +77,8 @@ function fixtureFileSummary(file, adapter, reportedPath = file) {
     );
     const flagKeys = Object.keys(remoteFeatureFlags);
     return {
-      status: hasAccounts && (adapter === "core" || hasPassword) ? "ready" : "incomplete",
+      // A headless platform signs with the accounts alone; nothing unlocks a UI.
+      status: hasAccounts && (adapter !== void 0 && getAdapterSurface(adapter).headless || hasPassword) ? "ready" : "incomplete",
       path: reportedPath,
       accountCount: Array.isArray(data.accounts) ? data.accounts.length : 0,
       hasPassword,
@@ -155,7 +136,8 @@ function renderRuntimeContext(runtimeContext) {
   }
   return lines.join("\n");
 }
-function createDoctorReport(adapter, target, manifestValidation, actionManifestPath = manifestPath(adapter), mobilePlatform) {
+function createDoctorReport(adapter, target, manifestValidation, actionManifestPath = getAdapterSurface(adapter).actions.manifestPath(), platform) {
+  const readiness = getAdapterSurface(adapter).readiness;
   const mode = compatibilityMode(adapter, target);
   const manifestErrors = Number(manifestValidation.summary?.errors ?? 0);
   const checks = [
@@ -171,8 +153,7 @@ function createDoctorReport(adapter, target, manifestValidation, actionManifestP
       required: false,
       message: mode === "unsupported/no bridge" ? `No ${adapter} bridge is available for this checkout.` : `${adapter} compatibility mode: ${mode}.`
     },
-    ...adapter === "mobile" ? mobileToolDoctorChecks(mobilePlatform) : [],
-    ...adapter === "extension" ? [extensionBrowserDoctorCheck(target), extensionBrowserResolutionDoctorCheck(target)] : []
+    ...readiness.checks?.(target, platform) ?? []
   ];
   const requiredChecks = requiredDoctorCheckSummary(checks);
   return {
@@ -188,99 +169,11 @@ function createDoctorReport(adapter, target, manifestValidation, actionManifestP
     compatibilityMode: mode,
     shape: repoShape(target),
     fixture: fixtureSummary(target, adapter),
-    environment: adapter === "mobile" ? { mobilePerps: mobilePerpsEnvironment(target) } : {},
+    environment: readiness.environment?.(target) ?? {},
     runtimeContext: runtimeContextSummary(target, adapter),
     manifestValidation: manifestValidation.summary
   };
 }
-function extensionBrowserDoctorCheck(target) {
-  const requireFromTarget = createRequire(path.join(path.resolve(target), "package.json"));
-  for (const packageName of ["@playwright/test", "playwright"]) {
-    try {
-      const playwright = requireFromTarget(packageName);
-      const executable = playwright.chromium?.executablePath?.();
-      if (executable && fs.existsSync(executable)) {
-        return {
-          id: "playwright-chromium",
-          status: "pass",
-          required: true,
-          message: "Checkout-pinned Playwright Chromium is installed.",
-          detail: executable
-        };
-      }
-    } catch {
-    }
-  }
-  return {
-    id: "playwright-chromium",
-    status: "fail",
-    required: true,
-    message: "Checkout-pinned Playwright Chromium is not installed.",
-    userAction: "yarn playwright install chromium"
-  };
-}
-function extensionBrowserResolutionDoctorCheck(target) {
-  const resolver = path.join(runnerDir, "adapters/shared/browser-resolver.cjs");
-  const runtime = path.join(path.resolve(target), recipeRuntimeDir());
-  const record = path.join(runtime, "browser-resolution.json");
-  let profile = process.env.CHROME_USER_DATA_DIR || path.join(runtime, process.env.RECIPE_CHROME_PROFILE_NAME || "chrome-profile");
-  while (profile.length > 1 && profile.endsWith("/")) profile = profile.slice(0, -1);
-  const profileExists = fs.existsSync(path.join(profile, "Local State"));
-  const result = spawnSync(process.execPath, [
-    resolver,
-    "resolve",
-    "--target",
-    path.resolve(target),
-    "--launch-method",
-    "launch-services",
-    "--display",
-    "headful",
-    ...profileExists && fs.existsSync(record) ? ["--recorded", record] : [],
-    "--json"
-  ], {
-    cwd: path.resolve(target),
-    encoding: "utf8",
-    timeout: 135e3
-  });
-  if (result.status === 0) {
-    const resolution = JSON.parse(result.stdout);
-    const managed = resolution.managedChrome;
-    const managedNote = managed && !resolution.warning?.includes("managed by policy") ? ` Google Chrome is managed by policy (${managed.forcedExtensions.length} forced extension${managed.forcedExtensions.length === 1 ? "" : "s"}: ${managed.forcedExtensions.map(({ id, name }) => name ? `${id} (${name})` : id).join(", ")}${managed.signinForced ? "; browser sign-in forced" : ""}); slots use Chrome for Testing.` : "";
-    const probe = resolution.probe ? `; Chrome for Testing probe (${resolution.probe.launchMethod}, ${resolution.probe.display}${resolution.probe.cached ? ", cached" : ""}${resolution.probe.transient ? `, retried after ${resolution.probe.expiresAt}` : ""}): ${resolution.probe.reason}` : resolution.recordedFrom ? `; kept from the slot profile record ${resolution.recordedFrom}` : "";
-    return {
-      id: "extension-browser",
-      status: "pass",
-      required: false,
-      message: `Launch browser: ${resolution.browser} ${resolution.version ?? "(unknown version)"} via ${resolution.source} (${resolution.mode}); extension loading: ${resolution.extensionLoading}${probe}.${managedNote}${resolution.warning ? ` Warning: ${resolution.warning}` : ""}`,
-      detail: resolution.bin
-    };
-  }
-  const message = (result.stderr || result.error?.message || "browser resolution failed").trim();
-  return {
-    id: "extension-browser",
-    status: "fail",
-    required: message.includes("BROWSER_UNLAUNCHABLE:"),
-    message,
-    userAction: "install Google Chrome, or set RECIPE_HARNESS_BROWSER / RECIPE_HARNESS_CHROME_BIN to a browser that starts"
-  };
-}
-function mobileToolDoctorChecks(platform) {
-  const specs = platform === "android" ? [{ tool: "adb", platform: "Android" }] : platform === "ios" ? [{ tool: "idb", platform: "iOS" }] : [
-    { tool: "adb", platform: "Android" },
-    { tool: "idb", platform: "iOS" }
-  ];
-  return specs.map(({ tool, platform: platformName }) => {
-    const resolved = resolveMobileToolPath(tool);
-    return {
-      id: `device-tool-${tool}`,
-      status: resolved ? "pass" : "fail",
-      required: platform !== void 0,
-      message: resolved ? `${platformName} device tool ${tool} is ready.` : `${platformName} device tool ${tool} is unavailable.`,
-      ...resolved ? { detail: resolved } : {},
-      ...!resolved ? { userAction: mobileToolRecovery(tool) } : {}
-    };
-  });
-}
 function runnerInstallKind(runnerRoot, invokedPath, executablePath) {
   if (isPin(runnerRoot)) return "pinned-install";
   const normalizedRoot = path.normalize(runnerRoot);
@@ -344,11 +237,8 @@ function readJsonObject(file) {
 export {
   compatibilityMode,
   createDoctorReport,
-  extensionBrowserDoctorCheck,
-  extensionBrowserResolutionDoctorCheck,
   fixtureFileSummary,
   fixtureSummary,
-  mobileToolDoctorChecks,
   renderRuntimeContext,
   repoShape,
   requiredDoctorCheckSummary,

package/dist/harness.js

@@ -3,7 +3,7 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { shellLeafMissing, missingShellLeafMessage } from "./leaf-invoke.js";
-import { resolveExtensionSlotPorts } from "./adapters/slot-ports.js";
+import { adapterRegistry } from "./adapters/registry.js";
 import { recipeHarnessPath, recipeRuntimeDir, runnerDir } from "./paths.js";
 import { colorHumanMessage } from "./cli-color.js";
 const HARNESS_ACTIONS = ["install", "verify", "cleanup"];
@@ -37,15 +37,15 @@ Examples:
 
 core supports install, verify, and cleanup (headless; no live).`);
 }
-function failureHint(adapter, action) {
-  if (adapter === "core") {
+function failureHint(surface, action) {
+  const restart = surface.harness.restart;
+  if (!restart) {
     if (action === "verify") {
-      return `Install the core harness first: mm-harness install --platform core`;
+      return `Install the ${surface.adapter} harness first: mm-harness install --platform ${surface.adapter}`;
     }
     return "Read the error above for the specific cause, then re-run this command.";
   }
-  const helper = adapter === "mobile" ? "mm-harness launch ios   # or launch android" : "mm-harness launch";
-  return `Read the error above for the specific cause. To (re)start the runtime, run: ${helper}`;
+  return `Read the error above for the specific cause. To (re)start the runtime, run: ${restart}`;
 }
 function successNext(adapter, action, target) {
   const base = `--adapter ${adapter} --target ${shellQuote(target)}`;
@@ -67,7 +67,7 @@ function shellQuote(value) {
   return /^[A-Za-z0-9_./:=@+-]+$/u.test(value) ? value : `'${value.replace(/'/gu, `'\\''`)}'`;
 }
 function isAdapter(value) {
-  return value === "mobile" || value === "extension" || value === "core" || value === "terminal";
+  return value !== void 0 && adapterRegistry.has(value);
 }
 function parseHarnessArgs(args) {
   const forward = [];
@@ -170,37 +170,9 @@ function readRuntimeContextField(contextPath, field) {
   if (node === void 0 || node === null || node === "") return void 0;
   return String(node);
 }
-function applyExtensionRuntimeEnv(target, args) {
-  const contextPath = resolveRuntimeContextPath(target);
-  const contextExists = fs.existsSync(contextPath);
-  if (contextExists) {
-    process.env.RECIPE_RUNTIME_CONTEXT = contextPath;
-    if (!process.env.RECIPE_SLOT_ID) {
-      const slotId = readRuntimeContextField(contextPath, "slotId");
-      if (slotId) process.env.RECIPE_SLOT_ID = slotId;
-    }
-    if (!process.env.RECIPE_HARNESS_EXTENSION_ID) {
-      const extensionId = readRuntimeContextField(contextPath, "extensionId");
-      if (extensionId) process.env.RECIPE_HARNESS_EXTENSION_ID = extensionId;
-    }
-  } else {
-    delete process.env.RECIPE_RUNTIME_CONTEXT;
-  }
-  resolveExtensionSlotPorts(target);
-  let result = [...args];
-  if (!hasArg(result, "--cdp-port")) {
-    const cdpPort = process.env.RECIPE_CDP_PORT ?? process.env.CDP_PORT;
-    if (cdpPort) {
-      process.env.RECIPE_CDP_PORT = cdpPort;
-      process.env.CDP_PORT = cdpPort;
-      result = [...result, "--cdp-port", cdpPort];
-    }
-  }
-  return result;
-}
 function resolveEntry(base, candidates, mode) {
   for (const candidate of candidates) {
-    const full = path.join(base, candidate);
+    const full = path.resolve(base, candidate);
     try {
       const stat = fs.statSync(full);
       if (!stat.isFile()) continue;
@@ -208,7 +180,7 @@ function resolveEntry(base, candidates, mode) {
     } catch {
     }
   }
-  return path.join(base, candidates[0]);
+  return path.resolve(base, candidates[0]);
 }
 function installedRunnerSource(target, adapter) {
   const pointer = path.join(recipeHarnessPath(target, adapter), "runner", ".runner-source");
@@ -217,56 +189,12 @@ function installedRunnerSource(target, adapter) {
   if (!value || !fs.existsSync(value)) return void 0;
   return value;
 }
-function isExecutable(file) {
-  try {
-    const stat = fs.statSync(file);
-    return stat.isFile() && (stat.mode & 73) !== 0;
-  } catch {
-    return false;
-  }
-}
-const INJECT_CANDIDATES = {
-  mobile: { entry: "adapters/mobile/inject.sh", fallback: "scripts/inject-mobile-harness.sh" },
-  extension: { entry: "adapters/extension/inject.mjs", fallback: "scripts/inject-extension-harness.mjs" },
-  core: { entry: "adapters/core/inject.sh", fallback: "scripts/inject-core-harness.sh" },
-  terminal: { entry: "adapters/terminal/inject.mjs", fallback: "adapters/terminal/inject.mjs" }
-};
-const CLEANUP_CANDIDATES = {
-  mobile: { entry: "adapters/mobile/cleanup.sh", fallback: "scripts/cleanup-mobile-harness.sh" },
-  extension: { entry: "adapters/extension/cleanup.mjs", fallback: "scripts/cleanup-extension-harness.mjs" },
-  core: { entry: "adapters/core/cleanup.sh", fallback: "scripts/cleanup-core-harness.sh" },
-  terminal: { entry: "adapters/terminal/cleanup.mjs", fallback: "adapters/terminal/cleanup.mjs" }
-};
-function resolveHarnessDispatch(adapter, action, target) {
-  if (action === "install") {
-    const { entry, fallback } = INJECT_CANDIDATES[adapter];
-    if (adapter === "extension" || adapter === "terminal") {
-      return { command: process.execPath, prefixArgs: [resolveEntry(runnerDir, [entry, fallback], "file")] };
-    }
-    return { command: resolveEntry(runnerDir, [entry, fallback], "file"), prefixArgs: [] };
-  }
-  if (action === "cleanup") {
-    const { entry, fallback } = CLEANUP_CANDIDATES[adapter];
-    const base = adapter === "terminal" ? runnerDir : installedRunnerSource(target, adapter) ?? runnerDir;
-    if (adapter === "extension" || adapter === "terminal") {
-      return { command: process.execPath, prefixArgs: [resolveEntry(base, [entry, fallback], "file")] };
-    }
-    return { command: resolveEntry(base, [entry, fallback], "file"), prefixArgs: [] };
-  }
-  if (adapter === "terminal" && action === "verify") {
-    return { command: process.execPath, prefixArgs: [path.join(runnerDir, "adapters", "terminal", "verify.mjs")] };
-  }
-  if (adapter === "core" && action === "verify") {
-    const delegate = path.join(recipeHarnessPath(target, "core"), "runner", "bin", "mm-harness");
-    if (!isExecutable(delegate)) {
-      return {
-        error: `core recipe harness not installed: missing delegate ${delegate}.
-Next: mm-harness install --platform core --target ${target}`
-      };
-    }
-    return { command: delegate, prefixArgs: ["doctor", "--adapter", "core"] };
-  }
-  return { inProcess: adapter === "mobile" ? "mobile-verify" : "extension-verify" };
+function resolveHarnessDispatch(surface, action, target) {
+  if (action === "verify") return surface.harness.verify(target);
+  const leaf = action === "install" ? surface.harness.install : surface.harness.cleanup;
+  const base = action === "cleanup" && surface.harness.cleanup.fromInstalledRunner ? installedRunnerSource(target, surface.adapter) ?? runnerDir : runnerDir;
+  const entry = resolveEntry(base, [leaf.entry, leaf.fallback], "file");
+  return leaf.node ? { command: process.execPath, prefixArgs: [entry] } : { command: entry, prefixArgs: [] };
 }
 async function handleHarness(argv) {
   const action = argv[0];
@@ -280,6 +208,7 @@ async function handleHarness(argv) {
     return 2;
   }
   const harnessAction = action;
+  const { getAdapterSurface } = await import("./adapters/surface.js");
   const { adapter: parsedAdapter, json, quiet, forward } = parseHarnessArgs(argv.slice(1));
   const rawTarget = argValue(forward, "--target");
   const target = path.resolve(rawTarget ?? process.cwd());
@@ -306,10 +235,11 @@ async function handleHarness(argv) {
   if (harnessAction === "install" && hasArg(forward, "--runway")) {
     return handleRunwayInstall(adapter, target, forward, json);
   }
-  if (adapter === "extension" && harnessAction === "verify") {
-    forwardArgs = applyExtensionRuntimeEnv(target, forwardArgs);
+  const surface = getAdapterSurface(adapter);
+  if (harnessAction === "verify" && surface.harness.verifyArgs) {
+    forwardArgs = surface.harness.verifyArgs(target, forwardArgs);
   }
-  const dispatch = resolveHarnessDispatch(adapter, harnessAction, target);
+  const dispatch = resolveHarnessDispatch(surface, harnessAction, target);
   if ("error" in dispatch) {
     if (quiet) {
       return 1;
@@ -335,7 +265,7 @@ async function handleHarness(argv) {
   }
   const start = Date.now();
   if ("inProcess" in dispatch) {
-    const runVerify = dispatch.inProcess === "mobile-verify" ? (await import("./adapters/mobile/verify.js")).runMobileVerify : (await import("./adapters/extension/verify.js")).runExtensionVerify;
+    const runVerify = await dispatch.inProcess();
     let exitCode;
     try {
       exitCode = await runVerify(forwardArgs, {
@@ -355,7 +285,7 @@ async function handleHarness(argv) {
 `);
       exitCode = 1;
     }
-    return reportHarnessOutcome(harnessAction, adapter, target, exitCode, autoDetected, json, quiet, start);
+    return reportHarnessOutcome(harnessAction, surface, target, exitCode, autoDetected, json, quiet, start);
   }
   if (shellLeafMissing(dispatch.command)) {
     const message = missingShellLeafMessage(dispatch.command);
@@ -366,7 +296,7 @@ async function handleHarness(argv) {
         harnessSummary(harnessAction, adapter, target, "fail", 1, autoDetected, {
           code: "HARNESS_SPAWN_FAILED",
           message,
-          userAction: failureHint(adapter, harnessAction)
+          userAction: failureHint(surface, harnessAction)
         })
       );
     } else {
@@ -387,19 +317,20 @@ async function handleHarness(argv) {
         harnessSummary(harnessAction, adapter, target, "fail", 1, autoDetected, {
           code: "HARNESS_SPAWN_FAILED",
           message: `${harnessAction} ${adapter} could not start: ${result.error.message}`,
-          userAction: failureHint(adapter, harnessAction)
+          userAction: failureHint(surface, harnessAction)
         })
       );
     } else {
       console.error(`\u2717 ${harnessAction} ${adapter} could not start: ${result.error.message}
-  ${failureHint(adapter, harnessAction)}`);
+  ${failureHint(surface, harnessAction)}`);
     }
     return 1;
   }
-  return reportHarnessOutcome(harnessAction, adapter, target, result.status ?? 1, autoDetected, json, quiet, start);
+  return reportHarnessOutcome(harnessAction, surface, target, result.status ?? 1, autoDetected, json, quiet, start);
 }
-function reportHarnessOutcome(action, adapter, target, exitCode, autoDetected, json, quiet, start) {
+function reportHarnessOutcome(action, surface, target, exitCode, autoDetected, json, quiet, start) {
   const seconds = ((Date.now() - start) / 1e3).toFixed(1);
+  const adapter = surface.adapter;
   if (quiet) {
     return exitCode;
   } else if (json) {
@@ -411,7 +342,7 @@ function reportHarnessOutcome(action, adapter, target, exitCode, autoDetected, j
         exitCode === 0 ? "pass" : "fail",
         exitCode,
         autoDetected,
-        exitCode === 0 ? void 0 : { code: "HARNESS_FAILED", message: `${action} ${adapter} failed (exit ${exitCode})`, userAction: failureHint(adapter, action) }
+        exitCode === 0 ? void 0 : { code: "HARNESS_FAILED", message: `${action} ${adapter} failed (exit ${exitCode})`, userAction: failureHint(surface, action) }
       )
     );
   } else if (exitCode === 0) {
@@ -419,7 +350,7 @@ function reportHarnessOutcome(action, adapter, target, exitCode, autoDetected, j
   Next: ${successNext(adapter, action, target)}`));
   } else {
     console.error(colorHumanMessage(`\u2717 ${action} ${adapter} failed (exit ${exitCode}, ${seconds}s)
-  ${failureHint(adapter, action)}`));
+  ${failureHint(surface, action)}`));
   }
   return exitCode;
 }
@@ -448,7 +379,7 @@ async function handleRunwayInstall(adapter, target, forward, json) {
   });
   const provisionedSimulator = typeof result.simulator === "object" && result.simulator ? result.simulator : void 0;
   const provisionedDevice = typeof provisionedSimulator?.udid === "string" ? provisionedSimulator.udid : typeof provisionedSimulator?.name === "string" ? provisionedSimulator.name : void 0;
-  const next = result.status === "pass" && adapter === "mobile" && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? "ios")} --adapter mobile --target ${shellQuote(target)}` + (provisionedDevice ? ` --device ${shellQuote(provisionedDevice)}` : "") : void 0;
+  const next = result.status === "pass" && surface.runwayProvision.launchNext && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? "ios")} --adapter ${adapter} --target ${shellQuote(target)}` + (provisionedDevice ? ` --device ${shellQuote(provisionedDevice)}` : "") : void 0;
   const output = next ? { ...result, next } : result;
   if (json) {
     console.log(JSON.stringify(output, null, 2));

package/dist/mm-harness-cli.js

@@ -1032,8 +1032,9 @@ function detectedSlotLine(out) {
     if (ctx.slotId) parts.push(`slot ${out("ok", String(ctx.slotId))}`);
     if (ctx.simulator) parts.push(`device ${out("ok", String(ctx.simulator))}`);
     const devServerPort = ctx.watcherPort ?? ctx.devServerPort ?? ctx.metroPort;
-    if (adapter && adapter !== "core" && devServerPort) {
-      parts.push(`${getAdapterSurface(adapter).devServer.label} :${out("ok", String(devServerPort))}`);
+    const surface = adapter ? getAdapterSurface(adapter) : void 0;
+    if (surface && !surface.headless && devServerPort) {
+      parts.push(`${surface.devServer.label} :${out("ok", String(devServerPort))}`);
     }
     if (ctx.gitBranch) parts.push(`branch ${out("info", String(ctx.gitBranch))}`);
     if (parts.length === 0) return null;

package/dist/paths.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { adapterRegistry } from "./adapters/registry.js";
 const runnerDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const pathDefaults = readPathDefaults();
 const DEFAULT_RECIPE_RUNTIME_DIR = pathDefaults.recipeRuntimeDir;
@@ -88,8 +89,13 @@ function isProtocolRoot(candidate) {
   return fs.existsSync(path.join(candidate, "packages/recipe-harness/package.json")) && fs.existsSync(path.join(candidate, "packages/protocol/package.json"));
 }
 function assertAdapter(adapter) {
-  if (adapter !== "mobile" && adapter !== "extension" && adapter !== "core" && adapter !== "terminal") {
-    throw new Error("Adapter must be mobile, extension, core, or terminal.");
+  const ids = adapterRegistry.list();
+  if (ids.length === 0) {
+    throw new Error("internal: no adapters are registered yet; import src/adapters/surface.ts before validating an adapter");
+  }
+  if (typeof adapter !== "string" || !adapterRegistry.has(adapter)) {
+    const choices = ids.length > 1 ? `${ids.slice(0, -1).join(", ")}, or ${ids.at(-1)}` : ids.join("");
+    throw new Error(`Adapter must be ${choices}.`);
   }
 }
 function manifestPath(adapter) {

package/dist/runtime-context.js

@@ -3,6 +3,7 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { getAdapterSurface } from "./adapters/surface.js";
 import { recipeRuntimeDir } from "./paths.js";
 function ensureRuntimeContext(target, adapter) {
   const repoRoot = fs.realpathSync(target);
@@ -91,7 +92,7 @@ function validExistingContext(context, repoRoot, runtimeDir, adapter) {
       if (runtimeStart[field] !== void 0 && (typeof runtimeStart[field] !== "string" || runtimeStart[field].length === 0)) return false;
     }
   }
-  const forbiddenResources = adapter === "core" ? ["cdpPort", "watcherPort", "metroPort", "devServerPort", "simulator", "simulatorUdid", "adbSerial", "extensionId"] : adapter === "extension" ? ["metroPort", "simulator", "simulatorUdid", "adbSerial"] : adapter === "terminal" ? ["metroPort", "simulator", "simulatorUdid", "adbSerial", "extensionId"] : ["cdpPort", "extensionId"];
+  const forbiddenResources = getAdapterSurface(adapter).runtimeContext.forbiddenFields;
   if (forbiddenResources.some((field) => context[field] !== void 0)) return false;
   return true;
 }
@@ -104,11 +105,12 @@ function localDefaults(repoRoot, adapter, existing) {
   const digest = createHash("sha256").update(repoRoot).digest("hex");
   const offset = Number.parseInt(digest.slice(0, 8), 16) % 1e4;
   const defaults = { slotId: `local-${adapter}-${digest.slice(0, 8)}` };
-  if (adapter === "extension" && !numericEnv("RECIPE_CDP_PORT", "CDP_PORT") && !existing.cdpPort) {
-    defaults.cdpPort = claimLocalPort(repoRoot, "cdp", 2e4 + offset);
+  const localPorts = getAdapterSurface(adapter).runtimeContext.localPorts ?? {};
+  if (localPorts.cdp !== void 0 && !numericEnv("RECIPE_CDP_PORT", "CDP_PORT") && !existing.cdpPort) {
+    defaults.cdpPort = claimLocalPort(repoRoot, "cdp", localPorts.cdp + offset);
   }
-  if (adapter !== "core" && adapter !== "terminal" && !numericEnv("WATCHER_PORT", "METRO_PORT", "RECIPE_WATCHER_PORT") && !existing.watcherPort && !existing.metroPort && !existing.devServerPort) {
-    defaults.watcherPort = claimLocalPort(repoRoot, "watcher", (adapter === "extension" ? 3e4 : 4e4) + offset);
+  if (localPorts.watcher !== void 0 && !numericEnv("WATCHER_PORT", "METRO_PORT", "RECIPE_WATCHER_PORT") && !existing.watcherPort && !existing.metroPort && !existing.devServerPort) {
+    defaults.watcherPort = claimLocalPort(repoRoot, "watcher", localPorts.watcher + offset);
   }
   return defaults;
 }
@@ -158,21 +160,14 @@ function portClaimIsLive(claim, port) {
   }
 }
 function runtimeResources(adapter, existing, defaults) {
-  if (adapter === "core") return {};
+  const { resources } = getAdapterSurface(adapter).runtimeContext;
+  if (!resources) return {};
   const watcherPort = numericEnv("WATCHER_PORT", "METRO_PORT", "RECIPE_WATCHER_PORT") ?? existing.watcherPort ?? existing.metroPort ?? existing.devServerPort ?? defaults.watcherPort;
-  const shared = {
+  return {
     watcherPort,
-    devServerPort: watcherPort
+    devServerPort: watcherPort,
+    ...resources({ watcherPort, existing, defaults, envPort: numericEnv })
   };
-  if (adapter === "extension" || adapter === "terminal") {
-    shared.cdpPort = numericEnv("RECIPE_CDP_PORT", "CDP_PORT") ?? existing.cdpPort ?? defaults.cdpPort;
-  } else {
-    shared.metroPort = watcherPort;
-    shared.simulator = process.env.IOS_SIMULATOR || existing.simulator;
-    shared.simulatorUdid = process.env.SIM_UDID || existing.simulatorUdid;
-    shared.adbSerial = process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || existing.adbSerial;
-  }
-  return shared;
 }
 function numericEnv(...names) {
   for (const name of names) {