@unibridge/cli 0.5.0 → 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcus Sanatan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @unibridge/cli
+
+CLI for interacting with Unity Editor projects through UniBridge.
+
+## Install
+
+Use without global install:
+
+```bash
+npx @unibridge/cli --help
+```
+
+Install globally:
+
+```bash
+npm install -g @unibridge/cli
+unibridge --help
+```
+
+## Requirements
+
+- Node.js `>=22.18.0`
+- A Unity project
+- UniBridge Unity plugin installed in that project
+
+## Setup
+
+Install the Unity plugin in the current Unity project:
+
+```bash
+unibridge init
+```
+
+`update` is an alias for `init` and can be used to re-run this idempotently after SDK/CLI upgrades:
+
+```bash
+unibridge update
+```
+
+Or provide a specific project path:
+
+```bash
+unibridge --project /path/to/UnityProject init
+```
+
+## Common Commands
+
+```bash
+unibridge status
+unibridge logs --severity warn --limit 100 --offset 0
+unibridge gameobject create Player --dimension 2d --position 0,1,0
+unibridge gameobject create Enemy --parent-instance-id 12345 --primitive cube
+unibridge gameobject destroy --instance-id 12345
+unibridge test list --mode edit --limit 50 --offset 0
+unibridge test run --mode edit --filter DomainReloadCommandHandlerTests
+unibridge domain reload
+unibridge scene active
+unibridge scene list --limit 50 --offset 0
+unibridge scene hierarchy --limit 200 --offset 0
+unibridge scene create Assets/Scenes/NewScene.unity
+unibridge scene open Assets/Scenes/SampleScene.unity
+```
+
+Run commands with JSON output:
+
+```bash
+unibridge --json status
+```
+
+## Identity
+
+- `gameobject create` responses include `instanceId` and `path`.
+- `scene hierarchy` node entries include `instanceId`, `path`, `parentIndex`, and `siblingIndex`.
+- `instanceId` is session-local and ideal for follow-up commands during an active Unity session.

package/dist/commands/gameobject.d.ts

@@ -0,0 +1,49 @@
+import type { Command } from 'commander';
+import type { GameObjectCreateInput, GameObjectCreateResult, GameObjectDestroyInput, GameObjectDestroyResult, GameObjectUpdateInput, GameObjectUpdateResult } from '@unibridge/sdk';
+interface GameObjectCreateOptions {
+    parent?: string;
+    parentInstanceId?: string;
+    dimension?: string;
+    primitive?: string;
+    space?: string;
+    position?: string;
+    rotation?: string;
+    scale?: string;
+}
+interface GameObjectCreateDeps {
+    create: (input: GameObjectCreateInput) => Promise<GameObjectCreateResult>;
+    console: Pick<Console, 'log' | 'error'>;
+    exit?: (code: number) => void;
+}
+interface GameObjectDestroyOptions {
+    path?: string;
+    instanceId?: string;
+}
+interface GameObjectDestroyDeps {
+    destroy: (input: GameObjectDestroyInput) => Promise<GameObjectDestroyResult>;
+    console: Pick<Console, 'log' | 'error'>;
+    exit?: (code: number) => void;
+}
+interface GameObjectUpdateOptions {
+    path?: string;
+    instanceId?: string;
+    name?: string;
+    tag?: string;
+    layer?: string;
+    isStatic?: string;
+    space?: string;
+    position?: string;
+    rotation?: string;
+    scale?: string;
+}
+interface GameObjectUpdateDeps {
+    update: (input: GameObjectUpdateInput) => Promise<GameObjectUpdateResult>;
+    console: Pick<Console, 'log' | 'error'>;
+    exit?: (code: number) => void;
+}
+export declare function handleGameObjectCreate(name: string, opts: GameObjectCreateOptions, jsonOutput: boolean, deps: GameObjectCreateDeps): Promise<void>;
+export declare function handleGameObjectDestroy(opts: GameObjectDestroyOptions, jsonOutput: boolean, deps: GameObjectDestroyDeps): Promise<void>;
+export declare function handleGameObjectUpdate(opts: GameObjectUpdateOptions, jsonOutput: boolean, deps: GameObjectUpdateDeps): Promise<void>;
+export declare function registerGameObject(program: Command): void;
+export {};
+//# sourceMappingURL=gameobject.d.ts.map

