gdharness 1.3.60 → 1.3.62

package/build/keeper.js

@@ -6946,13 +6946,20 @@ var require_public_api = __commonJS(function(exports) {
 });
 
 // src/keeper.ts
-import { closeSync as closeSync3, existsSync as existsSync4, mkdtempSync as mkdtempSync4, openSync as openSync4, readFileSync as readFileSync9, rmSync as rmSync7, writeFileSync as writeFileSync4 } from "node:fs";
+import { closeSync as closeSync3, existsSync as existsSync5, mkdtempSync as mkdtempSync4, openSync as openSync4, readFileSync as readFileSync10, rmSync as rmSync8, writeFileSync as writeFileSync5 } from "node:fs";
 import { tmpdir as tmpdir8 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 import { setTimeout as delay3 } from "node:timers/promises";
 
 // src/alive.ts
 import process2 from "node:process";
+
+// src/errors.ts
+function errorCode(error) {
+  return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : undefined;
+}
+
+// src/alive.ts
 function exitOf(child) {
   if (child.exitCode !== null || child.signalCode !== null) {
     return Promise.resolve({ code: child.exitCode, signal: child.signalCode });
@@ -6971,29 +6978,29 @@ function alive(pid) {
     process2.kill(pid, 0);
     return true;
   } catch (error) {
-    return error.code === "EPERM";
+    return errorCode(error) === "EPERM";
   }
 }
 
 // src/desktop.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 
 // src/compiled-helper.ts
 import { createHash } from "node:crypto";
 import {
   closeSync,
-  existsSync,
+  existsSync as existsSync2,
   mkdtempSync,
   openSync,
-  readFileSync,
-  rmSync,
+  readFileSync as readFileSync2,
+  rmSync as rmSync2,
   statSync,
-  writeFileSync,
+  writeFileSync as writeFileSync2,
   writeSync
 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join } from "node:path";
+import { join as join2 } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
 
 // src/spawn.ts
@@ -7003,13 +7010,241 @@ import {
   spawn,
   spawnSync
 } from "node:child_process";
+
+// src/uid-cache.ts
+import {
+  existsSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+var CACHE = join(".godot", "uid_cache.bin");
+var RES = "res://";
+var UID = "uid://";
+var NOTHING = { moved: [], dropped: [] };
+function uidCacheEntries(data) {
+  if (data.length < 4) {
+    return null;
+  }
+  const count = data.readUInt32LE(0);
+  const paths = new Map;
+  let at = 4;
+  for (let entry = 0;entry < count; entry++) {
+    if (at + 12 > data.length) {
+      return null;
+    }
+    const id = data.readBigUInt64LE(at);
+    const length = data.readUInt32LE(at + 8);
+    at += 12;
+    if (at + length > data.length) {
+      return null;
+    }
+    paths.set(id, data.toString("utf8", at, at + length));
+    at += length;
+  }
+  return [...paths];
+}
+function encodedUidCache(entries) {
+  const parts = [Buffer.alloc(4)];
+  parts[0]?.writeUInt32LE(entries.length, 0);
+  for (const [id, path] of entries) {
+    const named = Buffer.from(path, "utf8");
+    const head = Buffer.alloc(12);
+    head.writeBigUInt64LE(id, 0);
+    head.writeUInt32LE(named.length, 8);
+    parts.push(head, named);
+  }
+  return Buffer.concat(parts);
+}
+function uidOfText(text) {
+  if (!text.startsWith(UID) || text.length === UID.length) {
+    return null;
+  }
+  let id = 0n;
+  for (const character of text.slice(UID.length)) {
+    const code = character.charCodeAt(0);
+    let digit;
+    if (code >= 97 && code <= 122) {
+      digit = code - 97;
+    } else if (code >= 48 && code <= 57) {
+      digit = code - 48 + 25;
+    } else {
+      return null;
+    }
+    id = id * 34n + BigInt(digit);
+  }
+  return id & 0x7fffffffffffffffn;
+}
+function presenceIn(projectPath) {
+  const listed = new Map;
+  return (path) => {
+    const inside = path.slice(RES.length);
+    const slash = inside.lastIndexOf("/");
+    const folder = slash < 0 ? "" : inside.slice(0, slash);
+    let names = listed.get(folder);
+    if (names === undefined) {
+      try {
+        names = new Set(readdirSync(join(projectPath, folder)));
+      } catch {
+        names = new Set;
+      }
+      listed.set(folder, names);
+    }
+    return names.has(inside.slice(slash + 1));
+  };
+}
+var IMPORT_UID = /^uid="(uid:\/\/[^"]*)"/m;
+var HEADER_UID = /^\[gd_(?:scene|resource)\b[^\]\n]*\buid="(uid:\/\/[^"]*)"/;
+function declared(path, name) {
+  const read = () => {
+    try {
+      return readFileSync(path, "utf8");
+    } catch {
+      return null;
+    }
+  };
+  if (name.endsWith(".uid")) {
+    const text = read()?.trim();
+    return text === undefined ? null : [text, name.slice(0, -".uid".length)];
+  }
+  const pattern = name.endsWith(".import") ? IMPORT_UID : name.endsWith(".tscn") || name.endsWith(".tres") ? HEADER_UID : null;
+  const text = pattern === null ? undefined : read()?.match(pattern)?.[1];
+  if (text === undefined) {
+    return null;
+  }
+  return [text, name.endsWith(".import") ? name.slice(0, -".import".length) : name];
+}
+function declaringFiles(projectPath, wanted) {
+  const found = new Map;
+  const visit = (directory, prefix) => {
+    let entries;
+    try {
+      entries = readdirSync(directory, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    if (entries.some((entry) => entry.name === ".gdignore")) {
+      return;
+    }
+    for (const entry of entries) {
+      if (found.size === wanted.size) {
+        return;
+      }
+      if (entry.name.startsWith(".")) {
+        continue;
+      }
+      const path = join(directory, entry.name);
+      const spelled = `${prefix}${entry.name}`;
+      if (entry.isDirectory()) {
+        visit(path, `${spelled}/`);
+        continue;
+      }
+      const declaration = entry.isFile() ? declared(path, spelled) : null;
+      const id = declaration === null ? null : uidOfText(declaration[0]);
+      if (declaration !== null && id !== null && wanted.has(id) && !found.has(id)) {
+        found.set(id, `${RES}${declaration[1]}`);
+      }
+    }
+  };
+  visit(projectPath, "");
+  return found;
+}
+function mendUidCache(projectPath) {
+  const cache = join(projectPath, CACHE);
+  let data;
+  try {
+    data = readFileSync(cache);
+  } catch {
+    return NOTHING;
+  }
+  const entries = uidCacheEntries(data);
+  if (entries === null) {
+    return NOTHING;
+  }
+  const present = presenceIn(projectPath);
+  const gone = entries.filter(([, path]) => path.startsWith(RES) && !present(path));
+  if (gone.length === 0) {
+    return NOTHING;
+  }
+  const goneIds = new Set(gone.map(([id]) => id));
+  const now = declaringFiles(projectPath, goneIds);
+  const moved = [];
+  const dropped = [];
+  for (const [id, path] of gone) {
+    const to = now.get(id);
+    if (to === undefined) {
+      dropped.push([id, path]);
+    } else {
+      moved.push([id, path, to]);
+    }
+  }
+  const written = `${cache}.${String(process.pid)}.mending`;
+  const kept = entries.flatMap(([id, path]) => {
+    if (!goneIds.has(id)) {
+      return [[id, path]];
+    }
+    const to = now.get(id);
+    return to === undefined ? [] : [[id, to]];
+  });
+  writeFileSync(written, encodedUidCache(kept));
+  try {
+    renameSync(written, cache);
+  } catch (error) {
+    rmSync(written, { force: true });
+    throw error;
+  }
+  return { moved, dropped };
+}
+function projectStarted(args, cwd) {
+  const at = args.indexOf("--path");
+  const named = at < 0 ? undefined : args[at + 1];
+  if (named === undefined) {
+    return null;
+  }
+  const from = cwd === undefined ? process.cwd() : cwd instanceof URL ? fileURLToPath(cwd) : cwd;
+  const project = isAbsolute(named) ? named : resolve(from, named);
+  return existsSync(join(project, "project.godot")) ? project : null;
+}
+function mendBeforeStart(args, cwd) {
+  const project = projectStarted(args, cwd);
+  if (project === null) {
+    return;
+  }
+  const where = join(project, CACHE);
+  try {
+    const { moved, dropped } = mendUidCache(project);
+    if (moved.length > 0) {
+      const named = moved.map(([, from, to]) => `${from} to ${to}`).join(", ");
+      process.stderr.write(`uid cache: moved what names a file gone in ${where}: ${named}
+`);
+    }
+    if (dropped.length > 0) {
+      const named = dropped.map(([, path]) => path).join(", ");
+      process.stderr.write(`uid cache: dropped what names a file gone from ${where}: ${named}
+`);
+    }
+  } catch (error) {
+    const said = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`uid cache: could not rewrite ${where}, which names files gone: ${said}
+`);
+  }
+}
+
+// src/spawn.ts
 function spawnHidden(command, args, options = {}) {
+  mendBeforeStart(args, options.cwd);
   return spawn(command, [...args], { ...options, windowsHide: true });
 }
 function spawnShown(command, args, options = {}) {
+  mendBeforeStart(args, options.cwd);
   return spawn(command, [...args], { ...options, windowsHide: false });
 }
 function runHidden(command, args, options = {}) {
+  mendBeforeStart(args, options.cwd ?? undefined);
   return new Promise((resolve, reject) => {
     execFile(command, [...args], { ...options, encoding: "utf8", windowsHide: true }, (error, stdout, stderr) => {
       if (error !== null) {
@@ -7037,14 +7272,14 @@ class CompiledHelper {
     this.digest = createHash("sha256").update(source).digest("hex").slice(0, 16);
   }
   assembly(directory = tmpdir()) {
-    return join(directory, `${this.file}-${this.digest}.dll`);
+    return join2(directory, `${this.file}-${this.digest}.dll`);
   }
   async ensure(directory = tmpdir(), budgetMs = HELPER_COMPILE_MS, wait = true) {
     const assembly = this.assembly(directory);
     const lock = `${assembly}.compiling`;
     const until = Date.now() + budgetMs;
     while (Date.now() < until) {
-      if (existsSync(assembly)) {
+      if (existsSync2(assembly)) {
         return null;
       }
       let mine = false;
@@ -7058,14 +7293,14 @@ class CompiledHelper {
         try {
           return await this.compile(directory, assembly, until - Date.now());
         } finally {
-          rmSync(lock, { force: true });
+          rmSync2(lock, { force: true });
         }
       }
       try {
-        const holder = Number(readFileSync(lock, "utf8").trim());
+        const holder = Number(readFileSync2(lock, "utf8").trim());
         const old = Date.now() - statSync(lock).mtimeMs > budgetMs;
         if (old || Number.isInteger(holder) && holder > 0 && !alive(holder)) {
-          rmSync(lock, { force: true });
+          rmSync2(lock, { force: true });
           continue;
         }
       } catch {}
@@ -7077,9 +7312,9 @@ class CompiledHelper {
     return `the ${this.named} was not compiled within ${String(budgetMs)} ms`;
   }
   async compile(directory, assembly, budgetMs) {
-    const scratch = mkdtempSync(join(directory, `${this.file}-source-`));
-    const source = join(scratch, "helper.cs");
-    writeFileSync(source, this.source, "utf8");
+    const scratch = mkdtempSync(join2(directory, `${this.file}-source-`));
+    const source = join2(scratch, "helper.cs");
+    writeFileSync2(source, this.source, "utf8");
     const literal = (path) => `'${path.replaceAll("'", "''")}'`;
     const script = [
       "$ErrorActionPreference = 'Stop'",
@@ -7116,11 +7351,11 @@ class CompiledHelper {
         });
         compiler.once("close", (code) => {
           clearTimeout(timer);
-          resolve(existsSync(assembly) ? null : `Windows PowerShell could not compile the ${this.named}${code === null ? " in time" : ""}: ${complained.trim() || `exit code ${String(code)}`}`);
+          resolve(existsSync2(assembly) ? null : `Windows PowerShell could not compile the ${this.named}${code === null ? " in time" : ""}: ${complained.trim() || `exit code ${String(code)}`}`);
         });
       });
     } finally {
-      rmSync(scratch, { recursive: true, force: true });
+      rmSync2(scratch, { recursive: true, force: true });
     }
   }
 }
@@ -7379,7 +7614,7 @@ function windowsCommandLine(command, args) {
 }
 function helperFailure(file) {
   try {
-    const said = readFileSync2(file, "utf8").trim();
+    const said = readFileSync3(file, "utf8").trim();
     return said === "" ? null : said;
   } catch {
     return null;
@@ -7388,11 +7623,12 @@ function helperFailure(file) {
 function helperStep(stepFile) {
   let step = null;
   try {
-    step = readFileSync2(stepFile, "utf8").trim();
+    step = readFileSync3(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()) {
+  mendBeforeStart(args, how.directory);
   const fields = [
     how.desktop ?? "",
     windowsCommandLine(command, args),
@@ -7403,7 +7639,7 @@ function throughHelper(how, command, args, files, assembly = helperAssembly()) {
     files.step,
     how.affinity === undefined ? "" : how.affinity.toString()
   ];
-  writeFileSync2(files.spec, fields.map((field) => Buffer.from(field, "utf8").toString("base64")).join(`
+  writeFileSync3(files.spec, fields.map((field) => Buffer.from(field, "utf8").toString("base64")).join(`
 `), "utf8");
   const literal = (path) => `'${path.replaceAll("'", "''")}'`;
   const script = [
@@ -7435,12 +7671,12 @@ function throughHelper(how, command, args, files, assembly = helperAssembly()) {
 // src/engine-slots.ts
 import {
   closeSync as closeSync2,
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   mkdirSync,
   openSync as openSync2,
-  readdirSync,
-  readFileSync as readFileSync5,
-  rmSync as rmSync3,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync6,
+  rmSync as rmSync4,
   statSync as statSync3,
   watch,
   writeSync as writeSync2
@@ -7486,18 +7722,19 @@ var buffered = "";
 var next = 1;
 var out = null;
 var queued = [];
+function holdOn(pipe, wanted) {
+  const call = Reflect.get(pipe, wanted ? "ref" : "unref");
+  if (typeof call === "function") {
+    Reflect.apply(call, pipe, []);
+  }
+}
 var held = false;
 function holding(child, wanted) {
   if (held === wanted) {
     return;
   }
   held = wanted;
-  const stdout = child.stdout;
-  if (wanted) {
-    stdout.ref?.();
-  } else {
-    stdout.unref?.();
-  }
+  holdOn(child.stdout, wanted);
 }
 function running() {
   if (helper?.exitCode === null && helper.signalCode === null) {
@@ -7539,8 +7776,8 @@ function running() {
   child.once("exit", gone);
   child.once("error", gone);
   child.unref();
-  child.stdin.unref?.();
-  child.stderr.unref?.();
+  holdOn(child.stdin, false);
+  holdOn(child.stderr, false);
   held = true;
   holding(child, false);
   helper = child;
@@ -7969,14 +8206,14 @@ async function loadingTheTable() {
   return `$null = [Reflection.Assembly]::LoadFrom('${TABLE.assembly().replaceAll("'", "''")}')`;
 }
 async function askProcessTable(call, withinMs) {
-  return askWindows(`${await loadingTheTable()}; [GdhProcessTable]::${call}`, withinMs);
+  return await askWindows(`${await loadingTheTable()}; [GdhProcessTable]::${call}`, withinMs);
 }
 
 // src/engine-spent.ts
 var watched = new Set;
 
 // src/harnesses.ts
-import { basename as basename2, dirname as dirname2, isAbsolute as isAbsolute2, join as join3, relative as relative2, resolve as resolve2 } from "node:path";
+import { basename as basename2, dirname as dirname2, isAbsolute as isAbsolute3, join as join4, relative as relative2, resolve as resolve3 } from "node:path";
 
 // node_modules/yaml/dist/index.js
 var composer = require_composer();
@@ -8026,13 +8263,13 @@ var $visitAsync = visit.visitAsync;
 
 // src/paths.ts
 import { realpathSync, statSync as statSync2 } from "node:fs";
-import { basename, dirname, isAbsolute, join as join2, relative, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute as isAbsolute2, join as join3, relative, resolve as resolve2, sep } from "node:path";
 function realAsFarAsItExists(path) {
   const missing = [];
   let at = path;
   for (;; ) {
     try {
-      return join2(realpathSync.native(at), ...missing);
+      return join3(realpathSync.native(at), ...missing);
     } catch {
       const parent = dirname(at);
       if (parent === at) {
@@ -8044,6 +8281,14 @@ function realAsFarAsItExists(path) {
   }
 }
 
+// src/records.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringList(value) {
+  return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+
 // src/harnesses.ts
 var SERVER_KEY = "gdharness";
 function tomlArray(values) {
@@ -8066,7 +8311,7 @@ var HARNESSES = [
     shape: "plain",
     home: ".claude",
     marker: ".claude",
-    skills: { dir: join3(".claude", "skills"), shared: false }
+    skills: { dir: join4(".claude", "skills"), shared: false }
   },
   {
     id: "copilot-cli",
@@ -8076,7 +8321,7 @@ var HARNESSES = [
     container: "mcpServers",
     shape: "plain",
     home: ".copilot",
-    skills: { dir: join3(".github", "skills"), shared: true },
+    skills: { dir: join4(".github", "skills"), shared: true },
     manual: "Trust the folder when Copilot CLI first asks, or it reads no config here."
   },
   {
@@ -8102,22 +8347,22 @@ var HARNESSES = [
     id: "cursor",
     name: "Cursor",
     scope: "project",
-    file: join3(".cursor", "mcp.json"),
+    file: join4(".cursor", "mcp.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".cursor",
-    skills: { dir: join3(".cursor", "skills"), shared: true },
+    skills: { dir: join4(".cursor", "skills"), shared: true },
     manual: "Cursor asks before each tool call by default, and the server can be toggled off."
   },
   {
     id: "vscode",
     name: "VS Code",
     scope: "project",
-    file: join3(".vscode", "mcp.json"),
+    file: join4(".vscode", "mcp.json"),
     container: "servers",
     shape: "typed",
     home: ".vscode",
-    skills: { dir: join3(".github", "skills"), shared: true },
+    skills: { dir: join4(".github", "skills"), shared: true },
     manual: "VS Code asks you to trust a server the first time it starts one."
   },
   {
@@ -8127,45 +8372,45 @@ var HARNESSES = [
     file: "opencode.json",
     container: "mcp",
     shape: "opencode",
-    home: join3(".config", "opencode"),
+    home: join4(".config", "opencode"),
     marker: ".opencode",
-    skills: { dir: join3(".opencode", "skills"), shared: true }
+    skills: { dir: join4(".opencode", "skills"), shared: true }
   },
   {
     id: "junie",
     name: "Junie",
     scope: "project",
-    file: join3(".junie", "mcp", "mcp.json"),
+    file: join4(".junie", "mcp", "mcp.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".junie",
-    skills: { dir: join3(".junie", "skills"), shared: true }
+    skills: { dir: join4(".junie", "skills"), shared: true }
   },
   {
     id: "kiro",
     name: "Kiro",
     scope: "project",
-    file: join3(".kiro", "settings", "mcp.json"),
+    file: join4(".kiro", "settings", "mcp.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".kiro",
-    skills: { dir: join3(".kiro", "skills"), shared: false }
+    skills: { dir: join4(".kiro", "skills"), shared: false }
   },
   {
     id: "gemini",
     name: "Gemini CLI",
     scope: "project",
-    file: join3(".gemini", "settings.json"),
+    file: join4(".gemini", "settings.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".gemini",
-    skills: { dir: join3(".gemini", "skills"), shared: true }
+    skills: { dir: join4(".gemini", "skills"), shared: true }
   },
   {
     id: "roo",
     name: "Roo Code",
     scope: "project",
-    file: join3(".roo", "mcp.json"),
+    file: join4(".roo", "mcp.json"),
     container: "mcpServers",
     shape: "plain"
   },
@@ -8173,7 +8418,7 @@ var HARNESSES = [
     id: "kilo",
     name: "Kilo Code",
     scope: "project",
-    file: join3(".kilocode", "mcp.json"),
+    file: join4(".kilocode", "mcp.json"),
     container: "mcpServers",
     shape: "plain"
   },
@@ -8181,16 +8426,16 @@ var HARNESSES = [
     id: "amazon-q",
     name: "Amazon Q Developer CLI",
     scope: "project",
-    file: join3(".amazonq", "mcp.json"),
+    file: join4(".amazonq", "mcp.json"),
     container: "mcpServers",
     shape: "plain",
-    home: join3(".aws", "amazonq")
+    home: join4(".aws", "amazonq")
   },
   {
     id: "zed",
     name: "Zed",
     scope: "project",
-    file: join3(".zed", "settings.json"),
+    file: join4(".zed", "settings.json"),
     container: "context_servers",
     shape: "plain"
   },
@@ -8198,16 +8443,16 @@ var HARNESSES = [
     id: "amp",
     name: "Amp",
     scope: "project",
-    file: join3(".amp", "settings.json"),
+    file: join4(".amp", "settings.json"),
     container: "amp.mcpServers",
     shape: "plain",
-    home: join3(".config", "amp")
+    home: join4(".config", "amp")
   },
   {
     id: "warp",
     name: "Warp",
     scope: "project",
-    file: join3(".warp", ".mcp.json"),
+    file: join4(".warp", ".mcp.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".warp",
@@ -8217,7 +8462,7 @@ var HARNESSES = [
     id: "trae",
     name: "Trae",
     scope: "project",
-    file: join3(".trae", "mcp.json"),
+    file: join4(".trae", "mcp.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".trae"
@@ -8226,7 +8471,7 @@ var HARNESSES = [
     id: "factory",
     name: "Factory Droid",
     scope: "project",
-    file: join3(".factory", "mcp.json"),
+    file: join4(".factory", "mcp.json"),
     container: "mcpServers",
     shape: "typed",
     home: ".factory"
@@ -8235,7 +8480,7 @@ var HARNESSES = [
     id: "tabnine",
     name: "Tabnine",
     scope: "project",
-    file: join3(".tabnine", "mcp_servers.json"),
+    file: join4(".tabnine", "mcp_servers.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".tabnine"
@@ -8252,7 +8497,7 @@ var HARNESSES = [
     id: "pi",
     name: "pi",
     scope: "project",
-    file: join3(".pi", "mcp.json"),
+    file: join4(".pi", "mcp.json"),
     container: "mcpServers",
     shape: "plain",
     home: ".pi"
@@ -8261,7 +8506,7 @@ var HARNESSES = [
     id: "mistral-vibe",
     name: "Mistral Vibe",
     scope: "project",
-    file: join3(".vibe", "config.toml"),
+    file: join4(".vibe", "config.toml"),
     container: "mcp_servers",
     shape: "plain",
     toml: {
@@ -8317,7 +8562,7 @@ var HARNESSES = [
     id: "codex",
     name: "Codex CLI",
     scope: "home",
-    file: join3(".codex", "config.toml"),
+    file: join4(".codex", "config.toml"),
     container: "mcp_servers",
     shape: "plain",
     manual: "Codex reads its config at startup, so restart it.",
@@ -8336,20 +8581,20 @@ var HARNESSES = [
     id: "cline",
     name: "Cline",
     scope: "home",
-    file: join3(".cline", "data", "settings", "cline_mcp_settings.json"),
+    file: join4(".cline", "data", "settings", "cline_mcp_settings.json"),
     container: "mcpServers",
     shape: "plain",
     marker: ".cline",
-    skills: { dir: join3(".cline", "skills"), shared: false }
+    skills: { dir: join4(".cline", "skills"), shared: false }
   },
   {
     id: "goose",
     name: "Goose",
     scope: "home",
     file: {
-      win32: { appData: join3("Block", "goose", "config", "config.yaml") },
-      darwin: join3(".config", "goose", "config.yaml"),
-      linux: join3(".config", "goose", "config.yaml")
+      win32: { appData: join4("Block", "goose", "config", "config.yaml") },
+      darwin: join4(".config", "goose", "config.yaml"),
+      linux: join4(".config", "goose", "config.yaml")
     },
     container: "extensions",
     shape: "plain",
@@ -8370,19 +8615,19 @@ var HARNESSES = [
     id: "windsurf",
     name: "Windsurf",
     scope: "home",
-    file: join3(".codeium", "windsurf", "mcp_config.json"),
+    file: join4(".codeium", "windsurf", "mcp_config.json"),
     container: "mcpServers",
     shape: "plain",
-    skills: { dir: join3(".windsurf", "skills"), shared: true }
+    skills: { dir: join4(".windsurf", "skills"), shared: true }
   },
   {
     id: "hermes",
     name: "Hermes",
     scope: "home",
-    file: join3(".hermes", "config.yaml"),
+    file: join4(".hermes", "config.yaml"),
     container: "mcp_servers",
     shape: "plain",
-    skills: { dir: join3(".hermes", "skills"), shared: true },
+    skills: { dir: join4(".hermes", "skills"), shared: true },
     yaml: {
       path: ["mcp_servers", SERVER_KEY],
       entry: (launch) => ({
@@ -8397,7 +8642,7 @@ var HARNESSES = [
     id: "openclaw",
     name: "OpenClaw",
     scope: "home",
-    file: join3(".openclaw", "openclaw.json"),
+    file: join4(".openclaw", "openclaw.json"),
     container: "mcpServers",
     shape: "plain"
   },
@@ -8406,9 +8651,9 @@ var HARNESSES = [
     name: "Claude Desktop",
     scope: "home",
     file: {
-      win32: { appData: join3("Claude", "claude_desktop_config.json") },
-      darwin: join3("Library", "Application Support", "Claude", "claude_desktop_config.json"),
-      linux: join3(".config", "Claude", "claude_desktop_config.json")
+      win32: { appData: join4("Claude", "claude_desktop_config.json") },
+      darwin: join4("Library", "Application Support", "Claude", "claude_desktop_config.json"),
+      linux: join4(".config", "Claude", "claude_desktop_config.json")
     },
     container: "mcpServers",
     shape: "plain"
@@ -8417,7 +8662,7 @@ var HARNESSES = [
     id: "zeroclaw",
     name: "ZeroClaw",
     scope: "home",
-    file: join3(".zeroclaw", "config.toml"),
+    file: join4(".zeroclaw", "config.toml"),
     container: "mcp.servers",
     shape: "plain",
     toml: {
@@ -8438,7 +8683,7 @@ var HARNESSES = [
     id: "deepcode",
     name: "Deep Code",
     scope: "home",
-    file: join3(".deepcode", "settings.json"),
+    file: join4(".deepcode", "settings.json"),
     container: "mcpServers",
     shape: "plain"
   },
@@ -8446,7 +8691,7 @@ var HARNESSES = [
     id: "nanobot",
     name: "nanobot",
     scope: "home",
-    file: join3(".nanobot", "config.json"),
+    file: join4(".nanobot", "config.json"),
     container: "mcpServers",
     shape: "plain",
     snippet: (launch) => jsonSnippet(launch, "mcpServers", "plain")
@@ -8455,7 +8700,7 @@ var HARNESSES = [
     id: "autohand",
     name: "Autohand",
     scope: "home",
-    file: join3(".autohand", "config.json"),
+    file: join4(".autohand", "config.json"),
     container: "mcpServers",
     shape: "plain",
     snippet: (launch) => jsonSnippet(launch, "mcpServers", "plain")
@@ -8464,7 +8709,7 @@ var HARNESSES = [
 var OURS = ["GODOT_PATH", "GDHARNESS_PROJECT"];
 function environmentFor(launch, held) {
   const kept = {};
-  if (typeof held === "object" && held !== null && !Array.isArray(held)) {
+  if (isRecord(held)) {
     for (const [name, value] of Object.entries(held)) {
       if (typeof value === "string" && !OURS.includes(name)) {
         kept[name] = value;
@@ -8474,7 +8719,7 @@ function environmentFor(launch, held) {
   return { ...kept, ...launch.env };
 }
 function entryFor(shape, launch, held) {
-  const before = typeof held === "object" && held !== null && !Array.isArray(held) ? { ...held } : {};
+  const before = isRecord(held) ? { ...held } : {};
   if (shape === "opencode") {
     return {
       ...before,
@@ -8500,7 +8745,15 @@ var LOG_LIMIT_BYTES = 128 * 1024 * 1024;
 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 DECLARATION_KEYWORDS = [
+  "func",
+  "var",
+  "const",
+  "signal",
+  "enum",
+  "class"
+];
+var DECLARATION_LINE = new RegExp(`^(${ANNOTATIONS})(static\\s+)?(${DECLARATION_KEYWORDS.join("|")})\\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");
@@ -8554,7 +8807,7 @@ var KEYWORDS = new Set([
 ]);
 
 // src/whole-file.ts
-import { readFileSync as readFileSync3, renameSync, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4, renameSync as renameSync2, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "node:fs";
 var HELD_FILE_MS = 1000;
 var HELD_FILE_RETRY_MS = 10;
 var HELD_BY_A_READER = new Set(["EPERM", "EACCES", "EBUSY"]);
@@ -8562,9 +8815,9 @@ function readWhole(path) {
   const until = Date.now() + HELD_FILE_MS;
   for (;; ) {
     try {
-      return readFileSync3(path, "utf8");
+      return readFileSync4(path, "utf8");
     } catch (error) {
-      const code = error.code ?? "";
+      const code = errorCode(error) ?? "";
       if (code === "ENOENT") {
         return null;
       }
@@ -8578,20 +8831,20 @@ function readWhole(path) {
 function writeWhole(path, text) {
   const partial = `${path}.${process.pid}.partial`;
   try {
-    writeFileSync3(partial, text, "utf8");
+    writeFileSync4(partial, text, "utf8");
   } catch {
     return false;
   }
   const until = Date.now() + HELD_FILE_MS;
   for (;; ) {
     try {
-      renameSync(partial, path);
+      renameSync2(partial, path);
       return true;
     } catch (error) {
-      const code = error.code ?? "";
+      const code = errorCode(error) ?? "";
       if (!HELD_BY_A_READER.has(code) || Date.now() >= until) {
         try {
-          rmSync2(partial, { force: true });
+          rmSync3(partial, { force: true });
         } catch {}
         return false;
       }
@@ -8603,10 +8856,10 @@ function removeWhole(path) {
   const until = Date.now() + HELD_FILE_MS;
   for (;; ) {
     try {
-      rmSync2(path, { force: true });
+      rmSync3(path, { force: true });
       return true;
     } catch (error) {
-      const code = error.code ?? "";
+      const code = errorCode(error) ?? "";
       if (!HELD_BY_A_READER.has(code) || Date.now() >= until) {
         return false;
       }
@@ -8616,7 +8869,7 @@ function removeWhole(path) {
 }
 
 // src/engine-leaks.ts
-var REFCOUNTED_HELD = "A RefCounted alive at exit is held by a cycle of references (two holding each other, or one " + "holding a lambda that captures it) or by an Object never freed, rather than by a node left out " + "of the tree; a WeakRef on one side of the cycle, or clearing the reference once done, frees it.";
+var REFCOUNTED_HELD = "A RefCounted alive at exit is held by a cycle of references (two holding each other, or one " + "holding a lambda that captures it) or by an Object never freed, rather than by a node left out " + "of the tree. A WeakRef on one side of the cycle, or clearing the reference once done, frees it.";
 var WALK_STOPPED_SENTENCE = "The engine's shutdown stopped part way through its scripts (godot#117991, fixed in 4.8 by " + "godot#120976), so it reported as leaked at exit what it never got to free, and the report is the " + "engine's rather than the run's. gdharness holds every script loaded from a file past that walk, " + "which keeps it whole, so this one stopped on a script it could not hold, such as one made in code. " + "A leak of the run's own is not told apart in such a run.";
 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");
@@ -8669,7 +8922,7 @@ var MEMORY_PER_ENGINE = 1.5 * 1024 ** 3;
 var SCAN_BYTES = 1024 * 1024;
 
 // src/process-children.ts
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 import { basename as basename3 } from "node:path";
 async function startTimesOf(pids) {
   const began = new Map;
@@ -8711,7 +8964,7 @@ async function linuxStartTimes(pids) {
   const hertz = await ticksPerSecond();
   let booted;
   try {
-    booted = Number(/^btime\s+(\d+)$/m.exec(readFileSync4("/proc/stat", "utf8"))?.[1] ?? Number.NaN) * 1000;
+    booted = Number(/^btime\s+(\d+)$/m.exec(readFileSync5("/proc/stat", "utf8"))?.[1] ?? Number.NaN) * 1000;
   } catch {
     return began;
   }
@@ -8721,7 +8974,7 @@ async function linuxStartTimes(pids) {
   for (const pid of pids) {
     let stat;
     try {
-      stat = readFileSync4(`/proc/${String(pid)}/stat`, "utf8");
+      stat = readFileSync5(`/proc/${String(pid)}/stat`, "utf8");
     } catch {
       continue;
     }
@@ -8751,7 +9004,7 @@ async function ticksPerSecond() {
 }
 function printedBy(command, args, env) {
   return runHidden(command, args, { timeout: ASK_TIMEOUT_MS, env }).then(({ stdout }) => stdout, (error) => {
-    const printed = error.stdout;
+    const printed = error instanceof Error && "stdout" in error ? error.stdout : undefined;
     return typeof printed === "string" ? printed : "";
   });
 }
@@ -8883,7 +9136,7 @@ function nameSlotEngine(lock, holder, engine) {
 }
 function giveBackSlot(lock, pid) {
   try {
-    if (holderOf(readFileSync5(lock, "utf8"))?.pid === pid) {
+    if (holderOf(readFileSync6(lock, "utf8"))?.pid === pid) {
       removeWhole(lock);
     }
   } catch {}
@@ -8917,9 +9170,9 @@ function crashesReported() {
 }
 
 // src/game-debugger.ts
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync8 } from "node:fs";
 import { createServer } from "node:net";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 
 // src/godot-variant.ts
 var NIL = 0;
@@ -9224,8 +9477,8 @@ function readMessage(body) {
 }
 
 // src/setup.ts
-import { dirname as dirname3, join as join5 } from "node:path";
-import { fileURLToPath } from "node:url";
+import { dirname as dirname3, join as join6 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/dictionary.ts
 function emptyRecord() {
@@ -9339,25 +9592,25 @@ var IMPORTABLE = new Set(IMPORTABLE_EXTENSIONS);
 var hashes = new Map;
 
 // src/scratch.ts
-import { existsSync as existsSync3, mkdtempSync as mkdtempSync2, readdirSync as readdirSync2, rmSync as rmSync4 } from "node:fs";
+import { existsSync as existsSync4, mkdtempSync as mkdtempSync2, readdirSync as readdirSync3, rmSync as rmSync5 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 import process6 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(join4(tmpdir5(), `gdharness-${kind}-${process6.pid}-`));
+  return mkdtempSync2(join5(tmpdir5(), `gdharness-${kind}-${process6.pid}-`));
 }
-function discardWith(remove, paths) {
+function discardWith(removePath, paths) {
   const left = [];
   for (const path of paths) {
     if (!path) {
       continue;
     }
     try {
-      remove(path);
+      removePath(path);
     } catch (error) {
       left.push({ path, reason: error instanceof Error ? error.message : String(error) });
     }
@@ -9372,7 +9625,7 @@ function discard(...paths) {
   return left;
 }
 function remove(path) {
-  rmSync4(path, SWEPT);
+  rmSync5(path, SWEPT);
 }
 function tryAgain(path, attempt) {
   if (attempt === 0) {
@@ -9384,7 +9637,7 @@ function tryAgain(path, attempt) {
     lastTryOnExit();
   }
   const after = AGAIN_AFTER_MS[attempt];
-  if (after === undefined || !existsSync3(path)) {
+  if (after === undefined || !existsSync4(path)) {
     waiting.delete(path);
     if (after === undefined) {
       atExit.add(path);
@@ -9533,7 +9786,7 @@ function parseIniLikeValue(value) {
 }
 
 // src/server-version.ts
-import { readFileSync as readFileSync6 } from "node:fs";
+import { readFileSync as readFileSync7 } from "node:fs";
 
 // src/update-check.ts
 var CACHE_MS = 10 * 60 * 1000;
@@ -9544,8 +9797,9 @@ var MAX_RETRY_MS = 60 * 60 * 1000;
 var DEBUG_MODE = process.env["GDHARNESS_DEBUG"] === "1";
 var SERVER_VERSION = (() => {
   try {
-    const pkg = JSON.parse(readFileSync6(new URL("../package.json", import.meta.url), "utf8"));
-    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    const pkg = JSON.parse(readFileSync7(new URL("../package.json", import.meta.url), "utf8"));
+    const version = isRecord(pkg) ? pkg["version"] : undefined;
+    return typeof version === "string" ? version : "0.0.0";
   } catch {
     return "0.0.0";
   }
@@ -9557,7 +9811,7 @@ var RUNTIME_AUTOLOAD = {
   path: "gdharness/loader.gd"
 };
 function shippedAddonsDirectory() {
-  return join5(dirname3(fileURLToPath(import.meta.url)), "godot", "addons");
+  return join6(dirname3(fileURLToPath2(import.meta.url)), "godot", "addons");
 }
 
 // src/game-debugger.ts
@@ -9568,9 +9822,12 @@ var ADDON_LINES = 200;
 var RUNTIME_ADDON = "res://addons/gdharness_runtime/";
 var RUNTIME_AUTOLOAD2 = `${RUNTIME_ADDON}runtime_autoload.gd`;
 var frameEnd = null;
+function topIsTheAddon(frames) {
+  return frames[0]?.script.startsWith(RUNTIME_ADDON) ?? false;
+}
 function frameEndLine() {
   if (frameEnd === null) {
-    const lines = readFileSync7(join6(shippedAddonsDirectory(), "gdharness_runtime", "runtime_autoload.gd"), "utf8").split(`
+    const lines = readFileSync8(join7(shippedAddonsDirectory(), "gdharness_runtime", "runtime_autoload.gd"), "utf8").split(`
 `);
     const declared = lines.findIndex((line) => line.startsWith("func _notification("));
     if (declared === -1) {
@@ -9970,7 +10227,7 @@ class GameDebugger {
       if (entered === null) {
         return {
           paused: false,
-          note: `The game has been asked to stop and had not within ${PAUSE_MS / 1000}s. It takes the request between frames, and in a script every 2048 lines it runs, so its main thread is in a loop that sleeps between few lines, or inside one long engine call or a native extension's own loop. The request stays with the game, which stops when it next reaches that point; debug_state stack reads where once it has.`
+          note: `The game has been asked to stop and had not within ${PAUSE_MS / 1000}s. It takes the request between frames, and in a script every 2048 lines it runs, so its main thread is in a loop that sleeps between few lines, or inside one long engine call or a native extension's own loop. The request stays with the game, which stops when it next reaches that point. debug_state stack reads where once it has.`
         };
       }
     }
@@ -9985,7 +10242,7 @@ class GameDebugger {
       if (again === null) {
         return {
           paused: false,
-          note: `The game stopped between frames, where no script runs, so it was let go to stop at the next line of script it runs, and none ran within ${STEP_MS / 1000}s. It stops there when one does; debug_state stack reads it then.`
+          note: `The game stopped between frames, where no script runs, so it was let go to stop at the next line of script it runs, and none ran within ${STEP_MS / 1000}s. It stops there when one does, and debug_state stack reads it then.`
         };
       }
     }
@@ -9993,7 +10250,7 @@ class GameDebugger {
     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.`
+        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, and debug_state stack reads it then.`
       };
     }
     this.stoppedBy("Paused");
@@ -10013,7 +10270,7 @@ class GameDebugger {
     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)) {
+    while (frames !== null && this.held !== null && topIsTheAddon(frames)) {
       if (until !== undefined && Date.now() >= until) {
         return { frames, gaveUp: "time" };
       }
@@ -10093,7 +10350,7 @@ class GameDebugger {
       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.`
+        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, and debug_state stack reads it then.`
       };
     }
     this.stoppedBy("Stepped");
@@ -10211,7 +10468,7 @@ class GameDebugger {
       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(", ")}.`
+      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() {
@@ -10222,10 +10479,10 @@ class GameDebugger {
 
 // src/keeper-channel.ts
 import { randomUUID } from "node:crypto";
-import { mkdtempSync as mkdtempSync3, rmSync as rmSync5 } from "node:fs";
+import { mkdtempSync as mkdtempSync3, rmSync as rmSync6 } from "node:fs";
 import { connect, createServer as createServer2 } from "node:net";
 import { tmpdir as tmpdir6 } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 import process7 from "node:process";
 var DEBUG_PREFIX = "debug ";
 function endedOrWhyNot(end) {
@@ -10241,11 +10498,41 @@ async function debuggedOrWhyNot(debug, asked) {
     return JSON.stringify({ refused: "This run has no debugger." });
   }
   try {
-    return JSON.stringify(await debug(JSON.parse(asked)));
+    const request = debugRequestOf(JSON.parse(asked));
+    if (request === null) {
+      return JSON.stringify({ refused: `The debugger takes no request like ${asked.slice(0, 200)}.` });
+    }
+    return JSON.stringify(await debug(request));
   } catch (error) {
     return JSON.stringify({ refused: `The debugger could not answer: ${errorText(error)}` });
   }
 }
+var RESUMED_HOW = ["continue", "next", "step", "out"];
+function debugRequestOf(asked) {
+  if (!isRecord(asked)) {
+    return null;
+  }
+  const { op, script, line, set, how, frame, expression } = asked;
+  switch (op) {
+    case "breakpoint":
+      return typeof script === "string" && typeof line === "number" && typeof set === "boolean" ? { op, script, line, set } : null;
+    case "pause":
+    case "stack":
+    case "output":
+    case "state":
+      return { op };
+    case "resume": {
+      const resumed = RESUMED_HOW.find((one) => one === how);
+      return resumed === undefined ? null : { op, how: resumed };
+    }
+    case "variables":
+      return typeof frame === "number" ? { op, frame } : null;
+    case "evaluate":
+      return typeof frame === "number" && typeof expression === "string" ? { op, frame, expression } : null;
+    default:
+      return null;
+  }
+}
 function errorText(error) {
   return (error instanceof Error ? error.message : String(error)).replaceAll(`
 `, " ");
@@ -10253,8 +10540,8 @@ function errorText(error) {
 async function listenForTheServer(end, debug) {
   let directory = null;
   try {
-    directory = process7.platform === "win32" ? null : mkdtempSync3(join7(tmpdir6(), "gdharness-keeper-"));
-    const address = directory === null ? `\\\\.\\pipe\\gdharness-keeper-${randomUUID()}` : join7(directory, "keeper.sock");
+    directory = process7.platform === "win32" ? null : mkdtempSync3(join8(tmpdir6(), "gdharness-keeper-"));
+    const address = directory === null ? `\\\\.\\pipe\\gdharness-keeper-${randomUUID()}` : join8(directory, "keeper.sock");
     const server = createServer2((socket) => {
       socket.setEncoding("utf8");
       socket.on("error", () => {});
@@ -10290,13 +10577,13 @@ async function listenForTheServer(end, debug) {
       close: () => {
         server.close();
         if (made !== null) {
-          rmSync5(made, { recursive: true, force: true });
+          rmSync6(made, { recursive: true, force: true });
         }
       }
     };
   } catch {
     if (directory !== null) {
-      rmSync5(directory, { recursive: true, force: true });
+      rmSync6(directory, { recursive: true, force: true });
     }
     return null;
   }
@@ -10312,7 +10599,9 @@ function listening(server, address) {
 }
 
 // src/outside.ts
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import process8 from "node:process";
+import { text } from "node:stream/consumers";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 function withChanges(base, changes) {
   const env = { ...base };
   for (const [name, value] of Object.entries(changes)) {
@@ -10328,13 +10617,70 @@ function sendSpec(child, spec) {
   child.stdin?.end(JSON.stringify(spec), "utf8");
 }
 async function receivedSpec() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
+  const received = await text(process8.stdin);
+  const spec = sentSpecOf(JSON.parse(received));
+  if (spec === null) {
+    throw new Error(`What came down stdin is not a spec a server sends: ${received.slice(0, 200)}`);
   }
-  return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+  return spec;
 }
-var KEEPER_SCRIPT = fileURLToPath2(new URL("./keeper.js", import.meta.url));
+function envChangesOf(value) {
+  if (!isRecord(value)) {
+    return null;
+  }
+  const changes = {};
+  for (const [name, change] of Object.entries(value)) {
+    if (typeof change !== "string" && change !== null) {
+      return null;
+    }
+    changes[name] = change;
+  }
+  return changes;
+}
+function runOf(value) {
+  if (!isRecord(value)) {
+    return null;
+  }
+  const { transcript, startedAt, projectPath, servedBy, profile, breakpoints, debugged, slot } = value;
+  const held = slot === undefined ? undefined : slotOf(slot);
+  if (typeof transcript !== "string" || typeof startedAt !== "number" || typeof projectPath !== "string" || servedBy !== undefined && typeof servedBy !== "string" || profile !== undefined && typeof profile !== "string" || breakpoints !== undefined && !isStringList(breakpoints) || debugged !== undefined && typeof debugged !== "boolean" || held === null) {
+    return null;
+  }
+  return {
+    transcript,
+    startedAt,
+    projectPath,
+    ...servedBy === undefined ? {} : { servedBy },
+    ...profile === undefined ? {} : { profile },
+    ...breakpoints === undefined ? {} : { breakpoints },
+    ...debugged === undefined ? {} : { debugged },
+    ...held === undefined ? {} : { slot: held }
+  };
+}
+function slotOf(value) {
+  const { lock, from, by } = isRecord(value) ? value : {};
+  return typeof lock === "string" && typeof from === "number" && typeof by === "string" ? { lock, from, by } : null;
+}
+function sentSpecOf(value) {
+  if (!isRecord(value)) {
+    return null;
+  }
+  const { command, args, envChanges, run, desktop, noActivate } = value;
+  const changes = envChangesOf(envChanges);
+  const ran = run === undefined ? undefined : runOf(run);
+  if (typeof command !== "string" || !isStringList(args) || changes === null || ran === null || desktop !== undefined && typeof desktop !== "string" || noActivate !== undefined && typeof noActivate !== "boolean") {
+    return null;
+  }
+  return {
+    command,
+    args,
+    envChanges: changes,
+    ...ran === undefined ? {} : { run: ran },
+    ...desktop === undefined ? {} : { desktop },
+    ...noActivate === undefined ? {} : { noActivate }
+  };
+}
+var KEEPER_SCRIPT = fileURLToPath3(new URL("./keeper.js", import.meta.url));
 function readLaunched(printed) {
   const line = printed.split(`
 `).find((one) => one.trim() !== "")?.trim() ?? "";
@@ -10347,12 +10693,12 @@ function readLaunched(printed) {
 
 // src/run-record.ts
 import { createHash as createHash2 } from "node:crypto";
-import { mkdirSync as mkdirSync2, openSync as openSync3, readdirSync as readdirSync3, readFileSync as readFileSync8, rmSync as rmSync6, statSync as statSync4 } from "node:fs";
-import { basename as basename4, join as join9, resolve as resolve4 } from "node:path";
+import { mkdirSync as mkdirSync2, openSync as openSync3, readdirSync as readdirSync4, readFileSync as readFileSync9, rmSync as rmSync7, statSync as statSync4 } from "node:fs";
+import { basename as basename4, join as join10, resolve as resolve5 } from "node:path";
 
 // src/runtime-client.ts
 import { tmpdir as tmpdir7 } from "node:os";
-import { dirname as dirname4, join as join8, resolve as resolve3 } from "node:path";
+import { dirname as dirname4, join as join9, resolve as resolve4 } from "node:path";
 
 // src/launch.ts
 function envValue(name, variables = process.env) {
@@ -10397,7 +10743,7 @@ function runtimeDirectory(variables = process.env) {
     return explicit;
   }
   const perUser = envValue("XDG_RUNTIME_DIR", variables);
-  return join8(perUser ?? tmpdir7(), "gdharness");
+  return join9(perUser ?? tmpdir7(), "gdharness");
 }
 var ERROR_REPORT_KEEP_MS = 60 * 60 * 1000;
 var verdicts = new Map;
@@ -10407,15 +10753,15 @@ var untaken = new Map;
 
 // src/run-record.ts
 function runsDirectory() {
-  return join9(runtimeDirectory(), "runs");
+  return join10(runtimeDirectory(), "runs");
 }
 function projectKey(projectPath) {
-  const real = realAsFarAsItExists(resolve4(projectPath)).replace(/[\\/]+$/, "");
+  const real = realAsFarAsItExists(resolve5(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 join9(directory, "runs", `note-${projectKey(projectPath)}.json`);
+  return join10(directory, "runs", `note-${projectKey(projectPath)}.json`);
 }
 function writeRunRecord(record) {
   mkdirSync2(runsDirectory(), { recursive: true });
@@ -10443,11 +10789,11 @@ function recordRunEnded(projectPath, pid, ending) {
 function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync8(path, "utf8"));
+    parsed = JSON.parse(readFileSync9(path, "utf8"));
   } catch {
     return null;
   }
-  if (!parsed || typeof parsed !== "object") {
+  if (!isRecord(parsed)) {
     return null;
   }
   const fields = parsed;
@@ -10485,11 +10831,10 @@ function recordAt(path) {
   };
 }
 function restartedFromAt(value) {
-  if (!value || typeof value !== "object") {
+  if (!isRecord(value)) {
     return [];
   }
-  const fields = value;
-  const { pid, endedAt, exitCode, exitSignal } = fields;
+  const { pid, endedAt, exitCode, exitSignal } = value;
   if (typeof pid !== "number" || typeof endedAt !== "number") {
     return [];
   }
@@ -10863,9 +11208,9 @@ async function startDirectly(spec, output, hidden, detached = true, errors = out
 }
 async function startThroughHelper(spec, output, stopFile) {
   const scratch = scratchDirectory("desktop");
-  const pidFile = join10(scratch, "pid");
-  const errorFile = join10(scratch, "error");
-  const stepFile = join10(scratch, "step");
+  const pidFile = join11(scratch, "pid");
+  const errorFile = join11(scratch, "error");
+  const stepFile = join11(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();
@@ -10873,7 +11218,7 @@ 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: join10(scratch, "spec.json"),
+      spec: join11(scratch, "spec.json"),
       pid: pidFile,
       error: errorFile,
       stop: stopFile,
@@ -10889,7 +11234,7 @@ async function startThroughHelper(spec, output, stopFile) {
       exited.now = true;
     });
     for (let waited = 0;waited < DESKTOP_START_MS; waited += 50) {
-      const pid = existsSync4(pidFile) ? Number(readFileSync9(pidFile, "utf8").trim()) : Number.NaN;
+      const pid = existsSync5(pidFile) ? Number(readFileSync10(pidFile, "utf8").trim()) : Number.NaN;
       if (Number.isInteger(pid) && pid > 0) {
         return { child: started.child, pid };
       }
@@ -10920,7 +11265,7 @@ function profiledBy(path, projectPath) {
   };
   let projectGodot = null;
   try {
-    projectGodot = readFileSync9(join10(projectPath, "project.godot"), "utf8");
+    projectGodot = readFileSync10(join11(projectPath, "project.godot"), "utf8");
   } catch {}
   const observer = new ProfileObserver((totals) => {
     const first = latest === null;
@@ -10938,9 +11283,13 @@ function profiledBy(path, projectPath) {
       if (timer !== null) {
         clearTimeout(timer);
       }
-      latest = observer.totals() ?? latest;
+      const last = observer.totals() ?? latest;
+      latest = last;
+      if (last === null) {
+        return;
+      }
       let tries = 0;
-      while (latest !== null && !writeProfileFile(path, { ...latest, connected: true }) && tries < LAST_WRITE_TRIES) {
+      while (!writeProfileFile(path, { ...last, connected: true }) && tries < LAST_WRITE_TRIES) {
         tries += 1;
       }
     }
@@ -11021,12 +11370,12 @@ 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 exitNotes = run === undefined ? null : mkdtempSync4(join10(tmpdir8(), "gdharness-exit-"));
+  const exitNotes = run === undefined ? null : mkdtempSync4(join11(tmpdir8(), "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" : openSync4(run.transcript, "a");
-  const own = run !== undefined && throughTheHelper(spec) ? mkdtempSync4(join10(tmpdir8(), "gdharness-stop-")) : null;
-  const stopFile = own === null ? "" : join10(own, "stop");
+  const own = run !== undefined && throughTheHelper(spec) ? mkdtempSync4(join11(tmpdir8(), "gdharness-stop-")) : null;
+  const stopFile = own === null ? "" : join11(own, "stop");
   let started;
   const keeperStarted = run?.slot === undefined ? undefined : ownStart();
   const spawnedAt = Date.now();
@@ -11063,7 +11412,7 @@ async function keep() {
   let listening = null;
   let end = () => {
     if (stopFile !== "") {
-      writeFileSync4(stopFile, "");
+      writeFileSync5(stopFile, "");
       return "signalled";
     }
     return child.kill() ? "signalled" : "gone";
@@ -11165,7 +11514,7 @@ async function keep() {
   listening?.close();
   for (const made of [own, exitNotes]) {
     if (made !== null) {
-      rmSync7(made, { recursive: true, force: true });
+      rmSync8(made, { recursive: true, force: true });
     }
   }
   process.exit(0);
@@ -11176,7 +11525,7 @@ function restartSaid(notes, pid) {
     return null;
   }
   try {
-    const said = JSON.parse(readFileSync9(join10(notes, `exit-${String(pid)}.json`), "utf8"));
+    const said = JSON.parse(readFileSync10(join11(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;