@flui-cloud/cli 0.0.1

package/lib/cli/src/commands/app/backup/create.js

@@ -0,0 +1,128 @@
+"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 AppBackupCreate extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppBackupCreate);
+        let destination;
+        if (flags.bucket) {
+            if (!flags.endpoint) {
+                this.error('--endpoint is required when --bucket is set');
+            }
+            if (!flags['access-key'] || !flags['secret-key']) {
+                this.error('S3 credentials missing. Pass --access-key/--secret-key or set FLUI_S3_ACCESS_KEY/FLUI_S3_SECRET_KEY.');
+            }
+            destination = {
+                bucket: flags.bucket,
+                endpoint: flags.endpoint,
+                region: flags.region,
+                accessKeyId: flags['access-key'],
+                secretAccessKey: flags['secret-key'],
+                keyPrefix: flags['key-prefix'],
+            };
+        }
+        const target = destination
+            ? `s3://${destination.bucket}`
+            : 'auto-provisioned bucket';
+        const spinner = (0, ora_1.default)(`Backing up "${args.name}" to ${target}...`).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 backup = await service.createAppBackup(app.id, {
+                volumeName: flags.volume,
+                description: flags.description,
+                destination,
+            });
+            spinner.succeed(`Backup uploaded: ${backup.exportId}`);
+            console.log('');
+            console.log(`  ${chalk_1.default.bold('Provider:')}  ${backup.provider}`);
+            console.log(`  ${chalk_1.default.bold('Namespace:')} ${backup.namespace}`);
+            console.log(`  ${chalk_1.default.bold('Source:')}    ${backup.sourcePvcName}`);
+            console.log(`  ${chalk_1.default.bold('Source request:')}  ${backup.sizeGb} GiB`);
+            const uploaded = backup.actualBytes === undefined
+                ? 'unknown'
+                : (0, format_bytes_1.formatBytes)(backup.actualBytes);
+            console.log(`  ${chalk_1.default.bold('Uploaded:')}        ${uploaded}`);
+            console.log(`  ${chalk_1.default.bold('Bucket:')}    ${backup.destination.bucket}`);
+            console.log(`  ${chalk_1.default.bold('Endpoint:')}  ${backup.destination.endpoint}`);
+            console.log(`  ${chalk_1.default.bold('Prefix:')}    ${backup.exportId}`);
+            console.log(`  ${chalk_1.default.bold('Created:')}   ${backup.createdAt}`);
+            console.log('');
+            if (!destination) {
+                console.log(chalk_1.default.dim(`  Bucket auto-provisioned by ${backup.provider} object storage.`));
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Backup failed');
+            const msg = error.response?.data?.message ?? error.message ?? String(error);
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppBackupCreate.description = 'Archive an application volume to S3-compatible object storage. ' +
+    'When --bucket is omitted the cluster provider auto-provisions one ' +
+    '(Scaleway: full-auto using your compute key; Hetzner: requires Object ' +
+    'Storage credentials connected). Otherwise pass an explicit endpoint + ' +
+    '--bucket and S3 credentials via flags or FLUI_S3_ACCESS_KEY/FLUI_S3_SECRET_KEY env.';
+AppBackupCreate.examples = [
+    '<%= config.bin %> <%= command.id %> my-app',
+    '<%= config.bin %> <%= command.id %> my-app --description nightly',
+    '<%= config.bin %> <%= command.id %> my-app -b external-bucket -e https://s3.eu-central-1.amazonaws.com -r eu-central-1',
+];
+AppBackupCreate.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppBackupCreate.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect)',
+    }),
+    volume: core_1.Flags.string({
+        char: 'v',
+        description: 'Volume (PVC) name when the app has multiple volumes. Required if more than one PVC exists.',
+    }),
+    description: core_1.Flags.string({
+        char: 'd',
+        description: 'Optional human-friendly tag appended to the key prefix',
+    }),
+    bucket: core_1.Flags.string({
+        char: 'b',
+        description: 'Destination S3 bucket name. Omit to auto-provision via the cluster provider.',
+    }),
+    endpoint: core_1.Flags.string({
+        char: 'e',
+        description: 'S3 endpoint URL (required when --bucket is set). Examples: ' +
+            'https://s3.fr-par.scw.cloud, https://s3.eu-central-1.amazonaws.com',
+    }),
+    region: core_1.Flags.string({
+        char: 'r',
+        description: 'S3 region',
+        default: 'auto',
+    }),
+    'access-key': core_1.Flags.string({
+        description: 'S3 access key. Defaults to FLUI_S3_ACCESS_KEY env var.',
+        env: 'FLUI_S3_ACCESS_KEY',
+    }),
+    'secret-key': core_1.Flags.string({
+        description: 'S3 secret key. Defaults to FLUI_S3_SECRET_KEY env var.',
+        env: 'FLUI_S3_SECRET_KEY',
+    }),
+    'key-prefix': core_1.Flags.string({
+        description: 'Override the destination key prefix (default: flui/<cluster>/<app>/<timestamp>/)',
+    }),
+};
+exports.default = AppBackupCreate;

