@deeeed/metamask-harness 0.92.21 → 0.92.23

package/dist/commands/checklist.js

@@ -1,242 +0,0 @@
-import { EXIT } from "@farmslot/recipe-cli/harness";
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { HANDOFF_INPUT } from "@farmslot/agent-runtime";
-import { enumerateChecklistCheckboxes, isTerminalWorkerSignalStatus } from "@farmslot/protocol";
-const require2 = createRequire(import.meta.url);
-const MARK_SCRIPT = require2.resolve(
-  "@farmslot/agent-runtime/scripts/mark-checklist-step.cjs"
-);
-const { resolveChecklistPaths } = require2(
-  "@farmslot/agent-runtime/scripts/checklist-target.cjs"
-);
-const { readSubtaskIndex, SubtaskRefusal } = require2("@farmslot/agent-runtime/scripts/subtask-unit.cjs");
-const USAGE = "mm-harness checklist <mark <task-dir> <step> | closeout <task-dir>> [options]";
-const CHECKLIST_VALUE_OPTIONS = /* @__PURE__ */ new Set([
-  "--reason",
-  "--checklist",
-  "--signal",
-  "--config",
-  "--destination",
-  "--metadata"
-]);
-function parseChecklistArgv(argv) {
-  const positionals = [];
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index] ?? "";
-    if (arg.startsWith("-")) {
-      const option = arg.split("=", 1)[0] ?? arg;
-      if (CHECKLIST_VALUE_OPTIONS.has(option) && !arg.includes("=")) index += 1;
-      continue;
-    }
-    positionals.push({ index, value: arg });
-  }
-  const consumed = new Set(positionals.slice(0, 2).map(({ index }) => index));
-  return {
-    action: positionals[0]?.value,
-    taskDir: positionals[1]?.value,
-    step: positionals[2]?.value,
-    forwarded: argv.filter((_, index) => !consumed.has(index))
-  };
-}
-function handoffCommand() {
-  if (process.env.HANDOFF_BIN) {
-    try {
-      fs.accessSync(process.env.HANDOFF_BIN, fs.constants.X_OK);
-      return { command: process.env.HANDOFF_BIN, prefix: [] };
-    } catch {
-      return { command: process.execPath, prefix: [process.env.HANDOFF_BIN] };
-    }
-  }
-  return {
-    command: process.execPath,
-    prefix: [require2.resolve("@farmslot/handoff/cli")]
-  };
-}
-function closeoutArgs(taskDir, args) {
-  const normalized = args.flatMap((arg) => {
-    const option = ["--config", "--destination", "--metadata"].find(
-      (name) => arg.startsWith(`${name}=`)
-    );
-    return option ? [option, arg.slice(option.length + 1)] : [arg];
-  });
-  if (process.env.METAMASK_AGENTIC_LEARNINGS_DIR && !normalized.includes("--destination")) {
-    return [
-      "closeout",
-      taskDir,
-      ...normalized,
-      "--destination",
-      process.env.METAMASK_AGENTIC_LEARNINGS_DIR
-    ];
-  }
-  return ["closeout", taskDir, ...normalized];
-}
-function runCloseout(taskDir, args, stdio) {
-  try {
-    const { command, prefix } = handoffCommand();
-    return spawnSync(command, [...prefix, ...closeoutArgs(taskDir, args)], {
-      encoding: "utf8",
-      stdio
-    });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      status: 1,
-      stdout: "",
-      stderr: message,
-      error: new Error(message)
-    };
-  }
-}
-function stageLearningPackage(taskDir, step, markArgs) {
-  if (!["complete", "no-change"].includes(step ?? "") || markArgs.includes("--skip-learnings") || !fs.existsSync(path.join(taskDir, HANDOFF_INPUT))) {
-    return;
-  }
-  try {
-    const result = runCloseout(taskDir, ["--json"], "pipe");
-    if (result.status === 0) return;
-  } catch {
-  }
-  console.error(
-    `Warning: learning capture could not be staged; rerun: mm-harness checklist closeout ${taskDir}; task verdict is unchanged.`
-  );
-}
-function terminalSignalStatus(taskDir) {
-  const { signalPath } = resolveChecklistPaths(taskDir);
-  let signal;
-  try {
-    signal = JSON.parse(fs.readFileSync(signalPath, "utf8"));
-  } catch {
-    return null;
-  }
-  return isTerminalWorkerSignalStatus(signal.status) ? signal.status ?? null : null;
-}
-function preserveTerminalSignal(taskDir, step) {
-  if (step !== "start" && numericMarkStep(step) === null) return false;
-  const status = terminalSignalStatus(taskDir);
-  if (!status) return false;
-  console.log(
-    `signal already terminal: status=${status}; ignoring non-terminal mark ${step}`
-  );
-  return true;
-}
-function numericMarkStep(step) {
-  const stepNumber = Number(step);
-  return Number.isInteger(stepNumber) && stepNumber >= 1 ? stepNumber : null;
-}
-function checklistStepRequiresDiffPass(checklist, stepNumber) {
-  const step = enumerateChecklistCheckboxes(checklist).find((item) => item.stepNumber === stepNumber);
-  return step !== void 0 && /mm-harness check diff/u.test(step.rawLabel);
-}
-function checkDiffGateReady(taskDir, step, parentChecklist) {
-  const stepNumber = numericMarkStep(step);
-  if (stepNumber === null) return true;
-  const taskPath = parentChecklist ? path.join(taskDir, parentChecklist) : resolveChecklistPaths(taskDir).taskPath;
-  let checklist = "";
-  try {
-    checklist = fs.readFileSync(taskPath, "utf8");
-  } catch {
-    return true;
-  }
-  if (!checklistStepRequiresDiffPass(checklist, stepNumber)) return true;
-  return checkDiffSummaryReady(taskDir, step);
-}
-function checkDiffSummaryReady(taskDir, step) {
-  const summaryPath = path.join(
-    taskDir,
-    "artifacts",
-    "validation-summary.json"
-  );
-  try {
-    const summary = JSON.parse(fs.readFileSync(summaryPath, "utf8"));
-    if (summary.command === "check" && summary.action === "diff" && summary.status === "pass") {
-      return true;
-    }
-  } catch {
-  }
-  console.error(
-    `check-diff gate ${step} requires a task-local PASS at ${summaryPath}`
-  );
-  console.error(
-    `Run: mm-harness check diff [--fix] --artifacts-dir ${path.dirname(summaryPath)}`
-  );
-  console.error("Then rerun the same checklist mark command.");
-  return false;
-}
-function teachRecipeCompletion(taskDir, step) {
-  if (step !== "complete") return;
-  const artifactsDir = path.join(taskDir, "artifacts");
-  if (!fs.existsSync(path.join(artifactsDir, "recipe.json"))) return;
-  const qualityPath = path.join(artifactsDir, "recipe-quality.json");
-  const coveragePath = path.join(artifactsDir, "recipe-coverage.md");
-  const missingQuality = !fs.existsSync(qualityPath);
-  const missingCoverage = !fs.existsSync(coveragePath);
-  if (!missingQuality && !missingCoverage) return;
-  console.error("Recipe completion needs two closure artifacts; derive them from the real recipe run and evidence (do not stub them):");
-  if (missingCoverage) {
-    console.error(`  - ${coveragePath}: map each proof target to its recipe node and evidence, or record a reasoned N/A.`);
-  }
-  if (missingQuality) {
-    const compactPath = path.join(artifactsDir, "recipe-quality-input.json");
-    console.error("    First run: mm-harness help");
-    console.error(`  - ${qualityPath}: write ${compactPath} as:`);
-    console.error('    {"verdict":"pass|warn|fail","reasons":["evidence-backed reason"]}');
-    console.error(`    then run: mm-harness recipe-quality build --input ${compactPath} --output ${qualityPath}`);
-  }
-  console.error("Then rerun the same checklist complete command.");
-}
-async function handleChecklist(argv) {
-  const { action, taskDir, step, forwarded } = parseChecklistArgv(argv);
-  if (!taskDir) {
-    console.error(`usage: ${USAGE}`);
-    return EXIT.usage;
-  }
-  const resolvedTaskDir = path.resolve(taskDir);
-  if (action === "closeout") {
-    const result2 = runCloseout(resolvedTaskDir, forwarded, "inherit");
-    if (result2.error) {
-      console.error(`mm-harness checklist closeout: ${result2.error.message}`);
-      return EXIT.runtime;
-    }
-    return result2.status ?? EXIT.runtime;
-  }
-  if (action !== "mark" || !step) {
-    console.error(`usage: ${USAGE}`);
-    return EXIT.usage;
-  }
-  if (preserveTerminalSignal(resolvedTaskDir, step)) return EXIT.ok;
-  if (step === "sub" && forwarded[2] === "complete") {
-    try {
-      const unit = readSubtaskIndex(resolvedTaskDir)?.units.find((unit2) => unit2.id === forwarded[1]);
-      if (unit && !checkDiffGateReady(resolvedTaskDir, String(unit.parent.stepNumber), unit.parent.checklist)) return EXIT.runtime;
-    } catch (error) {
-      if (!(error instanceof SubtaskRefusal)) throw error;
-      console.error(error.message);
-      return error.code;
-    }
-  }
-  if (!checkDiffGateReady(resolvedTaskDir, step)) return EXIT.runtime;
-  teachRecipeCompletion(resolvedTaskDir, step);
-  const result = spawnSync(
-    process.execPath,
-    [MARK_SCRIPT, resolvedTaskDir, ...forwarded],
-    { stdio: "inherit" }
-  );
-  if (result.error) {
-    console.error(`mm-harness checklist mark: ${result.error.message}`);
-    return EXIT.runtime;
-  }
-  const status = result.status ?? EXIT.runtime;
-  if (status === EXIT.ok) {
-    stageLearningPackage(resolvedTaskDir, step, forwarded);
-  }
-  return status;
-}
-export {
-  checkDiffSummaryReady,
-  handleChecklist,
-  runCloseout,
-  teachRecipeCompletion
-};

