ci: publish images and a release from a version tag

.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 60
+    permissions:
+      contents: write
+      packages: write
+    env:
+      HUB_IMAGE: ghcr.io/corbitsdev/corbits-builder-hub
+      SIDECAR_IMAGE: ghcr.io/corbitsdev/corbits-builder-sidecar
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - id: version
+        run: |
+          version=$(jq -r .version package.json)
+          if [ "$GITHUB_REF_NAME" != "v$version" ]; then
+            echo "::error::Tag $GITHUB_REF_NAME does not match package.json version $version"
+            exit 1
+          fi
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+      - uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
+      - uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
+        with:
+          context: .
+          file: deploy/Dockerfile
+          target: hub
+          push: true
+          tags: ${{ env.HUB_IMAGE }}:${{ steps.version.outputs.version }}
+      - uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
+        with:
+          context: .
+          file: deploy/Dockerfile
+          target: sidecar
+          push: true
+          tags: ${{ env.SIDECAR_IMAGE }}:${{ steps.version.outputs.version }}
+      - env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          notes="$RUNNER_TEMP/notes.md"
+          cat > "$notes" <<EOF
+          Images:
+
+          - \`$HUB_IMAGE:$VERSION\`
+          - \`$SIDECAR_IMAGE:$VERSION\`
+
+          [docs/SELF_HOST.md](https://github.com/$GITHUB_REPOSITORY/blob/$GITHUB_REF_NAME/docs/SELF_HOST.md) covers self-hosting; set the hub and sidecar `image:` to these refs instead of building.
+          EOF
+          prerelease=()
+          if [[ "$VERSION" == 0.* || "$VERSION" == *-* ]]; then
+            prerelease=(--prerelease)
+          fi
+          gh release create "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" --verify-tag \
+            --generate-notes --notes-file "$notes" "${prerelease[@]}"

CONTRIBUTING.md

@@ -139,6 +139,14 @@ change follows, whether a person or a coding agent writes it.
   `vendor/interchange.manifest.json`; `bun run vendor:verify` fails on
   anything unrecorded.
 
+## Releasing
+
+Maintainers bump `version` in the root, `apps/hub`, `apps/web`,
+`packages/client` and `packages/schemas` package.json files, run
+`bun install`, and merge. Then `git tag -s vX.Y.Z && git push origin vX.Y.Z`
+publishes the hub and sidecar images and the GitHub release; a 0.x version or
+one with a `-` suffix is marked a pre-release.
+
 ## Security
 
 Report vulnerabilities through [SECURITY.md](https://github.com/corbitsdev/corbits-builder/blob/main/SECURITY.md), never a public

apps/hub/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbits-builder/hub",
-  "version": "0.0.0",
+  "version": "0.1.0-rc.1",
   "private": true,
   "license": "SEE LICENSE IN ../../LICENSE.md",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",

apps/hub/src/app.ts

@@ -101,6 +101,7 @@ import { requestErrorMetadata } from "./request-error.ts";
 import { createLiveAppProxy } from "./live-app/proxy.ts";
 import { createLiveAppRunner } from "./live-app/runner.ts";
 import { mountWebUi } from "./web-ui.ts";
+import { version } from "../package.json";
 
 const log = getLogger(["corbits-builder", "hub"]);
 
@@ -569,7 +570,7 @@ export async function createHubRuntime(
     );
     mountHubOpenAPI(app, {
       config,
-      version: "0.0.0",
+      version,
       securitySchemes: {
         sessionCookie: {
           type: "apiKey",

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbits-builder/web",
-  "version": "0.0.0",
+  "version": "0.1.0-rc.1",
   "private": true,
   "description": "Builder portal (Vite + React). Composes the hub's authenticated APIs.",
   "license": "SEE LICENSE IN ../../LICENSE.md",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "corbits-builder",
-  "version": "0.0.0",
+  "version": "0.1.0-rc.1",
   "private": true,
   "description": "Builder turns an idea into approved documents, a design and a working web app, with agents on the model provider you choose.",
   "license": "SEE LICENSE IN LICENSE.md",

packages/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbits-builder/client",
-  "version": "0.0.0",
+  "version": "0.1.0-rc.1",
   "private": true,
   "license": "SEE LICENSE IN ../../LICENSE.md",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",

packages/schemas/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbits-builder/schemas",
-  "version": "0.0.0",
+  "version": "0.1.0-rc.1",
   "private": true,
   "license": "SEE LICENSE IN ../../LICENSE.md",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",