@deeeed/metamask-harness 0.50.6 → 0.51.1

package/CHANGELOG.md

@@ -2,21 +2,24 @@
 
 ## Unreleased
 
-## 0.50.6 - 2026-09-11
+## 0.51.1 - 2026-09-13
 
 ### Fixed
 
-- Stop every Extension Chrome whose `--user-data-dir` is under this checkout's `temp/recipe/runtime/`, including uniquely named recipe profiles. The previous allow-list of `chrome-profile`, `chrome-profile-recipe`, and `chrome-profile-pw` left leftovers that `mm-harness stop` reported as already stopped. Nested `console-tail.mjs` log paths under that runtime dir are reaped the same way. Personal Chrome and other checkouts stay untouched.
-- Close extra MetaMask home tabs after an Extension browser launch. `open -n` with a start URL against a still-live profile was stacking unlock tabs.
-- Reap every Chrome process that still owns the Extension profile before relaunch, and kill a macOS `open -n` browser that never exposes CDP, so repeated launches cannot stack headed Chrome instances on the same user-data-dir.
-- Keep the Extension Chrome window visible, but restore the previously focused macOS app through Launch Services while Chrome starts so the window does not come to the front or take the keyboard. System Events hangs during that activation, so osascript restore cannot hold focus.
+- Mobile native builds run `expo run:ios` / `run:android` with `--no-bundler` (and without `--port`, which Expo refuses next to it): the harness owns Metro on the watcher port, and Expo's post-build port re-check (lsof under a 350 ms budget) aborted a successful 45-minute build on a loaded machine with "Port became busy running another process while the app was compiling".
+- Mobile `verify` waits for the React Native bridge to settle (bounded, best effort) before its live smoke, so a checkout is no longer reported not ready when the app is still hydrating right after a launch or a fixture unlock. `mm-harness prepare` on a fresh full slot build had failed at the final `verify` step this way while a retry a minute later passed.
+## 0.51.0 - 2026-09-13
 
-## 0.50.5 - 2026-09-10
+### Added
 
-### Fixed
+- `mm-harness task init` writes the task directory (task document, checklist, mark shim, and inputs) from a shared execution template, with the MetaMask surface, harness-gated mark command, and detected platform applied by default.
+- `mm-harness prepare` runs the readiness chain for a checkout (`doctor --fix`, `status`, launch, fixtures, `verify`), stops at the first failure, and records one readiness record at `<artifacts-dir>/sandbox.json` with a per-step report.
+
+### Changed
 
-- Avoid disabling and re-enabling the Extension after a fresh browser launch, which could cause `No SW` storage errors in reused wallet profiles. Keep build handoff for updates in an already-running browser.
-- Keep the previously focused macOS app in front while Chrome starts, instead of restoring only after CDP is up. Do not let caffeinate declare user activity during that launch.
+- Pin the getting-started iOS simulator to the checkout runtime file, and stop the setup prompt from auto-creating a disposable wallet.
+- Resolve the checklist a mark targets through the agent runtime: a missing `checklist-target.json` now means the default checklist and signal instead of silently disabling the terminal-signal guard, and an invalid one raises its own error.
+- Require `@farmslot/agent-runtime` 0.9.0 and `@farmslot/protocol` 0.26.0.
 
 ## 0.50.4 - 2026-09-10
 

package/README.md

@@ -121,6 +121,37 @@ Mobile and Extension recipes can bracket explicit UI-smoothness windows with
 `app.performance_assert`. Capture is never automatic. See
 [UI smoothness capture](docs/PERFORMANCE-CAPTURE.md).
 
