@deeeed/metamask-harness 0.5.0 → 0.6.0

package/src/cli-commands.ts

@@ -1,250 +0,0 @@
-/**
- * cli-commands.ts — single source of truth for recipe CLI tab completion.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-interface CommandSpec {
-  name: string;
-  aliases?: string[];
-  desc?: string;
-  flags?: string[];
-  args?: string[];
-}
-
-interface CommandSpecMap {
-  shared: CommandSpec[];
-  extension: CommandSpec[];
-  mobile: CommandSpec[];
-  shim: CommandSpec[];
-}
-
-export const SPEC: CommandSpecMap = {
-  shim: [
-    { name: 'sync', desc: 'Copy fixture, write slot context, install harness', flags: ['--dry-run', '--no-install'] },
-    { name: 'help', aliases: ['-h', '--help'], desc: 'Show usage' },
-  ],
-  shared: [
-    { name: 'status', aliases: ['health', 'home'], desc: 'Home status + next commands', flags: ['--json'] },
-    { name: 'ports', desc: 'Slot ports and runtime paths', flags: ['--json'] },
-    { name: 'up', desc: 'Decide + run minimum work to reach ready', flags: ['--json', '--dry-run'] },
-    { name: 'sync', desc: 'Refresh harness + canonicalize wallet fixture', flags: ['--json'] },
-    { name: 'logs', aliases: ['tail'], desc: 'Compact build events or full log', flags: ['--full', '-f'] },
-    { name: 'debug', aliases: ['devtools', 'inspect'], desc: 'Open DevTools UI', flags: ['--json', '--no-open'] },
-    { name: 'actions', desc: 'List runnable recipe actions', flags: ['--json'] },
-    { name: 'doctor', desc: 'Check harness/orchestration health', flags: ['--json', '--target', '--adapter', '--runtime-dir'] },
-    { name: 'run', desc: 'Execute a proof recipe', args: ['recipe.json'] },
-    { name: 'interactive', aliases: ['menu'], desc: 'Interactive command menu' },
-    { name: 'prepare', desc: 'Install harness (+ optional validate)', flags: ['--target', '--runtime-dir', '--json'] },
-    { name: 'runtime-status', desc: 'Structured runtime status JSON', flags: ['--json', '--target', '--cdp-port', '--runtime-dir'] },
-  ],
-  extension: [
-    { name: 'decision', aliases: ['decide'], desc: 'Runtime decision (what next?)' },
-    { name: 'update', aliases: ['sync-runtime'], desc: 'Perform recommended runtime action' },
-    { name: 'ready', aliases: ['ensure-ready'], desc: 'Ensure one healthy extension home tab' },
-    { name: 'watch', aliases: ['start-watch', 'watcher'], desc: 'Start/reuse webpack watcher', flags: ['--full', '-f'] },
-    { name: 'stop', aliases: ['stop-watch', 'stop-watcher'], desc: 'Stop this checkout watcher' },
-    { name: 'rebuild', aliases: ['reset', 'reopen', 'reload', 'browser', 'launch', 'full-launch', 'runtime-launch', 'build', 'build:once', 'build-once', 'refresh-once'], desc: 'Clean webpack + browser launch', flags: ['--json', '--dry-run', '--full'] },
-    { name: 'sidepanel', desc: 'Side panel helper', args: ['cycle', 'open', 'close', 'toggle', 'status'] },
-    { name: 'prepare', flags: ['--target', '--cdp-port', '--runtime-dir', '--validate'] },
-    { name: 'debug', args: ['page', 'worker'], flags: ['--json', '--no-open'] },
-  ],
-  mobile: [
-    { name: 'ios', aliases: ['start'], desc: 'Start Metro + launch iOS dev client' },
-    { name: 'android', desc: 'Start Metro + launch Android dev client' },
-    { name: 'setup:ios', desc: 'iOS launch + wallet fixture setup' },
-    { name: 'setup:android', desc: 'Android launch + wallet fixture setup' },
-    { name: 'stop', desc: 'Stop Metro for this slot' },
-    { name: 'app-status', aliases: ['bridge-status'], desc: 'Bridge/runtime status' },
-    { name: 'route', aliases: ['get-route'], desc: 'Current navigation route' },
-    { name: 'navigate', desc: 'Navigate by route name', args: ['RouteName'] },
-    { name: 'back', aliases: ['go-back'], desc: 'Navigate back' },
-    { name: 'unlock', desc: 'Unlock with fixture password', args: ['password'] },
-    { name: 'setup-wallet', aliases: ['wallet-setup'], desc: 'Apply wallet fixture', args: ['fixture.json'] },
-    { name: 'accounts', aliases: ['list-accounts'], desc: 'List accounts' },
-    { name: 'select-account', aliases: ['switch-account'], desc: 'Switch account', args: ['address'] },
-    { name: 'screenshot', desc: 'Capture simulator/device screenshot', args: ['path'] },
-    { name: 'dev-menu', aliases: ['devmenu'], desc: 'Open RN developer menu', flags: ['--json', '--no-open'] },
-    { name: 'prepare', flags: ['--target', '--platform', '--preflight-mode', '--port', '--simulator', '--adb-serial', '--runtime-dir', '--wallet-setup', '--wallet-fixture'] },
-    { name: 'debug', flags: ['--json', '--no-open', '--action'] },
-  ],
-};
-
-const GLOBAL_FLAGS = ['--json', '--dry-run', '--full', '-f', '--help', '-h', '--no-open', '--no-color'];
-
-function mergeCommands(adapter: string): CommandSpec[] {
-  const byName = new Map<string, CommandSpec & { aliases: string[]; flags: string[]; args: string[] }>();
-  const add = (cmd: CommandSpec) => {
-    const existing = byName.get(cmd.name);
-    if (!existing) {
-      byName.set(cmd.name, {
-        ...cmd,
-        aliases: [...(cmd.aliases || [])],
-        flags: [...(cmd.flags || [])],
-        args: [...(cmd.args || [])],
-      });
-      return;
-    }
-    existing.aliases = [...new Set([...(existing.aliases || []), ...(cmd.aliases || [])])];
-    existing.flags = [...new Set([...(existing.flags || []), ...(cmd.flags || [])])];
-    existing.args = [...new Set([...(existing.args || []), ...(cmd.args || [])])];
-    if (!existing.desc && cmd.desc) existing.desc = cmd.desc;
-  };
-  for (const cmd of SPEC.shared) add(cmd);
-  for (const cmd of SPEC[adapter as keyof CommandSpecMap] || []) add(cmd);
-  return [...byName.values()];
-}
-
-export function commandTokens(adapter: string, { includeAliases = true }: { includeAliases?: boolean } = {}): string[] {
-  const tokens = new Set<string>();
-  for (const cmd of mergeCommands(adapter)) {
-    tokens.add(cmd.name);
-    if (includeAliases) for (const alias of cmd.aliases || []) tokens.add(alias);
-  }
-  return [...tokens].sort();
-}
-
-export function shimCommandTokens(): string[] {
-  const tokens = new Set<string>();
-  for (const cmd of SPEC.shim) {
-    tokens.add(cmd.name);
-    for (const alias of cmd.aliases || []) tokens.add(alias);
-  }
-  return [...tokens].sort();
-}
-
-export function lookupCommand(adapter: string, token: string): CommandSpec | null {
-  for (const cmd of mergeCommands(adapter)) {
-    if (cmd.name === token) return cmd;
-    if ((cmd.aliases || []).includes(token)) return cmd;
-  }
-  for (const cmd of SPEC.shim) {
-    if (cmd.name === token) return cmd;
-    if ((cmd.aliases || []).includes(token)) return cmd;
-  }
-  return null;
-}
-
-export function flagsForPosition(adapter: string, commandToken: string): string[] {
-  const cmd = lookupCommand(adapter, commandToken);
-  const flags = new Set(GLOBAL_FLAGS);
-  if (cmd) for (const flag of cmd.flags || []) flags.add(flag);
-  return [...flags].sort();
-}
-
-export function argsForPosition(adapter: string, commandToken: string, argIndex: number): string[] {
-  const cmd = lookupCommand(adapter, commandToken);
-  if (!cmd?.args?.length) return [];
-  const value = cmd.args[Math.max(0, argIndex)];
-  return value ? [value] : cmd.args;
-}
-
-const RUN_RECIPE_DIRS: ((adapter: string, root: string) => string)[] = [
-  (adapter, root) => path.join(root, 'temp/recipe/harness', adapter, 'runner/recipes'),
-  (adapter, root) => path.join(root, 'temp/agentic/recipe-harness', adapter, 'runner/recipes'),
-];
-
-export function listRunRecipes(adapter: string, root: string, cwd = process.cwd()): string[] {
-  const byBase = new Map<string, string>();
-  for (const resolveDir of RUN_RECIPE_DIRS) {
-    const dir = resolveDir(adapter, root);
-    if (!fs.existsSync(dir)) continue;
-    for (const name of fs.readdirSync(dir)) {
-      if (!name.endsWith('.recipe.json') || byBase.has(name)) continue;
-      byBase.set(name, path.join(dir, name));
-    }
-  }
-  return [...byBase.values()]
-    .map((abs) => path.relative(cwd, abs))
-    .sort();
-}
-
-function usage(): void {
-  process.stderr.write(`Usage:
-  cli-commands dump --adapter extension|mobile|shim [--aliases]
-  cli-commands describe --adapter extension|mobile|shim
-  cli-commands flags --adapter <adapter> --command <name>
-  cli-commands args --adapter <adapter> --command <name> [--index <n>]
-  cli-commands run-recipes --adapter extension|mobile --root <repo> [--cwd <dir>]
-  cli-commands global-flags
-`);
-}
-
-async function main(): Promise<void> {
-  const { parseArgs: parseArgsUtil } = await import('node:util');
-  const { values, positionals } = parseArgsUtil({
-    allowPositionals: true,
-    args: process.argv.slice(2),
-    options: {
-      adapter: { type: 'string' },
-      command: { type: 'string' },
-      aliases: { type: 'boolean', default: true },
-      index: { type: 'string', default: '0' },
-      root: { type: 'string' },
-      cwd: { type: 'string' },
-    },
-  });
-
-  const command = positionals[0];
-  if (!command || command === '--help' || command === '-h') {
-    usage();
-    process.exit(command ? 0 : 2);
-  }
-
-  if (command === 'global-flags') {
-    process.stdout.write(`${GLOBAL_FLAGS.join('\n')}\n`);
-    return;
-  }
-
-  const adapter = values.adapter;
-  if (!adapter && command !== 'global-flags') {
-    usage();
-    process.exit(2);
-  }
-
-  if (command === 'dump') {
-    process.stdout.write(`${commandTokens(adapter as string, { includeAliases: values.aliases }).join('\n')}\n`);
-    return;
-  }
-
-  if (command === 'describe') {
-    const rows = adapter === 'shim' ? SPEC.shim : mergeCommands(adapter as string);
-    for (const cmd of rows) {
-      const aliases = (cmd.aliases || []).join('|');
-      const label = aliases ? `${cmd.name}|${aliases}` : cmd.name;
-      process.stdout.write(`${label}\t${cmd.desc || cmd.name}\n`);
-    }
-    return;
-  }
-
-  if (command === 'flags') {
-    process.stdout.write(`${flagsForPosition(adapter as string, values.command || '').join('\n')}\n`);
-    return;
-  }
-
-  if (command === 'args') {
-    const index = Number.parseInt(values.index as string, 10) || 0;
-    process.stdout.write(`${argsForPosition(adapter as string, values.command || '', index).join('\n')}\n`);
-    return;
-  }
-
-  if (command === 'run-recipes') {
-    const root = values.root ? path.resolve(values.root) : process.cwd();
-    const cwd = values.cwd ? path.resolve(values.cwd) : process.cwd();
-    process.stdout.write(`${listRunRecipes(adapter as string, root, cwd).join('\n')}\n`);
-    return;
-  }
-
-  usage();
-  process.exit(2);
-}
-
-const _filename = fileURLToPath(import.meta.url);
-const isMain = process.argv[1] && path.resolve(process.argv[1]) === _filename;
-if (isMain) {
-  main().catch((error: unknown) => {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
-    process.exit(1);
-  });
-}

package/src/cli-version.ts

@@ -1,141 +0,0 @@
-/**
- * cli-version.ts — detect stale installed harness scripts vs the active runner.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { parseArgs } from 'node:util';
-
-function readJson(file: string): unknown {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-function readPackageVersion(dir: string): string {
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')) as { version?: string };
-    return pkg.version || 'unknown';
-  } catch {
-    return 'unknown';
-  }
-}
-
-function gitHead(dir: string): string {
-  const result = spawnSync('git', ['-C', dir, 'rev-parse', 'HEAD'], { encoding: 'utf8' });
-  return result.status === 0 ? result.stdout.trim() : 'unknown';
-}
-
-interface HarnessCheckInput {
-  runnerRoot: string;
-  manifestPath: string;
-  installedShaPath?: string;
-}
-
-interface HarnessCheckResult {
-  stale: boolean;
-  reasons: string[];
-  installedRevision?: string | null;
-  currentRevision?: string;
-  installedVersion?: string | null;
-  currentVersion?: string;
-  manifest?: string;
-}
-
-export function checkHarness({ runnerRoot, manifestPath }: HarnessCheckInput): HarnessCheckResult {
-  const manifest = readJson(manifestPath);
-  const reasons: string[] = [];
-  if (!manifest) {
-    return { stale: false, reasons: ['no harness manifest'] };
-  }
-
-  const currentRevision = gitHead(runnerRoot);
-  const currentVersion = readPackageVersion(runnerRoot);
-  const manifestRecord = manifest as Record<string, unknown>;
-  const source = manifestRecord.source as Record<string, unknown> | undefined;
-  const installedRevision = (source?.runnerRevision as string) || null;
-  const installedVersion = (manifestRecord.runnerPackageVersion as string) || null;
-
-  if (installedRevision && installedRevision !== 'unknown' && installedRevision !== currentRevision) {
-    reasons.push(`runner revision ${installedRevision.slice(0, 8)} != ${currentRevision.slice(0, 8)}`);
-  }
-  if (installedVersion && installedVersion !== currentVersion) {
-    reasons.push(`runner package ${installedVersion} != ${currentVersion}`);
-  }
-
-  return {
-    stale: reasons.length > 0,
-    reasons,
-    installedRevision,
-    currentRevision,
-    installedVersion,
-    currentVersion,
-  };
-}
-
-function usage(): void {
-  console.error(`Usage:
-  cli-version check --runner-root <dir> --manifest <path> [--installed-sha <path>] [--json]`);
-}
-
-async function main(): Promise<void> {
-  const [command, ...rest] = process.argv.slice(2);
-  const { values } = parseArgs({
-    args: rest,
-    allowPositionals: false,
-    options: {
-      'runner-root': { type: 'string' },
-      manifest: { type: 'string' },
-      'installed-sha': { type: 'string' },
-      json: { type: 'boolean', default: false },
-    },
-  });
-
-  if (!command || command === '--help' || command === '-h') {
-    usage();
-    process.exit(command ? 0 : 2);
-  }
-
-  if (command !== 'check') {
-    usage();
-    process.exit(2);
-  }
-
-  const runnerRoot = values['runner-root'];
-  const manifestPath = values.manifest;
-  if (!runnerRoot || !manifestPath) {
-    usage();
-    process.exit(2);
-  }
-
-  const payload: HarnessCheckResult & { manifest: string } = {
-    ...checkHarness({
-      runnerRoot,
-      manifestPath,
-      installedShaPath: values['installed-sha'],
-    }),
-    manifest: manifestPath,
-  };
-
-  if (values.json) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-    return;
-  }
-
-  if (payload.stale) {
-    process.stderr.write(`recipe: harness stale (${payload.reasons.join('; ')})\n`);
-    process.stderr.write('recipe: run: recipe sync\n');
-    process.exit(1);
-  }
-  process.stdout.write('harness up to date\n');
-}
-
-const isMain = process.argv[1] && path.resolve(process.argv[1]) === path.resolve(import.meta.filename ?? '');
-if (isMain) {
-  main().catch((error: unknown) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  });
-}