package/dist/commands/domain.js

@@ -1,57 +0,0 @@
-import { optionFlag, optionString, parseArgs, targetPath, usageError } from "@farmslot/recipe-cli/harness";
-import {
-  changedFiles,
-  classifyDomain,
-  configPath,
-  discoverLibraries,
-  readConfig,
-  REVIEW_ADAPTERS
-} from "../review/knowledge.js";
-import { adapterFromOptions } from "./review.js";
-async function handleDomain(argv) {
-  const parsed = parseArgs(argv);
-  const target = targetPath(parsed.options);
-  const json = optionFlag(parsed.options, "json");
-  const declared = optionString(parsed.options, "domain") ?? process.env.MM_HARNESS_DOMAIN;
-  const detected = adapterFromOptions();
-  const adapter = detected === "unscoped" ? void 0 : detected;
-  if (declared) {
-    emit(json, { domain: declared, source: "declared", adapter: adapter ?? null, target });
-    return 0;
-  }
-  if (!adapter) {
-    throw usageError(`No MetaMask checkout detected: pass --adapter <${REVIEW_ADAPTERS.join("|")}> or --domain <name>.`);
-  }
-  const config = readConfig(configPath());
-  const libraries = discoverLibraries({ target, config });
-  const { base, files } = changedFiles(target, optionString(parsed.options, "base"));
-  const matches = classifyDomain(files, adapter, libraries);
-  const best = matches[0];
-  emit(json, {
-    domain: best?.domain ?? null,
-    source: best ? "owned-paths" : "none",
-    adapter,
-    target,
-    base,
-    changedFiles: files.length,
-    libraries: libraries.map((library) => ({ name: library.name, root: library.root, source: library.source, revision: library.revision ?? null })),
-    matches: matches.map((match) => ({ domain: match.domain, library: match.library.root, matched: match.matched }))
-  });
-  return 0;
-}
-function emit(json, payload) {
-  if (json) {
-    process.stdout.write(`${JSON.stringify({ command: "domain", ...payload }, null, 2)}
-`);
-    return;
-  }
-  process.stdout.write(`${payload.domain ?? "none"}
-`);
-  const best = payload.matches?.[0];
-  const detail = payload.source === "declared" ? "declared via --domain or MM_HARNESS_DOMAIN" : best ? `owned-paths match in ${best.library} (${best.matched.length} of ${payload.changedFiles} changed files)` : `no library owns the ${payload.changedFiles} changed files (base ${payload.base}; libraries scanned: ${payload.libraries?.length ?? 0})`;
-  process.stderr.write(`domain: ${detail}
-`);
-}
-export {
-  handleDomain
-};

