godot-cli 0.37.0 → 0.39.0

package/dist/lib/progress.js

@@ -1,18 +1,5 @@
-/**
- * Forward a single progress event to the caller's optional callback,
- * swallowing any exception the callback throws. A broken onProgress handler
- * must never abort the underlying library operation.
- */
-export function emitProgress(onProgress, event) {
-    if (!onProgress)
-        return;
-    try {
-        onProgress(event);
-    }
-    catch {
-        // Intentionally ignored — see doc comment.
-    }
-}
+// Forward a progress event to the caller's optional callback, swallowing anything it throws: cli-core's.
+export { emitProgress } from '@baizor/gamedev-cli-core';
 /** ` (PID: n)` when the pid is known, else nothing: a log line never says "PID: unknown". */
 export function pidSuffix(pid) {
     return pid !== undefined ? ` (PID: ${pid})` : '';

package/dist/lib/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAwC,EAAE,KAAoB;IACzF,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,IAAI,CAAC;QACH,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,SAAS,CAAC,GAAuB;IAC/C,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,6FAA6F;AAC7F,MAAM,UAAU,SAAS,CAAC,GAAuB;IAC/C,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/lib/rql.d.ts

@@ -0,0 +1,32 @@
+import { RQL_MUTATE_TOOL, RQL_QUERY_TOOL, RQL_SCHEMA_TOOL, decodeQueryFile, isRqlMutation, rqlStages, stripToolName } from '@baizor/gamedev-cli-core';
+export { RQL_MUTATE_TOOL, RQL_QUERY_TOOL, RQL_SCHEMA_TOOL, decodeQueryFile, isRqlMutation, rqlStages, stripToolName };
+export interface RqlCallOptions {
+    /** `--schema [type]`: true without a type. */
+    schema?: string | boolean;
+    dryRun?: boolean;
+    maxTargets?: number;
+}
+/** The rql-* tool and its input for a command-line query, or why the command line is wrong. */
+export declare function rqlToolCall(query: string | undefined, options: RqlCallOptions): {
+    toolName: string;
+    input: Record<string, unknown>;
+} | {
+    usage: string;
+};
+/**
+ * A hint for a failed RQL tool (`toolName` rql-*) whose error is a familiar slip (an operator spelled as in another
+ * language), else `undefined`.
+ */
+export declare function rqlErrorHint(toolName: string, message: string): string | undefined;
+/** A query that saves files: a scene save, a new scene (saved at its path), a resource edit or creation. */
+export declare function rqlMaySave(query: string): boolean;
+/**
+ * The scene / resource files of the project (dot folders such as `.godot` and `addons/` left out) modified at or after
+ * `sinceMs`, as res:// paths, sorted — what a save call actually wrote.
+ */
+export declare function resourcesWrittenSince(projectDir: string, sinceMs: number): string[];
+/**
+ * The line a change prints: the files it wrote (the first `limit`, then how many more). When it wrote none: that, for a
+ * save (`maySave`); nothing for any other change (scene edits stay unsaved until SaveScene()).
+ */
+export declare function saveReceipt(written: readonly string[], maySave: boolean, limit?: number): string | undefined;

package/dist/lib/rql.js

@@ -0,0 +1,105 @@
+// `rql` — RQL text straight from the command line: which rql-* tool a query goes to, hints for the RQL slips agents
+// make most, and which files a save wrote. Never prints, never exits.
+import * as fs from 'fs';
+import * as path from 'path';
+import { RQL_MUTATE_TOOL, RQL_QUERY_TOOL, RQL_SCHEMA_TOOL, decodeQueryFile, isRqlMutation, rqlStages, stripToolName } from '@baizor/gamedev-cli-core';
+export { RQL_MUTATE_TOOL, RQL_QUERY_TOOL, RQL_SCHEMA_TOOL, decodeQueryFile, isRqlMutation, rqlStages, stripToolName };
+/** The rql-* tool and its input for a command-line query, or why the command line is wrong. */
+export function rqlToolCall(query, options) {
+    const { schema, dryRun, maxTargets } = options;
+    if (schema !== undefined) {
+        // `rql --schema 'nodes | count'` hands the query to --schema as its value.
+        if (query !== undefined || (typeof schema === 'string' && /[|\s]/.test(schema.trim()))) {
+            return { usage: 'Pass either a query or --schema [type] (a type name), not both.' };
+        }
+        return { toolName: RQL_SCHEMA_TOOL, input: typeof schema === 'string' ? { type: schema } : {} };
+    }
+    if (query === undefined || query.trim() === '') {
+        return { usage: 'No query given: godot-cli rql \'nodes | where name starts-with "Tree" | count\' (recipes: rql --help)' };
+    }
+    if (!isRqlMutation(query)) {
+        if (dryRun || maxTargets !== undefined)
+            return { usage: '--dry-run and --max-targets are for a query ending in set / call.' };
+        return { toolName: RQL_QUERY_TOOL, input: { query } };
+    }
+    return { toolName: RQL_MUTATE_TOOL, input: { query, ...(dryRun ? { dry_run: true } : {}), ...(maxTargets !== undefined ? { max_targets: maxTargets } : {}) } };
+}
+/** Operators agents bring from other languages, with RQL's spelling. */
+const OPERATOR_HINTS = [
+    [/^startswith$/i, 'RQL spells it starts-with: where name starts-with "Tree"'],
+    [/^endswith$/i, 'RQL spells it ends-with: where name ends-with "_lod0"'],
+    [/^(like|ilike)$/i, 'RQL has no like: use starts-with / ends-with / contains, or matches "regex"'],
+    [/^(includes|has)$/i, 'RQL spells it contains: where name contains "Tree"'],
+    [/^(isnull|is_null)$/i, 'RQL spells it x is null / x is not null'],
+    [/^(notin|not_in)$/i, 'RQL spells it not (x in [a, b])'],
+    [/^(regex|regexp|match|rlike)$/i, 'RQL spells it matches "regex": where name matches "^Tree[0-9]+$"'],
+];
+/**
+ * A hint for a failed RQL tool (`toolName` rql-*) whose error is a familiar slip (an operator spelled as in another
+ * language), else `undefined`.
+ */
+export function rqlErrorHint(toolName, message) {
+    if (!toolName.startsWith('rql-'))
+        return undefined;
+    const token = /unexpected '([^']+)'|unknown method '([^']+)'/.exec(message);
+    const word = token?.[1] ?? token?.[2];
+    if (word) {
+        for (const [pattern, hint] of OPERATOR_HINTS)
+            if (pattern.test(word))
+                return hint;
+    }
+    return undefined;
+}
+/** A query that saves files: a scene save, a new scene (saved at its path), a resource edit or creation. */
+export function rqlMaySave(query) {
+    // Outside string literals and `identifiers`: where name == "SaveScene(" saves nothing.
+    const code = query.replace(/"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`[^`]*`/g, '""');
+    return /\b(SaveScenes?|SaveAllScenes|NewScene|CreateResource|Save)\s*\(|godot\.resources?\(/.test(code);
+}
+/** The Godot files a save writes: scenes and resources. */
+const SAVED_FILE = /\.(tscn|scn|tres|res)$/i;
+/**
+ * The scene / resource files of the project (dot folders such as `.godot` and `addons/` left out) modified at or after
+ * `sinceMs`, as res:// paths, sorted — what a save call actually wrote.
+ */
+export function resourcesWrittenSince(projectDir, sinceMs) {
+    const found = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!entry.name.startsWith('.') && !(dir === projectDir && entry.name === 'addons'))
+                    walk(full);
+            }
+            else if (SAVED_FILE.test(entry.name)) {
+                try {
+                    if (fs.statSync(full).mtimeMs >= sinceMs)
+                        found.push(`res://${path.relative(projectDir, full).split(path.sep).join('/')}`);
+                }
+                catch {
+                    /* removed meanwhile */
+                }
+            }
+        }
+    };
+    walk(projectDir);
+    return found.sort();
+}
+/**
+ * The line a change prints: the files it wrote (the first `limit`, then how many more). When it wrote none: that, for a
+ * save (`maySave`); nothing for any other change (scene edits stay unsaved until SaveScene()).
+ */
+export function saveReceipt(written, maySave, limit = 20) {
+    if (written.length === 0)
+        return maySave ? 'No scene or resource file of the project changed on disk.' : undefined;
+    const more = written.length > limit ? `, +${written.length - limit} more` : '';
+    return `Saved to disk: ${written.slice(0, limit).join(', ')}${more}`;
+}
+//# sourceMappingURL=rql.js.map

