@deeeed/metamask-harness 0.17.4 → 0.17.5

package/dist/commands/last.js

@@ -1,52 +0,0 @@
-import { readCommandJournal } from "../command-journal.js";
-import { EXIT } from "./shared.js";
-import {
-  optionFlag,
-  optionString,
-  targetPath
-} from "./parse-args.js";
-async function handleLast({ options }) {
-  const target = targetPath(options);
-  const { file, record } = readCommandJournal(target, optionString(options, "runtimeDir"));
-  const json = optionFlag(options, "json");
-  if (!record) {
-    const message = `no resumability journal exists for ${target}`;
-    const userAction = "run a proof or runtime command in this checkout, then re-run mm-harness last --json";
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "last",
-        target,
-        journalPath: file,
-        status: "fail",
-        exitCode: EXIT.runtime,
-        error: { code: "LAST_NOT_FOUND", message, userAction }
-      }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness last: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.runtime;
-  }
-  if (json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "last",
-      target,
-      journalPath: file,
-      status: "pass",
-      exitCode: EXIT.ok,
-      last: record
-    }, null, 2));
-  } else {
-    const end = record.finishedAt ?? "still running or interrupted";
-    console.log(`${record.verdict.toUpperCase()} ${record.command} (exit ${record.exitCode ?? "pending"})`);
-    console.log(`started: ${record.startedAt}`);
-    console.log(`finished: ${end}`);
-    if (record.evidencePaths.length > 0) console.log(`evidence: ${record.evidencePaths.join(", ")}`);
-  }
-  return EXIT.ok;
-}
-export {
-  handleLast
-};

package/dist/json-stream.js

@@ -1,57 +0,0 @@
-class JsonStreamWriter {
-  enabled;
-  command;
-  completed = false;
-  writeLine;
-  constructor(command, enabled, output = process.stdout) {
-    this.command = command;
-    this.enabled = enabled;
-    const write = output.write.bind(output);
-    this.writeLine = (line) => {
-      write(`${line}
-`);
-    };
-  }
-  isolateStdout() {
-    if (!this.enabled) return () => void 0;
-    const original = process.stdout.write;
-    const redirect = ((chunk, encoding, callback) => process.stderr.write(chunk, encoding, callback));
-    process.stdout.write = redirect;
-    return () => {
-      if (process.stdout.write === redirect) process.stdout.write = original;
-    };
-  }
-  emit(event, fields = {}) {
-    if (!this.enabled || this.completed) return;
-    this.writeLine(JSON.stringify({
-      schemaVersion: 1,
-      command: this.command,
-      event,
-      ...fields,
-      ts: (/* @__PURE__ */ new Date()).toISOString()
-    }));
-  }
-  phase(phase, fields = {}) {
-    this.emit("phase", { phase, ...fields });
-  }
-  node(nodeId, action, status) {
-    this.emit("node", { nodeId, action, status });
-  }
-  mutation(mutation) {
-    this.emit("mutation", { mutation });
-  }
-  recovery(code) {
-    this.emit("recovery", { code });
-  }
-  error(error) {
-    this.emit("error", { error });
-  }
-  complete(status, exitCode, fields = {}) {
-    if (!this.enabled || this.completed) return;
-    this.emit("complete", { status, exitCode, ...fields });
-    this.completed = true;
-  }
-}
-export {
-  JsonStreamWriter
-};

package/dist/run-diagnostics.js

