gdharness 1.2.37 → 1.2.38

package/build/index.js

@@ -3365,18 +3365,18 @@ import {
   closeSync as closeSync3,
   constants,
   copyFileSync,
-  existsSync as existsSync20,
+  existsSync as existsSync21,
   fstatSync,
   mkdirSync as mkdirSync15,
   openSync as openSync4,
-  readdirSync as readdirSync11,
+  readdirSync as readdirSync12,
   readFileSync as readFileSync24,
   readSync as readSync2,
   rmdirSync as rmdirSync2,
-  statSync as statSync12,
+  statSync as statSync13,
   writeFileSync as writeFileSync16
 } from "node:fs";
-import { basename as basename7, dirname as dirname18, extname as extname4, isAbsolute as isAbsolute4, join as join26, normalize as normalize2, relative as relative5 } from "node:path";
+import { basename as basename8, dirname as dirname19, extname as extname4, isAbsolute as isAbsolute5, join as join27, normalize as normalize2, relative as relative5 } from "node:path";
 import { setTimeout as delay5 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 
@@ -28538,19 +28538,11 @@ function dictionary(entries) {
   return Object.assign(emptyRecord(), entries);
 }
 
-// src/editor-log.ts
-import {
-  closeSync as closeSync2,
-  existsSync as existsSync7,
-  mkdirSync as mkdirSync7,
-  openSync as openSync2,
-  readFileSync as readFileSync12,
-  readSync,
-  rmSync as rmSync6,
-  statSync as statSync5,
-  writeFileSync as writeFileSync8
-} from "node:fs";
-import { dirname as dirname7, join as join11 } from "node:path";
+// src/doc-cache.ts
+import { existsSync as existsSync7, readdirSync as readdirSync3, statSync as statSync5 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute3, join as join11 } from "node:path";
+import process7 from "node:process";
 
 // src/game-log.ts
 import { StringDecoder } from "node:string_decoder";
@@ -28758,6 +28750,9 @@ class GameLog {
   count(severity) {
     return this.entries.filter((entry) => entry.severity === severity).length;
   }
+  crashReport() {
+    return this.entries.find((entry) => CRASH.test(entry.text));
+  }
   everything() {
     return this.entries;
   }
@@ -28791,12 +28786,131 @@ function answersTo(entry, severity, contains) {
   return [entry.text, ...entry.detail].some((line) => line.toLowerCase().includes(needle));
 }
 
+// src/engine-run.ts
+function runEngine(executable, args, options = {}) {
+  return new Promise((resolve) => {
+    const log = new GameLog;
+    let failure = null;
+    const signal = callSignal();
+    const child = spawnHidden(executable, args, {
+      stdio: ["ignore", "pipe", "pipe"],
+      ...signal === undefined ? {} : { signal }
+    });
+    child.stdout.on("data", (chunk) => {
+      log.append("stdout", chunk);
+    });
+    child.stderr.on("data", (chunk) => {
+      log.append("stderr", chunk);
+    });
+    const { timeout } = options;
+    const timer = timeout === undefined ? undefined : setTimeout(() => {
+      failure ??= `it ran past its ${timeout.said}`;
+      child.kill();
+    }, timeout.ms);
+    child.on("error", (error) => {
+      failure ??= error.name === "AbortError" ? "the call was cancelled" : `it could not be started: ${error.message}`;
+    });
+    child.on("close", (code, closedBy) => {
+      clearTimeout(timer);
+      log.finish();
+      const started = child.pid !== undefined;
+      resolve({ log, exitCode: started ? code : null, exitSignal: closedBy, failure });
+    });
+  });
+}
+var WINDOWS_STATUSES = new Map([
+  [3221225477, "an access violation, so it crashed"],
+  [3221225501, "an illegal instruction, so it crashed"],
+  [3221225620, "an integer division by zero, so it crashed"],
+  [3221225725, "a stack overflow, so it crashed"],
+  [3221225781, "a library it needs was not found, so it never started"],
+  [3221225786, "its console was closed or sent Ctrl+C"],
+  [3221226356, "a corrupted heap, so it crashed"],
+  [3221226505, "a stack buffer overrun or a fast fail, so it crashed"]
+]);
+function exitCodeText(code) {
+  if (code === null) {
+    return "exit code unknown";
+  }
+  if (code < 3221225472) {
+    return `exit code ${code}`;
+  }
+  const hex = `0x${code.toString(16).toUpperCase()}`;
+  return `exit code ${hex}, ${WINDOWS_STATUSES.get(code) ?? "a Windows error status"}`;
+}
+function howItEnded(run) {
+  if (run.failure !== null) {
+    return run.exitSignal === null ? run.failure : `ended by ${run.exitSignal}, because ${run.failure}`;
+  }
+  return run.exitSignal === null ? exitCodeText(run.exitCode) : `ended by ${run.exitSignal}`;
+}
+
+// src/doc-cache.ts
+var CACHE_FILE = /^editor_doc_cache-\d+\.\d+\.res$/;
+function editorCacheDirectory(godotPath, platform = process7.platform, env = process7.env, home = homedir2()) {
+  const beside = dirname7(godotPath);
+  const bundle = platform === "darwin" && basename2(beside) === "MacOS" && basename2(dirname7(beside)) === "Contents" ? dirname7(dirname7(dirname7(beside))) : null;
+  for (const folder of bundle === null ? [beside] : [beside, bundle]) {
+    if (existsSync7(join11(folder, "._sc_")) || existsSync7(join11(folder, "_sc_"))) {
+      return join11(folder, "editor_data", "cache");
+    }
+  }
+  if (platform === "win32") {
+    const set = (name) => env[name] === "" ? undefined : env[name];
+    return join11(set("LOCALAPPDATA") ?? set("TEMP") ?? join11(home, "AppData", "Local"), "Godot");
+  }
+  if (platform === "darwin") {
+    return join11(home, "Library", "Caches", "Godot");
+  }
+  const xdg = env["XDG_CACHE_HOME"];
+  return join11(xdg !== undefined && isAbsolute3(xdg) ? xdg : join11(home, ".cache"), "godot");
+}
+function docCachesWritten(directory) {
+  const written = new Map;
+  let names;
+  try {
+    names = readdirSync3(directory);
+  } catch {
+    return written;
+  }
+  for (const name of names.filter((one) => CACHE_FILE.test(one))) {
+    try {
+      written.set(join11(directory, name), statSync5(join11(directory, name)).mtimeMs);
+    } catch {}
+  }
+  return written;
+}
+function docCacheCrash(ran, before, after, what) {
+  const report = ran.log.crashReport();
+  if (ran.exitCode === 0 && ran.exitSignal === null && report === undefined || ran.failure !== null) {
+    return null;
+  }
+  const rewritten = [...after].find(([path, at]) => before.get(path) !== at)?.[0];
+  if (rewritten === undefined) {
+    return null;
+  }
+  const said = report === undefined ? "" : `, and its crash handler printed "${report.text}"`;
+  return `The first ${what} ended badly (${howItEnded(ran)}${said}) after rebuilding the editor's class reference ` + `cache, ${rewritten}. Godot crashes as an import or an export exits when it finds that cache ` + "stale, which it is whenever another build of the same minor version wrote it last, such as 4.7.1 " + `beside 4.7.2, and the crashing run writes a fresh one. So the ${what} was run again, and this answer ` + "is from that second run.";
+}
+
 // src/editor-log.ts
+import {
+  closeSync as closeSync2,
+  existsSync as existsSync8,
+  mkdirSync as mkdirSync7,
+  openSync as openSync2,
+  readFileSync as readFileSync12,
+  readSync,
+  rmSync as rmSync6,
+  statSync as statSync6,
+  writeFileSync as writeFileSync8
+} from "node:fs";
+import { dirname as dirname8, join as join12 } from "node:path";
 function editorLogPath(projectPath) {
-  return join11(projectPath, ".godot", "gdharness-editor.log");
+  return join12(projectPath, ".godot", "gdharness-editor.log");
 }
 function editorLogNotePath(projectPath) {
-  return join11(projectPath, ".godot", "gdharness-editor.json");
+  return join12(projectPath, ".godot", "gdharness-editor.json");
 }
 function readEditorLogNote(projectPath) {
   try {
@@ -28811,7 +28925,7 @@ function readEditorLogNote(projectPath) {
 function clearEditorLog(projectPath) {
   try {
     const path = editorLogPath(projectPath);
-    mkdirSync7(dirname7(path), { recursive: true });
+    mkdirSync7(dirname8(path), { recursive: true });
     rmSync6(path, { force: true });
     rmSync6(editorLogNotePath(projectPath), { force: true });
   } catch {}
@@ -28819,7 +28933,7 @@ function clearEditorLog(projectPath) {
 function writeEditorLogNote(projectPath, pid) {
   try {
     const path = editorLogNotePath(projectPath);
-    mkdirSync7(dirname7(path), { recursive: true });
+    mkdirSync7(dirname8(path), { recursive: true });
     writeFileSync8(path, JSON.stringify({ pid, startedAt: new Date().toISOString() }, null, 2), "utf8");
   } catch {}
 }
@@ -28841,7 +28955,7 @@ function editorConsole(projectPath, editorPid, openedByAServer) {
     return { kind: "older server", notedPid: noted?.pid ?? null };
   }
   const path = editorLogPath(projectPath);
-  if (!existsSync7(path)) {
+  if (!existsSync8(path)) {
     return { kind: "not written" };
   }
   const log = new GameLog;
@@ -28900,7 +29014,7 @@ function foldProgress(text) {
 }
 var MOST_CONSOLE_BYTES = 8 * 1024 * 1024;
 function theFirstOf(path) {
-  const whole = statSync5(path).size;
+  const whole = statSync6(path).size;
   if (whole <= MOST_CONSOLE_BYTES) {
     return { text: readFileSync12(path, "utf8") };
   }
@@ -29057,60 +29171,21 @@ function linesBefore(entries, at, collapsed, wanted) {
   return found.reverse();
 }
 
-// src/engine-run.ts
-function runEngine(executable, args, options = {}) {
-  return new Promise((resolve) => {
-    const log = new GameLog;
-    let failure = null;
-    const signal = callSignal();
-    const child = spawnHidden(executable, args, {
-      stdio: ["ignore", "pipe", "pipe"],
-      ...signal === undefined ? {} : { signal }
-    });
-    child.stdout.on("data", (chunk) => {
-      log.append("stdout", chunk);
-    });
-    child.stderr.on("data", (chunk) => {
-      log.append("stderr", chunk);
-    });
-    const { timeout } = options;
-    const timer = timeout === undefined ? undefined : setTimeout(() => {
-      failure ??= `it ran past its ${timeout.said}`;
-      child.kill();
-    }, timeout.ms);
-    child.on("error", (error) => {
-      failure ??= error.name === "AbortError" ? "the call was cancelled" : `it could not be started: ${error.message}`;
-    });
-    child.on("close", (code, closedBy) => {
-      clearTimeout(timer);
-      log.finish();
-      const started = child.pid !== undefined;
-      resolve({ log, exitCode: started ? code : null, exitSignal: closedBy, failure });
-    });
-  });
-}
-function howItEnded(run) {
-  if (run.failure !== null) {
-    return run.exitSignal === null ? run.failure : `ended by ${run.exitSignal}, because ${run.failure}`;
-  }
-  return run.exitSignal === null ? `exit code ${run.exitCode ?? "unknown"}` : `ended by ${run.exitSignal}`;
-}
-
 // src/file-move.ts
 import {
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   mkdirSync as mkdirSync10,
-  readdirSync as readdirSync5,
+  readdirSync as readdirSync6,
   readFileSync as readFileSync16,
   renameSync as renameSync3,
-  statSync as statSync6,
+  statSync as statSync7,
   writeFileSync as writeFileSync11
 } from "node:fs";
-import { basename as basename3, dirname as dirname11, extname as extname3, join as join15, relative as relative4 } from "node:path";
+import { basename as basename4, dirname as dirname12, extname as extname3, join as join16, relative as relative4 } from "node:path";
 
 // src/project-scan.ts
-import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync13 } from "node:fs";
-import { extname, join as join12 } from "node:path";
+import { existsSync as existsSync9, readdirSync as readdirSync4, readFileSync as readFileSync13 } from "node:fs";
+import { extname, join as join13 } from "node:path";
 var SKIPPED = new Set(["node_modules"]);
 function skipped(name) {
   return name.startsWith(".") || SKIPPED.has(name);
@@ -29120,10 +29195,10 @@ function steppedOver(directory) {
   return gdignored(directory) || installedByUs(directory);
 }
 function gdignored(directory) {
-  return existsSync8(join12(directory, ".gdignore"));
+  return existsSync9(join13(directory, ".gdignore"));
 }
 function installedByUs(directory) {
-  return existsSync8(join12(directory, VERSION_MARKER));
+  return existsSync9(join13(directory, VERSION_MARKER));
 }
 var SCENE_EXTENSIONS = new Set(["tscn", "scn"]);
 var ASSET_EXTENSIONS = new Set([
@@ -29162,12 +29237,12 @@ function projectStructure(projectPath) {
     if (steppedOver(directory)) {
       return;
     }
-    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (skipped(entry.name)) {
         continue;
       }
       if (entry.isDirectory()) {
-        visit(join12(directory, entry.name));
+        visit(join13(directory, entry.name));
       } else if (entry.isFile()) {
         const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
         if (SCENE_EXTENSIONS.has(extension)) {
@@ -29191,13 +29266,13 @@ function projectFiles(projectPath, extensions) {
     if (steppedOver(directory)) {
       return;
     }
-    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (skipped(entry.name)) {
         continue;
       }
       const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
       if (entry.isDirectory()) {
-        visit(join12(directory, entry.name), spelled);
+        visit(join13(directory, entry.name), spelled);
       } else if (entry.isFile() && extensions.includes(extname(entry.name).toLowerCase())) {
         found.push(spelled);
       }
@@ -29213,20 +29288,20 @@ function scriptsWithoutUid(projectPath) {
     if (steppedOver(directory)) {
       return;
     }
-    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (skipped(entry.name)) {
         continue;
       }
       const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
       if (entry.isDirectory()) {
-        visit(join12(directory, entry.name), spelled);
+        visit(join13(directory, entry.name), spelled);
         continue;
       }
       if (!entry.isFile()) {
         continue;
       }
       const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
-      if (CARRIES_A_UID.has(extension) && !existsSync8(join12(directory, `${entry.name}.uid`))) {
+      if (CARRIES_A_UID.has(extension) && !existsSync9(join13(directory, `${entry.name}.uid`))) {
         found.push(spelled);
       }
     }
@@ -29254,11 +29329,11 @@ function projectTexts(projectPath) {
     if (steppedOver(directory)) {
       return;
     }
-    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (skipped(entry.name)) {
         continue;
       }
-      const absolute = join12(directory, entry.name);
+      const absolute = join13(directory, entry.name);
       const spelled = `${prefix}${entry.name}`;
       if (entry.isDirectory()) {
         visit(absolute, `${spelled}/`);
@@ -29284,11 +29359,11 @@ function ignoredTexts(projectPath) {
       return;
     }
     const under = ignored || gdignored(directory);
-    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (skipped(entry.name)) {
         continue;
       }
-      const absolute = join12(directory, entry.name);
+      const absolute = join13(directory, entry.name);
       const spelled = `${prefix}${entry.name}`;
       if (entry.isDirectory()) {
         visit(absolute, `${spelled}/`, under);
@@ -29321,14 +29396,14 @@ function searchProject(projectPath, options) {
     if (steppedOver(directory)) {
       return;
     }
-    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (full()) {
         return;
       }
       if (skipped(entry.name)) {
         continue;
       }
-      const entryPath = join12(directory, entry.name);
+      const entryPath = join13(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -29367,8 +29442,8 @@ function searchProject(projectPath, options) {
 }
 
 // src/rename.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync8, readFileSync as readFileSync14, renameSync as renameSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname8, posix as posix2 } from "node:path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync8, readFileSync as readFileSync14, renameSync as renameSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync9 } from "node:fs";
+import { dirname as dirname9, posix as posix2 } from "node:path";
 class Script {
   path;
   text;
@@ -30097,21 +30172,21 @@ function applyRewrites(rewrites) {
     if (now !== rewrite.before) {
       throw new Error(`${rewrite.path} changed on disk while the rename was being worked out; nothing was written`);
     }
-    if (rewrite.writeTo !== rewrite.absolute && existsSync9(rewrite.writeTo)) {
+    if (rewrite.writeTo !== rewrite.absolute && existsSync10(rewrite.writeTo)) {
       throw new Error(`${rewrite.writeTo} already exists; nothing was written`);
     }
   }
   const done = [];
   try {
     for (const rewrite of rewrites) {
-      mkdirSync8(dirname8(rewrite.writeTo), { recursive: true });
+      mkdirSync8(dirname9(rewrite.writeTo), { recursive: true });
       const staging = `${rewrite.writeTo}.gdharness-rename`;
       writeFileSync9(staging, rewrite.after, "utf8");
       renameSync2(staging, rewrite.writeTo);
       let movedUid = false;
       if (rewrite.writeTo !== rewrite.absolute) {
         unlinkSync2(rewrite.absolute);
-        if (existsSync9(`${rewrite.absolute}.uid`)) {
+        if (existsSync10(`${rewrite.absolute}.uid`)) {
           renameSync2(`${rewrite.absolute}.uid`, `${rewrite.writeTo}.uid`);
           movedUid = true;
         }
@@ -30135,14 +30210,14 @@ function applyRewrites(rewrites) {
 }
 
 // src/rename-symbol.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync9, readdirSync as readdirSync4, realpathSync as realpathSync4, rmSync as rmSync7, writeFileSync as writeFileSync10 } from "node:fs";
-import { basename as basename2, dirname as dirname10, join as join14, relative as relative3, resolve as resolve5 } from "node:path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync9, readdirSync as readdirSync5, realpathSync as realpathSync4, rmSync as rmSync7, writeFileSync as writeFileSync10 } from "node:fs";
+import { basename as basename3, dirname as dirname11, join as join15, relative as relative3, resolve as resolve5 } from "node:path";
 
 // src/lsp_client.ts
-import { existsSync as existsSync10, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync11, realpathSync as realpathSync2 } from "node:fs";
 import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection3 } from "node:net";
-import { dirname as dirname9, join as join13, resolve as resolve3 } from "node:path";
+import { dirname as dirname10, join as join14, resolve as resolve3 } from "node:path";
 import { setTimeout as delay4 } from "node:timers/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
 var DEFAULT_LSP_PORT = 6005;
@@ -30340,7 +30415,7 @@ class GodotLSPClient {
     if (this.initialized) {
       return;
     }
-    const rootPath = this.rootPath ?? dirname9(resolve3(filePath));
+    const rootPath = this.rootPath ?? dirname10(resolve3(filePath));
     await this.initialize(rootPath);
   }
   async sendRequest(method, params, timeoutMs = this.timeouts.requestMs) {
@@ -30913,7 +30988,7 @@ async function resolveLSPPaths(projectPathValue, scriptPathValue) {
   } catch {
     throw new ArgumentRefusal(`Project path does not exist: ${requestedProjectPath}`);
   }
-  if (!existsSync10(join13(projectPath, "project.godot"))) {
+  if (!existsSync11(join14(projectPath, "project.godot"))) {
     throw new ArgumentRefusal(`Not a Godot project: ${projectPath}. Point projectPath at the directory holding project.godot.`);
   }
   const contained = resolveWithinProject(projectPath, scriptPathValue);
@@ -31288,13 +31363,13 @@ function onDiskSpelling(path) {
   let at = resolve5(path);
   for (;; ) {
     try {
-      return join14(realpathSync4.native(at), ...missing.reverse());
+      return join15(realpathSync4.native(at), ...missing.reverse());
     } catch {
-      const parent = dirname10(at);
+      const parent = dirname11(at);
       if (parent === at) {
         return resolve5(path);
       }
-      missing.push(basename2(at));
+      missing.push(basename3(at));
       at = parent;
     }
   }
@@ -31341,7 +31416,7 @@ async function renameSymbol(request, services) {
         reason: `newScriptPath must be a .gd path inside the project, and ${request.newScriptPath} is not.`
       };
     }
-    if (existsSync11(request.newScriptPath)) {
+    if (existsSync12(request.newScriptPath)) {
       return { ok: false, reason: `${moveTo} already exists, so the script cannot be moved there.` };
     }
   }
@@ -31517,7 +31592,7 @@ async function renameSymbol(request, services) {
       scripts,
       moves: new Map([[declaringPath, moveTo]]),
       named: [declaringPath],
-      exists: (path) => existsSync11(`${projectPath}/${path.slice("res://".length)}`)
+      exists: (path) => existsSync12(`${projectPath}/${path.slice("res://".length)}`)
     }, plan);
   }
   plan = mentionIgnored(plan, ignoredTexts(projectPath), symbol, moveTo === null ? [] : [declaringPath]);
@@ -31718,15 +31793,15 @@ ${mention.kind}`;
 var LEFT_ALONE_ANSWER_LINES = 300;
 var detailWrites = 0;
 function writeLeftAloneDetail(projectPath, symbol, detail) {
-  const directory = join14(projectPath, ".godot", "gdharness-renames");
+  const directory = join15(projectPath, ".godot", "gdharness-renames");
   mkdirSync9(directory, { recursive: true });
   detailWrites += 1;
-  const path = join14(directory, `${String(Date.now())}-${String(detailWrites).padStart(6, "0")}-${String(process.pid)}-${symbol}.json`);
+  const path = join15(directory, `${String(Date.now())}-${String(detailWrites).padStart(6, "0")}-${String(process.pid)}-${symbol}.json`);
   writeFileSync10(path, `${JSON.stringify(detail, null, 2)}
 `, "utf8");
-  const kept = readdirSync4(directory).filter((name) => name.endsWith(".json")).sort().reverse();
+  const kept = readdirSync5(directory).filter((name) => name.endsWith(".json")).sort().reverse();
   for (const old of kept.slice(10)) {
-    rmSync7(join14(directory, old), { force: true });
+    rmSync7(join15(directory, old), { force: true });
   }
   return path;
 }
@@ -31751,15 +31826,15 @@ function summaryOf(edits, mentions, rewrites, left) {
 // src/file-move.ts
 var SIDECARS = [".uid", ".import"];
 function filesUnder(directory) {
-  return readdirSync5(directory, { withFileTypes: true }).flatMap((entry) => {
-    const path = join15(directory, entry.name);
+  return readdirSync6(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path = join16(directory, entry.name);
     return entry.isDirectory() ? filesUnder(path) : [path];
   });
 }
 function sameFile(one, other) {
   try {
-    const a = statSync6(one);
-    const b = statSync6(other);
+    const a = statSync7(one);
+    const b = statSync7(other);
     return a.ino === b.ino && a.dev === b.dev;
   } catch {
     return false;
@@ -31773,8 +31848,8 @@ function unseenByTheEngine(projectPath, path) {
       return `${path} is under ${step}, and the engine passes over every directory whose name starts with a dot`;
     }
     if (at < steps.length - 1) {
-      directory = join15(directory, step);
-      if (existsSync12(join15(directory, ".gdignore"))) {
+      directory = join16(directory, step);
+      if (existsSync13(join16(directory, ".gdignore"))) {
         return `${path} is under a directory holding a .gdignore, which the engine does not load`;
       }
     }
@@ -31786,21 +31861,21 @@ function installedAddonOf(projectPath, path) {
   if (steps[0] !== "addons" || steps[1] === undefined) {
     return null;
   }
-  return existsSync12(join15(projectPath, "addons", steps[1], VERSION_MARKER)) ? `res://addons/${steps[1]}` : null;
+  return existsSync13(join16(projectPath, "addons", steps[1], VERSION_MARKER)) ? `res://addons/${steps[1]}` : null;
 }
 function binaryResources(projectPath) {
   const found = [];
   const visit = (directory, prefix) => {
-    if (existsSync12(join15(directory, ".gdignore"))) {
+    if (existsSync13(join16(directory, ".gdignore"))) {
       return;
     }
-    for (const entry of readdirSync5(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync6(directory, { withFileTypes: true })) {
       if (entry.name.startsWith(".")) {
         continue;
       }
       const path = `${prefix}${entry.name}`;
       if (entry.isDirectory()) {
-        visit(join15(directory, entry.name), `${path}/`);
+        visit(join16(directory, entry.name), `${path}/`);
       } else if (/\.(scn|res)$/i.test(entry.name)) {
         found.push(path);
       }
@@ -31810,7 +31885,7 @@ function binaryResources(projectPath) {
   return found;
 }
 function targetPathOf(projectPath, absolute) {
-  const inside = relative4(onDiskSpelling(projectPath), join15(onDiskSpelling(dirname11(absolute)), basename3(absolute)));
+  const inside = relative4(onDiskSpelling(projectPath), join16(onDiskSpelling(dirname12(absolute)), basename4(absolute)));
   if (inside === "" || inside.startsWith("..") || /^[A-Za-z]:/.test(inside)) {
     return null;
   }
@@ -31828,13 +31903,13 @@ function planFileMove(projectPath, absoluteFrom, absoluteTo) {
   if (to === null) {
     return { ok: false, reason: `newPath must be a path inside the project, and ${absoluteTo} is not.` };
   }
-  if (!existsSync12(absoluteFrom)) {
+  if (!existsSync13(absoluteFrom)) {
     return { ok: false, reason: `There is nothing at ${from} to move.` };
   }
   if (from === to) {
     return { ok: false, reason: `${from} is already there; nothing to move.` };
   }
-  const isDirectory = statSync6(absoluteFrom).isDirectory();
+  const isDirectory = statSync7(absoluteFrom).isDirectory();
   if (from === "res://project.godot") {
     return {
       ok: false,
@@ -31857,7 +31932,7 @@ function planFileMove(projectPath, absoluteFrom, absoluteTo) {
   if (isDirectory && to.startsWith(`${from}/`)) {
     return { ok: false, reason: `${from} cannot be moved into itself.` };
   }
-  if (existsSync12(absoluteTo) && !sameFile(absoluteFrom, absoluteTo)) {
+  if (existsSync13(absoluteTo) && !sameFile(absoluteFrom, absoluteTo)) {
     return { ok: false, reason: `${to} already exists, so nothing was moved there.` };
   }
   const unseen = unseenByTheEngine(projectPath, to);
@@ -31865,7 +31940,7 @@ function planFileMove(projectPath, absoluteFrom, absoluteTo) {
     return { ok: false, reason: `${unseen}, so nothing there could load what was moved.` };
   }
   if (!isDirectory) {
-    const owner = SIDECARS.map((sidecar) => from.endsWith(sidecar) ? from.slice(0, -sidecar.length) : null).find((path) => path !== null && existsSync12(join15(projectPath, path.slice("res://".length))));
+    const owner = SIDECARS.map((sidecar) => from.endsWith(sidecar) ? from.slice(0, -sidecar.length) : null).find((path) => path !== null && existsSync13(join16(projectPath, path.slice("res://".length))));
     if (owner !== undefined && owner !== null) {
       return { ok: false, reason: `${from} belongs to ${owner} and moves with it: move ${owner} instead.` };
     }
@@ -31887,7 +31962,7 @@ function planFileMove(projectPath, absoluteFrom, absoluteTo) {
   } else {
     moves.set(from, to);
     for (const sidecar of SIDECARS) {
-      if (existsSync12(`${absoluteFrom}${sidecar}`)) {
+      if (existsSync13(`${absoluteFrom}${sidecar}`)) {
         moves.set(`${from}${sidecar}`, `${to}${sidecar}`);
       }
     }
@@ -31899,12 +31974,12 @@ function planFileMove(projectPath, absoluteFrom, absoluteTo) {
     scripts,
     moves,
     named: [from],
-    exists: (path) => existsSync12(join15(projectPath, path.slice("res://".length)))
+    exists: (path) => existsSync13(join16(projectPath, path.slice("res://".length)))
   }, { edits: [], mentions: [] });
   plan = mentionIgnored(plan, ignoredTexts(projectPath), null, [from]);
   const binaries = [];
   for (const path of binaryResources(projectPath)) {
-    const bytes = readFileSync16(join15(projectPath, path.slice("res://".length)));
+    const bytes = readFileSync16(join16(projectPath, path.slice("res://".length)));
     const names = [...moves.keys()].find((moving) => bytes.includes(moving));
     if (names !== undefined) {
       binaries.push({
@@ -31923,7 +31998,7 @@ function planFileMove(projectPath, absoluteFrom, absoluteTo) {
   }));
   const left = leftAloneReport(mentions);
   const rewrites = rewritesOf(plan, texts, null);
-  const absoluteOf = (path) => join15(projectPath, path.slice("res://".length));
+  const absoluteOf = (path) => join16(projectPath, path.slice("res://".length));
   const rewritten = new Map(rewrites.map((rewrite) => [rewrite.path, rewrite]));
   const moved = [...moves].map(([source, target]) => {
     const rewrite = rewritten.get(source);
@@ -31970,19 +32045,19 @@ function applyFileMove(outcome) {
     }
   }
   for (const file of outcome.moved) {
-    if (!existsSync12(file.absoluteFrom)) {
+    if (!existsSync13(file.absoluteFrom)) {
       throw new Error(`${file.from} is gone from disk; nothing was written`);
     }
     if (file.text !== null && readFileSync16(file.absoluteFrom, "utf8") !== file.text.before) {
       throw new Error(`${file.from} changed on disk while the move was being worked out; nothing was written`);
     }
-    if (existsSync12(file.absoluteTo) && !sameFile(file.absoluteFrom, file.absoluteTo)) {
+    if (existsSync13(file.absoluteTo) && !sameFile(file.absoluteFrom, file.absoluteTo)) {
       throw new Error(`${file.to} already exists; nothing was written`);
     }
   }
   const undo = [];
   const rename = (source, target) => {
-    mkdirSync10(dirname11(target), { recursive: true });
+    mkdirSync10(dirname12(target), { recursive: true });
     renameSync3(source, target);
     undo.push(() => {
       renameSync3(target, source);
@@ -32705,27 +32780,27 @@ function getDefaultBridge(ownProject = null) {
 }
 
 // src/godot-path.ts
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 import { normalize } from "node:path";
 
 // src/detection.ts
-import { existsSync as existsSync13, readdirSync as readdirSync6, statSync as statSync7 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync14, readdirSync as readdirSync7, statSync as statSync8 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join17 } from "node:path";
 function resolveHomeDirectory() {
   try {
-    return homedir2();
+    return homedir3();
   } catch {
     return "";
   }
 }
 function scanDirectoryForGodotBinaries(directory, platform) {
-  if (!directory || !existsSync13(directory)) {
+  if (!directory || !existsSync14(directory)) {
     return [];
   }
   let entries;
   try {
-    entries = readdirSync6(directory);
+    entries = readdirSync7(directory);
   } catch {
     return [];
   }
@@ -32735,16 +32810,16 @@ function scanDirectoryForGodotBinaries(directory, platform) {
     if (!pattern.test(name)) {
       continue;
     }
-    const fullPath = join16(directory, name);
+    const fullPath = join17(directory, name);
     try {
-      const stat = statSync7(fullPath);
+      const stat = statSync8(fullPath);
       if (stat.isFile()) {
         matches.push({ name, mtime: stat.mtimeMs });
       }
     } catch {}
   }
   matches.sort((a, b) => b.mtime - a.mtime);
-  return matches.map((m) => join16(directory, m.name));
+  return matches.map((m) => join17(directory, m.name));
 }
 function conventionalPaths(platform, home) {
   const paths = ["godot"];
@@ -32845,7 +32920,7 @@ class GodotLocator {
       return known;
     }
     let reason;
-    if (path !== "godot" && !existsSync14(path)) {
+    if (path !== "godot" && !existsSync15(path)) {
       reason = "does not exist";
     } else {
       try {
@@ -32861,12 +32936,12 @@ class GodotLocator {
 }
 
 // src/headless.ts
-import { existsSync as existsSync18, readFileSync as readFileSync19, realpathSync as realpathSync5, writeFileSync as writeFileSync13 } from "node:fs";
-import { dirname as dirname13, join as join20 } from "node:path";
+import { existsSync as existsSync19, readFileSync as readFileSync19, realpathSync as realpathSync5, writeFileSync as writeFileSync13 } from "node:fs";
+import { dirname as dirname14, join as join21 } from "node:path";
 
 // src/library-copies.ts
-import { existsSync as existsSync15, readdirSync as readdirSync7, readFileSync as readFileSync17, renameSync as renameSync4, unlinkSync as unlinkSync3 } from "node:fs";
-import { basename as basename4, dirname as dirname12, isAbsolute as isAbsolute3, join as join17 } from "node:path";
+import { existsSync as existsSync16, readdirSync as readdirSync8, readFileSync as readFileSync17, renameSync as renameSync4, unlinkSync as unlinkSync3 } from "node:fs";
+import { basename as basename5, dirname as dirname13, isAbsolute as isAbsolute4, join as join18 } from "node:path";
 function freeLibraryCopies(projectPath, platform = process.platform) {
   const setAside = [];
   const swept = [];
@@ -32874,26 +32949,26 @@ function freeLibraryCopies(projectPath, platform = process.platform) {
     return { setAside, swept };
   }
   for (const library of windowsLibraries(projectPath)) {
-    const folder = dirname12(library);
-    const copy = `~${basename4(library)}`;
-    if (existsSync15(join17(folder, copy))) {
-      const aside = join17(folder, `${copy}.aside-${process.pid}-${Date.now()}`);
+    const folder = dirname13(library);
+    const copy = `~${basename5(library)}`;
+    if (existsSync16(join18(folder, copy))) {
+      const aside = join18(folder, `${copy}.aside-${process.pid}-${Date.now()}`);
       try {
-        renameSync4(join17(folder, copy), aside);
+        renameSync4(join18(folder, copy), aside);
         setAside.push(aside);
       } catch {}
     }
     let names;
     try {
-      names = readdirSync7(folder);
+      names = readdirSync8(folder);
     } catch {
       continue;
     }
     for (const name of names) {
       if (name.length > copy.length && name.toLowerCase().startsWith(copy.toLowerCase())) {
         try {
-          unlinkSync3(join17(folder, name));
-          swept.push(join17(folder, name));
+          unlinkSync3(join18(folder, name));
+          swept.push(join18(folder, name));
         } catch {}
       }
     }
@@ -32901,7 +32976,7 @@ function freeLibraryCopies(projectPath, platform = process.platform) {
   return { setAside, swept };
 }
 function windowsLibraries(projectPath) {
-  const listed = readOrNull(join17(projectPath, ".godot", "extension_list.cfg"));
+  const listed = readOrNull(join18(projectPath, ".godot", "extension_list.cfg"));
   if (listed === null) {
     return [];
   }
@@ -32920,7 +32995,7 @@ function windowsLibraries(projectPath) {
         continue;
       }
       const named = inLibraries ? /^\s*windows[\w.]*\s*=\s*"([^"]+)"/.exec(row)?.[1] : undefined;
-      const library = named === undefined ? null : resolveResource(projectPath, dirname12(manifest), named);
+      const library = named === undefined ? null : resolveResource(projectPath, dirname13(manifest), named);
       if (library !== null) {
         libraries.add(library);
       }
@@ -32933,9 +33008,9 @@ function resolveResource(projectPath, relativeTo, path) {
     return null;
   }
   if (path.startsWith("res://")) {
-    return join17(projectPath, path.slice("res://".length));
+    return join18(projectPath, path.slice("res://".length));
   }
-  return isAbsolute3(path) ? path : join17(relativeTo, path);
+  return isAbsolute4(path) ? path : join18(relativeTo, path);
 }
 function readOrNull(path) {
   try {
@@ -32947,29 +33022,29 @@ function readOrNull(path) {
 
 // src/reimport.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync16, readFileSync as readFileSync18, rmSync as rmSync8, statSync as statSync8, utimesSync, writeFileSync as writeFileSync12 } from "node:fs";
-import { basename as basename5, join as join18 } from "node:path";
+import { existsSync as existsSync17, readFileSync as readFileSync18, rmSync as rmSync8, statSync as statSync9, utimesSync, writeFileSync as writeFileSync12 } from "node:fs";
+import { basename as basename6, join as join19 } from "node:path";
 function forceNextImport(projectPath, resourcePath) {
   const relative = resourcePath.replace(/^res:\/\//, "");
-  const sidecar = join18(projectPath, `${relative}.import`);
-  if (!existsSync16(sidecar)) {
+  const sidecar = join19(projectPath, `${relative}.import`);
+  if (!existsSync17(sidecar)) {
     return;
   }
-  const { atime, mtimeMs } = statSync8(sidecar);
+  const { atime, mtimeMs } = statSync9(sidecar);
   writeFileSync12(sidecar, readFileSync18(sidecar, "utf8").replace(/^valid=false\r?\n/m, ""));
   utimesSync(sidecar, atime, new Date(mtimeMs + 2000));
   rmSync8(importRecord(projectPath, resourcePath), { force: true });
 }
 function importRecord(projectPath, resourcePath) {
   const digest = createHash3("md5").update(resourcePath).digest("hex");
-  return join18(projectPath, ".godot", "imported", `${basename5(resourcePath)}-${digest}.md5`);
+  return join19(projectPath, ".godot", "imported", `${basename6(resourcePath)}-${digest}.md5`);
 }
 
 // src/scratch.ts
-import { existsSync as existsSync17, mkdtempSync as mkdtempSync2, readdirSync as readdirSync8, rmSync as rmSync9 } from "node:fs";
+import { existsSync as existsSync18, mkdtempSync as mkdtempSync2, readdirSync as readdirSync9, rmSync as rmSync9 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { join as join19 } from "node:path";
-import process7 from "node:process";
+import { join as join20 } from "node:path";
+import process8 from "node:process";
 var SWEPT = { recursive: true, force: true };
 var AGAIN_AFTER_MS = [250, 500, 1000, 2000, 4000, 8000, 16000];
 var waiting = new Set;
@@ -32984,12 +33059,12 @@ var KINDS = [
   "tests"
 ];
 function scratchDirectory(kind) {
-  return mkdtempSync2(join19(tmpdir5(), `gdharness-${kind}-${process7.pid}-`));
+  return mkdtempSync2(join20(tmpdir5(), `gdharness-${kind}-${process8.pid}-`));
 }
 function sweepAbandonedScratch(directory = tmpdir5()) {
   let entries;
   try {
-    entries = readdirSync8(directory);
+    entries = readdirSync9(directory);
   } catch {
     return;
   }
@@ -33000,7 +33075,7 @@ function sweepAbandonedScratch(directory = tmpdir5()) {
       continue;
     }
     try {
-      remove(join19(directory, entry));
+      remove(join20(directory, entry));
     } catch {}
   }
 }
@@ -33038,7 +33113,7 @@ function tryAgain(path, attempt) {
     lastTryOnExit();
   }
   const after = AGAIN_AFTER_MS[attempt];
-  if (after === undefined || !existsSync17(path)) {
+  if (after === undefined || !existsSync18(path)) {
     waiting.delete(path);
     if (after === undefined) {
       atExit.add(path);
@@ -33060,7 +33135,7 @@ function lastTryOnExit() {
     return;
   }
   lastTryWatched = true;
-  process7.once("exit", () => {
+  process8.once("exit", () => {
     for (const path of [...waiting, ...atExit]) {
       try {
         remove(path);
@@ -33138,7 +33213,7 @@ function refusalsIn(log) {
 }
 function scriptFault(problems, script) {
   const spelled = (path) => `(${path.replaceAll("\\", "/").toLowerCase()}/`;
-  const directories = [...new Set([spelled(dirname13(script)), spelled(resolvedOr(dirname13(script)))])];
+  const directories = [...new Set([spelled(dirname14(script)), spelled(resolvedOr(dirname14(script)))])];
   return problems.find((entry) => {
     const at = entry.detail.find((line) => line.startsWith("at: "))?.replaceAll("\\", "/").toLowerCase();
     return entry.severity === "error" && at !== undefined && directories.some((directory) => at.includes(directory));
@@ -33176,26 +33251,33 @@ async function runImport(godotPath, projectPath, options = {}) {
   };
   const first = await pass();
   const collided = librariesNotCopied(first.messages);
-  if (collided.length === 0) {
+  const crash = first.docCacheNote;
+  if (collided.length === 0 && crash === undefined) {
     return first;
   }
-  const second = await pass();
+  const { docCacheNote: _, ...again } = await pass();
+  const second = again.ok || crash === undefined ? again : { ...again, message: `${again.message.replace(/[.\s]+$/, "")}. ${crash}` };
   const still = librariesNotCopied(second.messages);
   return {
     ...second,
-    librariesRetried: collided,
-    ...still.length === 0 ? {} : { librariesNotLoaded: still },
-    extensionNote: extensionRetryNote(collided, still)
+    ...collided.length === 0 ? {} : {
+      librariesRetried: collided,
+      ...still.length === 0 ? {} : { librariesNotLoaded: still },
+      extensionNote: extensionRetryNote(collided, still)
+    },
+    ...crash === undefined ? {} : { docCacheNote: crash }
   };
 }
 async function importOnce(godotPath, projectPath) {
   const logDir = scratchDirectory("import");
+  const caches = editorCacheDirectory(godotPath);
+  const cachesBefore = docCachesWritten(caches);
   let ran;
   try {
     ran = await runEngine(godotPath, [
       "--headless",
       "--log-file",
-      join20(logDir, "engine.log"),
+      join21(logDir, "engine.log"),
       "--path",
       projectPath,
       "--import"
@@ -33204,24 +33286,26 @@ async function importOnce(godotPath, projectPath) {
     discard(logDir);
   }
   const problems = problemsIn(ran.log);
+  const crash = docCacheCrash(ran, cachesBefore, docCachesWritten(caches), "import");
   if (ran.exitCode === 0 && ran.failure === null) {
-    return { ok: true, ...reported2(problems) };
+    return { ok: true, ...reported2(problems), ...crash === null ? {} : { docCacheNote: crash } };
   }
   return {
     ok: false,
     message: `the import pass failed (${howItEnded(ran)}): ${reason(ran.log, problems)}`,
-    ...reported2(problems)
+    ...reported2(problems),
+    ...crash === null ? {} : { docCacheNote: crash }
   };
 }
 async function runOperation(engine, operation, params, projectPath) {
   const paramsDir = scratchDirectory("params");
-  const paramsFile = join20(paramsDir, `${operation}.json`);
-  const answerFile = join20(paramsDir, "answer.json");
+  const paramsFile = join21(paramsDir, `${operation}.json`);
+  const answerFile = join21(paramsDir, "answer.json");
   writeFileSync13(paramsFile, JSON.stringify(snakeCased(params)), "utf8");
   const args = [
     "--headless",
     "--log-file",
-    join20(paramsDir, "engine.log"),
+    join21(paramsDir, "engine.log"),
     "--path",
     projectPath,
     "--script",
@@ -33309,7 +33393,7 @@ async function runOperation(engine, operation, params, projectPath) {
   };
 }
 function answerIn(file) {
-  if (!existsSync18(file)) {
+  if (!existsSync19(file)) {
     return { kind: "none" };
   }
   const text = readFileSync19(file, "utf8");
@@ -33935,26 +34019,26 @@ function askTheKeeper(address, line, withinMs) {
 }
 
 // src/lifecycle-log.ts
-import { appendFileSync, mkdirSync as mkdirSync11, renameSync as renameSync5, statSync as statSync9 } from "node:fs";
-import { dirname as dirname14, join as join21 } from "node:path";
-import process8 from "node:process";
+import { appendFileSync, mkdirSync as mkdirSync11, renameSync as renameSync5, statSync as statSync10 } from "node:fs";
+import { dirname as dirname15, join as join22 } from "node:path";
+import process9 from "node:process";
 function lifecycleLogPath() {
-  return join21(runtimeDirectory(), "servers.log");
+  return join22(runtimeDirectory(), "servers.log");
 }
 var LIFECYCLE_LOG_LIMIT = 1e6;
 function writeLifecycle(event, fields = {}) {
   const path = lifecycleLogPath();
   try {
-    mkdirSync11(dirname14(path), { recursive: true });
-    if ((statSync9(path, { throwIfNoEntry: false })?.size ?? 0) > LIFECYCLE_LOG_LIMIT) {
+    mkdirSync11(dirname15(path), { recursive: true });
+    if ((statSync10(path, { throwIfNoEntry: false })?.size ?? 0) > LIFECYCLE_LOG_LIMIT) {
       try {
         renameSync5(path, `${path}.1`);
       } catch {}
     }
     const line = {
       at: new Date().toISOString(),
-      pid: process8.pid,
-      ppid: process8.ppid,
+      pid: process9.pid,
+      ppid: process9.ppid,
       version: SERVER_VERSION,
       event
     };
@@ -34243,14 +34327,14 @@ function setupPromptHandlers(server) {
 
 // src/restart-note.ts
 import { mkdirSync as mkdirSync12, readFileSync as readFileSync20, rmSync as rmSync10, writeFileSync as writeFileSync14 } from "node:fs";
-import { dirname as dirname15, join as join22 } from "node:path";
+import { dirname as dirname16, join as join23 } from "node:path";
 function restartNotePath(projectPath) {
-  return join22(projectPath, ".godot", "gdharness-restart.json");
+  return join23(projectPath, ".godot", "gdharness-restart.json");
 }
 function noteRestartBegun(note) {
   const path = restartNotePath(note.projectPath);
   try {
-    mkdirSync12(dirname15(path), { recursive: true });
+    mkdirSync12(dirname16(path), { recursive: true });
     writeFileSync14(path, `${JSON.stringify(note, null, 2)}
 `, "utf8");
   } catch (error) {
@@ -34282,23 +34366,23 @@ function restartSettled(projectPath) {
 
 // src/run-record.ts
 import { createHash as createHash4 } from "node:crypto";
-import { mkdirSync as mkdirSync13, openSync as openSync3, readdirSync as readdirSync9, readFileSync as readFileSync21, realpathSync as realpathSync6, rmSync as rmSync11, statSync as statSync10 } from "node:fs";
-import { basename as basename6, dirname as dirname16, join as join23, resolve as resolve6 } from "node:path";
+import { mkdirSync as mkdirSync13, openSync as openSync3, readdirSync as readdirSync10, readFileSync as readFileSync21, realpathSync as realpathSync6, rmSync as rmSync11, statSync as statSync11 } from "node:fs";
+import { basename as basename7, dirname as dirname17, join as join24, resolve as resolve6 } from "node:path";
 function runsDirectory() {
-  return join23(runtimeDirectory(), "runs");
+  return join24(runtimeDirectory(), "runs");
 }
 function realAsFarAsItExists(path) {
   const missing = [];
   let at = path;
   for (;; ) {
     try {
-      return join23(realpathSync6.native(at), ...missing);
+      return join24(realpathSync6.native(at), ...missing);
     } catch {
-      const parent = dirname16(at);
+      const parent = dirname17(at);
       if (parent === at) {
         return path;
       }
-      missing.unshift(basename6(at));
+      missing.unshift(basename7(at));
       at = parent;
     }
   }
@@ -34309,10 +34393,10 @@ function projectKey(projectPath) {
   return createHash4("sha256").update(folded.replaceAll("\\", "/")).digest("hex").slice(0, 16);
 }
 function runRecordPath(projectPath, directory = runtimeDirectory()) {
-  return join23(directory, "runs", `note-${projectKey(projectPath)}.json`);
+  return join24(directory, "runs", `note-${projectKey(projectPath)}.json`);
 }
 function latestRunPath(servedBy, directory = runtimeDirectory()) {
-  return join23(directory, "runs", `latest-${projectKey(servedBy)}.json`);
+  return join24(directory, "runs", `latest-${projectKey(servedBy)}.json`);
 }
 function writeLatestRun(servedBy, latest) {
   try {
@@ -34338,17 +34422,20 @@ function readLatestRun(servedBy, directory = runtimeDirectory()) {
 var SHARED_NOTE = "run.json";
 function openTranscript(startedAt) {
   mkdirSync13(runsDirectory(), { recursive: true });
-  const path = join23(runsDirectory(), `run-${startedAt}.log`);
+  const path = join24(runsDirectory(), `run-${startedAt}.log`);
   return { path, fd: openSync3(path, "a") };
 }
 function profilePath(startedAt) {
-  return join23(runsDirectory(), `run-${startedAt}.profile.json`);
+  return join24(runsDirectory(), `run-${startedAt}.profile.json`);
+}
+function profileMarkPath(startedAt) {
+  return join24(runsDirectory(), `run-${startedAt}.profile-mark.json`);
 }
 function noteIsAbout(note, playing) {
   return note.play !== undefined && playing !== null && note.play.play === playing.play && note.play.editorPid === playing.editorPid;
 }
 function editorNotePath(projectPath, directory = runtimeDirectory()) {
-  return join23(directory, "runs", `editor-${projectKey(projectPath)}.json`);
+  return join24(directory, "runs", `editor-${projectKey(projectPath)}.json`);
 }
 function writeEditorRunNote(note) {
   mkdirSync13(runsDirectory(), { recursive: true });
@@ -34359,7 +34446,7 @@ function writeEditorRunNote(note) {
 }
 function readEditorRunNote(projectPath) {
   for (const directory of runtimeDirectories()) {
-    const note = editorNoteAt(editorNotePath(projectPath, directory)) ?? editorNoteAt(join23(directory, "runs", "editor-run.json"));
+    const note = editorNoteAt(editorNotePath(projectPath, directory)) ?? editorNoteAt(join24(directory, "runs", "editor-run.json"));
     if (note !== null && isSameDirectory(note.projectPath, projectPath)) {
       return note;
     }
@@ -34393,7 +34480,7 @@ function readRunRecord(projectPath) {
     if (own !== null) {
       return own;
     }
-    const shared = recordAt(join23(directory, "runs", SHARED_NOTE));
+    const shared = recordAt(join24(directory, "runs", SHARED_NOTE));
     if (shared !== null && shared.projectPath !== "" && isSameDirectory(shared.projectPath, projectPath)) {
       return shared;
     }
@@ -34405,13 +34492,13 @@ function everyRunRecord() {
   for (const directory of runtimeDirectories()) {
     let entries;
     try {
-      entries = readdirSync9(join23(directory, "runs"));
+      entries = readdirSync10(join24(directory, "runs"));
     } catch {
       continue;
     }
     for (const entry of entries) {
       if (entry === SHARED_NOTE || entry.startsWith("note-") && entry.endsWith(".json")) {
-        const record = recordAt(join23(directory, "runs", entry));
+        const record = recordAt(join24(directory, "runs", entry));
         if (record !== null) {
           found.push(record);
         }
@@ -34581,7 +34668,7 @@ function whyNotTheRun(record, running, needed) {
   if (after > SAME_RUN_WINDOW_MS) {
     return `that process started ${Math.round(after / 1000)} seconds after the run had`;
   }
-  const engine = record.command === undefined ? null : basename6(record.command);
+  const engine = record.command === undefined ? null : basename7(record.command);
   const said = process.platform === "win32" ? running.text.toLowerCase() : running.text;
   const wanted = engine === null || process.platform !== "win32" ? engine : engine.toLowerCase();
   if (wanted !== null && !said.includes(wanted)) {
@@ -34620,7 +34707,7 @@ function judgeAnnouncedGame(running, projectPath, announcedAt) {
 }
 function clearRunRecord(projectPath) {
   for (const directory of runtimeDirectories()) {
-    const shared = join23(directory, "runs", SHARED_NOTE);
+    const shared = join24(directory, "runs", SHARED_NOTE);
     const sharedRecord = recordAt(shared);
     const ours = sharedRecord !== null && sharedRecord.projectPath !== "" && isSameDirectory(sharedRecord.projectPath, projectPath);
     for (const path of [runRecordPath(projectPath, directory), ...ours ? [shared] : []]) {
@@ -34632,7 +34719,7 @@ function clearRunRecord(projectPath) {
 }
 function ageMs(path, now) {
   try {
-    return now - statSync10(path).mtimeMs;
+    return now - statSync11(path).mtimeMs;
   } catch {
     return 0;
   }
@@ -34641,20 +34728,21 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
   const directory = runsDirectory();
   const kept = new Set(everyRunRecord().flatMap((record) => [
     record.transcript,
+    profileMarkPath(record.startedAt),
     ...record.profile === undefined ? [] : [record.profile]
   ]));
   let entries;
   try {
-    entries = readdirSync9(directory);
+    entries = readdirSync10(directory);
   } catch {
     return;
   }
   for (const entry of entries) {
-    const transcript = entry.startsWith("run-") && (entry.endsWith(".log") || entry.endsWith(".profile.json"));
+    const transcript = entry.startsWith("run-") && (entry.endsWith(".log") || entry.endsWith(".profile.json") || entry.endsWith(".profile-mark.json"));
     if (!transcript && !entry.endsWith(".partial")) {
       continue;
     }
-    const path = join23(directory, entry);
+    const path = join24(directory, entry);
     if (kept.has(path) || ageMs(path, now) < keepMs) {
       continue;
     }
@@ -34665,7 +34753,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
 }
 
 // src/script-origins.ts
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 var UNRESOLVED = /Could not resolve class "([A-Za-z_][A-Za-z0-9_]*)", because of a parser error/;
 function unresolvedClassIn(message) {
   return UNRESOLVED.exec(message)?.[1] ?? null;
@@ -34721,7 +34809,7 @@ function checkWithEngine(godotPath, projectPath) {
       const ran = await runEngine(godotPath, [
         "--headless",
         "--log-file",
-        join24(logDir, "engine.log"),
+        join25(logDir, "engine.log"),
         "--path",
         projectPath,
         "--check-only",
@@ -34815,6 +34903,52 @@ function isCalibration(signature) {
   const parts = signatureParts(signature);
   return parts.script.endsWith(RUNTIME_SCRIPT) && (parts.function === PROFILER_PROBE || parts.function === PROFILER_CALIBRATOR);
 }
+function writeProfileMark(path, mark) {
+  return writeWhole(path, JSON.stringify(mark));
+}
+function readProfileMark(path) {
+  try {
+    const parsed = JSON.parse(readFileSync22(path, "utf8"));
+    return typeof parsed === "object" && typeof parsed.totals === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function totalsSince(now, mark) {
+  if (now.frames < mark.frames || now.startedAt !== mark.startedAt) {
+    return null;
+  }
+  let shrunk = 0;
+  const functions = {};
+  for (const [signature, sum] of Object.entries(now.functions)) {
+    const before = mark.functions[signature];
+    if (isCalibration(signature) || before === undefined) {
+      functions[signature] = sum;
+      continue;
+    }
+    const added = {
+      calls: sum.calls - before.calls,
+      selfSeconds: sum.selfSeconds - before.selfSeconds,
+      totalSeconds: sum.totalSeconds - before.totalSeconds
+    };
+    if (added.calls < 0 || added.selfSeconds < 0 || added.totalSeconds < 0) {
+      shrunk += 1;
+    } else if (added.calls > 0) {
+      functions[signature] = added;
+    }
+  }
+  shrunk += Object.keys(mark.functions).filter((signature) => now.functions[signature] === undefined && (mark.functions[signature]?.calls ?? 0) > 0).length;
+  return {
+    totals: {
+      ...now,
+      frames: now.frames - mark.frames,
+      unreadable: Math.max(0, now.unreadable - mark.unreadable),
+      ...now.cappedFrames === undefined ? {} : { cappedFrames: Math.max(0, now.cappedFrames - (mark.cappedFrames ?? 0)) },
+      functions
+    },
+    shrunk
+  };
+}
 function perCallCostOf(totals) {
   for (const [signature, sum] of Object.entries(totals.functions)) {
     const parts = signatureParts(signature);
@@ -35467,7 +35601,7 @@ var TOOL_SPECS = [
       rootNodeType: {
         type: "string",
         ops: ["create"],
-        description: "create: the root node class. Default Node."
+        description: "create: the root node class, an engine class or a class_name a project script declares, which the root is made as with that script attached. Default Node."
       },
       rootNodeName: {
         type: "string",
@@ -35505,7 +35639,7 @@ var TOOL_SPECS = [
   {
     name: "scene_node",
     title: "Scene nodes",
-    description: `One node in a scene file: add, read, set, duplicate, reparent or delete it, or paint TileMap cells. Any ClassDB node type can be added, so a NavigationRegion2D, an AnimationTree or a Camera3D is an add with that nodeType and its properties, and another scene is instanced by an add with instancePath. A set with properties {"name": "Boss"} renames a node. A property holding a Resource takes the res:// path of one, so a texture, a material or a theme is a set like any other. A write is refused while the editor holds unsaved changes to the scene, and for a node that belongs to a scene this one instances or inherits. ${WITHOUT_AN_EDITOR}`,
+    description: `One node in a scene file: add, read, set, duplicate, reparent or delete it, or paint TileMap cells. Any ClassDB node type or script class can be added, so a NavigationRegion2D, an AnimationTree or a Camera3D is an add with that nodeType and its properties, and another scene is instanced by an add with instancePath. A set with properties {"name": "Boss"} renames a node. A property holding a Resource takes the res:// path of one, so a texture, a material or a theme is a set like any other. A write is refused while the editor holds unsaved changes to the scene, and for a node that belongs to a scene this one instances or inherits. ${WITHOUT_AN_EDITOR}`,
     parameters: {
       projectPath: PROJECT_PATH2,
       scenePath: SCENE_PATH,
@@ -35518,7 +35652,7 @@ var TOOL_SPECS = [
       nodeType: {
         type: "string",
         ops: ["add"],
-        description: 'add: the node class, such as "CharacterBody2D". Give this or instancePath.'
+        description: 'add: the node class, such as "CharacterBody2D", or a class_name a project script declares, which the node is made as with that script attached. Give this or instancePath.'
       },
       instancePath: {
         type: "string",
@@ -35863,7 +35997,7 @@ var TOOL_SPECS = [
       resourceType: {
         type: "string",
         ops: ["create"],
-        description: 'create: the resource class, such as "PhysicsMaterial" or "StandardMaterial3D".'
+        description: 'create: the resource class, such as "PhysicsMaterial" or "StandardMaterial3D", or a class_name a project script declares, which the resource is made as with that script attached.'
       },
       properties: { ...PROPERTIES, ops: ["create", "modify"] },
       script: {
@@ -36057,6 +36191,17 @@ var TOOL_SPECS = [
         ops: ["profile"],
         description: "profile: also answer, under callers, where the project's scripts name this function in code: its name, or Class.name for the functions of one class. Each place has its script, line, the named function it is written in (within), whether the function is called there or passed on as a Callable (called), and the profile's calls, self and total milliseconds for the function it is in, those taking the most time first, forty at most. Found by name in the source, since the engine's profiler records nothing about who made a call, so a method of the same name on another class is listed too, except, when Class.name was asked, one called through another class of the project by name or through a parameter, local or class variable declared as one, and a call made through a string is not. A parameter, local or class variable of the same name is not the function and is not listed. A property's get or set block, which the profile names Class.@name_getter or Class.@name_setter, is asked about by that name or by the property's: the places are where the property is named, each saying instead of called whether it writes the property (access write), which runs the set block, or reads it (access read), which runs the get block, and the rows are both blocks'. Inside the property's own blocks its name is the value stored, which the engine reads and writes without running them, so those lines are not places."
       },
+      mark: {
+        type: "boolean",
+        ops: ["profile"],
+        description: `profile: answer as usual and set the run's mark at these totals, so a later profile with since: "mark" answers for one action, a press or a commit, apart from the boot and everything before it. The mark is kept beside the run's profile, so a server that replaces this one reads it too, and setting it again moves it. Given with since, the answer counts from the mark before it moves, which times one span after another. Default false.`
+      },
+      since: {
+        type: "string",
+        enum: ["mark"],
+        ops: ["profile"],
+        description: 'profile: "mark" answers only what was added after the mark that mark: true set in this run: per function the calls and self and total milliseconds since it, with the functions that added no call left out, frames and coveredMs since it, and callersOf read off the same difference. Refused when no mark was set in this run, or when the profile holds less than it did at the mark, which is a profiler started again since.'
+      },
       limit: {
         type: "integer",
         minimum: 1,
@@ -36108,7 +36253,7 @@ var TOOL_SPECS = [
         requires: []
       }
     },
-    answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: close (the game was asked to close and exited, so exitCode is its own), keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. entries holds the errors and warnings and not the ordinary lines the run printed, which printedLinesNotShown counts; a check given --verbose holds those too, and editor_run start then editor_output reads everything. An engine crash is an error whatever it prints after: the crash handler's report is the entry, and the engine version and the native and GDScript backtraces are its detail, so a crashed run is never booted or clean. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
+    answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: close (the game was asked to close and exited, so exitCode is its own), keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. entries holds the errors and warnings and not the ordinary lines the run printed, which printedLinesNotShown counts; a check given --verbose holds those too, and editor_run start then editor_output reads everything. An engine crash is an error whatever it prints after: the crash handler's report is the entry, and the engine version and the native and GDScript backtraces are its detail, so a crashed run is never booted or clean. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked. A profile with mark answers marked: true; one with since answers since: \"mark\" and markSetMsAgo, and lessThanAtMark counts the functions left out for reading less than at the mark, which the engine's own totals, capped, can do when they replace the frames' sum.",
     defaultOperation: "start"
   },
   {
@@ -36906,16 +37051,16 @@ function serverInstructions() {
 import { createHash as createHash5 } from "node:crypto";
 import {
   cpSync,
-  existsSync as existsSync19,
+  existsSync as existsSync20,
   mkdirSync as mkdirSync14,
-  readdirSync as readdirSync10,
+  readdirSync as readdirSync11,
   readFileSync as readFileSync23,
   rmdirSync,
   rmSync as rmSync12,
-  statSync as statSync11,
+  statSync as statSync12,
   writeFileSync as writeFileSync15
 } from "node:fs";
-import { dirname as dirname17, join as join25 } from "node:path";
+import { dirname as dirname18, join as join26 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 var ADDONS = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
 var EDITOR_PLUGINS = ["gdharness_editor", "auto_reload"];
@@ -36934,13 +37079,13 @@ function runtimeAddonDigest(from = shippedAddonsDirectory()) {
 function addonsDigest(names, from) {
   const hash = createHash5("sha256");
   const walk = (directory, relative) => {
-    for (const name of readdirSync10(directory).sort()) {
+    for (const name of readdirSync11(directory).sort()) {
       if (name === VERSION_MARKER || name === DIGEST_MARKER) {
         continue;
       }
-      const path = join25(directory, name);
+      const path = join26(directory, name);
       const inside = `${relative}/${name}`;
-      if (statSync11(path).isDirectory()) {
+      if (statSync12(path).isDirectory()) {
         walk(path, inside);
       } else {
         hash.update(`${inside}
@@ -36952,7 +37097,7 @@ function addonsDigest(names, from) {
     }
   };
   for (const name of names) {
-    walk(join25(from, name), name);
+    walk(join26(from, name), name);
   }
   return hash.digest("hex");
 }
@@ -36985,19 +37130,19 @@ function installedRuntimeDigest(projectPath) {
   return digestMarker(projectPath, RUNTIME_ADDON);
 }
 function digestMarker(projectPath, addon) {
-  const marker = join25(projectPath, "addons", addon, DIGEST_MARKER);
-  if (!existsSync19(marker)) {
+  const marker = join26(projectPath, "addons", addon, DIGEST_MARKER);
+  if (!existsSync20(marker)) {
     return null;
   }
   const said = readFileSync23(marker, "utf8").trim();
   return said === "" ? null : said;
 }
 function shippedAddonsDirectory() {
-  return join25(dirname17(fileURLToPath3(import.meta.url)), "godot", "addons");
+  return join26(dirname18(fileURLToPath3(import.meta.url)), "godot", "addons");
 }
 function installedAddonVersion(projectPath) {
-  const marker = join25(projectPath, "addons", ADDONS[0], VERSION_MARKER);
-  if (!existsSync19(marker)) {
+  const marker = join26(projectPath, "addons", ADDONS[0], VERSION_MARKER);
+  if (!existsSync20(marker)) {
     return null;
   }
   const said = readFileSync23(marker, "utf8").trim();
@@ -37011,7 +37156,7 @@ function loaderAmong(projectPath, named) {
     }
     let source = null;
     try {
-      source = readFileSync23(join25(projectPath, path), "utf8");
+      source = readFileSync23(join26(projectPath, path), "utf8");
     } catch {}
     if (source?.includes(RUNTIME_AUTOLOAD.path)) {
       return { name: entry, path, exists: true };
@@ -37053,10 +37198,10 @@ function enabledPlugins(settings) {
 function inspectProject(projectPath) {
   const problems = [];
   const addons = ADDONS.map((name) => {
-    const directory = join25(projectPath, "addons", name);
-    const marker = join25(directory, VERSION_MARKER);
-    const installed = existsSync19(directory);
-    const version = existsSync19(marker) ? readFileSync23(marker, "utf8").trim() : null;
+    const directory = join26(projectPath, "addons", name);
+    const marker = join26(directory, VERSION_MARKER);
+    const installed = existsSync20(directory);
+    const version = existsSync20(marker) ? readFileSync23(marker, "utf8").trim() : null;
     const current = version === SERVER_VERSION;
     if (!installed) {
       problems.push(`addons/${name} is not installed; run gdharness setup`);
@@ -37065,7 +37210,7 @@ function inspectProject(projectPath) {
     }
     return { name, installed, version, current };
   });
-  const settings = parseProjectGodot(readFileSync23(join25(projectPath, "project.godot"), "utf8"));
+  const settings = parseProjectGodot(readFileSync23(join26(projectPath, "project.godot"), "utf8"));
   const pluginsEnabled = enabledPlugins(settings);
   for (const name of EDITOR_PLUGINS) {
     if (!pluginsEnabled.includes(name)) {
@@ -37081,7 +37226,7 @@ function inspectProject(projectPath) {
   const tracked = trackedByGit(projectPath, [...named.values()]);
   const addonMissing = (path) => addons.some((addon) => !addon.installed && path.startsWith(`addons/${addon.name}/`));
   for (const [name, path] of named) {
-    if (!existsSync19(join25(projectPath, path))) {
+    if (!existsSync20(join26(projectPath, path))) {
       if (!addonMissing(path)) {
         problems.push(`the ${name} autoload names res://${path}, which is not in this project, so it boots with a missing script; restore that file, or point the autoload at one that is here`);
       }
@@ -37133,7 +37278,7 @@ var UPDATE_NOTICE_EVERY = 500;
 var FEEDBACK_NOTICE_EVERY = 250;
 var FAILED_BUDGET = 1e6;
 var ANSWER_BUDGET = 4000000;
-var __dirname2 = dirname18(fileURLToPath4(import.meta.url));
+var __dirname2 = dirname19(fileURLToPath4(import.meta.url));
 var PARENT_ASKED_AFTER_MS = 5000;
 function editorRestartTimeoutMs() {
   return waitFromEnv("GDHARNESS_EDITOR_RESTART_TIMEOUT_MS", 90000);
@@ -37165,22 +37310,22 @@ function writtenFileRefusal(path, rule) {
   if (/^(res|user):\/\//.test(path)) {
     return `${named} ${path} is a Godot path; ${what} is saved outside the project, at an absolute path on this machine.`;
   }
-  if (!isAbsolute4(path)) {
+  if (!isAbsolute5(path)) {
     return `${named} ${path} is not absolute; name the whole path, so where it is written does not depend on this server's directory.`;
   }
   if (!rule.extensions.includes(extname4(path).toLowerCase())) {
     return `${named} ${path} does not end in ${rule.extensions.join(" or ")}, which is what ${what} is.`;
   }
-  const directory = realPathOr(dirname18(path));
-  if (!existsSync20(directory)) {
-    return `${named}'s directory ${dirname18(path)} does not exist; ${what} creates no directories.`;
+  const directory = realPathOr(dirname19(path));
+  if (!existsSync21(directory)) {
+    return `${named}'s directory ${dirname19(path)} does not exist; ${what} creates no directories.`;
   }
-  const where = join26(directory, basename7(path));
+  const where = join27(directory, basename8(path));
   const inside = rule.projects.find((project) => project !== "" && isWithinRoot(realPathOr(project), where));
   if (inside !== undefined) {
     return `${named} ${path} is inside the project at ${inside}; ${what} is saved outside it, so it never becomes part of the game.`;
   }
-  const taken = rule.writes(where).find((file) => existsSync20(file));
+  const taken = rule.writes(where).find((file) => existsSync21(file));
   if (taken !== undefined) {
     return taken === where ? `${named} ${path} already exists; ${what} is not written over a file. Name a new one.` : `${named} ${path} would write ${taken}, which already exists; ${what} is not written over a file. Name a new one.`;
   }
@@ -37291,7 +37436,7 @@ function exited(run) {
   return run.exitCode !== null || run.exitSignal !== null;
 }
 function howItExited(run) {
-  return run.exitSignal === null ? `exit code ${run.exitCode ?? "unknown"}` : `ended by ${run.exitSignal}, with no exit code`;
+  return run.exitSignal === null ? exitCodeText(run.exitCode) : `ended by ${run.exitSignal}, with no exit code`;
 }
 function errorsUnread(run) {
   return run.throughEditor && typeof run.errorReport !== "string";
@@ -37404,7 +37549,7 @@ function endedWithoutACode(run) {
 function ourRunEnded(run, now) {
   const which = `${run.throughEditor ? "played in the editor" : "started"}${run.pid === null ? "" : ` (pid ${run.pid})`}`;
   const when = run.endedAt === undefined ? "" : ` ${Math.max(0, Math.round((now - run.endedAt) / 1000))}s ago`;
-  const how = run.endedThrough === "close" ? "this server asked it to close" : run.endedThrough === "keeper" ? "this server ended it through the keeper holding it" : run.endedThrough === "signal" ? "this server signalled it" : run.endedThrough === "editor" ? "this server asked the editor to stop it" : run.exitCode !== null ? `it exited by itself with code ${run.exitCode}` : run.exitSignal === null ? "it is no longer running" : `it was ended by ${run.exitSignal}`;
+  const how = run.endedThrough === "close" ? "this server asked it to close" : run.endedThrough === "keeper" ? "this server ended it through the keeper holding it" : run.endedThrough === "signal" ? "this server signalled it" : run.endedThrough === "editor" ? "this server asked the editor to stop it" : run.exitCode !== null ? `it exited by itself with ${exitCodeText(run.exitCode)}` : run.exitSignal === null ? "it is no longer running" : `it was ended by ${run.exitSignal}`;
   return `No game with the runtime addon is running: the game this server ${which} ended${when}, and ${how}. editor_output has what it printed, and editor_run start runs it again.`;
 }
 function stopVerdict(stop) {
@@ -37742,7 +37887,7 @@ function notRunNote(notRun, failFast) {
 function exportPresetRefusal(projectPath, preset) {
   let text;
   try {
-    text = readFileSync24(join26(projectPath, "export_presets.cfg"), "utf8");
+    text = readFileSync24(join27(projectPath, "export_presets.cfg"), "utf8");
   } catch {
     return `This project has no export_presets.cfg, so it has no preset '${preset}' to export with. project_export add_preset writes one, as the editor's Project > Export does.`;
   }
@@ -37764,7 +37909,7 @@ function exportPresetRefusal(projectPath, preset) {
   }
   return names.length === 0 ? `export_presets.cfg names no preset, so there is no '${preset}' to export with. project_export add_preset adds one.` : `This project has no export preset named '${preset}'. Its presets are ${names.map((name) => `'${name}'`).join(", ")}.`;
 }
-function exportAnswer(ending, asked, before, after, beside = []) {
+function exportAnswer(ending, asked, before, after, beside = [], docCacheNote = null) {
   const { log } = ending;
   const written = after !== null && after !== before;
   const notCopied = librariesNotCopied(log.all);
@@ -37781,6 +37926,7 @@ function exportAnswer(ending, asked, before, after, beside = []) {
       librariesNotLoaded: notCopied,
       extensionNote: `The export could not load ${notCopied.join(" and ")}: on Windows an engine running as the editor, which an export is, loads a GDExtension from a ~ copy beside the library, and another engine on this project held that copy: it could not be moved aside before the export, or another engine made a new one in between. Export again once that engine has loaded or exited.`
     },
+    ...docCacheNote === null ? {} : { docCacheNote },
     ...foldedEntriesAnswer(log)
   };
   if (verdict.exported) {
@@ -37805,9 +37951,9 @@ function writtenBeside(before, after, output, within) {
 function filesIn(folder) {
   const found = new Map;
   try {
-    for (const entry of readdirSync11(folder, { withFileTypes: true })) {
+    for (const entry of readdirSync12(folder, { withFileTypes: true })) {
       if (entry.isFile()) {
-        found.set(entry.name, statSync12(join26(folder, entry.name)).mtimeMs);
+        found.set(entry.name, statSync13(join27(folder, entry.name)).mtimeMs);
       }
     }
   } catch {}
@@ -37841,7 +37987,7 @@ function unsavedInEditorNote(scripts) {
   return `${named} ${one ? "is" : "are"} open in the editor's script ${one ? "tab" : "tabs"} with unsaved edits, and saving ${one ? "that tab" : "them"} there writes ${one ? "its" : "their"} text over what was written here: close ${one ? "it" : "them"} without saving, or save first and edit again.`;
 }
 function editorAddonMissing(projectPath) {
-  if (!existsSync20(join26(projectPath, "project.godot"))) {
+  if (!existsSync21(join27(projectPath, "project.godot"))) {
     return null;
   }
   const report = inspectProject(projectPath);
@@ -38129,7 +38275,7 @@ function profileFrameFunctions(projectPath) {
   let projectGodot = null;
   if (projectPath !== null) {
     try {
-      projectGodot = readFileSync24(join26(projectPath, "project.godot"), "utf8");
+      projectGodot = readFileSync24(join27(projectPath, "project.godot"), "utf8");
     } catch {}
   }
   return frameFunctionsFor(queuedMessagesOf(projectGodot));
@@ -38307,7 +38453,7 @@ function foldedEntriesAnswer(log, floor = "warning") {
 var ERROR_ASSERT = "GdUnitGodotErrorAssertImpl.gd";
 function gdUnitFailsOnScriptErrors(projectPath) {
   try {
-    return settingKeys(readFileSync24(join26(projectPath, "project.godot"), "utf8")).get("gdunit4/report/godot/script_error") !== false;
+    return settingKeys(readFileSync24(join27(projectPath, "project.godot"), "utf8")).get("gdunit4/report/godot/script_error") !== false;
   } catch {
     return true;
   }
@@ -38322,13 +38468,13 @@ function uncaughtNote(uncaught) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync20(join26(projectPath, wanted))) {
+  if (wanted === "" || existsSync21(join27(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
   let near = [];
   try {
-    near = readdirSync11(projectPath, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.toLowerCase() !== root).map((entry) => entry.name).filter((name) => name.toLowerCase().startsWith("test") || root.startsWith(name.toLowerCase()));
+    near = readdirSync12(projectPath, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.toLowerCase() !== root).map((entry) => entry.name).filter((name) => name.toLowerCase().startsWith("test") || root.startsWith(name.toLowerCase()));
   } catch {
     return "";
   }
@@ -38420,23 +38566,23 @@ function engineChecked(why) {
 var EXTERNAL_MEMBER = 'Could not resolve external class member "';
 function isDirectory(path) {
   try {
-    return statSync12(path).isDirectory();
+    return statSync13(path).isDirectory();
   } catch {
     return false;
   }
 }
 function scriptsUnder(directory, prefix) {
-  if (existsSync20(join26(directory, ".gdignore"))) {
+  if (existsSync21(join27(directory, ".gdignore"))) {
     return [];
   }
   const found = [];
-  for (const entry of readdirSync11(directory, { withFileTypes: true }).sort((a, b) => a.name < b.name ? -1 : 1)) {
+  for (const entry of readdirSync12(directory, { withFileTypes: true }).sort((a, b) => a.name < b.name ? -1 : 1)) {
     if (entry.name.startsWith(".")) {
       continue;
     }
     const path = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
     if (entry.isDirectory()) {
-      found.push(...scriptsUnder(join26(directory, entry.name), path));
+      found.push(...scriptsUnder(join27(directory, entry.name), path));
     } else if (entry.isFile() && entry.name.endsWith(".gd")) {
       found.push(path);
     }
@@ -38452,7 +38598,7 @@ function runtimeAddonAnnouncesEditors(projectPath) {
     return false;
   }
   try {
-    return readFileSync24(join26(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
+    return readFileSync24(join27(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
   } catch {
     return false;
   }
@@ -38478,7 +38624,7 @@ var STATIC_LIST_HINT = { ttlMs: 5 * 60000, cacheScope: "private" };
 class GodotServer {
   stdio = null;
   locator = new GodotLocator;
-  operationsScript = join26(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join27(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -38739,14 +38885,14 @@ class GodotServer {
   }
   noteTheStart() {
     const cwd = process.cwd();
-    const mcpJson = join26(cwd, ".mcp.json");
+    const mcpJson = join27(cwd, ".mcp.json");
     const announced = this.ownProject === null ? null : readAnnouncement(announcementPath(this.ownProject));
     const predecessor = announced !== null && announced.pid !== process.pid && alive(announced.pid) ? announced.pid : null;
     writeLifecycle("started", {
       argv: process.argv.slice(1),
       cwd,
       project: this.ownProject,
-      mcpJson: existsSync20(mcpJson) ? mcpJson : null
+      mcpJson: existsSync21(mcpJson) ? mcpJson : null
     });
     if (predecessor !== null) {
       writeLifecycle("replaced", { project: this.ownProject, predecessor });
@@ -38887,7 +39033,7 @@ class GodotServer {
         return checked.response;
       }
       const named = args["projectPath"];
-      if (typeof named === "string" && existsSync20(join26(named, "project.godot"))) {
+      if (typeof named === "string" && existsSync21(join27(named, "project.godot"))) {
         this.lastProjectPath = named;
       }
       this.updates.refresh();
@@ -38923,7 +39069,7 @@ class GodotServer {
     let notSaved;
     try {
       savedAt = answer.content.map((item, index) => {
-        const file = join26(directory, item.type === "text" ? `${stem}-${index}.txt` : `${stem}-${index}.${item.mimeType.split("/")[1] ?? "bin"}`);
+        const file = join27(directory, item.type === "text" ? `${stem}-${index}.txt` : `${stem}-${index}.${item.mimeType.split("/")[1] ?? "bin"}`);
         writeFileSync16(file, item.type === "text" ? item.text : Buffer.from(item.data, "base64"));
         return file;
       });
@@ -39541,8 +39687,8 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join26(path, "project.godot");
-    if (!existsSync20(file)) {
+    const file = join27(path, "project.godot");
+    if (!existsSync21(file)) {
       return {
         ok: false,
         response: this.createErrorResponse(`Not a Godot project: ${path}`, [
@@ -39588,7 +39734,7 @@ class GodotServer {
   }
   runEnvironment(args) {
     const savesIn = readNonEmptyString(args, "savesIn");
-    if (savesIn !== undefined && !isAbsolute4(savesIn)) {
+    if (savesIn !== undefined && !isAbsolute5(savesIn)) {
       return {
         ok: false,
         response: this.createErrorResponse(`savesIn must be an absolute path, not "${savesIn}".`, [
@@ -39847,7 +39993,8 @@ class GodotServer {
         uidsCreated: given,
         stillWithoutUid: after,
         note: uidsLeftNote(after.length),
-        ...imported.extensionNote === undefined ? {} : { extensionNote: imported.extensionNote }
+        ...imported.extensionNote === undefined ? {} : { extensionNote: imported.extensionNote },
+        ...imported.docCacheNote === undefined ? {} : { docCacheNote: imported.docCacheNote }
       }
     }, scanned));
   }
@@ -40086,6 +40233,9 @@ class GodotServer {
       if (imported.extensionNote !== undefined) {
         extra["extensionNote"] = imported.extensionNote;
       }
+      if (imported.docCacheNote !== undefined) {
+        extra["docCacheNote"] = imported.docCacheNote;
+      }
     }
     const after = await this.operation("get_import_status", statusAsk, projectPath);
     if (!after.ok) {
@@ -40202,7 +40352,7 @@ class GodotServer {
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
-      name: typeof name === "string" && name !== "" ? name : basename7(project.value.path),
+      name: typeof name === "string" && name !== "" ? name : basename8(project.value.path),
       path: project.value.path,
       mainScene: typeof mainScene === "string" && mainScene !== "" ? mainScene : null,
       godotVersion: await this.godotVersion(engine.value),
@@ -40285,18 +40435,18 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const folder = dirname18(output.absolutePath);
+    const folder = dirname19(output.absolutePath);
     try {
       mkdirSync15(folder, { recursive: true });
     } catch (error) {
-      return this.createErrorResponse(`Cannot create ${dirname18(output.relativePath)} to export into: ${errorMessage(error)}`);
+      return this.createErrorResponse(`Cannot create ${dirname19(output.relativePath)} to export into: ${errorMessage(error)}`);
     }
     const debug = readBoolean(args, "debug") ?? false;
     const exportLogs = scratchDirectory("export");
     const exportArgs = [
       "--headless",
       "--log-file",
-      join26(exportLogs, "engine.log"),
+      join27(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -40304,24 +40454,37 @@ class GodotServer {
       output.absolutePath
     ];
     this.logDebug(`Exporting: ${engine.value} ${exportArgs.join(" ")}`);
-    const writtenAt = () => existsSync20(output.absolutePath) ? statSync12(output.absolutePath).mtimeMs : null;
-    const before = writtenAt();
-    const listedBefore = filesIn(folder);
-    const freed = freeLibraryCopies(project.value.path);
-    if (freed.setAside.length > 0 || freed.swept.length > 0) {
-      this.logDebug(`Before the export: set aside ${freed.setAside.join(", ")}; swept ${freed.swept.join(", ")}`);
-    }
-    let ending;
+    const writtenAt = () => existsSync21(output.absolutePath) ? statSync13(output.absolutePath).mtimeMs : null;
+    const caches = editorCacheDirectory(engine.value);
+    const exportOnce = async () => {
+      const before = writtenAt();
+      const listedBefore = filesIn(folder);
+      const cachesBefore = docCachesWritten(caches);
+      const freed = freeLibraryCopies(project.value.path);
+      if (freed.setAside.length > 0 || freed.swept.length > 0) {
+        this.logDebug(`Before the export: set aside ${freed.setAside.join(", ")}; swept ${freed.swept.join(", ")}`);
+      }
+      const ending = await runEngine(engine.value, exportArgs, {
+        timeout: { ms: 300000, said: "five minutes" }
+      });
+      const crash = docCacheCrash(ending, cachesBefore, docCachesWritten(caches), "export");
+      return { ending, before, listedBefore, crash };
+    };
+    let run;
+    let docCacheNote;
     try {
-      ending = await runEngine(engine.value, exportArgs, { timeout: { ms: 300000, said: "five minutes" } });
+      const first = await exportOnce();
+      docCacheNote = first.crash;
+      run = first.crash === null ? first : await exportOnce();
     } finally {
       discard(exportLogs);
     }
+    const { ending, before, listedBefore } = run;
     if (ending.exitSignal === null && ending.exitCode === null) {
       return this.createErrorResponse(`Export could not be run: ${ending.failure ?? "the engine gave no exit status"}`);
     }
-    const beside = writtenBeside(listedBefore, filesIn(folder), basename7(output.absolutePath), dirname18(output.relativePath).replaceAll("\\", "/"));
-    return exportAnswer(ending, { preset, outputPath: output.relativePath, debug }, before, writtenAt(), beside);
+    const beside = writtenBeside(listedBefore, filesIn(folder), basename8(output.absolutePath), dirname19(output.relativePath).replaceAll("\\", "/"));
+    return exportAnswer(ending, { preset, outputPath: output.relativePath, debug }, before, writtenAt(), beside, docCacheNote);
   }
   reportTestProgress(log) {
     const progress = callProgress();
@@ -40374,10 +40537,10 @@ class GodotServer {
     if (movie !== null) {
       return this.createErrorResponse(movie);
     }
-    const missing = paths.value.filter((path) => !existsSync20(join26(project.value.path, path.slice("res://".length))));
+    const missing = paths.value.filter((path) => !existsSync21(join27(project.value.path, path.slice("res://".length))));
     const asked = paths.value.filter((path) => !missing.includes(path));
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    const noRunner = !existsSync20(join26(project.value.path, runner));
+    const noRunner = !existsSync21(join27(project.value.path, runner));
     if (asked.length === 0) {
       const verdict = `nothing at ${missing.join(" and ")}`;
       const andNoRunner = noRunner ? `, and gdUnit4 is not installed in this project: no ${runner}` : "";
@@ -40468,21 +40631,21 @@ class GodotServer {
       await untilGone([run.process.pid]);
     }
     await run.settled;
-    const reportsDir = join26(project.value.path, ".godot", ...ours.split("/"));
+    const reportsDir = join27(project.value.path, ".godot", ...ours.split("/"));
     let report = null;
     let reportProblem = null;
     try {
-      const written = existsSync20(reportsDir) ? readdirSync11(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
+      const written = existsSync21(reportsDir) ? readdirSync12(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(readFileSync24(join26(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync24(join27(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
     } finally {
       discard(reportsDir, userData);
       try {
-        rmdirSync2(dirname18(reportsDir));
+        rmdirSync2(dirname19(reportsDir));
       } catch {}
     }
     const engineEntries = foldedRepeats(run.log.select({
@@ -40514,7 +40677,7 @@ class GodotServer {
     const declaring = printedErrors.some((error) => unresolvedClassIn(error.message) !== null) ? await originsOf(printedErrors, declaredClasses(project.value.path), checkWithEngine(engine.value, project.value.path)) : { origins: [], unconfirmed: [] };
     const scriptErrors = [...declaring.origins, ...printedErrors];
     const brokenScripts = new Set(scriptErrors.map((error) => error.path)).size;
-    const ranAs = cutShort !== null ? cutShort.verdict : nothingRan ?? (brokenScripts > 0 ? `script errors in ${brokenScripts === 1 ? "one script" : `${brokenScripts} scripts`}, so no suite ran` : undefined) ?? (uncaught.length > 0 ? `${uncaught.length === 1 ? "one script error" : `${uncaught.length} script errors`} that failed no case` : undefined) ?? (exitCode === null ? undefined : verdicts[exitCode]) ?? (run.exitSignal === null ? `exit ${exitCode ?? "unknown"}` : howItExited(run));
+    const ranAs = cutShort !== null ? cutShort.verdict : nothingRan ?? (brokenScripts > 0 ? `script errors in ${brokenScripts === 1 ? "one script" : `${brokenScripts} scripts`}, so no suite ran` : undefined) ?? (uncaught.length > 0 ? `${uncaught.length === 1 ? "one script error" : `${uncaught.length} script errors`} that failed no case` : undefined) ?? (exitCode === null ? undefined : verdicts[exitCode]) ?? howItExited(run);
     const nothingAt = missing.join(" and ");
     const verdict = missing.length === 0 ? ranAs : `${ranAs}; nothing at ${nothingAt}`;
     const missingNote = missing.length === 0 ? undefined : `Nothing at ${nothingAt}, so ${missing.length === 1 ? "it was" : "they were"} left out and only ${asked.join(", ")} ran; a run of fewer paths than were asked for is not called a pass.${elsewhereIn(project.value.path, missing[0] ?? "")}`;
@@ -40841,7 +41004,7 @@ class GodotServer {
     const cached = cachedClasses(projectPath);
     const sourceOf = (resourcePath) => {
       const contained = resolveWithinProject(projectPath, resourcePath);
-      if (!contained.ok || !existsSync20(contained.absolutePath)) {
+      if (!contained.ok || !existsSync21(contained.absolutePath)) {
         return null;
       }
       try {
@@ -40935,7 +41098,7 @@ class GodotServer {
   }
   sourceOfClass(projectPath, resourcePath) {
     const contained = resolveWithinProject(projectPath, resourcePath);
-    if (!contained.ok || !existsSync20(contained.absolutePath)) {
+    if (!contained.ok || !existsSync21(contained.absolutePath)) {
       return null;
     }
     try {
@@ -41097,7 +41260,7 @@ class GodotServer {
       ...Array.isArray(stack) ? {
         stack: stack.map((frame) => ({
           ...frame,
-          ...projectPath !== "" && typeof frame["script"] === "string" && frame["script"].startsWith("res://") ? { path: join26(projectPath, frame["script"].slice("res://".length)) } : {}
+          ...projectPath !== "" && typeof frame["script"] === "string" && frame["script"].startsWith("res://") ? { path: join27(projectPath, frame["script"].slice("res://".length)) } : {}
         }))
       } : {}
     });
@@ -41376,7 +41539,7 @@ class GodotServer {
       return null;
     }
     try {
-      return settingKeys(readFileSync24(join26(projectPath, "project.godot"), "utf8"));
+      return settingKeys(readFileSync24(join27(projectPath, "project.godot"), "utf8"));
     } catch {
       return null;
     }
@@ -41813,7 +41976,7 @@ class GodotServer {
   }
   async runtimeUp(projectPath, before, budget, withArgs) {
     const budgetMs = budget.ms;
-    if (!existsSync20(join26(projectPath, RUNTIME_AUTOLOAD.path))) {
+    if (!existsSync21(join27(projectPath, RUNTIME_AUTOLOAD.path))) {
       return runtimeVerdict(null, {
         addon: false,
         budgetMs,
@@ -41899,7 +42062,7 @@ class GodotServer {
     }
     let announcedAt;
     try {
-      announcedAt = statSync12(endpoint.file).mtimeMs;
+      announcedAt = statSync13(endpoint.file).mtimeMs;
     } catch {
       return;
     }
@@ -42789,9 +42952,13 @@ class GodotServer {
     if (callersName !== undefined && !callersName.replace(/@([^.@]+)_(?:getter|setter)$/, "$1").split(".").every(isIdentifier)) {
       return this.createErrorResponse(`callersOf takes a function's name, or Class.name for the functions of one class, and ${JSON.stringify(callersName)} is neither.`, ["editor_run profile names each function as it answers; pass one of those"]);
     }
+    const asked = {
+      mark: readBoolean(args, "mark") === true,
+      since: readString(args, "since") === "mark"
+    };
     const going = await this.runStillGoing(run);
     const projectPath = run.projectPath;
-    const projectGone = projectPath !== null && !existsSync20(join26(projectPath, "project.godot"));
+    const projectGone = projectPath !== null && !existsSync21(join27(projectPath, "project.godot"));
     if (projectGone && callersName !== undefined) {
       return this.createErrorResponse(`callersOf reads the project's scripts, and the run's project at ${projectPath} has no project.godot any more.`, ["editor_run profile without callersOf answers with the profile itself"]);
     }
@@ -42801,7 +42968,7 @@ class GodotServer {
       ...callersName === undefined ? {} : { callersOf: { name: callersName, scripts: () => projectScripts(projectPath) } }
     };
     if (run.throughEditor) {
-      return await this.profileOfThePlayedGame(going, projectPath, fromProject, limit);
+      return await this.profileOfThePlayedGame(run, going, fromProject, limit, asked);
     }
     const path = run.profile;
     if (path === undefined) {
@@ -42814,15 +42981,16 @@ class GodotServer {
       ]);
     }
     const totals = file.connected ? file : null;
-    return this.jsonTextResponse(profileAnswer({
+    return this.profileReply(run, {
       through: "gdharness",
       running: going,
       totals,
       coveredMs: totals?.lastFrameAt == null ? 0 : totals.lastFrameAt - totals.startedAt,
       ...fromProject
-    }, limit));
+    }, limit, asked);
   }
-  async profileOfThePlayedGame(going, projectPath, fromProject, limit) {
+  async profileOfThePlayedGame(run, going, fromProject, limit, asked) {
+    const { projectPath } = run;
     const read = await this.handleViaBridge("profile_read", {});
     if (read.isError === true) {
       return read;
@@ -42844,12 +43012,13 @@ class GodotServer {
         return this.createErrorResponse("The editor says it is playing and has no debugger session for the game, so there is nothing to switch the profiler on in yet.", ["Ask again in a moment, once the game is up"]);
       }
       const on = await this.firstProfiledFrame();
+      const unmarked = asked.mark || asked.since ? " Nothing was marked, and nothing is counted from a mark: the profile begins now, so an answer without since covers the same span." : "";
       return this.jsonTextResponse({
         through: "editor",
         running: true,
         started: true,
         functions: [],
-        note: on ? "The profiler was switched on now, for the game the editor is playing, and its first frame has arrived, so it covers what the game does from here on. Ask again for the functions; editor_run start with profile: true covers a game from its start." : `The profiler was switched on for the game the editor is playing, and no frame of it had arrived ${PROFILER_ON_MS}ms later: what the game does before the first one is not counted. Ask again for the functions; editor_run start with profile: true covers a game from its start.`
+        note: on ? `The profiler was switched on now, for the game the editor is playing, and its first frame has arrived, so it covers what the game does from here on. Ask again for the functions; editor_run start with profile: true covers a game from its start.${unmarked}` : `The profiler was switched on for the game the editor is playing, and no frame of it had arrived ${PROFILER_ON_MS}ms later: what the game does before the first one is not counted. Ask again for the functions; editor_run start with profile: true covers a game from its start.${unmarked}`
       });
     }
     const functions = asParams(held["functions"]);
@@ -42872,13 +43041,70 @@ class GodotServer {
         ];
       }))
     } : null;
-    return this.jsonTextResponse(profileAnswer({
+    return this.profileReply(run, {
       through: "editor",
       running: going,
       totals,
       coveredMs: readNonNegativeNumber(held, "coveredMs") ?? 0,
       ...fromProject
-    }, limit));
+    }, limit, asked);
+  }
+  profileReply(run, reading, limit, asked) {
+    const markPath = profileMarkPath(run.startedAt);
+    const now = Date.now();
+    let shown = reading;
+    const lead = [];
+    let sinceFields = {};
+    if (asked.since) {
+      const mark = readProfileMark(markPath);
+      if (mark === null || mark.runStartedAt !== run.startedAt || mark.projectPath !== run.projectPath) {
+        return this.createErrorResponse("No mark has been set in this run, so there is nothing to count from.", ["editor_run profile with mark: true sets one at the totals it answers with"]);
+      }
+      const added = reading.totals === null ? null : totalsSince(reading.totals, mark.totals);
+      if (added === null) {
+        return this.createErrorResponse("The profile holds less than it did at the mark, so the profiler was started again since, and what it holds now cannot be counted from the mark.", ["editor_run profile with mark: true sets a mark in the profile as it is now"]);
+      }
+      shown = {
+        ...reading,
+        totals: added.totals,
+        coveredMs: Math.max(0, reading.coveredMs - mark.coveredMs)
+      };
+      const ago = now - mark.takenAt;
+      sinceFields = {
+        since: "mark",
+        markSetMsAgo: ago,
+        ...added.shrunk > 0 ? { lessThanAtMark: added.shrunk } : {}
+      };
+      lead.push(`Counted from the mark set ${ago}ms ago: each function's calls and milliseconds are what it added after the mark, frames and coveredMs are those since it, and a function that added no call is left out.`);
+      if (added.shrunk > 0) {
+        const one = added.shrunk === 1;
+        lead.push(`${one ? "One function reads" : `${added.shrunk} functions read`} less than at the mark and ${one ? "is" : "are"} left out, counted under lessThanAtMark: the engine's own totals arrived after the mark and replaced the frames' sum, and capped totals leave out the functions with the least time.`);
+      }
+    }
+    if (asked.mark) {
+      if (reading.totals === null) {
+        return this.createErrorResponse("There is nothing to mark yet: the game has not connected to the profiler.", ["Ask again in a moment, once the game is up"]);
+      }
+      const mark = {
+        takenAt: now,
+        projectPath: run.projectPath,
+        runStartedAt: run.startedAt,
+        coveredMs: reading.coveredMs,
+        totals: reading.totals
+      };
+      if (!writeProfileMark(markPath, mark)) {
+        return this.createErrorResponse(`The mark could not be written to ${markPath}, so none is set.`);
+      }
+      lead.push(asked.since ? 'The mark is moved to the totals as they are now, so the next since: "mark" counts from here.' : 'The mark is set at these totals: editor_run profile with since: "mark" answers only what is added after it.');
+    }
+    const answer = profileAnswer(shown, limit);
+    const note = [...lead, ...typeof answer["note"] === "string" ? [answer["note"]] : []].join(" ");
+    return this.jsonTextResponse({
+      ...answer,
+      ...sinceFields,
+      ...asked.mark ? { marked: true } : {},
+      note: note === "" ? undefined : note
+    });
   }
   async firstProfiledFrame() {
     const deadline = Date.now() + PROFILER_ON_MS;
@@ -43079,7 +43305,7 @@ class GodotServer {
       notes.push(endedWithoutACode({
         throughEditor: run.throughEditor,
         announced: announced !== undefined || run.announcedPid !== undefined,
-        couldAnnounce: run.projectPath !== null && existsSync20(join26(run.projectPath, RUNTIME_AUTOLOAD.path)),
+        couldAnnounce: run.projectPath !== null && existsSync21(join27(run.projectPath, RUNTIME_AUTOLOAD.path)),
         endedHere: typeof run.endedHere === "string",
         pickedUp: run.pickedUp === true
       }));
@@ -43709,7 +43935,7 @@ class GodotServer {
     if (!scriptPath.ok) {
       return this.createErrorResponse(scriptPath.reason);
     }
-    if (!existsSync20(scriptPath.absolutePath)) {
+    if (!existsSync21(scriptPath.absolutePath)) {
       return this.createErrorResponse(`Script file does not exist: ${scriptPath.absolutePath}`);
     }
     const asked = readNonEmptyString(args, "newScriptPath");
@@ -44291,7 +44517,7 @@ class GodotServer {
   async ownRunOnItsWay(projectPath, budgetMs) {
     const run = await this.currentRun();
     const project = projectPath ?? run?.projectPath ?? null;
-    if (run === null || project === null || run.announcedPid !== undefined || run.projectPath !== null && !isSameDirectory(run.projectPath, project) || !existsSync20(join26(project, RUNTIME_AUTOLOAD.path)) || !await this.runStillGoing(run)) {
+    if (run === null || project === null || run.announcedPid !== undefined || run.projectPath !== null && !isSameDirectory(run.projectPath, project) || !existsSync21(join27(project, RUNTIME_AUTOLOAD.path)) || !await this.runStillGoing(run)) {
       return null;
     }
     const already = runtimesAnnounced().running;
@@ -44300,7 +44526,7 @@ class GodotServer {
         return !run.announcedBefore.has(one.pid);
       }
       try {
-        return statSync12(one.file).mtimeMs >= run.startedAt;
+        return statSync13(one.file).mtimeMs >= run.startedAt;
       } catch {
         return false;
       }
@@ -44381,7 +44607,7 @@ class GodotServer {
       }
     }
     const screenshotDir = expectsScreenshot ? scratchDirectory("runtime-screenshot") : null;
-    const screenshotPath = screenshotDir ? join26(screenshotDir, "capture.png") : null;
+    const screenshotPath = screenshotDir ? join27(screenshotDir, "capture.png") : null;
     const staleNote = this.runtimeStaleNote(choice.endpoint);
     const stale = staleNote === undefined ? {} : { addonIsStale: true, staleNote };
     const refused = (message) => this.createErrorResponse(staleNote === undefined ? message : `${message}