@atelierai/uco 1.0.0

package/dist/config/resolve.js.map

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

package/dist/devops/commands-upstream/bootstrap-local.d.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { type UnityConnectionConfig } from '../utils/config.js';
+/**
+ * Produce a new config object with local-mode fields pinned to `url` / `token`.
+ * Preserves all other keys from `current` (immutable update — does not mutate `current`).
+ *
+ * The plugin-side ConnectionMode enum only accepts "Custom" (local) or "Cloud".
+ * We intentionally normalize any integer (0 → Custom, 1 → Cloud) representation
+ * to the canonical string "Custom" so the on-disk file is explicit.
+ */
+export declare function pinLocalModeConfig(current: Readonly<UnityConnectionConfig>, url: string, token: string): UnityConnectionConfig;
+/**
+ * Returns true iff `current` already reflects local mode with matching url + token.
+ * Used to make bootstrap-local a no-op when nothing would change on disk.
+ */
+export declare function isAlreadyPinned(current: Readonly<UnityConnectionConfig>, url: string, token: string): boolean;
+export declare const bootstrapLocalCommand: Command;

package/dist/devops/commands-upstream/bootstrap-local.js

@@ -0,0 +1,87 @@
+// Copyright (c) 2025 Ivan Murzak. All rights reserved.
+// Licensed under the Apache License, Version 2.0.
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { resolveAndValidateProjectPath } from '../utils/connection.js';
+import { readConfig, writeConfig, } from '../utils/config.js';
+/**
+ * Produce a new config object with local-mode fields pinned to `url` / `token`.
+ * Preserves all other keys from `current` (immutable update — does not mutate `current`).
+ *
+ * The plugin-side ConnectionMode enum only accepts "Custom" (local) or "Cloud".
+ * We intentionally normalize any integer (0 → Custom, 1 → Cloud) representation
+ * to the canonical string "Custom" so the on-disk file is explicit.
+ */
+export function pinLocalModeConfig(current, url, token) {
+    return {
+        ...current,
+        connectionMode: 'Custom',
+        host: url,
+        token,
+    };
+}
+/**
+ * Returns true iff `current` already reflects local mode with matching url + token.
+ * Used to make bootstrap-local a no-op when nothing would change on disk.
+ */
+export function isAlreadyPinned(current, url, token) {
+    // Accept both "Custom" (string) and 0 (legacy int) as already-local.
+    // Anything else (including "Cloud", 1, or unset) means we still need to pin.
+    const mode = current.connectionMode;
+    if (mode !== 'Custom' && mode !== 0)
+        return false;
+    return current.host === url && current.token === token;
+}
+export const bootstrapLocalCommand = new Command('bootstrap-local')
+    .description('Pin a Unity project\'s MCP config to local mode with the given URL/token. Idempotent.')
+    .argument('[path]', 'Unity project path (defaults to cwd)')
+    .option('--path <path>', 'Unity project path (defaults to cwd)')
+    .requiredOption('--url <url>', 'Local MCP server URL to pin (e.g. http://localhost:5140/)')
+    .requiredOption('--token <token>', 'Local MCP bearer token to pin')
+    .option('--dry-run', 'Report what would change without writing to disk')
+    .action(async (positionalPath, options) => {
+    const projectPath = resolveAndValidateProjectPath(positionalPath, options);
+    // commander's requiredOption guarantees url/token are defined before the action runs.
+    const url = options.url.replace(/\/$/, '');
+    const token = options.token;
+    verbose(`Project path: ${projectPath}`);
+    verbose(`Target URL: ${url}`);
+    verbose(`Target token: ${'*'.repeat(Math.min(token.length, 8))}... (length ${token.length})`);
+    // uco 0.3.0 renamed the config file; write the new name, but honor a legacy
+    // file when it is the only one present (the plugin migrates it on next start).
+    const configPath = path.join(projectPath, 'UserSettings', fs.existsSync(path.join(projectPath, 'UserSettings', 'uco-config.json'))
+        ? 'uco-config.json'
+        : 'AI-Game-Developer-Config.json');
+    const existedBefore = fs.existsSync(configPath);
+    // Use readConfig (not getOrCreateConfig) so --dry-run truly has no side effects.
+    // When the file doesn't exist we pin onto an empty base; this mirrors a fresh
+    // worktree where the plugin has not yet written its default Cloud config.
+    const current = readConfig(projectPath) ?? {};
+    if (isAlreadyPinned(current, url, token)) {
+        ui.success(`MCP config already pinned to local mode (${url}). No changes written.`);
+        return;
+    }
+    const next = pinLocalModeConfig(current, url, token);
+    if (options.dryRun) {
+        ui.heading('bootstrap-local (dry run)');
+        ui.label('Config file', configPath);
+        ui.label('connectionMode', `${String(current.connectionMode ?? 'unset')} → Custom`);
+        ui.label('host', `${String(current.host ?? 'unset')} → ${url}`);
+        ui.label('token', `${current.token ? '<previous>' : '<unset>'} → <supplied>`);
+        ui.info('No changes written (--dry-run).');
+        return;
+    }
+    writeConfig(projectPath, next);
+    ui.heading('bootstrap-local');
+    ui.label('Config file', configPath);
+    ui.label('connectionMode', 'Custom');
+    ui.label('host', url);
+    ui.label('token', '<supplied>');
+    ui.success(existedBefore
+        ? 'Config updated to pin local mode.'
+        : 'Config created and pinned to local mode.');
+});
+//# sourceMappingURL=bootstrap-local.js.map

