@deeeed/metamask-harness 0.2.0 → 0.3.0

package/runner/src/commands/debug.ts

@@ -1,44 +0,0 @@
-// debug — open the debug console by composing the porcelain: extension `debug`
-// (--worker → `debug worker`); mobile `debug` (--dev-menu → `dev-menu`).
-// Cross-platform flag misuse teaches (exit 2).
-
-import { EXIT, flag, parseFlags, resolveAdapter, spawnPorcelain, targetOf, usageOut } from './shared.ts';
-
-const DEBUG_BOOLEANS = new Set(['worker', 'devMenu', 'json']);
-
-export async function handleDebug(argv: string[]): Promise<number> {
-  const { options } = parseFlags(argv, DEBUG_BOOLEANS);
-  const json = flag(options, 'json');
-  const target = targetOf(options);
-  const adapter = resolveAdapter(options, target);
-
-  if (!adapter) return usageOut(json, 'debug', `could not detect the MetaMask repo type for ${target}`);
-  if (adapter === 'core') return usageOut(json, 'debug', 'core is headless; there is no debug console.');
-
-  const worker = flag(options, 'worker');
-  const devMenu = flag(options, 'devMenu');
-  if (adapter === 'mobile' && worker) {
-    return usageOut(json, 'debug', '--worker is extension-only (service-worker DevTools). Use --dev-menu on mobile.');
-  }
-  if (adapter === 'extension' && devMenu) {
-    return usageOut(json, 'debug', '--dev-menu is mobile-only (RN developer menu). Use --worker on the extension.');
-  }
-
-  let args: string[];
-  if (adapter === 'extension') {
-    args = worker ? ['debug', 'worker'] : ['debug'];
-  } else {
-    args = devMenu ? ['dev-menu'] : ['debug'];
-  }
-  const result = spawnPorcelain(adapter, args, target, json);
-  if (json) {
-    console.log(
-      JSON.stringify(
-        { schemaVersion: 1, command: 'debug', adapter, mode: worker ? 'worker' : devMenu ? 'dev-menu' : 'default', exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime },
-        null,
-        2,
-      ),
-    );
-  }
-  return result.status === 0 ? EXIT.ok : EXIT.runtime;
-}

package/runner/src/commands/fixtures.ts

@@ -1,99 +0,0 @@
-// fixtures <sync|set> — manage wallet DATA (never overlay/runtime state). `sync`
-// re-renders the wallet fixture files; `set` applies THE canonical fixture (SRP/
-// password read FROM the fixture, never typed) and always teaches the edit path.
-
-import fs from 'node:fs';
-import path from 'node:path';
-
-import { walletFixturePath } from '../paths.ts';
-import type { MetaMaskRecipeAdapter } from '../types.ts';
-import { EXIT, flag, parseFlags, resolveAdapter, spawnPorcelain, str, targetOf, usageOut } from './shared.ts';
-
-// One node injected from cli.ts so `fixtures set` can reuse the real engine path
-// (`call`'s one-node machinery) without a circular import.
-export interface CommandDeps {
-  runOneNode: (
-    adapter: MetaMaskRecipeAdapter,
-    action: string,
-    args: Record<string, string>,
-    target: string,
-    actionManifest: string | undefined,
-  ) => Promise<{ status: 'pass' | 'fail' }>;
-}
-
-const FIXTURES_BOOLEANS = new Set(['json']);
-
-export async function handleFixtures(argv: string[], deps: CommandDeps): Promise<number> {
-  const { positional, options } = parseFlags(argv, FIXTURES_BOOLEANS);
-  const json = flag(options, 'json');
-  const sub = positional[0];
-  if (sub !== 'sync' && sub !== 'set') {
-    return usageOut(json, 'fixtures', 'fixtures requires a subcommand: mm-harness fixtures <sync|set>');
-  }
-  const target = targetOf(options);
-  const adapter = resolveAdapter(options, target);
-  if (!adapter) return usageOut(json, 'fixtures', `could not detect the MetaMask repo type for ${target}`);
-  if (adapter === 'core') return usageOut(json, 'fixtures', 'core is headless; it has no wallet fixture.');
-
-  const canonicalFixture = walletFixturePath(target);
-
-  if (sub === 'sync') {
-    // Re-render the wallet fixture files onto the checkout (wallet DATA only).
-    const result = spawnPorcelain(adapter, ['sync'], target, json);
-    if (json) {
-      console.log(
-        JSON.stringify(
-          { schemaVersion: 1, command: 'fixtures', action: 'sync', adapter, fixture: canonicalFixture, exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime },
-          null,
-          2,
-        ),
-      );
-    }
-    return result.status === 0 ? EXIT.ok : EXIT.runtime;
-  }
-
-  // set — apply THE canonical wallet fixture (password read FROM the fixture).
-  // Env-gap resolution (docs/CLI-SPEC.md Part 4): flag > env RECIPE_WALLET_FIXTURE
-  // > the slot's canonical fixture.
-  const fixturePath = path.resolve(str(options, 'fixture') ?? process.env.RECIPE_WALLET_FIXTURE ?? canonicalFixture);
-  let status: 'pass' | 'fail';
-  if (adapter === 'mobile') {
-    // Grounded porcelain: mm-recipe setup-wallet [<fixture>].
-    const result = spawnPorcelain('mobile', ['setup-wallet', fixturePath], target, json);
-    status = result.status === 0 ? 'pass' : 'fail';
-  } else {
-    // Extension has no standalone porcelain set arm — reuse call's one-node
-    // machinery via the real engine path (metamask.wallet.setup in the manifest).
-    if (!fs.existsSync(fixturePath)) {
-      return usageOut(
-        json,
-        'fixtures',
-        `no wallet fixture at ${fixturePath}.\n  Create it (or pass --fixture <path>), then re-run: mm-harness fixtures set`,
-      );
-    }
-    const previousFixtureEnv = process.env.RECIPE_WALLET_FIXTURE;
-    process.env.RECIPE_WALLET_FIXTURE = fixturePath;
-    try {
-      const result = await deps.runOneNode('extension', 'metamask.wallet.setup', {}, target, str(options, 'actionManifest'));
-      status = result.status;
-    } finally {
-      if (previousFixtureEnv === undefined) delete process.env.RECIPE_WALLET_FIXTURE;
-      else process.env.RECIPE_WALLET_FIXTURE = previousFixtureEnv;
-    }
-  }
-
-  // Always teach where to customize the wallet.
-  const teaching = `Wallet fixture applied.  Want different accounts? Edit: ${canonicalFixture}`;
-  if (json) {
-    console.log(
-      JSON.stringify(
-        { schemaVersion: 1, command: 'fixtures', action: 'set', adapter, fixture: fixturePath, canonicalFixture, status, exitCode: status === 'pass' ? EXIT.ok : EXIT.runtime, message: teaching },
-        null,
-        2,
-      ),
-    );
-  } else {
-    console.error(teaching);
-  }
-  return status === 'pass' ? EXIT.ok : EXIT.runtime;
-}

