@deeeed/metamask-harness 0.79.0 → 0.81.0

package/dist/commands/last.js

@@ -1,60 +0,0 @@
-import { readCommandJournal } from "../command-journal.js";
-import { EXIT } from "./shared.js";
-import {
-  optionFlag,
-  optionString,
-  shellQuote,
-  targetPath
-} from "./parse-args.js";
-async function handleLast({ options }) {
-  const target = targetPath(options);
-  const { file, record } = readCommandJournal(target, optionString(options, "runtimeDir"));
-  const json = optionFlag(options, "json");
-  if (!record) {
-    const message = `no resumability journal exists for ${target}`;
-    const userAction = "run a proof or runtime command in this checkout, then re-run mm-harness last --json";
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "last",
-        target,
-        journalPath: file,
-        status: "fail",
-        exitCode: EXIT.runtime,
-        error: { code: "LAST_NOT_FOUND", message, userAction }
-      }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness last: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.runtime;
-  }
-  if (json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "last",
-      target,
-      journalPath: file,
-      status: "pass",
-      exitCode: EXIT.ok,
-      last: record
-    }, null, 2));
-  } else {
-    const end = record.finishedAt ?? "still running or interrupted";
-    console.log(`${record.verdict.toUpperCase()} ${record.command} (exit ${record.exitCode ?? "pending"})`);
-    console.log(`command: mm-harness ${record.command}${record.args.length > 0 ? ` ${record.args.map(shellQuote).join(" ")}` : ""}`);
-    console.log(`started: ${record.startedAt}`);
-    console.log(`finished: ${end}`);
-    if (record.evidencePaths.length > 0) {
-      console.log("evidence:");
-      for (const evidence of record.evidencePaths) console.log(`  ${evidence}`);
-    } else {
-      console.log("evidence: none recorded");
-    }
-    console.log(`journal: ${file}`);
-  }
-  return EXIT.ok;
-}
-export {
-  handleLast
-};

package/dist/commands/launch/index.js

