@atelierai/uco 1.0.0

package/dist/devops/lib/unity-lifecycle.d.ts

@@ -0,0 +1,102 @@
+import { CliError } from '../../util/errors.js';
+import { type AvailableRelease as HubAvailableRelease, type InstalledEditor as HubInstalledEditor, type UnityHubOperationOptions } from '../utils/unity-hub.js';
+import { type AvailableRelease as OfficialAvailableRelease, type CreateUnityProjectOptions, type InstalledEditor as OfficialInstalledEditor, type InstallEditorOptions, type UnityCliArchitecture, type UnityCliFactoryOptions } from '../utils/unity-cli.js';
+export type UnityLifecycleBackend = 'unity-cli' | 'unity-hub';
+export type UnityCliPolicy = 'auto' | 'required' | 'hub';
+export type LifecycleSelectionReason = 'auto-detected' | 'auto-absent-fallback' | 'required-by-flag' | 'required-by-path-override' | 'forced-hub';
+export interface LifecycleEditor {
+    version: string;
+    path: string;
+    alias?: string;
+    architecture?: string;
+    modules?: string[];
+    isDefault?: boolean;
+}
+export interface LifecycleRelease {
+    version: string;
+    alias?: string;
+    architecture?: string;
+    installedPath?: string;
+    isStable: boolean;
+}
+export interface LifecycleDecision {
+    policy: UnityCliPolicy;
+    reason: LifecycleSelectionReason;
+    overridePresent: boolean;
+    officialAvailable: boolean;
+    officialPath?: string;
+    fallback: boolean;
+}
+export interface LifecycleDiagnostics {
+    policy: UnityCliPolicy;
+    selectedBackend: UnityLifecycleBackend;
+    selectionReason: LifecycleSelectionReason;
+    overridePresent: boolean;
+    officialAvailable: boolean;
+    officialPath: string | null;
+    officialVersion: string | null;
+    fallback: boolean;
+}
+export interface LifecycleInstallOptions extends InstallEditorOptions {
+    prefetchedReleases?: readonly LifecycleRelease[];
+}
+export interface LifecycleCreateProjectOptions {
+    projectPath: string;
+    editorVersion?: string;
+    template?: string;
+    architecture?: UnityCliArchitecture;
+}
+export interface UnityLifecycleSession {
+    readonly backend: UnityLifecycleBackend;
+    readonly decision: LifecycleDecision;
+    readonly unityCliPath: string | undefined;
+    readonly hubPath: string | undefined;
+    validateInstallOptions(options: InstallEditorOptions): void;
+    validateCreateOptions(options: LifecycleCreateProjectOptions): void;
+    listInstalledEditors(): Promise<LifecycleEditor[]>;
+    listAvailableReleases(): Promise<LifecycleRelease[]>;
+    installEditor(version: string, options?: LifecycleInstallOptions): Promise<void>;
+    createProject(options: LifecycleCreateProjectOptions): Promise<void>;
+    getDiagnostics(): LifecycleDiagnostics;
+}
+export interface UnityLifecycleSessionOptions {
+    /** Suppress backend-owned progress for JSON or library-safe callers. */
+    silent?: boolean;
+}
+export type UnityLifecycleSessionSelector = (options?: UnityLifecycleSessionOptions) => UnityLifecycleSession;
+export interface BoundOfficialLifecycleAdapter {
+    getUnityCliVersion(): string | null;
+    listInstalledEditors(): Promise<OfficialInstalledEditor[]>;
+    listAvailableReleases(): Promise<OfficialAvailableRelease[]>;
+    installEditor(version: string, options?: InstallEditorOptions): Promise<void>;
+    createProject(options: CreateUnityProjectOptions): Promise<void>;
+}
+export interface OfficialLifecycleAdapter extends BoundOfficialLifecycleAdapter {
+    findUnityCli(): string | null;
+    /** Bind operations to the selection result so this session never rediscovers. */
+    bindExecutable?(executable: string | null): BoundOfficialLifecycleAdapter;
+}
+export interface HubLifecycleAdapter {
+    ensureUnityHub(options?: UnityHubOperationOptions): Promise<string>;
+    listInstalledEditors(hubPath: string, options?: UnityHubOperationOptions): HubInstalledEditor[];
+    listAvailableReleases(hubPath: string, options?: UnityHubOperationOptions): HubAvailableRelease[];
+    installEditor(hubPath: string, version: string, prefetchedReleases?: HubAvailableRelease[], options?: UnityHubOperationOptions): Promise<void>;
+    createProject(hubPath: string, projectPath: string, editorVersion?: string, options?: UnityHubOperationOptions): void;
+}
+export interface UnityLifecycleRouterOptions {
+    environment?: NodeJS.ProcessEnv;
+    official?: OfficialLifecycleAdapter;
+    hub?: HubLifecycleAdapter;
+}
+export declare class UnityLifecycleError extends CliError {
+    toJSON(): Record<string, unknown>;
+}
+/** @internal Production-shaped adapter factory used by lifecycle contract tests. */
+export declare function createOfficialLifecycleAdapter(options?: UnityCliFactoryOptions): OfficialLifecycleAdapter;
+export declare function findHighestLifecycleEditor(editors: readonly LifecycleEditor[]): LifecycleEditor | null;
+export declare function findLatestStableLifecycleRelease(releases: readonly LifecycleRelease[]): LifecycleRelease | null;
+export declare function createUnityLifecycleRouter(options?: UnityLifecycleRouterOptions): {
+    selectSession: UnityLifecycleSessionSelector;
+};
+export declare function selectUnityLifecycleSession(options?: UnityLifecycleSessionOptions): UnityLifecycleSession;
+export declare function lifecycleBackendMetadata(session: UnityLifecycleSession): Record<string, string>;