package/lib/cli/src/commands/app/backup/delete.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+export default class AppBackupDelete extends Command {
+    static readonly description = "Delete an S3 backup of an application. Removes all objects under the export key prefix.";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        exportId: 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>;
+        bucket: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        endpoint: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        region: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'access-key': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'secret-key': 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/backup/delete.js

@@ -0,0 +1,95 @@
+"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 AppBackupDelete extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppBackupDelete);
+        if (!flags['access-key'] || !flags['secret-key']) {
+            this.error('S3 credentials missing. Pass --access-key/--secret-key or set FLUI_S3_ACCESS_KEY/FLUI_S3_SECRET_KEY.');
+        }
+        if (!flags.force) {
+            const ok = await (0, prompts_1.confirmPrompt)(`Delete backup "${args.exportId}" from s3://${flags.bucket}?`);
+            if (!ok) {
+                console.log(chalk_1.default.dim('  Aborted.'));
+                return;
+            }
+        }
+        const destination = {
+            bucket: flags.bucket,
+            endpoint: flags.endpoint,
+            region: flags.region,
+            accessKeyId: flags['access-key'],
+            secretAccessKey: flags['secret-key'],
+        };
+        const spinner = (0, ora_1.default)(`Deleting backup ${args.exportId}...`).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.deleteAppBackup(app.id, args.exportId, destination);
+            spinner.succeed(`Deleted backup ${args.exportId}`);
+        }
+        catch (error) {
+            spinner.fail('Backup deletion failed');
+            const msg = error.response?.data?.message ?? error.message ?? String(error);
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppBackupDelete.description = 'Delete an S3 backup of an application. Removes all objects under the export key prefix.';
+AppBackupDelete.examples = [
+    '<%= config.bin %> <%= command.id %> my-app flui/<cluster>/<app>/20260510170000-abc123 -b my-bucket -e https://s3.fr-par.scw.cloud',
+];
+AppBackupDelete.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+    exportId: core_1.Args.string({
+        description: 'Export id (S3 key prefix) returned by `flui app backup create`',
+        required: true,
+    }),
+};
+AppBackupDelete.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect)',
+    }),
+    bucket: core_1.Flags.string({
+        char: 'b',
+        description: 'S3 bucket where the backup lives',
+        required: true,
+    }),
+    endpoint: core_1.Flags.string({
+        char: 'e',
+        description: 'S3 endpoint URL',
+        required: true,
+    }),
+    region: core_1.Flags.string({
+        char: 'r',
+        description: 'S3 region',
+        default: 'auto',
+    }),
+    'access-key': core_1.Flags.string({
+        description: 'S3 access key id (defaults to FLUI_S3_ACCESS_KEY env)',
+        env: 'FLUI_S3_ACCESS_KEY',
+    }),
+    'secret-key': core_1.Flags.string({
+        description: 'S3 secret access key (defaults to FLUI_S3_SECRET_KEY env)',
+        env: 'FLUI_S3_SECRET_KEY',
+    }),
+    force: core_1.Flags.boolean({
+        char: 'f',
+        description: 'Skip confirmation',
+    }),
+};
+exports.default = AppBackupDelete;

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

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class AppBuild extends Command {
+    static readonly description: string;
+    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>;
+        refresh: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        watch: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        interval: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private printBuild;
+}

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

