@specific.dev/cli 0.1.132 → 0.1.134

package/dist/cli.js

@@ -367797,6 +367797,27 @@ var ApiClient = class {
     }
     return response.json();
   }
+  async runObservabilityQuery(environmentId, sql) {
+    const url = `${this.baseUrl}/environments/${environmentId}/observability/query`;
+    writeLog("api", `POST ${url}`);
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...await this.authHeaders()
+      },
+      body: JSON.stringify({ sql })
+    });
+    writeLog("api", `Response: ${response.status} ${response.statusText}`);
+    if (!response.ok) {
+      throw await readApiError(
+        response,
+        "Query failed",
+        `POST ${url}`
+      );
+    }
+    return response.json();
+  }
 };
 var SpecificClient = class {
   client;
@@ -367856,6 +367877,10 @@ var SpecificClient = class {
   async deletePreviewEnvironment(environmentId) {
     return this.client.deletePreviewEnvironment(environmentId);
   }
+  // --- Observability ---
+  async runObservabilityQuery(environmentId, sql) {
+    return this.client.runObservabilityQuery(environmentId, sql);
+  }
 };
 function toDeployment(response) {
   return {
@@ -373693,7 +373718,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.132",
+      cli_version: "0.1.134",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -377799,7 +377824,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.132";
+  const currentVersion = "0.1.134";
   const response = await fetch(`${BINARIES_BASE_URL}/latest?t=${Date.now()}`);
   if (!response.ok) {
     throw new Error(`Failed to check for updates: HTTP ${response.status}`);
@@ -378066,54 +378091,255 @@ async function projectListCommand() {
 }
 
 // src/commands/status.tsx
-async function statusCommand() {
+import React12, { useState as useState11, useEffect as useEffect11 } from "react";
+import { render as render10, Text as Text12, Box as Box11 } from "ink";
+import Spinner7 from "ink-spinner";
+function statusColor(s) {
+  switch (s) {
+    case "active":
+      return "green";
+    case "deploying":
+      return "yellow";
+    case "failed":
+      return "red";
+    case "none":
+      return "gray";
+  }
+}
+function StatusUI() {
+  const [state, setState] = useState11({ phase: "loading" });
+  useEffect11(() => {
+    (async () => {
+      try {
+        const projectId = readProjectId();
+        const token = await getValidAccessToken();
+        const client2 = new SpecificClient({ accessToken: token });
+        const status2 = await client2.getProjectStatus(projectId);
+        setState({ phase: "success", status: status2 });
+      } catch (err) {
+        setState({
+          phase: "error",
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    })();
+  }, []);
+  if (state.phase === "loading") {
+    return /* @__PURE__ */ React12.createElement(Box11, null, /* @__PURE__ */ React12.createElement(Text12, { color: "blue" }, /* @__PURE__ */ React12.createElement(Spinner7, { type: "dots" })), /* @__PURE__ */ React12.createElement(Text12, null, " Loading project status..."));
+  }
+  if (state.phase === "error") {
+    process.exitCode = 1;
+    return /* @__PURE__ */ React12.createElement(Text12, { color: "red" }, "Failed to get status: ", state.error);
+  }
+  const status = state.status;
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, status.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", status.id, ")")), status.environments.length === 0 ? /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "No environments found.") : status.environments.map((env2) => /* @__PURE__ */ React12.createElement(Box11, { key: env2.id, flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true, color: "cyan" }, env2.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.id, ")")), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Status: ", /* @__PURE__ */ React12.createElement(Text12, { color: statusColor(env2.status), bold: true }, env2.status)), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Active deployment:", " ", env2.activeDeployment ? /* @__PURE__ */ React12.createElement(React12.Fragment, null, /* @__PURE__ */ React12.createElement(Text12, { color: "green" }, env2.activeDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.activeDeployment.state, ")")) : /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "none")), env2.inProgressDeployment && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "In progress:", " ", /* @__PURE__ */ React12.createElement(Text12, { color: "yellow" }, env2.inProgressDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.inProgressDeployment.state, ")")), env2.publicUrls && Object.keys(env2.publicUrls).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Public URLs:"), Object.entries(env2.publicUrls).map(([serviceName, url]) => /* @__PURE__ */ React12.createElement(Text12, { key: serviceName }, "    - ", /* @__PURE__ */ React12.createElement(Text12, { color: "cyan" }, serviceName), ": ", /* @__PURE__ */ React12.createElement(Text12, { color: "blue" }, url)))))));
+}
+function statusCommand() {
+  render10(/* @__PURE__ */ React12.createElement(StatusUI, null));
+}
+
+// src/lib/query/render-table.ts
+var MAX_COL_WIDTH = 60;
+var ANSI = {
+  dim: "\x1B[2m",
+  reset: "\x1B[0m"
+};
+function renderTable(input) {
+  const { columns, rows, stats } = input;
+  if (columns.length === 0) {
+    return "(no columns)\n";
+  }
+  const cellMatrix = rows.map(
+    (row) => columns.map((col, i) => formatCell(row[i], col.type))
+  );
+  const widths = columns.map((col, i) => {
+    const headerWidth = visibleLength(col.name);
+    const typeWidth = visibleLength(col.type);
+    let max = Math.max(headerWidth, typeWidth);
+    for (const row of cellMatrix) {
+      const w = visibleLength(row[i]);
+      if (w > max) max = w;
+    }
+    return Math.min(max, MAX_COL_WIDTH);
+  });
+  const aligns = columns.map(
+    (col) => isNumericType(col.type) ? "right" : "left"
+  );
+  const out = [];
+  out.push(borderLine(widths, "top"));
+  out.push(headerRow(columns.map((c) => c.name), widths, aligns));
+  out.push(headerRow(
+    columns.map((c) => c.type),
+    widths,
+    aligns,
+    /*dim*/
+    true
+  ));
+  out.push(borderLine(widths, "mid"));
+  for (const row of cellMatrix) {
+    out.push(dataRow(row, widths, aligns));
+  }
+  out.push(borderLine(widths, "bottom"));
+  out.push(statsLine(stats, rows.length));
+  return out.join("\n") + "\n";
+}
+function formatCell(value, type) {
+  if (value === null || value === void 0) {
+    return `${ANSI.dim}NULL${ANSI.reset}`;
+  }
+  if (type.startsWith("Map(") && typeof value === "object") {
+    return JSON.stringify(value);
+  }
+  if (type.startsWith("Array(") && Array.isArray(value)) {
+    return JSON.stringify(value);
+  }
+  if (typeof value === "number") {
+    return formatNumber(value);
+  }
+  if (typeof value === "string") {
+    if (type.startsWith("DateTime") && /^\d{4}-\d{2}-\d{2} /.test(value)) {
+      return value.replace(" ", "T") + "Z";
+    }
+    return value;
+  }
+  return String(value);
+}
+function formatNumber(n) {
+  if (Number.isInteger(n)) {
+    return n.toLocaleString("en-US");
+  }
+  return n.toString();
+}
+function isNumericType(type) {
+  const inner = unwrapType(type);
+  return /^(U?Int|Float|Decimal)/.test(inner);
+}
+function unwrapType(type) {
+  const m = type.match(/^(?:Nullable|LowCardinality)\((.+)\)$/);
+  return m ? unwrapType(m[1]) : type;
+}
+function visibleLength(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+function pad(s, width, align) {
+  const visible = visibleLength(s);
+  if (visible > width) {
+    return truncate(s, width);
+  }
+  const padding = " ".repeat(width - visible);
+  return align === "right" ? padding + s : s + padding;
+}
+function truncate(s, width) {
+  if (width <= 1) return "\u2026";
+  return s.slice(0, width - 1) + "\u2026";
+}
+function borderLine(widths, pos) {
+  const left = pos === "top" ? "\u250C" : pos === "mid" ? "\u251C" : "\u2514";
+  const sep2 = pos === "top" ? "\u252C" : pos === "mid" ? "\u253C" : "\u2534";
+  const right = pos === "top" ? "\u2510" : pos === "mid" ? "\u2524" : "\u2518";
+  return left + widths.map((w) => "\u2500".repeat(w + 2)).join(sep2) + right;
+}
+function headerRow(values, widths, aligns, dim = false) {
+  const cells = values.map((v, i) => {
+    const padded = pad(v, widths[i], aligns[i]);
+    return dim ? `${ANSI.dim}${padded}${ANSI.reset}` : padded;
+  });
+  return "\u2502 " + cells.join(" \u2502 ") + " \u2502";
+}
+function dataRow(row, widths, aligns) {
+  const cells = row.map((v, i) => pad(v, widths[i], aligns[i]));
+  return "\u2502 " + cells.join(" \u2502 ") + " \u2502";
+}
+function statsLine(stats, returned) {
+  const parts = [`${returned.toLocaleString("en-US")} rows`];
+  if (stats.elapsed !== void 0) {
+    parts.push(`${formatElapsed(stats.elapsed)}`);
+  }
+  if (stats.rows_read !== void 0) {
+    parts.push(`${stats.rows_read.toLocaleString("en-US")} rows scanned`);
+  }
+  return `${ANSI.dim}${parts.join(" \xB7 ")}${ANSI.reset}`;
+}
+function formatElapsed(seconds) {
+  const ms = seconds * 1e3;
+  if (ms < 1e3) return `${ms.toFixed(0)}ms`;
+  return `${seconds.toFixed(2)}s`;
+}
+
+// src/commands/query.tsx
+async function queryCommand(sqlArg, options2) {
   try {
+    const sql = await resolveSql(sqlArg);
     const projectId = readProjectId();
     const token = await getValidAccessToken();
     const client2 = new SpecificClient({ accessToken: token });
-    const status = await client2.getProjectStatus(projectId);
-    console.log(`${status.name} (${status.id})`);
-    if (status.environments.length === 0) {
-      console.log("");
-      console.log("No environments found.");
-      return;
+    const environmentId = await resolveEnvironment(client2, projectId, options2.env);
+    const result = await client2.runObservabilityQuery(environmentId, sql);
+    process.stdout.write(renderTable(result));
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error occurred";
+    const friendly = friendlyErrorMessage(message);
+    console.error(`Error: ${friendly}`);
+    process.exit(1);
+  }
+}
+async function resolveSql(arg) {
+  if (arg && arg !== "-") return arg;
+  if (process.stdin.isTTY) {
+    throw new Error("Provide SQL as an argument or via stdin.");
+  }
+  return await readStdin();
+}
+async function readStdin() {
+  return new Promise((resolve9, reject) => {
+    let data = "";
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (chunk) => data += chunk);
+    process.stdin.on("end", () => resolve9(data.trim()));
+    process.stdin.on("error", reject);
+  });
+}
+async function resolveEnvironment(client2, projectId, envFlag) {
+  const status = await client2.getProjectStatus(projectId);
+  const environments = status.environments;
+  if (envFlag) {
+    const match = environments.find((e) => e.name === envFlag);
+    if (!match) {
+      const available = environments.map((e) => e.name).join(", ") || "(none)";
+      throw new Error(
+        `Environment "${envFlag}" not found. Available: ${available}`
+      );
     }
-    for (const env2 of status.environments) {
-      console.log("");
-      console.log(`Environment: ${env2.name} (${env2.id})`);
-      console.log(`  Status: ${env2.status}`);
-      if (env2.activeDeployment) {
-        console.log(
-          `  Active deployment: ${env2.activeDeployment.id} (${env2.activeDeployment.state})`
-        );
-      } else {
-        console.log(`  Active deployment: none`);
-      }
-      if (env2.inProgressDeployments.length > 0) {
-        console.log(`  In progress:`);
-        for (const d of env2.inProgressDeployments) {
-          console.log(`    - ${d.id} (${d.state})`);
-        }
-      }
-      if (env2.publicUrls && Object.keys(env2.publicUrls).length > 0) {
-        console.log(`  Public URLs:`);
-        for (const [serviceName, url] of Object.entries(env2.publicUrls)) {
-          console.log(`    - ${serviceName}: ${url}`);
-        }
-      }
+    return match.id;
+  }
+  if (hasEnvironmentId()) {
+    const savedId = readEnvironmentId();
+    if (environments.some((e) => e.id === savedId)) {
+      return savedId;
     }
-  } catch (error) {
-    const message = error instanceof Error ? error.message : "Unknown error occurred";
-    console.error(`Failed to get status: ${message}`);
-    process.exit(1);
   }
+  if (environments.length === 1) {
+    return environments[0].id;
+  }
+  if (environments.length === 0) {
+    throw new Error("This project has no environments yet.");
+  }
+  const names = environments.map((e) => e.name).join(", ");
+  throw new Error(
+    `Project has multiple environments (${names}). Pass --env <name>.`
+  );
+}
+function friendlyErrorMessage(raw) {
+  const m = raw.match(/^Query failed: (.+?) \([A-Z_]+\)$/);
+  if (m) return m[1];
+  return raw;
 }
 
 // src/cli-program.tsx
 var program = new Command();
 var env = "production";
 var envLabel = env !== "production" ? `[${env.toUpperCase()}] ` : "";
-program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.132").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.134").enablePositionalOptions();
 program.command("init").description("Initialize project for use with a coding agent").option("--agent <name...>", "Agents to configure (cursor, claude, codex, other)").addHelpText("after", `
 Examples:
   $ specific init
@@ -378190,6 +378416,14 @@ Examples:
 program.command("status").description("Show project, environments, and deployment status").addHelpText("after", `
 Examples:
   $ specific status`).action(statusCommand);
+program.command("query [sql]").description("Run a SQL query against your environment's observability data").option("--env <name>", "Target environment (defaults to the current one)").addHelpText("after", `
+Examples:
+  $ specific query "SELECT count() FROM observability.logs"
+  $ specific query --env staging "SELECT * FROM observability.logs LIMIT 5"
+  $ cat queries/p99.sql | specific query
+  $ specific query - < queries/p99.sql`).action((sql, options2) => {
+  queryCommand(sql, options2);
+});
 program.command("beta").description("Manage beta feature flags").action(betaCommand);
 program.command("update").description("Update Specific CLI to the latest version").action(updateCommand);
 program.command("login").description("Log in to Specific").option("--device-code <code>", "Complete login using a device code from a previous non-interactive login").action((options2) => loginCommand(options2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/cli",
-  "version": "0.1.132",
+  "version": "0.1.134",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",