@deeeed/metamask-harness 0.92.22 → 0.92.23

package/dist/task-view.js

@@ -1,332 +0,0 @@
-import { readOperations, processIdentity } from "@farmslot/recipe-runner/runtime/operation";
-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,
-  enumerateChecklistCheckboxes,
-  INTERACTIVE_CHECKLIST_MARKDOWN,
-  isSettledSubtaskStatus,
-  isTerminalWorkerSignalStatus,
-  READINESS_RECORD,
-  SUBTASK_INDEX_FILE,
-  SUBTASKS_DIR,
-  subtaskPaths,
-  WORKER_SIGNAL_FILE
-} from "@farmslot/protocol";
-import { readCommandJournal, recipeRuntimeDir, resolveRuntimeContextPath } from "@farmslot/recipe-cli/harness";
-import { PREPARE_PROGRESS_ARTIFACT } from "./paths.js";
-import { parseLibraryPathEnv } from "./review/knowledge.js";
-const CHECKLIST_LABEL_LIMIT = 70;
-const TASK_SILENT_AFTER_MS = 10 * 60 * 1e3;
-function findTaskDir(target) {
-  return latestTaskDir(path.join(target, "temp", "tasks"));
-}
-function collectTaskView(target, taskDir, now) {
-  target = fs.existsSync(target) ? fs.realpathSync(target) : path.resolve(target);
-  taskDir = taskDir && (fs.existsSync(taskDir) ? fs.realpathSync(taskDir) : path.resolve(taskDir));
-  const taskIsRunning = taskDir && readJsonObject(path.join(taskDir, WORKER_SIGNAL_FILE))?.status === "running";
-  const operations = readOperations(path.join(target, recipeRuntimeDir(), "operations")).filter((operation) => !taskIsRunning || path.resolve(operation.logPath).startsWith(path.resolve(taskDir, "artifacts", "operations") + path.sep)).map((operation) => ({ ...operation, ownerAlive: operation.status === "running" && processIdentity(operation.pid) === operation.processStartedAt }));
-  const base = {
-    operations,
-    checkout: readCheckout(target),
-    isolation: readIsolation(target),
-    libraries: parseLibraryPathEnv(process.env.RECIPE_LIBRARY_PATH).map(
-      ({ name, root }) => ({ ...name ? { name } : {}, path: root })
-    )
-  };
-  if (!taskDir) {
-    return { ...base, checklist: [], subtasks: [], activity: { ongoing: false, reason: "no-task" } };
-  }
-  const handoff = readJsonObject(path.join(taskDir, HANDOFF_INPUT));
-  const fixtures = readJsonObject(path.join(taskDir, "artifacts", "prepare", "fixtures.json"));
-  const sandbox = readJsonObject(path.join(taskDir, "artifacts", READINESS_RECORD)) ?? readJsonObject(path.join(target, recipeRuntimeDir(), READINESS_RECORD));
-  const signal = readJsonObject(path.join(taskDir, WORKER_SIGNAL_FILE));
-  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);
-  const commandAt = parseTime(journal?.at);
-  const commandCounts = commandAt !== void 0 && (startedAt === void 0 || commandAt >= startedAt);
-  const lastCommand = commandCounts ? journal : void 0;
-  const activity = taskActivity({
-    status: pickString(signal, "status"),
-    lastWrites: [
-      startedAt,
-      parseTime(pickString(signal, "timestamp")),
-      ...readMarkEvents(signal).map((event) => Date.parse(event.checkedAt)),
-      commandCounts ? commandAt : void 0,
-      prepare ? parseTime(prepare.updatedAt) : void 0,
-      ...operations.flatMap((operation) => [parseTime(operation.lastOutputAt), parseTime(operation.stageStartedAt), parseTime(operation.startedAt)])
-    ],
-    branch: base.checkout.branch,
-    ticket,
-    now
-  });
-  return {
-    ...base,
-    taskDir,
-    // The readiness record is the only place a harness records itself for a task.
-    harness: section({
-      version: pickString(asObject(sandbox?.harness), "version"),
-      sourceKind: pickString(asObject(sandbox?.harness), "source")
-    }),
-    template: section({
-      id: pickString(template, "id"),
-      sourceId: pickString(template, "sourceId"),
-      flow: pickString(handoff, "flow"),
-      domain: pickString(handoff, "domain"),
-      surface: pickString(handoff, "surface"),
-      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"),
-      status: pickString(fixtures, "status"),
-      walletReset: pickBoolean(fixtures, "walletReset")
-    }),
-    sandbox: section({ ready: pickBoolean(sandbox, "ready") }),
-    ...prepare ? { prepare } : {},
-    checklist,
-    subtasks: readSubtasks(taskDir),
-    signal: section({
-      status: pickString(signal, "status"),
-      step: pickString(signal, "step"),
-      timestamp: pickString(signal, "timestamp"),
-      attemptId: pickString(signal, "attemptId")
-    }),
-    ...lastCommand ? { lastCommand } : {},
-    ...timing,
-    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;
-  const first = record.args[0];
-  const subject = first !== void 0 && !first.startsWith("-") ? first : void 0;
-  const at = record.finishedAt || record.startedAt;
-  const atMs = parseTime(at);
-  return {
-    command: record.command,
-    ...subject ? { subject } : {},
-    verdict: record.verdict,
-    ...at ? { at } : {},
-    ...atMs !== void 0 ? { ageMs: Math.max(0, now - atMs) } : {}
-  };
-}
-function taskActivity(input) {
-  const writes = input.lastWrites.filter((value) => value !== void 0);
-  const idleMs = writes.length > 0 ? input.now - Math.max(...writes) : void 0;
-  const branchCarriesTicket = input.ticket && input.branch ? input.branch.includes(input.ticket) : void 0;
-  const extra = {
-    ...idleMs !== void 0 ? { idleMs } : {},
-    ...branchCarriesTicket !== void 0 ? { branchCarriesTicket } : {}
-  };
-  if (input.status === void 0 && writes.length === 0) return { ongoing: false, reason: "no-task", ...extra };
-  if (isTerminalWorkerSignalStatus(input.status)) return { ongoing: false, reason: "finished", ...extra };
-  if (idleMs !== void 0 && idleMs > TASK_SILENT_AFTER_MS) return { ongoing: false, reason: "silent", ...extra };
-  return { ongoing: true, ...extra };
-}
-function applyTiming(rows, signal, startedAtIso, now) {
-  const events = readMarkEvents(signal);
-  const durations = new Map(
-    deriveChecklistStepDurations({ schemaVersion: 1, events }, startedAtIso).map((step) => [
-      step.stepNumber,
-      step.durationMs
-    ])
-  );
-  const marks = new Map(events.map((event) => [event.stepNumber, Date.parse(event.checkedAt)]));
-  for (const row of rows) {
-    const durationMs = durations.get(row.number);
-    if (durationMs !== void 0) row.durationMs = durationMs;
-  }
-  const instants = [...marks.values()];
-  const lastAt = instants.length > 0 ? Math.max(...instants) : void 0;
-  const firstAt = instants.length > 0 ? Math.min(...instants) : void 0;
-  const current = rows.find((row) => !row.checked);
-  if (current && lastAt !== void 0) current.runningMs = now - lastAt;
-  const origin = parseTime(startedAtIso) ?? firstAt;
-  return {
-    ...current ? { currentStep: current.number } : {},
-    ...origin !== void 0 ? { elapsedMs: now - origin } : {}
-  };
-}
-function readMarkEvents(signal) {
-  const events = asObject(signal?.checklistTiming)?.events;
-  if (!Array.isArray(events)) return [];
-  const marks = [];
-  for (const entry of events) {
-    const event = asObject(entry);
-    const stepNumber = pickNumber(event, "stepNumber");
-    const checkedAt = pickString(event, "checkedAt");
-    if (stepNumber === void 0 || parseTime(checkedAt) === void 0) continue;
-    marks.push({ stepNumber, label: "", checkedAt });
-  }
-  return marks;
-}
-function readChecklistRows(file) {
-  const text = readTextFile(file);
-  if (text === void 0) return [];
-  return enumerateChecklistCheckboxes(text).map((item) => ({
-    ...item.phase ? { phase: item.phase } : {},
-    number: item.stepNumber,
-    label: trimLabel(item.rawLabel),
-    checked: item.checked
-  }));
-}
-function readSubtasks(taskDir) {
-  const index = readJsonObject(path.join(taskDir, SUBTASKS_DIR, SUBTASK_INDEX_FILE));
-  if (!index) return [];
-  const units = index.units;
-  if (!Array.isArray(units)) return [];
-  const views = [];
-  for (const entry of units) {
-    const unit = asObject(entry);
-    const id = pickString(unit, "id");
-    const parentStep = pickNumber(asObject(unit?.parent), "stepNumber");
-    if (id === void 0 || parentStep === void 0) continue;
-    const paths = subtaskPaths(id);
-    const signal = readJsonObject(path.join(taskDir, paths.signal));
-    const status = pickString(signal, "status");
-    const source = asObject(unit?.source);
-    views.push({
-      id,
-      parentStep,
-      ...status !== void 0 ? { status } : {},
-      settled: isSettledSubtaskStatus(status),
-      rows: readChecklistRows(path.join(taskDir, paths.checklist)),
-      ...section({ kind: pickString(source, "kind"), ref: pickString(source, "ref") }) ? { source: section({ kind: pickString(source, "kind"), ref: pickString(source, "ref") }) } : {}
-    });
-  }
-  return views;
-}
-function trimLabel(text) {
-  const plain = checklistStepName(text).replace(/\*\*/gu, "").replace(/^\d+\.\s*/u, "").replace(/\s+/gu, " ").trim();
-  if (plain.length <= CHECKLIST_LABEL_LIMIT) return plain;
-  return `${plain.slice(0, CHECKLIST_LABEL_LIMIT).trimEnd()}\u2026`;
-}
-function readCheckout(target) {
-  const branch = gitRef(target, "--abbrev-ref");
-  const head = gitRef(target, "--short");
-  return { target, ...branch ? { branch } : {}, ...head ? { head } : {} };
-}
-function gitRef(target, mode) {
-  const result = spawnSync("git", ["-C", target, "rev-parse", mode, "HEAD"], { encoding: "utf8" });
-  if (result.status !== 0) return void 0;
-  return result.stdout.trim() || void 0;
-}
-function readIsolation(target) {
-  const context = readJsonObject(resolveRuntimeContextPath(target));
-  if (!context) return void 0;
-  return section({
-    slotId: pickString(context, "slotId"),
-    platform: pickString(context, "platform"),
-    metroPort: pickNumber(context, "metroPort"),
-    watcherPort: pickNumber(context, "watcherPort"),
-    devServerPort: pickNumber(context, "devServerPort"),
-    simulator: pickString(context, "simulator"),
-    simulatorUdid: pickString(context, "simulatorUdid"),
-    cdpPort: pickNumber(context, "cdpPort"),
-    extensionId: pickString(context, "extensionId")
-  });
-}
-function readTextFile(file) {
-  try {
-    return fs.readFileSync(file, "utf8");
-  } catch (error) {
-    if (error.code === "ENOENT") return void 0;
-    throw error;
-  }
-}
-function readJsonObject(file) {
-  const raw = readTextFile(file);
-  if (raw === void 0) return void 0;
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (error) {
-    throw new Error(`${file} is not valid JSON: ${error.message}`);
-  }
-  const object = asObject(parsed);
-  if (!object) throw new Error(`${file} must contain a JSON object.`);
-  return object;
-}
-function asObject(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-  return value;
-}
-function pickString(source, key) {
-  const value = source?.[key];
-  return typeof value === "string" && value !== "" ? value : void 0;
-}
-function pickNumber(source, key) {
-  const value = source?.[key];
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-}
-function pickBoolean(source, key) {
-  const value = source?.[key];
-  return typeof value === "boolean" ? value : void 0;
-}
-function parseTime(value) {
-  if (value === void 0) return void 0;
-  const parsed = Date.parse(value);
-  return Number.isFinite(parsed) ? parsed : void 0;
-}
-function section(value) {
-  return Object.values(value).some((entry) => entry !== void 0) ? value : void 0;
-}
-export {
-  CHECKLIST_LABEL_LIMIT,
-  TASK_SILENT_AFTER_MS,
-  collectTaskView,
-  findTaskDir
-};