gdharness 1.1.46 → 1.1.47

package/build/cli.js

@@ -17588,7 +17588,7 @@ var init_tool_definitions = __esm(() => {
     },
     {
       name: "project_test",
-      description: "Runs the project's gdUnit4 tests headless and answers with every case that did not pass: where it is, and what the assertion said. Suites where everything passed are counted rather than listed, and an engine message keeps the frames above gdUnit4 rather than the twenty inside it, so a clean tier answers in a few lines. The class list is rebuilt first, so a suite written a moment ago is found, and the rebuild's answer is under classes, with the classes each addon declares counted under addedInAddons and changedInAddons rather than named: a class it puts back that the cache had after the last rebuild is named under classes.lostSinceLastRebuild, which is the editor writing its shorter list over the file on every save until restarted. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. On macOS the engine reads user:// off HOME and the run writes where the player keeps theirs, which the answer says under savesNote rather than leaving to be found in a save list. A run that found nothing to run is never called a pass: gdUnit4 exits cleanly for one, so the answer says so and names the path it looked in. A script that does not load stops gdUnit4 before any suite runs: its errors come back in full under scriptErrors, and the scripts that failed only because one they depend on did are listed by path under failedThroughDependency. A run where nothing failed but nodes were left in the tree comes back under warnings, with the count per suite: gdUnit4 decides its verdict on those and keeps them out of its report, so they are read off what it printed. Needs gdUnit4 under addons/gdUnit4.",
+      description: "Runs the project's gdUnit4 tests headless and answers with every case that did not pass: where it is, and what the assertion said. Suites where everything passed are counted rather than listed, and an engine message keeps the frames above gdUnit4 rather than the twenty inside it, so a clean tier answers in a few lines. The class list is rebuilt first, so a suite written a moment ago is found, and the rebuild's answer is under classes, with the classes each addon declares counted under addedInAddons and changedInAddons rather than named: a class it puts back that the cache had after the last rebuild is named under classes.lostSinceLastRebuild, which is the editor writing its shorter list over the file on every save until restarted. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. On macOS the engine reads user:// off HOME and the run writes where the player keeps theirs, which the answer says under savesNote rather than leaving to be found in a save list. A run that found nothing to run is never called a pass: gdUnit4 exits cleanly for one, so the answer says so and names the path it looked in. A script that does not load stops gdUnit4 before any suite runs: its errors come back in full under scriptErrors, and the scripts that failed only because one they depend on did are listed by path under failedThroughDependency. When they failed on a class whose own script has a parser error, which gdUnit4 never names, that script is checked by the engine and its error comes first under scriptErrors, with the class it declares under declares. A run where nothing failed but nodes were left in the tree comes back under warnings, with the count per suite: gdUnit4 decides its verdict on those and keeps them out of its report, so they are read off what it printed. Needs gdUnit4 under addons/gdUnit4.",
       parameters: {
         projectPath: PROJECT_PATH,
         path: {
@@ -18158,7 +18158,7 @@ var init_tool_definitions = __esm(() => {
         says: {
           type: "string",
           ops: ["find"],
-          description: 'find: part of what the node has written on it as drawn, the way the text op reads it, case-insensitively, which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern, and a glob that finds nothing says under note how many nodes it would find open at both ends. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Alternatives separated by | match when any one of them does, each by these rules ("*won*|*lost*"); write \\| for a bar that is part of the words.'
+          description: 'find: part of what the node has written on it as drawn, the way the text op reads it, case-insensitively and with a typed space matching any space the game draws (a non-breaking one included), which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern, and a glob that finds nothing says under note how many nodes it would find open at both ends. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Alternatives separated by | match when any one of them does, each by these rules ("*won*|*lost*"); write \\| for a bar that is part of the words.'
         },
         limit: {
           type: "integer",
@@ -18336,7 +18336,7 @@ var init_tool_definitions = __esm(() => {
         says: {
           type: "string",
           ops: ["click"],
-          description: "click: the words on the control to click, matched the way runtime_inspect find matches says (a plain word is contained in the text, a pattern with * or ? is a glob over it, and | separates alternatives), among the controls on screen, and pressed in the same frame it was found in, so a panel rebuilding between a find and a click cannot free it first. Words on a label inside a button press the button. A control with something drawn over its centre that would take the pointer, such as a screen shown over it or a dialog stacked above its own, is not on screen; nor is one on a hidden canvas layer, one outside the viewport, or one a container clips away that a click does not scroll. The refusal counts those apart. The matches are ranked the way a person picks what to press: an enabled button before anything else, a disabled one included, then a control whose whole text, or one whole line of it such as the title on a card, is the words before one saying them as part of more, and the best one is pressed; found.picked says why. Several matches at the best rank are refused with each one listed, and index picks one. A match saying the words only as part of more is named under found.partOf, and is refused when a control saying exactly the words is hidden, off the screen or covered, since it would stand in for that one; index presses it anyway. An empty field says its placeholder. An item of an open menu is drawn by the menu rather than held as a control, so a click finds none, and the refusal names the menu and the choose call that picks it."
+          description: "click: the words on the control to click, matched the way runtime_inspect find matches says (a plain word is contained in the text, a pattern with * or ? is a glob over it, and | separates alternatives), among the controls on screen, and pressed in the same frame it was found in, so a panel rebuilding between a find and a click cannot free it first. Words on a label inside a button press the button. A control with something drawn over its centre that would take the pointer, such as a screen shown over it or a dialog stacked above its own, is not on screen; nor is one on a hidden canvas layer, one outside the viewport, or one a container clips away that a click does not scroll. The refusal counts those apart. The matches are ranked the way a person picks what to press: an enabled button before anything else, a disabled one included, then a control whose whole text, or one whole line of it such as the title on a card, is the words before one saying them as part of more, and the best one is pressed; found.picked says why. Several matches at the best rank are refused with each one listed, and index picks one. A match saying the words only as part of more is named under found.partOf, and is refused when another control says exactly the words (hidden, off the screen, covered, or on screen taking clicks without being a button), since it would stand in for that one, and when it lets the pointer through to what is under it; index presses it anyway. Words found only inside longer words (\"out\" in \"Scout\") rank after every other match and are refused unless index is given; words starting a longer word (\"Recruit\" in \"Recruits\") count. An empty field says its placeholder, and a control with no text of its own, a picture on a button, says its accessibility name. An item of an open menu is drawn by the menu rather than held as a control, so a click finds none, and the refusal names the menu and the choose call that picks it."
         },
         action: {
           type: "string",
@@ -38708,12 +38708,16 @@ function whyNoReport(printed, asked) {
   return printed.some((line) => NOTHING_RAN.test(line)) ? `no test cases found at ${asked}` : null;
 }
 function scriptErrorsPrinted(printed) {
+  return discoveryListing(printed)?.errors ?? [];
+}
+function discoveryListing(printed) {
   const start = printed.findIndex((line) => line.includes(DISCOVERY_FAILED));
   if (start < 0) {
-    return [];
+    return null;
   }
   const found = [];
   let message = null;
+  let to = start + 1;
   for (const line of printed.slice(start + 1)) {
     const at = /^\s*at (res:\/\/.+):(\d+)\s*$/.exec(line);
     if (at !== null && message !== null) {
@@ -38724,8 +38728,10 @@ function scriptErrorsPrinted(printed) {
     } else {
       break;
     }
+    to += 1;
   }
-  return found.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : (a.line ?? 0) - (b.line ?? 0));
+  const errors = found.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : (a.line ?? 0) - (b.line ?? 0));
+  return { errors, from: start, to };
 }
 function unspelled(text) {
   return text.replace(/<(?:LF|CR|TAB|BS|FF|VT|BEL|ESC|DEL|0x[0-9A-F]{2})>/g, (spelling) => spelling.startsWith("<0x") ? String.fromCharCode(Number.parseInt(spelling.slice(3, 5), 16)) : SPELLED[spelling] ?? spelling);
@@ -41562,6 +41568,104 @@ var init_run_record = __esm(() => {
   execFileAsync = promisify4(execFile4);
 });
 
+// src/script-origins.ts
+import { join as join24 } from "node:path";
+function unresolvedClassIn(message) {
+  return UNRESOLVED.exec(message)?.[1] ?? null;
+}
+async function originsOf(errors, declared, check) {
+  const listed = new Set(errors.map((error) => error.path));
+  const origins = [];
+  const unconfirmed = [];
+  const asked = new Set;
+  const waiting = errors.map((error) => unresolvedClassIn(error.message)).filter((name) => name !== null);
+  while (waiting.length > 0 && asked.size < MOST_CHECKED) {
+    const name = waiting.shift() ?? "";
+    const path = declared.get(name);
+    if (path === undefined || listed.has(path) || asked.has(path)) {
+      continue;
+    }
+    asked.add(path);
+    const checked = await check(path);
+    const own = checked.errors.filter((error) => error.path === path);
+    if (own.length === 0) {
+      unconfirmed.push({
+        path,
+        declares: name,
+        why: checked.failure === null ? "the engine's check of it found no error" : `the engine's check of it did not finish (${checked.failure})`
+      });
+      continue;
+    }
+    for (const error of own) {
+      origins.push({ ...error, declares: name });
+      const deeper = unresolvedClassIn(error.message);
+      if (deeper !== null) {
+        waiting.push(deeper);
+      }
+    }
+  }
+  return { origins, unconfirmed };
+}
+function reloadedAt(entry) {
+  for (const line of entry.detail) {
+    const at = RELOADED_AT.exec(line.trim());
+    if (at !== null) {
+      return { path: at[1] ?? "", line: Number(at[2]) === 0 ? null : Number(at[2]) };
+    }
+  }
+  return null;
+}
+function checkWithEngine(godotPath, projectPath) {
+  return async (path) => {
+    const logDir = scratchDirectory("tests");
+    try {
+      const ran = await runEngine(godotPath, [
+        "--headless",
+        "--log-file",
+        join24(logDir, "engine.log"),
+        "--path",
+        projectPath,
+        "--check-only",
+        "-s",
+        path
+      ], { timeout: { ms: 60000, said: "minute" } });
+      const errors = ran.log.select({ severity: "error", sinceLastCall: false, limit: 50 }).entries.flatMap((entry) => {
+        const at = reloadedAt(entry);
+        return at === null ? [] : [{ ...at, message: entry.text }];
+      });
+      return { errors, failure: ran.failure === null ? null : howItEnded(ran) };
+    } finally {
+      discard(logDir);
+    }
+  };
+}
+function withoutListed(entries, errors) {
+  if (errors.length === 0) {
+    return [...entries];
+  }
+  const listing = discoveryListing(entries.map((entry) => entry.text));
+  const paths = new Set(errors.map((error) => error.path));
+  return entries.filter((entry, at) => {
+    if (listing !== null && at >= listing.from && at < listing.to) {
+      return false;
+    }
+    const reloaded = reloadedAt(entry);
+    if (reloaded !== null && errors.some((error) => error.path === reloaded.path && error.line === reloaded.line && error.message === entry.text)) {
+      return false;
+    }
+    const failedToLoad = /^Failed to load script "(res:\/\/[^"]+)" with error "[^"]+"\.$/.exec(entry.text);
+    return failedToLoad === null || !paths.has(failedToLoad[1] ?? "");
+  });
+}
+var UNRESOLVED, MOST_CHECKED = 8, RELOADED_AT;
+var init_script_origins = __esm(() => {
+  init_engine_run();
+  init_junit();
+  init_scratch();
+  UNRESOLVED = /Could not resolve class "([A-Za-z_][A-Za-z0-9_]*)", because of a parser error/;
+  RELOADED_AT = /GDScript::reload \((res:\/\/.+):(\d+)\)$/;
+});
+
 // src/server.ts
 import { execFile as execFile5, spawn as spawn4 } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -41580,7 +41684,7 @@ import {
   rmdirSync as rmdirSync2,
   statSync as statSync9
 } from "node:fs";
-import { basename as basename7, dirname as dirname18, extname as extname2, isAbsolute as isAbsolute3, join as join24, normalize as normalize2, relative as relative5 } from "node:path";
+import { basename as basename7, dirname as dirname18, extname as extname2, isAbsolute as isAbsolute3, join as join25, normalize as normalize2, relative as relative5 } from "node:path";
 import { setTimeout as delay3 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 import { promisify as promisify5 } from "node:util";
@@ -41605,7 +41709,7 @@ function captureDestinationRefusal(outputPath, projects) {
   if (!existsSync19(directory)) {
     return `outputPath's directory ${dirname18(outputPath)} does not exist; a capture creates no directories.`;
   }
-  const where = join24(directory, basename7(outputPath));
+  const where = join25(directory, basename7(outputPath));
   const inside = projects.find((project) => project !== "" && isWithinRoot(realPathOr(project), where));
   if (inside !== undefined) {
     return `outputPath ${outputPath} is inside the project at ${inside}; a capture is saved outside it, so it never becomes part of the game.`;
@@ -42093,7 +42197,13 @@ function foldedScriptErrors(errors) {
 function nonEmpty(lists) {
   return Object.fromEntries(Object.entries(lists).filter(([, list]) => list.length > 0));
 }
-function scriptErrorsNote(errors) {
+function scriptErrorsNote(errors, {
+  origins,
+  unconfirmed
+} = {
+  origins: [],
+  unconfirmed: []
+}) {
   const { scriptErrors: own, failedThroughDependency: dependents } = foldedScriptErrors(errors);
   const causes = new Map;
   for (const error of own) {
@@ -42102,7 +42212,22 @@ function scriptErrorsNote(errors) {
     }
   }
   const scripts = causes.size + dependents.length;
-  const named = [...causes.values()].map((error) => `${error.line === null ? error.path : `${error.path}:${error.line}`} ${error.message}${/[.!?]\)?$/.test(error.message) ? "" : "."}`).join(" ");
+  const at = (error) => error.line === null ? error.path : `${error.path}:${error.line}`;
+  const sentence = (text) => `${text}${/[.!?]\)?$/.test(text) ? "" : "."}`;
+  const traced = new Set;
+  const failedOn = (declares) => {
+    const through = [...causes.values()].filter((error) => unresolvedClassIn(error.message) === declares);
+    for (const error of through) {
+      traced.add(error.path);
+    }
+    return through.length === 0 ? "" : ` ${through.map(at).join(", ")} could not resolve ${declares} because of it.`;
+  };
+  const first = [...new Map(origins.map((origin) => [origin.path, origin])).values()].sort((a, b) => Number(unresolvedClassIn(a.message) !== null) - Number(unresolvedClassIn(b.message) !== null));
+  const named = [
+    ...first.map((origin) => `${at(origin)} ${sentence(origin.message)} gdUnit4 did not name this script, which declares ${origin.declares}; the engine's own check of it found the error.${failedOn(origin.declares)}`),
+    ...unconfirmed.map((origin) => `${origin.path} declares ${origin.declares}, which gdUnit4 did not name, and ${origin.why}.${failedOn(origin.declares)}`),
+    ...[...causes.values()].filter((error) => !traced.has(error.path)).map((error) => `${at(error)} ${sentence(error.message)}`)
+  ].join(" ");
   const following = dependents.length === 0 ? "" : causes.size === 0 ? `${dependents.join(", ")} ${dependents.length === 1 ? "depends" : "depend"} on a script that did not compile, and gdUnit4 named none with an error of its own: script_diagnostics on one of them finds it.` : `${dependents.length === 1 ? "One more" : `${dependents.length} more`} failed only because a script ${dependents.length === 1 ? "it depends" : "they depend"} on did: ${dependents.join(", ")}.`;
   const more = own.length - causes.size;
   const rest = more > 0 ? `${more === 1 ? "One more error" : `${more} more errors`} in ${causes.size === 1 ? "that script" : "those scripts"} ${more === 1 ? "is" : "are"} under scriptErrors.` : "";
@@ -42169,7 +42294,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync19(join24(projectPath, wanted))) {
+  if (wanted === "" || existsSync19(join25(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -42221,7 +42346,7 @@ function runtimeAddonAnnouncesEditors(projectPath) {
     return false;
   }
   try {
-    return readFileSync21(join24(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
+    return readFileSync21(join25(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
   } catch {
     return false;
   }
@@ -42246,7 +42371,7 @@ function needsItsOwnProcess(asked) {
 class GodotServer {
   mcp;
   locator = new GodotLocator;
-  operationsScript = join24(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join25(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -42549,7 +42674,7 @@ class GodotServer {
         return checked.response;
       }
       const named = args["projectPath"];
-      if (typeof named === "string" && existsSync19(join24(named, "project.godot"))) {
+      if (typeof named === "string" && existsSync19(join25(named, "project.godot"))) {
         this.lastProjectPath = named;
       }
       this.updates.refresh();
@@ -43023,7 +43148,7 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join24(path, "project.godot");
+    const file = join25(path, "project.godot");
     if (!existsSync19(file)) {
       return {
         ok: false,
@@ -43702,7 +43827,7 @@ class GodotServer {
     const exportArgs = [
       "--headless",
       "--log-file",
-      join24(exportLogs, "engine.log"),
+      join25(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -43732,7 +43857,7 @@ class GodotServer {
     if (!paths.ok) {
       return this.createErrorResponse(paths.reason, PATH_SOLUTIONS);
     }
-    const missing = paths.value.filter((path) => !existsSync19(join24(project.value.path, path.slice("res://".length))));
+    const missing = paths.value.filter((path) => !existsSync19(join25(project.value.path, path.slice("res://".length))));
     const asked = paths.value.filter((path) => !missing.includes(path));
     if (asked.length === 0) {
       const verdict = `nothing at ${missing.join(" and ")}`;
@@ -43748,7 +43873,7 @@ class GodotServer {
       };
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync19(join24(project.value.path, runner))) {
+    if (!existsSync19(join25(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"
       ]);
@@ -43813,14 +43938,14 @@ class GodotServer {
       await untilGone([run.process.pid]);
     }
     await run.settled;
-    const reportsDir = join24(project.value.path, ".godot", ...ours.split("/"));
+    const reportsDir = join25(project.value.path, ".godot", ...ours.split("/"));
     let report = null;
     let reportProblem = null;
     try {
       const written = existsSync19(reportsDir) ? readdirSync10(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(readFileSync21(join24(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync21(join25(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -43849,7 +43974,9 @@ class GodotServer {
     const nothingRan = timedOut ? null : whyNoReport(said, asked.join(" and "));
     const cutShort = timedOut ? timedOutVerdict(timeoutMs, silentForMs) : null;
     const hung = cutShort?.hung ?? false;
-    const scriptErrors = timedOut || exitCode !== 105 ? [] : scriptErrorsPrinted(said);
+    const printedErrors = timedOut || exitCode !== 105 ? [] : scriptErrorsPrinted(said);
+    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) ?? (exitCode === null ? undefined : verdicts[exitCode]) ?? (run.exitSignal === null ? `exit ${exitCode ?? "unknown"}` : howItExited(run));
     const nothingAt = missing.join(" and ");
@@ -43863,7 +43990,7 @@ class GodotServer {
       ...echoed.omitted > 0 ? { printedOmitted: echoed.omitted } : {}
     };
     if (report === null) {
-      const said = nothingRan !== null ? `No tests ran: ${ranAs}.` : scriptErrors.length > 0 ? scriptErrorsNote(scriptErrors) : reportProblem !== null ? `The test run's report could not be read (${reportProblem}); the engine's own verdict was ${ranAs}.` : `The test run wrote no report (${ranAs}).`;
+      const said = nothingRan !== null ? `No tests ran: ${ranAs}.` : scriptErrors.length > 0 ? scriptErrorsNote(printedErrors, declaring) : reportProblem !== null ? `The test run's report could not be read (${reportProblem}); the engine's own verdict was ${ranAs}.` : `The test run wrote no report (${ranAs}).`;
       const note = missingNote === undefined ? said : `${said} ${missingNote}`;
       return {
         content: [
@@ -43881,7 +44008,7 @@ class GodotServer {
               ...missing.length > 0 ? { missing } : {},
               ...nonEmpty(foldedScriptErrors(scriptErrors)),
               arguments: cmdArgs,
-              entries: forAnswer(printed.slice(0, 60).map(aboveTheRunner)),
+              entries: forAnswer(withoutListed(printed, scriptErrors).slice(0, 60).map(aboveTheRunner)),
               ...printedLines,
               savesNote,
               ...scanned
@@ -44389,7 +44516,7 @@ class GodotServer {
       return null;
     }
     try {
-      return settingKeys(readFileSync21(join24(projectPath, "project.godot"), "utf8"));
+      return settingKeys(readFileSync21(join25(projectPath, "project.godot"), "utf8"));
     } catch {
       return null;
     }
@@ -44711,7 +44838,7 @@ class GodotServer {
   }
   async runtimeUp(projectPath, before, budget, withArgs) {
     const budgetMs = budget.ms;
-    if (!existsSync19(join24(projectPath, RUNTIME_AUTOLOAD.path))) {
+    if (!existsSync19(join25(projectPath, RUNTIME_AUTOLOAD.path))) {
       return runtimeVerdict(null, {
         addon: false,
         budgetMs,
@@ -45728,7 +45855,7 @@ class GodotServer {
       notes.push(endedWithoutACode({
         throughEditor: run.throughEditor,
         announced: announced !== undefined || run.announcedPid !== undefined,
-        couldAnnounce: run.projectPath !== null && existsSync19(join24(run.projectPath, RUNTIME_AUTOLOAD.path)),
+        couldAnnounce: run.projectPath !== null && existsSync19(join25(run.projectPath, RUNTIME_AUTOLOAD.path)),
         endedHere: typeof run.endedHere === "string",
         pickedUp: run.pickedUp === true
       }));
@@ -46577,7 +46704,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) || !existsSync19(join24(project, RUNTIME_AUTOLOAD.path)) || !await this.runStillGoing(run)) {
+    if (run === null || project === null || run.announcedPid !== undefined || run.projectPath !== null && !isSameDirectory(run.projectPath, project) || !existsSync19(join25(project, RUNTIME_AUTOLOAD.path)) || !await this.runStillGoing(run)) {
       return null;
     }
     const already = runtimesAnnounced().running;
@@ -46661,7 +46788,7 @@ class GodotServer {
       }
     }
     const screenshotDir = expectsScreenshot ? scratchDirectory("runtime-screenshot") : null;
-    const screenshotPath = screenshotDir ? join24(screenshotDir, "capture.png") : null;
+    const screenshotPath = screenshotDir ? join25(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}
@@ -46852,6 +46979,7 @@ var init_server3 = __esm(() => {
   init_run_record();
   init_runtime_client();
   init_scratch();
+  init_script_origins();
   init_server_version();
   init_setup();
   init_tool_definitions();
@@ -46908,7 +47036,7 @@ init_bridge_announce();
 init_errors();
 init_godot_path();
 import { existsSync as existsSync20 } from "node:fs";
-import { join as join25, resolve as resolve8 } from "node:path";
+import { join as join26, resolve as resolve8 } from "node:path";
 
 // src/harnesses.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync2 } from "node:fs";
@@ -48239,7 +48367,7 @@ class UsageError extends Refusal {
 function projectArgument(at) {
   const named = args.slice(at).find((value) => !value.startsWith("--"));
   const projectPath = resolve8(named ?? ".");
-  if (!existsSync20(join25(projectPath, "project.godot"))) {
+  if (!existsSync20(join26(projectPath, "project.godot"))) {
     throw new UsageError(`Not a Godot project: ${projectPath} holds no project.godot.`);
   }
   return projectPath;
@@ -48284,7 +48412,7 @@ async function registerRuntime(godot, projectPath) {
     return;
   }
   console.log(`${RUNTIME_AUTOLOAD.name} autoload left at ${named}, which this project registers itself`);
-  if (!existsSync20(join25(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
+  if (!existsSync20(join26(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
     console.log(`  that file is not in this project, so it boots with a missing script: restore it, or point the entry at res://${RUNTIME_AUTOLOAD.path}`);
   }
 }

package/build/godot/addons/gdharness_runtime/runtime_menus.gd

@@ -61,7 +61,7 @@ static func wanted_items(menu: PopupMenu, params: Dictionary) -> Array[int]:
 			if words[at] == wanted:
 				return _items([order[at]])
 		for at: int in words.size():
-			if words[at].nocasecmp_to(wanted) == 0:
+			if Says.spaced(words[at]).nocasecmp_to(Says.spaced(wanted)) == 0:
 				return _items([order[at]])
 	# Separators are left out here: a heading is refused when named in full, and a pattern that
 	# matched one beside the item it heads would tie the two.

package/build/godot/addons/gdharness_runtime/runtime_says.gd

@@ -16,6 +16,9 @@ const SPLITS_KEPT: int = 8
 ## Each `says` split into alternatives, by what was written; see [method alternatives].
 static var _splits: Dictionary[String, Array] = {}
 
+## Every space separator Unicode has besides the plain space, built once; see [method spaced].
+static var _spaces: RegEx = null
+
 
 ## Whether [param node]'s own words are what [param wanted] asks for.
 static func says(node: Node, wanted: String) -> bool:
@@ -35,12 +38,33 @@ static func says(node: Node, wanted: String) -> bool:
 ## first, and read as one glob with the bars in it, it waited out its whole timeout for words no
 ## screen says.
 static func matches(said: String, wanted: String) -> bool:
+	var shown: String = spaced(said)
 	for words: String in alternatives(wanted):
-		if said.containsn(words) if is_plain(words) else said.matchn(words):
+		if shown.containsn(words) if is_plain(words) else shown.matchn(words):
 			return true
 	return false
 
 
+## [param text] with every Unicode space separator written as a plain space, which is what a caller
+## types for any of them. A game keeping a name on one line writes it with a non-breaking space, and
+## "Deskanem Bonituk" typed with a plain one found nothing while the screen showed exactly those
+## words. One character for one, so a place found in the result is the same place in [param text].
+static func spaced(text: String) -> String:
+	if _spaces == null:
+		var separators: String = (
+			String.chr(0x00A0)
+			+ String.chr(0x1680)
+			+ String.chr(0x2000)
+			+ "-"
+			+ String.chr(0x200A)
+			+ String.chr(0x202F)
+			+ String.chr(0x205F)
+			+ String.chr(0x3000)
+		)
+		_spaces = RegEx.create_from_string("[%s]" % separators)
+	return _spaces.sub(text, " ", true)
+
+
 ## The alternatives [param wanted] names, each as words on a screen: split at every `|` not written
 ## as `\|`, which stays a bar in the words. An empty alternative, a stray bar at either end, is
 ## dropped: it names no words, and a find that came back empty widened it to `**` and suggested a
@@ -110,4 +134,4 @@ static func widened(wanted: String) -> String:
 ## which reads as a control that is not on the screen. Nothing on a screen says a backslash and
 ## an n, so the two characters mean the break to everybody who writes them.
 static func as_said(wanted: String) -> String:
-	return wanted.replace("\\n", "\n")
+	return spaced(wanted.replace("\\n", "\n"))

package/build/godot/addons/gdharness_runtime/runtime_targets.gd

@@ -41,6 +41,8 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 	# The words of the control that matched, which a button pressed on a label's behalf has none of.
 	var said: Array[String] = []
 	var exact: Array[bool] = []
+	# Whether the words are only inside longer words there, "out" in "Scout".
+	var inside: Array[bool] = []
 	var hidden: int = 0
 	# Controls saying exactly the words that a click cannot reach, kept to say what a match on screen
 	# that only says them as part of more stands in for.
@@ -60,14 +62,17 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 				var target: Control = _pressed_through(control)
 				var words: String = Words.said_by(node)
 				var whole: bool = _says_exactly(words, wanted)
+				var buried: bool = not whole and _inside_a_word(words, wanted)
 				var at: int = matched.find(target)
 				if at == -1:
 					matched.append(target)
 					said.append(words)
 					exact.append(whole)
-				elif whole and not exact[at]:
+					inside.append(buried)
+				elif (whole and not exact[at]) or (inside[at] and not buried):
 					said[at] = words
-					exact[at] = true
+					exact[at] = whole
+					inside[at] = buried
 		var children: Array[Node] = node.get_children(true)
 		for index: int in range(children.size() - 1, -1, -1):
 			pending.push_front(children[index])
@@ -95,9 +100,13 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 				out_of_reach_as.append("under %s, which is drawn over it" % over.get_path())
 			if cover == null:
 				cover = over
-	# Stable, so matches of one rank keep the order they are drawn in.
+	# Stable, so matches of one rank keep the order they are drawn in. Words only inside longer words
+	# come after everything else: ranked as a button saying them as part of more, "Scout, 90" was
+	# pressed for "Out" over a control saying exactly "Out", and spent a game's silver.
 	open.sort_custom(
 		func(a: int, b: int) -> bool:
+			if inside[a] != inside[b]:
+				return inside[b]
 			var first: int = _rank(matched[a], exact[a])
 			var second: int = _rank(matched[b], exact[b])
 			return first > second or (first == second and a < b)
@@ -106,11 +115,13 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 	var ranks: Array[int] = []
 	var lines: Array[String] = []
 	var wholes: Array[bool] = []
+	var insides: Array[bool] = []
 	for index: int in open:
 		targets.append(matched[index])
 		ranks.append(_rank(matched[index], exact[index]))
 		lines.append(said[index])
 		wholes.append(exact[index])
+		insides.append(inside[index])
 
 	var under: String = "" if root_path == "/root" else " under %s" % root_path
 	if targets.is_empty():
@@ -129,7 +140,10 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 				]
 			)
 		}
-	var best: int = ranks.count(ranks[0])
+	var best: int = 0
+	for at: int in targets.size():
+		if ranks[at] == ranks[0] and insides[at] == insides[0]:
+			best += 1
 	if which == null and best > 1:
 		var order: String = "" if best == targets.size() else ", best matches first"
 		return {
@@ -151,30 +165,74 @@ static func control_saying(root: Node, root_path: String, wanted: String, which:
 				% [str(which), targets.size(), plural, under, wanted, _candidates(targets, lines)]
 			)
 		}
-	# A word inside a sentence on screen, while a control saying exactly that word is out of reach: the
-	# sentence is a stand-in, not the control meant. A tab reading "Out" sat in a collapsed drawer, and
-	# a click on it pressed a dispatch saying somebody "fell out in the hall". Pressed only when asked
-	# for by index, which is the caller saying the sentence is what they meant.
-	if which == null and not wholes[index] and not exact_out_of_reach.is_empty():
+	# A match saying the words as part of more, while another control says exactly them, is a stand-in
+	# for that one, not the control meant: a tab reading "Out" sat in a collapsed drawer and a dispatch
+	# saying somebody "fell out in the hall" was pressed, and with the tab's own words on screen in a
+	# control that is not a button, a card reading "Scout, 90" was. Pressed only when asked for by
+	# index, which is the caller saying the match is what they meant.
+	var exact_elsewhere: Array[Node] = exact_out_of_reach.duplicate()
+	var elsewhere_as: Array[String] = out_of_reach_as.duplicate()
+	# On screen only when it takes clicks itself: a heading saying exactly "Onward" beside a button
+	# saying "Onward now" is not what a click on "Onward" is for, and the button is pressed.
+	for other: int in targets.size():
+		var taking: bool = targets[other].get_mouse_filter_with_override() != Control.MOUSE_FILTER_IGNORE
+		if other != index and wholes[other] and taking:
+			exact_elsewhere.append(targets[other])
+			elsewhere_as.append("on screen, taking clicks but not an enabled button")
+	var best_one: String = "the one on screen," if targets.size() == 1 else "the best match on screen,"
+	if which == null and not wholes[index] and not exact_elsewhere.is_empty():
 		return {
 			"type": "error",
 			"message":
 			(
 				(
-					'no control on screen%s says exactly "%s", so nothing was clicked: %s %s says it as part of'
-					+ ' "%s", while %s; pass index %d to press that one anyway, or bring the other into view'
+					'no %s on screen%s says exactly "%s", so nothing was clicked: %s %s says it as part of'
+					+ ' "%s", while %s; pass index %d to press that one anyway'
 				)
 				% [
+					"button" if exact_elsewhere.size() > exact_out_of_reach.size() else "control",
 					under,
 					wanted,
-					"the one on screen," if targets.size() == 1 else "the best match on screen,",
+					best_one,
 					targets[index].get_path(),
 					_shortened(lines[index]),
-					_out_of_reach_exactly(exact_out_of_reach, out_of_reach_as),
+					_out_of_reach_exactly(exact_elsewhere, elsewhere_as),
 					index,
 				]
 			)
 		}
+	if which == null and insides[index]:
+		return {
+			"type": "error",
+			"message":
+			(
+				(
+					'no control on screen%s says "%s" as a word of its own, so nothing was clicked: %s %s has'
+					+ ' it only inside a longer word, "%s"; pass index %d to press that one anyway'
+				)
+				% [under, wanted, best_one, targets[index].get_path(), _shortened(lines[index]), index]
+			)
+		}
+	# Words in a sentence on a control that lets the pointer through: the press lands on whatever is
+	# under it, which is nothing the words name. A line saying what "is out there" was the best match
+	# left for "Out" once the cards saying "Scout" were passed over.
+	if (
+		which == null
+		and not wholes[index]
+		and targets[index].get_mouse_filter_with_override() == Control.MOUSE_FILTER_IGNORE
+	):
+		return {
+			"type": "error",
+			"message":
+			(
+				(
+					'no control on screen%s that takes a click says "%s", so nothing was clicked: %s %s says it'
+					+ ' as part of "%s" and lets the pointer through to what is under it; pass index %d to'
+					+ " click there anyway"
+				)
+				% [under, wanted, best_one, targets[index].get_path(), _shortened(lines[index]), index]
+			)
+		}
 	var found: Dictionary = {"says": wanted, "index": index, "of": targets.size()}
 	if not wholes[index]:
 		found["partOf"] = _shortened(lines[index])
@@ -205,7 +263,8 @@ static func _rank(target: Control, whole: bool) -> int:
 ## A line counts because a card is a title over a description: "WARD" over "wards 3" is the card
 ## named WARD, and read as its words run together it said WARD only as part of more, level with
 ## "WARDSPITE" over its own description, and a click on WARD was refused as not clear.
-static func _says_exactly(said: String, wanted: String) -> bool:
+static func _says_exactly(written: String, wanted: String) -> bool:
+	var said: String = Says.spaced(written)
 	for words: String in Says.alternatives(wanted):
 		if not Says.is_plain(words):
 			if said.matchn(words):
@@ -220,6 +279,32 @@ static func _says_exactly(said: String, wanted: String) -> bool:
 	return false
 
 
+## Whether [param written] has the plain words [param wanted] asks for only inside longer words,
+## never starting where a word starts: "out" in "Scout". Words starting a longer one count as said,
+## "Recruit" in "Recruits", and so does anything matched by a pattern.
+static func _inside_a_word(written: String, wanted: String) -> bool:
+	var said: String = Says.spaced(written).to_lower()
+	var found: bool = false
+	for words: String in Says.alternatives(wanted):
+		var looked_for: String = words.to_lower()
+		if not Says.is_plain(words) or not _in_a_word(looked_for.unicode_at(0)):
+			return false
+		var at: int = said.find(looked_for)
+		while at >= 0:
+			found = true
+			if at == 0 or not _in_a_word(said.unicode_at(at - 1)):
+				return false
+			at = said.find(looked_for, at + 1)
+	return found
+
+
+## Whether the character [param code] is part of a word: a letter, a digit or an underscore. A letter
+## is told by having a case, which leaves scripts without one counted as breaks between words.
+static func _in_a_word(code: int) -> bool:
+	var character: String = String.chr(code)
+	return character.to_lower() != character.to_upper() or character.is_valid_int() or character == "_"
+
+
 ## [param count] matches of [param rank], as the start of a sentence.
 static func _described(count: int, rank: int, wanted: String, under: String) -> String:
 	var what: String = "button" if rank >= 2 else "control"
@@ -509,7 +594,7 @@ static func _clipped_away(
 ## words. A line in another font or holding an image measures off from what is drawn, which a wide
 ## line with nothing between the words and its start hardly does.
 static func point_on_words(label: RichTextLabel, wanted: String) -> Dictionary:
-	var text: String = Words.said_by(label)
+	var text: String = Says.spaced(Words.said_by(label))
 	var start: int = -1
 	var length: int = 0
 	for words: String in Says.alternatives(wanted):

package/build/godot/addons/gdharness_runtime/runtime_words.gd

@@ -25,7 +25,14 @@ static func said_by(node: Node) -> String:
 		return _label_says(label)
 	if _draws_a_list(node):
 		return "\n".join(lines_said_by(node))
-	return _text_of(node)
+	var own: String = _text_of(node)
+	# A control showing a picture rather than words is named for a player who cannot see it, and that
+	# name is the one the words a caller asks by are meant for: the rail's "Out" tab is a square with
+	# an icon on it, and a click on "Out" found only the words around it.
+	if own.is_empty() and node is Control:
+		var control: Control = node
+		return control.atr(control.accessibility_name).strip_edges()
+	return own
 
 
 ## Every line [param node] draws for a player to read, one to an entry: a label's one line, or each

package/build/index.js

@@ -10259,7 +10259,7 @@ import {
   rmdirSync as rmdirSync2,
   statSync as statSync8
 } from "node:fs";
-import { basename as basename5, dirname as dirname14, extname as extname2, isAbsolute as isAbsolute3, join as join20, normalize as normalize2, relative as relative4 } from "node:path";
+import { basename as basename5, dirname as dirname14, extname as extname2, isAbsolute as isAbsolute3, join as join21, normalize as normalize2, relative as relative4 } from "node:path";
 import { setTimeout as delay3 } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { promisify as promisify5 } from "node:util";
@@ -29420,12 +29420,16 @@ function whyNoReport(printed, asked) {
 }
 var DISCOVERY_FAILED = "Script errors were detected during test discovery!";
 function scriptErrorsPrinted(printed) {
+  return discoveryListing(printed)?.errors ?? [];
+}
+function discoveryListing(printed) {
   const start = printed.findIndex((line) => line.includes(DISCOVERY_FAILED));
   if (start < 0) {
-    return [];
+    return null;
   }
   const found = [];
   let message = null;
+  let to = start + 1;
   for (const line of printed.slice(start + 1)) {
     const at = /^\s*at (res:\/\/.+):(\d+)\s*$/.exec(line);
     if (at !== null && message !== null) {
@@ -29436,8 +29440,10 @@ function scriptErrorsPrinted(printed) {
     } else {
       break;
     }
+    to += 1;
   }
-  return found.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : (a.line ?? 0) - (b.line ?? 0));
+  const errors = found.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : (a.line ?? 0) - (b.line ?? 0));
+  return { errors, from: start, to };
 }
 var ESCAPE = String.fromCharCode(27);
 var LOCATION = `'[^'\\n]*' in \\S+:\\d+`;
@@ -32498,6 +32504,99 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
   }
 }
 
+// src/script-origins.ts
+import { join as join19 } 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;
+}
+var MOST_CHECKED = 8;
+async function originsOf(errors, declared, check) {
+  const listed = new Set(errors.map((error) => error.path));
+  const origins = [];
+  const unconfirmed = [];
+  const asked = new Set;
+  const waiting = errors.map((error) => unresolvedClassIn(error.message)).filter((name) => name !== null);
+  while (waiting.length > 0 && asked.size < MOST_CHECKED) {
+    const name = waiting.shift() ?? "";
+    const path = declared.get(name);
+    if (path === undefined || listed.has(path) || asked.has(path)) {
+      continue;
+    }
+    asked.add(path);
+    const checked = await check(path);
+    const own = checked.errors.filter((error) => error.path === path);
+    if (own.length === 0) {
+      unconfirmed.push({
+        path,
+        declares: name,
+        why: checked.failure === null ? "the engine's check of it found no error" : `the engine's check of it did not finish (${checked.failure})`
+      });
+      continue;
+    }
+    for (const error of own) {
+      origins.push({ ...error, declares: name });
+      const deeper = unresolvedClassIn(error.message);
+      if (deeper !== null) {
+        waiting.push(deeper);
+      }
+    }
+  }
+  return { origins, unconfirmed };
+}
+var RELOADED_AT = /GDScript::reload \((res:\/\/.+):(\d+)\)$/;
+function reloadedAt(entry) {
+  for (const line of entry.detail) {
+    const at = RELOADED_AT.exec(line.trim());
+    if (at !== null) {
+      return { path: at[1] ?? "", line: Number(at[2]) === 0 ? null : Number(at[2]) };
+    }
+  }
+  return null;
+}
+function checkWithEngine(godotPath, projectPath) {
+  return async (path) => {
+    const logDir = scratchDirectory("tests");
+    try {
+      const ran = await runEngine(godotPath, [
+        "--headless",
+        "--log-file",
+        join19(logDir, "engine.log"),
+        "--path",
+        projectPath,
+        "--check-only",
+        "-s",
+        path
+      ], { timeout: { ms: 60000, said: "minute" } });
+      const errors = ran.log.select({ severity: "error", sinceLastCall: false, limit: 50 }).entries.flatMap((entry) => {
+        const at = reloadedAt(entry);
+        return at === null ? [] : [{ ...at, message: entry.text }];
+      });
+      return { errors, failure: ran.failure === null ? null : howItEnded(ran) };
+    } finally {
+      discard(logDir);
+    }
+  };
+}
+function withoutListed(entries, errors) {
+  if (errors.length === 0) {
+    return [...entries];
+  }
+  const listing = discoveryListing(entries.map((entry) => entry.text));
+  const paths = new Set(errors.map((error) => error.path));
+  return entries.filter((entry, at) => {
+    if (listing !== null && at >= listing.from && at < listing.to) {
+      return false;
+    }
+    const reloaded = reloadedAt(entry);
+    if (reloaded !== null && errors.some((error) => error.path === reloaded.path && error.line === reloaded.line && error.message === entry.text)) {
+      return false;
+    }
+    const failedToLoad = /^Failed to load script "(res:\/\/[^"]+)" with error "[^"]+"\.$/.exec(entry.text);
+    return failedToLoad === null || !paths.has(failedToLoad[1] ?? "");
+  });
+}
+
 // src/setup.ts
 import { spawnSync } from "node:child_process";
 import { createHash as createHash4 } from "node:crypto";
@@ -32512,7 +32611,7 @@ import {
   statSync as statSync7,
   writeFileSync as writeFileSync13
 } from "node:fs";
-import { dirname as dirname13, join as join19 } from "node:path";
+import { dirname as dirname13, join as join20 } 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"];
@@ -32536,7 +32635,7 @@ function addonsDigest(names, from) {
       if (name === VERSION_MARKER || name === DIGEST_MARKER) {
         continue;
       }
-      const path = join19(directory, name);
+      const path = join20(directory, name);
       const inside = `${relative}/${name}`;
       if (statSync7(path).isDirectory()) {
         walk(path, inside);
@@ -32550,7 +32649,7 @@ function addonsDigest(names, from) {
     }
   };
   for (const name of names) {
-    walk(join19(from, name), name);
+    walk(join20(from, name), name);
   }
   return hash.digest("hex");
 }
@@ -32583,7 +32682,7 @@ function installedRuntimeDigest(projectPath) {
   return digestMarker(projectPath, RUNTIME_ADDON);
 }
 function digestMarker(projectPath, addon) {
-  const marker = join19(projectPath, "addons", addon, DIGEST_MARKER);
+  const marker = join20(projectPath, "addons", addon, DIGEST_MARKER);
   if (!existsSync15(marker)) {
     return null;
   }
@@ -32591,10 +32690,10 @@ function digestMarker(projectPath, addon) {
   return said === "" ? null : said;
 }
 function shippedAddonsDirectory() {
-  return join19(dirname13(fileURLToPath3(import.meta.url)), "godot", "addons");
+  return join20(dirname13(fileURLToPath3(import.meta.url)), "godot", "addons");
 }
 function installedAddonVersion(projectPath) {
-  const marker = join19(projectPath, "addons", ADDONS[0], VERSION_MARKER);
+  const marker = join20(projectPath, "addons", ADDONS[0], VERSION_MARKER);
   if (!existsSync15(marker)) {
     return null;
   }
@@ -32609,7 +32708,7 @@ function loaderAmong(projectPath, named) {
     }
     let source = null;
     try {
-      source = readFileSync18(join19(projectPath, path), "utf8");
+      source = readFileSync18(join20(projectPath, path), "utf8");
     } catch {}
     if (source?.includes(RUNTIME_AUTOLOAD.path)) {
       return { name: entry, path, exists: true };
@@ -32651,8 +32750,8 @@ function enabledPlugins(settings) {
 function inspectProject(projectPath) {
   const problems = [];
   const addons = ADDONS.map((name) => {
-    const directory = join19(projectPath, "addons", name);
-    const marker = join19(directory, VERSION_MARKER);
+    const directory = join20(projectPath, "addons", name);
+    const marker = join20(directory, VERSION_MARKER);
     const installed = existsSync15(directory);
     const version = existsSync15(marker) ? readFileSync18(marker, "utf8").trim() : null;
     const current = version === SERVER_VERSION;
@@ -32663,7 +32762,7 @@ function inspectProject(projectPath) {
     }
     return { name, installed, version, current };
   });
-  const settings = parseProjectGodot(readFileSync18(join19(projectPath, "project.godot"), "utf8"));
+  const settings = parseProjectGodot(readFileSync18(join20(projectPath, "project.godot"), "utf8"));
   const pluginsEnabled = enabledPlugins(settings);
   for (const name of EDITOR_PLUGINS) {
     if (!pluginsEnabled.includes(name)) {
@@ -32679,7 +32778,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 (!existsSync15(join19(projectPath, path))) {
+    if (!existsSync15(join20(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`);
       }
@@ -33085,7 +33184,7 @@ var TOOL_SPECS = [
   },
   {
     name: "project_test",
-    description: "Runs the project's gdUnit4 tests headless and answers with every case that did not pass: where it is, and what the assertion said. Suites where everything passed are counted rather than listed, and an engine message keeps the frames above gdUnit4 rather than the twenty inside it, so a clean tier answers in a few lines. The class list is rebuilt first, so a suite written a moment ago is found, and the rebuild's answer is under classes, with the classes each addon declares counted under addedInAddons and changedInAddons rather than named: a class it puts back that the cache had after the last rebuild is named under classes.lostSinceLastRebuild, which is the editor writing its shorter list over the file on every save until restarted. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. On macOS the engine reads user:// off HOME and the run writes where the player keeps theirs, which the answer says under savesNote rather than leaving to be found in a save list. A run that found nothing to run is never called a pass: gdUnit4 exits cleanly for one, so the answer says so and names the path it looked in. A script that does not load stops gdUnit4 before any suite runs: its errors come back in full under scriptErrors, and the scripts that failed only because one they depend on did are listed by path under failedThroughDependency. A run where nothing failed but nodes were left in the tree comes back under warnings, with the count per suite: gdUnit4 decides its verdict on those and keeps them out of its report, so they are read off what it printed. Needs gdUnit4 under addons/gdUnit4.",
+    description: "Runs the project's gdUnit4 tests headless and answers with every case that did not pass: where it is, and what the assertion said. Suites where everything passed are counted rather than listed, and an engine message keeps the frames above gdUnit4 rather than the twenty inside it, so a clean tier answers in a few lines. The class list is rebuilt first, so a suite written a moment ago is found, and the rebuild's answer is under classes, with the classes each addon declares counted under addedInAddons and changedInAddons rather than named: a class it puts back that the cache had after the last rebuild is named under classes.lostSinceLastRebuild, which is the editor writing its shorter list over the file on every save until restarted. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. On macOS the engine reads user:// off HOME and the run writes where the player keeps theirs, which the answer says under savesNote rather than leaving to be found in a save list. A run that found nothing to run is never called a pass: gdUnit4 exits cleanly for one, so the answer says so and names the path it looked in. A script that does not load stops gdUnit4 before any suite runs: its errors come back in full under scriptErrors, and the scripts that failed only because one they depend on did are listed by path under failedThroughDependency. When they failed on a class whose own script has a parser error, which gdUnit4 never names, that script is checked by the engine and its error comes first under scriptErrors, with the class it declares under declares. A run where nothing failed but nodes were left in the tree comes back under warnings, with the count per suite: gdUnit4 decides its verdict on those and keeps them out of its report, so they are read off what it printed. Needs gdUnit4 under addons/gdUnit4.",
     parameters: {
       projectPath: PROJECT_PATH,
       path: {
@@ -33655,7 +33754,7 @@ var TOOL_SPECS = [
       says: {
         type: "string",
         ops: ["find"],
-        description: 'find: part of what the node has written on it as drawn, the way the text op reads it, case-insensitively, which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern, and a glob that finds nothing says under note how many nodes it would find open at both ends. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Alternatives separated by | match when any one of them does, each by these rules ("*won*|*lost*"); write \\| for a bar that is part of the words.'
+        description: 'find: part of what the node has written on it as drawn, the way the text op reads it, case-insensitively and with a typed space matching any space the game draws (a non-breaking one included), which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern, and a glob that finds nothing says under note how many nodes it would find open at both ends. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Alternatives separated by | match when any one of them does, each by these rules ("*won*|*lost*"); write \\| for a bar that is part of the words.'
       },
       limit: {
         type: "integer",
@@ -33833,7 +33932,7 @@ var TOOL_SPECS = [
       says: {
         type: "string",
         ops: ["click"],
-        description: "click: the words on the control to click, matched the way runtime_inspect find matches says (a plain word is contained in the text, a pattern with * or ? is a glob over it, and | separates alternatives), among the controls on screen, and pressed in the same frame it was found in, so a panel rebuilding between a find and a click cannot free it first. Words on a label inside a button press the button. A control with something drawn over its centre that would take the pointer, such as a screen shown over it or a dialog stacked above its own, is not on screen; nor is one on a hidden canvas layer, one outside the viewport, or one a container clips away that a click does not scroll. The refusal counts those apart. The matches are ranked the way a person picks what to press: an enabled button before anything else, a disabled one included, then a control whose whole text, or one whole line of it such as the title on a card, is the words before one saying them as part of more, and the best one is pressed; found.picked says why. Several matches at the best rank are refused with each one listed, and index picks one. A match saying the words only as part of more is named under found.partOf, and is refused when a control saying exactly the words is hidden, off the screen or covered, since it would stand in for that one; index presses it anyway. An empty field says its placeholder. An item of an open menu is drawn by the menu rather than held as a control, so a click finds none, and the refusal names the menu and the choose call that picks it."
+        description: "click: the words on the control to click, matched the way runtime_inspect find matches says (a plain word is contained in the text, a pattern with * or ? is a glob over it, and | separates alternatives), among the controls on screen, and pressed in the same frame it was found in, so a panel rebuilding between a find and a click cannot free it first. Words on a label inside a button press the button. A control with something drawn over its centre that would take the pointer, such as a screen shown over it or a dialog stacked above its own, is not on screen; nor is one on a hidden canvas layer, one outside the viewport, or one a container clips away that a click does not scroll. The refusal counts those apart. The matches are ranked the way a person picks what to press: an enabled button before anything else, a disabled one included, then a control whose whole text, or one whole line of it such as the title on a card, is the words before one saying them as part of more, and the best one is pressed; found.picked says why. Several matches at the best rank are refused with each one listed, and index picks one. A match saying the words only as part of more is named under found.partOf, and is refused when another control says exactly the words (hidden, off the screen, covered, or on screen taking clicks without being a button), since it would stand in for that one, and when it lets the pointer through to what is under it; index presses it anyway. Words found only inside longer words (\"out\" in \"Scout\") rank after every other match and are refused unless index is given; words starting a longer word (\"Recruit\" in \"Recruits\") count. An empty field says its placeholder, and a control with no text of its own, a picture on a button, says its accessibility name. An item of an open menu is drawn by the menu rather than held as a control, so a click finds none, and the refusal names the menu and the choose call that picks it."
       },
       action: {
         type: "string",
@@ -34114,7 +34213,7 @@ function captureDestinationRefusal(outputPath, projects) {
   if (!existsSync16(directory)) {
     return `outputPath's directory ${dirname14(outputPath)} does not exist; a capture creates no directories.`;
   }
-  const where = join20(directory, basename5(outputPath));
+  const where = join21(directory, basename5(outputPath));
   const inside = projects.find((project) => project !== "" && isWithinRoot(realPathOr(project), where));
   if (inside !== undefined) {
     return `outputPath ${outputPath} is inside the project at ${inside}; a capture is saved outside it, so it never becomes part of the game.`;
@@ -34635,7 +34734,13 @@ function foldedScriptErrors(errors) {
 function nonEmpty(lists) {
   return Object.fromEntries(Object.entries(lists).filter(([, list]) => list.length > 0));
 }
-function scriptErrorsNote(errors) {
+function scriptErrorsNote(errors, {
+  origins,
+  unconfirmed
+} = {
+  origins: [],
+  unconfirmed: []
+}) {
   const { scriptErrors: own, failedThroughDependency: dependents } = foldedScriptErrors(errors);
   const causes = new Map;
   for (const error of own) {
@@ -34644,7 +34749,22 @@ function scriptErrorsNote(errors) {
     }
   }
   const scripts = causes.size + dependents.length;
-  const named = [...causes.values()].map((error) => `${error.line === null ? error.path : `${error.path}:${error.line}`} ${error.message}${/[.!?]\)?$/.test(error.message) ? "" : "."}`).join(" ");
+  const at = (error) => error.line === null ? error.path : `${error.path}:${error.line}`;
+  const sentence = (text) => `${text}${/[.!?]\)?$/.test(text) ? "" : "."}`;
+  const traced = new Set;
+  const failedOn = (declares) => {
+    const through = [...causes.values()].filter((error) => unresolvedClassIn(error.message) === declares);
+    for (const error of through) {
+      traced.add(error.path);
+    }
+    return through.length === 0 ? "" : ` ${through.map(at).join(", ")} could not resolve ${declares} because of it.`;
+  };
+  const first = [...new Map(origins.map((origin) => [origin.path, origin])).values()].sort((a, b) => Number(unresolvedClassIn(a.message) !== null) - Number(unresolvedClassIn(b.message) !== null));
+  const named = [
+    ...first.map((origin) => `${at(origin)} ${sentence(origin.message)} gdUnit4 did not name this script, which declares ${origin.declares}; the engine's own check of it found the error.${failedOn(origin.declares)}`),
+    ...unconfirmed.map((origin) => `${origin.path} declares ${origin.declares}, which gdUnit4 did not name, and ${origin.why}.${failedOn(origin.declares)}`),
+    ...[...causes.values()].filter((error) => !traced.has(error.path)).map((error) => `${at(error)} ${sentence(error.message)}`)
+  ].join(" ");
   const following = dependents.length === 0 ? "" : causes.size === 0 ? `${dependents.join(", ")} ${dependents.length === 1 ? "depends" : "depend"} on a script that did not compile, and gdUnit4 named none with an error of its own: script_diagnostics on one of them finds it.` : `${dependents.length === 1 ? "One more" : `${dependents.length} more`} failed only because a script ${dependents.length === 1 ? "it depends" : "they depend"} on did: ${dependents.join(", ")}.`;
   const more = own.length - causes.size;
   const rest = more > 0 ? `${more === 1 ? "One more error" : `${more} more errors`} in ${causes.size === 1 ? "that script" : "those scripts"} ${more === 1 ? "is" : "are"} under scriptErrors.` : "";
@@ -34743,7 +34863,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync16(join20(projectPath, wanted))) {
+  if (wanted === "" || existsSync16(join21(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -34795,7 +34915,7 @@ function runtimeAddonAnnouncesEditors(projectPath) {
     return false;
   }
   try {
-    return readFileSync19(join20(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
+    return readFileSync19(join21(projectPath, RUNTIME_AUTOLOAD.path), "utf8").includes('"editor_pid"');
   } catch {
     return false;
   }
@@ -34820,7 +34940,7 @@ function needsItsOwnProcess(asked) {
 class GodotServer {
   mcp;
   locator = new GodotLocator;
-  operationsScript = join20(__dirname2, "godot", "operations", "godot_operations.gd");
+  operationsScript = join21(__dirname2, "godot", "operations", "godot_operations.gd");
   godotBridge;
   tools = buildToolDefinitions();
   activeProcess = null;
@@ -35123,7 +35243,7 @@ class GodotServer {
         return checked.response;
       }
       const named = args["projectPath"];
-      if (typeof named === "string" && existsSync16(join20(named, "project.godot"))) {
+      if (typeof named === "string" && existsSync16(join21(named, "project.godot"))) {
         this.lastProjectPath = named;
       }
       this.updates.refresh();
@@ -35597,7 +35717,7 @@ class GodotServer {
     if (path === undefined) {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
-    const file = join20(path, "project.godot");
+    const file = join21(path, "project.godot");
     if (!existsSync16(file)) {
       return {
         ok: false,
@@ -36276,7 +36396,7 @@ class GodotServer {
     const exportArgs = [
       "--headless",
       "--log-file",
-      join20(exportLogs, "engine.log"),
+      join21(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -36306,7 +36426,7 @@ class GodotServer {
     if (!paths.ok) {
       return this.createErrorResponse(paths.reason, PATH_SOLUTIONS);
     }
-    const missing = paths.value.filter((path) => !existsSync16(join20(project.value.path, path.slice("res://".length))));
+    const missing = paths.value.filter((path) => !existsSync16(join21(project.value.path, path.slice("res://".length))));
     const asked = paths.value.filter((path) => !missing.includes(path));
     if (asked.length === 0) {
       const verdict = `nothing at ${missing.join(" and ")}`;
@@ -36322,7 +36442,7 @@ class GodotServer {
       };
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync16(join20(project.value.path, runner))) {
+    if (!existsSync16(join21(project.value.path, runner))) {
       return this.createErrorResponse(`gdUnit4 is not installed in this project: no ${runner}.`, [
         "Install gdUnit4 under addons/gdUnit4, from https://github.com/godot-gdunit-labs/gdUnit4"
       ]);
@@ -36387,14 +36507,14 @@ class GodotServer {
       await untilGone([run.process.pid]);
     }
     await run.settled;
-    const reportsDir = join20(project.value.path, ".godot", ...ours.split("/"));
+    const reportsDir = join21(project.value.path, ".godot", ...ours.split("/"));
     let report = null;
     let reportProblem = null;
     try {
       const written = existsSync16(reportsDir) ? readdirSync9(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(readFileSync19(join20(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync19(join21(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -36423,7 +36543,9 @@ class GodotServer {
     const nothingRan = timedOut ? null : whyNoReport(said, asked.join(" and "));
     const cutShort = timedOut ? timedOutVerdict(timeoutMs, silentForMs) : null;
     const hung = cutShort?.hung ?? false;
-    const scriptErrors = timedOut || exitCode !== 105 ? [] : scriptErrorsPrinted(said);
+    const printedErrors = timedOut || exitCode !== 105 ? [] : scriptErrorsPrinted(said);
+    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) ?? (exitCode === null ? undefined : verdicts[exitCode]) ?? (run.exitSignal === null ? `exit ${exitCode ?? "unknown"}` : howItExited(run));
     const nothingAt = missing.join(" and ");
@@ -36437,7 +36559,7 @@ class GodotServer {
       ...echoed.omitted > 0 ? { printedOmitted: echoed.omitted } : {}
     };
     if (report === null) {
-      const said = nothingRan !== null ? `No tests ran: ${ranAs}.` : scriptErrors.length > 0 ? scriptErrorsNote(scriptErrors) : reportProblem !== null ? `The test run's report could not be read (${reportProblem}); the engine's own verdict was ${ranAs}.` : `The test run wrote no report (${ranAs}).`;
+      const said = nothingRan !== null ? `No tests ran: ${ranAs}.` : scriptErrors.length > 0 ? scriptErrorsNote(printedErrors, declaring) : reportProblem !== null ? `The test run's report could not be read (${reportProblem}); the engine's own verdict was ${ranAs}.` : `The test run wrote no report (${ranAs}).`;
       const note = missingNote === undefined ? said : `${said} ${missingNote}`;
       return {
         content: [
@@ -36455,7 +36577,7 @@ class GodotServer {
               ...missing.length > 0 ? { missing } : {},
               ...nonEmpty(foldedScriptErrors(scriptErrors)),
               arguments: cmdArgs,
-              entries: forAnswer(printed.slice(0, 60).map(aboveTheRunner)),
+              entries: forAnswer(withoutListed(printed, scriptErrors).slice(0, 60).map(aboveTheRunner)),
               ...printedLines,
               savesNote,
               ...scanned
@@ -36963,7 +37085,7 @@ class GodotServer {
       return null;
     }
     try {
-      return settingKeys(readFileSync19(join20(projectPath, "project.godot"), "utf8"));
+      return settingKeys(readFileSync19(join21(projectPath, "project.godot"), "utf8"));
     } catch {
       return null;
     }
@@ -37285,7 +37407,7 @@ class GodotServer {
   }
   async runtimeUp(projectPath, before, budget, withArgs) {
     const budgetMs = budget.ms;
-    if (!existsSync16(join20(projectPath, RUNTIME_AUTOLOAD.path))) {
+    if (!existsSync16(join21(projectPath, RUNTIME_AUTOLOAD.path))) {
       return runtimeVerdict(null, {
         addon: false,
         budgetMs,
@@ -38302,7 +38424,7 @@ class GodotServer {
       notes.push(endedWithoutACode({
         throughEditor: run.throughEditor,
         announced: announced !== undefined || run.announcedPid !== undefined,
-        couldAnnounce: run.projectPath !== null && existsSync16(join20(run.projectPath, RUNTIME_AUTOLOAD.path)),
+        couldAnnounce: run.projectPath !== null && existsSync16(join21(run.projectPath, RUNTIME_AUTOLOAD.path)),
         endedHere: typeof run.endedHere === "string",
         pickedUp: run.pickedUp === true
       }));
@@ -39151,7 +39273,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) || !existsSync16(join20(project, RUNTIME_AUTOLOAD.path)) || !await this.runStillGoing(run)) {
+    if (run === null || project === null || run.announcedPid !== undefined || run.projectPath !== null && !isSameDirectory(run.projectPath, project) || !existsSync16(join21(project, RUNTIME_AUTOLOAD.path)) || !await this.runStillGoing(run)) {
       return null;
     }
     const already = runtimesAnnounced().running;
@@ -39235,7 +39357,7 @@ class GodotServer {
       }
     }
     const screenshotDir = expectsScreenshot ? scratchDirectory("runtime-screenshot") : null;
-    const screenshotPath = screenshotDir ? join20(screenshotDir, "capture.png") : null;
+    const screenshotPath = screenshotDir ? join21(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}

package/package.json

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