@flui-cloud/cli 0.0.1

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

@@ -0,0 +1,99 @@
+"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 AppCrashes extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppCrashes);
+        const spinner = (0, ora_1.default)(`Fetching crash reports 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 diagnoses = await service.getCrashes(app.id);
+            spinner.stop();
+            if (flags.output === 'json') {
+                console.log(JSON.stringify(diagnoses, null, 2));
+                return;
+            }
+            const open = diagnoses.filter((d) => !d.resolvedAt);
+            const resolved = diagnoses.filter((d) => d.resolvedAt);
+            if (diagnoses.length === 0) {
+                console.log(chalk_1.default.green(`\n  No crash reports for "${args.name}".\n`));
+                return;
+            }
+            console.log(chalk_1.default.cyan(`\n  Crash Reports — ${args.name}\n`));
+            if (open.length > 0) {
+                console.log(chalk_1.default.bold('  Active\n'));
+                for (const d of open)
+                    this.printActiveDiagnosis(d);
+            }
+            if (resolved.length > 0) {
+                console.log(chalk_1.default.dim(`  ${resolved.length} resolved crash(es) not shown.`));
+                console.log('');
+            }
+            console.log(chalk_1.default.dim(`  ${open.length} active, ${resolved.length} resolved — total ${diagnoses.length}`));
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch crash reports');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+    }
+    printActiveDiagnosis(d) {
+        const icon = d.severity === 'critical' ? chalk_1.default.red('✖') : chalk_1.default.yellow('⚠');
+        console.log(`  ${icon} ${chalk_1.default.bold(d.title)}`);
+        console.log(`    ${chalk_1.default.dim('category:')}  ${d.category}`);
+        console.log(`    ${chalk_1.default.dim('pod:')}       ${d.podName}`);
+        console.log(`    ${chalk_1.default.dim('severity:')}  ${this.colorSeverity(d.severity)}`);
+        console.log(`    ${chalk_1.default.dim('detected:')}  ${new Date(d.createdAt).toLocaleString()}`);
+        if (d.explanation) {
+            console.log(`    ${chalk_1.default.dim('reason:')}    ${d.explanation}`);
+        }
+        if (d.suggestedAction?.summary) {
+            console.log(`    ${chalk_1.default.dim('action:')}    ${d.suggestedAction.summary}`);
+        }
+        console.log('');
+    }
+    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);
+        }
+    }
+}
+AppCrashes.description = 'Show recent crash diagnoses for an application';
+AppCrashes.examples = [
+    '<%= config.bin %> <%= command.id %> my-api',
+    '<%= config.bin %> <%= command.id %> my-api --output json',
+];
+AppCrashes.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppCrashes.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 = AppCrashes;

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

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class AppDelete 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>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'no-wait': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private waitForUninstall;
+    private pollUninstall;
+}

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

@@ -0,0 +1,149 @@
+"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");
+const POLL_INTERVAL_MS = 5000;
+const MAX_WAIT_MS = 300_000; // 5 min
+class AppDelete extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppDelete);
+        const spinner = (0, ora_1.default)(`Looking up "${args.name}"…`).start();
+        let service;
+        try {
+            const { id: clusterId } = await (0, resolve_cluster_1.resolveCluster)(flags.cluster);
+            service = await cli_app_service_1.CliAppService.create(clusterId);
+        }
+        catch (error) {
+            spinner.fail('Setup failed');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+        let app;
+        try {
+            app = await service.getAppByName(args.name);
+        }
+        catch (error) {
+            spinner.fail('App not found');
+            console.log(chalk_1.default.red(`\n  Error: ${error.message}\n`));
+            this.exit(1);
+        }
+        const detail = await service.getAppDetail(app.id);
+        spinner.stop();
+        const isCatalog = !!detail.catalogInstallId;
+        const isSystemProtected = detail.systemProtected === true;
+        if (isSystemProtected && !flags.force) {
+            console.log(chalk_1.default.red(`\n  "${app.name}" is a system-protected application.\n`));
+            console.log(chalk_1.default.yellow('  Re-run with --force to delete it anyway.\n'));
+            this.exit(1);
+        }
+        console.log(chalk_1.default.red(`\n  ${isCatalog ? 'UNINSTALL' : 'DELETE'} Application\n`));
+        console.log(`  ${chalk_1.default.bold('Name:')}   ${app.name}`);
+        console.log(`  ${chalk_1.default.bold('Slug:')}   ${app.slug}`);
+        console.log(`  ${chalk_1.default.bold('Kind:')}   ${isCatalog ? 'catalog' : 'source-deploy'}${isSystemProtected ? chalk_1.default.yellow(' (system-protected)') : ''}`);
+        console.log(`  ${chalk_1.default.bold('Status:')} ${app.status}`);
+        console.log(chalk_1.default.red('\n  ALL DATA AND VOLUMES WILL BE PERMANENTLY DELETED!\n'));
+        if (!flags.force) {
+            console.log(chalk_1.default.yellow(`  To confirm, type the app name exactly: ${chalk_1.default.bold(app.name)}`));
+            const confirmed = await (0, prompts_1.confirmByTypingPrompt)(chalk_1.default.yellow('  App name'), app.name);
+            if (!confirmed) {
+                console.log(chalk_1.default.green('\n  Deletion cancelled (name did not match)\n'));
+                return;
+            }
+        }
+        const queueSpinner = (0, ora_1.default)(isCatalog ? 'Queuing uninstall…' : 'Queuing delete…').start();
+        try {
+            if (isCatalog) {
+                await service.uninstall(detail.catalogInstallId);
+            }
+            else {
+                await service.deleteApp(app.id);
+            }
+            queueSpinner.succeed(isCatalog ? 'Uninstall queued' : 'Delete queued');
+            console.log('');
+        }
+        catch (error) {
+            queueSpinner.fail(isCatalog ? 'Failed to queue uninstall' : 'Failed to queue delete');
+            const msg = error.response?.data?.message ?? error.message;
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            this.exit(1);
+        }
+        if (flags['no-wait'] || !isCatalog) {
+            console.log(chalk_1.default.dim('  Use `flui app list` to verify the app is removed.\n'));
+            return;
+        }
+        await this.waitForUninstall(service, detail.catalogInstallId, app.name);
+    }
+    async waitForUninstall(service, catalogInstallId, appName) {
+        console.log(chalk_1.default.dim(`  Waiting for uninstall to complete (up to ${MAX_WAIT_MS / 60000} min)…`));
+        const waitSpinner = (0, ora_1.default)(`Uninstalling ${appName}…`).start();
+        const started = Date.now();
+        while (Date.now() - started < MAX_WAIT_MS) {
+            await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+            const done = await this.pollUninstall(service, catalogInstallId, appName, waitSpinner);
+            if (done)
+                return;
+        }
+        waitSpinner.warn('Timed out waiting for uninstall');
+        console.log(chalk_1.default.yellow(`\n  Uninstall is still running. Check with:`));
+        console.log(chalk_1.default.dim(`    flui app list\n`));
+    }
+    async pollUninstall(service, catalogInstallId, appName, waitSpinner) {
+        try {
+            const current = await service.getInstallStatus(catalogInstallId);
+            if (current.status === 'UNINSTALLED') {
+                waitSpinner.succeed(chalk_1.default.green(`"${appName}" uninstalled successfully`));
+                console.log('');
+                console.log(chalk_1.default.dim('  All resources and volumes have been removed.\n'));
+                return true;
+            }
+            if (current.status === 'FAILED') {
+                waitSpinner.fail('Uninstall failed');
+                const msg = current.errorMessage ?? 'Unknown error';
+                console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+                this.exit(1);
+            }
+            waitSpinner.text = `Uninstalling ${appName}… (${current.status.toLowerCase()})`;
+        }
+        catch {
+            /* polling error — keep trying */
+        }
+        return false;
+    }
+}
+AppDelete.description = 'Delete an application and remove all its resources from the cluster. ' +
+    'Works for both catalog installs and source-deploy (flui.yaml) apps. ' +
+    'System-protected apps require --force.';
+AppDelete.examples = [
+    '<%= config.bin %> <%= command.id %> uptime-kuma',
+    '<%= config.bin %> <%= command.id %> uptime-kuma --force',
+    '<%= config.bin %> <%= command.id %> uptime-kuma --no-wait',
+];
+AppDelete.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+};
+AppDelete.flags = {
+    cluster: core_1.Flags.string({
+        char: 'c',
+        description: 'Cluster name or ID (default: auto-detect when only one cluster exists)',
+    }),
+    force: core_1.Flags.boolean({
+        char: 'f',
+        description: 'Skip confirmation prompt',
+        default: false,
+    }),
+    'no-wait': core_1.Flags.boolean({
+        description: 'Return immediately after queuing the uninstall',
+        default: false,
+    }),
+};
+exports.default = AppDelete;

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

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export default class AppImageDelete extends Command {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        versionId: import("@oclif/core/lib/interfaces").Arg<number, {
+            max?: number | undefined;
+            min?: number | undefined;
+        }>;
+    };
+    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>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,72 @@
+"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 AppImageDelete extends core_1.Command {
+    async run() {
+        const { args, flags } = await this.parse(AppImageDelete);
+        if (!flags.yes) {
+            const ok = await (0, prompts_1.confirmPrompt)(`Permanently delete GHCR version ${args.versionId} for "${args.name}"?`, false);
+            if (!ok) {
+                console.log(chalk_1.default.dim('  Aborted.'));
+                return;
+            }
+        }
+        const spinner = (0, ora_1.default)(`Deleting version ${args.versionId}...`).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.deleteImageVersion(app.id, args.versionId, {
+                force: flags.force,
+            });
+            spinner.succeed(`Deleted GHCR version ${args.versionId}`);
+        }
+        catch (error) {
+            spinner.fail('Delete failed');
+            const msg = error.message ?? '';
+            console.log(chalk_1.default.red(`\n  Error: ${msg}\n`));
+            if (/latest release/i.test(msg) && !flags.force) {
+                console.log(chalk_1.default.dim('  Re-run with --force to override the latest-release guard.\n'));
+            }
+            if (/delete:packages/i.test(msg)) {
+                console.log(chalk_1.default.dim('  Your GHCR PAT must be a classic token with read:packages + delete:packages scopes.\n'));
+            }
+            this.exit(1);
+        }
+    }
+}
+AppImageDelete.description = 'Delete a container image version from the registry (GHCR). ' +
+    'Refuses to delete the currently deployed version. The latest-release guard can be overridden with --force.';
+AppImageDelete.examples = [
+    '<%= config.bin %> <%= command.id %> my-api 845914920',
+    '<%= config.bin %> <%= command.id %> my-api 845914920 --force',
+];
+AppImageDelete.args = {
+    name: core_1.Args.string({
+        description: 'Application name or slug',
+        required: true,
+    }),
+    versionId: core_1.Args.integer({
+        description: 'GitHub Packages numeric version id (from `flui app versions --output json`)',
+        required: true,
+    }),
+};
+AppImageDelete.flags = {
+    cluster: core_1.Flags.string({ char: 'c' }),
+    force: core_1.Flags.boolean({
+        description: 'Override the latest-release guard. The currently-deployed guard is never bypassable.',
+    }),
+    yes: core_1.Flags.boolean({
+        char: 'y',
+        description: 'Skip confirmation prompt',
+    }),
+};
+exports.default = AppImageDelete;

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

@@ -0,0 +1,40 @@
+import { Command } from '@oclif/core';
+export default class AppInit extends Command {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly args: {
+        framework: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static readonly flags: {
+        list: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        target: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Replace the template placeholder `metadata.name` (e.g. `my-astro-app`,
+     * `my-nextjs-app`, `my-app`) with a value derived from the user's project:
+     *  1. `name` from package.json (if present)
+     *  2. `name` from pyproject.toml `[project]`
+     *  3. basename of the target directory
+     * The substitution is conservative: it only triggers when the current value
+     * starts with `my-` (template marker) so it never clobbers a name the user
+     * has already personalised on a re-run.
+     */
+    private autoFillFluiYamlName;
+    private deriveProjectName;
+    /**
+     * Coerce an arbitrary project name into the slug shape expected by the
+     * flui/v1 schema (lowercase, alphanumerics + dashes, no leading/trailing
+     * dash). Falls back to null if the result is empty.
+     */
+    private sanitizeAppName;
+    private printPostCheckResults;
+    private resolveTemplate;
+    private printList;
+    private processFile;
+    private promptConflict;
+    private printDiff;
+    private printNextSteps;
+}