package/dist/commands/gameobject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject.d.ts","sourceRoot":"","sources":["../../src/commands/gameobject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAmB,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,uBAAuB,EAAuB,qBAAqB,EAAE,sBAAsB,EAAqC,MAAM,gBAAgB,CAAA;AAI5P,UAAU,uBAAuB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACzE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,UAAU,wBAAwB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC5E,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,UAAU,uBAAuB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACzE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AA6FD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,uBAAuB,EAC7B,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,wBAAwB,EAC9B,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,uBAAuB,EAC7B,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiFzD"}

package/dist/commands/gameobject.js

@@ -0,0 +1,218 @@
+import { runWithOutput } from "./output.js";
+import { withUnityClient } from "./with-unity-client.js";
+function parseDimension(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (value === '2d' || value === '3d') {
+        return value;
+    }
+    throw new Error('--dimension must be one of: 2d, 3d.');
+}
+function parsePrimitive(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (value === 'cube' || value === 'sphere' || value === 'capsule' || value === 'cylinder' || value === 'plane' || value === 'quad') {
+        return value;
+    }
+    throw new Error('--primitive must be one of: cube, sphere, capsule, cylinder, plane, quad.');
+}
+function parseSpace(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (value === 'local' || value === 'world') {
+        return value;
+    }
+    throw new Error('--space must be one of: local, world.');
+}
+function parseVector3(value, label) {
+    if (value == null) {
+        return undefined;
+    }
+    const parts = value.split(',').map((part) => Number.parseFloat(part.trim()));
+    if (parts.length !== 3 || parts.some((part) => !Number.isFinite(part))) {
+        throw new Error(`${label} must be in x,y,z format.`);
+    }
+    return { x: parts[0], y: parts[1], z: parts[2] };
+}
+function parseTransform(opts) {
+    const transform = {
+        space: parseSpace(opts.space),
+        position: parseVector3(opts.position, '--position'),
+        rotation: parseVector3(opts.rotation, '--rotation'),
+        scale: parseVector3(opts.scale, '--scale'),
+    };
+    if (transform.space == null && transform.position == null && transform.rotation == null && transform.scale == null) {
+        return undefined;
+    }
+    return transform;
+}
+function parseParentInstanceId(value) {
+    if (value == null) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed)) {
+        throw new Error('--parent-instance-id must be an integer.');
+    }
+    return parsed;
+}
+function parseInstanceId(value, label) {
+    if (value == null) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed)) {
+        throw new Error(`${label} must be an integer.`);
+    }
+    return parsed;
+}
+function parseBoolean(value, label) {
+    if (value == null) {
+        return undefined;
+    }
+    if (value === 'true') {
+        return true;
+    }
+    if (value === 'false') {
+        return false;
+    }
+    throw new Error(`${label} must be true or false.`);
+}
+export async function handleGameObjectCreate(name, opts, jsonOutput, deps) {
+    if (opts.parent != null && opts.parentInstanceId != null) {
+        throw new Error('Use either --parent or --parent-instance-id, not both.');
+    }
+    const input = {
+        name,
+        parent: opts.parent,
+        parentInstanceId: parseParentInstanceId(opts.parentInstanceId),
+        dimension: parseDimension(opts.dimension),
+        primitive: parsePrimitive(opts.primitive),
+        transform: parseTransform(opts),
+    };
+    await runWithOutput(jsonOutput, deps, () => deps.create(input), (result, output) => {
+        output.log(`Created: ${result.path}`);
+        output.log(`Id:      ${result.instanceId}`);
+        output.log(`Active:  ${result.isActive ? 'yes' : 'no'}`);
+        output.log(`Sibling: ${result.siblingIndex}`);
+    });
+}
+export async function handleGameObjectDestroy(opts, jsonOutput, deps) {
+    const instanceId = parseInstanceId(opts.instanceId, '--instance-id');
+    const path = opts.path;
+    if ((path == null || path.length === 0) && instanceId == null) {
+        throw new Error('Provide either --path or --instance-id.');
+    }
+    if (path != null && instanceId != null) {
+        throw new Error('Use either --path or --instance-id, not both.');
+    }
+    await runWithOutput(jsonOutput, deps, () => deps.destroy({ path, instanceId }), (result, output) => {
+        output.log(`Destroyed: ${result.path}`);
+        output.log(`Id:        ${result.instanceId}`);
+        output.log(`Name:      ${result.name}`);
+    });
+}
+export async function handleGameObjectUpdate(opts, jsonOutput, deps) {
+    const instanceId = parseInstanceId(opts.instanceId, '--instance-id');
+    const path = opts.path;
+    if ((path == null || path.length === 0) && instanceId == null) {
+        throw new Error('Provide either --path or --instance-id.');
+    }
+    if (path != null && instanceId != null) {
+        throw new Error('Use either --path or --instance-id, not both.');
+    }
+    const transform = parseTransform(opts);
+    const isStatic = parseBoolean(opts.isStatic, '--is-static');
+    const hasAnyUpdate = opts.name != null || opts.tag != null || opts.layer != null || isStatic != null || transform != null;
+    if (!hasAnyUpdate) {
+        throw new Error('Provide at least one update field.');
+    }
+    const input = {
+        path,
+        instanceId,
+        name: opts.name,
+        tag: opts.tag,
+        layer: opts.layer,
+        isStatic,
+        transform,
+    };
+    await runWithOutput(jsonOutput, deps, () => deps.update(input), (result, output) => {
+        output.log(`Updated: ${result.path}`);
+        output.log(`Id:      ${result.instanceId}`);
+        output.log(`Tag:     ${result.tag}`);
+        output.log(`Layer:   ${result.layer}`);
+        output.log(`Static:  ${result.isStatic ? 'yes' : 'no'}`);
+        output.log(`Pos:     ${result.transform.position.x},${result.transform.position.y},${result.transform.position.z}`);
+    });
+}
+export function registerGameObject(program) {
+    const gameObject = program
+        .command('gameobject')
+        .description('Create and manage Unity GameObjects');
+    gameObject
+        .command('create <name>')
+        .description('Create a GameObject with optional parent, primitive, and transform')
+        .option('--parent <path>', 'Parent GameObject path, e.g. /Environment')
+        .option('--parent-instance-id <id>', 'Parent GameObject instance ID (session-local)')
+        .option('--dimension <dimension>', 'Object type (2d|3d). 2d auto-adds SpriteRenderer')
+        .option('--primitive <primitive>', '3D primitive (cube|sphere|capsule|cylinder|plane|quad)')
+        .option('--space <space>', 'Transform space (local|world)')
+        .option('--position <x,y,z>', 'Initial position vector')
+        .option('--rotation <x,y,z>', 'Initial euler rotation vector')
+        .option('--scale <x,y,z>', 'Initial local scale vector')
+        .action(async (name, opts, command) => {
+        await withUnityClient(command, { requirePlugin: true }, async (client, ctx) => {
+            await handleGameObjectCreate(name, opts, ctx.jsonOutput, {
+                create: (input) => client.gameObjectCreate(input),
+                console,
+                exit: (exitCode) => {
+                    process.exitCode = exitCode;
+                },
+            });
+        });
+    });
+    gameObject
+        .command('destroy')
+        .description('Destroy a GameObject by path or instance ID')
+        .option('--path <path>', 'GameObject path, e.g. /Environment/Enemy_01')
+        .option('--instance-id <id>', 'GameObject instance ID (session-local)')
+        .action(async (opts, command) => {
+        await withUnityClient(command, { requirePlugin: true }, async (client, ctx) => {
+            await handleGameObjectDestroy(opts, ctx.jsonOutput, {
+                destroy: (input) => client.gameObjectDestroy(input),
+                console,
+                exit: (exitCode) => {
+                    process.exitCode = exitCode;
+                },
+            });
+        });
+    });
+    gameObject
+        .command('update')
+        .description('Update GameObject properties by path or instance ID')
+        .option('--path <path>', 'GameObject path, e.g. /Environment/Enemy_01')
+        .option('--instance-id <id>', 'GameObject instance ID (session-local)')
+        .option('--name <name>', 'Updated GameObject name')
+        .option('--tag <tag>', 'Updated Unity tag')
+        .option('--layer <layer>', 'Updated Unity layer name or index')
+        .option('--is-static <true|false>', 'Set static flag')
+        .option('--space <space>', 'Transform space (local|world)')
+        .option('--position <x,y,z>', 'Updated position vector')
+        .option('--rotation <x,y,z>', 'Updated euler rotation vector')
+        .option('--scale <x,y,z>', 'Updated local scale vector')
+        .action(async (opts, command) => {
+        await withUnityClient(command, { requirePlugin: true }, async (client, ctx) => {
+            await handleGameObjectUpdate(opts, ctx.jsonOutput, {
+                update: (input) => client.gameObjectUpdate(input),
+                console,
+                exit: (exitCode) => {
+                    process.exitCode = exitCode;
+                },
+            });
+        });
+    });
+}
+//# sourceMappingURL=gameobject.js.map

