@synteq/cli 0.2.0 → 1.1.1

package/dist/commands/app/settings/set.d.ts

@@ -0,0 +1,25 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app settings set` — patch one or more build/deploy settings. Only
+ *  the flags you pass are changed; the rest are left as they are. */
+export default class SettingsSet 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>;
+        "root-directory": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "dockerfile-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "build-context": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "docker-command": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "pre-deploy-command": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "auto-deploy": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "health-check-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "build-filter-included": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "build-filter-ignored": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/settings/set.js

@@ -0,0 +1,96 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { ok, dim } from "../../../ui/glyphs.js";
+/** A build filter is a list of globs; the flag takes them comma-separated, the
+ *  way the portal's field does — a repeatable flag would swallow a positional
+ *  app name that follows it. `''` is the "clear it" value, mirroring
+ *  `--port 0 → null` below: `[]` is what the API takes to mean "no filter". */
+const globs = (v) => v
+    .split(",")
+    .map((g) => g.trim())
+    .filter(Boolean);
+/** `synteq app settings set` — patch one or more build/deploy settings. Only
+ *  the flags you pass are changed; the rest are left as they are. */
+export default class SettingsSet extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Change an app's build/deploy settings. Only the flags you pass are updated; omit a flag to leave it unchanged.";
+    static examples = [
+        "<%= config.bin %> app settings set --auto-deploy off",
+        "<%= config.bin %> app settings set --root-directory backend --dockerfile-path backend/Dockerfile --app my-api",
+        "<%= config.bin %> app settings set --health-check-path /healthz --app my-api -o json",
+        "<%= config.bin %> app settings set --port 5230 --app my-memos",
+        "<%= config.bin %> app settings set --port 0 --app my-memos",
+        "<%= config.bin %> app settings set my-api --build-filter-included 'backend/**,shared/**' --build-filter-ignored '**/*.md'",
+        "<%= config.bin %> app settings set --build-filter-included '' --app my-api   # clear the included filter",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        "root-directory": Flags.string({ description: "Subdirectory to build from (default: repo root)." }),
+        "dockerfile-path": Flags.string({ description: "Path to the Dockerfile, relative to the build context." }),
+        "build-context": Flags.string({ description: "Docker build context directory." }),
+        "docker-command": Flags.string({ description: "Override the container start command." }),
+        "pre-deploy-command": Flags.string({ description: "Command run once before each deploy (migrations etc.)." }),
+        "auto-deploy": Flags.string({
+            options: ["on_commit", "off"],
+            description: "Deploy automatically on every push (on_commit) or only manually (off).",
+        }),
+        "health-check-path": Flags.string({ description: "HTTP path polled to gate a deploy healthy (e.g. /healthz)." }),
+        "build-filter-included": Flags.string({
+            description: "Comma-separated path globs whose changes trigger a build. A push touching none of them is skipped; with no filter any change builds. Pass '' to clear.",
+        }),
+        "build-filter-ignored": Flags.string({
+            description: "Comma-separated path globs to ignore when deciding to build. A push touching only these won't build. Pass '' to clear.",
+        }),
+        port: Flags.integer({
+            description: "Port the app listens on (1-65535). The health check and traffic both go here. Pass 0 to clear it and let the runtime detect the port.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(SettingsSet);
+        try {
+            const patch = {};
+            if (flags["root-directory"] !== undefined)
+                patch.rootDirectory = flags["root-directory"];
+            if (flags["dockerfile-path"] !== undefined)
+                patch.dockerfilePath = flags["dockerfile-path"];
+            if (flags["build-context"] !== undefined)
+                patch.buildContext = flags["build-context"];
+            if (flags["docker-command"] !== undefined)
+                patch.dockerCommand = flags["docker-command"];
+            if (flags["pre-deploy-command"] !== undefined)
+                patch.preDeployCommand = flags["pre-deploy-command"];
+            if (flags["auto-deploy"] !== undefined)
+                patch.autoDeploy = flags["auto-deploy"];
+            if (flags["health-check-path"] !== undefined)
+                patch.healthCheckPath = flags["health-check-path"];
+            if (flags["build-filter-included"] !== undefined)
+                patch.buildFilterIncluded = globs(flags["build-filter-included"]);
+            if (flags["build-filter-ignored"] !== undefined)
+                patch.buildFilterIgnored = globs(flags["build-filter-ignored"]);
+            if (flags.port !== undefined) {
+                // 0 is the CLI's "clear it" sentinel: the API takes `null` to mean
+                // "no override, detect the port", but a flag cannot carry null, and 0
+                // is not a port anything can listen on so it is free to repurpose.
+                // Every other out-of-range value is left to the API's own 422 rather
+                // than duplicating the bounds here.
+                patch.port = flags.port === 0 ? null : flags.port;
+            }
+            if (Object.keys(patch).length === 0) {
+                this.error("Nothing to change — pass at least one setting flag (see --help).", { exit: 1 });
+            }
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const s = await withSpinner("Saving settings", () => this.clients.api.apps.patchSettings(app.id, patch));
+            this.emit(s, () => {
+                this.log(ok(`Updated ${Object.keys(patch).length} setting(s) on ${app.slug}.`));
+                this.log(dim("Run `synteq app settings show` to see the full config."));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/app/settings/set.js.map

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

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

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app settings show` — build/deploy settings for an app. */
+export default class SettingsShow 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/settings/show.js

