gdharness 0.13.11 → 0.13.13

package/build/cli.js

@@ -7281,6 +7281,32 @@ var init_game_log = __esm(() => {
   STREAMS = ["stdout", "stderr", "transcript"];
 });
 
+// src/scratch.ts
+import { rmSync as rmSync2 } from "node:fs";
+function discardWith(remove, paths) {
+  const left = [];
+  for (const path of paths) {
+    if (!path) {
+      continue;
+    }
+    try {
+      remove(path);
+    } catch (error) {
+      left.push({ path, reason: error instanceof Error ? error.message : String(error) });
+    }
+  }
+  return left;
+}
+function discard(...paths) {
+  return discardWith((path) => {
+    rmSync2(path, SWEPT);
+  }, paths);
+}
+var SWEPT;
+var init_scratch = __esm(() => {
+  SWEPT = { recursive: true, force: true, maxRetries: 20, retryDelay: 250 };
+});
+
 // src/update-check.ts
 import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir3, tmpdir as tmpdir2 } from "node:os";
@@ -7554,7 +7580,7 @@ var init_class_cache = () => {};
 
 // src/headless.ts
 import { execFile as execFile3 } from "node:child_process";
-import { mkdtempSync as mkdtempSync2, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { mkdtempSync as mkdtempSync2, writeFileSync as writeFileSync4 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join7 } from "node:path";
 import { promisify as promisify3 } from "node:util";
@@ -7595,6 +7621,36 @@ function reason2(stdout, stderr) {
   }
   return stdout.trim().split(/\r?\n/).at(-1) ?? "no output at all";
 }
