@brendanbank/create-atrium-host 0.29.1 → 0.30.0

package/README.md

@@ -28,7 +28,7 @@ npx @brendanbank/create-atrium-host test-host --yes-defaults
 | `--yes-defaults`        | Skip prompts; derive everything from the project name |
 | `--no-git`              | Skip `git init` + initial commit                      |
 | `--out <dir>`           | Output directory (default: `./<name>`)                |
-| `--atrium <version>`    | Atrium image / SDK version pin (default: `0.29`)      |
+| `--atrium <version>`    | Atrium image / SDK version pin (default: `0.30`)      |
 | `-h`, `--help`          | Show help                                             |
 
 ## What it emits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brendanbank/create-atrium-host",
-  "version": "0.29.1",
+  "version": "0.30.0",
   "description": "Scaffolder for new atrium host extensions: backend Python package + frontend Vite bundle + compose stack + CI, all wired against atrium's published image and host SDK packages. Run via `npx @brendanbank/create-atrium-host <name>`.",
   "license": "BSD-2-Clause",
   "type": "module",

package/src/cli.js

@@ -37,7 +37,7 @@ const TEMPLATE_DIR = resolve(__dirname, '..', 'template');
 // The atrium image + SDK packages version in lockstep. Bump this when
 // cutting a new atrium release so freshly scaffolded hosts pin against
 // the right line.
-const DEFAULT_ATRIUM_VERSION = '0.29';
+const DEFAULT_ATRIUM_VERSION = '0.30';
 
 const HELP = `
 ${kleur.bold('create-atrium-host')} — scaffold a new atrium host extension

package/template/Dockerfile

@@ -37,6 +37,25 @@ RUN /opt/venv/bin/python -m ensurepip --upgrade \
 # Bake the host bundle into atrium's static dir at /host/main.js.
 COPY --from=frontend-builder /app/dist /opt/atrium/static/host
 
+# Build stamp for ``GET /api/version`` — the SPA renders it in the
+# user menu next to the atrium line, so an operator can see both
+# layers at a glance. ``ATRIUM_VERSION`` / ``ATRIUM_COMMIT`` are
+# inherited as ENV from the atrium base image; these three describe
+# *this* image.
+#
+# Wire them up in CI, e.g.:
+#   docker build \
+#     --build-arg ATRIUM_APP_VERSION="$(git describe --tags --exact-match 2>/dev/null)" \
+#     --build-arg ATRIUM_APP_COMMIT="$(git rev-parse HEAD)" .
+# An untagged build leaves the version empty and the UI renders the
+# line as ``<name>: <short sha>``.
+ARG ATRIUM_APP_NAME="__BRAND_NAME__"
+ARG ATRIUM_APP_VERSION=""
+ARG ATRIUM_APP_COMMIT=""
+ENV ATRIUM_APP_NAME=${ATRIUM_APP_NAME} \
+    ATRIUM_APP_VERSION=${ATRIUM_APP_VERSION} \
+    ATRIUM_APP_COMMIT=${ATRIUM_APP_COMMIT}
+
 USER app
 
 # Re-declare HEALTHCHECK on the derived image. The base atrium image

package/template/README.md

@@ -115,7 +115,7 @@ make typecheck       # tsc --noEmit on the host bundle
 against a specific release:
 
 ```bash
-ATRIUM_IMAGE=ghcr.io/brendanbank/atrium:0.29.1 make build up
+ATRIUM_IMAGE=ghcr.io/brendanbank/atrium:0.30.0 make build up
 ```
 
 The frontend SDK packages