package/dist/devops/lib/unity-lifecycle.js

@@ -0,0 +1,313 @@
+import * as path from 'node:path';
+import { CliError } from '../../util/errors.js';
+import { createProject as createHubProject, ensureUnityHub, installEditor as installHubEditor, listAvailableReleases as listHubAvailableReleases, listInstalledEditors as listHubInstalledEditors, silentUnityHubOutput, } from '../utils/unity-hub.js';
+import { createUnityCli, } from '../utils/unity-cli.js';
+export class UnityLifecycleError extends CliError {
+    toJSON() {
+        return {
+            error: true,
+            message: this.message,
+            code: this.code,
+            exitCode: this.exitCode,
+        };
+    }
+}
+function officialOperations(client) {
+    return {
+        getUnityCliVersion: client.getUnityCliVersion,
+        listInstalledEditors: client.listInstalledEditorsU,
+        listAvailableReleases: client.listAvailableReleasesU,
+        installEditor: client.installEditorU,
+        createProject: client.createProjectU,
+    };
+}
+/** @internal Production-shaped adapter factory used by lifecycle contract tests. */
+export function createOfficialLifecycleAdapter(options = {}) {
+    const discoveryClient = createUnityCli(options);
+    return {
+        findUnityCli: discoveryClient.findUnityCli,
+        ...officialOperations(discoveryClient),
+        bindExecutable(executable) {
+            const selectedEnvironment = {
+                ...(options.environment ?? process.env),
+            };
+            return officialOperations(createUnityCli({
+                ...options,
+                environment: selectedEnvironment,
+                pinnedExecutable: executable,
+            }));
+        },
+    };
+}
+const productionOfficialAdapter = createOfficialLifecycleAdapter();
+const productionHubAdapter = {
+    ensureUnityHub,
+    listInstalledEditors: listHubInstalledEditors,
+    listAvailableReleases: listHubAvailableReleases,
+    installEditor: installHubEditor,
+    createProject: createHubProject,
+};
+function parsePolicy(environment) {
+    const raw = environment['UCO_USE_UNITY_CLI'];
+    if (raw === undefined || raw === '' || raw === 'auto')
+        return 'auto';
+    if (raw === '1')
+        return 'required';
+    if (raw === '0')
+        return 'hub';
+    throw new UnityLifecycleError(`Invalid UCO_USE_UNITY_CLI value: ${JSON.stringify(raw)}. Expected auto, 1, or 0.`, 'invalid-unity-cli-policy');
+}
+function hasPathOverride(environment) {
+    return Boolean(environment['UNITY_CLI_PATH']?.trim());
+}
+function unsupportedInstallOption(options) {
+    if ((options.modules?.length ?? 0) > 0)
+        return '--module';
+    if (options.architecture !== undefined)
+        return '--architecture';
+    if (options.changeset !== undefined)
+        return '--changeset';
+    if (options.childModules !== undefined)
+        return options.childModules ? '--child-modules' : '--no-child-modules';
+    if (options.force === true)
+        return '--force';
+    if (options.acceptEula === true)
+        return '--accept-eula';
+    if (options.resume === true)
+        return '--resume';
+    if (options.noElevate === true)
+        return '--no-elevate';
+    return undefined;
+}
+function unsupportedCreateOption(options) {
+    if (options.template !== undefined)
+        return '--template';
+    if (options.architecture !== undefined)
+        return '--architecture';
+    return undefined;
+}
+function officialOnlyError(option) {
+    return new UnityLifecycleError(`${option} requires the official Unity CLI. Remove the option or set UCO_USE_UNITY_CLI=1.`, 'unity-cli-required');
+}
+function validateProjectTarget(projectPath) {
+    const normalized = path.resolve(projectPath);
+    const name = path.basename(normalized);
+    const parent = path.dirname(normalized);
+    if (!name || normalized === parent) {
+        throw new UnityLifecycleError(`Project path must include a project folder name: ${normalized}`, 'invalid-project-path');
+    }
+    return { name, parent };
+}
+function compareUnityVersions(a, b) {
+    const tokens = (value) => (value.match(/\d+|[a-zA-Z]+/g)?.map((token) => {
+        const numeric = Number(token);
+        return Number.isNaN(numeric) ? token.toLowerCase() : numeric;
+    }) ?? []);
+    const left = tokens(a);
+    const right = tokens(b);
+    const length = Math.max(left.length, right.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPart = left[index];
+        const rightPart = right[index];
+        if (leftPart === undefined)
+            return -1;
+        if (rightPart === undefined)
+            return 1;
+        if (typeof leftPart === 'number' && typeof rightPart === 'number') {
+            if (leftPart !== rightPart)
+                return leftPart - rightPart;
+            continue;
+        }
+        const compared = String(leftPart).localeCompare(String(rightPart));
+        if (compared !== 0)
+            return compared;
+    }
+    return 0;
+}
+export function findHighestLifecycleEditor(editors) {
+    if (editors.length === 0)
+        return null;
+    return editors.reduce((highest, current) => (compareUnityVersions(current.version, highest.version) > 0 ? current : highest));
+}
+export function findLatestStableLifecycleRelease(releases) {
+    const stable = releases.filter((release) => release.isStable);
+    if (stable.length === 0)
+        return null;
+    return stable.reduce((highest, current) => (compareUnityVersions(current.version, highest.version) > 0 ? current : highest));
+}
+export function createUnityLifecycleRouter(options = {}) {
+    const environment = options.environment ?? process.env;
+    const official = options.official ?? productionOfficialAdapter;
+    const hub = options.hub ?? productionHubAdapter;
+    const selectSession = (sessionOptions = {}) => {
+        const policy = parsePolicy(environment);
+        const overridePresent = hasPathOverride(environment);
+        const officialPath = official.findUnityCli();
+        const officialAvailable = officialPath !== null;
+        let backend;
+        let reason;
+        if (policy === 'hub') {
+            backend = 'unity-hub';
+            reason = 'forced-hub';
+        }
+        else if (policy === 'required') {
+            backend = 'unity-cli';
+            reason = 'required-by-flag';
+        }
+        else if (overridePresent) {
+            backend = 'unity-cli';
+            reason = 'required-by-path-override';
+        }
+        else if (officialAvailable) {
+            backend = 'unity-cli';
+            reason = 'auto-detected';
+        }
+        else {
+            backend = 'unity-hub';
+            reason = 'auto-absent-fallback';
+        }
+        const decision = {
+            policy,
+            reason,
+            overridePresent,
+            officialAvailable,
+            ...(officialPath !== null ? { officialPath } : {}),
+            fallback: reason === 'auto-absent-fallback',
+        };
+        const selectedOfficial = official.bindExecutable?.(officialPath) ?? official;
+        const hubOperationOptions = {
+            strictInventory: true,
+            ...(sessionOptions.silent ? { output: silentUnityHubOutput } : {}),
+        };
+        let resolvedHubPath;
+        let hubPromise;
+        const resolveHub = () => {
+            hubPromise ??= hub.ensureUnityHub(hubOperationOptions).then((value) => {
+                resolvedHubPath = value;
+                return value;
+            });
+            return hubPromise;
+        };
+        const validateInstallOptions = (installOptions) => {
+            if (backend !== 'unity-hub')
+                return;
+            const unsupported = unsupportedInstallOption(installOptions);
+            if (unsupported !== undefined)
+                throw officialOnlyError(unsupported);
+        };
+        const validateCreateOptions = (projectOptions) => {
+            validateProjectTarget(projectOptions.projectPath);
+            if (backend !== 'unity-hub')
+                return;
+            const unsupported = unsupportedCreateOption(projectOptions);
+            if (unsupported !== undefined)
+                throw officialOnlyError(unsupported);
+        };
+        return {
+            backend,
+            decision,
+            get unityCliPath() {
+                return backend === 'unity-cli' ? officialPath ?? undefined : undefined;
+            },
+            get hubPath() {
+                return backend === 'unity-hub' ? resolvedHubPath : undefined;
+            },
+            validateInstallOptions,
+            validateCreateOptions,
+            async listInstalledEditors() {
+                if (backend === 'unity-cli') {
+                    return (await selectedOfficial.listInstalledEditors()).map((editor) => ({
+                        version: editor.version,
+                        path: editor.path,
+                        ...(editor.alias !== undefined ? { alias: editor.alias } : {}),
+                        ...(editor.architecture !== undefined ? { architecture: editor.architecture } : {}),
+                        modules: [...editor.modules],
+                        isDefault: editor.isDefault,
+                    }));
+                }
+                return hub.listInstalledEditors(await resolveHub(), hubOperationOptions).map((editor) => ({
+                    version: editor.version,
+                    path: editor.path,
+                }));
+            },
+            async listAvailableReleases() {
+                if (backend === 'unity-cli') {
+                    return (await selectedOfficial.listAvailableReleases()).map((release) => ({
+                        version: release.version,
+                        ...(release.alias !== undefined ? { alias: release.alias } : {}),
+                        ...(release.architecture !== undefined ? { architecture: release.architecture } : {}),
+                        ...(release.installedPath !== undefined ? { installedPath: release.installedPath } : {}),
+                        isStable: release.isStable,
+                    }));
+                }
+                return hub.listAvailableReleases(await resolveHub(), hubOperationOptions).map((release) => ({
+                    version: release.version,
+                    isStable: release.isStable,
+                }));
+            },
+            async installEditor(version, installOptions = {}) {
+                validateInstallOptions(installOptions);
+                if (backend === 'unity-cli') {
+                    const { prefetchedReleases: _prefetchedReleases, ...officialOptions } = installOptions;
+                    await selectedOfficial.installEditor(version, officialOptions);
+                    return;
+                }
+                const prefetched = installOptions.prefetchedReleases?.map((release) => ({
+                    version: release.version,
+                    isStable: release.isStable,
+                }));
+                await hub.installEditor(await resolveHub(), version, prefetched, hubOperationOptions);
+            },
+            async createProject(projectOptions) {
+                validateCreateOptions(projectOptions);
+                const target = path.resolve(projectOptions.projectPath);
+                if (backend === 'unity-cli') {
+                    const { name, parent } = validateProjectTarget(target);
+                    await selectedOfficial.createProject({
+                        name,
+                        parent,
+                        ...(projectOptions.editorVersion !== undefined
+                            ? { editorVersion: projectOptions.editorVersion }
+                            : {}),
+                        ...(projectOptions.template !== undefined ? { template: projectOptions.template } : {}),
+                        ...(projectOptions.architecture !== undefined
+                            ? { architecture: projectOptions.architecture }
+                            : {}),
+                    });
+                    return;
+                }
+                hub.createProject(await resolveHub(), target, projectOptions.editorVersion, hubOperationOptions);
+            },
+            getDiagnostics() {
+                return {
+                    policy,
+                    selectedBackend: backend,
+                    selectionReason: reason,
+                    overridePresent,
+                    officialAvailable,
+                    officialPath,
+                    officialVersion: officialAvailable ? selectedOfficial.getUnityCliVersion() : null,
+                    fallback: reason === 'auto-absent-fallback',
+                };
+            },
+        };
+    };
+    return { selectSession };
+}
+const productionRouter = createUnityLifecycleRouter();
+export function selectUnityLifecycleSession(options) {
+    return productionRouter.selectSession(options);
+}
+export function lifecycleBackendMetadata(session) {
+    if (session.backend === 'unity-cli') {
+        return {
+            backend: session.backend,
+            ...(session.unityCliPath !== undefined ? { unityCliPath: session.unityCliPath } : {}),
+        };
+    }
+    return {
+        backend: session.backend,
+        ...(session.hubPath !== undefined ? { hubPath: session.hubPath } : {}),
+    };
+}
+//# sourceMappingURL=unity-lifecycle.js.map

