@laioutr/cli 0.3.2 → 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.2 darwin-arm64 node-v22.22.2
+@laioutr/cli/0.4.0 linux-x64 node-v24.18.0
 $ laioutr --help [COMMAND]
 USAGE
   $ laioutr COMMAND
@@ -32,6 +32,10 @@ USAGE
 
 <!-- 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)
@@ -60,7 +64,8 @@ FLAGS
                                 <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: /Users/sl/src/laioutr/apps/cli] current working directory
+      --cwd=<value>             (required) [default: /home/runner/work/laioutr/laioutr/apps/cli] current working
+                                directory
 
 DESCRIPTION
   Publish an app version to the Laioutr platform.
@@ -73,7 +78,132 @@ EXAMPLES
   LAIOUTR_API_KEY=orgKey_xxx laioutr app release
 ```
 
-_See code: [src/commands/app/release.ts](https://github.com/laioutr/laioutr/blob/v0.3.2/src/commands/app/release.ts)_
+_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]`
 
@@ -398,7 +528,8 @@ FLAGS
   -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: /Users/sl/src/laioutr/apps/cli] current working directory
+      --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.
@@ -423,7 +554,8 @@ FLAGS
   -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: /Users/sl/src/laioutr/apps/cli] current working directory
+      --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.
@@ -435,7 +567,7 @@ EXAMPLES
   $ laioutr rc fetch
 ```
 
-_See code: [src/commands/rc/fetch.ts](https://github.com/laioutr/laioutr/blob/v0.3.2/src/commands/rc/fetch.ts)_
+_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]`
 
@@ -447,7 +579,7 @@ USAGE
 
 FLAGS
   --cockpitApiHost=<value>  (required) [default: https://cockpit.laioutr.cloud] cockpit api host
-  --cwd=<value>             (required) [default: /Users/sl/src/laioutr/apps/cli] current working directory
+  --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.
@@ -456,5 +588,5 @@ EXAMPLES
   $ laioutr rc update
 ```
 
-_See code: [src/commands/rc/update.ts](https://github.com/laioutr/laioutr/blob/v0.3.2/src/commands/rc/update.ts)_
+_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.js

@@ -1,35 +1,19 @@
-/* eslint-disable no-console */
 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 url = `${flags.cockpitApiHost}/api/v1/project/fetch-rc`;
-    const [organizationSlug, projectSlug] = flags.project.replace('/p/', '').split('/');
-    const response = await fetch(url, {
-        body: JSON.stringify({
-            environmentName: flags.environmentName,
-            organizationSlug,
-            projectSecret: flags.projectSecret,
-            projectSlug,
-        }),
-        headers: {
-            'Content-Type': 'application/json',
-        },
-        method: 'POST',
-    });
-    const body = await response.text();
-    let data = null;
-    if (response.status !== 200) {
-        throw new Error(`Failed to fetch RC file. Status: ${response.status} ${response.statusText}. Body: ${body}`);
-    }
-    try {
-        data = JSON.parse(body);
+    const parsed = parseProjectSlug(flags.project);
+    if (!parsed) {
+        throw new Error(`Invalid project "${flags.project}" — expected <organization slug>/<project slug>.`);
     }
-    catch (error) {
-        console.error(error, response);
-        throw new Error('Failed to parse RC file. See error message above.');
-    }
-    const parsed = apiResponseSchema.parse(data);
-    return parsed.content;
+    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.js

@@ -1,27 +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 url = `${options.cockpitApiHost}/api/v1/app/release`;
-    const response = await fetch(url, {
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/json',
-            Authorization: `Bearer ${options.apiKey}`,
-        },
-        body: JSON.stringify({
-            packageName: options.packageName,
-            version: options.version,
-            configSchema: options.configSchema,
-            peerDependencies: options.peerDependencies,
-            channel: options.channel,
-        }),
-    });
-    const body = await response.text();
-    if (response.status !== 200) {
-        throw new Error(`Release failed (${response.status}): ${body}`);
-    }
-    return releaseResponseSchema.parse(JSON.parse(body));
+    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/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;
+    }>;
+}

package/dist/commands/deploy/logs.js

@@ -0,0 +1,51 @@
+import { Flags } from '@oclif/core';
+import { fetchDeploymentLogs } from '../../api/deploy.js';
+import { LogRenderer } from '../../deploy/log-renderer.js';
+import { isTerminalStatus, POLL_INTERVAL_MS, sleep } from '../../deploy/polling.js';
+import DeployBaseCommand from '../../deploy-base-command.js';
+export default class DeployLogs extends DeployBaseCommand {
+    static description = 'Fetch and display build logs for a deployment.';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> deploy logs --project org/project --key orgKey_xxx --deploymentId dep_abc123'];
+    static flags = {
+        ...DeployBaseCommand.flags,
+        deploymentId: Flags.string({
+            description: 'Deployment ID',
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DeployLogs);
+        const { organizationSlug, projectSlug } = this.parseProject(flags.project);
+        const apiOptions = {
+            cockpitApiHost: flags.cockpitApiHost,
+            apiKey: flags.key,
+            organizationSlug,
+            projectSlug,
+            deploymentId: flags.deploymentId,
+        };
+        // Initial fetch
+        const initial = await fetchDeploymentLogs(apiOptions);
+        if (!initial.supported) {
+            this.log("Build logs are not available for this deployment's hosting provider.");
+            return initial;
+        }
+        const isFollowing = !isTerminalStatus(initial.deploymentStatus);
+        this.log(`Build log for deployment ${flags.deploymentId}${isFollowing ? ' (following)' : ''}`);
+        this.log('');
+        const renderer = new LogRenderer();
+        renderer.render(initial.lines, (msg) => this.log(msg));
+        if (!isFollowing) {
+            return initial;
+        }
+        // Follow mode — poll until terminal
+        while (true) {
+            await sleep(POLL_INTERVAL_MS);
+            const result = await fetchDeploymentLogs(apiOptions);
+            renderer.render(result.lines, (msg) => this.log(msg));
+            if (isTerminalStatus(result.deploymentStatus)) {
+                return result;
+            }
+        }
+    }
+}

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

@@ -0,0 +1,30 @@
+import DeployBaseCommand from '../../deploy-base-command.js';
+export default class DeployStatus 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<{
+        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;
+    }>;
+}