create-objectstack 14.8.0 → 15.1.0

package/dist/templates/blank/.dockerignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.git
+*.log
+.env
+cookies.txt

package/dist/templates/blank/Dockerfile

@@ -0,0 +1,30 @@
+# Container build for this ObjectStack app.
+#
+#   docker build -t my-app .
+#   docker run -p 8080:8080 \
+#     -e OS_DATABASE_URL="postgres://user:pass@db-host:5432/myapp" \
+#     -e OS_AUTH_SECRET -e OS_SECRET_KEY \
+#     my-app
+#
+# Or run the full app + Postgres stack: see docker-compose.yml.
+# Docs: https://docs.objectstack.ai/docs/deployment/self-hosting
+
+# ── Build stage: compile TypeScript metadata to the artifact ─────────
+FROM node:22-slim AS build
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npx os build              # → dist/objectstack.json
+
+# ── Runtime: the official ObjectStack runtime image ──────────────────
+# Ships Node + @objectstack/cli with `os start`, a non-root user, the
+# /api/v1/health HEALTHCHECK, and OS_ARTIFACT_PATH/OS_PORT preset (port 8080)
+# — see docker/README.md in the framework repo. Pin the tag to the
+# @objectstack/cli version in your package.json so the runtime matches the
+# CLI that built the artifact.
+FROM ghcr.io/objectstack-ai/objectstack:latest
+COPY --from=build --chown=node:node /app/dist/objectstack.json /srv/app/objectstack.json
+
+# OS_DATABASE_URL, OS_AUTH_SECRET, and OS_SECRET_KEY are injected at runtime —
+# never bake them into the image.

package/dist/templates/blank/README.md

@@ -40,6 +40,29 @@ otherwise fail *silently at runtime* — e.g. a bare `done` (instead of
 `record.done`) in an action predicate that would hide the action on every
 record. See `AGENTS.md` for the full convention.
 
+## Deploy
+
+The project ships container-ready — the `Dockerfile` builds your metadata into
+an artifact and runs it on the official ObjectStack runtime image
+(`ghcr.io/objectstack-ai/objectstack`):
+
+```bash
+# Image only
+docker build -t my-app .
+
+# Or the full app + Postgres stack
+cat > .env <<EOF
+POSTGRES_PASSWORD=$(openssl rand -hex 16)
+OS_AUTH_SECRET=$(openssl rand -hex 32)
+OS_SECRET_KEY=$(openssl rand -hex 32)
+EOF
+docker compose up -d
+curl -fsS http://localhost:8080/api/v1/health
+```
+
+Bare Node, Kubernetes, reverse-proxy wiring, and the required secrets are
+covered in [Self-Hosted Deployment](https://docs.objectstack.ai/docs/deployment/self-hosting).
+
 ## Next steps
 
 - Add an object: see the `objectstack-data` skill.

package/dist/templates/blank/docker-compose.yml

@@ -0,0 +1,39 @@
+# Single-host production stack: this app + Postgres.
+#
+# Create a .env file next to this compose file (never committed) with
+# POSTGRES_PASSWORD / OS_AUTH_SECRET / OS_SECRET_KEY (generate secrets with
+# `openssl rand -hex 32`), then `docker compose up -d`.
+#
+# Docs: https://docs.objectstack.ai/docs/deployment/self-hosting
+
+services:
+  app:
+    build: .
+    ports:
+      - "8080:8080"
+    environment:
+      OS_DATABASE_URL: postgres://objectstack:${POSTGRES_PASSWORD}@db:5432/myapp
+      OS_AUTH_SECRET: ${OS_AUTH_SECRET}
+      OS_SECRET_KEY: ${OS_SECRET_KEY}
+    depends_on:
+      db:
+        condition: service_healthy
+    restart: unless-stopped
+
+  db:
+    image: postgres:17
+    environment:
+      POSTGRES_USER: objectstack
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: myapp
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U objectstack -d myapp"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
+    restart: unless-stopped
+
+volumes:
+  pgdata:

package/dist/templates/blank/objectstack.config.ts

@@ -9,6 +9,11 @@ export default defineStack({
     type: 'app',
     name: 'Blank Starter',
     description: 'Minimal ObjectStack environment — a clean slate for building.',
+    // Protocol compatibility range (ADR-0087 D1): lets an incompatible runtime
+    // refuse this package at the boundary with the exact migration command,
+    // instead of crashing later. Kept in lockstep with releases by
+    // scripts/sync-template-versions.mjs.
+    engines: { protocol: '^15' },
   },
   objects: Object.values(objects),
 });

package/dist/templates/blank/package.json

@@ -11,13 +11,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@objectstack/spec": "^14.0.0",
-    "@objectstack/runtime": "^14.0.0",
-    "@objectstack/driver-memory": "^14.0.0",
-    "@objectstack/plugin-hono-server": "^14.0.0"
+    "@objectstack/spec": "^15.0.0",
+    "@objectstack/runtime": "^15.0.0",
+    "@objectstack/driver-memory": "^15.0.0",
+    "@objectstack/plugin-hono-server": "^15.0.0"
   },
   "devDependencies": {
-    "@objectstack/cli": "^14.0.0",
+    "@objectstack/cli": "^15.0.0",
     "typescript": "^6.0.0"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-objectstack",
-  "version": "14.8.0",
+  "version": "15.1.0",
   "description": "Create a new ObjectStack project — npx create-objectstack",
   "bin": {
     "create-objectstack": "./bin/create-objectstack.js"