@specific.dev/cli 0.1.37

package/dist/commands/psql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psql.d.ts","sourceRoot":"","sources":["../../src/commands/psql.tsx"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,iBA4DtD"}

package/dist/commands/psql.js

@@ -0,0 +1,53 @@
+import { spawn } from "child_process";
+import { InstanceStateManager } from "../lib/dev/index.js";
+export async function psqlCommand(databaseName) {
+    const stateManager = new InstanceStateManager(process.cwd());
+    await stateManager.cleanStaleState();
+    const existingInstances = await stateManager.getExistingInstances();
+    if (!existingInstances) {
+        console.error("Error: No running instances found. Run `specific dev` first.");
+        process.exit(1);
+    }
+    const availableDatabases = Object.keys(existingInstances.databases);
+    if (availableDatabases.length === 0) {
+        console.error("Error: No databases found in running instances.");
+        process.exit(1);
+    }
+    let targetDb;
+    if (databaseName) {
+        if (!existingInstances.databases[databaseName]) {
+            console.error(`Error: Database "${databaseName}" not found. Available: ${availableDatabases.join(", ")}`);
+            process.exit(1);
+        }
+        targetDb = databaseName;
+    }
+    else {
+        if (availableDatabases.length > 1) {
+            console.error(`Error: Multiple databases available. Specify one: ${availableDatabases.join(", ")}`);
+            process.exit(1);
+        }
+        targetDb = availableDatabases[0];
+    }
+    const dbState = existingInstances.databases[targetDb];
+    const child = spawn("psql", ["-h", dbState.host, "-p", String(dbState.port), "-U", dbState.user, "-d", dbState.dbName], {
+        cwd: process.cwd(),
+        env: {
+            ...process.env,
+            PGPASSWORD: dbState.password,
+        },
+        stdio: "inherit",
+    });
+    child.on("exit", (code, signal) => {
+        if (signal) {
+            process.kill(process.pid, signal);
+        }
+        else {
+            process.exit(code ?? 0);
+        }
+    });
+    child.on("error", (err) => {
+        console.error(`Error: Failed to start psql: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=psql.js.map

package/dist/commands/psql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psql.js","sourceRoot":"","sources":["../../src/commands/psql.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,YAAqB;IACrD,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,MAAM,YAAY,CAAC,eAAe,EAAE,CAAC;IACrC,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,oBAAoB,EAAE,CAAC;IAEpE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEpE,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,QAAgB,CAAC;IAErB,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CACX,oBAAoB,YAAY,2BAA2B,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,QAAQ,GAAG,YAAY,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CACX,qDAAqD,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAE,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAE,CAAC;IAEvD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;QACtH,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,UAAU,EAAE,OAAO,CAAC,QAAQ;SAC7B;QACD,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/secrets.d.ts

@@ -0,0 +1,3 @@
+export declare function secretsSetCommand(secretName: string): Promise<void>;
+export declare function secretsCommand(action: string | undefined, secretName: string | undefined): Promise<void>;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/commands/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/commands/secrets.tsx"],"names":[],"mappings":"AAsHA,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,iBAQzD;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,iBAqB9F"}

package/dist/commands/secrets.js

@@ -0,0 +1,136 @@
+import React, { useState, useEffect } from "react";
+import { render, Text, Box, useInput, useApp } from "ink";
+import * as fs from "fs";
+import { SECRETS_FILE } from "../lib/secrets/index.js";
+const HEADER_COMMENT = "# Do not commit this file - it contains secrets\n";
+function SetSecretUI({ secretName }) {
+    const { exit } = useApp();
+    const [value, setValue] = useState("");
+    const [done, setDone] = useState(false);
+    const [error, setError] = useState(null);
+    useInput((input, key) => {
+        if (done)
+            return;
+        if (key.return) {
+            if (value.trim() === "") {
+                setError("Secret value cannot be empty");
+                return;
+            }
+            try {
+                // Escape quotes and backslashes in the value for HCL
+                const escapedValue = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+                const hclLine = `${secretName} = "${escapedValue}"`;
+                // Read existing file or start fresh
+                let content = "";
+                let hasHeader = false;
+                if (fs.existsSync(SECRETS_FILE)) {
+                    content = fs.readFileSync(SECRETS_FILE, "utf-8");
+                    hasHeader = content.startsWith("#");
+                    // Check if this secret already exists and update it
+                    const lines = content.split("\n");
+                    const newLines = [];
+                    let found = false;
+                    // Match: secretName = "..." or secretName="..."
+                    const pattern = new RegExp(`^${secretName}\\s*=\\s*"`);
+                    for (const line of lines) {
+                        if (pattern.test(line.trim())) {
+                            newLines.push(hclLine);
+                            found = true;
+                        }
+                        else {
+                            newLines.push(line);
+                        }
+                    }
+                    if (found) {
+                        fs.writeFileSync(SECRETS_FILE, newLines.join("\n"));
+                        setDone(true);
+                        return;
+                    }
+                }
+                // Append new secret
+                let newContent = "";
+                if (!hasHeader && !content) {
+                    newContent = HEADER_COMMENT + "\n";
+                }
+                else if (content) {
+                    newContent = content.endsWith("\n") ? content : content + "\n";
+                }
+                newContent += `${hclLine}\n`;
+                fs.writeFileSync(SECRETS_FILE, newContent);
+                setDone(true);
+            }
+            catch (err) {
+                setError(err instanceof Error ? err.message : String(err));
+            }
+        }
+        else if (key.backspace || key.delete) {
+            setValue((prev) => prev.slice(0, -1));
+        }
+        else if (key.escape) {
+            exit();
+        }
+        else if (!key.ctrl && !key.meta && input) {
+            setValue((prev) => prev + input);
+        }
+    });
+    useEffect(() => {
+        if (done) {
+            const timer = setTimeout(() => exit(), 50);
+            return () => clearTimeout(timer);
+        }
+    }, [done, exit]);
+    if (error) {
+        return React.createElement(Text, { color: "red" },
+            "Error: ",
+            error);
+    }
+    if (done) {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { color: "green" },
+                "Secret '",
+                secretName,
+                "' saved to ",
+                SECRETS_FILE)));
+    }
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, null,
+            "Enter value for secret '",
+            secretName,
+            "':"),
+        React.createElement(Box, null,
+            React.createElement(Text, { color: "cyan" }, "> "),
+            React.createElement(Text, null, value.length > 0 ? "*".repeat(value.length) : ""),
+            React.createElement(Text, { color: "gray" }, "|")),
+        React.createElement(Text, { dimColor: true }, "(Press Enter to save, Esc to cancel)")));
+}
+export async function secretsSetCommand(secretName) {
+    if (!secretName) {
+        console.error("Error: Secret name required");
+        console.error("Usage: specific secrets set <name>");
+        process.exit(1);
+    }
+    render(React.createElement(SetSecretUI, { secretName: secretName }));
+}
+export async function secretsCommand(action, secretName) {
+    if (!action) {
+        console.error("Usage: specific secrets <command>");
+        console.error("");
+        console.error("Commands:");
+        console.error("  set <name>    Set a secret value");
+        process.exit(1);
+    }
+    if (action === "set") {
+        if (!secretName) {
+            console.error("Error: Secret name required");
+            console.error("Usage: specific secrets set <name>");
+            process.exit(1);
+        }
+        await secretsSetCommand(secretName);
+    }
+    else {
+        console.error(`Unknown command: ${action}`);
+        console.error("Usage: specific secrets set <name>");
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=secrets.js.map

package/dist/commands/secrets.js.map

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

package/dist/docs/builds.md

@@ -0,0 +1,71 @@
+# Builds
+
+Builds define how to produce artifacts. Services reference builds.
+
+```hcl
+build "api" {
+  base = "node"
+  command = "npm run build"
+}
+```
+
+## Required fields
+
+- `base` - Base environment. Supported: `"node"`, `"python"`, `"go"`, `"rust"`, `"java"`.
+
+## Optional fields
+
+- `command` - Build command to run after dependencies are installed (e.g., `npm run build`, `go build -o api`).
+
+## Automatic dependency installation
+
+Specific automatically installs dependencies before running your build command. Dependencies are cached in a separate Docker layer for faster builds when only source code changes.
+
+| Base | Detected Files | Install Command |
+|------|----------------|-----------------|
+| `node` | `package-lock.json` | `npm ci` |
+| `node` | `yarn.lock` | `yarn install --frozen-lockfile` |
+| `node` | `pnpm-lock.yaml` | `pnpm install --frozen-lockfile` |
+| `node` | `package.json` only | `npm install` |
+| `python` | `requirements.txt` | `pip install -r requirements.txt` |
+| `python` | `Pipfile.lock` | `pipenv install --deploy --system` |
+| `python` | `poetry.lock` | `poetry install` |
+| `python` | `pyproject.toml` | `pip install .` |
+| `go` | `go.mod` | `go mod download` |
+
+For simple projects that only need dependencies installed, you can omit the `command` field:
+
+```hcl
+build "api" {
+  base = "node"
+}
+```
+
+## Base details
+
+For **node** and **python**, the entire working directory is available at runtime.
+
+For **go**, **rust**, and **java**, a multi-stage build is used:
+
+- **go**: The entire working directory is copied to the runtime image.
+- **rust**: Only `target/release` is copied to the working directory in the runtime image.
+- **java**: JAR files from `target/*.jar` or `build/libs/*.jar` are copied to `app.jar` in the working directory.
+
+## Dev configuration
+
+Override the build command for local development. If no `dev` block is defined, the build is skipped in development.
+
+```hcl
+build "spa" {
+  base = "node"
+  command = "npm run build"
+
+  dev {
+    command = "npm run build:watch"
+  }
+}
+```
+
+---
+
+Run `specific docs services` for service configuration.

package/dist/docs/index.md

@@ -0,0 +1,30 @@
+# Specific
+
+Infrastructure-as-code designed for coding agents. Define your infrastructure in `specific.hcl` alongside your application code. This will define how to build, deploy and run the full system in production, but also how to run it in development. Specific is fully generic and works with any programming language and framework without any SDKs. We use environments variables to pass information to the code.
+
+This documentation is nested and references to other docs are in Markdown link format. Run `specific docs [PATH]` to read a docs page.
+
+## Workflow
+
+1. Create or edit `specific.hcl` in the project root
+2. ALWAYS run `specific check` to validate configuration and fix any issues
+3. Run yourself or instruct the user to run `specific exec [SERVICE] --- [COMMAND]` for one-off commands that need to be run in development, like database migrations or seeding. The command will be run with databases and other services started and env vars injected.
+
+A full development environment can be started with `specific dev`. To deploy any changes, the user can run `specific deploy`.
+
+## Topics
+
+- [Services](/services): define how to build, deploy and run the code in this project as services, both in development and production.
+- [Secrets and configuration](/secrets-config): define secrets and configuration variables that the user may or should provide. These can be injected into services through environment variables.
+- [Postgres](/postgres): define managed PostgreSQL databases that services depend on.
+- [Sync](/sync): define real-time, partial synchronisation out of PostgreSQL into frontends or other services. Should be used to implement real-time and collaborative apps.
+- [Storage](/storage): define S3-compatible object/blob storage for services to store files in.
+- [Redis](/redis): define non-durable Redis-compatible databases for caching and more.
+
+## Common integrations
+
+The following is a list of common frameworks and libraries with guidance on how to use them with Specific:
+
+- [Next.js](/integrations/nextjs): full-stack React framework
+- [Drizzle ORM](/integrations/drizzle): TypeScript ORM with type safety
+- [Prisma](/integrations/prisma): TypeScript ORM with auto-generated client

package/dist/docs/integrations/drizzle.md

@@ -0,0 +1,83 @@
+# Drizzle ORM
+
+Drizzle is a TypeScript ORM with a focus on type safety and performance. This guide covers using Drizzle with Specific Postgres.
+
+## Configuration
+
+Pass the database URL to your service and always add a `pre_deploy` step to run database migrations.
+
+```hcl
+build "api" {
+  base = "node"
+  command = "npm run build"
+}
+
+postgres "main" {}
+
+service "api" {
+  build = build.api
+  command = "node dist/index.js"
+
+  endpoint {
+    public = true
+  }
+
+  env = {
+    PORT = port
+    DATABASE_URL = postgres.main.url
+  }
+
+  dev {
+    command = "npm run dev"
+  }
+
+  pre_deploy {
+    command = "npx drizzle-kit migrate"
+  }
+}
+```
+
+## Drizzle configuration
+
+Configure Drizzle to read the connection string from the environment in `drizzle.config.ts`:
+
+```typescript
+import { defineConfig } from "drizzle-kit";
+
+export default defineConfig({
+  schema: "./src/db/schema.ts",
+  out: "./drizzle",
+  dialect: "postgresql",
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});
+```
+
+## Development
+
+Use `specific exec` to push schema changes and generate migrations:
+
+```bash
+# Push schema directly to local database (for rapid iteration)
+specific exec api -- npx drizzle-kit push
+
+# If user is relying on Drizzle migrations, generate them once done with schema changes
+specific exec api -- npx drizzle-kit generate
+```
+
+## Database client
+
+Create your database client reading from the environment:
+
+```typescript
+import { drizzle } from "drizzle-orm/postgres-js";
+import postgres from "postgres";
+
+const client = postgres(process.env.DATABASE_URL!);
+export const db = drizzle(client);
+```
+
+## Drizzle studio
+
+Drizzle studio is not needed as `specific dev` includes a database viewer and editor in its admin interface.

package/dist/docs/integrations/nextjs.md

@@ -0,0 +1,45 @@
+# Next.js
+
+Next.js is a full-stack React framework. This guide covers running Next.js with Specific.
+
+## Configuration
+
+For smaller Docker images and faster cold starts, enable standalone output in `next.config.js`:
+
+```javascript
+module.exports = {
+  output: "standalone",
+};
+```
+
+Then reference the standalone output to run the server:
+
+```hcl
+build "web" {
+  base = "node"
+  command = "npm run build"
+}
+
+service "web" {
+  build = build.web
+  command = "node .next/standalone/server.js"
+
+  endpoint {
+    public = true
+  }
+
+  env = {
+    PORT = port
+  }
+
+  dev {
+    command = "npm run dev"
+  }
+}
+```
+
+Next.js reads `PORT` from the environment automatically, so no additional configuration is needed.
+
+## Important note on pre-rendering during builds
+
+During a build, Next.js will load a lot of code to perform pre-rendering. That code can not reference any environments variables from `specific.hcl`, like database URLs or API keys from secrets, as those are not available during the build and will cause it to fail. Ensure all code that relies on these env vars DOES NOT get executed during the build phase.

package/dist/docs/integrations/prisma.md

@@ -0,0 +1,110 @@
+# Prisma
+
+Prisma is a TypeScript ORM with auto-generated client and migrations. This guide covers using Prisma with Specific.
+
+## Setup
+
+Pass the database URL to your service and always add a `pre_deploy` step to run database migrations.
+
+```hcl
+build "api" {
+  base = "node"
+  command = "npx prisma generate && npm run build"
+}
+
+service "api" {
+  build = build.api
+  command = "node dist/index.js"
+
+  endpoint {
+    public = true
+  }
+
+  env = {
+    PORT = port
+    DATABASE_URL = postgres.main.url
+  }
+
+  pre_deploy {
+    command = "npx prisma migrate deploy"
+  }
+
+  dev {
+    command = "npm run dev"
+  }
+}
+
+postgres "main" {}
+```
+
+Note: The build command includes `prisma generate` to ensure the Prisma client is generated before building.
+
+## Prisma schema
+
+Configure the datasource in `prisma/schema.prisma`:
+
+```prisma
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+}
+```
+
+## Development
+
+Use `specific exec` to run migrations:
+
+```bash
+# Create and apply a new migration
+specific exec api -- npx prisma migrate dev --name add_users_table
+
+# Apply pending migrations
+specific exec api -- npx prisma migrate dev
+
+# Push schema directly (for rapid prototyping)
+specific exec api -- npx prisma db push
+```
+
+To seed your database, add a seed script to `package.json`:
+
+```json
+{
+  "prisma": {
+    "seed": "npx tsx prisma/seed.ts"
+  }
+}
+```
+
+Then run it:
+
+```bash
+specific exec api -- npx prisma db seed
+```
+
+## Database client
+
+Create a singleton Prisma client:
+
+```typescript
+import { PrismaClient } from "@prisma/client";
+
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClient | undefined;
+};
+
+export const prisma = globalForPrisma.prisma ?? new PrismaClient();
+
+if (process.env.NODE_ENV !== "production") {
+  globalForPrisma.prisma = prisma;
+}
+```
+
+The singleton pattern prevents multiple client instances during hot reloading in development.
+
+## Prisma Studio
+
+Prisma Studio is not necessary as `specific dev` includes a database viewer and editor in its admin interface.

package/dist/docs/postgres.md

@@ -0,0 +1,41 @@
+# Postgres
+
+Managed PostgreSQL database instances.
+
+```hcl
+postgres "main" {}
+```
+
+Reference postgres attributes in env blocks:
+
+```hcl
+service "api" {
+  build = build.api
+  command = "./api"
+
+  endpoint {
+    public = true
+  }
+
+  env = {
+    DATABASE_URL = postgres.main.url
+  }
+}
+
+postgres "main" {}
+```
+
+## Available postgres attributes
+
+- `url` - Full connection string (e.g., `postgres://user:pass@host:5432/dbname`)
+- `host` - Database host
+- `port` - Database port
+- `user` - Database user
+- `password` - Database password
+- `name` - Database name
+
+---
+
+Related topics:
+- Run `specific docs sync` for real-time data synchronization
+- Run `specific docs exec` for running migrations

package/dist/docs/redis.md

@@ -0,0 +1,33 @@
+# Redis
+
+Managed Redis instances.
+
+```hcl
+redis "cache" {}
+```
+
+Reference redis attributes in env blocks:
+
+```hcl
+service "api" {
+  build = build.api
+  command = "./api"
+
+  endpoint {
+    public = true
+  }
+
+  env = {
+    REDIS_URL = redis.cache.url
+  }
+}
+
+redis "cache" {}
+```
+
+## Available redis attributes
+
+- `url` - Full connection string (e.g., `redis://:password@host:6379`)
+- `host` - Redis host
+- `port` - Redis port
+- `password` - Redis password for authentication