@deeeed/metamask-harness 0.79.0 → 0.81.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (252) hide show
  1. package/CHANGELOG.md +73 -0
  2. package/README.md +1 -1
  3. package/adapters/extension/ensure-browser.sh +2 -2
  4. package/adapters/extension/inject.mjs +0 -1
  5. package/adapters/extension/launch-browser.cjs +39 -613
  6. package/adapters/extension/readiness.mjs +2 -5
  7. package/adapters/extension/reattach.sh +2 -2
  8. package/adapters/extension/stamp-runtime-title.cjs +1 -1
  9. package/adapters/manifest.json +16 -64
  10. package/adapters/mobile/bridge-runtime/cdp-bridge.cjs +57 -1358
  11. package/adapters/mobile/bridge-runtime/teaching.cjs +20 -0
  12. package/adapters/mobile/inject.sh +16 -0
  13. package/adapters/mobile/launch-console-forwarder.cjs +1 -2
  14. package/adapters/mobile/open-device.sh +2 -2
  15. package/adapters/mobile/reload-app.mjs +4 -4
  16. package/adapters/mobile/reset-app-data.sh +1 -1
  17. package/adapters/mobile/start-console-forwarder.sh +3 -2
  18. package/adapters/mobile/start-metro.sh +17 -12
  19. package/adapters/mobile/wait-for-bridge.cjs +2 -2
  20. package/adapters/shared/harness-source-fingerprint.mjs +13 -8
  21. package/adapters/shared/open-debug.mjs +2 -2
  22. package/adapters/shared/sync-wallet-fixture.sh +8 -5
  23. package/adapters/terminal/cleanup.mjs +2 -1
  24. package/adapters/terminal/inject.mjs +2 -1
  25. package/adapters/terminal/launch.mjs +17 -13
  26. package/adapters/terminal/lib/mainnet-guard.mjs +9 -0
  27. package/adapters/terminal/lib/readiness.mjs +20 -12
  28. package/adapters/terminal/policy.mjs +35 -0
  29. package/adapters/terminal/verify.mjs +10 -3
  30. package/adapters/terminal/wallet-host.mjs +43 -225
  31. package/bin/mm-harness +9 -28
  32. package/dist/adapters/checkout-files.js +16 -0
  33. package/dist/adapters/console-capture.js +14 -1
  34. package/dist/adapters/core/actions.js +8 -4
  35. package/dist/adapters/core/overlay.js +1 -1
  36. package/dist/adapters/core/readiness.js +28 -1
  37. package/dist/adapters/core/run.js +2 -2
  38. package/dist/adapters/core/surface.js +16 -1
  39. package/dist/adapters/extension/actions.js +6 -2
  40. package/dist/adapters/extension/browser-pid.js +56 -0
  41. package/dist/adapters/extension/console-capture.js +1 -1
  42. package/dist/adapters/extension/doctor-checks.js +1 -1
  43. package/dist/adapters/extension/ensure-ready.js +5 -4
  44. package/dist/adapters/extension/extension-id.js +1 -1
  45. package/dist/adapters/extension/feature-flags.js +1 -1
  46. package/dist/adapters/extension/fixtures.js +1 -2
  47. package/dist/adapters/extension/launch.js +4 -5
  48. package/dist/adapters/extension/launched-browser.js +1 -2
  49. package/dist/adapters/extension/network-observer.js +14 -1
  50. package/dist/adapters/extension/overlay.js +1 -1
  51. package/dist/adapters/extension/product-config.js +1 -1
  52. package/dist/adapters/extension/readiness.js +1 -1
  53. package/dist/adapters/extension/reload.js +1 -1
  54. package/dist/adapters/extension/run.js +135 -14
  55. package/dist/adapters/extension/runtime-decision.js +2 -1
  56. package/dist/adapters/extension/runtime.js +9 -5
  57. package/dist/adapters/extension/surface.js +15 -2
  58. package/dist/adapters/extension/verify.js +2 -2
  59. package/dist/adapters/harness-freshness.js +2 -1
  60. package/dist/adapters/mobile/actions.js +4 -1
  61. package/dist/adapters/mobile/android-gfxinfo-performance.js +1 -3
  62. package/dist/adapters/mobile/app-identity.js +10 -0
  63. package/dist/adapters/mobile/doctor-checks.js +1 -1
  64. package/dist/adapters/mobile/fixtures.js +1 -1
  65. package/dist/adapters/mobile/launch.js +27 -28
  66. package/dist/adapters/mobile/lifecycle.js +1 -1
  67. package/dist/adapters/mobile/metro-env.js +9 -59
  68. package/dist/adapters/mobile/network-observer.js +68 -0
  69. package/dist/adapters/mobile/performance-observer.js +2 -4
  70. package/dist/adapters/mobile/prepare-target.js +1 -1
  71. package/dist/adapters/mobile/prepare.js +3 -4
  72. package/dist/adapters/mobile/provision.js +1 -1
  73. package/dist/adapters/mobile/readiness.js +1 -1
  74. package/dist/adapters/mobile/recording-target.js +15 -0
  75. package/dist/adapters/mobile/release-artifact-state.js +1 -1
  76. package/dist/adapters/mobile/reload.js +1 -1
  77. package/dist/adapters/mobile/run.js +39 -15
  78. package/dist/adapters/mobile/runtime-decision.js +2 -4
  79. package/dist/adapters/mobile/source-freshness.js +22 -126
  80. package/dist/adapters/mobile/surface.js +26 -3
  81. package/dist/adapters/mobile/ui.js +16 -5
  82. package/dist/adapters/mobile/verify.js +2 -3
  83. package/dist/adapters/performance/cdp-trace.js +1 -1
  84. package/dist/adapters/performance/device-platform.js +1 -1
  85. package/dist/adapters/perps-order-inputs.js +36 -0
  86. package/dist/adapters/proof-failure.js +11 -0
  87. package/dist/adapters/slot-ports.js +1 -1
  88. package/dist/adapters/surface.js +1 -0
  89. package/dist/adapters/terminal/actions.js +4 -1
  90. package/dist/adapters/terminal/console-capture.js +1 -1
  91. package/dist/adapters/terminal/doctor-checks.js +2 -0
  92. package/dist/adapters/terminal/launch.js +4 -1
  93. package/dist/adapters/terminal/overlay.js +8 -1
  94. package/dist/adapters/terminal/run.js +33 -5
  95. package/dist/adapters/terminal/surface.js +9 -1
  96. package/dist/adapters.js +27 -7
  97. package/dist/advisor-policy.js +1 -1
  98. package/dist/checkout-view.js +1 -2
  99. package/dist/cli.js +59 -21
  100. package/dist/command-contract.js +1 -26
  101. package/dist/commands/check.js +33 -10
  102. package/dist/commands/checklist.js +1 -1
  103. package/dist/commands/completion-candidates.js +6 -14
  104. package/dist/commands/config.js +2 -2
  105. package/dist/commands/core-readiness.js +12 -7
  106. package/dist/commands/debug.js +3 -3
  107. package/dist/commands/device-target.js +5 -5
  108. package/dist/commands/doctor.js +2 -14
  109. package/dist/commands/domain.js +2 -2
  110. package/dist/commands/ensure-ready.js +1 -7
  111. package/dist/commands/fixtures.js +5 -6
  112. package/dist/commands/help.js +3 -4
  113. package/dist/commands/launch/device.js +10 -17
  114. package/dist/commands/launch/extension.js +2 -8
  115. package/dist/commands/launch/mobile.js +1 -1
  116. package/dist/commands/logs.js +3 -3
  117. package/dist/commands/mobile-device-view.js +4 -2
  118. package/dist/commands/overlay.js +110 -0
  119. package/dist/commands/pin.js +1 -1
  120. package/dist/commands/pr-body.js +2 -2
  121. package/dist/commands/prepare.js +4 -9
  122. package/dist/commands/provision.js +3 -12
  123. package/dist/commands/recipe-advice.js +1 -2
  124. package/dist/commands/recipe-quality.js +2 -3
  125. package/dist/commands/resolve-extension.js +1 -7
  126. package/dist/commands/review.js +4 -4
  127. package/dist/commands/runtime-decision.js +1 -6
  128. package/dist/commands/runtime-health.js +1 -7
  129. package/dist/commands/runtime-launch.js +1 -13
  130. package/dist/commands/self-test.js +5 -8
  131. package/dist/commands/status-watch.js +1 -2
  132. package/dist/commands/status.js +2 -5
  133. package/dist/commands/task-init.js +2 -3
  134. package/dist/commands/tutorial.js +2 -2
  135. package/dist/commands/update.js +1 -1
  136. package/dist/completions-cache.js +1 -1
  137. package/dist/console-classifier.js +19 -0
  138. package/dist/doctor.js +2 -3
  139. package/dist/engine.js +57 -0
  140. package/dist/funding-execution-context.js +96 -1
  141. package/dist/host.js +32 -0
  142. package/dist/index.js +1 -6
  143. package/dist/live-tsx.js +49 -0
  144. package/dist/mm-harness-cli.js +4 -6
  145. package/dist/paths.js +34 -64
  146. package/dist/performance-observation.js +3 -5
  147. package/dist/progress.js +1 -1
  148. package/dist/recipe-assistance-context.js +6 -9
  149. package/dist/recipe-security.js +2 -59
  150. package/dist/review/knowledge.js +2 -2
  151. package/dist/runner.js +7 -4
  152. package/dist/runtime-context.js +1 -1
  153. package/dist/task-view.js +2 -3
  154. package/docs/CONTRIBUTING.md +5 -3
  155. package/docs/RECIPES.md +31 -3
  156. package/docs/cli-contract.md +2 -2
  157. package/docs/feature-guard.md +90 -0
  158. package/library/README.md +3 -1
  159. package/library/actions/core/perps/_controller.mjs +153 -134
  160. package/library/actions/core/perps/_rewards.mjs +186 -0
  161. package/library/actions/core/perps/close_positions.mjs +1 -1
  162. package/library/actions/core/perps/place_order.mjs +167 -45
  163. package/library/actions/core/perps/quote_fees.mjs +61 -0
  164. package/library/actions/core/wallet/list_accounts.mjs +14 -57
  165. package/library/actions/extension/feature_flags/state.mjs +1 -1
  166. package/library/actions/extension/perps/close_visible_position.mjs +5 -0
  167. package/library/actions/extension/perps/edit_margin.mjs +4 -0
  168. package/library/actions/extension/perps/mutation-receipt.mjs +95 -3
  169. package/library/actions/extension/perps/perps.mjs +320 -3
  170. package/library/actions/extension/perps/place_order.mjs +3 -1
  171. package/library/actions/extension/perps/update_position_tpsl.mjs +4 -0
  172. package/library/actions/extension/platform/cdp.mjs +73 -11
  173. package/library/actions/harness-exports.mjs +1 -6
  174. package/library/actions/mobile/app/network-control.mjs +6 -8
  175. package/library/actions/mobile/perps/perps.mjs +216 -11
  176. package/library/actions/mobile/perps/place_order.mjs +3 -1
  177. package/library/actions/mobile/perps/prepare_local_snapshot_endpoint.mjs +1 -1
  178. package/library/actions/mobile/platform/bridge.mjs +8 -8
  179. package/library/actions/mobile/platform/native-session-name.mjs +21 -1
  180. package/library/actions/mobile/platform/native-session.mjs +3 -4
  181. package/library/actions/mobile/platform/observe-ui.mjs +12 -6
  182. package/library/actions/mobile/ui/native-navigation.mjs +4 -3
  183. package/library/actions/mobile/wallet/native-ui.mjs +3 -2
  184. package/library/actions/shared/analytics/_adapter.mjs +1 -1
  185. package/library/actions/shared/console-findings.mjs +1 -1
  186. package/library/actions/shared/perps/order-policy.mjs +177 -0
  187. package/library/actions/shared/wallet/fixture-accounts.mjs +84 -0
  188. package/library/actions/terminal/app/launch.mjs +3 -2
  189. package/library/actions/terminal/platform/hud.mjs +2 -1
  190. package/library/actions/terminal/platform/page.mjs +2 -1
  191. package/library/actions/terminal/platform/runtime.mjs +2 -1
  192. package/library/actions/terminal/wallet/_signature-log.mjs +40 -161
  193. package/library/actions/terminal/wallet/assert_signatures.mjs +6 -12
  194. package/library/actions/terminal/wallet/read_signatures.mjs +10 -9
  195. package/library/manifests/core.action-manifest.json +87 -13
  196. package/library/manifests/extension.action-manifest.json +4 -0
  197. package/library/manifests/mobile.action-manifest.json +12 -0
  198. package/package.json +8 -9
  199. package/site/assets/help-recipes.json +1 -0
  200. package/adapters/extension/lib/slot-title.cjs +0 -292
  201. package/adapters/mobile/bridge-runtime/console-forwarder.cjs +0 -472
  202. package/adapters/mobile/bridge-runtime/lib/bridge-errors.cjs +0 -125
  203. package/adapters/mobile/bridge-runtime/lib/cdp-broker.cjs +0 -1055
  204. package/adapters/mobile/bridge-runtime/lib/cdp-eval.cjs +0 -110
  205. package/adapters/mobile/bridge-runtime/lib/config.cjs +0 -61
  206. package/adapters/mobile/bridge-runtime/lib/console-format.cjs +0 -53
  207. package/adapters/mobile/bridge-runtime/lib/devtools-proxy.cjs +0 -177
  208. package/adapters/mobile/bridge-runtime/lib/issue-capture.cjs +0 -446
  209. package/adapters/mobile/bridge-runtime/lib/match-bridge-target.cjs +0 -84
  210. package/adapters/mobile/bridge-runtime/lib/target-discovery.cjs +0 -403
  211. package/adapters/mobile/bridge-runtime/lib/ws-client.cjs +0 -116
  212. package/adapters/mobile/coalesce-metro-log.cjs +0 -24
  213. package/adapters/mobile/launch-metro.cjs +0 -77
  214. package/adapters/mobile/metro-config.cjs +0 -98
  215. package/adapters/mobile/metro-log-generation.cjs +0 -106
  216. package/adapters/terminal/lib/origin.mjs +0 -30
  217. package/adapters/terminal/lib/page-script.mjs +0 -246
  218. package/adapters/terminal/lib/strict-wallet.mjs +0 -138
  219. package/dist/adapters/mobile/frame-metrics.js +0 -118
  220. package/dist/adapters/mobile/video-recorder.js +0 -289
  221. package/dist/artifact-files.js +0 -92
  222. package/dist/checkout-lock.js +0 -149
  223. package/dist/cli-color.js +0 -98
  224. package/dist/command-journal.js +0 -308
  225. package/dist/commands/call.js +0 -685
  226. package/dist/commands/last.js +0 -60
  227. package/dist/commands/launch/index.js +0 -109
  228. package/dist/commands/list-executables.js +0 -247
  229. package/dist/commands/manifest.js +0 -488
  230. package/dist/commands/parse-args.js +0 -279
  231. package/dist/commands/reload.js +0 -41
  232. package/dist/commands/run-engine.js +0 -1340
  233. package/dist/commands/run-report.js +0 -241
  234. package/dist/commands/run.js +0 -751
  235. package/dist/commands/shared.js +0 -323
  236. package/dist/commands/stop.js +0 -60
  237. package/dist/devices.js +0 -100
  238. package/dist/discovery.js +0 -15
  239. package/dist/execution-provenance.js +0 -332
  240. package/dist/harness.js +0 -451
  241. package/dist/heal-bounds.js +0 -137
  242. package/dist/json-stream.js +0 -60
  243. package/dist/leaf-invoke.js +0 -19
  244. package/dist/library-provenance.js +0 -33
  245. package/dist/live-adapter-contract.js +0 -380
  246. package/dist/metamask-action-validation.js +0 -68
  247. package/dist/network-observation.js +0 -290
  248. package/dist/recording-target.js +0 -120
  249. package/dist/run-diagnostics.js +0 -364
  250. package/dist/run-recording.js +0 -481
  251. package/dist/runtime-proof.js +0 -90
  252. package/library/actions/mobile/platform/tool-paths.mjs +0 -123
