gdharness 0.5.8 → 0.5.10

package/build/index.js

@@ -10126,9 +10126,9 @@ function defectReport(where, error, godotVersion) {
 
 // src/server.ts
 import { execFile as execFile3, spawn } from "node:child_process";
-import { existsSync as existsSync6, mkdtempSync as mkdtempSync2, readdirSync as readdirSync5, readFileSync as readFileSync7, realpathSync as realpathSync2, rmSync as rmSync2 } from "node:fs";
+import { existsSync as existsSync7, mkdtempSync as mkdtempSync2, readdirSync as readdirSync5, readFileSync as readFileSync8, realpathSync as realpathSync2, rmSync as rmSync4 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
-import { basename, dirname as dirname2, join as join7, normalize as normalize2 } from "node:path";
+import { basename, dirname as dirname4, join as join9, normalize as normalize2 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { promisify as promisify3 } from "node:util";
@@ -24696,9 +24696,47 @@ class StdioServerTransport {
   }
 }
 
+// src/bridge-announce.ts
+import { mkdirSync as mkdirSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname, join as join2 } from "node:path";
+function announcementPath(projectPath) {
+  return join2(projectPath, ".godot", "gdharness-bridge.json");
+}
+var BRIDGE_ANNOUNCE_PROTOCOL = 1;
+function announceBridge(projectPath, bridge) {
+  const path = announcementPath(projectPath);
+  try {
+    mkdirSync2(dirname(path), { recursive: true });
+    const announcement = {
+      protocol: BRIDGE_ANNOUNCE_PROTOCOL,
+      host: bridge.host,
+      port: bridge.port,
+      pid: process.pid,
+      version: bridge.version,
+      startedAt: new Date().toISOString()
+    };
+    writeFileSync2(path, `${JSON.stringify(announcement, null, 2)}
+`, "utf8");
+    return path;
+  } catch (error) {
+    console.error(`[SERVER] Could not announce the editor bridge at ${path}: ${errorMessage(error)}`);
+    return null;
+  }
+}
+function withdrawBridge(path) {
+  if (path === null) {
+    return;
+  }
+  try {
+    rmSync(path, { force: true });
+  } catch (error) {
+    console.error(`[SERVER] Could not withdraw the editor bridge announcement: ${errorMessage(error)}`);
+  }
+}
+
 // src/class-cache.ts
 import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "node:fs";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 function declaredClasses(projectPath) {
   const declared = new Map;
   const visit = (directory, prefix) => {
@@ -24706,7 +24744,7 @@ function declaredClasses(projectPath) {
       if (entry.name.startsWith(".")) {
         continue;
       }
-      const path = join2(directory, entry.name);
+      const path = join3(directory, entry.name);
       if (entry.isDirectory()) {
         visit(path, `${prefix}${entry.name}/`);
       } else if (entry.isFile() && entry.name.endsWith(".gd")) {
@@ -24721,7 +24759,7 @@ function declaredClasses(projectPath) {
   return declared;
 }
 function cachedClasses(projectPath) {
-  const cache = join2(projectPath, ".godot", "global_script_class_cache.cfg");
+  const cache = join3(projectPath, ".godot", "global_script_class_cache.cfg");
   if (!existsSync2(cache)) {
     return null;
   }
@@ -24840,6 +24878,10 @@ var DEFAULT_DAP_PORT = 6006;
 var DAP_REQUEST_TIMEOUT_MS = 1e4;
 var SCOPES_TIMEOUT_MS = 20000;
 var VARIABLES_POLL_TIMEOUT_MS = 2000;
+function said(body, field) {
+  const value = body?.[field];
+  return typeof value === "string" ? value : "";
+}
 
 class GodotDAPClient {
   socket = null;
@@ -24854,7 +24896,7 @@ class GodotDAPClient {
   initialized = false;
   attached = false;
   lastThreadId = 1;
-  stopped = false;
+  halt = null;
   breakpoints = new Map;
   constructor(port = portFromEnv("GDHARNESS_DAP_PORT", DEFAULT_DAP_PORT), host = "127.0.0.1") {
     this.port = port;
@@ -24903,7 +24945,7 @@ class GodotDAPClient {
           this.connected = false;
           this.initialized = false;
           this.attached = false;
-          this.stopped = false;
+          this.halt = null;
           this.socket = null;
           this.failPendingRequests(new Error("DAP connection closed"));
         });
@@ -24923,7 +24965,7 @@ class GodotDAPClient {
       this.connected = false;
       this.initialized = false;
       this.attached = false;
-      this.stopped = false;
+      this.halt = null;
       return;
     }
     if (this.connected) {
@@ -24952,7 +24994,7 @@ class GodotDAPClient {
     this.connected = false;
     this.initialized = false;
     this.attached = false;
-    this.stopped = false;
+    this.halt = null;
   }
   async ensureConnected() {
     if (!this.connected) {
@@ -25029,12 +25071,16 @@ class GodotDAPClient {
       if (typeof threadId === "number") {
         this.lastThreadId = threadId;
       }
-      this.stopped = true;
+      this.halt = {
+        reason: said(body, "reason"),
+        description: said(body, "description"),
+        text: said(body, "text")
+      };
       return;
     }
     if (eventName === "terminated" || eventName === "exited") {
       this.attached = false;
-      this.stopped = false;
+      this.halt = null;
     }
   }
   async initialize() {
@@ -25108,7 +25154,7 @@ class GodotDAPClient {
     await this.attach();
     const resolvedThreadId = await this.resolveThreadId(threadId);
     await this.sendRequest("continue", { threadId: resolvedThreadId });
-    this.stopped = false;
+    this.halt = null;
   }
   async stepOver(threadId) {
     await this.attach();
@@ -25179,7 +25225,10 @@ class GodotDAPClient {
     return this.connected;
   }
   isStopped() {
-    return this.stopped;
+    return this.halt !== null;
+  }
+  whereItStopped() {
+    return this.halt;
   }
   async resolveThreadId(threadId) {
     if (typeof threadId === "number" && threadId > 0) {
@@ -25208,7 +25257,7 @@ class GodotDAPClient {
     this.connected = false;
     this.initialized = false;
     this.attached = false;
-    this.stopped = false;
+    this.halt = null;
     this.reader = new FrameReader;
     socket?.destroy();
     this.failPendingRequests(new Error(`Godot DAP ${detail}. The connection was dropped.`));
@@ -25364,6 +25413,16 @@ class GameLog {
     this.entries.push(entry);
     this.lastHeadline = headline ? { index: entry.index, detail } : null;
   }
+  record(severity, text) {
+    this.entries.push({
+      index: this.entries.length,
+      severity,
+      source: "debugger",
+      text,
+      detail: []
+    });
+    this.lastHeadline = null;
+  }
   get all() {
     return this.entries;
   }
@@ -25426,19 +25485,37 @@ class GodotBridge extends EventEmitter {
   connectionInfo = null;
   pendingRequests = new Map;
   resourceQueues = new Map;
-  port;
+  wantedPort;
+  boundPort = null;
   host;
   timeoutMs;
-  constructor(port = DEFAULT_PORT, host = DEFAULT_HOST, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  mayMove;
+  constructor(port = DEFAULT_PORT, host = DEFAULT_HOST, timeoutMs = DEFAULT_TIMEOUT_MS, mayMove = false) {
     super();
-    this.port = port;
+    this.wantedPort = port;
     this.host = host;
     this.timeoutMs = timeoutMs;
+    this.mayMove = mayMove;
+  }
+  get port() {
+    return this.boundPort ?? this.wantedPort;
   }
-  start() {
+  async start() {
     if (this.httpServer) {
-      return Promise.resolve();
+      return;
+    }
+    try {
+      await this.listenOn(this.wantedPort);
+    } catch (error) {
+      const held = error instanceof Error && "code" in error && error.code === "EADDRINUSE";
+      if (!held || !this.mayMove) {
+        throw error;
+      }
+      this.log("warn", `Editor bridge port ${this.wantedPort} is held; taking another one.`);
+      await this.listenOn(0);
     }
+  }
+  listenOn(port) {
     return new Promise((resolve, reject) => {
       const server = http.createServer((_req, res) => {
         res.writeHead(404);
@@ -25462,6 +25539,8 @@ class GodotBridge extends EventEmitter {
         settled = true;
         this.httpServer = server;
         this.godotWss = godotWss;
+        const bound = server.address();
+        this.boundPort = typeof bound === "object" && bound !== null ? bound.port : port;
         this.log("info", `Editor bridge listening on ${this.host}:${this.port}`);
         resolve();
       });
@@ -25478,7 +25557,7 @@ class GodotBridge extends EventEmitter {
       godotWss.on("error", (error) => {
         this.log("error", `Godot WebSocket server error: ${error.message}`);
       });
-      server.listen(this.port, this.host);
+      server.listen(port, this.host);
     });
   }
   async stop() {
@@ -25512,6 +25591,7 @@ class GodotBridge extends EventEmitter {
       this.httpServer = null;
     }
     await Promise.all(closeTasks);
+    this.boundPort = null;
     this.connectionInfo = null;
     this.log("info", "WebSocket bridge stopped");
   }
@@ -25813,8 +25893,8 @@ class GodotBridge extends EventEmitter {
   }
 }
 var defaultBridge = null;
-function getDefaultBridge() {
-  defaultBridge ??= new GodotBridge(resolveDefaultBridgePort(), resolveDefaultBridgeHost());
+function getDefaultBridge(mayMove = false) {
+  defaultBridge ??= new GodotBridge(resolveDefaultBridgePort(), resolveDefaultBridgeHost(), DEFAULT_TIMEOUT_MS, mayMove);
   return defaultBridge;
 }
 
@@ -25827,7 +25907,7 @@ import { promisify } from "node:util";
 // src/detection.ts
 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";
+import { join as join4 } from "node:path";
 function resolveHomeDirectory() {
   try {
     return homedir2();
@@ -25851,7 +25931,7 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     if (!pattern.test(name)) {
       continue;
     }
-    const fullPath = join3(directory, name);
+    const fullPath = join4(directory, name);
     try {
       const stat = statSync(fullPath);
       if (stat.isFile()) {
@@ -25860,7 +25940,7 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     } catch {}
   }
   matches.sort((a, b) => b.mtime - a.mtime);
-  return matches.map((m) => join3(directory, m.name));
+  return matches.map((m) => join4(directory, m.name));
 }
 function conventionalPaths(platform, home) {
   const paths = ["godot"];
@@ -26003,9 +26083,9 @@ class GodotLocator {
 
 // src/headless.ts
 import { execFile as execFile2 } from "node:child_process";
-import { mkdtempSync, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { mkdtempSync, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 var run2 = promisify2(execFile2);
 function snakeCased(params) {
@@ -26046,9 +26126,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(join4(tmpdir2(), "gdharness-params-"));
-  const paramsFile = join4(paramsDir, `${operation}.json`);
-  writeFileSync2(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
+  const paramsDir = mkdtempSync(join5(tmpdir2(), "gdharness-params-"));
+  const paramsFile = join5(paramsDir, `${operation}.json`);
+  writeFileSync3(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
   const args = [
     "--headless",
     "--path",
@@ -26078,7 +26158,7 @@ async function runOperation(engine, operation, params, projectPath) {
       messages: []
     };
   } finally {
-    rmSync(paramsDir, { recursive: true, force: true });
+    rmSync2(paramsDir, { recursive: true, force: true });
   }
   const payload = lastJsonObject(stdout);
   if (payload === null) {
@@ -26373,7 +26453,7 @@ function parseJUnit(xml) {
 import { realpathSync } from "node:fs";
 import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection2 } from "node:net";
-import { dirname, resolve as resolve2 } from "node:path";
+import { dirname as dirname2, resolve as resolve2 } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 // src/paths.ts
@@ -26551,7 +26631,7 @@ class GodotLSPClient {
     if (this.initialized) {
       return;
     }
-    const rootPath = this.rootPath ?? dirname(resolve2(filePath));
+    const rootPath = this.rootPath ?? dirname2(resolve2(filePath));
     await this.initialize(rootPath);
   }
   async sendRequest(method, params) {
@@ -26919,7 +26999,7 @@ async function handleLSPTool(client, toolName, args) {
 
 // src/project-scan.ts
 import { readdirSync as readdirSync3, readFileSync as readFileSync4 } from "node:fs";
-import { join as join5 } from "node:path";
+import { join as join6 } 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) {
@@ -26930,7 +27010,7 @@ function projectStructure(projectPath) {
         continue;
       }
       if (entry.isDirectory()) {
-        visit(join5(directory, entry.name));
+        visit(join6(directory, entry.name));
       } else if (entry.isFile()) {
         const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
         if (extension === "tscn") {
@@ -26972,7 +27052,7 @@ function searchProject(projectPath, options) {
       if (SKIPPED.has(entry.name)) {
         continue;
       }
-      const entryPath = join5(directory, entry.name);
+      const entryPath = join6(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -27226,7 +27306,7 @@ function setupResourceHandlers(mcp, getProjectPath) {
 import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync6, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join6, resolve as resolve4 } from "node:path";
+import { join as join7, resolve as resolve4 } from "node:path";
 
 // src/tool-args.ts
 function asParams(value) {
@@ -27288,13 +27368,13 @@ function runtimeDirectory(variables = process.env) {
     return explicit;
   }
   const perUser = envValue("XDG_RUNTIME_DIR", variables);
-  return join6(perUser ?? tmpdir3(), "gdharness");
+  return join7(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"));
+    candidates.push(join7(base, process.platform === "win32" ? "Temp" : "", "gdharness"));
   }
   return [...new Set(candidates.map((path) => resolve4(path)))];
 }
@@ -27357,7 +27437,7 @@ function announcedIn(directory) {
     if (!match) {
       continue;
     }
-    const file = join6(directory, entry);
+    const file = join7(directory, entry);
     const pid = Number.parseInt(match[1] ?? "", 10);
     const announced = processAlive(pid) ? parseAnnouncement(file, pid) : { kind: "rubbish" };
     if (announced.kind === "rubbish") {
@@ -27498,6 +27578,20 @@ function runtimeRequest(endpoint, command, params, timeoutMs) {
   });
 }
 
+// src/setup.ts
+import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname3, join as join8 } from "node:path";
+var ADDONS = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
+var VERSION_MARKER = ".gdharness-version";
+function installedAddonVersion(projectPath) {
+  const marker = join8(projectPath, "addons", ADDONS[0], VERSION_MARKER);
+  if (!existsSync6(marker)) {
+    return null;
+  }
+  const said = readFileSync7(marker, "utf8").trim();
+  return said === "" ? null : said;
+}
+
 // src/tool-definitions.ts
 var PROJECT_PATH = {
   type: "string",
@@ -28413,7 +28507,7 @@ function buildToolDefinitions() {
 var UPDATE_NOTICE_EVERY = 500;
 var FEEDBACK_NOTICE_EVERY = 250;
 var run3 = promisify3(execFile3);
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var __dirname2 = dirname4(fileURLToPath2(import.meta.url));
 var EDITOR_RESTART_TIMEOUT_MS = 90000;
 var BRIDGE_RETRY_MS = 2000;
 var PATH_SOLUTIONS = [
@@ -28491,11 +28585,11 @@ function realPathOr(path) {
   }
 }
 function hasMainScene(projectFile) {
-  const scene = parseProjectGodot(readFileSync7(projectFile, "utf8"))["application"]?.["run/main_scene"];
+  const scene = parseProjectGodot(readFileSync8(projectFile, "utf8"))["application"]?.["run/main_scene"];
   return typeof scene === "string" && scene !== "";
 }
 function editorPlaysHeadless(projectFile) {
-  const runArgs = parseProjectGodot(readFileSync7(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
+  const runArgs = parseProjectGodot(readFileSync8(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
   return typeof runArgs === "string" && /(?:^|\s)--headless(?:\s|$)/.test(runArgs);
 }
 function camelCased(params) {
@@ -28511,7 +28605,7 @@ function camelCased(params) {
 class GodotServer {
   mcp;
   locator = new GodotLocator;
-  operationsScript = join7(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join9(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -28525,8 +28619,11 @@ class GodotServer {
   bridgeRetry = null;
   lastProjectPath = null;
   shutdownInitiated = false;
+  ownProject;
+  announcedAt = null;
   constructor() {
-    this.godotBridge = getDefaultBridge();
+    this.ownProject = envValue("GDHARNESS_PROJECT") ?? null;
+    this.godotBridge = getDefaultBridge(this.ownProject !== null);
     this.mcp = new McpServer({ name: "gdharness", version: SERVER_VERSION }, { capabilities: { tools: {}, resources: {} } });
     this.setupToolHandlers();
     setupResourceHandlers(this.mcp, () => this.lastProjectPath);
@@ -28574,6 +28671,7 @@ class GodotServer {
       this.bridgeStartupError = null;
       const bridgeStatus = this.godotBridge.getStatus();
       console.error(`[SERVER] Godot Editor Bridge started on ${bridgeStatus.host}:${bridgeStatus.port}`);
+      this.announceTheBridge();
     } catch (bridgeError) {
       const code = bridgeError instanceof Error && "code" in bridgeError && typeof bridgeError.code === "string" ? bridgeError.code : null;
       const reason = errorMessage(bridgeError);
@@ -28606,6 +28704,18 @@ class GodotServer {
     this.stopTryingTheBridge();
     const bridgeStatus = this.godotBridge.getStatus();
     console.error(`[SERVER] Godot Editor Bridge came up on ${bridgeStatus.host}:${bridgeStatus.port}; editor tools are live.`);
+    this.announceTheBridge();
+  }
+  announceTheBridge() {
+    if (this.ownProject === null) {
+      return;
+    }
+    const status = this.godotBridge.getStatus();
+    this.announcedAt = announceBridge(this.ownProject, {
+      host: status.host,
+      port: status.port,
+      version: SERVER_VERSION
+    });
   }
   stopTryingTheBridge() {
     if (this.bridgeRetry !== null) {
@@ -28616,6 +28726,8 @@ class GodotServer {
   async cleanup() {
     this.logDebug("Cleaning up resources");
     this.stopTryingTheBridge();
+    withdrawBridge(this.announcedAt);
+    this.announcedAt = null;
     if (this.activeProcess) {
       this.activeProcess.process?.kill();
       this.activeProcess = null;
@@ -28731,28 +28843,44 @@ class GodotServer {
     if (this.callsSinceNotice < UPDATE_NOTICE_EVERY && this.noticedUpdate) {
       return answer;
     }
+    const moved = this.projectHasMovedOn();
+    if (moved !== null) {
+      this.noticedUpdate = true;
+      this.callsSinceNotice = 0;
+      return this.saying(answer, {
+        project_upgraded_under_this_server: {
+          server_is: SERVER_VERSION,
+          project_is: moved,
+          what_to_do: "The project was upgraded while this server has been running, so it is still answering " + "as the version it was started as. Tell the user to reconnect the MCP server, which is " + "the only thing that replaces it: a server cannot restart itself."
+        }
+      });
+    }
     const notice = this.updates.notice();
     if (notice === null) {
       return answer;
     }
     this.noticedUpdate = true;
     this.callsSinceNotice = 0;
+    return this.saying(answer, {
+      update_available: {
+        ...notice,
+        what_to_do: "Tell the user a newer gdharness is out, with what changed, and offer to take it. " + "Only run the upgrade command if they say yes: it restarts their editor and the " + "MCP server has to be reconnected afterwards."
+      }
+    });
+  }
+  saying(answer, block) {
     return {
       ...answer,
-      content: [
-        ...answer.content,
-        {
-          type: "text",
-          text: JSON.stringify({
-            update_available: {
-              ...notice,
-              what_to_do: "Tell the user a newer gdharness is out, with what changed, and offer to take it. " + "Only run the upgrade command if they say yes: it restarts their editor and the " + "MCP server has to be reconnected afterwards."
-            }
-          }, null, 2)
-        }
-      ]
+      content: [...answer.content, { type: "text", text: JSON.stringify(block, null, 2) }]
     };
   }
+  projectHasMovedOn() {
+    if (this.ownProject === null) {
+      return null;
+    }
+    const installed = installedAddonVersion(this.ownProject);
+    return installed === null || installed === SERVER_VERSION ? null : installed;
+  }
   withFeedbackNotice(answer) {
     this.callsSinceFeedback += 1;
     if (this.callsSinceFeedback < FEEDBACK_NOTICE_EVERY) {
@@ -28998,8 +29126,8 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join7(path, "project.godot");
-    if (!existsSync6(file)) {
+    const file = join9(path, "project.godot");
+    if (!existsSync7(file)) {
       return {
         ok: false,
         response: this.createErrorResponse(`Not a Godot project: ${path}`, [
@@ -29144,7 +29272,7 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const application = parseProjectGodot(readFileSync7(project.value.file, "utf8"))["application"] ?? {};
+    const application = parseProjectGodot(readFileSync8(project.value.file, "utf8"))["application"] ?? {};
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
@@ -29233,7 +29361,7 @@ class GodotServer {
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
     const verdict = {
-      exported: exitCode === 0 && log.count("error") === 0 && existsSync6(output.absolutePath),
+      exported: exitCode === 0 && log.count("error") === 0 && existsSync7(output.absolutePath),
       preset,
       outputPath: output.relativePath,
       debug,
@@ -29263,7 +29391,7 @@ class GodotServer {
       return contained.response;
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync6(join7(project.value.path, runner))) {
+    if (!existsSync7(join9(project.value.path, runner))) {
       return this.createErrorResponse(`gdUnit4 is not installed in this project: no ${runner}.`, [
         "Install gdUnit4 under addons/gdUnit4, from https://github.com/godot-gdunit-labs/gdUnit4"
       ]);
@@ -29296,7 +29424,7 @@ class GodotServer {
     ];
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 600000;
     this.logDebug(`Running tests: ${engine.value} ${cmdArgs.join(" ")}`);
-    const userData = mkdtempSync2(join7(tmpdir4(), "gdharness-tests-"));
+    const userData = mkdtempSync2(join9(tmpdir4(), "gdharness-tests-"));
     const run = this.spawnGame(engine.value, cmdArgs, userDataIn(userData));
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -29312,20 +29440,20 @@ class GodotServer {
         resolve(false);
       });
     });
-    const reportsDir = join7(project.value.path, ".godot", "gdharness-reports");
+    const reportsDir = join9(project.value.path, ".godot", "gdharness-reports");
     let report = null;
     let reportProblem = null;
     try {
-      const written = existsSync6(reportsDir) ? readdirSync5(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
+      const written = existsSync7(reportsDir) ? readdirSync5(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
-        report = parseJUnit(readFileSync7(join7(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync8(join9(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
     } finally {
-      rmSync2(reportsDir, { recursive: true, force: true });
-      rmSync2(userData, { recursive: true, force: true });
+      rmSync4(reportsDir, { recursive: true, force: true });
+      rmSync4(userData, { recursive: true, force: true });
     }
     const engineEntries = run.log.select({ severity: "warning", sinceLastCall: false, limit: 200 }).entries;
     const verdicts = {
@@ -29438,6 +29566,8 @@ class GodotServer {
       startupError: this.bridgeStartupError,
       staleNote: stale ? addonMismatch(status.addonVersion, SERVER_VERSION) : undefined,
       retryingBridge: this.bridgeRetry === null ? undefined : true,
+      announcedAt: this.announcedAt ?? undefined,
+      projectIs: this.projectHasMovedOn() ?? undefined,
       note: isPortConflict ? "Bridge port is already in use. Another gdharness instance owns the editor bridge, so this server cannot reach the editor. Usually the server this one replaced, still on its way out." : undefined,
       suggestion: isPortConflict ? `This server is asking for the port again every ${BRIDGE_RETRY_MS / 1000}s and takes it the moment the other one lets go, so editor tools come back on their own. Ask again, or end the older gdharness process to have it now.` : undefined
     };
@@ -29650,7 +29780,8 @@ class GodotServer {
       log,
       startedAt: Date.now(),
       exitCode: null,
-      throughEditor: true
+      throughEditor: true,
+      brokeOn: null
     };
     this.activeProcess = played;
     return this.jsonTextResponse({
@@ -29670,6 +29801,15 @@ class GodotServer {
 `) ? line : `${line}
 `);
     }
+    this.recordWhatItBrokeOn(game);
+  }
+  recordWhatItBrokeOn(game) {
+    const halt = this.dapClient?.whereItStopped() ?? null;
+    if (halt?.reason !== "exception" || halt.text === "" || game.brokeOn === halt.text) {
+      return;
+    }
+    game.brokeOn = halt.text;
+    game.log.record("error", halt.text);
   }
   async endActiveGame() {
     const running = this.activeProcess;
@@ -29691,7 +29831,8 @@ class GodotServer {
       log,
       startedAt: Date.now(),
       exitCode: null,
-      throughEditor: false
+      throughEditor: false,
+      brokeOn: null
     };
     child.stdout.on("data", (data) => {
       log.append("stdout", data);
@@ -29756,6 +29897,7 @@ class GodotServer {
       contains: readNonEmptyString(args, "contains"),
       limit: readPositiveNumber(args, "limit") ?? 200
     });
+    const halt = this.activeProcess.throughEditor ? this.dapClient?.whereItStopped() ?? null : null;
     return this.jsonTextResponse({
       running: this.activeProcess.exitCode === null,
       exitCode: this.activeProcess.exitCode,
@@ -29764,6 +29906,7 @@ class GodotServer {
       errors: this.activeProcess.log.count("error"),
       warnings: this.activeProcess.log.count("warning"),
       clean: this.activeProcess.log.count("error") === 0,
+      heldAt: halt,
       omitted: selected.omitted,
       entries: selected.entries
     });
@@ -29833,8 +29976,8 @@ class GodotServer {
       return this.createErrorResponse(choice.problem);
     }
     const expectsScreenshot = command === "capture_screenshot" || command === "capture_viewport";
-    const screenshotDir = expectsScreenshot ? mkdtempSync2(join7(tmpdir4(), "gdharness-runtime-screenshot-")) : null;
-    const screenshotPath = screenshotDir ? join7(screenshotDir, "capture.png") : null;
+    const screenshotDir = expectsScreenshot ? mkdtempSync2(join9(tmpdir4(), "gdharness-runtime-screenshot-")) : null;
+    const screenshotPath = screenshotDir ? join9(screenshotDir, "capture.png") : null;
     try {
       const reply = await runtimeRequest(choice.endpoint, command, screenshotPath ? { ...params, output_path: screenshotPath } : params, timeoutMs);
       if (!reply.ok) {
@@ -29855,12 +29998,12 @@ class GodotServer {
       return {
         content: [
           { type: "text", text: `Screenshot captured: ${dimensions}` },
-          { type: "image", data: readFileSync7(screenshotPath).toString("base64"), mimeType: "image/png" }
+          { type: "image", data: readFileSync8(screenshotPath).toString("base64"), mimeType: "image/png" }
         ]
       };
     } finally {
       if (screenshotDir) {
-        rmSync2(screenshotDir, { recursive: true, force: true });
+        rmSync4(screenshotDir, { recursive: true, force: true });
       }
     }
   }