Enhance GitHub Actions workflow by adding permissions and token validation step for improved documentation sync reliability

Author: Thavarshan

.github/workflows/sync-docs.yml

@@ -15,6 +15,10 @@ on:
         default: false
         type: boolean
 
+permissions:
+  contents: read
+  actions: read
+
 jobs:
   sync-docs:
     runs-on: ubuntu-latest
@@ -32,6 +36,21 @@ jobs:
           git config --global user.name "docs-sync-bot"
           git config --global user.email "bot@altus4.dev"
 
+      - name: Validate token access
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+        run: |
+          if [ -z "$GH_TOKEN" ]; then
+            echo "❌ GH_TOKEN is not set or is empty"
+            exit 1
+          else
+            echo "✅ GH_TOKEN is set"
+            # Test token by making a simple API call
+            curl -s -H "Authorization: token $GH_TOKEN" \
+                 -H "Accept: application/vnd.github.v3+json" \
+                 https://api.github.com/user | jq -r '.login // "Token validation failed"'
+          fi
+
       - name: Check for docs changes
         id: check_changes
         run: |
@@ -63,7 +82,7 @@ jobs:
       - name: Sync to docs repository
         if: steps.check_changes.outputs.has_changes == 'true'
         env:
-          DOCS_REPO_TOKEN: ${{ secrets.DOCS_SYNC_TOKEN }}
+          DOCS_REPO_TOKEN: ${{ secrets.GH_TOKEN }}
         run: |
           # Configuration
           DOCS_REPO_URL="https://x-access-token:${DOCS_REPO_TOKEN}@github.com/altus4/docs.git"