name: CI on: pull_request: workflow_dispatch: concurrency: group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} cancel-in-progress: true env: HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }} jobs: # The former single "verify" gate is split into two parallel jobs (verify-1 + verify-2) # to halve CI wallclock. The two heavy UI checks (ui-visual + hot-swap) sit in verify-1, # the two heavy accessibility checks (a11y-coverage + a11y smoke) in verify-2, with the # lighter static gates spread evenly. Every required command still runs exactly once # across both jobs and keeps its canonical relative order WITHIN its owning job. verify-1: name: Quality Static Verify (1/2) runs-on: toolctrl-ci timeout-minutes: 20 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Verify GitHub CI workflow run: pnpm run verify:github-ci-workflow - name: Verify Gitea CI workflow run: pnpm run verify:gitea-ci-workflow - name: Verify Gitea deploy workflow run: pnpm run verify:deploy-workflow - name: Verify deploy readiness run: pnpm run verify:deploy-readiness - name: Verify Docker baseline run: pnpm run verify:docker-baseline - name: Verify Docker non-root runtime run: pnpm run verify:docker-non-root - name: Verify CI baseline run: pnpm run verify:ci-baseline - name: Verify source health run: pnpm run verify:source-health - name: Verify ESLint baseline run: pnpm run verify:eslint-baseline - name: Verify env drift run: pnpm run verify:env-drift - name: Verify health baseline run: pnpm run verify:health-baseline - name: Verify API inventory run: pnpm run verify:api-inventory - name: Verify UI mock static baseline run: pnpm run verify:ui-visual - name: Test UI mock hot-swap run: pnpm run test:hot-swap verify-2: name: Quality Static Verify (2/2) runs-on: toolctrl-ci timeout-minutes: 20 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Verify tenant isolation report run: pnpm run verify:tenant-isolation-report - name: Verify cross-cutting model registry completeness run: pnpm run verify:cross-cutting-models - name: Verify sidebar routes run: pnpm run verify:sidebar-routes - name: Verify i18n keys run: pnpm run verify:i18n - name: Verify Tenant Auth tenant and onboarding gates run: | pnpm run verify:tenant-auth-baseline pnpm run verify:onboarding-flow - name: Verify Phase C package boundaries run: pnpm run verify:phase-c-boundaries - name: Verify Feature Manifest removed modules run: pnpm run verify:removed-modules - name: Verify accessibility coverage run: pnpm run verify:a11y-coverage - name: Test accessibility smoke run: pnpm run test:a11y - name: Verify documentation gates run: | pnpm run verify:porting-docs-baseline pnpm run verify:production-docs pnpm run verify:release-docs pnpm run verify:docs-links typecheck-test: name: Quality Typecheck and Tests runs-on: toolctrl-ci timeout-minutes: 25 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Typecheck run: pnpm typecheck - name: Lint run: pnpm lint - name: Foundation package tests run: pnpm run test:foundation - name: Workspace package tests run: pnpm run test:packages - name: Unit tests run: pnpm test build: name: Quality Build and Bundle runs-on: toolctrl-ci timeout-minutes: 30 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Verify Feature Manifest core without plugins run: pnpm run verify:core-build-without-plugins-smoke - name: Build env: HIVEGRID_BUILD_SOURCEMAPS: "1" run: pnpm run build:ci - name: Verify bundle size run: pnpm run verify:bundle-size - name: Verify web Sentry sourcemaps run: test -n "$(find apps/web/build/client -type f -name '*.map' -print -quit)" - name: Upload web Sentry sourcemaps uses: actions/upload-artifact@v3 with: name: web-client-sourcemaps path: apps/web/build/client if-no-files-found: error retention-days: 7 - name: Verify production seed artifact run: pnpm run verify:production-seed-artifact api: name: API Service runs-on: toolctrl-ci timeout-minutes: 25 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Verify OpenAPI security run: pnpm run verify:openapi-security - name: Typecheck API run: pnpm --filter @hivegrid/api typecheck - name: Test API run: pnpm exec vitest run apps/api/src - name: Build API run: pnpm --filter @hivegrid/api build mcp: name: MCP Service runs-on: toolctrl-ci timeout-minutes: 20 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Typecheck MCP run: pnpm --filter @hivegrid/mcp typecheck - name: Test MCP run: pnpm --filter @hivegrid/mcp test - name: Build MCP run: pnpm --filter @hivegrid/mcp build worker: name: Worker Service runs-on: toolctrl-ci timeout-minutes: 25 env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Typecheck Worker run: pnpm --filter @hivegrid/worker typecheck - name: Test Worker run: pnpm --filter @hivegrid/worker exec vitest run - name: Verify workflow outbox native readiness run: pnpm run verify:workflow-outbox-native - name: Build Worker run: pnpm --filter @hivegrid/worker build - name: Health Check Worker run: pnpm --filter @hivegrid/worker health env: WORKER_ENABLED: "false" database: name: Database Checks runs-on: toolctrl-ci timeout-minutes: 20 steps: - name: Resolve internal Gitea host run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi - name: Checkout code uses: actions/checkout@v4 - name: Enable Corepack run: corepack enable - name: Prepare pnpm 10.33.0 run: corepack prepare pnpm@10.33.0 --activate - name: Configure pnpm store run: pnpm config set store-dir .pnpm-store - name: Cache pnpm store uses: actions/cache@v4 with: path: .pnpm-store key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm- - name: Install dependencies run: pnpm install --frozen-lockfile --prefer-offline - name: Generate database client run: pnpm run db:generate env: DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public - name: Setup Docker CLI run: | if ! command -v docker >/dev/null 2>&1; then if ! command -v apt-get >/dev/null 2>&1 || [ "$(id -u)" != "0" ]; then echo "Docker CLI missing and apt-get is not available as root" exit 1 fi apt-get update -qq apt-get install -qq -y --no-install-recommends ca-certificates curl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc chmod a+r /etc/apt/keyrings/docker.asc . /etc/os-release echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian ${VERSION_CODENAME} stable" > /etc/apt/sources.list.d/docker.list apt-get update -qq apt-get install -qq -y --no-install-recommends docker-ce-cli fi docker --version - name: Verify migrations schema parity run: pnpm run verify:migrations-parity - name: Verify database migration status if: gitea.event_name != 'pull_request' run: pnpm run verify:db-migrate-status:staging env: COOLIFY_STAGING_SSH_HOST: ${{ vars.COOLIFY_STAGING_SSH_HOST }} COOLIFY_STAGING_SSH_USER: ${{ vars.COOLIFY_STAGING_SSH_USER }} COOLIFY_STAGING_WEB_RESOURCE_UUID: ${{ vars.COOLIFY_STAGING_WEB_RESOURCE_UUID }} COOLIFY_STAGING_SSH_KEY: ${{ secrets.COOLIFY_STAGING_SSH_KEY }} - name: Test database package run: pnpm --filter @hivegrid/db test docker-smoke: name: Docker Smoke runs-on: toolctrl-ci timeout-minutes: 30 # No needs: the Docker images are built from source inside this job (no dependency on the # quality/build jobs' outputs), so it runs fully in parallel instead of waiting on the # ~4 min quality phase -> off the critical tail. Trade-off: if quality fails, the images # still build (wasted compute), but the run fails overall anyway. steps: - name: Setup hosts override and Docker CLI run: | if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token" exit 1 fi printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts fi if ! command -v docker >/dev/null 2>&1 || ! docker buildx version >/dev/null 2>&1 || ! docker compose version >/dev/null 2>&1; then if ! command -v apt-get >/dev/null 2>&1 || [ "$(id -u)" != "0" ]; then echo "Docker CLI/buildx missing and apt-get is not available as root" exit 1 fi apt-get update -qq apt-get install -qq -y --no-install-recommends ca-certificates curl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc chmod a+r /etc/apt/keyrings/docker.asc . /etc/os-release echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian ${VERSION_CODENAME} stable" > /etc/apt/sources.list.d/docker.list apt-get update -qq apt-get install -qq -y --no-install-recommends docker-ce-cli docker-buildx-plugin docker-compose-plugin fi docker --version docker buildx version docker compose version - name: Checkout code uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 # Layer-cache strategy: this job runs on the self-hosted toolctrl-ci runner against the # mounted host Docker daemon, whose BuildKit keeps a persistent local layer cache between # CI runs (proven by the fact the `docker run hivegrid-*:smoke` steps below find images the # build loaded into the host store). The Dockerfile additionally persists the pnpm store via # `RUN --mount=type=cache,id=hivegrid-pnpm-store`. The three targets share base/deps/build # stages, so a single daemon dedupes them within a run. No explicit `--cache-to/--cache-from` # (type=local/registry) is configured: it would add cold first runs, import/export overhead # and would require `--load` for the smoke steps, for no gain over the warm host cache. # `type=gha` is intentionally not used here — it is GitHub-hosted-runner-only. - name: Build Docker smoke targets shell: bash run: | set -euo pipefail docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-web:smoke . & web_pid=$! docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-api:smoke . & api_pid=$! docker build --target mcp --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-mcp:smoke . & mcp_pid=$! docker build --target worker --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-worker:smoke . & worker_pid=$! status=0 wait "$web_pid" || status=$? wait "$api_pid" || status=$? wait "$mcp_pid" || status=$? wait "$worker_pid" || status=$? exit "$status" - name: Validate web Docker artifacts run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js' - name: Validate web Docker runtime run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke env: DOCKER_WEB_SMOKE_TRANSPORT: exec - name: Validate API Docker runtime run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke env: DOCKER_API_SMOKE_TRANSPORT: exec - name: Validate MCP Docker runtime run: bash scripts/docker-mcp-runtime-smoke.sh hivegrid-mcp:smoke env: DOCKER_MCP_SMOKE_TRANSPORT: exec - name: Validate worker Docker runtime run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke - name: Validate Docker Compose config run: docker compose config