@flui-cloud/cli 0.0.1

package/lib/cli/src/commands/app/snapshot/list.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../../lib/resolve-cluster");
+const format_bytes_1 = require("../../../lib/format-bytes");
+class AppSnapshotList extends core_1.Command {
+    async run() {
+        const { flags } = await this.parse(AppSnapshotList);
+        const spinner = (0, ora_1.default)('Fetching snapshots...').start();
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            let items;
+            if (flags.app) {
+                const app = await service.getAppByName(flags.app);
+                items = await service.listAppSnapshots(app.id);
+            }
+            else {
+                items = await service.listClusterSnapshots();
+            }
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(items, null, 2));
+                return;
+            }
+            if (items.length === 0) {
+                console.log(chalk_1.default.dim('  No snapshots found.'));
+                return;
+            }
+            console.log('');
+            console.log(`  ${chalk_1.default.bold('EXPORT ID'.padEnd(48))} ${chalk_1.default.bold('SINK'.padEnd(12))} ${chalk_1.default.bold('REQ'.padEnd(7))} ${chalk_1.default.bold('USED'.padEnd(10))} ${chalk_1.default.bold('READY'.padEnd(6))} ${chalk_1.default.bold('SOURCE PVC')}`);
+            console.log('  ' + '─'.repeat(130));
+            for (const s of items) {
+                const id = s.exportId.padEnd(48).slice(0, 48);
+                const sink = s.sink.padEnd(12);
+                const size = (s.sizeGb === undefined ? '—' : `${s.sizeGb}Gi`).padEnd(7);
+                const used = (s.actualBytes === undefined ? '—' : (0, format_bytes_1.formatBytes)(s.actualBytes)).padEnd(10);
+                const ready = (s.ready ? chalk_1.default.green('OK') : chalk_1.default.yellow('..')).padEnd(6);
+                const src = s.sourcePvcName ?? '—';
+                console.log(`  ${id} ${sink} ${size} ${used} ${ready} ${src}`);
+            }
+            console.log('');
+            console.log(chalk_1.default.dim(`  ${items.length} snapshot(s) total`));
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to list snapshots');
+            const msg = error.response?.data?.message ?? error.message ?? String(error);
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppSnapshotList.description = 'List volume snapshots. ' +
+    'Use --app to filter to a single app, omit to list cluster-wide.';
+AppSnapshotList.examples = [
+    '<%= config.bin %> <%= command.id %>',
+    '<%= config.bin %> <%= command.id %> --app my-app',
+];
+AppSnapshotList.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect)',
+    }),
+    app: core_1.Flags.string({
+        char: 'a',
+        description: 'Filter by application name or slug',
+    }),
+    output: core_1.Flags.string({
+        char: 'o',
+        description: 'Output format',
+        options: ['table', 'json'],
+        default: 'table',
+    }),
+};
+exports.default = AppSnapshotList;