package/dist/devops/commands-upstream/bootstrap-local.js.map

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

package/dist/devops/commands-upstream/close.d.ts

@@ -0,0 +1,57 @@
+import { Command } from 'commander';
+import { type SupportedPlatform } from '../utils/unity-shutdown.js';
+export interface CloseOptions {
+    timeout?: string;
+    timeoutSeconds?: 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/devops/commands-upstream/close.js

@@ -0,0 +1,188 @@
+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 <seconds>', `Polite-quit timeout in seconds (canonical; default: ${DEFAULT_TIMEOUT_SECONDS})`)
+    .option('--timeout <seconds>', 'Deprecated alias for --timeout-seconds; value is 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 timeoutRaw = options.timeoutSeconds ?? options.timeout;
+    const timeoutSeconds = parseTimeoutSeconds(timeoutRaw);
+    if (timeoutSeconds === null) {
+        ui.error(`Invalid timeout value: "${timeoutRaw}". 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/devops/commands-upstream/close.js.map

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

package/dist/devops/commands-upstream/configure.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const configureCommand: Command;

package/dist/devops/commands-upstream/configure.js

@@ -0,0 +1,87 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { configure } from '../lib/configure.js';
+function parseCommaSeparated(value) {
+    return value.split(',').map((s) => s.trim()).filter(Boolean);
+}
+function buildAction(enable, disable, enableAll, disableAll) {
+    if (!enable && !disable && !enableAll && !disableAll)
+        return undefined;
+    return {
+        enableNames: enable,
+        disableNames: disable,
+        enableAll,
+        disableAll,
+    };
+}
+export const configureCommand = new Command('configure')
+    .description('Configure MCP tools, prompts, and resources in uco-config.json')
+    .argument('[path]', 'Path to the Unity project')
+    .option('--path <path>', 'Path to the Unity project')
+    .option('--enable-tools <names>', 'Enable specific tools (comma-separated)', parseCommaSeparated)
+    .option('--disable-tools <names>', 'Disable specific tools (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-tools', 'Enable all tools')
+    .option('--disable-all-tools', 'Disable all tools')
+    .option('--enable-prompts <names>', 'Enable specific prompts (comma-separated)', parseCommaSeparated)
+    .option('--disable-prompts <names>', 'Disable specific prompts (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-prompts', 'Enable all prompts')
+    .option('--disable-all-prompts', 'Disable all prompts')
+    .option('--enable-resources <names>', 'Enable specific resources (comma-separated)', parseCommaSeparated)
+    .option('--disable-resources <names>', 'Disable specific resources (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-resources', 'Enable all resources')
+    .option('--disable-all-resources', 'Disable all resources')
+    .option('--list', 'List current configuration')
+    .action(async (positionalPath, options) => {
+    const resolvedPath = positionalPath ?? options.path;
+    if (!resolvedPath) {
+        ui.error('Path is required. Usage: unity-mcp-cli configure <path> or --path <path>');
+        process.exit(1);
+    }
+    const projectPath = path.resolve(resolvedPath);
+    verbose(`Loading config for project: ${projectPath}`);
+    // `--list` must be read-only: previously this command short-
+    // circuited before applying any enable/disable flags. Preserve
+    // that semantics by suppressing the mutating actions whenever
+    // `options.list` is set, regardless of other flags.
+    const toolsAction = buildAction(options.enableTools, options.disableTools, options.enableAllTools, options.disableAllTools);
+    const promptsAction = buildAction(options.enablePrompts, options.disablePrompts, options.enableAllPrompts, options.disableAllPrompts);
+    const resourcesAction = buildAction(options.enableResources, options.disableResources, options.enableAllResources, options.disableAllResources);
+    const result = await configure({
+        unityProjectPath: projectPath,
+        tools: options.list ? undefined : toolsAction,
+        prompts: options.list ? undefined : promptsAction,
+        resources: options.list ? undefined : resourcesAction,
+    });
+    if (result.kind === 'failure') {
+        ui.error(result.error.message);
+        process.exit(1);
+    }
+    // Narrowed: result.kind === 'success' below — `snapshot` is
+    // non-optional.
+    if (options.list) {
+        ui.heading('Current configuration');
+        ui.label('Host', result.snapshot.host ?? 'not set');
+        ui.label('Keep Connected', String(result.snapshot.keepConnected ?? false));
+        ui.label('Transport', result.snapshot.transportMethod ?? 'streamableHttp');
+        ui.label('Auth', result.snapshot.authOption ?? 'none');
+        const printFeatures = (featureLabel, features) => {
+            ui.heading(featureLabel);
+            if (features.length === 0) {
+                ui.info('(none configured - all enabled by default)');
+                return;
+            }
+            for (const f of features) {
+                ui.featureRow(f.name, f.enabled);
+            }
+        };
+        printFeatures('Tools', result.snapshot.tools);
+        printFeatures('Prompts', result.snapshot.prompts);
+        printFeatures('Resources', result.snapshot.resources);
+        return;
+    }
+    verbose('Writing updated configuration');
+    ui.success('Configuration updated successfully.');
+});
+//# sourceMappingURL=configure.js.map

package/dist/devops/commands-upstream/configure.js.map

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

package/dist/devops/commands-upstream/create-project.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const createProjectCommand: Command;

package/dist/devops/commands-upstream/create-project.js

@@ -0,0 +1,43 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import { ensureUnityHub, createProject, listInstalledEditors, findHighestEditor } from '../utils/unity-hub.js';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+export const createProjectCommand = new Command('create-project')
+    .description('Create a new Unity project')
+    .argument('[path]', 'Path where the project will be created')
+    .option('--path <path>', 'Path where the project will be created')
+    .option('--unity <version>', 'Unity Editor version to use')
+    .action(async (positionalPath, options) => {
+    const resolvedPath = positionalPath ?? options.path;
+    if (!resolvedPath) {
+        ui.error('Path is required. Usage: unity-mcp-cli create-project <path> or --path <path>');
+        process.exit(1);
+    }
+    const spinner = ui.startSpinner('Locating Unity Hub...');
+    let hubPath;
+    try {
+        hubPath = await ensureUnityHub();
+    }
+    catch (err) {
+        spinner.error('Failed to locate Unity Hub');
+        throw err;
+    }
+    spinner.success('Unity Hub located');
+    let editorVersion = options.unity;
+    if (!editorVersion) {
+        const editors = listInstalledEditors(hubPath);
+        if (editors.length === 0) {
+            ui.error('No Unity editors installed. Install one with: unity-mcp-cli install-unity [version]');
+            process.exit(1);
+        }
+        const highest = findHighestEditor(editors);
+        editorVersion = highest.version;
+        ui.info(`No Unity version specified, using highest installed: ${editorVersion}`);
+    }
+    const projectPath = path.resolve(resolvedPath);
+    verbose(`Creating project at: ${projectPath} with editor version: ${editorVersion}`);
+    verbose(`Unity Hub path: ${hubPath}`);
+    createProject(hubPath, projectPath, editorVersion);
+});
+//# sourceMappingURL=create-project.js.map

package/dist/devops/commands-upstream/create-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../../src/devops/commands-upstream/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/G,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC9D,WAAW,CAAC,4BAA4B,CAAC;KACzC,QAAQ,CAAC,QAAQ,EAAE,wCAAwC,CAAC;KAC5D,MAAM,CAAC,eAAe,EAAE,wCAAwC,CAAC;KACjE,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,cAAkC,EAAE,OAA0C,EAAE,EAAE;IAC/F,MAAM,YAAY,GAAG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IACpD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,EAAE,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IACzD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAErC,IAAI,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;IAElC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,EAAE,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;YAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC3C,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC,wDAAwD,aAAa,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,OAAO,CAAC,wBAAwB,WAAW,yBAAyB,aAAa,EAAE,CAAC,CAAC;IACrF,OAAO,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;IACtC,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}

package/dist/devops/commands-upstream/install-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const installPluginCommand: Command;

package/dist/devops/commands-upstream/install-plugin.js

@@ -0,0 +1,64 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { installPlugin } from '../lib/install-plugin.js';
+export const installPluginCommand = new Command('install-plugin')
+    .description('Install Unity-MCP plugin into a Unity project')
+    .argument('[path]', 'Path to the Unity project')
+    .option('--path <path>', 'Path to the Unity project')
+    .option('--plugin-version <version>', 'Plugin version to install (default: latest)')
+    .action(async (positionalPath, options) => {
+    const resolvedPath = positionalPath ?? options.path;
+    if (!resolvedPath) {
+        ui.error('Path is required. Usage: unity-mcp-cli install-plugin <path> or --path <path>');
+        process.exit(1);
+    }
+    const projectPath = path.resolve(resolvedPath);
+    // Wire the library's progress events back into the CLI's chalk-
+    // styled ui so the terminal experience stays identical.
+    let spinner;
+    if (!options.pluginVersion) {
+        spinner = ui.startSpinner('Resolving latest plugin version...');
+    }
+    const result = await installPlugin({
+        unityProjectPath: projectPath,
+        version: options.pluginVersion,
+        onProgress: (event) => {
+            if (event.phase === 'dependencies-resolved' && spinner) {
+                spinner.success(`Resolved plugin version: ${event.version}`);
+                spinner = undefined;
+                return;
+            }
+            if (event.phase === 'manifest-patched') {
+                // Preserve the historical `ui.success("Updated …")` vs
+                // `ui.info("manifest.json is already up to date.")` split
+                // that the shared manifest helpers used to print directly.
+                if (event.message.startsWith('Updated ')) {
+                    ui.success(event.message);
+                }
+                else {
+                    ui.info(event.message);
+                }
+            }
+        },
+    });
+    if (result.kind === 'failure') {
+        if (spinner) {
+            spinner.error('Failed to resolve plugin version');
+            spinner = undefined;
+        }
+        ui.error(result.error.message);
+        process.exit(1);
+    }
+    // Narrowed: result.kind === 'success' below — `installedVersion`
+    // and `manifestPath` are non-optional.
+    verbose(`Plugin version: ${result.installedVersion} (explicit: ${!!options.pluginVersion})`);
+    verbose(`Manifest path: ${result.manifestPath}`);
+    ui.info(`Installing Unity-MCP plugin v${result.installedVersion} into: ${projectPath}`);
+    for (const warning of result.warnings) {
+        ui.warn(warning);
+    }
+    ui.success('Done! Open the project in Unity Editor to complete installation.');
+});
+//# sourceMappingURL=install-plugin.js.map

package/dist/devops/commands-upstream/install-plugin.js.map

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

package/dist/devops/commands-upstream/install-unity.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const installUnityCommand: Command;