@@ -0,0 +1,48 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel } from "../../../ui/wizard.js";
+import { dim } from "../../../ui/glyphs.js";
+/** `synteq app settings show` — build/deploy settings for an app. */
+export default class SettingsShow extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Show an app's build and deploy settings (root dir, Dockerfile path, commands, auto-deploy, health check).";
+    static examples = [
+        "<%= config.bin %> app settings show                # bare: linked app",
+        "<%= config.bin %> app settings show --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(SettingsShow);
+        try {
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const s = await withSpinner("Loading settings", () => this.clients.api.apps.settings(app.id));
+            this.emit(s, () => {
+                this.log(panel(`${app.slug} settings`, [
+                    ["Root directory", s.rootDirectory ?? dim("(repo root)")],
+                    ["Dockerfile path", s.dockerfilePath ?? dim("(auto)")],
+                    ["Build context", s.buildContext ?? dim("(auto)")],
+                    ["Docker command", s.dockerCommand ?? dim("(image default)")],
+                    ["Pre-deploy command", s.preDeployCommand ?? dim("(none)")],
+                    ["Auto-deploy", s.autoDeploy],
+                    ["Health check path", s.healthCheckPath ?? dim("(none)")],
+                    // An unset port is not "(none)" — the app IS being probed on
+                    // something, so show what, and say it was not chosen by hand.
+                    ["Port", s.port != null ? String(s.port) : dim(`${s.effectivePort} (detected)`)],
+                ]));
+                if (s.buildFilterIncluded?.length)
+                    this.log(dim(`\nBuild filter — included: ${s.buildFilterIncluded.join(", ")}`));
+                if (s.buildFilterIgnored?.length)
+                    this.log(dim(`Build filter — ignored: ${s.buildFilterIgnored.join(", ")}`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=show.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq app unlink` — forget this directory's `synteq link`. */
+export default class AppUnlink extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/app/unlink.js

@@ -0,0 +1,25 @@
+import { BaseCommand } from "../../base/command.js";
+import { ok } from "../../ui/glyphs.js";
+/** `synteq app unlink` — forget this directory's `synteq link`. */
+export default class AppUnlink extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Unlink the current directory from its app (forgets the saved `synteq link`).";
+    static examples = [
+        "<%= config.bin %> app unlink",
+        "<%= config.bin %> app unlink -o json",
+    ];
+    async run() {
+        await this.initClients();
+        try {
+            const cwd = process.cwd();
+            const removed = this.clients.config.removeLink(cwd);
+            this.emit({ directory: cwd, removed }, () => {
+                this.log(removed ? ok(`Unlinked ${cwd}.`) : `No link stored for ${cwd}.`);
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=unlink.js.map

package/dist/commands/app/unlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/commands/app/unlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAExC,mEAAmE;AACnE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,8EAA8E,CAAC;IACpG,MAAM,CAAC,QAAQ,GAAG;QAChB,8BAA8B;QAC9B,sCAAsC;KACvC,CAAC;IACF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;gBAC1C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;YAC5E,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/apps/create.d.ts

@@ -0,0 +1,26 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq apps create` — create a managed-container app in the active project.
+ *
+ * Goes through the SAME `createApp` seam `synteq deploy --create` and the link
+ * walkthrough use: a free tier is a bare `POST /apps` behind the saved-card
+ * gate; a paid tier is an ORDER (first-month quote → card → confirm → charge →
+ * the app is provisioned off the settled order). Calling `POST /apps` directly
+ * for a paid tier only ever earned the backend's 402 ("Paid plans are created
+ * through an order"), which is what this command did until 2026-09-25.
+ */
+export default class AppsCreate extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        slug: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        plan: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        region: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "payment-method": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "apply-credits": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/create.js

@@ -0,0 +1,91 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { statusColor } from "../../ui/glyphs.js";
+import { isInteractive, panel } from "../../ui/wizard.js";
+import { PaymentMethodRequired } from "../../ui/payment-gate.js";
+import { createApp, resolveAppRegion } from "../link.js";
+/**
+ * `synteq apps create` — create a managed-container app in the active project.
+ *
+ * Goes through the SAME `createApp` seam `synteq deploy --create` and the link
+ * walkthrough use: a free tier is a bare `POST /apps` behind the saved-card
+ * gate; a paid tier is an ORDER (first-month quote → card → confirm → charge →
+ * the app is provisioned off the settled order). Calling `POST /apps` directly
+ * for a paid tier only ever earned the backend's 402 ("Paid plans are created
+ * through an order"), which is what this command did until 2026-09-25.
+ */
+export default class AppsCreate extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Create a managed-container app in the active project.";
+    static examples = [
+        "<%= config.bin %> apps create --slug my-api",
+        "<%= config.bin %> apps create --slug my-api --plan hobby --region dfw-primary --yes",
+        "<%= config.bin %> apps create --slug my-api -o json   # scriptable: prints the App row",
+    ];
+    static flags = {
+        slug: Flags.string({
+            required: true,
+            description: "App name/slug — unique within the project (1..63 chars).",
+        }),
+        plan: Flags.string({
+            description: "Plan tier slug, e.g. free or starter (default: free, same as `deploy --create`). A paid tier charges the first month now.",
+        }),
+        region: Flags.string({
+            description: "Region to deploy in (default: the only placeable location, else asks).",
+        }),
+        project: Flags.string({
+            description: "Project id to create in (defaults to the active project).",
+        }),
+        "payment-method": Flags.string({
+            description: "For a paid --plan: saved payment method id to charge (default: the team's default, or asks).",
+        }),
+        "apply-credits": Flags.boolean({
+            description: "For a paid --plan: apply the team's credit balance to the first month first.",
+            default: false,
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Confirm the first-month charge of a paid --plan without asking (scripts must pass this).",
+            default: false,
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { flags } = await this.parse(AppsCreate);
+        const interactive = isInteractive() && this.outputFormat === "table";
+        try {
+            const region = await resolveAppRegion(this.clients, flags.region, async (locations) => {
+                if (!interactive) {
+                    throw new Error(`Several locations can place this app — pass --region (${locations.map((l) => l.code).join(", ")}).`);
+                }
+                const { pickFromCatalog } = await import("../../ui/wizard.js");
+                return pickFromCatalog("Location", locations.map((l) => ({ value: l.region, name: l.city, description: l.code })));
+            });
+            const app = await createApp(this.clients, { slug: flags.slug, planTier: flags.plan ?? "free", region, projectId: flags.project }, {
+                interactive,
+                log: (line) => this.info(line),
+                paymentMethodId: flags["payment-method"],
+                applyCredits: flags["apply-credits"],
+                yes: flags.yes,
+            });
+            this.emit(app, () => {
+                this.log(panel("App created", [
+                    ["Slug", app.slug],
+                    ["ID", app.id],
+                    ["Status", statusColor(app.status)],
+                    ["Plan", app.planTier],
+                    ["Region", app.region],
+                    ["Hostname", app.hostname],
+                ]));
+                this.log("");
+                this.log(`Deploy it: synteq deploy --app ${app.slug}   (from the app's directory, or --image <ref>)`);
+            });
+        }
+        catch (err) {
+            if (err instanceof PaymentMethodRequired)
+                this.error(err.message, { exit: 1 });
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/apps/create.js.map

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

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq apps list` — managed-container apps in the active project.
+ *
+ * Backend: GET /apps. Scoping matches `vps list` — the server resolves the
+ * active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class AppsList extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/list.js

@@ -0,0 +1,54 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { renderTable, shortId, truncationNote } from "../../ui/table.js";
+import { statusColor } from "../../ui/glyphs.js";
+/**
+ * `synteq apps list` — managed-container apps in the active project.
+ *
+ * Backend: GET /apps. Scoping matches `vps list` — the server resolves the
+ * active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class AppsList extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List managed-container apps in the active project.";
+    static examples = [
+        "<%= config.bin %> apps list",
+        "<%= config.bin %> apps list --project 019e...   # scope to a specific project",
+        "<%= config.bin %> apps list -o json",
+    ];
+    static flags = {
+        project: Flags.string({
+            description: "Project id to scope to (defaults to the active project).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { flags } = await this.parse(AppsList);
+        try {
+            const page = await this.clients.api.apps.listPage(flags.project);
+            const apps = page.items;
+            const note = truncationNote(apps.length, page.total, "--project");
+            this.emit(apps, () => {
+                if (apps.length === 0) {
+                    this.log("No apps. Create one with `synteq apps create --slug <name>`.");
+                    return;
+                }
+                this.log(renderTable(["ID", "SLUG", "STATUS", "PLAN", "REGION", "REL", "HOSTNAME"], apps.map((a) => [
+                    shortId(a.id),
+                    a.slug,
+                    statusColor(a.status),
+                    a.planTier,
+                    a.region,
+                    String(a.activeRelease),
+                    a.hostname,
+                ])));
+            });
+            if (note)
+                this.info(note);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/apps/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/apps/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,oDAAoD,CAAC;IAC1E,MAAM,CAAC,QAAQ,GAAG;QAChB,6BAA6B;QAC7B,+EAA+E;QAC/E,qCAAqC;KACtC,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,0DAA0D;SACxE,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;gBACnB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,IAAI,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;oBACzE,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,CACN,WAAW,CACT,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,EAC7D,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACd,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,CAAC,CAAC,IAAI;oBACN,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;oBACrB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,MAAM;oBACR,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;oBACvB,CAAC,CAAC,QAAQ;iBACX,CAAC,CACH,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC"}

package/dist/commands/baremetal/activity.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../base/command.js";
+export default class BaremetalActivity extends BaseCommand {
+    static description: string;
+    static apiKeyScope: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/baremetal/activity.js

@@ -0,0 +1,53 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveBaremetalId } from "../../ui/baremetal-resolve.js";
+import { renderTable } from "../../ui/table.js";
+import { dim } from "../../ui/glyphs.js";
+export default class BaremetalActivity extends BaseCommand {
+    static description = "Show recent activity for a bare metal server.";
+    // GET /baremetal/{id}/activity resolves to read:baremetal via the backend's
+    // broad bare-metal read rule (2026-08-24 audit wave).
+    static apiKeyScope = "read:baremetal";
+    static examples = [
+        "<%= config.bin %> baremetal activity 019e...",
+        "<%= config.bin %> baremetal activity 019e... --limit 50",
+        "<%= config.bin %> baremetal activity 019e... --limit 25 --offset 25",
+        "<%= config.bin %> baremetal activity 019e... -o json",
+    ];
+    static args = {
+        id: Args.string({
+            description: "Server id (full or the short id from `baremetal list`), hostname, reference, or IP.",
+            required: true,
+        }),
+    };
+    static flags = {
+        limit: Flags.integer({ default: 25, description: "Max rows (1..100)." }),
+        offset: Flags.integer({ default: 0, description: "Pagination offset." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(BaremetalActivity);
+        try {
+            const serviceId = await resolveBaremetalId(this.clients.api, args.id);
+            const log = await this.clients.api.baremetal.activity(serviceId, flags.limit, flags.offset);
+            this.emit(log, () => {
+                if (log.items.length === 0) {
+                    this.log("No activity entries.");
+                    return;
+                }
+                this.log(renderTable(["WHEN", "ACTOR", "ACTION", "DETAIL"], log.items.map((e) => [
+                    e.created_at.slice(0, 19).replace("T", " "),
+                    e.actor?.email ?? "system",
+                    e.action,
+                    e.detail ?? "",
+                ])));
+                this.log("");
+                this.log(dim(`Showing ${log.items.length} of ${log.total} entries.`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=activity.js.map

package/dist/commands/baremetal/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/commands/baremetal/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAEzC,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,WAAW;IACxD,MAAM,CAAC,WAAW,GAAG,+CAA+C,CAAC;IACrE,4EAA4E;IAC5E,sDAAsD;IACtD,MAAM,CAAC,WAAW,GAAG,gBAAgB,CAAC;IACtC,MAAM,CAAC,QAAQ,GAAG;QAChB,8CAA8C;QAC9C,yDAAyD;QACzD,qEAAqE;QACrE,sDAAsD;KACvD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,qFAAqF;YAClG,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;QACxE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;KACzE,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC5F,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;oBACjC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,CACN,WAAW,CACT,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EACrC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACnB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;oBAC3C,CAAC,CAAC,KAAK,EAAE,KAAK,IAAI,QAAQ;oBAC1B,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,MAAM,IAAI,EAAE;iBACf,CAAC,CACH,CACF,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,MAAM,OAAO,GAAG,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC;YACxE,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/baremetal/bandwidth.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from "../../base/command.js";
+export default class BaremetalBandwidth extends BaseCommand {
+    static description: string;
+    static apiKeyScope: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/baremetal/bandwidth.js

@@ -0,0 +1,86 @@
+import { Args } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveBaremetalId } from "../../ui/baremetal-resolve.js";
+import { panel } from "../../ui/wizard.js";
+import { renderTable } from "../../ui/table.js";
+import { statusColor } from "../../ui/glyphs.js";
+export default class BaremetalBandwidth extends BaseCommand {
+    static description = [
+        "Show a bare metal server's bandwidth usage: current month-to-date, plan allowance, and overage.",
+        "",
+        "Read-only. Includes up to 12 months of history. `-o json` returns",
+        "the full summary (current period + history + rates).",
+    ].join("\n");
+    static apiKeyScope = "read:baremetal";
+    static examples = [
+        "<%= config.bin %> baremetal bandwidth 019e...",
+        "<%= config.bin %> baremetal bandwidth 019e... -o json    # full summary for scripting",
+    ];
+    static args = {
+        id: Args.string({
+            description: "Server id (full or the short id from `baremetal list`), hostname, reference, or IP.",
+            required: true,
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args } = await this.parse(BaremetalBandwidth);
+        try {
+            const serviceId = await resolveBaremetalId(this.clients.api, args.id);
+            const summary = await this.clients.api.baremetal.bandwidth(serviceId);
+            this.emit(summary, () => {
+                const includedTb = summary.included_tb != null ? `${summary.included_tb} TB` : "unmetered";
+                const overage = summary.overage_per_tb != null ? `$${summary.overage_per_tb.toFixed(2)}/TB` : "—";
+                const cur = summary.current;
+                const usedTb = cur ? cur.used_tb : 0;
+                const overTb = summary.included_tb != null ? Math.max(0, usedTb - summary.included_tb) : 0;
+                const overageCost = summary.overage_per_tb != null && overTb > 0
+                    ? `$${(overTb * summary.overage_per_tb).toFixed(2)}`
+                    : null;
+                this.log(panel(`Bandwidth — ${serviceId}`, [
+                    ["Period", cur ? `${cur.period_start.slice(0, 10)} → ${cur.period_end.slice(0, 10)}` : "no open period"],
+                    ["Used", `${usedTb.toFixed(4)} TB`],
+                    ["Included", includedTb],
+                    ["Overage rate", overage],
+                    [
+                        "Est. overage",
+                        summary.included_tb != null
+                            ? overTb > 0
+                                ? `${overTb.toFixed(4)} TB${overageCost ? ` (${overageCost})` : ""}`
+                                : "none"
+                            : "",
+                    ],
+                    [
+                        "Last polled",
+                        cur?.last_polled_at ? cur.last_polled_at.slice(0, 19).replace("T", " ") : "",
+                    ],
+                    [
+                        "Overage invoiced",
+                        cur?.overage_invoiced_at ? statusColor("invoiced") : cur ? "not yet" : "",
+                    ],
+                ]));
+                if (summary.history.length > 0) {
+                    this.log("");
+                    this.log("History:");
+                    this.log(renderTable(["PERIOD", "USED (TB)", "IN", "OUT", "OVERAGE"], summary.history.map((p) => [
+                        p.period_start.slice(0, 7),
+                        p.used_tb.toFixed(4),
+                        fmtGB(p.bytes_in),
+                        fmtGB(p.bytes_out),
+                        p.overage_invoiced_at ? "invoiced" : "",
+                    ])));
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+function fmtGB(bytes) {
+    const gb = bytes / 1e9;
+    if (gb >= 1000)
+        return `${(gb / 1000).toFixed(2)} TB`;
+    return `${gb.toFixed(2)} GB`;
+}
+//# sourceMappingURL=bandwidth.js.map