godot-cli 0.38.0 → 0.39.0

package/dist/utils/editor-mcp-server.js

@@ -0,0 +1,134 @@
+import { execFileSync } from 'child_process';
+import * as path from 'path';
+import { platform } from 'os';
+import { isProcessAlive, killProcessTree, readProcessStart } from '@baizor/gamedev-cli-core';
+import { waitForExit } from './godot-shutdown.js';
+import { verbose } from './ui.js';
+/**
+ * The local MCP server is launched by the addon (`GodotMcpServerManager.StartServer`) as a child process of the
+ * editor. The plugin stops it when the editor quits cleanly, but a hard-killed editor leaves it running. `close`
+ * finds it BEFORE the editor goes away — by process parentage, never by command line — and stops it afterwards.
+ * A stopgap for `close` only: a server that watched its parent PID itself would also cover editor crashes.
+ */
+/** File name of the server binary (`GodotMcpServerView.ExecutableName`), without `.exe`. */
+const MCP_SERVER_EXECUTABLE = 'gamedev-mcp-server';
+/** True for the server binary's process name: `gamedev-mcp-server[.exe]`, a full path, or Linux's 15-char `comm`. */
+export function isMcpServerName(name) {
+    const base = path.basename(name.trim().replace(/\\/g, '/')).toLowerCase().replace(/\.exe$/, '');
+    return base === MCP_SERVER_EXECUTABLE || (base.length === 15 && MCP_SERVER_EXECUTABLE.startsWith(base));
+}
+/**
+ * Every process below `rootPid`: children, grandchildren (the `_console` wrapper runs the editor as its child). A
+ * Windows parent PID can name a dead process whose PID was reused, so a child that started before its supposed parent
+ * is not its child.
+ */
+function descendantsOf(table, rootPid) {
+    const byPid = new Map(table.map((e) => [e.pid, e]));
+    const children = new Map();
+    for (const e of table)
+        children.set(e.ppid, [...(children.get(e.ppid) ?? []), e]);
+    const found = [];
+    const seen = new Set([rootPid]);
+    const queue = [rootPid];
+    while (queue.length > 0) {
+        const parent = queue.shift();
+        const parentStarted = byPid.get(parent)?.startedMs;
+        for (const entry of children.get(parent) ?? []) {
+            if (seen.has(entry.pid))
+                continue;
+            if (parentStarted !== undefined && entry.startedMs !== undefined && entry.startedMs < parentStarted)
+                continue;
+            seen.add(entry.pid);
+            queue.push(entry.pid);
+            found.push(entry);
+        }
+    }
+    return found;
+}
+/** The PIDs of the processes below `rootPid` that run the server binary. */
+export function findServerDescendants(table, rootPid) {
+    return descendantsOf(table, rootPid).filter((e) => isMcpServerName(e.name)).map((e) => e.pid);
+}
+/** Parse `pid ppid [startedTicks] name` lines (Windows rows carry UTC .NET ticks). */
+export function parseProcessTable(output, withStart) {
+    const rows = [];
+    const pattern = withStart ? /^\s*(\d+)\s+(\d+)\s+(\d+)\s+(.+?)\s*$/ : /^\s*(\d+)\s+(\d+)\s+(.+?)\s*$/;
+    for (const line of output.split(/\r?\n/)) {
+        const m = line.match(pattern);
+        if (!m)
+            continue;
+        const entry = { pid: Number(m[1]), ppid: Number(m[2]), name: withStart ? m[4] : m[3] };
+        // .NET ticks (100 ns since 0001-01-01) to epoch ms; only ever compared with each other.
+        if (withStart)
+            entry.startedMs = Number((BigInt(m[3]) - 621355968000000000n) / 10000n);
+        rows.push(entry);
+    }
+    return rows;
+}
+const EXEC_OPTIONS = { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 16 * 1024 * 1024 };
+/**
+ * The process table (PID, parent PID, name), or empty when it cannot be read. On Windows only Godot and server rows:
+ * the addon starts the server straight from the editor, which the `_console` wrapper runs, so no other process sits
+ * between them.
+ */
+export function listProcessTable() {
+    try {
+        if (platform() === 'win32') {
+            const script = `Get-CimInstance Win32_Process -Filter "Name LIKE '%godot%' OR Name LIKE '${MCP_SERVER_EXECUTABLE}%'" | ` +
+                'ForEach-Object { "$($_.ProcessId) $($_.ParentProcessId) ' +
+                '$(if ($_.CreationDate) { $_.CreationDate.ToUniversalTime().Ticks } else { 0 }) $($_.Name)" }';
+            const out = execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script], { ...EXEC_OPTIONS, timeout: 20000 });
+            return parseProcessTable(out, true);
+        }
+        const out = execFileSync('ps', ['-A', '-o', 'pid=,ppid=,comm='], { ...EXEC_OPTIONS, timeout: 10000 });
+        return parseProcessTable(out, false);
+    }
+    catch (err) {
+        verbose(`Failed to list processes: ${err instanceof Error ? err.message : String(err)}`);
+        return [];
+    }
+}
+/** The MCP server processes the editor `editorPid` started (its own descendants only), with their start tokens. */
+export async function findEditorServers(editorPid) {
+    const pids = findServerDescendants(listProcessTable(), editorPid);
+    const servers = await Promise.all(pids.map(async (pid) => ({ pid, start: await readProcessStart(pid) })));
+    for (const s of servers)
+        verbose(`Editor PID ${editorPid} runs MCP server PID ${s.pid}`);
+    return servers;
+}
+/**
+ * Once the editor `editorPid` is gone, kill each of its servers still running, with the processes it started. A server
+ * is skipped while its editor is alive, and when its PID now belongs to another process (start token changed). Returns
+ * the PIDs stopped.
+ */
+export async function stopOrphanedServers(editorPid, servers) {
+    if (servers.length === 0 || isProcessAlive(editorPid))
+        return [];
+    const stopped = [];
+    for (const server of servers) {
+        if (!isProcessAlive(server.pid))
+            continue;
+        if (server.start === undefined || (await readProcessStart(server.pid)) !== server.start) {
+            verbose(`MCP server PID ${server.pid} cannot be proven to be the same process; left alone`);
+            continue;
+        }
+        // POSIX: the server leads no process group (.NET's Process.Start keeps the editor's), so killProcessTree reaches only
+        // the server itself; its children are taken from the table. Windows: `taskkill /T` covers them.
+        const children = platform() === 'win32' ? [] : descendantsOf(listProcessTable(), server.pid);
+        await killProcessTree(server.pid);
+        for (const child of children) {
+            try {
+                process.kill(child.pid, 'SIGKILL');
+            }
+            catch {
+                /* already gone */
+            }
+        }
+        if (await waitForExit(server.pid, 5000))
+            stopped.push(server.pid);
+        else
+            verbose(`MCP server PID ${server.pid} is still alive after the kill`);
+    }
+    return stopped;
+}
+//# sourceMappingURL=editor-mcp-server.js.map