+## Work a task
+
+```bash
+# Pick a checklist from the shared catalog.
+mm-harness execution-template list --package-templates <catalog> --json
+
+# Write the task directory the agent works from.
+mm-harness task init temp/tasks/fix/TAT-1 \
+  --flow fix-bug --run-mode autonomous --template fix-bug/autonomous.mobile \
+  --package-templates <catalog> --title "Wrong total on the receipt" --ticket TAT-1
+
+# Bring the checkout to a proven-ready state before the first step.
+mm-harness prepare --artifacts-dir temp/tasks/fix/TAT-1/artifacts --json
+
+# Mark progress; the task's own ./mark shim routes here.
+mm-harness checklist mark temp/tasks/fix/TAT-1 start
+mm-harness checklist mark temp/tasks/fix/TAT-1 1
+mm-harness checklist mark temp/tasks/fix/TAT-1 complete --mark-last
+```
+
+`task init` writes `TASK.md`, `CHECKLIST.md`, the `mark` shim, and `inputs/`.
+`CHECKLIST.md` is the only file whose boxes count as steps. It writes no
+`checklist-target.json`; absent means `CHECKLIST.md` + `SIGNAL.json`.
+
+`prepare` runs `doctor --fix`, `status`, `launch --verify`, `fixtures set`, and
+`verify` in order, stops at the first failure, and records one readiness record
+at `<artifacts-dir>/sandbox.json`. Core skips launch and fixtures; Mobile takes
+`ios`/`android` from the checkout's configured target, then from the devices
+`status` reports, and asks when that is ambiguous. Exit 0 means
+ready. See [the task directory](site/task-dir.html).
+
 ## Discover and prove
 
 ```bash

package/adapters/extension/ensure-browser.sh

@@ -301,8 +301,7 @@ const {
   runtimeIdentityArgs,
   writeRuntimeIdentity,
 } = require(path.join('${SCRIPT_DIR}', 'lib/chrome-args.cjs'));
-const { captureMacFrontmost, macBackgroundOpenArgs, preserveMacFrontmost, startMacFocusHold, stopMacFocusHold } = require(path.join('${SCRIPT_DIR}', 'lib/macos-focus.cjs'));
-const { stopProfileProcessesSync } = require(path.join('${SCRIPT_DIR}', 'lib/validation-process-ownership.cjs'));
+const { captureMacFrontmostProcess, restoreMacFrontmostProcess } = require(path.join('${SCRIPT_DIR}', 'lib/macos-focus.cjs'));
 
 const SLOT_ID = '${SLOT_ID}';
 const AGENT_DIR = '${AGENT_DIR}';
@@ -323,13 +322,6 @@ const resumeWebpack = () => {
   if (WEBPACK_PID) { try { process.kill(-Number(WEBPACK_PID), 'SIGCONT'); } catch { try { process.kill(Number(WEBPACK_PID), 'SIGCONT'); } catch {} } }
 };
 
-const previousFrontmost = captureMacFrontmost();
-let focusHold = null;
-const releaseFocusHold = () => {
-  stopMacFocusHold(focusHold);
-  preserveMacFrontmost(previousFrontmost);
-};
-
 (async () => {
   const runtimeNonce = createRuntimeIdentityNonce();
   const startedAt = Date.now();
@@ -352,8 +344,8 @@ const releaseFocusHold = () => {
   }
 
   const chromiumApp = path.dirname(path.dirname(path.dirname(chromium.executablePath())));
-  focusHold = startMacFocusHold(previousFrontmost);
-  execFileSync('open', macBackgroundOpenArgs(chromiumApp, args), { stdio: 'ignore' });
+  const previousFrontmostPid = captureMacFrontmostProcess();
+  execFileSync('open', ['-g', '-n', '-a', chromiumApp, '--args', ...args], { stdio: 'ignore' });
   for (let i = 0; i < 60; i++) {
     try {
       const version = await new Promise((resolve, reject) => {
@@ -404,7 +396,6 @@ const releaseFocusHold = () => {
     } catch {}
   }
   if (!browserPid) {
-    stopProfileProcessesSync(PROFILE, { waitForAppearanceMs: 400 });
     throw new Error(
       'Reopened Chrome did not expose an owned CDP listener on port ' + CDP_PORT +
       '. Next: inspect the slot browser process, then rerun: mm-harness launch --adapter extension --build'
@@ -437,12 +428,11 @@ const releaseFocusHold = () => {
   try {
     extId = execFileSync(RUNNER_BIN, ['resolve-extension', '--adapter', 'extension', '--target', REPO], { encoding: 'utf8' }).trim();
   } catch (err) {
-    releaseFocusHold();
     resumeWebpack();
     console.error('[FAIL] runner resolve-extension failed: ' + (err && err.message ? err.message : String(err)));
     process.exit(1);
   }
-  if (!/^[a-p]{32}$/.test(extId)) { releaseFocusHold(); resumeWebpack(); console.error('[FAIL] runner returned invalid extension id: ' + JSON.stringify(extId)); process.exit(1); }
+  if (!/^[a-p]{32}$/.test(extId)) { resumeWebpack(); console.error('[FAIL] runner returned invalid extension id: ' + JSON.stringify(extId)); process.exit(1); }
   console.log('[reopen] Extension: ' + extId + ' (via runner resolve-extension)');
 
   // Navigate to MetaMask home
@@ -508,10 +498,8 @@ const releaseFocusHold = () => {
   if (process.env.MM_HARNESS_FOCUS_BROWSER === '1') {
     await page.bringToFront().catch(() => {});
   } else {
-    await new Promise(r => setTimeout(r, 1000));
-    preserveMacFrontmost(previousFrontmost);
+    restoreMacFrontmostProcess(previousFrontmostPid);
   }
-  releaseFocusHold();
 
   fs.writeFileSync(path.join(AGENT_DIR, 'extension.id'), extId);
   console.log('[reopen] Ready \u2014 ' + SLOT_ID + (CDP_PORT ? ' CDP:' + CDP_PORT : ''));
@@ -521,7 +509,6 @@ const releaseFocusHold = () => {
   if (WEBPACK_PID) console.log('[webpack] Resumed');
   process.exit(0);
 })().catch(e => {
-  releaseFocusHold();
   resumeWebpack();
   try { removeRuntimeIdentity(AGENT_DIR); } catch {}
   try { fs.unlinkSync(path.join(AGENT_DIR, 'browser.pid')); } catch {}

package/adapters/extension/launch-browser.cjs

@@ -24,7 +24,7 @@ const os = require('node:os');
 const path = require('node:path');
 const { execFileSync, spawn, spawnSync } = require('node:child_process');
 const { extensionIdFromExtensionDir } = require('./lib/extension-id.cjs');
-const { profileProcessPids, stopProfileProcessesSync } = require('./lib/validation-process-ownership.cjs');
+const { profileProcessPids } = require('./lib/validation-process-ownership.cjs');
 const { acquireBuildHandoff } = require('./build-handoff.cjs');
 const {
   automationRuntimeArgs,
@@ -42,13 +42,7 @@ const {
   validationLaunchQuarantineError,
   writeRuntimeIdentity,
 } = require('./lib/chrome-args.cjs');
-const {
-  captureMacFrontmost,
-  macBackgroundOpenArgs,
-  preserveMacFrontmost,
-  startMacFocusHold,
-  stopMacFocusHold,
-} = require('./lib/macos-focus.cjs');
+const { captureMacFrontmostProcess, restoreMacFrontmostProcess } = require('./lib/macos-focus.cjs');
 
 if (process.argv.includes('--help') || process.argv.includes('-h')) {
   console.log(
@@ -113,7 +107,7 @@ try {
       'Next: remove the invalid runtime identity and fix owner permissions, then rerun: mm-harness launch --adapter extension --build',
   );
 }
-stopProfileProcessesSync(args.profile, { extraPids: [...ownedPids] });
+terminatePids([...ownedPids]);
 if (args['reset-profile'] !== undefined) {
   fs.rmSync(args.profile, { recursive: true, force: true });
   fs.mkdirSync(args.profile, { recursive: true });
@@ -170,83 +164,70 @@ const chromeArgs = [
   initialUrl,
 ];
 const logFd = fs.openSync(args['chrome-log'], 'a');
-const previousFrontmost = captureMacFrontmost();
-const focusHold = startMacFocusHold(previousFrontmost);
+const previousFrontmostPid = captureMacFrontmostProcess();
 let browserPid;
 try {
-  try {
-    const application = process.platform === 'darwin' ? macApplicationForExecutable(args['chrome-bin']) : null;
-    if (application) {
-      beginDetachedLaunch(cdpPort, args.profile, activeValidationLease);
-      execFileSync('open', macBackgroundOpenArgs(application, chromeArgs), {
-        env: sanitizedChildEnv(),
-        stdio: ['ignore', logFd, logFd],
-      });
-      browserPid = waitForOwnedCdpPid(cdpPort, args.profile, args['extension-dir']);
-      if (browserPid === null) {
-        stopProfileProcessesSync(args.profile, { waitForAppearanceMs: 400 });
-        throw new Error(
-          `Chrome launched but did not expose an owned CDP listener on 127.0.0.1:${cdpPort}. ` +
-            `Next: inspect ${args['chrome-log']}, then rerun: mm-harness launch --adapter extension --build`,
-        );
-      }
-    } else {
-      beginDetachedLaunch(cdpPort, args.profile, activeValidationLease);
-      const child = spawn(args['chrome-bin'], chromeArgs, {
-        detached: true,
-        env: sanitizedChildEnv(),
-        stdio: ['ignore', logFd, logFd],
-      });
-      child.unref();
-      browserPid = waitForOwnedCdpPid(cdpPort, args.profile, args['extension-dir']);
-      if (browserPid === null) {
-        stopProfileProcessesSync(args.profile, { extraPids: child.pid ? [child.pid] : [] });
-        throw new Error(
-          `Chrome launched but did not expose an owned CDP listener on 127.0.0.1:${cdpPort}. ` +
-            `Next: inspect ${args['chrome-log']}, then rerun: mm-harness launch --adapter extension --build`,
-        );
-      }
-    }
-    pruneExtraHomeTabs(cdpPort, args['extension-dir']);
-  } finally {
-    fs.closeSync(logFd);
-  }
-  fs.writeFileSync(args['chrome-pid'], `${browserPid}\n`);
-  try {
-    writeRuntimeIdentity(runtimeDir, {
-      port: cdpPort,
-      pid: browserPid,
-      startedAt,
-      nonce: runtimeNonce,
+  const application = process.platform === 'darwin' ? macApplicationForExecutable(args['chrome-bin']) : null;
+  if (application) {
+    beginDetachedLaunch(cdpPort, args.profile, activeValidationLease);
+    execFileSync('open', ['-g', '-n', '-a', application, '--args', ...chromeArgs], {
+      env: sanitizedChildEnv(),
+      stdio: ['ignore', logFd, logFd],
     });
-    clearDetachedLaunchUnproven(args.profile);
-    if (!activeValidationLease) {
-      clearValidationPortQuarantine(cdpPort, args.profile);
+    browserPid = waitForOwnedCdpPid(cdpPort, args.profile, args['extension-dir']);
+    if (browserPid === null) {
+      throw new Error(`Chrome launched but did not expose CDP on 127.0.0.1:${cdpPort}`);
     }
-  } catch (error) {
-    terminatePids([browserPid]);
-    fs.rmSync(args['chrome-pid'], { force: true });
-    const detail = error instanceof Error ? error.message : String(error);
-    throw new Error(
-      `Failed to persist Extension runtime identity under ${runtimeDir}: ${detail}. ` +
-        'Next: fix owner write permissions for the runtime directory, then rerun: mm-harness launch --adapter extension --build',
-    );
-  }
-  if (process.platform === 'darwin') {
-    const wake = spawn('caffeinate', ['-dims', '-w', String(browserPid)], {
+  } else {
+    beginDetachedLaunch(cdpPort, args.profile, activeValidationLease);
+    const child = spawn(args['chrome-bin'], chromeArgs, {
       detached: true,
-      stdio: 'ignore',
+      env: sanitizedChildEnv(),
+      stdio: ['ignore', logFd, logFd],
     });
-    wake.unref();
-    // Chrome often activates when the first window paints, which can be after CDP
-    // is already listening. Keep the previous app frontmost through that paint.
-    const settleMs = Number(process.env.MM_HARNESS_FOCUS_SETTLE_MS);
-    const waitSec = Number.isFinite(settleMs) && settleMs >= 0 ? settleMs / 1000 : 1;
-    if (waitSec > 0) spawnSync('sleep', [String(waitSec)]);
+    child.unref();
+    browserPid = waitForOwnedCdpPid(cdpPort, args.profile, args['extension-dir']);
+    if (browserPid === null) {
+      if (child.pid) terminatePids([child.pid]);
+      throw new Error(
+        `Chrome launched but did not expose an owned CDP listener on 127.0.0.1:${cdpPort}. ` +
+          `Next: inspect ${args['chrome-log']}, then rerun: mm-harness launch --adapter extension --build`,
+      );
+    }
   }
 } finally {
-  stopMacFocusHold(focusHold);
-  preserveMacFrontmost(previousFrontmost);
+  fs.closeSync(logFd);
+}
+fs.writeFileSync(args['chrome-pid'], `${browserPid}\n`);
+try {
+  writeRuntimeIdentity(runtimeDir, {
+    port: cdpPort,
+    pid: browserPid,
+    startedAt,
+    nonce: runtimeNonce,
+  });
+  clearDetachedLaunchUnproven(args.profile);
+  if (!activeValidationLease) {
+    clearValidationPortQuarantine(cdpPort, args.profile);
+  }
+} catch (error) {
+  terminatePids([browserPid]);
+  fs.rmSync(args['chrome-pid'], { force: true });
+  const detail = error instanceof Error ? error.message : String(error);
+  throw new Error(
+    `Failed to persist Extension runtime identity under ${runtimeDir}: ${detail}. ` +
+      'Next: fix owner write permissions for the runtime directory, then rerun: mm-harness launch --adapter extension --build',
+  );
+}
+if (process.platform === 'darwin') {
+  const wake = spawn('caffeinate', ['-dimsu', '-w', String(browserPid)], {
+    detached: true,
+    stdio: 'ignore',
+  });
+  wake.unref();
+}
+if (process.env.MM_HARNESS_FOCUS_BROWSER !== '1') {
+  restoreMacFrontmostProcess(previousFrontmostPid);
 }
 
 function sanitizedChildEnv() {
@@ -445,64 +426,3 @@ function extensionHomeUrl(extensionDir) {
   const id = extensionIdFromExtensionDir(extensionDir);
   return id ? `chrome-extension://${id}/home.html` : '';
 }
