gdharness 0.13.7 → 0.13.9

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,8 +15739,8 @@ 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.",
-      parameters: { projectPath: PROJECT_PATH },
+      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, ops: ["open"] } },
       requires: [],
       operations: {
         open: { summary: "open the editor on a project", requires: ["projectPath"] },
@@ -15743,7 +15752,7 @@ var init_tool_definitions = __esm(() => {
       name: "editor_run",
       description: "The run: starting the project, stopping it, or booting it once to see whether it comes up clean. start keeps it running and collecting output until it quits or is stopped, windowed where there is a display and headless where there is not, unless headless says otherwise; only runtime_capture needs the window. A run that quits on its own is kept, so a scene that prints an answer and quits is start, then editor_output until running is false. What runs is a scene: a SceneTree script is not an entry point here, so put the script on the root of a scene of its own and name that in scene. args hands the game its own flags, the ones it reads with OS.get_cmdline_user_args(), and a run carrying any is started by this server rather than by the editor. check boots it headless for a few frames, waits for it to quit, and answers with the verdict: whether it came up, and every error and warning it printed on the way. A start waits for the game to become something the runtime_* tools can talk to and says which it is under runtime: listening with the port it took, or why not, so the first call after a start does not have to be made twice. When it is not listening, mayYetAnnounce says whether that is final: false is a runtime that is not coming, true is a game still on its way up, which editor_status will see and runtimeWaitMs waits longer for. A start this server made also answers with transcript, the file both the run's streams are written to, so a watch on it can be armed off the start rather than off a second call.",
       parameters: {
-        projectPath: PROJECT_PATH,
+        projectPath: { ...PROJECT_PATH, ops: ["start", "check"] },
         scene: {
           type: "string",
           ops: ["start", "check"],
@@ -15772,11 +15781,17 @@ var init_tool_definitions = __esm(() => {
           description: "check: how long to give the boot before it is called hung. Default 60000. wait: how long to wait for the run to end before answering anyway. Default 600000."
         }
       },
-      requires: ["projectPath"],
+      requires: [],
       operations: {
-        start: { summary: "run the project until it quits or is stopped", requires: [] },
+        start: {
+          summary: "run the project until it quits or is stopped",
+          requires: ["projectPath"]
+        },
         stop: { summary: "end the run and answer with what it printed last", requires: [] },
-        check: { summary: "boot headless, quit after a few frames, and report the verdict", requires: [] },
+        check: {
+          summary: "boot headless, quit after a few frames, and report the verdict",
+          requires: ["projectPath"]
+        },
         wait: { summary: "wait for the run to end, then answer as editor_output does", requires: [] }
       },
       defaultOperation: "start"
@@ -31159,6 +31174,7 @@ class GodotDAPClient {
   pendingRequests;
   reader = new FrameReader;
   outputBuffer = [];
+  onOutput = null;
   maxOutputLines = 1000;
   initialized = false;
   attached = false;
@@ -31326,6 +31342,13 @@ class GodotDAPClient {
       if (outputText.length > 0) {
         const lines = outputText.split(/\r?\n/).filter((line) => line.length > 0);
         this.outputBuffer.push(...lines);
+        if (this.onOutput !== null) {
+          for (const line of lines) {
+            try {
+              this.onOutput(line);
+            } catch {}
+          }
+        }
       }
       if (this.outputBuffer.length > this.maxOutputLines) {
         this.outputBuffer = this.outputBuffer.slice(this.outputBuffer.length - this.maxOutputLines);
@@ -31382,6 +31405,9 @@ class GodotDAPClient {
     await this.sendRequest("configurationDone", {});
     this.attached = true;
   }
+  setOutputSink(sink) {
+    this.onOutput = sink;
+  }
   getOutput(clear = false) {
     const lines = [...this.outputBuffer];
     if (clear) {
@@ -36321,6 +36347,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);
@@ -36513,6 +36574,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,
@@ -37076,9 +37138,10 @@ class GodotServer {
     if (op !== null) {
       const elsewhere = Object.keys(args).filter((key) => key !== "op" && !opTakes(spec, op, key));
       if (elsewhere.length > 0) {
+        const takes = argumentsOf(spec, op);
         return {
           ok: false,
-          response: this.createErrorResponse(`${spec.name} ${op} does not take ${elsewhere.join(", ")}. ${op} takes: ${argumentsOf(spec, op).join(", ")}.`)
+          response: this.createErrorResponse(`${spec.name} ${op} does not take ${elsewhere.join(", ")}. ${takes.length === 0 ? `${op} takes no arguments.` : `${op} takes: ${takes.join(", ")}.`}`)
         };
       }
     }
@@ -37828,9 +37891,27 @@ class GodotServer {
     if (this.dapClient !== null && this.dapClient.port !== port) {
       this.dapClient = null;
     }
-    this.dapClient ??= new GodotDAPClient(port);
+    if (this.dapClient === null) {
+      this.dapClient = new GodotDAPClient(port);
+      this.dapClient.setOutputSink((line) => {
+        this.writeToTranscript(line);
+      });
+    }
     return this.dapClient;
   }
+  writeToTranscript(line) {
+    const run = this.activeProcess;
+    if (run?.throughEditor !== true || run.transcript === null) {
+      return;
+    }
+    try {
+      appendFileSync(run.transcript, line.endsWith(`
+`) ? line : `${line}
+`);
+    } catch (error) {
+      this.logDebug(`Could not write an editor-played run's transcript: ${errorMessage(error)}`);
+    }
+  }
   editorServes(field, variable, fallback) {
     const named = portFromEnvOrNull(variable);
     if (named !== null) {
@@ -37906,6 +37987,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) {
@@ -37914,6 +38005,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) {
@@ -37933,6 +38025,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,
@@ -37940,6 +38034,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
     });
   }
@@ -38130,6 +38226,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`,
@@ -38140,19 +38237,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",
@@ -38168,10 +38270,15 @@ class GodotServer {
     if (!game.throughEditor || !this.dapClient) {
       return;
     }
-    for (const line of this.dapClient.getOutput(true)) {
-      game.log.append("stdout", line.endsWith(`
+    if (game.transcript === null) {
+      for (const line of this.dapClient.getOutput(true)) {
+        game.log.append("stdout", line.endsWith(`
 `) ? line : `${line}
 `);
+      }
+    }
+    if (!this.dapClient.isConnected()) {
+      game.consoleLost = true;
     }
     this.recordWhatItBrokeOn(game);
   }
@@ -38325,7 +38432,20 @@ class GodotServer {
     }
   }
   async pickUpWhatTheEditorIsPlaying() {
-    if (this.activeProcess !== null || !this.godotBridge.isConnected()) {
+    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();
@@ -38337,19 +38457,23 @@ class GodotServer {
     } catch (error) {
       this.logDebug(`Picked up an editor-played run without its adapter: ${errorMessage(error)}`);
     }
-    this.activeProcess = {
+    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: null,
+      transcript: note?.transcript ?? null,
       readOffset: 0,
-      projectPath: this.godotBridge.getStatus().projectPath ?? null,
-      startedAt: Date.now(),
+      projectPath: project,
+      startedAt: note?.startedAt ?? Date.now(),
       exitCode: null,
       throughEditor: true,
       brokeOn: null,
       pickedUpPlaying: true
     };
+    this.activeProcess = picked;
   }
   adoptRecordedRun() {
     const record = readRunRecord();
@@ -38469,6 +38593,9 @@ 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.`);
     }
@@ -38476,7 +38603,11 @@ class GodotServer {
       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("The editor was already playing this when this server reached it, so this is not the run from its start: what it printed before that went with the server that was listening then. It is the run the editor is holding now, which is the one the debug_* tools answer for.");
+      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}.`);
@@ -38493,7 +38624,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,

package/build/index.js

@@ -10142,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,
@@ -25009,6 +25010,7 @@ class GodotDAPClient {
   pendingRequests;
   reader = new FrameReader;
   outputBuffer = [];
+  onOutput = null;
   maxOutputLines = 1000;
   initialized = false;
   attached = false;
@@ -25176,6 +25178,13 @@ class GodotDAPClient {
       if (outputText.length > 0) {
         const lines = outputText.split(/\r?\n/).filter((line) => line.length > 0);
         this.outputBuffer.push(...lines);
+        if (this.onOutput !== null) {
+          for (const line of lines) {
+            try {
+              this.onOutput(line);
+            } catch {}
+          }
+        }
       }
       if (this.outputBuffer.length > this.maxOutputLines) {
         this.outputBuffer = this.outputBuffer.slice(this.outputBuffer.length - this.maxOutputLines);
@@ -25232,6 +25241,9 @@ class GodotDAPClient {
     await this.sendRequest("configurationDone", {});
     this.attached = true;
   }
+  setOutputSink(sink) {
+    this.onOutput = sink;
+  }
   getOutput(clear = false) {
     const lines = [...this.outputBuffer];
     if (clear) {
@@ -27545,6 +27557,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();
@@ -27973,6 +27994,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);
@@ -28745,8 +28801,8 @@ 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.",
-    parameters: { projectPath: PROJECT_PATH },
+    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, ops: ["open"] } },
     requires: [],
     operations: {
       open: { summary: "open the editor on a project", requires: ["projectPath"] },
@@ -28758,7 +28814,7 @@ var TOOL_SPECS = [
     name: "editor_run",
     description: "The run: starting the project, stopping it, or booting it once to see whether it comes up clean. start keeps it running and collecting output until it quits or is stopped, windowed where there is a display and headless where there is not, unless headless says otherwise; only runtime_capture needs the window. A run that quits on its own is kept, so a scene that prints an answer and quits is start, then editor_output until running is false. What runs is a scene: a SceneTree script is not an entry point here, so put the script on the root of a scene of its own and name that in scene. args hands the game its own flags, the ones it reads with OS.get_cmdline_user_args(), and a run carrying any is started by this server rather than by the editor. check boots it headless for a few frames, waits for it to quit, and answers with the verdict: whether it came up, and every error and warning it printed on the way. A start waits for the game to become something the runtime_* tools can talk to and says which it is under runtime: listening with the port it took, or why not, so the first call after a start does not have to be made twice. When it is not listening, mayYetAnnounce says whether that is final: false is a runtime that is not coming, true is a game still on its way up, which editor_status will see and runtimeWaitMs waits longer for. A start this server made also answers with transcript, the file both the run's streams are written to, so a watch on it can be armed off the start rather than off a second call.",
     parameters: {
-      projectPath: PROJECT_PATH,
+      projectPath: { ...PROJECT_PATH, ops: ["start", "check"] },
       scene: {
         type: "string",
         ops: ["start", "check"],
@@ -28787,11 +28843,17 @@ var TOOL_SPECS = [
         description: "check: how long to give the boot before it is called hung. Default 60000. wait: how long to wait for the run to end before answering anyway. Default 600000."
       }
     },
-    requires: ["projectPath"],
+    requires: [],
     operations: {
-      start: { summary: "run the project until it quits or is stopped", requires: [] },
+      start: {
+        summary: "run the project until it quits or is stopped",
+        requires: ["projectPath"]
+      },
       stop: { summary: "end the run and answer with what it printed last", requires: [] },
-      check: { summary: "boot headless, quit after a few frames, and report the verdict", requires: [] },
+      check: {
+        summary: "boot headless, quit after a few frames, and report the verdict",
+        requires: ["projectPath"]
+      },
       wait: { summary: "wait for the run to end, then answer as editor_output does", requires: [] }
     },
     defaultOperation: "start"
@@ -29830,9 +29892,10 @@ class GodotServer {
     if (op !== null) {
       const elsewhere = Object.keys(args).filter((key) => key !== "op" && !opTakes(spec, op, key));
       if (elsewhere.length > 0) {
+        const takes = argumentsOf(spec, op);
         return {
           ok: false,
-          response: this.createErrorResponse(`${spec.name} ${op} does not take ${elsewhere.join(", ")}. ${op} takes: ${argumentsOf(spec, op).join(", ")}.`)
+          response: this.createErrorResponse(`${spec.name} ${op} does not take ${elsewhere.join(", ")}. ${takes.length === 0 ? `${op} takes no arguments.` : `${op} takes: ${takes.join(", ")}.`}`)
         };
       }
     }
@@ -30582,9 +30645,27 @@ class GodotServer {
     if (this.dapClient !== null && this.dapClient.port !== port) {
       this.dapClient = null;
     }
-    this.dapClient ??= new GodotDAPClient(port);
+    if (this.dapClient === null) {
+      this.dapClient = new GodotDAPClient(port);
+      this.dapClient.setOutputSink((line) => {
+        this.writeToTranscript(line);
+      });
+    }
     return this.dapClient;
   }
+  writeToTranscript(line) {
+    const run = this.activeProcess;
+    if (run?.throughEditor !== true || run.transcript === null) {
+      return;
+    }
+    try {
+      appendFileSync(run.transcript, line.endsWith(`
+`) ? line : `${line}
+`);
+    } catch (error) {
+      this.logDebug(`Could not write an editor-played run's transcript: ${errorMessage(error)}`);
+    }
+  }
   editorServes(field, variable, fallback) {
     const named = portFromEnvOrNull(variable);
     if (named !== null) {
@@ -30660,6 +30741,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) {
@@ -30668,6 +30759,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) {
@@ -30687,6 +30779,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,
@@ -30694,6 +30788,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
     });
   }
@@ -30884,6 +30980,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`,
@@ -30894,19 +30991,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",
@@ -30922,10 +31024,15 @@ class GodotServer {
     if (!game.throughEditor || !this.dapClient) {
       return;
     }
-    for (const line of this.dapClient.getOutput(true)) {
-      game.log.append("stdout", line.endsWith(`
+    if (game.transcript === null) {
+      for (const line of this.dapClient.getOutput(true)) {
+        game.log.append("stdout", line.endsWith(`
 `) ? line : `${line}
 `);
+      }
+    }
+    if (!this.dapClient.isConnected()) {
+      game.consoleLost = true;
     }
     this.recordWhatItBrokeOn(game);
   }
@@ -31079,7 +31186,20 @@ class GodotServer {
     }
   }
   async pickUpWhatTheEditorIsPlaying() {
-    if (this.activeProcess !== null || !this.godotBridge.isConnected()) {
+    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();
@@ -31091,19 +31211,23 @@ class GodotServer {
     } catch (error) {
       this.logDebug(`Picked up an editor-played run without its adapter: ${errorMessage(error)}`);
     }
-    this.activeProcess = {
+    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: null,
+      transcript: note?.transcript ?? null,
       readOffset: 0,
-      projectPath: this.godotBridge.getStatus().projectPath ?? null,
-      startedAt: Date.now(),
+      projectPath: project,
+      startedAt: note?.startedAt ?? Date.now(),
       exitCode: null,
       throughEditor: true,
       brokeOn: null,
       pickedUpPlaying: true
     };
+    this.activeProcess = picked;
   }
   adoptRecordedRun() {
     const record = readRunRecord();
@@ -31223,6 +31347,9 @@ 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.`);
     }
@@ -31230,7 +31357,11 @@ class GodotServer {
       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("The editor was already playing this when this server reached it, so this is not the run from its start: what it printed before that went with the server that was listening then. It is the run the editor is holding now, which is the one the debug_* tools answer for.");
+      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}.`);
@@ -31247,7 +31378,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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "0.13.7",
+  "version": "0.13.9",
   "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",