@atelierai/uco 1.0.0

package/dist/commands/devops/build.js

@@ -0,0 +1,142 @@
+import { Option } from 'commander';
+import { CliError, runCommand } from '../../util/cli-context.js';
+import { buildProjectU, } from '../../devops/utils/unity-cli.js';
+import { parsePositiveBase10Integer, requireAndroidKeystoreDependencies, requireNonEmpty, requireOneOf, resolveUnityOperationProject, withOperationCancellation, } from './_unity-operations.js';
+import { commandOptionValues, lastCommandOption, restoreRootOptions, scanCommandInvocation, } from './_unity-command-line.js';
+const ARCHITECTURES = ['x86_64', 'arm64'];
+const ANDROID_EXPORT_TYPES = ['apk', 'aab', 'android-studio-project'];
+const ANDROID_SYMBOL_TYPES = ['none', 'public', 'debugging'];
+const VERSIONING_STRATEGIES = ['semantic', 'tag', 'custom', 'none'];
+const opaqueBuildArgsOption = new Option('--args [arguments]', 'Opaque official build argument string; do not place secrets here');
+// Commander refuses an option-looking token as a required value. Parsing this
+// one option as optional lets the ownership scanner consume that opaque token;
+// keep the public help contract required because the action rejects omission.
+opaqueBuildArgsOption.flags = '--args <arguments>';
+const defaultBuildClient = { buildProjectU };
+function validatedBuildOptions(project, options) {
+    const validated = {
+        project,
+        target: requireNonEmpty(options.target ?? '', '--target'),
+        executeMethod: requireNonEmpty(options.executeMethod ?? '', '--execute-method'),
+        noTail: true,
+    };
+    if (options.buildTargetGroup !== undefined) {
+        validated.buildTargetGroup = requireNonEmpty(options.buildTargetGroup, '--build-target-group');
+    }
+    if (options.outputPath !== undefined) {
+        validated.outputPath = requireNonEmpty(options.outputPath, '--output-path');
+    }
+    if (options.logFile !== undefined) {
+        validated.logFile = requireNonEmpty(options.logFile, '--log-file');
+    }
+    if (options.editorVersion !== undefined) {
+        validated.editorVersion = requireNonEmpty(options.editorVersion, '--editor-version');
+    }
+    if (options.editorPath !== undefined) {
+        validated.editorPath = requireNonEmpty(options.editorPath, '--editor-path');
+    }
+    if (options.architecture !== undefined) {
+        validated.architecture = requireOneOf(options.architecture, ARCHITECTURES, '--architecture');
+    }
+    if (options.args !== undefined)
+        validated.args = requireNonEmpty(options.args, '--args');
+    if (options.allowInstall === true)
+        validated.allowInstall = true;
+    if (options.androidExportType !== undefined) {
+        validated.androidExportType = requireOneOf(options.androidExportType, ANDROID_EXPORT_TYPES, '--android-export-type');
+    }
+    if (options.androidKeystoreBase64 !== undefined) {
+        validated.androidKeystoreBase64 = requireNonEmpty(options.androidKeystoreBase64, '--android-keystore-base64');
+    }
+    if (options.androidKeystorePassword !== undefined) {
+        validated.androidKeystorePassword = requireNonEmpty(options.androidKeystorePassword, '--android-keystore-password');
+    }
+    if (options.androidKeyAlias !== undefined) {
+        validated.androidKeyAlias = requireNonEmpty(options.androidKeyAlias, '--android-key-alias');
+    }
+    if (options.androidKeyAliasPassword !== undefined) {
+        validated.androidKeyAliasPassword = requireNonEmpty(options.androidKeyAliasPassword, '--android-key-alias-password');
+    }
+    if (options.androidTargetSdkVersion !== undefined) {
+        validated.androidTargetSdkVersion = parsePositiveBase10Integer(options.androidTargetSdkVersion, '--android-target-sdk-version');
+    }
+    if (options.androidSymbolType !== undefined) {
+        validated.androidSymbolType = requireOneOf(options.androidSymbolType, ANDROID_SYMBOL_TYPES, '--android-symbol-type');
+    }
+    if (options.androidVersionCode !== undefined) {
+        validated.androidVersionCode = parsePositiveBase10Integer(options.androidVersionCode, '--android-version-code');
+    }
+    if (options.versioningStrategy !== undefined) {
+        validated.versioningStrategy = requireOneOf(options.versioningStrategy, VERSIONING_STRATEGIES, '--versioning-strategy');
+    }
+    if (options.buildVersion !== undefined) {
+        validated.buildVersion = requireNonEmpty(options.buildVersion, '--build-version');
+    }
+    if (options.allowDirtyBuild === true)
+        validated.allowDirtyBuild = true;
+    requireAndroidKeystoreDependencies(validated);
+    return validated;
+}
+export async function executeBuild(positionalProject, options, rootProject, client = defaultBuildClient, dependencies = {}) {
+    const project = resolveUnityOperationProject(positionalProject, rootProject);
+    const buildOptions = validatedBuildOptions(project, options);
+    const controller = dependencies.controller ?? new AbortController();
+    const operation = () => client.buildProjectU(buildOptions, { signal: controller.signal });
+    return dependencies.signalHost === undefined
+        ? withOperationCancellation(controller, operation)
+        : withOperationCancellation(controller, operation, dependencies.signalHost);
+}
+export function registerBuild(program, client = defaultBuildClient) {
+    program
+        .command('build [project]')
+        .description('Build a Unity project with the official Unity CLI (no Hub fallback; live tail disabled).')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true)
+        .option('--target <target>', 'Build target (required; official Unity CLI value)')
+        .option('--execute-method <method>', 'Static build method to execute (required)')
+        .option('--build-target-group <group>', 'Unity build target group')
+        .option('-o, --output-path <path>', 'Build artifact output path (forwarded unchanged)')
+        .option('-l, --log-file <path>', 'Build log file path (forwarded unchanged)')
+        .option('--editor-version <version>', 'Unity Editor version')
+        .option('-e, --editor-path <path>', 'Unity Editor executable path (forwarded unchanged)')
+        .option('-a, --architecture <architecture>', 'Editor architecture: x86_64 or arm64')
+        .addOption(opaqueBuildArgsOption)
+        .option('--allow-install', 'Allow the official CLI to install a required editor')
+        .option('--no-tail', 'Disable live build-log tailing (uco always enforces this)')
+        .option('--android-export-type <type>', 'Android export: apk, aab, or android-studio-project')
+        .option('--android-keystore-base64 <base64>', 'Base64 Android keystore payload (redacted from errors)')
+        .option('--android-keystore-password <password>', 'Android keystore password (redacted from errors)')
+        .option('--android-key-alias <alias>', 'Android signing key alias')
+        .option('--android-key-alias-password <password>', 'Android key alias password (redacted from errors)')
+        .option('--android-target-sdk-version <version>', 'Positive Android target SDK integer')
+        .option('--android-symbol-type <type>', 'Android symbols: none, public, or debugging')
+        .option('--android-version-code <code>', 'Positive Android version code integer')
+        .option('--versioning-strategy <strategy>', 'Versioning: semantic, tag, custom, or none')
+        .option('--build-version <version>', 'Explicit build version')
+        .option('--allow-dirty-build', 'Allow a build from a dirty working tree')
+        .action(function (project, _options) {
+        const invocation = scanCommandInvocation(this, ['args']);
+        // A separate opaque value such as `--args --json` is consumed by the root
+        // parser before this action. Restore only genuine root option occurrences.
+        restoreRootOptions(this, invocation);
+        return runCommand(this, async (ctx) => {
+            if (invocation.passthrough.length > 0) {
+                throw new CliError('Build does not accept arguments after a literal `--` delimiter.', 'invalid-unity-build-arguments');
+            }
+            if (invocation.unknownOptions.length > 0) {
+                throw new CliError(`Unknown build option: ${invocation.unknownOptions[0]}`, 'invalid-unity-build-option');
+            }
+            if (invocation.positionals.length > 1) {
+                throw new CliError('Only one Unity project positional may be supplied to build.', 'invalid-unity-build-arguments');
+            }
+            const scannedArgs = lastCommandOption(invocation, 'args');
+            const hasArgsOption = invocation.options.some((option) => option.owner === 'command' && option.attribute === 'args');
+            if (hasArgsOption && typeof scannedArgs !== 'string') {
+                throw new CliError('--args requires a value.', 'invalid-unity-build-arguments');
+            }
+            const resolvedOptions = commandOptionValues(invocation);
+            return executeBuild(invocation.positionals[0] ?? project, resolvedOptions, ctx.resolved.projectPath, client);
+        })();
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/devops/build.js.map

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

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerClose(program: Command): void;

package/dist/commands/devops/close.js

@@ -0,0 +1,121 @@
+// uco close — gracefully terminate the Unity Editor for a project.
+//
+// Mirrors upstream's commands/close.ts behavior:
+//   1. Resolve project path (canonicalize via realpath)
+//   2. Verify it's a Unity project root (has ProjectSettings/ProjectVersion.txt)
+//   3. Find the Editor PID via lockfile + process enumeration
+//   4. Ask the plugin to preflight saved/idle state and schedule normal exit
+//   5. Wait for exit without escalating to a force kill
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { platform as nodePlatform } from 'node:os';
+import { runCommand, CliError } from '../../util/cli-context.js';
+import { findUnityProcess } from '../../devops/utils/unity-process.js';
+import { readLockfilePid, isProcessAlive, waitForExit, } from '../../devops/utils/unity-shutdown.js';
+import { unwrapToolPayload } from '../../util/tool-payload.js';
+import { MAX_TIMER_SECONDS, parseBoundedInteger } from '../../util/timeout.js';
+const DEFAULT_TIMEOUT_S = 30;
+export function registerClose(program) {
+    program
+        .command('close [project]')
+        .description('Preflight and normally close the saved, idle Unity Editor for a project.')
+        .option('--timeout-seconds <seconds>', `Normal-close timeout in seconds (canonical; default: ${DEFAULT_TIMEOUT_S}; range: 1-${MAX_TIMER_SECONDS}; deprecated alias: --timeout)`)
+        .option('--timeout <seconds>', `Deprecated alias for --timeout-seconds; seconds; default: ${DEFAULT_TIMEOUT_S}; range: 1-${MAX_TIMER_SECONDS}`)
+        .option('--force', 'Deprecated and refused: close never force-kills an Editor', false)
+        .action(function (projectArg, opts) {
+        const projectPath = canonicalizePath(projectArg ?? process.cwd());
+        return runCommand(this, async (ctx) => {
+            if (!fs.existsSync(projectPath)) {
+                throw new CliError(`Project path does not exist: ${projectPath}`, 'no-such-project');
+            }
+            if (!fs.existsSync(path.join(projectPath, 'ProjectSettings', 'ProjectVersion.txt'))) {
+                throw new CliError(`Not a Unity project root: ${projectPath}`, 'not-unity-project');
+            }
+            const timeoutRaw = opts.timeoutSeconds ?? opts.timeout ?? String(DEFAULT_TIMEOUT_S);
+            const timeoutS = parseBoundedInteger(timeoutRaw, {
+                option: opts.timeoutSeconds !== undefined ? '--timeout-seconds' : '--timeout',
+                unit: 'seconds',
+                maximum: MAX_TIMER_SECONDS,
+            });
+            const platform = nodePlatform();
+            const pid = resolveEditorPid(projectPath, platform);
+            if (pid === null) {
+                return { closed: false, reason: 'no-running-editor', projectPath };
+            }
+            if (opts.force) {
+                throw new CliError('--force is no longer permitted. Resolve the reported Editor blockers and request a normal close.', 'force-close-disabled', 1, false, { pid, projectPath });
+            }
+            let closeResponse;
+            try {
+                closeResponse = await ctx.transport.callTool('editor-application-request-close', {}, { timeoutMs: Math.min(timeoutS * 1000, 10_000) });
+            }
+            catch (error) {
+                // The process may close the bridge before its response flushes. Treat that
+                // narrow race as success only when the exact pre-resolved PID has exited.
+                if (await waitForExit(pid, 1500, platform)) {
+                    return { closed: true, mode: 'normal-editor-exit', pid, projectPath };
+                }
+                throw new CliError(`Unable to run the Editor close preflight for PID ${pid}.`, 'close-preflight-unavailable', 1, true, { pid, cause: error instanceof Error ? error.message : String(error) });
+            }
+            const preflight = unwrapToolPayload(closeResponse);
+            if (readBoolean(preflight, 'Ok', 'ok') === false ||
+                readBoolean(preflight, 'Accepted', 'accepted') !== true) {
+                throw new CliError(`Unity Editor (PID ${pid}) refused normal close because it is not saved and idle.`, 'close-refused', 1, false, preflight);
+            }
+            const responsePid = readNumber(preflight, 'EditorPid', 'editorPid');
+            if (responsePid !== undefined && responsePid !== pid) {
+                throw new CliError(`Close preflight targeted PID ${responsePid}, but project discovery resolved PID ${pid}.`, 'close-pid-mismatch', 1, false, { projectPath, resolvedPid: pid, responsePid });
+            }
+            const exited = await waitForExit(pid, timeoutS * 1000, platform);
+            if (exited) {
+                return { closed: true, mode: 'normal-editor-exit', pid, projectPath, timeoutSeconds: timeoutS };
+            }
+            let finalState;
+            try {
+                finalState = await ctx.transport.callTool('editor-application-get-state', {}, { timeoutMs: 2_000 });
+            }
+            catch (error) {
+                finalState = { unavailable: true, cause: error instanceof Error ? error.message : String(error) };
+            }
+            throw new CliError(`Unity Editor (PID ${pid}) did not complete normal close within ${timeoutS}s; it was not force-killed.`, 'graceful-timeout', 1, true, { pid, projectPath, timeoutSeconds: timeoutS, finalState });
+        }, { project: projectPath })();
+    });
+}
+function readBoolean(record, ...keys) {
+    for (const key of keys)
+        if (typeof record[key] === 'boolean')
+            return record[key];
+    return undefined;
+}
+function readNumber(record, ...keys) {
+    for (const key of keys)
+        if (typeof record[key] === 'number')
+            return record[key];
+    return undefined;
+}
+function canonicalizePath(p) {
+    const r = path.resolve(p);
+    try {
+        return fs.realpathSync(r);
+    }
+    catch {
+        return r;
+    }
+}
+function resolveEditorPid(projectPath, platform) {
+    const lockPid = readLockfilePid(projectPath);
+    let proc = findUnityProcess(projectPath);
+    if (!proc) {
+        const noRealpath = path.resolve(projectPath);
+        if (noRealpath !== projectPath)
+            proc = findUnityProcess(noRealpath);
+    }
+    if (lockPid !== null && isProcessAlive(lockPid, platform)) {
+        if (proc && proc.pid === lockPid)
+            return lockPid;
+        if (!proc)
+            return lockPid; // lockfile alive, no enum match — trust lockfile
+    }
+    return proc ? proc.pid : null;
+}
+//# sourceMappingURL=close.js.map

package/dist/commands/devops/close.js.map

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

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerConfigure(program: Command): void;

package/dist/commands/devops/configure.js

@@ -0,0 +1,62 @@
+// uco configure — enable/disable MCP tools, prompts, resources in
+// a Unity project's UserSettings/uco-config.json.
+import { runCommand } from '../../util/cli-context.js';
+import { configure } from '../../devops/lib/configure.js';
+import { resolveProjectArg, progressLogger, unwrapResult } from './_helpers.js';
+function toFeatureAction(opts, kind) {
+    const enableNames = opts[`enable${cap(kind)}`];
+    const disableNames = opts[`disable${cap(kind)}`];
+    const enableAll = opts[`enableAll${cap(kind)}`];
+    const disableAll = opts[`disableAll${cap(kind)}`];
+    if (!enableNames && !disableNames && !enableAll && !disableAll)
+        return undefined;
+    const action = {};
+    if (enableNames)
+        action.enableNames = enableNames.split(',').map((s) => s.trim()).filter(Boolean);
+    if (disableNames)
+        action.disableNames = disableNames.split(',').map((s) => s.trim()).filter(Boolean);
+    if (enableAll)
+        action.enableAll = true;
+    if (disableAll)
+        action.disableAll = true;
+    return action;
+}
+function cap(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+export function registerConfigure(program) {
+    program
+        .command('configure [project]')
+        .description('Configure enabled tools/prompts/resources in the project config.')
+        .option('--list', 'Show current config and exit (no changes)')
+        .option('--enable-tools <list>', 'Comma-separated tool names to enable')
+        .option('--disable-tools <list>', 'Comma-separated tool names to disable')
+        .option('--enable-all-tools', 'Enable every tool present in config')
+        .option('--disable-all-tools', 'Disable every tool present in config')
+        .option('--enable-prompts <list>', 'Comma-separated prompt names to enable')
+        .option('--disable-prompts <list>', 'Comma-separated prompt names to disable')
+        .option('--enable-all-prompts', 'Enable every prompt present in config')
+        .option('--disable-all-prompts', 'Disable every prompt present in config')
+        .option('--enable-resources <list>', 'Comma-separated resource names to enable')
+        .option('--disable-resources <list>', 'Comma-separated resource names to disable')
+        .option('--enable-all-resources', 'Enable every resource present in config')
+        .option('--disable-all-resources', 'Disable every resource present in config')
+        .action(function (projectArg, opts) {
+        return runCommand(this, async (ctx) => {
+            const projectPath = resolveProjectArg(ctx, projectArg);
+            // --list ≡ no actions; configure() returns the snapshot anyway.
+            const tools = opts.list ? undefined : toFeatureAction(opts, 'tools');
+            const prompts = opts.list ? undefined : toFeatureAction(opts, 'prompts');
+            const resources = opts.list ? undefined : toFeatureAction(opts, 'resources');
+            const result = await configure({
+                unityProjectPath: projectPath,
+                ...(tools ? { tools } : {}),
+                ...(prompts ? { prompts } : {}),
+                ...(resources ? { resources } : {}),
+                onProgress: progressLogger(ctx),
+            });
+            return unwrapResult(result);
+        })();
+    });
+}
+//# sourceMappingURL=configure.js.map

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

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

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

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import { CliError } from '../../util/cli-context.js';
+import { type UnityLifecycleSession, type UnityLifecycleSessionSelector } from '../../devops/lib/unity-lifecycle.js';
+import type { UnityCliArchitecture } from '../../devops/utils/unity-cli.js';
+import type { InstallPluginOptions, InstallResult } from '../../devops/lib/types.js';
+export interface CreateProjectOptions {
+    unity?: string;
+    template?: string;
+    architecture?: UnityCliArchitecture;
+    pluginVersion?: string;
+    skipPlugin?: boolean;
+}
+export type ProjectPluginInstaller = (options: InstallPluginOptions) => Promise<InstallResult>;
+export declare class ProjectCreatedPluginInstallError extends CliError {
+    readonly projectPath: string;
+    readonly editorVersion: string;
+    readonly backendMetadata: Record<string, unknown>;
+    readonly packageId = "com.atelierai.unity.copilot";
+    readonly retryCommand: string;
+    readonly underlyingCause: Error;
+    constructor(fields: {
+        projectPath: string;
+        editorVersion: string;
+        backendMetadata: Record<string, unknown>;
+        pluginVersion?: string;
+        cause: Error;
+    });
+    toJSON(): Record<string, unknown>;
+}
+export declare function validateCreateProjectPluginOptions(options: CreateProjectOptions): string | undefined;
+export declare function executeCreateProject(positionalPath: string, options: CreateProjectOptions, session: UnityLifecycleSession, pluginInstaller?: ProjectPluginInstaller): Promise<Record<string, unknown>>;
+export declare function registerCreateProject(program: Command, selectSession?: UnityLifecycleSessionSelector, pluginInstaller?: ProjectPluginInstaller): void;

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

@@ -0,0 +1,170 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { runCommand, CliError } from '../../util/cli-context.js';
+import { printInfo } from '../../util/output.js';
+import { progressLogger } from './_helpers.js';
+import { findHighestLifecycleEditor, lifecycleBackendMetadata, selectUnityLifecycleSession, } from '../../devops/lib/unity-lifecycle.js';
+import { installPlugin } from '../../devops/lib/install-plugin.js';
+import { UCO_UNITY_PACKAGE_ID } from '../../devops/utils/manifest.js';
+import { recordUnityInInstallManifest } from '../../skills/install-manifest.js';
+export class ProjectCreatedPluginInstallError extends CliError {
+    projectPath;
+    editorVersion;
+    backendMetadata;
+    packageId = UCO_UNITY_PACKAGE_ID;
+    retryCommand;
+    underlyingCause;
+    constructor(fields) {
+        const retryCommand = [
+            'uco install-plugin',
+            JSON.stringify(fields.projectPath),
+            ...(fields.pluginVersion !== undefined
+                ? ['--version', JSON.stringify(fields.pluginVersion)]
+                : []),
+        ].join(' ');
+        super(`Project was created at ${fields.projectPath}, but ${UCO_UNITY_PACKAGE_ID} installation failed: ${fields.cause.message}. Retry with: ${retryCommand}`, 'project-created-plugin-install-failed');
+        this.name = 'ProjectCreatedPluginInstallError';
+        this.projectPath = fields.projectPath;
+        this.editorVersion = fields.editorVersion;
+        this.backendMetadata = fields.backendMetadata;
+        this.retryCommand = retryCommand;
+        this.underlyingCause = fields.cause;
+    }
+    toJSON() {
+        return {
+            error: true,
+            kind: 'project-created-plugin-install-failed',
+            code: this.code,
+            message: this.message,
+            projectCreated: true,
+            projectPath: this.projectPath,
+            editorVersion: this.editorVersion,
+            ...this.backendMetadata,
+            packageId: this.packageId,
+            cause: this.underlyingCause.message,
+            retryCommand: this.retryCommand,
+        };
+    }
+}
+/**
+ * Whether the resolved project path is absolute and looks like a real Unity
+ * project on disk (an `Assets/` or `Packages/` directory exists). The install
+ * manifest recording is skipped otherwise: a scripted or partially-failed
+ * creation must not leave `.uco/` litter at an arbitrary path.
+ */
+function isRecordableUnityProject(projectPath) {
+    return path.isAbsolute(projectPath)
+        && (fs.existsSync(path.join(projectPath, 'Assets'))
+            || fs.existsSync(path.join(projectPath, 'Packages')));
+}
+export function validateCreateProjectPluginOptions(options) {
+    if (options.skipPlugin && options.pluginVersion !== undefined) {
+        throw new CliError('--skip-plugin cannot be combined with --plugin-version.', 'invalid-plugin-options');
+    }
+    if (options.pluginVersion !== undefined) {
+        const version = options.pluginVersion.trim();
+        if (!version) {
+            throw new CliError('--plugin-version must not be empty.', 'invalid-plugin-version');
+        }
+        return version;
+    }
+    return undefined;
+}
+export async function executeCreateProject(positionalPath, options, session, pluginInstaller = installPlugin) {
+    const projectPath = path.resolve(positionalPath);
+    const pluginVersion = validateCreateProjectPluginOptions(options);
+    session.validateCreateOptions({
+        projectPath,
+        ...(options.unity !== undefined ? { editorVersion: options.unity } : {}),
+        ...(options.template !== undefined ? { template: options.template } : {}),
+        ...(options.architecture !== undefined ? { architecture: options.architecture } : {}),
+    });
+    let editorVersion = options.unity;
+    if (!editorVersion) {
+        const highest = findHighestLifecycleEditor(await session.listInstalledEditors());
+        if (highest === null) {
+            throw new CliError('No Unity editors installed. Run `uco install-unity` first.', 'no-editors');
+        }
+        editorVersion = highest.version;
+    }
+    await session.createProject({
+        projectPath,
+        editorVersion,
+        ...(options.template !== undefined ? { template: options.template } : {}),
+        ...(options.architecture !== undefined ? { architecture: options.architecture } : {}),
+    });
+    const backendMetadata = lifecycleBackendMetadata(session);
+    if (options.skipPlugin) {
+        return {
+            created: true,
+            projectPath,
+            editorVersion,
+            ...backendMetadata,
+            plugin: { status: 'skipped', packageId: UCO_UNITY_PACKAGE_ID },
+        };
+    }
+    const pluginResult = await pluginInstaller({
+        unityProjectPath: projectPath,
+        ...(pluginVersion !== undefined ? { version: pluginVersion } : {}),
+    });
+    if (pluginResult.kind === 'failure') {
+        throw new ProjectCreatedPluginInstallError({
+            projectPath,
+            editorVersion,
+            backendMetadata,
+            ...(pluginVersion !== undefined ? { pluginVersion } : {}),
+            cause: pluginResult.error,
+        });
+    }
+    // Record the Unity surface in the install manifest. create-project installs
+    // the plugin from the OpenUPM registry (a version, not the uco bundle), so
+    // the resolved version is recorded as the user-managed source. Fails open.
+    // Guarded: only an absolute path that actually looks like a Unity project
+    // (an `Assets/` or `Packages/` directory on disk) is recorded — the
+    // recording must never conjure `.uco/` directories under a relative or
+    // junk path (scripted callers, partially-failed creations).
+    if (isRecordableUnityProject(projectPath)) {
+        recordUnityInInstallManifest(projectPath, {
+            installed: true,
+            source: pluginResult.installedVersion,
+            projectPath,
+        });
+    }
+    return {
+        created: true,
+        projectPath,
+        editorVersion,
+        ...backendMetadata,
+        plugin: {
+            status: 'installed',
+            packageId: UCO_UNITY_PACKAGE_ID,
+            version: pluginResult.installedVersion,
+            manifestPath: pluginResult.manifestPath,
+            modified: pluginResult.modified,
+        },
+    };
+}
+export function registerCreateProject(program, selectSession = selectUnityLifecycleSession, pluginInstaller = installPlugin) {
+    program
+        .command('create-project <path>')
+        .description('Create a new Unity project at the given path.')
+        .option('--unity <version>', 'Unity Editor version (default: highest installed)')
+        .option('--template <template>', 'Official Unity project template identifier')
+        .option('--architecture <architecture>', 'Project architecture: x86_64 or arm64')
+        .option('--plugin-version <version>', `Exact ${UCO_UNITY_PACKAGE_ID} version (skips latest lookup)`)
+        .option('--skip-plugin', 'Create the project without installing the uco Unity package')
+        .action(function (positionalPath, opts) {
+        return runCommand(this, async (ctx) => {
+            validateCreateProjectPluginOptions(opts);
+            const session = selectSession({ silent: ctx.output.json });
+            if (session.decision.fallback) {
+                printInfo(ctx.output, 'Official Unity CLI was not found; using Unity Hub. Install the official `unity` CLI to enable native project options.');
+            }
+            return executeCreateProject(positionalPath, opts, session, (pluginOptions) => pluginInstaller({
+                ...pluginOptions,
+                onProgress: progressLogger(ctx),
+            }));
+        })();
+    });
+}
+//# sourceMappingURL=create-project.js.map

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

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

package/dist/commands/devops/editors.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+import { type UnityLifecycleSession, type UnityLifecycleSessionSelector } from '../../devops/lib/unity-lifecycle.js';
+export interface EditorsOptions {
+    releases?: boolean;
+    diagnostics?: boolean;
+}
+export declare function executeEditors(options: EditorsOptions, session: UnityLifecycleSession): Promise<Record<string, unknown>>;
+export declare function registerEditors(program: Command, selectSession?: UnityLifecycleSessionSelector): void;

package/dist/commands/devops/editors.js

@@ -0,0 +1,30 @@
+import { runCommand } from '../../util/cli-context.js';
+import { printInfo } from '../../util/output.js';
+import { selectUnityLifecycleSession, } from '../../devops/lib/unity-lifecycle.js';
+export async function executeEditors(options, session) {
+    const inventory = options.releases
+        ? { releases: await session.listAvailableReleases() }
+        : { editors: await session.listInstalledEditors() };
+    return {
+        backend: session.backend,
+        ...inventory,
+        ...(options.diagnostics ? { diagnostics: session.getDiagnostics() } : {}),
+    };
+}
+export function registerEditors(program, selectSession = selectUnityLifecycleSession) {
+    program
+        .command('editors')
+        .description('List installed Unity editors or available releases.')
+        .option('--releases', 'List available editor releases instead of installed editors')
+        .option('--diagnostics', 'Include official Unity CLI routing diagnostics')
+        .action(function (options) {
+        return runCommand(this, async (ctx) => {
+            const session = selectSession({ silent: ctx.output.json });
+            if (session.decision.fallback) {
+                printInfo(ctx.output, 'Official Unity CLI was not found; using Unity Hub. Install the official `unity` CLI to use the native inventory.');
+            }
+            return executeEditors(options, session);
+        })();
+    });
+}
+//# sourceMappingURL=editors.js.map

package/dist/commands/devops/editors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editors.js","sourceRoot":"","sources":["../../../src/commands/devops/editors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,2BAA2B,GAG5B,MAAM,qCAAqC,CAAC;AAO7C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,OAA8B;IAE9B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ;QAChC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,EAAE,EAAE;QACrD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;IAEtD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,SAAS;QACZ,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,gBAA+C,2BAA2B;IAE1E,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,YAAY,EAAE,6DAA6D,CAAC;SACnF,MAAM,CAAC,eAAe,EAAE,gDAAgD,CAAC;SACzE,MAAM,CAAC,UAAyB,OAAuB;QACtD,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC9B,SAAS,CACP,GAAG,CAAC,MAAM,EACV,kHAAkH,CACnH,CAAC;YACJ,CAAC;YACD,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/devops/index.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerDevopsCommands(program: Command): void;