gdharness 0.5.0 → 0.5.2

package/build/index.js

@@ -9826,17 +9826,213 @@ function toError(error) {
 }
 
 // src/server-version.ts
-import { readFileSync } from "node:fs";
+import { readFileSync as readFileSync2 } from "node:fs";
+
+// src/update-check.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+
+// src/runner.ts
+function currentRunner() {
+  const versions = process.versions;
+  return versions["bun"] === undefined ? "npx" : "bunx";
+}
+function runLine(runner, version, rest = "") {
+  const flag = runner === "npx" ? "-y " : "";
+  return `${runner} ${flag}gdharness@${version}${rest === "" ? "" : ` ${rest}`}`;
+}
+
+// src/update-check.ts
+var REGISTRY = "https://registry.npmjs.org/gdharness/latest";
+var RELEASES = "https://github.com/Aureliolo/gdharness/releases/tag";
+var CACHE_MS = 4 * 60 * 60 * 1000;
+var REQUEST_TIMEOUT_MS = 1e4;
+var MAX_BODY_BYTES = 1 << 20;
+var FIRST_RETRY_MS = 30000;
+var MAX_RETRY_MS = 60 * 60 * 1000;
+var VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+function cacheDirectory(environment) {
+  const set = (name) => {
+    const value = environment[name];
+    return value !== undefined && value !== "" ? value : null;
+  };
+  const home = set("HOME") ?? homedir();
+  if (process.platform === "win32") {
+    return join(set("LOCALAPPDATA") ?? home, "gdharness");
+  }
+  if (process.platform === "darwin") {
+    return join(home, "Library", "Caches", "gdharness");
+  }
+  return join(set("XDG_CACHE_HOME") ?? join(home, ".cache"), "gdharness");
+}
+function cacheFile(environment = process.env) {
+  try {
+    const directory = cacheDirectory(environment);
+    mkdirSync(directory, { recursive: true, mode: 448 });
+    return join(directory, "update-check.json");
+  } catch {
+    return join(tmpdir(), "gdharness-update-check.json");
+  }
+}
+function readCache(path) {
+  try {
+    if (!existsSync(path)) {
+      return null;
+    }
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (typeof parsed !== "object" || parsed === null) {
+      return null;
+    }
+    const record = parsed;
+    const checkedAt = record["checkedAt"];
+    const latest = record["latest"];
+    if (typeof checkedAt !== "number" || typeof latest !== "string" || !VERSION.test(latest)) {
+      return null;
+    }
+    return { checkedAt, latest };
+  } catch {
+    return null;
+  }
+}
+function writeCache(path, entry) {
+  try {
+    writeFileSync(path, JSON.stringify(entry), { encoding: "utf8", mode: 384 });
+  } catch {}
+}
+function parts(version) {
+  const withoutBuild = version.split("+")[0] ?? version;
+  const dash = withoutBuild.indexOf("-");
+  const numeric = dash === -1 ? withoutBuild : withoutBuild.slice(0, dash);
+  return {
+    numbers: numeric.split(".").map((piece) => Number.parseInt(piece, 10) || 0),
+    prerelease: dash !== -1
+  };
+}
+function isNewer(candidate, current) {
+  const left = parts(candidate);
+  const right = parts(current);
+  for (let index = 0;index < 3; index += 1) {
+    const a = left.numbers[index] ?? 0;
+    const b = right.numbers[index] ?? 0;
+    if (a !== b) {
+      return a > b;
+    }
+  }
+  return !left.prerelease && right.prerelease;
+}
+async function fetchLatest() {
+  const response = await fetch(REGISTRY, {
+    headers: { accept: "application/vnd.npm.install-v1+json, application/json" },
+    redirect: "error",
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+  });
+  if (!response.ok || response.body === null) {
+    return null;
+  }
+  const declared = Number.parseInt(response.headers.get("content-length") ?? "", 10);
+  if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) {
+    return null;
+  }
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of response.body) {
+    size += chunk.byteLength;
+    if (size > MAX_BODY_BYTES) {
+      return null;
+    }
+    chunks.push(chunk);
+  }
+  const parsed = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+  if (typeof parsed !== "object" || parsed === null) {
+    return null;
+  }
+  const version = parsed["version"];
+  return typeof version === "string" && VERSION.test(version) ? version : null;
+}
+
+class UpdateCheck {
+  latest = null;
+  checking = false;
+  checkedAt = 0;
+  retryAt = 0;
+  backoffMs = FIRST_RETRY_MS;
+  enabled;
+  current;
+  cachePath;
+  constructor(current, environment = process.env) {
+    this.current = current;
+    this.enabled = (environment["GDHARNESS_NO_UPDATE_CHECK"] ?? "") === "";
+    this.cachePath = cacheFile(environment);
+    const cached = this.enabled ? readCache(this.cachePath) : null;
+    if (cached !== null) {
+      this.latest = cached.latest;
+      this.checkedAt = cached.checkedAt;
+    }
+  }
+  refresh(now = Date.now()) {
+    if (!this.enabled || this.checking || now < this.retryAt || now - this.checkedAt < CACHE_MS) {
+      return;
+    }
+    this.checking = true;
+    fetchLatest().then((version) => {
+      if (version === null) {
+        this.scheduleRetry(now);
+        return;
+      }
+      this.latest = version;
+      this.checkedAt = Date.now();
+      this.backoffMs = FIRST_RETRY_MS;
+      this.retryAt = 0;
+      writeCache(this.cachePath, { checkedAt: this.checkedAt, latest: version });
+    }).catch(() => {
+      this.scheduleRetry(now);
+    }).finally(() => {
+      this.checking = false;
+    });
+  }
+  scheduleRetry(now) {
+    this.retryAt = now + this.backoffMs;
+    this.backoffMs = Math.min(this.backoffMs * 2, MAX_RETRY_MS);
+  }
+  notice() {
+    const latest = this.latest;
+    if (!this.enabled || latest === null || !isNewer(latest, this.current)) {
+      return null;
+    }
+    return {
+      current: this.current,
+      latest,
+      releaseNotes: `${RELEASES}/v${latest}`,
+      upgrade: runLine(currentRunner(), latest, "upgrade")
+    };
+  }
+}
+
+// src/server-version.ts
 var DEBUG_MODE = process.env["DEBUG"] === "true";
 var GODOT_DEBUG_MODE_DEFAULT = process.env["GODOT_DEBUG"] === "true" || DEBUG_MODE;
 var SERVER_VERSION = (() => {
   try {
-    const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    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";
   }
 })();
