gdharness 0.11.0 → 0.11.1

package/README.md

@@ -61,6 +61,29 @@ parts connect, and every tool, op and argument.
 [SECURITY.md](.github/SECURITY.md) is how to report something.
 [CONTRIBUTING.md](.github/CONTRIBUTING.md) is what a change has to clear.
 
+## Versions
+
+0.x, and the number is telling the truth: the tools, their arguments and the shape of their
+answers are still moving, because the projects using this keep finding answers that were wrong or
+missing. Pin an exact version and upgrade deliberately.
+
+Built and measured against Godot 4.7.2 on Windows, Linux and macOS. The editor, engine, runtime
+and integration suites run against a real engine on all three before anything is tagged. Older
+4.x is likely to work and is not tested.
+
+What each kind of release means here:
+
+- **Patch**: an answer that was wrong is now right. The output can change, because a wrong answer
+  corrected is a fix rather than a feature, and leaving one wrong to protect whoever parsed it is
+  how a tool stops being worth asking.
+- **Minor**: a tool, an op, an argument or a field was added, or behaviour a caller can see
+  changed.
+- **Major**: a tool, an op, an argument or a field was renamed or taken away. Nothing else earns
+  one.
+
+1.0 is not a date, it is a condition: the tool surface holding still for a fortnight, and the
+issues arriving being things it cannot do yet rather than things it answers wrongly.
+
 ## Project
 
 Fork of [GoPeak](https://github.com/HaD0Yun/Doyunha-Gopeak) v2.3.9, September 2026, MIT: the

package/build/cli.js

@@ -15725,8 +15725,14 @@ var init_tool_definitions = __esm(() => {
           type: "boolean",
           description: "Only entries printed since the previous editor_output. Default false."
         },
-        contains: { type: "string", description: "Only entries mentioning this text." },
-        limit: { type: "number", description: "The most entries to answer with, newest kept. Default 200." }
+        contains: {
+          type: "string",
+          description: "Only entries mentioning this text, matched against everything the run has printed rather than against the entries this answer would otherwise carry: a line is found however much was printed after it."
+        },
+        limit: {
+          type: "number",
+          description: "The most entries to answer with, newest kept. Default 200, and omitted says how many matching entries that left out. A run long enough to pass it needs this raised, not just filtered: filtering narrows what counts as matching, and the newest of those is still all one answer carries."
+        }
       },
       requires: []
     },
@@ -36097,6 +36103,9 @@ function runsDirectory() {
 function recordPath() {
   return join14(runsDirectory(), "run.json");
 }
+function recordPaths() {
+  return runtimeDirectories().map((directory) => join14(directory, "runs", "run.json"));
+}
 function openTranscript(startedAt) {
   mkdirSync6(runsDirectory(), { recursive: true });
   const path = join14(runsDirectory(), `run-${startedAt}.log`);
@@ -36107,9 +36116,18 @@ function writeRunRecord(record) {
   writeFileSync8(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
 function readRunRecord() {
+  for (const path of recordPaths()) {
+    const record = recordAt(path);
+    if (record !== null) {
+      return record;
+    }
+  }
+  return null;
+}
+function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync12(recordPath(), "utf8"));
+    parsed = JSON.parse(readFileSync12(path, "utf8"));
   } catch {
     return null;
   }
@@ -36132,10 +36150,16 @@ function readRunRecord() {
     arguments: Array.isArray(args) ? args.filter((value) => typeof value === "string") : []
   };
 }
-function clearRunRecord() {
-  try {
-    rmSync7(recordPath());
-  } catch {}
+function clearRunRecord(ours = () => true) {
+  for (const path of recordPaths()) {
+    const record = recordAt(path);
+    if (record === null || !ours(record)) {
+      continue;
+    }
+    try {
+      rmSync7(path);
+    } catch {}
+  }
 }
 function ageMs(path, now) {
   try {
@@ -37764,7 +37788,7 @@ class GodotServer {
   async endActiveGame() {
     const running = this.activeProcess;
     this.activeProcess = null;
-    clearRunRecord();
+    clearRunRecord((record) => this.couldBeOurs(record.projectPath));
     if (!running) {
       return;
     }

package/build/index.js

@@ -27798,6 +27798,9 @@ function runsDirectory() {
 function recordPath() {
   return join8(runsDirectory(), "run.json");
 }
+function recordPaths() {
+  return runtimeDirectories().map((directory) => join8(directory, "runs", "run.json"));
+}
 function openTranscript(startedAt) {
   mkdirSync3(runsDirectory(), { recursive: true });
   const path = join8(runsDirectory(), `run-${startedAt}.log`);
@@ -27808,9 +27811,18 @@ function writeRunRecord(record) {
   writeFileSync4(recordPath(), JSON.stringify(record, null, 2), "utf8");
 }
 function readRunRecord() {
+  for (const path of recordPaths()) {
+    const record = recordAt(path);
+    if (record !== null) {
+      return record;
+    }
+  }
+  return null;
+}
+function recordAt(path) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync8(recordPath(), "utf8"));
+    parsed = JSON.parse(readFileSync8(path, "utf8"));
   } catch {
     return null;
   }
@@ -27833,10 +27845,16 @@ function readRunRecord() {
     arguments: Array.isArray(args) ? args.filter((value) => typeof value === "string") : []
   };
 }
-function clearRunRecord() {
-  try {
-    rmSync3(recordPath());
-  } catch {}
+function clearRunRecord(ours = () => true) {
+  for (const path of recordPaths()) {
+    const record = recordAt(path);
+    if (record === null || !ours(record)) {
+      continue;
+    }
+    try {
+      rmSync3(path);
+    } catch {}
+  }
 }
 function ageMs(path, now) {
   try {
@@ -28511,8 +28529,14 @@ var TOOL_SPECS = [
         type: "boolean",
         description: "Only entries printed since the previous editor_output. Default false."
       },
-      contains: { type: "string", description: "Only entries mentioning this text." },
-      limit: { type: "number", description: "The most entries to answer with, newest kept. Default 200." }
+      contains: {
+        type: "string",
+        description: "Only entries mentioning this text, matched against everything the run has printed rather than against the entries this answer would otherwise carry: a line is found however much was printed after it."
+      },
+      limit: {
+        type: "number",
+        description: "The most entries to answer with, newest kept. Default 200, and omitted says how many matching entries that left out. A run long enough to pass it needs this raised, not just filtered: filtering narrows what counts as matching, and the newest of those is still all one answer carries."
+      }
     },
     requires: []
   },
@@ -30546,7 +30570,7 @@ class GodotServer {
   async endActiveGame() {
     const running = this.activeProcess;
     this.activeProcess = null;
-    clearRunRecord();
+    clearRunRecord((record) => this.couldBeOurs(record.projectPath));
     if (!running) {
       return;
     }

package/package.json

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