-
-function cdpHttp(port, pathname) {
-  const result = spawnSync(process.execPath, ['-e', `
-    const http = require('http');
-    http.get('http://127.0.0.1:${Number(port)}${pathname}', (res) => {
-      let body = '';
-      res.on('data', (chunk) => { body += chunk; });
-      res.on('end', () => process.stdout.write(body));
-    }).on('error', () => process.exit(1));
-  `], { encoding: 'utf8', timeout: 4000 });
-  if (result.status !== 0) return null;
-  return result.stdout;
-}
-
-function pruneExtraHomeTabs(port, extensionDir) {
-  const id = extensionIdFromExtensionDir(extensionDir);
-  const raw = cdpHttp(port, '/json/list');
-  if (!id || !raw) return;
-  let targets;
-  try {
-    targets = JSON.parse(raw);
-  } catch {
-    return;
-  }
-  if (!Array.isArray(targets)) return;
-  const homes = targets.filter((target) => (
-    target &&
-    target.type === 'page' &&
-    typeof target.id === 'string' &&
-    typeof target.url === 'string' &&
-    target.url.includes(`chrome-extension://${id}/`) &&
-    target.url.includes('/home.html')
-  ));
-  const strays = targets.filter((target) => (
-    target &&
-    target.type === 'page' &&
-    typeof target.id === 'string' &&
-    typeof target.url === 'string' &&
-    (
-      target.url === 'about:blank' ||
-      target.url === 'chrome://newtab/' ||
-      target.url.startsWith('chrome://new-tab-page')
-    )
-  ));
-  if (homes.length === 0) return;
-  const keeper = homes.find((target) => (
-    typeof target.title === 'string' &&
-    target.title.trim() !== '' &&
-    target.title.trim() !== 'MetaMask'
-  )) ?? homes[0];
-  if (homes.length > 1) {
-    for (const extra of homes) {
-      if (keeper && extra.id === keeper.id) continue;
-      cdpHttp(port, `/json/close/${extra.id}`);
-    }
-  }
-  for (const stray of strays) {
-    if (keeper && stray.id === keeper.id) continue;
-    cdpHttp(port, `/json/close/${stray.id}`);
-  }
-}

