gdharness 0.13.0 → 0.13.2

package/build/cli.js

@@ -36950,10 +36950,14 @@ class GodotServer {
     const known = new Set([...Object.keys(spec.parameters), ...spec.operations ? ["op"] : []]);
     const unknown = Object.keys(args).filter((key) => !known.has(key));
     if (unknown.length > 0) {
-      const takes = known.size === 0 ? "It takes no arguments." : `It takes: ${[...known].join(", ")}.`;
+      const asked = readString(args, "op");
+      const named = asked !== undefined && spec.operations?.[asked] !== undefined ? asked : null;
+      const wanted = named === null ? [...known] : [...argumentsOf(spec, named), "op"];
+      const takes = wanted.length === 0 ? "It takes no arguments." : `It takes: ${wanted.join(", ")}.`;
+      const where = named === null ? spec.name : `${spec.name} ${named}`;
       return {
         ok: false,
-        response: this.createErrorResponse(`${spec.name} does not take ${unknown.join(", ")}. ${takes}`)
+        response: this.createErrorResponse(`${where} does not take ${unknown.join(", ")}. ${takes} This is gdharness ${SERVER_VERSION}, which is what decides whether an argument exists.`)
       };
     }
     const wrong = wrongTypes(spec, args);
@@ -37693,13 +37697,13 @@ class GodotServer {
       const severity = asParams(entry)["severity"];
       return severity === 1 || severity === "error" || severity === "ERROR";
     }).length;
-    return this.jsonTextResponse({
+    return this.jsonTextResponse(markIfStale({
       scriptPath: readString(args, "scriptPath"),
       clean: errors === 0,
       errors,
       warnings: diagnostics.length - errors,
       diagnostics
-    });
+    }, this.godotBridge.getStatus().addonVersion, SERVER_VERSION));
   }
   async handleLSP(toolName, args) {
     const port = this.editorServes("lspPort", "GDHARNESS_LSP_PORT", DEFAULT_LSP_PORT);
@@ -39955,12 +39959,18 @@ function headlessSection() {
   return [
     "## What a gate can call",
     "",
-    "These answer from a short-lived headless engine: no editor window, no port, no running game,",
-    "and nothing left behind. They are the only calls worth putting in a push gate, because every",
-    "other tool needs an editor somebody has open or a game somebody is running.",
+    "These answer from a short-lived headless engine: no editor window, no running game, and no",
+    "process or port outliving the answer. They are the only calls an automatic check can make at",
+    "all, because every other tool needs an editor somebody has open or a game somebody is running.",
     "",
     ...byTool.map((line) => `- ${line}`),
     "",
+    "Needing nothing is not the same as changing nothing, and a gate wants both. Most of these",
+    "write to the project because that is what they are for: `script_edit create` writes a file,",
+    "`project_settings set` rewrites `project.godot`, `project_import reimport` and `refresh_classes`",
+    "write under `.godot`. The reading ops are the ones to gate on, and which is which is in each",
+    "op's own summary below rather than assumed from this list.",
+    "",
     "Everything else needs the editor (`editor_*`, `debug_*`, `scene_*`, `resource_*`) or a running",
     "game (`runtime_*`).",
     ""

package/build/index.js

@@ -29705,10 +29705,14 @@ class GodotServer {
     const known = new Set([...Object.keys(spec.parameters), ...spec.operations ? ["op"] : []]);
     const unknown = Object.keys(args).filter((key) => !known.has(key));
     if (unknown.length > 0) {
-      const takes = known.size === 0 ? "It takes no arguments." : `It takes: ${[...known].join(", ")}.`;
+      const asked = readString(args, "op");
+      const named = asked !== undefined && spec.operations?.[asked] !== undefined ? asked : null;
+      const wanted = named === null ? [...known] : [...argumentsOf(spec, named), "op"];
+      const takes = wanted.length === 0 ? "It takes no arguments." : `It takes: ${wanted.join(", ")}.`;
+      const where = named === null ? spec.name : `${spec.name} ${named}`;
       return {
         ok: false,
-        response: this.createErrorResponse(`${spec.name} does not take ${unknown.join(", ")}. ${takes}`)
+        response: this.createErrorResponse(`${where} does not take ${unknown.join(", ")}. ${takes} This is gdharness ${SERVER_VERSION}, which is what decides whether an argument exists.`)
       };
     }
     const wrong = wrongTypes(spec, args);
@@ -30448,13 +30452,13 @@ class GodotServer {
       const severity = asParams(entry)["severity"];
       return severity === 1 || severity === "error" || severity === "ERROR";
     }).length;
-    return this.jsonTextResponse({
+    return this.jsonTextResponse(markIfStale({
       scriptPath: readString(args, "scriptPath"),
       clean: errors === 0,
       errors,
       warnings: diagnostics.length - errors,
       diagnostics
-    });
+    }, this.godotBridge.getStatus().addonVersion, SERVER_VERSION));
   }
   async handleLSP(toolName, args) {
     const port = this.editorServes("lspPort", "GDHARNESS_LSP_PORT", DEFAULT_LSP_PORT);

package/package.json

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