@@ -0,0 +1,133 @@
+"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 TERMINAL = new Set([
+    'COMPLETED',
+    'FAILED',
+    'CANCELLED',
+]);
+class AppBuild extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppBuild);
+        const spinner = (0, ora_1.default)(`Fetching latest build 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);
+            let build = await service.getLatestBuild(app.id);
+            if (!build) {
+                spinner.stop();
+                console.log(chalk_1.default.yellow(`\n  No builds found for ${app.name}.\n`));
+                return;
+            }
+            if (flags.refresh) {
+                spinner.text = 'Refreshing from provider...';
+                build = await service.refreshBuild(build.id);
+            }
+            if (!flags.watch) {
+                spinner.stop();
+                if (flags.output === 'json') {
+                    console.log(JSON.stringify(build, null, 2));
+                }
+                else {
+                    this.printBuild(app.name, build);
+                }
+                return;
+            }
+            // Watch mode
+            while (!TERMINAL.has(build.status)) {
+                spinner.text = `Build ${build.status.toLowerCase()}... (${new Date().toLocaleTimeString()})`;
+                await sleep(flags.interval * 1000);
+                try {
+                    build = await service.refreshBuild(build.id);
+                }
+                catch {
+                    // Fallback to plain GET if refresh fails transiently
+                    build = await service.getBuild(build.id);
+                }
+            }
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(build, null, 2));
+            }
+            else {
+                this.printBuild(app.name, build);
+            }
+            if (build.status !== 'COMPLETED')
+                this.exit(1);
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch build');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+    printBuild(appName, b) {
+        console.log(chalk_1.default.cyan(`\n  Latest build — ${appName}\n`));
+        console.log(`  ${chalk_1.default.bold('ID:')}        ${b.id}`);
+        console.log(`  ${chalk_1.default.bold('Status:')}    ${colorStatus(b.status)}`);
+        console.log(`  ${chalk_1.default.bold('Provider:')}  ${b.provider}`);
+        console.log(`  ${chalk_1.default.bold('Branch:')}    ${b.branch}`);
+        if (b.commitSha)
+            console.log(`  ${chalk_1.default.bold('Commit:')}    ${b.commitSha.slice(0, 12)}`);
+        if (b.imageRef)
+            console.log(`  ${chalk_1.default.bold('Image:')}     ${b.imageRef}`);
+        if (b.externalUrl)
+            console.log(`  ${chalk_1.default.bold('Run URL:')}   ${chalk_1.default.dim(b.externalUrl)}`);
+        if (b.errorMessage)
+            console.log(`  ${chalk_1.default.bold('Error:')}     ${chalk_1.default.red(b.errorMessage)}`);
+        console.log('');
+    }
+}
+AppBuild.description = 'Inspect or refresh the latest build for an application. ' +
+    'Use --watch to follow the status until terminal.';
+AppBuild.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --watch',
+    '<%= config.bin %> <%= command.id %> my-api --refresh',
+];
+AppBuild.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppBuild.flags = {
+    cluster: core_1.Flags.string({ char: 'c' }),
+    output: core_1.Flags.string({
+        char: 'o',
+        options: ['text', 'json'],
+        default: 'text',
+    }),
+    refresh: core_1.Flags.boolean({
+        description: 'Force the backend to re-poll GitHub Actions for the latest build now',
+    }),
+    watch: core_1.Flags.boolean({
+        char: 'w',
+        description: 'Poll until the latest build reaches a terminal status (COMPLETED / FAILED / CANCELLED)',
+    }),
+    interval: core_1.Flags.integer({
+        description: 'Polling interval in seconds (with --watch)',
+        default: 5,
+    }),
+};
+exports.default = AppBuild;
+function colorStatus(s) {
+    if (s === 'COMPLETED')
+        return chalk_1.default.green(s);
+    if (s === 'FAILED' || s === 'CANCELLED')
+        return chalk_1.default.red(s);
+    if (s === 'PENDING')
+        return chalk_1.default.dim(s);
+    return chalk_1.default.blue(s);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class AppBuilds extends Command {
+    static readonly description = "List recent builds for 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>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/cli/src/commands/app/builds.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");
+class AppBuilds extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppBuilds);
+        const spinner = (0, ora_1.default)(`Fetching builds 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 builds = (await service.listBuilds(app.id)).slice(0, flags.limit);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(builds, null, 2));
+                return;
+            }
+            if (builds.length === 0) {
+                console.log(chalk_1.default.yellow(`\n  No builds found for ${app.name}.\n`));
+                return;
+            }
+            console.log(chalk_1.default.cyan(`\n  Builds for ${app.name}\n`));
+            console.log(chalk_1.default.dim(`  ${'STATUS'.padEnd(11)} ${'PROVIDER'.padEnd(16)} ${'BRANCH'.padEnd(14)} ${'COMMIT'.padEnd(10)} ${'STARTED'.padEnd(20)} URL`));
+            console.log(chalk_1.default.dim('  ' + '─'.repeat(100)));
+            for (const b of builds) {
+                const status = colorBuildStatus(b.status ?? 'PENDING').padEnd(20);
+                const provider = (b.provider ?? '-').padEnd(16);
+                const branch = (b.branch ?? '-').padEnd(14);
+                const commit = ((b.commitSha ?? '').slice(0, 7) || '-').padEnd(10);
+                const started = b.startedAt
+                    ? new Date(b.startedAt).toLocaleString().padEnd(20)
+                    : chalk_1.default.dim('-'.padEnd(20));
+                const url = b.externalUrl ?? '';
+                console.log(`  ${status} ${provider} ${branch} ${commit} ${started} ${chalk_1.default.dim(url)}`);
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch builds');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppBuilds.description = 'List recent builds for an application';
+AppBuilds.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --output json',
+    '<%= config.bin %> <%= command.id %> my-api --limit 5',
+];
+AppBuilds.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppBuilds.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: 10 }),
+};
+exports.default = AppBuilds;
+function colorBuildStatus(s) {
+    if (s === 'COMPLETED')
+        return chalk_1.default.green(s);
+    if (s === 'FAILED' || s === 'CANCELLED')
+        return chalk_1.default.red(s);
+    if (s === 'PENDING')
+        return chalk_1.default.dim(s);
+    return chalk_1.default.blue(s);
+}

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

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class AppCrash extends Command {
+    static readonly description = "Show a single crash diagnosis. Use --dismiss to mark it resolved.";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        id: 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>;
+        dismiss: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private colorSeverity;
+}

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

