@specific.dev/cli 0.1.42 → 0.1.43

package/dist/docs/index.md

@@ -28,6 +28,7 @@ The following is a list of common frameworks and libraries with guidance on how
 - [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
+- [Temporal](/integrations/temporal): durable workflow engine for background tasks, AI agents, cron jobs, batch jobs and more
 
 ## Adding Specific to existing projects / migrating to Specific
 

package/dist/docs/integrations/temporal.md

@@ -0,0 +1,89 @@
+# Temporal
+
+Temporal is a durable workflow engine. This guide covers running Temporal locally during development and connecting to Temporal Cloud in production.
+
+Temporal has extensive SDK support across many languages including TypeScript, Python, Go, Java, .NET, and PHP. See the [Temporal documentation](https://docs.temporal.io/) for language-specific guides on implementing workers, workflows, and activities. This document only covers integration with Specific.
+
+## Configuration
+
+Define a dev-only Temporal service that runs locally, along with configs and secrets for production Temporal Cloud.
+
+```hcl
+build "app" {
+  base = "node"
+}
+
+# Dev-only service: runs local Temporal server during development
+# No top-level command means it's excluded from production deployment
+#
+service "temporal" {
+  endpoint "grpc" {}
+  endpoint "ui" { public = true }
+
+  dev {
+    command = "temporal server start-dev --port $GRPC_PORT --ui-port $UI_PORT --db-filename /tmp/temporal.db"
+    env = {
+      GRPC_PORT = endpoint.grpc.port
+      UI_PORT   = endpoint.ui.port
+    }
+  }
+}
+
+# Temporal Cloud address (e.g., your-namespace.tmprl.cloud:7233)
+config "temporal_address" {}
+
+# Namespace - uses "default" in dev, must be set for production
+config "temporal_namespace" {
+  dev {
+    default = "default"
+  }
+}
+
+# API key for Temporal Cloud - not required in dev
+secret "temporal_api_key" {
+  dev {
+    required = false
+  }
+}
+
+service "app" {
+  build = build.app
+  command = "node index.js"
+  expose {}
+
+  env = {
+    PORT               = port
+    TEMPORAL_ADDRESS   = config.temporal_address
+    TEMPORAL_NAMESPACE = config.temporal_namespace
+    TEMPORAL_API_KEY   = secret.temporal_api_key
+  }
+
+  dev {
+    command = "node --watch index.js"
+    env = {
+      # Override to use local Temporal service instead
+      TEMPORAL_ADDRESS = ""
+      TEMPORAL_HOST    = service.temporal.endpoint.grpc.host
+      TEMPORAL_PORT    = service.temporal.endpoint.grpc.port
+    }
+  }
+}
+```
+
+## Development
+
+Running `specific dev` automatically starts a local Temporal server. The user must install the Temporal CLI for this: https://temporal.io/setup/install-temporal-cli. The Temporal Web UI is available at the public endpoint URL shown in the output.
+
+Your app connects to the local Temporal server using the service endpoint environment variables (`TEMPORAL_HOST` and `TEMPORAL_PORT`).
+
+## Production
+
+In production, the dev-only `temporal` service is excluded from deployment. Your app connects to Temporal Cloud using:
+
+1. `temporal_address` - Your Temporal Cloud address (e.g., `your-namespace.tmprl.cloud:7233`)
+2. `temporal_namespace` - Your Temporal Cloud namespace
+3. `temporal_api_key` - API key for authentication
+
+Set these with `specific secrets set` before deploying.
+
+## SDK support

package/dist/docs/services.md

@@ -116,14 +116,14 @@ service "worker" {
   command = "./worker"
 
   env = {
-    API_URL = service.api.url  # http://localhost:PORT in dev, http://api:80 in prod
+    API_URL = service.api.url  # localhost:PORT in dev, api:80 in prod
   }
 }
 ```
 
 Available service reference attributes:
 
-- `service.<name>.url` - Full URL (e.g., `http://localhost:3000`)
+- `service.<name>.url` - Full URL without scheme (e.g., `localhost:3000`)
 - `service.<name>.host` - Host only (e.g., `localhost`)
 - `service.<name>.port` - Port only (e.g., `3000`)
 
@@ -233,6 +233,7 @@ secret "temporal_url" {}
 ```
 
 Dev-only services:
+
 - Cannot have a `build` reference (they run arbitrary commands)
 - Are automatically excluded from production deployment
 - Can define endpoints that other services reference during development
@@ -320,6 +321,7 @@ service "frontend" {
 ---
 
 Related topics:
+
 - Run `specific docs builds` for build configuration
 - Run `specific docs exec` for running one-off commands during development
 - Run `specific docs postgres` for database configuration

package/package.json

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