@deeeed/metamask-harness 0.2.0 → 0.3.1

package/docs/harness-cli.md

@@ -1,43 +0,0 @@
-# `mm-harness` — Command Reference
-
-> This page is a pointer. The full, authoritative command contract lives in
-> [CLI-SPEC.md](CLI-SPEC.md); the before→after overview is in
-> [MENTAL-MODEL.md](MENTAL-MODEL.md). This file exists only so links to
-> `harness-cli.md` keep resolving.
-
-`mm-harness` is the MetaMask recipe harness — the single front door for launching
-the app, proving behavior, and managing the per-checkout **runtime overlay**. It
-is the only bin: platform (`mobile | extension | core`) is auto-detected from the
-checkout, a positional target forces it (`mm-harness launch ios`), and depth lives
-in flags (`--json`, ports, build tiers), never in extra command names.
-
-Naming: **"harness" is the tool** (`mm-harness`) and the generic engine package
-(`@farmslot/recipe-harness`). The files the tool installs into a target checkout
-are the **runtime overlay** — never "the harness".
-
-## Command surface (all shipped)
-
-```
-DAILY LOOP        launch · logs · debug · fixtures       what a teammate runs many times a day
-DISCOVER          actions · call · flows                 compose recipes from the vocabulary + flow library
-PROVE             run · doctor                           run recipes, check readiness
-RUNTIME OVERLAY   install · verify · cleanup             install/verify/clean the per-checkout overlay
-```
-
-Grammar: `mm-harness <command> [target] [flags]`. `--json` is the agent contract on
-every command; the bare command is the human happy path.
-
-- `run` validates first, then executes; `run --plan` validates and prints the plan
-  without touching a device.
-- `call <action>` runs one action from the adapter vocabulary through the same
-  engine path `run` uses.
-- `doctor` is read-only; `doctor --fix` runs the self-healing steps (overlay
-  auto-ensure; never a fixture reseed) without launching the app and reports
-  `fixed[]` / `failed[]`.
-- `flows` lists the recipe library (bare = `flows list`); `flows promote` keeps a
-  proven flow.
-- `install` / `verify` / `cleanup` manage the runtime overlay; the DAILY LOOP
-  commands auto-ensure it.
-
-For flags, exit-code taxonomy, `--json` shapes, and per-command detail, see
-[CLI-SPEC.md](CLI-SPEC.md).

package/orchestration/compat-overlays/mobile/README.md

@@ -1,13 +0,0 @@
-# Mobile historical compatibility overlays
-
-These patch files document temporary source overlays used by Recipe v1 historical
-injection evals when an older MetaMask Mobile checkout cannot boot under the
-current local Xcode/Hermes toolchain.
-
-They are intentionally kept in the external runner repository, not Farmslot root
-scripts, so a `/recipe-harness` skill can apply the same reversible overlay before
-a historical rebuild and record the overlay path in validation evidence.
-
-- `rn81-message-event-source.patch`: adds a read-only `MessageEvent.prototype.source`
-  getter for React Native 0.81 historical checkouts whose bundled polyfill omits
-  it while CDP websocket clients expect browser-compatible `MessageEvent` shape.