package/dist/cli-color.js DELETED
@@ -1,98 +0,0 @@
1
- const STYLES = {
2
- reset: "\x1B[0m",
3
- bold: "\x1B[1m",
4
- dim: "\x1B[2m",
5
- label: "\x1B[1;36m",
6
- cmd: "\x1B[1m",
7
- ok: "\x1B[1;32m",
8
- warn: "\x1B[1;33m",
9
- err: "\x1B[1;31m",
10
- info: "\x1B[0;37m",
11
- accent: "\x1B[1;35m",
12
- path: "\x1B[2m",
13
- comment: "\x1B[2m",
14
- active: "\x1B[1m"
15
- };
16
- function colorEnabled(stream = process.stderr) {
17
- if (process.env.NO_COLOR != null && process.env.NO_COLOR !== "" && process.env.NO_COLOR !== "0") {
18
- return false;
19
- }
20
- if (process.env.RECIPE_NO_COLOR === "1") return false;
21
- if (process.env.RECIPE_COLOR === "1" || process.env.FORCE_COLOR === "1") return true;
22
- return Boolean(stream?.isTTY);
23
- }
24
- function stripAnsi(text) {
25
- return String(text).replace(/\x1b\[[0-9;]*m/gu, "");
26
- }
27
- function color(style, text, { stream = process.stderr } = {}) {
28
- const value = String(text);
29
- if (!colorEnabled(stream)) return value;
30
- const code = STYLES[style];
31
- if (!code) return value;
32
- return `${code}${value}${STYLES.reset}`;
33
- }
34
- function colorKv(label, value, valueStyle = "info", { stream = process.stderr } = {}) {
35
- return `${color("label", `${label}:`, { stream })} ${color(valueStyle, value, { stream })}`;
36
- }
37
- function colorStatusWord(word, { stream = process.stderr } = {}) {
38
- const normalized = String(word || "").toLowerCase();
39
- if (["up", "ready", "yes", "pass", "running", "present", "healthy"].includes(normalized)) {
40
- return color("ok", word, { stream });
41
- }
42
- if (["down", "stopped", "no", "fail", "failed", "missing", "blocked", "unknown"].includes(normalized)) {
43
- return color("err", word, { stream });
44
- }
45
- if (["compiling", "bundling", "starting", "waiting", "warn"].includes(normalized)) {
46
- return color("warn", word, { stream });
47
- }
48
- return color("info", word, { stream });
49
- }
50
- function colorHumanMessage(message, { stream = process.stderr } = {}) {
51
- return String(message).split("\n").map((line) => {
52
- const marker = /^(\s*)(→|✓|✗)\s?(.*)$/u.exec(line);
53
- if (marker) {
54
- const style = marker[2] === "\u2713" ? "ok" : marker[2] === "\u2717" ? "err" : "accent";
55
- return `${marker[1]}${color(style, marker[2], { stream })}${marker[3] ? ` ${marker[3]}` : ""}`;
56
- }
57
- const next = /^(\s*)Next:\s*(.*)$/u.exec(line);
58
- if (next) {
59
- return `${next[1]}${color("label", "Next:", { stream })}${next[2] ? ` ${color("cmd", next[2], { stream })}` : ""}`;
60
- }
61
- const warning = /^(\s*)(WARN(?:ING)?)(:?)[ \t]*(.*)$/iu.exec(line);
62
- if (warning) {
63
- return `${warning[1]}${color("warn", `${warning[2]}${warning[3]}`, { stream })}${warning[4] ? ` ${warning[4]}` : ""}`;
64
- }
65
- return line;
66
- }).join("\n");
67
- }
68
- function classifyLogEvent(event) {
69
- const text = String(event || "");
70
- if (/Module build failed|^ERROR in |BUILD FAILED|compiled with [1-9][0-9]* error/iu.test(text)) {
71
- return "err";
72
- }
73
- if (/compiled successfully|compiled with [0-9]+ warning|PASS runtime-launch|launch pass|verify pass|build complete/iu.test(text)) {
74
- return "ok";
75
- }
76
- if (/phase [0-9]\/[0-9]|prepare pipeline|snapshot|fixture:|dist-freshness|build-health/iu.test(text)) {
77
- return "label";
78
- }
79
- if (/webpack [0-9]+%|Bundl(ed|ing)|(iOS|Android).*%/iu.test(text)) {
80
- return "warn";
81
- }
82
- return "info";
83
- }
84
- function colorLogEvent(event, { latest = false, stream = process.stderr } = {}) {
85
- const style = classifyLogEvent(event);
86
- const painted = color(style === "label" ? "label" : style, event, { stream });
87
- return latest ? color("active", painted, { stream }) : painted;
88
- }
89
- export {
90
- classifyLogEvent,
91
- color,
92
- colorEnabled,
93
- colorHumanMessage,
94
- colorKv,
95
- colorLogEvent,
96
- colorStatusWord,
97
- stripAnsi
98
- };
@@ -1,308 +0,0 @@
1
- import { randomUUID } from "node:crypto";
2
- import fs from "node:fs";
3
- import path from "node:path";
4
- import { OperationRecord, readOperations, processIdentity, ensureRuntimeDirectory } from "@farmslot/recipe-runner/runtime/operation";
5
- import { latestTaskDir } from "@farmslot/agent-runtime";
6
- import { recipeRuntimeDir } from "./paths.js";
7
- const COMMAND_JOURNAL_FILE = "last-command.json";
8
- const JOURNALED_COMMANDS = /* @__PURE__ */ new Set([
9
- "prepare",
10
- "call",
11
- "check",
12
- "checklist",
13
- "cleanup",
14
- "doctor",
15
- "fixtures",
16
- "install",
17
- "launch",
18
- "runtime-launch",
19
- "provision",
20
- "recipe-quality",
21
- "run",
22
- "stop",
23
- "verify"
24
- ]);
25
- const SENSITIVE_KEY = /(?:api[-_]?key|auth|credential|mnemonic|pass(?:word)?|private[-_]?key|secret|seed|srp|token|vault)/iu;
26
- const EVIDENCE_OPTIONS = /* @__PURE__ */ new Set(["--artifacts-dir", "--out", "--output"]);
27
- let activeCommandJournal;
28
- async function withCommandJournal(command, argv, execute) {
29
- if (!JOURNALED_COMMANDS.has(command)) return execute();
30
- const handle = tryBeginCommandJournal(command, argv);
31
- const previous = activeCommandJournal;
32
- const parentId = process.env.MM_HARNESS_OPERATION_ID;
33
- if (handle) process.env.MM_HARNESS_OPERATION_ID = handle.operation.value.id;
34
- activeCommandJournal = handle;
35
- try {
36
- const exitCode = await execute();
37
- tryFinishCommandJournal(handle, exitCode);
38
- return exitCode;
39
- } catch (error) {
40
- tryFinishCommandJournal(handle, 1);
41
- throw error;
42
- } finally {
43
- activeCommandJournal = previous;
44
- if (parentId) process.env.MM_HARNESS_OPERATION_ID = parentId;
45
- else delete process.env.MM_HARNESS_OPERATION_ID;
46
- }
47
- }
48
- function recordCommandStage(stage) {
49
- activeCommandJournal?.operation.stage(stage);
50
- }
51
- function recordCommandOutput(chunk) {
52
- activeCommandJournal?.operation.output(chunk);
53
- }
54
- function recordCommandEvidence(...evidence) {
55
- const handle = activeCommandJournal;
56
- if (!handle || evidence.length === 0) return;
57
- try {
58
- const paths = new Set(handle.record.evidencePaths);
59
- for (const entry of evidence) paths.add(path.resolve(entry));
60
- handle.record = { ...handle.record, evidencePaths: [...paths] };
61
- writeAtomic(handle.file, handle.record);
62
- } catch (error) {
63
- process.stderr.write(
64
- `mm-harness: resumability journal could not record evidence: ${errorMessage(error)}
65
- `
66
- );
67
- }
68
- }
69
- function commandJournalPath(target, runtimeDir) {
70
- const relative = runtimeDir ?? recipeRuntimeDir();
71
- assertRelativeRuntimeDir(relative);
72
- return path.join(path.resolve(target), relative, COMMAND_JOURNAL_FILE);
73
- }
74
- function readCommandJournal(target, runtimeDir) {
75
- const legacyFile = commandJournalPath(target, runtimeDir);
76
- const operations = readOperations(path.join(path.dirname(legacyFile), "operations"));
77
- const live = operations.filter((operation) => operation.status === "running" && processIdentity(operation.pid) === operation.processStartedAt);
78
- const roots = operations.filter((operation) => !operation.parentId).sort((a, b) => (a.finishedAt ?? a.startedAt).localeCompare(b.finishedAt ?? b.startedAt));
79
- const selected = live.find((operation) => !operation.parentId) ?? live.at(-1) ?? roots.at(-1) ?? operations.at(-1);
80
- const file = selected ? path.join(path.dirname(legacyFile), "operations", `${selected.id}.journal.json`) : legacyFile;
81
- let descriptor;
82
- try {
83
- const noFollow = typeof fs.constants.O_NOFOLLOW === "number" ? fs.constants.O_NOFOLLOW : 0;
84
- descriptor = fs.openSync(file, fs.constants.O_RDONLY | noFollow);
85
- const descriptorStat = fs.fstatSync(descriptor, { bigint: true });
86
- const pathStat = fs.lstatSync(file, { bigint: true });
87
- if (!descriptorStat.isFile() || !pathStat.isFile() || pathStat.isSymbolicLink() || pathStat.dev === 0n && pathStat.ino === 0n || descriptorStat.dev !== pathStat.dev || descriptorStat.ino !== pathStat.ino) {
88
- return { file, record: null };
89
- }
90
- const parsed = JSON.parse(
91
- fs.readFileSync(descriptor, "utf8")
92
- );
93
- return isCommandJournalRecord(parsed) ? { file, record: parsed } : { file, record: null };
94
- } catch {
95
- return { file, record: null };
96
- } finally {
97
- if (descriptor !== void 0) fs.closeSync(descriptor);
98
- }
99
- }
100
- function redactCommandArgs(argv) {
101
- const redacted = [];
102
- for (let index = 0; index < argv.length; index += 1) {
103
- const token = argv[index] ?? "";
104
- const equals = token.indexOf("=");
105
- if (token.startsWith("--") && equals !== -1) {
106
- const option = token.slice(0, equals);
107
- const value = token.slice(equals + 1);
108
- redacted.push(
109
- `${option}=${option === "--arg" ? redactAssignment(value) : SENSITIVE_KEY.test(option) ? "<redacted>" : redactUrl(value)}`
110
- );
111
- continue;
112
- }
113
- if (token.startsWith("--") && SENSITIVE_KEY.test(token)) {
114
- redacted.push(token);
115
- const value = argv[index + 1];
116
- if (value !== void 0 && !value.startsWith("--")) {
117
- redacted.push("<redacted>");
118
- index += 1;
119
- }
120
- continue;
121
- }
122
- if (token === "--arg") {
123
- redacted.push(token);
124
- const value = argv[index + 1];
125
- if (value !== void 0) {
126
- redacted.push(redactAssignment(value));
127
- index += 1;
128
- }
129
- continue;
130
- }
131
- redacted.push(redactAssignment(redactUrl(token)));
132
- }
133
- return redacted;
134
- }
135
- function pruneCompletedJournals(directory, operations) {
136
- const completed = operations.filter((operation) => operation.status !== "running");
137
- for (const operation of completed.slice(0, -100)) {
138
- for (const suffix of [".json", ".journal.json", ".log"]) {
139
- fs.rmSync(path.join(directory, `${operation.id}${suffix}`), { force: true });
140
- }
141
- }
142
- }
143
- function tryBeginCommandJournal(command, argv) {
144
- try {
145
- const target = invocationTarget(argv);
146
- if (!fs.existsSync(target)) return void 0;
147
- const runtimeDir = optionValue(argv, "--runtime-dir");
148
- const legacyFile = commandJournalPath(target, runtimeDir);
149
- const taskDir = latestTaskDir(path.join(target, "temp", "tasks"));
150
- const signalFile = taskDir && path.join(taskDir, "SIGNAL.json");
151
- const liveTask = signalFile && fs.existsSync(signalFile) && JSON.parse(fs.readFileSync(signalFile, "utf8")).status === "running";
152
- const directory = path.join(path.dirname(legacyFile), "operations");
153
- const operations = readOperations(directory, (error) => process.stderr.write(`mm-harness: ignoring invalid prior operation: ${error.message}
154
- `));
155
- pruneCompletedJournals(directory, operations);
156
- const inherited = process.env.MM_HARNESS_OPERATION_ID;
157
- const parent = inherited && operations.find((operation2) => operation2.id === inherited && operation2.target === target && operation2.status === "running" && processIdentity(operation2.pid) === operation2.processStartedAt);
158
- const operation = new OperationRecord(directory, command, target, {
159
- ...parent ? { parentId: parent.id } : {},
160
- ...liveTask ? { mirrorDirectory: path.join(taskDir, "artifacts", "operations") } : {}
161
- });
162
- const file = path.join(directory, `${operation.value.id}.journal.json`);
163
- const now = (/* @__PURE__ */ new Date()).toISOString();
164
- const record = {
165
- schemaVersion: 1,
166
- command,
167
- args: redactCommandArgs(argv.slice(1)),
168
- target,
169
- verdict: "running",
170
- exitCode: null,
171
- evidencePaths: evidencePaths(argv),
172
- startedAt: now,
173
- finishedAt: null
174
- };
175
- writeAtomic(file, record);
176
- return { file, record, operation };
177
- } catch (error) {
178
- process.stderr.write(
179
- `mm-harness: resumability journal unavailable: ${errorMessage(error)}
180
- `
181
- );
182
- return void 0;
183
- }
184
- }
185
- function tryFinishCommandJournal(handle, exitCode) {
186
- if (!handle) return;
187
- try {
188
- writeAtomic(handle.file, {
189
- ...handle.record,
190
- verdict: exitCode === 0 ? "pass" : "fail",
191
- exitCode,
192
- finishedAt: (/* @__PURE__ */ new Date()).toISOString()
193
- });
194
- } catch (error) {
195
- process.stderr.write(
196
- `mm-harness: resumability journal could not finalize: ${errorMessage(error)}
197
- `
198
- );
199
- } finally {
200
- handle.operation.finish(exitCode);
201
- }
202
- }
203
- function writeAtomic(file, record) {
204
- ensureRuntimeDirectory(path.dirname(file));
205
- const temporary = `${file}.${process.pid}.${randomUUID()}.tmp`;
206
- let descriptor;
207
- try {
208
- descriptor = fs.openSync(temporary, "wx", 384);
209
- fs.fchmodSync(descriptor, 384);
210
- fs.writeFileSync(descriptor, `${JSON.stringify(record, null, 2)}
211
- `);
212
- fs.fsyncSync(descriptor);
213
- fs.closeSync(descriptor);
214
- descriptor = void 0;
215
- fs.renameSync(temporary, file);
216
- } finally {
217
- if (descriptor !== void 0) fs.closeSync(descriptor);
218
- fs.rmSync(temporary, { force: true });
219
- }
220
- }
221
- function invocationTarget(argv) {
222
- const target = path.resolve(optionValue(argv, "--target") ?? process.cwd());
223
- return fs.existsSync(target) ? fs.realpathSync(target) : target;
224
- }
225
- function evidencePaths(argv) {
226
- const values = /* @__PURE__ */ new Set();
227
- for (const option of EVIDENCE_OPTIONS) {
228
- const value = optionValue(argv, option);
229
- if (value) values.add(path.resolve(value));
230
- }
231
- return [...values];
232
- }
233
- function optionValue(argv, option) {
234
- const divider = argv.indexOf("--");
235
- const end = divider === -1 ? argv.length : divider;
236
- for (let index = 1; index < end; index += 1) {
237
- const token = argv[index] ?? "";
238
- if (token === option) {
239
- const value = argv[index + 1];
240
- return value && !value.startsWith("--") ? value : void 0;
241
- }
242
- if (token.startsWith(`${option}=`)) return token.slice(option.length + 1);
243
- }
244
- return void 0;
245
- }
246
- function redactAssignment(token) {
247
- const equals = token.indexOf("=");
248
- if (equals <= 0) return redactValue(token);
249
- const key = token.slice(0, equals);
250
- const value = token.slice(equals + 1);
251
- return `${key}=${SENSITIVE_KEY.test(key) ? "<redacted>" : redactValue(value)}`;
252
- }
253
- function redactUrl(token) {
254
- return token.replace(/(\w+:\/\/)[^/@\s:]+:[^/@\s]+@/gu, "$1<redacted>@");
255
- }
256
- function redactValue(value) {
257
- try {
258
- return JSON.stringify(redactStructuredValue(JSON.parse(value)));
259
- } catch {
260
- return value.replace(
261
- /((?:api[-_]?key|auth|credential|mnemonic|pass(?:word)?|private[-_]?key|secret|seed|srp|token|vault)=)[^\s]+/giu,
262
- "$1<redacted>"
263
- );
264
- }
265
- }
266
- function isSensitiveKey(key) {
267
- return SENSITIVE_KEY.test(key);
268
- }
269
- function redactStructuredValue(value) {
270
- if (Array.isArray(value)) return value.map(redactStructuredValue);
271
- if (!value || typeof value !== "object") return value;
272
- return Object.fromEntries(
273
- Object.entries(value).map(([key, entry]) => [
274
- key,
275
- isSensitiveKey(key) ? "<redacted>" : redactStructuredValue(entry)
276
- ])
277
- );
278
- }
279
- function assertRelativeRuntimeDir(value) {
280
- if (!value || path.isAbsolute(value) || !/^[A-Za-z0-9._/-]+$/u.test(value)) {
281
- throw new Error(`--runtime-dir must be a safe relative path: ${value}`);
282
- }
283
- if (value.split("/").some((part) => !part || part === "." || part === "..")) {
284
- throw new Error(
285
- `--runtime-dir contains an unsafe path component: ${value}`
286
- );
287
- }
288
- }
289
- function isCommandJournalRecord(value) {
290
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
291
- const record = value;
292
- return record.schemaVersion === 1 && typeof record.command === "string" && Array.isArray(record.args) && record.args.every((entry) => typeof entry === "string") && typeof record.target === "string" && (record.verdict === "running" || record.verdict === "pass" || record.verdict === "fail") && (record.exitCode === null || typeof record.exitCode === "number") && Array.isArray(record.evidencePaths) && record.evidencePaths.every((entry) => typeof entry === "string") && typeof record.startedAt === "string" && (record.finishedAt === null || typeof record.finishedAt === "string");
293
- }
294
- function errorMessage(error) {
295
- return error instanceof Error ? error.message : String(error);
296
- }
297
- export {
298
- COMMAND_JOURNAL_FILE,
299
- commandJournalPath,
300
- isSensitiveKey,
301
- readCommandJournal,
302
- recordCommandEvidence,
303
- recordCommandOutput,
304
- recordCommandStage,
305
- redactCommandArgs,
306
- redactStructuredValue,
307
- withCommandJournal
308
- };