@deeeed/metamask-harness 0.6.3 → 0.7.0

package/adapters/shared/resolve-farmslot-ports-core.mjs

@@ -1,205 +1,3 @@
-// Farmslot pool + slot-suffix port resolution — pure JS for runner and overlay leaves.
-
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const coreDir = path.dirname(fileURLToPath(import.meta.url));
-
-function pathDefault(key) {
-  for (const candidate of [
-    path.join(coreDir, 'path-defaults.json'),
-    path.join(coreDir, '../../adapters/shared/path-defaults.json'),
-  ]) {
-    if (!fs.existsSync(candidate)) continue;
-    const value = JSON.parse(fs.readFileSync(candidate, 'utf8'))[key];
-    if (value) return value;
-  }
-  throw new Error(`Missing path default: ${key}`);
-}
-
-function recipeRuntimeDir() {
-  return process.env.RECIPE_RUNTIME_DIR || pathDefault('recipeRuntimeDir');
-}
-
-export function formatKvLines(kv) {
-  const lines = [];
-  if (kv.CDP_PORT !== undefined) lines.push(`CDP_PORT=${kv.CDP_PORT}`);
-  if (kv.WATCHER_PORT !== undefined) lines.push(`WATCHER_PORT=${kv.WATCHER_PORT}`);
-  if (kv.SLOT_ID) lines.push(`SLOT_ID=${kv.SLOT_ID}`);
-  if (kv.IOS_SIMULATOR) lines.push(`IOS_SIMULATOR=${kv.IOS_SIMULATOR}`);
-  return lines.length ? `${lines.join('\n')}\n` : '';
-}
-
-export function realRepoPath(repo) {
-  if (!repo) return null;
-  try {
-    return fs.realpathSync(repo);
-  } catch {
-    return null;
-  }
-}
-
-export function inferSlotSuffix(repo) {
-  const base = path.basename(repo);
-  const m = /-(\d+)$/u.exec(base);
-  return m ? m[1] : null;
-}
-
-function scoreSlot(slot, slotSuffix) {
-  const resources = slot.resources ?? {};
-  const cdp = resources.browser?.cdp_port;
-  const port = resources['dev-server']?.port;
-  const simulator = resources['ios-sim']?.simulator;
-  const session = slot.session ?? '';
-  const slotId = slot.id ?? '';
-  let score = 0;
-  if (cdp !== undefined) score += 100;
-  if (port !== undefined) score += 10;
-  if (slotSuffix) {
-    if (session === `mme-${slotSuffix}`) score += 50;
-    if (slotId.endsWith(`mme-${slotSuffix}`) || slotId.includes(`-mme-${slotSuffix}`)) score += 40;
-  }
-  if (!slotId.toLowerCase().includes('demo')) score += 5;
-  return [score, cdp, port, slotId, simulator];
-}
-
-export function resolveFarmslotPortsByRepo(repo) {
-  const realRepo = realRepoPath(repo);
-  if (!realRepo) return null;
-
-  const slotSuffix = inferSlotSuffix(realRepo);
-  const roots = [];
-  // A slot checkout lives at <workspace>/repos/<slot>; that workspace's own
-  // pool is the authoritative one for this repo — machine-global fallbacks
-  // (env root, dev checkout) apply only when the repo is not workspace-shaped.
-  if (path.basename(path.dirname(realRepo)) === 'repos') {
-    roots.push(path.join(path.dirname(path.dirname(realRepo)), 'farmslot'));
-  }
-  if (process.env.FARMSLOT_ROOT) roots.push(process.env.FARMSLOT_ROOT);
-  roots.push(path.join(os.homedir(), 'dev', 'farmslot'));
-
-  for (const root of roots) {
-    if (!root || !fs.existsSync(path.join(root, 'pool'))) continue;
-    const poolDir = path.join(root, 'pool');
-    let best = null;
-
-    for (const name of fs.readdirSync(poolDir).sort()) {
-      if (!name.endsWith('.json') || name.includes('.bak.')) continue;
-      let data;
-      try {
-        data = JSON.parse(fs.readFileSync(path.join(poolDir, name), 'utf8'));
-      } catch {
-        continue;
-      }
-      for (const slot of data.slots ?? []) {
-        const slotRepo = slot.repo ?? '';
-        if (!slotRepo) continue;
-        let slotReal;
-        try {
-          slotReal = fs.realpathSync(slotRepo);
-        } catch {
-          continue;
-        }
-        if (slotReal !== realRepo) continue;
-        const scored = scoreSlot(slot, slotSuffix);
-        if (!best || scored[0] > best[0]) best = scored;
-      }
-    }
-
-    if (best) {
-      const [, cdp, port, slotId, simulator] = best;
-      return formatKvLines({
-        ...(cdp !== undefined ? { CDP_PORT: cdp } : {}),
-        ...(port !== undefined ? { WATCHER_PORT: port } : {}),
-        ...(slotId ? { SLOT_ID: slotId } : {}),
-        ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
-      });
-    }
-  }
-  return null;
-}
-
-export function resolveDefaultExtensionPorts(repo) {
-  const n = inferSlotSuffix(repo);
-  if (!n) return null;
-  return formatKvLines({
-    CDP_PORT: 6660 + Number(n),
-    WATCHER_PORT: 9010 + Number(n),
-    SLOT_ID: `local-extension-${n}`,
-  });
-}
-
-export function resolveExtensionRuntimePorts(repo) {
-  return resolveFarmslotPortsByRepo(repo) ?? resolveDefaultExtensionPorts(repo) ?? '';
-}
-
-export function resolveMobileSlotDefaults(repo) {
-  const n = inferSlotSuffix(repo);
-  if (!n) return null;
-  return formatKvLines({
-    WATCHER_PORT: 8060 + Number(n),
-    IOS_SIMULATOR: `mm-${n}`,
-    SLOT_ID: `local-mobile-${n}`,
-  });
-}
-
-export function resolveMobileRuntimeContext(repo) {
-  const ctxPath = path.join(repo, recipeRuntimeDir(), 'agentic-runtime.json');
-  if (fs.existsSync(ctxPath)) {
-    try {
-      const c = JSON.parse(fs.readFileSync(ctxPath, 'utf8'));
-      if (c.simulator || (c.metroPort != null && c.metroPort !== '')) {
-        return formatKvLines({
-          ...(c.metroPort != null && c.metroPort !== '' ? { WATCHER_PORT: c.metroPort } : {}),
-          ...(c.simulator ? { IOS_SIMULATOR: c.simulator } : {}),
-          ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
-        });
-      }
-    } catch {
-      /* unreadable context falls through to the provision baseline */
-    }
-  }
-  return resolveMobileProvisionBaseline(repo);
-}
-
-// A provisioned-but-unprepared slot has no agentic-runtime.json yet, but the
-// provision baseline records the same authoritative simulator/port identity —
-// without it, a fresh slot's first launch degrades to the simctl `booted`
-// alias and misses the installed dev client entirely.
-function resolveMobileProvisionBaseline(repo) {
-  const basePath = path.join(repo, recipeRuntimeDir(), 'runway-provision.json');
-  if (!fs.existsSync(basePath)) return null;
-  try {
-    const c = JSON.parse(fs.readFileSync(basePath, 'utf8'));
-    const simulator = c.simulator?.name || c.simulator?.udid;
-    const watcherPort = c.watcherPort != null && c.watcherPort !== '' ? c.watcherPort : undefined;
-    if (!simulator && watcherPort === undefined) return null;
-    return formatKvLines({
-      ...(watcherPort !== undefined ? { WATCHER_PORT: watcherPort } : {}),
-      ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
-      ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
-    });
-  } catch {
-    return null;
-  }
-}
-
-export function resolveMobileRuntimePorts(repo) {
-  return (
-    resolveMobileRuntimeContext(repo)
-    ?? resolveFarmslotPortsByRepo(repo)
-    ?? resolveMobileSlotDefaults(repo)
-    ?? ''
-  );
-}
-
-export const cliFns = {
-  resolve_farmslot_ports_by_repo: resolveFarmslotPortsByRepo,
-  resolve_default_extension_ports: resolveDefaultExtensionPorts,
-  resolve_extension_runtime_ports: (repo) => resolveExtensionRuntimePorts(repo) || null,
-  resolve_mobile_runtime_context: resolveMobileRuntimeContext,
-  resolve_mobile_slot_defaults: resolveMobileSlotDefaults,
-  resolve_mobile_runtime_ports: (repo) => resolveMobileRuntimePorts(repo) || null,
-};
+// Back-compat shim: the port-resolution core is now resolve-slot-ports-core.mjs.
+// Re-exports it verbatim for one release so importers of the old path keep resolving.
+export * from './resolve-slot-ports-core.mjs';