package/dist/utils/editor-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-mcp-server.js","sourceRoot":"","sources":["../../src/utils/editor-mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA8C,MAAM,eAAe,CAAC;AACzF,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;GAKG;AAEH,4FAA4F;AAC5F,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAgBnD,qHAAqH;AACrH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChG,OAAO,IAAI,KAAK,qBAAqB,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,IAAI,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1G,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAA8B,EAAE,OAAe;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClC,IAAI,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,GAAG,aAAa;gBAAE,SAAS;YAC9G,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,KAA8B,EAAE,OAAe;IACnF,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAChG,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,SAAkB;IAClE,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,+BAA+B,CAAC;IACtG,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,KAAK,GAAiB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrG,wFAAwF;QACxF,IAAI,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,GAAG,MAAM,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,YAAY,GAA0C,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;AAElJ;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,MAAM,GACV,4EAA4E,qBAAqB,QAAQ;gBACzG,0DAA0D;gBAC1D,8FAA8F,CAAC;YACjG,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACvI,OAAO,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACtG,OAAO,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,mHAAmH;AACnH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,MAAM,IAAI,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1G,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,OAAO,CAAC,cAAc,SAAS,wBAAwB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACzF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB,EAAE,OAAgC;IAC3F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACjE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,SAAS;QAC1C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACxF,OAAO,CAAC,kBAAkB,MAAM,CAAC,GAAG,sDAAsD,CAAC,CAAC;YAC5F,SAAS;QACX,CAAC;QACD,sHAAsH;QACtH,gGAAgG;QAChG,MAAM,QAAQ,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7F,MAAM,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;QACD,IAAI,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;YAC7D,OAAO,CAAC,kBAAkB,MAAM,CAAC,GAAG,gCAAgC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/exit-codes.d.ts