package/dist/lib/rql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rql.js","sourceRoot":"","sources":["../../src/lib/rql.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-script.d.ts

@@ -0,0 +1,23 @@
+import { type Diagnostic } from './godot-log.js';
+import { type HeadlessBaseOptions, type HeadlessResult, type HeadlessStep } from './headless.js';
+export interface RunScriptOptions extends HeadlessBaseOptions {
+    /** `res://…` or a file path (absolute or relative to the current directory). */
+    script: string;
+    /** Passed after `--` (`OS.get_cmdline_user_args()`). */
+    scriptArgs?: string[];
+    /** Each output line as it arrives. */
+    onLine?: (line: string) => void;
+}
+export interface RunScriptReport {
+    projectPath: string;
+    script: string;
+    /** The code the script passed to `quit()`. */
+    scriptExitCode: number | null;
+    output: string;
+    steps: HeadlessStep[];
+    diagnostics: Diagnostic[];
+}
+export type RunScriptResult = HeadlessResult<RunScriptReport>;
+/** `res://` path of a script inside the project, the absolute path otherwise (Godot loads both). */
+export declare function scriptPathForGodot(projectPath: string, script: string, cwd?: string): string;
+export declare function runScript(options: RunScriptOptions): Promise<RunScriptResult>;

package/dist/lib/run-script.js