package/lib/cli/src/commands/app/snapshot/restore.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class AppSnapshotRestore extends Command {
+    static readonly description = "Restore a snapshot into a new side-by-side PVC. The application is not touched \u2014 the new PVC is created in the same namespace and can be promoted later with `flui app snapshot swap`.";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        snapshotId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        swap: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        volume: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/cli/src/commands/app/snapshot/restore.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../../lib/resolve-cluster");
+class AppSnapshotRestore extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppSnapshotRestore);
+        const spinner = (0, ora_1.default)(`Restoring snapshot ${args.snapshotId}...`).start();
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            const app = await service.getAppByName(args.name);
+            const result = await service.restoreAppSnapshot(app.id, args.snapshotId);
+            spinner.succeed(`Restored to new PVC: ${result.newPvcName}`);
+            console.log('');
+            console.log(`  ${chalk_1.default.bold('App:')}        ${app.name}`);
+            console.log(`  ${chalk_1.default.bold('From snap:')}  ${args.snapshotId}`);
+            console.log(`  ${chalk_1.default.bold('New PVC:')}    ${result.newPvcName}`);
+            if (flags.swap) {
+                const volumeName = flags.volume ?? 'data';
+                const swapSpinner = (0, ora_1.default)(`Swapping volume "${volumeName}" to ${result.newPvcName}...`).start();
+                await service.swapAppVolume(app.id, volumeName, result.newPvcName);
+                swapSpinner.succeed('Volume swapped, rollout triggered');
+                console.log(chalk_1.default.dim(`\n  Old PVC kept as backup. Use \`flui env kubectl get pvc -n <ns>\` to inspect, delete when no longer needed.`));
+            }
+            else {
+                console.log('');
+                console.log(chalk_1.default.dim('  Next steps:'));
+                console.log(chalk_1.default.dim(`  flui app snapshot swap ${app.name} ${result.newPvcName}`));
+            }
+        }
+        catch (error) {
+            spinner.fail('Restore failed');
+            const msg = error.response?.data?.message ?? error.message ?? String(error);
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppSnapshotRestore.description = 'Restore a snapshot into a new side-by-side PVC. The application is not touched — the new PVC is created in the same namespace and can be promoted later with `flui app snapshot swap`.';
+AppSnapshotRestore.examples = [
+    '<%= config.bin %> <%= command.id %> my-app my-app-snap-20260510-abcdef',
+    '<%= config.bin %> <%= command.id %> my-app my-app-snap-... --swap',
+];
+AppSnapshotRestore.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+    snapshotId: core_1.Args.string({
+        description: 'Snapshot id (from `flui app snapshot list`)',
+        required: true,
+    }),
+};
+AppSnapshotRestore.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect)',
+    }),
+    swap: core_1.Flags.boolean({
+        description: 'Immediately swap the restored PVC into the live application (rolling restart). Old PVC is preserved as a backup.',
+    }),
+    volume: core_1.Flags.string({
+        char: 'v',
+        description: 'Application volume name to swap when --swap is set. Required if the app has multiple volumes.',
+    }),
+};
+exports.default = AppSnapshotRestore;

package/lib/cli/src/commands/app/snapshot/swap.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class AppSnapshotSwap extends Command {
+    static readonly description = "Swap the application volume to a different PVC (typically one created by `flui app snapshot restore`). Triggers a rolling restart. The previous PVC is preserved as a backup.";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        newPvcName: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        volume: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/lib/cli/src/commands/app/snapshot/swap.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../../lib/resolve-cluster");
+const prompts_1 = require("../../../lib/prompts");
+class AppSnapshotSwap extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppSnapshotSwap);
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            const app = await service.getAppByName(args.name);
+            const volumeName = flags.volume ?? 'data';
+            if (!flags.force) {
+                const ok = await (0, prompts_1.confirmPrompt)(`Swap volume "${volumeName}" of "${args.name}" to PVC "${args.newPvcName}"? This triggers a rolling restart.`);
+                if (!ok) {
+                    console.log(chalk_1.default.dim('  Aborted.'));
+                    return;
+                }
+            }
+            const spinner = (0, ora_1.default)(`Swapping ${volumeName} → ${args.newPvcName}...`).start();
+            await service.swapAppVolume(app.id, volumeName, args.newPvcName);
+            spinner.succeed('Swap applied, rolling restart triggered');
+            console.log(chalk_1.default.dim(`\n  Old PVC kept as backup. Use \`flui env kubectl get pvc -n <ns>\` to inspect, delete when ready.`));
+        }
+        catch (error) {
+            const msg = error.response?.data?.message ?? error.message ?? String(error);
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppSnapshotSwap.description = 'Swap the application volume to a different PVC (typically one created by `flui app snapshot restore`). Triggers a rolling restart. The previous PVC is preserved as a backup.';
+AppSnapshotSwap.examples = [
+    '<%= config.bin %> <%= command.id %> my-app my-app-data-restored-20260511',
+    '<%= config.bin %> <%= command.id %> my-app new-pvc --volume data --force',
+];
+AppSnapshotSwap.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+    newPvcName: core_1.Args.string({
+        description: 'PVC name to swap into the application',
+        required: true,
+    }),
+};
+AppSnapshotSwap.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect)',
+    }),
+    volume: core_1.Flags.string({
+        char: 'v',
+        description: 'Application volume name (default: the single volume)',
+    }),
+    force: core_1.Flags.boolean({
+        char: 'f',
+        description: 'Skip confirmation',
+    }),
+};
+exports.default = AppSnapshotSwap;