@@ -1,109 +0,0 @@
-import fs from "node:fs";
-import { getAdapterSurface } from "../../adapters/surface.js";
-import {
-  ADAPTER_DETECT_NEXT,
-  checkoutBusyOut,
-  EXIT,
-  flag,
-  parseFlags,
-  resolveAdapter,
-  str,
-  targetOf,
-  usageOut
-} from "../shared.js";
-import { parseHeal } from "../../heal-bounds.js";
-import { acquireCheckoutLock } from "../../checkout-lock.js";
-import { JsonStreamWriter } from "../../json-stream.js";
-import { shellQuote } from "./quote.js";
-const LAUNCH_BOOLEANS = /* @__PURE__ */ new Set([
-  "build",
-  "watch",
-  "verify",
-  "sidepanel",
-  "fullscreen",
-  "runway",
-  "clearMetro",
-  "json",
-  "jsonStream",
-  "freshProfile",
-  "headless",
-  "headful"
-]);
-async function handleLaunch(argv) {
-  const { options } = parseFlags(argv, LAUNCH_BOOLEANS);
-  const json = flag(options, "json");
-  const stream = new JsonStreamWriter("launch", flag(options, "jsonStream"));
-  const jsonOutput = json && !stream.enabled;
-  const restoreStdout = stream.isolateStdout();
-  const target = targetOf(options);
-  try {
-    let exitCode;
-    if (!fs.existsSync(target)) {
-      exitCode = await handleLaunchLocked(argv, stream);
-    } else {
-      const lock = acquireCheckoutLock(target, "launch");
-      if ("message" in lock) {
-        const userAction = `wait for the current owner, or inspect ${lock.path} if its process has exited`;
-        stream.error({ code: "SANDBOX_BUSY", message: lock.message, userAction });
-        exitCode = checkoutBusyOut(jsonOutput, "launch", lock.message, lock.path);
-      } else {
-        try {
-          exitCode = await handleLaunchLocked(argv, stream);
-        } finally {
-          lock.release();
-        }
-      }
-    }
-    stream.complete(exitCode === EXIT.ok ? "pass" : "fail", exitCode);
-    return exitCode;
-  } catch (error) {
-    const exitCode = error !== null && typeof error === "object" && "exitCode" in error && typeof error.exitCode === "number" ? error.exitCode : EXIT.runtime;
-    stream.error({
-      code: exitCode === EXIT.usage ? "CLI_USAGE_ERROR" : "LAUNCH_FAILED",
-      message: error instanceof Error ? error.message : String(error),
-      userAction: `mm-harness doctor --target ${shellQuote(target)} --json`
-    });
-    stream.complete("fail", exitCode);
-    throw error;
-  } finally {
-    restoreStdout();
-  }
-}
-async function handleLaunchLocked(argv, stream) {
-  const { positional, options } = parseFlags(argv, LAUNCH_BOOLEANS);
-  const json = flag(options, "json");
-  const jsonOutput = json && !stream.enabled;
-  const machine = json || stream.enabled;
-  const target = targetOf(options);
-  const heal = parseHeal(options, "auto");
-  if (typeof heal !== "string") return launchUsage(jsonOutput, stream, heal.error, "use --heal off|infra-only|auto");
-  const posToken = positional[0];
-  const mobileTargetToken = posToken === "ios" || posToken === "android" ? posToken : void 0;
-  const platformFlag = str(options, "platform");
-  const platformMobileToken = platformFlag === "ios" || platformFlag === "android" ? platformFlag : void 0;
-  const mobileTarget = mobileTargetToken ?? platformMobileToken;
-  const adapterHint = mobileTarget ? "mobile" : void 0;
-  const adapter = resolveAdapter(options, target, adapterHint);
-  if (!adapter) {
-    return launchUsage(jsonOutput, stream, `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
-  }
-  stream.phase("resolve", { target, adapter, platform: mobileTarget ?? null });
-  return getAdapterSurface(adapter).launch({
-    adapter,
-    target,
-    options,
-    mobileTarget,
-    heal,
-    jsonOutput,
-    machine,
-    stream,
-    usage: (message, userAction) => launchUsage(jsonOutput, stream, message, userAction)
-  });
-}
-function launchUsage(json, stream, message, userAction) {
-  stream.error({ code: "USAGE", message, userAction });
-  return usageOut(json, "launch", message, userAction);
-}
-export {
-  handleLaunch
-};

package/dist/commands/list-executables.js

@@ -1,247 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { resolveActionManifest } from "../manifest.js";
-import { importRecipeProtocol } from "../paths.js";
-import { color } from "../cli-color.js";
-import { EXIT } from "./shared.js";
-import { optionFlag, optionString, optionStrings, resolveAdapter, shellQuoteArg } from "./parse-args.js";
-import { actionDomain, describeManifestActions, renderHumanActionCatalog } from "./manifest.js";
-import { shortActionNames } from "@farmslot/recipe-cli";
-import {
-  describeRunnableRecipe,
-  listRunnableRecipes,
-  resolveMetaMaskLibrarySources
-} from "./run-engine.js";
-const recipeDomain = (name) => name.includes(".") ? name.split(".")[0].replaceAll("_", "-") : "general";
-function catalogDescription(description) {
-  if (!description) return "";
-  const firstSentence = description.match(/^.*?[.!?](?:\s|$)/u)?.[0]?.trim() ?? description;
-  return firstSentence.length <= 180 ? firstSentence : `${firstSentence.slice(0, 177).trimEnd()}\u2026`;
-}
-async function handleListExecutables(command, options) {
-  const json = optionFlag(options, "json");
-  const { adapter } = resolveAdapter(options);
-  const domainFilter = optionString(options, "domain")?.replaceAll("_", "-");
-  const sourceFilter = optionString(options, "source");
-  const sort = optionString(options, "sort") ?? (json ? "name" : "domain");
-  const groupKey = (entry, domain) => sort === "library" ? entry.source : sort === "domain" ? domain : "";
-  const select = (available2, domainOf) => available2.filter((entry) => (!domainFilter || domainOf(entry) === domainFilter) && (!sourceFilter || entry.source === sourceFilter)).sort((left, right) => groupKey(left, domainOf(left)).localeCompare(groupKey(right, domainOf(right))) || left.name.localeCompare(right.name));
-  const out = (style, text) => color(style, text, { stream: process.stdout });
-  const stylesFor = (domains) => {
-    const palette = ["label", "accent", "ok", "warn"];
-    return new Map([...new Set(domains)].sort().map((domain, index) => [domain, palette[index % palette.length]]));
-  };
-  const librarySources = await resolveMetaMaskLibrarySources(optionStrings(options, "library"));
-  const libraryLines = () => {
-    const lines = ["Libraries loaded:"];
-    for (const source of librarySources ?? []) {
-      const name = source.name ?? path.basename(source.root);
-      const kind = source.provenance?.kind === "bundled" ? "bundled" : "linked";
-      lines.push(`  ${out("bold", name)} ${kind} \xB7 ${source.root}`);
-    }
-    if (domainFilter || sourceFilter) {
-      lines.push(`Filter: ${[domainFilter && `domain=${domainFilter}`, sourceFilter && `source=${sourceFilter}`].filter(Boolean).join(" ")}`);
-    }
-    return lines;
-  };
-  if (command === "run") {
-    const available2 = await listRunnableRecipes(adapter, librarySources);
-    const recipes = select(available2, (recipe) => recipeDomain(recipe.name));
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command, action: "list", adapter, recipes }, null, 2));
-      return EXIT.ok;
-    }
-    const domainStyles = stylesFor(available2.map((recipe) => recipeDomain(recipe.name)));
-    console.log(out("bold", `runnable recipes (${adapter})`));
-    for (const line of libraryLines()) console.log(line);
-    console.log(out("comment", "Inspect: mm-harness run <recipe> --describe"));
-    if (recipes.length === 0) {
-      console.log("No runnable recipes match.");
-      console.log(`Available domains: ${[...domainStyles.keys()].join(", ") || "none"}`);
-      console.log(`Available sources: ${[...new Set(available2.map((recipe) => recipe.source))].join(", ") || "none"}`);
-    }
-    const groups = /* @__PURE__ */ new Map();
-    for (const recipe of recipes) {
-      const group = groupKey(recipe, recipeDomain(recipe.name));
-      groups.set(group, [...groups.get(group) ?? [], recipe]);
-    }
-    for (const [group, entries] of groups) {
-      if (group) {
-        const label = sort === "library" ? `Library: ${group}` : group;
-        console.log(`
-${out(sort === "domain" ? domainStyles.get(group) : "bold", label)} ${out("dim", `(${entries.length})`)}`);
-      }
-      for (const recipe of entries) {
-        const style = domainStyles.get(recipeDomain(recipe.name));
-        const shadowed = recipe.shadows.length > 0 ? ` shadows=${recipe.shadows.join(",")}` : "";
-        const variant = recipe.variant ? ` variant=${recipe.variant}` : " variant=all";
-        const summary = catalogDescription(recipe.description);
-        console.log(`  ${out(style, recipe.name)} ${out("dim", `library=${recipe.source}${variant}${shadowed}`)}`);
-        if (summary) console.log(`    ${summary}`);
-      }
-    }
-    return EXIT.ok;
-  }
-  const { manifest, actionSources } = await resolveActionManifest(
-    adapter,
-    optionString(options, "actionManifest"),
-    librarySources
-  );
-  const { getRecipeActionManifestActionNames } = await importRecipeProtocol();
-  const protocolNames = new Set(getRecipeActionManifestActionNames(manifest));
-  const available = describeManifestActions(manifest, actionSources).filter((entry) => protocolNames.has(entry.name)).sort((left, right) => left.name.localeCompare(right.name));
-  const described = select(available, actionDomain);
-  const shortByName = shortActionNames(available.map((entry) => entry.name));
-  const actions = described.map((entry) => ({
-    name: entry.name,
-    short: shortByName.get(entry.name) ?? null,
-    description: entry.description,
-    fields: entry.fields,
-    source: entry.source,
-    sourceTier: entry.sourceTier,
-    sourceManifest: entry.sourceManifest,
-    shadows: entry.shadows
-  }));
-  if (json) {
-    console.log(JSON.stringify({ schemaVersion: 1, command, action: "list", adapter, actions }, null, 2));
-    return EXIT.ok;
-  }
-  const contextLines = libraryLines();
-  if (described.length === 0) {
-    contextLines.push(`Available domains: ${[...new Set(available.map(actionDomain))].sort().join(", ") || "none"}`);
-    contextLines.push(`Available sources: ${[...new Set(available.map((entry) => entry.source))].sort().join(", ") || "none"}`);
-  }
-  console.log(renderHumanActionCatalog(described, {
-    title: `invocable actions (${adapter})`,
-    guidance: "Use: mm-harness call <name>  \xB7  short names shown first where unambiguous",
-    sort,
-    domainStyles: stylesFor(available.map(actionDomain)),
-    contextLines,
-    displayName: (entry) => {
-      const short = shortByName.get(entry.name);
-      return short ? `${short} (${entry.name})` : `${entry.name} (full name only \u2014 ambiguous short)`;
-    }
-  }));
-  return EXIT.ok;
-}
-async function handleDescribeRecipe(recipeArg, options) {
-  const json = optionFlag(options, "json");
-  const { adapter } = resolveAdapter(options);
-  const libraryEntries = optionStrings(options, "library");
-  const directRecipePath = path.resolve(recipeArg);
-  const librarySources = await resolveMetaMaskLibrarySources(
-    libraryEntries,
-    fs.existsSync(directRecipePath) ? directRecipePath : void 0
-  );
-  const result = await describeRunnableRecipe(recipeArg, adapter, librarySources);
-  const targetEntry = optionString(options, "target");
-  const replayTarget = targetEntry ? path.resolve(targetEntry) : void 0;
-  const contextFlags = [
-    `--adapter ${adapter}`,
-    ...libraryEntries?.map((entry) => `--library ${shellQuoteArg(entry)}`) ?? [],
-    ...replayTarget ? [`--target ${shellQuoteArg(replayTarget)}`] : []
-  ].join(" ");
-  const discoveryCommand = `mm-harness run --list ${contextFlags}`;
-  if ("notFound" in result || "unreadable" in result) {
-    const code = "notFound" in result ? "RECIPE_NOT_FOUND" : "RECIPE_UNPARSEABLE";
-    const message = "notFound" in result ? result.notFound : result.unreadable;
-    const userAction = "notFound" in result ? discoveryCommand : `fix ${shellQuoteArg(recipeArg)}, then retry: mm-harness run ${shellQuoteArg(recipeArg)} --describe ${contextFlags}`;
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "run",
-        action: "describe",
-        status: "fail",
-        error: { code, message, userAction },
-        exitCode: EXIT.usage
-      }, null, 2));
-    } else {
-      console.error(`\u2717 run: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  const recipe = result.recipe;
-  const parameterArgs = recipe.parameters.filter((parameter) => parameter.required && !Object.hasOwn(parameter, "default")).map((parameter) => `${parameter.name}=${shellQuoteArg(exampleParameterValue(parameter))}`);
-  const runCommand = [
-    "mm-harness run",
-    shellQuoteArg(recipeArg),
-    ...parameterArgs,
-    contextFlags
-  ].filter(Boolean).join(" ");
-  const nextCommand = `${runCommand} --plan`;
-  if (json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "run",
-      action: "describe",
-      status: "pass",
-      recipe,
-      runCommand,
-      nextCommand
-    }, null, 2));
-    return EXIT.ok;
-  }
-  const out = (style, text) => color(style, text, { stream: process.stdout });
-  console.log(out("bold", `recipe ${recipe.name}`));
-  if (recipe.title) console.log(`  ${out("label", "title:")} ${recipe.title}`);
-  if (recipe.description) console.log(`  ${out("label", "description:")} ${recipe.description}`);
-  console.log(`  ${out("label", "adapter:")} ${recipe.adapter}`);
-  console.log(`  ${out("label", "source:")} ${recipe.source} \xB7 ${recipe.file}`);
-  console.log(`  ${out("label", "path:")} ${out("path", recipe.path)}`);
-  if (recipe.$schema) console.log(`  ${out("label", "schema:")} ${recipe.$schema}`);
-  console.log(`  ${out("label", "variant:")} ${recipe.variant ?? "all adapters"}`);
-  if (recipe.shadows.length > 0) {
-    console.log(`  ${out("label", "shadows:")} ${recipe.shadows.join(", ")}`);
-  }
-  if (recipe.parameters.length === 0) {
-    console.log(`  ${out("label", "parameters:")} none`);
-  } else {
-    console.log(`  ${out("label", `parameters (${recipe.parameters.length})`)}`);
-    for (const parameter of recipe.parameters) {
-      const required = parameter.required ? " required" : "";
-      const defaultValue = Object.hasOwn(parameter, "default") ? ` default=${compactValue(parameter.default)}` : "";
-      const choices = parameter.enum ? ` choices=${compactValue(parameter.enum)}` : "";
-      const description = parameter.description ? ` \u2014 ${parameter.description}` : "";
-      console.log(
-        `    ${out("cmd", parameter.name)}${parameter.type ? ` (${parameter.type})` : ""}${required}${defaultValue}${choices}${description}`
-      );
-    }
-  }
-  renderComposition("actions", recipe.actions, out);
-  renderComposition("called recipes", recipe.nestedRecipes, out);
-  if (recipe.unresolvedRecipes.length > 0) {
-    renderComposition("unresolved recipes", recipe.unresolvedRecipes, out);
-  }
-  console.log(`  ${out("comment", `Run: ${runCommand}`)}`);
-  console.log(`  ${out("comment", `Next: ${nextCommand}`)}`);
-  return EXIT.ok;
-}
-function exampleParameterValue(parameter) {
-  if (parameter.enum && parameter.enum.length > 0) return stringifyAssignmentValue(parameter.enum[0]);
-  if (parameter.type === "boolean") return "false";
-  if (parameter.type === "number" || parameter.type === "integer") return "0";
-  if (parameter.type === "array") return "[]";
-  if (parameter.type === "object") return "{}";
-  return "value";
-}
-function stringifyAssignmentValue(value) {
-  return typeof value === "string" ? value : JSON.stringify(value) ?? String(value);
-}
-function compactValue(value) {
-  const rendered = JSON.stringify(value);
-  if (rendered === void 0) return String(value);
-  return rendered.length <= 180 ? rendered : `${rendered.slice(0, 177)}\u2026`;
-}
-function renderComposition(label, values, out) {
-  if (values.length === 0) {
-    console.log(`  ${out("label", `${label}:`)} none`);
-    return;
-  }
-  console.log(`  ${out("label", `${label} (${values.length})`)}`);
-  for (const value of values) console.log(`    ${out("cmd", value)}`);
-}
-export {
-  handleDescribeRecipe,
-  handleListExecutables
-};