package/adapters/extension/lib/macos-focus.cjs

@@ -1,197 +1,32 @@
 'use strict';
 
-const { execFileSync, spawn } = require('node:child_process');
-
-const HOLD_INTERVAL_MS = 20;
-const toolEnv = () => ({ ...process.env });
-
-function captureMacFrontmost() {
-  if (process.platform !== 'darwin') return null;
-  try {
-    const asn = execFileSync('lsappinfo', ['front'], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }).trim();
-    if (!asn) return null;
-    return parseLsappinfo(execFileSync('lsappinfo', ['info', asn], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }));
-  } catch {
-    return null;
-  }
-}
+const { execFileSync } = require('node:child_process');
 
 function captureMacFrontmostProcess() {
-  return captureMacFrontmost()?.pid ?? null;
-}
-
-function parseLsappinfo(info) {
-  const pid = Number.parseInt((info.match(/\bpid\s*=\s*(\d+)/u) || info.match(/"pid"=(\d+)/u) || [])[1], 10);
-  const bundlePath = (info.match(/bundle path="([^"]+)"/u) || info.match(/"LSBundlePath"="([^"]+)"/u) || [])[1];
-  const name = (info.match(/^"([^"]+)"/mu) || info.match(/"LSDisplayName"="([^"]+)"/u) || [])[1];
-  if (!Number.isInteger(pid) || pid <= 0 || !bundlePath) return null;
-  return { pid, bundlePath, name: name || bundlePath };
-}
-
-function currentFrontmostPid() {
+  if (process.platform !== 'darwin') return null;
   try {
-    const asn = execFileSync('lsappinfo', ['front'], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }).trim();
-    if (!asn) return null;
-    const value = execFileSync('lsappinfo', ['info', '-only', 'pid', asn], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }).trim();
-    const pid = Number.parseInt((value.match(/"pid"=(\d+)/u) || [])[1], 10);
+    const value = execFileSync('osascript', [
+      '-e',
+      'tell application "System Events" to get unix id of first application process whose frontmost is true',
+    ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 1_000 }).trim();
+    const pid = Number.parseInt(value, 10);
     return Number.isInteger(pid) && pid > 0 ? pid : null;
   } catch {
     return null;
   }
 }
 