package/runner/src/commands/logs.ts

@@ -1,60 +0,0 @@
-// logs — tail Metro/webpack + app logs by composing the porcelain `logs` (+
-// --full). Teaches (exit 2) when nothing is running for the checkout.
-
-import fs from 'node:fs';
-import path from 'node:path';
-
-import { recipeRuntimePath } from '../paths.ts';
-import { EXIT, flag, parseFlags, resolveAdapter, spawnPorcelain, str, targetOf, usageOut } from './shared.ts';
-
-const LOGS_BOOLEANS = new Set(['full', 'json']);
-
-export async function handleLogs(argv: string[]): Promise<number> {
-  const { options } = parseFlags(argv, LOGS_BOOLEANS);
-  const json = flag(options, 'json');
-  const target = targetOf(options);
-  const adapter = resolveAdapter(options, target);
-
-  if (!adapter) return usageOut(json, 'logs', `could not detect the MetaMask repo type for ${target}`);
-  if (adapter === 'core') return usageOut(json, 'logs', 'core is headless; there are no app/Metro logs.');
-
-  const source = str(options, 'source') ?? 'metro';
-  if (source !== 'metro' && source !== 'app') {
-    return usageOut(json, 'logs', '--source must be metro or app.');
-  }
-
-  // Env-gap flag (docs/CLI-SPEC.md Part 4): --events sets the compact event count
-  // the porcelain reads from RECIPE_LOG_EVENTS. Resolution is flag > env > default:
-  // the flag wins by setting the env; an absent flag leaves the agent/CI env alone.
-  const events = str(options, 'events');
-  if (events !== undefined) {
-    if (!/^\d+$/u.test(events)) return usageOut(json, 'logs', `--events must be numeric (got: ${events}).`);
-    process.env.RECIPE_LOG_EVENTS = events;
-  }
-
-  // Nothing running → teaching error pointing at launch. The log file is the
-  // signal that Metro/webpack has been started for this checkout.
-  const logFile = recipeRuntimePath(target, adapter === 'mobile' ? 'metro.log' : 'webpack.log');
-  if (!fs.existsSync(logFile)) {
-    const launchHint = adapter === 'mobile' ? 'mm-harness launch ios' : 'mm-harness launch';
-    return usageOut(
-      json,
-      'logs',
-      `nothing running for this checkout (no ${path.basename(logFile)}).\n  Start it first: ${launchHint}`,
-    );
-  }
-
-  const args = ['logs'];
-  if (flag(options, 'full')) args.push('--full');
-  const result = spawnPorcelain(adapter, args, target, json);
-  if (json) {
-    console.log(
-      JSON.stringify(
-        { schemaVersion: 1, command: 'logs', adapter, source, logFile, exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime },
-        null,
-        2,
-      ),
-    );
-  }
-  return result.status === 0 ? EXIT.ok : EXIT.runtime;
-}

package/runner/src/index.ts

@@ -1,6 +0,0 @@
-// Keep the package entrypoint narrow. CLI internals import path/runtime helpers
-// directly so consumers see only the runner factory, manifest, and doctor API.
-export { createDoctorReport } from './doctor.ts';
-export { loadActionManifest, validateManifest } from './manifest.ts';
-export { createMetaMaskExtensionRunner, createMetaMaskMobileRunner, createMetaMaskRunner } from './runner.ts';
-export type { CreateMetaMaskRunnerOptions, MetaMaskDoctorReport, MetaMaskRecipeAdapter } from './types.ts';