package/orchestration/doctor.mjs

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-// doctor.mjs — orchestration feature-surface doctor
-//
-// Purpose:
-//   Verifies orchestration/manifest.json against reality: every entry point
-//   exists; every script entry answers --help with exit 0; and every script
-//   under orchestration/{mobile,extension,core} is listed (no doc drift).
-//
-// Inputs (flags): --json (machine-readable report)
-// Outputs: per-feature lines (or JSON report) on stdout.
-//   Exit 0 — surface healthy; 1 — missing entry, failing --help, or
-//   unlisted script; 2 — bad args.
-// Never touches: anything (read-only + --help subprocesses).
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-let json = false;
-for (const arg of process.argv.slice(2)) {
-  if (arg === '--json') json = true;
-  else if (arg === '-h' || arg === '--help') {
-    console.log('Usage: doctor.mjs [--json]');
-    process.exit(0);
-  } else {
-    console.error(`Unknown arg: ${arg}`);
-    process.exit(2);
-  }
-}
-
-const orchestrationDir = path.dirname(fileURLToPath(import.meta.url));
-const runnerRoot = path.resolve(orchestrationDir, '..');
-const manifest = JSON.parse(fs.readFileSync(path.join(orchestrationDir, 'manifest.json'), 'utf8'));
-
-const results = [];
-for (const feature of manifest.features) {
-  const entryAbs = path.join(runnerRoot, feature.entry);
-  const checks = { exists: fs.existsSync(entryAbs), help: null };
-  if (checks.exists && (feature.kind === 'bash' || feature.kind === 'node')) {
-    const runner = feature.kind === 'bash' ? 'bash' : process.execPath;
-    const run = spawnSync(runner, [entryAbs, '--help'], { encoding: 'utf8', timeout: 30000 });
-    checks.help = run.status === 0;
-  }
-  const ok = checks.exists && (checks.help === null || checks.help === true);
-  results.push({ id: feature.id, entry: feature.entry, kind: feature.kind, ...checks, ok });
-}
-
-// drift guard: every script in the orchestration trees must be listed
-const listed = new Set(manifest.features.map((feature) => feature.entry));
-const unlisted = [];
-for (const platform of ['mobile', 'extension', 'core', 'lib']) {
-  const dir = path.join(orchestrationDir, platform);
-  if (!fs.existsSync(dir)) continue;
-  for (const entry of fs.readdirSync(dir)) {
-    const rel = `orchestration/${platform}/${entry}`;
-    if (!/\.(?:sh|mjs|cjs|json)$/u.test(entry)) continue;
-    if (!listed.has(rel)) unlisted.push(rel);
-  }
-}
-
-const failed = results.filter((result) => !result.ok);
-const status = failed.length === 0 && unlisted.length === 0 ? 'pass' : 'fail';
-if (json) {
-  console.log(JSON.stringify({ status, features: results, unlisted }, null, 2));
-} else {
-  for (const result of results) {
-    console.log(`${result.ok ? 'ok  ' : 'FAIL'} ${result.id} (${result.entry})${result.help === false ? ' [--help failed]' : ''}${result.exists ? '' : ' [missing]'}`);
-  }
-  for (const rel of unlisted) console.log(`FAIL unlisted script not in manifest: ${rel}`);
-  console.log(`orchestration surface: ${status} (${results.length - failed.length}/${results.length} features, ${unlisted.length} unlisted)`);
-}
-process.exit(status === 'pass' ? 0 : 1);

package/orchestration/lib/cli-home.mjs