@@ -0,0 +1,43 @@
+// `runScript`: a one-shot SceneTree / MainLoop GDScript (`godot --headless --path <project> -s <file>`) with a hard
+// timeout. The verdict is the exit code the script passed to `quit(code)`, checked against the log: a script that
+// failed to parse makes Godot exit 0 without running anything. Library-safe.
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseGodotLog } from './godot-log.js';
+import { engineRan, headlessFailure, stoppedRun, notStarted, prepareHeadless, runGodotStep, } from './headless.js';
+/** `res://` path of a script inside the project, the absolute path otherwise (Godot loads both). */
+export function scriptPathForGodot(projectPath, script, cwd = process.cwd()) {
+    if (script.startsWith('res://'))
+        return script;
+    const abs = path.resolve(cwd, script);
+    const rel = path.relative(projectPath, abs);
+    if (!rel.startsWith('..') && !path.isAbsolute(rel))
+        return `res://${rel.split(path.sep).join('/')}`;
+    return abs.split(path.sep).join('/');
+}
+export async function runScript(options) {
+    const ctx = prepareHeadless(options);
+    if (ctx.kind === 'failure')
+        return ctx;
+    const script = scriptPathForGodot(ctx.projectPath, options.script);
+    const onDisk = script.startsWith('res://') ? path.join(ctx.projectPath, script.slice('res://'.length)) : script;
+    if (!fs.existsSync(onDisk))
+        return headlessFailure('not-found', `Script not found: ${onDisk}`);
+    const args = ['-s', script, ...(options.scriptArgs && options.scriptArgs.length > 0 ? ['--', ...options.scriptArgs] : [])];
+    const run = await runGodotStep(ctx, 'run-script', args, options.onLine ? { onLine: options.onLine } : {});
+    const diagnostics = parseGodotLog(run.output).filter((d) => d.source !== 'engine');
+    const report = { projectPath: ctx.projectPath, script, scriptExitCode: run.exitCode, output: run.output, steps: ctx.steps, diagnostics };
+    const fail = (failure) => ({ ...failure, ...report });
+    const stopped = stoppedRun(run, 'The script');
+    if (stopped)
+        return fail(stopped);
+    if (!engineRan(run))
+        return fail(notStarted('script-errors', run));
+    const loadErrors = diagnostics.filter((d) => d.severity === 'error' && d.phase === 'load');
+    if (loadErrors.length > 0)
+        return fail(headlessFailure('script-errors', `The script failed to load (${loadErrors.length} error(s)).`));
+    if (run.exitCode !== 0)
+        return fail(headlessFailure('script-errors', `The script exited with code ${run.exitCode}.`));
+    return { kind: 'success', success: true, ...report };
+}
+//# sourceMappingURL=run-script.js.map

