gdharness 0.13.30 → 0.13.32

package/build/cli.js

@@ -7489,8 +7489,8 @@ function addonMismatch(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}.`;
+  const editor = reported === "" ? UNVERSIONED : `the ${reported} addon`;
+  const both = `The editor is running ${editor} 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}.`;
   }
@@ -7503,7 +7503,7 @@ function markIfStale(answer, addonVersion, serverVersion) {
   }
   return { ...answer, addonIsStale: true, staleNote };
 }
-var DEBUG_MODE, GODOT_DEBUG_MODE_DEFAULT, SERVER_VERSION, UNVERSIONED = "addon from before versions were reported";
+var DEBUG_MODE, GODOT_DEBUG_MODE_DEFAULT, SERVER_VERSION, UNVERSIONED = "an addon from before versions were reported";
 var init_server_version = __esm(() => {
   init_update_check();
   DEBUG_MODE = process.env["DEBUG"] === "true";
@@ -7535,7 +7535,7 @@ function declaredClasses(projectPath) {
       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(readFileSync5(path, "utf8"));
+        const found = DECLARATION.exec(readFileSync5(path, "utf8"));
         if (found?.[1]) {
           declared.set(found[1], `res://${prefix}${entry.name}`);
         }
@@ -7656,9 +7656,12 @@ function heldButGone(projectPath, editorHolds) {
 }
 function unseenByEditor(projectPath, editorHolds) {
   const held = new Set(editorHolds);
-  return [...declaredClasses(projectPath)].filter(([name]) => !held.has(name)).map(([className, path]) => ({ className, path }));
+  return [...declaredClasses(projectPath)].filter(([name]) => !held.has(name)).map(([className, path]) => ({ className, path })).sort((one, other) => one.className < other.className ? -1 : one.className > other.className ? 1 : 0);
 }
-var init_class_cache = () => {};
+var DECLARATION;
+var init_class_cache = __esm(() => {
+  DECLARATION = /^(?:@[a-z_]+(?:\([^)\n]*\))?\s+)*class_name\s+([A-Za-z_][A-Za-z0-9_]*)/m;
+});
 
 // src/headless.ts
 import { execFile as execFile3 } from "node:child_process";
@@ -15249,6 +15252,30 @@ function readParams(params, key) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
 }
 