-function restoreMacFrontmost(target) {
-  if (process.platform !== 'darwin' || !target?.bundlePath) return false;
-  try {
-    execFileSync('open', ['-a', target.bundlePath], {
-      env: toolEnv(),
-      stdio: 'ignore',
-      timeout: 500,
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 function restoreMacFrontmostProcess(pid) {
   if (process.platform !== 'darwin' || !Number.isInteger(pid) || pid <= 0) return false;
   try {
-    const asn = execFileSync('lsappinfo', ['find', `pid=${pid}`], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }).trim();
-    if (!asn) return false;
-    return restoreMacFrontmost(parseLsappinfo(execFileSync('lsappinfo', ['info', asn], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    })));
-  } catch {
-    return false;
-  }
-}
-
-function preserveMacFrontmost(target) {
-  if (process.env.MM_HARNESS_FOCUS_BROWSER === '1') return false;
-  if (process.platform !== 'darwin' || !target?.bundlePath || !Number.isInteger(target.pid) || target.pid <= 0) {
-    return false;
-  }
-  const current = currentFrontmostPid();
-  if (current === target.pid) return true;
-  return restoreMacFrontmost(target);
-}
-
-function preserveMacFrontmostProcess(pid) {
-  if (process.env.MM_HARNESS_FOCUS_BROWSER === '1') return false;
-  if (!Number.isInteger(pid) || pid <= 0) return false;
-  const current = currentFrontmostPid();
-  if (current === pid) return true;
-  return restoreMacFrontmostProcess(pid);
-}
-
-function macBackgroundOpenArgs(application, chromeArgs) {
-  return ['-g', '-n', '-a', application, '--args', ...chromeArgs];
-}
-
-function startMacFocusHold(targetOrPid) {
-  if (process.env.MM_HARNESS_FOCUS_BROWSER === '1') return null;
-  if (process.platform !== 'darwin') return null;
-  const target = typeof targetOrPid === 'number'
-    ? { pid: targetOrPid, bundlePath: bundlePathForPid(targetOrPid) }
-    : targetOrPid;
-  if (!target?.bundlePath || !Number.isInteger(target.pid) || target.pid <= 0) return null;
-  return spawn(process.execPath, [
-    __filename,
-    '--hold',
-    String(target.pid),
-    target.bundlePath,
-    String(process.pid),
-  ], { stdio: 'ignore', env: toolEnv() });
-}
-
-function bundlePathForPid(pid) {
-  try {
-    const asn = execFileSync('lsappinfo', ['find', `pid=${pid}`], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }).trim();
-    return parseLsappinfo(execFileSync('lsappinfo', ['info', asn], {
-      encoding: 'utf8',
-      env: toolEnv(),
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: 200,
-    }))?.bundlePath ?? null;
-  } catch {
-    return null;
-  }
-}
-
-function stopMacFocusHold(child) {
-  if (!child || !Number.isInteger(child.pid) || child.pid <= 0) return;
-  try {
-    process.kill(child.pid, 'SIGTERM');
-  } catch (error) {
-    if (error.code !== 'ESRCH') throw error;
-  }
-}
-
-function parentAlive(pid) {
-  if (!Number.isInteger(pid) || pid <= 0) return false;
-  try {
-    process.kill(pid, 0);
+    execFileSync('osascript', [
+      '-e',
+      `tell application "System Events" to set frontmost of first application process whose unix id is ${pid} to true`,
+    ], { stdio: 'ignore', timeout: 1_000 });
     return true;
   } catch {
     return false;
   }
 }
 
-if (require.main === module && process.argv[2] === '--hold') {
-  const pid = Number.parseInt(process.argv[3], 10);
-  const bundlePath = process.argv[4];
-  const parentPid = Number.parseInt(process.argv[5], 10);
-  const target = { pid, bundlePath };
-  const hold = () => {
-    if (!parentAlive(parentPid)) process.exit(0);
-    preserveMacFrontmost(target);
-  };
-  hold();
-  setInterval(hold, HOLD_INTERVAL_MS);
-}
-
-module.exports = {
-  captureMacFrontmost,
-  captureMacFrontmostProcess,
-  macBackgroundOpenArgs,
-  preserveMacFrontmost,
-  preserveMacFrontmostProcess,
-  restoreMacFrontmost,
-  restoreMacFrontmostProcess,
-  startMacFocusHold,
-  stopMacFocusHold,
-};
+module.exports = { captureMacFrontmostProcess, restoreMacFrontmostProcess };

package/adapters/extension/lib/validation-process-ownership.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const { execFileSync, spawnSync } = require('node:child_process');
+const { execFileSync } = require('node:child_process');
 
 function commandHasExactProfile(command, profile) {
   const expected = `--user-data-dir=${profile}`;
@@ -43,53 +43,6 @@ function delay(milliseconds) {
   return new Promise((resolve) => setTimeout(resolve, milliseconds));
 }
 
-function pidAlive(pid) {
-  if (!Number.isInteger(pid) || pid <= 0) return false;
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error) {
-    if (error.code === 'ESRCH') return false;
-    throw error;
-  }
-}
-
-function uniquePids(pids) {
-  return [...new Set(pids)].filter((pid) => Number.isInteger(pid) && pid > 0 && pid !== process.pid);
-}
-
-// Reap every live process that still owns this profile, then refuse to continue
-// if any survive. `open -n` otherwise starts a second headed Chrome on the same
-// user-data-dir while the previous instance is still dying.
-function stopProfileProcessesSync(profile, { extraPids = [], timeoutMs = 5_000, waitForAppearanceMs = 0 } = {}) {
-  const deadline = Date.now() + timeoutMs;
-  const appearUntil = Date.now() + Math.max(0, waitForAppearanceMs);
-  let ownersSince = 0;
-  while (Date.now() < deadline) {
-    const pids = uniquePids([
-      ...profileProcessPids(profile),
-      ...extraPids.filter(pidAlive),
-    ]);
-    if (pids.length === 0) {
-      if (Date.now() >= appearUntil) return;
-    } else {
-      if (ownersSince === 0) ownersSince = Date.now();
-      signalPids(pids, Date.now() - ownersSince >= 500 ? 'SIGKILL' : 'SIGTERM');
-    }
-    spawnSync('sleep', ['0.1']);
-  }
-  const remaining = uniquePids([
-    ...profileProcessPids(profile),
-    ...extraPids.filter(pidAlive),
-  ]);
-  if (remaining.length > 0) {
-    throw new Error(
-      `Owned Chrome processes survived stop (pid ${remaining.join(', ')}). ` +
-        'Next: mm-harness stop --adapter extension --target <checkout>',
-    );
-  }
-}
-
 async function stopProfileProcesses(profile, { quietMs = 0, timeoutMs = 5_000 } = {}) {
   const deadline = Date.now() + timeoutMs;
   let quietSince = Date.now();
@@ -113,4 +66,4 @@ async function stopProfileProcesses(profile, { quietMs = 0, timeoutMs = 5_000 }
   throw new Error(`Extension validation profile did not remain quiescent for ${quietMs}ms.`);
 }
 
-module.exports = { profileProcessPids, stopProfileProcesses, stopProfileProcessesSync };
+module.exports = { profileProcessPids, stopProfileProcesses };