gdharness 1.1.9 → 1.1.10

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

@@ -10,6 +10,7 @@ const Values = preload("runtime_values.gd")
 ## reports are the same place by construction rather than by agreement.
 const Queries = preload("runtime_queries.gd")
 const Read = preload("reading.gd")
+const Targets = preload("runtime_targets.gd")
 const Words = preload("runtime_words.gd")
 
 ## The distance from a capital letter to its small one in Unicode. A keycode holds the capital.
@@ -484,10 +485,25 @@ static func _scroll_into_view(control: Control) -> bool:
 ## A control out of sight inside a ScrollContainer is scrolled to first; the answer says so under
 ## `scrolled_into_view`, because the view having moved is a thing that happened to the screen and
 ## the caller is the only one who can tell whether that matters.
+##
+## `says` names the control by the words on it instead, under `path` when that is given as well,
+## found and pressed in the same frame. A find and then a click by path was two round trips over a
+## generated path copied whole, and a panel that rebuilt itself between them freed the button, so
+## the click landed on nothing.
 func click(params: Dictionary) -> Dictionary:
 	var node_path: String = str(params.get("path", ""))
+	var wanted: String = str(params.get("says", ""))
+	var found: Variant = null
+	if not wanted.is_empty():
+		var picked: Dictionary = Targets.control_saying(
+			_host.get_tree().root, "/root" if node_path.is_empty() else node_path, wanted, params.get("index")
+		)
+		if picked.has("message"):
+			return picked
+		node_path = picked["path"]
+		found = picked["found"]
 	if node_path.is_empty():
-		return {"type": "error", "message": "Node path required"}
+		return {"type": "error", "message": "click needs a path, or says to find the control by its words"}
 
 	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
 	if standing.has("message"):
@@ -582,7 +598,7 @@ func click(params: Dictionary) -> Dictionary:
 	if is_instance_valid(control):
 		afterwards = "in_tree" if control.is_inside_tree() else "removed"
 