@@ -0,0 +1,106 @@
+"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 AppCrash extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppCrash);
+        const verb = flags.dismiss ? 'Dismissing' : 'Fetching';
+        const spinner = (0, ora_1.default)(`${verb} crash ${args.id}...`).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 d = flags.dismiss
+                ? await service.dismissCrash(app.id, args.id)
+                : await service.getCrash(app.id, args.id);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(d, null, 2));
+                return;
+            }
+            if (flags.dismiss) {
+                console.log(chalk_1.default.green(`\n  ✔ Crash ${d.id} marked as resolved.\n`));
+                return;
+            }
+            console.log(chalk_1.default.cyan(`\n  Crash ${d.id}\n`));
+            console.log(`  ${chalk_1.default.dim('title:')}      ${d.title}`);
+            console.log(`  ${chalk_1.default.dim('category:')}   ${d.category}`);
+            console.log(`  ${chalk_1.default.dim('severity:')}   ${this.colorSeverity(d.severity)}`);
+            console.log(`  ${chalk_1.default.dim('pod:')}        ${d.podName}`);
+            if (d.containerName) {
+                console.log(`  ${chalk_1.default.dim('container:')}  ${d.containerName}`);
+            }
+            console.log(`  ${chalk_1.default.dim('detected:')}   ${new Date(d.createdAt).toLocaleString()}`);
+            console.log(`  ${chalk_1.default.dim('resolved:')}   ${d.resolvedAt ? new Date(d.resolvedAt).toLocaleString() : chalk_1.default.yellow('open')}`);
+            if (d.explanation) {
+                console.log(`\n  ${chalk_1.default.bold('Reason')}`);
+                console.log(`  ${d.explanation}`);
+            }
+            const action = d.suggestedAction;
+            if (action?.summary) {
+                console.log(`\n  ${chalk_1.default.bold('Suggested action')}`);
+                console.log(`  ${action.summary}`);
+                if (Array.isArray(action.steps)) {
+                    for (const step of action.steps)
+                        console.log(`    • ${step}`);
+                }
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail(`${verb} failed`);
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+    colorSeverity(severity) {
+        switch (severity) {
+            case 'critical':
+                return chalk_1.default.red(severity);
+            case 'warning':
+                return chalk_1.default.yellow(severity);
+            default:
+                return chalk_1.default.dim(severity);
+        }
+    }
+}
+AppCrash.description = 'Show a single crash diagnosis. Use --dismiss to mark it resolved.';
+AppCrash.examples = [
+    '<%= config.bin %> <%= command.id %> my-api 5d3f...',
+    '<%= config.bin %> <%= command.id %> my-api 5d3f... --dismiss',
+    '<%= config.bin %> <%= command.id %> my-api 5d3f... --output json',
+];
+AppCrash.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+    id: core_1.Args.string({
+        description: 'Crash diagnosis ID',
+        required: true,
+    }),
+};
+AppCrash.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+    dismiss: core_1.Flags.boolean({
+        description: 'Mark this crash diagnosis as resolved',
+        default: false,
+    }),
+    output: core_1.Flags.string({
+        char: 'o',
+        description: 'Output format',
+        options: ['table', 'json'],
+        default: 'table',
+    }),
+};
+exports.default = AppCrash;

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

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class AppCrashes extends Command {
+    static readonly description = "Show recent crash diagnoses for 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 printActiveDiagnosis;
+    private colorSeverity;
+}