@@ -0,0 +1,2 @@
+export { ExitCode, EXIT_CODES as EXIT_CODE_TABLE } from '@baizor/gamedev-cli-core';
+export type { ExitCodeValue } from '@baizor/gamedev-cli-core';

package/dist/utils/exit-codes.js

@@ -0,0 +1,4 @@
+// Process exit codes shared by godot-cli, unity-mcp-cli and unreal-mcp-cli: the contract lives in
+// @baizor/gamedev-cli-core.
+export { ExitCode, EXIT_CODES as EXIT_CODE_TABLE } from '@baizor/gamedev-cli-core';
+//# sourceMappingURL=exit-codes.js.map

package/dist/utils/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,4BAA4B;AAE5B,OAAO,EAAE,QAAQ,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/utils/godot-process.d.ts

@@ -8,3 +8,8 @@ export interface GodotProcess {
  * Returns process info if found, null otherwise.
  */
 export declare function findGodotProcess(projectPath: string): GodotProcess | null;
+/**
+ * Windows: the PIDs of a process's direct Godot children (the `_console` wrapper's editor; not its conhost).
+ * Empty elsewhere or on error.
+ */
+export declare function childProcessIds(pid: number): number[];

package/dist/utils/godot-process.js

@@ -36,6 +36,22 @@ export function findGodotProcess(projectPath) {
     verbose(`No Godot process found for project: ${projectPath}`);
     return null;
 }
+/**
+ * Windows: the PIDs of a process's direct Godot children (the `_console` wrapper's editor; not its conhost).
+ * Empty elsewhere or on error.
+ */
+export function childProcessIds(pid) {
+    if (platform() !== 'win32')
+        return [];
+    try {
+        const filter = `ParentProcessId=${pid} AND Name LIKE '%godot%'`;
+        const out = execFileSync('powershell.exe', ['-NoProfile', '-Command', `(Get-CimInstance Win32_Process -Filter "${filter}").ProcessId`], { encoding: 'utf-8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] });
+        return out.split(/\s+/).map((s) => parseInt(s, 10)).filter((n) => Number.isFinite(n) && n > 0);
+    }
+    catch {
+        return [];
+    }
+}
 /**
  * List all running Godot editor processes with their project paths. Matches
  * any process whose name contains "godot" (covers `Godot.exe`, `Godot_mono.exe`,

package/dist/utils/godot-process.js.map

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

package/dist/utils/godot-shutdown.d.ts

@@ -8,7 +8,9 @@ export declare function isProcessAlive(pid: number, os?: SupportedPlatform): boo
  */
 export declare function sendGracefulShutdown(pid: number, os?: SupportedPlatform): boolean;
 /** Hard-kill the process. SIGKILL on POSIX; `taskkill /F` on Windows. */
-export declare function sendForceKill(pid: number, os?: SupportedPlatform): boolean;
+export declare function sendForceKill(pid: number, os?: SupportedPlatform, 
+/** Windows: also its child processes (`/T`) — for the `_console` wrapper, whose child is the editor itself. */
+tree?: boolean): boolean;
 /**
  * Poll for the process to exit, up to `timeoutMs`. Resolves true when the
  * process is gone, false on timeout.

package/dist/utils/godot-shutdown.js

@@ -37,10 +37,12 @@ export function sendGracefulShutdown(pid, os = platform()) {
     }
 }
 /** Hard-kill the process. SIGKILL on POSIX; `taskkill /F` on Windows. */
-export function sendForceKill(pid, os = platform()) {
+export function sendForceKill(pid, os = platform(), 
+/** Windows: also its child processes (`/T`) — for the `_console` wrapper, whose child is the editor itself. */
+tree = false) {
     try {
         if (os === 'win32') {
-            execFileSync('taskkill', ['/PID', String(pid), '/F'], { encoding: 'utf-8', timeout: 5000, stdio: 'pipe' });
+            execFileSync('taskkill', tree ? ['/PID', String(pid), '/T', '/F'] : ['/PID', String(pid), '/F'], { encoding: 'utf-8', timeout: 5000, stdio: 'pipe' });
             return true;
         }
         process.kill(pid, 'SIGKILL');

package/dist/utils/godot-shutdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"godot-shutdown.js","sourceRoot":"","sources":["../../src/utils/godot-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAI9B,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,KAAwB,QAAQ,EAAuB;IACjG,IAAI,CAAC;QACH,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE;gBACpE,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,gEAAgE;QAChE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAW,EACX,KAAwB,QAAQ,EAAuB;IAEvD,IAAI,CAAC;QACH,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,YAAY,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACrG,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,KAAwB,QAAQ,EAAuB;IAEvD,IAAI,CAAC;QACH,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,YAAY,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3G,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,SAAiB,EACjB,KAAwB,QAAQ,EAAuB;IAEvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,CAAC;IACrB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"godot-shutdown.js","sourceRoot":"","sources":["../../src/utils/godot-shutdown.ts"],"names":[],"mappings":"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"}

package/dist/utils/input.d.ts

@@ -3,7 +3,7 @@ export interface InputOptions {
     inputFile?: string;
 }
 /**
- * Parse tool input from --input, --input-file, or stdin.
+ * Parse tool input from --input, --input-file, or stdin. Bad input is a usage error (exit 2).
  *
  * - `--input-file -` or `--input-file /dev/stdin` reads from stdin (cross-platform).
  * - `--input-file <path>` reads from a file.
@@ -11,5 +11,5 @@ export interface InputOptions {
  * - Falls back to `{}` if nothing provided.
  */
 export declare function parseInput(options: InputOptions): string;
-/** A whole-number flag value (commander supplies the default as text), or exit with an error. */
-export declare function parsePositiveIntFlag(raw: string, flagName: string, allowZero?: boolean): number;
+/** Commander accumulator for a repeatable option. */
+export declare function collect(value: string, previous: string[]): string[];

package/dist/utils/input.js

@@ -1,10 +1,14 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import * as ui from './ui.js';
 import { verbose } from './ui.js';
-import { parseJsonStrict, JsonParseError } from './json-parse.js';
+import { parseJsonStrict, JsonParseError } from '@baizor/gamedev-cli-core';
+import { ExitCode } from './exit-codes.js';
+import { exitWithError } from './output.js';
+function usage(message) {
+    return exitWithError(ExitCode.Usage, 'USAGE', message);
+}
 /**
- * Parse tool input from --input, --input-file, or stdin.
+ * Parse tool input from --input, --input-file, or stdin. Bad input is a usage error (exit 2).
  *
  * - `--input-file -` or `--input-file /dev/stdin` reads from stdin (cross-platform).
  * - `--input-file <path>` reads from a file.
@@ -21,34 +25,28 @@ export function parseInput(options) {
                 content = fs.readFileSync(0, 'utf-8');
             }
             catch {
-                ui.error('Failed to read from stdin.');
-                process.exit(1);
-            }
-            if (!content.trim()) {
-                ui.error('No input received from stdin.');
-                process.exit(1);
+                usage('Failed to read from stdin.');
             }
+            if (!content.trim())
+                usage('No input received from stdin.');
         }
         else {
             const filePath = path.resolve(options.inputFile);
-            if (!fs.existsSync(filePath)) {
-                ui.error(`Input file does not exist: ${filePath}`);
-                process.exit(1);
+            if (!fs.existsSync(filePath))
+                usage(`Input file does not exist: ${filePath}`);
+            try {
+                content = fs.readFileSync(filePath, 'utf-8');
+            }
+            catch (err) {
+                usage(`Cannot read --input-file ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
             }
-            content = fs.readFileSync(filePath, 'utf-8');
         }
         try {
             parseJsonStrict(content);
         }
         catch (err) {
             const source = isStdin ? 'stdin' : options.inputFile;
-            if (err instanceof JsonParseError) {
-                ui.error(`--input-file content from '${source}' must be valid JSON\n${err.message}`);
-            }
-            else {
-                ui.error(`--input-file content from '${source}' must be valid JSON`);
-            }
-            process.exit(1);
+            usage(`--input-file content from '${source}' must be valid JSON` + (err instanceof JsonParseError ? `\n${err.message}` : ''));
         }
         return content;
     }
@@ -58,24 +56,13 @@ export function parseInput(options) {
             return result.raw;
         }
         catch (err) {
-            if (err instanceof JsonParseError) {
-                ui.error(`--input must be valid JSON\n${err.message}`);
-            }
-            else {
-                ui.error('--input must be valid JSON');
-            }
-            process.exit(1);
+            usage('--input must be valid JSON' + (err instanceof JsonParseError ? `\n${err.message}` : ''));
         }
     }
     return '{}';
 }
-/** A whole-number flag value (commander supplies the default as text), or exit with an error. */
-export function parsePositiveIntFlag(raw, flagName, allowZero = false) {
-    const value = Number(raw);
-    if (!Number.isInteger(value) || value < 0 || (value === 0 && !allowZero)) {
-        ui.error(`${flagName} must be a ${allowZero ? 'non-negative' : 'positive'} whole number, got "${raw}"`);
-        process.exit(1);
-    }
-    return value;
+/** Commander accumulator for a repeatable option. */
+export function collect(value, previous) {
+    return [...previous, value];
 }
 //# sourceMappingURL=input.js.map

package/dist/utils/input.js.map

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

package/dist/utils/output.d.ts

@@ -0,0 +1,45 @@
+import type { Command } from 'commander';
+import { CommandOutput as ContractOutput, type EnvelopeError as ContractEnvelopeError, type OutputFormat } from '@baizor/gamedev-cli-core';
+import { type ExitCodeValue } from './exit-codes.js';
+export { CommandExit, OUTPUT_FORMATS, formatFromArgv } from '@baizor/gamedev-cli-core';
+export type { OutputFormat } from '@baizor/gamedev-cli-core';
+/** Upper-snake error codes of the envelope. */
+export type ErrorCode = 'USAGE' | 'TOOL_FAILED' | 'UNREACHABLE' | 'TIMEOUT' | 'BUSY' | 'AWAITING_INPUT' | 'TESTS_FAILED' | 'TEST_RUN_ERROR' | 'COMPILATION_FAILED' | 'SCRIPT_ERRORS' | 'IMPORT_FAILED' | 'PROJECT_OPEN' | 'NOT_FOUND' | 'EXPORT_FAILED' | 'NOT_AUTHENTICATED' | 'ERROR';
+/** One envelope error (`{code, message, httpStatus?}`): the shared contract's, with this CLI's codes. */
+export type EnvelopeError = ContractEnvelopeError<ErrorCode>;
+/** Add `--format` to a command. `extra` lists command-specific formats (e.g. `github`). */
+export declare function addFormatOption(cmd: Command, extra?: readonly string[]): Command;
+/**
+ * The output of one command run. Created at the start of an action; in json/ndjson it switches `ui` to stderr so
+ * stdout carries only the envelope. Exactly one `finish` per run.
+ */
+export declare class CommandOutput<F extends string = OutputFormat> extends ContractOutput<ErrorCode> {
+    readonly format: F;
+    constructor(command: string, format: F);
+    /** A progress line: ndjson event on stderr, plain stderr line in json, `ui.info` in text. */
+    progress(message: string): void;
+    /**
+     * Emit the envelope (machine formats) and end the command. Text output is the caller's job before calling this.
+     * The process exits once stdout is flushed; until then a `CommandExit` unwinds the action.
+     */
+    finish(exitCode: ExitCodeValue, data?: unknown, errors?: EnvelopeError[]): never;
+    /** Fail with one error: printed with `ui.error` in text, in the envelope otherwise. */
+    fail(exitCode: ExitCodeValue, code: ErrorCode, message: string, data?: unknown): never;
+}
+/**
+ * An unexpected error escaped a command: report it through the active command's envelope (exit 1) when one runs
+ * in a machine format. Returns false when there is none (the caller prints it).
+ */
+export declare function failActive(err: unknown): boolean;
+/**
+ * Exit from a shared helper (path / input validation): through the active command's envelope when one runs in a
+ * machine format, else `ui.error`.
+ */
+export declare function exitWithError(exitCode: ExitCodeValue, code: ErrorCode, message: string): never;
+/**
+ * Parse a `--format` value. An unknown value is a usage error (exit 2), reported in text since the format itself
+ * is what is wrong.
+ */
+export declare function parseFormat<F extends string = never>(raw: string | undefined, extra?: readonly F[]): OutputFormat | F;
+/** Parse a positive (or, with `allowZero`, non-negative) whole-number flag, or exit 2. */
+export declare function parseIntFlag(raw: string | undefined, flagName: string, allowZero?: boolean): number;

package/dist/utils/output.js

@@ -0,0 +1,101 @@
+// `--format text|json|ndjson` output contract shared by godot-cli, unity-mcp-cli and unreal-mcp-cli (it lives in
+// @baizor/gamedev-cli-core).
+//
+// json:   stdout carries exactly one pretty-printed envelope; every human-readable line goes to stderr.
+// ndjson: progress lines `{"type":"progress",...}` on stderr, the envelope as one line on stdout.
+// text:   the usual human output.
+import { CommandOutput as ContractOutput, OUTPUT_FORMATS, UsageError, activeCommandOutput, exitAfterFlush, parseFormat as parseContractFormat, } from '@baizor/gamedev-cli-core';
+import * as ui from './ui.js';
+import { ExitCode } from './exit-codes.js';
+export { CommandExit, OUTPUT_FORMATS, formatFromArgv } from '@baizor/gamedev-cli-core';
+/** Add `--format` to a command. `extra` lists command-specific formats (e.g. `github`). */
+export function addFormatOption(cmd, extra = []) {
+    const formats = [...OUTPUT_FORMATS, ...extra].join('|');
+    return cmd.option('--format <format>', `Output format: ${formats}`, 'text');
+}
+/**
+ * The output of one command run. Created at the start of an action; in json/ndjson it switches `ui` to stderr so
+ * stdout carries only the envelope. Exactly one `finish` per run.
+ */
+export class CommandOutput extends ContractOutput {
+    constructor(command, format) {
+        super(command, format);
+        // ndjson: every human line on stderr is an event too, so stderr stays parseable line by line.
+        ui.setMachineOutput(this.machine, format === 'ndjson'
+            ? (level, message) => JSON.stringify({ type: 'log', command, level, message })
+            : undefined);
+    }
+    /** A progress line: ndjson event on stderr, plain stderr line in json, `ui.info` in text. */
+    progress(message) {
+        if (this.format === 'ndjson')
+            super.progress(message);
+        else if (this.format === 'json')
+            process.stderr.write(message + '\n');
+        else
+            ui.info(message);
+    }
+    /**
+     * Emit the envelope (machine formats) and end the command. Text output is the caller's job before calling this.
+     * The process exits once stdout is flushed; until then a `CommandExit` unwinds the action.
+     */
+    finish(exitCode, data = null, errors = []) {
+        for (const err of errors)
+            this.record(err.code, err.message, err.httpStatus);
+        this.emit(exitCode, data);
+        exitAfterFlush(exitCode);
+    }
+    /** Fail with one error: printed with `ui.error` in text, in the envelope otherwise. */
+    fail(exitCode, code, message, data = null) {
+        if (!this.machine)
+            ui.error(message);
+        return this.finish(exitCode, data, [{ code, message }]);
+    }
+}
+/** The godot-cli output of the command being run, if one was created. */
+function active() {
+    const output = activeCommandOutput();
+    return output instanceof CommandOutput ? output : undefined;
+}
+/**
+ * An unexpected error escaped a command: report it through the active command's envelope (exit 1) when one runs
+ * in a machine format. Returns false when there is none (the caller prints it).
+ */
+export function failActive(err) {
+    const output = active();
+    if (!output?.machine)
+        return false;
+    return output.fail(ExitCode.Error, 'ERROR', err instanceof Error ? err.message : String(err));
+}
+/**
+ * Exit from a shared helper (path / input validation): through the active command's envelope when one runs in a
+ * machine format, else `ui.error`.
+ */
+export function exitWithError(exitCode, code, message) {
+    active()?.fail(exitCode, code, message);
+    ui.error(message);
+    process.exit(exitCode);
+}
+/**
+ * Parse a `--format` value. An unknown value is a usage error (exit 2), reported in text since the format itself
+ * is what is wrong.
+ */
+export function parseFormat(raw, extra = []) {
+    try {
+        return parseContractFormat(raw, extra);
+    }
+    catch (err) {
+        if (!(err instanceof UsageError))
+            throw err;
+        ui.error(err.message);
+        process.exit(ExitCode.Usage);
+    }
+}
+/** Parse a positive (or, with `allowZero`, non-negative) whole-number flag, or exit 2. */
+export function parseIntFlag(raw, flagName, allowZero = false) {
+    const value = Number(raw);
+    if (raw === undefined || raw.trim() === '' || !Number.isInteger(value) || value < 0 || (value === 0 && !allowZero)) {
+        exitWithError(ExitCode.Usage, 'USAGE', `Invalid ${flagName} value: "${raw}". Must be a ${allowZero ? 'non-negative' : 'positive'} whole number.`);
+    }
+    return value;
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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

package/dist/utils/server-source.d.ts

@@ -5,7 +5,7 @@
  * download entirely (offline / CI). Bumping the addon's server pin requires
  * bumping this in the same PR or the parity test goes red.
  */
-export declare const DEFAULT_SERVER_VERSION = "9.4.4";
+export declare const DEFAULT_SERVER_VERSION = "9.5.0";
 /** GitHub-release host the server zip + manifest are downloaded from. NOTHING else is trusted. */
 export declare const TRUSTED_DOWNLOAD_HOST = "github.com";
 /** The `owner/repo` the shared server releases live under. */

package/dist/utils/server-source.js

@@ -18,7 +18,7 @@ import { createHash } from 'crypto';
  * download entirely (offline / CI). Bumping the addon's server pin requires
  * bumping this in the same PR or the parity test goes red.
  */
-export const DEFAULT_SERVER_VERSION = '9.4.4';
+export const DEFAULT_SERVER_VERSION = '9.5.0';
 /** GitHub-release host the server zip + manifest are downloaded from. NOTHING else is trusted. */
 export const TRUSTED_DOWNLOAD_HOST = 'github.com';
 /** The `owner/repo` the shared server releases live under. */

package/dist/utils/skill-guides.d.ts

@@ -1,16 +1,13 @@
-export declare const CLI_SKILL_NAME = "godot-cli";
-export declare const APP_SKILL_NAME = "ai-game-dev-app";
-export declare const APP_SKILL_DESCRIPTION = "AI Game Dev App: image, texture, 3D model, audio and video generation; animation, rigging, Blender, music and sound effects. Consult when a game-development task needs creative tools unavailable in the current environment, or an integrated workflow for Unity, Unreal Engine or Godot.";
-export declare const CLI_SKILL_DESCRIPTION = "Install and use godot-cli: Node.js requirements, npm installation, npx, tool calls, JSON input files and troubleshooting.";
+/** Skill folders earlier versions generated from a hand-written catalog (`godot-mcp`, `godot-mcp-<family>`). */
+export declare function isRetiredSkillName(name: string): boolean;
 export declare const SKILL_METADATA: {
     readonly 'generated-by': "godot-mcp";
     readonly 'ai-game-dev': "exclude";
 };
-export declare function skillMetadataLines(): string[];
-export declare const SKILL_REFERENCES = "> CLI installation and usage: see the `godot-cli` skill.\n> If this task needs unavailable asset-generation or Blender tools, consult `ai-game-dev-app` for an optional integrated workflow.\n";
-export declare function buildCliGuide(platform?: NodeJS.Platform): string;
-export declare const CLI_GUIDE: string;
-export declare const APP_GUIDE: string;
+/** What each failing exit code asks of the agent (0 and 1 need nothing). A test keeps the codes in the core contract. */
+export declare const EXIT_CODE_ACTIONS: Readonly<Record<number, string>>;
+export declare function buildInstallGuide(platform?: NodeJS.Platform): string;
+/** Every file `setup-skills` writes, relative to the agent's skills folder. Pure and deterministic. */
 export declare function buildGuideFiles(platform?: NodeJS.Platform): {
     relativePath: string;
     content: string;