package/adapters/shared/resolve-farmslot-ports.mjs

@@ -1,20 +1,5 @@
 #!/usr/bin/env node
-// Node leaf for port resolution — self-contained for runner and injected overlay copies.
-
-import { cliFns } from './resolve-farmslot-ports-core.mjs';
-
-const [, , fn, repo] = process.argv;
-if (!fn || fn === '-h' || fn === '--help') {
-  process.stderr.write('Usage: resolve-farmslot-ports.mjs <fn> <repo>\n');
-  process.exit(fn ? 0 : 2);
-}
-
-const handler = cliFns[fn];
-if (!handler) {
-  process.stderr.write(`resolve-farmslot-ports: unknown fn: ${fn}\n`);
-  process.exit(2);
-}
-
-const out = handler(repo ?? '.');
-if (!out?.trim()) process.exit(1);
-process.stdout.write(out.endsWith('\n') ? out : `${out}\n`);
+// Back-compat shim: this leaf is now resolve-slot-ports.mjs. Delegates to it for one
+// release so `node resolve-farmslot-ports.mjs <fn> <repo>` keeps working (the new CLI
+// reads the same argv positions on import).
+import './resolve-slot-ports.mjs';

package/adapters/shared/resolve-farmslot-ports.sh

@@ -1,105 +1,7 @@
 #!/usr/bin/env bash
