@laioutr/cli 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @laioutr/cli
 
+## 0.4.0
+
+### Minor Changes
+
+- e5eb46a: Add a `deploy` command group for managing project deployments from the CLI. Every command targets a project as `--project org/project` and authenticates with an organization API key (`--key`, or the `LAIOUTR_API_KEY` env var).
+
+  - `laioutr deploy trigger` — trigger a production or named-preview deployment (`--preview <name>`). Waits for completion by default (`--no-wait` to return immediately) and can stream build logs with `--logs`.
+  - `laioutr deploy status` — show a deployment's status, environment, URL, and who created it.
+  - `laioutr deploy list` — list recent deployments for a project (`--limit`, default 20, max 100).
+  - `laioutr deploy logs` — fetch and follow a deployment's build logs.
+
 ## 0.3.1
 
 ### Patch Changes

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @laioutr/cli
 $ laioutr COMMAND
 running command...
 $ laioutr (--version)
-@laioutr/cli/0.3.1 linux-x64 node-v24.14.1
+@laioutr/cli/0.4.0 linux-x64 node-v24.18.0
 $ laioutr --help [COMMAND]
 USAGE
   $ laioutr COMMAND
@@ -31,6 +31,11 @@ USAGE
 # Commands
 
 <!-- commands -->
+* [`laioutr app release`](#laioutr-app-release)
+* [`laioutr deploy list`](#laioutr-deploy-list)
+* [`laioutr deploy logs`](#laioutr-deploy-logs)
+* [`laioutr deploy status`](#laioutr-deploy-status)
+* [`laioutr deploy trigger`](#laioutr-deploy-trigger)
 * [`laioutr help [COMMAND]`](#laioutr-help-command)
 * [`laioutr plugins`](#laioutr-plugins)
 * [`laioutr plugins add PLUGIN`](#laioutr-plugins-add-plugin)
@@ -42,6 +47,163 @@ USAGE
 * [`laioutr plugins uninstall [PLUGIN]`](#laioutr-plugins-uninstall-plugin)
 * [`laioutr plugins unlink [PLUGIN]`](#laioutr-plugins-unlink-plugin)
 * [`laioutr plugins update`](#laioutr-plugins-update)
+* [`laioutr project fetch-rc [FILENAME]`](#laioutr-project-fetch-rc-filename)
+* [`laioutr rc fetch [FILENAME]`](#laioutr-rc-fetch-filename)
+* [`laioutr rc update [FILENAME]`](#laioutr-rc-update-filename)
+
+## `laioutr app release`
+
+Publish an app version to the Laioutr platform.
+
+```
+USAGE
+  $ laioutr app release --cockpitApiHost <value> --cwd <value> -k <value> [-c stable|testing]
+
+FLAGS
+  -c, --channel=<option>        Release channel (auto-detected from version if omitted)
+                                <options: stable|testing>
+  -k, --key=<value>             (required) API key for authentication
+      --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                directory
+
+DESCRIPTION
+  Publish an app version to the Laioutr platform.
+
+EXAMPLES
+  $ laioutr app release
+
+  $ laioutr app release --channel testing
+
+  LAIOUTR_API_KEY=orgKey_xxx laioutr app release
+```
+
+_See code: [src/commands/app/release.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/app/release.ts)_
+
+## `laioutr deploy list`
+
+List recent deployments for a project.
+
+```
+USAGE
+  $ laioutr deploy list --cockpitApiHost <value> --cwd <value> -p <value> -k <value> [--json] [--limit <value>]
+
+FLAGS
+  -k, --key=<value>             (required) Organization API key with project:deploy scope
+  -p, --project=<value>         (required) Project identifier in org/project format
+      --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                directory
+      --limit=<value>           [default: 20] Maximum number of deployments to list (1-100)
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List recent deployments for a project.
+
+EXAMPLES
+  $ laioutr deploy list --project org/project --key orgKey_xxx
+
+  $ laioutr deploy list --project org/project --key orgKey_xxx --limit 50
+```
+
+_See code: [src/commands/deploy/list.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/deploy/list.ts)_
+
+## `laioutr deploy logs`
+
+Fetch and display build logs for a deployment.
+
+```
+USAGE
+  $ laioutr deploy logs --cockpitApiHost <value> --cwd <value> -p <value> -k <value> --deploymentId <value>
+    [--json]
+
+FLAGS
+  -k, --key=<value>             (required) Organization API key with project:deploy scope
+  -p, --project=<value>         (required) Project identifier in org/project format
+      --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                directory
+      --deploymentId=<value>    (required) Deployment ID
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Fetch and display build logs for a deployment.
+
+EXAMPLES
+  $ laioutr deploy logs --project org/project --key orgKey_xxx --deploymentId dep_abc123
+```
+
+_See code: [src/commands/deploy/logs.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/deploy/logs.ts)_
+
+## `laioutr deploy status`
+
+Show status of a deployment.
+
+```
+USAGE
+  $ laioutr deploy status --cockpitApiHost <value> --cwd <value> -p <value> -k <value> --deploymentId <value>
+    [--json]
+
+FLAGS
+  -k, --key=<value>             (required) Organization API key with project:deploy scope
+  -p, --project=<value>         (required) Project identifier in org/project format
+      --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                directory
+      --deploymentId=<value>    (required) Deployment ID
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show status of a deployment.
+
+EXAMPLES
+  $ laioutr deploy status --project org/project --key orgKey_xxx --deploymentId dep_abc123
+```
+
+_See code: [src/commands/deploy/status.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/deploy/status.ts)_
+
+## `laioutr deploy trigger`
+
+Trigger a project deployment.
+
+```
+USAGE
+  $ laioutr deploy trigger --cockpitApiHost <value> --cwd <value> -p <value> -k <value> [--json] [--wait] [--logs]
+    [--preview <value>]
+
+FLAGS
+  -k, --key=<value>             (required) Organization API key with project:deploy scope
+  -p, --project=<value>         (required) Project identifier in org/project format
+      --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                directory
+      --logs                    Stream build log output instead of spinner
+      --preview=<value>         Create a preview deployment with optional name
+      --[no-]wait               Wait for deployment to complete
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Trigger a project deployment.
+
+EXAMPLES
+  $ laioutr deploy trigger --project org/project --key orgKey_xxx
+
+  $ laioutr deploy trigger --project org/project --key orgKey_xxx --no-wait
+
+  $ laioutr deploy trigger --project org/project --key orgKey_xxx --logs
+
+  $ laioutr deploy trigger --project org/project --key orgKey_xxx --preview my-feature
+```
+
+_See code: [src/commands/deploy/trigger.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/deploy/trigger.ts)_
 
 ## `laioutr help [COMMAND]`
 
@@ -352,4 +514,79 @@ DESCRIPTION
 ```
 
 _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.41/src/commands/plugins/update.ts)_
+
+## `laioutr project fetch-rc [FILENAME]`
+
+Fetches the laioutrrc.json of a project from the cockpit api.
+
+```
+USAGE
+  $ laioutr project fetch-rc [FILENAME] --cockpitApiHost <value> --cwd <value> -e <value> -s <value> -p <value>
+
+FLAGS
+  -e, --environmentName=<value>  (required) [default: main] environment name
+  -p, --project=<value>          (required) <organization slug>/<project slug>
+  -s, --projectSecret=<value>    (required) project secret
+      --cockpitApiHost=<value>   (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>              (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                 directory
+
+DESCRIPTION
+  Fetches the laioutrrc.json of a project from the cockpit api.
+
+ALIASES
+  $ laioutr project fetch-rc
+
+EXAMPLES
+  $ laioutr project fetch-rc
+```
+
+## `laioutr rc fetch [FILENAME]`
+
+Fetches the laioutrrc.json of a project from the cockpit api.
+
+```
+USAGE
+  $ laioutr rc fetch [FILENAME] --cockpitApiHost <value> --cwd <value> -e <value> -s <value> -p <value>
+
+FLAGS
+  -e, --environmentName=<value>  (required) [default: main] environment name
+  -p, --project=<value>          (required) <organization slug>/<project slug>
+  -s, --projectSecret=<value>    (required) project secret
+      --cockpitApiHost=<value>   (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+      --cwd=<value>              (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                 directory
+
+DESCRIPTION
+  Fetches the laioutrrc.json of a project from the cockpit api.
+
+ALIASES
+  $ laioutr project fetch-rc
+
+EXAMPLES
+  $ laioutr rc fetch
+```
+
+_See code: [src/commands/rc/fetch.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/rc/fetch.ts)_
+
+## `laioutr rc update [FILENAME]`
+
+Updates an existing laioutrrc.json file with the latest from the cockpit api.
+
+```
+USAGE
+  $ laioutr rc update [FILENAME] --cockpitApiHost <value> --cwd <value>
+
+FLAGS
+  --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
+  --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working directory
+
+DESCRIPTION
+  Updates an existing laioutrrc.json file with the latest from the cockpit api.
+
+EXAMPLES
+  $ laioutr rc update
+```
+
+_See code: [src/commands/rc/update.ts](https://github.com/laioutr/laioutr/blob/v0.4.0/src/commands/rc/update.ts)_
 <!-- commandsstop -->

package/dist/api/deploy.d.ts

@@ -0,0 +1,65 @@
+export interface DeployApiOptions {
+    cockpitApiHost: string;
+    apiKey: string;
+    organizationSlug: string;
+    projectSlug: string;
+}
+export interface TriggerOptions extends DeployApiOptions {
+    previewName?: string;
+}
+export declare function triggerDeployment(options: TriggerOptions): Promise<{
+    deploymentId: string;
+    status: string;
+    environment: string;
+    previewName: string | null;
+}>;
+export declare function fetchDeploymentStatus(options: DeployApiOptions & {
+    deploymentId: string;
+}): Promise<{
+    deploymentId: string;
+    status: string;
+    environment: string;
+    previewName: string | null;
+    url: string | null;
+    lastError: string | null;
+    createdAt: string;
+    stoppedAt: string | null;
+    attribution: {
+        principalType: "user" | "api-key" | "system";
+        displayName: string;
+        email: string | null;
+        agentName: string | null;
+        redacted: boolean;
+    } | null;
+}>;
+export declare function fetchDeployments(options: DeployApiOptions & {
+    limit?: number;
+}): Promise<{
+    deployments: {
+        deploymentId: string;
+        status: string;
+        environment: string;
+        previewName: string | null;
+        url: string | null;
+        createdAt: string;
+        stoppedAt: string | null;
+        attribution: {
+            principalType: "user" | "api-key" | "system";
+            displayName: string;
+            email: string | null;
+            agentName: string | null;
+            redacted: boolean;
+        } | null;
+    }[];
+}>;
+export declare function fetchDeploymentLogs(options: DeployApiOptions & {
+    deploymentId: string;
+}): Promise<{
+    lines: {
+        text: string;
+        level?: "error" | "warning" | null | undefined;
+        timestamp?: number | null | undefined;
+    }[] | null;
+    supported: boolean;
+    deploymentStatus: string;
+}>;

package/dist/api/deploy.js

@@ -0,0 +1,34 @@
+import { postJson } from './http.js';
+import { deploymentLogsResponseSchema, deploymentsListResponseSchema, deploymentStatusResponseSchema, deployTriggerResponseSchema, } from '../deploy/validation.js';
+export async function triggerDeployment(options) {
+    const data = await postJson(`${options.cockpitApiHost}/api/v1/project/deploy`, {
+        organizationSlug: options.organizationSlug,
+        projectSlug: options.projectSlug,
+        previewName: options.previewName,
+    }, { apiKey: options.apiKey });
+    return deployTriggerResponseSchema.parse(data);
+}
+export async function fetchDeploymentStatus(options) {
+    const data = await postJson(`${options.cockpitApiHost}/api/v1/project/deployment-status`, {
+        organizationSlug: options.organizationSlug,
+        projectSlug: options.projectSlug,
+        deploymentId: options.deploymentId,
+    }, { apiKey: options.apiKey });
+    return deploymentStatusResponseSchema.parse(data);
+}
+export async function fetchDeployments(options) {
+    const data = await postJson(`${options.cockpitApiHost}/api/v1/project/deployments`, {
+        organizationSlug: options.organizationSlug,
+        projectSlug: options.projectSlug,
+        limit: options.limit,
+    }, { apiKey: options.apiKey });
+    return deploymentsListResponseSchema.parse(data);
+}
+export async function fetchDeploymentLogs(options) {
+    const data = await postJson(`${options.cockpitApiHost}/api/v1/project/deployment-logs`, {
+        organizationSlug: options.organizationSlug,
+        projectSlug: options.projectSlug,
+        deploymentId: options.deploymentId,
+    }, { apiKey: options.apiKey });
+    return deploymentLogsResponseSchema.parse(data);
+}

package/dist/api/fetchRc.d.ts

@@ -0,0 +1,10 @@
+interface HostApiOptions {
+    cockpitApiHost: string;
+}
+export interface ProjectApiOptions extends HostApiOptions {
+    project: string;
+    projectSecret: string;
+    environmentName: string;
+}
+export declare const fetchRc: (flags: ProjectApiOptions) => Promise<string>;
+export {};

package/dist/api/fetchRc.js

@@ -0,0 +1,19 @@
+import { z } from 'zod/v4';
+import { postJson } from './http.js';
+import { parseProjectSlug } from '../project.js';
+const apiResponseSchema = z.object({
+    content: z.string(),
+});
+export const fetchRc = async (flags) => {
+    const parsed = parseProjectSlug(flags.project);
+    if (!parsed) {
+        throw new Error(`Invalid project "${flags.project}" — expected <organization slug>/<project slug>.`);
+    }
+    const data = await postJson(`${flags.cockpitApiHost}/api/v1/project/fetch-rc`, {
+        environmentName: flags.environmentName,
+        organizationSlug: parsed.organizationSlug,
+        projectSecret: flags.projectSecret,
+        projectSlug: parsed.projectSlug,
+    });
+    return apiResponseSchema.parse(data).content;
+};

package/dist/api/http.d.ts

@@ -0,0 +1,14 @@
+export interface PostJsonOptions {
+    /** When set, sent as an `Authorization: Bearer <apiKey>` header. */
+    apiKey?: string;
+    /** Extra headers, merged over the defaults (`Content-Type` + auth). */
+    headers?: Record<string, string>;
+}
+/**
+ * POSTs a JSON body to `url` and returns the parsed JSON response.
+ *
+ * Throws if the response status is not 200 (the message carries the status and
+ * raw body) or if the body is not valid JSON. Callers validate the returned
+ * shape themselves — typically with a zod schema — so this returns `unknown`.
+ */
+export declare function postJson(url: string, body: unknown, options?: PostJsonOptions): Promise<unknown>;

package/dist/api/http.js

@@ -0,0 +1,28 @@
+/**
+ * POSTs a JSON body to `url` and returns the parsed JSON response.
+ *
+ * Throws if the response status is not 200 (the message carries the status and
+ * raw body) or if the body is not valid JSON. Callers validate the returned
+ * shape themselves — typically with a zod schema — so this returns `unknown`.
+ */
+export async function postJson(url, body, options = {}) {
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(options.apiKey ? { Authorization: `Bearer ${options.apiKey}` } : {}),
+            ...options.headers,
+        },
+        body: JSON.stringify(body),
+    });
+    const text = await response.text();
+    if (response.status !== 200) {
+        throw new Error(`Request failed (${response.status}): ${text}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Failed to parse JSON response from ${url}`);
+    }
+}

package/dist/api/releaseAppVersion.d.ts

@@ -0,0 +1,13 @@
+export interface ReleaseOptions {
+    cockpitApiHost: string;
+    apiKey: string;
+    packageName: string;
+    version: string;
+    configSchema: Record<string, unknown>;
+    peerDependencies: Record<string, string>;
+    channel?: 'stable' | 'testing';
+}
+export declare const releaseAppVersion: (options: ReleaseOptions) => Promise<{
+    message: string;
+    versionId?: string | undefined;
+}>;

package/dist/api/releaseAppVersion.js

@@ -0,0 +1,16 @@
+import { z } from 'zod/v4';
+import { postJson } from './http.js';
+const releaseResponseSchema = z.object({
+    message: z.string(),
+    versionId: z.string().optional(),
+});
+export const releaseAppVersion = async (options) => {
+    const data = await postJson(`${options.cockpitApiHost}/api/v1/app/release`, {
+        packageName: options.packageName,
+        version: options.version,
+        configSchema: options.configSchema,
+        peerDependencies: options.peerDependencies,
+        channel: options.channel,
+    }, { apiKey: options.apiKey });
+    return releaseResponseSchema.parse(data);
+};

package/dist/commands/app/release.d.ts

@@ -0,0 +1,12 @@
+import LaioutrBaseCommand from '../../laioutr-base-command.js';
+export default class AppRelease extends LaioutrBaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        key: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        channel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cockpitApiHost: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        cwd: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/release.js

@@ -0,0 +1,63 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Flags } from '@oclif/core';
+import { releaseAppVersion } from '../../api/releaseAppVersion.js';
+import LaioutrBaseCommand from '../../laioutr-base-command.js';
+export default class AppRelease extends LaioutrBaseCommand {
+    static description = 'Publish an app version to the Laioutr platform.';
+    static examples = [
+        '<%= config.bin %> app release',
+        '<%= config.bin %> app release --channel testing',
+        'LAIOUTR_API_KEY=orgKey_xxx <%= config.bin %> app release',
+    ];
+    static flags = {
+        ...LaioutrBaseCommand.flags,
+        key: Flags.string({
+            char: 'k',
+            description: 'API key for authentication',
+            env: 'LAIOUTR_API_KEY',
+            required: true,
+        }),
+        channel: Flags.string({
+            char: 'c',
+            description: 'Release channel (auto-detected from version if omitted)',
+            options: ['stable', 'testing'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AppRelease);
+        // 1. Read package.json
+        const pkgPath = path.join(flags.cwd, 'package.json');
+        const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));
+        if (!pkg.name || !pkg.version) {
+            this.error('package.json must have "name" and "version" fields');
+        }
+        // 2. Import configSchema via jiti
+        let configSchema = {};
+        try {
+            const { createJiti } = await import('jiti');
+            const jiti = createJiti(flags.cwd);
+            const mod = await jiti.import(path.join(flags.cwd, 'src/module.ts'));
+            configSchema = mod.configSchema ?? {};
+        }
+        catch {
+            this.warn('Could not import configSchema from src/module.ts — publishing without config schema');
+        }
+        // 3. Extract peer dependencies
+        const peerDependencies = pkg.peerDependencies ?? {};
+        // 4. Detect channel
+        const channel = flags.channel;
+        this.log(`Publishing ${pkg.name}@${pkg.version}...`);
+        // 5. Call the release API
+        const result = await releaseAppVersion({
+            cockpitApiHost: flags.cockpitApiHost,
+            apiKey: flags.key,
+            packageName: pkg.name,
+            version: pkg.version,
+            configSchema,
+            peerDependencies,
+            channel,
+        });
+        this.log(result.message);
+    }
+}

package/dist/commands/deploy/list.d.ts

@@ -0,0 +1,31 @@
+import DeployBaseCommand from '../../deploy-base-command.js';
+export default class DeployList extends DeployBaseCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        key: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        cockpitApiHost: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        cwd: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        deployments: {
+            deploymentId: string;
+            status: string;
+            environment: string;
+            previewName: string | null;
+            url: string | null;
+            createdAt: string;
+            stoppedAt: string | null;
+            attribution: {
+                principalType: "user" | "api-key" | "system";
+                displayName: string;
+                email: string | null;
+                agentName: string | null;
+                redacted: boolean;
+            } | null;
+        }[];
+    }>;
+}

package/dist/commands/deploy/list.js

@@ -0,0 +1,54 @@
+import { Flags } from '@oclif/core';
+import { makeTable } from '@oclif/table';
+import { fetchDeployments } from '../../api/deploy.js';
+import { formatAttribution } from '../../deploy/attribution.js';
+import DeployBaseCommand from '../../deploy-base-command.js';
+export default class DeployList extends DeployBaseCommand {
+    static description = 'List recent deployments for a project.';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> deploy list --project org/project --key orgKey_xxx',
+        '<%= config.bin %> deploy list --project org/project --key orgKey_xxx --limit 50',
+    ];
+    static flags = {
+        ...DeployBaseCommand.flags,
+        limit: Flags.integer({
+            default: 20,
+            description: 'Maximum number of deployments to list (1-100)',
+            max: 100,
+            min: 1,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DeployList);
+        const { organizationSlug, projectSlug } = this.parseProject(flags.project);
+        const result = await fetchDeployments({
+            cockpitApiHost: flags.cockpitApiHost,
+            apiKey: flags.key,
+            organizationSlug,
+            projectSlug,
+            limit: flags.limit,
+        });
+        if (result.deployments.length === 0) {
+            this.log('No deployments found.');
+            return result;
+        }
+        const rows = result.deployments.map((d) => ({
+            ID: d.deploymentId,
+            Type: d.environment,
+            Preview: d.previewName ?? '—',
+            Status: d.status,
+            URL: d.url ?? '—',
+            'Created by': formatAttribution(d.attribution),
+        }));
+        this.log(makeTable({
+            data: rows,
+            // Keep our exact header casing (ID / URL / Created by) instead of the
+            // default case-formatter, and truncate the middle of long cells (URLs)
+            // so both ends stay visible.
+            headerOptions: { formatter: (header) => header },
+            overflow: 'truncate-middle',
+        }));
+        return result;
+    }
+}

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

@@ -0,0 +1,22 @@
+import DeployBaseCommand from '../../deploy-base-command.js';
+export default class DeployLogs extends DeployBaseCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        deploymentId: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        key: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        cockpitApiHost: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        cwd: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<{
+        lines: {
+            text: string;
+            level?: "error" | "warning" | null | undefined;
+            timestamp?: number | null | undefined;
+        }[] | null;
+        supported: boolean;
+        deploymentStatus: string;
+    }>;
+}