@synteq/cli 0.2.0 → 1.1.2

package/dist/commands/app/health.js

@@ -0,0 +1,40 @@
+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";
+import { panel } from "../../ui/wizard.js";
+/** `synteq app health` — probe the running app's health endpoint. */
+export default class AppHealth extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Check a running app's health (probes its health endpoint through the cluster).";
+    static examples = [
+        "<%= config.bin %> app health                 # bare: uses this directory's `synteq link`",
+        "<%= config.bin %> app health --app my-api",
+        "<%= config.bin %> app health --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(AppHealth);
+        try {
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const h = await withSpinner("Probing health", () => this.clients.api.apps.health(app.id));
+            this.emit(h, () => {
+                this.log(panel(h.ok ? "Healthy" : "Unhealthy", [
+                    ["App", app.slug],
+                    ["OK", h.ok ? ok("yes") : "no"],
+                    ["Status", h.status != null ? String(h.status) : dim("—")],
+                    ["Latency", h.latencyMs != null ? `${h.latencyMs} ms` : dim("—")],
+                    ["Detail", h.detail ?? dim("—")],
+                ]));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=health.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/commands/app/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,qEAAqE;AACrE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,gFAAgF,CAAC;IACtG,MAAM,CAAC,QAAQ,GAAG;QAChB,0FAA0F;QAC1F,2CAA2C;QAC3C,mDAAmD;KACpD,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;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE;gBAChB,IAAI,CAAC,GAAG,CACN,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE;oBACpC,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC;oBACjB,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC/B,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBAC1D,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACjE,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;iBACjC,CAAC,CACH,CAAC;YACJ,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/index.d.ts

@@ -0,0 +1,6 @@
+import Status from "../status.js";
+/** Bare `synteq app` in a linked directory shows that app (same as `synteq status`). */
+export default class AppDefault extends Status {
+    static description: string;
+    static examples: string[];
+}

package/dist/commands/app/index.js

@@ -0,0 +1,7 @@
+import Status from "../status.js";
+/** Bare `synteq app` in a linked directory shows that app (same as `synteq status`). */
+export default class AppDefault extends Status {
+    static description = "Show the app linked to the current directory and its latest deploy (same as `synteq status`).";
+    static examples = ["<%= config.bin %> app", "<%= config.bin %> app -o json"];
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,wFAAwF;AACxF,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,MAAM;IAC5C,MAAM,CAAC,WAAW,GAAG,+FAA+F,CAAC;IACrH,MAAM,CAAC,QAAQ,GAAG,CAAC,uBAAuB,EAAE,+BAA+B,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+import Link from "../link.js";
+/** `synteq app link [app]` — `synteq link` under the app topic, with the
+ *  slug as a positional so it reads like `function link <name>`. */
+export default class AppLink extends Link {
+    static description: string;
+    static apiKeyScope: string;
+    static examples: string[];
+    static args: {
+        app: 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>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        remove: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "no-interactive": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static baseFlags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        insecure: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/link.js

@@ -0,0 +1,31 @@
+import { Args } from "@oclif/core";
+import Link from "../link.js";
+/** `synteq app link [app]` — `synteq link` under the app topic, with the
+ *  slug as a positional so it reads like `function link <name>`. */
+export default class AppLink extends Link {
+    static description = [
+        "Link the current directory to an app: name one by slug or id, or pick one on a TTY.",
+        "Same as `synteq link`; a linked directory deploys with a bare `synteq deploy`.",
+    ].join("\n");
+    static apiKeyScope = "none";
+    static examples = [
+        "<%= config.bin %> app link                  # interactive: pick a team, project and app (or create one)",
+        "<%= config.bin %> app link my-api           # straight to an existing app by slug",
+        "<%= config.bin %> app link 01931234-...     # or by id",
+        "<%= config.bin %> app link my-api --project 01931234-... -o json",
+    ];
+    static args = {
+        app: Args.string({
+            description: "App slug (or uuid) to link to. Omit on a TTY for the interactive walkthrough.",
+        }),
+    };
+    static flags = Link.flags;
+    static baseFlags = Link.baseFlags;
+    async run() {
+        const { args, flags } = await this.parse(AppLink);
+        if (args.app && !flags.app)
+            this.argv.push("--app", args.app);
+        await super.run();
+    }
+}
+//# sourceMappingURL=link.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../src/commands/app/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,IAAI,MAAM,YAAY,CAAC;AAE9B;oEACoE;AACpE,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,IAAI;IACvC,MAAM,CAAC,WAAW,GAAG;QACnB,qFAAqF;QACrF,gFAAgF;KACjF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,QAAQ,GAAG;QAChB,yGAAyG;QACzG,mFAAmF;QACnF,wDAAwD;QACxD,kEAAkE;KACnE,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,+EAA+E;SAC7F,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAElC,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC"}

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

@@ -0,0 +1,25 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq app logs` — bounded log history for a time window, or with
+ *  `--follow` the live container tail. Backend: GET
+ *  /apps/{id}/logs/history?since=|from=&until=, or the log WS. */
+export default class AppLogs extends BaseCommand {
+    static apiKeyScope: string;
+    /** `synteq logs` lived at the root until 2026-10-06; kept as a hidden alias. */
+    static hiddenAliases: 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>;
+        follow: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        since: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        until: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        container: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/logs.js

@@ -0,0 +1,121 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../base/command.js";
+import { buildLogWsUrl, streamLogs } from "../../apps-support/log-stream.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { dim } from "../../ui/glyphs.js";
+import { parseTimeframe, fmtClock } from "../../apps-support/time.js";
+const SINCE = ["15m", "1h", "6h", "24h", "72h", "168h", "336h", "720h", "4320h"];
+/** `synteq app logs` — bounded log history for a time window, or with
+ *  `--follow` the live container tail. Backend: GET
+ *  /apps/{id}/logs/history?since=|from=&until=, or the log WS. */
+export default class AppLogs extends BaseCommand {
+    static apiKeyScope = "none";
+    /** `synteq logs` lived at the root until 2026-10-06; kept as a hidden alias. */
+    static hiddenAliases = ["logs"];
+    static description = [
+        "Query an app's log history over a time window, or tail its live container logs with --follow.",
+        "",
+        "`--follow` / `-f` opens a WebSocket to the app's log proxy (single-use",
+        "ws-ticket) and streams until Ctrl-C. Without it the history route answers:",
+        "Pick the window either relatively (`--since 6h`) or as an absolute timeframe:",
+        "`--from` / `--until` take an ISO-8601 instant (2026-09-12T16:00:00Z, a date",
+        "alone is midnight UTC) or an age (90m, 2h, 3d = that long ago). `--from`",
+        "replaces `--since`; `--until` defaults to now. Timestamps print in your",
+        "local zone; pass `-o json` for the raw ISO instants.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> app logs --since 1h                    # bare: linked app",
+        "<%= config.bin %> app logs my-api -f                      # live tail (Ctrl-C to stop)",
+        "<%= config.bin %> app logs my-api --follow > app.log      # redirect the stream",
+        "<%= config.bin %> app logs --app my-api --since 24h --search error",
+        "<%= config.bin %> app logs --app my-api --from 2026-09-12T16:00:00Z --until 2026-09-12T16:30:00Z",
+        "<%= config.bin %> app logs --app my-api --from 3h --until 2h      # the hour that ended two hours ago",
+        "<%= config.bin %> app logs --app my-api --since 6h --limit 2000 -o json",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        follow: Flags.boolean({
+            char: "f",
+            description: "Tail the live container logs until Ctrl-C instead of querying history.",
+            exclusive: ["since", "from", "until", "search", "container", "limit"],
+        }),
+        since: Flags.string({
+            options: SINCE,
+            default: "1h",
+            description: `Relative window (one of ${SINCE.join(", ")}; default 1h). Ignored when --from is given.`,
+        }),
+        from: Flags.string({
+            description: "Start of an absolute timeframe: ISO-8601 instant or an age like 2h / 3d. Replaces --since.",
+        }),
+        until: Flags.string({
+            description: "End of the timeframe: ISO-8601 instant or an age like 30m (default: now).",
+        }),
+        search: Flags.string({ description: "Substring filter over log lines (case-insensitive)." }),
+        container: Flags.string({ description: "Restrict to one container/pod." }),
+        limit: Flags.integer({
+            default: 500,
+            description: "Maximum lines to return, newest wins (1..5000; default 500).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(AppLogs);
+        try {
+            if (flags.follow) {
+                const app = await this.resolveLinkedApp(flags, args.target);
+                const { ticket } = await this.clients.api.auth.wsTicket();
+                await streamLogs({
+                    url: buildLogWsUrl(this.clients.config.get().api_base_url, app.id, ticket, true),
+                    slug: app.slug,
+                    follow: true,
+                    log: (l) => this.log(l),
+                    unsupported: () => this.error("This Node build has no global WebSocket (need Node 20+). Upgrade Node to stream logs.", { exit: 3 }),
+                });
+                return;
+            }
+            let timeframe;
+            try {
+                timeframe = parseTimeframe(flags.from, flags.until);
+            }
+            catch (e) {
+                this.error(e instanceof Error ? e.message : String(e), { exit: 1 });
+            }
+            if (flags.limit < 1 || flags.limit > 5000)
+                this.error("--limit must be 1..5000.", { exit: 1 });
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const windowLabel = timeframe.from
+                ? `${timeframe.from} → ${timeframe.until ?? "now"}`
+                : flags.since;
+            const res = await withSpinner(`Fetching logs (${windowLabel})`, () => this.clients.api.apps.logHistory(app.id, {
+                since: flags.since,
+                from: timeframe.from,
+                until: timeframe.until,
+                container: flags.container,
+                limit: flags.limit,
+            }));
+            // The history route has no server-side text search; filter here so
+            // `--search` means the same thing on every portal version.
+            const needle = flags.search?.toLowerCase();
+            const all = res.lines ?? res.entries ?? [];
+            const lines = needle ? all.filter((l) => (l.message ?? "").toLowerCase().includes(needle)) : all;
+            this.emit(needle ? { ...res, lines } : res, () => {
+                if (lines.length === 0) {
+                    this.log(dim(timeframe.from ? `No log lines in ${windowLabel}.` : `No log lines in the last ${flags.since}.`));
+                    return;
+                }
+                for (const l of lines) {
+                    const ts = l.ts ? dim(`${fmtClock(l.ts)} `) : "";
+                    const ctr = l.container && l.container !== "app" ? dim(`[${l.container}] `) : "";
+                    const build = l.build ? dim(`${l.build} `) : "";
+                    this.log(`${ts}${build}${ctr}${l.message ?? ""}`);
+                }
+                this.log(dim(`${lines.length} line${lines.length === 1 ? "" : "s"} · ${windowLabel}`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=logs.js.map

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

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

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

@@ -0,0 +1,21 @@
+import { BaseCommand } from "../../base/command.js";
+import type { AppUsage } from "../../api/types.js";
+/** `synteq app metrics` — CPU / memory / network usage against the plan
+ *  envelope, live plus the window's series. Backend: GET /apps/{id}/usage. */
+export default class AppMetrics 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>;
+        range: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        until: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+/** Table rows: one per axis with a value, formatted in that axis's unit. */
+export declare function summarize(usage: AppUsage): string[][];

package/dist/commands/app/metrics.js

@@ -0,0 +1,123 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../base/command.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { dim } from "../../ui/glyphs.js";
+import { renderTable } from "../../ui/table.js";
+import { parseTimeframe } from "../../apps-support/time.js";
+const RANGES = ["15m", "1h", "6h", "24h", "72h", "168h"];
+/** `synteq app metrics` — CPU / memory / network usage against the plan
+ *  envelope, live plus the window's series. Backend: GET /apps/{id}/usage. */
+export default class AppMetrics extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Show an app's resource usage: live CPU, memory and network against its plan, plus the window's peak and average.",
+        "",
+        "`--range` picks a relative window; `--from` / `--until` (ISO instants or ages",
+        "like 2h / 3d, given together) pick an explicit one. `-o json` returns the",
+        "raw series for plotting.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> app metrics                            # bare: linked app, last hour",
+        "<%= config.bin %> app metrics --app my-api --range 24h",
+        "<%= config.bin %> app metrics --app my-api --from 2026-09-12T00:00:00Z --until 2026-09-12T12:00:00Z",
+        "<%= config.bin %> app metrics --app my-api --range 6h -o json",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        range: Flags.string({
+            options: RANGES,
+            default: "1h",
+            description: `Relative window (one of ${RANGES.join(", ")}; default 1h). Ignored when --from is given.`,
+        }),
+        from: Flags.string({ description: "Start of an explicit window (ISO-8601 or an age like 6h). Requires --until." }),
+        until: Flags.string({ description: "End of the explicit window (ISO-8601 or an age like 1h). Requires --from." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(AppMetrics);
+        try {
+            if ((flags.from === undefined) !== (flags.until === undefined)) {
+                this.error("--from and --until must be given together.", { exit: 1 });
+            }
+            let timeframe;
+            try {
+                timeframe = parseTimeframe(flags.from, flags.until);
+            }
+            catch (e) {
+                this.error(e instanceof Error ? e.message : String(e), { exit: 1 });
+            }
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const usage = await withSpinner("Fetching usage", () => this.clients.api.apps.usage(app.id, {
+                range: flags.range,
+                since: timeframe.from,
+                until: timeframe.until,
+            }));
+            this.emit(usage, () => {
+                const rows = summarize(usage);
+                if (rows.length === 0) {
+                    this.log(dim(`No usage recorded for ${app.slug} in this window.`));
+                    return;
+                }
+                this.log(renderTable(["Axis", "Now", "Peak", "Average", "Plan"], rows));
+                const env = usage.envelope;
+                if (env?.bandwidthGbMonth != null || env?.bandwidthUsedGb != null) {
+                    const used = env.bandwidthUsedGb ?? 0;
+                    const cap = env.bandwidthGbMonth;
+                    this.log(dim(`Bandwidth this period: ${used.toFixed(2)} GB${cap != null ? ` of ${cap} GB` : " (unmetered)"}`));
+                }
+                this.log(dim(usage.current ? "Now = live from the orchestrator." : "Now = latest snapshot (orchestrator unreachable)."));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+/** Table rows: one per axis with a value, formatted in that axis's unit. */
+export function summarize(usage) {
+    const env = usage.envelope;
+    const axes = [
+        { key: "cpu", label: "CPU", fmt: (v) => `${(v / 1000).toFixed(2)} cores`, plan: env ? `${(env.cpuMillicores / 1000).toFixed(2)} cores` : undefined },
+        { key: "memory", label: "Memory", fmt: (v) => `${Math.round(v / (1024 * 1024))} MB`, plan: env ? `${env.memoryMib} MB` : undefined },
+        { key: "networkRx", label: "Net in", fmt: (v) => `${fmtRate(v)}` },
+        { key: "networkTx", label: "Net out", fmt: (v) => `${fmtRate(v)}` },
+    ];
+    const out = [];
+    for (const axis of axes) {
+        const live = usage.current?.[axis.key];
+        const points = collectPoints(usage, axis.key, live);
+        if (!live && points.length === 0)
+            continue;
+        const peak = points.length ? Math.max(...points) : null;
+        const avg = points.length ? points.reduce((a, b) => a + b, 0) / points.length : null;
+        out.push([
+            axis.label,
+            live ? axis.fmt(live.current) : "—",
+            peak !== null ? axis.fmt(peak) : "—",
+            avg !== null ? axis.fmt(avg) : "—",
+            axis.plan ?? "—",
+        ]);
+    }
+    return out;
+}
+function collectPoints(usage, key, live) {
+    const fromLive = live?.series?.map((p) => p.value) ?? [];
+    if (fromLive.length)
+        return fromLive;
+    const fromSnapshots = [];
+    for (const s of usage.series ?? []) {
+        const axis = s.payload?.[key];
+        if (axis && typeof axis.current === "number")
+            fromSnapshots.push(axis.current);
+    }
+    return fromSnapshots;
+}
+function fmtRate(bytesPerSec) {
+    if (bytesPerSec < 1024)
+        return `${bytesPerSec.toFixed(0)} B/s`;
+    if (bytesPerSec < 1024 * 1024)
+        return `${(bytesPerSec / 1024).toFixed(1)} KB/s`;
+    return `${(bytesPerSec / (1024 * 1024)).toFixed(2)} MB/s`;
+}
+//# sourceMappingURL=metrics.js.map

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

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

package/dist/commands/app/plan/change.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app plan change <tier>` — move an app to another plan (previews the
+ *  proration first, then confirms). */
+export default class PlanChange extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        tier: 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>;
+        at: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/plan/change.js

@@ -0,0 +1,79 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel, isInteractive, confirmAction } from "../../../ui/wizard.js";
+import { ok, dim, yellow } from "../../../ui/glyphs.js";
+/** `synteq app plan change <tier>` — move an app to another plan (previews the
+ *  proration first, then confirms). */
+export default class PlanChange extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Change an app's plan; previews the prorated charge and downgrade warnings before applying.";
+    static examples = [
+        "<%= config.bin %> app plan change pro                       # upgrade linked app",
+        "<%= config.bin %> app plan change hobby --app my-api --at cycle_end",
+        "<%= config.bin %> app plan change pro --app my-api --yes -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "App slug or id (optional; default: the directory's linked app or --app)." }),
+        tier: Args.string({ required: false, description: "Target plan tier (free | hobby | starter | pro)." }),
+    };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        at: Flags.string({
+            options: ["now", "cycle_end"],
+            default: "now",
+            description: "When to apply the change (now: prorated immediately; cycle_end: at the next renewal). Default now.",
+        }),
+        yes: Flags.boolean({ char: "y", description: "Skip the confirmation prompt." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(PlanChange);
+        const [target, tier] = this.positional(args.target, args.tier, "tier");
+        try {
+            const app = await this.resolveLinkedApp(flags, target);
+            const preview = await withSpinner("Previewing change", () => this.clients.api.apps.planPreview(app.id, tier, flags.at));
+            const interactive = isInteractive() && this.outputFormat === "table";
+            if (interactive || !flags.yes) {
+                this.log(panel(`Change ${app.slug} → ${tier}`, [
+                    ["Action", preview.action],
+                    ["Prorated now", `$${preview.proratedCharge}`],
+                    ["Tax", `$${preview.tax}`],
+                    ["New monthly", `$${preview.newMonthly}`],
+                ]));
+                if (preview.belowUsage) {
+                    this.log(yellow(`\n⚠ This plan is below recent p95 usage` +
+                        `${preview.p95Cpu != null ? ` (cpu ${preview.p95Cpu})` : ""}` +
+                        `${preview.p95Mem != null ? ` (mem ${preview.p95Mem})` : ""}` +
+                        ` — the app may be throttled or restarted.`));
+                }
+            }
+            if (!flags.yes) {
+                if (!interactive) {
+                    this.error("Refusing to change plan without --yes in non-interactive mode.", { exit: 1 });
+                }
+                const go = await confirmAction(`Apply this plan change?`, false);
+                if (!go) {
+                    this.log("Aborted.");
+                    return;
+                }
+            }
+            const result = await withSpinner("Changing plan", () => this.clients.api.apps.changePlan(app.id, { planTier: tier, schedule: flags.at }));
+            this.emit(result, () => {
+                if (result.pendingPlanTier) {
+                    this.log(ok(`Scheduled: ${app.slug} → ${result.pendingPlanTier} at ${result.pendingPlanTierAt ?? "next renewal"}.`));
+                }
+                else {
+                    this.log(ok(`${app.slug} is now on ${result.planTier} ($${result.newMonthly}/mo).`));
+                    if (result.proratedCharge && result.proratedCharge !== "0.00") {
+                        this.log(dim(`Charged $${result.proratedCharge} (+ $${result.tax} tax) prorated now.`));
+                    }
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=change.js.map

package/dist/commands/app/plan/change.js.map

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

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

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app plan show` — the app's current plan + the plans it can move to. */
+export default class PlanShow 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/plan/show.js

@@ -0,0 +1,40 @@
+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 plan show` — the app's current plan + the plans it can move to. */
+export default class PlanShow extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Show an app's current plan and the plans available to switch to.";
+    static examples = [
+        "<%= config.bin %> app plan show                # bare: linked app",
+        "<%= config.bin %> app plan 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(PlanShow);
+        try {
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const [detail, plans] = await withSpinner("Loading plan", () => Promise.all([this.clients.api.apps.get(app.id), this.clients.api.apps.plans()]));
+            this.emit({ current: detail.planTier, plans }, () => {
+                this.log(panel(app.slug, [["Current plan", detail.planTier ?? dim("—")]]));
+                this.log(dim("\nAvailable plans:"));
+                for (const p of plans) {
+                    const mark = p.name === detail.planTier ? "•" : " ";
+                    const price = p.isFree ? "free" : `$${p.monthlyAnchorUsd ?? "?"}/mo`;
+                    this.log(`  ${mark} ${p.name.padEnd(10)} ${(p.displayName ?? "").padEnd(18)} ${dim(price)}`);
+                }
+                this.log(dim("\nChange with: synteq app plan change <tier> --app " + app.slug));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=show.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../../src/commands/app/plan/show.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,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,kFAAkF;AAClF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,kEAAkE,CAAC;IACxF,MAAM,CAAC,QAAQ,GAAG;QAChB,mEAAmE;QACnE,sDAAsD;KACvD,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,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,CAC7D,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAChF,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE;gBAClD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;gBACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;oBACpD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,IAAI,GAAG,KAAK,CAAC;oBACrE,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC/F,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,qDAAqD,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC"}