gdharness 0.13.1 → 0.13.3

package/build/cli.js

@@ -7493,7 +7493,7 @@ var init_server_version = __esm(() => {
 });
 
 // src/class-cache.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync as statSync2 } from "node:fs";
 import { join as join6 } from "node:path";
 function declaredClasses(projectPath) {
   const declared = new Map;
@@ -7531,6 +7531,14 @@ function cachedClasses(projectPath) {
   }
   return listed;
 }
+function cacheWrittenAt(projectPath) {
+  const cache = join6(projectPath, ".godot", "global_script_class_cache.cfg");
+  try {
+    return statSync2(cache).mtimeMs;
+  } catch {
+    return null;
+  }
+}
 function staleAgainst(cached, projectPath) {
   return [...declaredClasses(projectPath)].filter(([name, path]) => cached.get(name) !== path).map(([name]) => name);
 }
@@ -14744,9 +14752,17 @@ var init_types = __esm(() => {
 });
 
 // src/paths.ts
+import { realpathSync } from "node:fs";
 import { isAbsolute, relative, resolve, sep } from "node:path";
+function realPathOr(path) {
+  try {
+    return realpathSync.native(path);
+  } catch {
+    return path;
+  }
+}
 function isSameDirectory(onePath, otherPath) {
-  return relative(resolve(onePath), resolve(otherPath)) === "";
+  return relative(realPathOr(resolve(onePath)), realPathOr(resolve(otherPath))) === "";
 }
 function isWithinRoot(rootPath, candidatePath) {
   const step = relative(resolve(rootPath), resolve(candidatePath));
@@ -15127,8 +15143,16 @@ function buildToolDefinitions() {
     };
   });
 }