+var UNVERSIONED = "addon from before versions were reported";
+function addonMismatch(addonVersion, serverVersion) {
+  if (addonVersion === serverVersion) {
+    return;
+  }
+  const reported = addonVersion ?? "";
+  const editor = reported === "" ? UNVERSIONED : reported;
+  const both = `The editor is running the ${editor} addon while this server ships ${serverVersion}.`;
+  if (reported !== "" && isNewer(reported, serverVersion)) {
+    return `${both} This server is the older half: reconnect it in your harness so it spawns ${reported}.`;
+  }
+  return `${both} Restart it with editor_launch restart to pick the new one up.`;
+}
 
 // src/issues.ts
 var NEW_ISSUE = "https://github.com/Aureliolo/gdharness/issues/new";
@@ -24500,8 +24696,8 @@ class StdioServerTransport {
 }
 
 // src/class-cache.ts
-import { existsSync, readdirSync, readFileSync as readFileSync2 } from "node:fs";
-import { join } from "node:path";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "node:fs";
+import { join as join2 } from "node:path";
 function declaredClasses(projectPath) {
   const declared = new Map;
   const visit = (directory, prefix) => {
@@ -24509,11 +24705,11 @@ function declaredClasses(projectPath) {
       if (entry.name.startsWith(".")) {
         continue;
       }
-      const path = join(directory, entry.name);
+      const path = join2(directory, entry.name);
       if (entry.isDirectory()) {
         visit(path, `${prefix}${entry.name}/`);
       } else if (entry.isFile() && entry.name.endsWith(".gd")) {
-        const found = /^class_name\s+([A-Za-z_][A-Za-z0-9_]*)/m.exec(readFileSync2(path, "utf8"));
+        const found = /^class_name\s+([A-Za-z_][A-Za-z0-9_]*)/m.exec(readFileSync3(path, "utf8"));
         if (found?.[1]) {
           declared.set(found[1], `res://${prefix}${entry.name}`);
         }
@@ -24524,12 +24720,12 @@ function declaredClasses(projectPath) {
   return declared;
 }
 function cachedClasses(projectPath) {
-  const cache = join(projectPath, ".godot", "global_script_class_cache.cfg");
-  if (!existsSync(cache)) {
+  const cache = join2(projectPath, ".godot", "global_script_class_cache.cfg");
+  if (!existsSync2(cache)) {
     return null;
   }
   const listed = new Map;
-  const text = readFileSync2(cache, "utf8");
+  const text = readFileSync3(cache, "utf8");
   for (const entry of text.matchAll(/"class":\s*&"([^"]+)"[\s\S]*?"path":\s*"([^"]+)"/g)) {
     listed.set(entry[1] ?? "", entry[2] ?? "");
   }
@@ -25621,23 +25817,23 @@ function getDefaultBridge() {
 
 // src/godot-path.ts
 import { execFile } from "node:child_process";
-import { existsSync as existsSync3 } from "node:fs";
+import { existsSync as existsSync4 } from "node:fs";
 import { normalize } from "node:path";
 import { promisify } from "node:util";
 
 // src/detection.ts
-import { existsSync as existsSync2, readdirSync as readdirSync2, statSync } from "node:fs";
-import { homedir } from "node:os";
-import { join as join2 } from "node:path";
+import { existsSync as existsSync3, readdirSync as readdirSync2, statSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join3 } from "node:path";
 function resolveHomeDirectory() {
   try {
-    return homedir();
+    return homedir2();
   } catch {
     return "";
   }
 }
 function scanDirectoryForGodotBinaries(directory, platform) {
-  if (!directory || !existsSync2(directory)) {
+  if (!directory || !existsSync3(directory)) {
     return [];
   }
   let entries;
@@ -25652,7 +25848,7 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     if (!pattern.test(name)) {
       continue;
     }
-    const fullPath = join2(directory, name);
+    const fullPath = join3(directory, name);
     try {
       const stat = statSync(fullPath);
       if (stat.isFile()) {
@@ -25661,7 +25857,7 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     } catch {}
   }
   matches.sort((a, b) => b.mtime - a.mtime);
-  return matches.map((m) => join2(directory, m.name));
+  return matches.map((m) => join3(directory, m.name));
 }
 function conventionalPaths(platform, home) {
   const paths = ["godot"];
@@ -25737,6 +25933,19 @@ function runArguments(options) {
 function editorArguments(projectPath) {
   return ["-e", "--path", projectPath];
 }
+function userDataIn(home, variables = process.env) {
+  const moved = ["APPDATA", "XDG_DATA_HOME"];
+  const carried = {};
+  for (const [name, value] of Object.entries(variables)) {
+    if (!moved.some((named) => named.toLowerCase() === name.toLowerCase())) {
+      carried[name] = value;
+    }
+  }
+  for (const named of moved) {
+    carried[named] = home;
+  }
+  return carried;
+}
 
 // src/godot-path.ts
 var run = promisify(execFile);
@@ -25776,7 +25985,7 @@ class GodotLocator {
       return known;
     }
     let ok = false;
-    if (path === "godot" || existsSync3(path)) {
+    if (path === "godot" || existsSync4(path)) {
       try {
         await run(path, ["--version"]);
         ok = true;
@@ -25791,9 +26000,9 @@ class GodotLocator {
 
 // src/headless.ts
 import { execFile as execFile2 } from "node:child_process";
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join as join3 } from "node:path";
+import { mkdtempSync, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { tmpdir as tmpdir2 } from "node:os";
+import { join as join4 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 var run2 = promisify2(execFile2);
 function snakeCased(params) {
@@ -25834,9 +26043,9 @@ function reason(stdout, stderr) {
   return stdout.trim().split(/\r?\n/).at(-1) ?? "no output at all";
 }
 async function runOperation(engine, operation, params, projectPath) {
-  const paramsDir = mkdtempSync(join3(tmpdir(), "gdharness-params-"));
-  const paramsFile = join3(paramsDir, `${operation}.json`);
-  writeFileSync(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
+  const paramsDir = mkdtempSync(join4(tmpdir2(), "gdharness-params-"));
+  const paramsFile = join4(paramsDir, `${operation}.json`);
+  writeFileSync2(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
   const args = [
     "--headless",
     "--path",
@@ -26706,8 +26915,8 @@ async function handleLSPTool(client, toolName, args) {
 }
 
 // src/project-scan.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync3 } from "node:fs";
-import { join as join4 } from "node:path";
+import { readdirSync as readdirSync3, readFileSync as readFileSync4 } from "node:fs";
+import { join as join5 } from "node:path";
 var SKIPPED = new Set([".git", ".godot", ".import", "node_modules"]);
 var ASSET_EXTENSIONS = new Set(["png", "jpg", "jpeg", "webp", "svg", "ttf", "otf", "wav", "mp3", "ogg"]);
 function projectStructure(projectPath) {
@@ -26718,7 +26927,7 @@ function projectStructure(projectPath) {
         continue;
       }
       if (entry.isDirectory()) {
-        visit(join4(directory, entry.name));
+        visit(join5(directory, entry.name));
       } else if (entry.isFile()) {
         const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
         if (extension === "tscn") {
@@ -26760,7 +26969,7 @@ function searchProject(projectPath, options) {
       if (SKIPPED.has(entry.name)) {
         continue;
       }
-      const entryPath = join4(directory, entry.name);
+      const entryPath = join5(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -26771,7 +26980,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync3(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync4(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -26794,7 +27003,7 @@ function searchProject(projectPath, options) {
 }
 
 // src/resources.ts
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 import { extname, resolve as resolve3 } from "node:path";
 var STATIC_RESOURCES = [
   {
@@ -26965,7 +27174,7 @@ function readResourceText(uri, getProjectPath) {
   const parsedUri = parseGodotUri(uri);
   if (parsedUri.kind === "project-info") {
     const projectFilePath = resolveProjectFile(projectPath, "project.godot");
-    const rawProject = readFileSync4(projectFilePath, "utf-8");
+    const rawProject = readFileSync5(projectFilePath, "utf-8");
     const parsedProject = parseProjectGodot(rawProject);
     return {
       mimeType: "application/json",
@@ -26974,7 +27183,7 @@ function readResourceText(uri, getProjectPath) {
   }
   const filePath = resolveProjectFile(projectPath, parsedUri.resourcePath);
   ensureAllowedExtension(parsedUri.kind, filePath);
-  const text = readFileSync4(filePath, "utf-8");
+  const text = readFileSync5(filePath, "utf-8");
   return {
     mimeType: parsedUri.kind === "script" ? "text/x-gdscript" : "text/plain",
     text
@@ -27011,10 +27220,10 @@ function setupResourceHandlers(mcp, getProjectPath) {
 }
 
 // src/runtime-client.ts
-import { existsSync as existsSync4, readdirSync as readdirSync4, readFileSync as readFileSync5, unlinkSync } from "node:fs";
+import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync6, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
-import { tmpdir as tmpdir2 } from "node:os";
-import { join as join5, resolve as resolve4 } from "node:path";
+import { tmpdir as tmpdir3 } from "node:os";
+import { join as join6, resolve as resolve4 } from "node:path";
 
 // src/tool-args.ts
 function asParams(value) {
@@ -27076,7 +27285,15 @@ function runtimeDirectory(variables = process.env) {
     return explicit;
   }
   const perUser = envValue("XDG_RUNTIME_DIR", variables);
-  return join5(perUser ?? tmpdir2(), "gdharness");
+  return join6(perUser ?? tmpdir3(), "gdharness");
+}
+function runtimeDirectories(variables = process.env) {
+  const candidates = [runtimeDirectory(variables)];
+  const fallbacks = process.platform === "win32" ? [envValue("SystemRoot", variables) ?? envValue("windir", variables) ?? "C:\\Windows"] : ["/tmp", "/var/tmp"];
+  for (const base of fallbacks) {
+    candidates.push(join6(base, process.platform === "win32" ? "Temp" : "", "gdharness"));
+  }
+  return [...new Set(candidates.map((path) => resolve4(path)))];
 }
 function processAlive(pid) {
   try {
@@ -27089,7 +27306,7 @@ function processAlive(pid) {
 function parseAnnouncement(file, pid) {
   let fields;
   try {
-    fields = asParams(JSON.parse(readFileSync5(file, "utf8")));
+    fields = asParams(JSON.parse(readFileSync6(file, "utf8")));
   } catch {
     return null;
   }
@@ -27107,8 +27324,19 @@ function parseAnnouncement(file, pid) {
     file
   };
 }
-function discoverRuntimes(directory = runtimeDirectory()) {
-  if (!existsSync4(directory)) {
+function discoverRuntimes(directories = runtimeDirectories()) {
+  const found = new Map;
+  for (const directory of directories) {
+    for (const endpoint of announcedIn(directory)) {
+      if (!found.has(endpoint.pid)) {
+        found.set(endpoint.pid, endpoint);
+      }
+    }
+  }
+  return [...found.values()].sort((a, b) => b.pid - a.pid);
+}
+function announcedIn(directory) {
+  if (!existsSync5(directory)) {
     return [];
   }
   const found = [];
@@ -27117,7 +27345,7 @@ function discoverRuntimes(directory = runtimeDirectory()) {
     if (!match) {
       continue;
     }
-    const file = join5(directory, entry);
+    const file = join6(directory, entry);
     const pid = Number.parseInt(match[1] ?? "", 10);
     const endpoint = processAlive(pid) ? parseAnnouncement(file, pid) : null;
     if (endpoint) {
@@ -27128,7 +27356,7 @@ function discoverRuntimes(directory = runtimeDirectory()) {
       } catch {}
     }
   }
-  return found.sort((a, b) => b.pid - a.pid);
+  return found;
 }
 function describe2(endpoint) {
   return `pid ${endpoint.pid} on ${endpoint.address}:${endpoint.port} (${endpoint.project.name || "unnamed"} at ${endpoint.project.path})`;
@@ -27552,7 +27780,7 @@ var TOOL_SPECS = [
   },
   {
     name: "project_test",
-    description: "Runs the project's gdUnit4 tests headless and answers with every case: which failed, where, and what the assertion said. The class list is rebuilt first, so a suite written a moment ago is found. Needs gdUnit4 under addons/gdUnit4.",
+    description: "Runs the project's gdUnit4 tests headless and answers with every case: which failed, where, and what the assertion said. The class list is rebuilt first, so a suite written a moment ago is found. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. Needs gdUnit4 under addons/gdUnit4.",
     parameters: {
       projectPath: PROJECT_PATH,
       path: {
@@ -28153,187 +28381,6 @@ function buildToolDefinitions() {
   });
 }
 
-// src/update-check.ts
-import { existsSync as existsSync5, mkdirSync, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir2, tmpdir as tmpdir3 } from "node:os";
-import { join as join6 } from "node:path";
-
-// src/runner.ts
-function currentRunner() {
-  const versions = process.versions;
-  return versions["bun"] === undefined ? "npx" : "bunx";
-}
-function runLine(runner, version, rest = "") {
-  const flag = runner === "npx" ? "-y " : "";
-  return `${runner} ${flag}gdharness@${version}${rest === "" ? "" : ` ${rest}`}`;
-}
-
-// src/update-check.ts
-var REGISTRY = "https://registry.npmjs.org/gdharness/latest";
-var RELEASES = "https://github.com/Aureliolo/gdharness/releases/tag";
-var CACHE_MS = 4 * 60 * 60 * 1000;
-var REQUEST_TIMEOUT_MS = 1e4;
-var MAX_BODY_BYTES = 1 << 20;
-var FIRST_RETRY_MS = 30000;
-var MAX_RETRY_MS = 60 * 60 * 1000;
-var VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
-function cacheDirectory(environment) {
-  const set = (name) => {
-    const value = environment[name];
-    return value !== undefined && value !== "" ? value : null;
-  };
-  const home = set("HOME") ?? homedir2();
-  if (process.platform === "win32") {
-    return join6(set("LOCALAPPDATA") ?? home, "gdharness");
-  }
-  if (process.platform === "darwin") {
-    return join6(home, "Library", "Caches", "gdharness");
-  }
-  return join6(set("XDG_CACHE_HOME") ?? join6(home, ".cache"), "gdharness");
-}
-function cacheFile(environment = process.env) {
-  try {
-    const directory = cacheDirectory(environment);
-    mkdirSync(directory, { recursive: true, mode: 448 });
-    return join6(directory, "update-check.json");
-  } catch {
-    return join6(tmpdir3(), "gdharness-update-check.json");
-  }
-}
-function readCache(path) {
-  try {
-    if (!existsSync5(path)) {
-      return null;
-    }
-    const parsed = JSON.parse(readFileSync6(path, "utf8"));
-    if (typeof parsed !== "object" || parsed === null) {
-      return null;
-    }
-    const record = parsed;
-    const checkedAt = record["checkedAt"];
-    const latest = record["latest"];
-    if (typeof checkedAt !== "number" || typeof latest !== "string" || !VERSION.test(latest)) {
-      return null;
-    }
-    return { checkedAt, latest };
-  } catch {
-    return null;
-  }
-}
-function writeCache(path, entry) {
-  try {
-    writeFileSync2(path, JSON.stringify(entry), { encoding: "utf8", mode: 384 });
-  } catch {}
-}
-function parts(version) {
-  const withoutBuild = version.split("+")[0] ?? version;
-  const dash = withoutBuild.indexOf("-");
-  const numeric = dash === -1 ? withoutBuild : withoutBuild.slice(0, dash);
-  return {
-    numbers: numeric.split(".").map((piece) => Number.parseInt(piece, 10) || 0),
-    prerelease: dash !== -1
-  };
-}
-function isNewer(candidate, current) {
-  const left = parts(candidate);
-  const right = parts(current);
-  for (let index = 0;index < 3; index += 1) {
-    const a = left.numbers[index] ?? 0;
-    const b = right.numbers[index] ?? 0;
-    if (a !== b) {
-      return a > b;
-    }
-  }
-  return !left.prerelease && right.prerelease;
-}
-async function fetchLatest() {
-  const response = await fetch(REGISTRY, {
-    headers: { accept: "application/vnd.npm.install-v1+json, application/json" },
-    redirect: "error",
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-  });
-  if (!response.ok || response.body === null) {
-    return null;
-  }
-  const declared = Number.parseInt(response.headers.get("content-length") ?? "", 10);
-  if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) {
-    return null;
-  }
-  const chunks = [];
-  let size = 0;
-  for await (const chunk of response.body) {
-    size += chunk.byteLength;
-    if (size > MAX_BODY_BYTES) {
-      return null;
-    }
-    chunks.push(chunk);
-  }
-  const parsed = JSON.parse(Buffer.concat(chunks).toString("utf8"));
-  if (typeof parsed !== "object" || parsed === null) {
-    return null;
-  }
-  const version = parsed["version"];
-  return typeof version === "string" && VERSION.test(version) ? version : null;
-}
-
-class UpdateCheck {
-  latest = null;
-  checking = false;
-  checkedAt = 0;
-  retryAt = 0;
-  backoffMs = FIRST_RETRY_MS;
-  enabled;
-  current;
-  cachePath;
-  constructor(current, environment = process.env) {
-    this.current = current;
-    this.enabled = (environment["GDHARNESS_NO_UPDATE_CHECK"] ?? "") === "";
-    this.cachePath = cacheFile(environment);
-    const cached = this.enabled ? readCache(this.cachePath) : null;
-    if (cached !== null) {
-      this.latest = cached.latest;
-      this.checkedAt = cached.checkedAt;
-    }
-  }
-  refresh(now = Date.now()) {
-    if (!this.enabled || this.checking || now < this.retryAt || now - this.checkedAt < CACHE_MS) {
-      return;
-    }
-    this.checking = true;
-    fetchLatest().then((version) => {
-      if (version === null) {
-        this.scheduleRetry(now);
-        return;
-      }
-      this.latest = version;
-      this.checkedAt = Date.now();
-      this.backoffMs = FIRST_RETRY_MS;
-      this.retryAt = 0;
-      writeCache(this.cachePath, { checkedAt: this.checkedAt, latest: version });
-    }).catch(() => {
-      this.scheduleRetry(now);
-    }).finally(() => {
-      this.checking = false;
-    });
-  }
-  scheduleRetry(now) {
-    this.retryAt = now + this.backoffMs;
-    this.backoffMs = Math.min(this.backoffMs * 2, MAX_RETRY_MS);
-  }
-  notice() {
-    const latest = this.latest;
-    if (!this.enabled || latest === null || !isNewer(latest, this.current)) {
-      return null;
-    }
-    return {
-      current: this.current,
-      latest,
-      releaseNotes: `${RELEASES}/v${latest}`,
-      upgrade: runLine(currentRunner(), latest, "upgrade")
-    };
-  }
-}
-
 // src/server.ts
 var UPDATE_NOTICE_EVERY = 500;
 var FEEDBACK_NOTICE_EVERY = 250;
@@ -29187,7 +29234,8 @@ class GodotServer {
     ];
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 600000;
     this.logDebug(`Running tests: ${engine.value} ${cmdArgs.join(" ")}`);
-    const run = this.spawnGame(engine.value, cmdArgs);
+    const userData = mkdtempSync2(join7(tmpdir4(), "gdharness-tests-"));
+    const run = this.spawnGame(engine.value, cmdArgs, userDataIn(userData));
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
         run.process.kill();
@@ -29215,6 +29263,7 @@ class GodotServer {
       reportProblem = errorMessage(error);
     } finally {
       rmSync2(reportsDir, { recursive: true, force: true });
+      rmSync2(userData, { recursive: true, force: true });
     }
     const engineEntries = run.log.select({ severity: "warning", sinceLastCall: false, limit: 200 }).entries;
     const verdicts = {
@@ -29325,7 +29374,7 @@ class GodotServer {
       addonIsStale: status.connected ? stale : undefined,
       bridgeAvailable: this.bridgeStartupError === null,
       startupError: this.bridgeStartupError,
-      staleNote: stale ? `The editor is running the ${status.addonVersion === "" ? "addon from before versions were reported" : status.addonVersion} addon while this server ships ${SERVER_VERSION}. Restart it with editor_launch restart to pick the new one up.` : undefined,
+      staleNote: stale ? addonMismatch(status.addonVersion, SERVER_VERSION) : undefined,
       note: isPortConflict ? "Bridge port is already in use. Another gdharness instance may own the editor bridge, so this server cannot report that editor connection." : undefined,
       suggestion: isPortConflict ? "Stop duplicate gdharness/MCP server instances or re-run the command from the same server process that owns the bridge port." : undefined
     };
@@ -29403,6 +29452,7 @@ class GodotServer {
       addonVersion: now.addonVersion,
       serverVersion: SERVER_VERSION,
       addonIsStale: now.addonVersion !== SERVER_VERSION,
+      staleNote: addonMismatch(now.addonVersion, SERVER_VERSION),
       tookMs: Date.now() - began
     });
   }
@@ -29436,7 +29486,8 @@ class GodotServer {
     this.logDebug(`Launching Godot editor for project: ${project.value.path}`);
     const editor = spawn(engine.value, editorArguments(project.value.path), {
       stdio: "ignore",
-      detached: true
+      detached: true,
+      env: { ...process.env, GDHARNESS_RUNTIME_DIR: runtimeDirectory() }
     });
     const started = await new Promise((resolve) => {
       editor.once("spawn", () => {
@@ -29569,8 +29620,8 @@ class GodotServer {
     }
     running.process?.kill();
   }
-  spawnGame(godotPath, cmdArgs) {
-    const child = spawn(godotPath, cmdArgs, { stdio: ["ignore", "pipe", "pipe"] });
+  spawnGame(godotPath, cmdArgs, env) {
+    const child = spawn(godotPath, cmdArgs, { stdio: ["ignore", "pipe", "pipe"], ...env ? { env } : {} });
     const log = new GameLog;
     const started = {
       process: child,