package/dist/lib/run-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-script.js","sourceRoot":"","sources":["../../src/lib/run-script.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-tests.d.ts

@@ -0,0 +1,50 @@
+import { type Diagnostic } from './godot-log.js';
+import { type HeadlessBaseOptions, type HeadlessResult, type HeadlessStep } from './headless.js';
+import { type JUnitReport } from './junit.js';
+export type TestRunner = 'gut' | 'gdunit4';
+export declare const TEST_RUNNERS: Record<TestRunner, {
+    label: string;
+    script: string;
+    install: string;
+}>;
+export interface RunTestsOptions extends HeadlessBaseOptions {
+    /** Default: the one installed (GUT first when both are). */
+    runner?: TestRunner;
+    /** Test directories (res:// or project-relative). Default: GUT's .gutconfig.json, else res://test and/or res://tests. */
+    dirs?: string[];
+    /** Only test scripts whose file name contains this text. */
+    filter?: string;
+    /** Skip the `--import` step (the project was imported already). */
+    skipImport?: boolean;
+}
+export interface TestsReport {
+    projectPath: string;
+    runner: TestRunner;
+    steps: HeadlessStep[];
+    /** The JUnit XML file the runner wrote. */
+    junitFile?: string;
+    report?: JUnitReport;
+    /** Test scripts that failed to load (they never reach the report). */
+    loadErrors: Diagnostic[];
+}
+export type RunTestsResult = HeadlessResult<TestsReport>;
+/** The test runners installed in a project. */
+export declare function detectTestRunners(projectPath: string): TestRunner[];
+/** Default test dirs: res://test and/or res://tests when they exist, else res://. */
+export declare function defaultTestDirs(projectPath: string): string[];
+/** The `.gd` files under `dirs` whose name contains `filter` (for gdUnit4, which has no file filter of its own). */
+export declare function findTestScripts(projectPath: string, dirs: string[], filter: string): string[];
+/** The runner's command line (after `--headless --path <project>`). */
+export declare function runnerArgs(runner: TestRunner, options: {
+    projectPath: string;
+    dirs?: string[];
+    filter?: string;
+    junitFile: string;
+    reportDir: string;
+}): string[];
+/**
+ * The newest file named like `nameRe` under `root`, `maxDepth` folders deep (gdUnit4: `<dir>/report_<n>/results.xml`;
+ * GUT: `junit.xml` or `junit_<timestamp>.xml` directly in the run folder).
+ */
+export declare function newestReport(root: string, nameRe: RegExp, maxDepth?: number): string | undefined;
+export declare function runTests(options: RunTestsOptions): Promise<RunTestsResult>;

package/dist/lib/run-tests.js