-# resolve-farmslot-ports.sh — bash-compat wrapper over resolve-farmslot-ports.mjs
-#
-# Farmslot pool JSON is authoritative when a slot repo matches; otherwise fall back
-# to the local-extension-N formula (6660+N / 9010+N).
-#
-# Usage:
-#   . resolve-farmslot-ports.sh
-#   resolve_extension_runtime_ports /path/to/metamask-extension-N
-#     -> prints CDP_PORT=... WATCHER_PORT=... SLOT_ID=... lines
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-_RESOLVE_PORTS_MJS="$SCRIPT_DIR/resolve-farmslot-ports.mjs"
-
-_resolve_ports_cli() {
-  node "$_RESOLVE_PORTS_MJS" "$1" "${2:-.}"
-}
-
-resolve_farmslot_ports_by_repo() {
-  _resolve_ports_cli resolve_farmslot_ports_by_repo "$1"
-}
-
-infer_extension_slot_suffix() {
-  local repo="$1" base
-  base="$(basename "$repo")"
-  if [[ "$base" =~ -([0-9]+)$ ]]; then
-    printf '%s' "${BASH_REMATCH[1]}"
-    return 0
-  fi
-  return 1
-}
-
-resolve_default_extension_ports() {
-  _resolve_ports_cli resolve_default_extension_ports "$1"
-}
-
-resolve_extension_runtime_ports() {
-  _resolve_ports_cli resolve_extension_runtime_ports "${1:-.}"
-}
-
-apply_resolved_extension_ports() {
-  local repo="${1:-.}" line key val from_pool=false resolved=""
-  if resolved="$(_resolve_ports_cli resolve_farmslot_ports_by_repo "$repo" 2>/dev/null)"; then
-    from_pool=true
-  elif resolved="$(_resolve_ports_cli resolve_default_extension_ports "$repo" 2>/dev/null)"; then
-    from_pool=false
-  else
-    return 0
-  fi
-  while IFS= read -r line; do
-    [ -n "$line" ] || continue
-    key="${line%%=*}"
-    val="${line#*=}"
-    case "$key" in
-      CDP_PORT)
-        if [ "$from_pool" = true ] || [ -z "${CDP_PORT:-}" ]; then CDP_PORT="$val"; fi
-        ;;
-      WATCHER_PORT)
-        if [ "$from_pool" = true ] || [ -z "${WATCHER_PORT:-}" ]; then WATCHER_PORT="$val"; fi
-        ;;
-      SLOT_ID)
-        if [ "$from_pool" = true ] || [ -z "${RECIPE_SLOT_ID:-}" ]; then RECIPE_SLOT_ID="$val"; fi
-        ;;
-    esac
-  done <<< "$resolved"
-}
-
-resolve_mobile_slot_defaults() {
-  _resolve_ports_cli resolve_mobile_slot_defaults "$1"
-}
-
-resolve_mobile_runtime_context() {
-  _resolve_ports_cli resolve_mobile_runtime_context "$1"
-}
-
-resolve_mobile_runtime_ports() {
-  _resolve_ports_cli resolve_mobile_runtime_ports "${1:-.}"
-}
-
-apply_resolved_mobile_ports() {
-  local repo="${1:-.}" line key val from_pool=false resolved=""
-  if resolved="$(_resolve_ports_cli resolve_farmslot_ports_by_repo "$repo" 2>/dev/null)"; then
-    from_pool=true
-  elif resolved="$(_resolve_ports_cli resolve_mobile_slot_defaults "$repo" 2>/dev/null)"; then
-    from_pool=false
-  else
-    return 0
-  fi
-  while IFS= read -r line; do
-    [ -n "$line" ] || continue
-    key="${line%%=*}"
-    val="${line#*=}"
-    case "$key" in
-      WATCHER_PORT)
-        if [ "$from_pool" = true ] || [ -z "${WATCHER_PORT:-}" ]; then WATCHER_PORT="$val"; fi
-        ;;
-      IOS_SIMULATOR)
-        if [ "$from_pool" = true ] || [ -z "${IOS_SIMULATOR:-}" ]; then IOS_SIMULATOR="$val"; fi
-        ;;
-      SLOT_ID)
-        if [ "$from_pool" = true ] || [ -z "${RECIPE_SLOT_ID:-}" ]; then RECIPE_SLOT_ID="$val"; fi
-        ;;
-    esac
-  done <<< "$resolved"
-}
+# Back-compat shim: this wrapper is now resolve-slot-ports.sh. Sources it for one
+# release so old callers keep the same sourced function names (including the
+# resolve_farmslot_ports_by_repo alias defined there).
+_SHIM_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC1091
+. "$_SHIM_DIR/resolve-slot-ports.sh"