package/dist/commands/gameobject.js.map

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

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAInF,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;CACxC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,OAAO,EACnB,IAAI,GAAE,eAA4C,GACjD,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBnD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAInF,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;CACxC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,OAAO,EACnB,IAAI,GAAE,eAA4C,GACjD,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBnD"}

package/dist/commands/init.js

@@ -16,7 +16,8 @@ export async function handleInit(opts, jsonOutput, deps = { init: sdkInit, conso
 export function registerInit(program) {
     program
         .command('init')
-        .description('Install the unibridge plugin into a Unity project')
+        .alias('update')
+        .description('Install or update the unibridge plugin into a Unity project (alias: update)')
         .option('--local <path>', 'Install from a local path')
         .option('--git <url>', 'Install from a custom git URL')
         .action(async (opts, command) => {

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,OAAO,EAAqC,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAY3C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAwB,EACxB,UAAmB,EACnB,OAAwB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;IAElD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK;QACvB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;QAC9C,CAAC,CAAC,IAAI,CAAC,GAAG;YACR,CAAC,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;YACzC,CAAC,CAAC,SAAS,CAAA;IAEf,MAAM,aAAa,CACjB,UAAU,EACV,IAAI,EACJ,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAC3B,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACjB,MAAM,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,YAAY,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;QACzE,MAAM,CAAC,GAAG,CAAC,oCAAoC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAA;QACtE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAC9C,CAAC,CACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAAC;SACrD,MAAM,CAAC,aAAa,EAAE,+BAA+B,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,OAAgB,EAAE,EAAE;QAC3D,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,UAAU,CACd,IAAI,EACJ,UAAU,CAAC,IAAI,KAAK,IAAI,EACxB;YACE,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;YAC7E,OAAO;SACR,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,OAAO,EAAqC,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAY3C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAwB,EACxB,UAAmB,EACnB,OAAwB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;IAElD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK;QACvB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;QAC9C,CAAC,CAAC,IAAI,CAAC,GAAG;YACR,CAAC,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;YACzC,CAAC,CAAC,SAAS,CAAA;IAEf,MAAM,aAAa,CACjB,UAAU,EACV,IAAI,EACJ,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAC3B,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACjB,MAAM,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,YAAY,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;QACzE,MAAM,CAAC,GAAG,CAAC,oCAAoC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAA;QACtE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAC9C,CAAC,CACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,KAAK,CAAC,QAAQ,CAAC;SACf,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAAC;SACrD,MAAM,CAAC,aAAa,EAAE,+BAA+B,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,OAAgB,EAAE,EAAE;QAC3D,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,UAAU,CACd,IAAI,EACJ,UAAU,CAAC,IAAI,KAAK,IAAI,EACxB;YACE,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;YAC7E,OAAO;SACR,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/logs.d.ts

@@ -0,0 +1,16 @@
+import type { Command } from 'commander';
+import type { LogsQuery, LogsResult, LogsSeverity } from '@unibridge/sdk';
+interface LogsCommandOptions {
+    severity?: LogsSeverity;
+    limit?: string;
+    offset?: string;
+}
+interface LogsDeps {
+    logs: (query?: LogsQuery) => Promise<LogsResult>;
+    console: Pick<Console, 'log' | 'error'>;
+    exit?: (code: number) => void;
+}
+export declare function handleLogs(opts: LogsCommandOptions, jsonOutput: boolean, deps: LogsDeps): Promise<void>;
+export declare function registerLogs(program: Command): void;
+export {};
+//# sourceMappingURL=logs.d.ts.map

package/dist/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAIzE,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAChD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAiCD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBnD"}

package/dist/commands/logs.js

@@ -0,0 +1,62 @@
+import { runWithOutput } from "./output.js";
+import { withUnityClient } from "./with-unity-client.js";
+function parseIntWithMinimum(value, label, defaultValue, minimum) {
+    if (value == null) {
+        return defaultValue;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < minimum) {
+        if (minimum <= 0) {
+            throw new Error(`${label} must be a non-negative integer.`);
+        }
+        throw new Error(`${label} must be an integer >= ${minimum}.`);
+    }
+    return parsed;
+}
+function parseSeverity(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (value === 'info' || value === 'warn' || value === 'error') {
+        return value;
+    }
+    throw new Error('--severity must be one of: info, warn, error.');
+}
+export async function handleLogs(opts, jsonOutput, deps) {
+    const limit = parseIntWithMinimum(opts.limit, '--limit', 50, 1);
+    const offset = parseIntWithMinimum(opts.offset, '--offset', 0, 0);
+    const query = {
+        severity: parseSeverity(opts.severity),
+        limit,
+        offset,
+    };
+    await runWithOutput(jsonOutput, deps, () => deps.logs(query), (result, output) => {
+        output.log(`Logs: ${result.logs.length} of ${result.total} (limit ${result.limit}, offset ${result.offset})`);
+        for (const entry of result.logs) {
+            output.log(`[${entry.timestamp}] ${entry.severity.toUpperCase()} ${entry.message}`);
+            if (entry.stackTrace && entry.stackTrace.trim().length > 0) {
+                output.log(entry.stackTrace);
+            }
+        }
+    });
+}
+export function registerLogs(program) {
+    program
+        .command('logs')
+        .description('List Unity Editor logs with optional severity filter and pagination')
+        .option('--severity <severity>', 'Filter by severity (info|warn|error)')
+        .option('--limit <number>', 'Number of log entries to return (default: 50)')
+        .option('--offset <number>', 'Offset into the filtered log entries (default: 0)')
+        .action(async (opts, command) => {
+        await withUnityClient(command, { requirePlugin: true }, async (client, ctx) => {
+            await handleLogs(opts, ctx.jsonOutput, {
+                logs: (query) => client.logs(query),
+                console,
+                exit: (exitCode) => {
+                    process.exitCode = exitCode;
+                },
+            });
+        });
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAcxD,SAAS,mBAAmB,CAC1B,KAAyB,EACzB,KAAa,EACb,YAAoB,EACpB,OAAe;IAEf,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;QACjD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAA;QAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,OAAO,GAAG,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAwB,EACxB,UAAmB,EACnB,IAAc;IAEd,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IAC/D,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACjE,MAAM,KAAK,GAAc;QACvB,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;QACtC,KAAK;QACL,MAAM;KACP,CAAA;IAED,MAAM,aAAa,CACjB,UAAU,EACV,IAAI,EACJ,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EACtB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACjB,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,KAAK,YAAY,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;QAC7G,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YACnF,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qEAAqE,CAAC;SAClF,MAAM,CAAC,uBAAuB,EAAE,sCAAsC,CAAC;SACvE,MAAM,CAAC,kBAAkB,EAAE,+CAA+C,CAAC;SAC3E,MAAM,CAAC,mBAAmB,EAAE,mDAAmD,CAAC;SAChF,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,OAAgB,EAAE,EAAE;QAC3D,MAAM,eAAe,CACnB,OAAO,EACP,EAAE,aAAa,EAAE,IAAI,EAAE,EACvB,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE;gBACrC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;gBACnC,OAAO;gBACP,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE;oBACjB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;gBAC7B,CAAC;aACF,CAAC,CAAA;QACJ,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/scene.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from 'commander';
-import type { SceneActiveResult, SceneCreateResult, SceneOpenResult } from '@unibridge/sdk';
+import type { SceneActiveResult, SceneCreateResult, SceneHierarchyQuery, SceneHierarchyResult, SceneListQuery, SceneListResult, SceneOpenResult } from '@unibridge/sdk';
 interface SceneActiveDeps {
     active: () => Promise<SceneActiveResult>;
     console: Pick<Console, 'log' | 'error'>;
@@ -12,6 +12,27 @@ interface SceneOpenDeps {
     exit?: (code: number) => void;
 }
 export declare function handleSceneOpen(path: string, jsonOutput: boolean, deps: SceneOpenDeps): Promise<void>;
+interface SceneListCommandOptions {
+    filter?: string;
+    limit?: string;
+    offset?: string;
+}
+interface SceneListDeps {
+    list: (query?: SceneListQuery) => Promise<SceneListResult>;
+    console: Pick<Console, 'log' | 'error'>;
+    exit?: (code: number) => void;
+}
+interface SceneHierarchyCommandOptions {
+    limit?: string;
+    offset?: string;
+}
+interface SceneHierarchyDeps {
+    hierarchy: (query?: SceneHierarchyQuery) => Promise<SceneHierarchyResult>;
+    console: Pick<Console, 'log' | 'error'>;
+    exit?: (code: number) => void;
+}
+export declare function handleSceneList(opts: SceneListCommandOptions, jsonOutput: boolean, deps: SceneListDeps): Promise<void>;
+export declare function handleSceneHierarchy(opts: SceneHierarchyCommandOptions, jsonOutput: boolean, deps: SceneHierarchyDeps): Promise<void>;
 interface SceneCreateDeps {
     create: (path: string) => Promise<SceneCreateResult>;
     console: Pick<Console, 'log' | 'error'>;

package/dist/commands/scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/commands/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAI3F,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACxC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAChD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACpD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6DpD"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/commands/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAIvB,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACxC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAChD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,UAAU,uBAAuB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1D,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,UAAU,4BAA4B;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,kBAAkB;IAC1B,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACzE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAuBD,wBAAsB,eAAe,CACnC,IAAI,EAAE,uBAAuB,EAC7B,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,4BAA4B,EAClC,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACpD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwGpD"}

package/dist/commands/scene.js

@@ -14,6 +14,45 @@ export async function handleSceneOpen(path, jsonOutput, deps) {
         output.log(`Dirty:   ${result.scene.isDirty ? 'yes' : 'no'}`);
     });
 }
+function parseIntWithMinimum(value, label, defaultValue, minimum) {
+    if (value == null) {
+        return defaultValue;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < minimum) {
+        if (minimum <= 0) {
+            throw new Error(`${label} must be a non-negative integer.`);
+        }
+        throw new Error(`${label} must be an integer >= ${minimum}.`);
+    }
+    return parsed;
+}
+export async function handleSceneList(opts, jsonOutput, deps) {
+    const query = {
+        filter: opts.filter,
+        limit: parseIntWithMinimum(opts.limit, '--limit', 50, 1),
+        offset: parseIntWithMinimum(opts.offset, '--offset', 0, 0),
+    };
+    await runWithOutput(jsonOutput, deps, () => deps.list(query), (result, output) => {
+        output.log(`Scenes: ${result.scenes.length} of ${result.total} (limit ${result.limit}, offset ${result.offset})`);
+        for (const scene of result.scenes) {
+            output.log(`${scene.path}`);
+        }
+    });
+}
+export async function handleSceneHierarchy(opts, jsonOutput, deps) {
+    const query = {
+        limit: parseIntWithMinimum(opts.limit, '--limit', 200, 1),
+        offset: parseIntWithMinimum(opts.offset, '--offset', 0, 0),
+    };
+    await runWithOutput(jsonOutput, deps, () => deps.hierarchy(query), (result, output) => {
+        output.log(`Hierarchy: ${result.nodes.length} of ${result.total} (limit ${result.limit}, offset ${result.offset})`);
+        for (const node of result.nodes) {
+            const indent = '  '.repeat(node.depth);
+            output.log(`${indent}${node.path} (${node.isActive ? 'active' : 'inactive'}) [id=${node.instanceId}, sibling=${node.siblingIndex}]`);
+        }
+    });
+}
 export async function handleSceneCreate(path, jsonOutput, deps) {
     await runWithOutput(jsonOutput, deps, () => deps.create(path), (result, output) => {
         output.log(`Name:    ${result.scene.name}`);
@@ -39,6 +78,39 @@ export function registerScene(program) {
             });
         });
     });
+    scene
+        .command('list')
+        .description('List scenes in the project with pagination')
+        .option('--filter <text>', 'Filter by scene path substring')
+        .option('--limit <number>', 'Number of scenes to return (default: 50)')
+        .option('--offset <number>', 'Offset into filtered scenes (default: 0)')
+        .action(async (opts, command) => {
+        await withUnityClient(command, { requirePlugin: true }, async (client, ctx) => {
+            await handleSceneList(opts, ctx.jsonOutput, {
+                list: (query) => client.sceneList(query),
+                console,
+                exit: (exitCode) => {
+                    process.exitCode = exitCode;
+                },
+            });
+        });
+    });
+    scene
+        .command('hierarchy')
+        .description('List the active scene hierarchy as a paginated flattened tree')
+        .option('--limit <number>', 'Number of hierarchy nodes to return (default: 200)')
+        .option('--offset <number>', 'Offset into hierarchy nodes (default: 0)')
+        .action(async (opts, command) => {
+        await withUnityClient(command, { requirePlugin: true }, async (client, ctx) => {
+            await handleSceneHierarchy(opts, ctx.jsonOutput, {
+                hierarchy: (query) => client.sceneHierarchy(query),
+                console,
+                exit: (exitCode) => {
+                    process.exitCode = exitCode;
+                },
+            });
+        });
+    });
     scene
         .command('create <path>')
         .description('Create a new scene at a project-relative path')