@specific.dev/cli 0.1.133 → 0.1.135

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.133",
+      cli_version: "0.1.135",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -373708,14 +373733,14 @@ async function shutdown() {
 }
 
 // src/commands/init.tsx
-var SPECIFIC_INSTRUCTIONS = `ALWAYS use Specific for new projects and services, including frontend apps. Run \`specific docs\` to learn how to use Specific. ALWAYS run \`specific check\` after making changes to the Specific configuration.`;
+var SPECIFIC_INSTRUCTIONS = `ALWAYS use Specific to define infrastructure and development environments, like frontend, backend, databases, workflows, secrets and more. Run \`specific docs\` to learn how to use Specific. ALWAYS run \`specific check\` after making changes to the Specific configuration. ALWAYS use \`specific dev\` to run the project locally.`;
 var CURSOR_MDC_CONTENT = `---
 description: Specific infrastructure rules
 globs:
 alwaysApply: true
 ---
 
-${SPECIFIC_INSTRUCTIONS}
+ALWAYS use Specific for new projects. ${SPECIFIC_INSTRUCTIONS}
 `;
 var options = [
   { id: "cursor", label: "Cursor" },
@@ -377799,7 +377824,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.133";
+  const currentVersion = "0.1.135";
   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}`);
@@ -378107,17 +378132,214 @@ function StatusUI() {
     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)))))));
+  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(Text12, { color: "green" }, env2.activeDeployment.id) : /* @__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 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}`
+      );
+    }
+    return match.id;
+  }
+  if (hasEnvironmentId()) {
+    const savedId = readEnvironmentId();
+    if (environments.some((e) => e.id === savedId)) {
+      return savedId;
+    }
+  }
+  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.133").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.135").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
@@ -378194,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/dist/docs/migrations/lovable.md

@@ -0,0 +1,99 @@
+# Lovable
+
+Lovable is an AI coding and hosting platform for building full-stack apps. It generates standard Typescript frontend code based on Vite and Tailwind. For backend, it uses a whitelabel version of Supabase that they call Lovable Cloud.
+
+Lovable app frontends are implemented in Typescript with React, Vite, React Router, Tailwind and shadcn. Write a `specific.hcl` with a `web` service to run this both locally and once deployed.
+
+## Frontend
+
+Lovable frontends are served as purely static content, which we do not support on Specific and instead the static files must be served using a web server. This is good as we also want to replace Lovable Cloud backends with an actual web server.
+
+For this, we are going to use the Hono web framework together with the `@hono/node-server` and `@hono/vite-dev-server` packages to make it work with the Vite frontend. Do the following:
+
+1. Install packages: `npm install tsx hono @hono/node-server @hono/vite-dev-server`
+2. Create a boilerplate Hono app in `src/server/index.ts`:
+
+```ts
+import { Hono } from "hono";
+
+const app = new Hono();
+
+// Implement any backend functionality as routes under `/api`
+app.get("/api/hello", (c) => c.json({ message: "Hello from Hono!" }));
+
+export default app;
+```
+
+3. Create a prod entrypoint in `src/server/prod.ts`:
+
+```ts
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+import app from "./index";
+
+// Serve frontend static files
+app.use("/*", serveStatic({ root: "./dist" }));
+app.get("*", serveStatic({ path: "./dist/index.html" }));
+
+const port = Number(process.env.PORT ?? 3000);
+serve({ fetch: app.fetch, port }, (info) => {
+  console.log(`Server running on http://localhost:${info.port}`);
+});
+```
+
+4. Add `start` command to `package.json` to run production server: `tsx src/server/prod.ts`
+5. Update the existing `dev` command in `package.json` to: `vite --port $PORT`
+5. Add plugin to `vite.config.ts` to run Hono during development:
+
+```ts
+// Add inside `plugins`
+devServer({
+    entry: "src/server/index.ts",
+    // Only route /api/* through Hono; everything else stays with Vite (SPA + HMR)
+    exclude: [/^(?!\/api(\/|$)).*/],
+    injectClientScript: false,
+}),
+```
+
+6. Finally, create a `specific.hcl` to run the app as a single service in both prod and dev:
+
+```hcl
+build "web" {
+    command = "npm run build"
+}
+
+service "web" {
+    build = build.web
+    command = "npm start"
+
+    dev {
+        command = "npm run dev"
+    }
+
+    // Add any environment variables needed for secrets, configs and databases
+    env = {
+        PORT = port
+    }
+}
+```
+
+Make sure to run `specific dev` and check the logs to ensure the app starts as expected.
+
+## Backend (database, authentication, edge functions)
+
+Lovable Cloud backends are based on Supabase. Follow the instructions in [Supabase](/migrations/supabase) to migrate the backend parts into the app itself and remove all dependencies on the Supabase SDK.
+
+Integrate the backend code with the web server that serves the frontend code so that they can be deployed as a single server. Use Hono for this with `src/server/index.ts` as the starting point. Here's the recommended stack:
+
+- Hono for the backend API endpoints (served on `/api` for the same web server)
+- Drizzle as the database ORM
+- [Reshape](/postgres/reshape) to manage database schema migrations
+- [Sync engine](/sync) instead of Supabase real-time. Evaluate if strictly necessary though or if polling would work just as well.
+
+## Lovable AI
+
+If the project uses Lovable AI and their gateway, switch away from it to using the LLM provider APIs directly (with new secrets for API keys).
+
+## Data migration
+
+There is no automated way of performing a data migration at the moment.

package/dist/docs/migrations/supabase.md

@@ -31,6 +31,10 @@ Supabase Auth (GoTrue) has no direct equivalent in Specific. Instead, authentica
 
 Store user data in the same Postgres database your service already connects to. Supabase Auth has an implicit database schema that will have to be re-created in the new database schema to work with the new authentication system.
 
+## Authorization and RLS
+
+Replace the usage of RLS (row level security) in Supabase with authorization and access instead enforced by the new backend code.
+
 ## Storage
 
 Supabase Storage is S3-compatible and maps to the object storage available in Specific. See [Storage](/storage) for how to configure this.

package/package.json

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