-	return {
+	var answer: Dictionary = {
 		"type": "clicked",
 		"path": node_path,
 		"position": _values.serialize(position),
@@ -593,6 +609,9 @@ func click(params: Dictionary) -> Dictionary:
 		"control_afterwards": afterwards,
 		"scrolled_into_view": scrolled,
 	}
+	if found != null:
+		answer["found"] = found
+	return answer
 
 
 ## What to add to a refusal about a point outside the viewport, when the reason is that nobody

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

@@ -259,6 +259,12 @@ static func _says(said: String, wanted: String) -> bool:
 	return said.containsn(words) if _is_literal(words) else said.matchn(words)
 
 
+## Whether [param node]'s own words are what [param wanted] asks for, by the rules a find uses, so a
+## click that names its control by its words finds the one a find would have answered with.
+static func says(node: Node, wanted: String) -> bool:
+	return _says(Words.said_by(node), wanted)
+
+
 ## [param wanted], a glob, open at both ends so it matches its words anywhere in a text; "" when
 ## it is not a glob, or already open at both ends, and so has nothing to suggest.
 static func _widened(wanted: String) -> String:

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

@@ -0,0 +1,113 @@
+extends RefCounted
+
+## Which control a click means when it names the control by the words on it rather than by path.
+
+const Queries = preload("runtime_queries.gd")
+const Read = preload("reading.gd")
+const Values = preload("runtime_values.gd")
+const Words = preload("runtime_words.gd")
+
+## How many of the controls saying the same words a refusal names, with the index for each.
+const LISTED_CANDIDATES: int = 10
+
+
+## The control a click by [param wanted] words presses, found under [param root_path] in the tree
+## [param root] heads, or the refusal saying why there is none or which of several:
+## {"path", "found"} or {"type", "message"}.
+##
+## Matched the way a find matches `says`, against a control's own words, and only among controls
+## the player can see. A match inside a button presses the button, because the label is what says
+## the words and the button is what takes the click: aimed at the label, the pointer lands on the
+## button and the answer would call the click a miss. Several matches are refused rather than
+## guessed, each named with the [param which] that picks it, counting from 0.
+static func control_saying(root: Node, root_path: String, wanted: String, which: Variant) -> Dictionary:
+	var reached: Dictionary = Values.node_at(root, root_path)
+	if reached.has("message"):
+		return reached
+	var targets: Array[Control] = []
+	# The words of the control that matched, which a button pressed on a label's behalf has none of.
+	var said: Array[String] = []
+	var hidden: int = 0
+	var pending: Array[Node] = [reached["node"]]
+	while not pending.is_empty():
+		var node: Node = pending.pop_front()
+		if node is Control and Queries.says(node, wanted):
+			if not Queries.shown(node):
+				hidden += 1
+			else:
+				var matched: Control = node
+				var target: Control = _pressed_through(matched)
+				if not targets.has(target):
+					targets.append(target)
+					said.append(Words.said_by(node))
+		var children: Array[Node] = node.get_children(true)
+		for index: int in range(children.size() - 1, -1, -1):
+			pending.push_front(children[index])
+
+	var under: String = "" if root_path == "/root" else " under %s" % root_path
+	if targets.is_empty():
+		return {
+			"type": "error",
+			"message":
+			(
+				'no control on screen%s says "%s", so nothing was clicked%s'
+				% [under, wanted, _hidden_note(hidden)]
+			)
+		}
+	if which == null and targets.size() > 1:
+		return {
+			"type": "error",
+			"message":
+			(
+				'%d controls on screen%s say "%s", so which to click is not clear; pass index, counting from 0: %s'
+				% [targets.size(), under, wanted, _candidates(targets, said)]
+			)
+		}
+	var index: int = 0 if which == null else Read.as_int(which, -1)
+	if index < 0 or index >= targets.size():
+		var plural: String = "" if targets.size() == 1 else "s"
+		return {
+			"type": "error",
+			"message":
+			(
+				'index %s is not one of the %d control%s on screen%s saying "%s": %s'
+				% [str(which), targets.size(), plural, under, wanted, _candidates(targets, said)]
+			)
+		}
+	return {
+		"path": str(targets[index].get_path()),
+		"found": {"says": wanted, "index": index, "of": targets.size()},
+	}
+
+
+## What to add to a refusal that found nothing on screen, when words matched controls out of sight.
+static func _hidden_note(hidden: int) -> String:
+	if hidden == 0:
+		return ""
+	return "; %d hidden control%s" % [hidden, " says it" if hidden == 1 else "s say it"]
+
+
+## [param control], or the button holding it when it is not one itself, which is what a click on
+## its words means.
+static func _pressed_through(control: Control) -> Control:
+	var walk: Node = control
+	while walk != null:
+		if walk is BaseButton:
+			var pressed: BaseButton = walk
+			return pressed
+		walk = walk.get_parent()
+	return control
+
+
+## The controls a click by words could mean, each with its index, its path and the words that
+## matched, [param said] holding those in the same order.
+static func _candidates(targets: Array[Control], said: Array[String]) -> String:
+	var named: Array[String] = []
+	for index: int in mini(targets.size(), LISTED_CANDIDATES):
+		var words: String = said[index].replace("\n", " ")
+		if words.length() > 60:
+			words = words.substr(0, 57) + "..."
+		named.append('%d %s ("%s")' % [index, targets[index].get_path(), words])
+	if targets.size() > LISTED_CANDIDATES:
+		named.append("and %d more" % (targets.size() - LISTED_CANDIDATES))
+	return "; ".join(named)

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

@@ -0,0 +1 @@
+uid://be1ydcqg2ag4t

package/build/index.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-// @bun
 import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -10085,6 +10084,14 @@ function markIfStale(answer, addonVersion, serverVersion, addonDigest, shippedDi
 // src/issues.ts
 var NEW_ISSUE = "https://github.com/Aureliolo/gdharness/issues/new";
 var ENHANCEMENT_URL = `${NEW_ISSUE}?template=feature_request.md`;
+function feedbackNotice() {
+  return JSON.stringify({
+    gdharness_feedback: {
+      what_to_do: "If this session has run into something gdharness cannot do, or a tool that should " + "exist and does not, tell the user what is missing and offer to open an enhancement " + "issue for them. Only if they say yes, and only for a real gap: a call you got wrong " + "is not one. If you cannot open an issue yourself, give them the link and what to " + "write in it.",
+      enhancement_url: ENHANCEMENT_URL
+    }
+  }, null, 2);
+}
 function runtime() {
   const versions = process3.versions;
   const bun = versions["bun"];
@@ -10140,6 +10147,16 @@ function filledTemplate(where, message, godotVersion) {
   ].join(`
 `);
 }
+
+class DefectsSeen {
+  counts = new Map;
+  before(where, message) {
+    const signature = defectSignature(where, message);
+    const seen = this.counts.get(signature) ?? 0;
+    this.counts.set(signature, seen + 1);
+    return seen;
+  }
+}
 function defectReport(where, error, context = {}) {
   const { godotVersion, seenBefore = 0 } = context;
   const message = errorMessage(error);
@@ -26896,19 +26913,21 @@ class GameLog {
         this.seen[severity] = this.entries.length;
       }
     }
-    const matching = this.entries.slice(floor).filter((entry) => {
-      if (!wanted.has(entry.severity)) {
-        return false;
-      }
-      if (needle === undefined) {
-        return true;
-      }
-      return [entry.text, ...entry.detail].some((line) => line.toLowerCase().includes(needle));
-    });
+    const matching = this.entries.slice(floor).filter((entry) => answersTo(entry, options.severity, options.contains));
     const omitted = Math.max(0, matching.length - options.limit);
     return { entries: matching.slice(omitted), omitted };
   }
 }
