gdharness 0.13.43 → 1.0.0

package/README.md

@@ -53,16 +53,16 @@ emptily, so a call that succeeded is a call that was understood.
 
 ## At a glance
 
-|           |                                                                                  |
-| --------- | -------------------------------------------------------------------------------- |
-| Needs     | Godot 4.7 or newer, Node 22 or newer. Runs under Bun 1.4 too.                    |
-| Surface   | 30 tools named `domain_verb`, and 4 `godot://` resources                         |
-| Reaches   | The editor that is open, a game it is playing, and the project on disk           |
-| Harnesses | 35, written inside the project wherever the harness has a project config         |
-| Skill     | Written to `.agents/skills`, which every major harness reads                     |
-| Install   | npm, or a Sigstore-signed archive with an SBOM, SLSA Build Level 3               |
-| Proven    | Every tool driven against Godot 4.7.2 in CI, on Windows, Linux and macOS         |
-| Status    | 0.x: pin an exact version. [What a bump means](.github/CONTRIBUTING.md#versions) |
+|           |                                                                                      |
+| --------- | ------------------------------------------------------------------------------------ |
+| Needs     | Godot 4.7 or newer, Node 22 or newer. Runs under Bun 1.4 too.                        |
+| Surface   | 30 tools named `domain_verb`, and 4 `godot://` resources                             |
+| Reaches   | The editor that is open, a game it is playing, and the project on disk               |
+| Harnesses | 35, written inside the project wherever the harness has a project config             |
+| Skill     | Written to `.agents/skills`, which every major harness reads                         |
+| Install   | npm, or a Sigstore-signed archive with an SBOM, SLSA Build Level 3                   |
+| Proven    | Every tool driven against Godot 4.7.2 in CI, on Windows, Linux and macOS             |
+| Status    | 1.0: every release is a patch. [What a bump means](.github/CONTRIBUTING.md#versions) |
 
 Older 4.x is likely to work and is not tested.
 

package/build/cli.js

@@ -15319,10 +15319,22 @@ function opTakes(spec, op, name) {
 function argumentsOf(spec, op) {
   return Object.keys(spec.parameters).filter((name) => opTakes(spec, op, name));
 }
-function toolsWithoutProjectPath() {
-  return TOOL_SPECS.filter((spec) => !Object.hasOwn(spec.parameters, "projectPath")).map((spec) => spec.name).sort();
+function callsWithoutProjectPath() {
+  const calls = [];
+  for (const spec of TOOL_SPECS) {
+    if (!Object.hasOwn(spec.parameters, "projectPath")) {
+      calls.push(spec.name);
+      continue;
+    }
+    for (const op of Object.keys(spec.operations ?? {})) {
+      if (!opTakes(spec, op, "projectPath")) {
+        calls.push(`${spec.name} ${op}`);
+      }
+    }
+  }
+  return calls.sort();
 }
-function projectPathSentence(without = toolsWithoutProjectPath()) {
+function projectPathSentence(without = callsWithoutProjectPath()) {
   if (without.length === 0) {
     return "Every call takes `projectPath`";
   }
@@ -16155,7 +16167,7 @@ var init_tool_definitions = __esm(() => {
         says: {
           type: "string",
           ops: ["find"],
-          description: "find: part of what the node has written on 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."
+          description: "find: part of what the node has written on 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. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one."
         },
         limit: {
           type: "number",
@@ -16373,7 +16385,7 @@ var init_tool_definitions = __esm(() => {
         says: {
           type: "string",
           ops: ["until"],
-          description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
+          description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included; a label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
         },
         timeoutMs: {
           type: "number",

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

@@ -212,7 +212,18 @@ static func _is_literal(pattern: String) -> bool:
 ## only, a glob matched nothing at all and an empty answer reads as a control that is not on the
 ## screen: twice in one session here, over a button that was.
 static func _says(said: String, wanted: String) -> bool:
-	return said.containsn(wanted) if _is_literal(wanted) else said.matchn(wanted)
+	var words: String = as_said(wanted)
+	return said.containsn(words) if _is_literal(words) else said.matchn(words)
+
+
+## [param wanted] as words on a screen: a backslash followed by n is a line break.
+##
+## A button with two lines on it was asked for with the break written as the two characters, the
+## way it is typed into a JSON string one escape short, and was answered as not there: 0 found,
+## 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")
 
 
 ## Every filter but the name, so a find that came back empty can say how many nodes the name was
@@ -236,11 +247,27 @@ func _matches_apart_from_name(node: Node, wanted: Dictionary[String, String]) ->
 		if not script is Script:
 			return false
 		var attached: Script = script
-		if attached.get_global_name() != wanted["class"]:
+		if not _script_is(attached, wanted["class"]):
 			return false
 	return true
 
 
+## Whether [param attached] is the script class [param wanted], the way a typed `is` reads it: its
+## own class_name, or one it extends at any distance.
+##
+## The class_name alone answered 0 for `Card` over a tree of rows whose scripts extend Card two
+## steps down, IntakeRow extends DocketCard extends Card, while `is_class` reaches every native
+## subclass. A caller naming a class means what extends it, whichever side of the line the class
+## is declared on.
+static func _script_is(attached: Script, wanted: String) -> bool:
+	var walk: Script = attached
+	while walk != null:
+		if walk.get_global_name() == wanted:
+			return true
+		walk = walk.get_base_script()
+	return false
+
+
 ## Where a node is on screen: a Control's rectangle, a Node2D's position, or the place a 3D node
 ## is drawn in, in both the canvas coordinates the node reports and the window pixels input
 ## arrives in. The two differ whenever the project stretches its viewport, which is what made a

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

@@ -198,10 +198,11 @@ func wait_until(params: Dictionary) -> Dictionary:
 ## and the screen is the part that stays put.
 func _wait_until_said(node_path: String, said: String, timeout_ms: int) -> Dictionary:
 	var started: int = Time.get_ticks_msec()
-	var found: bool = _anything_says(node_path, said)
+	var words: String = Queries.as_said(said)
+	var found: bool = _anything_says(node_path, words)
 	while not found and Time.get_ticks_msec() - started < timeout_ms:
 		await _host.get_tree().process_frame
-		found = _anything_says(node_path, said)
+		found = _anything_says(node_path, words)
 
 	return {
 		"type": "condition",

package/build/index.js

@@ -29770,7 +29770,7 @@ var TOOL_SPECS = [
       says: {
         type: "string",
         ops: ["find"],
-        description: "find: part of what the node has written on 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."
+        description: "find: part of what the node has written on 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. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one."
       },
       limit: {
         type: "number",
@@ -29988,7 +29988,7 @@ var TOOL_SPECS = [
       says: {
         type: "string",
         ops: ["until"],
-        description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
+        description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included; a label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
       },
       timeoutMs: {
         type: "number",

package/package.json

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