gdharness 0.12.9 → 0.12.11

package/build/cli.js

@@ -7401,7 +7401,7 @@ class UpdateCheck {
     }
   }
   refresh(now = Date.now()) {
-    if (!this.enabled || this.checking || now < this.retryAt || now - this.checkedAt < CACHE_MS) {
+    if (!this.enabled || this.checking || now < this.retryAt || !this.stale(now)) {
       return;
     }
     this.checking = true;
@@ -7421,6 +7421,9 @@ class UpdateCheck {
       this.checking = false;
     });
   }
+  stale(now) {
+    return now - this.checkedAt >= CACHE_MS;
+  }
   scheduleRetry(now) {
     this.retryAt = now + this.backoffMs;
     this.backoffMs = Math.min(this.backoffMs * 2, MAX_RETRY_MS);
@@ -7430,7 +7433,7 @@ class UpdateCheck {
     if (!this.enabled || latest === null || !isNewer(latest, this.current)) {
       return null;
     }
-    if (this.checking && now - this.checkedAt >= CACHE_MS) {
+    if (this.checking && this.stale(now)) {
       return null;
     }
     return {
@@ -7527,9 +7530,7 @@ function staleClassNames(projectPath) {
 }
 function unseenByEditor(projectPath, editorHolds) {
   const held = new Set(editorHolds);
-  const declared = declaredClasses(projectPath);
-  const source = cachedClasses(projectPath) ?? declared;
-  return [...source].filter(([name]) => !held.has(name) && declared.has(name)).map(([className, path]) => ({ className, path: declared.get(className) ?? path }));
+  return [...declaredClasses(projectPath)].filter(([name]) => !held.has(name)).map(([className, path]) => ({ className, path }));
 }
 var init_class_cache = () => {};
 
@@ -15323,7 +15324,7 @@ var init_tool_definitions = __esm(() => {
     },
     {
       name: "project_search",
-      description: "Searches text or a regular expression across project files and returns file paths with line numbers.",
+      description: "Searches text or a regular expression across project files and returns file paths with line numbers. What the engine steps over is not searched: directories spelled with a dot, node_modules, and any directory holding a .gdignore. A vendored engine or an export directory is therefore absent from the results rather than matching the code you are looking for in a copy nobody runs.",
       parameters: {
         projectPath: PROJECT_PATH,
         query: { type: "string", description: "The text or pattern to find." },
@@ -15762,7 +15763,7 @@ var init_tool_definitions = __esm(() => {
     },
     {
       name: "editor_rescan",
-      description: "Makes the running editor scan the project filesystem, so files written outside it are picked up. The scan is a change-detecting walk rather than an unconditional reparse, so a file another engine has already imported reads as settled and the walk does not look inside it: its class_name then stays out of the list the editor resolves against, however many times you scan. Any class in that state is named under unseenByEditor, which is what no check on disk can see, since the declaration and the cache are both correct there and only the editor disagrees. The cure is a change to the declaring script, or editor_launch restart; project_import refresh_classes rewrites the cache and does not touch what the editor is holding. Needs the editor connected.",
+      description: "Makes the running editor scan the project filesystem, so files written outside it are picked up. The scan is a change-detecting walk rather than an unconditional reparse, so a file another engine has already imported reads as settled and the walk does not look inside it: its class_name then stays out of the list the editor resolves against, however many times you scan. Any class in that state is named under unseenByEditor, which is what no check on disk can see, since the declaration and the cache are both correct there and only the editor disagrees. The cure is a change to the declaring script, or editor_launch restart; project_import refresh_classes rewrites the cache and does not touch what the editor is holding. The scan also writes .godot/global_script_class_cache.cfg from the list the editor is holding, so a class it cannot resolve is one the scan drops out of that file: unseenByEditor names it before a fresh engine, a CI run or a clone inherits it. Needs the editor connected.",
       parameters: {
         projectPath: PROJECT_PATH,
         timeoutMs: { type: "number", description: "How long to wait for the scan. Default 30000." }
@@ -15845,7 +15846,7 @@ var init_tool_definitions = __esm(() => {
         limit: {
           type: "number",
           ops: ["find", "text"],
-          description: "find: the most nodes to answer with, default 100. text: the most lines, default 500, with truncated saying whether there were more."
+          description: "find: the most nodes to answer with, default 100. text: the most lines, default 500, with omitted saying how many lines that left behind. A screen whose dialog sits under a long list is a screen read with omitted greater than zero, so raise this or point root at the dialog rather than reading the answer as what is on screen."
         },
         includeHidden: {
           type: "boolean",
@@ -35785,13 +35786,22 @@ var init_lsp_client = __esm(() => {
 });
 
 // src/project-scan.ts
-import { readdirSync as readdirSync4, readFileSync as readFileSync10 } from "node:fs";
+import { existsSync as existsSync10, readdirSync as readdirSync4, readFileSync as readFileSync10 } from "node:fs";
 import { join as join12 } from "node:path";
+function skipped(name) {
+  return name.startsWith(".") || SKIPPED.has(name);
+}
+function steppedOver(directory) {
+  return existsSync10(join12(directory, ".gdignore"));
+}
 function projectStructure(projectPath) {
   const structure = { scenes: 0, scripts: 0, assets: 0, other: 0 };
   const visit = (directory) => {
+    if (steppedOver(directory)) {
+      return;
+    }
     for (const entry of readdirSync4(directory, { withFileTypes: true })) {
-      if (entry.name.startsWith(".")) {
+      if (skipped(entry.name)) {
         continue;
       }
       if (entry.isDirectory()) {
@@ -35830,11 +35840,14 @@ function searchProject(projectPath, options) {
     return false;
   };
   const visit = (directory) => {
+    if (steppedOver(directory)) {
+      return;
+    }
     for (const entry of readdirSync4(directory, { withFileTypes: true })) {
       if (full()) {
         return;
       }
-      if (SKIPPED.has(entry.name)) {
+      if (skipped(entry.name)) {
         continue;
       }
       const entryPath = join12(directory, entry.name);
@@ -35871,12 +35884,12 @@ function searchProject(projectPath, options) {
 }
 var SKIPPED, ASSET_EXTENSIONS;
 var init_project_scan = __esm(() => {
-  SKIPPED = new Set([".git", ".godot", ".import", "node_modules"]);
+  SKIPPED = new Set(["node_modules"]);
   ASSET_EXTENSIONS = new Set(["png", "jpg", "jpeg", "webp", "svg", "ttf", "otf", "wav", "mp3", "ogg"]);
 });
 
 // src/runtime-client.ts
-import { existsSync as existsSync10, readdirSync as readdirSync5, readFileSync as readFileSync11, unlinkSync } from "node:fs";
+import { existsSync as existsSync11, readdirSync as readdirSync5, readFileSync as readFileSync11, 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";
@@ -35947,7 +35960,7 @@ function discoverRuntimes(directories = runtimeDirectories()) {
   return runtimesAnnounced(directories).running;
 }
 function announcedIn(directory) {
-  if (!existsSync10(directory)) {
+  if (!existsSync11(directory)) {
     return [];
   }
   const found = [];
@@ -36284,11 +36297,11 @@ var init_run_record = __esm(() => {
 });
 
 // src/setup.ts
-import { cpSync as cpSync2, existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync13, rmSync as rmSync8, writeFileSync as writeFileSync9 } from "node:fs";
+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";
 function installedAddonVersion(projectPath) {
   const marker = join15(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
-  if (!existsSync11(marker)) {
+  if (!existsSync12(marker)) {
     return null;
   }
   const said = readFileSync13(marker, "utf8").trim();
@@ -36311,7 +36324,7 @@ var init_setup = __esm(() => {
 import { execFile as execFile5, spawn } from "node:child_process";
 import {
   closeSync,
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   fstatSync,
   mkdirSync as mkdirSync8,
   mkdtempSync as mkdtempSync3,
@@ -36459,7 +36472,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync12(join16(projectPath, wanted))) {
+  if (wanted === "" || existsSync13(join16(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -37076,7 +37089,7 @@ class GodotServer {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
     const file = join16(path, "project.godot");
-    if (!existsSync12(file)) {
+    if (!existsSync13(file)) {
       return {
         ok: false,
         response: this.createErrorResponse(`Not a Godot project: ${path}`, [
@@ -37340,7 +37353,7 @@ class GodotServer {
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
     const verdict = {
-      exported: exitCode === 0 && log.count("error") === 0 && existsSync12(output.absolutePath),
+      exported: exitCode === 0 && log.count("error") === 0 && existsSync13(output.absolutePath),
       preset,
       outputPath: output.relativePath,
       debug,
@@ -37370,7 +37383,7 @@ class GodotServer {
       return contained.response;
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync12(join16(project.value.path, runner))) {
+    if (!existsSync13(join16(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"
       ]);
@@ -37424,7 +37437,7 @@ class GodotServer {
     let report = null;
     let reportProblem = null;
     try {
-      const written = existsSync12(reportsDir) ? readdirSync7(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
+      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 newest = written.at(-1);
       if (newest !== undefined) {
         report = parseJUnit(readFileSync14(join16(reportsDir, newest, "results.xml"), "utf8"));
@@ -37844,7 +37857,7 @@ class GodotServer {
     return runIsUp(run, editorSays);
   }
   async runtimeUp(projectPath, before, budgetMs) {
-    if (!existsSync12(join16(projectPath, RUNTIME_AUTOLOAD2.path))) {
+    if (!existsSync13(join16(projectPath, RUNTIME_AUTOLOAD2.path))) {
       return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false });
     }
     const endpoint = await announcedSince(projectPath, before, {
@@ -38474,7 +38487,7 @@ var init_server3 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync13 } from "fs";
+import { existsSync as existsSync14 } from "fs";
 import { join as join17, resolve as resolve5 } from "path";
 
 // src/errors.ts
@@ -39851,7 +39864,7 @@ that is running, and the project on disk. ${TOOL_SPECS.length} tools, named \`do
 
 | Ask | Tool |
 | --- | --- |
-| What a screen says | \`runtime_inspect text\`, which reads what is drawn and leaves out what is hidden |
+| What a screen says | \`runtime_inspect text\`, which reads what is drawn and leaves out what is hidden. Read \`omitted\`: a long list above a dialog pushes it past the limit, and what comes back then is the top of the screen rather than the screen |
 | Find a control by the word on it | \`runtime_inspect find\` with \`says\`, rather than listing a screen and reading each one |
 | Where a control is, and whether it is visible | \`runtime_inspect\` \`find\`, \`rect\` |
 | What a property reads right now | \`runtime_inspect\` \`property\`, \`runtime_invoke\` |
@@ -39890,12 +39903,21 @@ formatting. \`script_diagnostics\` and \`script_info\` come from the editor's ow
 \`editor_classes\` need nothing open: they run a short headless engine and are gone before the
 answer is printed.
 
+Editing a file while a game is running does not change the running game. \`auto_reload\` is an
+editor plugin and reloads into the editor's own process; the game is a separate process holding
+its own copy. So a long run is not a reason to stop editing, and the new code arrives on the next
+\`editor_run start\`.
+
 A wall of "Could not find type" on the project's own classes means the editor is not holding
 them. \`editor_rescan\` asks it to scan and names any class it still cannot resolve under
 \`unseenByEditor\`: its walk skips a file a headless engine has already imported, so the
 declaration and the cache can both be right while the editor stays blind to it. Change the
 declaring script, or restart the editor.
 
+The scan writes \`.godot/global_script_class_cache.cfg\` from the list the editor is holding, so
+a class it cannot resolve is dropped out of that file too, and the next fresh engine, CI run or
+clone starts from the narrower one. That is the same class \`unseenByEditor\` names.
+
 A diagnostic about a member rather than a type, \`Static function "x()" not found in base "Y"\`
 about something the engine compiles, is a different thing and is no longer stale here: each ask
 gives the document back when its answer arrives, so the next one is read off disk. If one turns
@@ -40013,7 +40035,7 @@ class UsageError extends Refusal {
 function projectArgument(at) {
   const named = args.slice(at).find((value) => !value.startsWith("--"));
   const projectPath = resolve5(named ?? ".");
-  if (!existsSync13(join17(projectPath, "project.godot"))) {
+  if (!existsSync14(join17(projectPath, "project.godot"))) {
     throw new UsageError(`Not a Godot project: ${projectPath} holds no project.godot.`);
   }
   return projectPath;
@@ -40047,7 +40069,7 @@ async function registerRuntime(godot, projectPath) {
     return;
   }
   console.log(`${RUNTIME_AUTOLOAD.name} autoload left at ${named}, which this project registers itself`);
-  if (!existsSync13(join17(projectPath, (named ?? "").replace(/^res:\/\//, "")))) {
+  if (!existsSync14(join17(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}`);
   }
 }
@@ -40179,7 +40201,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, existsSync13);
+      const directories = skillDirectories(chosen.harnesses, projectPath, existsSync14);
       for (const written of writeSkill(directories, getLocalVersion())) {
         console.log(`skill: ${written.replaced ? "replaced" : "written"} ${written.path}`);
       }
@@ -40268,7 +40290,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, existsSync13), version)) {
+  for (const written of writeSkill(skillDirectories(already, projectPath, existsSync14), version)) {
     console.log(`skill: ${written.replaced ? "replaced" : "written"} ${written.path}`);
   }
   console.log(`

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

@@ -258,7 +258,8 @@ func _matches_apart_from_name(node: Node, wanted: Dictionary[String, String]) ->
 ##
 ## [param limit] is the first few lines rather than all of them, which is how the top of a screen
 ## is read without the hall under it: the bar along the top of a guild is eleven lines and the
-## panel it sits on is two hundred.
+## panel it sits on is two hundred. `omitted` says how many lines that left behind, so a screen
+## whose interesting half is below the cut says so in a number rather than in a flag.
 func read_text(params: Dictionary) -> Dictionary:
 	var root_path: String = str(params.get("root", "/root"))
 	var include_hidden: bool = bool(params.get("include_hidden", false))
@@ -269,19 +270,20 @@ func read_text(params: Dictionary) -> Dictionary:
 		return reached
 	var root: Node = reached["node"]
 
-	# One line further than asked for, so that whether anything was left behind is read off the
-	# walk rather than guessed at from the count: a panel of exactly as many lines as the caller
-	# asked for is one they have read all of, and saying otherwise sends them back for nothing.
-	var read: PackedStringArray = PackedStringArray()
-	_read_into(root, include_hidden, limit + 1, read)
-	var more: bool = read.size() > limit
-	var lines: PackedStringArray = read.slice(0, limit) if more else read
+	# The rest of the subtree is walked and counted rather than stopped at. A flag on its own gets
+	# read as a footnote: a screen answered with its first few hundred lines and the dialog the
+	# player is being asked to answer below them reads exactly like a dialog that is not there,
+	# and a bare `truncated: true` was looked straight past twice before the limit was suspected.
+	# A number is what sends somebody back.
+	var lines: PackedStringArray = PackedStringArray()
+	var left_out: int = _read_into(root, include_hidden, limit, lines)
 	return {
 		"type": "text",
 		"root": root_path,
 		"lines": lines,
 		"count": lines.size(),
-		"truncated": more,
+		"truncated": left_out > 0,
+		"omitted": left_out,
 	}
 
 
@@ -293,16 +295,21 @@ func read_text(params: Dictionary) -> Dictionary:
 ## screen full of forms answered with every label on it and none of the values in it. The hidden
 ## check covers a [Window] for the same walk: a dropdown's popup is a child that is not drawn
 ## until it is opened, and reading a closed menu would put every item on the screen.
-func _read_into(node: Node, include_hidden: bool, most: int, into: PackedStringArray) -> void:
-	if into.size() >= most:
-		return
+## Fills [param into] up to [param most] lines and answers with how many further lines the rest of
+## the subtree says, which is what the caller is told rather than left to infer.
+func _read_into(node: Node, include_hidden: bool, most: int, into: PackedStringArray) -> int:
 	if not include_hidden and not _drawn(node):
-		return
+		return 0
+	var left_out: int = 0
 	var said: String = said_by(node)
 	if not said.is_empty():
-		into.append(said)
+		if into.size() < most:
+			into.append(said)
+		else:
+			left_out += 1
 	for child: Node in node.get_children(true):
-		_read_into(child, include_hidden, most, into)
+		left_out += _read_into(child, include_hidden, most, into)
+	return left_out
 
 
 ## Whether [param node] is on the screen at all, for the three kinds of thing that can be hidden.

package/build/godot/operations/file_walk.gd

@@ -4,11 +4,23 @@ extends RefCounted
 # walk descends into every visible directory and matches whole names, while the extension walk
 # skips anything beginning with a dot, including .import sidecars that would otherwise answer
 # for the resource they belong to.
+#
+# Both stop at a `.gdignore`, because the engine does: nothing under one is imported, so what is
+# in there is not a resource, not a dependency and not a global class. Walking in anyway hands
+# every caller files the engine will never answer for.
+
+
+# A directory the engine steps over, marker file and all.
+func is_stepped_over(path: String) -> bool:
+	return FileAccess.file_exists(path + ".gdignore")
 
 
 # Files under `path` whose name ends with `extension`, which is passed with its dot.
 func find_files(path: String, extension: String) -> Array[String]:
 	var files: Array[String] = []
+	if is_stepped_over(path):
+		return files
+
 	var dir: DirAccess = DirAccess.open(path)
 
 	if dir:
@@ -29,6 +41,9 @@ func find_files(path: String, extension: String) -> Array[String]:
 # Files under `path` whose extension is in `extensions`, which are passed without their dot.
 func find_files_with_extensions(path: String, extensions: Array) -> Array[String]:
 	var files: Array[String] = []
+	if is_stepped_over(path):
+		return files
+
 	var dir: DirAccess = DirAccess.open(path)
 
 	if dir:

package/build/index.js

@@ -9972,7 +9972,7 @@ class UpdateCheck {
     }
   }
   refresh(now = Date.now()) {
-    if (!this.enabled || this.checking || now < this.retryAt || now - this.checkedAt < CACHE_MS) {
+    if (!this.enabled || this.checking || now < this.retryAt || !this.stale(now)) {
       return;
     }
     this.checking = true;
@@ -9992,6 +9992,9 @@ class UpdateCheck {
       this.checking = false;
     });
   }
+  stale(now) {
+    return now - this.checkedAt >= CACHE_MS;
+  }
   scheduleRetry(now) {
     this.retryAt = now + this.backoffMs;
     this.backoffMs = Math.min(this.backoffMs * 2, MAX_RETRY_MS);
@@ -10001,7 +10004,7 @@ class UpdateCheck {
     if (!this.enabled || latest === null || !isNewer(latest, this.current)) {
       return null;
     }
-    if (this.checking && now - this.checkedAt >= CACHE_MS) {
+    if (this.checking && this.stale(now)) {
       return null;
     }
     return {
@@ -10131,7 +10134,7 @@ function defectReport(where, error, godotVersion) {
 import { execFile as execFile3, spawn } from "node:child_process";
 import {
   closeSync,
-  existsSync as existsSync7,
+  existsSync as existsSync8,
   fstatSync,
   mkdirSync as mkdirSync5,
   mkdtempSync as mkdtempSync2,
@@ -24815,9 +24818,7 @@ function staleClassNames(projectPath) {
 }
 function unseenByEditor(projectPath, editorHolds) {
   const held = new Set(editorHolds);
-  const declared = declaredClasses(projectPath);
-  const source = cachedClasses(projectPath) ?? declared;
-  return [...source].filter(([name]) => !held.has(name) && declared.has(name)).map(([className, path]) => ({ className, path: declared.get(className) ?? path }));
+  return [...declaredClasses(projectPath)].filter(([name]) => !held.has(name)).map(([className, path]) => ({ className, path }));
 }
 
 // src/dap_client.ts
@@ -27195,15 +27196,24 @@ async function handleLSPTool(client, toolName, args) {
 }
 
 // src/project-scan.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync5 } from "node:fs";
 import { join as join6 } from "node:path";
-var SKIPPED = new Set([".git", ".godot", ".import", "node_modules"]);
+var SKIPPED = new Set(["node_modules"]);
+function skipped(name) {
+  return name.startsWith(".") || SKIPPED.has(name);
+}
+function steppedOver(directory) {
+  return existsSync5(join6(directory, ".gdignore"));
+}
 var ASSET_EXTENSIONS = new Set(["png", "jpg", "jpeg", "webp", "svg", "ttf", "otf", "wav", "mp3", "ogg"]);
 function projectStructure(projectPath) {
   const structure = { scenes: 0, scripts: 0, assets: 0, other: 0 };
   const visit = (directory) => {
+    if (steppedOver(directory)) {
+      return;
+    }
     for (const entry of readdirSync3(directory, { withFileTypes: true })) {
-      if (entry.name.startsWith(".")) {
+      if (skipped(entry.name)) {
         continue;
       }
       if (entry.isDirectory()) {
@@ -27242,11 +27252,14 @@ function searchProject(projectPath, options) {
     return false;
   };
   const visit = (directory) => {
+    if (steppedOver(directory)) {
+      return;
+    }
     for (const entry of readdirSync3(directory, { withFileTypes: true })) {
       if (full()) {
         return;
       }
-      if (SKIPPED.has(entry.name)) {
+      if (skipped(entry.name)) {
         continue;
       }
       const entryPath = join6(directory, entry.name);
@@ -27505,7 +27518,7 @@ import { mkdirSync as mkdirSync3, openSync, readdirSync as readdirSync5, readFil
 import { basename, join as join8 } from "node:path";
 
 // src/runtime-client.ts
-import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync7, unlinkSync } from "node:fs";
+import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync7, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join7, resolve as resolve4 } from "node:path";
@@ -27631,7 +27644,7 @@ function discoverRuntimes(directories = runtimeDirectories()) {
   return runtimesAnnounced(directories).running;
 }
 function announcedIn(directory) {
-  if (!existsSync5(directory)) {
+  if (!existsSync6(directory)) {
     return [];
   }
   const found = [];
@@ -27961,7 +27974,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
 }
 
 // src/setup.ts
-import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync9, rmSync as rmSync4, writeFileSync as writeFileSync5 } from "node:fs";
+import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync9, rmSync as rmSync4, writeFileSync as writeFileSync5 } from "node:fs";
 import { dirname as dirname3, join as join9 } from "node:path";
 var ADDONS = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
 var RUNTIME_AUTOLOAD = {
@@ -27971,7 +27984,7 @@ var RUNTIME_AUTOLOAD = {
 var VERSION_MARKER = ".gdharness-version";
 function installedAddonVersion(projectPath) {
   const marker = join9(projectPath, "addons", ADDONS[0], VERSION_MARKER);
-  if (!existsSync6(marker)) {
+  if (!existsSync7(marker)) {
     return null;
   }
   const said = readFileSync9(marker, "utf8").trim();
@@ -28198,7 +28211,7 @@ var TOOL_SPECS = [
   },
   {
     name: "project_search",
-    description: "Searches text or a regular expression across project files and returns file paths with line numbers.",
+    description: "Searches text or a regular expression across project files and returns file paths with line numbers. What the engine steps over is not searched: directories spelled with a dot, node_modules, and any directory holding a .gdignore. A vendored engine or an export directory is therefore absent from the results rather than matching the code you are looking for in a copy nobody runs.",
     parameters: {
       projectPath: PROJECT_PATH,
       query: { type: "string", description: "The text or pattern to find." },
@@ -28637,7 +28650,7 @@ var TOOL_SPECS = [
   },
   {
     name: "editor_rescan",
-    description: "Makes the running editor scan the project filesystem, so files written outside it are picked up. The scan is a change-detecting walk rather than an unconditional reparse, so a file another engine has already imported reads as settled and the walk does not look inside it: its class_name then stays out of the list the editor resolves against, however many times you scan. Any class in that state is named under unseenByEditor, which is what no check on disk can see, since the declaration and the cache are both correct there and only the editor disagrees. The cure is a change to the declaring script, or editor_launch restart; project_import refresh_classes rewrites the cache and does not touch what the editor is holding. Needs the editor connected.",
+    description: "Makes the running editor scan the project filesystem, so files written outside it are picked up. The scan is a change-detecting walk rather than an unconditional reparse, so a file another engine has already imported reads as settled and the walk does not look inside it: its class_name then stays out of the list the editor resolves against, however many times you scan. Any class in that state is named under unseenByEditor, which is what no check on disk can see, since the declaration and the cache are both correct there and only the editor disagrees. The cure is a change to the declaring script, or editor_launch restart; project_import refresh_classes rewrites the cache and does not touch what the editor is holding. The scan also writes .godot/global_script_class_cache.cfg from the list the editor is holding, so a class it cannot resolve is one the scan drops out of that file: unseenByEditor names it before a fresh engine, a CI run or a clone inherits it. Needs the editor connected.",
     parameters: {
       projectPath: PROJECT_PATH,
       timeoutMs: { type: "number", description: "How long to wait for the scan. Default 30000." }
@@ -28720,7 +28733,7 @@ var TOOL_SPECS = [
       limit: {
         type: "number",
         ops: ["find", "text"],
-        description: "find: the most nodes to answer with, default 100. text: the most lines, default 500, with truncated saying whether there were more."
+        description: "find: the most nodes to answer with, default 100. text: the most lines, default 500, with omitted saying how many lines that left behind. A screen whose dialog sits under a long list is a screen read with omitted greater than zero, so raise this or point root at the dialog rather than reading the answer as what is on screen."
       },
       includeHidden: {
         type: "boolean",
@@ -29241,7 +29254,7 @@ function aboveTheRunner(entry) {
 }
 function elsewhereIn(projectPath, asked) {
   const wanted = asked.replace(/^res:\/\//, "").replace(/\/+$/, "");
-  if (wanted === "" || existsSync7(join10(projectPath, wanted))) {
+  if (wanted === "" || existsSync8(join10(projectPath, wanted))) {
     return "";
   }
   const root = (wanted.split("/")[0] ?? "").toLowerCase();
@@ -29858,7 +29871,7 @@ class GodotServer {
       return { ok: false, response: this.createErrorResponse("projectPath is required.") };
     }
     const file = join10(path, "project.godot");
-    if (!existsSync7(file)) {
+    if (!existsSync8(file)) {
       return {
         ok: false,
         response: this.createErrorResponse(`Not a Godot project: ${path}`, [
@@ -30122,7 +30135,7 @@ class GodotServer {
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
     const verdict = {
-      exported: exitCode === 0 && log.count("error") === 0 && existsSync7(output.absolutePath),
+      exported: exitCode === 0 && log.count("error") === 0 && existsSync8(output.absolutePath),
       preset,
       outputPath: output.relativePath,
       debug,
@@ -30152,7 +30165,7 @@ class GodotServer {
       return contained.response;
     }
     const runner = "addons/gdUnit4/bin/GdUnitCmdTool.gd";
-    if (!existsSync7(join10(project.value.path, runner))) {
+    if (!existsSync8(join10(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"
       ]);
@@ -30206,7 +30219,7 @@ class GodotServer {
     let report = null;
     let reportProblem = null;
     try {
-      const written = existsSync7(reportsDir) ? readdirSync6(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
+      const written = existsSync8(reportsDir) ? readdirSync6(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
         report = parseJUnit(readFileSync10(join10(reportsDir, newest, "results.xml"), "utf8"));
@@ -30626,7 +30639,7 @@ class GodotServer {
     return runIsUp(run, editorSays);
   }
   async runtimeUp(projectPath, before, budgetMs) {
-    if (!existsSync7(join10(projectPath, RUNTIME_AUTOLOAD.path))) {
+    if (!existsSync8(join10(projectPath, RUNTIME_AUTOLOAD.path))) {
       return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false });
     }
     const endpoint = await announcedSince(projectPath, before, {

package/package.json

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