gdharness 1.0.7 → 1.0.8

package/build/cli.js

@@ -31993,17 +31993,49 @@ var init_bridge_announce = __esm(() => {
   init_errors();
 });
 
+// src/class-note.ts
+import { mkdirSync as mkdirSync9, readFileSync as readFileSync14, writeFileSync as writeFileSync11 } from "node:fs";
+import { dirname as dirname11, join as join16 } from "node:path";
+function classNotePath(projectPath) {
+  return join16(projectPath, ".godot", "gdharness-classes.json");
+}
+function readClassNote(projectPath) {
+  try {
+    const fields = asParams(JSON.parse(readFileSync14(classNotePath(projectPath), "utf8")));
+    const rebuiltWith = readArray(fields, "rebuiltWith");
+    if (rebuiltWith === undefined || !rebuiltWith.every((name) => typeof name === "string")) {
+      return null;
+    }
+    const pid = readNumber(fields, "shortListEditorPid");
+    return {
+      rebuiltWith: rebuiltWith.map(String),
+      ...Object.hasOwn(fields, "shortListEditorPid") ? { shortListEditorPid: pid ?? null } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function writeClassNote(projectPath, note) {
+  try {
+    const path = classNotePath(projectPath);
+    mkdirSync9(dirname11(path), { recursive: true });
+    writeFileSync11(path, `${JSON.stringify(note, null, 2)}
+`, "utf8");
+  } catch {}
+}
+var init_class_note = () => {};
+
 // src/config-pin.ts
-import { existsSync as existsSync11, readFileSync as readFileSync14 } from "node:fs";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync11, readFileSync as readFileSync15 } from "node:fs";
+import { join as join17 } from "node:path";
 function versionsNamedInConfig(projectPath) {
-  const config = join16(projectPath, ".mcp.json");
+  const config = join17(projectPath, ".mcp.json");
   if (!existsSync11(config)) {
     return [];
   }
   let text;
   try {
-    text = readFileSync14(config, "utf8");
+    text = readFileSync15(config, "utf8");
     JSON.parse(text);
   } catch {
     return [];
@@ -36564,7 +36596,7 @@ var init_junit = __esm(() => {
 import { realpathSync as realpathSync2 } from "node:fs";
 import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection3 } from "node:net";
-import { dirname as dirname11, resolve as resolve4 } from "node:path";
+import { dirname as dirname12, resolve as resolve4 } from "node:path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
 function diagnosticsKey(uri) {
   let decoded;
@@ -36692,7 +36724,7 @@ class GodotLSPClient {
     if (this.initialized) {
       return;
     }
-    const rootPath = this.rootPath ?? dirname11(resolve4(filePath));
+    const rootPath = this.rootPath ?? dirname12(resolve4(filePath));
     await this.initialize(rootPath);
   }
   async sendRequest(method, params) {
@@ -37137,13 +37169,13 @@ var init_process_time = __esm(() => {
 });
 
 // src/project-scan.ts
-import { existsSync as existsSync13, readdirSync as readdirSync5, readFileSync as readFileSync15 } from "node:fs";
-import { join as join17 } from "node:path";
+import { existsSync as existsSync13, readdirSync as readdirSync5, readFileSync as readFileSync16 } from "node:fs";
+import { join as join18 } from "node:path";
 function skipped(name) {
   return name.startsWith(".") || SKIPPED.has(name);
 }
 function steppedOver(directory) {
-  return existsSync13(join17(directory, ".gdignore"));
+  return existsSync13(join18(directory, ".gdignore"));
 }
 function projectStructure(projectPath) {
   const structure = { scenes: 0, scripts: 0, assets: 0, other: 0 };
@@ -37156,7 +37188,7 @@ function projectStructure(projectPath) {
         continue;
       }
       if (entry.isDirectory()) {
-        visit(join17(directory, entry.name));
+        visit(join18(directory, entry.name));
       } else if (entry.isFile()) {
         const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
         if (extension === "tscn") {
@@ -37186,14 +37218,14 @@ function scriptsWithoutUid(projectPath) {
       }
       const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
       if (entry.isDirectory()) {
-        visit(join17(directory, entry.name), spelled);
+        visit(join18(directory, entry.name), spelled);
         continue;
       }
       if (!entry.isFile()) {
         continue;
       }
       const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
-      if (CARRIES_A_UID.has(extension) && !existsSync13(join17(directory, `${entry.name}.uid`))) {
+      if (CARRIES_A_UID.has(extension) && !existsSync13(join18(directory, `${entry.name}.uid`))) {
         found.push(spelled);
       }
     }
@@ -37228,7 +37260,7 @@ function searchProject(projectPath, options) {
       if (skipped(entry.name)) {
         continue;
       }
-      const entryPath = join17(directory, entry.name);
+      const entryPath = join18(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -37239,7 +37271,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync15(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync16(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -37268,16 +37300,16 @@ var init_project_scan = __esm(() => {
 });
 
 // src/restart-note.ts
-import { mkdirSync as mkdirSync9, readFileSync as readFileSync16, rmSync as rmSync8, writeFileSync as writeFileSync11 } from "node:fs";
-import { dirname as dirname12, join as join18 } from "node:path";
+import { mkdirSync as mkdirSync10, readFileSync as readFileSync17, rmSync as rmSync8, writeFileSync as writeFileSync12 } from "node:fs";
+import { dirname as dirname13, join as join19 } from "node:path";
 function restartNotePath(projectPath) {
-  return join18(projectPath, ".godot", "gdharness-restart.json");
+  return join19(projectPath, ".godot", "gdharness-restart.json");
 }
 function noteRestartBegun(note) {
   const path = restartNotePath(note.projectPath);
   try {
-    mkdirSync9(dirname12(path), { recursive: true });
-    writeFileSync11(path, `${JSON.stringify(note, null, 2)}
+    mkdirSync10(dirname13(path), { recursive: true });
+    writeFileSync12(path, `${JSON.stringify(note, null, 2)}
 `, "utf8");
   } catch (error) {
     console.error(`[SERVER] Could not record the restart at ${path}: ${errorMessage(error)}`);
@@ -37285,7 +37317,7 @@ function noteRestartBegun(note) {
 }
 function restartOwed(projectPath) {
   try {
-    const parsed = JSON.parse(readFileSync16(restartNotePath(projectPath), "utf8"));
+    const parsed = JSON.parse(readFileSync17(restartNotePath(projectPath), "utf8"));
     if (typeof parsed !== "object" || parsed === null) {
       return null;
     }
@@ -37311,36 +37343,36 @@ var init_restart_note = __esm(() => {
 
 // src/run-record.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { mkdirSync as mkdirSync10, openSync, readdirSync as readdirSync6, readFileSync as readFileSync17, rmSync as rmSync9, statSync as statSync4, writeFileSync as writeFileSync12 } from "node:fs";
-import { basename as basename3, join as join19 } from "node:path";
+import { mkdirSync as mkdirSync11, openSync, readdirSync as readdirSync6, readFileSync as readFileSync18, rmSync as rmSync9, statSync as statSync4, writeFileSync as writeFileSync13 } from "node:fs";
+import { basename as basename3, join as join20 } from "node:path";
 function runsDirectory() {
-  return join19(runtimeDirectory(), "runs");
+  return join20(runtimeDirectory(), "runs");
 }
 function recordPath() {
-  return join19(runsDirectory(), "run.json");
+  return join20(runsDirectory(), "run.json");
 }
 function recordPaths() {
-  return runtimeDirectories().map((directory) => join19(directory, "runs", "run.json"));
+  return runtimeDirectories().map((directory) => join20(directory, "runs", "run.json"));
 }
 function openTranscript(startedAt) {
-  mkdirSync10(runsDirectory(), { recursive: true });
-  const path = join19(runsDirectory(), `run-${startedAt}.log`);
+  mkdirSync11(runsDirectory(), { recursive: true });
+  const path = join20(runsDirectory(), `run-${startedAt}.log`);
   return { path, fd: openSync(path, "a") };
 }
 function writeRunRecord(record) {
-  mkdirSync10(runsDirectory(), { recursive: true });
-  writeFileSync12(recordPath(), JSON.stringify(record, null, 2), "utf8");
+  mkdirSync11(runsDirectory(), { recursive: true });
+  writeFileSync13(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
 function editorNotePath() {
-  return join19(runsDirectory(), "editor-run.json");
+  return join20(runsDirectory(), "editor-run.json");
 }
 function writeEditorRunNote(note) {
-  mkdirSync10(runsDirectory(), { recursive: true });
-  writeFileSync12(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
+  mkdirSync11(runsDirectory(), { recursive: true });
+  writeFileSync13(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
 }
 function readEditorRunNote() {
   for (const directory of runtimeDirectories()) {
-    const note = editorNoteAt(join19(directory, "runs", "editor-run.json"));
+    const note = editorNoteAt(join20(directory, "runs", "editor-run.json"));
     if (note !== null) {
       return note;
     }
@@ -37350,7 +37382,7 @@ function readEditorRunNote() {
 function editorNoteAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync17(path, "utf8"));
+    parsed = JSON.parse(readFileSync18(path, "utf8"));
   } catch {
     return null;
   }
@@ -37373,7 +37405,7 @@ function recordRunEnded(pid, exitCode) {
     return;
   }
   try {
-    writeFileSync12(path, JSON.stringify({ ...record, exitCode }, null, 2), "utf8");
+    writeFileSync13(path, JSON.stringify({ ...record, exitCode }, null, 2), "utf8");
   } catch {}
 }
 function readRunRecord() {
@@ -37388,7 +37420,7 @@ function readRunRecord() {
 function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync17(path, "utf8"));
+    parsed = JSON.parse(readFileSync18(path, "utf8"));
   } catch {
     return null;
   }
@@ -37433,7 +37465,7 @@ function runningAs(pid) {
     const began = startedAt(pid, null);
     const when = began === null ? {} : { startedAt: began };
     if (process.platform === "linux") {
-      const raw = readFileSync17(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
+      const raw = readFileSync18(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
       return raw === "" ? null : { kind: "commandLine", text: raw, ...when };
     }
     const args = execFileSync2("ps", ["-p", String(pid), "-o", "args="], {
@@ -37584,7 +37616,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
     if (!entry.startsWith("run-") || !entry.endsWith(".log")) {
       continue;
     }
-    const path = join19(directory, entry);
+    const path = join20(directory, entry);
     if (path === keep || ageMs(path, now) < keepMs) {
       continue;
     }
@@ -37607,16 +37639,16 @@ import {
   closeSync,
   existsSync as existsSync14,
   fstatSync,
-  mkdirSync as mkdirSync11,
+  mkdirSync as mkdirSync12,
   mkdtempSync as mkdtempSync3,
   openSync as openSync2,
   readdirSync as readdirSync7,
-  readFileSync as readFileSync18,
+  readFileSync as readFileSync19,
   readSync,
   statSync as statSync5
 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { basename as basename4, dirname as dirname13, join as join20, normalize as normalize3, relative as relative3, resolve as resolve5 } from "node:path";
+import { basename as basename4, dirname as dirname14, join as join21, normalize as normalize3, relative as relative3 } from "node:path";
 import { setTimeout as delay3 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { promisify as promisify7 } from "node:util";
@@ -37858,7 +37890,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync14(join20(projectPath, wanted))) {
+  if (wanted === "" || existsSync14(join21(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -37872,7 +37904,7 @@ function elsewhereIn(projectPath, asked) {
   return near.length === 0 ? "" : ` The project does have ${there}.`;
 }
 function hasMainScene(projectFile) {
-  const scene = parseProjectGodot(readFileSync18(projectFile, "utf8"))["application"]?.["run/main_scene"];
+  const scene = parseProjectGodot(readFileSync19(projectFile, "utf8"))["application"]?.["run/main_scene"];
   return typeof scene === "string" && scene !== "";
 }
 function runtimeAddonAnnouncesEditors(projectPath) {
@@ -37880,13 +37912,13 @@ function runtimeAddonAnnouncesEditors(projectPath) {
     return false;
   }
   try {
-    return readFileSync18(join20(projectPath, RUNTIME_AUTOLOAD2.path), "utf8").includes('"editor_pid"');
+    return readFileSync19(join21(projectPath, RUNTIME_AUTOLOAD2.path), "utf8").includes('"editor_pid"');
   } catch {
     return false;
   }
 }
 function editorPlaysHeadless(projectFile) {
-  const runArgs = parseProjectGodot(readFileSync18(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
+  const runArgs = parseProjectGodot(readFileSync19(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
   return typeof runArgs === "string" && /(?:^|\s)--headless(?:\s|$)/.test(runArgs);
 }
 function camelCased(params) {
@@ -37902,7 +37934,7 @@ function camelCased(params) {
 class GodotServer {
   mcp;
   locator = new GodotLocator2;
-  operationsScript = join20(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join21(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -37920,8 +37952,6 @@ class GodotServer {
   successorWatch = null;
   lastProjectPath = null;
   shutdownInitiated = false;
-  shortListEditors = new Map;
-  cacheLastRebuilt = new Map;
   launchedEditor = null;
   launchedFrom = null;
   ownProject;
@@ -38569,7 +38599,7 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join20(path, "project.godot");
+    const file = join21(path, "project.godot");
     if (!existsSync14(file)) {
       return {
         ok: false,
@@ -38793,7 +38823,7 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const application = parseProjectGodot(readFileSync18(project.value.file, "utf8"))["application"] ?? {};
+    const application = parseProjectGodot(readFileSync19(project.value.file, "utf8"))["application"] ?? {};
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
@@ -38854,18 +38884,18 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const folder = dirname13(output.absolutePath);
+    const folder = dirname14(output.absolutePath);
     try {
-      mkdirSync11(folder, { recursive: true });
+      mkdirSync12(folder, { recursive: true });
     } catch (error) {
-      return this.createErrorResponse(`Cannot create ${dirname13(output.relativePath)} to export into: ${errorMessage(error)}`);
+      return this.createErrorResponse(`Cannot create ${dirname14(output.relativePath)} to export into: ${errorMessage(error)}`);
     }
     const debug = readBoolean(args, "debug") ?? false;
-    const exportLogs = mkdtempSync3(join20(tmpdir5(), "gdharness-export-"));
+    const exportLogs = mkdtempSync3(join21(tmpdir5(), "gdharness-export-"));
     const exportArgs = [
       "--headless",
       "--log-file",
-      join20(exportLogs, "engine.log"),
+      join21(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -38923,7 +38953,7 @@ class GodotServer {
       return contained.response;
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync14(join20(project.value.path, runner))) {
+    if (!existsSync14(join21(project.value.path, runner))) {
       return this.createErrorResponse(`gdUnit4 is not installed in this project: no ${runner}.`, [
         "Install gdUnit4 under addons/gdUnit4, from https://github.com/godot-gdunit-labs/gdUnit4"
       ]);
@@ -38958,7 +38988,7 @@ class GodotServer {
     ];
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 600000;
     this.logDebug(`Running tests: ${engine.value} ${cmdArgs.join(" ")}`);
-    const userData = mkdtempSync3(join20(tmpdir5(), "gdharness-tests-"));
+    const userData = mkdtempSync3(join21(tmpdir5(), "gdharness-tests-"));
     const run = this.spawnGame(engine.value, cmdArgs, userDataIn(userData));
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -38974,14 +39004,14 @@ class GodotServer {
         resolve(false);
       });
     });
-    const reportsDir = join20(project.value.path, ".godot", ...ours.split("/"));
+    const reportsDir = join21(project.value.path, ".godot", ...ours.split("/"));
     let report = null;
     let reportProblem = null;
     try {
       const written = existsSync14(reportsDir) ? readdirSync7(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
-        report = parseJUnit(readFileSync18(join20(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync19(join21(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -39121,7 +39151,7 @@ class GodotServer {
         return null;
       }
       try {
-        return readFileSync18(contained.absolutePath, "utf8");
+        return readFileSync19(contained.absolutePath, "utf8");
       } catch {
         return null;
       }
@@ -39159,8 +39189,15 @@ class GodotServer {
     };
   }
   editorWritesAShortList(projectPath) {
-    const key = resolve5(projectPath);
-    return this.shortListEditors.has(key) && this.shortListEditors.get(key) === this.godotBridge.getStatus().editorPid;
+    const recorded = readClassNote(projectPath)?.shortListEditorPid;
+    return recorded !== undefined && recorded === (this.godotBridge.getStatus().editorPid ?? null);
+  }
+  noteAShortListEditor(projectPath) {
+    const note = readClassNote(projectPath);
+    writeClassNote(projectPath, {
+      rebuiltWith: note?.rebuiltWith ?? [],
+      shortListEditorPid: this.godotBridge.getStatus().editorPid ?? null
+    });
   }
   sourceOfClass(projectPath, resourcePath) {
     const contained = resolveWithinProject(projectPath, resourcePath);
@@ -39168,7 +39205,7 @@ class GodotServer {
       return null;
     }
     try {
-      return readFileSync18(contained.absolutePath, "utf8");
+      return readFileSync19(contained.absolutePath, "utf8");
     } catch {
       return null;
     }
@@ -39397,7 +39434,7 @@ class GodotServer {
       return null;
     }
     try {
-      return settingKeys(readFileSync18(join20(projectPath, "project.godot"), "utf8"));
+      return settingKeys(readFileSync19(join21(projectPath, "project.godot"), "utf8"));
     } catch {
       return null;
     }
@@ -39639,7 +39676,7 @@ class GodotServer {
   }
   async runtimeUp(projectPath, before, budget, withArgs) {
     const budgetMs = budget.ms;
-    if (!existsSync14(join20(projectPath, RUNTIME_AUTOLOAD2.path))) {
+    if (!existsSync14(join21(projectPath, RUNTIME_AUTOLOAD2.path))) {
       return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false, withArgs });
     }
     let asking = null;
@@ -40512,7 +40549,7 @@ class GodotServer {
     const after = projectPath === "" || busy ? null : cachedClasses(projectPath);
     const lost = before === null || after === null ? [] : [...before.keys()].filter((name) => !after.has(name));
     if (lost.length > 0) {
-      this.shortListEditors.set(resolve5(projectPath), this.godotBridge.getStatus().editorPid);
+      this.noteAShortListEditor(projectPath);
     }
     const atMissingPaths = after === null ? [] : cachedAtMissingPaths(after, projectPath);
     const restored = lost.length > 0 || atMissingPaths.length > 0 ? await this.rebuildCacheAfterLoss(projectPath, lost) : [];
@@ -40578,9 +40615,8 @@ class GodotServer {
     return now === null ? [] : lost.filter((name) => now.has(name));
   }
   async rebuildClassCache(projectPath) {
-    const key = resolve5(projectPath);
     const before = cachedClasses(projectPath);
-    const remembered = this.cacheLastRebuilt.get(key);
+    const noted = readClassNote(projectPath);
     const rebuilt = await this.operation("refresh_class_cache", {}, projectPath);
     if (!rebuilt.ok) {
       return rebuilt;
@@ -40589,12 +40625,15 @@ class GodotServer {
     if (after === null) {
       return rebuilt;
     }
-    this.cacheLastRebuilt.set(key, new Set(after.keys()));
-    const lost = remembered === undefined || before === null ? [] : [...remembered].filter((name) => !before.has(name) && after.has(name)).sort();
-    if (lost.length === 0 || !this.godotBridge.isConnected()) {
+    const lost = noted === null || before === null ? [] : noted.rebuiltWith.filter((name) => !before.has(name) && after.has(name)).sort();
+    const seenLosing = lost.length > 0 && this.godotBridge.isConnected();
+    writeClassNote(projectPath, {
+      rebuiltWith: [...after.keys()].sort(),
+      ...seenLosing ? { shortListEditorPid: this.godotBridge.getStatus().editorPid ?? null } : noted?.shortListEditorPid === undefined ? {} : { shortListEditorPid: noted.shortListEditorPid }
+    });
+    if (!seenLosing) {
       return rebuilt;
     }
-    this.shortListEditors.set(key, this.godotBridge.getStatus().editorPid);
     const them = lost.length === 1 ? "it" : "them";
     return {
       ...rebuilt,
@@ -40751,8 +40790,8 @@ class GodotServer {
       ]);
     }
     const expectsScreenshot = command === "capture_screenshot" || command === "capture_viewport";
-    const screenshotDir = expectsScreenshot ? mkdtempSync3(join20(tmpdir5(), "gdharness-runtime-screenshot-")) : null;
-    const screenshotPath = screenshotDir ? join20(screenshotDir, "capture.png") : null;
+    const screenshotDir = expectsScreenshot ? mkdtempSync3(join21(tmpdir5(), "gdharness-runtime-screenshot-")) : null;
+    const screenshotPath = screenshotDir ? join21(screenshotDir, "capture.png") : null;
     try {
       const reply = await runtimeRequest(choice.endpoint, command, screenshotPath ? { ...params, output_path: screenshotPath } : params, timeoutMs);
       if (!reply.ok) {
@@ -40776,7 +40815,7 @@ class GodotServer {
             type: "text",
             text: `Screenshot captured: ${dimensions}${chosenAmongSeveral ? ` from pid ${own}, the game this server holds` : ""}`
           },
-          { type: "image", data: readFileSync18(screenshotPath).toString("base64"), mimeType: "image/png" }
+          { type: "image", data: readFileSync19(screenshotPath).toString("base64"), mimeType: "image/png" }
         ]
       };
     } finally {
@@ -40852,6 +40891,7 @@ var init_server3 = __esm(() => {
   init_breakpoint_note();
   init_bridge_announce();
   init_class_cache();
+  init_class_note();
   init_config_pin();
   init_dap_client();
   init_errors();
@@ -40878,7 +40918,7 @@ var init_server3 = __esm(() => {
   init_tool_definitions();
   init_update_check();
   run7 = promisify7(execFile7);
-  __dirname2 = dirname13(fileURLToPath4(import.meta.url));
+  __dirname2 = dirname14(fileURLToPath4(import.meta.url));
   CONSOLE_WRAPPER = /_console(\.exe)?$/i;
   LONGEST_BOOT_NOTED_MS = 5 * 60000;
   VALUE_NAMES = {
@@ -40919,7 +40959,7 @@ var init_server3 = __esm(() => {
 
 // src/cli.ts
 import { existsSync as existsSync15 } from "fs";
-import { join as join21, resolve as resolve6 } from "path";
+import { join as join22, resolve as resolve5 } from "path";
 
 // src/errors.ts
 class Refusal extends Error {
@@ -42623,8 +42663,8 @@ class UsageError extends Refusal {
 }
 function projectArgument(at) {
   const named = args.slice(at).find((value) => !value.startsWith("--"));
-  const projectPath = resolve6(named ?? ".");
-  if (!existsSync15(join21(projectPath, "project.godot"))) {
+  const projectPath = resolve5(named ?? ".");
+  if (!existsSync15(join22(projectPath, "project.godot"))) {
     throw new UsageError(`Not a Godot project: ${projectPath} holds no project.godot.`);
   }
   return projectPath;
@@ -42663,7 +42703,7 @@ async function registerRuntime(godot, projectPath) {
     return;
   }
   console.log(`${RUNTIME_AUTOLOAD.name} autoload left at ${named}, which this project registers itself`);
-  if (!existsSync15(join21(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
+  if (!existsSync15(join22(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
     console.log(`  that file is not in this project, so it boots with a missing script: restore it, or point the entry at res://${RUNTIME_AUTOLOAD.path}`);
   }
 }

package/build/index.js

@@ -10175,16 +10175,16 @@ import {
   closeSync,
   existsSync as existsSync9,
   fstatSync,
-  mkdirSync as mkdirSync8,
+  mkdirSync as mkdirSync9,
   mkdtempSync as mkdtempSync2,
   openSync as openSync2,
   readdirSync as readdirSync6,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   readSync,
   statSync as statSync5
 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
-import { basename as basename3, dirname as dirname8, join as join14, normalize as normalize2, relative as relative3, resolve as resolve5 } from "node:path";
+import { basename as basename3, dirname as dirname9, join as join15, normalize as normalize2, relative as relative3 } from "node:path";
 import { setTimeout as delay3 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { promisify as promisify5 } from "node:util";
@@ -25814,18 +25814,49 @@ function unseenByEditor(projectPath, editorHolds) {
   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);
 }
 
+// src/class-note.ts
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname5, join as join7 } from "node:path";
+function classNotePath(projectPath) {
+  return join7(projectPath, ".godot", "gdharness-classes.json");
+}
+function readClassNote(projectPath) {
+  try {
+    const fields = asParams(JSON.parse(readFileSync8(classNotePath(projectPath), "utf8")));
+    const rebuiltWith = readArray(fields, "rebuiltWith");
+    if (rebuiltWith === undefined || !rebuiltWith.every((name) => typeof name === "string")) {
+      return null;
+    }
+    const pid = readNumber(fields, "shortListEditorPid");
+    return {
+      rebuiltWith: rebuiltWith.map(String),
+      ...Object.hasOwn(fields, "shortListEditorPid") ? { shortListEditorPid: pid ?? null } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function writeClassNote(projectPath, note) {
+  try {
+    const path = classNotePath(projectPath);
+    mkdirSync5(dirname5(path), { recursive: true });
+    writeFileSync5(path, `${JSON.stringify(note, null, 2)}
+`, "utf8");
+  } catch {}
+}
+
 // src/config-pin.ts
-import { existsSync as existsSync4, readFileSync as readFileSync8 } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync9 } from "node:fs";
+import { join as join8 } from "node:path";
 var PINNED = /\bgdharness@(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\b/g;
 function versionsNamedInConfig(projectPath) {
-  const config = join7(projectPath, ".mcp.json");
+  const config = join8(projectPath, ".mcp.json");
   if (!existsSync4(config)) {
     return [];
   }
   let text;
   try {
-    text = readFileSync8(config, "utf8");
+    text = readFileSync9(config, "utf8");
     JSON.parse(text);
   } catch {
     return [];
@@ -27192,7 +27223,7 @@ import { promisify as promisify2 } from "node:util";
 // src/detection.ts
 import { existsSync as existsSync5, readdirSync as readdirSync3, statSync as statSync3 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 function resolveHomeDirectory() {
   try {
     return homedir2();
@@ -27216,7 +27247,7 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     if (!pattern.test(name)) {
       continue;
     }
-    const fullPath = join8(directory, name);
+    const fullPath = join9(directory, name);
     try {
       const stat = statSync3(fullPath);
       if (stat.isFile()) {
@@ -27225,7 +27256,7 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     } catch {}
   }
   matches.sort((a, b) => b.mtime - a.mtime);
-  return matches.map((m) => join8(directory, m.name));
+  return matches.map((m) => join9(directory, m.name));
 }
 function conventionalPaths(platform, home) {
   const paths = ["godot"];
@@ -27345,9 +27376,9 @@ class GodotLocator {
 
 // src/headless.ts
 import { execFile as execFile3 } from "node:child_process";
-import { mkdtempSync, writeFileSync as writeFileSync5 } from "node:fs";
+import { mkdtempSync, writeFileSync as writeFileSync6 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 import { promisify as promisify3 } from "node:util";
 
 // src/scratch.ts
@@ -27413,12 +27444,12 @@ function reason(stdout, stderr) {
   return stdout.trim().split(/\r?\n/).at(-1) ?? "no output at all";
 }
 async function runImport(godotPath, projectPath) {
-  const logDir = mkdtempSync(join9(tmpdir3(), "gdharness-import-"));
+  const logDir = mkdtempSync(join10(tmpdir3(), "gdharness-import-"));
   try {
     const { stderr } = await run3(godotPath, [
       "--headless",
       "--log-file",
-      join9(logDir, "engine.log"),
+      join10(logDir, "engine.log"),
       "--path",
       projectPath,
       "--import"
@@ -27443,13 +27474,13 @@ async function runImport(godotPath, projectPath) {
   }
 }
 async function runOperation(engine, operation, params, projectPath) {
-  const paramsDir = mkdtempSync(join9(tmpdir3(), "gdharness-params-"));
-  const paramsFile = join9(paramsDir, `${operation}.json`);
-  writeFileSync5(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
+  const paramsDir = mkdtempSync(join10(tmpdir3(), "gdharness-params-"));
+  const paramsFile = join10(paramsDir, `${operation}.json`);
+  writeFileSync6(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
   const args = [
     "--headless",
     "--log-file",
-    join9(paramsDir, "engine.log"),
+    join10(paramsDir, "engine.log"),
     "--path",
     projectPath,
     "--script",
@@ -27878,7 +27909,7 @@ function orphansPrinted(printed) {
 import { realpathSync as realpathSync2 } from "node:fs";
 import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection3 } from "node:net";
-import { dirname as dirname5, resolve as resolve3 } from "node:path";
+import { dirname as dirname6, resolve as resolve3 } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 var DEFAULT_LSP_PORT = 6005;
 var DIAGNOSTICS_TIMEOUT_MS = 5000;
@@ -28008,7 +28039,7 @@ class GodotLSPClient {
     if (this.initialized) {
       return;
     }
-    const rootPath = this.rootPath ?? dirname5(resolve3(filePath));
+    const rootPath = this.rootPath ?? dirname6(resolve3(filePath));
     await this.initialize(rootPath);
   }
   async sendRequest(method, params) {
@@ -28444,14 +28475,14 @@ function secondsFromClock(printed) {
 }
 
 // src/project-scan.ts
-import { existsSync as existsSync7, readdirSync as readdirSync4, readFileSync as readFileSync9 } from "node:fs";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync7, readdirSync as readdirSync4, readFileSync as readFileSync10 } from "node:fs";
+import { join as join11 } from "node:path";
 var SKIPPED = new Set(["node_modules"]);
 function skipped(name) {
   return name.startsWith(".") || SKIPPED.has(name);
 }
 function steppedOver(directory) {
-  return existsSync7(join10(directory, ".gdignore"));
+  return existsSync7(join11(directory, ".gdignore"));
 }
 var ASSET_EXTENSIONS = new Set(["png", "jpg", "jpeg", "webp", "svg", "ttf", "otf", "wav", "mp3", "ogg"]);
 function projectStructure(projectPath) {
@@ -28465,7 +28496,7 @@ function projectStructure(projectPath) {
         continue;
       }
       if (entry.isDirectory()) {
-        visit(join10(directory, entry.name));
+        visit(join11(directory, entry.name));
       } else if (entry.isFile()) {
         const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
         if (extension === "tscn") {
@@ -28496,14 +28527,14 @@ function scriptsWithoutUid(projectPath) {
       }
       const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
       if (entry.isDirectory()) {
-        visit(join10(directory, entry.name), spelled);
+        visit(join11(directory, entry.name), spelled);
         continue;
       }
       if (!entry.isFile()) {
         continue;
       }
       const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
-      if (CARRIES_A_UID.has(extension) && !existsSync7(join10(directory, `${entry.name}.uid`))) {
+      if (CARRIES_A_UID.has(extension) && !existsSync7(join11(directory, `${entry.name}.uid`))) {
         found.push(spelled);
       }
     }
@@ -28538,7 +28569,7 @@ function searchProject(projectPath, options) {
       if (skipped(entry.name)) {
         continue;
       }
-      const entryPath = join10(directory, entry.name);
+      const entryPath = join11(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -28549,7 +28580,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync9(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync10(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -28572,7 +28603,7 @@ function searchProject(projectPath, options) {
 }
 
 // src/resources.ts
-import { readFileSync as readFileSync10 } from "node:fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 import { extname, resolve as resolve4 } from "node:path";
 var STATIC_RESOURCES = [
   {
@@ -28767,7 +28798,7 @@ function readResourceText(uri, getProjectPath) {
   const parsedUri = parseGodotUri(uri);
   if (parsedUri.kind === "project-info") {
     const projectFilePath = resolveProjectFile(projectPath, "project.godot");
-    const rawProject = readFileSync10(projectFilePath, "utf-8");
+    const rawProject = readFileSync11(projectFilePath, "utf-8");
     const parsedProject = parseProjectGodot(rawProject);
     return {
       mimeType: "application/json",
@@ -28776,7 +28807,7 @@ function readResourceText(uri, getProjectPath) {
   }
   const filePath = resolveProjectFile(projectPath, parsedUri.resourcePath);
   ensureAllowedExtension(parsedUri.kind, filePath);
-  const text = readFileSync10(filePath, "utf-8");
+  const text = readFileSync11(filePath, "utf-8");
   return {
     mimeType: parsedUri.kind === "script" ? "text/x-gdscript" : "text/plain",
     text
@@ -28813,16 +28844,16 @@ function setupResourceHandlers(mcp, getProjectPath) {
 }
 
 // src/restart-note.ts
-import { mkdirSync as mkdirSync5, readFileSync as readFileSync11, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
-import { dirname as dirname6, join as join11 } from "node:path";
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync12, rmSync as rmSync4, writeFileSync as writeFileSync7 } from "node:fs";
+import { dirname as dirname7, join as join12 } from "node:path";
 function restartNotePath(projectPath) {
-  return join11(projectPath, ".godot", "gdharness-restart.json");
+  return join12(projectPath, ".godot", "gdharness-restart.json");
 }
 function noteRestartBegun(note) {
   const path = restartNotePath(note.projectPath);
   try {
-    mkdirSync5(dirname6(path), { recursive: true });
-    writeFileSync6(path, `${JSON.stringify(note, null, 2)}
+    mkdirSync6(dirname7(path), { recursive: true });
+    writeFileSync7(path, `${JSON.stringify(note, null, 2)}
 `, "utf8");
   } catch (error) {
     console.error(`[SERVER] Could not record the restart at ${path}: ${errorMessage(error)}`);
@@ -28830,7 +28861,7 @@ function noteRestartBegun(note) {
 }
 function restartOwed(projectPath) {
   try {
-    const parsed = JSON.parse(readFileSync11(restartNotePath(projectPath), "utf8"));
+    const parsed = JSON.parse(readFileSync12(restartNotePath(projectPath), "utf8"));
     if (typeof parsed !== "object" || parsed === null) {
       return null;
     }
@@ -28853,36 +28884,36 @@ function restartSettled(projectPath) {
 
 // src/run-record.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync5, readFileSync as readFileSync12, rmSync as rmSync5, statSync as statSync4, writeFileSync as writeFileSync7 } from "node:fs";
-import { basename as basename2, join as join12 } from "node:path";
+import { mkdirSync as mkdirSync7, openSync, readdirSync as readdirSync5, readFileSync as readFileSync13, rmSync as rmSync5, statSync as statSync4, writeFileSync as writeFileSync8 } from "node:fs";
+import { basename as basename2, join as join13 } from "node:path";
 function runsDirectory() {
-  return join12(runtimeDirectory(), "runs");
+  return join13(runtimeDirectory(), "runs");
 }
 function recordPath() {
-  return join12(runsDirectory(), "run.json");
+  return join13(runsDirectory(), "run.json");
 }
 function recordPaths() {
-  return runtimeDirectories().map((directory) => join12(directory, "runs", "run.json"));
+  return runtimeDirectories().map((directory) => join13(directory, "runs", "run.json"));
 }
 function openTranscript(startedAt) {
-  mkdirSync6(runsDirectory(), { recursive: true });
-  const path = join12(runsDirectory(), `run-${startedAt}.log`);
+  mkdirSync7(runsDirectory(), { recursive: true });
+  const path = join13(runsDirectory(), `run-${startedAt}.log`);
   return { path, fd: openSync(path, "a") };
 }
 function writeRunRecord(record) {
-  mkdirSync6(runsDirectory(), { recursive: true });
-  writeFileSync7(recordPath(), JSON.stringify(record, null, 2), "utf8");
+  mkdirSync7(runsDirectory(), { recursive: true });
+  writeFileSync8(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
 function editorNotePath() {
-  return join12(runsDirectory(), "editor-run.json");
+  return join13(runsDirectory(), "editor-run.json");
 }
 function writeEditorRunNote(note) {
-  mkdirSync6(runsDirectory(), { recursive: true });
-  writeFileSync7(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
+  mkdirSync7(runsDirectory(), { recursive: true });
+  writeFileSync8(editorNotePath(), JSON.stringify(note, null, 2), "utf8");
 }
 function readEditorRunNote() {
   for (const directory of runtimeDirectories()) {
-    const note = editorNoteAt(join12(directory, "runs", "editor-run.json"));
+    const note = editorNoteAt(join13(directory, "runs", "editor-run.json"));
     if (note !== null) {
       return note;
     }
@@ -28892,7 +28923,7 @@ function readEditorRunNote() {
 function editorNoteAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync12(path, "utf8"));
+    parsed = JSON.parse(readFileSync13(path, "utf8"));
   } catch {
     return null;
   }
@@ -28915,7 +28946,7 @@ function recordRunEnded(pid, exitCode) {
     return;
   }
   try {
-    writeFileSync7(path, JSON.stringify({ ...record, exitCode }, null, 2), "utf8");
+    writeFileSync8(path, JSON.stringify({ ...record, exitCode }, null, 2), "utf8");
   } catch {}
 }
 function readRunRecord() {
@@ -28930,7 +28961,7 @@ function readRunRecord() {
 function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync12(path, "utf8"));
+    parsed = JSON.parse(readFileSync13(path, "utf8"));
   } catch {
     return null;
   }
@@ -28975,7 +29006,7 @@ function runningAs(pid) {
     const began = startedAt(pid, null);
     const when = began === null ? {} : { startedAt: began };
     if (process.platform === "linux") {
-      const raw = readFileSync12(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
+      const raw = readFileSync13(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
       return raw === "" ? null : { kind: "commandLine", text: raw, ...when };
     }
     const args = execFileSync2("ps", ["-p", String(pid), "-o", "args="], {
@@ -29128,7 +29159,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
     if (!entry.startsWith("run-") || !entry.endsWith(".log")) {
       continue;
     }
-    const path = join12(directory, entry);
+    const path = join13(directory, entry);
     if (path === keep || ageMs(path, now) < keepMs) {
       continue;
     }
@@ -29139,8 +29170,8 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
 }
 
 // src/setup.ts
-import { cpSync, existsSync as existsSync8, mkdirSync as mkdirSync7, readFileSync as readFileSync13, rmSync as rmSync6, writeFileSync as writeFileSync8 } from "node:fs";
-import { dirname as dirname7, join as join13 } from "node:path";
+import { cpSync, existsSync as existsSync8, mkdirSync as mkdirSync8, readFileSync as readFileSync14, rmSync as rmSync6, writeFileSync as writeFileSync9 } from "node:fs";
+import { dirname as dirname8, join as join14 } from "node:path";
 var ADDONS = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
 var RUNTIME_AUTOLOAD = {
   name: "GdharnessRuntime",
@@ -29148,11 +29179,11 @@ var RUNTIME_AUTOLOAD = {
 };
 var VERSION_MARKER = ".gdharness-version";
 function installedAddonVersion(projectPath) {
-  const marker = join13(projectPath, "addons", ADDONS[0], VERSION_MARKER);
+  const marker = join14(projectPath, "addons", ADDONS[0], VERSION_MARKER);
   if (!existsSync8(marker)) {
     return null;
   }
-  const said = readFileSync13(marker, "utf8").trim();
+  const said = readFileSync14(marker, "utf8").trim();
   return said === "" ? null : said;
 }
 
@@ -30309,7 +30340,7 @@ function buildToolDefinitions() {
 var UPDATE_NOTICE_EVERY = 500;
 var FEEDBACK_NOTICE_EVERY = 250;
 var run5 = promisify5(execFile5);
-var __dirname2 = dirname8(fileURLToPath2(import.meta.url));
+var __dirname2 = dirname9(fileURLToPath2(import.meta.url));
 var EDITOR_RESTART_TIMEOUT_MS = 90000;
 var HOLD_PING_MS = 2000;
 var SLOWEST_FRAME_RATE = 20;
@@ -30596,7 +30627,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync9(join14(projectPath, wanted))) {
+  if (wanted === "" || existsSync9(join15(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -30610,7 +30641,7 @@ function elsewhereIn(projectPath, asked) {
   return near.length === 0 ? "" : ` The project does have ${there}.`;
 }
 function hasMainScene(projectFile) {
-  const scene = parseProjectGodot(readFileSync14(projectFile, "utf8"))["application"]?.["run/main_scene"];
+  const scene = parseProjectGodot(readFileSync15(projectFile, "utf8"))["application"]?.["run/main_scene"];
   return typeof scene === "string" && scene !== "";
 }
 function runtimeAddonAnnouncesEditors(projectPath) {
@@ -30618,13 +30649,13 @@ function runtimeAddonAnnouncesEditors(projectPath) {
     return false;
   }
   try {
-    return readFileSync14(join14(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
+    return readFileSync15(join15(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
   } catch {
     return false;
   }
 }
 function editorPlaysHeadless(projectFile) {
-  const runArgs = parseProjectGodot(readFileSync14(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
+  const runArgs = parseProjectGodot(readFileSync15(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
   return typeof runArgs === "string" && /(?:^|\s)--headless(?:\s|$)/.test(runArgs);
 }
 function camelCased(params) {
@@ -30640,7 +30671,7 @@ function camelCased(params) {
 class GodotServer {
   mcp;
   locator = new GodotLocator;
-  operationsScript = join14(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join15(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -30658,8 +30689,6 @@ class GodotServer {
   successorWatch = null;
   lastProjectPath = null;
   shutdownInitiated = false;
-  shortListEditors = new Map;
-  cacheLastRebuilt = new Map;
   launchedEditor = null;
   launchedFrom = null;
   ownProject;
@@ -31307,7 +31336,7 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join14(path, "project.godot");
+    const file = join15(path, "project.godot");
     if (!existsSync9(file)) {
       return {
         ok: false,
@@ -31531,7 +31560,7 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const application = parseProjectGodot(readFileSync14(project.value.file, "utf8"))["application"] ?? {};
+    const application = parseProjectGodot(readFileSync15(project.value.file, "utf8"))["application"] ?? {};
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
@@ -31592,18 +31621,18 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const folder = dirname8(output.absolutePath);
+    const folder = dirname9(output.absolutePath);
     try {
-      mkdirSync8(folder, { recursive: true });
+      mkdirSync9(folder, { recursive: true });
     } catch (error) {
-      return this.createErrorResponse(`Cannot create ${dirname8(output.relativePath)} to export into: ${errorMessage(error)}`);
+      return this.createErrorResponse(`Cannot create ${dirname9(output.relativePath)} to export into: ${errorMessage(error)}`);
     }
     const debug = readBoolean(args, "debug") ?? false;
-    const exportLogs = mkdtempSync2(join14(tmpdir4(), "gdharness-export-"));
+    const exportLogs = mkdtempSync2(join15(tmpdir4(), "gdharness-export-"));
     const exportArgs = [
       "--headless",
       "--log-file",
-      join14(exportLogs, "engine.log"),
+      join15(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -31661,7 +31690,7 @@ class GodotServer {
       return contained.response;
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync9(join14(project.value.path, runner))) {
+    if (!existsSync9(join15(project.value.path, runner))) {
       return this.createErrorResponse(`gdUnit4 is not installed in this project: no ${runner}.`, [
         "Install gdUnit4 under addons/gdUnit4, from https://github.com/godot-gdunit-labs/gdUnit4"
       ]);
@@ -31696,7 +31725,7 @@ class GodotServer {
     ];
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 600000;
     this.logDebug(`Running tests: ${engine.value} ${cmdArgs.join(" ")}`);
-    const userData = mkdtempSync2(join14(tmpdir4(), "gdharness-tests-"));
+    const userData = mkdtempSync2(join15(tmpdir4(), "gdharness-tests-"));
     const run = this.spawnGame(engine.value, cmdArgs, userDataIn(userData));
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -31712,14 +31741,14 @@ class GodotServer {
         resolve(false);
       });
     });
-    const reportsDir = join14(project.value.path, ".godot", ...ours.split("/"));
+    const reportsDir = join15(project.value.path, ".godot", ...ours.split("/"));
     let report = null;
     let reportProblem = null;
     try {
       const written = existsSync9(reportsDir) ? readdirSync6(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
-        report = parseJUnit(readFileSync14(join14(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync15(join15(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -31859,7 +31888,7 @@ class GodotServer {
         return null;
       }
       try {
-        return readFileSync14(contained.absolutePath, "utf8");
+        return readFileSync15(contained.absolutePath, "utf8");
       } catch {
         return null;
       }
@@ -31897,8 +31926,15 @@ class GodotServer {
     };
   }
   editorWritesAShortList(projectPath) {
-    const key = resolve5(projectPath);
-    return this.shortListEditors.has(key) && this.shortListEditors.get(key) === this.godotBridge.getStatus().editorPid;
+    const recorded = readClassNote(projectPath)?.shortListEditorPid;
+    return recorded !== undefined && recorded === (this.godotBridge.getStatus().editorPid ?? null);
+  }
+  noteAShortListEditor(projectPath) {
+    const note = readClassNote(projectPath);
+    writeClassNote(projectPath, {
+      rebuiltWith: note?.rebuiltWith ?? [],
+      shortListEditorPid: this.godotBridge.getStatus().editorPid ?? null
+    });
   }
   sourceOfClass(projectPath, resourcePath) {
     const contained = resolveWithinProject(projectPath, resourcePath);
@@ -31906,7 +31942,7 @@ class GodotServer {
       return null;
     }
     try {
-      return readFileSync14(contained.absolutePath, "utf8");
+      return readFileSync15(contained.absolutePath, "utf8");
     } catch {
       return null;
     }
@@ -32135,7 +32171,7 @@ class GodotServer {
       return null;
     }
     try {
-      return settingKeys(readFileSync14(join14(projectPath, "project.godot"), "utf8"));
+      return settingKeys(readFileSync15(join15(projectPath, "project.godot"), "utf8"));
     } catch {
       return null;
     }
@@ -32377,7 +32413,7 @@ class GodotServer {
   }
   async runtimeUp(projectPath, before, budget, withArgs) {
     const budgetMs = budget.ms;
-    if (!existsSync9(join14(projectPath, RUNTIME_AUTOLOAD.path))) {
+    if (!existsSync9(join15(projectPath, RUNTIME_AUTOLOAD.path))) {
       return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false, withArgs });
     }
     let asking = null;
@@ -33250,7 +33286,7 @@ class GodotServer {
     const after = projectPath === "" || busy ? null : cachedClasses(projectPath);
     const lost = before === null || after === null ? [] : [...before.keys()].filter((name) => !after.has(name));
     if (lost.length > 0) {
-      this.shortListEditors.set(resolve5(projectPath), this.godotBridge.getStatus().editorPid);
+      this.noteAShortListEditor(projectPath);
     }
     const atMissingPaths = after === null ? [] : cachedAtMissingPaths(after, projectPath);
     const restored = lost.length > 0 || atMissingPaths.length > 0 ? await this.rebuildCacheAfterLoss(projectPath, lost) : [];
@@ -33316,9 +33352,8 @@ class GodotServer {
     return now === null ? [] : lost.filter((name) => now.has(name));
   }
   async rebuildClassCache(projectPath) {
-    const key = resolve5(projectPath);
     const before = cachedClasses(projectPath);
-    const remembered = this.cacheLastRebuilt.get(key);
+    const noted = readClassNote(projectPath);
     const rebuilt = await this.operation("refresh_class_cache", {}, projectPath);
     if (!rebuilt.ok) {
       return rebuilt;
@@ -33327,12 +33362,15 @@ class GodotServer {
     if (after === null) {
       return rebuilt;
     }
-    this.cacheLastRebuilt.set(key, new Set(after.keys()));
-    const lost = remembered === undefined || before === null ? [] : [...remembered].filter((name) => !before.has(name) && after.has(name)).sort();
-    if (lost.length === 0 || !this.godotBridge.isConnected()) {
+    const lost = noted === null || before === null ? [] : noted.rebuiltWith.filter((name) => !before.has(name) && after.has(name)).sort();
+    const seenLosing = lost.length > 0 && this.godotBridge.isConnected();
+    writeClassNote(projectPath, {
+      rebuiltWith: [...after.keys()].sort(),
+      ...seenLosing ? { shortListEditorPid: this.godotBridge.getStatus().editorPid ?? null } : noted?.shortListEditorPid === undefined ? {} : { shortListEditorPid: noted.shortListEditorPid }
+    });
+    if (!seenLosing) {
       return rebuilt;
     }
-    this.shortListEditors.set(key, this.godotBridge.getStatus().editorPid);
     const them = lost.length === 1 ? "it" : "them";
     return {
       ...rebuilt,
@@ -33489,8 +33527,8 @@ class GodotServer {
       ]);
     }
     const expectsScreenshot = command === "capture_screenshot" || command === "capture_viewport";
-    const screenshotDir = expectsScreenshot ? mkdtempSync2(join14(tmpdir4(), "gdharness-runtime-screenshot-")) : null;
-    const screenshotPath = screenshotDir ? join14(screenshotDir, "capture.png") : null;
+    const screenshotDir = expectsScreenshot ? mkdtempSync2(join15(tmpdir4(), "gdharness-runtime-screenshot-")) : null;
+    const screenshotPath = screenshotDir ? join15(screenshotDir, "capture.png") : null;
     try {
       const reply = await runtimeRequest(choice.endpoint, command, screenshotPath ? { ...params, output_path: screenshotPath } : params, timeoutMs);
       if (!reply.ok) {
@@ -33514,7 +33552,7 @@ class GodotServer {
             type: "text",
             text: `Screenshot captured: ${dimensions}${chosenAmongSeveral ? ` from pid ${own}, the game this server holds` : ""}`
           },
-          { type: "image", data: readFileSync14(screenshotPath).toString("base64"), mimeType: "image/png" }
+          { type: "image", data: readFileSync15(screenshotPath).toString("base64"), mimeType: "image/png" }
         ]
       };
     } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "1.0.7",
+  "version": "1.0.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",