-var PROJECT_PATH, RUNNING_PROJECT_PATH, SCENE_PATH, SCRIPT_PATH, RESOURCE_PATH, NODE_PATH, PROPERTIES, XY, ANIMATION_TRACK, SCRIPT_MODIFICATIONS, INPUT_EVENTS, TILESET_SOURCES, TILEMAP_CELLS, COLOUR, TOOL_SPECS, SPECS_BY_NAME;
+var PROJECT_INFO_SECTIONS, PROJECT_PATH, RUNNING_PROJECT_PATH, SCENE_PATH, SCRIPT_PATH, RESOURCE_PATH, NODE_PATH, PROPERTIES, XY, ANIMATION_TRACK, SCRIPT_MODIFICATIONS, INPUT_EVENTS, TILESET_SOURCES, TILEMAP_CELLS, COLOUR, TOOL_SPECS, SPECS_BY_NAME;
 var init_tool_definitions = __esm(() => {
+  PROJECT_INFO_SECTIONS = [
+    "autoloads",
+    "plugins",
+    "export_presets",
+    "audio_buses",
+    "health",
+    "validation"
+  ];
   PROJECT_PATH = {
     type: "string",
     description: "Absolute path to the project directory, the one holding project.godot."
@@ -15155,7 +15179,7 @@ var init_tool_definitions = __esm(() => {
   };
   PROPERTIES = {
     type: "object",
-    description: 'Properties to set, keyed by Godot property name. Vectors, colours and the like may be written as {"x": 1, "y": 2} or tagged {"_type": "Vector2", "x": 1, "y": 2}.',
+    description: 'Properties to set, keyed by Godot property name. Vectors, colours and the like may be written as {"x": 1, "y": 2} or tagged {"_type": "Vector2", "x": 1, "y": 2}, which is the form a read answers with, so a value read off one node can be written straight to another.',
     additionalProperties: true
   };
   XY = {
@@ -15278,10 +15302,7 @@ var init_tool_definitions = __esm(() => {
         projectPath: PROJECT_PATH,
         include: {
           type: "array",
-          items: {
-            type: "string",
-            enum: ["autoloads", "plugins", "export_presets", "audio_buses", "health", "validation"]
-          },
+          items: { type: "string", enum: PROJECT_INFO_SECTIONS },
           description: "Extra sections: registered autoloads, addons and whether each is enabled, export presets, the audio bus layout, a health report, or export validation."
         },
         preset: { type: "string", description: "For validation: the export preset to validate against." },
@@ -15299,6 +15320,12 @@ var init_tool_definitions = __esm(() => {
       parameters: {
         projectPath: PROJECT_PATH,
         setting: { type: "string", description: 'Setting path, such as "display/window/size/viewport_width".' },
+        from: {
+          type: "string",
+          enum: ["disk", "editor"],
+          ops: ["get"],
+          description: "get: where to read. Default disk, which starts a short-lived engine and reads project.godot, needs no editor and is what an automatic check can reproduce. editor asks the open editor instead, which costs no engine and answers what the editor holds, including changes nobody has saved. Asking for editor with none connected is refused rather than answered from disk, so an answer never means the other one quietly."
+        },
         prefix: {
           type: "string",
           ops: ["get"],
@@ -16151,7 +16178,7 @@ var init_tool_definitions = __esm(() => {
 });
 
 // src/headless-operations.ts
-var HEADLESS_OPERATIONS;
+var HEADLESS_OPERATIONS, EDITOR_READS;
 var init_headless_operations = __esm(() => {
   HEADLESS_OPERATIONS = dictionary({
     project_settings: dictionary({
@@ -16185,6 +16212,9 @@ var init_headless_operations = __esm(() => {
       inheritance: "inspect_inheritance"
     })
   });
+  EDITOR_READS = dictionary({
+    project_settings: dictionary({ get: "get_project_setting" })
+  });
 });
 
 // node_modules/zod/v3/helpers/util.js
@@ -30955,6 +30985,36 @@ var init_bridge_announce = __esm(() => {
   init_errors();
 });
 
+// src/config-pin.ts
+import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
+import { join as join12 } from "node:path";
+function versionsNamedInConfig(projectPath) {
+  const config = join12(projectPath, ".mcp.json");
+  if (!existsSync9(config)) {
+    return [];
+  }
+  let text;
+  try {
+    text = readFileSync10(config, "utf8");
+    JSON.parse(text);
+  } catch {
+    return [];
+  }
+  return [...new Set([...text.matchAll(PINNED)].map((found) => found[1] ?? ""))].filter((version) => version !== "");
+}
+function configDisagrees(projectPath, serverVersion) {
+  const named = versionsNamedInConfig(projectPath);
+  const others = named.filter((version) => version !== serverVersion);
+  if (others.length === 0) {
+    return null;
+  }
+  return `.mcp.json in this project names gdharness@${others.join(" and gdharness@")}, and this server ` + `is ${serverVersion}. Whichever is meant to be right, nothing will change version until the ` + "MCP server is reconnected, and a pin kept anywhere else does not reach this file.";
+}
+var PINNED;
+var init_config_pin = __esm(() => {
+  PINNED = /\bgdharness@(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\b/g;
+});
+
 // src/framing.ts
 function frame(message) {
   const body = Buffer.from(JSON.stringify(message), "utf8");
@@ -34932,7 +34992,7 @@ var init_godot_bridge = __esm(() => {
 
 // src/godot-path.ts
 import { execFile as execFile4 } from "node:child_process";
-import { existsSync as existsSync9 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 import { normalize as normalize2 } from "node:path";
 import { promisify as promisify4 } from "node:util";
 var run4, GodotLocator2;
@@ -34974,7 +35034,7 @@ var init_godot_path = __esm(() => {
         return known;
       }
       let ok = false;
-      if (path === "godot" || existsSync9(path)) {
+      if (path === "godot" || existsSync10(path)) {
         try {
           await run4(path, ["--version"]);
           ok = true;
@@ -35319,7 +35379,7 @@ var init_junit = __esm(() => {
 });
 
 // src/lsp_client.ts
-import { realpathSync } from "node:fs";
+import { realpathSync as realpathSync2 } from "node:fs";
 import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection2 } from "node:net";
 import { dirname as dirname7, resolve as resolve3 } from "node:path";
@@ -35335,7 +35395,7 @@ function diagnosticsKey(uri) {
     return decoded;
   }
   try {
-    return realpathSync.native(fileURLToPath3(decoded)).toLowerCase();
+    return realpathSync2.native(fileURLToPath3(decoded)).toLowerCase();
   } catch {
     return decoded.toLowerCase();
   }
@@ -35895,13 +35955,13 @@ var init_process_time = __esm(() => {
 });
 
 // src/project-scan.ts
-import { existsSync as existsSync10, readdirSync as readdirSync4, readFileSync as readFileSync10 } from "node:fs";
-import { join as join12 } from "node:path";
+import { existsSync as existsSync11, readdirSync as readdirSync4, readFileSync as readFileSync11 } from "node:fs";
+import { join as join13 } from "node:path";
 function skipped(name) {
   return name.startsWith(".") || SKIPPED.has(name);
 }
 function steppedOver(directory) {
-  return existsSync10(join12(directory, ".gdignore"));
+  return existsSync11(join13(directory, ".gdignore"));
 }
 function projectStructure(projectPath) {
   const structure = { scenes: 0, scripts: 0, assets: 0, other: 0 };
@@ -35914,7 +35974,7 @@ function projectStructure(projectPath) {
         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 (extension === "tscn") {
@@ -35959,7 +36019,7 @@ function searchProject(projectPath, options) {
       if (skipped(entry.name)) {
         continue;
       }
-      const entryPath = join12(directory, entry.name);
+      const entryPath = join13(directory, entry.name);
       if (entry.isDirectory()) {
         visit(entryPath);
         continue;
@@ -35970,7 +36030,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync10(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync11(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -35998,10 +36058,10 @@ var init_project_scan = __esm(() => {
 });
 
 // src/runtime-client.ts
-import { existsSync as existsSync11, readdirSync as readdirSync5, readFileSync as readFileSync11, unlinkSync } from "node:fs";
+import { existsSync as existsSync12, readdirSync as readdirSync5, readFileSync as readFileSync12, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join13, resolve as resolve4 } from "node:path";
+import { join as join14, resolve as resolve4 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 function runtimeDirectory(variables = process.env) {
   const explicit = envValue("GDHARNESS_RUNTIME_DIR", variables);
@@ -36009,13 +36069,13 @@ function runtimeDirectory(variables = process.env) {
     return explicit;
   }
   const perUser = envValue("XDG_RUNTIME_DIR", variables);
-  return join13(perUser ?? tmpdir4(), "gdharness");
+  return join14(perUser ?? tmpdir4(), "gdharness");
 }
 function runtimeDirectories(variables = process.env) {
   const candidates = [runtimeDirectory(variables)];
   const fallbacks = process.platform === "win32" ? [envValue("SystemRoot", variables) ?? envValue("windir", variables) ?? "C:\\Windows"] : ["/tmp", "/var/tmp"];
   for (const base of fallbacks) {
-    candidates.push(join13(base, process.platform === "win32" ? "Temp" : "", "gdharness"));
+    candidates.push(join14(base, process.platform === "win32" ? "Temp" : "", "gdharness"));
   }
   return [...new Set(candidates.map((path) => resolve4(path)))];
 }
@@ -36030,7 +36090,7 @@ function processAlive(pid) {
 function parseAnnouncement(file, pid) {
   let fields;
   try {
-    fields = asParams(JSON.parse(readFileSync11(file, "utf8")));
+    fields = asParams(JSON.parse(readFileSync12(file, "utf8")));
   } catch {
     return { kind: "rubbish" };
   }
@@ -36069,7 +36129,7 @@ function discoverRuntimes(directories = runtimeDirectories()) {
   return runtimesAnnounced(directories).running;
 }
 function announcedIn(directory) {
-  if (!existsSync11(directory)) {
+  if (!existsSync12(directory)) {
     return [];
   }
   const found = [];
@@ -36078,7 +36138,7 @@ function announcedIn(directory) {
     if (!match) {
       continue;
     }
-    const file = join13(directory, entry);
+    const file = join14(directory, entry);
     const pid = Number.parseInt(match[1] ?? "", 10);
     const announced = processAlive(pid) ? parseAnnouncement(file, pid) : { kind: "rubbish" };
     if (announced.kind === "rubbish") {
@@ -36240,20 +36300,20 @@ var init_runtime_client = __esm(() => {
 
 // src/run-record.ts
 import { execFileSync } from "node:child_process";
-import { mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync6, readFileSync as readFileSync12, rmSync as rmSync7, statSync as statSync2, writeFileSync as writeFileSync8 } from "node:fs";
-import { basename as basename2, join as join14 } from "node:path";
+import { mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync6, readFileSync as readFileSync13, rmSync as rmSync7, statSync as statSync3, writeFileSync as writeFileSync8 } from "node:fs";
+import { basename as basename2, join as join15 } from "node:path";
 function runsDirectory() {
-  return join14(runtimeDirectory(), "runs");
+  return join15(runtimeDirectory(), "runs");
 }
 function recordPath() {
-  return join14(runsDirectory(), "run.json");
+  return join15(runsDirectory(), "run.json");
 }
 function recordPaths() {
-  return runtimeDirectories().map((directory) => join14(directory, "runs", "run.json"));
+  return runtimeDirectories().map((directory) => join15(directory, "runs", "run.json"));
 }
 function openTranscript(startedAt) {
   mkdirSync6(runsDirectory(), { recursive: true });
-  const path = join14(runsDirectory(), `run-${startedAt}.log`);
+  const path = join15(runsDirectory(), `run-${startedAt}.log`);
   return { path, fd: openSync(path, "a") };
 }
 function writeRunRecord(record) {
@@ -36282,7 +36342,7 @@ function readRunRecord() {
 function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync12(path, "utf8"));
+    parsed = JSON.parse(readFileSync13(path, "utf8"));
   } catch {
     return null;
   }
@@ -36318,7 +36378,7 @@ function runningAs(pid) {
   }
   try {
     if (process.platform === "linux") {
-      const raw = readFileSync12(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
+      const raw = readFileSync13(`/proc/${pid}/cmdline`, "utf8").replaceAll("\x00", " ").trim();
       return raw === "" ? null : { kind: "commandLine", text: raw };
     }
     const args = execFileSync("ps", ["-p", String(pid), "-o", "args="], {
@@ -36393,7 +36453,7 @@ function clearRunRecord(ours = () => true) {
 }
 function ageMs(path, now) {
   try {
-    return now - statSync2(path).mtimeMs;
+    return now - statSync3(path).mtimeMs;
   } catch {
     return 0;
   }
@@ -36411,7 +36471,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
     if (!entry.startsWith("run-") || !entry.endsWith(".log")) {
       continue;
     }
-    const path = join14(directory, entry);
+    const path = join15(directory, entry);
     if (path === keep || ageMs(path, now) < keepMs) {
       continue;
     }
@@ -36425,14 +36485,14 @@ var init_run_record = __esm(() => {
 });
 
 // src/setup.ts
-import { cpSync as cpSync2, existsSync as existsSync12, mkdirSync as mkdirSync7, readFileSync as readFileSync13, rmSync as rmSync8, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname8, join as join15 } from "node:path";
+import { cpSync as cpSync2, existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync14, rmSync as rmSync8, writeFileSync as writeFileSync9 } from "node:fs";
+import { dirname as dirname8, join as join16 } from "node:path";
 function installedAddonVersion(projectPath) {
-  const marker = join15(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
-  if (!existsSync12(marker)) {
+  const marker = join16(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
+  if (!existsSync13(marker)) {
     return null;
   }
-  const said = readFileSync13(marker, "utf8").trim();
+  const said = readFileSync14(marker, "utf8").trim();
   return said === "" ? null : said;
 }
 var ADDONS2, RUNTIME_AUTOLOAD2, VERSION_MARKER2 = ".gdharness-version";
@@ -36453,19 +36513,18 @@ import { execFile as execFile6, spawn } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import {
   closeSync,
-  existsSync as existsSync13,
+  existsSync as existsSync14,
   fstatSync,
   mkdirSync as mkdirSync8,
   mkdtempSync as mkdtempSync3,
   openSync as openSync2,
   readdirSync as readdirSync7,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   readSync,
-  realpathSync as realpathSync2,
   rmSync as rmSync9
 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { basename as basename3, dirname as dirname9, join as join16, normalize as normalize3 } from "node:path";
+import { basename as basename3, dirname as dirname9, join as join17, normalize as normalize3 } from "node:path";
 import { setTimeout as delay3 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { promisify as promisify6 } from "node:util";
@@ -36563,6 +36622,30 @@ function wrongTypes(spec, args) {
   }
   return complaints;
 }
+function unlistedValues(schema, value, path) {
+  if (typeof schema !== "object" || schema === null) {
+    return [];
+  }
+  const fields = schema;
+  const listed = fields["enum"];
+  if (Array.isArray(listed) && typeof value === "string") {
+    return listed.includes(value) ? [] : [`${path} as one of ${listed.join(", ")}, not ${JSON.stringify(value)}`];
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap((element, index) => unlistedValues(fields["items"], element, `${path}[${index}]`));
+  }
+  const properties = fields["properties"];
+  if (isPlainObject3(properties) && isPlainObject3(value)) {
+    return Object.entries(value).flatMap(([field, held]) => Object.hasOwn(properties, field) ? unlistedValues(properties[field], held, `${path}.${field}`) : []);
+  }
+  return [];
+}
+function isPlainObject3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function outsideTheirLists(spec, args) {
+  return Object.entries(args).flatMap(([name, value]) => unlistedValues(spec.parameters[name], value, name));
+}
 function escapingPropertyValue(properties) {
   if (typeof properties !== "object" || properties === null) {
     return;
@@ -36577,17 +36660,6 @@ function escapingPropertyValue(properties) {
   }
   return;
 }
-function realPathOr(path) {
-  try {
-    return realpathSync2.native(path);
-  } catch {
-    return path;
-  }
-}
-function samePath(one, other) {
-  const settled = (path) => realPathOr(path).replaceAll("\\", "/").replace(/\/+$/, "").toLowerCase();
-  return settled(one) === settled(other);
-}
 function aboveTheRunner(entry) {
   const runner = entry.detail.findIndex((line) => line.includes(RUNNER_DIRECTORY));
   if (runner < 0) {
@@ -36601,7 +36673,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync13(join16(projectPath, wanted))) {
+  if (wanted === "" || existsSync14(join17(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -36615,11 +36687,11 @@ function elsewhereIn(projectPath, asked) {
   return near.length === 0 ? "" : ` The project does have ${there}.`;
 }
 function hasMainScene(projectFile) {
-  const scene = parseProjectGodot(readFileSync14(projectFile, "utf8"))["application"]?.["run/main_scene"];
+  const scene = parseProjectGodot(readFileSync15(projectFile, "utf8"))["application"]?.["run/main_scene"];
   return typeof scene === "string" && scene !== "";
 }
 function editorPlaysHeadless(projectFile) {
-  const runArgs = parseProjectGodot(readFileSync14(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
+  const runArgs = parseProjectGodot(readFileSync15(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
   return typeof runArgs === "string" && /(?:^|\s)--headless(?:\s|$)/.test(runArgs);
 }
 function camelCased(params) {
@@ -36635,7 +36707,7 @@ function camelCased(params) {
 class GodotServer {
   mcp;
   locator = new GodotLocator2;
-  operationsScript = join16(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join17(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -36909,6 +36981,18 @@ class GodotServer {
         }
       });
     }
+    const disagreement = this.configDisagreement();
+    if (disagreement !== null) {
+      this.noticedUpdate = true;
+      this.callsSinceNotice = 0;
+      return this.saying(answer, {
+        config_names_another_version: {
+          server_is: SERVER_VERSION,
+          said: disagreement,
+          what_to_do: "Tell the user which version their config names and which one is answering, and that " + "the two will not meet until .mcp.json is right and the MCP server is reconnected. Do " + "not edit their config without asking: which of the two they meant is theirs to say."
+        }
+      });
+    }
     const notice = this.updates.notice();
     if (notice === null) {
       return answer;
@@ -36935,6 +37019,9 @@ class GodotServer {
     const installed = installedAddonVersion(this.ownProject);
     return installed === null || installed === SERVER_VERSION ? null : installed;
   }
+  configDisagreement() {
+    return this.ownProject === null ? null : configDisagrees(this.ownProject, SERVER_VERSION);
+  }
   withFeedbackNotice(answer) {
     this.callsSinceFeedback += 1;
     if (this.callsSinceFeedback < FEEDBACK_NOTICE_EVERY) {
@@ -36950,13 +37037,17 @@ class GodotServer {
     const known = new Set([...Object.keys(spec.parameters), ...spec.operations ? ["op"] : []]);
     const unknown = Object.keys(args).filter((key) => !known.has(key));
     if (unknown.length > 0) {
-      const takes = known.size === 0 ? "It takes no arguments." : `It takes: ${[...known].join(", ")}.`;
+      const asked = readString(args, "op");
+      const named = asked !== undefined && spec.operations?.[asked] !== undefined ? asked : null;
+      const wanted = named === null ? [...known] : [...argumentsOf(spec, named), "op"];
+      const takes = wanted.length === 0 ? "It takes no arguments." : `It takes: ${wanted.join(", ")}.`;
+      const where = named === null ? spec.name : `${spec.name} ${named}`;
       return {
         ok: false,
-        response: this.createErrorResponse(`${spec.name} does not take ${unknown.join(", ")}. ${takes}`)
+        response: this.createErrorResponse(`${where} does not take ${unknown.join(", ")}. ${takes} This is gdharness ${SERVER_VERSION}, which is what decides whether an argument exists.`)
       };
     }
-    const wrong = wrongTypes(spec, args);
+    const wrong = [...wrongTypes(spec, args), ...outsideTheirLists(spec, args)];
     if (wrong.length > 0) {
       return { ok: false, response: this.createErrorResponse(`${spec.name} takes ${wrong.join("; ")}.`) };
     }
@@ -37008,7 +37099,25 @@ class GodotServer {
   async dispatch(tool, op, args) {
     const headless = HEADLESS_OPERATIONS[tool]?.[op];
     if (headless !== undefined) {
-      const answered = await this.headless(headless, args);
+      const { from: asked, ...answerable } = args;
+      if (asked === "editor") {
+        const editorSide = EDITOR_READS[tool]?.[op];
+        if (editorSide === undefined) {
+          return this.createErrorResponse(`${tool} ${op} cannot be read from the editor, only from disk.`, [
+            'Leave from unset, or pass from: "disk"'
+          ]);
+        }
+        if (!this.godotBridge.isConnected()) {
+          return this.createErrorResponse(`${tool} ${op} was asked of the editor, and no editor has reached this server.`, [
+            "editor_status says whether the bridge is up and whether an editor may yet connect",
+            'Open the project with editor_launch, or pass from: "disk" to read the file instead'
+          ]);
+        }
+        const { op: _dropped, ...asks } = answerable;
+        const contained = this.containProjectFiles(asks);
+        return contained.ok ? await this.handleViaBridge(editorSide, contained.value) : contained.response;
+      }
+      const answered = await this.headless(headless, answerable);
       return headless === "refresh_class_cache" && this.godotBridge.isConnected() ? await this.alsoSayWhatTheEditorCannotSee(answered, args) : answered;
     }
     const { op: _op, ...arguments_ } = args;
@@ -37223,8 +37332,8 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join16(path, "project.godot");
-    if (!existsSync13(file)) {
+    const file = join17(path, "project.godot");
+    if (!existsSync14(file)) {
       return {
         ok: false,
         response: this.createErrorResponse(`Not a Godot project: ${path}`, [
@@ -37381,9 +37490,9 @@ class GodotServer {
   }
   async handleProjectInfo(args) {
     const include = readStringArray(args, "include") ?? [];
-    const unknown = include.filter((name) => PROJECT_INFO_SECTIONS[name] === undefined);
+    const unknown = include.filter((name) => PROJECT_INFO_SECTIONS2[name] === undefined);
     if (unknown.length > 0) {
-      return this.createErrorResponse(`project_info cannot include ${unknown.join(", ")}. Sections: ${Object.keys(PROJECT_INFO_SECTIONS).join(", ")}.`);
+      return this.createErrorResponse(`project_info cannot include ${unknown.join(", ")}. Sections: ${Object.keys(PROJECT_INFO_SECTIONS2).join(", ")}.`);
     }
     const project = this.project(args);
     if (!project.ok) {
@@ -37393,7 +37502,7 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const application = parseProjectGodot(readFileSync14(project.value.file, "utf8"))["application"] ?? {};
+    const application = parseProjectGodot(readFileSync15(project.value.file, "utf8"))["application"] ?? {};
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
@@ -37405,7 +37514,7 @@ class GodotServer {
     };
     const detailed = args["detail"] === "full";
     for (const section of include) {
-      const spec = PROJECT_INFO_SECTIONS[section];
+      const spec = PROJECT_INFO_SECTIONS2[section];
       if (spec === undefined) {
         continue;
       }
@@ -37461,11 +37570,11 @@ class GodotServer {
       return this.createErrorResponse(`Cannot create ${dirname9(output.relativePath)} to export into: ${errorMessage(error)}`);
     }
     const debug = readBoolean(args, "debug") ?? false;
-    const exportLogs = mkdtempSync3(join16(tmpdir5(), "gdharness-export-"));
+    const exportLogs = mkdtempSync3(join17(tmpdir5(), "gdharness-export-"));
     const exportArgs = [
       "--headless",
       "--log-file",
-      join16(exportLogs, "engine.log"),
+      join17(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -37493,7 +37602,7 @@ class GodotServer {
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
     const verdict = {
-      exported: exitCode === 0 && log.count("error") === 0 && existsSync13(output.absolutePath),
+      exported: exitCode === 0 && log.count("error") === 0 && existsSync14(output.absolutePath),
       preset,
       outputPath: output.relativePath,
       debug,
@@ -37523,7 +37632,7 @@ class GodotServer {
       return contained.response;
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync13(join16(project.value.path, runner))) {
+    if (!existsSync14(join17(project.value.path, runner))) {
       return this.createErrorResponse(`gdUnit4 is not installed in this project: no ${runner}.`, [
         "Install gdUnit4 under addons/gdUnit4, from https://github.com/godot-gdunit-labs/gdUnit4"
       ]);
@@ -37558,7 +37667,7 @@ class GodotServer {
     ];
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 600000;
     this.logDebug(`Running tests: ${engine.value} ${cmdArgs.join(" ")}`);
-    const userData = mkdtempSync3(join16(tmpdir5(), "gdharness-tests-"));
+    const userData = mkdtempSync3(join17(tmpdir5(), "gdharness-tests-"));
     const run = this.spawnGame(engine.value, cmdArgs, userDataIn(userData));
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -37574,14 +37683,14 @@ class GodotServer {
         resolve(false);
       });
     });
-    const reportsDir = join16(project.value.path, ".godot", ...ours.split("/"));
+    const reportsDir = join17(project.value.path, ".godot", ...ours.split("/"));
     let report = null;
     let reportProblem = null;
     try {
-      const written = existsSync13(reportsDir) ? readdirSync7(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
+      const written = existsSync14(reportsDir) ? readdirSync7(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
-        report = parseJUnit(readFileSync14(join16(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync15(join17(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -37693,13 +37802,13 @@ class GodotServer {
       const severity = asParams(entry)["severity"];
       return severity === 1 || severity === "error" || severity === "ERROR";
     }).length;
-    return this.jsonTextResponse({
+    return this.jsonTextResponse(markIfStale({
       scriptPath: readString(args, "scriptPath"),
       clean: errors === 0,
       errors,
       warnings: diagnostics.length - errors,
       diagnostics
-    });
+    }, this.godotBridge.getStatus().addonVersion, SERVER_VERSION));
   }
   async handleLSP(toolName, args) {
     const port = this.editorServes("lspPort", "GDHARNESS_LSP_PORT", DEFAULT_LSP_PORT);
@@ -37744,6 +37853,7 @@ class GodotServer {
       retryingBridge: this.bridgeRetry === null ? undefined : true,
       announcedAt: this.announcedAt ?? undefined,
       projectIs: this.projectHasMovedOn() ?? undefined,
+      configIs: this.configDisagreement() ?? undefined,
       note: isPortConflict ? "Bridge port is already in use. Another gdharness instance owns the editor bridge, so this server cannot reach the editor. Usually the server this one replaced, still on its way out." : undefined,
       suggestion: isPortConflict ? `This server is asking for the port again every ${BRIDGE_RETRY_MS / 1000}s and takes it the moment the other one lets go, so editor tools come back on their own. Ask again, or end the older gdharness process to have it now.` : undefined
     };
@@ -37999,7 +38109,7 @@ class GodotServer {
     return runIsUp(run, editorSays);
   }
   async runtimeUp(projectPath, before, budgetMs) {
-    if (!existsSync13(join16(projectPath, RUNTIME_AUTOLOAD2.path))) {
+    if (!existsSync14(join17(projectPath, RUNTIME_AUTOLOAD2.path))) {
       return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false });
     }
     const endpoint = await announcedSince(projectPath, before, {
@@ -38254,7 +38364,7 @@ class GodotServer {
     if (mine === null) {
       return false;
     }
-    return project !== "" && samePath(mine, project);
+    return project !== "" && isSameDirectory(mine, project);
   }
   currentRun() {
     return this.activeProcess ?? this.adoptRecordedRun();
@@ -38385,6 +38495,11 @@ class GodotServer {
   async handleRescanFilesystem(args) {
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 30000;
     const started = Date.now();
+    const projectPath = typeof args["projectPath"] === "string" ? args["projectPath"] : "";
+    const before = projectPath === "" ? null : cachedClasses(projectPath);
+    const writtenBefore = projectPath === "" ? null : cacheWrittenAt(projectPath);
+    const blind = projectPath === "" ? { unseen: [] } : await this.classesTheEditorCannotSee(args);
+    const atRisk = before === null ? [] : blind.unseen.filter((one) => before.has(one.className));
     const first = await this.handleViaBridge("rescan_filesystem", args);
     if (first.isError) {
       return first;
@@ -38393,17 +38508,27 @@ class GodotServer {
     while (busy && Date.now() - started < timeoutMs) {
       await new Promise((settle) => setTimeout(settle, 100));
       const status = asParams(await this.godotBridge.invokeTool("rescan_filesystem", { ...args, statusOnly: true }));
-      busy = Boolean(status["scanning"]) || Boolean(status["importing"]);
+      const pending = Boolean(status["pending"]) && Date.now() - started < SCAN_START_MS;
+      busy = Boolean(status["scanning"]) || Boolean(status["importing"]) || pending;
+    }
+    if (!busy && atRisk.length > 0) {
+      const until = Date.now() + CACHE_WRITE_MS;
+      while (Date.now() < until && cacheWrittenAt(projectPath) === writtenBefore) {
+        await new Promise((settle) => setTimeout(settle, 100));
+      }
     }
+    const after = projectPath === "" || busy ? null : cachedClasses(projectPath);
+    const lost = before === null || after === null ? [] : [...before.keys()].filter((name) => !after.has(name));
     const checked = busy ? { unseen: [] } : await this.classesTheEditorCannotSee(args);
     const unseen = checked.unseen;
     return this.jsonTextResponse({
-      ok: !busy && unseen.length === 0 && checked.unchecked === undefined,
+      ok: !busy && unseen.length === 0 && lost.length === 0 && checked.unchecked === undefined,
       stillWorking: busy,
       waitedMs: Date.now() - started,
       unseenByEditor: unseen.length > 0 ? unseen : undefined,
+      cacheLost: lost.length > 0 ? lost : undefined,
       classesUnchecked: checked.unchecked,
-      note: busy ? "The editor was still scanning or importing when the wait ran out, so new files may not be visible yet." : unseen.length > 0 ? "The scan finished and these classes are still not in the list the editor resolves against, so every use of them reads as an unknown identifier. Its walk skips a file another engine has already imported. Change the declaring script and rescan, or restart the editor with editor_launch restart." : undefined
+      note: busy ? "The editor was still scanning or importing when the wait ran out, so new files may not be visible yet." : lost.length > 0 ? "The scan wrote the class cache from the list this editor is holding, and that list is shorter than the file was: these classes were in it before the scan and are not now. Every engine that reads the cache next, including a test run, will report them as unknown identifiers in files nobody touched. Run project_import refresh_classes to put them back, and do not rescan again until the editor has been restarted with editor_launch restart, because it will write the same short list over it." : unseen.length > 0 ? "The scan finished and these classes are still not in the list the editor resolves against, so every use of them reads as an unknown identifier. Its walk skips a file another engine has already imported. Change the declaring script and rescan, or restart the editor with editor_launch restart." : undefined
     });
   }
   async alsoSayWhatTheEditorCannotSee(answered, args) {
@@ -38428,7 +38553,7 @@ class GodotServer {
       return { unseen: [], unchecked: "no projectPath, so there was nothing to read the cache from" };
     }
     const open = this.godotBridge.getStatus().projectPath;
-    if (open === undefined || !samePath(open, projectPath)) {
+    if (open === undefined || !isSameDirectory(open, projectPath)) {
       return {
         unseen: [],
         unchecked: `the connected editor is open on ${open ?? "a project it did not name"}, not this one`
@@ -38456,6 +38581,14 @@ class GodotServer {
         "editor_status says whether the bridge is up and what it is listening on"
       ]);
     }
+    const open = this.godotBridge.getStatus().projectPath;
+    const meant = readNonEmptyString(args, "projectPath");
+    if (open !== undefined && open !== "" && meant !== undefined && !isSameDirectory(open, meant)) {
+      return this.createErrorResponse(`This call names ${meant}, and the editor on this bridge has ${open} open.`, [
+        "editor_status names the project this server's editor is showing",
+        "One server serves one editor: start a second server for the other project"
+      ]);
+    }
     try {
       return this.jsonTextResponse(markIfStale(await this.godotBridge.invokeTool(toolName, args), this.godotBridge.getStatus().addonVersion, SERVER_VERSION));
     } catch (error) {
@@ -38474,8 +38607,8 @@ class GodotServer {
       return this.createErrorResponse(choice.problem);
     }
     const expectsScreenshot = command === "capture_screenshot" || command === "capture_viewport";
-    const screenshotDir = expectsScreenshot ? mkdtempSync3(join16(tmpdir5(), "gdharness-runtime-screenshot-")) : null;
-    const screenshotPath = screenshotDir ? join16(screenshotDir, "capture.png") : null;
+    const screenshotDir = expectsScreenshot ? mkdtempSync3(join17(tmpdir5(), "gdharness-runtime-screenshot-")) : null;
+    const screenshotPath = screenshotDir ? join17(screenshotDir, "capture.png") : null;
     try {
       const reply = await runtimeRequest(choice.endpoint, command, screenshotPath ? { ...params, output_path: screenshotPath } : params, timeoutMs);
       if (!reply.ok) {
@@ -38496,7 +38629,7 @@ class GodotServer {
       return {
         content: [
           { type: "text", text: `Screenshot captured: ${dimensions}` },
-          { type: "image", data: readFileSync14(screenshotPath).toString("base64"), mimeType: "image/png" }
+          { type: "image", data: readFileSync15(screenshotPath).toString("base64"), mimeType: "image/png" }
         ]
       };
     } finally {
@@ -38564,13 +38697,14 @@ async function runGodotServer() {
   const server = new GodotServer;
   await server.run();
 }
-var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run6, __dirname2, EDITOR_RESTART_TIMEOUT_MS = 90000, SLOWEST_FRAME_RATE = 20, VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, WAIT_FOR_RUN_MS = 600000, RUN_POLL_MS = 250, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, PROJECT_INFO_SECTIONS, RUNNER_DIRECTORY = "addons/gdUnit4/";
+var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run6, __dirname2, EDITOR_RESTART_TIMEOUT_MS = 90000, SLOWEST_FRAME_RATE = 20, VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, CACHE_WRITE_MS = 2000, SCAN_START_MS = 2000, WAIT_FOR_RUN_MS = 600000, RUN_POLL_MS = 250, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, PROJECT_INFO_SECTIONS2, RUNNER_DIRECTORY = "addons/gdUnit4/";
 var init_server3 = __esm(() => {
   init_mcp();
   init_stdio2();
   init_types();
   init_bridge_announce();
   init_class_cache();
+  init_config_pin();
   init_dap_client();
   init_errors();
   init_game_log();
@@ -38617,7 +38751,7 @@ var init_server3 = __esm(() => {
     output: "dap_get_output",
     variables: "dap_get_variables"
   });
-  PROJECT_INFO_SECTIONS = dictionary({
+  PROJECT_INFO_SECTIONS2 = dictionary({
     autoloads: { operation: "list_autoloads", params: () => ({}) },
     plugins: { operation: "list_plugins", params: () => ({}) },
     export_presets: { operation: "list_export_presets", params: () => ({}) },
@@ -38631,8 +38765,8 @@ var init_server3 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync14 } from "fs";
-import { join as join17, resolve as resolve5 } from "path";
+import { existsSync as existsSync15 } from "fs";
+import { join as join18, resolve as resolve5 } from "path";
 
 // src/errors.ts
 class Refusal extends Error {
@@ -39969,6 +40103,11 @@ function headlessSection() {
     "",
     "Everything else needs the editor (`editor_*`, `debug_*`, `scene_*`, `resource_*`) or a running",
     "game (`runtime_*`).",
+    "",
+    'One of these can be pointed the other way: `project_settings get` takes `from: "editor"` to ask',
+    "the open editor instead of the file, which is a different reading and costs no engine start. A",
+    "gate leaves it alone, because there is no editor on a build machine and the call is refused",
+    "rather than answered from the file.",
     ""
   ];
 }
@@ -40237,7 +40376,7 @@ class UsageError extends Refusal {
 function projectArgument(at) {
   const named = args.slice(at).find((value) => !value.startsWith("--"));
   const projectPath = resolve5(named ?? ".");
-  if (!existsSync14(join17(projectPath, "project.godot"))) {
+  if (!existsSync15(join18(projectPath, "project.godot"))) {
     throw new UsageError(`Not a Godot project: ${projectPath} holds no project.godot.`);
   }
   return projectPath;
@@ -40271,7 +40410,7 @@ async function registerRuntime(godot, projectPath) {
     return;
   }
   console.log(`${RUNTIME_AUTOLOAD.name} autoload left at ${named}, which this project registers itself`);
-  if (!existsSync14(join17(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
+  if (!existsSync15(join18(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
     console.log(`  that file is not in this project, so it boots with a missing script: restore it, or point the entry at res://${RUNTIME_AUTOLOAD.path}`);
   }
 }
@@ -40403,7 +40542,7 @@ async function setup() {
       console.log("no harness configured; name one yourself, and gdharness harnesses lists them all");
     }
     if (!args.includes("--no-skill")) {
-      const directories = skillDirectories(chosen.harnesses, projectPath, existsSync14);
+      const directories = skillDirectories(chosen.harnesses, projectPath, existsSync15);
       for (const written of writeSkill(directories, getLocalVersion())) {
         console.log(`skill: ${written.replaced ? "replaced" : "written"} ${written.path}`);
       }
@@ -40492,7 +40631,7 @@ async function upgrade() {
   if (already.length === 0) {
     console.log("no harness config names gdharness, so none was re-pinned");
   }
-  for (const written of writeSkill(skillDirectories(already, projectPath, existsSync14), version)) {
+  for (const written of writeSkill(skillDirectories(already, projectPath, existsSync15), version)) {
     console.log(`skill: ${written.replaced ? "replaced" : "written"} ${written.path}`);
   }
   console.log(`