@synteq/cli 0.2.0 → 1.1.2

package/dist/base/command.js

@@ -1,3 +1,4 @@
+import { linkKind } from "../config/store.js";
 import { Command, Flags, Errors } from "@oclif/core";
 import { makeClients } from "../api/factory.js";
 import { ApiError, AuthExpiredError, NetworkError } from "../api/errors.js";
@@ -5,6 +6,13 @@ import { PaymentPickerError } from "../ui/payment.js";
 import { setRenderMode } from "../ui/render-mode.js";
 import { detectAuthMode, scopeAllowsCommand, formatOutOfScopeMessage, formatSessionOnlyMessage, isAuthRecoveryCommand, } from "../auth/scope.js";
 import { guardCliVersion } from "../version-check.js";
+import { resolveApp } from "../apps-support/resolve.js";
+import { Args } from "@oclif/core";
+/** Positional app target shared by the `app …` commands that act on one app. */
+export const appTargetArg = {
+    target: Args.string({ required: false, description: "App slug or id (default: the directory's linked app)." }),
+};
+import { clientsForLinkTeam, notLinkedError } from "../apps-support/link.js";
 export class BaseCommand extends Command {
     static baseFlags = {
         output: Flags.string({
@@ -29,10 +37,11 @@ export class BaseCommand extends Command {
         if (this.clients.authMode === "api_key") {
             const ctorScope = this.constructor.apiKeyScope;
             // Skip the whoami round-trip for session-only commands (apiKeyScope
-            // "none" or undefined). The guard below deny-session-onlys from the
-            // label alone — no scope set is needed — so forcing a network call
-            // for e.g. `synteq logout` under an offline API-key mode is a bad UX.
-            if (ctorScope !== undefined && ctorScope !== "none") {
+            // "none" or undefined) and for "any" commands. The guard below decides
+            // both from the label alone — no scope set is needed — so forcing a
+            // network call for e.g. `synteq logout` under an offline API-key mode
+            // is a bad UX.
+            if (ctorScope !== undefined && ctorScope !== "none" && ctorScope !== "any") {
                 try {
                     const who = await this.clients.api.auth.apiKeyWhoami();
                     this.clients.apiKeyScopes = new Set(who.scopes);
@@ -50,6 +59,7 @@ export class BaseCommand extends Command {
             envOverride: process.env.SYNTEQ_TUI,
             noColor: Boolean(process.env.NO_COLOR),
             isTty,
+            jsonOutput: this.outputFormat === "json",
         });
         {
             const cmdId = this.id ?? "<command>";
@@ -87,6 +97,59 @@ export class BaseCommand extends Command {
             renderTable();
         }
     }
+    /** An informational line. stdout in table mode; stderr in JSON mode, where
+     *  stdout carries the JSON document only (piped / `-o json` output must
+     *  parse). */
+    info(line) {
+        if (this.outputFormat === "json")
+            this.logToStderr(line);
+        else
+            this.log(line);
+    }
+    /**
+     * The app-resolution dance every `app *` command shares: take an explicit
+     * `--app <slug|uuid>` or fall back to this directory's `synteq link`,
+     * rescope the client to the linked team, and resolve to a full App.
+     * Rescopes `this.clients` as a side effect (same as the inline blocks it
+     * replaces). A bad slug is a user error (exit 1); an API fault propagates
+     * to `this.fail`.
+     */
+    /**
+     * Commands with one required positional (a release ref, an env key, a
+     * hostname, a tier) also take the app as an optional LEADING positional:
+     * `app deployment show rackmap 1` and `app deployment show 1` both work.
+     * Returns [target, value]; errors when the value is missing.
+     */
+    positional(first, second, name) {
+        if (second !== undefined)
+            return [first, second];
+        if (first === undefined)
+            this.error(`Missing required argument: ${name}`, { exit: 1 });
+        return [undefined, first];
+    }
+    async resolveLinkedApp(flags, target) {
+        // `synteq app health my-api` and `--app my-api` are the same thing.
+        let appRef = target ?? flags.app;
+        let linkProjectId;
+        if (!appRef) {
+            const link = this.clients.config.linkFor(process.cwd());
+            if (!link)
+                this.error(notLinkedError("--app <slug>"), { exit: 1 });
+            if (linkKind(link) === "function") {
+                this.error(`This directory is linked to the function "${link.app_slug}", not an app. ` +
+                    "Use `synteq function …` here, or pass --app <slug>.", { exit: 1 });
+            }
+            appRef = link.app_id;
+            linkProjectId = link.project_id;
+            this.clients = clientsForLinkTeam(this.clients, link, flags);
+        }
+        // Let the resolution failure propagate so the command's `this.fail` maps
+        // it: `resolveApp` throws a plain Error for a bad slug (→ exit 1) and an
+        // ApiError for a 404. The old `"status" in e` catch flattened a
+        // NetworkError / AuthExpiredError (neither carries `status`) to exit 1
+        // instead of its 3 / 2.
+        return resolveApp(this.clients.api, appRef, linkProjectId);
+    }
     failWith(detail, exit, status, requestId) {
         if (this.outputFormat === "json") {
             process.stderr.write(JSON.stringify({
@@ -115,6 +178,26 @@ export class BaseCommand extends Command {
         }
         return super.catch(err);
     }
+    /** A finished command gives the shell back. Interactive prompts (inquirer,
+     *  clack) attach to stdin, and a TTY stdin that is left flowing or ref'd
+     *  keeps Node's event loop — and so the process — alive after the last line
+     *  of output, which reads as the CLI hanging. `run()` has resolved or thrown
+     *  by the time oclif calls this, so nothing still needs the keyboard. */
+    async finally(err) {
+        try {
+            const { stdin } = process;
+            if (stdin.isTTY) {
+                if (stdin.isRaw)
+                    stdin.setRawMode?.(false);
+                stdin.pause();
+                stdin.unref?.();
+            }
+        }
+        catch {
+            // releasing the terminal is best-effort; never mask the command's result
+        }
+        return super.finally(err);
+    }
     fail(err) {
         if (err instanceof AuthExpiredError) {
             this.failWith(err.message, 2, 401);

package/dist/base/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/base/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/base/command.ts"],"names":[],"mappings":"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"}

package/dist/commands/agents.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "@oclif/core";
+/** The CLI's contract for automation, as Markdown. Kept next to the code it
+ *  describes; the portal's /agent-use.txt links here for the CLI details. */
+export declare function agentGuide(bin: string): string;
+export default class Agents extends Command {
+    static description: string;
+    static apiKeyScope: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/agents.js

@@ -0,0 +1,53 @@
+import { Command } from "@oclif/core";
+import { UPGRADE_COMMAND } from "../version-check.js";
+/** The CLI's contract for automation, as Markdown. Kept next to the code it
+ *  describes; the portal's /agent-use.txt links here for the CLI details. */
+export function agentGuide(bin) {
+    return [
+        `# ${bin} CLI: notes for AI agents and scripts`,
+        "",
+        "## Auth",
+        "- Create a team API key at https://cloud.synteq.com/organization/api-keys, then either",
+        `  \`export SYNTEQ_API_TOKEN=sk_...\` (this process only) or \`echo "$KEY" | ${bin} login --with-token\` (stored).`,
+        `- \`${bin} whoami\` shows who the CLI acts as.`,
+        `- API keys are scope-limited. With a key, \`${bin} --help\` lists only the commands the key can run.`,
+        "",
+        "## Output",
+        "- stdout is JSON whenever it is not a terminal (piped or captured). `-o json` / `-o table` force a format.",
+        '- In JSON mode an error is one line on stderr: `{"error":{"detail","status","request_id","exit_code"}}`.',
+        `- Exit codes: 0 ok, 1 bad input / not found / out of scope, 2 not signed in, 3 server or network error (safe to retry reads), 4 CLI too old (\`${UPGRADE_COMMAND}\`).`,
+        "",
+        "## Finding commands",
+        `- \`${bin} --help\` lists topics. \`${bin} <topic> --help\` and \`${bin} <topic> <verb> --help\` document every flag, with examples.`,
+        `- No command for it? \`${bin} api <METHOD> <path>\` calls any endpoint in https://api.cloud.synteq.com/openapi.json and prints the raw JSON.`,
+        `  Body from \`--input file.json\` or stdin; query params with \`--query key=value\`. Example: \`${bin} api GET /resources\`.`,
+        "",
+        "## Prompts and confirmation",
+        "- Pickers and confirmations only appear on a terminal. When piped, pass values as flags (each command's --help names them).",
+        "- Commands that destroy, reinstall, power-cycle, or charge money take `--yes` to skip their confirmation.",
+        "",
+        "## Rules",
+        "- Get explicit confirmation from the user before destroying, reinstalling, or power-cycling a resource.",
+        "- Get explicit confirmation from the user before placing an order, deploying to a paid plan, or changing billing.",
+        "- Resource IDs are UUID strings; treat them as opaque.",
+        "",
+    ].join("\n");
+}
+export default class Agents extends Command {
+    static description = [
+        "Print the automation guide for AI agents and scripts (auth, JSON output, exit codes, finding commands).",
+        "",
+        "Markdown on stdout, so it can be appended to a project's AGENTS.md or CLAUDE.md.",
+        "Needs no sign-in and makes no network calls.",
+    ].join("\n");
+    static apiKeyScope = "any";
+    static examples = [
+        "<%= config.bin %> agents",
+        "<%= config.bin %> agents >> AGENTS.md   # give every agent in this repo the guide",
+    ];
+    async run() {
+        await this.parse(Agents);
+        process.stdout.write(agentGuide(this.config.bin));
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;6EAC6E;AAC7E,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO;QACL,KAAK,GAAG,uCAAuC;QAC/C,EAAE;QACF,SAAS;QACT,wFAAwF;QACxF,+EAA+E,GAAG,iCAAiC;QACnH,OAAO,GAAG,sCAAsC;QAChD,+CAA+C,GAAG,oDAAoD;QACtG,EAAE;QACF,WAAW;QACX,4GAA4G;QAC5G,0GAA0G;QAC1G,kJAAkJ,eAAe,MAAM;QACvK,EAAE;QACF,qBAAqB;QACrB,OAAO,GAAG,6BAA6B,GAAG,2BAA2B,GAAG,8DAA8D;QACtI,0BAA0B,GAAG,iHAAiH;QAC9I,mGAAmG,GAAG,wBAAwB;QAC9H,EAAE;QACF,6BAA6B;QAC7B,6HAA6H;QAC7H,2GAA2G;QAC3G,EAAE;QACF,UAAU;QACV,yGAAyG;QACzG,mHAAmH;QACnH,wDAAwD;QACxD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,MAAM,CAAC,WAAW,GAAG;QACnB,yGAAyG;QACzG,EAAE;QACF,kFAAkF;QAClF,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,MAAM,CAAC,QAAQ,GAAG;QAChB,0BAA0B;QAC1B,mFAAmF;KACpF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC"}

package/dist/commands/api.d.ts

@@ -1,6 +1,5 @@
 import { BaseCommand } from "../base/command.js";
 export default class Api extends BaseCommand {
-    static hidden: boolean;
     static description: string;
     static apiKeyScope: string;
     static examples: string[];

package/dist/commands/api.js

@@ -5,18 +5,19 @@ import { readStdin } from "../ui/stdin.js";
 const METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE"]);
 const PROTECTED_HEADERS = new Set(["authorization", "x-api-key"]);
 export default class Api extends BaseCommand {
-    static hidden = true;
     static description = [
-        "Make a raw authenticated request to the portal API (escape hatch).",
+        "Make a raw authenticated request to any portal API endpoint (escape hatch).",
         "",
         "Prefer the dedicated commands (`synteq vps list`, `synteq ssh-key add`, …)",
         "when one exists — they validate input and format output. `synteq api` is",
-        "for endpoints the CLI doesn't wrap yet: it authenticates as you (session",
+        "for endpoints the CLI doesn't wrap yet (see the OpenAPI spec at",
+        "https://api.cloud.synteq.com/openapi.json): it authenticates as you (session",
         "or API token), prints the raw JSON response to stdout (pretty on a TTY,",
         "compact when piped), and maps failures to the standard error envelope",
-        "and exit codes (1 user / 2 auth / 3 server-or-network).",
+        "and exit codes (1 user / 2 auth / 3 server-or-network). With an API key,",
+        "the key's scopes decide which endpoints answer (403 otherwise).",
     ].join("\n");
-    static apiKeyScope = "none";
+    static apiKeyScope = "any";
     static examples = [
         "<%= config.bin %> api GET /resources",
         "<%= config.bin %> api GET /billing/balance --include        # status + headers on stderr",

package/dist/commands/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/commands/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/commands/api.ts"],"names":[],"mappings":"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"}

package/dist/commands/app/deployment/list.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app deployment list` — release/deploy history for an app. */
+export default class DeploymentList extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/deployment/list.js

@@ -0,0 +1,45 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { renderTable } from "../../../ui/table.js";
+import { statusColor, dim } from "../../../ui/glyphs.js";
+/** `synteq app deployment list` — release/deploy history for an app. */
+export default class DeploymentList extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List an app's deployment history (releases, newest first).";
+    static examples = [
+        "<%= config.bin %> app deployment list                # bare: linked app",
+        "<%= config.bin %> app deployment list --app my-api",
+        "<%= config.bin %> app deployment list --app my-api -o json",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(DeploymentList);
+        try {
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const releases = await withSpinner("Loading deployments", () => this.clients.api.apps.releases(app.id));
+            this.emit(releases, () => {
+                if (releases.length === 0) {
+                    this.log("No deployments yet.");
+                    return;
+                }
+                this.log(renderTable(["#", "Status", "Created", "Build", "Message"], releases.map((r) => [
+                    String(r.number),
+                    statusColor(r.status ?? ""),
+                    r.deployedAt ?? "",
+                    r.buildId ? dim(r.buildId.slice(0, 8)) : dim("—"),
+                    (r.commitMessage ?? "").slice(0, 48),
+                ])));
+                this.log(dim("\nInspect one: synteq app deployment show <#>"));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/app/deployment/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/app/deployment/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wEAAwE;AACxE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,4DAA4D,CAAC;IAClF,MAAM,CAAC,QAAQ,GAAG;QAChB,yEAAyE;QACzE,oDAAoD;QACpD,4DAA4D;KAC7D,CAAC;IACF,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC;KAChG,CAAC;IACF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CACvC,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACvB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;oBAChC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,CACN,WAAW,CACT,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,EAC9C,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBAClB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBAChB,WAAW,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;oBAC3B,CAAC,CAAC,UAAU,IAAI,EAAE;oBAClB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;oBACjD,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACrC,CAAC,CACH,CACF,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC"}

package/dist/commands/app/deployment/rollback.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app deployment rollback --to N` — re-deploy an earlier release's
+ *  image. Backend: POST /apps/{id}/rollback; the server mints a NEW release
+ *  carrying the old image, so history stays append-only. */
+export default class DeploymentRollback extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/deployment/rollback.js

@@ -0,0 +1,57 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { isInteractive, confirmAction } from "../../../ui/wizard.js";
+import { ok, dim } from "../../../ui/glyphs.js";
+/** `synteq app deployment rollback --to N` — re-deploy an earlier release's
+ *  image. Backend: POST /apps/{id}/rollback; the server mints a NEW release
+ *  carrying the old image, so history stays append-only. */
+export default class DeploymentRollback extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Roll an app back to an earlier release (re-deploys that release's image as a new release).";
+    static examples = [
+        "<%= config.bin %> app deployment rollback --to 12                         # bare: this directory's linked app",
+        "<%= config.bin %> app deployment rollback --app my-api --to 12 --yes      # no prompt (required when piped)",
+        "<%= config.bin %> app deployment rollback --app my-api --to 12 --yes -o json",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        to: Flags.integer({
+            required: true,
+            description: "Release number to roll back to — see `synteq app deployment list`.",
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Skip the confirmation prompt (required for non-interactive use).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(DeploymentRollback);
+        try {
+            if (flags.to < 1)
+                this.error("--to must be a release number (1 or higher).", { exit: 1 });
+            const app = await this.resolveLinkedApp(flags, args.target);
+            if (!flags.yes) {
+                if (!(isInteractive() && this.outputFormat === "table")) {
+                    this.error("Refusing to roll back without --yes in a non-interactive session.", { exit: 1 });
+                }
+                const go = await confirmAction(`Roll ${app.slug} back to release #${flags.to}?`, false);
+                if (!go) {
+                    this.log("Aborted.");
+                    return;
+                }
+            }
+            const build = await withSpinner(`Rolling back to #${flags.to}`, () => this.clients.api.apps.rollback(app.id, flags.to));
+            this.emit(build, () => {
+                this.log(ok(`Rollback to release #${flags.to} started on ${app.slug}.`));
+                this.log(dim("A new release carrying that image is rolling out — `synteq app deployment list` shows it."));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/commands/app/deployment/rollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.js","sourceRoot":"","sources":["../../../../src/commands/app/deployment/rollback.ts"],"names":[],"mappings":"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"}

package/dist/commands/app/deployment/show.d.ts

@@ -0,0 +1,26 @@
+import { BaseCommand } from "../../../base/command.js";
+/**
+ * `synteq app deployment show <ref>` — one build's full detail.
+ *
+ * `<ref>` may be a build id, a release id, or a release number (`9` or
+ * `#9`). Release ids and numbers are resolved to their build id via the
+ * release list, so `deployment show <n>` composes directly with the `#`
+ * column that `deployment list` prints.
+ */
+export default class DeploymentShow extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        ref: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /** Resolve a user-supplied ref to a build id. A bare/`#`-prefixed integer,
+     *  or an id that matches a release, is mapped through that release's
+     *  buildId; anything else is treated as a build id already. */
+    private resolveBuildId;
+}

package/dist/commands/app/deployment/show.js

@@ -0,0 +1,98 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel } from "../../../ui/wizard.js";
+import { statusColor, dim } from "../../../ui/glyphs.js";
+import { pageThrough } from "../../../api/client.js";
+/**
+ * `synteq app deployment show <ref>` — one build's full detail.
+ *
+ * `<ref>` may be a build id, a release id, or a release number (`9` or
+ * `#9`). Release ids and numbers are resolved to their build id via the
+ * release list, so `deployment show <n>` composes directly with the `#`
+ * column that `deployment list` prints.
+ */
+export default class DeploymentShow extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Show the details of one build/deployment (status, steps, who triggered it). Accepts a build id, a release id, or a release number.";
+    static examples = [
+        "<%= config.bin %> app deployment show 9                     # by release number",
+        "<%= config.bin %> app deployment show 01a05963...           # by build or release id",
+        "<%= config.bin %> app deployment show 9 --app my-api -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "App slug or id (optional; default: the directory's linked app or --app)." }),
+        ref: Args.string({
+            required: false,
+            description: "A build id, a release id, or a release number (e.g. 9 or #9) from `app deployment list`.",
+        }),
+    };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(DeploymentShow);
+        const [target, ref] = this.positional(args.target, args.ref, "ref");
+        try {
+            const app = await this.resolveLinkedApp(flags, target);
+            const buildId = await withSpinner("Loading build", async () => {
+                const id = await this.resolveBuildId(app.id, ref);
+                return this.clients.api.apps.buildDetail(app.id, id).then((b) => ({ id, b }));
+            });
+            const { id, b } = buildId;
+            this.emit(b, () => {
+                this.log(panel(`Build ${id.slice(0, 12)}`, [
+                    ["App", app.slug],
+                    ["Status", statusColor(b.status ?? "")],
+                    ["Triggered by", b.triggeredBy?.name ?? dim("—")],
+                    ["Image digest", b.imageDigest ? dim(b.imageDigest.slice(0, 24)) : dim("—")],
+                ]));
+                for (const s of b.steps ?? []) {
+                    this.log(`  ${statusColor(s.status)}  ${s.label}${s.durationMs != null ? dim(` (${s.durationMs}ms)`) : ""}`);
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    /** Resolve a user-supplied ref to a build id. A bare/`#`-prefixed integer,
+     *  or an id that matches a release, is mapped through that release's
+     *  buildId; anything else is treated as a build id already. */
+    async resolveBuildId(appId, ref) {
+        const num = ref.startsWith("#") ? ref.slice(1) : ref;
+        const asNumber = /^\d+$/.test(num) ? Number(num) : null;
+        // Only fetch the release list when the ref could be a release (a number,
+        // or an id we can try to match) — a plain build id skips the round-trip.
+        if (asNumber !== null || /^[0-9a-f-]{20,}$/i.test(ref)) {
+            let releases = [];
+            try {
+                // The release list is paged (50/200, portal #419) and ordered by
+                // number desc, so a number past the first page is reached by
+                // walking until the page's last number is at or below it; a
+                // release id has no order to exploit and walks until found.
+                releases = await pageThrough((page) => this.clients.api.apps.releasesPage(appId, { page }), (page) => asNumber !== null
+                    ? page.items.some((r) => r.number <= asNumber)
+                    : page.items.some((r) => r.id === ref));
+            }
+            catch {
+                // If the list read fails, fall through and try the ref as a build id.
+            }
+            const match = asNumber !== null
+                ? releases.find((r) => r.number === asNumber)
+                : releases.find((r) => r.id === ref);
+            if (match) {
+                if (!match.buildId) {
+                    this.error(`Release #${match.number} has no build (image-ref or seeded release) — nothing to show.`, { exit: 1 });
+                }
+                return match.buildId;
+            }
+            if (asNumber !== null) {
+                this.error(`No release #${asNumber} on this app.`, { exit: 1 });
+            }
+        }
+        return ref;
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/app/deployment/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../../src/commands/app/deployment/show.ts"],"names":[],"mappings":"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"}

package/dist/commands/app/domain/add.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app domain add <hostname>` — attach a custom domain (returns the
+ *  DNS records to add). */
+export default class DomainAdd extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        hostname: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "accept-fee": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}