gdharness 1.2.21 → 1.2.23

package/build/cli.js

@@ -8002,6 +8002,11 @@ class GameLog {
     transcript: null
   };
   seen = { error: 0, warning: 0, info: 0 };
+  crashed = {
+    stdout: null,
+    stderr: null,
+    transcript: null
+  };
   byScript = new Set;
   append(source, chunk) {
     const decoded = typeof chunk === "string" ? chunk : this.decoders[source].write(chunk);
@@ -8026,6 +8031,21 @@ class GameLog {
     if (line.trim() === "") {
       return;
     }
+    const report = this.crashed[source];
+    if (report !== null) {
+      const said = line.trim();
+      if (!CRASH_FILLER.test(said)) {
+        report.push(said);
+      }
+      return;
+    }
+    if (CRASH.test(line)) {
+      const detail = [];
+      this.entries.push({ index: this.entries.length, severity: "error", source, text: line.trim(), detail });
+      this.crashed[source] = detail;
+      this.lastHeadline[source] = null;
+      return;
+    }
     const owner = this.lastHeadline[source];
     if (owner !== null && /^\s/.test(line)) {
       owner.detail.push(line.trim());
@@ -8096,9 +8116,11 @@ function answersTo(entry, severity, contains) {
   const needle = contains.toLowerCase();
   return [entry.text, ...entry.detail].some((line) => line.toLowerCase().includes(needle));
 }
-var HEADLINE, COLOUR_CODE, STREAMS, ADMITTED, FRAME, LONGEST_CYCLE = 64;
+var HEADLINE, CRASH, CRASH_FILLER, COLOUR_CODE, STREAMS, ADMITTED, FRAME, LONGEST_CYCLE = 64;
 var init_game_log = __esm(() => {
   HEADLINE = /^(USER )?(SCRIPT ERROR|SHADER ERROR|ERROR|WARNING):\s?(.*)$/;
+  CRASH = /^(?:CrashHandlerException|handle_crash): Program crashed with signal \d+/;
+  CRASH_FILLER = /^(?:=+|-- END OF .* BACKTRACE --|\[\d+\] .* - no debug info in .*)$/;
   COLOUR_CODE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
   STREAMS = ["stdout", "stderr", "transcript"];
   ADMITTED = {
@@ -11082,7 +11104,7 @@ var init_tool_definitions = __esm(() => {
     {
       name: "project_settings",
       title: "Project settings",
-      description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is. get answers exists, true for any setting the engine knows, and at_default, true when the value is the engine's own default and so has no line in project.godot.",
+      description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is. get answers exists, true for any setting the engine knows, and at_default, true when the value is the engine's own default and so has no line in project.godot. Each setting under prefix carries at_default too, so a family read separates what the project sets from the engine's defaults; it is absent for a setting the engine registers no default for, such as an input action the project added, which only the project can have set.",
       parameters: {
         projectPath: PROJECT_PATH,
         setting: {
@@ -11400,7 +11422,7 @@ var init_tool_definitions = __esm(() => {
       name: "scene_tree",
       title: "Scene tree",
       effect: "read",
-      description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected.",
+      description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected. For the nodes of a game that is running, runtime_inspect tree, which needs no editor.",
       parameters: {
         projectPath: PROJECT_PATH,
         scenePath: SCENE_PATH,
@@ -11924,7 +11946,7 @@ var init_tool_definitions = __esm(() => {
           requires: []
         }
       },
-      answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
+      answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. entries holds the errors and warnings and not the ordinary lines the run printed, which printedLinesNotShown counts; a check given --verbose holds those too, and editor_run start then editor_output reads everything. An engine crash is an error whatever it prints after: the crash handler's report is the entry, and the engine version and the native and GDScript backtraces are its detail, so a crashed run is never booted or clean. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
       defaultOperation: "start"
     },
     {
@@ -43558,6 +43580,14 @@ function runtimeVerdict(endpoint, after) {
   }
   const state = after.playingSeen === false ? "the editor has not yet reported the game as playing, which a restarted editor does not until its scan is over" : "the game is still running";
   const sized = after.sizedToMs === undefined ? "" : halfAsLongAgain(after.sizedToMs) > after.budgetMs ? `, the longest a start waits unasked though the slowest of its last boots took ${after.sizedToMs}ms to announce,` : `, half as long again as the ${after.sizedToMs}ms the slowest of its last boots took,`;
+  if (!after.running && after.runtimeCameUp === true) {
+    return {
+      listening: false,
+      mayYetAnnounce: false,
+      note: "the game's runtime came up and the game quit before this start could reach it, so there is nothing to talk to: editor_output has what it printed, and a scene that is to be inspected has to stay running past its first frame",
+      heldAt: null
+    };
+  }
   return {
     listening: false,
     mayYetAnnounce: after.running,
@@ -44863,7 +44893,7 @@ class GodotServer {
     const { op: _op, ...arguments_ } = args;
     const bridge = async (command, extra = {}) => {
       const contained = this.containProjectFiles({ ...arguments_, ...extra });
-      return contained.ok ? await this.handleViaBridge(command, contained.value) : contained.response;
+      return contained.ok ? await this.handleViaBridge(command, contained.value, tool) : contained.response;
     };
     switch (tool) {
       case "project_info":
@@ -47119,15 +47149,20 @@ class GodotServer {
         note: `${fresh.length} games of this project announced at once and none could be told from the process tree as this run's own game rather than one it started, so none is taken as its runtime. editor_status lists them under runtimes.`
       };
     }
+    const running = endpoint !== null || going !== null && await this.runStillGoing(going);
+    if (going !== null && !running) {
+      this.drainTranscript(going);
+    }
     return runtimeVerdict(endpoint, {
       addon: true,
       budgetMs,
       ...budget.sizedToMs === undefined ? {} : { sizedToMs: budget.sizedToMs },
       heldAt: this.dapClient?.whereItStopped() ?? null,
-      running: endpoint !== null || going !== null && await this.runStillGoing(going),
+      running,
       withArgs,
       servesAProject: this.ownProject !== null,
-      ...going?.throughEditor === true ? { playingSeen: going.seenPlaying === true } : {}
+      ...going?.throughEditor === true ? { playingSeen: going.seenPlaying === true } : {},
+      runtimeCameUp: going !== null && !running && going.log.all.some((entry) => entry.text.startsWith(RUNTIME_LISTENING_LINE))
     });
   }
   announceBudget(args, projectPath, scene) {
@@ -47983,6 +48018,8 @@ class GodotServer {
     await boot.settled;
     const errors = boot.log.count("error");
     const warnings = boot.log.count("warning");
+    const floor = engineArgs.includes("--verbose") ? "info" : "warning";
+    const printed = boot.log.count("info");
     return this.jsonTextResponse({
       booted: !hung && boot.exitCode === 0 && errors === 0,
       hung,
@@ -47996,7 +48033,8 @@ class GodotServer {
       argsNote: engineFlagsNote(userArgs),
       ...scanWaitAnswer(scanned),
       savesNote: asked.savesIn !== undefined && savesStayPut() ? SAVES_NOT_MOVED_NOTE : undefined,
-      ...foldedEntriesAnswer(boot.log, engineArgs.includes("--verbose") ? "info" : "warning")
+      printedLinesNotShown: floor === "warning" && printed > 0 ? printed : undefined,
+      ...foldedEntriesAnswer(boot.log, floor)
     });
   }
   async handleRunProfile(args) {
@@ -49063,9 +49101,11 @@ class GodotServer {
     const holds = held["classes"].map(String);
     return { unseen: unseenByEditor(projectPath, holds), stillHeld: heldButGone(projectPath, holds) };
   }
-  async handleViaBridge(toolName, args) {
+  async handleViaBridge(toolName, args, askedAs) {
     if (!this.godotBridge.isConnected()) {
+      const instead = askedAs !== undefined && Object.hasOwn(EDITOR_FREE_INSTEAD, askedAs) ? EDITOR_FREE_INSTEAD[askedAs] : undefined;
       return this.createErrorResponse("Editor not connected: no Godot editor with the gdharness editor addon has reached this server.", [
+        ...instead === undefined ? [] : [instead],
         "Open the project in the editor with editor_launch, or by hand",
         "Enable the addon under Project > Project Settings > Plugins",
         "editor_status says whether the bridge is up and what it is listening on"
@@ -49378,7 +49418,7 @@ async function runGodotServer() {
   const server = new GodotServer;
   await server.run();
 }
-var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run4, __dirname2, EDITOR_SERVERS_START_MS = 20000, HOLD_PING_MS = 2000, SLOWEST_FRAME_RATE = 20, PLAY_STARTS_WITHIN_MS = 30000, KEEPER_ANSWER_MS = 15000, EXIT_REPORTED_WITHIN_MS = 2000, CONSOLE_WRAPPER, LONGEST_BOOT_NOTED_MS, PROFILE_SEND_MS = 5000, MOST_GROUPS = 20, VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, CONSOLE_WATCH_MS = 250, BOUNDARY_WAIT_MS = 2000, HANDOVER_MS, HANDOVER_POLL_MS = 250, CACHE_WRITE_MS = 2000, STREAMS_GRACE_MS = 2000, PLAYING_STATUS_MS = 1000, SCAN_START_MS = 2000, SCAN_SETTLED_MS = 500, REIMPORT_TIMEOUT_MS = 300000, OPS_ELSEWHERE, AUDIO_BUS_OPS, STALLED_AFTER_MS = 30000, TEST_HEARTBEAT_MS = 20000, DEPENDED_FAILED = "Failed to compile depended scripts", WAIT_FOR_RUN_MS = 600000, RUN_POLL_MS = 250, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, PROJECT_INFO_SECTIONS2, RUNNER_DIRECTORY = "addons/gdUnit4/", PROFILE_FUNCTIONS = 30, PROFILER_ON_MS = 3000, PROPERTY_PLACES = "It is a property, so each place says whether it writes it (access write), which runs its set block, or reads it (access read), which runs its get block: withinCalls on a read says nothing of the set block, nor on a write of the get block unless the write is a compound one such as +=. Inside the property's own blocks its name is the value stored, which the engine reads and writes without running them, so those lines are not listed.", CALLERS_FOUND_BY_NAME = "Found by name in the project's scripts, since the engine's profiler counts calls and time per function and records nothing about who made them: a method of the same name on another class is listed too, unless one class was asked about and it is called through another class by name or through a variable declared as one. Each place carries the profile's numbers for the function it is written in.", MOST_ENGINE_ENTRIES = 200, ERROR_ASSERT = "GdUnitGodotErrorAssertImpl.gd", EXTERNAL_MEMBER = 'Could not resolve external class member "', STATIC_LIST_HINT;
+var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run4, __dirname2, EDITOR_SERVERS_START_MS = 20000, HOLD_PING_MS = 2000, SLOWEST_FRAME_RATE = 20, PLAY_STARTS_WITHIN_MS = 30000, KEEPER_ANSWER_MS = 15000, EXIT_REPORTED_WITHIN_MS = 2000, CONSOLE_WRAPPER, LONGEST_BOOT_NOTED_MS, PROFILE_SEND_MS = 5000, MOST_GROUPS = 20, RUNTIME_LISTENING_LINE = "[gdharness] runtime listening on ", VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, CONSOLE_WATCH_MS = 250, BOUNDARY_WAIT_MS = 2000, HANDOVER_MS, HANDOVER_POLL_MS = 250, CACHE_WRITE_MS = 2000, STREAMS_GRACE_MS = 2000, PLAYING_STATUS_MS = 1000, SCAN_START_MS = 2000, SCAN_SETTLED_MS = 500, REIMPORT_TIMEOUT_MS = 300000, EDITOR_FREE_INSTEAD, OPS_ELSEWHERE, AUDIO_BUS_OPS, STALLED_AFTER_MS = 30000, TEST_HEARTBEAT_MS = 20000, DEPENDED_FAILED = "Failed to compile depended scripts", WAIT_FOR_RUN_MS = 600000, RUN_POLL_MS = 250, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, PROJECT_INFO_SECTIONS2, RUNNER_DIRECTORY = "addons/gdUnit4/", PROFILE_FUNCTIONS = 30, PROFILER_ON_MS = 3000, PROPERTY_PLACES = "It is a property, so each place says whether it writes it (access write), which runs its set block, or reads it (access read), which runs its get block: withinCalls on a read says nothing of the set block, nor on a write of the get block unless the write is a compound one such as +=. Inside the property's own blocks its name is the value stored, which the engine reads and writes without running them, so those lines are not listed.", CALLERS_FOUND_BY_NAME = "Found by name in the project's scripts, since the engine's profiler counts calls and time per function and records nothing about who made them: a method of the same name on another class is listed too, unless one class was asked about and it is called through another class by name or through a variable declared as one. Each place carries the profile's numbers for the function it is written in.", MOST_ENGINE_ENTRIES = 200, ERROR_ASSERT = "GdUnitGodotErrorAssertImpl.gd", EXTERNAL_MEMBER = 'Could not resolve external class member "', STATIC_LIST_HINT;
 var init_server = __esm(() => {
   init_dist();
   init_stdio();
@@ -49442,6 +49482,9 @@ var init_server = __esm(() => {
     object: "an object"
   };
   HANDOVER_MS = SUCCESSOR_CHECK_MS + 5000;
+  EDITOR_FREE_INSTEAD = {
+    scene_tree: "runtime_inspect tree reads the nodes of a game that is running, and needs no editor; scene_tree reads a scene file through the editor"
+  };
   OPS_ELSEWHERE = {
     runtime_invoke: { get: "runtime_inspect property", property: "runtime_inspect property" }
   };

package/build/godot/operations/dependencies.gd

@@ -284,6 +284,15 @@ static func _code_of(line: String) -> String:
 	return bare if mark == -1 else bare.substr(0, mark)
 
 
+# [param content] with each line's comment taken off and its strings kept, which is where the paths
+# a script loads are written.
+static func _code_lines(content: String) -> String:
+	var kept: Array[String] = []
+	for line: String in content.split("\n"):
+		kept.append(Patterns.without_comment(line))
+	return "\n".join(kept)
+
+
 # The comment on [param line], strings emptied first so a # inside one does not start it.
 static func _comment_of(line: String) -> String:
 	var bare: String = Patterns.compiled(STRING_LITERAL).sub(line, '""', true)
@@ -361,6 +370,11 @@ func _analyze_resource(path: String, current_depth: int, walk: DependencyWalk) -
 	if file:
 		var content: String = file.get_as_text()
 		file.close()
+		# A script's comments name paths as examples, and read as references they were answered as
+		# dependencies, one of a file that does not exist: the shipped serialisation module's comment
+		# about `["res://addons/x/plugin.cfg"]` was a dependency of every project with the addon.
+		if path.get_extension() == "gd":
+			content = _code_lines(content)
 
 		for pattern: String in REFERENCE_PATTERNS:
 			var regex: RegEx = Patterns.compiled(pattern)

package/build/godot/operations/gdscript_analysis.gd

@@ -59,7 +59,7 @@ func get_gdscript_info(params: Dictionary) -> Dictionary:
 			if _triple_quotes(raw) % 2 == 1:
 				in_multiline_string = false
 			continue
-		var stripped: String = _without_comment(raw)
+		var stripped: String = Patterns.without_comment(raw)
 
 		if stripped.is_empty():
 			continue
@@ -101,7 +101,7 @@ func get_gdscript_info(params: Dictionary) -> Dictionary:
 		if _can_wrap(header):
 			while _bracket_depth(stripped) > 0 and i + 1 < lines.size():
 				i += 1
-				stripped = (stripped + " " + _without_comment(lines[i])).strip_edges()
+				stripped = (stripped + " " + Patterns.without_comment(lines[i])).strip_edges()
 			header = Patterns.without_annotations(stripped)
 		var declaration: RegExMatch = Patterns.declared_class(header)
 		if declaration != null:
@@ -508,28 +508,6 @@ func _up_to(text: String, needle: String) -> String:
 	return text
 
 
-# The line with any trailing comment taken off, quote-aware so a `#` inside a string stays.
-#
-# The only one of these scanners that does not count brackets, on purpose: a `#` starts a comment
-# wherever it is, and there is no depth at which it does not. Giving this one the depth its
-# neighbours have puts the comment into the value of `var table := {  # keyed by name`, because the
-# brace opens before the `#` and closes on a later line. Held by a case, since the argument for the
-# difference is not visible from the code and reads like an oversight beside its neighbours.
-func _without_comment(line: String) -> String:
-	var quote: String = ""
-	for i: int in range(line.length()):
-		var ch: String = line[i]
-		if not quote.is_empty():
-			if ch == quote and line[i - 1] != "\\":
-				quote = ""
-			continue
-		if ch == "#":
-			return line.substr(0, i).strip_edges()
-		if ch == '"' or ch == "'":
-			quote = ch
-	return line.strip_edges()
-
-
 # Where the bracket opened at [from] closes, or -1 if it does not.
 #
 # `rfind(")")` took the last one on the line, which is the right answer until something after the

package/build/godot/operations/patterns.gd

@@ -84,3 +84,25 @@ static func without_annotations(line: String) -> String:
 		rest = rest.substr(found.get_end()).strip_edges()
 		found = annotation.search(rest)
 	return rest
+
+
+# The line with any trailing comment taken off, quote-aware so a `#` inside a string stays.
+#
+# The only one of the scanners here that does not count brackets, on purpose: a `#` starts a comment
+# wherever it is, and there is no depth at which it does not. Giving this one the depth its
+# neighbours have puts the comment into the value of `var table := {  # keyed by name`, because the
+# brace opens before the `#` and closes on a later line. Held by a case, since the argument for the
+# difference is not visible from the code and reads like an oversight beside its neighbours.
+static func without_comment(line: String) -> String:
+	var quote: String = ""
+	for i: int in range(line.length()):
+		var ch: String = line[i]
+		if not quote.is_empty():
+			if ch == quote and line[i - 1] != "\\":
+				quote = ""
+			continue
+		if ch == "#":
+			return line.substr(0, i).strip_edges()
+		if ch == '"' or ch == "'":
+			quote = ch
+	return line.strip_edges()

package/build/godot/operations/project_config.gd

@@ -82,6 +82,11 @@ func _settings_under(prefix: String) -> Dictionary:
 			"type": type_string(kind),
 			"value": _values.serialize_value(value),
 		}
+		# As a single get says it, so a family read can be told apart into what the project sets
+		# and the engine's defaults: "input/" is ninety actions the engine ships and the project's few.
+		var default_value: Variant = ProjectSettings.property_get_revert(name)
+		if default_value != null:
+			described["at_default"] = value == default_value
 		found.append(described)
 
 	found.sort_custom(func(a: Dictionary, b: Dictionary) -> bool: return a["setting"] < b["setting"])

package/build/index.js

@@ -28147,6 +28147,8 @@ import { dirname as dirname7, join as join10 } from "node:path";
 // src/game-log.ts
 import { StringDecoder } from "node:string_decoder";
 var HEADLINE = /^(USER )?(SCRIPT ERROR|SHADER ERROR|ERROR|WARNING):\s?(.*)$/;
+var CRASH = /^(?:CrashHandlerException|handle_crash): Program crashed with signal \d+/;
+var CRASH_FILLER = /^(?:=+|-- END OF .* BACKTRACE --|\[\d+\] .* - no debug info in .*)$/;
 var COLOUR_CODE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
 function announced(line) {
   const match = HEADLINE.exec(line);
@@ -28261,6 +28263,11 @@ class GameLog {
     transcript: null
   };
   seen = { error: 0, warning: 0, info: 0 };
+  crashed = {
+    stdout: null,
+    stderr: null,
+    transcript: null
+  };
   byScript = new Set;
   append(source, chunk) {
     const decoded = typeof chunk === "string" ? chunk : this.decoders[source].write(chunk);
@@ -28285,6 +28292,21 @@ class GameLog {
     if (line.trim() === "") {
       return;
     }
+    const report = this.crashed[source];
+    if (report !== null) {
+      const said = line.trim();
+      if (!CRASH_FILLER.test(said)) {
+        report.push(said);
+      }
+      return;
+    }
+    if (CRASH.test(line)) {
+      const detail = [];
+      this.entries.push({ index: this.entries.length, severity: "error", source, text: line.trim(), detail });
+      this.crashed[source] = detail;
+      this.lastHeadline[source] = null;
+      return;
+    }
     const owner = this.lastHeadline[source];
     if (owner !== null && /^\s/.test(line)) {
       owner.detail.push(line.trim());
@@ -34114,7 +34136,7 @@ var TOOL_SPECS = [
   {
     name: "project_settings",
     title: "Project settings",
-    description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is. get answers exists, true for any setting the engine knows, and at_default, true when the value is the engine's own default and so has no line in project.godot.",
+    description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is. get answers exists, true for any setting the engine knows, and at_default, true when the value is the engine's own default and so has no line in project.godot. Each setting under prefix carries at_default too, so a family read separates what the project sets from the engine's defaults; it is absent for a setting the engine registers no default for, such as an input action the project added, which only the project can have set.",
     parameters: {
       projectPath: PROJECT_PATH2,
       setting: {
@@ -34432,7 +34454,7 @@ var TOOL_SPECS = [
     name: "scene_tree",
     title: "Scene tree",
     effect: "read",
-    description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected.",
+    description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected. For the nodes of a game that is running, runtime_inspect tree, which needs no editor.",
     parameters: {
       projectPath: PROJECT_PATH2,
       scenePath: SCENE_PATH,
@@ -34956,7 +34978,7 @@ var TOOL_SPECS = [
         requires: []
       }
     },
-    answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
+    answer: "stop: endedPid is, for a run the editor plays, the number its game announced under, read at the stop rather than remembered, and the operating system hands a freed number to the next process, so it can equal the game before it. stopped is false, with the number under notSignalled, when that number no longer answers as the process the run was started as and nothing was signalled, the note naming which property it failed on, and false with the number under stillGoing when what was told to end was still running ten seconds later. endedThrough says how the stop ended a run that was going: keeper (the process that started the game ended it through the handle it holds), signal (its pid was signalled once shown to still be the run), or editor (the editor playing it was asked). A start that ends the run before it says how under endedPreviousRunThrough, with the same values, and one that refused to signal that run names the property it failed on under previousRunLeftBecause. check: hung is a run killed at timeoutMs, and errors and warnings count what it printed, which comes back under entries with repeats folded together. entries holds the errors and warnings and not the ordinary lines the run printed, which printedLinesNotShown counts; a check given --verbose holds those too, and editor_run start then editor_output reads everything. An engine crash is an error whatever it prints after: the crash handler's report is the entry, and the engine version and the native and GDScript backtraces are its detail, so a crashed run is never booted or clean. arguments is the engine command line the check ran, as a start's is. profile: per function its script, the function (Class.name when the script declares a class_name), the line its body's first statement is on, for a lambda the named function it is written in (within), calls, and self and total milliseconds, with functionsCounted, scriptMs (the self time of them all) and coveredMs. complete is true when the engine's own totals arrived, which it sends only when the profiler is switched off: the runtime addon does that as a game quits, so a scene that does its work in _ready and quits is covered whole; otherwise the answer is the frames summed so far and the note says what that misses. Self time counts a call into the engine's own methods as the caller's, and a call through super too, while the overridden function's row counts it again: such a row carries selfIncludesSuper, so self times along an override chain overlap. The profiler's own cost of timing a call lands in the self time of the function called; with the runtime addon it is measured each run on an empty function, as perCallOverheadUs, and a row with at least half its selfMs in it carries overheadMs, since a small function called often costs that much less without the profiler. A function the profiler started inside is left out, since its time would be counted from the engine's start. The milliseconds are time passed while the function ran, not processor time given to it, so they grow when other processes compete for the processor: compare two profiles taken under the same load. They are also summed over every thread: a function run by WorkerThreadPool or a Thread on several threads at once counts each thread's time, the engine does not say which thread a call ran on, and a function waiting for them has the wait in its own self time, so selfMs is not time taken from frames, and scriptMs can exceed coveredMs, which the note then says. A property's get and set blocks are named Class.@name_getter and Class.@name_setter, as the engine names them, and their rows carry property, the property's name. A game the editor plays that was not started with profile: true says, in the answer, that it was profiled from the moment it was asked.",
     defaultOperation: "start"
   },
   {
@@ -36211,6 +36233,7 @@ function endedToStartThis(ended) {
 var LONGEST_BOOT_NOTED_MS = 5 * 60000;
 var PROFILE_SEND_MS = 5000;
 var MOST_GROUPS = 20;
+var RUNTIME_LISTENING_LINE = "[gdharness] runtime listening on ";
 function runtimeVerdict(endpoint, after) {
   if (endpoint !== null) {
     return { listening: true, pid: endpoint.pid, port: endpoint.port };
@@ -36232,6 +36255,14 @@ function runtimeVerdict(endpoint, after) {
   }
   const state = after.playingSeen === false ? "the editor has not yet reported the game as playing, which a restarted editor does not until its scan is over" : "the game is still running";
   const sized = after.sizedToMs === undefined ? "" : halfAsLongAgain(after.sizedToMs) > after.budgetMs ? `, the longest a start waits unasked though the slowest of its last boots took ${after.sizedToMs}ms to announce,` : `, half as long again as the ${after.sizedToMs}ms the slowest of its last boots took,`;
+  if (!after.running && after.runtimeCameUp === true) {
+    return {
+      listening: false,
+      mayYetAnnounce: false,
+      note: "the game's runtime came up and the game quit before this start could reach it, so there is nothing to talk to: editor_output has what it printed, and a scene that is to be inspected has to stay running past its first frame",
+      heldAt: null
+    };
+  }
   return {
     listening: false,
     mayYetAnnounce: after.running,
@@ -36417,6 +36448,9 @@ function engineFlagsNote(args) {
   const named = among.join(", ");
   return `${named} ${among.length === 1 ? "is a flag" : "are flags"} the engine reads, and args goes to the game after --, where the engine does not read ${among.length === 1 ? "it" : "them"}. engineArgs hands the engine its own flags; ${among.length === 1 ? "leave it" : "leave them"} in args only for a game that reads ${among.length === 1 ? "that flag" : "those flags"} itself.`;
 }
+var EDITOR_FREE_INSTEAD = {
+  scene_tree: "runtime_inspect tree reads the nodes of a game that is running, and needs no editor; scene_tree reads a scene file through the editor"
+};
 var OPS_ELSEWHERE = {
   runtime_invoke: { get: "runtime_inspect property", property: "runtime_inspect property" }
 };
@@ -37607,7 +37641,7 @@ class GodotServer {
     const { op: _op, ...arguments_ } = args;
     const bridge = async (command, extra = {}) => {
       const contained = this.containProjectFiles({ ...arguments_, ...extra });
-      return contained.ok ? await this.handleViaBridge(command, contained.value) : contained.response;
+      return contained.ok ? await this.handleViaBridge(command, contained.value, tool) : contained.response;
     };
     switch (tool) {
       case "project_info":
@@ -39863,15 +39897,20 @@ class GodotServer {
         note: `${fresh.length} games of this project announced at once and none could be told from the process tree as this run's own game rather than one it started, so none is taken as its runtime. editor_status lists them under runtimes.`
       };
     }
+    const running = endpoint !== null || going !== null && await this.runStillGoing(going);
+    if (going !== null && !running) {
+      this.drainTranscript(going);
+    }
     return runtimeVerdict(endpoint, {
       addon: true,
       budgetMs,
       ...budget.sizedToMs === undefined ? {} : { sizedToMs: budget.sizedToMs },
       heldAt: this.dapClient?.whereItStopped() ?? null,
-      running: endpoint !== null || going !== null && await this.runStillGoing(going),
+      running,
       withArgs,
       servesAProject: this.ownProject !== null,
-      ...going?.throughEditor === true ? { playingSeen: going.seenPlaying === true } : {}
+      ...going?.throughEditor === true ? { playingSeen: going.seenPlaying === true } : {},
+      runtimeCameUp: going !== null && !running && going.log.all.some((entry) => entry.text.startsWith(RUNTIME_LISTENING_LINE))
     });
   }
   announceBudget(args, projectPath, scene) {
@@ -40727,6 +40766,8 @@ class GodotServer {
     await boot.settled;
     const errors = boot.log.count("error");
     const warnings = boot.log.count("warning");
+    const floor = engineArgs.includes("--verbose") ? "info" : "warning";
+    const printed = boot.log.count("info");
     return this.jsonTextResponse({
       booted: !hung && boot.exitCode === 0 && errors === 0,
       hung,
@@ -40740,7 +40781,8 @@ class GodotServer {
       argsNote: engineFlagsNote(userArgs),
       ...scanWaitAnswer(scanned),
       savesNote: asked.savesIn !== undefined && savesStayPut() ? SAVES_NOT_MOVED_NOTE : undefined,
-      ...foldedEntriesAnswer(boot.log, engineArgs.includes("--verbose") ? "info" : "warning")
+      printedLinesNotShown: floor === "warning" && printed > 0 ? printed : undefined,
+      ...foldedEntriesAnswer(boot.log, floor)
     });
   }
   async handleRunProfile(args) {
@@ -41807,9 +41849,11 @@ class GodotServer {
     const holds = held["classes"].map(String);
     return { unseen: unseenByEditor(projectPath, holds), stillHeld: heldButGone(projectPath, holds) };
   }
-  async handleViaBridge(toolName, args) {
+  async handleViaBridge(toolName, args, askedAs) {
     if (!this.godotBridge.isConnected()) {
+      const instead = askedAs !== undefined && Object.hasOwn(EDITOR_FREE_INSTEAD, askedAs) ? EDITOR_FREE_INSTEAD[askedAs] : undefined;
       return this.createErrorResponse("Editor not connected: no Godot editor with the gdharness editor addon has reached this server.", [
+        ...instead === undefined ? [] : [instead],
         "Open the project in the editor with editor_launch, or by hand",
         "Enable the addon under Project > Project Settings > Plugins",
         "editor_status says whether the bridge is up and what it is listening on"

package/package.json

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