package/lib/cli/src/commands/app/start.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class AppStart extends Command {
+    static readonly description = "Start a stopped application";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/cli/src/commands/app/start.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../lib/resolve-cluster");
+class AppStart extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppStart);
+        const spinner = (0, ora_1.default)(`Starting "${args.name}"...`).start();
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            const app = await service.getAppByName(args.name);
+            await service.start(app.id);
+            spinner.succeed(`"${args.name}" started`);
+            console.log(chalk_1.default.dim('\n  Pods are coming up. Check status with:'));
+            console.log(chalk_1.default.cyan(`  flui app status ${args.name}\n`));
+        }
+        catch (error) {
+            spinner.fail('Failed to start application');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppStart.description = 'Start a stopped application';
+AppStart.examples = ['<%= config.bin %> <%= command.id %> my-api'];
+AppStart.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppStart.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+};
+exports.default = AppStart;

package/lib/cli/src/commands/app/status.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class AppStatus extends Command {
+    static readonly description = "Show live runtime status of an application";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private printContainer;
+    private colorStatus;
+}

package/lib/cli/src/commands/app/status.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../lib/resolve-cluster");
+class AppStatus extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppStatus);
+        const spinner = (0, ora_1.default)(`Fetching status for "${args.name}"...`).start();
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            const app = await service.getAppByName(args.name);
+            const runtime = await service.getRuntime(app.id);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify({ app, runtime }, null, 2));
+                return;
+            }
+            console.log(chalk_1.default.cyan(`\n  ${app.name}\n`));
+            console.log(`  ${chalk_1.default.bold('ID:')}         ${app.id}`);
+            console.log(`  ${chalk_1.default.bold('Status:')}     ${this.colorStatus(app.status)}`);
+            console.log(`  ${chalk_1.default.bold('Kind:')}       ${(app.kind || '').toLowerCase()}`);
+            console.log(`  ${chalk_1.default.bold('Exposure:')}   ${(app.exposure || '').toLowerCase()}`);
+            if (app.lastDeployedAt) {
+                console.log(`  ${chalk_1.default.bold('Deployed:')}   ${new Date(app.lastDeployedAt).toLocaleString()}`);
+            }
+            console.log(chalk_1.default.cyan('\n  Replicas\n'));
+            const r = runtime.replicas;
+            const ready = r.ready ?? 0;
+            const desired = r.desired ?? 0;
+            const replicaColor = ready === desired && desired > 0 ? chalk_1.default.green : chalk_1.default.yellow;
+            console.log(`  ${chalk_1.default.bold('Desired:')}    ${desired}`);
+            console.log(`  ${chalk_1.default.bold('Ready:')}      ${replicaColor(String(ready))}`);
+            if (r.unavailable) {
+                console.log(`  ${chalk_1.default.bold('Unavailable:')} ${chalk_1.default.red(String(r.unavailable))}`);
+            }
+            if (runtime.containers.length > 0) {
+                console.log(chalk_1.default.cyan('\n  Containers\n'));
+                for (const c of runtime.containers)
+                    this.printContainer(c);
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch status');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+    printContainer(c) {
+        console.log(`  ${chalk_1.default.bold(c.name)}`);
+        console.log(`    ${chalk_1.default.dim('image:')}   ${c.image}`);
+        const req = c.requests;
+        const lim = c.limits;
+        if (req.cpu || req.memory) {
+            console.log(`    ${chalk_1.default.dim('requests:')} cpu=${req.cpu ?? '-'}  mem=${req.memory ?? '-'}`);
+        }
+        if (lim.cpu || lim.memory) {
+            console.log(`    ${chalk_1.default.dim('limits:')}   cpu=${lim.cpu ?? '-'}  mem=${lim.memory ?? '-'}`);
+        }
+        if (c.usage) {
+            const u = c.usage;
+            console.log(`    ${chalk_1.default.dim('usage:')}    cpu=${u.cpu ?? '-'}  mem=${u.memory ?? '-'}`);
+        }
+    }
+    colorStatus(status) {
+        const s = status.toLowerCase();
+        if (s === 'running')
+            return chalk_1.default.green(status);
+        if (s === 'stopped')
+            return chalk_1.default.yellow(status);
+        if (s === 'failed' || s === 'degraded')
+            return chalk_1.default.red(status);
+        if (s === 'provisioning' || s === 'updating')
+            return chalk_1.default.blue(status);
+        return chalk_1.default.dim(status);
+    }
+}
+AppStatus.description = 'Show live runtime status of an application';
+AppStatus.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --output json',
+];
+AppStatus.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppStatus.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+    output: core_1.Flags.string({
+        char: 'o',
+        description: 'Output format',
+        options: ['table', 'json'],
+        default: 'table',
+    }),
+};
+exports.default = AppStatus;