@@ -1,354 +0,0 @@
-#!/usr/bin/env node
-/**
- * cli-home.mjs — recipe CLI home screen and ports output.
- */
-import fs from 'node:fs';
-import http from 'node:http';
-import path from 'node:path';
-import { parseArgs } from 'node:util';
-import {
-  color,
-  colorKv,
-  colorStatusWord,
-} from './cli-color.mjs';
-
-const OUT = process.stdout;
-
-function readJson(file) {
-  if (!file || !fs.existsSync(file)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-function httpProbe(url, timeoutMs = 1500) {
-  return new Promise((resolve) => {
-    const req = http.get(url, { timeout: timeoutMs }, (res) => {
-      let body = '';
-      res.on('data', (chunk) => { body += chunk; });
-      res.on('end', () => resolve({ ok: res.statusCode >= 200 && res.statusCode < 300, body }));
-    });
-    req.on('timeout', () => { req.destroy(); resolve({ ok: false, body: '' }); });
-    req.on('error', () => resolve({ ok: false, body: '' }));
-  });
-}
-
-function watcherPhase(logPath) {
-  if (!logPath || !fs.existsSync(logPath)) return 'stopped';
-  const text = fs.readFileSync(logPath, 'utf8');
-  if (/Module build failed|^ERROR in /m.test(text)) return 'failed';
-  if (/compiled successfully|MetaMask .* compiled|Bundle end:/m.test(text)) return 'ready';
-  if (/webpack.Progress|Building|Compiling|yarn start/m.test(text)) return 'compiling';
-  return 'unknown';
-}
-
-function metroPhase(logPath) {
-  if (!logPath || !fs.existsSync(logPath)) return 'stopped';
-  const text = fs.readFileSync(logPath, 'utf8');
-  if (/Bundl(ed|ing)|Finished/m.test(text)) {
-    const match = text.match(/(iOS|Android).*?([0-9]+(?:\.[0-9]+)?)%/);
-    if (match && Number(match[2]) < 100) return 'bundling';
-    return 'ready';
-  }
-  return 'starting';
-}
-
-function mobileBridgeSnapshot(runtimeStatus) {
-  const raw = runtimeStatus?.bridge?.status;
-  const targets = Array.isArray(raw) ? raw : raw ? [raw] : [];
-  const ready = targets.find((item) => item && typeof item === 'object' && item.route);
-  if (!ready) return { route: null, account: null, deviceName: null };
-  return {
-    route: ready.route?.name || null,
-    account: ready.account?.name || ready.account?.address || null,
-    deviceName: ready.deviceName || null,
-  };
-}
-
-function watcherPhaseLabel(phase) {
-  switch (phase) {
-    case 'ready': return 'ready';
-    case 'compiling': return 'compiling';
-    case 'failed': return 'failed';
-    case 'stopped': return 'stopped';
-    default: return phase || 'unknown';
-  }
-}
-
-function metroPhaseLabel(phase) {
-  switch (phase) {
-    case 'running':
-    case 'ready': return 'ready';
-    case 'bundling': return 'bundling';
-    case 'starting': return 'starting';
-    case 'down': return 'down';
-    default: return phase || 'unknown';
-  }
-}
-
-function nextActions(adapter, state) {
-  const actions = [];
-  if (state.harnessStale) {
-    actions.push({ command: 'recipe sync', reason: 'refresh harness scripts + fixture context' });
-  }
-  if (adapter === 'extension') {
-    if (state.ready) {
-      actions.push({ command: 'recipe refresh', reason: 'fast incremental update when watcher is active' });
-      actions.push({ command: 'recipe debug', reason: 'open Chrome DevTools' });
-      actions.push({ command: 'recipe logs', reason: 'compact last build events (recipe logs --full for raw tail)' });
-    } else if (state.watcher === 'ready' && state.decision === 'build') {
-      actions.push({ command: 'recipe refresh', reason: 'watcher is up; wait for dist to catch up' });
-      actions.push({ command: 'recipe rebuild', reason: 'heavy clean rebuild if refresh stalls' });
-    } else if (state.watcher === 'compiling') {
-      actions.push({ command: 'recipe logs', reason: 'compact webpack progress' });
-      actions.push({ command: 'recipe status', reason: 're-check readiness' });
-    } else {
-      actions.push({ command: 'recipe up', reason: 'decide and run the minimum path to ready' });
-      actions.push({ command: 'recipe rebuild', reason: 'clean webpack + browser launch (2-8 min)' });
-      actions.push({ command: 'recipe watch', reason: 'start watcher only' });
-    }
-    if (!state.fixturePresent) actions.unshift({ command: 'recipe sync', reason: 'install fixture + harness context' });
-  } else {
-    if (state.ready) {
-      actions.push({ command: 'recipe debug', reason: 'open React Native DevTools' });
-      actions.push({ command: 'recipe logs', reason: 'compact Metro events (recipe logs --full for raw tail)' });
-    } else if (state.metro === 'ready' && !state.bridgeReady) {
-      actions.push({ command: 'recipe up', reason: 'launch dev client and wait for bridge' });
-      actions.push({ command: 'recipe logs', reason: 'compact bundle progress' });
-    } else {
-      actions.push({ command: 'recipe up', reason: 'start Metro + launch dev client as needed' });
-      actions.push({ command: 'recipe ios', reason: 'launch iOS dev client' });
-      actions.push({ command: 'recipe android', reason: 'launch Android dev client' });
-    }
-    if (!state.fixturePresent) actions.unshift({ command: 'recipe sync', reason: 'install fixture + harness context' });
-  }
-  return actions.slice(0, 5);
-}
-
-function renderHuman(payload) {
-  const lines = [];
-  const head = payload.adapter === 'extension' ? 'Extension recipe' : 'Mobile recipe';
-  lines.push(`${color('bold', head, { stream: OUT })} ${color('dim', '|', { stream: OUT })} ${color('path', payload.root, { stream: OUT })}`);
-  lines.push(`${colorKv('slot', payload.slotId || '?', 'info', { stream: OUT })}  ${colorKv('runtime', payload.runtimeDir, 'path', { stream: OUT })}`);
-  if (payload.harnessStale) {
-    lines.push(color('warn', 'harness: stale - run: recipe sync', { stream: OUT }));
-  }
-  if (payload.adapter === 'extension') {
-    lines.push(
-      `${colorKv('cdp', String(payload.ports.cdp ?? '?'), 'info', { stream: OUT })}  ${colorKv('watcher-port', String(payload.ports.watcher ?? '?'), 'info', { stream: OUT })}`,
-    );
-    lines.push([
-      `${color('label', 'browser:', { stream: OUT })} ${colorStatusWord(payload.browser, { stream: OUT })}`,
-      `${color('label', 'webpack:', { stream: OUT })} ${colorStatusWord(watcherPhaseLabel(payload.watcher), { stream: OUT })}`,
-      `${color('label', 'ready:', { stream: OUT })} ${colorStatusWord(payload.ready ? 'yes' : 'no', { stream: OUT })}`,
-      payload.reason ? color('comment', ` (${payload.reason})`, { stream: OUT }) : '',
-    ].join('  '));
-    lines.push(`${color('label', 'fixture:', { stream: OUT })} ${colorStatusWord(payload.fixturePresent ? 'present' : 'missing', { stream: OUT })}`);
-  } else {
-    const bridgeBits = [];
-    if (payload.appRoute) bridgeBits.push(`route=${payload.appRoute}`);
-    if (payload.appAccount) bridgeBits.push(`account=${payload.appAccount}`);
-    const bridgeDetail = bridgeBits.length > 0 ? color('comment', ` (${bridgeBits.join(', ')})`, { stream: OUT }) : '';
-    lines.push(
-      `${colorKv('metro-port', String(payload.ports.watcher ?? '?'), 'info', { stream: OUT })}  ${colorKv('device', payload.device || payload.appDevice || '?', 'info', { stream: OUT })}  ${color('label', 'metro:', { stream: OUT })} ${colorStatusWord(metroPhaseLabel(payload.metro), { stream: OUT })}  ${color('label', 'bridge:', { stream: OUT })} ${colorStatusWord(payload.bridge, { stream: OUT })}${bridgeDetail}`,
-    );
-    lines.push([
-      `${color('label', 'fixture:', { stream: OUT })} ${colorStatusWord(payload.fixturePresent ? 'present' : 'missing', { stream: OUT })}`,
-      `${color('label', 'ready:', { stream: OUT })} ${colorStatusWord(payload.ready ? 'yes' : 'no', { stream: OUT })}`,
-      payload.reason ? color('comment', ` (${payload.reason})`, { stream: OUT }) : '',
-    ].join('  '));
-  }
-  if (payload.decision) {
-    lines.push(`${colorKv('decision', payload.decision, 'ok', { stream: OUT })}${payload.reasonCode ? color('comment', ` - ${payload.reasonCode}`, { stream: OUT }) : ''}`);
-  }
-  if (payload.tmux) {
-    lines.push(`${colorKv('tmux', payload.tmux, 'accent', { stream: OUT })}${color('comment', ' (webpack window may still stream full logs)', { stream: OUT })}`);
-  }
-  lines.push('');
-  lines.push(color('label', 'next:', { stream: OUT }));
-  for (const item of payload.nextActions) {
-    lines.push(`  ${color('cmd', item.command, { stream: OUT })}  ${color('comment', `# ${item.reason}`, { stream: OUT })}`);
-  }
-  lines.push('');
-  lines.push(color('comment', 'speed:  fast -> watch -> refresh   slow -> rebuild   inspect -> status | logs | logs --full | debug', { stream: OUT }));
-  return `${lines.join('\n')}\n`;
-}
-
-function renderPorts(payload) {
-  const lines = [
-    colorKv('slot', payload.slotId || '?', 'info', { stream: OUT }),
-    `${colorKv('cdp', String(payload.ports.cdp ?? '?'), 'info', { stream: OUT })}  ${colorKv('watcher', String(payload.ports.watcher ?? '?'), 'info', { stream: OUT })}`,
-    `${colorKv('runtime', payload.runtimeDir, 'path', { stream: OUT })}  ${colorKv('harness', payload.harnessDir, 'path', { stream: OUT })}`,
-  ];
-  if (payload.tmux) lines.push(colorKv('tmux', payload.tmux, 'accent', { stream: OUT }));
-  return `${lines.join('\n')}\n`;
-}
-
-async function buildHome({ adapter, target, runtimeDir, ports, runtimeStatus, decision, harnessStale = false }) {
-  const runtimeAbs = path.join(target, runtimeDir);
-  const context = readJson(path.join(runtimeAbs, 'agentic-runtime.json'))
-    || readJson(path.join(runtimeAbs, 'recipe-runtime.json'))
-    || {};
-  const slotId = context.slotId || null;
-  const fixturePresent = Boolean(
-    runtimeStatus?.fixture?.present
-    || fs.existsSync(path.join(runtimeAbs, 'wallet-fixture.json')),
-  );
-
-  let browser = 'down';
-  let watcher = 'stopped';
-  let metro = 'stopped';
-  let bridge = 'down';
-  let bridgeReady = false;
-  let device = process.env.IOS_SIMULATOR || process.env.ANDROID_DEVICE || process.env.ADB_SERIAL || null;
-  let tmux = null;
-
-  if (adapter === 'extension') {
-    const cdp = ports.cdp;
-    if (cdp) {
-      const probe = await httpProbe(`http://127.0.0.1:${cdp}/json/version`);
-      browser = probe.ok ? 'up' : 'down';
-    }
-    const logPath = path.join(runtimeAbs, 'webpack.log');
-    watcher = watcherPhase(logPath);
-    const slot = (path.basename(target).match(/-(\d+)$/) || [])[1];
-    if (slot) tmux = `mme-${slot}:webpack-${ports.watcher || '?'}`;
-  } else {
-    const port = ports.watcher;
-    if (port) {
-      const status = await httpProbe(`http://127.0.0.1:${port}/status`);
-      metro = status.ok && status.body.includes('packager-status:running') ? 'running' : 'down';
-      if (metro === 'running') metro = metroPhase(path.join(runtimeAbs, 'metro.log'));
-    }
-    bridgeReady = Boolean(runtimeStatus?.bridge?.ready);
-    bridge = bridgeReady ? 'ready' : (runtimeStatus?.debugTarget?.present ? 'waiting' : 'down');
-  }
-
-  const ready = Boolean(runtimeStatus?.ready);
-  const decisionValue = decision?.decision || runtimeStatus?.decision?.decision || null;
-  const reasonCode = decision?.reasonCode || runtimeStatus?.decision?.reasonCode || runtimeStatus?.reason || null;
-  const bridgeSnap = adapter === 'mobile' ? mobileBridgeSnapshot(runtimeStatus) : null;
-
-  const payload = {
-    schemaVersion: 1,
-    kind: 'home',
-    adapter,
-    root: target,
-    runtimeDir,
-    slotId,
-    ports,
-    fixturePresent,
-    harnessStale,
-    ready,
-    reason: runtimeStatus?.reason || null,
-    appRoute: bridgeSnap?.route || null,
-    appAccount: bridgeSnap?.account || null,
-    appDevice: bridgeSnap?.deviceName || null,
-    decision: decisionValue,
-    reasonCode,
-    browser: adapter === 'extension' ? browser : undefined,
-    watcher: adapter === 'extension' ? watcher : undefined,
-    metro: adapter === 'mobile' ? metro : undefined,
-    bridge: adapter === 'mobile' ? bridge : undefined,
-    bridgeReady: adapter === 'mobile' ? bridgeReady : undefined,
-    device: adapter === 'mobile' ? device : undefined,
-    tmux: adapter === 'extension' ? tmux : undefined,
-    runtimeStatus,
-    nextActions: [],
-  };
-  payload.nextActions = nextActions(adapter, {
-    ready,
-    watcher,
-    metro,
-    bridgeReady,
-    fixturePresent,
-    harnessStale,
-    decision: decisionValue,
-  });
-  return payload;
-}
-
-function buildPorts({ adapter, target, runtimeDir, ports, slotId }) {
-  return {
-    schemaVersion: 1,
-    kind: 'ports',
-    adapter,
-    root: target,
-    runtimeDir,
-    slotId: slotId || null,
-    ports,
-    tmux: adapter === 'extension' && ports.watcher
-      ? `mme-${(path.basename(target).match(/-(\d+)$/) || ['', ''])[1]}:webpack-${ports.watcher}`
-      : null,
-    harnessDir: process.env.RECIPE_HARNESS_ROOT || 'temp/recipe/harness',
-  };
-}
-
-async function main() {
-  const { values } = parseArgs({
-    args: process.argv.slice(2),
-    options: {
-      adapter: { type: 'string' },
-      target: { type: 'string' },
-      'runtime-dir': { type: 'string' },
-      'cdp-port': { type: 'string' },
-      'watcher-port': { type: 'string' },
-      'slot-id': { type: 'string' },
-      mode: { type: 'string', default: 'home' },
-      'runtime-status-file': { type: 'string' },
-      'decision-file': { type: 'string' },
-      'harness-stale': { type: 'boolean', default: false },
-      json: { type: 'boolean', default: false },
-    },
-    allowPositionals: false,
-  });
-
-  if (!values.adapter || !values.target) {
-    console.error('cli-home.mjs requires --adapter and --target');
-    process.exit(2);
-  }
-
-  const ports = {
-    cdp: values['cdp-port'] ? Number(values['cdp-port']) : null,
-    watcher: values['watcher-port'] ? Number(values['watcher-port']) : null,
-  };
-  const runtimeStatus = readJson(values['runtime-status-file']);
-  const decision = readJson(values['decision-file']);
-
-  const payload = values.mode === 'ports'
-    ? buildPorts({
-      adapter: values.adapter,
-      target: values.target,
-      runtimeDir: values['runtime-dir'] || 'temp/recipe/runtime',
-      ports,
-      slotId: values['slot-id'],
-    })
-    : await buildHome({
-      adapter: values.adapter,
-      target: values.target,
-      runtimeDir: values['runtime-dir'] || 'temp/recipe/runtime',
-      ports,
-      runtimeStatus,
-      decision,
-      harnessStale: values['harness-stale'],
-    });
-
-  if (values.json) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-    return;
-  }
-
-  if (payload.kind === 'ports') {
-    process.stdout.write(renderPorts(payload));
-    return;
-  }
-
-  process.stdout.write(renderHuman(payload));
-}
-
-main().catch((error) => {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});

package/orchestration/lib/recipe-paths.mjs

@@ -1,26 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const defaultsPath = path.join(path.dirname(fileURLToPath(import.meta.url)), 'path-defaults.json');
-const defaults = JSON.parse(fs.readFileSync(defaultsPath, 'utf8'));
-
-export const DEFAULT_RECIPE_HARNESS_ROOT = defaults.recipeHarnessRoot;
-export const DEFAULT_RECIPE_RUNTIME_DIR = defaults.recipeRuntimeDir;
-
-export function validateRelativeRecipePath(name, value) {
-  if (!value || path.isAbsolute(value)) throw new Error(`${name} must be a non-empty relative path: ${value}`);
-  if (!/^[A-Za-z0-9._/-]+$/u.test(value)) throw new Error(`${name} contains unsupported characters: ${value}`);
-  for (const part of value.split('/')) {
-    if (!part || part === '.' || part === '..') throw new Error(`${name} contains unsafe path component: ${value}`);
-  }
-  return value;
-}
-
-export function recipeHarnessRoot(env = process.env) {
-  return validateRelativeRecipePath('RECIPE_HARNESS_ROOT', env.RECIPE_HARNESS_ROOT || DEFAULT_RECIPE_HARNESS_ROOT);
-}
-
-export function recipeRuntimeDir(env = process.env) {
-  return validateRelativeRecipePath('RECIPE_RUNTIME_DIR', env.RECIPE_RUNTIME_DIR || DEFAULT_RECIPE_RUNTIME_DIR);
-}

package/orchestration/mobile/launch.sh

@@ -1,137 +0,0 @@
-#!/usr/bin/env bash
-# launch.sh — mobile instance identity intake + prepare/preflight launch
-#
-# Purpose:
-#   Resolves the per-instance tuple (port, simulator/adb-serial, runtime dir,
-#   platform, preflight mode) and runs the installed runner's mobile prepare.
-#
-# Inputs (flags / env precedence):
-#   --target <metamask-mobile> (default $PWD)
-#   --platform ios|android (default ios)
-#   --preflight-mode|--mode fast|auto|default|rebuild-native|clean
-#       (env RECIPE_HARNESS_MOBILE_PREFLIGHT_MODE, default fast)
-#   --port|--watcher-port|--cdp-port <port> (env WATCHER_PORT > METRO_PORT > CDP_PORT)
-#   --simulator <sim> (env IOS_SIMULATOR > SIM_UDID)
-#   --adb-serial <serial> (env ADB_SERIAL > ANDROID_SERIAL)
-#   --runtime-dir <dir> (env RECIPE_RUNTIME_DIR)
-#   --wallet-setup / --no-wallet-setup, --wallet-fixture <json>
-#   --artifacts-dir <dir>
-#
-# Outputs:
-#   <artifacts>/summary.json (adapter/action/status/runtime/generatedAt),
-#   <artifacts>/runtime-status.json, <artifacts>/logs/prepare.log
-#   Exit 0 — launch pass; 1 — runner missing or prepare failed; 2 — bad args.
-#
-# Never touches: product source files; anything outside the target's harness
-# dir and the artifacts dir.
-set -euo pipefail
-
-TARGET="$PWD"
-PLATFORM="ios"
-PREFLIGHT_MODE="${RECIPE_HARNESS_MOBILE_PREFLIGHT_MODE:-fast}"
-ARTIFACTS=""
-PORT="${WATCHER_PORT:-${METRO_PORT:-${CDP_PORT:-}}}"
-SIMULATOR="${IOS_SIMULATOR:-${SIM_UDID:-}}"
-ADB_SERIAL_ARG="${ADB_SERIAL:-${ANDROID_SERIAL:-}}"
-RUNTIME_DIR_ARG="${RECIPE_RUNTIME_DIR:-}"
-WALLET_SETUP=false
-WALLET_FIXTURE_ARG=""
-require_value() { [ "$#" -ge 2 ] || { echo "Missing value for $1" >&2; exit 2; }; }
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --target) require_value "$@"; TARGET="$2"; shift 2 ;;
-    --platform) require_value "$@"; PLATFORM="$2"; shift 2 ;;
-    --preflight-mode|--mode) require_value "$@"; PREFLIGHT_MODE="$2"; shift 2 ;;
-    --artifacts-dir) require_value "$@"; ARTIFACTS="$2"; shift 2 ;;
-    --port|--watcher-port|--cdp-port) require_value "$@"; PORT="$2"; shift 2 ;;
-    --simulator) require_value "$@"; SIMULATOR="$2"; shift 2 ;;
-    --adb-serial) require_value "$@"; ADB_SERIAL_ARG="$2"; shift 2 ;;
-    --runtime-dir) require_value "$@"; RUNTIME_DIR_ARG="$2"; shift 2 ;;
-    --wallet-setup) WALLET_SETUP=true; shift ;;
-    --no-wallet-setup) WALLET_SETUP=false; shift ;;
-    --wallet-fixture) require_value "$@"; WALLET_FIXTURE_ARG="$2"; shift 2 ;;
-    -h|--help)
-      echo "Usage: launch.sh [--target <metamask-mobile>] [--platform ios|android] [--preflight-mode fast|auto|default|rebuild-native|clean] [--port <port>] [--simulator <sim>] [--runtime-dir <dir>] [--wallet-setup] [--wallet-fixture <json>]"
-      exit 0
-      ;;
-    *) echo "Unknown arg: $1" >&2; exit 2 ;;
-  esac
-done
-
-case "$PLATFORM" in ios|android) ;; *) echo "Unknown --platform: $PLATFORM" >&2; exit 2 ;; esac
-case "$PREFLIGHT_MODE" in fast|auto|default|rebuild-native|clean) ;; *) echo "Unknown --preflight-mode: $PREFLIGHT_MODE" >&2; exit 2 ;; esac
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck disable=SC1091
-for _hp in "$SCRIPT_DIR/lib/harness-path.sh" "$SCRIPT_DIR/../lib/harness-path.sh"; do
-  [ -f "$_hp" ] && { . "$_hp"; break; }
-done
-unset _hp
-if ! command -v harness_root >/dev/null 2>&1; then
-  echo "mm-harness: shared lib orchestration/lib/harness-path.sh not found; reinstall the runner." >&2
-  exit 1
-fi
-TARGET="$(cd "$TARGET" && pwd)"
-HARNESS_DIR="$(harness_dir "$TARGET" mobile)"
-RUNNER_BIN="$HARNESS_DIR/runner/bin/metamask-recipe"
-ARTIFACTS="${ARTIFACTS:-$HARNESS_DIR/launch/$(date -u +%Y%m%dT%H%M%SZ)}"
-mkdir -p "$ARTIFACTS/logs"
-
-if [ ! -x "$RUNNER_BIN" ]; then
-  echo "Mobile recipe runner is not installed in $TARGET. Run metamask-recipe mobile install --target $TARGET first." >&2
-  exit 1
-fi
-
-prepare_args=(mobile prepare --target "$TARGET" --platform "$PLATFORM" --preflight-mode "$PREFLIGHT_MODE")
-[ -n "$PORT" ] && prepare_args+=(--port "$PORT")
-[ -n "$SIMULATOR" ] && prepare_args+=(--simulator "$SIMULATOR")
-[ -n "$ADB_SERIAL_ARG" ] && prepare_args+=(--adb-serial "$ADB_SERIAL_ARG")
-[ -n "$RUNTIME_DIR_ARG" ] && prepare_args+=(--runtime-dir "$RUNTIME_DIR_ARG")
-$WALLET_SETUP && prepare_args+=(--wallet-setup)
-[ -n "$WALLET_FIXTURE_ARG" ] && prepare_args+=(--wallet-fixture "$WALLET_FIXTURE_ARG")
-
-status="pass"
-if (cd "$TARGET" && "$RUNNER_BIN" "${prepare_args[@]}") > "$ARTIFACTS/logs/prepare.log" 2>&1; then
-  runtime_status="pass"
-else
-  runtime_status="fail"
-  status="fail"
-fi
-
-status_args=(mobile runtime-status --target "$TARGET" --json)
-[ -n "$PORT" ] && status_args+=(--port "$PORT")
-[ -n "$RUNTIME_DIR_ARG" ] && status_args+=(--runtime-dir "$RUNTIME_DIR_ARG")
-(cd "$TARGET" && "$RUNNER_BIN" "${status_args[@]}") > "$ARTIFACTS/runtime-status.json" 2> "$ARTIFACTS/logs/runtime-status.err" || true
-
-TARGET_FOR_SUMMARY="$TARGET" ARTIFACTS_FOR_SUMMARY="$ARTIFACTS" STATUS_FOR_SUMMARY="$status" RUNTIME_STATUS="$runtime_status" PLATFORM_FOR_SUMMARY="$PLATFORM" MODE_FOR_SUMMARY="$PREFLIGHT_MODE" node <<'NODE'
-const fs = require('fs');
-const path = require('path');
-const artifacts = process.env.ARTIFACTS_FOR_SUMMARY;
-let runtime = null;
-try { runtime = JSON.parse(fs.readFileSync(path.join(artifacts, 'runtime-status.json'), 'utf8')); } catch {}
-fs.writeFileSync(path.join(artifacts, 'summary.json'), `${JSON.stringify({
-  adapter: 'mobile',
-  action: 'launch',
-  status: process.env.STATUS_FOR_SUMMARY,
-  platform: process.env.PLATFORM_FOR_SUMMARY,
-  preflightMode: process.env.MODE_FOR_SUMMARY,
-  target: process.env.TARGET_FOR_SUMMARY,
-  runtime: {
-    status: process.env.RUNTIME_STATUS,
-    ready: runtime?.ready === true,
-    reason: runtime?.reason || null,
-    port: runtime?.metro?.port || null,
-    prepareLogPath: path.join(artifacts, 'logs/prepare.log'),
-    runtimeStatusPath: path.join(artifacts, 'runtime-status.json'),
-  },
-  runtimePolicy: {
-    nativeBuildPolicy: process.env.MODE_FOR_SUMMARY === 'fast'
-      ? 'fast mode never runs a native build; it requires an installed dev client, starts/reuses Metro, prewarms the JS bundle, opens the dev client, and waits for the bridge'
-      : 'non-fast modes may install or rebuild the native dev client when needed; then start/reuse Metro, prewarm the JS bundle, open the dev client, and wait for the bridge',
-  },
-  generatedAt: new Date().toISOString(),
-}, null, 2)}\n`);
-NODE
-
-echo "Mobile harness launch $status: $ARTIFACTS/summary.json"
-[ "$status" = "pass" ]