+function answersTo(entry, severity, contains) {
+  if (!ADMITTED[severity].has(entry.severity)) {
+    return false;
+  }
+  if (contains === undefined) {
+    return true;
+  }
+  const needle = contains.toLowerCase();
+  return [entry.text, ...entry.detail].some((line) => line.toLowerCase().includes(needle));
+}
 
 // src/editor-log.ts
 function editorLogPath(projectPath) {
@@ -27018,7 +27037,7 @@ function shapeOf(text) {
   }
   return { shape, values };
 }
-function bursts(entries, before) {
+function bursts(entries, before, keep) {
   const shapes = new Map;
   const shaped = entries.map((entry) => shapeOf(entry.text));
   for (const [at, entry] of entries.entries()) {
@@ -27046,6 +27065,9 @@ function bursts(entries, before) {
     if (entry === undefined) {
       continue;
     }
+    if (keep !== undefined && !group.indices.some((at) => entries[at] !== undefined && keep(entries[at]))) {
+      continue;
+    }
     repeated.push({
       shape: key.slice(key.indexOf("\x00") + 1),
       count: group.indices.length,
@@ -27968,126 +27990,6 @@ var EDITOR_READS = dictionary({
   project_settings: dictionary({ get: "get_project_setting" })
 });
 
-// src/issues.ts
-import { createHash as createHash2 } from "node:crypto";
-import process5 from "node:process";
-var NEW_ISSUE2 = "https://github.com/Aureliolo/gdharness/issues/new";
-var ENHANCEMENT_URL2 = `${NEW_ISSUE2}?template=feature_request.md`;
-function feedbackNotice() {
-  return JSON.stringify({
-    gdharness_feedback: {
-      what_to_do: "If this session has run into something gdharness cannot do, or a tool that should " + "exist and does not, tell the user what is missing and offer to open an enhancement " + "issue for them. Only if they say yes, and only for a real gap: a call you got wrong " + "is not one. If you cannot open an issue yourself, give them the link and what to " + "write in it.",
-      enhancement_url: ENHANCEMENT_URL2
-    }
-  }, null, 2);
-}
-function runtime2() {
-  const versions = process5.versions;
-  const bun = versions["bun"];
-  return bun === undefined ? `node ${process5.versions.node}` : `bun ${bun}`;
-}
-function defectSignature2(where, message) {
-  const normalised = `${where}
-${message}`.toLowerCase().replaceAll("\\", "/").replaceAll(/(?:[a-z]:)?(?:\/+[\w.-]+){2,}/gu, "<path>").replaceAll(/\d+/gu, "0");
-  return createHash2("sha256").update(normalised).digest("hex").slice(0, 8);
-}
-function facts2(where, message, godotVersion) {
-  return [
-    ["Where", where],
-    ["Error", message],
-    ["Version", `gdharness ${SERVER_VERSION}`],
-    ["Runtime", `${runtime2()}, ${process5.platform} ${process5.arch}`],
-    ["Godot", godotVersion ?? "not known at the point this failed"],
-    ["Signature", defectSignature2(where, message)]
-  ];
-}
-function filledTemplate2(where, message, godotVersion) {
-  return [
-    `**gdharness version**: ${SERVER_VERSION}`,
-    `**Godot version**: ${godotVersion ?? ""}`,
-    `**Bun version**: ${runtime2()}`,
-    `**OS**: ${process5.platform} ${process5.arch}`,
-    "**MCP client**:",
-    "",
-    "## What you did",
-    "",
-    where,
-    "",
-    "## What you expected",
-    "",
-    "The call to answer, or to refuse with a reason.",
-    "",
-    "## What happened",
-    "",
-    "gdharness failed in a way it does not model.",
-    "",
-    "```text",
-    message,
-    "```",
-    "",
-    `Signature: \`${defectSignature2(where, message)}\``,
-    "",
-    "If the real cause turned out to be the project, the environment or the call, say so here:",
-    "reaching you as a defect rather than as a refusal naming what would have worked is then the",
-    "thing to fix.",
-    "",
-    "## Anything that makes it reproducible",
-    ""
-  ].join(`
-`);
-}
-
-class DefectsSeen {
-  counts = new Map;
-  before(where, message) {
-    const signature = defectSignature2(where, message);
-    const seen = this.counts.get(signature) ?? 0;
-    this.counts.set(signature, seen + 1);
-    return seen;
-  }
-}
-function defectReport2(where, error, context = {}) {
-  const { godotVersion, seenBefore = 0 } = context;
-  const message = errorMessage(error);
-  const title = `Defect ${defectSignature2(where, message)}: ${where}`;
-  const url = `${NEW_ISSUE2}?template=bug_report.md&title=${encodeURIComponent(title)}` + `&body=${encodeURIComponent(filledTemplate2(where, message, godotVersion))}`;
-  const width = Math.max(...facts2(where, message, godotVersion).map(([label]) => (label ?? "").length));
-  return [
-    "gdharness failed in a way it does not model. Whatever went wrong underneath, it reached you",
-    "as a crash rather than as a refusal naming what would have worked, and that much is a defect",
-    "in gdharness however the rest of it turns out.",
-    "",
-    ...seenBefore === 0 ? [
-      "Send the call once more before anything else. Some of what reaches this line is a file",
-      "another process had open, or a connection that dropped, and those are gone by the next",
-      "attempt. If the same Signature comes back, it is not one of those, and repeating it",
-      "further only spends turns."
-    ] : [
-      `You have had this exact failure ${seenBefore === 1 ? "once" : `${seenBefore} times`} in this session already, so it is a`,
-      "state rather than a passing one, and sending the call again will not change it."
-    ],
-    "",
-    ...facts2(where, message, godotVersion).map(([label, value]) => `  ${(label ?? "").padEnd(width)}  ${value ?? ""}`),
-    "",
-    "Do not open an issue on your own initiative. Tell the person whose machine this is what",
-    "broke, and ask whether you may report it to gdharness on their behalf. What the report",
-    "carries is the lines above and nothing else, and whether that goes into a public tracker",
-    "is theirs to decide.",
-    "",
-    "If they say yes, this link carries the report already filled in:",
-    url,
-    "",
-    "If they say yes and you have no way to open an issue yourself, give them that link and",
-    "those lines, and stay with them while they file it.",
-    "",
-    "Worth reporting either way. If you can see that what actually went wrong was the project,",
-    "the environment or the call, then this message is the defect: a failure gdharness knows",
-    "about is meant to arrive as a refusal naming what would have worked, not as this. Say that",
-    "in the report and it is the more useful of the two."
-  ].join(`
-`);
-}
-
 // src/junit.ts
 class MalformedReportError extends Error {
   constructor(message) {
@@ -28290,7 +28192,7 @@ function scriptErrorsPrinted(printed) {
   for (const line of printed.slice(start + 1)) {
     const at = /^\s*at (res:\/\/.+):(\d+)\s*$/.exec(line);
     if (at !== null && message !== null) {
-      found.push({ path: at[1] ?? "", line: Number(at[2]), message });
+      found.push({ path: at[1] ?? "", line: Number(at[2]) === 0 ? null : Number(at[2]), message });
       message = null;
     } else if (at === null && message === null && /^ {2}\S/.test(line)) {
       message = line.trim();
@@ -28298,7 +28200,7 @@ function scriptErrorsPrinted(printed) {
       break;
     }
   }
-  return found.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : a.line - b.line);
+  return found.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : (a.line ?? 0) - (b.line ?? 0));
 }
 var ESCAPE = String.fromCharCode(27);
 var LOCATION = `'[^'\\n]*' in \\S+:\\d+`;
@@ -29193,7 +29095,7 @@ function searchProject(projectPath, options) {
 }
 
 // src/reimport.ts
-import { createHash as createHash3 } from "node:crypto";
+import { createHash as createHash2 } from "node:crypto";
 import { existsSync as existsSync9, readFileSync as readFileSync12, rmSync as rmSync5, statSync as statSync5, utimesSync, writeFileSync as writeFileSync8 } from "node:fs";
 import { basename as basename2, join as join13 } from "node:path";
 function forceNextImport(projectPath, resourcePath) {
@@ -29208,7 +29110,7 @@ function forceNextImport(projectPath, resourcePath) {
   rmSync5(importRecord(projectPath, resourcePath), { force: true });
 }
 function importRecord(projectPath, resourcePath) {
-  const digest = createHash3("md5").update(resourcePath).digest("hex");
+  const digest = createHash2("md5").update(resourcePath).digest("hex");
   return join13(projectPath, ".godot", "imported", `${basename2(resourcePath)}-${digest}.md5`);
 }
 
@@ -29494,7 +29396,7 @@ function restartSettled(projectPath) {
 
 // src/run-record.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { createHash as createHash4 } from "node:crypto";
+import { createHash as createHash3 } from "node:crypto";
 import {
   mkdirSync as mkdirSync8,
   openSync as openSync2,
@@ -29528,7 +29430,7 @@ function realAsFarAsItExists(path) {
 function projectKey(projectPath) {
   const real = realAsFarAsItExists(resolve5(projectPath)).replace(/[\\/]+$/, "");
   const folded = process.platform === "win32" || process.platform === "darwin" ? real.toLowerCase() : real;
-  return createHash4("sha256").update(folded.replaceAll("\\", "/")).digest("hex").slice(0, 16);
+  return createHash3("sha256").update(folded.replaceAll("\\", "/")).digest("hex").slice(0, 16);
 }
 function runRecordPath(projectPath, directory = runtimeDirectory()) {
   return join15(directory, "runs", `note-${projectKey(projectPath)}.json`);
@@ -29836,7 +29738,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
 }
 
 // src/setup.ts
-import { createHash as createHash5 } from "node:crypto";
+import { createHash as createHash4 } from "node:crypto";
 import {
   cpSync,
   existsSync as existsSync10,
@@ -29859,7 +29761,7 @@ var RUNTIME_AUTOLOAD = {
 var VERSION_MARKER = ".gdharness-version";
 var DIGEST_MARKER = ".gdharness-digest";
 function editorAddonDigest(from = shippedAddonsDirectory()) {
-  const hash = createHash5("sha256");
+  const hash = createHash4("sha256");
   const walk = (directory, relative) => {
     for (const name of readdirSync6(directory).sort()) {
       if (name === VERSION_MARKER || name === DIGEST_MARKER) {
@@ -30282,6 +30184,10 @@ var TOOL_SPECS = [
         type: "integer",
         minimum: 1,
         description: "How long the run may take before it is killed. Default 600000. A run killed at the limit answers timedOut and silentForMs, how long it had printed nothing; it is called hung only when that was half the limit, or thirty seconds of a longer one, and otherwise it was still running and wants a longer timeoutMs or a narrower path."
+      },
+      printed: {
+        type: "string",
+        description: "Also answer with every line the run printed that contains this, under printed, whether it passed or not: a suite that prints a marker beside the numbers it measured carries them back without failing an assertion to do it. Matched case aside, in the text and the backtrace, at most 200 lines, the newest kept; printedOmitted counts the rest."
       }
     },
     requires: ["projectPath"]
@@ -30931,14 +30837,19 @@ var TOOL_SPECS = [
   },
   {
     name: "runtime_input",
-    description: "Input to the running game: a whole click on a Control or a 3D node named by path, an item chosen out of a menu, typing into whatever has the focus, or a raw action, key, mouse button or mouse motion. All of it works headless, where the window is 64 by 64 and the GUI only takes what is inside it.",
+    description: "Input to the running game: a whole click on a Control or a 3D node named by path or on a control named by the words on it, an item chosen out of a menu, typing into whatever has the focus, or a raw action, key, mouse button or mouse motion. All of it works headless, where the window is 64 by 64 and the GUI only takes what is inside it.",
     parameters: {
       projectPath: RUNNING_PROJECT_PATH,
       pid: RUNNING_PID,
       nodePath: {
         type: "string",
         ops: ["click", "choose"],
-        description: "click: the Control to click, at its centre, or the 3D node to click, where it is drawn. choose: the PopupMenu, or the OptionButton or MenuButton in front of one."
+        description: "click: the Control to click, at its centre, or the 3D node to click, where it is drawn; with says, where to look for the control instead, default the whole tree. choose: the PopupMenu, or the OptionButton or MenuButton in front of one."
+      },
+      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), 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. Several matches are refused with each one listed, and index picks one."
       },
       action: {
         type: "string",
@@ -30975,8 +30886,8 @@ var TOOL_SPECS = [
       },
       index: {
         type: "number",
-        ops: ["choose"],
-        description: "choose: the item to take, by where it is in the list, when text will not do."
+        ops: ["click", "choose"],
+        description: "click: which of several controls saying the words, counting from 0 in the order a refusal lists them. choose: the item to take, by where it is in the list, when text will not do."
       },
       shift: { type: "boolean", ops: ["key"], description: "key: hold Shift with it. Default false." },
       ctrl: { type: "boolean", ops: ["key"], description: "key: hold Ctrl with it. Default false." },
@@ -31015,8 +30926,8 @@ var TOOL_SPECS = [
     requires: [],
     operations: {
       click: {
-        summary: "press and release on a Control, a frame apart, and answer with what was under the pointer and what became of the control: in_tree, removed or freed. A control out of sight inside a ScrollContainer is scrolled to first, and scrolled_into_view says whether the view moved. A 3D node is clicked where it is drawn, and landed then says the interface did not swallow the press",
-        requires: ["nodePath"]
+        summary: "press and release on a Control, a frame apart, and answer with what was under the pointer and what became of the control: in_tree, removed or freed. The control is named by nodePath, or by says with the words on it, found under nodePath when both are given, and the answer then says under found which match it was. A control out of sight inside a ScrollContainer is scrolled to first, and scrolled_into_view says whether the view moved. A 3D node is clicked where it is drawn, and landed then says the interface did not swallow the press",
+        requires: []
       },
       choose: {
         summary: "take an item out of a menu, by what it says or by where it is in the list. A menu's items are drawn rather than built, so there is nothing to click: the item takes the focus and Enter presses it, which is the engine's own path and needs no window. Answers with what was chosen and what the button in front of it shows now",
@@ -31606,16 +31517,26 @@ function changedSettings(before, after) {
   return [...names].filter((name) => JSON.stringify(before.get(name)) !== JSON.stringify(after.get(name))).sort();
 }
 var STALLED_AFTER_MS = 30000;
+var DEPENDED_FAILED = "Failed to compile depended scripts";
 function scriptErrorsNote(errors) {
-  const first = new Map;
+  const causes = new Map;
   for (const error of errors) {
-    if (!first.has(error.path)) {
-      first.set(error.path, error);
+    if (!error.message.includes(DEPENDED_FAILED) && !causes.has(error.path)) {
+      causes.set(error.path, error);
     }
   }
-  const scripts = [...first.values()].map((error) => `${error.path}:${error.line} ${error.message}${error.message.endsWith(".") ? "" : "."}`).join(" ");
-  const more = errors.length - first.size;
-  return `No tests ran: gdUnit4 could not load ${first.size === 1 ? "one script" : `${first.size} scripts`} while looking for suites, and it runs no suite at all when one fails to load. ${scripts}${more > 0 ? ` ${more === 1 ? "One more error" : `${more} more errors`} in ${first.size === 1 ? "that script" : "those scripts"} ${more === 1 ? "is" : "are"} under scriptErrors.` : ""}`;
+  const dependents = [...new Set(errors.map((error) => error.path))].filter((path) => !causes.has(path));
+  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 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 = errors.filter((error) => !error.message.includes(DEPENDED_FAILED)).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.` : "";
+  return [
+    `No tests ran: gdUnit4 could not load ${scripts === 1 ? "one script" : `${scripts} scripts`} while looking for suites, and it runs no suite at all when one fails to load.`,
+    named,
+    following,
+    rest
+  ].filter((part) => part !== "").join(" ");
 }
 function timedOutVerdict(timeoutMs, silentForMs) {
   const quiet = Math.round(silentForMs);
@@ -32049,7 +31970,7 @@ class GodotServer {
         content: [
           {
             type: "text",
-            text: defectReport2(where, error, {
+            text: defectReport(where, error, {
               seenBefore,
               godotVersion: this.lastGodotVersion ?? undefined
             })
@@ -32391,11 +32312,16 @@ class GodotServer {
         return await this.handleRuntimeCommand(op === "screenshot" ? "capture_screenshot" : "capture_viewport", args);
       case "runtime_input":
         if (op === "click") {
+          if (readNonEmptyString(args, "nodePath") === undefined && readNonEmptyString(args, "says") === undefined) {
+            return this.createErrorResponse("runtime_input click needs nodePath, or says with the words on the control to click.");
+          }
           return await this.handleRuntimeCommand("click", {
             ...whichGame(args),
             path: readNonEmptyString(args, "nodePath") ?? "",
             button: readString(args, "button") ?? "left",
-            double: readBoolean(args, "doubleClick") ?? false
+            double: readBoolean(args, "doubleClick") ?? false,
+            ...readNonEmptyString(args, "says") === undefined ? {} : { says: readNonEmptyString(args, "says") },
+            ...args["index"] === undefined ? {} : { index: args["index"] }
           });
         }
         if (op === "choose") {
@@ -33232,6 +33158,12 @@ class GodotServer {
     const brokenScripts = new Set(scriptErrors.map((error) => error.path)).size;
     const verdict = 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 savesNote = savesStayPut() && nothingRan === null ? SAVES_NOT_MOVED_NOTE : undefined;
+    const marker = readNonEmptyString(args, "printed");
+    const echoed = marker === undefined ? undefined : run.log.select({ severity: "info", sinceLastCall: false, contains: marker, limit: 200 });
+    const printedLines = echoed === undefined ? {} : {
+      printed: echoed.entries.map((entry) => entry.text),
+      ...echoed.omitted > 0 ? { printedOmitted: echoed.omitted } : {}
+    };
     if (report === null) {
       const note = nothingRan !== null ? `No tests ran: ${verdict}.${elsewhereIn(project.value.path, asked)}` : scriptErrors.length > 0 ? scriptErrorsNote(scriptErrors) : `The test run wrote no report (${verdict}${reportProblem ? `; ${reportProblem}` : ""}).`;
       return {
@@ -33250,6 +33182,7 @@ class GodotServer {
               ...scriptErrors.length > 0 ? { scriptErrors } : {},
               arguments: cmdArgs,
               entries: forAnswer(printed.slice(0, 60).map(aboveTheRunner)),
+              ...printedLines,
               savesNote,
               ...scanned
             }, null, 2)
@@ -33286,6 +33219,7 @@ class GodotServer {
       warnings: warnings.length > 0 ? warnings : undefined,
       orphans: orphans.total > 0 ? orphans.total : undefined,
       notRun: notRun > 0 ? notRun : undefined,
+      ...printedLines,
       savesNote,
       ...scanned,
       note: verdict.startsWith("warnings") && warnings.length === 0 ? "gdUnit4 exits 101 for orphan nodes when nothing failed, and this run printed no count of them: orphan reporting may be off in the project settings." : notRun > 0 ? `This run stopped at the first failure in each suite it failed in, so ${notRun} case${notRun === 1 ? "" : "s"} never ran and count as neither passed nor failed. Leave failFast out to run every case.` : undefined,
@@ -34671,15 +34605,18 @@ class GodotServer {
         "editor_output with no op answers about the game a run is playing, which is a different log"
       ]);
     }
-    const severity = readString(args, "severity");
+    const asked = readString(args, "severity");
+    const severity = asked === "error" || asked === "warning" ? asked : "info";
+    const contains = readNonEmptyString(args, "contains");
     const selected = console2.log.select({
-      severity: severity === "error" || severity === "warning" ? severity : "info",
+      severity,
       sinceLastCall: false,
-      contains: readNonEmptyString(args, "contains"),
+      contains,
       limit: readPositiveNumber(args, "limit") ?? 200
     });
     const everything = console2.log.everything();
-    const grouped = bursts(everything, readNonNegativeNumber(args, "before") ?? 3);
+    const filtered = severity !== "info" || contains !== undefined;
+    const grouped = bursts(everything, readNonNegativeNumber(args, "before") ?? 3, filtered ? (entry) => answersTo(entry, severity, contains) : undefined);
     const shown = grouped.slice(0, MOST_GROUPS);
     return this.jsonTextResponse({
       editorPid: editorPid ?? undefined,

package/package.json

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