Update workflows with action improvements and additions

.github/workflows/annotate.yml

@@ -0,0 +1,59 @@
+name: annotate
+
+on:
+  pull_request:
+    branches: [ "*" ]
+
+jobs:
+  update-docblocks:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install jq
+        run: sudo apt-get install -y jq
+
+      - name: Extract homepage from composer.json
+        id: composer
+        run: |
+          if [ -f "composer.json" ]; then
+            HOMEPAGE=$(jq -r '.homepage // empty' composer.json)
+            if [ ! -z "$HOMEPAGE" ]; then
+              echo "homepage=$HOMEPAGE" >> $GITHUB_OUTPUT
+            else
+              echo "Error: homepage not found in composer.json"
+              exit 1
+            fi
+          else
+            echo "Error: composer.json not found"
+            exit 1
+          fi
+
+      - name: Run DocBlock Annotator
+        run: docker run -v ${{ github.workspace }}/src:/app/run --rm davidsmith3/docblock-annotator-cli docblock-annotator-cli:update /app/run "@link ${{ steps.composer.outputs.homepage }}"
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit changes
+        if: steps.git-check.outputs.changes == 'true'
+        run: |
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+          git add .
+          git commit -m "Update docblocks."
+          git pull --rebase origin ${{ github.head_ref }}
+          git push origin HEAD:${{ github.head_ref }}

.github/workflows/backwards_compatibility.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     continue-on-error: ${{ github.event.pull_request.base.ref != 'main' }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Set safe directory

.github/workflows/build_docker_image.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
 

.github/workflows/composer_require_checker.yml

@@ -14,7 +14,7 @@ jobs:
         php-version: [ "8.2" ]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Set safe directory

.github/workflows/release.yml

@@ -12,7 +12,7 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
 

.github/workflows/test.yml

@@ -15,7 +15,7 @@ jobs:
         php-version: [ "8.2" ]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Create .env
         run: touch .env