Merge pull request #1462 from kaitranntt/kai/fix/1461-ci-gate

fix(ci): add always-reporting CI Gate so fork PRs stop deadlocking

.github/workflows/ci.yml

@@ -160,3 +160,37 @@ jobs:
 
       - name: Assert compose parity (compose.yaml vs docker-compose.integrated.yml)
         run: bash tests/docker/compose-parity.sh
+
+  # Single always-reporting status that branch protection requires.
+  #
+  # The validate/build/test jobs are gated to trusted author associations so
+  # untrusted fork code never executes on the self-hosted runners. A job skipped
+  # by a job-level `if` reports no status, so requiring those job names directly
+  # leaves fork PRs stuck on "Expected - waiting for status to be reported"
+  # forever. Requiring this gate instead keeps the contract satisfiable:
+  #   - trusted PR: gate is green only if every gated job actually succeeded
+  #   - fork PR:    gated jobs skip, gate reports green so the PR is mergeable
+  #                 (fork code is still reviewed by a maintainer before merge)
+  #
+  # No checkout here: the gate only inspects upstream job results, so it runs no
+  # third-party code and is safe on the self-hosted runner.
+  ci-gate:
+    if: always()
+    needs: [validate, build, test]
+    runs-on: [self-hosted, linux, x64]
+    name: CI Gate
+    steps:
+      - name: Verify gated jobs did not fail
+        env:
+          VALIDATE: ${{ needs.validate.result }}
+          BUILD: ${{ needs.build.result }}
+          TEST: ${{ needs.test.result }}
+        run: |
+          echo "validate=$VALIDATE build=$BUILD test=$TEST"
+          for result in "$VALIDATE" "$BUILD" "$TEST"; do
+            if [ "$result" = "failure" ] || [ "$result" = "cancelled" ]; then
+              echo "[X] A required CI job did not pass (result: $result)"
+              exit 1
+            fi
+          done
+          echo "[OK] CI gate satisfied (success or skipped-for-fork)"