gdharness 0.13.6 → 0.13.8

package/build/cli.js

@@ -14896,6 +14896,15 @@ function isValueComplete(value) {
   }
   return depth <= 0 && !inString;
 }
+function settingKeys(content) {
+  const named = new Set;
+  for (const [section, entries] of Object.entries(parseProjectGodot(content))) {
+    for (const key of Object.keys(entries)) {
+      named.add(`${section}/${key}`);
+    }
+  }
+  return named;
+}
 function parseProjectGodot(content) {
   const result = emptyRecord();
   let section = emptyRecord();
@@ -15730,7 +15739,7 @@ var init_tool_definitions = __esm(() => {
     },
     {
       name: "editor_launch",
-      description: "Opens the Godot editor on a project, in a window on this machine, or restarts the one already connected. An editor goes on serving the addon it read at startup, so restart is what puts a gdharness upgrade into effect; it saves open scenes on the way out and answers with the version that came back. Only an editor with a window can be restarted, because the engine hands back none of the arguments it was started with. editor_status says which editor is connected and whether it is holding an old addon.",
+      description: "Opens the Godot editor on a project, in a window on this machine, or restarts the one already connected. An editor goes on serving the addon it read at startup, so restart is what puts a gdharness upgrade into effect; it saves open scenes on the way out and answers with the version that came back. Only an editor with a window can be restarted, because the engine hands back none of the arguments it was started with. editor_status says which editor is connected and whether it is holding an old addon. A restart saves project.godot on the way out, and Godot writes only what differs from its own defaults, so a key named deliberately at its default value is dropped: settingsDropped names any that went, because nothing else will say so until something depends on one.",
       parameters: { projectPath: PROJECT_PATH },
       requires: [],
       operations: {
@@ -26630,13 +26639,14 @@ var require_fast_uri = __commonJS(function(exports, module) {
       if (!malformedIPLiteral) {
         malformedHost = canonicalizeHost(parsed, options, schemeHandler, isIP);
       }
-      if (!schemeHandler || schemeHandler && !schemeHandler.skipNormalize) {
-        if (uri.indexOf("%") !== -1) {
-          if (parsed.host !== undefined && !malformedIPLiteral) {
-            const host = isIP ? parsed.host : normalizePercentEncoding(parsed.host, true);
-            parsed.host = reescapeHostDelimiters(host, isIP);
-          }
+      if (uri.indexOf("%") !== -1 && parsed.host !== undefined && !malformedIPLiteral) {
+        let host = isIP ? parsed.host : normalizePercentEncoding(parsed.host, true);
+        if (!isIP) {
+          host = normalizePercentEncoding(host.toLowerCase());
         }
+        parsed.host = reescapeHostDelimiters(host, isIP);
+      }
+      if (!schemeHandler || schemeHandler && !schemeHandler.skipNormalize) {
         if (parsed.path) {
           parsed.path = normalizePathEncoding(parsed.path);
         }
@@ -36320,6 +36330,41 @@ function writeRunRecord(record) {
   mkdirSync6(runsDirectory(), { recursive: true });
   writeFileSync8(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
+function editorNotePath() {
+  return join15(runsDirectory(), "editor-run.json");
+}
+function writeEditorRunNote(note) {
+  mkdirSync6(runsDirectory(), { recursive: true });
+  writeFileSync8(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
+}
+function readEditorRunNote() {
+  for (const directory of runtimeDirectories()) {
+    const note = editorNoteAt(join15(directory, "runs", "editor-run.json"));
+    if (note !== null) {
+      return note;
+    }
+  }
+  return null;
+}
+function editorNoteAt(path) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync13(path, "utf8"));
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") {
+    return null;
+  }
+  const fields = parsed;
+  const projectPath = fields["projectPath"];
+  const transcript = fields["transcript"];
+  const startedAt = fields["startedAt"];
+  if (typeof projectPath !== "string" || typeof transcript !== "string" || typeof startedAt !== "number") {
+    return null;
+  }
+  return { projectPath, transcript, startedAt };
+}
 function recordRunEnded(pid, exitCode) {
   const path = recordPath();
   const record = recordAt(path);
@@ -36512,6 +36557,7 @@ var init_setup = __esm(() => {
 import { execFile as execFile6, spawn } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import {
+  appendFileSync,
   closeSync,
   existsSync as existsSync14,
   fstatSync,
@@ -36521,7 +36567,8 @@ import {
   readdirSync as readdirSync7,
   readFileSync as readFileSync15,
   readSync,
-  rmSync as rmSync9
+  rmSync as rmSync9,
+  statSync as statSync4
 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
 import { basename as basename3, dirname as dirname9, join as join17, normalize as normalize3 } from "node:path";
@@ -37887,6 +37934,7 @@ class GodotServer {
       };
     }));
     const playing = await this.editorPlayingState();
+    await this.pickUpWhatTheEditorIsPlaying();
     return this.jsonTextResponse({
       editor: {
         ...this.getEditorStatusPayload(),
@@ -37904,6 +37952,16 @@ class GodotServer {
       }
     });
   }
+  settingKeysOf(projectPath) {
+    if (projectPath === undefined) {
+      return new Set;
+    }
+    try {
+      return settingKeys(readFileSync15(join17(projectPath, "project.godot"), "utf8"));
+    } catch {
+      return new Set;
+    }
+  }
   async handleRestartEditor() {
     const before = this.godotBridge.getStatus();
     if (!before.connected) {
@@ -37912,6 +37970,7 @@ class GodotServer {
         "editor_status says whether the bridge is up and what has reached it"
       ]);
     }
+    const settingsBefore = this.settingKeysOf(before.projectPath);
     const mine = before.openedByAServer === true && before.projectPath !== undefined;
     const asked = mine ? await this.startItAgain(before.projectPath ?? "", before.editorPid) : await this.handleViaBridge("restart_editor", {});
     if (asked.isError === true) {
@@ -37931,6 +37990,8 @@ class GodotServer {
       ]);
     }
     const now = this.godotBridge.getStatus();
+    const after = this.settingKeysOf(before.projectPath);
+    const dropped = [...settingsBefore].filter((key) => !after.has(key));
     return this.jsonTextResponse({
       restarted: true,
       editorPid: now.editorPid,
@@ -37938,6 +37999,8 @@ class GodotServer {
       serverVersion: SERVER_VERSION,
       addonIsStale: now.addonVersion !== SERVER_VERSION,
       staleNote: addonMismatch(now.addonVersion, SERVER_VERSION),
+      settingsDropped: dropped.length > 0 ? dropped : undefined,
+      settingsNote: dropped.length > 0 ? 'The editor saved project.godot on its way out and these keys are no longer in it. Godot writes only what differs from its own defaults, so a key named deliberately at its default value is redundant to the editor and is dropped on save. If any of them were pinned on purpose, to keep "set to this on purpose" and "not set" apart, put them back: nothing else will say they have gone until something depends on one.' : undefined,
       tookMs: Date.now() - began
     });
   }
@@ -38128,6 +38191,7 @@ class GodotServer {
     const log = new GameLog;
     try {
       await this.dap().connect();
+      this.dapClient?.getOutput(true);
     } catch (error) {
       return this.createErrorResponse(`The editor is connected but its debug adapter is not: ${errorMessage(error)}`, [
         `This asked on port ${this.dap().port}, which is where the connected editor says it serves`,
@@ -38138,19 +38202,24 @@ class GodotServer {
     if (answer.isError === true) {
       return answer;
     }
+    const startedAt = Date.now();
+    const transcript = openTranscript(startedAt);
+    closeSync(transcript.fd);
     const played = {
       process: null,
       pid: null,
       log,
-      transcript: null,
+      transcript: transcript.path,
       readOffset: 0,
       projectPath,
-      startedAt: Date.now(),
+      startedAt,
       exitCode: null,
       throughEditor: true,
       brokeOn: null
     };
     this.activeProcess = played;
+    writeEditorRunNote({ projectPath, transcript: transcript.path, startedAt });
+    sweepTranscripts();
     return this.jsonTextResponse({
       started: true,
       through: "editor",
@@ -38166,10 +38235,24 @@ class GodotServer {
     if (!game.throughEditor || !this.dapClient) {
       return;
     }
+    const heard = [];
     for (const line of this.dapClient.getOutput(true)) {
-      game.log.append("stdout", line.endsWith(`
+      const ended = line.endsWith(`
 `) ? line : `${line}
-`);
+`;
+      game.log.append("stdout", ended);
+      heard.push(ended);
+    }
+    if (heard.length > 0 && game.transcript !== null) {
+      try {
+        appendFileSync(game.transcript, heard.join(""));
+        game.readOffset = statSync4(game.transcript).size;
+      } catch (error) {
+        this.logDebug(`Could not write an editor-played run's transcript: ${errorMessage(error)}`);
+      }
+    }
+    if (!this.dapClient.isConnected()) {
+      game.consoleLost = true;
     }
     this.recordWhatItBrokeOn(game);
   }
@@ -38322,6 +38405,50 @@ class GodotServer {
       closeSync(handle);
     }
   }
+  async pickUpWhatTheEditorIsPlaying() {
+    if (!this.godotBridge.isConnected()) {
+      return;
+    }
+    const going = this.activeProcess;
+    if (going !== null) {
+      if (going.throughEditor && going.consoleLost === true && (await this.editorPlayingState())?.playing) {
+        try {
+          await this.dap().connect();
+          going.log.append("stdout", `[gdharness] the debug adapter was reconnected here
+`);
+        } catch (error) {
+          this.logDebug(`Could not reconnect the adapter for a playing run: ${errorMessage(error)}`);
+        }
+      }
+      return;
+    }
+    const playing = await this.editorPlayingState();
+    if (playing?.playing !== true) {
+      return;
+    }
+    try {
+      await this.dap().connect();
+    } catch (error) {
+      this.logDebug(`Picked up an editor-played run without its adapter: ${errorMessage(error)}`);
+    }
+    const project = this.godotBridge.getStatus().projectPath ?? null;
+    const left = readEditorRunNote();
+    const note = left !== null && project !== null && isSameDirectory(left.projectPath, project) ? left : null;
+    const picked = {
+      process: null,
+      pid: null,
+      log: new GameLog,
+      transcript: note?.transcript ?? null,
+      readOffset: 0,
+      projectPath: project,
+      startedAt: note?.startedAt ?? Date.now(),
+      exitCode: null,
+      throughEditor: true,
+      brokeOn: null,
+      pickedUpPlaying: true
+    };
+    this.activeProcess = picked;
+  }
   adoptRecordedRun() {
     const record = readRunRecord();
     if (record === null || !this.couldBeOurs(record.projectPath)) {
@@ -38403,6 +38530,7 @@ class GodotServer {
     });
   }
   async handleWaitForRun(args) {
+    await this.pickUpWhatTheEditorIsPlaying();
     const run = this.currentRun();
     if (!run) {
       return this.createErrorResponse(this.nothingOfOursIsRunning());
@@ -38417,6 +38545,7 @@ class GodotServer {
     return await this.handleGetDebugOutput(args, stillRunning(run) ? budgetMs : undefined);
   }
   async handleGetDebugOutput(args, waitedMs) {
+    await this.pickUpWhatTheEditorIsPlaying();
     const run = this.currentRun();
     if (!run) {
       return this.createErrorResponse(this.nothingOfOursIsRunning());
@@ -38438,12 +38567,22 @@ class GodotServer {
     const wanted = readBoolean(args, "cpu") ?? false;
     const cpuSeconds = wanted && run.pid !== null && stillRunning(run) ? await cpuSecondsOf(run.pid) : undefined;
     const notes = [];
+    if (wanted && cpuSeconds === undefined && stillRunning(run)) {
+      notes.push(run.pid === null ? "cpu was asked for and there is no process to ask: the editor is playing this run and holds it, so nothing here has its process id. editor_run start without a connected editor, or with args, starts the game here instead and that run answers cpuSeconds." : "cpu was asked for and this platform would not say what the run has used.");
+    }
     if (waitedMs !== undefined) {
       notes.push(`The wait of ${waitedMs}ms ran out and the run is still going, so this is what it had printed by then rather than everything it will print. editor_run wait again to keep waiting.`);
     }
     if (run.endedUnwatched === true) {
       notes.push("This run outlived the server that started it and is over now, so its exit code was never collected. Everything it printed is below, read back from its transcript.");
     }
+    if (run.pickedUpPlaying === true) {
+      notes.push(run.transcript === null ? "The editor was already playing this when this server reached it, and the server that started it left no transcript, so this is not the run from its start: what it printed before that is only in the editor. It is the run the editor is holding now, which is the one the debug_* tools answer for." : "The editor was already playing this when this server reached it, and what it printed before that has been read back from its transcript. It is the run the editor is holding now, which is the one the debug_* tools answer for.");
+    }
+    if (run.consoleLost === true) {
+      const back = this.dapClient?.isConnected() === true;
+      notes.push(`The debug adapter this run's console arrives over went away while the run was going, so what is below has a hole in it and the counts are of what was heard rather than of what was printed. ${back ? "It is connected again, and the line marking where is in the log." : "It is still gone, so nothing further will arrive here."} The project's own user://logs/godot.log has the rest, and "no entries" here means "not heard" rather than a quiet run.`);
+    }
     if (typeof run.endedHere === "string") {
       notes.push(`This run was ended here, by ${run.endedHere}.`);
     } else if (!stillRunning(run) && !run.throughEditor && run.exitCode !== null) {
@@ -38459,7 +38598,8 @@ class GodotServer {
       pid: run.pid,
       errors: run.log.count("error"),
       warnings: run.log.count("warning"),
-      clean: run.log.count("error") === 0,
+      clean: run.consoleLost === true ? undefined : run.log.count("error") === 0,
+      consoleLost: run.consoleLost === true ? true : undefined,
       heldAt: halt,
       endedUnwatched: run.endedUnwatched === true ? true : undefined,
       endedBy: stillRunning(run) ? undefined : run.endedHere ?? null,
@@ -38474,6 +38614,7 @@ class GodotServer {
     });
   }
   async handleStopProject() {
+    await this.pickUpWhatTheEditorIsPlaying();
     const stopped = this.currentRun();
     if (!stopped) {
       return this.createErrorResponse(this.nothingOfOursIsRunning());

package/build/index.js

@@ -4060,13 +4060,14 @@ var require_fast_uri = __commonJS(function(exports, module) {
       if (!malformedIPLiteral) {
         malformedHost = canonicalizeHost(parsed, options, schemeHandler, isIP);
       }
-      if (!schemeHandler || schemeHandler && !schemeHandler.skipNormalize) {
-        if (uri.indexOf("%") !== -1) {
-          if (parsed.host !== undefined && !malformedIPLiteral) {
-            const host = isIP ? parsed.host : normalizePercentEncoding(parsed.host, true);
-            parsed.host = reescapeHostDelimiters(host, isIP);
-          }
+      if (uri.indexOf("%") !== -1 && parsed.host !== undefined && !malformedIPLiteral) {
+        let host = isIP ? parsed.host : normalizePercentEncoding(parsed.host, true);
+        if (!isIP) {
+          host = normalizePercentEncoding(host.toLowerCase());
         }
+        parsed.host = reescapeHostDelimiters(host, isIP);
+      }
+      if (!schemeHandler || schemeHandler && !schemeHandler.skipNormalize) {
         if (parsed.path) {
           parsed.path = normalizePathEncoding(parsed.path);
         }
@@ -10141,6 +10142,7 @@ function defectReport(where, error, godotVersion) {
 import { execFile as execFile4, spawn } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import {
+  appendFileSync,
   closeSync,
   existsSync as existsSync9,
   fstatSync,
@@ -10150,7 +10152,8 @@ import {
   readdirSync as readdirSync6,
   readFileSync as readFileSync11,
   readSync,
-  rmSync as rmSync5
+  rmSync as rmSync5,
+  statSync as statSync4
 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 import { basename as basename2, dirname as dirname4, join as join11, normalize as normalize2 } from "node:path";
@@ -27544,6 +27547,15 @@ function isValueComplete(value) {
   }
   return depth <= 0 && !inString;
 }
+function settingKeys(content) {
+  const named = new Set;
+  for (const [section, entries] of Object.entries(parseProjectGodot(content))) {
+    for (const key of Object.keys(entries)) {
+      named.add(`${section}/${key}`);
+    }
+  }
+  return named;
+}
 function parseProjectGodot(content) {
   const result = emptyRecord();
   let section = emptyRecord();
@@ -27972,6 +27984,41 @@ function writeRunRecord(record) {
   mkdirSync3(runsDirectory(), { recursive: true });
   writeFileSync4(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
+function editorNotePath() {
+  return join9(runsDirectory(), "editor-run.json");
+}
+function writeEditorRunNote(note) {
+  mkdirSync3(runsDirectory(), { recursive: true });
+  writeFileSync4(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
+}
+function readEditorRunNote() {
+  for (const directory of runtimeDirectories()) {
+    const note = editorNoteAt(join9(directory, "runs", "editor-run.json"));
+    if (note !== null) {
+      return note;
+    }
+  }
+  return null;
+}
+function editorNoteAt(path) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync9(path, "utf8"));
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") {
+    return null;
+  }
+  const fields = parsed;
+  const projectPath = fields["projectPath"];
+  const transcript = fields["transcript"];
+  const startedAt = fields["startedAt"];
+  if (typeof projectPath !== "string" || typeof transcript !== "string" || typeof startedAt !== "number") {
+    return null;
+  }
+  return { projectPath, transcript, startedAt };
+}
 function recordRunEnded(pid, exitCode) {
   const path = recordPath();
   const record = recordAt(path);
@@ -28744,7 +28791,7 @@ var TOOL_SPECS = [
   },
   {
     name: "editor_launch",
-    description: "Opens the Godot editor on a project, in a window on this machine, or restarts the one already connected. An editor goes on serving the addon it read at startup, so restart is what puts a gdharness upgrade into effect; it saves open scenes on the way out and answers with the version that came back. Only an editor with a window can be restarted, because the engine hands back none of the arguments it was started with. editor_status says which editor is connected and whether it is holding an old addon.",
+    description: "Opens the Godot editor on a project, in a window on this machine, or restarts the one already connected. An editor goes on serving the addon it read at startup, so restart is what puts a gdharness upgrade into effect; it saves open scenes on the way out and answers with the version that came back. Only an editor with a window can be restarted, because the engine hands back none of the arguments it was started with. editor_status says which editor is connected and whether it is holding an old addon. A restart saves project.godot on the way out, and Godot writes only what differs from its own defaults, so a key named deliberately at its default value is dropped: settingsDropped names any that went, because nothing else will say so until something depends on one.",
     parameters: { projectPath: PROJECT_PATH },
     requires: [],
     operations: {
@@ -30641,6 +30688,7 @@ class GodotServer {
       };
     }));
     const playing = await this.editorPlayingState();
+    await this.pickUpWhatTheEditorIsPlaying();
     return this.jsonTextResponse({
       editor: {
         ...this.getEditorStatusPayload(),
@@ -30658,6 +30706,16 @@ class GodotServer {
       }
     });
   }
+  settingKeysOf(projectPath) {
+    if (projectPath === undefined) {
+      return new Set;
+    }
+    try {
+      return settingKeys(readFileSync11(join11(projectPath, "project.godot"), "utf8"));
+    } catch {
+      return new Set;
+    }
+  }
   async handleRestartEditor() {
     const before = this.godotBridge.getStatus();
     if (!before.connected) {
@@ -30666,6 +30724,7 @@ class GodotServer {
         "editor_status says whether the bridge is up and what has reached it"
       ]);
     }
+    const settingsBefore = this.settingKeysOf(before.projectPath);
     const mine = before.openedByAServer === true && before.projectPath !== undefined;
     const asked = mine ? await this.startItAgain(before.projectPath ?? "", before.editorPid) : await this.handleViaBridge("restart_editor", {});
     if (asked.isError === true) {
@@ -30685,6 +30744,8 @@ class GodotServer {
       ]);
     }
     const now = this.godotBridge.getStatus();
+    const after = this.settingKeysOf(before.projectPath);
+    const dropped = [...settingsBefore].filter((key) => !after.has(key));
     return this.jsonTextResponse({
       restarted: true,
       editorPid: now.editorPid,
@@ -30692,6 +30753,8 @@ class GodotServer {
       serverVersion: SERVER_VERSION,
       addonIsStale: now.addonVersion !== SERVER_VERSION,
       staleNote: addonMismatch(now.addonVersion, SERVER_VERSION),
+      settingsDropped: dropped.length > 0 ? dropped : undefined,
+      settingsNote: dropped.length > 0 ? 'The editor saved project.godot on its way out and these keys are no longer in it. Godot writes only what differs from its own defaults, so a key named deliberately at its default value is redundant to the editor and is dropped on save. If any of them were pinned on purpose, to keep "set to this on purpose" and "not set" apart, put them back: nothing else will say they have gone until something depends on one.' : undefined,
       tookMs: Date.now() - began
     });
   }
@@ -30882,6 +30945,7 @@ class GodotServer {
     const log = new GameLog;
     try {
       await this.dap().connect();
+      this.dapClient?.getOutput(true);
     } catch (error) {
       return this.createErrorResponse(`The editor is connected but its debug adapter is not: ${errorMessage(error)}`, [
         `This asked on port ${this.dap().port}, which is where the connected editor says it serves`,
@@ -30892,19 +30956,24 @@ class GodotServer {
     if (answer.isError === true) {
       return answer;
     }
+    const startedAt = Date.now();
+    const transcript = openTranscript(startedAt);
+    closeSync(transcript.fd);
     const played = {
       process: null,
       pid: null,
       log,
-      transcript: null,
+      transcript: transcript.path,
       readOffset: 0,
       projectPath,
-      startedAt: Date.now(),
+      startedAt,
       exitCode: null,
       throughEditor: true,
       brokeOn: null
     };
     this.activeProcess = played;
+    writeEditorRunNote({ projectPath, transcript: transcript.path, startedAt });
+    sweepTranscripts();
     return this.jsonTextResponse({
       started: true,
       through: "editor",
@@ -30920,10 +30989,24 @@ class GodotServer {
     if (!game.throughEditor || !this.dapClient) {
       return;
     }
+    const heard = [];
     for (const line of this.dapClient.getOutput(true)) {
-      game.log.append("stdout", line.endsWith(`
+      const ended = line.endsWith(`
 `) ? line : `${line}
-`);
+`;
+      game.log.append("stdout", ended);
+      heard.push(ended);
+    }
+    if (heard.length > 0 && game.transcript !== null) {
+      try {
+        appendFileSync(game.transcript, heard.join(""));
+        game.readOffset = statSync4(game.transcript).size;
+      } catch (error) {
+        this.logDebug(`Could not write an editor-played run's transcript: ${errorMessage(error)}`);
+      }
+    }
+    if (!this.dapClient.isConnected()) {
+      game.consoleLost = true;
     }
     this.recordWhatItBrokeOn(game);
   }
@@ -31076,6 +31159,50 @@ class GodotServer {
       closeSync(handle);
     }
   }
+  async pickUpWhatTheEditorIsPlaying() {
+    if (!this.godotBridge.isConnected()) {
+      return;
+    }
+    const going = this.activeProcess;
+    if (going !== null) {
+      if (going.throughEditor && going.consoleLost === true && (await this.editorPlayingState())?.playing) {
+        try {
+          await this.dap().connect();
+          going.log.append("stdout", `[gdharness] the debug adapter was reconnected here
+`);
+        } catch (error) {
+          this.logDebug(`Could not reconnect the adapter for a playing run: ${errorMessage(error)}`);
+        }
+      }
+      return;
+    }
+    const playing = await this.editorPlayingState();
+    if (playing?.playing !== true) {
+      return;
+    }
+    try {
+      await this.dap().connect();
+    } catch (error) {
+      this.logDebug(`Picked up an editor-played run without its adapter: ${errorMessage(error)}`);
+    }
+    const project = this.godotBridge.getStatus().projectPath ?? null;
+    const left = readEditorRunNote();
+    const note = left !== null && project !== null && isSameDirectory(left.projectPath, project) ? left : null;
+    const picked = {
+      process: null,
+      pid: null,
+      log: new GameLog,
+      transcript: note?.transcript ?? null,
+      readOffset: 0,
+      projectPath: project,
+      startedAt: note?.startedAt ?? Date.now(),
+      exitCode: null,
+      throughEditor: true,
+      brokeOn: null,
+      pickedUpPlaying: true
+    };
+    this.activeProcess = picked;
+  }
   adoptRecordedRun() {
     const record = readRunRecord();
     if (record === null || !this.couldBeOurs(record.projectPath)) {
@@ -31157,6 +31284,7 @@ class GodotServer {
     });
   }
   async handleWaitForRun(args) {
+    await this.pickUpWhatTheEditorIsPlaying();
     const run = this.currentRun();
     if (!run) {
       return this.createErrorResponse(this.nothingOfOursIsRunning());
@@ -31171,6 +31299,7 @@ class GodotServer {
     return await this.handleGetDebugOutput(args, stillRunning(run) ? budgetMs : undefined);
   }
   async handleGetDebugOutput(args, waitedMs) {
+    await this.pickUpWhatTheEditorIsPlaying();
     const run = this.currentRun();
     if (!run) {
       return this.createErrorResponse(this.nothingOfOursIsRunning());
@@ -31192,12 +31321,22 @@ class GodotServer {
     const wanted = readBoolean(args, "cpu") ?? false;
     const cpuSeconds = wanted && run.pid !== null && stillRunning(run) ? await cpuSecondsOf(run.pid) : undefined;
     const notes = [];
+    if (wanted && cpuSeconds === undefined && stillRunning(run)) {
+      notes.push(run.pid === null ? "cpu was asked for and there is no process to ask: the editor is playing this run and holds it, so nothing here has its process id. editor_run start without a connected editor, or with args, starts the game here instead and that run answers cpuSeconds." : "cpu was asked for and this platform would not say what the run has used.");
+    }
     if (waitedMs !== undefined) {
       notes.push(`The wait of ${waitedMs}ms ran out and the run is still going, so this is what it had printed by then rather than everything it will print. editor_run wait again to keep waiting.`);
     }
     if (run.endedUnwatched === true) {
       notes.push("This run outlived the server that started it and is over now, so its exit code was never collected. Everything it printed is below, read back from its transcript.");
     }
+    if (run.pickedUpPlaying === true) {
+      notes.push(run.transcript === null ? "The editor was already playing this when this server reached it, and the server that started it left no transcript, so this is not the run from its start: what it printed before that is only in the editor. It is the run the editor is holding now, which is the one the debug_* tools answer for." : "The editor was already playing this when this server reached it, and what it printed before that has been read back from its transcript. It is the run the editor is holding now, which is the one the debug_* tools answer for.");
+    }
+    if (run.consoleLost === true) {
+      const back = this.dapClient?.isConnected() === true;
+      notes.push(`The debug adapter this run's console arrives over went away while the run was going, so what is below has a hole in it and the counts are of what was heard rather than of what was printed. ${back ? "It is connected again, and the line marking where is in the log." : "It is still gone, so nothing further will arrive here."} The project's own user://logs/godot.log has the rest, and "no entries" here means "not heard" rather than a quiet run.`);
+    }
     if (typeof run.endedHere === "string") {
       notes.push(`This run was ended here, by ${run.endedHere}.`);
     } else if (!stillRunning(run) && !run.throughEditor && run.exitCode !== null) {
@@ -31213,7 +31352,8 @@ class GodotServer {
       pid: run.pid,
       errors: run.log.count("error"),
       warnings: run.log.count("warning"),
-      clean: run.log.count("error") === 0,
+      clean: run.consoleLost === true ? undefined : run.log.count("error") === 0,
+      consoleLost: run.consoleLost === true ? true : undefined,
       heldAt: halt,
       endedUnwatched: run.endedUnwatched === true ? true : undefined,
       endedBy: stillRunning(run) ? undefined : run.endedHere ?? null,
@@ -31228,6 +31368,7 @@ class GodotServer {
     });
   }
   async handleStopProject() {
+    await this.pickUpWhatTheEditorIsPlaying();
     const stopped = this.currentRun();
     if (!stopped) {
       return this.createErrorResponse(this.nothingOfOursIsRunning());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "0.13.6",
+  "version": "0.13.8",
   "mcpName": "io.github.Aureliolo/gdharness",
   "description": "A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.",
   "type": "module",