unity-mcp-cli 0.66.1 → 0.67.0

package/README.md

@@ -96,6 +96,7 @@ npx unity-mcp-cli install-plugin /path/to/unity/project
   - [`install-plugin`](#install-plugin)
   - [`install-unity`](#install-unity)
   - [`open`](#open)
+  - [`close`](#close)
   - [`run-tool`](#run-tool)
   - [`wait-for-ready`](#wait-for-ready)
   - [`setup-mcp`](#setup-mcp)
@@ -283,6 +284,48 @@ unity-mcp-cli open ./MyGame \
 
 ![AI Game Developer — Unity SKILLS and MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
 
+## `close`
+
+Gracefully terminate the Unity Editor instance running for a given project path. Symmetric counterpart of [`open`](#open) — for scripted workflows (CI agents, pipeline executors, integration test fixtures) that need a clean tear-down without resorting to OS-level process kills.
+
+```bash
+unity-mcp-cli close ./MyGame
+```
+
+| Option | Required | Description |
+|---|---|---|
+| `[path]` | No | Path to the Unity project (positional, defaults to current directory) |
+| `--timeout <seconds>` | No | Polite-quit timeout in seconds (default: 30) |
+| `--force` | No | Hard-kill the Editor if it does not exit within `--timeout` |
+
+**How it works:**
+
+1. Resolves the running Editor's PID by reading `<project>/Temp/UnityLockfile` (4-byte little-endian uint32) and cross-checking against process enumeration to handle stale lock files.
+2. Sends a polite-quit signal — `SIGTERM` on Linux/macOS, `taskkill` (no `/F`) on Windows — letting Unity finish autosave / asset-import.
+3. Polls every 250ms until the process exits or `--timeout` elapses.
+4. If the timeout expires AND `--force` is set, falls back to `SIGKILL` / `taskkill /F`.
+5. Idempotent — closing an already-closed Editor (or a project whose Editor was never running) exits 0 with `no running Editor for project at <path>`.
+6. Refuses to act on any path that is not a Unity project root (`ProjectSettings/ProjectVersion.txt` must exist) — protects against accidental kill-all-Unity-on-host invocations.
+
+> **Windows headless caveat:** the polite-quit step uses `taskkill` (no `/F`), which delivers `WM_CLOSE`. That message only reaches processes owning a top-level window on the **same desktop/session** as the CLI. If Unity was launched by a Windows service in session 0 (or any other non-interactive desktop), the polite-quit will be silently dropped, the `--timeout` will elapse, and `--force` becomes the only path that brings the Editor down. Plan accordingly in headless CI runners.
+
+**Example — close, fall back to force after 60s:**
+
+```bash
+unity-mcp-cli close ./MyGame --timeout 60 --force
+```
+
+**Example — clean tear-down at the end of an automation script:**
+
+```bash
+unity-mcp-cli open ./MyGame
+unity-mcp-cli wait-for-ready ./MyGame
+unity-mcp-cli run-tool tests-run ./MyGame --input '{"testMode":"EditMode"}'
+unity-mcp-cli close ./MyGame
+```
+
+![AI Game Developer — Unity SKILLS and MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
+
 ## `run-tool`
 
 Execute an MCP tool directly via the HTTP API. The server URL and authorization token are **automatically resolved** from the project's config file (`UserSettings/AI-Game-Developer-Config.json`), based on the current connection mode (Custom or Cloud).

package/dist/commands/close.d.ts

@@ -0,0 +1,56 @@
+import { Command } from 'commander';
+import { type SupportedPlatform } from '../utils/unity-shutdown.js';
+export interface CloseOptions {
+    timeout?: string;
+    force?: boolean;
+}
+/**
+ * Resolve the project path argument to an absolute, canonical path.
+ *
+ * Mirrors the convention used by `open` / `wait-for-ready` — accepts a
+ * positional argument or `process.cwd()` fallback, normalises symlinks where
+ * possible, and trims any trailing path separator. Exported for unit tests.
+ */
+export declare function resolveCloseProjectPath(positionalPath: string | undefined, cwd: string): string;
+/**
+ * Returns true when `<projectPath>/ProjectSettings/ProjectVersion.txt` exists.
+ *
+ * The issue's acceptance criteria require refusing to act on any path that
+ * does not look like a Unity project root (`ProjectVersion.txt` is the
+ * canonical marker). This is intentionally narrower than the `open`
+ * subcommand's check — the goal here is to defend against accidental
+ * "kill all Unity processes on host" invocations, so a positive ID of
+ * "this is a Unity project" is required.
+ *
+ * Exported for unit tests.
+ */
+export declare function isUnityProjectRoot(projectPath: string): boolean;
+/**
+ * Parse a positive-integer `--timeout` value (seconds). Returns the parsed
+ * value, or `null` when the input is not a valid positive integer.
+ *
+ * The `undefined` branch falls back to the default for ergonomic
+ * direct-call use (e.g., unit tests). The action handler never reaches it
+ * because commander always materialises the configured default string.
+ *
+ * Exported for unit tests.
+ */
+export declare function parseTimeoutSeconds(raw: string | undefined): number | null;
+/**
+ * Resolve the editor PID for a given project path.
+ *
+ * Reads `<project>/Temp/UnityLockfile` (4 bytes LE uint32) and enumerates
+ * Unity processes by command line, then prefers the lockfile PID when it
+ * is alive and matches the enumerated process for this project (handles
+ * stale lockfiles); otherwise uses the enumerated PID.
+ *
+ * Symlink/realpath handling: `resolveCloseProjectPath` canonicalises via
+ * `realpathSync` while `findUnityProcess` only `path.resolve`s the cmdline
+ * `-projectPath` argument. If Unity was launched via a symlink, the first
+ * lookup misses. We retry against the un-canonicalised form so a symlinked
+ * launch path doesn't silently degrade close to a no-op.
+ *
+ * Returns `null` when no live editor matches the project. Exported for tests.
+ */
+export declare function resolveEditorPid(projectPath: string, platform?: SupportedPlatform): number | null;
+export declare const closeCommand: Command;

package/dist/commands/close.js

@@ -0,0 +1,186 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { platform as nodePlatform } from 'os';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { findUnityProcess } from '../utils/unity-process.js';
+import { readLockfilePid, isProcessAlive, sendGracefulShutdown, sendForceKill, waitForExit, } from '../utils/unity-shutdown.js';
+const DEFAULT_TIMEOUT_SECONDS = 30;
+/**
+ * Resolve the project path argument to an absolute, canonical path.
+ *
+ * Mirrors the convention used by `open` / `wait-for-ready` — accepts a
+ * positional argument or `process.cwd()` fallback, normalises symlinks where
+ * possible, and trims any trailing path separator. Exported for unit tests.
+ */
+export function resolveCloseProjectPath(positionalPath, cwd) {
+    const explicit = positionalPath ?? cwd;
+    let resolved = path.resolve(explicit);
+    // realpathSync collapses symlinks, ".." segments, and trailing separators
+    // when the path exists. When it does not, fall through to the resolved
+    // form so the caller can produce a "path does not exist" error.
+    try {
+        resolved = fs.realpathSync(resolved);
+    }
+    catch {
+        // Path may not exist — let the caller decide what to do.
+    }
+    return resolved;
+}
+/**
+ * Returns true when `<projectPath>/ProjectSettings/ProjectVersion.txt` exists.
+ *
+ * The issue's acceptance criteria require refusing to act on any path that
+ * does not look like a Unity project root (`ProjectVersion.txt` is the
+ * canonical marker). This is intentionally narrower than the `open`
+ * subcommand's check — the goal here is to defend against accidental
+ * "kill all Unity processes on host" invocations, so a positive ID of
+ * "this is a Unity project" is required.
+ *
+ * Exported for unit tests.
+ */
+export function isUnityProjectRoot(projectPath) {
+    return fs.existsSync(path.join(projectPath, 'ProjectSettings', 'ProjectVersion.txt'));
+}
+/**
+ * Parse a positive-integer `--timeout` value (seconds). Returns the parsed
+ * value, or `null` when the input is not a valid positive integer.
+ *
+ * The `undefined` branch falls back to the default for ergonomic
+ * direct-call use (e.g., unit tests). The action handler never reaches it
+ * because commander always materialises the configured default string.
+ *
+ * Exported for unit tests.
+ */
+export function parseTimeoutSeconds(raw) {
+    if (raw === undefined)
+        return DEFAULT_TIMEOUT_SECONDS;
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed <= 0)
+        return null;
+    return parsed;
+}
+/**
+ * Resolve the editor PID for a given project path.
+ *
+ * Reads `<project>/Temp/UnityLockfile` (4 bytes LE uint32) and enumerates
+ * Unity processes by command line, then prefers the lockfile PID when it
+ * is alive and matches the enumerated process for this project (handles
+ * stale lockfiles); otherwise uses the enumerated PID.
+ *
+ * Symlink/realpath handling: `resolveCloseProjectPath` canonicalises via
+ * `realpathSync` while `findUnityProcess` only `path.resolve`s the cmdline
+ * `-projectPath` argument. If Unity was launched via a symlink, the first
+ * lookup misses. We retry against the un-canonicalised form so a symlinked
+ * launch path doesn't silently degrade close to a no-op.
+ *
+ * Returns `null` when no live editor matches the project. Exported for tests.
+ */
+export function resolveEditorPid(projectPath, platform = nodePlatform()) {
+    const lockPid = readLockfilePid(projectPath);
+    // Enumerate Unity processes once. `findUnityProcess` shells out (3s timeout
+    // on Windows via PowerShell+CIM, 5s on POSIX via `ps`), so calling it twice
+    // on the stale-lockfile path used to roughly double close latency.
+    let proc = findUnityProcess(projectPath);
+    // Symlink fallback: if the canonical realpath form found no process, retry
+    // with `path.resolve` only (no realpath collapse) — that matches what
+    // `findUnityProcess` derives from the cmdline `-projectPath` argument.
+    if (!proc) {
+        const resolvedNoRealpath = path.resolve(projectPath);
+        if (resolvedNoRealpath !== projectPath) {
+            proc = findUnityProcess(resolvedNoRealpath);
+        }
+    }
+    if (lockPid !== null && isProcessAlive(lockPid, platform)) {
+        if (proc && proc.pid === lockPid) {
+            verbose(`Lockfile PID ${lockPid} confirmed via process enumeration`);
+            return lockPid;
+        }
+        // Lockfile alive but no matching enumerated process — the lockfile may
+        // still be authoritative if the asymmetry is purely realpath/symlink
+        // related (process listed under symlink path while we queried by realpath).
+        // Trust the live lockfile PID in that case rather than discarding it.
+        if (!proc) {
+            verbose(`Lockfile PID ${lockPid} alive but no enumerated match — using lockfile PID (likely symlink/path mismatch)`);
+            return lockPid;
+        }
+        verbose(`Lockfile PID ${lockPid} did not match enumerated Unity process for project — treating as stale`);
+    }
+    return proc ? proc.pid : null;
+}
+export const closeCommand = new Command('close')
+    .description('Gracefully terminate the Unity Editor instance running for a given project path')
+    .argument('[path]', 'Path to the Unity project (defaults to current directory)')
+    .option('--timeout <seconds>', `Polite-quit timeout in seconds (default: ${DEFAULT_TIMEOUT_SECONDS})`, String(DEFAULT_TIMEOUT_SECONDS))
+    .option('--force', 'Hard-kill the Editor if it does not exit within --timeout')
+    .action(async (positionalPath, options) => {
+    const projectPath = resolveCloseProjectPath(positionalPath, process.cwd());
+    verbose(`close invoked for project: ${projectPath}`);
+    if (!fs.existsSync(projectPath)) {
+        ui.error(`Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    if (!isUnityProjectRoot(projectPath)) {
+        ui.error(`Not a Unity project root: ${projectPath}`);
+        process.exit(1);
+    }
+    const timeoutSeconds = parseTimeoutSeconds(options.timeout);
+    if (timeoutSeconds === null) {
+        ui.error(`Invalid --timeout value: "${options.timeout}". Must be a positive integer (seconds).`);
+        process.exit(1);
+    }
+    const platform = nodePlatform();
+    const pid = resolveEditorPid(projectPath, platform);
+    if (pid === null) {
+        ui.success(`no running Editor for project at ${projectPath}`);
+        process.exit(0);
+    }
+    ui.heading('Closing Unity Editor');
+    ui.label('Project', projectPath);
+    ui.label('PID', String(pid));
+    ui.label('Timeout', `${timeoutSeconds}s`);
+    ui.label('Force', options.force ? 'yes' : 'no');
+    ui.divider();
+    // TOCTOU window: between resolveEditorPid returning and the signal call
+    // below, the original Unity process could exit and the OS could reuse
+    // the same numeric PID for an unrelated process (more likely on POSIX,
+    // where PIDs cycle aggressively). We accept the residual risk — the
+    // lockfile cross-check above already narrows it, holding a lock across
+    // a spawned Editor's lifetime is impractical, and the signals we send
+    // (SIGTERM / WM_CLOSE) are best-effort, not destructive.
+    const spinner = ui.startSpinner(`Sending polite-quit to PID ${pid}...`);
+    const sent = sendGracefulShutdown(pid, platform);
+    if (!sent) {
+        spinner.error(`Failed to deliver polite-quit signal to PID ${pid}`);
+        process.exit(1);
+    }
+    spinner.text = `Waiting up to ${timeoutSeconds}s for PID ${pid} to exit...`;
+    const timeoutMs = timeoutSeconds * 1000;
+    const exited = await waitForExit(pid, timeoutMs, platform);
+    if (exited) {
+        spinner.success(`Unity Editor (PID ${pid}) exited cleanly`);
+        process.exit(0);
+    }
+    if (!options.force) {
+        spinner.error(`Unity Editor (PID ${pid}) did not exit within ${timeoutSeconds}s. ` +
+            `Re-run with --force to hard-kill, or close it manually.`);
+        process.exit(1);
+    }
+    spinner.text = `Force-killing PID ${pid}...`;
+    const killed = sendForceKill(pid, platform);
+    if (!killed) {
+        spinner.error(`Failed to force-kill PID ${pid}`);
+        process.exit(1);
+    }
+    // Brief secondary wait so we report a true terminal state — the OS may
+    // need a moment to reap the process even after SIGKILL / `taskkill /F`.
+    const reaped = await waitForExit(pid, 5000, platform);
+    if (reaped) {
+        spinner.success(`Unity Editor (PID ${pid}) force-killed`);
+        process.exit(0);
+    }
+    spinner.error(`Unity Editor (PID ${pid}) is still alive after force-kill`);
+    process.exit(1);
+});
+//# sourceMappingURL=close.js.map

package/dist/commands/close.js.map

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

package/dist/index.js

@@ -1,6 +1,7 @@
 import { Command } from 'commander';
 import { createRequire } from 'module';
 import { bootstrapLocalCommand } from './commands/bootstrap-local.js';
+import { closeCommand } from './commands/close.js';
 import { createProjectCommand } from './commands/create-project.js';
 import { installUnityCommand } from './commands/install-unity.js';
 import { openCommand } from './commands/open.js';
@@ -28,6 +29,7 @@ program
 // Register all subcommands
 const subcommands = [
     bootstrapLocalCommand,
+    closeCommand,
     configureCommand,
     createProjectCommand,
     installPluginCommand,

package/dist/index.js.map

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

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

@@ -0,0 +1,87 @@
+/**
+ * Supported Node.js `process.platform` values for the close subcommand.
+ * Narrowed alias of NodeJS.Platform — keeps signal-selection logic exhaustive
+ * in tests without forcing callers to import a Node-internal type.
+ */
+export type SupportedPlatform = 'win32' | 'darwin' | 'linux';
+/**
+ * The polite-quit "graceful shutdown" signal for the current platform.
+ *
+ * - Linux / macOS: `SIGTERM` — Unity catches this and runs its normal exit
+ *   path (autosave, asset-import finalisation, plugin disconnect).
+ * - Windows: `WM_CLOSE` via `taskkill` (no `/F`) — same idea, sent through
+ *   `taskkill /PID <pid>` in the runtime helper. We return the string
+ *   sentinel `WM_CLOSE` here so the call site can branch on it.
+ *
+ * Exposed as a pure function so the unit test suite can assert the platform
+ * matrix without booting an editor.
+ */
+export declare function gracefulShutdownSignal(platform: SupportedPlatform): NodeJS.Signals | 'WM_CLOSE';
+/**
+ * The hard-kill signal for the current platform.
+ *
+ * - Linux / macOS: `SIGKILL`.
+ * - Windows: `taskkill /F` — represented here by the sentinel `TASKKILL_FORCE`.
+ */
+export declare function forceKillSignal(platform: SupportedPlatform): NodeJS.Signals | 'TASKKILL_FORCE';
+/**
+ * Read the editor PID stored in `<project>/Temp/UnityLockfile`.
+ *
+ * Unity writes the running editor's PID into the first 4 bytes of this file
+ * as a little-endian uint32 the moment it acquires the project lock. Returns
+ * `null` when the lockfile is missing, too small, or holds a zero/negative PID.
+ *
+ * The caller is responsible for cross-checking the PID against a live process
+ * list — stale lockfiles can survive an unclean editor exit.
+ */
+export declare function readLockfilePid(projectPath: string): number | null;
+/**
+ * Returns true when a process with the given PID is alive.
+ *
+ * Both platforms first try `process.kill(pid, 0)` — Node maps it through
+ * `OpenProcess` on Windows, so the check is in-process and effectively free
+ * compared to spawning `tasklist`. At a 250ms `waitForExit` cadence with a
+ * 30s default timeout that's ~120 fewer subprocesses per close on Windows.
+ *
+ * The Windows fallback to `tasklist` is kept as defence-in-depth: if a
+ * future Node release ever changes behaviour or `OpenProcess` denies access
+ * for a process owned by another session, we still get the right answer
+ * (just more slowly).
+ *
+ * On any failure the function errs on the side of "not running" and returns
+ * false, which keeps the wait loop progressing rather than spinning forever
+ * on a transient error.
+ */
+export declare function isProcessAlive(pid: number, platform?: SupportedPlatform): boolean;
+/**
+ * Send the platform's polite-quit signal to the given PID.
+ *
+ * Returns true on apparent success (the OS accepted the signal); false if the
+ * underlying call threw. The caller still has to poll `isProcessAlive` — the
+ * editor may take seconds to wind down.
+ *
+ * Windows caveat: `taskkill /PID <pid>` (no `/F`) delivers `WM_CLOSE`, which
+ * only reaches processes that own a top-level window on the same desktop /
+ * session as the caller. In headless contexts (Unity launched in session 0
+ * by a Windows service, or another non-interactive desktop) `taskkill` will
+ * exit 0 and this function will report `true`, but the editor will never
+ * receive the message. The `--timeout` will then elapse, and `--force` is
+ * the only path that brings the process down. This is documented in the
+ * close subcommand README and is consistent with the design decision to
+ * stick to OS-level polite-quit (rather than a Unity-side MCP `editor-quit`
+ * tool which would route through SignalR and bypass session walls).
+ */
+export declare function sendGracefulShutdown(pid: number, platform?: SupportedPlatform): boolean;
+/**
+ * Hard-kill the given PID. Used only when `--force` is set and the polite
+ * shutdown timed out.
+ */
+export declare function sendForceKill(pid: number, platform?: SupportedPlatform): boolean;
+/**
+ * Poll until the given PID disappears or the timeout elapses.
+ *
+ * Returns true if the process exited within `timeoutMs`; false otherwise.
+ * Uses a 250ms poll interval — short enough to give crisp UX on a fast exit
+ * without busy-looping.
+ */
+export declare function waitForExit(pid: number, timeoutMs: number, platform?: SupportedPlatform): Promise<boolean>;

package/dist/utils/unity-shutdown.js

@@ -0,0 +1,241 @@
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { platform as nodePlatform } from 'os';
+import { verbose } from './ui.js';
+/**
+ * The polite-quit "graceful shutdown" signal for the current platform.
+ *
+ * - Linux / macOS: `SIGTERM` — Unity catches this and runs its normal exit
+ *   path (autosave, asset-import finalisation, plugin disconnect).
+ * - Windows: `WM_CLOSE` via `taskkill` (no `/F`) — same idea, sent through
+ *   `taskkill /PID <pid>` in the runtime helper. We return the string
+ *   sentinel `WM_CLOSE` here so the call site can branch on it.
+ *
+ * Exposed as a pure function so the unit test suite can assert the platform
+ * matrix without booting an editor.
+ */
+export function gracefulShutdownSignal(platform) {
+    if (platform === 'win32')
+        return 'WM_CLOSE';
+    return 'SIGTERM';
+}
+/**
+ * The hard-kill signal for the current platform.
+ *
+ * - Linux / macOS: `SIGKILL`.
+ * - Windows: `taskkill /F` — represented here by the sentinel `TASKKILL_FORCE`.
+ */
+export function forceKillSignal(platform) {
+    if (platform === 'win32')
+        return 'TASKKILL_FORCE';
+    return 'SIGKILL';
+}
+/**
+ * Read the editor PID stored in `<project>/Temp/UnityLockfile`.
+ *
+ * Unity writes the running editor's PID into the first 4 bytes of this file
+ * as a little-endian uint32 the moment it acquires the project lock. Returns
+ * `null` when the lockfile is missing, too small, or holds a zero/negative PID.
+ *
+ * The caller is responsible for cross-checking the PID against a live process
+ * list — stale lockfiles can survive an unclean editor exit.
+ */
+export function readLockfilePid(projectPath) {
+    const lockfilePath = path.join(projectPath, 'Temp', 'UnityLockfile');
+    if (!fs.existsSync(lockfilePath)) {
+        verbose(`No Unity lockfile at ${lockfilePath}`);
+        return null;
+    }
+    let buf;
+    try {
+        buf = fs.readFileSync(lockfilePath);
+    }
+    catch (err) {
+        verbose(`Failed to read Unity lockfile: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    if (buf.length < 4) {
+        verbose(`Unity lockfile too small (${buf.length} bytes)`);
+        return null;
+    }
+    // `readUInt32LE` always returns a finite integer in [0, 2^32-1], so a
+    // non-positive check is the only meaningful filter here.
+    const pid = buf.readUInt32LE(0);
+    if (pid <= 0) {
+        verbose(`Unity lockfile holds non-positive PID: ${pid}`);
+        return null;
+    }
+    return pid;
+}
+/**
+ * Returns true when a process with the given PID is alive.
+ *
+ * Both platforms first try `process.kill(pid, 0)` — Node maps it through
+ * `OpenProcess` on Windows, so the check is in-process and effectively free
+ * compared to spawning `tasklist`. At a 250ms `waitForExit` cadence with a
+ * 30s default timeout that's ~120 fewer subprocesses per close on Windows.
+ *
+ * The Windows fallback to `tasklist` is kept as defence-in-depth: if a
+ * future Node release ever changes behaviour or `OpenProcess` denies access
+ * for a process owned by another session, we still get the right answer
+ * (just more slowly).
+ *
+ * On any failure the function errs on the side of "not running" and returns
+ * false, which keeps the wait loop progressing rather than spinning forever
+ * on a transient error.
+ */
+export function isProcessAlive(pid, platform = nodePlatform()) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        // EPERM means the process exists but we can't signal it — treat as alive.
+        if (code === 'EPERM')
+            return true;
+        if (code !== 'ESRCH') {
+            // Anything other than ESRCH is unexpected; fall through to the
+            // Windows-only verification path so we don't return a wrong answer
+            // on a transient OS hiccup. POSIX paths just return false.
+            if (platform !== 'win32')
+                return false;
+        }
+    }
+    if (platform !== 'win32')
+        return false;
+    // Windows fallback: `tasklist /FI "PID eq <pid>" /NH /FO CSV`.
+    // The first CSV column is the image name, the second is the PID. Parse
+    // field-wise so a digit run that happens to appear in another column
+    // (image name, session, memory, status) cannot produce a false positive.
+    try {
+        const out = execFileSync('tasklist', ['/FI', `PID eq ${pid}`, '/NH', '/FO', 'CSV'], {
+            encoding: 'utf-8',
+            timeout: 3000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // tasklist prints "INFO: No tasks are running ..." when nothing matches.
+        const target = `"${pid}"`;
+        for (const line of out.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0)
+                continue;
+            // Second CSV field — split on `,` and check column index 1. CSV from
+            // tasklist quotes every field, so a simple split is safe. Image names
+            // with embedded commas would shift the PID into a later column and
+            // produce a false negative; that's an accepted trade-off — Unity
+            // executable names don't contain commas in practice, and any false
+            // negative simply ends the wait loop one tick early.
+            const cols = trimmed.split(',');
+            if (cols.length >= 2 && cols[1] === target)
+                return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Send the platform's polite-quit signal to the given PID.
+ *
+ * Returns true on apparent success (the OS accepted the signal); false if the
+ * underlying call threw. The caller still has to poll `isProcessAlive` — the
+ * editor may take seconds to wind down.
+ *
+ * Windows caveat: `taskkill /PID <pid>` (no `/F`) delivers `WM_CLOSE`, which
+ * only reaches processes that own a top-level window on the same desktop /
+ * session as the caller. In headless contexts (Unity launched in session 0
+ * by a Windows service, or another non-interactive desktop) `taskkill` will
+ * exit 0 and this function will report `true`, but the editor will never
+ * receive the message. The `--timeout` will then elapse, and `--force` is
+ * the only path that brings the process down. This is documented in the
+ * close subcommand README and is consistent with the design decision to
+ * stick to OS-level polite-quit (rather than a Unity-side MCP `editor-quit`
+ * tool which would route through SignalR and bypass session walls).
+ */
+export function sendGracefulShutdown(pid, platform = nodePlatform()) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    const sig = gracefulShutdownSignal(platform);
+    verbose(`Sending graceful shutdown to PID ${pid} via ${sig}`);
+    try {
+        if (sig === 'WM_CLOSE') {
+            execFileSync('taskkill', ['/PID', String(pid)], {
+                timeout: 3000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return true;
+        }
+        process.kill(pid, sig);
+        return true;
+    }
+    catch (err) {
+        // Race: the editor can exit between PID resolution and signal delivery.
+        // POSIX surfaces this as ESRCH; Windows `taskkill` exits non-zero with
+        // "process … not found". The desired end state (process gone) is already
+        // reached, so we re-check liveness and report success when the PID is
+        // truly absent. This preserves close's idempotency contract.
+        if (!isProcessAlive(pid, platform)) {
+            verbose(`Graceful shutdown: PID ${pid} already gone — treating as success`);
+            return true;
+        }
+        verbose(`Graceful shutdown failed: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+/**
+ * Hard-kill the given PID. Used only when `--force` is set and the polite
+ * shutdown timed out.
+ */
+export function sendForceKill(pid, platform = nodePlatform()) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    const sig = forceKillSignal(platform);
+    verbose(`Force-killing PID ${pid} via ${sig}`);
+    try {
+        if (sig === 'TASKKILL_FORCE') {
+            execFileSync('taskkill', ['/F', '/PID', String(pid)], {
+                timeout: 3000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return true;
+        }
+        process.kill(pid, sig);
+        return true;
+    }
+    catch (err) {
+        // Same race as sendGracefulShutdown — the polite-quit path may have
+        // already won between waitForExit's last poll and our SIGKILL call.
+        if (!isProcessAlive(pid, platform)) {
+            verbose(`Force kill: PID ${pid} already gone — treating as success`);
+            return true;
+        }
+        verbose(`Force kill failed: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+/**
+ * Poll until the given PID disappears or the timeout elapses.
+ *
+ * Returns true if the process exited within `timeoutMs`; false otherwise.
+ * Uses a 250ms poll interval — short enough to give crisp UX on a fast exit
+ * without busy-looping.
+ */
+export async function waitForExit(pid, timeoutMs, platform = nodePlatform()) {
+    const pollIntervalMs = 250;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!isProcessAlive(pid, platform)) {
+            return true;
+        }
+        await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+    }
+    // One last check after the deadline elapses — the process may have exited
+    // in the trailing poll-interval slice we slept through.
+    return !isProcessAlive(pid, platform);
+}
+//# sourceMappingURL=unity-shutdown.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unity-mcp-cli",
-  "version": "0.66.1",
+  "version": "0.67.0",
   "description": "Cross-platform CLI tool for AI Game Developer (Skills & MCP). Full AI develop and test loop. Efficient token usage, advanced tools. Creates Unity project, installs plugins, configures tools, and manages HTTP connection with Unity Editor and a game made with Unity. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.",
   "type": "module",
   "main": "dist/lib.js",