+async function runImport(godotPath, projectPath) {
+  const logDir = mkdtempSync2(join7(tmpdir3(), "gdharness-import-"));
+  try {
+    const { stderr } = await run3(godotPath, [
+      "--headless",
+      "--log-file",
+      join7(logDir, "engine.log"),
+      "--path",
+      projectPath,
+      "--import"
+    ]);
+    return { ok: true, messages: problems2(stderr) };
+  } catch (error) {
+    if (error instanceof Error && "stdout" in error && "stderr" in error) {
+      const failed = error;
+      return {
+        ok: false,
+        message: `the import pass failed (exit ${failed.code ?? "unknown"}): ${reason2(failed.stdout, failed.stderr)}`,
+        messages: problems2(failed.stderr)
+      };
+    }
+    return {
+      ok: false,
+      message: `the import pass could not be run: ${error instanceof Error ? error.message : String(error)}`,
+      messages: []
+    };
+  } finally {
+    discard(logDir);
+  }
+}
 async function runOperation2(engine, operation, params, projectPath) {
   const paramsDir = mkdtempSync2(join7(tmpdir3(), "gdharness-params-"));
   const paramsFile = join7(paramsDir, `${operation}.json`);
@@ -7630,7 +7686,7 @@ async function runOperation2(engine, operation, params, projectPath) {
       messages: []
     };
   } finally {
-    rmSync3(paramsDir, { recursive: true, force: true });
+    discard(paramsDir);
   }
   const payload = lastJsonObject2(stdout);
   if (payload === null) {
@@ -7645,6 +7701,7 @@ async function runOperation2(engine, operation, params, projectPath) {
 var run3;
 var init_headless = __esm(() => {
   init_game_log();
+  init_scratch();
   run3 = promisify3(execFile3);
 });
 
@@ -15448,7 +15505,10 @@ var init_tool_definitions = __esm(() => {
           requires: []
         },
         uid: { summary: "the UID of one file", requires: ["resourcePath"] },
-        refresh_uids: { summary: "resave every resource so UID references are current", requires: [] },
+        refresh_uids: {
+          summary: "import the project so every script and shader has its .uid sidecar, and name under uidsCreated the ones this made and under stillWithoutUid the ones the engine would not import: it writes no scene and no script, so a project whose sidecars are all present is left untouched",
+          requires: []
+        },
         refresh_classes: {
           summary: 'rewrite .godot/global_script_class_cache.cfg from the class_name declarations on disk, and name under unseenByEditor any class the editor open on this project still cannot resolve: rewriting the file does not reach the list a running editor loaded, so "added: []" means the file was already right rather than that nothing is wrong',
           requires: []
@@ -16196,7 +16256,7 @@ var init_tool_definitions = __esm(() => {
 });
 
 // src/headless-operations.ts
-var HEADLESS_OPERATIONS, EDITOR_READS;
+var HEADLESS_OPERATIONS, ENGINE_PASSES, EDITOR_READS;
 var init_headless_operations = __esm(() => {
   HEADLESS_OPERATIONS = dictionary({
     project_settings: dictionary({
@@ -16218,7 +16278,6 @@ var init_headless_operations = __esm(() => {
       set_options: "set_import_options",
       reimport: "reimport_resource",
       uid: "get_uid",
-      refresh_uids: "resave_resources",
       refresh_classes: "refresh_class_cache"
     }),
     project_export: dictionary({ list: "list_export_presets" }),
@@ -16230,6 +16289,9 @@ var init_headless_operations = __esm(() => {
       inheritance: "inspect_inheritance"
     })
   });
+  ENGINE_PASSES = dictionary({
+    project_import: dictionary({ refresh_uids: "import" })
+  });
   EDITOR_READS = dictionary({
     project_settings: dictionary({ get: "get_project_setting" })
   });
@@ -30946,7 +31008,7 @@ var init_stdio2 = __esm(() => {
 });
 
 // src/bridge-announce.ts
-import { mkdirSync as mkdirSync5, readFileSync as readFileSync9, rmSync as rmSync6, writeFileSync as writeFileSync7 } from "node:fs";
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync9, rmSync as rmSync5, writeFileSync as writeFileSync7 } from "node:fs";
 import { dirname as dirname6, join as join11 } from "node:path";
 function announcementPath(projectPath) {
   return join11(projectPath, ".godot", "gdharness-bridge.json");
@@ -30994,7 +31056,7 @@ function withdrawBridge(path) {
     return;
   }
   try {
-    rmSync6(path, { force: true });
+    rmSync5(path, { force: true });
   } catch (error) {
     console.error(`[SERVER] Could not withdraw the editor bridge announcement: ${errorMessage(error)}`);
   }
@@ -36022,6 +36084,33 @@ function projectStructure(projectPath) {
   visit(projectPath);
   return structure;
 }
+function scriptsWithoutUid(projectPath) {
+  const found = [];
+  const visit = (directory, prefix) => {
+    if (steppedOver(directory)) {
+      return;
+    }
+    for (const entry of readdirSync4(directory, { withFileTypes: true })) {
+      if (skipped(entry.name)) {
+        continue;
+      }
+      const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
+      if (entry.isDirectory()) {
+        visit(join13(directory, entry.name), spelled);
+        continue;
+      }
+      if (!entry.isFile()) {
+        continue;
+      }
+      const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
+      if (CARRIES_A_UID.has(extension) && !existsSync11(join13(directory, `${entry.name}.uid`))) {
+        found.push(spelled);
+      }
+    }
+  };
+  visit(projectPath, "");
+  return found.sort();
+}
 function searchProject(projectPath, options) {
   const extensions = new Set(options.fileTypes.map((ext) => ext.replace(/^\./, "").toLowerCase()).filter(Boolean));
   const result = {
@@ -36081,10 +36170,11 @@ function searchProject(projectPath, options) {
   visit(projectPath);
   return result;
 }
-var SKIPPED, ASSET_EXTENSIONS;
+var SKIPPED, ASSET_EXTENSIONS, CARRIES_A_UID;
 var init_project_scan = __esm(() => {
   SKIPPED = new Set(["node_modules"]);
   ASSET_EXTENSIONS = new Set(["png", "jpg", "jpeg", "webp", "svg", "ttf", "otf", "wav", "mp3", "ogg"]);
+  CARRIES_A_UID = new Set(["gd", "shader", "gdshader"]);
 });
 
 // src/runtime-client.ts
@@ -36330,7 +36420,7 @@ var init_runtime_client = __esm(() => {
 
 // src/run-record.ts
 import { execFileSync } from "node:child_process";
-import { mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync6, readFileSync as readFileSync13, rmSync as rmSync7, statSync as statSync3, writeFileSync as writeFileSync8 } from "node:fs";
+import { mkdirSync as mkdirSync6, openSync, readdirSync as readdirSync6, readFileSync as readFileSync13, rmSync as rmSync6, statSync as statSync3, writeFileSync as writeFileSync8 } from "node:fs";
 import { basename as basename2, join as join15 } from "node:path";
 function runsDirectory() {
   return join15(runtimeDirectory(), "runs");
@@ -36540,7 +36630,7 @@ function clearRunRecord(ours = () => true) {
       continue;
     }
     try {
-      rmSync7(path);
+      rmSync6(path);
     } catch {}
   }
 }
@@ -36569,7 +36659,7 @@ function sweepTranscripts(keepMs = 24 * 60 * 60 * 1000, now = Date.now()) {
       continue;
     }
     try {
-      rmSync7(path);
+      rmSync6(path);
     } catch {}
   }
 }
@@ -36578,7 +36668,7 @@ var init_run_record = __esm(() => {
 });
 
 // src/setup.ts
-import { cpSync as cpSync2, existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync14, rmSync as rmSync8, writeFileSync as writeFileSync9 } from "node:fs";
+import { cpSync as cpSync2, existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync14, rmSync as rmSync7, writeFileSync as writeFileSync9 } from "node:fs";
 import { dirname as dirname8, join as join16 } from "node:path";
 function installedAddonVersion(projectPath) {
   const marker = join16(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
@@ -36614,8 +36704,7 @@ import {
   openSync as openSync2,
   readdirSync as readdirSync7,
   readFileSync as readFileSync15,
-  readSync,
-  rmSync as rmSync9
+  readSync
 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
 import { basename as basename3, dirname as dirname9, join as join17, normalize as normalize3 } from "node:path";
@@ -37192,6 +37281,9 @@ class GodotServer {
     return { ok: true, op };
   }
   async dispatch(tool, op, args) {
+    if (ENGINE_PASSES[tool]?.[op] !== undefined) {
+      return await this.handleRefreshUids(args);
+    }
     const headless = HEADLESS_OPERATIONS[tool]?.[op];
     if (headless !== undefined) {
       const { from: asked, ...answerable } = args;
@@ -37562,6 +37654,33 @@ class GodotServer {
     const { op: _op, projectPath: _projectPath, ...params } = contained.value;
     return this.answer(await this.operation(operation, params, project.value.path));
   }
+  async handleRefreshUids(args) {
+    const project = this.project(args);
+    if (!project.ok) {
+      return project.response;
+    }
+    const engine = await this.engine();
+    if (!engine.ok) {
+      return this.createErrorResponse("No Godot executable found.");
+    }
+    const projectPath = project.value.path;
+    const before = scriptsWithoutUid(projectPath);
+    const imported = await runImport(engine.value, projectPath);
+    if (!imported.ok) {
+      return this.answer(imported);
+    }
+    const after = scriptsWithoutUid(projectPath);
+    const given = before.filter((script) => !after.includes(script));
+    return this.answer({
+      ok: true,
+      messages: imported.messages,
+      payload: {
+        uidsCreated: given,
+        stillWithoutUid: after,
+        note: after.length > 0 ? `${after.length} still have no .uid, which is the engine declining to import them rather than this op skipping them. No scene was written.` : "No scene was written: this reads the project and imports it, and does not resave anything."
+      }
+    });
+  }
   async operation(operation, params, projectPath) {
     const engine = await this.engine();
     if (!engine.ok) {
@@ -37692,7 +37811,7 @@ class GodotServer {
       log.append("stderr", failed.stderr);
       exitCode = typeof failed.code === "number" ? failed.code : -1;
     } finally {
-      rmSync9(exportLogs, { recursive: true, force: true });
+      discard(exportLogs);
     }
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
@@ -37790,8 +37909,7 @@ class GodotServer {
     } catch (error) {
       reportProblem = errorMessage(error);
     } finally {
-      rmSync9(reportsDir, { recursive: true, force: true });
-      rmSync9(userData, { recursive: true, force: true });
+      discard(reportsDir, userData);
     }
     const engineEntries = run.log.select({ severity: "warning", sinceLastCall: false, limit: 200 }).entries.map(aboveTheRunner);
     const verdicts = {
@@ -38870,9 +38988,7 @@ class GodotServer {
         ]
       };
     } finally {
-      if (screenshotDir) {
-        rmSync9(screenshotDir, { recursive: true, force: true });
-      }
+      discard(screenshotDir);
     }
   }
   async handleFindRuntimeNodes(args) {
@@ -38959,6 +39075,7 @@ var init_server3 = __esm(() => {
   init_resources();
   init_run_record();
   init_runtime_client();
+  init_scratch();
   init_server_version();
   init_setup();
   init_tool_definitions();
@@ -39911,8 +40028,9 @@ function taken(harness, path, held, stripped) {
 
 // src/headless.ts
 init_game_log();
+init_scratch();
 import { execFile as execFile2 } from "node:child_process";
-import { mkdtempSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { mkdtempSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { tmpdir } from "node:os";
 import { join as join4 } from "node:path";
 import { promisify as promisify2 } from "node:util";
@@ -39989,7 +40107,7 @@ async function runOperation(engine, operation, params, projectPath) {
       messages: []
     };
   } finally {
-    rmSync2(paramsDir, { recursive: true, force: true });
+    discard(paramsDir);
   }
   const payload = lastJsonObject(stdout);
   if (payload === null) {
@@ -40138,7 +40256,7 @@ init_headless();
 init_resources();
 init_server_version();
 import { spawnSync } from "node:child_process";
-import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync7, rmSync as rmSync4, writeFileSync as writeFileSync5 } from "node:fs";
+import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync7, rmSync as rmSync3, writeFileSync as writeFileSync5 } from "node:fs";
 import { dirname as dirname3, join as join8 } from "node:path";
 import { fileURLToPath } from "node:url";
 var ADDONS = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
@@ -40163,7 +40281,7 @@ function installAddons(projectPath, from = shippedAddonsDirectory()) {
     }
     const target = join8(projectPath, "addons", name);
     const replaced = existsSync7(target);
-    rmSync4(target, { recursive: true, force: true });
+    rmSync3(target, { recursive: true, force: true });
     mkdirSync3(dirname3(target), { recursive: true });
     cpSync(source, target, { recursive: true });
     writeFileSync5(join8(target, VERSION_MARKER), `${SERVER_VERSION}
@@ -40177,7 +40295,7 @@ function removeAddons(projectPath) {
   for (const name of ADDONS) {
     const target = join8(projectPath, "addons", name);
     if (existsSync7(target)) {
-      rmSync4(target, { recursive: true, force: true });
+      rmSync3(target, { recursive: true, force: true });
       removed.push(target);
     }
   }
@@ -40306,7 +40424,7 @@ function inspectProject(projectPath) {
 
 // src/skill.ts
 init_tool_definitions();
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, readdirSync as readdirSync3, rmSync as rmSync5, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, readdirSync as readdirSync3, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
 import { basename, dirname as dirname4, join as join9 } from "node:path";
 
 // src/tool-reference.ts
@@ -40322,7 +40440,13 @@ function namedType(declared) {
   return "any";
 }
 function headlessSection() {
-  const byTool = Object.entries(HEADLESS_OPERATIONS).map(([tool, ops]) => `\`${tool}\` (${Object.keys(ops).join(", ")})`).sort();
+  const everyOp = new Map;
+  for (const table of [HEADLESS_OPERATIONS, ENGINE_PASSES]) {
+    for (const [tool, ops] of Object.entries(table)) {
+      everyOp.set(tool, [...everyOp.get(tool) ?? [], ...Object.keys(ops)]);
+    }
+  }
+  const byTool = [...everyOp].map(([tool, ops]) => `\`${tool}\` (${ops.join(", ")})`).sort();
   return [
     "## What a gate can call",
     "",
@@ -40551,7 +40675,7 @@ function removeSkill(directories, projectPath) {
   const removed = [];
   for (const directory of directories) {
     if (existsSync8(directory)) {
-      rmSync5(directory, { recursive: true, force: true });
+      rmSync4(directory, { recursive: true, force: true });
       pruneEmpty(dirname4(directory), projectPath);
       removed.push(directory);
     }
@@ -40565,7 +40689,7 @@ function pruneEmpty(directory, projectPath) {
     if (readdirSync3(path).length > 0) {
       return;
     }
-    rmSync5(path, { recursive: true, force: true });
+    rmSync4(path, { recursive: true, force: true });
     path = dirname4(path);
   }
 }
@@ -40573,7 +40697,7 @@ function writeSkill(directories, version) {
   const files = skillFiles(version);
   return directories.map((directory) => {
     const replaced = existsSync8(directory);
-    rmSync5(directory, { recursive: true, force: true });
+    rmSync4(directory, { recursive: true, force: true });
     for (const [name, contents] of files) {
       const path = join9(directory, name);
       mkdirSync4(dirname4(path), { recursive: true });

package/build/godot/operations/godot_operations.gd

@@ -108,8 +108,6 @@ func _run(operation: String, params: Dictionary) -> Dictionary:
 		# Resource files
 		"get_uid":
 			payload = ResourceFiles.new(_log).get_uid(params)
-		"resave_resources":
-			payload = ResourceFiles.new(_log).resave_resources(params)
 		"refresh_class_cache":
 			payload = ClassCache.new(_log).refresh_class_cache(params)
 

package/build/godot/operations/resource_files.gd

@@ -1,10 +1,8 @@
 extends RefCounted
 
-const FileWalk = preload("file_walk.gd")
 const Log = preload("logger.gd")
 
 var _log: Log
-var _files: FileWalk = FileWalk.new()
 
 
 func _init(p_log: Log) -> void:
@@ -41,92 +39,3 @@ func get_uid(params: Dictionary) -> Dictionary:
 	return {
 		"file": file_path, "absolute_path": absolute_path, "uid": uid_content.strip_edges(), "exists": true
 	}
-
-
-# Resave every scene, script and shader so that UID references are current.
-func resave_resources(_params: Dictionary) -> Dictionary:
-	_log.info("Resaving all resources to update UID references...")
-	var project_path: String = "res://"
-
-	var scenes: Array[String] = _files.find_files(project_path, ".tscn")
-	_log.debug("Found " + str(scenes.size()) + " scenes")
-
-	# Resave each scene
-	var success_count: int = 0
-	var error_count: int = 0
-
-	for scene_path: String in scenes:
-		_log.debug("Processing scene: " + scene_path)
-
-		if not FileAccess.file_exists(scene_path):
-			_log.error("Scene file does not exist at: " + scene_path)
-			error_count += 1
-			continue
-
-		var scene: Resource = load(scene_path)
-		if not scene:
-			error_count += 1
-			_log.error("Failed to load: " + scene_path)
-			continue
-
-		var error: Error = ResourceSaver.save(scene, scene_path)
-		if error != OK:
-			error_count += 1
-			_log.error("Failed to save: " + scene_path + ", error: " + str(error))
-			continue
-
-		success_count += 1
-		if _log.debug_mode:
-			_log.debug("Scene saved successfully: " + scene_path)
-			var file_check_after: bool = FileAccess.file_exists(scene_path)
-			_log.debug("File exists check after save: " + str(file_check_after))
-			if not file_check_after:
-				_log.error("File reported as saved but does not exist at: " + scene_path)
-
-	# A UID sits beside every script and shader as a .uid file. Outside the editor the save
-	# below answers OK and writes no sidecar, so what comes back is what was resaved and how
-	# many are still without one, rather than a count of UIDs this made.
-	var scripts: Array[String] = (
-		_files.find_files(project_path, ".gd")
-		+ _files.find_files(project_path, ".shader")
-		+ _files.find_files(project_path, ".gdshader")
-	)
-	_log.debug("Found " + str(scripts.size()) + " scripts/shaders")
-
-	var missing_uids: int = 0
-	var resaved_scripts: int = 0
-
-	for script_path: String in scripts:
-		_log.debug("Checking UID for: " + script_path)
-		var uid_path: String = script_path + ".uid"
-
-		var f: FileAccess = FileAccess.open(uid_path, FileAccess.READ)
-		if f:
-			_log.debug("UID file already exists for: " + script_path)
-			continue
-
-		missing_uids += 1
-		_log.debug("Missing UID file for: " + script_path + ", resaving...")
-
-		var res: Resource = load(script_path)
-		if not res:
-			_log.error("Failed to load resource: " + script_path)
-			continue
-
-		var error: Error = ResourceSaver.save(res, script_path)
-		if error != OK:
-			_log.error("Failed to resave: " + script_path + ", error: " + str(error))
-			continue
-
-		resaved_scripts += 1
-		_log.debug("Resaved: " + script_path)
-
-	_log.info("Resave operation complete")
-
-	return {
-		"scenes_processed": scenes.size(),
-		"scenes_saved": success_count,
-		"scenes_with_errors": error_count,
-		"scripts_missing_uids": missing_uids,
-		"scripts_resaved": resaved_scripts
-	}

package/build/index.js

@@ -10151,8 +10151,7 @@ import {
   openSync as openSync2,
   readdirSync as readdirSync6,
   readFileSync as readFileSync11,
-  readSync,
-  rmSync as rmSync5
+  readSync
 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 import { basename as basename2, dirname as dirname4, join as join11, normalize as normalize2 } from "node:path";
@@ -26324,10 +26323,35 @@ class GodotLocator {
 
 // src/headless.ts
 import { execFile as execFile2 } from "node:child_process";
-import { mkdtempSync, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "node:fs";
+import { mkdtempSync, writeFileSync as writeFileSync3 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { join as join6 } from "node:path";
 import { promisify as promisify2 } from "node:util";
+
+// src/scratch.ts
+import { rmSync as rmSync2 } from "node:fs";
+var SWEPT = { recursive: true, force: true, maxRetries: 20, retryDelay: 250 };
+function discardWith(remove, paths) {
+  const left = [];
+  for (const path of paths) {
+    if (!path) {
+      continue;
+    }
+    try {
+      remove(path);
+    } catch (error) {
+      left.push({ path, reason: error instanceof Error ? error.message : String(error) });
+    }
+  }
+  return left;
+}
+function discard(...paths) {
+  return discardWith((path) => {
+    rmSync2(path, SWEPT);
+  }, paths);
+}
+
+// src/headless.ts
 var run2 = promisify2(execFile2);
 function snakeCased(params) {
   const result = emptyRecord();
@@ -26366,6 +26390,36 @@ function reason(stdout, stderr) {
   }
   return stdout.trim().split(/\r?\n/).at(-1) ?? "no output at all";
 }
+async function runImport(godotPath, projectPath) {
+  const logDir = mkdtempSync(join6(tmpdir2(), "gdharness-import-"));
+  try {
+    const { stderr } = await run2(godotPath, [
+      "--headless",
+      "--log-file",
+      join6(logDir, "engine.log"),
+      "--path",
+      projectPath,
+      "--import"
+    ]);
+    return { ok: true, messages: problems(stderr) };
+  } catch (error) {
+    if (error instanceof Error && "stdout" in error && "stderr" in error) {
+      const failed = error;
+      return {
+        ok: false,
+        message: `the import pass failed (exit ${failed.code ?? "unknown"}): ${reason(failed.stdout, failed.stderr)}`,
+        messages: problems(failed.stderr)
+      };
+    }
+    return {
+      ok: false,
+      message: `the import pass could not be run: ${error instanceof Error ? error.message : String(error)}`,
+      messages: []
+    };
+  } finally {
+    discard(logDir);
+  }
+}
 async function runOperation(engine, operation, params, projectPath) {
   const paramsDir = mkdtempSync(join6(tmpdir2(), "gdharness-params-"));
   const paramsFile = join6(paramsDir, `${operation}.json`);
@@ -26401,7 +26455,7 @@ async function runOperation(engine, operation, params, projectPath) {
       messages: []
     };
   } finally {
-    rmSync2(paramsDir, { recursive: true, force: true });
+    discard(paramsDir);
   }
   const payload = lastJsonObject(stdout);
   if (payload === null) {
@@ -26435,7 +26489,6 @@ var HEADLESS_OPERATIONS = dictionary({
     set_options: "set_import_options",
     reimport: "reimport_resource",
     uid: "get_uid",
-    refresh_uids: "resave_resources",
     refresh_classes: "refresh_class_cache"
   }),
   project_export: dictionary({ list: "list_export_presets" }),
@@ -26447,6 +26500,9 @@ var HEADLESS_OPERATIONS = dictionary({
     inheritance: "inspect_inheritance"
   })
 });
+var ENGINE_PASSES = dictionary({
+  project_import: dictionary({ refresh_uids: "import" })
+});
 var EDITOR_READS = dictionary({
   project_settings: dictionary({ get: "get_project_setting" })
 });
@@ -27384,6 +27440,34 @@ function projectStructure(projectPath) {
   visit(projectPath);
   return structure;
 }
+var CARRIES_A_UID = new Set(["gd", "shader", "gdshader"]);
+function scriptsWithoutUid(projectPath) {
+  const found = [];
+  const visit = (directory, prefix) => {
+    if (steppedOver(directory)) {
+      return;
+    }
+    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+      if (skipped(entry.name)) {
+        continue;
+      }
+      const spelled = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
+      if (entry.isDirectory()) {
+        visit(join7(directory, entry.name), spelled);
+        continue;
+      }
+      if (!entry.isFile()) {
+        continue;
+      }
+      const extension = entry.name.split(".").pop()?.toLowerCase() ?? "";
+      if (CARRIES_A_UID.has(extension) && !existsSync6(join7(directory, `${entry.name}.uid`))) {
+        found.push(spelled);
+      }
+    }
+  };
+  visit(projectPath, "");
+  return found.sort();
+}
 function searchProject(projectPath, options) {
   const extensions = new Set(options.fileTypes.map((ext) => ext.replace(/^\./, "").toLowerCase()).filter(Boolean));
   const result = {
@@ -28538,7 +28622,10 @@ var TOOL_SPECS = [
         requires: []
       },
       uid: { summary: "the UID of one file", requires: ["resourcePath"] },
-      refresh_uids: { summary: "resave every resource so UID references are current", requires: [] },
+      refresh_uids: {
+        summary: "import the project so every script and shader has its .uid sidecar, and name under uidsCreated the ones this made and under stillWithoutUid the ones the engine would not import: it writes no scene and no script, so a project whose sidecars are all present is left untouched",
+        requires: []
+      },
       refresh_classes: {
         summary: 'rewrite .godot/global_script_class_cache.cfg from the class_name declarations on disk, and name under unseenByEditor any class the editor open on this project still cannot resolve: rewriting the file does not reach the list a running editor loaded, so "added: []" means the file was already right rather than that nothing is wrong',
         requires: []
@@ -29946,6 +30033,9 @@ class GodotServer {
     return { ok: true, op };
   }
   async dispatch(tool, op, args) {
+    if (ENGINE_PASSES[tool]?.[op] !== undefined) {
+      return await this.handleRefreshUids(args);
+    }
     const headless = HEADLESS_OPERATIONS[tool]?.[op];
     if (headless !== undefined) {
       const { from: asked, ...answerable } = args;
@@ -30316,6 +30406,33 @@ class GodotServer {
     const { op: _op, projectPath: _projectPath, ...params } = contained.value;
     return this.answer(await this.operation(operation, params, project.value.path));
   }
+  async handleRefreshUids(args) {
+    const project = this.project(args);
+    if (!project.ok) {
+      return project.response;
+    }
+    const engine = await this.engine();
+    if (!engine.ok) {
+      return this.createErrorResponse("No Godot executable found.");
+    }
+    const projectPath = project.value.path;
+    const before = scriptsWithoutUid(projectPath);
+    const imported = await runImport(engine.value, projectPath);
+    if (!imported.ok) {
+      return this.answer(imported);
+    }
+    const after = scriptsWithoutUid(projectPath);
+    const given = before.filter((script) => !after.includes(script));
+    return this.answer({
+      ok: true,
+      messages: imported.messages,
+      payload: {
+        uidsCreated: given,
+        stillWithoutUid: after,
+        note: after.length > 0 ? `${after.length} still have no .uid, which is the engine declining to import them rather than this op skipping them. No scene was written.` : "No scene was written: this reads the project and imports it, and does not resave anything."
+      }
+    });
+  }
   async operation(operation, params, projectPath) {
     const engine = await this.engine();
     if (!engine.ok) {
@@ -30446,7 +30563,7 @@ class GodotServer {
       log.append("stderr", failed.stderr);
       exitCode = typeof failed.code === "number" ? failed.code : -1;
     } finally {
-      rmSync5(exportLogs, { recursive: true, force: true });
+      discard(exportLogs);
     }
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
@@ -30544,8 +30661,7 @@ class GodotServer {
     } catch (error) {
       reportProblem = errorMessage(error);
     } finally {
-      rmSync5(reportsDir, { recursive: true, force: true });
-      rmSync5(userData, { recursive: true, force: true });
+      discard(reportsDir, userData);
     }
     const engineEntries = run.log.select({ severity: "warning", sinceLastCall: false, limit: 200 }).entries.map(aboveTheRunner);
     const verdicts = {
@@ -31624,9 +31740,7 @@ class GodotServer {
         ]
       };
     } finally {
-      if (screenshotDir) {
-        rmSync5(screenshotDir, { recursive: true, force: true });
-      }
+      discard(screenshotDir);
     }
   }
   async handleFindRuntimeNodes(args) {

package/package.json

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