gdharness 1.2.9 → 1.2.10

package/build/cli.js

@@ -9358,8 +9358,31 @@ function callSitesOf(source, name, otherClasses = new Set, property = false) {
     const declared = bodyHolding(shape.body, at).declarations.find((one) => one.name === member && (one.kind === "var" || one.kind === "const"));
     return declared === undefined ? null : declaredClass(codeLines[lines.positionOf(declared.offset).line] ?? "", member);
   };
+  const blockUnder = (declared) => {
+    const indent = (codeLines[declared] ?? "").search(/\S|$/);
+    let last = declared;
+    for (let index = declared + 1;index < codeLines.length; index += 1) {
+      const text = codeLines[index] ?? "";
+      if (text.trim() === "") {
+        continue;
+      }
+      if (text.search(/\S/) <= indent) {
+        break;
+      }
+      last = index;
+    }
+    return [declared, last];
+  };
+  const accessorsIn = (body) => [
+    ...body.declarations.filter((one) => one.kind === "var" && one.name === name).map((one) => blockUnder(lines.positionOf(one.offset).line)),
+    ...body.inner.flatMap(accessorsIn)
+  ];
+  const accessors = property ? accessorsIn(shape.body) : [];
   return occurrencesOf(source, name, regions).filter((one) => one.kind === "code" && one.declaredAs === null).filter((one) => {
     const index = lines.positionOf(one.offset).line;
+    if (!one.afterDot && accessors.some(([declared, last]) => index > declared && index <= last)) {
+      return false;
+    }
     if (one.afterDot) {
       const receiver = receiverBefore(code, one.offset);
       if (receiver === null || otherClasses.size === 0) {
@@ -9381,7 +9404,8 @@ function callSitesOf(source, name, otherClasses = new Set, property = false) {
   }).map((one) => {
     const line = lines.positionOf(one.offset).line + 1;
     const after = code.slice(one.offset + name.length).trimStart();
-    return { line, within: enclosingFunction(source, line, code), called: after.startsWith("(") };
+    const within = enclosingFunction(source, line, code);
+    return property ? { line, within, access: ASSIGNED.test(after) ? "write" : "read" } : { line, within, called: after.startsWith("(") };
   });
 }
 function collectEnumValues(text, from, into) {
@@ -9399,7 +9423,7 @@ function collectEnumValues(text, from, into) {
 function isIdentifier(name) {
   return new RegExp(`^${NAME}$`, "u").test(name) && !KEYWORDS.has(name);
 }
-var IDENTIFIER_START, IDENTIFIER_PART, DECLARING, NAME = "[\\p{L}_][\\p{L}\\p{N}_]*", ANNOTATIONS = "(?:@[\\p{L}_][\\p{L}\\p{N}_]*(?:\\([^)]*\\))?\\s+)*", DECLARATION_LINE, CLASS_NAME_LINE, EXTENDS_LINE, EXTENDS_CLAUSE, FUNC_LINE, SUPER_CALL, LAMBDA_HEADER, DOTTED, MEMBER_KINDS, KEYWORDS;
+var IDENTIFIER_START, IDENTIFIER_PART, DECLARING, NAME = "[\\p{L}_][\\p{L}\\p{N}_]*", ANNOTATIONS = "(?:@[\\p{L}_][\\p{L}\\p{N}_]*(?:\\([^)]*\\))?\\s+)*", DECLARATION_LINE, CLASS_NAME_LINE, EXTENDS_LINE, EXTENDS_CLAUSE, FUNC_LINE, SUPER_CALL, LAMBDA_HEADER, ASSIGNED, DOTTED, MEMBER_KINDS, KEYWORDS;
 var init_gdscript_source = __esm(() => {
   IDENTIFIER_START = /[\p{L}_]/u;
   IDENTIFIER_PART = /[\p{L}\p{N}_]/u;
@@ -9411,6 +9435,7 @@ var init_gdscript_source = __esm(() => {
   FUNC_LINE = new RegExp(`^[ \\t]*${ANNOTATIONS}(?:static\\s+)?func\\s+(${NAME})\\s*\\(`, "u");
   SUPER_CALL = /(?<![\p{L}\p{N}_.])super\s*[.(]/u;
   LAMBDA_HEADER = new RegExp(`(?<![\\p{L}\\p{N}_])func(?:\\s+${NAME})?\\s*\\(`, "u");
+  ASSIGNED = /^(?:\*\*|<<|>>|[-+*/%&|^])?=(?!=)/;
   DOTTED = `${NAME}(?:\\.${NAME})*`;
   MEMBER_KINDS = new Set(["var", "const", "signal", "enum", "enumValue"]);
   KEYWORDS = new Set([
@@ -18355,7 +18380,7 @@ var init_tool_definitions = __esm(() => {
           type: "integer",
           minimum: 0,
           ops: ["start"],
-          description: "start: how long to wait for the game to announce its runtime before answering. Default 5000, or half as long again as the last boot of this project took when that is more, up to 60000: the server notes how long each game took to announce, so a project that boots slowly is waited for from its second start on without being asked to. What it waits for is the first frame, so everything the game does before drawing one is inside it, including work the args just asked for: a flag that simulates six years of game time before anything is drawn makes the announcement that late, on a project that announces promptly without it. Raise it for such a run rather than reading runtime listening false as a fault. 0 does not wait at all, which is the one to pass for a scene that announces nothing by construction, such as a bench that prints and quits."
+          description: "start: how long to wait for the game to announce its runtime before answering. Default 5000, or half as long again as the slowest of the last five boots of the same scene when that is more, up to 60000: the server notes how long each game took to announce, per scene and for the main scene when none is named, since a boot moves with the load on the machine, so a scene that boots slowly is waited for from its second start on without being asked to, and a harness scene that announces late sets nothing for the main scene. What it waits for is the first frame, so everything the game does before drawing one is inside it, including work the args just asked for: a flag that simulates six years of game time before anything is drawn makes the announcement that late, on a project that announces promptly without it. Raise it for such a run rather than reading runtime listening false as a fault. 0 does not wait at all, which is the one to pass for a scene that announces nothing by construction, such as a bench that prints and quits."
         },
         frames: {
           type: "integer",
@@ -18377,7 +18402,7 @@ var init_tool_definitions = __esm(() => {
         callersOf: {
           type: "string",
           ops: ["profile"],
-          description: "profile: also answer, under callers, where the project's scripts name this function in code: its name, or Class.name for the functions of one class. Each place has its script, line, the named function it is written in (within), whether the function is called there or passed on as a Callable (called), and the profile's calls, self and total milliseconds for the function it is in, those taking the most time first, forty at most. Found by name in the source, since the engine's profiler records nothing about who made a call, so a method of the same name on another class is listed too, except, when Class.name was asked, one called through another class of the project by name or through a parameter, local or class variable declared as one, and a call made through a string is not. A parameter, local or class variable of the same name is not the function and is not listed. A property's get or set block, which the profile names Class.@name_getter or Class.@name_setter, is asked about by that name or by the property's: the places are where the property is named, and the rows are both blocks'."
+          description: "profile: also answer, under callers, where the project's scripts name this function in code: its name, or Class.name for the functions of one class. Each place has its script, line, the named function it is written in (within), whether the function is called there or passed on as a Callable (called), and the profile's calls, self and total milliseconds for the function it is in, those taking the most time first, forty at most. Found by name in the source, since the engine's profiler records nothing about who made a call, so a method of the same name on another class is listed too, except, when Class.name was asked, one called through another class of the project by name or through a parameter, local or class variable declared as one, and a call made through a string is not. A parameter, local or class variable of the same name is not the function and is not listed. A property's get or set block, which the profile names Class.@name_getter or Class.@name_setter, is asked about by that name or by the property's: the places are where the property is named, each saying instead of called whether it writes the property (access write), which runs the set block, or reads it (access read), which runs the get block, and the rows are both blocks'. 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 places."
         },
         limit: {
           type: "integer",
@@ -34419,19 +34444,33 @@ import { dirname as dirname9, join as join14 } from "node:path";
 function bootNotePath(projectPath) {
   return join14(projectPath, ".godot", "gdharness-boot.json");
 }
-function readBootNote(projectPath) {
+function readScenes(projectPath) {
   try {
-    const noted = readNumber(asParams(JSON.parse(readFileSync12(bootNotePath(projectPath), "utf8"))), "announcedAfterMs");
-    return noted !== undefined && Number.isFinite(noted) && noted > 0 ? noted : null;
+    return asParams(asParams(JSON.parse(readFileSync12(bootNotePath(projectPath), "utf8")))["scenes"]);
   } catch {
-    return null;
+    return {};
   }
 }
-function writeBootNote(projectPath, announcedAfterMs) {
+function bootsOf(projectPath, scene) {
+  const kept = asParams(readScenes(projectPath)[scene])["boots"];
+  return Array.isArray(kept) ? kept.filter((one) => typeof one === "number" && Number.isFinite(one) && one > 0) : [];
+}
+function readBootNote(projectPath, scene) {
+  const boots = bootsOf(projectPath, scene);
+  return boots.length === 0 ? null : Math.max(...boots);
+}
+function writeBootNote(projectPath, scene, announcedAfterMs) {
   try {
     const path = bootNotePath(projectPath);
     mkdirSync6(dirname9(path), { recursive: true });
-    writeFileSync8(path, JSON.stringify({ announcedAfterMs: Math.round(announcedAfterMs), at: new Date().toISOString() }, null, 2), "utf8");
+    const scenes = {
+      ...readScenes(projectPath),
+      [scene]: {
+        boots: [...bootsOf(projectPath, scene), Math.round(announcedAfterMs)].slice(-BOOTS_KEPT),
+        at: new Date().toISOString()
+      }
+    };
+    writeFileSync8(path, JSON.stringify({ scenes }, null, 2), "utf8");
   } catch {}
 }
 function halfAsLongAgain(lastBootMs) {
@@ -34443,7 +34482,7 @@ function waitSizedTo(lastBootMs, usual = ANNOUNCE_BUDGET_MS) {
   }
   return Math.min(LONGEST_SIZED_WAIT_MS, Math.max(usual, halfAsLongAgain(lastBootMs)));
 }
-var LONGEST_SIZED_WAIT_MS = 60000;
+var MAIN_SCENE = "", BOOTS_KEPT = 5, LONGEST_SIZED_WAIT_MS = 60000;
 var init_boot_note = __esm(() => {
   init_runtime_client();
 });
@@ -42695,7 +42734,8 @@ function classNamesOf(source) {
 function callersOf(totals, name, scripts) {
   const listed = [...scripts];
   const sources = new Map(listed);
-  const rows = rowsOf(totals, (script) => sources.get(script) ?? null);
+  const perCallUs = perCallCostOf(totals);
+  const rows = rowsOf(totals, (script) => sources.get(script) ?? null).map((row) => withOverhead(row, perCallUs));
   const asked = name.includes(".") ? name.slice(0, name.lastIndexOf(".")) : null;
   const bare = propertyOf(name) ?? bareName(name);
   const ownerOf = (fn) => fn.includes(".") ? fn.slice(0, fn.lastIndexOf(".")) : null;
@@ -42728,7 +42768,12 @@ function callersOf(totals, name, scripts) {
     }
   }
   sites.sort((a, b) => (b.withinTotalMs ?? -1) - (a.withinTotalMs ?? -1) || a.script.localeCompare(b.script) || a.line - b.line);
-  return { target, sites: sites.slice(0, CALL_SITES), omitted: Math.max(0, sites.length - CALL_SITES) };
+  return {
+    target,
+    sites: sites.slice(0, CALL_SITES),
+    omitted: Math.max(0, sites.length - CALL_SITES),
+    property
+  };
 }
 var QUEUE_SETTING = "limits/debugger/max_queued_messages", QUEUE_DEFAULT = 2048, QUEUE_HEADROOM = 512, UNNAMED_PREFIX = "#", PROFILE_FROM_START = "GDHARNESS_PROFILE_FROM_START", ms = (seconds) => Math.round(seconds * 1e6) / 1000, RUNTIME_SCRIPT = "gdharness_runtime/runtime_autoload.gd", PROFILER_PROBE = "_profiler_probe", PROFILER_CALIBRATOR = "_calibrate_the_profiler", CALL_SITES = 40;
 var init_script_profile = __esm(() => {
@@ -43108,7 +43153,7 @@ 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 its last game took ${after.sizedToMs}ms to announce,` : `, half as long again as the ${after.sizedToMs}ms its last game took,`;
+  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,`;
   return {
     listening: false,
     mayYetAnnounce: after.running,
@@ -43583,10 +43628,12 @@ function overheadRowsReturned(table, one) {
   if (shown === table.overheadDominated) {
     return one ? " Its row carries that share as overheadMs." : " Their rows carry that share as overheadMs.";
   }
+  const theReturned = returned === 1 ? "the one row returned" : `the ${returned} rows returned`;
   if (shown === 0) {
-    return one ? ` Its row, which carries that share as overheadMs, is not among the ${returned} returned; limit ${table.overheadReach} returns it.` : ` Their rows, which carry that share as overheadMs, are none of the ${returned} returned; limit ${table.overheadReach} returns them all.`;
+    return one ? ` Its row, which carries that share as overheadMs, comes after ${theReturned}; limit ${table.overheadReach} returns it.` : ` Their rows, which carry that share as overheadMs, come after ${theReturned}; limit ${table.overheadReach} returns them all.`;
   }
-  return ` Their rows carry that share as overheadMs, and ${shown} of them ${shown === 1 ? "is" : "are"} among the ${returned} returned; limit ${table.overheadReach} returns them all.`;
+  const among = returned === 1 ? "the one row returned is one of them" : `${shown} of them ${shown === 1 ? "is" : "are"} among ${theReturned}`;
+  return ` Their rows carry that share as overheadMs, and ${among}; limit ${table.overheadReach} returns them all.`;
 }
 function namedFew(names) {
   const shown = names.slice(0, 5);
@@ -43632,12 +43679,13 @@ function uncountedCallee(totals, name) {
 }
 function callersAnswer(totals, asked) {
   const found = callersOf(totals, asked.name, asked.scripts());
+  const byName = found.target.length === 0 ? `${CALLERS_FOUND_BY_NAME} ${uncountedCallee(totals, asked.name)}` : CALLERS_FOUND_BY_NAME;
   return {
     of: asked.name,
     rows: found.target,
     sites: found.sites,
     omitted: found.omitted > 0 ? found.omitted : undefined,
-    note: found.sites.length === 0 ? `No script in the project names ${asked.name} in code, outside its declaration: a call made through a string, such as call("name"), is not found by name.` : found.target.length === 0 ? `${CALLERS_FOUND_BY_NAME} ${uncountedCallee(totals, asked.name)}` : CALLERS_FOUND_BY_NAME
+    note: found.sites.length === 0 ? `No script in the project names ${asked.name} in code, outside its declaration: a call made through a string, such as call("name"), is not found by name.` : found.property ? `${byName} ${PROPERTY_PLACES}` : byName
   };
 }
 function foldedEntriesAnswer(log) {
@@ -46448,7 +46496,7 @@ class GodotServer {
       platform: process.platform,
       variables: process.env
     });
-    const runtimeWaitMs = this.announceBudget(args, project.value.path);
+    const runtimeWaitMs = this.announceBudget(args, project.value.path, sceneArgument);
     const editorWouldPlay = !headless || editorPlaysHeadless(project.value.file);
     const silent = resolveSilent(args["silent"], process.env) && !headless;
     const profiled = readBoolean(args, "profile") === true;
@@ -46470,6 +46518,7 @@ class GodotServer {
       ]);
     }
     started.announcedBefore = alreadyPlaying;
+    started.bootScene = runtimeWaitMs.scene;
     this.activeProcess = started;
     const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
     const endedForThis = endedToStartThis(ended);
@@ -46559,17 +46608,18 @@ class GodotServer {
       ...going?.throughEditor === true ? { playingSeen: going.seenPlaying === true } : {}
     });
   }
-  announceBudget(args, projectPath) {
+  announceBudget(args, projectPath, scene) {
+    const key = scene ?? MAIN_SCENE;
     const asked = readNonNegativeNumber(args, "runtimeWaitMs");
     if (asked !== undefined) {
-      return { ms: asked };
+      return { ms: asked, scene: key };
     }
-    const lastBoot = readBootNote(projectPath);
+    const lastBoot = readBootNote(projectPath, key);
     const ms = waitSizedTo(lastBoot);
-    return lastBoot !== null && ms > ANNOUNCE_BUDGET_MS ? { ms, sizedToMs: lastBoot } : { ms };
+    return lastBoot !== null && ms > ANNOUNCE_BUDGET_MS ? { ms, sizedToMs: lastBoot, scene: key } : { ms, scene: key };
   }
   noteBootOf(run, endpoint) {
-    if (run.projectPath === null) {
+    if (run.projectPath === null || run.bootScene === undefined) {
       return;
     }
     let announcedAt;
@@ -46581,7 +46631,7 @@ class GodotServer {
     const took = announcedAt - run.startedAt;
     this.logDebug(`boot of pid ${endpoint.pid} announced ${Math.round(took)}ms after the start of ${run.projectPath}`);
     if (took > 0 && took <= LONGEST_BOOT_NOTED_MS) {
-      writeBootNote(run.projectPath, took);
+      writeBootNote(run.projectPath, run.bootScene, took);
     }
   }
   async playThroughEditor(scene, refreshedClasses, scanned, projectPath, alreadyPlaying, runtimeWaitMs, ended, profiled) {
@@ -46640,7 +46690,8 @@ class GodotServer {
       brokeOn: null,
       announcedBefore: alreadyPlaying,
       seenPlaying: readBoolean(playAnswer, "playing") === true,
-      ...which === null ? {} : { play: which }
+      ...which === null ? {} : { play: which },
+      bootScene: runtimeWaitMs.scene
     };
     this.activeProcess = played;
     this.noteTheLatestRun({ projectPath, pid: null, startedAt });
@@ -46810,6 +46861,7 @@ class GodotServer {
     }
     running.endedHere = reason;
     const announced = this.announcedPidOf(running);
+    await this.sendTheProfileFirst(running, announced);
     if (running.throughEditor) {
       const asked = await this.handleViaBridge("stop_playing", {});
       if (asked.isError === true) {
@@ -46880,6 +46932,25 @@ class GodotServer {
     running.log.record(gone ? "info" : "warning", declined !== null ? `gdharness could not signal pid ${running.pid}: the operating system refused it (${declined}). It had described that process as ${described}.` : !gone ? `gdharness signalled pid ${running.pid}, which the operating system described as ${described}, and it was still running ${stopWaitMs() / 1000} seconds later.` : landed ? `gdharness ended pid ${running.pid}, which the operating system described as ${described}.` : `gdharness signalled pid ${running.pid} and it was already gone; the operating system had described it as ${described}.`);
     return gone ? "gone" : "lingering";
   }
+  async sendTheProfileFirst(run, announced) {
+    if (announced === undefined) {
+      return;
+    }
+    const profiled = run.throughEditor ? await this.theEditorIsProfiling() : run.profile !== undefined;
+    const endpoint = profiled ? runtimesAnnounced().running.find((one) => one.pid === announced) : undefined;
+    if (endpoint === undefined) {
+      return;
+    }
+    await runtimeRequest(endpoint, "send_profile", {}, PROFILE_SEND_MS);
+  }
+  async theEditorIsProfiling() {
+    const read = await this.handleViaBridge("profile_read", {});
+    if (read.isError === true) {
+      return false;
+    }
+    const held = asParams(JSON.parse(read.content[0]?.text ?? "{}"));
+    return readBoolean(held, "profiled") === true && readBoolean(held, "complete") !== true;
+  }
   async endThroughTheKeeper(run, pid, keeper) {
     const asked = await askTheKeeperToStop(keeper, KEEPER_ANSWER_MS);
     if (typeof asked !== "string") {
@@ -48555,7 +48626,7 @@ class GodotServer {
       return null;
     }
     const which = run.throughEditor ? "the game the editor is playing for it" : `pid ${run.pid ?? "unknown"}`;
-    const comingUpUntil = run.startedAt + waitSizedTo(readBootNote(project)) + budgetMs;
+    const comingUpUntil = run.startedAt + waitSizedTo(readBootNote(project, run.bootScene ?? MAIN_SCENE)) + budgetMs;
     const remaining = comingUpUntil - Date.now();
     if (remaining <= 0) {
       const seconds = Math.round((Date.now() - run.startedAt) / 1000);
@@ -48773,7 +48844,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, 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, 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, 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 "';
+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, 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 "';
 var init_server3 = __esm(() => {
   init_mcp();
   init_stdio2();

package/build/godot/addons/gdharness_runtime/runtime_autoload.gd

@@ -140,6 +140,7 @@ func _init() -> void:
 		"wait_frames": _waits.wait_frames,
 		"wait_signal": _waits.wait_signal,
 		"wait_until": _waits.wait_until,
+		"send_profile": _send_profile_now,
 	}
 	_wait_for_the_profiler()
 
@@ -236,6 +237,16 @@ func _send_the_profile() -> void:
 		)
 
 
+## The totals sent now, for a stop that is about to end the game without letting it quit: ended by
+## its process, a game takes the totals with it, and every stopped profile came back as the frames
+## summed. Nothing of the game's own runs, which quitting the tree would have done.
+func _send_profile_now(_params: Dictionary) -> Dictionary:
+	if not (EngineDebugger.is_active() and EngineDebugger.is_profiling("servers")):
+		return {"sent": false}
+	_send_the_profile()
+	return {"sent": true, "confirmed": _profile_received}
+
+
 ## What the script profiler costs per call in this game, measured once each time it is switched on.
 ##
 ## The profiler times every call it counts, and that bookkeeping lands in the self time of the

package/build/index.js

@@ -26036,19 +26036,35 @@ function runtimeRequest(endpoint, command, params, timeoutMs, keepListening = fa
 function bootNotePath(projectPath) {
   return join3(projectPath, ".godot", "gdharness-boot.json");
 }
-function readBootNote(projectPath) {
+var MAIN_SCENE = "";
+function readScenes(projectPath) {
   try {
-    const noted = readNumber(asParams(JSON.parse(readFileSync4(bootNotePath(projectPath), "utf8"))), "announcedAfterMs");
-    return noted !== undefined && Number.isFinite(noted) && noted > 0 ? noted : null;
+    return asParams(asParams(JSON.parse(readFileSync4(bootNotePath(projectPath), "utf8")))["scenes"]);
   } catch {
-    return null;
+    return {};
   }
 }
-function writeBootNote(projectPath, announcedAfterMs) {
+var BOOTS_KEPT = 5;
+function bootsOf(projectPath, scene) {
+  const kept = asParams(readScenes(projectPath)[scene])["boots"];
+  return Array.isArray(kept) ? kept.filter((one) => typeof one === "number" && Number.isFinite(one) && one > 0) : [];
+}
+function readBootNote(projectPath, scene) {
+  const boots = bootsOf(projectPath, scene);
+  return boots.length === 0 ? null : Math.max(...boots);
+}
+function writeBootNote(projectPath, scene, announcedAfterMs) {
   try {
     const path = bootNotePath(projectPath);
     mkdirSync2(dirname2(path), { recursive: true });
-    writeFileSync2(path, JSON.stringify({ announcedAfterMs: Math.round(announcedAfterMs), at: new Date().toISOString() }, null, 2), "utf8");
+    const scenes = {
+      ...readScenes(projectPath),
+      [scene]: {
+        boots: [...bootsOf(projectPath, scene), Math.round(announcedAfterMs)].slice(-BOOTS_KEPT),
+        at: new Date().toISOString()
+      }
+    };
+    writeFileSync2(path, JSON.stringify({ scenes }, null, 2), "utf8");
   } catch {}
 }
 var LONGEST_SIZED_WAIT_MS = 60000;
@@ -26613,6 +26629,7 @@ function bodyCallsSuper(code, line, lambda) {
   }
   return false;
 }
+var ASSIGNED = /^(?:\*\*|<<|>>|[-+*/%&|^])?=(?!=)/;
 function parametersOf(text, from) {
   const open = text.indexOf("(", from);
   if (open === -1) {
@@ -26731,8 +26748,31 @@ function callSitesOf(source, name, otherClasses = new Set, property = false) {
     const declared = bodyHolding(shape.body, at).declarations.find((one) => one.name === member && (one.kind === "var" || one.kind === "const"));
     return declared === undefined ? null : declaredClass(codeLines[lines.positionOf(declared.offset).line] ?? "", member);
   };
+  const blockUnder = (declared) => {
+    const indent = (codeLines[declared] ?? "").search(/\S|$/);
+    let last = declared;
+    for (let index = declared + 1;index < codeLines.length; index += 1) {
+      const text = codeLines[index] ?? "";
+      if (text.trim() === "") {
+        continue;
+      }
+      if (text.search(/\S/) <= indent) {
+        break;
+      }
+      last = index;
+    }
+    return [declared, last];
+  };
+  const accessorsIn = (body) => [
+    ...body.declarations.filter((one) => one.kind === "var" && one.name === name).map((one) => blockUnder(lines.positionOf(one.offset).line)),
+    ...body.inner.flatMap(accessorsIn)
+  ];
+  const accessors = property ? accessorsIn(shape.body) : [];
   return occurrencesOf(source, name, regions).filter((one) => one.kind === "code" && one.declaredAs === null).filter((one) => {
     const index = lines.positionOf(one.offset).line;
+    if (!one.afterDot && accessors.some(([declared, last]) => index > declared && index <= last)) {
+      return false;
+    }
     if (one.afterDot) {
       const receiver = receiverBefore(code, one.offset);
       if (receiver === null || otherClasses.size === 0) {
@@ -26754,7 +26794,8 @@ function callSitesOf(source, name, otherClasses = new Set, property = false) {
   }).map((one) => {
     const line = lines.positionOf(one.offset).line + 1;
     const after = code.slice(one.offset + name.length).trimStart();
-    return { line, within: enclosingFunction(source, line, code), called: after.startsWith("(") };
+    const within = enclosingFunction(source, line, code);
+    return property ? { line, within, access: ASSIGNED.test(after) ? "write" : "read" } : { line, within, called: after.startsWith("(") };
   });
 }
 function collectEnumValues(text, from, into) {
@@ -33491,7 +33532,8 @@ var CALL_SITES = 40;
 function callersOf(totals, name, scripts) {
   const listed = [...scripts];
   const sources = new Map(listed);
-  const rows = rowsOf(totals, (script) => sources.get(script) ?? null);
+  const perCallUs = perCallCostOf(totals);
+  const rows = rowsOf(totals, (script) => sources.get(script) ?? null).map((row) => withOverhead(row, perCallUs));
   const asked = name.includes(".") ? name.slice(0, name.lastIndexOf(".")) : null;
   const bare = propertyOf(name) ?? bareName(name);
   const ownerOf = (fn) => fn.includes(".") ? fn.slice(0, fn.lastIndexOf(".")) : null;
@@ -33524,7 +33566,12 @@ function callersOf(totals, name, scripts) {
     }
   }
   sites.sort((a, b) => (b.withinTotalMs ?? -1) - (a.withinTotalMs ?? -1) || a.script.localeCompare(b.script) || a.line - b.line);
-  return { target, sites: sites.slice(0, CALL_SITES), omitted: Math.max(0, sites.length - CALL_SITES) };
+  return {
+    target,
+    sites: sites.slice(0, CALL_SITES),
+    omitted: Math.max(0, sites.length - CALL_SITES),
+    property
+  };
 }
 
 // src/setup.ts
@@ -34492,7 +34539,7 @@ var TOOL_SPECS = [
         type: "integer",
         minimum: 0,
         ops: ["start"],
-        description: "start: how long to wait for the game to announce its runtime before answering. Default 5000, or half as long again as the last boot of this project took when that is more, up to 60000: the server notes how long each game took to announce, so a project that boots slowly is waited for from its second start on without being asked to. What it waits for is the first frame, so everything the game does before drawing one is inside it, including work the args just asked for: a flag that simulates six years of game time before anything is drawn makes the announcement that late, on a project that announces promptly without it. Raise it for such a run rather than reading runtime listening false as a fault. 0 does not wait at all, which is the one to pass for a scene that announces nothing by construction, such as a bench that prints and quits."
+        description: "start: how long to wait for the game to announce its runtime before answering. Default 5000, or half as long again as the slowest of the last five boots of the same scene when that is more, up to 60000: the server notes how long each game took to announce, per scene and for the main scene when none is named, since a boot moves with the load on the machine, so a scene that boots slowly is waited for from its second start on without being asked to, and a harness scene that announces late sets nothing for the main scene. What it waits for is the first frame, so everything the game does before drawing one is inside it, including work the args just asked for: a flag that simulates six years of game time before anything is drawn makes the announcement that late, on a project that announces promptly without it. Raise it for such a run rather than reading runtime listening false as a fault. 0 does not wait at all, which is the one to pass for a scene that announces nothing by construction, such as a bench that prints and quits."
       },
       frames: {
         type: "integer",
@@ -34514,7 +34561,7 @@ var TOOL_SPECS = [
       callersOf: {
         type: "string",
         ops: ["profile"],
-        description: "profile: also answer, under callers, where the project's scripts name this function in code: its name, or Class.name for the functions of one class. Each place has its script, line, the named function it is written in (within), whether the function is called there or passed on as a Callable (called), and the profile's calls, self and total milliseconds for the function it is in, those taking the most time first, forty at most. Found by name in the source, since the engine's profiler records nothing about who made a call, so a method of the same name on another class is listed too, except, when Class.name was asked, one called through another class of the project by name or through a parameter, local or class variable declared as one, and a call made through a string is not. A parameter, local or class variable of the same name is not the function and is not listed. A property's get or set block, which the profile names Class.@name_getter or Class.@name_setter, is asked about by that name or by the property's: the places are where the property is named, and the rows are both blocks'."
+        description: "profile: also answer, under callers, where the project's scripts name this function in code: its name, or Class.name for the functions of one class. Each place has its script, line, the named function it is written in (within), whether the function is called there or passed on as a Callable (called), and the profile's calls, self and total milliseconds for the function it is in, those taking the most time first, forty at most. Found by name in the source, since the engine's profiler records nothing about who made a call, so a method of the same name on another class is listed too, except, when Class.name was asked, one called through another class of the project by name or through a parameter, local or class variable declared as one, and a call made through a string is not. A parameter, local or class variable of the same name is not the function and is not listed. A property's get or set block, which the profile names Class.@name_getter or Class.@name_setter, is asked about by that name or by the property's: the places are where the property is named, each saying instead of called whether it writes the property (access write), which runs the set block, or reads it (access read), which runs the get block, and the rows are both blocks'. 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 places."
       },
       limit: {
         type: "integer",
@@ -35521,6 +35568,7 @@ function endedToStartThis(ended) {
   return ` ${which} was ended to start this one; its output is no longer what editor_output answers about.`;
 }
 var LONGEST_BOOT_NOTED_MS = 5 * 60000;
+var PROFILE_SEND_MS = 5000;
 var MOST_GROUPS = 20;
 function runtimeVerdict(endpoint, after) {
   if (endpoint !== null) {
@@ -35542,7 +35590,7 @@ 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 its last game took ${after.sizedToMs}ms to announce,` : `, half as long again as the ${after.sizedToMs}ms its last game took,`;
+  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,`;
   return {
     listening: false,
     mayYetAnnounce: after.running,
@@ -35992,6 +36040,7 @@ function playedCap(held) {
     totalCapped: readBoolean(held, "totalCapped") === true
   };
 }
+var 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.";
 var 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.";
 function projectSourceOf(projectPath) {
   const read = new Map;
@@ -36078,10 +36127,12 @@ function overheadRowsReturned(table, one) {
   if (shown === table.overheadDominated) {
     return one ? " Its row carries that share as overheadMs." : " Their rows carry that share as overheadMs.";
   }
+  const theReturned = returned === 1 ? "the one row returned" : `the ${returned} rows returned`;
   if (shown === 0) {
-    return one ? ` Its row, which carries that share as overheadMs, is not among the ${returned} returned; limit ${table.overheadReach} returns it.` : ` Their rows, which carry that share as overheadMs, are none of the ${returned} returned; limit ${table.overheadReach} returns them all.`;
+    return one ? ` Its row, which carries that share as overheadMs, comes after ${theReturned}; limit ${table.overheadReach} returns it.` : ` Their rows, which carry that share as overheadMs, come after ${theReturned}; limit ${table.overheadReach} returns them all.`;
   }
-  return ` Their rows carry that share as overheadMs, and ${shown} of them ${shown === 1 ? "is" : "are"} among the ${returned} returned; limit ${table.overheadReach} returns them all.`;
+  const among = returned === 1 ? "the one row returned is one of them" : `${shown} of them ${shown === 1 ? "is" : "are"} among ${theReturned}`;
+  return ` Their rows carry that share as overheadMs, and ${among}; limit ${table.overheadReach} returns them all.`;
 }
 function namedFew(names) {
   const shown = names.slice(0, 5);
@@ -36127,12 +36178,13 @@ function uncountedCallee(totals, name) {
 }
 function callersAnswer(totals, asked) {
   const found = callersOf(totals, asked.name, asked.scripts());
+  const byName = found.target.length === 0 ? `${CALLERS_FOUND_BY_NAME} ${uncountedCallee(totals, asked.name)}` : CALLERS_FOUND_BY_NAME;
   return {
     of: asked.name,
     rows: found.target,
     sites: found.sites,
     omitted: found.omitted > 0 ? found.omitted : undefined,
-    note: found.sites.length === 0 ? `No script in the project names ${asked.name} in code, outside its declaration: a call made through a string, such as call("name"), is not found by name.` : found.target.length === 0 ? `${CALLERS_FOUND_BY_NAME} ${uncountedCallee(totals, asked.name)}` : CALLERS_FOUND_BY_NAME
+    note: found.sites.length === 0 ? `No script in the project names ${asked.name} in code, outside its declaration: a call made through a string, such as call("name"), is not found by name.` : found.property ? `${byName} ${PROPERTY_PLACES}` : byName
   };
 }
 var MOST_ENGINE_ENTRIES = 200;
@@ -38946,7 +38998,7 @@ class GodotServer {
       platform: process.platform,
       variables: process.env
     });
-    const runtimeWaitMs = this.announceBudget(args, project.value.path);
+    const runtimeWaitMs = this.announceBudget(args, project.value.path, sceneArgument);
     const editorWouldPlay = !headless || editorPlaysHeadless(project.value.file);
     const silent = resolveSilent(args["silent"], process.env) && !headless;
     const profiled = readBoolean(args, "profile") === true;
@@ -38968,6 +39020,7 @@ class GodotServer {
       ]);
     }
     started.announcedBefore = alreadyPlaying;
+    started.bootScene = runtimeWaitMs.scene;
     this.activeProcess = started;
     const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
     const endedForThis = endedToStartThis(ended);
@@ -39057,17 +39110,18 @@ class GodotServer {
       ...going?.throughEditor === true ? { playingSeen: going.seenPlaying === true } : {}
     });
   }
-  announceBudget(args, projectPath) {
+  announceBudget(args, projectPath, scene) {
+    const key = scene ?? MAIN_SCENE;
     const asked = readNonNegativeNumber(args, "runtimeWaitMs");
     if (asked !== undefined) {
-      return { ms: asked };
+      return { ms: asked, scene: key };
     }
-    const lastBoot = readBootNote(projectPath);
+    const lastBoot = readBootNote(projectPath, key);
     const ms = waitSizedTo(lastBoot);
-    return lastBoot !== null && ms > ANNOUNCE_BUDGET_MS ? { ms, sizedToMs: lastBoot } : { ms };
+    return lastBoot !== null && ms > ANNOUNCE_BUDGET_MS ? { ms, sizedToMs: lastBoot, scene: key } : { ms, scene: key };
   }
   noteBootOf(run, endpoint) {
-    if (run.projectPath === null) {
+    if (run.projectPath === null || run.bootScene === undefined) {
       return;
     }
     let announcedAt;
@@ -39079,7 +39133,7 @@ class GodotServer {
     const took = announcedAt - run.startedAt;
     this.logDebug(`boot of pid ${endpoint.pid} announced ${Math.round(took)}ms after the start of ${run.projectPath}`);
     if (took > 0 && took <= LONGEST_BOOT_NOTED_MS) {
-      writeBootNote(run.projectPath, took);
+      writeBootNote(run.projectPath, run.bootScene, took);
     }
   }
   async playThroughEditor(scene, refreshedClasses, scanned, projectPath, alreadyPlaying, runtimeWaitMs, ended, profiled) {
@@ -39138,7 +39192,8 @@ class GodotServer {
       brokeOn: null,
       announcedBefore: alreadyPlaying,
       seenPlaying: readBoolean(playAnswer, "playing") === true,
-      ...which === null ? {} : { play: which }
+      ...which === null ? {} : { play: which },
+      bootScene: runtimeWaitMs.scene
     };
     this.activeProcess = played;
     this.noteTheLatestRun({ projectPath, pid: null, startedAt });
@@ -39308,6 +39363,7 @@ class GodotServer {
     }
     running.endedHere = reason;
     const announced = this.announcedPidOf(running);
+    await this.sendTheProfileFirst(running, announced);
     if (running.throughEditor) {
       const asked = await this.handleViaBridge("stop_playing", {});
       if (asked.isError === true) {
@@ -39378,6 +39434,25 @@ class GodotServer {
     running.log.record(gone ? "info" : "warning", declined !== null ? `gdharness could not signal pid ${running.pid}: the operating system refused it (${declined}). It had described that process as ${described}.` : !gone ? `gdharness signalled pid ${running.pid}, which the operating system described as ${described}, and it was still running ${stopWaitMs() / 1000} seconds later.` : landed ? `gdharness ended pid ${running.pid}, which the operating system described as ${described}.` : `gdharness signalled pid ${running.pid} and it was already gone; the operating system had described it as ${described}.`);
     return gone ? "gone" : "lingering";
   }
+  async sendTheProfileFirst(run, announced) {
+    if (announced === undefined) {
+      return;
+    }
+    const profiled = run.throughEditor ? await this.theEditorIsProfiling() : run.profile !== undefined;
+    const endpoint = profiled ? runtimesAnnounced().running.find((one) => one.pid === announced) : undefined;
+    if (endpoint === undefined) {
+      return;
+    }
+    await runtimeRequest(endpoint, "send_profile", {}, PROFILE_SEND_MS);
+  }
+  async theEditorIsProfiling() {
+    const read = await this.handleViaBridge("profile_read", {});
+    if (read.isError === true) {
+      return false;
+    }
+    const held = asParams(JSON.parse(read.content[0]?.text ?? "{}"));
+    return readBoolean(held, "profiled") === true && readBoolean(held, "complete") !== true;
+  }
   async endThroughTheKeeper(run, pid, keeper) {
     const asked = await askTheKeeperToStop(keeper, KEEPER_ANSWER_MS);
     if (typeof asked !== "string") {
@@ -41053,7 +41128,7 @@ class GodotServer {
       return null;
     }
     const which = run.throughEditor ? "the game the editor is playing for it" : `pid ${run.pid ?? "unknown"}`;
-    const comingUpUntil = run.startedAt + waitSizedTo(readBootNote(project)) + budgetMs;
+    const comingUpUntil = run.startedAt + waitSizedTo(readBootNote(project, run.bootScene ?? MAIN_SCENE)) + budgetMs;
     const remaining = comingUpUntil - Date.now();
     if (remaining <= 0) {
       const seconds = Math.round((Date.now() - run.startedAt) / 1000);

package/package.json

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