package/lib/cli/src/commands/app/stop.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class AppStop extends Command {
+    static readonly description = "Stop an application (scale to 0 replicas)";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/cli/src/commands/app/stop.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../lib/resolve-cluster");
+class AppStop extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppStop);
+        const spinner = (0, ora_1.default)(`Stopping "${args.name}"...`).start();
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            const app = await service.getAppByName(args.name);
+            await service.stop(app.id);
+            spinner.succeed(`"${args.name}" stopped (0 replicas)`);
+            const startCmd = chalk_1.default.cyan(`flui app start ${args.name}`);
+            console.log(chalk_1.default.dim(`\n  Run ${startCmd} to bring it back up.\n`));
+        }
+        catch (error) {
+            spinner.fail('Failed to stop application');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppStop.description = 'Stop an application (scale to 0 replicas)';
+AppStop.examples = ['<%= config.bin %> <%= command.id %> my-api'];
+AppStop.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppStop.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+};
+exports.default = AppStop;

package/lib/cli/src/commands/app/versions.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class AppVersions extends Command {
+    static readonly description = "List image versions available in the registry for an application, with deployment & release status";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/cli/src/commands/app/versions.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_app_service_1 = require("../../lib/services/cli-app.service");
+const resolve_cluster_1 = require("../../lib/resolve-cluster");
+class AppVersions extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppVersions);
+        const spinner = (0, ora_1.default)(`Fetching versions for "${args.name}"...`).start();
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            const service = await cli_app_service_1.CliAppService.create(clusterId);
+            const app = await service.getAppByName(args.name);
+            const data = await service.listAvailableVersions(app.id);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            console.log(chalk_1.default.cyan(`\n  Versions — ${app.name}\n`));
+            console.log(`  ${chalk_1.default.bold('Source:')}  ${data.sourceType}`);
+            console.log(`  ${chalk_1.default.bold('Current:')} ${data.currentImageRef ?? chalk_1.default.dim('—')}`);
+            console.log('');
+            const versions = data.versions.slice(0, flags.limit);
+            if (versions.length === 0) {
+                console.log(chalk_1.default.yellow('  No versions found.\n'));
+                return;
+            }
+            console.log(chalk_1.default.dim(`  ${'TAG'.padEnd(20)} ${'DIGEST'.padEnd(15)} ${'CREATED'.padEnd(20)} ${'RELEASES'.padEnd(10)} STATE`));
+            console.log(chalk_1.default.dim('  ' + '─'.repeat(100)));
+            for (const v of versions) {
+                const tag = (v.tag ?? '').padEnd(20);
+                const digest = (v.digest ? v.digest.replace('sha256:', '').slice(0, 12) : '').padEnd(15);
+                const created = (v.createdAt ? new Date(v.createdAt).toLocaleString() : '-').padEnd(20);
+                const rc = String(v.releaseCount).padEnd(10);
+                const flags = [];
+                if (v.isCurrentlyDeployed)
+                    flags.push(chalk_1.default.green('deployed'));
+                if (v.isLatestRelease && !v.isCurrentlyDeployed)
+                    flags.push(chalk_1.default.yellow('latest-release'));
+                if (v.lastRelease?.status === 'FAILED')
+                    flags.push(chalk_1.default.red('last-failed'));
+                const state = flags.join(' ');
+                console.log(`  ${tag} ${digest} ${created} ${rc} ${state}`);
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch versions');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppVersions.description = 'List image versions available in the registry for an application, with deployment & release status';
+AppVersions.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --output json',
+];
+AppVersions.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppVersions.flags = {
+    cluster: core_1.Flags.string({ char: 'c' }),
+    output: core_1.Flags.string({
+        char: 'o',
+        options: ['table', 'json'],
+        default: 'table',
+    }),
+    limit: core_1.Flags.integer({ char: 'n', default: 20 }),
+};
+exports.default = AppVersions;

package/lib/cli/src/commands/auth/generate-api-key.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class AuthGenerateApiKey extends Command {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        token: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        expires: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        profile: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}