package/adapters/shared/resolve-slot-ports-core.mjs

@@ -0,0 +1,213 @@
+// Slot-pool + slot-suffix port resolution — pure JS for runner and overlay leaves.
+// Reads the orchestrator's pool JSON (the on-disk `pool/` directory) when a slot
+// repo matches, else the local-extension-N suffix formula.
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const coreDir = path.dirname(fileURLToPath(import.meta.url));
+
+function pathDefault(key) {
+  for (const candidate of [
+    path.join(coreDir, 'path-defaults.json'),
+    path.join(coreDir, '../../adapters/shared/path-defaults.json'),
+  ]) {
+    if (!fs.existsSync(candidate)) continue;
+    const value = JSON.parse(fs.readFileSync(candidate, 'utf8'))[key];
+    if (value) return value;
+  }
+  throw new Error(`Missing path default: ${key}`);
+}
+
+function recipeRuntimeDir() {
+  return process.env.RECIPE_RUNTIME_DIR || pathDefault('recipeRuntimeDir');
+}
+
+export function formatKvLines(kv) {
+  const lines = [];
+  if (kv.CDP_PORT !== undefined) lines.push(`CDP_PORT=${kv.CDP_PORT}`);
+  if (kv.WATCHER_PORT !== undefined) lines.push(`WATCHER_PORT=${kv.WATCHER_PORT}`);
+  if (kv.SLOT_ID) lines.push(`SLOT_ID=${kv.SLOT_ID}`);
+  if (kv.IOS_SIMULATOR) lines.push(`IOS_SIMULATOR=${kv.IOS_SIMULATOR}`);
+  return lines.length ? `${lines.join('\n')}\n` : '';
+}
+
+export function realRepoPath(repo) {
+  if (!repo) return null;
+  try {
+    return fs.realpathSync(repo);
+  } catch {
+    return null;
+  }
+}
+
+export function inferSlotSuffix(repo) {
+  const base = path.basename(repo);
+  const m = /-(\d+)$/u.exec(base);
+  return m ? m[1] : null;
+}
+
+function scoreSlot(slot, slotSuffix) {
+  const resources = slot.resources ?? {};
+  const cdp = resources.browser?.cdp_port;
+  const port = resources['dev-server']?.port;
+  const simulator = resources['ios-sim']?.simulator;
+  const session = slot.session ?? '';
+  const slotId = slot.id ?? '';
+  let score = 0;
+  if (cdp !== undefined) score += 100;
+  if (port !== undefined) score += 10;
+  if (slotSuffix) {
+    if (session === `mme-${slotSuffix}`) score += 50;
+    if (slotId.endsWith(`mme-${slotSuffix}`) || slotId.includes(`-mme-${slotSuffix}`)) score += 40;
+  }
+  if (!slotId.toLowerCase().includes('demo')) score += 5;
+  return [score, cdp, port, slotId, simulator];
+}
+
+export function resolveSlotPortsByRepo(repo) {
+  const realRepo = realRepoPath(repo);
+  if (!realRepo) return null;
+
+  const slotSuffix = inferSlotSuffix(realRepo);
+  const roots = [];
+  // A slot checkout lives at <workspace>/repos/<slot>; that workspace's own
+  // pool is the authoritative one for this repo — machine-global fallbacks
+  // (env root, dev checkout) apply only when the repo is not workspace-shaped.
+  if (path.basename(path.dirname(realRepo)) === 'repos') {
+    roots.push(path.join(path.dirname(path.dirname(realRepo)), 'farmslot'));
+  }
+  if (process.env.FARMSLOT_ROOT) roots.push(process.env.FARMSLOT_ROOT);
+  roots.push(path.join(os.homedir(), 'dev', 'farmslot'));
+
+  for (const root of roots) {
+    if (!root || !fs.existsSync(path.join(root, 'pool'))) continue;
+    const poolDir = path.join(root, 'pool');
+    let best = null;
+
+    for (const name of fs.readdirSync(poolDir).sort()) {
+      if (!name.endsWith('.json') || name.includes('.bak.')) continue;
+      let data;
+      try {
+        data = JSON.parse(fs.readFileSync(path.join(poolDir, name), 'utf8'));
+      } catch {
+        continue;
+      }
+      for (const slot of data.slots ?? []) {
+        const slotRepo = slot.repo ?? '';
+        if (!slotRepo) continue;
+        let slotReal;
+        try {
+          slotReal = fs.realpathSync(slotRepo);
+        } catch {
+          continue;
+        }
+        if (slotReal !== realRepo) continue;
+        const scored = scoreSlot(slot, slotSuffix);
+        if (!best || scored[0] > best[0]) best = scored;
+      }
+    }
+
+    if (best) {
+      const [, cdp, port, slotId, simulator] = best;
+      return formatKvLines({
+        ...(cdp !== undefined ? { CDP_PORT: cdp } : {}),
+        ...(port !== undefined ? { WATCHER_PORT: port } : {}),
+        ...(slotId ? { SLOT_ID: slotId } : {}),
+        ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
+      });
+    }
+  }
+  return null;
+}
+
+export function resolveDefaultExtensionPorts(repo) {
+  const n = inferSlotSuffix(repo);
+  if (!n) return null;
+  return formatKvLines({
+    CDP_PORT: 6660 + Number(n),
+    WATCHER_PORT: 9010 + Number(n),
+    SLOT_ID: `local-extension-${n}`,
+  });
+}
+
+export function resolveExtensionRuntimePorts(repo) {
+  return resolveSlotPortsByRepo(repo) ?? resolveDefaultExtensionPorts(repo) ?? '';
+}
+
+export function resolveMobileSlotDefaults(repo) {
+  const n = inferSlotSuffix(repo);
+  if (!n) return null;
+  return formatKvLines({
+    WATCHER_PORT: 8060 + Number(n),
+    IOS_SIMULATOR: `mm-${n}`,
+    SLOT_ID: `local-mobile-${n}`,
+  });
+}
+
+export function resolveMobileRuntimeContext(repo) {
+  const ctxPath = path.join(repo, recipeRuntimeDir(), 'agentic-runtime.json');
+  if (fs.existsSync(ctxPath)) {
+    try {
+      const c = JSON.parse(fs.readFileSync(ctxPath, 'utf8'));
+      if (c.simulator || (c.metroPort != null && c.metroPort !== '')) {
+        return formatKvLines({
+          ...(c.metroPort != null && c.metroPort !== '' ? { WATCHER_PORT: c.metroPort } : {}),
+          ...(c.simulator ? { IOS_SIMULATOR: c.simulator } : {}),
+          ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
+        });
+      }
+    } catch {
+      /* unreadable context falls through to the provision baseline */
+    }
+  }
+  return resolveMobileProvisionBaseline(repo);
+}
+
+// A provisioned-but-unprepared slot has no agentic-runtime.json yet, but the
+// provision baseline records the same authoritative simulator/port identity —
+// without it, a fresh slot's first launch degrades to the simctl `booted`
+// alias and misses the installed dev client entirely.
+function resolveMobileProvisionBaseline(repo) {
+  const basePath = path.join(repo, recipeRuntimeDir(), 'runway-provision.json');
+  if (!fs.existsSync(basePath)) return null;
+  try {
+    const c = JSON.parse(fs.readFileSync(basePath, 'utf8'));
+    const simulator = c.simulator?.name || c.simulator?.udid;
+    const watcherPort = c.watcherPort != null && c.watcherPort !== '' ? c.watcherPort : undefined;
+    if (!simulator && watcherPort === undefined) return null;
+    return formatKvLines({
+      ...(watcherPort !== undefined ? { WATCHER_PORT: watcherPort } : {}),
+      ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
+      ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
+    });
+  } catch {
+    return null;
+  }
+}
+
+export function resolveMobileRuntimePorts(repo) {
+  return (
+    resolveMobileRuntimeContext(repo)
+    ?? resolveSlotPortsByRepo(repo)
+    ?? resolveMobileSlotDefaults(repo)
+    ?? ''
+  );
+}
+
+// Back-compat: the previous name for resolveSlotPortsByRepo, kept as an alias for
+// one release so existing importers keep resolving.
+export const resolveFarmslotPortsByRepo = resolveSlotPortsByRepo;
+
+export const cliFns = {
+  resolve_slot_ports_by_repo: resolveSlotPortsByRepo,
+  // Back-compat cli key for one release.
+  resolve_farmslot_ports_by_repo: resolveSlotPortsByRepo,
+  resolve_default_extension_ports: resolveDefaultExtensionPorts,
+  resolve_extension_runtime_ports: (repo) => resolveExtensionRuntimePorts(repo) || null,
+  resolve_mobile_runtime_context: resolveMobileRuntimeContext,
+  resolve_mobile_slot_defaults: resolveMobileSlotDefaults,
+  resolve_mobile_runtime_ports: (repo) => resolveMobileRuntimePorts(repo) || null,
+};

