Cache API validation results (#5376)

* Generate API validation report

* Fix path and add cache

* Add cache/restore steps

* Test with main

* Prepare for merge

* Use single workflow

Also use restore-keys

* Remove correct file

* Fix zizmor issues

* Remove contents: read since the repo is public

(cherry picked from commit bd811dc)

Author: pquentin

.github/workflows/validate-pr.yml

@@ -5,33 +5,51 @@ on:
     branches:
       - main
       - '[0-9]+.[0-9]+'
+  push:
+    branches:
+      - main
+      - '[0-9]+.[0-9]+'
+
+permissions:
+  pull-requests: write    # To create/update PR comments
 
 jobs:
-  validate-pr:
+  validate-apis:
     name: build
     runs-on: ubuntu-latest
 
     steps:
       - name: Check pull request was opened from branch
-        if: github.event.pull_request.head.repo.full_name != 'elastic/elasticsearch-specification'
+        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name != 'elastic/elasticsearch-specification'
         run: echo "Validation is not supported from forks"; exit 1
 
       - uses: actions/checkout@v4
         with:
           path: ./elasticsearch-specification
+          persist-credentials: false
 
       - uses: actions/checkout@v4
         with:
           repository: elastic/clients-flight-recorder
           path: ./clients-flight-recorder
           token: ${{ secrets.PAT }}
           ref: ${{ github.base_ref }}
+          persist-credentials: false
 
       - name: Use Node.js 22
         uses: actions/setup-node@v4
         with:
           node-version: 22
 
+      - name: Cache JSON report
+        id: cache-json-report
+        uses: actions/cache@v4
+        with:
+          path: ./clients-flight-recorder/recordings/types-validation/types-validation.json
+          key: types-validation-json-${{ github.event_name == 'pull_request' && format('{0}-{1}', github.head_ref, github.event.pull_request.base.sha) || format('{0}-{1}', github.ref_name, github.sha) }}
+          restore-keys: |
+            types-validation-json-${{ github.event_name == 'pull_request' && github.head_ref || github.ref_name }}-
+
       - name: Install deps 1/2
         working-directory: ./clients-flight-recorder
         run: |
@@ -61,12 +79,21 @@ jobs:
           node scripts/upload-recording/download.js --branch $branch --git
           node scripts/clone-elasticsearch/index.js --branch $branch
 
-      - name: Run validation
+      - name: Run validation (Push)
+        if: github.event_name == 'push'
+        working-directory: ./clients-flight-recorder/scripts/types-validator
+        env:
+          BRANCH: ${{ github.ref_name }}
+        run: node index.js --generate-report --ci --branch $BRANCH
+
+      - name: Run validation (PR)
+        if: github.event_name == 'pull_request'
         id: validation
         working-directory: ./elasticsearch-specification
         run: node .github/validate-pr --token ${{ secrets.GITHUB_TOKEN }}
 
       - name: Find existing comment
+        if: github.event_name == 'pull_request'
         uses: peter-evans/find-comment@3eae4d37986fb5a8592848f6a574fdf654e61f9e # v3.1.0
         id: find-comment
         with:
@@ -75,6 +102,7 @@ jobs:
           body-includes: 'Following you can find the validation changes'
 
       - name: Create or update comment
+        if: github.event_name == 'pull_request'
         uses: peter-evans/create-or-update-comment@71345be0265236311c031f5c7866368bd1eff043 # v4.0.0
         with:
           token: ${{ secrets.GITHUB_TOKEN }}