package/dist/devops/lib/unity-lifecycle.js.map

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

package/dist/devops/lib/update.d.ts

@@ -0,0 +1,84 @@
+import type { ProgressCallback } from './types.js';
+export interface UpdateOptions {
+    /** The directory whose installed state should be refreshed. */
+    targetPath: string;
+    /** Report the planned changes without writing anything. */
+    dryRun?: boolean;
+    /** Refresh all manifest agents even when content-identical. */
+    force?: boolean;
+    /** Skip the entire Unity toolchain surface. */
+    skipUnity?: boolean;
+    /** Skip MCP config reconciliation. */
+    skipMcpConfig?: boolean;
+    /**
+     * Test seam: override the bundle's plugin package source and NuGet folder
+     * (defaults: the uco package's vendor/ directory, dev workspace fallback).
+     */
+    pluginSourcePath?: string;
+    /** Test seam: see {@link pluginSourcePath}. */
+    nugetSourcePath?: string;
+    onProgress?: ProgressCallback;
+}
+export interface AgentRefreshReport {
+    id: string;
+    skillsPath: string;
+    status: 'updated' | 'unchanged' | 'failed';
+    changedFileCount: number;
+    error?: string;
+}
+export interface RuntimeRefreshReport {
+    status: 'updated' | 'unchanged' | 'failed';
+    changedFileCount: number;
+    /** True when a live catalog was detected and preserved. */
+    liveCatalogPreserved: boolean;
+    error?: string;
+}
+export interface UnityRefreshReport {
+    status: 'refreshed' | 'unchanged' | 'skipped' | 'failed';
+    detail: string;
+    warnings: string[];
+}
+export interface AgentConfigReport {
+    id: string;
+    status: 'created' | 'updated' | 'unchanged' | 'failed';
+    configPath: string;
+    error?: string;
+}
+export interface ConfigSyncReport {
+    status: 'synced' | 'skipped' | 'disabled';
+    detail: string;
+    agents: AgentConfigReport[];
+    restartReminder: boolean;
+}
+export interface NewAgentAdvisory {
+    id: string;
+    detectionPaths: readonly string[];
+}
+export interface UpdateSuccess {
+    kind: 'success';
+    success: true;
+    targetPath: string;
+    manifestPath: string;
+    seeded: boolean;
+    seedAgentIds: string[];
+    agents: AgentRefreshReport[];
+    runtime: RuntimeRefreshReport;
+    unity: UnityRefreshReport;
+    configSync: ConfigSyncReport;
+    newAgentAdvisories: NewAgentAdvisory[];
+    /** True when nothing needed refreshing — the command prints "Already up to date." */
+    upToDate: boolean;
+    versionBefore: string;
+    versionAfter: string;
+    warnings: string[];
+    dryRun: boolean;
+}
+export interface UpdateFailure {
+    kind: 'failure';
+    success: false;
+    targetPath?: string;
+    warnings: string[];
+    error: Error;
+}
+export type UpdateResult = UpdateSuccess | UpdateFailure;
+export declare function runUpdate(opts: UpdateOptions): Promise<UpdateResult>;