feat(deploy): multi-arch buildx script for broker + web + migrate

scripts/build-multiarch.sh produces linux/amd64 + linux/arm64 image
manifests for all three deployable images. Mac devs (Apple Silicon)
pulling claudemesh images get arm64 native — no QEMU, no 2-4x startup
penalty, no warnings. VPS (amd64) gets the native variant from the
same manifest.

- 3 images in one script: broker, web, migrate
- Tags both <SHA> and :latest per image
- GIT_SHA build-arg wired in for broker /health provenance

Replaces scripts/build-and-push.sh which was hardcoded to a dead
registry (192.168.1.3:3030) and wrong org (alezmad/turbostarter).

DEPLOY.md Step 2 rewritten to use the new script + Mac Docker Desktop
Rosetta-emulation gotcha documented.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

scripts/build-and-push.sh

@@ -1,22 +0,0 @@
-#!/bin/bash
-# Build Docker image locally and push to Gitea Container Registry
-# Usage: ./scripts/build-and-push.sh [tag]
-
-set -e
-
-# Configuration
-REGISTRY="192.168.1.3:3030"
-REPO="alezmad/turbostarter"
-TAG="${1:-latest}"
-IMAGE="${REGISTRY}/${REPO}:${TAG}"
-
-echo "🔨 Building Docker image: ${IMAGE}"
-docker build --platform linux/amd64 -t "${IMAGE}" .
-
-echo "📤 Pushing to Gitea registry..."
-docker push "${IMAGE}"
-
-echo "✅ Done! Image pushed: ${IMAGE}"
-echo ""
-echo "To deploy in Coolify, update the application to use:"
-echo "  Image: ${IMAGE}"

scripts/build-multiarch.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Build + push multi-arch (linux/amd64 + linux/arm64) claudemesh images.
+#
+# Usage:
+#   scripts/build-multiarch.sh [REGISTRY] [TAG]
+#
+#   REGISTRY   default: ghcr.io/claudemesh        (override for private registry)
+#   TAG        default: $(git rev-parse --short HEAD)
+#
+# Examples:
+#   scripts/build-multiarch.sh                                 # → ghcr.io/claudemesh/broker:<sha> + web + migrate
+#   scripts/build-multiarch.sh ghcr.io/myorg latest            # → ghcr.io/myorg/broker:latest + web + migrate
+#   scripts/build-multiarch.sh localhost:5000/claudemesh 0.1.0 # → local registry
+#
+# Requires: docker buildx with a multi-arch-capable builder. On Docker Desktop
+# (Mac/Windows), this is already set up. On Linux CI, run first:
+#   docker run --privileged --rm tonistiigi/binfmt --install all
+#   docker buildx create --use --name multiarch
+#
+# Why multi-arch: Mac dev machines are arm64 (Apple Silicon), VPS is typically
+# amd64. Single-arch images force one side into QEMU emulation (2-4x slower,
+# noisy warnings, occasional native-binding failures).
+
+set -euo pipefail
+
+REGISTRY="${1:-ghcr.io/claudemesh}"
+TAG="${2:-$(git rev-parse --short HEAD)}"
+GIT_SHA="$(git rev-parse --short HEAD)"
+
+PLATFORMS="linux/amd64,linux/arm64"
+
+cd "$(dirname "$0")/.."
+
+echo "→ Building ${REGISTRY}/{broker,web,migrate}:${TAG} for [${PLATFORMS}]"
+echo "  GIT_SHA=${GIT_SHA}"
+echo ""
+
+docker buildx build \
+  --platform "${PLATFORMS}" \
+  --file apps/broker/Dockerfile \
+  --build-arg "GIT_SHA=${GIT_SHA}" \
+  --tag "${REGISTRY}/broker:${TAG}" \
+  --tag "${REGISTRY}/broker:latest" \
+  --push \
+  .
+
+docker buildx build \
+  --platform "${PLATFORMS}" \
+  --file apps/web/Dockerfile \
+  --build-arg "NEXT_PUBLIC_URL=${NEXT_PUBLIC_URL:-https://claudemesh.com}" \
+  --tag "${REGISTRY}/web:${TAG}" \
+  --tag "${REGISTRY}/web:latest" \
+  --push \
+  .
+
+docker buildx build \
+  --platform "${PLATFORMS}" \
+  --file packages/db/Dockerfile \
+  --tag "${REGISTRY}/migrate:${TAG}" \
+  --tag "${REGISTRY}/migrate:latest" \
+  --push \
+  .
+
+echo ""
+echo "✓ pushed ${REGISTRY}/{broker,web,migrate}:${TAG} (+ :latest)"
+echo "  arm64 + amd64 — no QEMU emulation for your adopters"