gdharness 1.3.8 → 1.3.10

package/build/keeper.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/keeper.ts
-import { closeSync as closeSync2, existsSync as existsSync3, mkdtempSync as mkdtempSync4, openSync as openSync3, readFileSync as readFileSync3, rmSync as rmSync6, writeFileSync as writeFileSync3 } from "node:fs";
+import { closeSync as closeSync2, existsSync as existsSync3, mkdtempSync as mkdtempSync4, openSync as openSync3, readFileSync as readFileSync6, rmSync as rmSync6, writeFileSync as writeFileSync3 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { join as join7 } from "node:path";
-import { setTimeout as delay2 } from "node:timers/promises";
+import { join as join9 } from "node:path";
+import { setTimeout as delay3 } from "node:timers/promises";
 
 // src/alive.ts
 import process2 from "node:process";
@@ -60,6 +60,18 @@ function spawnHidden(command, args, options = {}) {
 function spawnShown(command, args, options = {}) {
   return spawn(command, [...args], { ...options, windowsHide: false });
 }
+function runHidden(command, args, options = {}) {
+  return new Promise((resolve, reject) => {
+    execFile(command, [...args], { ...options, encoding: "utf8", windowsHide: true }, (error, stdout, stderr) => {
+      if (error !== null) {
+        Object.assign(error, { stdout, stderr });
+        reject(error);
+        return;
+      }
+      resolve({ stdout, stderr });
+    });
+  });
+}
 
 // src/desktop.ts
 var DESKTOP_VARIABLE = "GDHARNESS_DESKTOP";
@@ -163,10 +175,25 @@ public static class GdharnessDesktop {
   // it did not start itself: a handle names one process, where a pid can name the next one too. The
   // process starts in directory rather than in this one's, which is a temporary directory: Windows
   // PowerShell saves its module cache relative to where it runs when the profile does not resolve.
-  public static int Run(string desktop, string commandLine, string pidFile, bool noActivate, string stopFile, string directory) {
+  // The spec is one field a line, each base64 of its UTF-8, read with no PowerShell cmdlet: a cmdlet
+  // has PowerShell prepare its modules first, on every start.
+  public static int RunSpec(string specFile) {
+    string[] lines = File.ReadAllLines(specFile);
+    Func<int, string> field = delegate(int index) { return Encoding.UTF8.GetString(Convert.FromBase64String(lines[index])); };
+    return Run(field(0), field(1), field(2), field(3) == "1", field(4), field(5), field(6));
+  }
+
+  static void Step(string stepFile, string step) {
+    if (stepFile.Length > 0) {
+      File.WriteAllText(stepFile, step);
+    }
+  }
+
+  public static int Run(string desktop, string commandLine, string pidFile, bool noActivate, string stopFile, string directory, string stepFile) {
     StartupInfo startup = new StartupInfo();
     startup.cb = Marshal.SizeOf(typeof(StartupInfo));
     if (desktop.Length > 0) {
+      Step(stepFile, "creating the " + desktop + " desktop");
       IntPtr held = CreateDesktopW(desktop, IntPtr.Zero, IntPtr.Zero, 0, GenericAll, IntPtr.Zero);
       if (held == IntPtr.Zero) {
         throw new Win32Exception(Marshal.GetLastWin32Error(), "CreateDesktopW " + desktop);
@@ -191,6 +218,7 @@ public static class GdharnessDesktop {
       LockSetForegroundWindow(LockForeground);
     }
     try {
+    Step(stepFile, "starting the process");
     if (!CreateProcessW(null, new StringBuilder(commandLine), IntPtr.Zero, IntPtr.Zero, true, DetachedProcess, IntPtr.Zero, directory, ref startup, out started)) {
       throw new Win32Exception(Marshal.GetLastWin32Error(), "CreateProcessW " + commandLine);
     }
@@ -330,24 +358,40 @@ function quoted(argument) {
 function windowsCommandLine(command, args) {
   return [command, ...args].map(quoted).join(" ");
 }
+function helperFailure(file) {
+  try {
+    const said = readFileSync(file, "utf8").trim();
+    return said === "" ? null : said;
+  } catch {
+    return null;
+  }
+}
+function helperStep(stepFile) {
+  let step = null;
+  try {
+    step = readFileSync(stepFile, "utf8").trim();
+  } catch {}
+  return step === null || step === "" ? "Windows PowerShell had not begun running the helper" : `the helper was ${step}`;
+}
 function throughHelper(how, command, args, files, assembly = helperAssembly()) {
-  const spec = {
-    desktop: how.desktop ?? "",
-    noActivate: how.noActivate === true,
-    commandLine: windowsCommandLine(command, args),
-    pidFile: files.pid,
-    stopFile: files.stop,
-    directory: how.directory,
-    assembly
-  };
-  writeFileSync(files.spec, JSON.stringify(spec), "utf8");
+  const fields = [
+    how.desktop ?? "",
+    windowsCommandLine(command, args),
+    files.pid,
+    how.noActivate === true ? "1" : "0",
+    files.stop,
+    how.directory,
+    files.step
+  ];
+  writeFileSync(files.spec, fields.map((field) => Buffer.from(field, "utf8").toString("base64")).join(`
+`), "utf8");
   const literal = (path) => `'${path.replaceAll("'", "''")}'`;
   const script = [
     "$ErrorActionPreference = 'Stop'",
     "try {",
-    `  $spec = [IO.File]::ReadAllText(${literal(files.spec)}, [Text.Encoding]::UTF8) | ConvertFrom-Json`,
-    "  Add-Type -LiteralPath $spec.assembly",
-    "  $code = [GdharnessDesktop]::Run($spec.desktop, $spec.commandLine, $spec.pidFile, [bool]$spec.noActivate, $spec.stopFile, $spec.directory)",
+    `  [IO.File]::WriteAllText(${literal(files.step)}, 'loading its assembly')`,
+    `  $null = [Reflection.Assembly]::LoadFrom(${literal(assembly)})`,
+    `  $code = [GdharnessDesktop]::RunSpec(${literal(files.spec)})`,
     "} catch {",
     `  [IO.File]::WriteAllText(${literal(files.error)}, $_.Exception.Message)`,
     "  exit 1",
@@ -396,7 +440,9 @@ function crashesReported() {
 }
 
 // src/game-debugger.ts
+import { readFileSync as readFileSync3 } from "node:fs";
 import { createServer } from "node:net";
+import { join as join5 } from "node:path";
 
 // src/godot-variant.ts
 var NIL = 0;
@@ -700,185 +746,636 @@ function readMessage(body) {
   return { message, thread, data };
 }
 
-// src/game-debugger.ts
-var PAUSE_MS = 30000;
-var STEP_MS = 1e4;
-var ADDON_STEP_MS = 5000;
-var RUNTIME_ADDON = "res://addons/gdharness_runtime/";
-var READ_MS = 5000;
-var REPLIES = new Set([
-  "debug_enter",
-  "debug_exit",
-  "stack_dump",
-  "stack_frame_vars",
-  "stack_frame_var"
+// src/setup.ts
+import { dirname as dirname2, join as join4 } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/gdscript-source.ts
+var DECLARING = new Set(["var", "const", "func", "signal", "enum", "class", "for", "class_name"]);
+var NAME = "[\\p{L}_][\\p{L}\\p{N}_]*";
+var ANNOTATIONS = "(?:@[\\p{L}_][\\p{L}\\p{N}_]*(?:\\([^)]*\\))?\\s+)*";
+var DECLARATION_LINE = new RegExp(`^(${ANNOTATIONS})(static\\s+)?(func|var|const|signal|enum|class)\\s+(${NAME})`, "u");
+var CLASS_NAME_LINE = new RegExp(`^${ANNOTATIONS}class_name\\s+(${NAME})`, "u");
+var EXTENDS_LINE = new RegExp(`^${ANNOTATIONS}(?:class_name\\s+${NAME}\\s+)?extends\\s`, "u");
+var FUNC_LINE = new RegExp(`^[ \\t]*${ANNOTATIONS}(?:static\\s+)?func\\s+(${NAME})\\s*\\(`, "u");
+var LAMBDA_HEADER = new RegExp(`(?<![\\p{L}\\p{N}_])func(?:\\s+${NAME})?\\s*\\(`, "u");
+var DOTTED = `${NAME}(?:\\.${NAME})*`;
+var MEMBER_KINDS = new Set(["var", "const", "signal", "enum", "enumValue"]);
+var KEYWORDS = new Set([
+  "and",
+  "as",
+  "assert",
+  "await",
+  "break",
+  "breakpoint",
+  "class",
+  "class_name",
+  "const",
+  "continue",
+  "elif",
+  "else",
+  "enum",
+  "extends",
+  "false",
+  "for",
+  "func",
+  "if",
+  "in",
+  "is",
+  "match",
+  "namespace",
+  "not",
+  "null",
+  "or",
+  "pass",
+  "preload",
+  "return",
+  "self",
+  "signal",
+  "static",
+  "super",
+  "trait",
+  "true",
+  "var",
+  "void",
+  "when",
+  "while",
+  "yield",
+  "INF",
+  "NAN",
+  "PI",
+  "TAU"
 ]);
-var INBOX_KEPT = 1e4;
-var OUTPUT_KEPT = 1000;
-var TYPE_NAMES = [
-  "Nil",
-  "bool",
-  "int",
-  "float",
-  "String",
-  "Vector2",
-  "Vector2i",
-  "Rect2",
-  "Rect2i",
-  "Vector3",
-  "Vector3i",
-  "Transform2D",
-  "Vector4",
-  "Vector4i",
-  "Plane",
-  "Quaternion",
-  "AABB",
-  "Basis",
-  "Transform3D",
-  "Projection",
-  "Color",
-  "StringName",
-  "NodePath",
-  "RID",
-  "Object",
-  "Callable",
-  "Signal",
-  "Dictionary",
-  "Array",
-  "PackedByteArray",
-  "PackedInt32Array",
-  "PackedInt64Array",
-  "PackedFloat32Array",
-  "PackedFloat64Array",
-  "PackedStringArray",
-  "PackedVector2Array",
-  "PackedVector3Array",
-  "PackedColorArray",
-  "PackedVector4Array"
-];
-var SCOPES = ["Locals", "Members", "Globals"];
-var ELEMENTS_SHOWN = 20;
-function isList(value) {
-  return Array.isArray(value);
-}
-function shownValue(value, typeHint = "") {
-  if (value === null) {
-    return "null";
-  }
-  if (typeof value === "string") {
-    return value;
-  }
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value);
-  }
-  if (isList(value)) {
-    const shown = value.slice(0, ELEMENTS_SHOWN).map((each) => shownValue(each));
-    const more = value.length - shown.length;
-    return `[${shown.join(", ")}${more > 0 ? `, and ${more} more` : ""}]`;
-  }
-  if (value.kind === "dictionary" && "entries" in value) {
-    const shown = value.entries.slice(0, ELEMENTS_SHOWN).map(([key, each]) => `${shownValue(key)}: ${shownValue(each)}`);
-    const more = value.entries.length - shown.length;
-    return `{${shown.join(", ")}${more > 0 ? `, and ${more} more` : ""}}`;
-  }
-  if (!("values" in value)) {
-    return value.kind;
-  }
-  if (value.kind === "Object") {
-    return `<${typeHint === "" ? "Object" : typeHint}#${String(value.values[0])}>`;
-  }
-  return `${value.kind}(${value.values.join(", ")})`;
-}
-function framesOf(data) {
-  const frames = [];
-  for (let at = 1;at + 2 < data.length; at += 3) {
-    const [script, line, name] = [data[at], data[at + 1], data[at + 2]];
-    if (typeof script !== "string" || typeof line !== "number" || typeof name !== "string") {
-      break;
-    }
-    frames.push({ id: frames.length, name, line, script });
-  }
-  return frames;
+
+// src/dictionary.ts
+function emptyRecord() {
+  return Object.create(null);
 }
 
-class GameDebugger {
-  connection = null;
-  held = null;
-  ended = false;
-  waiters = [];
-  inbox = [];
-  onClosed = [];
-  output = [];
-  outputDropped = 0;
-  queue = Promise.resolve();
-  server;
-  port;
-  breakpoints;
-  observers;
-  constructor(server, port, breakpoints, observers) {
-    this.server = server;
-    this.port = port;
-    this.breakpoints = breakpoints;
-    this.observers = observers;
-  }
-  static async open(breakpoints, observers = []) {
-    const server = createServer();
-    await new Promise((resolve, reject) => {
-      server.once("error", reject);
-      server.listen(0, "127.0.0.1", () => {
-        resolve();
-      });
-    });
-    const address = server.address();
-    if (address === null || typeof address === "string") {
-      server.close();
-      throw new Error("the debugger has no port");
-    }
-    const peer = new GameDebugger(server, address.port, breakpoints, observers);
-    server.on("connection", (socket) => {
-      peer.accept(socket);
-    });
-    return peer;
-  }
-  get engineArguments() {
-    const listed = this.breakpoints.map((one) => one.replaceAll(" ", "%20")).join(",");
-    return [
-      "--remote-debug",
-      `tcp://127.0.0.1:${this.port}`,
-      "--ignore-error-breaks",
-      ...listed === "" ? [] : ["--breakpoints", listed]
-    ];
-  }
-  accept(socket) {
-    if (this.connection !== null) {
-      socket.destroy();
-      return;
-    }
-    this.connection = socket;
-    this.server.close();
-    const send = (message, data) => {
-      this.send(message, data);
-    };
-    for (const observer of this.observers) {
-      observer.connected(send);
-    }
-    const stream = new DebuggerStream;
-    socket.on("data", (chunk) => {
-      let messages;
-      try {
-        messages = stream.push(chunk);
-      } catch {
-        socket.destroy();
-        return;
-      }
-      for (const received of messages) {
-        if ("message" in received) {
-          this.take(received);
-          for (const observer of this.observers) {
-            observer.message(received, send);
-          }
-        }
-      }
+// src/call-signal.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var current = new AsyncLocalStorage;
+
+// src/game-log.ts
+var COLOUR_CODE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
+var ADMITTED = {
+  error: new Set(["error"]),
+  warning: new Set(["error", "warning"]),
+  info: new Set(["error", "warning", "info"])
+};
+
+// src/engine-run.ts
+var WINDOWS_STATUSES = new Map([
+  [3221225477, "an access violation, so it crashed"],
+  [3221225501, "an illegal instruction, so it crashed"],
+  [3221225620, "an integer division by zero, so it crashed"],
+  [3221225725, "a stack overflow, so it crashed"],
+  [3221225781, "a library it needs was not found, so it never started"],
+  [3221225786, "its console was closed or sent Ctrl+C"],
+  [3221226356, "a corrupted heap, so it crashed"],
+  [3221226505, "a stack buffer overrun or a fast fail, so it crashed"]
+]);
+
+// src/engine-leaks.ts
+var NAME2 = "[\\p{L}_][\\p{L}\\p{N}_]*";
+var EXPORTED = new RegExp(`@export(?!_(?:group|subgroup|category)\\b)\\w*(?:\\([^)]*\\))?\\s+(?:@${NAME2}(?:\\([^)]*\\))?\\s+)*` + `(?:static\\s+)?var\\s+(${NAME2})\\s*:\\s*(?:Array|Dictionary)\\s*\\[([^\\]]*)\\]`, "gu");
+
+// src/project-scan.ts
+var SKIPPED = new Set(["node_modules"]);
+var SCENE_EXTENSIONS = new Set(["tscn", "scn"]);
+var SIDECAR_EXTENSIONS = new Set(["import", "uid"]);
+var ASSET_EXTENSIONS = new Set([
+  "png",
+  "jpg",
+  "jpeg",
+  "webp",
+  "svg",
+  "bmp",
+  "tga",
+  "exr",
+  "hdr",
+  "ktx",
+  "dds",
+  "ttf",
+  "otf",
+  "woff",
+  "woff2",
+  "fnt",
+  "wav",
+  "mp3",
+  "ogg",
+  "glb",
+  "gltf",
+  "obj",
+  "fbx",
+  "blend",
+  "dae",
+  "ogv",
+  "gdshader",
+  "gdshaderinc",
+  "shader",
+  "glsl"
+]);
+var CARRIES_A_UID = new Set(["gd", "shader", "gdshader"]);
+var BINARY_EXTENSIONS = new Set([
+  ...[...ASSET_EXTENSIONS].filter((extension) => !["svg", "gltf", "gdshader", "shader", "fnt"].includes(extension)),
+  "scn",
+  "res",
+  "zip",
+  "pck",
+  "exe",
+  "dll",
+  "so",
+  "dylib"
+]);
+
+// src/import-freshness.ts
+var IMPORTABLE_EXTENSIONS = [
+  "png",
+  "jpg",
+  "jpeg",
+  "webp",
+  "svg",
+  "bmp",
+  "tga",
+  "exr",
+  "hdr",
+  "dds",
+  "ktx",
+  "wav",
+  "mp3",
+  "ogg",
+  "ttf",
+  "otf",
+  "ttc",
+  "otc",
+  "woff",
+  "woff2",
+  "pfb",
+  "pfm",
+  "fnt",
+  "font",
+  "glb",
+  "gltf",
+  "fbx",
+  "obj",
+  "dae",
+  "csv",
+  "glsl"
+];
+var IMPORTABLE = new Set(IMPORTABLE_EXTENSIONS);
+var hashes = new Map;
+
+// src/paths.ts
+import { realpathSync, statSync as statSync2 } from "node:fs";
+import { basename, dirname, isAbsolute, join as join2, relative, resolve, sep } from "node:path";
+function realAsFarAsItExists(path) {
+  const missing = [];
+  let at = path;
+  for (;; ) {
+    try {
+      return join2(realpathSync.native(at), ...missing);
+    } catch {
+      const parent = dirname(at);
+      if (parent === at) {
+        return path;
+      }
+      missing.unshift(basename(at));
+      at = parent;
+    }
+  }
+}
+
+// src/scratch.ts
+import { existsSync as existsSync2, mkdtempSync as mkdtempSync2, readdirSync, rmSync as rmSync2 } from "node:fs";
+import { tmpdir as tmpdir2 } from "node:os";
+import { join as join3 } from "node:path";
+import process4 from "node:process";
+var SWEPT = { recursive: true, force: true };
+var AGAIN_AFTER_MS = [250, 500, 1000, 2000, 4000, 8000, 16000];
+var waiting = new Set;
+var atExit = new Set;
+function scratchDirectory(kind) {
+  return mkdtempSync2(join3(tmpdir2(), `gdharness-${kind}-${process4.pid}-`));
+}
+function discardWith(remove, paths) {
+  const left = [];
+  for (const path of paths) {
+    if (!path) {
+      continue;
+    }
+    try {
+      remove(path);
+    } catch (error) {
+      left.push({ path, reason: error instanceof Error ? error.message : String(error) });
+    }
+  }
+  return left;
+}
+function discard(...paths) {
+  const left = discardWith(remove, paths);
+  for (const { path } of left) {
+    tryAgain(path, 0);
+  }
+  return left;
+}
+function remove(path) {
+  rmSync2(path, SWEPT);
+}
+function tryAgain(path, attempt) {
+  if (attempt === 0) {
+    if (waiting.has(path)) {
+      return;
+    }
+    waiting.add(path);
+    atExit.delete(path);
+    lastTryOnExit();
+  }
+  const after = AGAIN_AFTER_MS[attempt];
+  if (after === undefined || !existsSync2(path)) {
+    waiting.delete(path);
+    if (after === undefined) {
+      atExit.add(path);
+    }
+    return;
+  }
+  setTimeout(() => {
+    try {
+      remove(path);
+      waiting.delete(path);
+    } catch {
+      tryAgain(path, attempt + 1);
+    }
+  }, after).unref();
+}
+var lastTryWatched = false;
+function lastTryOnExit() {
+  if (lastTryWatched) {
+    return;
+  }
+  lastTryWatched = true;
+  process4.once("exit", () => {
+    for (const path of [...waiting, ...atExit]) {
+      try {
+        remove(path);
+      } catch {}
+    }
+  });
+}
+
+// src/junit.ts
+var ESCAPE = String.fromCharCode(27);
+var LOCATION = `'[^'\\n]*' in \\S+:\\d+`;
+var IGNORING_CASE = " \\(ignoring case\\)";
+var PRINTED_ACTUAL = new RegExp(` but was\\n '((?:(?!\\tat ${LOCATION})[\\s\\S])*?)'((?:${ESCAPE}\\[[0-9;]*m)*)(${IGNORING_CASE})?((?:${ESCAPE}\\[[0-9;]*m)*)\\tat (${LOCATION})`, "g");
+var QUOTED_EQUALITY = new RegExp(`^Expecting(?: error message)?:\\n '([\\s\\S]*)'\\n but was\\n '([\\s\\S]*)'(?:${IGNORING_CASE})?\\n\\tat `);
+var COLOUR = new RegExp(`${ESCAPE}\\[([0-9;]*)m`, "g");
+
+// src/answer-json.ts
+var SCALAR = String.raw`(?:-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?|true|false|null)`;
+var SCALAR_ARRAY = new RegExp(String.raw`\[\n\s+(${SCALAR}(?:,\n\s+${SCALAR})*)\n\s*\]`, "g");
+
+// src/resources.ts
+var STATIC_RESOURCES = [
+  {
+    uri: "godot://project/info",
+    name: "Project Info",
+    description: "Parsed Godot project.godot metadata as JSON.",
+    mimeType: "application/json"
+  }
+];
+var RESOURCE_TEMPLATES = [
+  {
+    uriTemplate: "godot://scene/{path}",
+    name: "Scene File",
+    description: "Read a Godot scene (.tscn) file from the current project.",
+    mimeType: "text/plain"
+  },
+  {
+    uriTemplate: "godot://script/{path}",
+    name: "GDScript File",
+    description: "Read a GDScript (.gd) file from the current project.",
+    mimeType: "text/x-gdscript"
+  },
+  {
+    uriTemplate: "godot://resource/{path}",
+    name: "Resource File",
+    description: "Read a project resource file (.tres, .tscn, .gd).",
+    mimeType: "text/plain"
+  }
+];
+var RESOURCE_COUNT = STATIC_RESOURCES.length + RESOURCE_TEMPLATES.length;
+function isValueComplete(value) {
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  for (const character of value) {
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (character === "\\") {
+      escaped = true;
+      continue;
+    }
+    if (character === '"') {
+      inString = !inString;
+      continue;
+    }
+    if (inString) {
+      continue;
+    }
+    if (character === "{" || character === "[" || character === "(") {
+      depth += 1;
+    } else if (character === "}" || character === "]" || character === ")") {
+      depth -= 1;
+    }
+  }
+  return depth <= 0 && !inString;
+}
+function parseProjectGodot(content) {
+  const result = emptyRecord();
+  let section = emptyRecord();
+  result["root"] = section;
+  const lines = content.split(/\r?\n/);
+  for (let index = 0;index < lines.length; index += 1) {
+    const line = (lines[index] ?? "").trim();
+    if (!line || line.startsWith(";") || line.startsWith("#")) {
+      continue;
+    }
+    if (line.startsWith("[") && line.endsWith("]")) {
+      const name = line.slice(1, -1).trim();
+      section = result[name] ?? emptyRecord();
+      result[name] = section;
+      continue;
+    }
+    const eqIndex = line.indexOf("=");
+    if (eqIndex === -1) {
+      continue;
+    }
+    const key = line.slice(0, eqIndex).trim();
+    let rawValue = line.slice(eqIndex + 1).trim();
+    while (index + 1 < lines.length && !isValueComplete(rawValue)) {
+      index += 1;
+      rawValue += `
+${(lines[index] ?? "").trim()}`;
+    }
+    section[key] = parseIniLikeValue(rawValue);
+  }
+  return result;
+}
+function parseIniLikeValue(value) {
+  if (value === "null") {
+    return null;
+  }
+  if (value === "true") {
+    return true;
+  }
+  if (value === "false") {
+    return false;
+  }
+  if (/^-?\d+$/.test(value)) {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isSafeInteger(parsed) ? parsed : value;
+  }
+  if (/^-?\d*\.\d+$/.test(value)) {
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) ? parsed : value;
+  }
+  if (value.length >= 2 && (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'"))) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+
+// src/server-version.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+
+// src/update-check.ts
+var CACHE_MS = 10 * 60 * 1000;
+var MAX_BODY_BYTES = 1 << 20;
+var MAX_RETRY_MS = 60 * 60 * 1000;
+
+// src/server-version.ts
+var DEBUG_MODE = process.env["GDHARNESS_DEBUG"] === "1";
+var SERVER_VERSION = (() => {
+  try {
+    const pkg = JSON.parse(readFileSync2(new URL("../package.json", import.meta.url), "utf8"));
+    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+})();
+
+// src/setup.ts
+function shippedAddonsDirectory() {
+  return join4(dirname2(fileURLToPath(import.meta.url)), "godot", "addons");
+}
+
+// src/game-debugger.ts
+var PAUSE_MS = 30000;
+var STEP_MS = 1e4;
+var ADDON_FRAMES = 5;
+var ADDON_LINES = 200;
+var RUNTIME_ADDON = "res://addons/gdharness_runtime/";
+var RUNTIME_AUTOLOAD = `${RUNTIME_ADDON}runtime_autoload.gd`;
+var frameEnd = null;
+function frameEndLine() {
+  if (frameEnd === null) {
+    const lines = readFileSync3(join5(shippedAddonsDirectory(), "gdharness_runtime", "runtime_autoload.gd"), "utf8").split(`
+`);
+    const declared = lines.findIndex((line) => line.startsWith("func _notification("));
+    if (declared === -1) {
+      throw new Error(`The shipped ${RUNTIME_AUTOLOAD} declares no _notification.`);
+    }
+    frameEnd = declared + 2;
+  }
+  return frameEnd;
+}
+var READ_MS = 5000;
+var REPLIES = new Set([
+  "debug_enter",
+  "debug_exit",
+  "stack_dump",
+  "stack_frame_vars",
+  "stack_frame_var",
+  "evaluation_return",
+  "scene:inspect_object"
+]);
+var INBOX_KEPT = 1e4;
+var OUTPUT_KEPT = 1000;
+var TYPE_NAMES = [
+  "Nil",
+  "bool",
+  "int",
+  "float",
+  "String",
+  "Vector2",
+  "Vector2i",
+  "Rect2",
+  "Rect2i",
+  "Vector3",
+  "Vector3i",
+  "Transform2D",
+  "Vector4",
+  "Vector4i",
+  "Plane",
+  "Quaternion",
+  "AABB",
+  "Basis",
+  "Transform3D",
+  "Projection",
+  "Color",
+  "StringName",
+  "NodePath",
+  "RID",
+  "Object",
+  "Callable",
+  "Signal",
+  "Dictionary",
+  "Array",
+  "PackedByteArray",
+  "PackedInt32Array",
+  "PackedInt64Array",
+  "PackedFloat32Array",
+  "PackedFloat64Array",
+  "PackedStringArray",
+  "PackedVector2Array",
+  "PackedVector3Array",
+  "PackedColorArray",
+  "PackedVector4Array"
+];
+var SCOPES = ["Locals", "Members", "Globals"];
+var ELEMENTS_SHOWN = 20;
+function isList(value) {
+  return Array.isArray(value);
+}
+function shownValue(value, typeHint = "") {
+  if (value === null) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (isList(value)) {
+    const shown = value.slice(0, ELEMENTS_SHOWN).map((each) => shownValue(each));
+    const more = value.length - shown.length;
+    return `[${shown.join(", ")}${more > 0 ? `, and ${more} more` : ""}]`;
+  }
+  if (value.kind === "dictionary" && "entries" in value) {
+    const shown = value.entries.slice(0, ELEMENTS_SHOWN).map(([key, each]) => `${shownValue(key)}: ${shownValue(each)}`);
+    const more = value.entries.length - shown.length;
+    return `{${shown.join(", ")}${more > 0 ? `, and ${more} more` : ""}}`;
+  }
+  if (!("values" in value)) {
+    return value.kind;
+  }
+  if (value.kind === "Object") {
+    return `<${typeHint === "" ? "Object" : typeHint}#${String(value.values[0])}>`;
+  }
+  return `${value.kind}(${value.values.join(", ")})`;
+}
+function typeNamed(type, hint) {
+  if (typeof hint === "string" && hint !== "") {
+    return hint;
+  }
+  return typeof type === "number" ? TYPE_NAMES[type] ?? String(type) : "Variant";
+}
+function framesOf(data) {
+  const frames = [];
+  for (let at = 1;at + 2 < data.length; at += 3) {
+    const [script, line, name] = [data[at], data[at + 1], data[at + 2]];
+    if (typeof script !== "string" || typeof line !== "number" || typeof name !== "string") {
+      break;
+    }
+    frames.push({ id: frames.length, name, line, script });
+  }
+  return frames;
+}
+
+class GameDebugger {
+  connection = null;
+  held = null;
+  ended = false;
+  waiters = [];
+  inbox = [];
+  onClosed = [];
+  output = [];
+  outputDropped = 0;
+  queue = Promise.resolve();
+  server;
+  port;
+  breakpoints;
+  breakpointLines;
+  observers;
+  constructor(server, port, breakpoints, observers) {
+    this.server = server;
+    this.port = port;
+    this.breakpoints = breakpoints;
+    this.breakpointLines = new Set(breakpoints);
+    this.observers = observers;
+  }
+  static async open(breakpoints, observers = []) {
+    const server = createServer();
+    await new Promise((resolve, reject) => {
+      server.once("error", reject);
+      server.listen(0, "127.0.0.1", () => {
+        resolve();
+      });
+    });
+    const address = server.address();
+    if (address === null || typeof address === "string") {
+      server.close();
+      throw new Error("the debugger has no port");
+    }
+    const peer = new GameDebugger(server, address.port, breakpoints, observers);
+    server.on("connection", (socket) => {
+      peer.accept(socket);
+    });
+    return peer;
+  }
+  get engineArguments() {
+    const listed = this.breakpoints.map((one) => one.replaceAll(" ", "%20")).join(",");
+    return [
+      "--remote-debug",
+      `tcp://127.0.0.1:${this.port}`,
+      "--ignore-error-breaks",
+      ...listed === "" ? [] : ["--breakpoints", listed]
+    ];
+  }
+  accept(socket) {
+    if (this.connection !== null) {
+      socket.destroy();
+      return;
+    }
+    this.connection = socket;
+    this.server.close();
+    const send = (message, data) => {
+      this.send(message, data);
+    };
+    for (const observer of this.observers) {
+      observer.connected(send);
+    }
+    const stream = new DebuggerStream;
+    socket.on("data", (chunk) => {
+      let messages;
+      try {
+        messages = stream.push(chunk);
+      } catch {
+        socket.destroy();
+        return;
+      }
+      for (const received of messages) {
+        if ("message" in received) {
+          this.take(received);
+          for (const observer of this.observers) {
+            observer.message(received, send);
+          }
+        }
+      }
     });
     socket.on("error", () => {
       return;
@@ -1010,8 +1507,13 @@ class GameDebugger {
     }
     switch (request.op) {
       case "breakpoint":
+        if (request.set) {
+          this.breakpointLines.add(`${request.script}:${String(request.line)}`);
+        } else {
+          this.breakpointLines.delete(`${request.script}:${String(request.line)}`);
+        }
         this.send("breakpoint", [request.script, request.line, request.set], this.held?.thread ?? MAIN_THREAD);
-        return { sent: true };
+        return { sent: true, taken: await this.taken() };
       case "pause":
         return await this.pause();
       case "resume":
@@ -1031,6 +1533,8 @@ class GameDebugger {
       }
       case "variables":
         return await this.variables(request.frame);
+      case "evaluate":
+        return await this.evaluate(request.frame, request.expression);
       default:
         return { refused: `Nothing here answers ${JSON.stringify(request)}.` };
     }
@@ -1087,30 +1591,77 @@ class GameDebugger {
         };
       }
     }
-    let frames = await this.stack();
-    const stepping = Date.now();
-    while (frames !== null && this.held !== null && (frames[0]?.script.startsWith(RUNTIME_ADDON) ?? false) && Date.now() - stepping < ADDON_STEP_MS) {
-      this.forget("debug_enter");
-      this.send("step", [], this.held.thread);
-      if (await this.next(GameDebugger.named("debug_enter"), STEP_MS) === null) {
-        return {
-          paused: false,
-          note: `The game stopped in gdharness's runtime addon and was stepped on to reach its own script, and did not stop again within ${STEP_MS / 1000}s. It stops at the next line of script it runs; debug_state stack reads it then.`
-        };
-      }
-      frames = await this.stack();
+    const past = await this.pastTheAddon();
+    if (past === "lost") {
+      return {
+        paused: false,
+        note: `The game stopped in gdharness's runtime addon and was let go on to reach its own script, and did not stop again within ${STEP_MS / 1000}s. It stops at the next line of script it runs; debug_state stack reads it then.`
+      };
     }
     this.stoppedBy("Paused");
-    const stack = frames ?? [];
+    const stack = past.frames ?? [];
     return {
       paused: true,
       held: this.heldState(),
       stack,
-      ...stack[0]?.script.startsWith(RUNTIME_ADDON) === true ? {
-        note: `The game is held in gdharness's runtime addon, whose _process runs first in every frame: ${ADDON_STEP_MS / 1000}s of stepping reached no line of the game's own script, so it runs none from frame to frame. A breakpoint in the game's script stops it there.`
+      ...past.gaveUp === "frames" ? {
+        note: `The game is held in gdharness's runtime addon, whose _process runs first in every frame: ${ADDON_FRAMES} frames went by without a line of the game's own script, so it runs none from frame to frame. A breakpoint in the game's script stops it there.`
+      } : past.gaveUp === "lines" ? {
+        note: `The game is held in gdharness's runtime addon, which ran ${ADDON_LINES} lines outside its _process without reaching a line of the game's own script. debug_control step_over goes on from here, and a breakpoint in the game's script stops it there.`
       } : {}
     };
   }
+  async pastTheAddon(until) {
+    let frames = await this.stack();
+    let framesLeft = ADDON_FRAMES;
+    let linesLeft = ADDON_LINES;
+    while (frames !== null && this.held !== null && (frames[0]?.script.startsWith(RUNTIME_ADDON) ?? false)) {
+      if (until !== undefined && Date.now() >= until) {
+        return { frames, gaveUp: "time" };
+      }
+      if (frames.some((frame) => frame.script === RUNTIME_AUTOLOAD && frame.name === "_process")) {
+        if (until === undefined && framesLeft === 0) {
+          return { frames, gaveUp: "frames" };
+        }
+        framesLeft -= 1;
+        const reached = await this.toTheFrameEnd();
+        if (reached === "lost") {
+          return "lost";
+        }
+        frames = reached;
+        continue;
+      }
+      if (until === undefined && linesLeft === 0) {
+        return { frames, gaveUp: "lines" };
+      }
+      linesLeft -= 1;
+      this.forget("debug_enter");
+      this.send("step", [], this.held.thread);
+      if (await this.next(GameDebugger.named("debug_enter"), STEP_MS) === null) {
+        return "lost";
+      }
+      frames = await this.stack();
+    }
+    return { frames };
+  }
+  async toTheFrameEnd() {
+    const held = this.held;
+    if (held === null) {
+      return null;
+    }
+    const line = frameEndLine();
+    const theirs = this.breakpointLines.has(`${RUNTIME_AUTOLOAD}:${String(line)}`);
+    if (!theirs) {
+      this.send("breakpoint", [RUNTIME_AUTOLOAD, line, true], held.thread);
+    }
+    this.forget("debug_enter");
+    this.send("continue", [], held.thread);
+    const stopped = await this.next(GameDebugger.named("debug_enter"), STEP_MS);
+    if (!theirs) {
+      this.send("breakpoint", [RUNTIME_AUTOLOAD, line, false], this.held?.thread ?? MAIN_THREAD);
+    }
+    return stopped === null ? "lost" : await this.stack();
+  }
   stoppedBy(cause) {
     if (this.held !== null) {
       this.held = { ...this.held, reason: cause };
@@ -1139,8 +1690,27 @@ class GameDebugger {
         note: `The game had not stopped again ${STEP_MS / 1000}s after the step: the step is still running, as one out of a function that never returns does, or it went on without reaching another line. debug_state stack answers once it stops, and debug_control pause stops it wherever it is.`
       };
     }
+    const past = await this.pastTheAddon(Date.now() + STEP_MS);
+    if (past === "lost") {
+      return {
+        stepped: true,
+        heldAgain: false,
+        note: `The step stopped in gdharness's runtime addon and was let go on to reach the game's own script, and did not stop again within ${STEP_MS / 1000}s. It stops at the next line of script the game runs; debug_state stack reads it then.`
+      };
+    }
     this.stoppedBy("Stepped");
-    return { stepped: true, heldAgain: true, held: this.heldState(), stack: await this.stack() ?? [] };
+    const stack = past.frames ?? [];
+    const top = stack[0];
+    const onBreakpoint = top !== undefined && this.breakpointLines.has(`${top.script}:${String(top.line)}`);
+    return {
+      stepped: true,
+      heldAgain: true,
+      held: { ...this.heldState(), ...onBreakpoint ? { onBreakpoint: true } : {} },
+      stack,
+      ...past.gaveUp === undefined ? {} : {
+        note: `The step went on through gdharness's runtime addon, whose _process runs first in every frame, for ${STEP_MS / 1000}s without the game running a line of its own script, and is held in the addon. debug_control continue lets the game go, and a breakpoint in its script stops it there.`
+      }
+    };
   }
   async variables(frame) {
     const held = this.held;
@@ -1151,10 +1721,9 @@ class GameDebugger {
     if (frames === null) {
       return { refused: `The game did not send its stack within ${READ_MS / 1000}s.` };
     }
-    if (frames.find((each) => each.id === frame) === undefined) {
-      return {
-        refused: frames.length === 0 ? "The game is held where no script runs, so it has no frames: debug_control step_over takes it to the next line of script." : `The stack has no frame ${frame}; its frames are ${frames.map((each) => each.id).join(", ")}.`
-      };
+    const missing = GameDebugger.noFrame(frames, frame);
+    if (missing !== null) {
+      return missing;
     }
     this.forget("stack_frame_vars");
     this.forget("stack_frame_var");
@@ -1178,15 +1747,66 @@ class GameDebugger {
         };
       }
       const [name, scope, type, value, hint] = one.data;
-      const into = scopes[typeof scope === "number" ? scope : 0];
-      into?.variables.push({
-        name: typeof name === "string" ? name : shownValue(name ?? null),
+      const named = typeof name === "string" ? name : shownValue(name ?? null);
+      if (named.startsWith("@")) {
+        continue;
+      }
+      scopes[typeof scope === "number" ? scope : 0]?.variables.push({
+        name: named,
         value: shownValue(value ?? null, typeof hint === "string" ? hint : ""),
-        type: typeof hint === "string" && hint !== "" ? hint : typeof type === "number" ? TYPE_NAMES[type] ?? String(type) : "Variant"
+        type: typeNamed(type, hint)
       });
     }
     return { held: this.heldState(), frame, scopes };
   }
+  async evaluate(frame, expression) {
+    const held = this.held;
+    if (held === null) {
+      return this.notHeld();
+    }
+    const read = await this.variables(frame);
+    if (!Array.isArray(read["scopes"])) {
+      return read;
+    }
+    const members = read["scopes"].find((scope) => scope.name === "Members");
+    if (members?.variables.some((variable) => variable.name === "self") !== true) {
+      return {
+        refused: `Frame ${frame} has no instance of its script to evaluate on, as a static function called on its class has none, and the engine lets the game go on rather than answer one there, so it was not asked. Evaluate in a frame below it, or read this one's locals with debug_state variables.`
+      };
+    }
+    this.forget("evaluation_return");
+    this.send("evaluate", [expression, frame], held.thread);
+    const answered = await this.next(GameDebugger.named("evaluation_return"), READ_MS);
+    if (answered === null || !("data" in answered)) {
+      return {
+        refused: `The game worked out nothing for ${expression} within ${READ_MS / 1000}s. Ask again.`
+      };
+    }
+    const [, , type, value, hint] = answered.data;
+    return {
+      held: this.heldState(),
+      frame,
+      expression,
+      value: shownValue(value ?? null, typeof hint === "string" ? hint : ""),
+      type: typeNamed(type, hint),
+      ...value === null || value === undefined ? {
+        note: "null is also what an expression comes to when it does not parse or fails as it runs. The game prints why as an error, which editor_output reads, since its debugger hands errors over apart from the console debug_state output keeps."
+      } : {}
+    };
+  }
+  async taken() {
+    this.forget("scene:inspect_object");
+    this.send("scene:inspect_object", [0], this.held?.thread ?? MAIN_THREAD);
+    return await this.next(GameDebugger.named("scene:inspect_object"), READ_MS) !== null;
+  }
+  static noFrame(frames, frame) {
+    if (frames.find((each) => each.id === frame) !== undefined) {
+      return null;
+    }
+    return {
+      refused: frames.length === 0 ? "The game is held where no script runs, so it has no frames: debug_control step_over takes it to the next line of script." : `The stack has no frame ${frame}; its frames are ${frames.map((each) => each.id).join(", ")}.`
+    };
+  }
   close() {
     this.connection?.destroy();
     this.server.close();
@@ -1195,11 +1815,11 @@ class GameDebugger {
 
 // src/keeper-channel.ts
 import { randomUUID } from "node:crypto";
-import { mkdtempSync as mkdtempSync2, rmSync as rmSync2 } from "node:fs";
+import { mkdtempSync as mkdtempSync3, rmSync as rmSync3 } from "node:fs";
 import { connect, createServer as createServer2 } from "node:net";
-import { tmpdir as tmpdir2 } from "node:os";
-import { join as join2 } from "node:path";
-import process4 from "node:process";
+import { tmpdir as tmpdir3 } from "node:os";
+import { join as join6 } from "node:path";
+import process5 from "node:process";
 var DEBUG_PREFIX = "debug ";
 function endedOrWhyNot(end) {
   try {
@@ -1226,8 +1846,8 @@ function errorText(error) {
 async function listenForTheServer(end, debug) {
   let directory = null;
   try {
-    directory = process4.platform === "win32" ? null : mkdtempSync2(join2(tmpdir2(), "gdharness-keeper-"));
-    const address = directory === null ? `\\\\.\\pipe\\gdharness-keeper-${randomUUID()}` : join2(directory, "keeper.sock");
+    directory = process5.platform === "win32" ? null : mkdtempSync3(join6(tmpdir3(), "gdharness-keeper-"));
+    const address = directory === null ? `\\\\.\\pipe\\gdharness-keeper-${randomUUID()}` : join6(directory, "keeper.sock");
     const server = createServer2((socket) => {
       socket.setEncoding("utf8");
       socket.on("error", () => {});
@@ -1263,13 +1883,13 @@ async function listenForTheServer(end, debug) {
       close: () => {
         server.close();
         if (made !== null) {
-          rmSync2(made, { recursive: true, force: true });
+          rmSync3(made, { recursive: true, force: true });
         }
       }
     };
   } catch {
     if (directory !== null) {
-      rmSync2(directory, { recursive: true, force: true });
+      rmSync3(directory, { recursive: true, force: true });
     }
     return null;
   }
@@ -1285,7 +1905,7 @@ function listening(server, address) {
 }
 
 // src/outside.ts
-import { fileURLToPath } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 function withChanges(base, changes) {
   const env = { ...base };
   for (const [name, value] of Object.entries(changes)) {
@@ -1307,7 +1927,7 @@ async function receivedSpec() {
   }
   return JSON.parse(Buffer.concat(chunks).toString("utf8"));
 }
-var KEEPER_SCRIPT = fileURLToPath(new URL("./keeper.js", import.meta.url));
+var KEEPER_SCRIPT = fileURLToPath2(new URL("./keeper.js", import.meta.url));
 function readLaunched(printed) {
   const line = printed.split(`
 `).find((one) => one.trim() !== "")?.trim() ?? "";
@@ -1320,28 +1940,12 @@ function readLaunched(printed) {
 
 // src/run-record.ts
 import { createHash as createHash2 } from "node:crypto";
-import { mkdirSync, openSync as openSync2, readdirSync, readFileSync as readFileSync2, rmSync as rmSync4, statSync as statSync3 } from "node:fs";
-import { basename as basename2, join as join5, resolve as resolve3 } from "node:path";
+import { mkdirSync, openSync as openSync2, readdirSync as readdirSync2, readFileSync as readFileSync5, rmSync as rmSync5, statSync as statSync3 } from "node:fs";
+import { basename as basename3, join as join8, resolve as resolve3 } from "node:path";
 
-// src/paths.ts
-import { realpathSync, statSync as statSync2 } from "node:fs";
-import { basename, dirname, isAbsolute, join as join3, relative, resolve, sep } from "node:path";
-function realAsFarAsItExists(path) {
-  const missing = [];
-  let at = path;
-  for (;; ) {
-    try {
-      return join3(realpathSync.native(at), ...missing);
-    } catch {
-      const parent = dirname(at);
-      if (parent === at) {
-        return path;
-      }
-      missing.unshift(basename(at));
-      at = parent;
-    }
-  }
-}
+// src/process-children.ts
+import { readFileSync as readFileSync4 } from "node:fs";
+import { basename as basename2 } from "node:path";
 
 // src/windows-ask.ts
 var SCRIPT = [
@@ -1356,473 +1960,307 @@ var SCRIPT = [
   "  } catch {",
   "    $said = $_.Exception.Message",
   '    $tag = "ERR"',
-  "  }",
-  '  [Console]::Out.Write($parts[0] + " " + $tag + " " + [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes($said)) + "`n")',
-  "  [Console]::Out.Flush()",
-  "}"
-].join(`
-`);
-
-// src/runtime-client.ts
-import { tmpdir as tmpdir3 } from "node:os";
-import { dirname as dirname2, join as join4, resolve as resolve2 } from "node:path";
-
-// src/launch.ts
-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",
-  "--write-movie": "file",
-  "--rendering-driver": "driver",
-  "--rendering-method": "method",
-  "--accessibility": "accessibility"
-});
-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) {
-  const explicit = envValue("GDHARNESS_RUNTIME_DIR", variables);
-  if (explicit) {
-    return explicit;
-  }
-  const perUser = envValue("XDG_RUNTIME_DIR", variables);
-  return join4(perUser ?? tmpdir3(), "gdharness");
-}
-var ERROR_REPORT_KEEP_MS = 60 * 60 * 1000;
-var verdicts = new Map;
-var LATE_ANSWER_MS = 30 * 60000;
-var lateAnswers = new Map;
-var untaken = new Map;
-
-// src/whole-file.ts
-import { renameSync, rmSync as rmSync3, 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 {
-          rmSync3(partial, { force: true });
-        } catch {}
-        return false;
-      }
-      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, HELD_FILE_RETRY_MS);
-    }
-  }
-}
-
-// src/run-record.ts
-function runsDirectory() {
-  return join5(runtimeDirectory(), "runs");
-}
-function projectKey(projectPath) {
-  const real = realAsFarAsItExists(resolve3(projectPath)).replace(/[\\/]+$/, "");
-  const folded = process.platform === "win32" || process.platform === "darwin" ? real.toLowerCase() : real;
-  return createHash2("sha256").update(folded.replaceAll("\\", "/")).digest("hex").slice(0, 16);
-}
-function runRecordPath(projectPath, directory = runtimeDirectory()) {
-  return join5(directory, "runs", `note-${projectKey(projectPath)}.json`);
-}
-function writeRunRecord(record) {
-  mkdirSync(runsDirectory(), { recursive: true });
-  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);
-  const record = recordAt(path);
-  if (record === null || record.pid !== pid) {
-    return;
-  }
-  const written = {
-    ...record,
-    ...ending.exitCode === null ? {} : { exitCode: ending.exitCode },
-    ...ending.exitSignal === null ? {} : { exitSignal: ending.exitSignal },
-    endedAt: Date.now()
-  };
-  writeWhole(path, JSON.stringify(written, null, 2));
-}
-function recordAt(path) {
-  let parsed;
-  try {
-    parsed = JSON.parse(readFileSync2(path, "utf8"));
-  } catch {
-    return null;
-  }
-  if (!parsed || typeof parsed !== "object") {
-    return null;
-  }
-  const fields = parsed;
-  const pid = fields["pid"];
-  const transcript = fields["transcript"];
-  const startedAt = fields["startedAt"];
-  if (typeof pid !== "number" || typeof transcript !== "string" || typeof startedAt !== "number") {
-    return null;
-  }
-  const args = fields["arguments"];
-  const startedBy = fields["startedBy"];
-  const projectPath = fields["projectPath"];
-  const command = fields["command"];
-  if (typeof startedBy !== "number" || typeof projectPath !== "string" || projectPath === "" || typeof command !== "string" || !Array.isArray(args)) {
-    return null;
-  }
-  return {
-    pid,
-    transcript,
-    startedAt,
-    startedBy,
-    projectPath,
-    ...typeof fields["servedBy"] === "string" && fields["servedBy"] !== "" ? { servedBy: fields["servedBy"] } : {},
-    ...typeof fields["keeper"] === "string" && fields["keeper"] !== "" ? { keeper: fields["keeper"] } : {},
-    ...typeof fields["profile"] === "string" && fields["profile"] !== "" ? { profile: fields["profile"] } : {},
-    arguments: args.filter((value) => typeof value === "string"),
-    command,
-    ...typeof fields["exitCode"] === "number" ? { exitCode: fields["exitCode"] } : {},
-    ...typeof fields["exitSignal"] === "string" ? { exitSignal: fields["exitSignal"] } : {},
-    ...typeof fields["endedAt"] === "number" ? { endedAt: fields["endedAt"] } : {}
-  };
-}
+  "  }",
+  '  [Console]::Out.Write($parts[0] + " " + $tag + " " + [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes($said)) + "`n")',
+  "  [Console]::Out.Flush()",
+  "}"
+].join(`
+`);
 
-// src/scratch.ts
-import { existsSync as existsSync2, mkdtempSync as mkdtempSync3, readdirSync as readdirSync2, rmSync as rmSync5 } from "node:fs";
-import { tmpdir as tmpdir4 } from "node:os";
-import { join as join6 } from "node:path";
-import process5 from "node:process";
-var SWEPT = { recursive: true, force: true };
-var AGAIN_AFTER_MS = [250, 500, 1000, 2000, 4000, 8000, 16000];
-var waiting = new Set;
-var atExit = new Set;
-function scratchDirectory(kind) {
-  return mkdtempSync3(join6(tmpdir4(), `gdharness-${kind}-${process5.pid}-`));
-}
-function discardWith(remove, paths) {
-  const left = [];
-  for (const path of paths) {
-    if (!path) {
+// src/process-children.ts
+async function linuxStartTimes(pids) {
+  const began = new Map;
+  const hertz = await ticksPerSecond();
+  let booted;
+  try {
+    booted = Number(/^btime\s+(\d+)$/m.exec(readFileSync4("/proc/stat", "utf8"))?.[1] ?? Number.NaN) * 1000;
+  } catch {
+    return began;
+  }
+  if (hertz === null || Number.isNaN(booted)) {
+    return began;
+  }
+  for (const pid of pids) {
+    let stat;
+    try {
+      stat = readFileSync4(`/proc/${String(pid)}/stat`, "utf8");
+    } catch {
       continue;
     }
-    try {
-      remove(path);
-    } catch (error) {
-      left.push({ path, reason: error instanceof Error ? error.message : String(error) });
+    const ticks = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[19]);
+    if (Number.isInteger(ticks) && ticks >= 0) {
+      began.set(pid, booted + Math.round(ticks * 1000 / hertz));
     }
   }
-  return left;
+  return began;
 }
-function discard(...paths) {
-  const left = discardWith(remove, paths);
-  for (const { path } of left) {
-    tryAgain(path, 0);
+var ticksAnswered;
+async function ticksPerSecond() {
+  if (ticksAnswered !== undefined) {
+    return ticksAnswered;
   }
-  return left;
-}
-function remove(path) {
-  rmSync5(path, SWEPT);
-}
-function tryAgain(path, attempt) {
-  if (attempt === 0) {
-    if (waiting.has(path)) {
-      return;
+  try {
+    const hertz = Number((await runHidden("getconf", ["CLK_TCK"], { timeout: ASK_TIMEOUT_MS })).stdout.trim());
+    if (Number.isInteger(hertz) && hertz > 0) {
+      ticksAnswered = hertz;
+      return hertz;
     }
-    waiting.add(path);
-    atExit.delete(path);
-    lastTryOnExit();
-  }
-  const after = AGAIN_AFTER_MS[attempt];
-  if (after === undefined || !existsSync2(path)) {
-    waiting.delete(path);
-    if (after === undefined) {
-      atExit.add(path);
+  } catch {}
+  return null;
+}
+var ASK_TIMEOUT_MS = 15000;
+var ONE_SHOT_OPTIONS = [
+  "--import",
+  "--quit",
+  "--quit-after",
+  "--export-release",
+  "--export-debug",
+  "--export-pack",
+  "--export-patch",
+  "--doctool",
+  "--gdscript-docs",
+  "--script",
+  "-s",
+  "--check-only",
+  "--build-solutions",
+  "--dump-gdextension-interface",
+  "--dump-extension-api",
+  "--dump-extension-api-with-docs",
+  "--validate-extension-api",
+  "--convert-3to4",
+  "--validate-conversion-3to4"
+];
+function readCommandLine(command) {
+  const all = commandWords(command);
+  const separator = all.findIndex((word) => word === "--" || word === "++");
+  const words = separator === -1 ? all : all.slice(0, separator);
+  const executable = words[0] === undefined ? "" : basename2(words[0].replaceAll("\\", "/"));
+  const at = words.indexOf("--path");
+  let projectPath = null;
+  if (at !== -1 && at + 1 < words.length) {
+    const taken = [];
+    for (const word of words.slice(at + 1)) {
+      if (taken.length > 0 && (word.startsWith("-") || /^[a-z]+:\/\//.test(word))) {
+        break;
+      }
+      taken.push(word);
     }
-    return;
+    projectPath = taken.join(" ").replaceAll("%20", " ");
   }
-  setTimeout(() => {
-    try {
-      remove(path);
-      waiting.delete(path);
-    } catch {
-      tryAgain(path, attempt + 1);
-    }
-  }, after).unref();
+  return {
+    executable,
+    projectPath,
+    editor: words.some((word) => word === "-e" || word === "--editor"),
+    oneShot: words.find((word) => ONE_SHOT_OPTIONS.includes(word)) ?? null
+  };
 }
-var lastTryWatched = false;
-function lastTryOnExit() {
-  if (lastTryWatched) {
-    return;
-  }
-  lastTryWatched = true;
-  process5.once("exit", () => {
-    for (const path of [...waiting, ...atExit]) {
-      try {
-        remove(path);
-      } catch {}
+function commandWords(command) {
+  const words = [];
+  let word = "";
+  let quoted = false;
+  let started = false;
+  for (const char of command) {
+    if (char === '"') {
+      quoted = !quoted;
+      started = true;
+    } else if (!quoted && /\s/.test(char)) {
+      if (started) {
+        words.push(word);
+        word = "";
+        started = false;
+      }
+    } else {
+      word += char;
+      started = true;
     }
-  });
+  }
+  if (started) {
+    words.push(word);
+  }
+  return words;
 }
 
-// src/gdscript-source.ts
-var DECLARING = new Set(["var", "const", "func", "signal", "enum", "class", "for", "class_name"]);
-var NAME = "[\\p{L}_][\\p{L}\\p{N}_]*";
-var ANNOTATIONS = "(?:@[\\p{L}_][\\p{L}\\p{N}_]*(?:\\([^)]*\\))?\\s+)*";
-var DECLARATION_LINE = new RegExp(`^(${ANNOTATIONS})(static\\s+)?(func|var|const|signal|enum|class)\\s+(${NAME})`, "u");
-var CLASS_NAME_LINE = new RegExp(`^${ANNOTATIONS}class_name\\s+(${NAME})`, "u");
-var EXTENDS_LINE = new RegExp(`^${ANNOTATIONS}(?:class_name\\s+${NAME}\\s+)?extends\\s`, "u");
-var FUNC_LINE = new RegExp(`^[ \\t]*${ANNOTATIONS}(?:static\\s+)?func\\s+(${NAME})\\s*\\(`, "u");
-var LAMBDA_HEADER = new RegExp(`(?<![\\p{L}\\p{N}_])func(?:\\s+${NAME})?\\s*\\(`, "u");
-var DOTTED = `${NAME}(?:\\.${NAME})*`;
-var MEMBER_KINDS = new Set(["var", "const", "signal", "enum", "enumValue"]);
-var KEYWORDS = new Set([
-  "and",
-  "as",
-  "assert",
-  "await",
-  "break",
-  "breakpoint",
-  "class",
-  "class_name",
-  "const",
-  "continue",
-  "elif",
-  "else",
-  "enum",
-  "extends",
-  "false",
-  "for",
-  "func",
-  "if",
-  "in",
-  "is",
-  "match",
-  "namespace",
-  "not",
-  "null",
-  "or",
-  "pass",
-  "preload",
-  "return",
-  "self",
-  "signal",
-  "static",
-  "super",
-  "trait",
-  "true",
-  "var",
-  "void",
-  "when",
-  "while",
-  "yield",
-  "INF",
-  "NAN",
-  "PI",
-  "TAU"
-]);
-
-// src/answer-json.ts
-var SCALAR = String.raw`(?:-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?|true|false|null)`;
-var SCALAR_ARRAY = new RegExp(String.raw`\[\n\s+(${SCALAR}(?:,\n\s+${SCALAR})*)\n\s*\]`, "g");
+// src/runtime-client.ts
+import { tmpdir as tmpdir4 } from "node:os";
+import { dirname as dirname3, join as join7, resolve as resolve2 } from "node:path";
 
-// src/dictionary.ts
-function emptyRecord() {
-  return Object.create(null);
+// src/launch.ts
+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",
+  "--write-movie": "file",
+  "--rendering-driver": "driver",
+  "--rendering-method": "method",
+  "--accessibility": "accessibility"
+});
+var SET_BY_ARGUMENT = Object.freeze({
+  "--headless": "headless",
+  "--audio-driver": "silent",
+  "--quit-after": "frames, on editor_run check"
+});
 
-// src/project-scan.ts
-var SKIPPED = new Set(["node_modules"]);
-var SCENE_EXTENSIONS = new Set(["tscn", "scn"]);
-var SIDECAR_EXTENSIONS = new Set(["import", "uid"]);
-var ASSET_EXTENSIONS = new Set([
-  "png",
-  "jpg",
-  "jpeg",
-  "webp",
-  "svg",
-  "bmp",
-  "tga",
-  "exr",
-  "hdr",
-  "ktx",
-  "dds",
-  "ttf",
-  "otf",
-  "woff",
-  "woff2",
-  "fnt",
-  "wav",
-  "mp3",
-  "ogg",
-  "glb",
-  "gltf",
-  "obj",
-  "fbx",
-  "blend",
-  "dae",
-  "ogv",
-  "gdshader",
-  "shader"
-]);
-var CARRIES_A_UID = new Set(["gd", "shader", "gdshader"]);
-var BINARY_EXTENSIONS = new Set([
-  ...[...ASSET_EXTENSIONS].filter((extension) => !["svg", "gltf", "gdshader", "shader", "fnt"].includes(extension)),
-  "scn",
-  "res",
-  "zip",
-  "pck",
-  "exe",
-  "dll",
-  "so",
-  "dylib"
-]);
-
-// src/resources.ts
-var STATIC_RESOURCES = [
-  {
-    uri: "godot://project/info",
-    name: "Project Info",
-    description: "Parsed Godot project.godot metadata as JSON.",
-    mimeType: "application/json"
-  }
-];
-var RESOURCE_TEMPLATES = [
-  {
-    uriTemplate: "godot://scene/{path}",
-    name: "Scene File",
-    description: "Read a Godot scene (.tscn) file from the current project.",
-    mimeType: "text/plain"
-  },
-  {
-    uriTemplate: "godot://script/{path}",
-    name: "GDScript File",
-    description: "Read a GDScript (.gd) file from the current project.",
-    mimeType: "text/x-gdscript"
-  },
-  {
-    uriTemplate: "godot://resource/{path}",
-    name: "Resource File",
-    description: "Read a project resource file (.tres, .tscn, .gd).",
-    mimeType: "text/plain"
+// src/runtime-client.ts
+function runtimeDirectory(variables = process.env) {
+  const explicit = envValue("GDHARNESS_RUNTIME_DIR", variables);
+  if (explicit) {
+    return explicit;
   }
-];
-var RESOURCE_COUNT = STATIC_RESOURCES.length + RESOURCE_TEMPLATES.length;
-function isValueComplete(value) {
-  let depth = 0;
-  let inString = false;
-  let escaped = false;
-  for (const character of value) {
-    if (escaped) {
-      escaped = false;
-      continue;
-    }
-    if (character === "\\") {
-      escaped = true;
-      continue;
-    }
-    if (character === '"') {
-      inString = !inString;
-      continue;
-    }
-    if (inString) {
-      continue;
-    }
-    if (character === "{" || character === "[" || character === "(") {
-      depth += 1;
-    } else if (character === "}" || character === "]" || character === ")") {
-      depth -= 1;
+  const perUser = envValue("XDG_RUNTIME_DIR", variables);
+  return join7(perUser ?? tmpdir4(), "gdharness");
+}
+var ERROR_REPORT_KEEP_MS = 60 * 60 * 1000;
+var verdicts = new Map;
+var LATE_ANSWER_MS = 30 * 60000;
+var lateAnswers = new Map;
+var untaken = new Map;
+
+// src/whole-file.ts
+import { renameSync, rmSync as rmSync4, 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 {
+          rmSync4(partial, { force: true });
+        } catch {}
+        return false;
+      }
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, HELD_FILE_RETRY_MS);
     }
   }
-  return depth <= 0 && !inString;
 }
-function parseProjectGodot(content) {
-  const result = emptyRecord();
-  let section = emptyRecord();
-  result["root"] = section;
-  const lines = content.split(/\r?\n/);
-  for (let index = 0;index < lines.length; index += 1) {
-    const line = (lines[index] ?? "").trim();
-    if (!line || line.startsWith(";") || line.startsWith("#")) {
-      continue;
-    }
-    if (line.startsWith("[") && line.endsWith("]")) {
-      const name = line.slice(1, -1).trim();
-      section = result[name] ?? emptyRecord();
-      result[name] = section;
-      continue;
-    }
-    const eqIndex = line.indexOf("=");
-    if (eqIndex === -1) {
-      continue;
-    }
-    const key = line.slice(0, eqIndex).trim();
-    let rawValue = line.slice(eqIndex + 1).trim();
-    while (index + 1 < lines.length && !isValueComplete(rawValue)) {
-      index += 1;
-      rawValue += `
-${(lines[index] ?? "").trim()}`;
-    }
-    section[key] = parseIniLikeValue(rawValue);
+
+// src/run-record.ts
+function runsDirectory() {
+  return join8(runtimeDirectory(), "runs");
+}
+function projectKey(projectPath) {
+  const real = realAsFarAsItExists(resolve3(projectPath)).replace(/[\\/]+$/, "");
+  const folded = process.platform === "win32" || process.platform === "darwin" ? real.toLowerCase() : real;
+  return createHash2("sha256").update(folded.replaceAll("\\", "/")).digest("hex").slice(0, 16);
+}
+function runRecordPath(projectPath, directory = runtimeDirectory()) {
+  return join8(directory, "runs", `note-${projectKey(projectPath)}.json`);
+}
+function writeRunRecord(record) {
+  mkdirSync(runsDirectory(), { recursive: true });
+  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}`);
   }
-  return result;
 }
-function parseIniLikeValue(value) {
-  if (value === "null") {
+function recordRunEnded(projectPath, pid, ending) {
+  const path = runRecordPath(projectPath);
+  const record = recordAt(path);
+  if (record === null || record.pid !== pid) {
+    return;
+  }
+  const { endingAt: _looked, ...kept } = record;
+  const written = {
+    ...kept,
+    ...ending.exitCode === null ? {} : { exitCode: ending.exitCode },
+    ...ending.exitSignal === null ? {} : { exitSignal: ending.exitSignal },
+    ...ending.notTold === true ? { exitNotTold: true } : {},
+    endedAt: Date.now()
+  };
+  writeWhole(path, JSON.stringify(written, null, 2));
+}
+function recordAt(path) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync5(path, "utf8"));
+  } catch {
     return null;
   }
-  if (value === "true") {
-    return true;
+  if (!parsed || typeof parsed !== "object") {
+    return null;
   }
-  if (value === "false") {
-    return false;
+  const fields = parsed;
+  const pid = fields["pid"];
+  const transcript = fields["transcript"];
+  const startedAt = fields["startedAt"];
+  if (typeof pid !== "number" || typeof transcript !== "string" || typeof startedAt !== "number") {
+    return null;
   }
-  if (/^-?\d+$/.test(value)) {
-    const parsed = Number.parseInt(value, 10);
-    return Number.isSafeInteger(parsed) ? parsed : value;
+  const args = fields["arguments"];
+  const startedBy = fields["startedBy"];
+  const projectPath = fields["projectPath"];
+  const command = fields["command"];
+  if (typeof startedBy !== "number" || typeof projectPath !== "string" || projectPath === "" || typeof command !== "string" || !Array.isArray(args)) {
+    return null;
   }
-  if (/^-?\d*\.\d+$/.test(value)) {
-    const parsed = Number.parseFloat(value);
-    return Number.isFinite(parsed) ? parsed : value;
+  return {
+    pid,
+    transcript,
+    startedAt,
+    startedBy,
+    projectPath,
+    ...typeof fields["servedBy"] === "string" && fields["servedBy"] !== "" ? { servedBy: fields["servedBy"] } : {},
+    ...typeof fields["keeper"] === "string" && fields["keeper"] !== "" ? { keeper: fields["keeper"] } : {},
+    ...typeof fields["keeperPid"] === "number" && Number.isInteger(fields["keeperPid"]) && fields["keeperPid"] > 0 ? { keeperPid: fields["keeperPid"] } : {},
+    ...typeof fields["profile"] === "string" && fields["profile"] !== "" ? { profile: fields["profile"] } : {},
+    arguments: args.filter((value) => typeof value === "string"),
+    command,
+    ...typeof fields["exitCode"] === "number" ? { exitCode: fields["exitCode"] } : {},
+    ...typeof fields["exitSignal"] === "string" ? { exitSignal: fields["exitSignal"] } : {},
+    ...typeof fields["endedAt"] === "number" ? { endedAt: fields["endedAt"] } : {},
+    ...fields["exitNotTold"] === true ? { exitNotTold: true } : {},
+    ...Array.isArray(fields["restartedFrom"]) ? { restartedFrom: fields["restartedFrom"].flatMap(restartedFromAt) } : {},
+    ...typeof fields["endingAt"] === "number" ? { endingAt: fields["endingAt"] } : {}
+  };
+}
+function restartedFromAt(value) {
+  if (!value || typeof value !== "object") {
+    return [];
   }
-  if (value.length >= 2 && (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'"))) {
-    return value.slice(1, -1);
+  const fields = value;
+  const { pid, endedAt, exitCode, exitSignal } = fields;
+  if (typeof pid !== "number" || typeof endedAt !== "number") {
+    return [];
   }
-  return value;
+  return [
+    {
+      pid,
+      endedAt,
+      ...typeof exitCode === "number" ? { exitCode } : {},
+      ...typeof exitSignal === "string" ? { exitSignal } : {}
+    }
+  ];
 }
 
 // src/script-profile.ts
@@ -1974,6 +2412,184 @@ class ProfileObserver {
   }
 }
 
+// src/successor.ts
+import { readlinkSync, realpathSync as realpathSync2 } from "node:fs";
+import { basename as basename4 } from "node:path";
+import { setTimeout as delay2 } from "node:timers/promises";
+var RESTARTED_WITHIN_MS = 2000;
+var LIST_WITHIN_MS = 15000;
+var POLL_MS = 250;
+function successorAmong(listed, exitedPid, engine, notBefore, exitedAt, secondsOnly) {
+  const slack = secondsOnly ? 1000 : 0;
+  const fold = (name) => process.platform === "win32" ? name.toLowerCase() : name;
+  const wanted = fold(basename4(engine.replaceAll("\\", "/")));
+  const found = listed.filter((one) => one.pid !== exitedPid && fold(readCommandLine(one.command).executable) === wanted && one.startedAt + slack >= notBefore && one.startedAt + slack >= exitedAt - RESTARTED_WITHIN_MS);
+  return found.length === 1 ? found[0] ?? null : null;
+}
+async function followSuccessor(exitedPid, engine, notBefore, exitedAt, transcript) {
+  if (process.platform === "win32") {
+    return await followOnWindows(exitedPid, engine, notBefore, exitedAt);
+  }
+  return transcript === undefined ? null : await followOnPosix(exitedPid, engine, notBefore, exitedAt, transcript);
+}
+async function followOnWindows(exitedPid, engine, notBefore, exitedAt) {
+  const script = [
+    "[Console]::OutputEncoding = [Text.Encoding]::UTF8",
+    "$held = @{}",
+    `foreach ($c in @(Get-CimInstance Win32_Process -Filter "ParentProcessId=${exitedPid}" -Property ProcessId,CreationDate,CommandLine)) {`,
+    "  if (-not $c.CreationDate) { continue }",
+    "  $began = ([DateTimeOffset]$c.CreationDate).ToUnixTimeMilliseconds()",
+    "  $p = Get-Process -Id $c.ProcessId -ErrorAction SilentlyContinue",
+    "  if ($null -eq $p -or [Math]::Abs(([DateTimeOffset]$p.StartTime).ToUnixTimeMilliseconds() - $began) -gt 1000) { continue }",
+    "  $null = $p.Handle",
+    "  $held[[int]$c.ProcessId] = $p",
+    '  "$($c.ProcessId) $began $($c.CommandLine)"',
+    "}",
+    "'listed'",
+    "$chosen = [Console]::In.ReadLine()",
+    "if ($chosen -and $held.ContainsKey([int]$chosen)) { $p = $held[[int]$chosen]; $p.WaitForExit(); 'exit ' + $p.ExitCode }"
+  ].join(`
+`);
+  const holder = spawnHidden("powershell.exe", [
+    "-NoProfile",
+    "-NonInteractive",
+    "-ExecutionPolicy",
+    "Bypass",
+    "-EncodedCommand",
+    Buffer.from(script, "utf16le").toString("base64")
+  ], { stdio: ["pipe", "pipe", "ignore"] });
+  let said = "";
+  const closed = new Promise((resolve) => {
+    holder.once("close", () => {
+      resolve();
+    });
+    holder.once("error", () => {
+      resolve();
+    });
+  });
+  const listed = await new Promise((resolve) => {
+    const timer = setTimeout(() => {
+      resolve(false);
+    }, LIST_WITHIN_MS);
+    holder.stdout.on("data", (chunk) => {
+      said += chunk.toString("utf8");
+      if (/^listed\r?$/m.test(said)) {
+        clearTimeout(timer);
+        resolve(true);
+      }
+    });
+    closed.then(() => {
+      clearTimeout(timer);
+      resolve(/^listed\r?$/m.test(said));
+    });
+  });
+  if (!listed) {
+    holder.kill();
+    return null;
+  }
+  const candidates = [];
+  for (const line of said.split(/\r?\n/)) {
+    const fields = /^(\d+)\s+(\d+)\s+(.*)$/.exec(line);
+    if (fields?.[1] !== undefined && fields[2] !== undefined && fields[3] !== undefined) {
+      candidates.push({ pid: Number(fields[1]), startedAt: Number(fields[2]), command: fields[3].trim() });
+    }
+  }
+  const successor = successorAmong(candidates, exitedPid, engine, notBefore, exitedAt, false);
+  holder.stdin.end(successor === null ? `
+` : `${String(successor.pid)}
+`);
+  if (successor === null) {
+    return null;
+  }
+  const ended = closed.then(() => {
+    const told = /^exit (-?\d+)\r?$/m.exec(said);
+    return { code: told?.[1] === undefined ? null : Number(told[1]) };
+  });
+  return { successor, ended };
+}
+async function followOnPosix(exitedPid, engine, notBefore, exitedAt, transcript) {
+  const linux = process.platform === "linux";
+  let printed;
+  try {
+    ({ stdout: printed } = await runHidden("ps", ["-e", "-o", linux ? "pid=,args=" : "pid=,lstart=,args="], {
+      timeout: LIST_WITHIN_MS,
+      maxBuffer: 16 * 1024 * 1024,
+      env: { ...process.env, LC_ALL: "C" }
+    }));
+  } catch {
+    return null;
+  }
+  const listed = [];
+  if (linux) {
+    const commands = new Map;
+    for (const line of printed.split(`
+`)) {
+      const fields = /^\s*(\d+)\s+(.*)$/.exec(line);
+      if (fields?.[1] !== undefined) {
+        commands.set(Number(fields[1]), (fields[2] ?? "").trim());
+      }
+    }
+    for (const [pid, startedAt] of await linuxStartTimes([...commands.keys()])) {
+      listed.push({ pid, startedAt, command: commands.get(pid) ?? "" });
+    }
+  } else {
+    for (const line of printed.split(`
+`)) {
+      const fields = /^\s*(\d+)\s+(\w+\s+\w+\s+\d+\s+[\d:]+\s+\d+)\s+(.*)$/.exec(line);
+      const startedAt = Date.parse(fields?.[2] ?? "");
+      if (fields?.[1] !== undefined && !Number.isNaN(startedAt)) {
+        listed.push({ pid: Number(fields[1]), startedAt, command: (fields[3] ?? "").trim() });
+      }
+    }
+  }
+  const timely = listed.filter((one) => successorAmong([one], exitedPid, engine, notBefore, exitedAt, true) !== null);
+  const ours = canonical(transcript);
+  const candidates = [];
+  for (const one of timely) {
+    const writing = await outputOf(one.pid);
+    if (writing !== null && canonical(writing) === ours) {
+      candidates.push(one);
+    }
+  }
+  const successor = successorAmong(candidates, exitedPid, engine, notBefore, exitedAt, true);
+  if (successor === null) {
+    return null;
+  }
+  const ended = (async () => {
+    while (alive(successor.pid)) {
+      await delay2(POLL_MS);
+    }
+    return { code: null };
+  })();
+  return { successor, ended };
+}
+async function outputOf(pid) {
+  if (process.platform === "linux") {
+    try {
+      return readlinkSync(`/proc/${String(pid)}/fd/1`);
+    } catch {
+      return null;
+    }
+  }
+  try {
+    const { stdout } = await runHidden("lsof", ["-a", "-p", String(pid), "-d", "1", "-Fn"], {
+      timeout: LIST_WITHIN_MS
+    });
+    const named = stdout.split(`
+`).find((line) => line.startsWith("n"));
+    return named === undefined ? null : named.slice(1);
+  } catch {
+    return null;
+  }
+}
+function canonical(path) {
+  try {
+    return realpathSync2(path);
+  } catch {
+    return path;
+  }
+}
+
 // src/keeper.ts
 async function startDirectly(spec, output, hidden, detached = true, errors = output, directory = process.cwd()) {
   return await new Promise((resolve) => {
@@ -1993,8 +2609,9 @@ async function startDirectly(spec, output, hidden, detached = true, errors = out
 }
 async function startThroughHelper(spec, output, stopFile) {
   const scratch = scratchDirectory("desktop");
-  const pidFile = join7(scratch, "pid");
-  const errorFile = join7(scratch, "error");
+  const pidFile = join9(scratch, "pid");
+  const errorFile = join9(scratch, "error");
+  const stepFile = join9(scratch, "step");
   const where = spec.desktop !== undefined ? `on the ${spec.desktop} desktop` : spec.noActivate === true ? "without activation" : "through the desktop helper";
   try {
     const compiled = await ensureHelperCompiled();
@@ -2002,10 +2619,11 @@ async function startThroughHelper(spec, output, stopFile) {
       return { error: `it could not be started ${where}: ${compiled}` };
     }
     const wrapper = throughHelper({ ...spec, directory: process.cwd() }, spec.command, spec.args, {
-      spec: join7(scratch, "spec.json"),
+      spec: join9(scratch, "spec.json"),
       pid: pidFile,
       error: errorFile,
-      stop: stopFile
+      stop: stopFile,
+      step: stepFile
     });
     const envChanges = spec.desktop === undefined ? spec.envChanges : { ...spec.envChanges, [DESKTOP_VARIABLE]: spec.desktop };
     const started = await startDirectly({ ...spec, command: wrapper.command, args: wrapper.args, envChanges }, output, true, false, "ignore", tmpdir5());
@@ -2017,18 +2635,20 @@ async function startThroughHelper(spec, output, stopFile) {
       exited.now = true;
     });
     for (let waited = 0;waited < DESKTOP_START_MS; waited += 50) {
-      const pid = existsSync3(pidFile) ? Number(readFileSync3(pidFile, "utf8").trim()) : Number.NaN;
+      const pid = existsSync3(pidFile) ? Number(readFileSync6(pidFile, "utf8").trim()) : Number.NaN;
       if (Number.isInteger(pid) && pid > 0) {
         return { child: started.child, pid };
       }
       if (exited.now) {
-        const why = existsSync3(errorFile) ? readFileSync3(errorFile, "utf8").trim() : "it exited saying nothing";
+        const why = helperFailure(errorFile) ?? "it exited saying nothing";
         return { error: `it could not be started ${where}: ${why}` };
       }
-      await delay2(50);
+      await delay3(50);
     }
     started.child.kill();
-    return { error: `it was not started ${where} within ${DESKTOP_START_MS} ms` };
+    return {
+      error: `it was not started ${where} within ${DESKTOP_START_MS} ms, and ${helperStep(stepFile)}`
+    };
   } finally {
     discard(scratch);
   }
@@ -2046,7 +2666,7 @@ function profiledBy(path, projectPath) {
   };
   let projectGodot = null;
   try {
-    projectGodot = readFileSync3(join7(projectPath, "project.godot"), "utf8");
+    projectGodot = readFileSync6(join9(projectPath, "project.godot"), "utf8");
   } catch {}
   const observer = new ProfileObserver((totals) => {
     const first = latest === null;
@@ -2147,11 +2767,14 @@ async function keep() {
   }
   const profiled = run?.profile === undefined ? null : profiledBy(run.profile, run.projectPath);
   const debuggerPeer = run === undefined || run.debugged === false ? null : await GameDebugger.open(run.breakpoints ?? [], profiled === null ? [] : [profiled.observer]);
-  const toStart = debuggerPeer === null ? spec : { ...spec, args: withEngineArguments(spec.args, debuggerPeer.engineArguments) };
+  const exitNotes = run === undefined ? null : mkdtempSync4(join9(tmpdir5(), "gdharness-exit-"));
+  const noted = exitNotes === null ? spec : { ...spec, envChanges: { ...spec.envChanges, [EXIT_NOTES_VARIABLE]: exitNotes } };
+  const toStart = debuggerPeer === null ? noted : { ...noted, args: withEngineArguments(noted.args, debuggerPeer.engineArguments) };
   const transcript = run === undefined ? "ignore" : openSync3(run.transcript, "a");
-  const own = run !== undefined && throughTheHelper(spec) ? mkdtempSync4(join7(tmpdir5(), "gdharness-stop-")) : null;
-  const stopFile = own === null ? "" : join7(own, "stop");
+  const own = run !== undefined && throughTheHelper(spec) ? mkdtempSync4(join9(tmpdir5(), "gdharness-stop-")) : null;
+  const stopFile = own === null ? "" : join9(own, "stop");
   let started;
+  const spawnedAt = Date.now();
   try {
     started = await startDetached(toStart, transcript, run === undefined, stopFile);
   } finally {
@@ -2172,6 +2795,7 @@ async function keep() {
     startedAt: run.startedAt,
     startedBy: Date.now(),
     projectPath: run.projectPath,
+    keeperPid: process.pid,
     ...run.servedBy === undefined ? {} : { servedBy: run.servedBy },
     ...run.profile === undefined ? {} : { profile: run.profile },
     arguments: toStart.args,
@@ -2182,13 +2806,18 @@ async function keep() {
   }
   const exited = exitOf(child);
   let listening = null;
+  let end = () => {
+    if (stopFile !== "") {
+      writeFileSync3(stopFile, "");
+      return "signalled";
+    }
+    return child.kill() ? "signalled" : "gone";
+  };
+  const asked = { stop: false };
   if (record !== null) {
     listening = await listenForTheServer(() => {
-      if (stopFile !== "") {
-        writeFileSync3(stopFile, "");
-        return "signalled";
-      }
-      return child.kill() ? "signalled" : "gone";
+      asked.stop = true;
+      return end();
     }, debuggerPeer === null ? null : (request) => debuggerPeer.ask(request));
     if (listening !== null) {
       writeNoteIfItCan({ ...record, keeper: listening.address });
@@ -2201,21 +2830,87 @@ async function keep() {
     process.stdout.end(`pid ${pid}
 `, resolve);
   });
-  const { code, signal } = await exited;
+  let { code, signal } = await exited;
+  let exitedAt = Date.now();
+  let note = record === null ? null : listening === null ? record : { ...record, keeper: listening.address };
+  if (note !== null) {
+    writeNoteIfItCan({ ...note, endingAt: exitedAt });
+  }
+  end = () => "gone";
+  let looked = note === null || restartSaid(exitNotes, pid) === false ? null : followSuccessor(pid, spec.command, spawnedAt, exitedAt, run?.transcript);
   if (debuggerPeer !== null) {
     await debuggerPeer.drained(DRAIN_MS);
   }
   profiled?.finish();
+  let carried = pid;
+  let notTold = false;
+  while (note !== null && looked !== null) {
+    const followed = await looked;
+    if (followed === null) {
+      break;
+    }
+    const next = followed.successor;
+    const before = {
+      pid: carried,
+      endedAt: exitedAt,
+      ...code === null ? {} : { exitCode: code },
+      ...code === null && signal !== null ? { exitSignal: signal } : {}
+    };
+    note = {
+      ...note,
+      pid: next.pid,
+      startedBy: next.startedAt,
+      restartedFrom: [...note.restartedFrom ?? [], before]
+    };
+    writeNoteIfItCan(note);
+    end = () => {
+      try {
+        process.kill(next.pid);
+        return "signalled";
+      } catch {
+        return "gone";
+      }
+    };
+    if (asked.stop) {
+      end();
+    }
+    const ended = await followed.ended;
+    carried = next.pid;
+    code = ended.code;
+    signal = null;
+    notTold = ended.code === null;
+    exitedAt = Date.now();
+    writeNoteIfItCan({ ...note, endingAt: exitedAt });
+    looked = restartSaid(exitNotes, next.pid) === false ? null : followSuccessor(next.pid, spec.command, next.startedAt, exitedAt, run?.transcript);
+  }
   if (run !== undefined) {
-    recordRunEnded(run.projectPath, pid, { exitCode: code, exitSignal: code === null ? signal : null });
+    recordRunEnded(run.projectPath, carried, {
+      exitCode: code,
+      exitSignal: code === null ? signal : null,
+      notTold
+    });
   }
   debuggerPeer?.close();
   listening?.close();
-  if (own !== null) {
-    rmSync6(own, { recursive: true, force: true });
+  for (const made of [own, exitNotes]) {
+    if (made !== null) {
+      rmSync6(made, { recursive: true, force: true });
+    }
   }
   process.exit(0);
 }
+var EXIT_NOTES_VARIABLE = "GDHARNESS_EXIT_NOTES";
+function restartSaid(notes, pid) {
+  if (notes === null) {
+    return null;
+  }
+  try {
+    const said = JSON.parse(readFileSync6(join9(notes, `exit-${String(pid)}.json`), "utf8"));
+    return typeof said === "object" && said !== null && "restart" in said && typeof said.restart === "boolean" ? said.restart : null;
+  } catch {
+    return null;
+  }
+}
 await letWindowsReportCrashes();
 var mode = process.argv[2];
 if (mode === "launch") {