@solcreek/cli 0.4.18 → 0.4.20

package/dist/commands/deploy.js

@@ -8,7 +8,7 @@ import { CreekClient, CreekAuthError, detectFramework, resolveConfig, formatDete
 import { buildDoctorContext } from "../utils/doctor-context.js";
 import { getToken, getApiUrl } from "../utils/config.js";
 import { collectAssets } from "../utils/bundle.js";
-import { sandboxDeploy, pollSandboxStatus, printSandboxSuccess } from "../utils/sandbox.js";
+import { sandboxDeploy, pollSandboxStatus, printSandboxSuccess, expiresInMinutes } from "../utils/sandbox.js";
 import { prepareDeployBundle } from "../utils/prepare-bundle.js";
 import { BuildLogEmitter } from "../utils/build-log.js";
 import { isTTY, jsonOutput, resolveJsonMode, globalArgs, shouldAutoConfirm, AUTH_BREADCRUMBS, NO_PROJECT_BREADCRUMBS } from "../utils/output.js";
@@ -648,6 +648,7 @@ async function deployDirectory(dir, jsonMode, tos) {
                 url: status.previewUrl,
                 deployDurationMs: status.deployDurationMs,
                 expiresAt: result.expiresAt,
+                expiresInMinutes: expiresInMinutes(result.expiresAt),
                 assetCount: fileList.length,
                 mode: "sandbox",
             }, 0, [
@@ -777,6 +778,7 @@ async function deploySandbox(cwd, skipBuild, jsonMode = false, resolved, tos) {
                 url: status.previewUrl,
                 deployDurationMs: status.deployDurationMs,
                 expiresAt: result.expiresAt,
+                expiresInMinutes: expiresInMinutes(result.expiresAt),
                 framework: framework ?? null,
                 assetCount: fileList.length,
                 mode: "sandbox",

package/dist/commands/metrics.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `creek metrics` — read project traffic + error aggregates from the
+ * control-plane metrics endpoint (Analytics Engine + zone GraphQL).
+ *
+ * Auth: requires `creek login`. Server enforces tenant isolation from
+ * the session — the CLI passes only the project slug.
+ *
+ * Output shape matches the Dashboard Analytics tab: total requests
+ * (including edge-cache hits), worker invocations, error count, and
+ * three breakdowns (HTTP method, scriptType, statusBucket). Live p50/
+ * p99 CPU times aren't exposed here yet; they live in the Workers
+ * GraphQL subset the Dashboard reads separately.
+ *
+ * Pair with `--json` to pipe into reports / dashboards.
+ */
+export declare const metricsCommand: import("citty").CommandDef<{
+    json: {
+        type: "boolean";
+        description: string;
+        default: boolean;
+    };
+    yes: {
+        type: "boolean";
+        description: string;
+        default: boolean;
+    };
+    project: {
+        type: "string";
+        description: string;
+    };
+    period: {
+        type: "string";
+        description: string;
+    };
+}>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/commands/metrics.js

@@ -0,0 +1,167 @@
+import { defineCommand } from "citty";
+import consola from "consola";
+import { CreekClient, resolveConfig, ConfigNotFoundError, } from "@solcreek/sdk";
+import { getToken, getApiUrl } from "../utils/config.js";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS, NO_PROJECT_BREADCRUMBS, } from "../utils/output.js";
+const VALID_PERIODS = ["1h", "6h", "24h", "7d", "30d"];
+/**
+ * `creek metrics` — read project traffic + error aggregates from the
+ * control-plane metrics endpoint (Analytics Engine + zone GraphQL).
+ *
+ * Auth: requires `creek login`. Server enforces tenant isolation from
+ * the session — the CLI passes only the project slug.
+ *
+ * Output shape matches the Dashboard Analytics tab: total requests
+ * (including edge-cache hits), worker invocations, error count, and
+ * three breakdowns (HTTP method, scriptType, statusBucket). Live p50/
+ * p99 CPU times aren't exposed here yet; they live in the Workers
+ * GraphQL subset the Dashboard reads separately.
+ *
+ * Pair with `--json` to pipe into reports / dashboards.
+ */
+export const metricsCommand = defineCommand({
+    meta: {
+        name: "metrics",
+        description: "Read request + error metrics for a project. One-shot query — pair with --json for agent use or `| jq` piping.",
+    },
+    args: {
+        project: {
+            type: "string",
+            description: "Project slug. Defaults to creek.toml in cwd.",
+        },
+        period: {
+            type: "string",
+            description: `Time window. One of: ${VALID_PERIODS.join(", ")}. Default: 24h`,
+        },
+        ...globalArgs,
+    },
+    async run({ args }) {
+        const jsonMode = resolveJsonMode(args);
+        const token = getToken();
+        if (!token) {
+            if (jsonMode)
+                jsonOutput({ ok: false, error: "not_authenticated" }, 1, AUTH_BREADCRUMBS);
+            consola.error("Not authenticated. Run `creek login` first.");
+            process.exit(1);
+        }
+        const projectSlug = await resolveProjectSlug(args.project, jsonMode);
+        const period = validatePeriod(args.period, jsonMode);
+        const client = new CreekClient(getApiUrl(), token);
+        let response;
+        try {
+            response = await client.getMetrics(projectSlug, period);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (jsonMode)
+                jsonOutput({ ok: false, error: "metrics_failed", message: msg }, 1, []);
+            consola.error(`Failed to read metrics: ${msg}`);
+            process.exit(1);
+        }
+        if (jsonMode) {
+            jsonOutput({ ok: true, project: projectSlug, ...response }, 0, [
+                {
+                    command: `creek logs --project ${projectSlug} --since ${period}`,
+                    description: "Tail logs for the same window",
+                },
+            ]);
+            return;
+        }
+        printHuman(projectSlug, response);
+    },
+});
+function validatePeriod(raw, jsonMode) {
+    if (!raw)
+        return "24h";
+    if (VALID_PERIODS.includes(raw))
+        return raw;
+    const message = `Invalid --period: ${raw}. Valid: ${VALID_PERIODS.join(", ")}`;
+    if (jsonMode)
+        jsonOutput({ ok: false, error: "invalid_period", message }, 1, []);
+    consola.error(message);
+    process.exit(1);
+}
+async function resolveProjectSlug(override, jsonMode) {
+    if (override)
+        return override;
+    let resolved;
+    try {
+        resolved = resolveConfig(process.cwd());
+    }
+    catch (err) {
+        if (err instanceof ConfigNotFoundError) {
+            if (jsonMode)
+                jsonOutput({ ok: false, error: "no_project", message: "No project config in cwd" }, 1, NO_PROJECT_BREADCRUMBS);
+            consola.error("No project config in cwd. Pass --project <slug>.");
+            process.exit(1);
+        }
+        throw err;
+    }
+    return resolved.projectName;
+}
+// ─── Human output ────────────────────────────────────────────────────────
+const COLOR = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    green: "\x1b[32m",
+    cyan: "\x1b[36m",
+    gray: "\x1b[90m",
+};
+function tty() {
+    return process.stdout.isTTY ?? false;
+}
+function c(s, color) {
+    return tty() ? `${COLOR[color]}${s}${COLOR.reset}` : s;
+}
+function fmtNumber(n) {
+    if (n === 0)
+        return "0";
+    if (n < 1000)
+        return String(n);
+    if (n < 1_000_000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return `${(n / 1_000_000).toFixed(2)}M`;
+}
+function fmtPct(n, total) {
+    if (total === 0)
+        return "0%";
+    return `${((n / total) * 100).toFixed(1)}%`;
+}
+function printHuman(slug, r) {
+    const { totals } = r;
+    const cachePct = fmtPct(totals.cachedReqs, totals.reqs);
+    const errPct = fmtPct(totals.errs, totals.invocations);
+    consola.log("");
+    consola.log(`  ${c("⬡ creek metrics", "bold")}  ${c(`${slug} · ${r.period}`, "dim")}`);
+    consola.log("");
+    consola.log(`  Requests:      ${c(fmtNumber(totals.reqs), "bold")}`);
+    consola.log(`  Cache hits:    ${fmtNumber(totals.cachedReqs)} ${c(`(${cachePct})`, "dim")}`);
+    consola.log(`  Invocations:   ${fmtNumber(totals.invocations)} ${c("worker ran", "dim")}`);
+    const errColor = totals.errs > 0 ? "red" : "green";
+    consola.log(`  Errors:        ${c(fmtNumber(totals.errs), errColor)} ${c(`(${errPct} of invocations)`, "dim")}`);
+    consola.log("");
+    printBreakdown("Method", r.breakdowns.method);
+    printBreakdown("Script type", r.breakdowns.scriptType);
+    printBreakdown("Status bucket", r.breakdowns.statusBucket);
+}
+function printBreakdown(title, rows) {
+    if (rows.length === 0)
+        return;
+    consola.log(`  ${c(title, "dim")}`);
+    const total = rows.reduce((sum, r) => sum + r.reqs, 0);
+    const top = rows.slice(0, 5);
+    for (const row of top) {
+        const pct = fmtPct(row.reqs, total);
+        const label = row.label || c("(empty)", "gray");
+        const errBadge = row.errs > 0 ? c(` ${row.errs} err`, "red") : "";
+        consola.log(`    ${label.padEnd(12)} ${fmtNumber(row.reqs).padStart(8)} ${c(pct.padStart(6), "dim")}${errBadge}`);
+    }
+    if (rows.length > top.length) {
+        consola.log(`    ${c(`+${rows.length - top.length} more`, "dim")}`);
+    }
+    consola.log("");
+}
+//# sourceMappingURL=metrics.js.map

package/dist/index.js

@@ -19,6 +19,7 @@ import { rollbackCommand } from "./commands/rollback.js";
 import { opsCommand } from "./commands/ops.js";
 import { queueCommand } from "./commands/queue.js";
 import { logsCommand } from "./commands/logs.js";
+import { metricsCommand } from "./commands/metrics.js";
 import { doctorCommand } from "./commands/doctor.js";
 import { dbCommand } from "./commands/db.js";
 import { storageCommand } from "./commands/storage.js";
@@ -49,6 +50,7 @@ const main = defineCommand({
         projects: projectsCommand,
         deployments: deploymentsCommand,
         logs: logsCommand,
+        metrics: metricsCommand,
         doctor: doctorCommand,
         login: loginCommand,
         whoami: whoamiCommand,

package/dist/utils/sandbox.d.ts

@@ -60,6 +60,16 @@ export declare function sandboxDeploy(bundle: {
  * Poll sandbox status until terminal state.
  */
 export declare function pollSandboxStatus(statusUrl: string): Promise<SandboxStatusResponse>;
+/**
+ * Compute minutes-remaining until expiresAt (ISO string). Clamps at 0.
+ * Returned integer is ceiling, so a sandbox with 60:01 left reports 61.
+ */
+export declare function expiresInMinutes(expiresAt: string): number;
+/**
+ * Format expiresAt as a local-clock wall time ("HH:MM") for users who
+ * don't want to mentally parse ISO timestamps in UTC.
+ */
+export declare function expiresAtLocal(expiresAt: string): string;
 /**
  * Print sandbox success message with claim instructions.
  */

package/dist/utils/sandbox.js

@@ -57,13 +57,32 @@ export async function pollSandboxStatus(statusUrl) {
     }
     throw new Error("Sandbox deploy timed out");
 }
+/**
+ * Compute minutes-remaining until expiresAt (ISO string). Clamps at 0.
+ * Returned integer is ceiling, so a sandbox with 60:01 left reports 61.
+ */
+export function expiresInMinutes(expiresAt) {
+    const ms = new Date(expiresAt).getTime() - Date.now();
+    return Math.max(0, Math.ceil(ms / 60_000));
+}
+/**
+ * Format expiresAt as a local-clock wall time ("HH:MM") for users who
+ * don't want to mentally parse ISO timestamps in UTC.
+ */
+export function expiresAtLocal(expiresAt) {
+    const d = new Date(expiresAt);
+    const hh = d.getHours().toString().padStart(2, "0");
+    const mm = d.getMinutes().toString().padStart(2, "0");
+    return `${hh}:${mm}`;
+}
 /**
  * Print sandbox success message with claim instructions.
  */
 export function printSandboxSuccess(previewUrl, expiresAt, sandboxId) {
+    const mins = expiresInMinutes(expiresAt);
     consola.success(`  Live → ${previewUrl}`);
     consola.info("");
-    consola.info("  Free preview — available for 60 minutes.");
+    consola.info(`  Expires in ${mins} minutes (local ${expiresAtLocal(expiresAt)}).`);
     consola.info("  Make it permanent: creek login && creek claim " + sandboxId);
 }
 //# sourceMappingURL=sandbox.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solcreek/cli",
-  "version": "0.4.18",
+  "version": "0.4.20",
   "description": "CLI for the Creek deployment platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,7 +33,7 @@
     "esbuild": "^0.25.0",
     "smol-toml": "^1.3.1",
     "ws": "^8.20.0",
-    "@solcreek/sdk": "0.4.7"
+    "@solcreek/sdk": "0.4.9"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",