@flui-cloud/cli 0.0.1

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

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class AppMetrics extends Command {
+    static readonly description = "Show instant Prometheus metrics (CPU/mem/network/replicas) 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 fmtCores;
+    private fmtBytes;
+    private fmtRate;
+    private fmtPct;
+}

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

@@ -0,0 +1,100 @@
+"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 AppMetrics extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppMetrics);
+        const spinner = (0, ora_1.default)(`Fetching metrics 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 res = await service.getMetrics(app.id);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            const m = res.metrics;
+            console.log(chalk_1.default.cyan(`\n  Metrics — ${res.app_name}`));
+            console.log(chalk_1.default.dim(`  namespace=${res.namespace}  queried=${new Date(res.queried_at).toLocaleString()}\n`));
+            console.log(chalk_1.default.bold('  CPU'));
+            console.log(`    usage      ${this.fmtCores(m.cpu.usage_cores)}  /  req ${this.fmtCores(m.cpu.requests_cores)}  /  lim ${this.fmtCores(m.cpu.limits_cores)}`);
+            console.log(`    utilization ${this.fmtPct(m.cpu.utilization_percent)}\n`);
+            console.log(chalk_1.default.bold('  Memory'));
+            console.log(`    usage      ${this.fmtBytes(m.memory.usage_bytes)}  /  req ${this.fmtBytes(m.memory.requests_bytes)}  /  lim ${this.fmtBytes(m.memory.limits_bytes)}`);
+            console.log(`    utilization ${this.fmtPct(m.memory.utilization_percent)}\n`);
+            console.log(chalk_1.default.bold('  Network'));
+            console.log(`    rx         ${this.fmtRate(m.network.receive_bytes_rate)}`);
+            console.log(`    tx         ${this.fmtRate(m.network.transmit_bytes_rate)}\n`);
+            console.log(chalk_1.default.bold('  Replicas'));
+            const s = m.status;
+            console.log(`    desired=${s.replicas_desired ?? '-'}  ready=${s.replicas_ready ?? '-'}  unavailable=${s.replicas_unavailable ?? '-'}  up=${s.up ?? '-'}`);
+            console.log(`    restarts   total=${s.restart_total ?? '-'}  rate(1h)=${s.restart_rate_1h ?? '-'}\n`);
+            if (m.pods.length > 0) {
+                console.log(chalk_1.default.bold('  Pods'));
+                for (const p of m.pods) {
+                    console.log(`    ${p.phase.padEnd(10)} ${p.count}`);
+                }
+                console.log('');
+            }
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch metrics');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+    fmtCores(v) {
+        if (v === null || v === undefined)
+            return chalk_1.default.dim('-');
+        return `${v.toFixed(3)} cores`;
+    }
+    fmtBytes(v) {
+        if (v === null || v === undefined)
+            return chalk_1.default.dim('-');
+        return (0, format_bytes_1.formatBytes)(v);
+    }
+    fmtRate(v) {
+        if (v === null || v === undefined)
+            return chalk_1.default.dim('-');
+        return `${(0, format_bytes_1.formatBytes)(v)}/s`;
+    }
+    fmtPct(v) {
+        if (v === null || v === undefined)
+            return chalk_1.default.dim('-');
+        return `${v.toFixed(1)}%`;
+    }
+}
+AppMetrics.description = 'Show instant Prometheus metrics (CPU/mem/network/replicas) for an application';
+AppMetrics.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --output json',
+];
+AppMetrics.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppMetrics.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 = AppMetrics;

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class AppRedeploy extends Command {
+    static readonly description = "Redeploy an application from an existing image (tag or digest), without rebuilding";
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        target: 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>;
+        build: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,60 @@
+"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 AppRedeploy extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppRedeploy);
+        if (!flags.build && !args.target) {
+            this.error('Provide either a tag/digest argument or --build <buildId>.');
+        }
+        const spinner = (0, ora_1.default)(`Triggering redeploy 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);
+            if (flags.build) {
+                await service.deployFromBuild(app.id, flags.build);
+                spinner.succeed(`Redeploy triggered for ${app.name} from build ${flags.build}`);
+                return;
+            }
+            await service.redeployTag(app.id, args.target);
+            spinner.succeed(`Redeploy triggered for ${app.name} with image "${args.target}"`);
+            console.log(chalk_1.default.dim(`\n  Run "flui app release ${args.name} --watch" to follow rollout.\n`));
+        }
+        catch (error) {
+            spinner.fail('Redeploy failed');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppRedeploy.description = 'Redeploy an application from an existing image (tag or digest), without rebuilding';
+AppRedeploy.examples = [
+    '<%= config.bin %> <%= command.id %> my-api a1cac27',
+    '<%= config.bin %> <%= command.id %> my-api sha256:812bdfd0a833...',
+    '<%= config.bin %> <%= command.id %> my-api --build <buildId>',
+];
+AppRedeploy.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+    target: core_1.Args.string({
+        description: 'Tag, short digest (12+ hex), or full sha256:<digest>',
+        required: false,
+    }),
+};
+AppRedeploy.flags = {
+    cluster: core_1.Flags.string({ char: 'c' }),
+    build: core_1.Flags.string({
+        description: 'Deploy from an existing build id (alternative to tag/digest)',
+    }),
+};
+exports.default = AppRedeploy;

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

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class AppReleases extends Command {
+    static readonly description = "List recent releases (deploy/rollback operations) 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>;
+        current: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,117 @@
+"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 AppReleases extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppReleases);
+        const spinner = (0, ora_1.default)(`Fetching releases 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);
+            if (flags.current) {
+                const release = await service.getCurrentRelease(app.id);
+                spinner.stop();
+                if (flags.output === 'json') {
+                    console.log(JSON.stringify(release, null, 2));
+                    return;
+                }
+                if (!release) {
+                    console.log(chalk_1.default.yellow(`\n  No releases for ${app.name}.\n`));
+                    return;
+                }
+                printRelease(app.name, release, true);
+                return;
+            }
+            const releases = (await service.listReleases(app.id)).slice(0, flags.limit);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(releases, null, 2));
+                return;
+            }
+            if (releases.length === 0) {
+                console.log(chalk_1.default.yellow(`\n  No releases for ${app.name}.\n`));
+                return;
+            }
+            console.log(chalk_1.default.cyan(`\n  Releases — ${app.name}\n`));
+            console.log(chalk_1.default.dim(`  ${'STATUS'.padEnd(12)} ${'IMAGE'.padEnd(48)} ${'STARTED'.padEnd(20)} REASON`));
+            console.log(chalk_1.default.dim('  ' + '─'.repeat(110)));
+            for (const r of releases) {
+                const status = colorStatus(r.status).padEnd(21);
+                const image = (r.imageRef ?? '').padEnd(48);
+                const started = new Date(r.startedAt).toLocaleString().padEnd(20);
+                const reason = r.failureReason
+                    ? chalk_1.default.red(r.failureReason.slice(0, 60))
+                    : '';
+                console.log(`  ${status} ${image} ${started} ${reason}`);
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch releases');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppReleases.description = 'List recent releases (deploy/rollback operations) for an application';
+AppReleases.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --current',
+    '<%= config.bin %> <%= command.id %> my-api --output json',
+];
+AppReleases.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppReleases.flags = {
+    cluster: core_1.Flags.string({ char: 'c' }),
+    output: core_1.Flags.string({
+        char: 'o',
+        options: ['table', 'json'],
+        default: 'table',
+    }),
+    current: core_1.Flags.boolean({
+        description: 'Only show the current (most recent) release',
+    }),
+    limit: core_1.Flags.integer({ char: 'n', default: 10 }),
+};
+exports.default = AppReleases;
+function printRelease(appName, r, current) {
+    const title = current
+        ? `Current release — ${appName}`
+        : `Release — ${appName}`;
+    console.log(chalk_1.default.cyan(`\n  ${title}\n`));
+    console.log(`  ${chalk_1.default.bold('Status:')}        ${colorStatus(r.status)}`);
+    console.log(`  ${chalk_1.default.bold('Operation:')}     ${r.operationId}`);
+    if (r.imageRef)
+        console.log(`  ${chalk_1.default.bold('Image:')}         ${r.imageRef}`);
+    if (r.previousImageRef)
+        console.log(`  ${chalk_1.default.bold('Previous:')}      ${chalk_1.default.dim(r.previousImageRef)}`);
+    if (r.buildId)
+        console.log(`  ${chalk_1.default.bold('Build:')}         ${r.buildId}`);
+    console.log(`  ${chalk_1.default.bold('Started:')}       ${new Date(r.startedAt).toLocaleString()}`);
+    if (r.completedAt)
+        console.log(`  ${chalk_1.default.bold('Completed:')}     ${new Date(r.completedAt).toLocaleString()}`);
+    if (r.failureReason)
+        console.log(`  ${chalk_1.default.bold('Reason:')}        ${chalk_1.default.red(r.failureReason)}`);
+    console.log('');
+}
+function colorStatus(s) {
+    if (s === 'SUCCEEDED')
+        return chalk_1.default.green(s);
+    if (s === 'FAILED')
+        return chalk_1.default.red(s);
+    if (s === 'ROLLED_BACK')
+        return chalk_1.default.yellow(s);
+    return chalk_1.default.blue(s);
+}

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

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class AppRestart extends Command {
+    static readonly description = "Trigger a rolling restart 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>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,44 @@
+"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 AppRestart extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppRestart);
+        const spinner = (0, ora_1.default)(`Restarting "${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.restart(app.id);
+            spinner.succeed(`Rolling restart triggered for "${args.name}"`);
+            console.log(chalk_1.default.dim('\n  New pods will replace existing ones one by one.\n'));
+        }
+        catch (error) {
+            spinner.fail('Failed to restart application');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppRestart.description = 'Trigger a rolling restart of an application';
+AppRestart.examples = ['<%= config.bin %> <%= command.id %> my-api'];
+AppRestart.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppRestart.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+};
+exports.default = AppRestart;

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

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class AppScale extends Command {
+    static readonly description = "Scale an application to a desired replica count";
+    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>;
+        replicas: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,58 @@
+"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 AppScale extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppScale);
+        const spinner = (0, ora_1.default)(`Scaling "${args.name}" to ${flags.replicas} replica(s)...`).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.scale(app.id, flags.replicas);
+            spinner.succeed(`Scaled "${args.name}" to ${flags.replicas} replica(s)`);
+            const r = runtime.replicas;
+            console.log('');
+            console.log(`  ${chalk_1.default.bold('Desired:')}  ${r.desired ?? flags.replicas}`);
+            console.log(`  ${chalk_1.default.bold('Ready:')}    ${r.ready ?? 0}`);
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to scale application');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppScale.description = 'Scale an application to a desired replica count';
+AppScale.examples = [
+    '<%= config.bin %> <%= command.id %> my-api --replicas 3',
+    '<%= config.bin %> <%= command.id %> my-api --replicas 0',
+];
+AppScale.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppScale.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+    replicas: core_1.Flags.integer({
+        char: 'r',
+        description: 'Desired replica count (0 = stop all pods)',
+        required: true,
+        min: 0,
+        max: 20,
+    }),
+};
+exports.default = AppScale;

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class AppSnapshotCreate 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>;
+        volume: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,85 @@
+"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 AppSnapshotCreate extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppSnapshotCreate);
+        const spinner = (0, ora_1.default)(`Creating snapshot 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 snap = await service.createAppSnapshot(app.id, {
+                volumeName: flags.volume,
+                description: flags.description,
+            });
+            spinner.succeed(`Snapshot created: ${snap.exportId}`);
+            console.log('');
+            console.log(`  ${chalk_1.default.bold('Provider:')}  ${snap.provider}`);
+            console.log(`  ${chalk_1.default.bold('Sink:')}      ${snap.sink}`);
+            console.log(`  ${chalk_1.default.bold('Namespace:')} ${snap.namespace}`);
+            if (snap.sourcePvcName) {
+                console.log(`  ${chalk_1.default.bold('Source:')}    ${snap.sourcePvcName}`);
+            }
+            if (snap.sizeGb !== undefined) {
+                const actual = snap.actualBytes === undefined
+                    ? 'unknown'
+                    : (0, format_bytes_1.formatBytes)(snap.actualBytes);
+                console.log(`  ${chalk_1.default.bold('Source request:')}  ${snap.sizeGb} GiB`);
+                console.log(`  ${chalk_1.default.bold('Disk usage:')}      ${actual}`);
+            }
+            console.log(`  ${chalk_1.default.bold('Ready:')}     ${snap.ready ? 'yes' : 'pending'}`);
+            console.log(`  ${chalk_1.default.bold('Created:')}   ${snap.createdAt}`);
+            const caps = snap.providerCapabilities;
+            if (!caps.pvcCloneSupportsCheapRetention) {
+                console.log('');
+                console.log(chalk_1.default.yellow('  ! pvc-clone snapshots are billed as a full Volume each — delete when no longer needed:'));
+                console.log(chalk_1.default.yellow(`     flui app snapshot delete ${args.name} ${snap.exportId}`));
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Snapshot creation failed');
+            const msg = error.response?.data?.message ?? error.message ?? String(error);
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+    }
+}
+AppSnapshotCreate.description = 'Create a snapshot of an application volume. Today on every provider this ' +
+    'is a full PVC clone built via the copy-pod export primitive (sink=pvc-clone) ' +
+    'because workload PVCs use local-path. Cost: a full Volume per snapshot.';
+AppSnapshotCreate.examples = [
+    '<%= config.bin %> <%= command.id %> my-app',
+    '<%= config.bin %> <%= command.id %> my-app --description before-upgrade',
+    '<%= config.bin %> <%= command.id %> my-app --volume data',
+];
+AppSnapshotCreate.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppSnapshotCreate.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 snapshot id',
+    }),
+};
+exports.default = AppSnapshotCreate;

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class AppSnapshotDelete extends Command {
+    static readonly description = "Delete a volume snapshot of an application.";
+    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>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,63 @@
+"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 AppSnapshotDelete extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppSnapshotDelete);
+        if (!flags.force) {
+            const ok = await (0, prompts_1.confirmPrompt)(`Delete snapshot "${args.snapshotId}" of app "${args.name}"?`);
+            if (!ok) {
+                console.log(chalk_1.default.dim('  Aborted.'));
+                return;
+            }
+        }
+        const spinner = (0, ora_1.default)(`Deleting 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);
+            await service.deleteAppSnapshot(app.id, args.snapshotId);
+            spinner.succeed(`Deleted snapshot ${args.snapshotId}`);
+        }
+        catch (error) {
+            spinner.fail('Snapshot 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);
+        }
+    }
+}
+AppSnapshotDelete.description = 'Delete a volume snapshot of an application.';
+AppSnapshotDelete.examples = [
+    '<%= config.bin %> <%= command.id %> my-app my-app-snap-20260510-abcdef',
+    '<%= config.bin %> <%= command.id %> my-app my-app-snap-... --force',
+];
+AppSnapshotDelete.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,
+    }),
+};
+AppSnapshotDelete.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect)',
+    }),
+    force: core_1.Flags.boolean({
+        char: 'f',
+        description: 'Skip confirmation',
+    }),
+};
+exports.default = AppSnapshotDelete;

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

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class AppSnapshotList extends Command {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        cluster: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        app: 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>;
+}