package/dist/commands/execution-template.js

@@ -1,28 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-const require2 = createRequire(import.meta.url);
-async function handleExecutionTemplate(argv) {
-  let entrypoint;
-  try {
-    entrypoint = require2.resolve(
-      "@farmslot/agent-runtime/scripts/execution-template-cli.mjs"
-    );
-  } catch (error) {
-    console.error(
-      `mm-harness execution-template: installed @farmslot/agent-runtime does not expose the catalog command: ${error instanceof Error ? error.message : String(error)}`
-    );
-    return 1;
-  }
-  const result = spawnSync(process.execPath, [entrypoint, ...argv], {
-    env: process.env,
-    stdio: "inherit"
-  });
-  if (result.error) {
-    console.error(`mm-harness execution-template: ${result.error.message}`);
-    return 1;
-  }
-  return result.status ?? 1;
-}
-export {
-  handleExecutionTemplate
-};

package/dist/commands/logs.js

@@ -1,99 +0,0 @@
-import { adapterDetectNext, EXIT, flag, parseFlags, contextAdapter, spawnInherit, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
-import fs from "node:fs";
-import path from "node:path";
-import { createLogsOptions } from "../provider-logs.js";
-import { getAdapterSurface } from "../adapters/surface.js";
-const LOGS_BOOLEANS = /* @__PURE__ */ new Set(["full", "json", "window"]);
-async function handleLogs(argv) {
-  const { options } = parseFlags(argv, LOGS_BOOLEANS);
-  const json = flag(options, "json");
-  const target = targetOf(options);
-  const adapter = contextAdapter(target);
-  if (!adapter) {
-    return usageOut(json, "logs", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
-  }
-  const surface = getAdapterSurface(adapter);
-  if (surface.headless) {
-    return usageOut(json, "logs", "core is headless; it has no dev server logs.", surface.hints.launch);
-  }
-  const logSources = surface.logSources(target);
-  const appLogSource = surface.appLogSource(target);
-  const sourceLabels = logSources.map((entry) => entry.label);
-  const appSourceLabel = appLogSource?.label ?? "app";
-  const defaultSource = appLogSource && appSourceLabel !== "app" ? appSourceLabel : sourceLabels[0];
-  const source = str(options, "source") ?? defaultSource;
-  const validSources = [...sourceLabels, ...appLogSource ? [appSourceLabel] : [], ...appLogSource && appSourceLabel !== "app" ? ["app"] : []];
-  if (!validSources.includes(source)) {
-    return usageOut(json, "logs", `--source must be one of: ${validSources.join(", ")}.`, `mm-harness logs --source ${defaultSource}`);
-  }
-  const events = str(options, "events");
-  if (events !== void 0) {
-    if (!/^\d+$/u.test(events)) {
-      return usageOut(json, "logs", `--events must be numeric (got: ${events}).`, "mm-harness logs --events 20");
-    }
-    process.env.RECIPE_LOG_EVENTS = events;
-  }
-  const isAppSource = source === "app" || source === appSourceLabel;
-  const requested = isAppSource ? appLogSource : logSources.find((entry) => entry.label === source);
-  const ordered = isAppSource ? requested ? [requested] : [] : requested ? [requested] : logSources;
-  const logFile = ordered.find((entry) => fs.existsSync(entry.path))?.path;
-  if (!logFile) {
-    if (isAppSource && appLogSource) {
-      const message = `application console unavailable for this checkout (${path.basename(appLogSource.path)} is absent).`;
-      const userAction = surface.hints.launch;
-      if (json) {
-        console.log(JSON.stringify({
-          schemaVersion: 1,
-          command: "logs",
-          adapter,
-          source,
-          status: "fail",
-          error: { code: "APP_LOG_UNAVAILABLE", message, userAction },
-          exitCode: EXIT.runtime
-        }, null, 2));
-      } else {
-        console.error(`\u2717 logs: ${message}`);
-        console.error(`  Next: ${userAction}`);
-      }
-      return EXIT.runtime;
-    }
-    const names = isAppSource && appLogSource ? path.basename(appLogSource.path) : logSources.map((entry) => path.basename(entry.path)).join(" / ");
-    return usageOut(
-      json,
-      "logs",
-      `nothing running for this checkout (no ${names}).`,
-      surface.hints.launch
-    );
-  }
-  if (flag(options, "window")) {
-    const result = await createLogsOptions(surface).window({
-      target,
-      logFile: logSources[0].path
-    });
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "logs", action: "window", adapter, ...result }, null, 2));
-    return result.exitCode;
-  }
-  if (json) {
-    console.log(JSON.stringify({ schemaVersion: 1, command: "logs", adapter, source, logFile, exitCode: EXIT.ok }, null, 2));
-    return EXIT.ok;
-  }
-  process.stderr.write(
-    `${source} log: ${logFile}
-  tail it yourself: tail -f ${logFile}   \xB7   page it: less +F ${logFile}
-  following below (Ctrl-C to stop) \u2026
-`
-  );
-  const full = flag(options, "full");
-  if (full) {
-    return spawnInherit("tail", ["-n", "+1", "-F", logFile], target) === 0 ? EXIT.ok : EXIT.runtime;
-  }
-  return createLogsOptions(surface).compact({
-    target,
-    logFile,
-    events: process.env.RECIPE_LOG_EVENTS ?? "20",
-    mode: process.env.RECIPE_LOG_UI_MODE ?? "compact"
-  });
-}
-export {
-  handleLogs
-};