@deeeed/metamask-harness 0.62.0 → 0.63.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.63.0 - 2026-09-23
+
+### Added
+
+- Show the task's acceptance criteria and recorded verdicts in `status`, `status --watch`, and `status --task`, using the Farmslot handoff and acceptance ledger.
+- Show the active preparation step and elapsed time in `status --watch` and `status --task` even when the agent buffers preparation output.
+
+### Fixed
+
+- Allow 30 seconds for iOS simulator discovery so a cold CoreSimulator startup does not fail at five seconds.
+
 ## 0.62.0 - 2026-09-22
 
 ### Added

package/dist/commands/prepare.js

@@ -7,7 +7,7 @@ import {
 import { color, stripAnsi } from "../cli-color.js";
 import { runnerProvenance } from "../doctor.js";
 import { detectAdapter } from "../harness.js";
-import { harnessExecutable, manifestPath, recipeRuntimeDir } from "../paths.js";
+import { harnessExecutable, manifestPath, PREPARE_PROGRESS_ARTIFACT, recipeRuntimeDir } from "../paths.js";
 import { optionFlag, optionString, parseArgs, targetPath, usageError } from "./parse-args.js";
 import { EXIT } from "./shared.js";
 import { formatDuration } from "./status-watch.js";
@@ -336,13 +336,32 @@ async function handlePrepare(argv) {
   const remoteFlagArgs = remoteFlag === void 0 ? [] : ["--remote-flag", remoteFlag];
   let mobilePlatform = mobilePlatformOption(optionString(options, "mobilePlatform"));
   const recordPath = path.join(artifactsDir, READINESS_RECORD);
+  const progressPath = path.join(artifactsDir, PREPARE_PROGRESS_ARTIFACT);
   const chain = stepChain(platform);
   const view = json ? void 0 : createStepView(chain, stepHints(chain, lastRunDurations(recordPath)));
   view?.begin();
   const steps = [];
+  let activeStep;
+  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const writeProgress = () => {
+    fs.mkdirSync(path.dirname(progressPath), { recursive: true });
+    const temporaryPath = `${progressPath}.${process.pid}.tmp`;
+    fs.writeFileSync(temporaryPath, `${JSON.stringify({
+      schemaVersion: 1,
+      startedAt,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      total: chain.length,
+      steps: steps.filter(({ id }) => chain.includes(id)).map(({ id, status, durationMs }) => ({ id, status, durationMs })),
+      ...activeStep ? { active: activeStep } : {}
+    })}
+`);
+    fs.renameSync(temporaryPath, progressPath);
+  };
   const failed = () => steps.some((step) => step.status === "fail");
   const addStep = (step) => {
     steps.push(step);
+    activeStep = void 0;
+    writeProgress();
     view?.finish(step);
     return step;
   };
@@ -352,10 +371,17 @@ async function handlePrepare(argv) {
     }
     const step = await runStep(executable, target, artifactsDir, id, args, {
       json,
-      onSpawn: (startedAt) => view?.start(id, startedAt)
+      onSpawn: (stepStartedAt) => {
+        activeStep = { id, startedAt: new Date(stepStartedAt).toISOString() };
+        writeProgress();
+        view?.start(id, stepStartedAt);
+      }
     });
     return addStep(step);
   };
+  const heartbeat = setInterval(() => {
+    if (activeStep) writeProgress();
+  }, 1e4);
   try {
     await run("doctor", ["doctor", "--fix", "--json", "--adapter", platform, ...targetArgs]);
     await run("status", ["status", "--json", ...targetArgs]);
@@ -384,6 +410,7 @@ async function handlePrepare(argv) {
     }
     await run("verify", ["verify", "--json", "--adapter", platform, ...targetArgs]);
   } finally {
+    clearInterval(heartbeat);
     view?.end();
   }
   const provenance = runnerProvenance(manifestPath(platform));
@@ -404,6 +431,7 @@ async function handlePrepare(argv) {
   fs.mkdirSync(artifactsDir, { recursive: true });
   fs.writeFileSync(recordPath, `${JSON.stringify(record, null, 2)}
 `);
+  fs.rmSync(progressPath, { force: true });
   if (json) {
     console.log(JSON.stringify(record, null, 2));
   } else {

package/dist/commands/status-watch.js

@@ -103,9 +103,13 @@ function renderTaskView(view, title, explicitTask = false) {
   const contextLine = joinParts([
     view.libraries.length > 0 && `libraries ${out("info", view.libraries.map(libraryLabel).join(" "))}`,
     showTask && view.fixture && `fixture ${out("info", path.basename(view.fixture.fixture ?? "unknown"))} ${statusWord(out, view.fixture.status)}${view.fixture.walletReset ? out("warn", " reset") : ""}`,
-    showTask && view.sandbox?.ready !== void 0 && `sandbox ${view.sandbox.ready ? out("ok", "ready") : out("warn", "not ready")}`
+    showTask && (view.prepare ? `sandbox ${out("info", "preparing")}` : view.sandbox?.ready !== void 0 && `sandbox ${view.sandbox.ready ? out("ok", "ready") : out("warn", "not ready")}`)
   ]);
   if (contextLine) lines.push(contextLine);
+  if (showTask && view.acceptance?.length) lines.push("", ...renderAcceptanceLines(view));
+  if (showTask && view.prepare) {
+    lines.push(`prepare ${out("info", view.prepare.step)} \xB7 ${view.prepare.completed}/${view.prepare.total} steps \xB7 ${formatDuration(view.prepare.elapsedMs)} elapsed`);
+  }
   const last = view.lastCommand;
   if (showTask && last) {
     lines.push(joinParts([
@@ -148,6 +152,19 @@ function renderTaskView(view, title, explicitTask = false) {
   }
   return lines;
 }
+function renderAcceptanceLines(view) {
+  if (!view.acceptance?.length) return [];
+  const out = (style, text) => color(style, text, { stream: process.stdout });
+  const proven = view.acceptance.filter((row) => row.status?.verdict === "proven").length;
+  return [
+    `acceptance criteria ${proven}/${view.acceptance.length} proven`,
+    ...view.acceptance.map((row) => {
+      const verdict = row.status?.verdict ?? "no verdict";
+      const style = verdict === "proven" ? "ok" : verdict === "weak" ? "warn" : verdict === "no verdict" ? "dim" : "err";
+      return `  ${row.id} [${out(style, verdict)}] ${row.text}`;
+    })
+  ];
+}
 function idleReason(view) {
   if (!view.taskDir) return "no task directory under temp/tasks";
   const { reason, idleMs, branchCarriesTicket } = view.activity;
@@ -161,15 +178,33 @@ function idleReason(view) {
 }
 function changedLines(previous, next) {
   if (!previous || previous.taskDir !== next.taskDir) {
-    return [joinParts([
-      path.basename(next.checkout.target),
-      next.taskDir ? path.basename(next.taskDir) : "no-task-dir",
-      `status=${next.signal?.status ?? "unknown"}`,
-      `step=${next.signal?.step ? stepLabel(next.signal.step) : "none"}`
-    ], " ")];
+    return [
+      joinParts([
+        path.basename(next.checkout.target),
+        next.taskDir ? path.basename(next.taskDir) : "no-task-dir",
+        `status=${next.signal?.status ?? "unknown"}`,
+        `step=${next.signal?.step ? stepLabel(next.signal.step) : "none"}`
+      ], " "),
+      ...(next.acceptance ?? []).map((row) => `${row.id} ${row.status?.verdict ?? "no verdict"} ${row.text}`),
+      ...next.prepare ? [`prepare ${next.prepare.step} started (${next.prepare.completed}/${next.prepare.total} steps)`] : []
+    ];
   }
   const lines = [];
+  for (const step of next.prepare?.steps ?? []) {
+    if (!previous.prepare?.steps.some((prior) => prior.id === step.id && prior.status === step.status)) {
+      lines.push(`prepare ${step.id} ${step.status} (${formatDuration(step.durationMs)})`);
+    }
+  }
+  if (next.prepare && (previous.prepare?.step !== next.prepare.step || previous.prepare.startedAt !== next.prepare.startedAt)) {
+    lines.push(`prepare ${next.prepare.step} started (${next.prepare.completed}/${next.prepare.total} steps)`);
+  }
   const before = new Map(previous.checklist.map((row) => [row.number, row.checked]));
+  const beforeAcceptance = new Map(previous.acceptance?.map((row) => [row.id, row.status?.verdict]));
+  for (const row of next.acceptance ?? []) {
+    if (beforeAcceptance.get(row.id) !== row.status?.verdict || !beforeAcceptance.has(row.id)) {
+      lines.push(`${row.id} ${row.status?.verdict ?? "no verdict"} ${row.text}`);
+    }
+  }
   for (const row of next.checklist) {
     if (!row.checked || before.get(row.number) === true) continue;
     lines.push(`checked ${row.number} ${row.label}${row.durationMs !== void 0 ? ` (${formatDuration(row.durationMs)})` : ""}`);
@@ -254,6 +289,7 @@ export {
   changedLines,
   formatDuration,
   handleStatusTaskView,
+  renderAcceptanceLines,
   renderTaskView,
   runStatusWatch
 };

package/dist/commands/status.js

@@ -20,7 +20,8 @@ import {
   renderMobileLiveBlock
 } from "./mobile-device-view.js";
 import { ADAPTER_DETECT_NEXT, EXIT, usageOut } from "./shared.js";
-import { handleStatusTaskView } from "./status-watch.js";
+import { handleStatusTaskView, renderAcceptanceLines } from "./status-watch.js";
+import { collectTaskView, findTaskDir } from "../task-view.js";
 import { optionFlag, optionString, targetPath } from "./parse-args.js";
 async function handleStatus({ options }) {
   const target = targetPath(options);
@@ -106,6 +107,12 @@ async function handleStatus({ options }) {
   const out = (style, text) => color(style, text, { stream: process.stdout });
   console.log(`${out("label", "status")} ${out("bold", adapter)} ${out("dim", target)}`);
   console.log(renderCheckoutView(view));
+  if (!fast) {
+    const taskView = collectTaskView(target, findTaskDir(target), Date.now());
+    if (taskView.activity.ongoing && taskView.acceptance?.length) {
+      console.log(renderAcceptanceLines(taskView).join("\n"));
+    }
+  }
   if (adapter !== "mobile") renderFeatureFlagLine(staticFeatureFlags, out);
   if (deviceView) renderMobileDeviceList(deviceView, out);
   if (!fast && adapter === "mobile" && deviceView !== null && deviceView.allConnectedDevices.length > 0) {

package/dist/devices.js

@@ -1,9 +1,11 @@
 import { execFileSync } from "node:child_process";
 import { resolveMobileToolPath } from "../library/actions/mobile/platform/tool-paths.mjs";
+const IOS_DEVICE_DISCOVERY_TIMEOUT_MS = 3e4;
 function reportProbeFailure(errors, platform, error) {
   const code = error?.code;
   if (code === "ENOENT") return;
-  const reason = code === "ETIMEDOUT" ? "timed out after 5 seconds" : "failed";
+  const timeoutSeconds = platform === "ios" ? IOS_DEVICE_DISCOVERY_TIMEOUT_MS / 1e3 : 5;
+  const reason = code === "ETIMEDOUT" ? `timed out after ${timeoutSeconds} seconds` : "failed";
   const probeCode = code ?? error?.status;
   errors.push({
     platform,
@@ -61,7 +63,7 @@ function listIosSimulators(scope, errors) {
   try {
     output = execFileSync("xcrun", ["simctl", "list", "devices", scope, "-j"], {
       encoding: "utf8",
-      timeout: 5e3,
+      timeout: IOS_DEVICE_DISCOVERY_TIMEOUT_MS,
       stdio: ["ignore", "pipe", "ignore"]
     });
   } catch (error) {

package/dist/mm-harness-cli.js

@@ -192,8 +192,10 @@ Example:
   The task view reads task files only \u2014 no probe, no launch, no write \u2014 and shows
   the same facts whether a skill or a control plane started the run: slot and
   device isolation, template and flow, fixture and sandbox readiness, then the
-  checklist with the time each row took and how long the current row has been
-  running. --task without --watch prints it once. With --json, --watch emits one
+  checklist with the time each row took, how long the current row has been
+  running, and acceptance criteria with recorded verdicts. The home dashboard
+  also shows criteria for an ongoing task. --task without --watch prints it once.
+  With --json, --watch emits one
   object per change (newline-delimited) instead of redrawing.
 
   The checkout view (also under "view" in --json, and printed by doctor) is what

package/dist/paths.js

@@ -5,6 +5,7 @@ const runnerDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..
 const pathDefaults = readPathDefaults();
 const DEFAULT_RECIPE_RUNTIME_DIR = pathDefaults.recipeRuntimeDir;
 const DEFAULT_RECIPE_HARNESS_ROOT = pathDefaults.recipeHarnessRoot;
+const PREPARE_PROGRESS_ARTIFACT = "prepare/progress.json";
 function recipeRuntimeDir() {
   return validateRelativeRecipePath("RECIPE_RUNTIME_DIR", process.env.RECIPE_RUNTIME_DIR || DEFAULT_RECIPE_RUNTIME_DIR);
 }
@@ -171,6 +172,7 @@ function isMissingPackageError(error, packageName) {
 export {
   DEFAULT_RECIPE_HARNESS_ROOT,
   DEFAULT_RECIPE_RUNTIME_DIR,
+  PREPARE_PROGRESS_ARTIFACT,
   assertAdapter,
   extensionIdPath,
   harnessExecutable,

package/dist/task-view.js

@@ -2,6 +2,12 @@ import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { HANDOFF_INPUT, latestTaskDir } from "@farmslot/agent-runtime";
+import {
+  ACCEPTANCE_STATUS_ARTIFACT,
+  acceptanceCriteriaView,
+  acceptanceCriterionId,
+  validateAcceptanceStatusLedger
+} from "@farmslot/protocol/contracts/acceptance";
 import {
   checklistStepName,
   deriveChecklistStepDurations,
@@ -17,7 +23,7 @@ import {
 } from "@farmslot/protocol";
 import { readCommandJournal } from "./command-journal.js";
 import { resolveRuntimeContextPath } from "./harness.js";
-import { recipeRuntimeDir } from "./paths.js";
+import { PREPARE_PROGRESS_ARTIFACT, recipeRuntimeDir } from "./paths.js";
 import { parseLibraryPathEnv } from "./review/knowledge.js";
 const CHECKLIST_LABEL_LIMIT = 70;
 const TASK_SILENT_AFTER_MS = 10 * 60 * 1e3;
@@ -42,8 +48,22 @@ function collectTaskView(target, taskDir, now) {
   const checklist = readChecklistRows(path.join(taskDir, INTERACTIVE_CHECKLIST_MARKDOWN));
   const template = asObject(handoff?.executionTemplate);
   const task = asObject(handoff?.task);
+  const rawCriteria = task?.acceptanceCriteria;
+  if (rawCriteria !== void 0 && !Array.isArray(rawCriteria)) {
+    throw new Error(`${path.join(taskDir, HANDOFF_INPUT)}: task.acceptanceCriteria must be an array.`);
+  }
+  const criteria = rawCriteria?.map((text, index) => ({
+    id: acceptanceCriterionId(index),
+    text: String(text)
+  })).filter((criterion) => criterion.text.trim().length > 0) ?? [];
+  const rawLedger = readJsonObject(path.join(taskDir, ACCEPTANCE_STATUS_ARTIFACT));
+  if (rawLedger) {
+    const issues = validateAcceptanceStatusLedger(rawLedger);
+    if (issues.length > 0) throw new Error(`${ACCEPTANCE_STATUS_ARTIFACT}: ${issues.join("; ")}`);
+  }
   const startedAtIso = pickString(handoff, "startedAt");
   const startedAt = parseTime(startedAtIso);
+  const prepare = readPrepareProgress(taskDir, now, startedAt, parseTime(pickString(sandbox, "recordedAt")));
   const timing = applyTiming(checklist, signal, startedAtIso, now);
   const ticket = pickString(task, "ticket");
   const journal = readLastCommand(target, now);
@@ -56,7 +76,8 @@ function collectTaskView(target, taskDir, now) {
       startedAt,
       parseTime(pickString(signal, "timestamp")),
       ...readMarkEvents(signal).map((event) => Date.parse(event.checkedAt)),
-      commandCounts ? commandAt : void 0
+      commandCounts ? commandAt : void 0,
+      prepare ? parseTime(prepare.updatedAt) : void 0
     ],
     branch: base.checkout.branch,
     ticket,
@@ -79,6 +100,7 @@ function collectTaskView(target, taskDir, now) {
       title: pickString(task, "title"),
       ticket
     }),
+    ...criteria.length > 0 || rawLedger ? { acceptance: acceptanceCriteriaView(criteria, rawLedger ? rawLedger : null) } : {},
     fixture: section({
       fixture: pickString(fixtures, "fixture"),
       canonicalFixture: pickString(fixtures, "canonicalFixture"),
@@ -86,6 +108,7 @@ function collectTaskView(target, taskDir, now) {
       walletReset: pickBoolean(fixtures, "walletReset")
     }),
     sandbox: section({ ready: pickBoolean(sandbox, "ready") }),
+    ...prepare ? { prepare } : {},
     checklist,
     subtasks: readSubtasks(taskDir),
     signal: section({
@@ -99,6 +122,26 @@ function collectTaskView(target, taskDir, now) {
     activity
   };
 }
+function readPrepareProgress(taskDir, now, taskStartedAt, recordedAt) {
+  const progress = readJsonObject(path.join(taskDir, "artifacts", PREPARE_PROGRESS_ARTIFACT));
+  const active = asObject(progress?.active);
+  const step = pickString(active, "id");
+  const startedAt = pickString(active, "startedAt");
+  const stepStartedAt = parseTime(startedAt);
+  const runStartedAt = parseTime(pickString(progress, "startedAt"));
+  const updatedAtIso = pickString(progress, "updatedAt");
+  const updatedAt = parseTime(updatedAtIso);
+  const total = pickNumber(progress, "total");
+  if (!step || !["doctor", "status", "launch", "fixtures", "verify"].includes(step) || stepStartedAt === void 0 || runStartedAt === void 0 || updatedAt === void 0 || now - updatedAt > 3e4 || total === void 0 || total < 1 || taskStartedAt !== void 0 && runStartedAt < taskStartedAt || recordedAt !== void 0 && recordedAt >= runStartedAt) return void 0;
+  const steps = Array.isArray(progress?.steps) ? progress.steps.flatMap((value) => {
+    const item = asObject(value);
+    const id = pickString(item, "id");
+    const status = pickString(item, "status");
+    const durationMs = pickNumber(item, "durationMs");
+    return id && ["doctor", "status", "launch", "fixtures", "verify"].includes(id) && status && ["pass", "fail", "skipped"].includes(status) && durationMs !== void 0 ? [{ id, status, durationMs }] : [];
+  }) : [];
+  return { step, startedAt, updatedAt: updatedAtIso, elapsedMs: Math.max(0, now - stepStartedAt), completed: steps.length, total, steps };
+}
 function readLastCommand(target, now) {
   const { record } = readCommandJournal(target);
   if (!record) return void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"