CI/CD: parallel quality jobs and Cloud Run deploy workflow (#3)

* ci: parallelize CI and add Cloud Run CD workflow

* ci: harden matrix task handling and CD secret checks

.github/workflows/cd.yml

@@ -0,0 +1,93 @@
+name: CD
+
+on:
+  workflow_run:
+    workflows:
+      - CI
+    types:
+      - completed
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+concurrency:
+  group: cd-main
+  cancel-in-progress: false
+
+jobs:
+  check-secrets:
+    name: Check deploy prerequisites
+    runs-on: ubuntu-latest
+    outputs:
+      eligible_event: ${{ steps.check.outputs.eligible_event }}
+      secrets_ok: ${{ steps.check.outputs.secrets_ok }}
+
+    steps:
+      - name: Evaluate trigger and required secrets
+        id: check
+        env:
+          GCP_PROJECT_ID: ${{ secrets.GCP_PROJECT_ID }}
+          GCP_WORKLOAD_IDENTITY_PROVIDER: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
+          GCP_SERVICE_ACCOUNT: ${{ secrets.GCP_SERVICE_ACCOUNT }}
+        run: |
+          eligible_event=false
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            eligible_event=true
+          elif [[ "${{ github.event_name }}" == "workflow_run" && "${{ github.event.workflow_run.conclusion }}" == "success" ]]; then
+            eligible_event=true
+          fi
+
+          secrets_ok=false
+          if [[ -n "$GCP_PROJECT_ID" && -n "$GCP_WORKLOAD_IDENTITY_PROVIDER" && -n "$GCP_SERVICE_ACCOUNT" ]]; then
+            secrets_ok=true
+          fi
+
+          echo "eligible_event=$eligible_event" >> "$GITHUB_OUTPUT"
+          echo "secrets_ok=$secrets_ok" >> "$GITHUB_OUTPUT"
+
+  deploy:
+    name: Deploy Cloud Run
+    runs-on: ubuntu-latest
+    needs: check-secrets
+    timeout-minutes: 30
+    if: ${{ needs.check-secrets.outputs.eligible_event == 'true' && needs.check-secrets.outputs.secrets_ok == 'true' }}
+
+    steps:
+      - name: Checkout deployment ref
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_run' && github.event.workflow_run.head_sha || github.sha }}
+
+      - name: Authenticate to Google Cloud
+        uses: google-github-actions/auth@v2
+        with:
+          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
+          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
+
+      - name: Setup gcloud
+        uses: google-github-actions/setup-gcloud@v2
+
+      - name: Deploy bot service
+        run: |
+          gcloud run deploy "${{ vars.CLOUD_RUN_SERVICE_BOT || 'household-bot' }}" \
+            --source . \
+            --region "${{ vars.GCP_REGION || 'europe-west1' }}" \
+            --project "${{ secrets.GCP_PROJECT_ID }}" \
+            --allow-unauthenticated \
+            --quiet
+
+  deploy-skipped:
+    name: Deploy skipped (missing config)
+    runs-on: ubuntu-latest
+    needs: check-secrets
+    if: ${{ needs.check-secrets.outputs.eligible_event == 'true' && needs.check-secrets.outputs.secrets_ok == 'false' }}
+
+    steps:
+      - name: Print configuration hint
+        run: |
+          echo "CD skipped: configure required GitHub secrets."
+          echo "Required: GCP_PROJECT_ID, GCP_WORKLOAD_IDENTITY_PROVIDER, GCP_SERVICE_ACCOUNT"

.github/workflows/ci.yml

@@ -8,11 +8,27 @@ on:
     branches:
       - main
 
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   quality:
-    name: Quality Gates
+    name: Quality / ${{ matrix.task }}
     runs-on: ubuntu-latest
     timeout-minutes: 20
+    strategy:
+      fail-fast: false
+      matrix:
+        task:
+          - format
+          - lint
+          - typecheck
+          - test
+          - build
 
     steps:
       - name: Checkout
@@ -23,20 +39,39 @@ jobs:
         with:
           bun-version: 1.3.10
 
+      - name: Restore Bun cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.bun/install/cache
+            node_modules
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
-      - name: Check formatting
+      - name: Run quality gate
-        run: bun run format:check
+        run: |
-
+          case "${{ matrix.task }}" in
-      - name: Lint
+            format)
-        run: bun run lint
+              bun run format:check
-
+              ;;
-      - name: Typecheck
+            lint)
-        run: bun run typecheck
+              bun run lint
-
+              ;;
-      - name: Test
+            typecheck)
-        run: bun run test
+              bun run typecheck
-
+              ;;
-      - name: Build
+            test)
-        run: bun run build
+              bun run test
+              ;;
+            build)
+              bun run build
+              ;;
+            *)
+              echo "Unknown task: ${{ matrix.task }}"
+              exit 1
+              ;;
+          esac

docs/runbooks/dev-setup.md

@@ -42,4 +42,13 @@ bun run review:coderabbit
 - Linting uses `oxlint`.
 - Formatting uses `oxfmt` with no-semicolon style.
 - AI review uses CodeRabbit CLI in `--prompt-only` mode against `main`.
-- `WHE-19` will add CI checks for the same root commands.
+
+## CI/CD
+
+- CI runs in parallel matrix jobs on push/PR to `main`:
+  - `format:check`, `lint`, `typecheck`, `test`, `build`
+- CD deploys on successful `main` CI completion (or manual dispatch).
+- CD is enabled when GitHub secrets are configured:
+  - `GCP_PROJECT_ID`
+  - `GCP_WORKLOAD_IDENTITY_PROVIDER`
+  - `GCP_SERVICE_ACCOUNT`