fix: deployment pipeline (#81)

Remove auto-trigger-code-samples and instead run generate-code-samples
every 4 hours.

The previous setup would trigger generate-code-samples, but none of the
downstream workflows (the next one being .github/workflows/deploy-pages.yml).

The rules for GitHub are as follows:

If workflow A triggers workflow B in a way that is "automated", then B
will run but its completion will not trigger downstream workflows C.

"automated" here is determined by the use of `GITHUB_TOKEN`

    gh workflow run generate-code-samples.yml

implicitly uses `GITHUB_TOKEN`.

The current setup means that most of the pipeline runs redundantly (e.g.
we will generate code samples and check them in even with no changes) up
until the glean developer site's trigger-redeploy.yml[^1] which exits
early if there are no changes.

[1]: https://github.com/gleanwork/glean-developer-site/blob/8fa1fb6cfb44c457ed135eca678d7a9da82af4f4/.github/workflows/trigger-redeploy.yml#L1-L115

Author: david-hamilton-glean

.github/workflows/auto-trigger-code-samples.yml

@@ -3,10 +3,14 @@ name: Generate Code Samples
 on:
   workflow_dispatch:
 
+  # Run every 4 hours to check if all client releases are ready
+  schedule:
+    - cron: '0 */4 * * *'
+
 permissions:
   contents: write
 jobs:
-  generate-samples:
+  check-and-generate-samples:
     runs-on: macos-latest
 
     steps:
@@ -24,25 +28,41 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      - name: Check if all client releases have matching SHAs
+        id: check
+        run: |
+          if pnpm run check-client-releases; then
+            echo "clients_ready=true" >> $GITHUB_OUTPUT
+          else
+            echo "clients_ready=false" >> $GITHUB_OUTPUT
+          fi
+        env:
+          GH_TOKEN: ${{ github.token }}
+
       - name: Generate client code samples
+        if: github.event_name == 'workflow_dispatch' || steps.check.outputs.clients_ready == 'true'
         run: speakeasy run -s glean-client-merged-code-samples-spec
         env:
           SPEAKEASY_API_KEY: ${{ secrets.SPEAKEASY_API_KEY }}
 
       - name: Generate indexing code samples
+        if: github.event_name == 'workflow_dispatch' || steps.check.outputs.clients_ready == 'true'
         run: speakeasy run -s glean-index-merged-code-samples-spec
         env:
           SPEAKEASY_API_KEY: ${{ secrets.SPEAKEASY_API_KEY }}
 
       - name: Running code sample transformers
+        if: github.event_name == 'workflow_dispatch' || steps.check.outputs.clients_ready == 'true'
         run: pnpm transform:merged_code_samples_specs
 
       - name: Copy specs into final_specs
+        if: github.event_name == 'workflow_dispatch' || steps.check.outputs.clients_ready == 'true'
         run: |
           cp -r ./modified_code_samples_specs/client_rest.yaml ./final_specs/client_rest.yaml
           cp -r ./modified_code_samples_specs/indexing.yaml ./final_specs/indexing.yaml
 
       - name: Commit changes
+        if: github.event_name == 'workflow_dispatch' || steps.check.outputs.clients_ready == 'true'
         uses: ./.github/actions/git-commit
         with:
           commit_message: 'Update code samples'

.github/workflows/generate-code-samples.yml

@@ -213,9 +213,10 @@ In order to roll out changes from the upstream original source repo all the way
    - [gleanwork/api-client-typescript](https://github.com/gleanwork/api-client-typescript)
    - [gleanwork/api-client-go](https://github.com/gleanwork/api-client-go)
 7. 🤖CI in each of the API Client repos releases to their respective package managers
-8. 🤖[auto-trigger-code-samples.yml](https://github.com/gleanwork/open-api/actions/workflows/auto-trigger-code-samples.yml) checks every 4 hours if all API Client releases match the expected SHA, and triggers [generate-code-samples.yml](https://github.com/gleanwork/open-api/actions/workflows/generate-code-samples.yml) when ready
+8. 🤖[generate-code-samples.yml](https://github.com/gleanwork/open-api/actions/workflows/generate-code-samples.yml) checks every 4 hours if all API Client releases match the expected SHA and regenerates code samples if they do
 9. 🤖CI in this repo runs the [deploy-pages.yml](https://github.com/gleanwork/open-api/actions/workflows/deploy-pages.yml) workflow to deploy the final specs to GitHub Pages
 10. 🤖CI in this repo runs [trigger-developer-site-redeploy.yml](https://github.com/gleanwork/open-api/actions/workflows/trigger-developer-site-redeploy.yml)
-11. 🤖CI in [gleanwork/glean-developer-site](https://github.com/gleanwork/glean-developer-site) publishes a PR to update the developer site
-12. 👷Merge the [gleanwork/glean-developer-site](https://github.com/gleanwork/glean-developer-site) PR from step 11
-13. 🤖Vercel [redeploys developers.glean.com](https://vercel.com/glean-developers/glean-developer-site)
+    - `trigger-developer-site-redeploy` checks for changes and aborts early if there are none
+    - otherwise it publishes a PR to [gleanwork/glean-developer-site](https://github.com/gleanwork/glean-developer-site)
+11. 👷Merge the [gleanwork/glean-developer-site](https://github.com/gleanwork/glean-developer-site) PR from step 11
+12. 🤖Vercel [redeploys developers.glean.com](https://vercel.com/glean-developers/glean-developer-site)