@@ -0,0 +1,181 @@
+// `runTests`: run the project's GUT or gdUnit4 suite headless with a hard timeout (both runners are known to hang),
+// and judge it from the JUnit XML report cross-checked with the log: a test script that failed to load never shows up
+// in the report, so it must not pass. Library-safe.
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseGodotLog } from './godot-log.js';
+import { engineRan, headlessFailure, stoppedRun, notStarted, prepareHeadless, runGodotStep, runImportStep, } from './headless.js';
+import { parseJUnit } from './junit.js';
+import { isGodotProjectRoot } from '../utils/project-godot.js';
+export const TEST_RUNNERS = {
+    gut: {
+        label: 'GUT',
+        script: 'addons/gut/gut_cmdln.gd',
+        install: 'GUT: https://github.com/bitwes/Gut (Asset Library "GUT - Godot Unit Testing"), copied to res://addons/gut/',
+    },
+    gdunit4: {
+        label: 'gdUnit4',
+        script: 'addons/gdUnit4/bin/GdUnitCmdTool.gd',
+        install: 'gdUnit4: https://github.com/godot-gdunit-labs/gdUnit4 (Asset Library "gdUnit4"), copied to res://addons/gdUnit4/',
+    },
+};
+/** The test runners installed in a project. */
+export function detectTestRunners(projectPath) {
+    return Object.keys(TEST_RUNNERS).filter((r) => fs.existsSync(path.join(projectPath, TEST_RUNNERS[r].script)));
+}
+function toResPath(projectPath, dir) {
+    if (dir.startsWith('res://'))
+        return dir.replace(/\/+$/, '') || 'res://';
+    const rel = path.relative(projectPath, path.resolve(projectPath, dir)).split(path.sep).join('/');
+    return rel === '' ? 'res://' : `res://${rel}`;
+}
+function resToFs(projectPath, res) {
+    return path.join(projectPath, res.replace(/^res:\/\//, ''));
+}
+/** Default test dirs: res://test and/or res://tests when they exist, else res://. */
+export function defaultTestDirs(projectPath) {
+    const found = ['res://test', 'res://tests'].filter((d) => fs.existsSync(resToFs(projectPath, d)));
+    return found.length > 0 ? found : ['res://'];
+}
+/** The `.gd` files under `dirs` whose name contains `filter` (for gdUnit4, which has no file filter of its own). */
+export function findTestScripts(projectPath, dirs, filter) {
+    const out = [];
+    const walk = (res) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(resToFs(projectPath, res), { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith('.') || (res === 'res://' && e.name === 'addons'))
+                continue;
+            const child = res === 'res://' ? `res://${e.name}` : `${res}/${e.name}`;
+            if (e.isDirectory())
+                walk(child);
+            else if (e.name.endsWith('.gd') && e.name.includes(filter))
+                out.push(child);
+        }
+    };
+    for (const d of dirs)
+        walk(d);
+    return out.sort();
+}
+/** The runner's command line (after `--headless --path <project>`). */
+export function runnerArgs(runner, options) {
+    if (runner === 'gut') {
+        const hasConfig = fs.existsSync(path.join(options.projectPath, '.gutconfig.json'));
+        const dirs = options.dirs ?? (hasConfig ? [] : defaultTestDirs(options.projectPath));
+        return [
+            '-s', `res://${TEST_RUNNERS.gut.script}`,
+            '-gexit',
+            '-ginclude_subdirs',
+            ...(dirs.length > 0 ? [`-gdir=${dirs.join(',')}`] : []),
+            ...(options.filter ? [`-gselect=${options.filter}`] : []),
+            `-gjunit_xml_file=${options.junitFile}`,
+        ];
+    }
+    const dirs = options.dirs ?? defaultTestDirs(options.projectPath);
+    const targets = options.filter ? findTestScripts(options.projectPath, dirs, options.filter) : dirs;
+    return [
+        '-s', `res://${TEST_RUNNERS.gdunit4.script}`,
+        '--ignoreHeadlessMode',
+        // gdUnit4 stops at the first failure unless told to continue.
+        '-c',
+        ...targets.flatMap((t) => ['-a', t]),
+        '-rd', options.reportDir,
+    ];
+}
+/**
+ * The newest file named like `nameRe` under `root`, `maxDepth` folders deep (gdUnit4: `<dir>/report_<n>/results.xml`;
+ * GUT: `junit.xml` or `junit_<timestamp>.xml` directly in the run folder).
+ */
+export function newestReport(root, nameRe, maxDepth = 0) {
+    let best;
+    const walk = (dir, depth) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory() && depth < maxDepth)
+                walk(full, depth + 1);
+            else if (e.isFile() && nameRe.test(e.name)) {
+                const mtime = fs.statSync(full).mtimeMs;
+                if (!best || mtime > best.mtime)
+                    best = { file: full, mtime };
+            }
+        }
+    };
+    walk(root, 0);
+    return best?.file;
+}
+export async function runTests(options) {
+    const projectPath = path.resolve(options.projectPath);
+    // Before prepareHeadless: a missing runner is reported without looking for a binary or an open editor.
+    const installed = isGodotProjectRoot(projectPath) ? detectTestRunners(projectPath) : [];
+    const runner = options.runner ?? installed[0];
+    if (!runner || !installed.includes(runner)) {
+        const wanted = options.runner ? [options.runner] : Object.keys(TEST_RUNNERS);
+        return headlessFailure('not-found', `No ${options.runner ? TEST_RUNNERS[options.runner].label : 'test runner (GUT or gdUnit4)'} installed in ${projectPath}. Install one:\n` +
+            wanted.map((r) => `  ${TEST_RUNNERS[r].install}`).join('\n'));
+    }
+    const ctx = prepareHeadless(options);
+    if (ctx.kind === 'failure')
+        return ctx;
+    const progress = options.onProgress ?? (() => undefined);
+    const dirs = options.dirs?.map((d) => toResPath(ctx.projectPath, d));
+    // One report folder, cleared per run (the previous run's reports would otherwise pile up in .godot/).
+    const runDir = path.join(ctx.workDir, 'test');
+    fs.rmSync(runDir, { recursive: true, force: true });
+    fs.mkdirSync(runDir, { recursive: true });
+    const junitFile = path.join(runDir, 'junit.xml');
+    const reportDir = path.join(runDir, 'gdunit-reports');
+    const report = { projectPath: ctx.projectPath, runner, steps: ctx.steps, loadErrors: [] };
+    const fail = (failure) => ({ ...failure, ...report });
+    if (!options.skipImport) {
+        progress('Importing the project (godot --headless --import)...');
+        const imported = await runImportStep(ctx);
+        if (imported.failure?.reason === 'timeout' || imported.failure?.reason === 'interrupted')
+            return fail(imported.failure);
+    }
+    progress(`Running ${TEST_RUNNERS[runner].label} tests...`);
+    const run = await runGodotStep(ctx, 'test', runnerArgs(runner, { projectPath: ctx.projectPath, ...(dirs ? { dirs } : {}), ...(options.filter ? { filter: options.filter } : {}), junitFile, reportDir }));
+    report.loadErrors = parseGodotLog(run.output).filter((d) => d.severity === 'error' && d.source === 'gdscript' && d.phase === 'load' && !d.file?.startsWith('res://addons/'));
+    const stopped = stoppedRun(run, `The ${TEST_RUNNERS[runner].label} run`);
+    if (stopped)
+        return fail(stopped);
+    if (!engineRan(run))
+        return fail(notStarted('test-run-error', run));
+    // GUT renames the report to junit_<timestamp>.xml when junit_xml_timestamp is on (.gutconfig.json; GUT reads any
+    // -gjunit_xml_timestamp value as true): take the newest junit*.xml in this run's folder, which starts empty.
+    const xmlFile = runner === 'gut' ? newestReport(runDir, /^junit.*\.xml$/) : newestReport(reportDir, /^results\.xml$/, 3);
+    if (!xmlFile || !fs.existsSync(xmlFile)) {
+        return fail(headlessFailure('test-run-error', `${TEST_RUNNERS[runner].label} wrote no JUnit report (exit ${run.exitCode}): no verdict.`));
+    }
+    report.junitFile = xmlFile;
+    try {
+        report.report = parseJUnit(fs.readFileSync(xmlFile, 'utf-8'));
+    }
+    catch (err) {
+        return fail(headlessFailure('test-run-error', `Unreadable JUnit report ${xmlFile}: ${err instanceof Error ? err.message : String(err)}`));
+    }
+    const { failures, errors, tests, suiteFailures } = report.report;
+    if (failures + errors > 0)
+        return fail(headlessFailure('tests-failed', `${failures + errors} of ${tests} test(s) failed.`));
+    // A suite-level setup/teardown failure leaves every case passing.
+    if (suiteFailures > 0)
+        return fail(headlessFailure('tests-failed', `${suiteFailures} suite-level failure(s) (setup/teardown) although no test case failed.`));
+    if (report.loadErrors.length > 0) {
+        return fail(headlessFailure('test-run-error', `${report.loadErrors.length} test script(s) failed to load, so their tests never ran.`));
+    }
+    if (tests === 0)
+        return fail(headlessFailure('test-run-error', 'No tests ran: no verdict.'));
+    return { kind: 'success', success: true, ...report };
+}
+//# sourceMappingURL=run-tests.js.map

