omarchy-pkgs/.github/workflows/sync-upstream.yml

name: Sync Upstream Releases

on:
  schedule:
    # Every 6 hours, off the hour to dodge the scheduling backlog at :00
    - cron: '20 */6 * * *'
  workflow_dispatch:
    inputs:
      packages:
        description: 'Specific packages to update (space-separated, leave empty for all)'
        required: false
        default: ''

jobs:
  sync:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          persist-credentials: false

      # Runs in an Arch container for vercmp: whether a release is an upgrade has
      # to be decided by the same comparator pacman will use on users' machines.
      - name: Update packages from upstream release feeds
        id: sync
        run: |
          docker run --rm \
            -e PACKAGES="$PACKAGES" \
            -e UPSTREAM_GITHUB_TOKEN="$UPSTREAM_GITHUB_TOKEN" \
            -e HOST_UID="$(id -u)" \
            -e HOST_GID="$(id -g)" \
            -v "$PWD/bin:/workspace/bin:ro" \
            -v "$PWD/helpers:/workspace/helpers:ro" \
            -v "$PWD/pkgbuilds:/workspace/pkgbuilds" \
            -w /workspace \
            archlinux:base-devel bash -lc '
              set -euo pipefail

              pacman -Syu --noconfirm git jq python libarchive

              groupadd -g "$HOST_GID" runner
              useradd -m -u "$HOST_UID" -g "$HOST_GID" runner
              chown -R runner:runner /workspace/pkgbuilds

              # The reviewed lane only: packages marked auto_merge ride
              # track-branches.yml, which merges without a human.
              if [[ -n "${PACKAGES:-}" ]]; then
                read -r -a package_args <<< "$PACKAGES"
                runuser -u runner -- ./bin/sync-upstream --lane reviewed "${package_args[@]}"
              else
                runuser -u runner -- ./bin/sync-upstream --lane reviewed
              fi
            '
        env:
          PACKAGES: ${{ github.event.inputs.packages }}
          UPSTREAM_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      # Failed feeds leave their recipes untouched; completed updates still
      # reach review. The failed sync step keeps the workflow red and notifies.
      - name: Check for changes
        if: ${{ !cancelled() && steps.sync.outcome != 'skipped' }}
        id: changes
        run: |
          if [ -z "$(git status --porcelain)" ]; then
            echo "has_changes=false" >> "$GITHUB_OUTPUT"
          else
            echo "has_changes=true" >> "$GITHUB_OUTPUT"
          fi

      # A PR opened with GITHUB_TOKEN gets its build and test runs held
      # until a maintainer clicks "Approve workflows to run"; one opened by
      # the App builds on its own, so the reviewer sees a green (or red) PR
      # instead of a pending one. The App only opens the PR: merging stays
      # a human decision in this lane.
      - name: Mint the bot token
        if: ${{ !cancelled() && steps.changes.outputs.has_changes == 'true' }}
        id: app
        env:
          PKGS_BOT_APP_ID: ${{ secrets.PKGS_BOT_APP_ID }}
        # Without the App configured this falls back to GITHUB_TOKEN below,
        # which still opens the PR; a maintainer then has to approve its
        # workflow runs by hand, as before.
        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
        with:
          app-id: ${{ secrets.PKGS_BOT_APP_ID }}
          private-key: ${{ secrets.PKGS_BOT_PRIVATE_KEY }}
        continue-on-error: true

      - name: Create Pull Request
        if: ${{ !cancelled() && steps.changes.outputs.has_changes == 'true' }}
        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
        with:
          token: ${{ steps.app.outputs.token || secrets.GITHUB_TOKEN }}
          commit-message: 'chore: sync upstream releases'
          title: 'chore: sync upstream releases'
          body: |
            Automated update of packages that track an upstream vendor release
            feed rather than the AUR.

            Release watches and providers are declared in `.omarchy/package.json`;
            exceptional feeds use `.omarchy/upstream.sh`. Failed package updates
            are left untouched; check the workflow result for outstanding failures.
          branch: auto/sync-upstream
          delete-branch: true
          labels: automated
          reviewers: ryanrhughes

      - name: Notify Basecamp on failure
        if: failure() && env.BASECAMP_CHATBOT_URL != ''
        env:
          BASECAMP_CHATBOT_URL: ${{ secrets.BASECAMP_CHATBOT_URL }}
        run: |
          curl -s -o /dev/null \
            -H "Content-Type: application/json" \
            -d "$(jq -n --arg content \
              "🔴 <strong>Upstream sync failed</strong><br><a href=\"${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\">View run</a>" \
              '{content: $content}')" \
            "$BASECAMP_CHATBOT_URL"