@@ -1,261 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { createHash } from "node:crypto";
-import { spawnSync } from "node:child_process";
-import { getAdapterSurface } from "./adapters/surface.js";
-import { runnerDir } from "./paths.js";
-import { ensureExtensionConsoleCapture } from "./adapters/extension/console-capture.js";
-const MAX_CAPTURE_BYTES = 512 * 1024;
-const MAX_FINDINGS = 20;
-const MAX_PREVIEW_CHARS = 320;
-function readRunDiagnosticsDocument(diagnosticsPath) {
-  if (typeof diagnosticsPath !== "string" || diagnosticsPath.length === 0) return null;
-  try {
-    const document = JSON.parse(fs.readFileSync(diagnosticsPath, "utf8"));
-    return isRunDiagnosticsDocument(document) ? document : null;
-  } catch {
-    return null;
-  }
-}
-function formatRunDiagnosticsForHuman(diagnostics, adapter) {
-  if (!diagnostics) {
-    return [adapter === "core" ? "N/A \u2014 Core is headless and has no application log source." : "UNAVAILABLE \u2014 application diagnostics could not be collected for this run."];
-  }
-  const status = diagnostics.status === "clean" ? "CLEAN" : diagnostics.status === "review" ? "REVIEW" : "UNAVAILABLE";
-  const lines = [`${status} \u2014 ${diagnostics.note}`];
-  for (const finding of diagnostics.findings) {
-    const count = finding.count > 1 ? ` \xD7${finding.count}` : "";
-    lines.push(`${finding.level.toUpperCase()}${count} \u2014 ${finding.preview}`);
-  }
-  return lines;
-}
-async function beginRunDiagnostics(adapter, projectRoot) {
-  const source = getAdapterSurface(adapter).appLogSource(projectRoot);
-  if (!source) return null;
-  const mobileIssueBuffer = adapter === "mobile" && armMobileIssueBuffer(projectRoot) ? { projectRoot } : void 0;
-  if (adapter === "extension") {
-    await ensureExtensionConsoleCapture(projectRoot).catch(() => void 0);
-  }
-  const stat = safeStat(source.path);
-  return {
-    source,
-    offset: stat?.size ?? 0,
-    ...stat ? { inode: stat.ino } : {},
-    ...mobileIssueBuffer ? { mobileIssueBuffer } : {}
-  };
-}
-function isRunDiagnosticsDocument(value) {
-  if (!isRecord(value) || value.schemaVersion !== 1 || value.scope !== "recipe-run-application") return false;
-  if (value.status !== "clean" && value.status !== "review" && value.status !== "unavailable") return false;
-  return typeof value.note === "string" && Array.isArray(value.findings);
-}
-function finishRunDiagnostics(baseline, result) {
-  if (!baseline) return result;
-  try {
-    const bufferedIssues = baseline.mobileIssueBuffer ? collectMobileIssueBuffer(baseline.mobileIssueBuffer.projectRoot) : void 0;
-    const diagnostics = collectRunDiagnostics(baseline, bufferedIssues);
-    const artifactsDir = path.dirname(result.summaryPath);
-    const diagnosticsPath = path.join(artifactsDir, "diagnostics.json");
-    fs.writeFileSync(diagnosticsPath, `${JSON.stringify(diagnostics, null, 2)}
-`);
-    indexDiagnosticArtifact(result.artifactManifestPath);
-    indexDiagnosticSummary(result.summaryPath, diagnostics);
-    return {
-      ...result,
-      diagnosticsPath,
-      sideFindings: {
-        status: diagnostics.status,
-        note: diagnostics.note,
-        counts: diagnostics.counts
-      }
-    };
-  } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
-    console.warn(`WARN: run diagnostics were unavailable: ${detail}`);
-    return {
-      ...result,
-      sideFindings: {
-        status: "unavailable",
-        note: "Run diagnostics could not be collected; the recipe result is unchanged.",
-        counts: { total: 0, warning: 0, error: 0, exception: 0 }
-      }
-    };
-  }
-}
-function collectRunDiagnostics(baseline, bufferedIssues) {
-  const stat = safeStat(baseline.source.path);
-  const source = {
-    label: baseline.source.label,
-    path: baseline.source.path,
-    startOffset: baseline.offset,
-    endOffset: stat?.size ?? baseline.offset,
-    bytesRead: 0,
-    truncated: false,
-    inAppBuffer: bufferedIssues === void 0 ? "n/a" : bufferedIssues === null ? "unavailable" : "collected"
-  };
-  let text = "";
-  if (stat) {
-    const sameFile = baseline.inode === void 0 || baseline.inode === stat.ino;
-    const startOffset = sameFile && stat.size >= baseline.offset ? baseline.offset : 0;
-    const available = Math.max(0, stat.size - startOffset);
-    const bytesToRead = Math.min(available, MAX_CAPTURE_BYTES);
-    source.startOffset = startOffset;
-    source.endOffset = stat.size;
-    source.bytesRead = bytesToRead;
-    source.truncated = available > MAX_CAPTURE_BYTES;
-    if (bytesToRead > 0) text = readSlice(baseline.source.path, startOffset, bytesToRead);
-  }
-  const allFindings = dedupeFindings(
-    [
-      ...text.split(/\r?\n/u).map(classifyLine).filter((finding) => finding !== null),
-      ...(bufferedIssues ?? []).map(classifyBufferedIssue).filter((finding) => finding !== null)
-    ]
-  );
-  const findings = allFindings.slice(0, MAX_FINDINGS);
-  const counts = countFindings(allFindings);
-  const status = counts.total > 0 ? "review" : stat || bufferedIssues !== void 0 && bufferedIssues !== null ? "clean" : "unavailable";
-  const note = counts.total > 0 ? `Observed ${counts.total} distinct application warning/error event(s) during the recipe run; relation to the task is not determined.` : status === "clean" ? "No application warnings or errors were emitted during the recipe run." : "Application diagnostics were unavailable for this run.";
-  return {
-    schemaVersion: 1,
-    scope: "recipe-run-application",
-    status,
-    nonBlocking: true,
-    note,
-    source,
-    counts,
-    findings
-  };
-}
-function classifyLine(line) {
-  const trimmed = line.trim();
-  if (!trimmed) return null;
-  let level = null;
-  if (/\bEXCEPTION\s{2,}|\b(?:Uncaught|UnhandledPromiseRejection|FATAL EXCEPTION)\b/iu.test(trimmed)) {
-    level = "exception";
-  } else if (/^(?:ERROR\s{2,}|\[error\]\s*)/iu.test(trimmed) || /\]\s+ERROR\s{2,}/u.test(trimmed)) {
-    level = "error";
-  } else if (/^(?:WARN(?:ING)?\s{2,}|\[warn(?:ing)?\]\s*)/iu.test(trimmed) || /\]\s+WARN(?:ING)?\s{2,}/u.test(trimmed)) {
-    level = "warning";
-  }
-  if (!level) return null;
-  return makeFinding(level, trimmed);
-}
-function classifyBufferedIssue(value) {
-  if (!isRecord(value) || typeof value.text !== "string") return null;
-  const rawLevel = String(value.level ?? "").toLowerCase();
-  const level = rawLevel === "warn" || rawLevel === "warning" ? "warning" : rawLevel === "error" ? "error" : rawLevel === "exception" ? "exception" : null;
-  return level ? makeFinding(level, value.text) : null;
-}
-function makeFinding(level, text) {
-  const preview = redactPreview(text.trim());
-  const identity = preview.replace(/\b\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?\b/gu, "[TIME]").replace(/\[(?:sw|page:[^\]]+|console:[^\]]+)\]/gu, "[APP]").replace(/^(?:(?:WARN(?:ING)?|ERROR|EXCEPTION|\[TIME\]|\[APP\])\s*)+/u, "");
-  return {
-    level,
-    fingerprint: createHash("sha256").update(`${level}|${identity}`).digest("hex").slice(0, 12),
-    preview
-  };
-}
-function armMobileIssueBuffer(projectRoot) {
-  const armed = runMobileIssueCommand(projectRoot, "issues-arm");
-  if (!armed) return false;
-  return runMobileIssueCommand(projectRoot, "issues-collect") !== null;
-}
-function collectMobileIssueBuffer(projectRoot) {
-  const result = runMobileIssueCommand(projectRoot, "issues-collect");
-  return isRecord(result) && Array.isArray(result.entries) ? result.entries : null;
-}
-function runMobileIssueCommand(projectRoot, command) {
-  const bridge = path.join(runnerDir, "adapters", "mobile", "bridge-runtime", "cdp-bridge.cjs");
-  const result = spawnSync(process.execPath, [bridge, command], {
-    cwd: projectRoot,
-    env: { ...process.env, APP_ROOT: projectRoot, CDP_TIMEOUT: "5000" },
-    encoding: "utf8",
-    timeout: 1e4
-  });
-  if (result.status !== 0) return null;
-  try {
-    return JSON.parse(result.stdout.trim());
-  } catch {
-    return null;
-  }
-}
-function redactPreview(value) {
-  return value.replace(/\b(Bearer)\s+\S+/giu, "$1 [REDACTED]").replace(/\b(password|passphrase|mnemonic|seed(?:Phrase)?|privateKey|secret|token|authorization)\b\s*[:=]\s*(?:"[^"]*"|'[^']*'|\S+)/giu, "$1=[REDACTED]").replace(/\b(?:0x)?[a-f0-9]{64,}\b/giu, "[REDACTED_HEX]").replace(/(https?:\/\/[^\s?]+)\?\S+/giu, "$1?[REDACTED_QUERY]").slice(0, MAX_PREVIEW_CHARS);
-}
-function dedupeFindings(findings) {
-  const byFingerprint = /* @__PURE__ */ new Map();
-  for (const finding of findings) {
-    const existing = byFingerprint.get(finding.fingerprint);
-    if (existing) existing.count += 1;
-    else byFingerprint.set(finding.fingerprint, { ...finding, count: 1 });
-  }
-  return [...byFingerprint.values()];
-}
-function countFindings(findings) {
-  const counts = { total: findings.length, warning: 0, error: 0, exception: 0 };
-  for (const finding of findings) counts[finding.level] += 1;
-  return counts;
-}
-function readSlice(filePath, offset, length) {
-  const fd = fs.openSync(filePath, "r");
-  try {
-    const buffer = Buffer.alloc(length);
-    const bytesRead = fs.readSync(fd, buffer, 0, length, offset);
-    return buffer.subarray(0, bytesRead).toString("utf8");
-  } finally {
-    fs.closeSync(fd);
-  }
-}
-function safeStat(filePath) {
-  try {
-    return fs.statSync(filePath);
-  } catch {
-    return null;
-  }
-}
-function indexDiagnosticArtifact(manifestPath) {
-  const manifest = readJsonRecord(manifestPath);
-  if (!manifest) return;
-  const artifacts = Array.isArray(manifest.artifacts) ? manifest.artifacts : [];
-  manifest.artifacts = [
-    ...artifacts.filter((artifact) => !isRecord(artifact) || artifact.path !== "diagnostics.json"),
-    {
-      path: "diagnostics.json",
-      type: "json",
-      label: "Run-scoped application diagnostics",
-      category: "diagnostic"
-    }
-  ];
-  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}
-`);
-}
-function indexDiagnosticSummary(summaryPath, diagnostics) {
-  const summary = readJsonRecord(summaryPath);
-  if (!summary) return;
-  summary.sideFindings = {
-    status: diagnostics.status,
-    nonBlocking: true,
-    counts: diagnostics.counts,
-    diagnosticsPath: "diagnostics.json"
-  };
-  fs.writeFileSync(summaryPath, `${JSON.stringify(summary, null, 2)}
-`);
-}
-function readJsonRecord(filePath) {
-  try {
-    const value = JSON.parse(fs.readFileSync(filePath, "utf8"));
-    return isRecord(value) ? value : null;
-  } catch {
-    return null;
-  }
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-export {
-  beginRunDiagnostics,
-  collectRunDiagnostics,
-  finishRunDiagnostics,
-  formatRunDiagnosticsForHuman,
-  readRunDiagnosticsDocument
-};

package/docs/CLI-ERGONOMICS-AUDIT.md

@@ -1,32 +0,0 @@
-<!-- Generated by scripts/generate-cli-ergonomics-audit.mjs. Do not edit by hand. -->
-# CLI ergonomics audit
-
-This matrix tracks the public command surface. “Covered” means the shared preflight contract and
-`tests/contract/cli-teaching-errors.test.sh` exercise the behavior without dispatching runtime work.
-Runtime recovery is claimed only where command-specific failures return a stable `userAction`.
-Success hints are intentionally limited to lifecycle transitions with one truthful next command;
-discovery, read-only, and terminal evidence commands do not invent one. ID prefix support is N/A
-unless a command displays a shortened ID that another command accepts.
-
-| Command | Bad flag | First feedback | `--json` recovery | Success next step | Displayed ID prefix |
-|---|---|---|---|---|---|
-| `status` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | structured `next` | N/A: command displays no shortened ID |
-| `checklist` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage errors covered; no runtime recovery claim | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `actions` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `stop` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | launch `next` when the adapter has one unambiguous launch | N/A: command displays no shortened ID |
-| `call` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `flows` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage errors covered; no runtime recovery claim | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `run` | covered: `CLI_UNKNOWN_OPTION` | TTY intent before slow work; machine output clean | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `last` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `doctor` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `check` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `recipe-quality` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `provision` | covered: `CLI_UNKNOWN_OPTION` | TTY intent before slow work; machine output clean | usage + runtime `error.code/message/userAction` | launch `next` after install | N/A: command displays no shortened ID |
-| `install` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | verify `next` | N/A: command displays no shortened ID |
-| `verify` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | status `next` | N/A: command displays no shortened ID |
-| `cleanup` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | install `next` | N/A: command displays no shortened ID |
-| `launch` | covered: `CLI_UNKNOWN_OPTION` | TTY intent before slow work; machine output clean | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `logs` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `debug` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage errors covered; no runtime recovery claim | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `update` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |
-| `fixtures` | covered: `CLI_UNKNOWN_OPTION` | N/A: no newly introduced slow path | usage + runtime `error.code/message/userAction` | N/A: discovery, read-only, or terminal result | N/A: command displays no shortened ID |

package/docs/CLI-ERGONOMICS-HUMAN-QA.md

@@ -1,64 +0,0 @@
-# Human QA
-
-Run this from each product checkout before a release. Verify the visible outcome,
-not only the exit code.
-
-Run the non-visual gate first:
-
-```bash
-yarn qa:human \
-  --extension /path/to/metamask-extension \
-  --mobile /path/to/metamask-mobile \
-  --core /path/to/metamask-core \
-  --artifacts-dir temp/human-qa
-```
-
-It verifies live readiness, installed runtime, debugger target resolution, smoke
-evidence, and unchanged tracked product source. The checks below cover outcomes
-that still require eyes or an intentional source edit.
-
-## Common
-
-- [ ] `mm-harness --version` prints the candidate version.
-- [ ] `mm-harness doctor` detects the correct product and reports only current
-      configuration.
-- [ ] Without `capture-helper`, `doctor` names the CDP or simulator/ADB screenshot
-      fallback and says video is unavailable.
-- [ ] A misspelled flag explains the error and gives a runnable next command.
-- [ ] `mm-harness actions` and `mm-harness flows` return useful, bounded discovery.
-- [ ] `mm-harness fixtures set` either applies the fixture or names the missing
-      file and exact recovery action.
-- [ ] `mm-harness run <safe-recipe> --artifacts-dir temp/qa-proof` prints findings,
-      diagnostics, and absolute evidence paths.
-- [ ] `mm-harness last --json` identifies that run without rerunning it.
-- [ ] `mm-harness doctor --json` is one parseable document with no human decoration.
-
-## Extension
-
-- [ ] `mm-harness launch` opens/reuses the checkout's named Chrome profile.
-- [ ] `mm-harness launch --sidepanel` opens the MetaMask sidepanel without extra
-      Extension tabs.
-- [ ] `mm-harness debug` opens connected DevTools for the active MetaMask target.
-- [ ] `mm-harness logs --source extension` shows Extension console events.
-- [ ] `mm-harness logs --source dapp` shows dapp console events separately.
-- [ ] Edit a visible source string twice, waiting for successful incremental
-      compilation after each edit; refresh the browser and confirm both changes.
-- [ ] Revert the edit, confirm a third incremental compilation, and verify the
-      same watcher and Chrome process were reused.
-
-## Mobile
-
-- [ ] `mm-harness launch ios` boots/reuses the intended simulator and opens the app.
-- [ ] `mm-harness launch android` targets the intended emulator/device.
-- [ ] `mm-harness logs --source metro` and `--source app` show distinct streams.
-- [ ] `mm-harness debug` opens the usable React Native developer surface.
-- [ ] Change a visible JS string, confirm Metro rebuilds, reload the app, and see
-      the change without a native rebuild.
-
-## Core
-
-- [ ] `mm-harness status`, `doctor`, `actions`, `flows`, and a safe recipe run work
-      without browser/device assumptions.
-
-Record the command, version, checkout SHA, visible mismatch, exit code, and JSON
-error envelope for any failure.

package/docs/VIDEO-DEMO-VALIDATION.md

@@ -1,74 +0,0 @@
-# Video demo validation
-
-Use this checklist against the installed release before recording. Each checkout
-auto-detects its platform, ports, and slot; the paths below are placeholders only.
-
-```bash
-export EXTENSION_CHECKOUT=/path/to/metamask-extension
-export MOBILE_CHECKOUT=/path/to/metamask-mobile
-export CORE_CHECKOUT=/path/to/core
-```
-
-## Common
-
-- [ ] `mm-harness --version` prints the intended release.
-- [ ] `mm-harness doctor` explains any unavailable capability and gives one next step.
-- [ ] Recipe results print diagnostics and absolute artifact paths inline.
-- [ ] `git status --short` is unchanged in each product checkout after validation.
-
-## Extension
-
-```bash
-cd "$EXTENSION_CHECKOUT"
-mm-harness launch --build --verify
-mm-harness doctor
-mm-harness actions positions
-mm-harness flows
-mm-harness run runner.smoke --artifacts-dir temp/demo
-mm-harness run wallet.smoke --artifacts-dir temp/wallet-demo
-mm-harness logs --source app
-mm-harness debug
-```
-
-- [ ] Launch keeps an incremental webpack watcher alive.
-- [ ] Two small source edits compile incrementally; browser refresh shows both changes.
-- [ ] `debug` connects to the active slot's MetaMask target and opens Console.
-- [ ] `logs --source app` shows extension logs; `--source dapp` and `--source webpack`
-      show their separate streams.
-- [ ] Each recipe prints `diagnostics: CLEAN` or expands every warning/error inline.
-- [ ] Each recipe prints absolute paths for its report, trace, diagnostics, screenshots,
-      and artifact manifest.
-
-## Mobile
-
-```bash
-cd "$MOBILE_CHECKOUT"
-mm-harness launch ios --verify
-mm-harness fixtures set
-mm-harness call metamask.wallet.ensure_unlocked
-mm-harness status
-mm-harness logs --source app
-```
-
-- [ ] The intended simulator is running; focus changes only when explicitly requested.
-- [ ] Fixture setup reads the canonical checkout fixture and unlocks the wallet.
-- [ ] Status reports the live route, wallet state, account, and fixture readiness.
-- [ ] App logs are separate from Metro logs (`mm-harness logs --source metro`).
-
-## Core
-
-```bash
-cd "$CORE_CHECKOUT"
-mm-harness doctor
-mm-harness run runner.smoke --artifacts-dir temp/demo
-```
-
-- [ ] Doctor reports the headless controller ready.
-- [ ] The canonical wallet fixture supplies the default account.
-- [ ] Evidence paths are absolute; diagnostics is explicitly `N/A` for headless Core.
-
-## Recording path
-
-Show the Extension discovery and proof commands, then the equivalent Mobile and Core
-commands. The useful story is: one auto-detected CLI, reusable team libraries,
-parameterized recipes, app diagnostics, and proof artifacts that a human can inspect.

package/library/recipes/runner/smoke.core.recipe.json

@@ -1,27 +0,0 @@
-{
-  "schema_version": 1,
-  "title": "MetaMask Core runner smoke",
-  "description": "Proves the headless Core runner resolves the checkout, executes generic actions, and writes a valid artifact package.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "package",
-          "intent": "Resolve the Core checkout and report headless readiness"
-        },
-        "package": {
-          "action": "assert_file",
-          "path": "package.json",
-          "next": "done",
-          "intent": "Prove generic project-file assertions work in Core"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
-      }
-    }
-  }
-}

package/library/recipes/wallet/smoke.extension.recipe.json

@@ -1,42 +0,0 @@
-{
-  "schema_version": 1,
-  "title": "MetaMask Extension wallet smoke",
-  "description": "Fixture-backed proof that the Extension wallet is reachable, unlocked, readable, and visually capturable without depending on a product feature domain.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "fixture",
-          "intent": "Confirm the Extension runtime is reachable"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "next": "unlock",
-          "intent": "Confirm the checkout wallet fixture is ready"
-        },
-        "unlock": {
-          "action": "metamask.wallet.ensure_unlocked",
-          "next": "state",
-          "intent": "Ensure the fixture-backed wallet is unlocked"
-        },
-        "state": {
-          "action": "metamask.wallet.read_state",
-          "next": "screenshot",
-          "intent": "Read the current wallet state through the public adapter"
-        },
-        "screenshot": {
-          "action": "ui.screenshot",
-          "path": "screenshots/wallet-smoke.png",
-          "next": "done",
-          "intent": "Capture visual wallet evidence"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
-      }
-    }
-  }
-}

package/library/recipes/wallet/smoke.mobile.recipe.json

@@ -1,42 +0,0 @@
-{
-  "schema_version": 1,
-  "title": "MetaMask Mobile wallet smoke",
-  "description": "Fixture-backed proof that the Mobile wallet is reachable, unlocked, readable, and visually capturable without depending on a product feature domain.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "fixture",
-          "intent": "Confirm the Mobile runtime is reachable"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "next": "unlock",
-          "intent": "Confirm the checkout wallet fixture is ready"
-        },
-        "unlock": {
-          "action": "metamask.wallet.ensure_unlocked",
-          "next": "state",
-          "intent": "Ensure the fixture-backed wallet is unlocked"
-        },
-        "state": {
-          "action": "metamask.wallet.read_state",
-          "next": "screenshot",
-          "intent": "Read the current wallet state through the public adapter"
-        },
-        "screenshot": {
-          "action": "ui.screenshot",
-          "path": "screenshots/wallet-smoke.png",
-          "next": "done",
-          "intent": "Capture visual wallet evidence"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
-      }
-    }
-  }
-}