integrate PR title validation as a required step across workflows

Author: allnes

.github/workflows/check-pr-title.yml

@@ -3,6 +3,7 @@ name: "Check PR Title"
 on:
   pull_request:
     types: [opened, edited, reopened, synchronize]
+  workflow_call:
 
 permissions:
   contents: read
@@ -11,20 +12,27 @@ jobs:
   pr-title:
     name: Validate PR title
     runs-on: ubuntu-24.04
-    # Run always except: for 'edited' only run when title changed
-    if: >-
-      github.event_name != 'pull_request' ||
-      github.event.action != 'edited' ||
-      contains(toJson(github.event.changes), 'title')
     steps:
+      - name: Skip when PR edited without title change
+        if: github.event_name == 'pull_request' && github.event.action == 'edited' && !contains(toJson(github.event.changes), 'title')
+        run: echo "PR edited without title change; skipping title check."
+
       - name: Checkout repository (sparse, PR head)
+        if: github.event_name == 'pull_request' && (github.event.action != 'edited' || contains(toJson(github.event.changes), 'title'))
         uses: actions/checkout@v5
         with:
           ref: ${{ github.event.pull_request.head.sha }}
           fetch-depth: 1
           sparse-checkout: |
             scripts
           sparse-checkout-cone: true
+
+      - uses: actions/setup-python@v5
+        if: github.event_name == 'pull_request' && (github.event.action != 'edited' || contains(toJson(github.event.changes), 'title'))
+        with:
+          python-version: '3.x'
+
       - name: Run PR title check
+        if: github.event_name == 'pull_request' && (github.event.action != 'edited' || contains(toJson(github.event.changes), 'title'))
         run: |
           python3 scripts/check_pr_title.py "${{ github.event.pull_request.title }}"

.github/workflows/docker.yml

@@ -16,7 +16,11 @@ permissions:
   packages: write
 
 jobs:
+  pr-title:
+    uses: ./.github/workflows/check-pr-title.yml
   build-and-push:
+    needs:
+      - pr-title
     name: Build & Push Docker Image
     runs-on: ubuntu-latest
     if: github.repository == 'learning-process/parallel_programming_course'

.github/workflows/main.yml

@@ -16,7 +16,11 @@ concurrency:
         !startsWith(github.ref, 'refs/heads/gh-readonly-queue') }}
 
 jobs:
+  pr-title:
+    uses: ./.github/workflows/check-pr-title.yml
   pre-commit:
+    needs:
+      - pr-title
     uses: ./.github/workflows/pre-commit.yml
   ubuntu:
     needs:

.github/workflows/pre-commit.yml

@@ -6,7 +6,11 @@ on:
   workflow_call:
 
 jobs:
+  pr-title:
+    uses: ./.github/workflows/check-pr-title.yml
   pre-commit:
+    needs:
+      - pr-title
     runs-on: ubuntu-24.04
     container:
       image: ghcr.io/learning-process/ppc-ubuntu:1.1

.github/workflows/static-analysis-pr.yml

@@ -20,7 +20,11 @@ concurrency:
         !startsWith(github.ref, 'refs/heads/gh-readonly-queue') }}
 
 jobs:
+  pr-title:
+    uses: ./.github/workflows/check-pr-title.yml
   clang-tidy:
+    needs:
+      - pr-title
     runs-on: ubuntu-24.04
     container:
       image: ghcr.io/learning-process/ppc-ubuntu:1.1
@@ -117,6 +121,8 @@ jobs:
           echo "clang-tidy run has failed. See previous 'Run clang-tidy' stage logs"
           exit 1
   nolint-check:
+    needs:
+      - pr-title
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v5