@deeeed/metamask-harness 0.80.0 → 0.81.0

package/dist/commands/list-executables.js

@@ -1,245 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { resolveActionManifest } from "../manifest.js";
-import { importRecipeProtocol } from "../paths.js";
-import { color, EXIT, optionFlag, optionString, optionStrings, resolveAdapter, shellQuoteArg } from "@farmslot/recipe-cli/harness";
-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
-};