+// src/setup.ts
+import { cpSync as cpSync2, existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync8, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { dirname as dirname4, join as join9 } from "node:path";
+function installedAddonVersion(projectPath) {
+  const marker = join9(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
+  if (!existsSync8(marker)) {
+    return null;
+  }
+  const said = readFileSync8(marker, "utf8").trim();
+  return said === "" ? null : said;
+}
+var ADDONS2, RUNTIME_AUTOLOAD2, SCRIPT_RUNS_SETTING = "gdharness/runtime/serve_script_runs", BIND_ADDRESS_SETTING = "gdharness/runtime/bind_address", PORT_SETTING = "gdharness/runtime/port", VERSION_MARKER2 = ".gdharness-version";
+var init_setup = __esm(() => {
+  init_class_cache();
+  init_headless();
+  init_resources();
+  init_server_version();
+  ADDONS2 = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
+  RUNTIME_AUTOLOAD2 = {
+    name: "GdharnessRuntime",
+    path: "addons/gdharness_runtime/runtime_autoload.gd"
+  };
+});
+
 // src/tool-definitions.ts
 function opTakes(spec, op, name) {
   const ops = spec.parameters[name]?.ops;
@@ -15566,7 +15593,7 @@ var init_tool_definitions = __esm(() => {
         direction: {
           type: "string",
           enum: ["forward", "reverse"],
-          description: "forward: what this resource loads, with cycles reported. reverse: every file that refers to it and how, a scene instancing it, a script extending, preloading or loading it, and for a script with a class_name every use of that name. Default forward."
+          description: "forward: what this resource loads, with cycles reported. reverse: every file that refers to it and how, a scene instancing it, a script extending, preloading or loading it, and for a script with a class_name every use of that name. Each reference carries a kind, and two of them are mentions rather than uses: doc is a name inside a ## documentation comment, which renaming would break in the generated docs, and comment is one in ordinary prose, which it would only make stale. summary.in_code is the count with both of those left out, which is the number to read when the question is whether anything still uses this. Default forward."
         },
         depth: { type: "number", description: "forward: how many levels to follow. Default unlimited." },
         includeBuiltin: {
@@ -15836,7 +15863,7 @@ var init_tool_definitions = __esm(() => {
         scriptPath: SCRIPT_PATH,
         includeInherited: {
           type: "boolean",
-          description: "structure: include inherited members. Default false."
+          description: "structure: also list what the script inherits, walking extends through the project's other scripts. Each such member carries inherited_from, the file declaring it, and the answer gains inherits_from, the chain that was walked. A name the script overrides is listed at both its lines rather than once. A native base is not walked, since it declares nothing in a file: editor_classes info answers for those. Default false."
         },
         line: { type: "number", description: "completion, hover: zero-based line." },
         character: { type: "number", description: "completion, hover: zero-based column." }
@@ -15934,7 +15961,7 @@ var init_tool_definitions = __esm(() => {
         runtimeWaitMs: {
           type: "number",
           ops: ["start"],
-          description: "start: how long to wait for the game to announce its runtime before answering. Default 5000. Worth raising for a project that takes longer than that to reach its first frame, which is what leaves runtime listening false on a game whose runtime arrives a moment later. 0 does not wait at all, which is the one to pass for a scene that announces nothing by construction, such as a bench that prints and quits."
+          description: "start: how long to wait for the game to announce its runtime before answering. Default 5000. What it waits for is the first frame, so everything the game does before drawing one is inside it, including work the args just asked for: a flag that simulates six years of game time before anything is drawn makes the announcement that late, on a project that announces promptly without it. Raise it for such a run rather than reading runtime listening false as a fault. 0 does not wait at all, which is the one to pass for a scene that announces nothing by construction, such as a bench that prints and quits."
         },
         frames: {
           type: "number",
@@ -31118,14 +31145,14 @@ var init_stdio2 = __esm(() => {
 });
 
 // src/bridge-announce.ts
-import { mkdirSync as mkdirSync5, readFileSync as readFileSync9, rmSync as rmSync5, writeFileSync as writeFileSync7 } from "node:fs";
-import { dirname as dirname6, join as join11 } from "node:path";
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync10, rmSync as rmSync6, writeFileSync as writeFileSync8 } from "node:fs";
+import { dirname as dirname7, join as join12 } from "node:path";
 function announcementPath(projectPath) {
-  return join11(projectPath, ".godot", "gdharness-bridge.json");
+  return join12(projectPath, ".godot", "gdharness-bridge.json");
 }
 function readAnnouncement(path) {
   try {
-    const parsed = JSON.parse(readFileSync9(path, "utf8"));
+    const parsed = JSON.parse(readFileSync10(path, "utf8"));
     if (typeof parsed !== "object" || parsed === null) {
       return null;
     }
@@ -31144,7 +31171,7 @@ function announcementIsOurs(path) {
 function announceBridge(projectPath, bridge) {
   const path = announcementPath(projectPath);
   try {
-    mkdirSync5(dirname6(path), { recursive: true });
+    mkdirSync6(dirname7(path), { recursive: true });
     const announcement = {
       protocol: BRIDGE_ANNOUNCE_PROTOCOL,
       host: bridge.host,
@@ -31153,7 +31180,7 @@ function announceBridge(projectPath, bridge) {
       version: bridge.version,
       startedAt: new Date().toISOString()
     };
-    writeFileSync7(path, `${JSON.stringify(announcement, null, 2)}
+    writeFileSync8(path, `${JSON.stringify(announcement, null, 2)}
 `, "utf8");
     return path;
   } catch (error) {
@@ -31166,7 +31193,7 @@ function withdrawBridge(path) {
     return;
   }
   try {
-    rmSync5(path, { force: true });
+    rmSync6(path, { force: true });
   } catch (error) {
     console.error(`[SERVER] Could not withdraw the editor bridge announcement: ${errorMessage(error)}`);
   }
@@ -31177,16 +31204,16 @@ var init_bridge_announce = __esm(() => {
 });
 
 // src/config-pin.ts
-import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
-import { join as join12 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "node:fs";
+import { join as join13 } from "node:path";
 function versionsNamedInConfig(projectPath) {
-  const config = join12(projectPath, ".mcp.json");
-  if (!existsSync9(config)) {
+  const config = join13(projectPath, ".mcp.json");
+  if (!existsSync10(config)) {
     return [];
   }
   let text;
   try {
-    text = readFileSync10(config, "utf8");
+    text = readFileSync11(config, "utf8");
     JSON.parse(text);
   } catch {
     return [];
@@ -34727,6 +34754,9 @@ function servedPort(said) {
 function mayYetConnect(listeningSince, now = Date.now()) {
   return listeningSince === undefined || now - listeningSince.getTime() < CONNECT_WINDOW_MS;
 }
+function theEditorHasComeBack(status, startedAt) {
+  return status.connected && (status.connectedAt?.getTime() ?? 0) > startedAt && status.addonVersion !== undefined;
+}
 function anEditorIsStillComing(listeningSince, launchedEditorIsAlive, now = Date.now()) {
   return mayYetConnect(listeningSince, now) || launchedEditorIsAlive;
 }
@@ -35192,7 +35222,7 @@ var init_godot_bridge = __esm(() => {
 
 // src/godot-path.ts
 import { execFile as execFile4 } from "node:child_process";
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { normalize as normalize2 } from "node:path";
 import { promisify as promisify4 } from "node:util";
 var run4, GodotLocator2;
@@ -35234,7 +35264,7 @@ var init_godot_path = __esm(() => {
         return known;
       }
       let ok = false;
-      if (path === "godot" || existsSync10(path)) {
+      if (path === "godot" || existsSync11(path)) {
         try {
           await run4(path, ["--version"]);
           ok = true;
@@ -35582,7 +35612,7 @@ var init_junit = __esm(() => {
 import { realpathSync as realpathSync2 } from "node:fs";
 import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection2 } from "node:net";
-import { dirname as dirname7, resolve as resolve3 } from "node:path";
+import { dirname as dirname8, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
 function diagnosticsKey(uri) {
   let decoded;
@@ -35710,7 +35740,7 @@ class GodotLSPClient {
     if (this.initialized) {
       return;
     }
-    const rootPath = this.rootPath ?? dirname7(resolve3(filePath));
+    const rootPath = this.rootPath ?? dirname8(resolve3(filePath));
     await this.initialize(rootPath);
   }
   async sendRequest(method, params) {
@@ -36155,13 +36185,13 @@ var init_process_time = __esm(() => {
 });
 
 // src/project-scan.ts
-import { existsSync as existsSync11, readdirSync as readdirSync4, readFileSync as readFileSync11 } from "node:fs";
-import { join as join13 } from "node:path";
+import { existsSync as existsSync12, readdirSync as readdirSync4, readFileSync as readFileSync12 } from "node:fs";
+import { join as join14 } from "node:path";
 function skipped(name) {
   return name.startsWith(".") || SKIPPED.has(name);
 }
 function steppedOver(directory) {
-  return existsSync11(join13(directory, ".gdignore"));
+  return existsSync12(join14(directory, ".gdignore"));
 }
 function projectStructure(projectPath) {
   const structure = { scenes: 0, scripts: 0, assets: 0, other: 0 };
@@ -36174,7 +36204,7 @@ function projectStructure(projectPath) {
         continue;
       }
       if (entry.isDirectory()) {
-        visit(join13(directory, entry.name));
+        visit(join14(directory, entry.name));
       } else if (entry.isFile()) {
         const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
         if (extension === "tscn") {
@@ -36204,14 +36234,14 @@ function scriptsWithoutUid(projectPath) {
       }
       const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
       if (entry.isDirectory()) {
-        visit(join13(directory, entry.name), spelled);
+        visit(join14(directory, entry.name), spelled);
         continue;
       }
       if (!entry.isFile()) {
         continue;
       }
       const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
-      if (CARRIES_A_UID.has(extension) && !existsSync11(join13(directory, `${entry.name}.uid`))) {
+      if (CARRIES_A_UID.has(extension) && !existsSync12(join14(directory, `${entry.name}.uid`))) {
         found.push(spelled);
       }
     }
@@ -36246,7 +36276,7 @@ function searchProject(projectPath, options) {
       if (skipped(entry.name)) {
         continue;
       }
-      const entryPath = join13(directory, entry.name);
+      const entryPath = join14(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -36257,7 +36287,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync11(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync12(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -36286,10 +36316,10 @@ var init_project_scan = __esm(() => {
 });
 
 // src/runtime-client.ts
-import { existsSync as existsSync12, readdirSync as readdirSync5, readFileSync as readFileSync12, unlinkSync } from "node:fs";
+import { existsSync as existsSync13, readdirSync as readdirSync5, readFileSync as readFileSync13, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join14, resolve as resolve4 } from "node:path";
+import { join as join15, resolve as resolve4 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 function runtimeDirectory(variables = process.env) {
   const explicit = envValue("GDHARNESS_RUNTIME_DIR", variables);
@@ -36297,13 +36327,13 @@ function runtimeDirectory(variables = process.env) {
     return explicit;
   }
   const perUser = envValue("XDG_RUNTIME_DIR", variables);
-  return join14(perUser ?? tmpdir4(), "gdharness");
+  return join15(perUser ?? tmpdir4(), "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(join14(base, process.platform === "win32" ? "Temp" : "", "gdharness"));
+    candidates.push(join15(base, process.platform === "win32" ? "Temp" : "", "gdharness"));
   }
   return [...new Set(candidates.map((path) => resolve4(path)))];
 }
@@ -36318,7 +36348,7 @@ function processAlive(pid) {
 function parseAnnouncement(file, pid) {
   let fields;
   try {
-    fields = asParams(JSON.parse(readFileSync12(file, "utf8")));
+    fields = asParams(JSON.parse(readFileSync13(file, "utf8")));
   } catch {
     return { kind: "rubbish" };
   }
@@ -36357,7 +36387,7 @@ function discoverRuntimes(directories = runtimeDirectories()) {
   return runtimesAnnounced(directories).running;
 }
 function announcedIn(directory) {
-  if (!existsSync12(directory)) {
+  if (!existsSync13(directory)) {
     return [];
   }
   const found = [];
@@ -36366,7 +36396,7 @@ function announcedIn(directory) {
     if (!match) {
       continue;
     }
-    const file = join14(directory, entry);
+    const file = join15(directory, entry);
     const pid = Number.parseInt(match[1] ?? "", 10);
     const announced = processAlive(pid) ? parseAnnouncement(file, pid) : { kind: "rubbish" };
     if (announced.kind === "rubbish") {
@@ -36528,36 +36558,36 @@ var init_runtime_client = __esm(() => {
 
 // src/run-record.ts
 import { execFileSync } from "node:child_process";
-import { mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync6, readFileSync as readFileSync13, rmSync as rmSync6, statSync as statSync3, writeFileSync as writeFileSync8 } from "node:fs";
-import { basename as basename2, join as join15 } from "node:path";
+import { mkdirSync as mkdirSync7, openSync, readdirSync as readdirSync6, readFileSync as readFileSync14, rmSync as rmSync7, statSync as statSync3, writeFileSync as writeFileSync9 } from "node:fs";
+import { basename as basename2, join as join16 } from "node:path";
 function runsDirectory() {
-  return join15(runtimeDirectory(), "runs");
+  return join16(runtimeDirectory(), "runs");
 }
 function recordPath() {
-  return join15(runsDirectory(), "run.json");
+  return join16(runsDirectory(), "run.json");
 }
 function recordPaths() {
-  return runtimeDirectories().map((directory) => join15(directory, "runs", "run.json"));
+  return runtimeDirectories().map((directory) => join16(directory, "runs", "run.json"));
 }
 function openTranscript(startedAt) {
-  mkdirSync6(runsDirectory(), { recursive: true });
-  const path = join15(runsDirectory(), `run-${startedAt}.log`);
+  mkdirSync7(runsDirectory(), { recursive: true });
+  const path = join16(runsDirectory(), `run-${startedAt}.log`);
   return { path, fd: openSync(path, "a") };
 }
 function writeRunRecord(record) {
-  mkdirSync6(runsDirectory(), { recursive: true });
-  writeFileSync8(recordPath(), JSON.stringify(record, null, 2), "utf8");
+  mkdirSync7(runsDirectory(), { recursive: true });
+  writeFileSync9(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
 function editorNotePath() {
-  return join15(runsDirectory(), "editor-run.json");
+  return join16(runsDirectory(), "editor-run.json");
 }
 function writeEditorRunNote(note) {
-  mkdirSync6(runsDirectory(), { recursive: true });
-  writeFileSync8(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
+  mkdirSync7(runsDirectory(), { recursive: true });
+  writeFileSync9(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
 }
 function readEditorRunNote() {
   for (const directory of runtimeDirectories()) {
-    const note = editorNoteAt(join15(directory, "runs", "editor-run.json"));
+    const note = editorNoteAt(join16(directory, "runs", "editor-run.json"));
     if (note !== null) {
       return note;
     }
@@ -36567,7 +36597,7 @@ function readEditorRunNote() {
 function editorNoteAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync13(path, "utf8"));
+    parsed = JSON.parse(readFileSync14(path, "utf8"));
   } catch {
     return null;
   }
@@ -36590,7 +36620,7 @@ function recordRunEnded(pid, exitCode) {
     return;
   }
   try {
-    writeFileSync8(path, JSON.stringify({ ...record, exitCode }, null, 2), "utf8");
+    writeFileSync9(path, JSON.stringify({ ...record, exitCode }, null, 2), "utf8");
   } catch {}
 }
 function readRunRecord() {
@@ -36605,7 +36635,7 @@ function readRunRecord() {
 function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync13(path, "utf8"));
+    parsed = JSON.parse(readFileSync14(path, "utf8"));
   } catch {
     return null;
   }
@@ -36641,7 +36671,7 @@ function runningAs(pid) {
   }
   try {
     if (process.platform === "linux") {
-      const raw = readFileSync13(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
+      const raw = readFileSync14(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
       return raw === "" ? null : { kind: "commandLine", text: raw };
     }
     const args = execFileSync("ps", ["-p", String(pid), "-o", "args="], {
@@ -36738,7 +36768,7 @@ function clearRunRecord(ours = () => true) {
       continue;
     }
     try {
-      rmSync6(path);
+      rmSync7(path);
     } catch {}
   }
 }
@@ -36762,12 +36792,12 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
     if (!entry.startsWith("run-") || !entry.endsWith(".log")) {
       continue;
     }
-    const path = join15(directory, entry);
+    const path = join16(directory, entry);
     if (path === keep || ageMs(path, now) < keepMs) {
       continue;
     }
     try {
-      rmSync6(path);
+      rmSync7(path);
     } catch {}
   }
 }
@@ -36775,30 +36805,6 @@ var init_run_record = __esm(() => {
   init_runtime_client();
 });
 
-// src/setup.ts
-import { cpSync as cpSync2, existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync14, rmSync as rmSync7, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname8, join as join16 } from "node:path";
-function installedAddonVersion(projectPath) {
-  const marker = join16(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
-  if (!existsSync13(marker)) {
-    return null;
-  }
-  const said = readFileSync14(marker, "utf8").trim();
-  return said === "" ? null : said;
-}
-var ADDONS2, RUNTIME_AUTOLOAD2, VERSION_MARKER2 = ".gdharness-version";
-var init_setup = __esm(() => {
-  init_class_cache();
-  init_headless();
-  init_resources();
-  init_server_version();
-  ADDONS2 = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
-  RUNTIME_AUTOLOAD2 = {
-    name: "GdharnessRuntime",
-    path: "addons/gdharness_runtime/runtime_autoload.gd"
-  };
-});
-
 // src/server.ts
 import { execFile as execFile6, spawn } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -36859,7 +36865,7 @@ function runtimeVerdict(endpoint, after) {
   return {
     listening: false,
     mayYetAnnounce: after.running,
-    note: after.running ? `nothing announced itself within ${after.budgetMs}ms and the game is still running, so it may announce a moment from now: editor_status says whether it has, and editor_run start takes runtimeWaitMs to wait longer than this` : `nothing announced itself within ${after.budgetMs}ms and the game is no longer running, so nothing is going to: editor_output has what it printed on the way down`,
+    note: after.running ? `nothing announced itself within ${after.budgetMs}ms and the game is still running, so it may announce a moment from now: editor_status says whether it has, and editor_run start takes runtimeWaitMs to wait longer than this${after.withArgs ? ", which a run carrying its own arguments may well need, since whatever they ask the game to do before its first frame is inside this wait" : ""}` : `nothing announced itself within ${after.budgetMs}ms and the game is no longer running, so nothing is going to: editor_output has what it printed on the way down`,
     heldAt: null
   };
 }
@@ -38354,10 +38360,7 @@ class GodotServer {
     }
     const startedAt = before.connectedAt?.getTime() ?? 0;
     const began = Date.now();
-    const back = await this.waitForBridge(() => {
-      const status = this.godotBridge.getStatus();
-      return status.connected && (status.connectedAt?.getTime() ?? 0) > startedAt;
-    }, began + EDITOR_RESTART_TIMEOUT_MS);
+    const back = await this.waitForBridge(() => theEditorHasComeBack(this.godotBridge.getStatus(), startedAt), began + EDITOR_RESTART_TIMEOUT_MS);
     if (!back) {
       return this.createErrorResponse(`The editor was asked to restart and has not come back within ${EDITOR_RESTART_TIMEOUT_MS / 1000}s.`, [
         "It may be asking what to do about an unsaved scene: look at the editor window",
@@ -38552,7 +38555,7 @@ class GodotServer {
       transcript: started.transcript,
       refreshedClasses: refreshed.value,
       endedPreviousRun: ended ?? undefined,
-      runtime: await this.runtimeUp(project.value.path, alreadyPlaying, runtimeWaitMs),
+      runtime: await this.runtimeUp(project.value.path, alreadyPlaying, runtimeWaitMs, given.value.length > 0),
       message: `Use editor_output for what it prints and editor_run stop to end it.${spawnedInstead}${endedForThis}`
     });
   }
@@ -38561,9 +38564,9 @@ class GodotServer {
     const editorSays = run?.throughEditor === true ? (await this.editorPlayingState())?.playing ?? null : null;
     return runIsUp(run, editorSays);
   }
-  async runtimeUp(projectPath, before, budgetMs) {
+  async runtimeUp(projectPath, before, budgetMs, withArgs) {
     if (!existsSync14(join17(projectPath, RUNTIME_AUTOLOAD2.path))) {
-      return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false });
+      return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false, withArgs });
     }
     const endpoint = await announcedSince(projectPath, before, {
       budgetMs,
@@ -38573,7 +38576,8 @@ class GodotServer {
       addon: true,
       budgetMs,
       heldAt: this.dapClient?.whereItStopped() ?? null,
-      running: await this.gameIsUp()
+      running: await this.gameIsUp(),
+      withArgs
     });
   }
   async playThroughEditor(scene, refreshedClasses, projectPath, alreadyPlaying, runtimeWaitMs, ended) {
@@ -38624,7 +38628,7 @@ class GodotServer {
       refreshedClasses,
       debugPort: readNumber(asParams(JSON.parse(answer.content[0]?.text ?? "{}")), "debugPort"),
       endedPreviousRun: ended ?? undefined,
-      runtime: await this.runtimeUp(projectPath, alreadyPlaying, runtimeWaitMs),
+      runtime: await this.runtimeUp(projectPath, alreadyPlaying, runtimeWaitMs, false),
       message: "The editor is playing it, so its debugger holds it: the debug_* tools can reach it, " + "editor_output reads its console through the debug adapter, and editor_run stop ends it." + (ended === null ? "" : ` The run that was going, pid ${ended}, was ended to start this one; its output is no longer what editor_output answers about.`)
     });
   }
@@ -40641,9 +40645,10 @@ function inspectProject(projectPath) {
 }
 
 // src/skill.ts
+init_setup();
 init_tool_definitions();
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, readdirSync as readdirSync3, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
-import { basename, dirname as dirname4, join as join9 } from "node:path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync5, readdirSync as readdirSync3, rmSync as rmSync5, writeFileSync as writeFileSync7 } from "node:fs";
+import { basename, dirname as dirname5, join as join10 } from "node:path";
 
 // src/tool-reference.ts
 init_headless_operations();
@@ -40738,7 +40743,7 @@ function renderToolsMarkdown() {
 
 // src/skill.ts
 var SKILL_NAME = "gdharness";
-var SHARED_SKILLS = join9(".agents", "skills");
+var SHARED_SKILLS = join10(".agents", "skills");
 function skillMarkdown(version) {
   return `---
 name: ${SKILL_NAME}
@@ -40802,8 +40807,18 @@ that is running, and the project on disk. ${TOOL_SPECS.length} tools, named \`do
 These need the runtime autoload, which \`gdharness setup\` registers. \`runtime_capture\` needs a
 window and refuses headless rather than handing back the last frame anything drew.
 
-A headless game answers; a \`godot -s\` script run does not. It has no game in it, so the autoload
-stays quiet there rather than announcing a test tier as the project.
+The autoload reads these settings and no others. \`${BIND_ADDRESS_SETTING}\`
+is \`127.0.0.1\` and should stay there: the command set includes \`call_method\`, \`set_property\`
+and input injection, none of it authenticated, and Godot's own \`listen()\` defaults to every
+interface rather than to loopback, so this is named on purpose rather than left out.
+\`${PORT_SETTING}\` is 0, meaning the operating system picks one and the game announces it, which is
+what the server reads; fix it only for a client that cannot read the announcement.
+
+A headless game answers; a \`godot -s\` script run does not, by default. It has no game in it, so the
+autoload stays quiet there rather than announcing a test tier as the project: a gate starting sixteen
+engines would otherwise announce sixteen games that are not games. Set \`${SCRIPT_RUNS_SETTING}\`
+true in \`project.godot\` to serve one anyway, which is for driving a \`-s\` script on purpose. Read
+that setting rather than assuming the quiet: it is a default and not a property of script runs.
 
 The autoload reaches an export. \`gdharness runtime off\` in the project before shipping.
 
@@ -40867,27 +40882,27 @@ whatever the engine said on stderr comes back under \`engine_messages\`.
 function skillFiles(version) {
   return new Map([
     ["SKILL.md", skillMarkdown(version)],
-    [join9("references", "tools.md"), renderToolsMarkdown()]
+    [join10("references", "tools.md"), renderToolsMarkdown()]
   ]);
 }
 function skillDirectories(harnesses, projectPath, exists) {
-  const directories = [join9(projectPath, SHARED_SKILLS, SKILL_NAME)];
+  const directories = [join10(projectPath, SHARED_SKILLS, SKILL_NAME)];
   for (const harness of harnesses) {
     if (harness.skills === undefined) {
       continue;
     }
-    const own = join9(projectPath, harness.skills.dir);
-    if ((!harness.skills.shared || exists(own)) && !directories.includes(join9(own, SKILL_NAME))) {
-      directories.push(join9(own, SKILL_NAME));
+    const own = join10(projectPath, harness.skills.dir);
+    if ((!harness.skills.shared || exists(own)) && !directories.includes(join10(own, SKILL_NAME))) {
+      directories.push(join10(own, SKILL_NAME));
     }
   }
   return directories;
 }
 function everySkillDirectory(projectPath, harnesses) {
-  const directories = new Set([join9(projectPath, SHARED_SKILLS, SKILL_NAME)]);
+  const directories = new Set([join10(projectPath, SHARED_SKILLS, SKILL_NAME)]);
   for (const harness of harnesses) {
     if (harness.skills !== undefined) {
-      directories.add(join9(projectPath, harness.skills.dir, SKILL_NAME));
+      directories.add(join10(projectPath, harness.skills.dir, SKILL_NAME));
     }
   }
   return [...directories];
@@ -40895,52 +40910,52 @@ function everySkillDirectory(projectPath, harnesses) {
 function removeSkill(directories, projectPath) {
   const removed = [];
   for (const directory of directories) {
-    if (existsSync8(directory)) {
-      rmSync4(directory, { recursive: true, force: true });
-      pruneEmpty(dirname4(directory), projectPath);
+    if (existsSync9(directory)) {
+      rmSync5(directory, { recursive: true, force: true });
+      pruneEmpty(dirname5(directory), projectPath);
       removed.push(directory);
     }
   }
   return removed;
 }
 function pruneEmpty(directory, projectPath) {
-  const shared = join9(projectPath, ".agents");
+  const shared = join10(projectPath, ".agents");
   let path = directory;
   while (path !== projectPath && (basename(path) === "skills" || path === shared)) {
     if (readdirSync3(path).length > 0) {
       return;
     }
-    rmSync4(path, { recursive: true, force: true });
-    path = dirname4(path);
+    rmSync5(path, { recursive: true, force: true });
+    path = dirname5(path);
   }
 }
 function writeSkill(directories, version) {
   const files = skillFiles(version);
   return directories.map((directory) => {
-    const replaced = existsSync8(directory);
-    rmSync4(directory, { recursive: true, force: true });
+    const replaced = existsSync9(directory);
+    rmSync5(directory, { recursive: true, force: true });
     for (const [name, contents] of files) {
-      const path = join9(directory, name);
-      mkdirSync4(dirname4(path), { recursive: true });
-      writeFileSync6(path, contents, "utf8");
+      const path = join10(directory, name);
+      mkdirSync5(dirname5(path), { recursive: true });
+      writeFileSync7(path, contents, "utf8");
     }
     return { path: directory, replaced };
   });
 }
 
 // src/version.ts
-import { readFileSync as readFileSync8 } from "node:fs";
-import { dirname as dirname5, join as join10 } from "node:path";
+import { readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname6, join as join11 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function getLocalVersion() {
-  const currentDirectory = dirname5(fileURLToPath2(import.meta.url));
+  const currentDirectory = dirname6(fileURLToPath2(import.meta.url));
   const packageCandidates = [
-    join10(currentDirectory, "..", "package.json"),
-    join10(currentDirectory, "..", "..", "package.json")
+    join11(currentDirectory, "..", "package.json"),
+    join11(currentDirectory, "..", "..", "package.json")
   ];
   for (const packagePath of packageCandidates) {
     try {
-      const value = JSON.parse(readFileSync8(packagePath, "utf-8"));
+      const value = JSON.parse(readFileSync9(packagePath, "utf-8"));
       if (typeof value === "object" && value !== null && "name" in value && value.name === "gdharness" && "version" in value && typeof value.version === "string") {
         return value.version;
       }