package/adapters/shared/resolve-slot-ports.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// Node leaf for port resolution — self-contained for runner and injected overlay copies.
+
+import { cliFns } from './resolve-slot-ports-core.mjs';
+
+const [, , fn, repo] = process.argv;
+if (!fn || fn === '-h' || fn === '--help') {
+  process.stderr.write('Usage: resolve-slot-ports.mjs <fn> <repo>\n');
+  process.exit(fn ? 0 : 2);
+}
+
+const handler = cliFns[fn];
+if (!handler) {
+  process.stderr.write(`resolve-slot-ports: unknown fn: ${fn}\n`);
+  process.exit(2);
+}
+
+const out = handler(repo ?? '.');
+if (!out?.trim()) process.exit(1);
+process.stdout.write(out.endsWith('\n') ? out : `${out}\n`);

package/adapters/shared/resolve-slot-ports.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+# resolve-slot-ports.sh — bash-compat wrapper over resolve-slot-ports.mjs
+#
+# The orchestrator's pool JSON is authoritative when a slot repo matches; otherwise
+# fall back to the local-extension-N formula (6660+N / 9010+N).
+#
+# Usage:
+#   . resolve-slot-ports.sh
+#   resolve_extension_runtime_ports /path/to/metamask-extension-N
+#     -> prints CDP_PORT=... WATCHER_PORT=... SLOT_ID=... lines
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+_RESOLVE_PORTS_MJS="$SCRIPT_DIR/resolve-slot-ports.mjs"
+
+_resolve_ports_cli() {
+  node "$_RESOLVE_PORTS_MJS" "$1" "${2:-.}"
+}
+
+resolve_slot_ports_by_repo() {
+  _resolve_ports_cli resolve_slot_ports_by_repo "$1"
+}
+
+# Back-compat alias for the previous function name (one release).
+resolve_farmslot_ports_by_repo() {
+  resolve_slot_ports_by_repo "$1"
+}
+
+infer_extension_slot_suffix() {
+  local repo="$1" base
+  base="$(basename "$repo")"
+  if [[ "$base" =~ -([0-9]+)$ ]]; then
+    printf '%s' "${BASH_REMATCH[1]}"
+    return 0
+  fi
+  return 1
+}
+
+resolve_default_extension_ports() {
+  _resolve_ports_cli resolve_default_extension_ports "$1"
+}
+
+resolve_extension_runtime_ports() {
+  _resolve_ports_cli resolve_extension_runtime_ports "${1:-.}"
+}
+
+apply_resolved_extension_ports() {
+  local repo="${1:-.}" line key val from_pool=false resolved=""
+  if resolved="$(_resolve_ports_cli resolve_slot_ports_by_repo "$repo" 2>/dev/null)"; then
+    from_pool=true
+  elif resolved="$(_resolve_ports_cli resolve_default_extension_ports "$repo" 2>/dev/null)"; then
+    from_pool=false
+  else
+    return 0
+  fi
+  while IFS= read -r line; do
+    [ -n "$line" ] || continue
+    key="${line%%=*}"
+    val="${line#*=}"
+    case "$key" in
+      CDP_PORT)
+        if [ "$from_pool" = true ] || [ -z "${CDP_PORT:-}" ]; then CDP_PORT="$val"; fi
+        ;;
+      WATCHER_PORT)
+        if [ "$from_pool" = true ] || [ -z "${WATCHER_PORT:-}" ]; then WATCHER_PORT="$val"; fi
+        ;;
+      SLOT_ID)
+        if [ "$from_pool" = true ] || [ -z "${RECIPE_SLOT_ID:-}" ]; then RECIPE_SLOT_ID="$val"; fi
+        ;;
+    esac
+  done <<< "$resolved"
+}
+
+resolve_mobile_slot_defaults() {
+  _resolve_ports_cli resolve_mobile_slot_defaults "$1"
+}
+
+resolve_mobile_runtime_context() {
+  _resolve_ports_cli resolve_mobile_runtime_context "$1"
+}
+
+resolve_mobile_runtime_ports() {
+  _resolve_ports_cli resolve_mobile_runtime_ports "${1:-.}"
+}
+
+apply_resolved_mobile_ports() {
+  local repo="${1:-.}" line key val from_pool=false resolved=""
+  if resolved="$(_resolve_ports_cli resolve_slot_ports_by_repo "$repo" 2>/dev/null)"; then
+    from_pool=true
+  elif resolved="$(_resolve_ports_cli resolve_mobile_slot_defaults "$repo" 2>/dev/null)"; then
+    from_pool=false
+  else
+    return 0
+  fi
+  while IFS= read -r line; do
+    [ -n "$line" ] || continue
+    key="${line%%=*}"
+    val="${line#*=}"
+    case "$key" in
+      WATCHER_PORT)
+        if [ "$from_pool" = true ] || [ -z "${WATCHER_PORT:-}" ]; then WATCHER_PORT="$val"; fi
+        ;;
+      IOS_SIMULATOR)
+        if [ "$from_pool" = true ] || [ -z "${IOS_SIMULATOR:-}" ]; then IOS_SIMULATOR="$val"; fi
+        ;;
+      SLOT_ID)
+        if [ "$from_pool" = true ] || [ -z "${RECIPE_SLOT_ID:-}" ]; then RECIPE_SLOT_ID="$val"; fi
+        ;;
+    esac
+  done <<< "$resolved"
+}