feat(ci): add Cloudflare staging & cleanup workflows and update PR build testing

• Added new workflow (.github/workflows/cleanup-cloudflare.yaml) to cleanup staging on PR closure using static-site-tools.
• Introduced a staging deployment workflow (.github/workflows/stage-cloudflare.yaml) that deploys to Cloudflare upon successful PR builds.
• Refactored PR build testing (.github/workflows/pr-build-testing.yml) by replacing manual Hugo and Dart Sass installation with the static-site-tools Hugo build action and adjusting artifact handling.

Author: ethanholz

.github/workflows/cleanup-cloudflare.yaml

@@ -0,0 +1,16 @@
+name: Cleanup staging
+description: Cleanup staging environment; this occurs on PR merge or close
+
+on:
+  pull_request:
+    types: [closed]
+
+jobs:
+  cleanup-staging:
+    uses: omsf/static-site-tools/.github/workflows/cleanup-cloudflare.yaml@main
+    with:
+      pr_number: ${{ github.event.pull_request.number }}
+      project_name: ${{ vars.CLOUDFLARE_PROJECT_NAME }}
+    secrets:
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

.github/workflows/pr-build-testing.yml

@@ -10,31 +10,28 @@ jobs:
     env:
       HUGO_VERSION: 0.141.0
     steps:
-      - name: Install Hugo CLI
-        run: |
-          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
-          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
-      - name: Install Dart Sass
-        run: sudo snap install dart-sass
       - name: Checkout
         uses: actions/checkout@v4
         with:
           submodules: recursive
           fetch-depth: 0
       - name: Install Node.js dependencies
         run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
-      - name: Build with Hugo
-        env:
-          HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
-          HUGO_ENVIRONMENT: production
-          TZ: America/Los_Angeles
-        run: |
-          hugo \
-            --gc \
-            --minify
+
+      - name: Build site
+        uses: omsf/static-site-tools/build/hugo@main
+        with:
+          base-url: ""
+
+      - name: Make artifact
+        shell: bash
+        run: tar czf site.tar.gz docs
+
       - name: Upload build artifact
+        if: ${{ github.event_name != 'schedule' }}
         uses: actions/upload-artifact@v4
         with:
           name: pr-preview-${{ github.event.pull_request.number }}
-          path: ./docs
-          retention-days: 7
+          path: site.tar.gz
+          if-no-files-found: error
+          retention-days: 1

.github/workflows/stage-cloudflare.yaml

@@ -0,0 +1,34 @@
+name: Upload to staging
+on:
+  workflow_run:
+    workflows: ["PR Build Test"]
+    types:
+      - completed
+jobs:
+  get-metadata:
+    runs-on: ubuntu-latest
+    outputs:
+      pr_number: ${{ steps.pr-metadata.outputs.pr-number }}
+      pr_headsha: ${{ steps.pr-metadata.outputs.pr-headsha }}
+    steps:
+      - name: Get PR metadata from action
+        id: pr-metadata
+        uses: omsf/static-site-tools/pr-info-from-workflow-run@main
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+  stage:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    needs: get-metadata
+    uses: omsf/static-site-tools/.github/workflows/stage-cloudflare.yaml@main
+    permissions:
+      statuses: write
+      pull-requests: write
+    with:
+      run-id: ${{ github.event.workflow_run.id }}
+      pr-number: ${{ fromJSON(needs.get-metadata.outputs.pr_number) }} # convert to int
+      pr-headsha: ${{ needs.get-metadata.outputs.pr_headsha }}
+      project-name: ${{ vars.CLOUDFLARE_PROJECT_NAME }}
+      html-dir: _site
+    secrets:
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}