gdharness 1.2.18 → 1.2.20

package/build/cli.js

@@ -642,6 +642,36 @@ function resolveSilent(requested, variables) {
   const said = envValue("GDHARNESS_SILENT", variables)?.toLowerCase();
   return said !== undefined && said !== "0" && said !== "false";
 }
+function engineFlags(given) {
+  const offered = Object.keys(ENGINE_FLAGS).join(", ");
+  for (let at = 0;at < given.length; at += 1) {
+    const flag = given[at] ?? "";
+    const takes = Object.hasOwn(ENGINE_FLAGS, flag) ? ENGINE_FLAGS[flag] : undefined;
+    if (takes === undefined) {
+      const setBy = Object.hasOwn(SET_BY_ARGUMENT, flag) ? SET_BY_ARGUMENT[flag] : undefined;
+      return {
+        ok: false,
+        reason: setBy !== undefined ? `${flag} is set by this tool's own argument, ${setBy}, rather than through engineArgs.` : `${flag} is not one of the engine flags engineArgs takes, which are those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${offered}. A value goes as the next entry, as in ["--fixed-fps", "60"].`
+      };
+    }
+    if (takes === "none") {
+      continue;
+    }
+    const value = given[at + 1];
+    const fits = value !== undefined && (takes === "number" ? /^\d+(?:\.\d+)?$/.test(value) : /^\d+x\d+$/.test(value));
+    if (!fits) {
+      return {
+        ok: false,
+        reason: `${flag} takes ${takes === "number" ? "a number" : "a size such as 1280x720"} as the next entry, and ${value === undefined ? "nothing followed it" : `${JSON.stringify(value)} is not one`}.`
+      };
+    }
+    at += 1;
+  }
+  return { ok: true };
+}
+function engineFlagsAmongGameArgs(args) {
+  return args.filter((one) => Object.hasOwn(ENGINE_FLAGS, one) || Object.hasOwn(SET_BY_ARGUMENT, one));
+}
 function runArguments(options) {
   const args = options.headless ? ["--headless", "--path", options.projectPath] : ["--path", options.projectPath];
   if (options.silent === true && !options.headless) {
@@ -650,6 +680,9 @@ function runArguments(options) {
   if (options.quitAfter !== undefined && options.quitAfter !== null) {
     args.push("--quit-after", String(options.quitAfter));
   }
+  if (options.engineArgs !== undefined) {
+    args.push(...options.engineArgs);
+  }
   if (options.scene !== null) {
     args.push(`res://${options.scene}`);
   }
@@ -692,7 +725,35 @@ function environmentFor(options, variables = process.env) {
   const base = options.savesIn === undefined ? { ...variables } : userDataIn(options.savesIn, variables);
   return { ...base, ...options.env, GDHARNESS_RUNTIME_DIR: options.runtimeDirectory };
 }
-var OPENED_BY_A_SERVER = "GDHARNESS_OPENED_BY_A_SERVER", EDITOR_PID_VARIABLE = "GDHARNESS_EDITOR_PID", RESERVED_VARIABLE_PREFIX = "GDHARNESS_", SAVES_NOT_MOVED_NOTE = "On macOS the engine reads user:// off HOME and ignores the variables that move it elsewhere, measured on Godot 4.7.2, so this run wrote its saves where the player keeps theirs. A suite that saves a game has written into the same folder as the copy being played, and one that tidies up after itself may have removed real saves.";
+var ENGINE_FLAGS, SET_BY_ARGUMENT, OPENED_BY_A_SERVER = "GDHARNESS_OPENED_BY_A_SERVER", EDITOR_PID_VARIABLE = "GDHARNESS_EDITOR_PID", RESERVED_VARIABLE_PREFIX = "GDHARNESS_", SAVES_NOT_MOVED_NOTE = "On macOS the engine reads user:// off HOME and ignores the variables that move it elsewhere, measured on Godot 4.7.2, so this run wrote its saves where the player keeps theirs. A suite that saves a game has written into the same folder as the copy being played, and one that tidies up after itself may have removed real saves.";
+var init_launch = __esm(() => {
+  ENGINE_FLAGS = Object.freeze({
+    "--verbose": "none",
+    "--quiet": "none",
+    "--debug-collisions": "none",
+    "--debug-paths": "none",
+    "--debug-navigation": "none",
+    "--debug-avoidance": "none",
+    "--debug-stringnames": "none",
+    "--debug-canvas-item-redraw": "none",
+    "--debug-mute-audio": "none",
+    "--print-fps": "none",
+    "--gpu-profile": "none",
+    "--gpu-validation": "none",
+    "--gpu-abort": "none",
+    "--disable-vsync": "none",
+    "--frame-delay": "number",
+    "--time-scale": "number",
+    "--fixed-fps": "number",
+    "--max-fps": "number",
+    "--resolution": "size"
+  });
+  SET_BY_ARGUMENT = Object.freeze({
+    "--headless": "headless",
+    "--audio-driver": "silent",
+    "--quit-after": "frames, on editor_run check"
+  });
+});
 
 // src/godot-path.ts
 import { execFile as execFile2 } from "node:child_process";
@@ -769,6 +830,7 @@ var run2;
 var init_godot_path = __esm(() => {
   init_detection();
   init_errors();
+  init_launch();
   run2 = promisify2(execFile2);
 });
 
@@ -10840,6 +10902,7 @@ function annotationsOf(spec) {
 }
 var PROJECT_INFO_SECTIONS, PROJECT_PATH, RUNNING_PROJECT_PATH, RUNNING_PID, SCENE_PATH, SCRIPT_PATH, RESOURCE_PATH, NODE_PATH, PROPERTIES, XY, ANIMATION_TRACK, SCRIPT_MODIFICATIONS, INPUT_EVENTS, TILESET_SOURCES, TILEMAP_CELLS, COLOUR, TOOL_SPECS, SPECS_BY_NAME;
 var init_tool_definitions = __esm(() => {
+  init_launch();
   PROJECT_INFO_SECTIONS = [
     "autoloads",
     "plugins",
@@ -11758,7 +11821,13 @@ var init_tool_definitions = __esm(() => {
           type: "array",
           items: { type: "string" },
           ops: ["start", "check"],
-          description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+          description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here, so a flag the engine reads goes to the game instead, and the answer says so under argsNote. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+        },
+        engineArgs: {
+          type: "array",
+          items: { type: "string" },
+          ops: ["start", "check"],
+          description: `The engine's own flags, before the separator, such as ["--verbose"] or ["--fixed-fps", "60"], a value going as the next entry. Only those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${Object.keys(ENGINE_FLAGS).join(", ")}. Any other is refused, since the engine's command line can also run scripts, open other projects and write files. A run with any is started by this server, as one with args is. A check given --verbose answers with everything printed rather than only errors and warnings, since what verbose adds, the instances leaked at exit among it, is printed as ordinary lines.`
         },
         headless: { type: "boolean", ops: ["start"], description: "start: force a window or no window." },
         visible: {
@@ -11855,7 +11924,7 @@ var init_tool_definitions = __esm(() => {
           requires: []
         }
       },
-      answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
+      answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
       defaultOperation: "start"
     },
     {
@@ -34734,6 +34803,7 @@ function runtimeRequest(endpoint, command, params, timeoutMs, keepListening = fa
 var RUNTIME_PROTOCOL = 2, ANNOUNCEMENT_PATTERN, ERROR_REPORT_PATTERN, CONSOLE_BOUNDARY = "[gdharness] runtime listening on ", ERROR_REPORT_KEEP_MS, GONE_WINDOW_MS = 120000, GONE_KEPT = 32, gone, STARTED_AFTER_ANNOUNCING_MS = 2000, CONFIRMED_FOR_MS = 60000, JUDGED_AFTER_MS = 60000, verdicts, judging = null, ENDED_WITHIN_MS = 3000, LOOK_EVERY_MS = 50, ANNOUNCE_BUDGET_MS = 5000, nextRequestId = 1, LATE_ANSWER_MS, LATE_KEPT = 50, lateAnswers;
 var init_runtime_client = __esm(() => {
   init_alive();
+  init_launch();
   init_paths();
   init_process_children();
   ANNOUNCEMENT_PATTERN = /^runtime-(\d+)\.json$/;
@@ -40746,6 +40816,7 @@ var init_lsp_client = __esm(() => {
   init_answer_json();
   init_errors();
   init_framing();
+  init_launch();
   init_paths();
   init_ports();
   LSPTimeout = class LSPTimeout extends Error {
@@ -42409,19 +42480,41 @@ var init_restart_note = __esm(() => {
   init_errors();
 });
 
+// src/whole-file.ts
+import { renameSync as renameSync2, rmSync as rmSync12, writeFileSync as writeFileSync16 } from "node:fs";
+function writeWhole(path, text) {
+  const partial = `${path}.${process.pid}.partial`;
+  try {
+    writeFileSync16(partial, text, "utf8");
+  } catch {
+    return false;
+  }
+  const until = Date.now() + HELD_FILE_MS;
+  for (;; ) {
+    try {
+      renameSync2(partial, path);
+      return true;
+    } catch (error) {
+      const code = error.code ?? "";
+      if (!HELD_BY_A_READER.has(code) || Date.now() >= until) {
+        try {
+          rmSync12(partial, { force: true });
+        } catch {}
+        return false;
+      }
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, HELD_FILE_RETRY_MS);
+    }
+  }
+}
+var HELD_FILE_MS = 1000, HELD_FILE_RETRY_MS = 10, HELD_BY_A_READER;
+var init_whole_file = __esm(() => {
+  HELD_BY_A_READER = new Set(["EPERM", "EACCES", "EBUSY"]);
+});
+
 // src/run-record.ts
 import { execFile as execFile4 } from "node:child_process";
 import { createHash as createHash4 } from "node:crypto";
-import {
-  mkdirSync as mkdirSync14,
-  openSync as openSync2,
-  readdirSync as readdirSync10,
-  readFileSync as readFileSync21,
-  realpathSync as realpathSync6,
-  rmSync as rmSync12,
-  statSync as statSync8,
-  writeFileSync as writeFileSync16
-} from "node:fs";
+import { mkdirSync as mkdirSync14, openSync as openSync2, readdirSync as readdirSync10, readFileSync as readFileSync21, realpathSync as realpathSync6, rmSync as rmSync13, statSync as statSync8 } from "node:fs";
 import { basename as basename6, dirname as dirname18, join as join24, resolve as resolve7 } from "node:path";
 import { promisify as promisify4 } from "node:util";
 function runsDirectory() {
@@ -42457,7 +42550,7 @@ function latestRunPath(servedBy, directory = runtimeDirectory()) {
 function writeLatestRun(servedBy, latest) {
   try {
     mkdirSync14(runsDirectory(), { recursive: true });
-    writeFileSync16(latestRunPath(servedBy), JSON.stringify(latest, null, 2), "utf8");
+    writeWhole(latestRunPath(servedBy), JSON.stringify(latest, null, 2));
   } catch {}
 }
 function readLatestRun(servedBy, directory = runtimeDirectory()) {
@@ -42491,7 +42584,10 @@ function editorNotePath(projectPath, directory = runtimeDirectory()) {
 }
 function writeEditorRunNote(note) {
   mkdirSync14(runsDirectory(), { recursive: true });
-  writeFileSync16(editorNotePath(note.projectPath), JSON.stringify(note, null, 2), "utf8");
+  const path = editorNotePath(note.projectPath);
+  if (!writeWhole(path, JSON.stringify(note, null, 2))) {
+    throw new Error(`the editor run note could not be written at ${path}`);
+  }
 }
 function readEditorRunNote(projectPath) {
   for (const directory of runtimeDirectories()) {
@@ -42762,7 +42858,7 @@ function clearRunRecord(projectPath) {
     const ours = sharedRecord !== null && sharedRecord.projectPath !== "" && isSameDirectory(sharedRecord.projectPath, projectPath);
     for (const path of [runRecordPath(projectPath, directory), ...ours ? [shared] : []]) {
       try {
-        rmSync12(path, { force: true });
+        rmSync13(path, { force: true });
       } catch {}
     }
   }
@@ -42787,7 +42883,8 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
     return;
   }
   for (const entry of entries) {
-    if (!entry.startsWith("run-") || !(entry.endsWith(".log") || entry.endsWith(".profile.json"))) {
+    const transcript = entry.startsWith("run-") && (entry.endsWith(".log") || entry.endsWith(".profile.json"));
+    if (!transcript && !entry.endsWith(".partial")) {
       continue;
     }
     const path = join24(directory, entry);
@@ -42795,7 +42892,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
       continue;
     }
     try {
-      rmSync12(path);
+      rmSync13(path);
     } catch {}
   }
 }
@@ -42805,6 +42902,7 @@ var init_run_record = __esm(() => {
   init_paths();
   init_process_children();
   init_runtime_client();
+  init_whole_file();
   init_windows_ask();
   execFileAsync = promisify4(execFile4);
 });
@@ -42915,7 +43013,7 @@ var init_godot_variant = __esm(() => {
 });
 
 // src/script-profile.ts
-import { readFileSync as readFileSync22, renameSync as renameSync2, writeFileSync as writeFileSync17 } from "node:fs";
+import { readFileSync as readFileSync22 } from "node:fs";
 function readProfileFile(path) {
   try {
     const parsed = JSON.parse(readFileSync22(path, "utf8"));
@@ -43069,6 +43167,7 @@ var init_script_profile = __esm(() => {
   init_gdscript_source();
   init_godot_variant();
   init_resources();
+  init_whole_file();
 });
 
 // src/server-instructions.ts
@@ -43618,6 +43717,14 @@ function scanWaitAnswer(scanned, started = "game") {
     scanNote: !scanned.stillScanning ? undefined : started === "game" ? `${still} this game started during the scan and may have read a class cache being rewritten. If ` + 'editor_output shows "Could not find type" for a class that is declared, editor_rescan ' + "waits for the scan to finish, and a start after it reads the finished cache." : `${still} the engine answering this started during the scan and may have read a class cache being ` + "rewritten, and a class cache it wrote can be written over when the scan finishes. If " + 'engine_messages shows "Could not find type" for a class that is declared, editor_rescan waits ' + "for the scan to finish, and the same call after it reads the finished cache."
   };
 }
+function engineFlagsNote(args) {
+  const among = engineFlagsAmongGameArgs(args);
+  if (among.length === 0) {
+    return;
+  }
+  const named = among.join(", ");
+  return `${named} ${among.length === 1 ? "is a flag" : "are flags"} the engine reads, and args goes to the game after --, where the engine does not read ${among.length === 1 ? "it" : "them"}. engineArgs hands the engine its own flags; ${among.length === 1 ? "leave it" : "leave them"} in args only for a game that reads ${among.length === 1 ? "that flag" : "those flags"} itself.`;
+}
 function opElsewhere(tool, requested) {
   const ops = Object.hasOwn(OPS_ELSEWHERE, tool) ? OPS_ELSEWHERE[tool] : undefined;
   const where = ops !== undefined && typeof requested === "string" && Object.hasOwn(ops, requested) ? ops[requested] : undefined;
@@ -43999,9 +44106,9 @@ function callersAnswer(totals, asked) {
     note: found.sites.length === 0 ? `No script in the project names ${asked.name} in code, outside its declaration: a call made through a string, such as call("name"), is not found by name.` : found.property ? `${byName} ${PROPERTY_PLACES}` : byName
   };
 }
-function foldedEntriesAnswer(log) {
+function foldedEntriesAnswer(log, floor = "warning") {
   const problems = log.selectFolded({
-    severity: "warning",
+    severity: floor,
     sinceLastCall: false,
     limit: MOST_ENGINE_ENTRIES
   });
@@ -45026,6 +45133,25 @@ class GodotServer {
     }
     return { ok: true, value: given };
   }
+  engineArguments(args) {
+    if (args["engineArgs"] === undefined) {
+      return { ok: true, value: [] };
+    }
+    const given = readStringArray(args, "engineArgs");
+    if (given === undefined) {
+      return {
+        ok: false,
+        response: this.createErrorResponse("engineArgs must be a list of strings.", [
+          'Pass engine flags, such as ["--verbose"] or ["--fixed-fps", "60"]'
+        ])
+      };
+    }
+    const checked = engineFlags(given);
+    if (!checked.ok) {
+      return { ok: false, response: this.createErrorResponse(checked.reason) };
+    }
+    return { ok: true, value: given };
+  }
   runEnvironment(args) {
     const savesIn = readNonEmptyString(args, "savesIn");
     if (savesIn !== undefined && !isAbsolute3(savesIn)) {
@@ -46842,6 +46968,10 @@ class GodotServer {
     if (!given.ok) {
       return given.response;
     }
+    const flags = this.engineArguments(args);
+    if (!flags.ok) {
+      return flags.response;
+    }
     const asked = this.runEnvironment(args);
     if (!asked.ok) {
       return asked.response;
@@ -46863,7 +46993,7 @@ class GodotServer {
     }
     const sceneArgument = sceneToRun?.ok ? sceneToRun.relativePath : null;
     if (op === "check") {
-      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value);
+      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value, flags.value);
     }
     await this.pickUpWhatTheEditorIsPlaying();
     let ended = null;
@@ -46890,7 +47020,7 @@ class GodotServer {
     const editorWouldPlay = !headless || editorPlaysHeadless(project.value.file);
     const silent = resolveSilent(args["silent"], process.env) && !headless;
     const profiled = readBoolean(args, "profile") === true;
-    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
+    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && flags.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
       return await this.playThroughEditor(sceneArgument, refreshed.value, scanned, project.value.path, alreadyPlaying, runtimeWaitMs, ended, profiled);
     }
     const cmdArgs = runArguments({
@@ -46898,6 +47028,7 @@ class GodotServer {
       headless,
       scene: sceneArgument,
       userArgs: given.value,
+      engineArgs: flags.value,
       silent
     });
     this.logDebug(`Running Godot project: ${engine.value} ${cmdArgs.join(" ")}`);
@@ -46910,7 +47041,7 @@ class GodotServer {
     started.announcedBefore = alreadyPlaying;
     started.bootScene = runtimeWaitMs.scene;
     this.activeProcess = started;
-    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
+    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && (given.value.length > 0 || flags.value.length > 0) ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
     const endedForThis = endedToStartThis(ended);
     const stranded = wereHereFirst.filter((one) => one.pid !== ended?.pid && alive(one.pid));
     const alsoRunning = leftRunningNote(stranded);
@@ -46920,6 +47051,7 @@ class GodotServer {
       alsoRunning: stranded.length === 0 ? undefined : stranded.map((one) => one.pid),
       pid: started.pid,
       arguments: cmdArgs,
+      argsNote: engineFlagsNote(given.value),
       transcript: started.transcript,
       profile: profileOnStart(profiled, "gdharness", runtimeAddonRegistered(project.value.path)),
       refreshedClasses: refreshed.value,
@@ -47822,10 +47954,17 @@ class GodotServer {
   async currentRun() {
     return this.activeProcess ?? await this.adoptRecordedRun();
   }
-  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}) {
+  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}, engineArgs = []) {
     const frames = readPositiveNumber(args, "frames") ?? 3;
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 60000;
-    const cmdArgs = runArguments({ projectPath, headless: true, scene, quitAfter: frames, userArgs });
+    const cmdArgs = runArguments({
+      projectPath,
+      headless: true,
+      scene,
+      quitAfter: frames,
+      userArgs,
+      engineArgs
+    });
     const boot = this.spawnGame(godotPath, cmdArgs, needsItsOwnProcess(asked) ? environmentFor({ ...asked, runtimeDirectory: runtimeDirectory() }) : undefined);
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -47853,9 +47992,11 @@ class GodotServer {
       frames,
       errors,
       warnings,
+      arguments: cmdArgs,
+      argsNote: engineFlagsNote(userArgs),
       ...scanWaitAnswer(scanned),
       savesNote: asked.savesIn !== undefined && savesStayPut() ? SAVES_NOT_MOVED_NOTE : undefined,
-      ...foldedEntriesAnswer(boot.log)
+      ...foldedEntriesAnswer(boot.log, engineArgs.includes("--verbose") ? "info" : "warning")
     });
   }
   async handleRunProfile(args) {
@@ -49261,6 +49402,7 @@ var init_server = __esm(() => {
   init_issues();
   init_junit();
   init_keeper_channel();
+  init_launch();
   init_lsp_client();
   init_outside();
   init_paths();

package/build/index.js

@@ -24913,6 +24913,62 @@ function resolveSilent(requested, variables) {
   const said = envValue("GDHARNESS_SILENT", variables)?.toLowerCase();
   return said !== undefined && said !== "0" && said !== "false";
 }
+var ENGINE_FLAGS = Object.freeze({
+  "--verbose": "none",
+  "--quiet": "none",
+  "--debug-collisions": "none",
+  "--debug-paths": "none",
+  "--debug-navigation": "none",
+  "--debug-avoidance": "none",
+  "--debug-stringnames": "none",
+  "--debug-canvas-item-redraw": "none",
+  "--debug-mute-audio": "none",
+  "--print-fps": "none",
+  "--gpu-profile": "none",
+  "--gpu-validation": "none",
+  "--gpu-abort": "none",
+  "--disable-vsync": "none",
+  "--frame-delay": "number",
+  "--time-scale": "number",
+  "--fixed-fps": "number",
+  "--max-fps": "number",
+  "--resolution": "size"
+});
+var SET_BY_ARGUMENT = Object.freeze({
+  "--headless": "headless",
+  "--audio-driver": "silent",
+  "--quit-after": "frames, on editor_run check"
+});
+function engineFlags(given) {
+  const offered = Object.keys(ENGINE_FLAGS).join(", ");
+  for (let at = 0;at < given.length; at += 1) {
+    const flag = given[at] ?? "";
+    const takes = Object.hasOwn(ENGINE_FLAGS, flag) ? ENGINE_FLAGS[flag] : undefined;
+    if (takes === undefined) {
+      const setBy = Object.hasOwn(SET_BY_ARGUMENT, flag) ? SET_BY_ARGUMENT[flag] : undefined;
+      return {
+        ok: false,
+        reason: setBy !== undefined ? `${flag} is set by this tool's own argument, ${setBy}, rather than through engineArgs.` : `${flag} is not one of the engine flags engineArgs takes, which are those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${offered}. A value goes as the next entry, as in ["--fixed-fps", "60"].`
+      };
+    }
+    if (takes === "none") {
+      continue;
+    }
+    const value = given[at + 1];
+    const fits = value !== undefined && (takes === "number" ? /^\d+(?:\.\d+)?$/.test(value) : /^\d+x\d+$/.test(value));
+    if (!fits) {
+      return {
+        ok: false,
+        reason: `${flag} takes ${takes === "number" ? "a number" : "a size such as 1280x720"} as the next entry, and ${value === undefined ? "nothing followed it" : `${JSON.stringify(value)} is not one`}.`
+      };
+    }
+    at += 1;
+  }
+  return { ok: true };
+}
+function engineFlagsAmongGameArgs(args) {
+  return args.filter((one) => Object.hasOwn(ENGINE_FLAGS, one) || Object.hasOwn(SET_BY_ARGUMENT, one));
+}
 function runArguments(options) {
   const args = options.headless ? ["--headless", "--path", options.projectPath] : ["--path", options.projectPath];
   if (options.silent === true && !options.headless) {
@@ -24921,6 +24977,9 @@ function runArguments(options) {
   if (options.quitAfter !== undefined && options.quitAfter !== null) {
     args.push("--quit-after", String(options.quitAfter));
   }
+  if (options.engineArgs !== undefined) {
+    args.push(...options.engineArgs);
+  }
   if (options.scene !== null) {
     args.push(`res://${options.scene}`);
   }
@@ -33162,18 +33221,41 @@ function restartSettled(projectPath) {
 // src/run-record.ts
 import { execFile as execFile4 } from "node:child_process";
 import { createHash as createHash3 } from "node:crypto";
-import {
-  mkdirSync as mkdirSync11,
-  openSync as openSync2,
-  readdirSync as readdirSync7,
-  readFileSync as readFileSync18,
-  realpathSync as realpathSync6,
-  rmSync as rmSync9,
-  statSync as statSync6,
-  writeFileSync as writeFileSync13
-} from "node:fs";
+import { mkdirSync as mkdirSync11, openSync as openSync2, readdirSync as readdirSync7, readFileSync as readFileSync18, realpathSync as realpathSync6, rmSync as rmSync10, statSync as statSync6 } from "node:fs";
 import { basename as basename4, dirname as dirname13, join as join19, resolve as resolve6 } from "node:path";
 import { promisify as promisify4 } from "node:util";
+
+// src/whole-file.ts
+import { renameSync as renameSync2, rmSync as rmSync9, writeFileSync as writeFileSync13 } from "node:fs";
+var HELD_FILE_MS = 1000;
+var HELD_FILE_RETRY_MS = 10;
+var HELD_BY_A_READER = new Set(["EPERM", "EACCES", "EBUSY"]);
+function writeWhole(path, text) {
+  const partial = `${path}.${process.pid}.partial`;
+  try {
+    writeFileSync13(partial, text, "utf8");
+  } catch {
+    return false;
+  }
+  const until = Date.now() + HELD_FILE_MS;
+  for (;; ) {
+    try {
+      renameSync2(partial, path);
+      return true;
+    } catch (error) {
+      const code = error.code ?? "";
+      if (!HELD_BY_A_READER.has(code) || Date.now() >= until) {
+        try {
+          rmSync9(partial, { force: true });
+        } catch {}
+        return false;
+      }
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, HELD_FILE_RETRY_MS);
+    }
+  }
+}
+
+// src/run-record.ts
 var execFileAsync = promisify4(execFile4);
 function runsDirectory() {
   return join19(runtimeDirectory(), "runs");
@@ -33208,7 +33290,7 @@ function latestRunPath(servedBy, directory = runtimeDirectory()) {
 function writeLatestRun(servedBy, latest) {
   try {
     mkdirSync11(runsDirectory(), { recursive: true });
-    writeFileSync13(latestRunPath(servedBy), JSON.stringify(latest, null, 2), "utf8");
+    writeWhole(latestRunPath(servedBy), JSON.stringify(latest, null, 2));
   } catch {}
 }
 function readLatestRun(servedBy, directory = runtimeDirectory()) {
@@ -33243,7 +33325,10 @@ function editorNotePath(projectPath, directory = runtimeDirectory()) {
 }
 function writeEditorRunNote(note) {
   mkdirSync11(runsDirectory(), { recursive: true });
-  writeFileSync13(editorNotePath(note.projectPath), JSON.stringify(note, null, 2), "utf8");
+  const path = editorNotePath(note.projectPath);
+  if (!writeWhole(path, JSON.stringify(note, null, 2))) {
+    throw new Error(`the editor run note could not be written at ${path}`);
+  }
 }
 function readEditorRunNote(projectPath) {
   for (const directory of runtimeDirectories()) {
@@ -33515,7 +33600,7 @@ function clearRunRecord(projectPath) {
     const ours = sharedRecord !== null && sharedRecord.projectPath !== "" && isSameDirectory(sharedRecord.projectPath, projectPath);
     for (const path of [runRecordPath(projectPath, directory), ...ours ? [shared] : []]) {
       try {
-        rmSync9(path, { force: true });
+        rmSync10(path, { force: true });
       } catch {}
     }
   }
@@ -33540,7 +33625,8 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
     return;
   }
   for (const entry of entries) {
-    if (!entry.startsWith("run-") || !(entry.endsWith(".log") || entry.endsWith(".profile.json"))) {
+    const transcript = entry.startsWith("run-") && (entry.endsWith(".log") || entry.endsWith(".profile.json"));
+    if (!transcript && !entry.endsWith(".partial")) {
       continue;
     }
     const path = join19(directory, entry);
@@ -33548,7 +33634,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
       continue;
     }
     try {
-      rmSync9(path);
+      rmSync10(path);
     } catch {}
   }
 }
@@ -33647,7 +33733,7 @@ function withoutListed(entries, errors) {
 }
 
 // src/script-profile.ts
-import { readFileSync as readFileSync19, renameSync as renameSync2, writeFileSync as writeFileSync14 } from "node:fs";
+import { readFileSync as readFileSync19 } from "node:fs";
 
 // src/godot-variant.ts
 var FLAG_64 = 1 << 16;
@@ -34767,7 +34853,13 @@ var TOOL_SPECS = [
         type: "array",
         items: { type: "string" },
         ops: ["start", "check"],
-        description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+        description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here, so a flag the engine reads goes to the game instead, and the answer says so under argsNote. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+      },
+      engineArgs: {
+        type: "array",
+        items: { type: "string" },
+        ops: ["start", "check"],
+        description: `The engine's own flags, before the separator, such as ["--verbose"] or ["--fixed-fps", "60"], a value going as the next entry. Only those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${Object.keys(ENGINE_FLAGS).join(", ")}. Any other is refused, since the engine's command line can also run scripts, open other projects and write files. A run with any is started by this server, as one with args is. A check given --verbose answers with everything printed rather than only errors and warnings, since what verbose adds, the instances leaked at exit among it, is printed as ordinary lines.`
       },
       headless: { type: "boolean", ops: ["start"], description: "start: force a window or no window." },
       visible: {
@@ -34864,7 +34956,7 @@ var TOOL_SPECS = [
         requires: []
       }
     },
-    answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
+    answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
     defaultOperation: "start"
   },
   {
@@ -35558,9 +35650,9 @@ import {
   readdirSync as readdirSync8,
   readFileSync as readFileSync20,
   rmdirSync,
-  rmSync as rmSync10,
+  rmSync as rmSync11,
   statSync as statSync7,
-  writeFileSync as writeFileSync15
+  writeFileSync as writeFileSync14
 } from "node:fs";
 import { dirname as dirname14, join as join21 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -36317,6 +36409,14 @@ var PLAYING_STATUS_MS = 1000;
 var SCAN_START_MS = 2000;
 var SCAN_SETTLED_MS = 500;
 var REIMPORT_TIMEOUT_MS = 300000;
+function engineFlagsNote(args) {
+  const among = engineFlagsAmongGameArgs(args);
+  if (among.length === 0) {
+    return;
+  }
+  const named = among.join(", ");
+  return `${named} ${among.length === 1 ? "is a flag" : "are flags"} the engine reads, and args goes to the game after --, where the engine does not read ${among.length === 1 ? "it" : "them"}. engineArgs hands the engine its own flags; ${among.length === 1 ? "leave it" : "leave them"} in args only for a game that reads ${among.length === 1 ? "that flag" : "those flags"} itself.`;
+}
 var OPS_ELSEWHERE = {
   runtime_invoke: { get: "runtime_inspect property", property: "runtime_inspect property" }
 };
@@ -36747,9 +36847,9 @@ function callersAnswer(totals, asked) {
   };
 }
 var MOST_ENGINE_ENTRIES = 200;
-function foldedEntriesAnswer(log) {
+function foldedEntriesAnswer(log, floor = "warning") {
   const problems = log.selectFolded({
-    severity: "warning",
+    severity: floor,
     sinceLastCall: false,
     limit: MOST_ENGINE_ENTRIES
   });
@@ -37777,6 +37877,25 @@ class GodotServer {
     }
     return { ok: true, value: given };
   }
+  engineArguments(args) {
+    if (args["engineArgs"] === undefined) {
+      return { ok: true, value: [] };
+    }
+    const given = readStringArray(args, "engineArgs");
+    if (given === undefined) {
+      return {
+        ok: false,
+        response: this.createErrorResponse("engineArgs must be a list of strings.", [
+          'Pass engine flags, such as ["--verbose"] or ["--fixed-fps", "60"]'
+        ])
+      };
+    }
+    const checked = engineFlags(given);
+    if (!checked.ok) {
+      return { ok: false, response: this.createErrorResponse(checked.reason) };
+    }
+    return { ok: true, value: given };
+  }
   runEnvironment(args) {
     const savesIn = readNonEmptyString(args, "savesIn");
     if (savesIn !== undefined && !isAbsolute3(savesIn)) {
@@ -39593,6 +39712,10 @@ class GodotServer {
     if (!given.ok) {
       return given.response;
     }
+    const flags = this.engineArguments(args);
+    if (!flags.ok) {
+      return flags.response;
+    }
     const asked = this.runEnvironment(args);
     if (!asked.ok) {
       return asked.response;
@@ -39614,7 +39737,7 @@ class GodotServer {
     }
     const sceneArgument = sceneToRun?.ok ? sceneToRun.relativePath : null;
     if (op === "check") {
-      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value);
+      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value, flags.value);
     }
     await this.pickUpWhatTheEditorIsPlaying();
     let ended = null;
@@ -39641,7 +39764,7 @@ class GodotServer {
     const editorWouldPlay = !headless || editorPlaysHeadless(project.value.file);
     const silent = resolveSilent(args["silent"], process.env) && !headless;
     const profiled = readBoolean(args, "profile") === true;
-    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
+    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && flags.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
       return await this.playThroughEditor(sceneArgument, refreshed.value, scanned, project.value.path, alreadyPlaying, runtimeWaitMs, ended, profiled);
     }
     const cmdArgs = runArguments({
@@ -39649,6 +39772,7 @@ class GodotServer {
       headless,
       scene: sceneArgument,
       userArgs: given.value,
+      engineArgs: flags.value,
       silent
     });
     this.logDebug(`Running Godot project: ${engine.value} ${cmdArgs.join(" ")}`);
@@ -39661,7 +39785,7 @@ class GodotServer {
     started.announcedBefore = alreadyPlaying;
     started.bootScene = runtimeWaitMs.scene;
     this.activeProcess = started;
-    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
+    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && (given.value.length > 0 || flags.value.length > 0) ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
     const endedForThis = endedToStartThis(ended);
     const stranded = wereHereFirst.filter((one) => one.pid !== ended?.pid && alive(one.pid));
     const alsoRunning = leftRunningNote(stranded);
@@ -39671,6 +39795,7 @@ class GodotServer {
       alsoRunning: stranded.length === 0 ? undefined : stranded.map((one) => one.pid),
       pid: started.pid,
       arguments: cmdArgs,
+      argsNote: engineFlagsNote(given.value),
       transcript: started.transcript,
       profile: profileOnStart(profiled, "gdharness", runtimeAddonRegistered(project.value.path)),
       refreshedClasses: refreshed.value,
@@ -40573,10 +40698,17 @@ class GodotServer {
   async currentRun() {
     return this.activeProcess ?? await this.adoptRecordedRun();
   }
-  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}) {
+  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}, engineArgs = []) {
     const frames = readPositiveNumber(args, "frames") ?? 3;
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 60000;
-    const cmdArgs = runArguments({ projectPath, headless: true, scene, quitAfter: frames, userArgs });
+    const cmdArgs = runArguments({
+      projectPath,
+      headless: true,
+      scene,
+      quitAfter: frames,
+      userArgs,
+      engineArgs
+    });
     const boot = this.spawnGame(godotPath, cmdArgs, needsItsOwnProcess(asked) ? environmentFor({ ...asked, runtimeDirectory: runtimeDirectory() }) : undefined);
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -40604,9 +40736,11 @@ class GodotServer {
       frames,
       errors,
       warnings,
+      arguments: cmdArgs,
+      argsNote: engineFlagsNote(userArgs),
       ...scanWaitAnswer(scanned),
       savesNote: asked.savesIn !== undefined && savesStayPut() ? SAVES_NOT_MOVED_NOTE : undefined,
-      ...foldedEntriesAnswer(boot.log)
+      ...foldedEntriesAnswer(boot.log, engineArgs.includes("--verbose") ? "info" : "warning")
     });
   }
   async handleRunProfile(args) {

package/build/keeper.js

@@ -2,7 +2,7 @@
 
 // src/keeper.ts
 import { spawn } from "node:child_process";
-import { closeSync, existsSync as existsSync2, mkdtempSync as mkdtempSync3, openSync as openSync2, readFileSync as readFileSync3, rmSync as rmSync4, writeFileSync as writeFileSync4 } from "node:fs";
+import { closeSync, existsSync as existsSync2, mkdtempSync as mkdtempSync3, openSync as openSync2, readFileSync as readFileSync2, rmSync as rmSync5, writeFileSync as writeFileSync3 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 import { join as join5 } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
@@ -230,6 +230,14 @@ import { connect, createServer } from "node:net";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import process2 from "node:process";
+function endedOrWhyNot(end) {
+  try {
+    return end();
+  } catch (error) {
+    return `could not end it: ${error instanceof Error ? error.message : String(error)}`.replaceAll(`
+`, " ");
+  }
+}
 async function listenForAStop(end) {
   let directory = null;
   try {
@@ -244,7 +252,7 @@ async function listenForAStop(end) {
         if (asked.includes(`
 `)) {
           socket.end(asked.startsWith(`stop
-`) ? `${end()}
+`) ? `${endedOrWhyNot(end)}
 ` : `unknown
 `);
         }
@@ -315,16 +323,7 @@ function readLaunched(printed) {
 // src/run-record.ts
 import { execFile as execFile2 } from "node:child_process";
 import { createHash as createHash2 } from "node:crypto";
-import {
-  mkdirSync,
-  openSync,
-  readdirSync,
-  readFileSync,
-  realpathSync,
-  rmSync as rmSync2,
-  statSync,
-  writeFileSync as writeFileSync2
-} from "node:fs";
+import { mkdirSync, openSync, readdirSync, readFileSync, realpathSync, rmSync as rmSync3, statSync } from "node:fs";
 import { basename, dirname as dirname2, join as join3, resolve as resolve2 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 
@@ -364,6 +363,32 @@ function envValue(name, variables = process.env) {
   const value = variables[name];
   return value === undefined || value === "" ? undefined : value;
 }
+var ENGINE_FLAGS = Object.freeze({
+  "--verbose": "none",
+  "--quiet": "none",
+  "--debug-collisions": "none",
+  "--debug-paths": "none",
+  "--debug-navigation": "none",
+  "--debug-avoidance": "none",
+  "--debug-stringnames": "none",
+  "--debug-canvas-item-redraw": "none",
+  "--debug-mute-audio": "none",
+  "--print-fps": "none",
+  "--gpu-profile": "none",
+  "--gpu-validation": "none",
+  "--gpu-abort": "none",
+  "--disable-vsync": "none",
+  "--frame-delay": "number",
+  "--time-scale": "number",
+  "--fixed-fps": "number",
+  "--max-fps": "number",
+  "--resolution": "size"
+});
+var SET_BY_ARGUMENT = Object.freeze({
+  "--headless": "headless",
+  "--audio-driver": "silent",
+  "--quit-after": "frames, on editor_run check"
+});
 
 // src/runtime-client.ts
 function runtimeDirectory(variables = process.env) {
@@ -379,6 +404,36 @@ var verdicts = new Map;
 var LATE_ANSWER_MS = 30 * 60000;
 var lateAnswers = new Map;
 
+// src/whole-file.ts
+import { renameSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
+var HELD_FILE_MS = 1000;
+var HELD_FILE_RETRY_MS = 10;
+var HELD_BY_A_READER = new Set(["EPERM", "EACCES", "EBUSY"]);
+function writeWhole(path, text) {
+  const partial = `${path}.${process.pid}.partial`;
+  try {
+    writeFileSync2(partial, text, "utf8");
+  } catch {
+    return false;
+  }
+  const until = Date.now() + HELD_FILE_MS;
+  for (;; ) {
+    try {
+      renameSync(partial, path);
+      return true;
+    } catch (error) {
+      const code = error.code ?? "";
+      if (!HELD_BY_A_READER.has(code) || Date.now() >= until) {
+        try {
+          rmSync2(partial, { force: true });
+        } catch {}
+        return false;
+      }
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, HELD_FILE_RETRY_MS);
+    }
+  }
+}
+
 // src/run-record.ts
 var execFileAsync = promisify2(execFile2);
 function runsDirectory() {
@@ -410,7 +465,10 @@ function runRecordPath(projectPath, directory = runtimeDirectory()) {
 }
 function writeRunRecord(record) {
   mkdirSync(runsDirectory(), { recursive: true });
-  writeFileSync2(runRecordPath(record.projectPath), JSON.stringify(record, null, 2), "utf8");
+  const path = runRecordPath(record.projectPath);
+  if (!writeWhole(path, JSON.stringify(record, null, 2))) {
+    throw new Error(`the run note could not be written at ${path}`);
+  }
 }
 function recordRunEnded(projectPath, pid, ending) {
   const path = runRecordPath(projectPath);
@@ -424,9 +482,7 @@ function recordRunEnded(projectPath, pid, ending) {
     ...ending.exitSignal === null ? {} : { exitSignal: ending.exitSignal },
     endedAt: Date.now()
   };
-  try {
-    writeFileSync2(path, JSON.stringify(written, null, 2), "utf8");
-  } catch {}
+  writeWhole(path, JSON.stringify(written, null, 2));
 }
 function recordAt(path) {
   let parsed;
@@ -464,7 +520,7 @@ function recordAt(path) {
 }
 
 // src/scratch.ts
-import { existsSync, mkdtempSync as mkdtempSync2, readdirSync as readdirSync2, rmSync as rmSync3 } from "node:fs";
+import { existsSync, mkdtempSync as mkdtempSync2, readdirSync as readdirSync2, rmSync as rmSync4 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join4 } from "node:path";
 import process3 from "node:process";
@@ -497,7 +553,7 @@ function discard(...paths) {
   return left;
 }
 function remove(path) {
-  rmSync3(path, SWEPT);
+  rmSync4(path, SWEPT);
 }
 function tryAgain(path, attempt) {
   if (attempt === 0) {
@@ -541,7 +597,6 @@ function lastTryOnExit() {
 }
 
 // src/script-profile.ts
-import { readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync3 } from "node:fs";
 import { createServer as createServer2 } from "node:net";
 
 // src/gdscript-source.ts
@@ -1073,9 +1128,7 @@ function parseIniLikeValue(value) {
 
 // src/script-profile.ts
 function writeProfileFile(path, file) {
-  const partial = `${path}.${process.pid}.partial`;
-  writeFileSync3(partial, JSON.stringify(file), "utf8");
-  renameSync(partial, path);
+  return writeWhole(path, JSON.stringify(file));
 }
 var QUEUE_SETTING = "limits/debugger/max_queued_messages";
 var QUEUE_DEFAULT = 2048;
@@ -1315,12 +1368,12 @@ async function startThroughHelper(spec, output, stopFile) {
       exited.now = true;
     });
     for (let waited = 0;waited < DESKTOP_START_MS; waited += 50) {
-      const pid = existsSync2(pidFile) ? Number(readFileSync3(pidFile, "utf8").trim()) : Number.NaN;
+      const pid = existsSync2(pidFile) ? Number(readFileSync2(pidFile, "utf8").trim()) : Number.NaN;
       if (Number.isInteger(pid) && pid > 0) {
         return { child: started.child, pid };
       }
       if (exited.now) {
-        const why = existsSync2(errorFile) ? readFileSync3(errorFile, "utf8").trim() : "it exited saying nothing";
+        const why = existsSync2(errorFile) ? readFileSync2(errorFile, "utf8").trim() : "it exited saying nothing";
         return { error: `it could not be started ${where}: ${why}` };
       }
       await delay(50);
@@ -1332,18 +1385,19 @@ async function startThroughHelper(spec, output, stopFile) {
   }
 }
 var PROFILE_WRITE_MS = 500;
+var LAST_WRITE_TRIES = 5;
 async function profiledBy(path, projectPath) {
   let latest = null;
   let timer = null;
   const write = () => {
     timer = null;
-    if (latest !== null) {
-      writeProfileFile(path, { ...latest, connected: true });
+    if (latest !== null && !writeProfileFile(path, { ...latest, connected: true })) {
+      timer = setTimeout(write, PROFILE_WRITE_MS);
     }
   };
   let projectGodot = null;
   try {
-    projectGodot = readFileSync3(join5(projectPath, "project.godot"), "utf8");
+    projectGodot = readFileSync2(join5(projectPath, "project.godot"), "utf8");
   } catch {}
   const listener = await ProfileListener.open((totals) => {
     const first = latest === null;
@@ -1362,7 +1416,10 @@ async function profiledBy(path, projectPath) {
         clearTimeout(timer);
       }
       latest = listener.totals() ?? latest;
-      write();
+      let tries = 0;
+      while (latest !== null && !writeProfileFile(path, { ...latest, connected: true }) && tries < LAST_WRITE_TRIES) {
+        tries += 1;
+      }
       listener.close();
     }
   };
@@ -1427,6 +1484,11 @@ async function launch() {
     process.exit(0);
   });
 }
+function writeNoteIfItCan(record) {
+  try {
+    writeRunRecord(record);
+  } catch {}
+}
 async function keep() {
   const spec = await receivedSpec();
   const run = spec.run;
@@ -1467,7 +1529,7 @@ async function keep() {
     command: spec.command
   };
   if (record !== null) {
-    writeRunRecord(record);
+    writeNoteIfItCan(record);
   }
   let listening = null;
   child.once("exit", (code, signal) => {
@@ -1477,20 +1539,20 @@ async function keep() {
     profiled?.finish();
     listening?.close();
     if (own !== null) {
-      rmSync4(own, { recursive: true, force: true });
+      rmSync5(own, { recursive: true, force: true });
     }
     process.exit(0);
   });
   if (record !== null) {
     listening = await listenForAStop(() => {
       if (stopFile !== "") {
-        writeFileSync4(stopFile, "");
+        writeFileSync3(stopFile, "");
         return "signalled";
       }
       return child.kill() ? "signalled" : "gone";
     });
     if (listening !== null) {
-      writeRunRecord({ ...record, keeper: listening.address });
+      writeNoteIfItCan({ ...record, keeper: listening.address });
     }
   }
   process.stdout.write(`pid ${pid}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "mcpName": "io.github.Aureliolo/gdharness",
   "description": "A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.",
   "type": "module",