@deeeed/metamask-harness 0.14.7 → 0.15.0

package/dist/commands/check.js

@@ -4,14 +4,16 @@ import path from "node:path";
 import { detectAdapter } from "../harness.js";
 import { EXIT, usageOut } from "./shared.js";
 import { optionFlag, optionString, parseArgs } from "./parse-args.js";
-const USAGE = "mm-harness check diff [--target <repo>] [--adapter mobile|extension|core] [--base <ref>] [--profile fast|full] [--artifacts-dir <dir>] [--json]";
+const USAGE = "mm-harness check diff [--fix] [--target <repo>] [--adapter mobile|extension|core] [--base <ref>] [--profile fast|full] [--artifacts-dir <dir>] [--json]";
 const JS_TS_EXT_RE = /\.(?:c|m)?jsx?$|\.tsx?$/u;
 const FORMAT_EXT_RE = /\.(?:c|m)?jsx?$|\.tsx?$|\.json$|\.md$|\.css$|\.scss$|\.ya?ml$/u;
 const TEST_FILE_RE = /(?:^|[./_-])(?:test|spec)\.(?:c|m)?jsx?$|(?:^|[./_-])(?:test|spec)\.tsx?$/u;
+const ESLINT_SUPPRESSION_RE = /^\s*eslint-disable(?:-line|-next-line)?\b/u;
 async function handleCheck(argv) {
   const { positional, options } = parseArgs(argv, "check");
   const action = positional[0];
   const json = optionFlag(options, "json");
+  const fix = optionFlag(options, "fix");
   if (action !== "diff") {
     const message = action ? `unknown action '${action}'` : "missing action";
     return usageOut(json, "check", message, USAGE);
@@ -51,52 +53,64 @@ async function handleCheck(argv) {
   const mergeBase = resolveMergeBase(target, baseRef);
   const changedFiles = listChangedFiles(target, mergeBase, artifactsDir);
   const existingChangedFiles = changedFiles.filter((file) => fs.existsSync(path.join(target, file)));
-  const checks = [];
-  checks.push(
-    runToolCheck({
-      id: "eslint",
-      label: "Changed-file ESLint",
-      target,
-      artifactsDir,
-      files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
-      command: executable(target, "eslint"),
-      args: ["--cache", "--cache-location", path.join(artifactsDir, "eslintcache"), "--max-warnings=0", "--no-warn-ignored"]
-    })
-  );
-  checks.push(
-    runToolCheck({
-      id: "prettier",
-      label: "Changed-file Prettier",
-      target,
-      artifactsDir,
-      files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)),
-      command: executable(target, "prettier"),
-      args: ["--check"]
-    })
-  );
-  checks.push(
-    runToolCheck({
-      id: "jest",
-      label: "Changed test files",
-      target,
-      artifactsDir,
-      files: existingChangedFiles.filter((file) => TEST_FILE_RE.test(file)),
-      command: executable(target, "jest"),
-      args: ["--no-coverage"]
-    })
-  );
-  if (profile === "full") {
-    checks.push(runTypecheck({ target, artifactsDir, packageJson }));
-  } else {
-    checks.push({
-      id: "typecheck",
-      label: "TypeScript project check",
-      status: "skip",
-      reason: "profile=fast; run with --profile full for repo-wide typecheck"
-    });
+  const suppressionCheck = checkNewEslintSuppressions({
+    target,
+    artifactsDir,
+    mergeBase,
+    files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file))
+  });
+  const policyFailed = suppressionCheck.status === "fail";
+  const fixes = [];
+  if (fix && !policyFailed) {
+    fixes.push(
+      runToolCheck({
+        id: "eslint-fix",
+        label: "Changed-file ESLint fix",
+        target,
+        artifactsDir,
+        files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
+        command: executable(target, "eslint"),
+        args: ["--fix", "--cache", "--cache-location", path.join(artifactsDir, "eslintcache")]
+      })
+    );
+    fixes.push(runFormatterFix({ target, artifactsDir, files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)) }));
+  }
+  const checks = [suppressionCheck];
+  if (!policyFailed) {
+    checks.push(
+      runToolCheck({
+        id: "eslint",
+        label: "Changed-file ESLint",
+        target,
+        artifactsDir,
+        files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
+        command: executable(target, "eslint"),
+        args: ["--cache", "--cache-location", path.join(artifactsDir, "eslintcache")]
+      })
+    );
+    checks.push(runFormatterCheck({ target, artifactsDir, files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)) }));
+    checks.push(
+      ...runJestChecks({
+        adapter,
+        target,
+        artifactsDir,
+        files: existingChangedFiles.filter((file) => TEST_FILE_RE.test(file))
+      })
+    );
+    if (profile === "full") {
+      checks.push(runTypecheck({ target, artifactsDir, packageJson }));
+    } else {
+      checks.push({
+        id: "typecheck",
+        label: "TypeScript project check",
+        status: "skip",
+        reason: "profile=fast; run with --profile full for repo-wide typecheck"
+      });
+    }
   }