package/dist/lib/run-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.js","sourceRoot":"","sources":["../../src/lib/run-tests.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-tool.js

@@ -4,6 +4,7 @@
 // - No commander, no spinners, no process.exit, no console output.
 // - Errors are returned in `{ kind: 'failure', success: false, ... }`,
 //   never thrown past the public boundary.
+import { networkFailureReason } from '@baizor/gamedev-cli-core';
 const DEFAULT_TIMEOUT_MS = 60000;
 /**
  * Invoke a regular MCP tool over the Godot plugin's HTTP API.
@@ -57,7 +58,8 @@ async function invokeTool(routePrefix, opts) {
             body: body.json,
             signal: controller.signal,
         });
-        const text = await safeReadText(response);
+        // A connection dropped mid-body throws here and is classified as such, never read as an empty answer.
+        const text = await response.text();
         const data = parseJsonOrText(text);
         if (!response.ok) {
             return makeFailure({
@@ -138,14 +140,6 @@ function serializeInput(input) {
         };
     }
 }
-async function safeReadText(response) {
-    try {
-        return await response.text();
-    }
-    catch {
-        return '';
-    }
-}
 function parseJsonOrText(text) {
     if (text.length === 0)
         return undefined;
@@ -156,11 +150,6 @@ function parseJsonOrText(text) {
         return text;
     }
 }
-function getCause(err) {
-    if (!(err instanceof Error) || !('cause' in err))
-        return undefined;
-    return err.cause;
-}
 function classifyFetchError(err, endpoint, timeoutMs) {
     if (err instanceof Error && err.name === 'AbortError') {
         return makeFailure({
@@ -171,14 +160,9 @@ function classifyFetchError(err, endpoint, timeoutMs) {
         });
     }
     const error = err instanceof Error ? err : new Error(String(err));
-    const causeCode = getCause(err)?.code;
-    let reason = 'unknown';
-    if (causeCode === 'ECONNREFUSED')
-        reason = 'connection-refused';
-    else if (causeCode === 'ECONNRESET')
-        reason = 'connection-reset';
-    else if (causeCode === 'ENOTFOUND' || causeCode === 'EAI_AGAIN')
-        reason = 'network-error';
+    // The transport cause through the error's cause chain (shared with the other engine CLIs): a socket the server
+    // closed before or during the answer is `connection-reset` (exit 7), not `unknown`.
+    const reason = networkFailureReason(err) ?? 'unknown';
     return makeFailure({
         endpoint,
         reason,

package/dist/lib/run-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-tool.js","sourceRoot":"","sources":["../../src/lib/run-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-tool.js","sourceRoot":"","sources":["../../src/lib/run-tool.ts"],"names":[],"mappings":"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"}

package/dist/lib/session.d.ts

@@ -1,5 +1,10 @@
-import { EditorSession, type EditorSessionOptions, type EngineAdapter, type EnsureResult, type SessionProcessOps } from '@baizor/gamedev-cli-core';
+import { EditorSession, type EditorSessionErrorReason, type EditorSessionOptions, type EngineAdapter, type EnsureResult, type SessionProcessOps } from '@baizor/gamedev-cli-core';
 import type { BuildProjectResult } from './types.js';
+/**
+ * Where a started editor's log is (Godot's own `user://logs/godot.log`) and the script/load errors in it, for a start
+ * that never became ready.
+ */
+export declare function startupLogHint(projectPath: string): string;
 /** The plugin's system tool that saves and quits a CLI-started editor (a windowless one gets no WM_CLOSE). */
 export declare const SESSION_CLOSE_TOOL = "session-close";
 export interface GodotSessionOptions {
@@ -67,6 +72,8 @@ export type EnsureEditorResult = {
      * `launch-failed`: no editor could be started; `not-ready`: its server never answered.
      */
     reason: 'invalid-options' | 'build-failed' | 'launch-failed' | 'not-ready';
+    /** The editor session's own reason, when it failed (`lock-busy`: another CLI call holds the start lock). */
+    sessionReason?: EditorSessionErrorReason;
     message: string;
     error?: Error;
 };