gdharness 1.2.34 → 1.2.35

package/build/cli.js

@@ -8141,9 +8141,14 @@ class GameLog {
     const owner = this.lastHeadline[source];
     if (owner !== null && /^\s/.test(line)) {
       owner.detail.push(line.trim());
+      owner.continues = false;
       return;
     }
     const headline = announced(line);
+    if (owner?.continues === true && headline === null) {
+      owner.detail.push(line.trim());
+      return;
+    }
     const detail = [];
     const entry = {
       index: this.entries.length,
@@ -8156,7 +8161,7 @@ class GameLog {
     if (headline?.byScript === true) {
       this.byScript.add(entry.index);
     }
-    this.lastHeadline[source] = headline ? { detail } : null;
+    this.lastHeadline[source] = headline ? { detail, continues: source === "stderr" && headline.text.endsWith(":") } : null;
   }
   raisedByScript(entry) {
     return this.byScript.has(entry.index);
@@ -11558,20 +11563,36 @@ var init_tool_definitions = __esm(() => {
     {
       name: "project_export",
       title: "Export",
-      description: "Export presets and exports.",
+      description: "Export presets and exports. add_preset writes a preset to export_presets.cfg with the keys the editor's Project > Export writes for a new one, every platform option left at its default, and makes it the platform's runnable preset when the platform has none. It answers where this engine's export templates belong and whether the preset's platform has them, since an export needs them; list says the same for every preset. An editor open on the project does not see a preset added this way until it restarts. run names, as alsoWritten, what else the export wrote beside its output, such as the .pck a Windows or Linux build cannot start without.",
       parameters: {
         projectPath: PROJECT_PATH,
-        preset: { type: "string", description: "Preset name from export_presets.cfg." },
+        preset: {
+          type: "string",
+          ops: ["run", "add_preset"],
+          description: "Preset name from export_presets.cfg. add_preset: the name of the new one."
+        },
+        platform: {
+          type: "string",
+          ops: ["add_preset"],
+          enum: ["Windows Desktop", "Linux", "macOS", "Android", "iOS", "Web"],
+          description: "add_preset: the platform the preset exports for."
+        },
         outputPath: {
           type: "string",
-          description: `Where the export is written, inside the project. The directory is created if it is not there: Godot's command-line exporter refuses a missing one with "The given export path doesn't exist", which reads as a wrong path in the preset.`
+          ops: ["run", "add_preset"],
+          description: `Where the export is written, inside the project. The directory is created if it is not there: Godot's command-line exporter refuses a missing one with "The given export path doesn't exist", which reads as a wrong path in the preset. add_preset: the path the preset exports to from the editor, optional.`
         },
-        debug: { type: "boolean", description: "run: a debug export. Default false." }
+        debug: { type: "boolean", ops: ["run"], description: "run: a debug export. Default false." }
       },
       requires: ["projectPath"],
       operations: {
         list: { effect: "read", summary: "the presets in export_presets.cfg", requires: [] },
-        run: { effect: "destructive", summary: "export with a preset", requires: ["preset", "outputPath"] }
+        run: { effect: "destructive", summary: "export with a preset", requires: ["preset", "outputPath"] },
+        add_preset: {
+          effect: "additive",
+          summary: "add an export preset to export_presets.cfg",
+          requires: ["preset", "platform"]
+        }
       }
     },
     {
@@ -12946,7 +12967,7 @@ var init_headless_operations = __esm(() => {
       uid: "get_uid",
       refresh_classes: "refresh_class_cache"
     }),
-    project_export: dictionary({ list: "list_export_presets" }),
+    project_export: dictionary({ list: "list_export_presets", add_preset: "add_export_preset" }),
     script_edit: dictionary({ create: "create_script", modify: "modify_script" }),
     script_info: dictionary({ structure: "get_script_info" }),
     editor_classes: dictionary({
@@ -44892,7 +44913,7 @@ function exportPresetRefusal(projectPath, preset) {
   try {
     text = readFileSync26(join30(projectPath, "export_presets.cfg"), "utf8");
   } catch {
-    return `This project has no export_presets.cfg, so it has no preset '${preset}' to export with. The editor writes the file when a preset is added in Project > Export.`;
+    return `This project has no export_presets.cfg, so it has no preset '${preset}' to export with. project_export add_preset writes one, as the editor's Project > Export does.`;
   }
   const names = [];
   let inPreset = false;
@@ -44910,9 +44931,9 @@ function exportPresetRefusal(projectPath, preset) {
   if (names.includes(preset)) {
     return null;
   }
-  return names.length === 0 ? `export_presets.cfg names no preset, so there is no '${preset}' to export with. The editor adds one in Project > Export.` : `This project has no export preset named '${preset}'. Its presets are ${names.map((name) => `'${name}'`).join(", ")}.`;
+  return names.length === 0 ? `export_presets.cfg names no preset, so there is no '${preset}' to export with. project_export add_preset adds one.` : `This project has no export preset named '${preset}'. Its presets are ${names.map((name) => `'${name}'`).join(", ")}.`;
 }
-function exportAnswer(ending, asked, before, after) {
+function exportAnswer(ending, asked, before, after, beside = []) {
   const { log } = ending;
   const written = after !== null && after !== before;
   const notCopied = librariesNotCopied(log.all);
@@ -44924,6 +44945,7 @@ function exportAnswer(ending, asked, before, after) {
     failure: ending.failure ?? undefined,
     errors: log.count("error"),
     warnings: log.count("warning"),
+    ...beside.length === 0 ? {} : { alsoWritten: beside },
     ...notCopied.length === 0 ? {} : {
       librariesNotLoaded: notCopied,
       extensionNote: `The export could not load ${notCopied.join(" and ")}: on Windows an engine running as the editor, which an export is, loads a GDExtension from a ~ copy beside the library, and another engine on this project held that copy: it could not be moved aside before the export, or another engine made a new one in between. Export again once that engine has loaded or exited.`
@@ -44946,6 +44968,20 @@ function exportAnswer(ending, asked, before, after) {
     isError: true
   };
 }
+function writtenBeside(before, after, output, within) {
+  return [...after].filter(([name, at]) => name !== output && before.get(name) !== at).map(([name]) => within === "." ? name : `${within}/${name}`).sort();
+}
+function filesIn(folder) {
+  const found = new Map;
+  try {
+    for (const entry of readdirSync13(folder, { withFileTypes: true })) {
+      if (entry.isFile()) {
+        found.set(entry.name, statSync13(join30(folder, entry.name)).mtimeMs);
+      }
+    }
+  } catch {}
+  return found;
+}
 function scanWaitAnswer(scanned, started = "game") {
   if (scanned.waitedMs === 0) {
     return {};
@@ -46180,6 +46216,9 @@ class GodotServer {
     if (tool === "project_import" && op === "set_options") {
       return await this.handleSetImportOptions(args);
     }
+    if (tool === "project_export" && op === "add_preset") {
+      return await this.handleAddExportPreset(args);
+    }
     const headless = HEADLESS_OPERATIONS[tool]?.[op];
     if (headless !== undefined) {
       const { from: asked, ...answerable } = args;
@@ -47243,6 +47282,30 @@ class GodotServer {
       return this.createErrorResponse(`Search failed: ${errorMessage(error)}`);
     }
   }
+  async handleAddExportPreset(args) {
+    const project = this.project(args);
+    if (!project.ok) {
+      return project.response;
+    }
+    const given = readNonEmptyString(args, "outputPath");
+    const output = given === undefined ? null : resolveWithinProject(project.value.path, given);
+    if (output !== null && !output.ok) {
+      return this.createErrorResponse(output.reason, OUTPUT_PATH_SOLUTIONS);
+    }
+    const outcome = await this.operation("add_export_preset", {
+      preset: readString(args, "preset") ?? "",
+      platform: readString(args, "platform") ?? "",
+      outputPath: output?.relativePath ?? ""
+    }, project.value.path);
+    if (!outcome.ok || !this.editorHasOpen(project.value.path)) {
+      return this.answer(outcome);
+    }
+    return this.jsonTextResponse({
+      ...outcome.payload,
+      editorNote: "The editor open on this project read export_presets.cfg when it started and does not list this preset, and saving presets in its Export dialog writes its own list over the file. editor_launch restart loads the file; an export through project_export run reads the file and needs no restart.",
+      ...engineExtras(outcome)
+    });
+  }
   async handleExportProject(args) {
     const project = this.project(args);
     if (!project.ok) {
@@ -47251,11 +47314,14 @@ class GodotServer {
     const preset = readNonEmptyString(args, "preset") ?? "";
     const output = resolveWithinProject(project.value.path, readString(args, "outputPath") ?? "");
     if (!output.ok) {
-      return this.createErrorResponse(output.reason, PATH_SOLUTIONS);
+      return this.createErrorResponse(output.reason, OUTPUT_PATH_SOLUTIONS);
     }
     const noPreset = exportPresetRefusal(project.value.path, preset);
     if (noPreset !== null) {
-      return this.createErrorResponse(noPreset, ["project_export list reads the presets the project has"]);
+      return this.createErrorResponse(noPreset, [
+        "project_export list reads the presets the project has",
+        "project_export add_preset adds one"
+      ]);
     }
     const engine = await this.engine();
     if (!engine.ok) {
@@ -47282,6 +47348,7 @@ class GodotServer {
     this.logDebug(`Exporting: ${engine.value} ${exportArgs.join(" ")}`);
     const writtenAt = () => existsSync23(output.absolutePath) ? statSync13(output.absolutePath).mtimeMs : null;
     const before = writtenAt();
+    const listedBefore = filesIn(folder);
     const freed = freeLibraryCopies(project.value.path);
     if (freed.setAside.length > 0 || freed.swept.length > 0) {
       this.logDebug(`Before the export: set aside ${freed.setAside.join(", ")}; swept ${freed.swept.join(", ")}`);
@@ -47295,7 +47362,8 @@ class GodotServer {
     if (ending.exitSignal === null && ending.exitCode === null) {
       return this.createErrorResponse(`Export could not be run: ${ending.failure ?? "the engine gave no exit status"}`);
     }
-    return exportAnswer(ending, { preset, outputPath: output.relativePath, debug }, before, writtenAt());
+    const beside = writtenBeside(listedBefore, filesIn(folder), basename9(output.absolutePath), dirname22(output.relativePath).replaceAll("\\", "/"));
+    return exportAnswer(ending, { preset, outputPath: output.relativePath, debug }, before, writtenAt(), beside);
   }
   reportTestProgress(log) {
     const progress = callProgress();
@@ -51385,7 +51453,7 @@ async function runGodotServer() {
   const server = new GodotServer;
   await server.run();
 }
-var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, __dirname2, PARENT_ASKED_AFTER_MS = 5000, EDITOR_SERVERS_START_MS = 20000, HOLD_PING_MS = 2000, SLOWEST_FRAME_RATE = 20, ALONGSIDE_NOTE = "Another call on this game was running while this one was: calls sent together run together and are answered as each finishes, so this answer is not from after the other. Send a call meant to come after another once that one has answered.", OWN_DEBUGGER = " Its debugger is the keeper holding it rather than the editor, so the debug_* tools answer for it all the same: breakpoints stop it, and debug_control pause breaks into it wherever it is, which the editor offers no way to do.", PLAY_STARTS_WITHIN_MS = 30000, KEEPER_ANSWER_MS = 15000, KEEPER_DEBUG_MS, EXIT_REPORTED_WITHIN_MS = 2000, CLOSE_ASK_MS = 3000, 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, 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, __dirname2, PARENT_ASKED_AFTER_MS = 5000, EDITOR_SERVERS_START_MS = 20000, HOLD_PING_MS = 2000, SLOWEST_FRAME_RATE = 20, ALONGSIDE_NOTE = "Another call on this game was running while this one was: calls sent together run together and are answered as each finishes, so this answer is not from after the other. Send a call meant to come after another once that one has answered.", OWN_DEBUGGER = " Its debugger is the keeper holding it rather than the editor, so the debug_* tools answer for it all the same: breakpoints stop it, and debug_control pause breaks into it wherever it is, which the editor offers no way to do.", PLAY_STARTS_WITHIN_MS = 30000, KEEPER_ANSWER_MS = 15000, KEEPER_DEBUG_MS, EXIT_REPORTED_WITHIN_MS = 2000, CLOSE_ASK_MS = 3000, 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, 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, OUTPUT_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();
@@ -51467,6 +51535,9 @@ var init_server = __esm(() => {
     'Give the path relative to the project, such as "scenes/main.tscn" or "res://scenes/main.tscn"',
     "Point projectPath at the project the file belongs to"
   ];
+  OUTPUT_PATH_SOLUTIONS = [
+    'Give outputPath inside the project, relative to it, such as "build/game.exe" or "res://build/game.exe"; copy the build elsewhere once it is exported'
+  ];
   PROJECT_FILE_ARGUMENTS = [
     "scenePath",
     "instancePath",

package/build/godot/operations/export_presets.gd

@@ -0,0 +1,232 @@
+extends RefCounted
+
+## export_presets.cfg, read and written in the format the editor's Project > Export saves it in.
+
+const Read = preload("reading.gd")
+const Log = preload("logger.gd")
+
+const PRESETS_FILE: String = "res://export_presets.cfg"
+## Where the editor names the one preset of each platform it runs on a device.
+const RUNNABLE_SECTION: String = "runnable_presets"
+## The platforms the editor's exporter offers, by the name a preset gives its platform, each with
+## how the names of its files in the export templates directory begin.
+const PLATFORMS: Dictionary[String, String] = {
+	"Windows Desktop": "windows_",
+	"Linux": "linux_",
+	"macOS": "macos",
+	"Android": "android_",
+	"iOS": "ios",
+	"Web": "web_",
+}
+
+var _log: Log
+
+
+func _init(p_log: Log) -> void:
+	_log = p_log
+
+
+## The names of the project's export presets, in the order export_presets.cfg holds them.
+static func names() -> Array[String]:
+	var named: Array[String] = []
+	var config: ConfigFile = ConfigFile.new()
+	if config.load(PRESETS_FILE) != OK:
+		return named
+	var index: int = 0
+	while config.has_section("preset." + str(index)):
+		named.append(str(config.get_value("preset." + str(index), "name", "")))
+		index += 1
+	return named
+
+
+func list_export_presets(_params: Dictionary) -> Dictionary:
+	if not FileAccess.file_exists(PRESETS_FILE):
+		return {
+			"presets": [],
+			"presets_file_exists": false,
+			"note":
+			(
+				"No export_presets.cfg found. project_export add_preset adds a preset, as the editor's "
+				+ "Project > Export does."
+			)
+		}
+	var config: ConfigFile = ConfigFile.new()
+	var err: Error = config.load(PRESETS_FILE)
+	if err != OK:
+		return _log.failure("Failed to parse export_presets.cfg: " + error_string(err))
+
+	var templates: String = _templates_dir()
+	var presets: Array[Dictionary] = []
+	var index: int = 0
+	while config.has_section("preset." + str(index)):
+		var section: String = "preset." + str(index)
+		var platform: String = str(config.get_value(section, "platform", "Unknown"))
+		var preset: Dictionary = {
+			"index": index,
+			"name": config.get_value(section, "name", "Unknown"),
+			"platform": platform,
+			"runnable": _runnable(config, section),
+			"export_path": config.get_value(section, "export_path", ""),
+			"export_filter": config.get_value(section, "export_filter", "all_resources"),
+			"include_filter": config.get_value(section, "include_filter", ""),
+			"exclude_filter": config.get_value(section, "exclude_filter", "")
+		}
+		if config.has_section_key(section, "custom_features"):
+			preset["custom_features"] = config.get_value(section, "custom_features", "")
+		# Left out for a platform this file names and the exporter does not know, which has no
+		# templates to look for.
+		if platform in PLATFORMS:
+			preset["templates_installed"] = _installed(templates, platform)
+		presets.append(preset)
+		index += 1
+	return {"presets": presets, "presets_file_exists": true, "total_presets": index, "templates": templates}
+
+
+## Whether the preset in [param section] is the one its platform runs. The editor names that preset
+## in a section of its own, and kept a key in the preset's section only in files saved before that.
+static func _runnable(config: ConfigFile, section: String) -> bool:
+	var platform: String = str(config.get_value(section, "platform", ""))
+	if config.has_section_key(RUNNABLE_SECTION, platform):
+		return str(config.get_value(RUNNABLE_SECTION, platform)) == str(config.get_value(section, "name", ""))
+	return Read.as_bool(config.get_value(section, "runnable", false))
+
+
+## Adds an export preset to export_presets.cfg, written with the keys the editor's Project > Export
+## writes for a new one. The editor's exporter fills every platform option the file leaves out with
+## its default when it loads the file, which is what a preset fresh from that dialog holds too.
+func add_export_preset(params: Dictionary) -> Dictionary:
+	var preset_name: String = str(params.get("preset", "")).strip_edges()
+	var platform: String = str(params.get("platform", ""))
+	var export_path: String = str(params.get("output_path", "")).trim_prefix("res://")
+	if preset_name.is_empty():
+		return _log.failure("preset is required: the name the preset is exported by")
+	if platform not in PLATFORMS:
+		return _log.failure(
+			"Unknown platform '%s'. The platforms are %s." % [platform, ", ".join(PLATFORMS.keys())]
+		)
+	var config: ConfigFile = ConfigFile.new()
+	if FileAccess.file_exists(PRESETS_FILE):
+		var loading: Error = config.load(PRESETS_FILE)
+		if loading != OK:
+			return _log.failure("Failed to parse export_presets.cfg: " + error_string(loading))
+	var index: int = 0
+	while config.has_section("preset." + str(index)):
+		var held: String = "preset." + str(index)
+		if str(config.get_value(held, "name", "")) == preset_name:
+			return _log.failure(
+				(
+					(
+						"There is already an export preset named '%s', for %s, exporting to '%s'. "
+						+ "project_export run exports with it; give another name to add a second."
+					)
+					% [
+						preset_name,
+						config.get_value(held, "platform", ""),
+						config.get_value(held, "export_path", "")
+					]
+				)
+			)
+		index += 1
+	# A platform with no preset to run takes the new one, as the editor's dialog does.
+	var runnable: bool = not config.has_section_key(RUNNABLE_SECTION, platform)
+	if runnable:
+		config.set_value(RUNNABLE_SECTION, platform, preset_name)
+
+	var section: String = "preset." + str(index)
+	var values: Dictionary = {
+		"name": preset_name,
+		"platform": platform,
+		"dedicated_server": false,
+		"custom_features": "",
+		"export_filter": "all_resources",
+		"include_filter": "",
+		"exclude_filter": "",
+		"export_path": export_path,
+		"patches": PackedStringArray(),
+		"encryption_include_filters": "",
+		"encryption_exclude_filters": "",
+		"seed": 0,
+		"encrypt_pck": false,
+		"encrypt_directory": false,
+		"script_export_mode": 2,
+	}
+	for key: String in values:
+		config.set_value(section, key, values[key])
+	# A section with nothing in it is not written, and the editor's loader reports a missing options
+	# section as an error; these two are options of every platform, empty in a new preset.
+	config.set_value(section + ".options", "custom_template/debug", "")
+	config.set_value(section + ".options", "custom_template/release", "")
+	var saving: Error = config.save(PRESETS_FILE)
+	if saving != OK:
+		return _log.failure("Failed to save export_presets.cfg: " + error_string(saving))
+
+	var templates: String = _templates_dir()
+	var installed: bool = _installed(templates, platform)
+	var answer: Dictionary = {
+		"preset": preset_name,
+		"platform": platform,
+		"index": index,
+		"runnable": runnable,
+		"export_path": export_path,
+		"file": PRESETS_FILE,
+		"templates": templates,
+		"templates_installed": installed,
+	}
+	if not installed:
+		answer["templates_note"] = (
+			(
+				"No %s export templates for this engine are at %s, and an export for %s needs them. The "
+				+ "editor installs them in Editor > Manage Export Templates, or they can be unpacked "
+				+ "there from the export templates archive of this engine's release."
+			)
+			% [platform, templates, platform]
+		)
+	return answer
+
+
+## Where the editor of this engine keeps its export templates: beside the executable for a
+## self-contained one, otherwise in the user's data directory, as the editor's own paths have it.
+static func _templates_dir() -> String:
+	var version: Dictionary = Engine.get_version_info()
+	var named: String = "%d.%d" % [Read.as_int(version.get("major", 0)), Read.as_int(version.get("minor", 0))]
+	if Read.as_int(version.get("patch", 0)) != 0:
+		named += "." + str(Read.as_int(version.get("patch", 0)))
+	named += "." + str(version.get("status", ""))
+	if ClassDB.class_exists("CSharpScript"):
+		named += ".mono"
+	var beside: String = OS.get_executable_path().get_base_dir()
+	var contained: bool = _marks_self_contained(beside)
+	# A macOS bundle is read-only, so its editor looks for the marker beside the bundle too, and keeps
+	# its data there whichever of the two places had it.
+	if (
+		OS.has_feature("macos")
+		and beside.ends_with("MacOS")
+		and beside.path_join("..").simplify_path().ends_with("Contents")
+	):
+		beside = beside.path_join("../../..").simplify_path()
+		contained = contained or _marks_self_contained(beside)
+	if contained:
+		return beside.path_join("editor_data").path_join("export_templates").path_join(named)
+	var home: String = (
+		"godot" if OS.get_name() in ["Linux", "FreeBSD", "NetBSD", "OpenBSD", "BSD"] else "Godot"
+	)
+	return OS.get_data_dir().path_join(home).path_join("export_templates").path_join(named)
+
+
+## Whether [param templates] holds any of [param platform]'s templates. The directory is one per
+## engine version and holds whichever platforms were installed into it, so its being there says
+## nothing about this platform.
+static func _installed(templates: String, platform: String) -> bool:
+	if not DirAccess.dir_exists_absolute(templates):
+		return false
+	for file: String in DirAccess.get_files_at(templates):
+		if file.begins_with(PLATFORMS[platform]):
+			return true
+	return false
+
+
+static func _marks_self_contained(directory: String) -> bool:
+	return (
+		FileAccess.file_exists(directory.path_join("._sc_"))
+		or FileAccess.file_exists(directory.path_join("_sc_"))
+	)

package/build/godot/operations/godot_operations.gd

@@ -19,6 +19,7 @@ const AudioBuses = preload("audio_buses.gd")
 const ClassCache = preload("class_cache.gd")
 const ClassDbQueries = preload("classdb_queries.gd")
 const Dependencies = preload("dependencies.gd")
+const ExportPresets = preload("export_presets.gd")
 const FileReads = preload("file_reads.gd")
 const GdscriptAnalysis = preload("gdscript_analysis.gd")
 const GdscriptAuthoring = preload("gdscript_authoring.gd")
@@ -179,7 +180,9 @@ func _run(operation: String, params: Dictionary) -> Dictionary:
 		"set_import_options":
 			payload = ImportPipeline.new(_log).set_import_options(params)
 		"list_export_presets":
-			payload = ImportPipeline.new(_log).list_export_presets(params)
+			payload = ExportPresets.new(_log).list_export_presets(params)
+		"add_export_preset":
+			payload = ExportPresets.new(_log).add_export_preset(params)
 		"validate_project":
 			payload = ImportPipeline.new(_log).validate_project(params)
 

package/build/godot/operations/import_pipeline.gd

@@ -1,5 +1,6 @@
 extends RefCounted
 
+const ExportPresets = preload("export_presets.gd")
 const Read = preload("reading.gd")
 const Serialisation = preload("serialisation.gd")
 const FileWalk = preload("file_walk.gd")
@@ -319,63 +320,6 @@ static func _all_ints(held: Variant, keys: bool) -> bool:
 	return true
 
 
-# The names of the project's export presets, in the order export_presets.cfg holds them.
-static func _preset_names() -> Array[String]:
-	var names: Array[String] = []
-	var config: ConfigFile = ConfigFile.new()
-	if config.load("res://export_presets.cfg") != OK:
-		return names
-	var index: int = 0
-	while config.has_section("preset." + str(index)):
-		names.append(str(config.get_value("preset." + str(index), "name", "")))
-		index += 1
-	return names
-
-
-# List export presets
-func list_export_presets(_params: Dictionary) -> Dictionary:
-	_log.info("Listing export presets")
-
-	var presets_file: String = "res://export_presets.cfg"
-
-	if not FileAccess.file_exists(presets_file):
-		return {
-			"presets": [],
-			"presets_file_exists": false,
-			"note": "No export_presets.cfg found. Configure export presets in the Godot editor."
-		}
-
-	var config: ConfigFile = ConfigFile.new()
-	var err: Error = config.load(presets_file)
-
-	if err != OK:
-		return _log.failure("Failed to parse export_presets.cfg: " + str(err))
-
-	# Export presets are stored as [preset.0], [preset.1], etc.
-	var presets: Array[Dictionary] = []
-	var preset_idx: int = 0
-	while config.has_section("preset." + str(preset_idx)):
-		var section: String = "preset." + str(preset_idx)
-		var preset: Dictionary = {
-			"index": preset_idx,
-			"name": config.get_value(section, "name", "Unknown"),
-			"platform": config.get_value(section, "platform", "Unknown"),
-			"runnable": config.get_value(section, "runnable", false),
-			"export_path": config.get_value(section, "export_path", ""),
-			"export_filter": config.get_value(section, "export_filter", "all_resources"),
-			"include_filter": config.get_value(section, "include_filter", ""),
-			"exclude_filter": config.get_value(section, "exclude_filter", "")
-		}
-
-		if config.has_section_key(section, "custom_features"):
-			preset["custom_features"] = config.get_value(section, "custom_features", "")
-
-		presets.append(preset)
-		preset_idx += 1
-
-	return {"presets": presets, "presets_file_exists": true, "total_presets": preset_idx}
-
-
 # Validate project for export
 func validate_project(params: Dictionary) -> Dictionary:
 	var preset_name: String = str(params.get("preset", ""))
@@ -429,7 +373,7 @@ func validate_project(params: Dictionary) -> Dictionary:
 				"warning",
 				"export_presets",
 				"No export presets configured",
-				"Configure export presets in Godot editor: Project > Export",
+				"Add a preset with project_export add_preset, or in the editor: Project > Export",
 				include_suggestions
 			)
 		)
@@ -438,7 +382,7 @@ func validate_project(params: Dictionary) -> Dictionary:
 	# does not exist answered valid, as though it had been checked.
 	if not preset_name.is_empty():
 		checks_performed.append("export_preset")
-		var named: Array[String] = _preset_names()
+		var named: Array[String] = ExportPresets.names()
 		if preset_name not in named:
 			issues.append(
 				_finding(
@@ -453,7 +397,7 @@ func validate_project(params: Dictionary) -> Dictionary:
 							else ": the presets are " + ", ".join(named)
 						)
 					),
-					"Pass one of the preset names, or add the preset in the editor: Project > Export",
+					"Pass one of the preset names, or add the preset with project_export add_preset",
 					include_suggestions
 				)
 			)

package/build/godot/operations/project_diagnostics.gd

@@ -148,7 +148,9 @@ func get_project_health(params: Dictionary) -> Dictionary:
 		recommendations.append("Address critical issues to improve project stability")
 	# A project still being made has no presets yet, which is no fault in it.
 	if "config" in check_categories and not FileAccess.file_exists("res://export_presets.cfg"):
-		recommendations.append("No export presets are configured: add them before exporting")
+		recommendations.append(
+			"No export presets are configured: project_export add_preset adds one before exporting"
+		)
 
 	# Every detail costs points, so each is an issue; `issues` was always empty beside them, and a
 	# category said passed next to the failure it had just found.

package/build/index.js

@@ -28717,9 +28717,14 @@ class GameLog {
     const owner = this.lastHeadline[source];
     if (owner !== null && /^\s/.test(line)) {
       owner.detail.push(line.trim());
+      owner.continues = false;
       return;
     }
     const headline = announced(line);
+    if (owner?.continues === true && headline === null) {
+      owner.detail.push(line.trim());
+      return;
+    }
     const detail = [];
     const entry = {
       index: this.entries.length,
@@ -28732,7 +28737,7 @@ class GameLog {
     if (headline?.byScript === true) {
       this.byScript.add(entry.index);
     }
-    this.lastHeadline[source] = headline ? { detail } : null;
+    this.lastHeadline[source] = headline ? { detail, continues: source === "stderr" && headline.text.endsWith(":") } : null;
   }
   raisedByScript(entry) {
     return this.byScript.has(entry.index);
@@ -33314,7 +33319,7 @@ var HEADLESS_OPERATIONS = dictionary({
     uid: "get_uid",
     refresh_classes: "refresh_class_cache"
   }),
-  project_export: dictionary({ list: "list_export_presets" }),
+  project_export: dictionary({ list: "list_export_presets", add_preset: "add_export_preset" }),
   script_edit: dictionary({ create: "create_script", modify: "modify_script" }),
   script_info: dictionary({ structure: "get_script_info" }),
   editor_classes: dictionary({
@@ -35290,20 +35295,36 @@ var TOOL_SPECS = [
   {
     name: "project_export",
     title: "Export",
-    description: "Export presets and exports.",
+    description: "Export presets and exports. add_preset writes a preset to export_presets.cfg with the keys the editor's Project > Export writes for a new one, every platform option left at its default, and makes it the platform's runnable preset when the platform has none. It answers where this engine's export templates belong and whether the preset's platform has them, since an export needs them; list says the same for every preset. An editor open on the project does not see a preset added this way until it restarts. run names, as alsoWritten, what else the export wrote beside its output, such as the .pck a Windows or Linux build cannot start without.",
     parameters: {
       projectPath: PROJECT_PATH2,
-      preset: { type: "string", description: "Preset name from export_presets.cfg." },
+      preset: {
+        type: "string",
+        ops: ["run", "add_preset"],
+        description: "Preset name from export_presets.cfg. add_preset: the name of the new one."
+      },
+      platform: {
+        type: "string",
+        ops: ["add_preset"],
+        enum: ["Windows Desktop", "Linux", "macOS", "Android", "iOS", "Web"],
+        description: "add_preset: the platform the preset exports for."
+      },
       outputPath: {
         type: "string",
-        description: `Where the export is written, inside the project. The directory is created if it is not there: Godot's command-line exporter refuses a missing one with "The given export path doesn't exist", which reads as a wrong path in the preset.`
+        ops: ["run", "add_preset"],
+        description: `Where the export is written, inside the project. The directory is created if it is not there: Godot's command-line exporter refuses a missing one with "The given export path doesn't exist", which reads as a wrong path in the preset. add_preset: the path the preset exports to from the editor, optional.`
       },
-      debug: { type: "boolean", description: "run: a debug export. Default false." }
+      debug: { type: "boolean", ops: ["run"], description: "run: a debug export. Default false." }
     },
     requires: ["projectPath"],
     operations: {
       list: { effect: "read", summary: "the presets in export_presets.cfg", requires: [] },
-      run: { effect: "destructive", summary: "export with a preset", requires: ["preset", "outputPath"] }
+      run: { effect: "destructive", summary: "export with a preset", requires: ["preset", "outputPath"] },
+      add_preset: {
+        effect: "additive",
+        summary: "add an export preset to export_presets.cfg",
+        requires: ["preset", "platform"]
+      }
     }
   },
   {
@@ -37565,7 +37586,7 @@ function exportPresetRefusal(projectPath, preset) {
   try {
     text = readFileSync24(join26(projectPath, "export_presets.cfg"), "utf8");
   } catch {
-    return `This project has no export_presets.cfg, so it has no preset '${preset}' to export with. The editor writes the file when a preset is added in Project > Export.`;
+    return `This project has no export_presets.cfg, so it has no preset '${preset}' to export with. project_export add_preset writes one, as the editor's Project > Export does.`;
   }
   const names = [];
   let inPreset = false;
@@ -37583,9 +37604,9 @@ function exportPresetRefusal(projectPath, preset) {
   if (names.includes(preset)) {
     return null;
   }
-  return names.length === 0 ? `export_presets.cfg names no preset, so there is no '${preset}' to export with. The editor adds one in Project > Export.` : `This project has no export preset named '${preset}'. Its presets are ${names.map((name) => `'${name}'`).join(", ")}.`;
+  return names.length === 0 ? `export_presets.cfg names no preset, so there is no '${preset}' to export with. project_export add_preset adds one.` : `This project has no export preset named '${preset}'. Its presets are ${names.map((name) => `'${name}'`).join(", ")}.`;
 }
-function exportAnswer(ending, asked, before, after) {
+function exportAnswer(ending, asked, before, after, beside = []) {
   const { log } = ending;
   const written = after !== null && after !== before;
   const notCopied = librariesNotCopied(log.all);
@@ -37597,6 +37618,7 @@ function exportAnswer(ending, asked, before, after) {
     failure: ending.failure ?? undefined,
     errors: log.count("error"),
     warnings: log.count("warning"),
+    ...beside.length === 0 ? {} : { alsoWritten: beside },
     ...notCopied.length === 0 ? {} : {
       librariesNotLoaded: notCopied,
       extensionNote: `The export could not load ${notCopied.join(" and ")}: on Windows an engine running as the editor, which an export is, loads a GDExtension from a ~ copy beside the library, and another engine on this project held that copy: it could not be moved aside before the export, or another engine made a new one in between. Export again once that engine has loaded or exited.`
@@ -37619,6 +37641,20 @@ function exportAnswer(ending, asked, before, after) {
     isError: true
   };
 }
+function writtenBeside(before, after, output, within) {
+  return [...after].filter(([name, at]) => name !== output && before.get(name) !== at).map(([name]) => within === "." ? name : `${within}/${name}`).sort();
+}
+function filesIn(folder) {
+  const found = new Map;
+  try {
+    for (const entry of readdirSync11(folder, { withFileTypes: true })) {
+      if (entry.isFile()) {
+        found.set(entry.name, statSync12(join26(folder, entry.name)).mtimeMs);
+      }
+    }
+  } catch {}
+  return found;
+}
 function scanWaitAnswer(scanned, started = "game") {
   if (scanned.waitedMs === 0) {
     return {};
@@ -37856,6 +37892,9 @@ var PATH_SOLUTIONS = [
   'Give the path relative to the project, such as "scenes/main.tscn" or "res://scenes/main.tscn"',
   "Point projectPath at the project the file belongs to"
 ];
+var OUTPUT_PATH_SOLUTIONS = [
+  'Give outputPath inside the project, relative to it, such as "build/game.exe" or "res://build/game.exe"; copy the build elsewhere once it is exported'
+];
 var PROJECT_FILE_ARGUMENTS = [
   "scenePath",
   "instancePath",
@@ -38910,6 +38949,9 @@ class GodotServer {
     if (tool === "project_import" && op === "set_options") {
       return await this.handleSetImportOptions(args);
     }
+    if (tool === "project_export" && op === "add_preset") {
+      return await this.handleAddExportPreset(args);
+    }
     const headless = HEADLESS_OPERATIONS[tool]?.[op];
     if (headless !== undefined) {
       const { from: asked, ...answerable } = args;
@@ -39973,6 +40015,30 @@ class GodotServer {
       return this.createErrorResponse(`Search failed: ${errorMessage(error)}`);
     }
   }
+  async handleAddExportPreset(args) {
+    const project = this.project(args);
+    if (!project.ok) {
+      return project.response;
+    }
+    const given = readNonEmptyString(args, "outputPath");
+    const output = given === undefined ? null : resolveWithinProject(project.value.path, given);
+    if (output !== null && !output.ok) {
+      return this.createErrorResponse(output.reason, OUTPUT_PATH_SOLUTIONS);
+    }
+    const outcome = await this.operation("add_export_preset", {
+      preset: readString(args, "preset") ?? "",
+      platform: readString(args, "platform") ?? "",
+      outputPath: output?.relativePath ?? ""
+    }, project.value.path);
+    if (!outcome.ok || !this.editorHasOpen(project.value.path)) {
+      return this.answer(outcome);
+    }
+    return this.jsonTextResponse({
+      ...outcome.payload,
+      editorNote: "The editor open on this project read export_presets.cfg when it started and does not list this preset, and saving presets in its Export dialog writes its own list over the file. editor_launch restart loads the file; an export through project_export run reads the file and needs no restart.",
+      ...engineExtras(outcome)
+    });
+  }
   async handleExportProject(args) {
     const project = this.project(args);
     if (!project.ok) {
@@ -39981,11 +40047,14 @@ class GodotServer {
     const preset = readNonEmptyString(args, "preset") ?? "";
     const output = resolveWithinProject(project.value.path, readString(args, "outputPath") ?? "");
     if (!output.ok) {
-      return this.createErrorResponse(output.reason, PATH_SOLUTIONS);
+      return this.createErrorResponse(output.reason, OUTPUT_PATH_SOLUTIONS);
     }
     const noPreset = exportPresetRefusal(project.value.path, preset);
     if (noPreset !== null) {
-      return this.createErrorResponse(noPreset, ["project_export list reads the presets the project has"]);
+      return this.createErrorResponse(noPreset, [
+        "project_export list reads the presets the project has",
+        "project_export add_preset adds one"
+      ]);
     }
     const engine = await this.engine();
     if (!engine.ok) {
@@ -40012,6 +40081,7 @@ class GodotServer {
     this.logDebug(`Exporting: ${engine.value} ${exportArgs.join(" ")}`);
     const writtenAt = () => existsSync20(output.absolutePath) ? statSync12(output.absolutePath).mtimeMs : null;
     const before = writtenAt();
+    const listedBefore = filesIn(folder);
     const freed = freeLibraryCopies(project.value.path);
     if (freed.setAside.length > 0 || freed.swept.length > 0) {
       this.logDebug(`Before the export: set aside ${freed.setAside.join(", ")}; swept ${freed.swept.join(", ")}`);
@@ -40025,7 +40095,8 @@ class GodotServer {
     if (ending.exitSignal === null && ending.exitCode === null) {
       return this.createErrorResponse(`Export could not be run: ${ending.failure ?? "the engine gave no exit status"}`);
     }
-    return exportAnswer(ending, { preset, outputPath: output.relativePath, debug }, before, writtenAt());
+    const beside = writtenBeside(listedBefore, filesIn(folder), basename7(output.absolutePath), dirname18(output.relativePath).replaceAll("\\", "/"));
+    return exportAnswer(ending, { preset, outputPath: output.relativePath, debug }, before, writtenAt(), beside);
   }
   reportTestProgress(log) {
     const progress = callProgress();

package/package.json

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