-  const status = checks.some((check) => check.status === "fail") ? "fail" : "pass";
+  const status = [...fixes, ...checks].some((check) => check.status === "fail") ? "fail" : "pass";
   const exitCode = status === "pass" ? EXIT.ok : EXIT.validation;
+  const guidance = policyFailed ? ["Remove the newly added eslint-disable directive(s). Fix the underlying violation with existing named styles, project tokens, or another established source pattern; then rerun mm-harness check diff [--fix]. Other checks were skipped until this policy failure is removed."] : checks.some((check) => check.id === "eslint" && check.status === "fail") ? ["Fix the reported violations in changed source using existing project patterns and tokens; do not suppress rules, hide violations behind indirection, weaken configuration, or bypass check diff. Then rerun mm-harness check diff [--fix]."] : [];
   const summary = {
     schemaVersion: 1,
     command: "check",
@@ -106,12 +120,15 @@ async function handleCheck(argv) {
     adapter: adapter ?? null,
     target,
     profile,
+    fix,
     baseRef,
     baseSource: base.source,
     baseLabel: base.label ?? null,
     mergeBase,
     changedFiles,
+    fixes,
     checks,
+    guidance,
     artifacts: {
       dir: artifactsDir,
       summaryJson: path.join(artifactsDir, "validation-summary.json"),
@@ -184,6 +201,93 @@ function isUnderArtifactsDir(target, artifactsDir, file) {
 function normalizeRelativePath(value) {
   return value.split(path.sep).join("/");
 }
+function checkNewEslintSuppressions(input) {
+  const id = "policy-suppressions";
+  const label = "New ESLint suppression policy";
+  if (input.files.length === 0) {
+    return { id, label, status: "skip", reason: "no changed JS/TS files" };
+  }
+  const untracked = new Set(
+    runCommand("git", ["ls-files", "--others", "--exclude-standard"], input.target).stdout.split("\n").map((file) => normalizeRelativePath(file.trim())).filter(Boolean)
+  );
+  const findings = [];
+  const trackedFiles = input.files.filter((file) => !untracked.has(normalizeRelativePath(file)));
+  if (trackedFiles.length > 0) {
+    const base = input.mergeBase ?? "HEAD";
+    const diff = runCommand(
+      "git",
+      ["diff", "--unified=0", "--no-color", "--no-ext-diff", base, "--", ...trackedFiles],
+      input.target
+    ).stdout;
+    findings.push(...findAddedSuppressions(diff));
+  }
+  for (const file of input.files.filter((candidate) => untracked.has(normalizeRelativePath(candidate)))) {
+    const lines = fs.readFileSync(path.join(input.target, file), "utf8").split("\n");
+    lines.forEach((line, index) => {
+      if (hasEslintSuppressionDirective(line)) findings.push(`${normalizeRelativePath(file)}:${index + 1}: ${line.trim()}`);
+    });
+  }
+  const logPath = path.join(input.artifactsDir, `${id}.log`);
+  fs.writeFileSync(logPath, findings.length > 0 ? `${findings.join("\n")}
+` : "No newly added eslint-disable directives.\n");
+  return findings.length > 0 ? {
+    id,
+    label,
+    status: "fail",
+    logPath,
+    reason: `${findings.length} newly added eslint-disable directive(s)`
+  } : { id, label, status: "pass", logPath };
+}
+function findAddedSuppressions(diff) {
+  const findings = [];
+  let file = "";
+  let newLine = 0;
+  for (const line of diff.split("\n")) {
+    if (line.startsWith("+++ ")) {
+      file = normalizeRelativePath(line.slice(4).replace(/^b\//u, ""));
+      continue;
+    }
+    const hunk = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/u.exec(line);
+    if (hunk) {
+      newLine = Number(hunk[1]);
+      continue;
+    }
+    if (line.startsWith("+") && !line.startsWith("+++")) {
+      const content = line.slice(1);
+      if (hasEslintSuppressionDirective(content)) findings.push(`${file}:${newLine}: ${content.trim()}`);
+      newLine += 1;
+    } else if (!line.startsWith("-") && !line.startsWith("\\")) {
+      newLine += 1;
+    }
+  }
+  return findings;
+}
+function hasEslintSuppressionDirective(line) {
+  let quote = "";
+  let escaped = false;
+  for (let index = 0; index < line.length; index += 1) {
+    const char = line[index];
+    if (quote) {
+      if (escaped) escaped = false;
+      else if (char === "\\") escaped = true;
+      else if (char === quote) quote = "";
+      continue;
+    }
+    if (char === "'" || char === '"' || char === "`") {
+      quote = char;
+      continue;
+    }
+    if (char !== "/") continue;
+    const next = line[index + 1];
+    if (next === "/") return ESLINT_SUPPRESSION_RE.test(line.slice(index + 2));
+    if (next !== "*") continue;
+    if (ESLINT_SUPPRESSION_RE.test(line.slice(index + 2))) return true;
+    const end = line.indexOf("*/", index + 2);
+    if (end === -1) return false;
+    index = end + 1;
+  }
+  return false;
+}
 function executable(target, name) {
   const local = path.join(target, "node_modules", ".bin", name);
   return fs.existsSync(local) ? local : null;
@@ -197,6 +301,118 @@ function runToolCheck(input) {
   }
   return runCheckCommand(input.id, input.label, input.target, input.artifactsDir, input.command, [...input.args, ...input.files]);
 }
+function runJestChecks(input) {
+  if (input.adapter !== "core" || input.files.length === 0) {
+    return [
+      runToolCheck({
+        id: "jest",
+        label: "Changed test files",
+        target: input.target,
+        artifactsDir: input.artifactsDir,
+        files: input.files,
+        command: executable(input.target, "jest"),
+        args: ["--no-coverage"]
+      })
+    ];
+  }
+  const groups = /* @__PURE__ */ new Map();
+  const rootFiles = [];
+  for (const file of input.files) {
+    const workspace = resolveWorkspace(input.target, file);
+    if (!workspace) {
+      rootFiles.push(file);
+      continue;
+    }
+    const key = workspace.root;
+    const group = groups.get(key) ?? { ...workspace, files: [] };
+    group.files.push(normalizeRelativePath(path.relative(workspace.root, path.join(input.target, file))));
+    groups.set(key, group);
+  }
+  const resultCount = groups.size + (rootFiles.length > 0 ? 1 : 0);
+  const results = [];
+  for (const group of [...groups.values()].sort((a, b) => a.name.localeCompare(b.name))) {
+    const id = resultCount === 1 ? "jest" : `jest-${safeId(group.name)}`;
+    results.push(
+      runCheckCommand(
+        id,
+        `Changed test files (${group.name})`,
+        input.target,
+        input.artifactsDir,
+        "yarn",
+        ["workspace", group.name, "run", "jest", "--no-coverage", ...group.files.sort()]
+      )
+    );
+  }
+  if (rootFiles.length > 0) {
+    results.push(
+      runToolCheck({
+        id: resultCount === 1 ? "jest" : "jest-root",
+        label: "Changed root test files",
+        target: input.target,
+        artifactsDir: input.artifactsDir,
+        files: rootFiles,
+        command: executable(input.target, "jest"),
+        args: ["--no-coverage"]
+      })
+    );
+  }
+  return results;
+}
+function resolveWorkspace(target, file) {
+  const root = path.resolve(target);
+  let current = path.dirname(path.resolve(root, file));
+  while (current !== root && current.startsWith(`${root}${path.sep}`)) {
+    const packageJson = readPackageJson(current);
+    if (typeof packageJson?.name === "string" && packageJson.name.trim()) {
+      return { name: packageJson.name, root: current };
+    }
+    current = path.dirname(current);
+  }
+  return null;
+}
+function safeId(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-|-$/gu, "");
+}
+function runFormatterCheck(input) {
+  const oxfmtConfig = ["oxfmt.config.ts", "oxfmt.config.mts", "oxfmt.config.cts", "oxfmt.config.js", "oxfmt.config.mjs", "oxfmt.config.cjs", ".oxfmtrc.json"].find((candidate) => fs.existsSync(path.join(input.target, candidate)));
+  const oxfmt = oxfmtConfig ? executable(input.target, "oxfmt") : null;
+  if (oxfmt && oxfmtConfig) {
+    return runToolCheck({
+      id: "oxfmt",
+      label: "Changed-file oxfmt",
+      ...input,
+      command: oxfmt,
+      args: ["--config", oxfmtConfig, "--check"]
+    });
+  }
+  return runToolCheck({
+    id: "prettier",
+    label: "Changed-file Prettier",
+    ...input,
+    command: executable(input.target, "prettier"),
+    args: ["--check"]
+  });
+}
+function runFormatterFix(input) {
+  const oxfmtConfig = ["oxfmt.config.ts", "oxfmt.config.mts", "oxfmt.config.cts", "oxfmt.config.js", "oxfmt.config.mjs", "oxfmt.config.cjs", ".oxfmtrc.json"].find((candidate) => fs.existsSync(path.join(input.target, candidate)));
+  const oxfmt = oxfmtConfig ? executable(input.target, "oxfmt") : null;
+  if (oxfmt && oxfmtConfig) {
+    return runToolCheck({
+      id: "oxfmt-fix",
+      label: "Changed-file oxfmt fix",
+      ...input,
+      command: oxfmt,
+      args: ["--config", oxfmtConfig, "--write"]
+    });
+  }
+  return runToolCheck({
+    id: "prettier-fix",
+    label: "Changed-file Prettier fix",
+    ...input,
+    command: executable(input.target, "prettier"),
+    args: ["--write"]
+  });
+}
 function runTypecheck(input) {
   const scripts = input.packageJson?.scripts && typeof input.packageJson.scripts === "object" ? input.packageJson.scripts : {};
   if (typeof scripts["lint:tsc"] === "string") {
@@ -270,13 +486,16 @@ function renderMarkdown(summary) {
     "",
     `Verdict: ${summary.status}`,
     `Profile: ${summary.profile}`,
+    `Fix: ${summary.fix ? "yes" : "no"}`,
     `Base: ${summary.baseRef || "(none)"} (${summary.baseSource || "unknown"}${summary.baseLabel ? `: ${summary.baseLabel}` : ""})`,
     `Changed files: ${summary.changedFiles.length}`,
     "",
+    ...summary.fixes.length > 0 ? ["## Fixes", "", ...summary.fixes.map((fix) => `- ${fix.status.toUpperCase()} ${fix.id}${fix.reason ? ` \u2014 ${fix.reason}` : ""}${fix.logPath ? ` (${fix.logPath})` : ""}`), ""] : [],
+    ...summary.guidance.length > 0 ? ["## Next action", "", ...summary.guidance.map((item) => `- ${item}`), ""] : [],
     "## Checks",
     ""
   ];
-  for (const check of summary.checks) {
+  for (const check of [...summary.fixes, ...summary.checks]) {
     lines.push(`- ${check.status.toUpperCase()} ${check.id}${check.reason ? ` \u2014 ${check.reason}` : ""}${check.logPath ? ` (${check.logPath})` : ""}`);
   }
   lines.push("", "## Changed Files", "");
@@ -298,6 +517,7 @@ function renderHuman(summary) {
     console.log(`  ${prefix} ${check.id}: ${check.status}${check.reason ? ` (${check.reason})` : ""}`);
     if (check.status === "fail" && check.logPath) console.log(`    log: ${check.logPath}`);
   }
+  for (const item of summary.guidance) console.log(`  Next: ${item}`);
   console.log(`Artifacts: ${summary.artifacts.summaryJson}`);
 }
 function failEnvelope(input) {

package/dist/commands/checklist.js

@@ -0,0 +1,136 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { EXIT } from "./shared.js";
+const require2 = createRequire(import.meta.url);
+const USAGE = "mm-harness checklist mark <task-dir> <step> [options]";
+function terminalSignalStatus(taskDir) {
+  try {
+    const target = JSON.parse(
+      fs.readFileSync(path.join(taskDir, "checklist-target.json"), "utf8")
+    );
+    const signalPath = path.resolve(taskDir, target.signal ?? "SIGNAL.json");
+    const signal = JSON.parse(fs.readFileSync(signalPath, "utf8"));
+    return signal.status === "complete" || signal.status === "blocked" ? signal.status : null;
+  } catch {
+    return null;
+  }
+}
+function preserveTerminalSignal(taskDir, markArgs) {
+  const step = markArgs[0];
+  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 checklistPath(taskDir) {
+  try {
+    const target = JSON.parse(
+      fs.readFileSync(path.join(taskDir, "checklist-target.json"), "utf8")
+    );
+    return path.resolve(taskDir, target.checklist ?? "CHECKLIST.md");
+  } catch {
+    return path.join(taskDir, "CHECKLIST.md");
+  }
+}
+function checklistStepRequiresDiffPass(checklist, stepNumber) {
+  let inFence = false;
+  let seen = 0;
+  for (const line of checklist.split(/\n/u)) {
+    if (/^\s*```/u.test(line)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence) continue;
+    const match = line.match(/^\s*[-*]\s+\[(?: |x|X)\]\s+(.*)$/u);
+    if (!match) continue;
+    seen += 1;
+    if (seen === stepNumber) return /mm-harness check diff/u.test(match[1] ?? "");
+  }
+  return false;
+}
+function checkDiffGateReady(taskDir, markArgs) {
+  const step = markArgs[0];
+  const stepNumber = numericMarkStep(step);
+  if (stepNumber === null) return true;
+  let checklist = "";
+  try {
+    checklist = fs.readFileSync(checklistPath(taskDir), "utf8");
+  } catch {
+    return true;
+  }
+  if (!checklistStepRequiresDiffPass(checklist, stepNumber)) return true;
+  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, markArgs) {
+  if (markArgs[0] !== "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(`  - ${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, ...markArgs] = argv;
+  if (action !== "mark" || !taskDir || markArgs.length === 0) {
+    console.error(`usage: ${USAGE}`);
+    return EXIT.usage;
+  }
+  const resolvedTaskDir = path.resolve(taskDir);
+  if (preserveTerminalSignal(resolvedTaskDir, markArgs)) return EXIT.ok;
+  if (!checkDiffGateReady(resolvedTaskDir, markArgs)) return EXIT.runtime;
+  teachRecipeCompletion(resolvedTaskDir, markArgs);
+  const result = spawnSync(
+    process.execPath,
+    [require2.resolve("@farmslot/agent-runtime/scripts/mark-checklist-step.cjs"), resolvedTaskDir, ...markArgs],
+    { stdio: "inherit" }
+  );
+  if (result.error) {
+    console.error(`mm-harness checklist mark: ${result.error.message}`);
+    return EXIT.runtime;
+  }
+  return result.status ?? EXIT.runtime;
+}
+export {
+  handleChecklist
+};

package/dist/commands/debug.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import { runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { ADAPTER_DETECT_NEXT, EXIT, flag, parseFlags, resolveAdapter, spawnScript, targetOf, usageOut } from "./shared.js";
-const DEBUG_BOOLEANS = /* @__PURE__ */ new Set(["worker", "devMenu", "json"]);
+const DEBUG_BOOLEANS = /* @__PURE__ */ new Set(["worker", "devMenu", "json", "noOpen"]);
 async function handleDebug(argv) {
   const { options } = parseFlags(argv, DEBUG_BOOLEANS);
   const json = flag(options, "json");
@@ -14,6 +14,7 @@ async function handleDebug(argv) {
   surface.resolveSlotPorts(target);
   const worker = flag(options, "worker");
   const devMenu = flag(options, "devMenu");
+  const noOpen = flag(options, "noOpen");
   if (adapter === "mobile" && worker) {
     return usageOut(
       json,
@@ -40,11 +41,21 @@ async function handleDebug(argv) {
     debugArgs.push("--action", devMenu ? "dev-menu" : "debug");
   }
   if (json) debugArgs.push("--json");
+  if (noOpen) debugArgs.push("--no-open");
   const result = spawnScript(process.execPath, [openDebug, ...debugArgs], target, json);
   if (json) {
+    const leaf = parseDebugLeaf(result.output);
     console.log(
       JSON.stringify(
-        { schemaVersion: 1, command: "debug", adapter, mode: worker ? "worker" : devMenu ? "dev-menu" : "default", exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime },
+        {
+          ...leaf,
+          schemaVersion: 1,
+          command: "debug",
+          adapter,
+          mode: worker ? "worker" : devMenu ? "dev-menu" : "default",
+          opened: leaf.opened === true,
+          exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime
+        },
         null,
         2
       )
@@ -52,6 +63,14 @@ async function handleDebug(argv) {
   }
   return result.status === 0 ? EXIT.ok : EXIT.runtime;
 }
+function parseDebugLeaf(output) {
+  try {
+    const value = JSON.parse(output.trim());
+    if (value && typeof value === "object" && !Array.isArray(value)) return value;
+  } catch {
+  }
+  return output.trim() ? { detail: output.trim() } : {};
+}
 export {
   handleDebug
 };