Merge remote-tracking branch 'origin/feat-api-spec-validator' into feat-api-spec-validator

Author: prkhrkat

.github/workflows/api-spec-merger.yaml

@@ -6,7 +6,7 @@ on:
       - 'specs/**'
 
 permissions:
-  contents: write  # This is correct and grants the necessary permissions.
+  contents: write
 
 jobs:
   lint-and-bundle:
@@ -15,20 +15,40 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
-          fetch-depth: 0
           ref: ${{ github.ref }}
 
       - name: Set up Redocly CLI
         run: npm install -g @redocly/cli
 
       - name: Run specs bundling script
+        working-directory: ${{ github.workspace }}
         run: |
-          chmod +x scripts/generate-api-docs.sh 
-          scripts/generate-api-docs.sh 
+          chmod +x scripts/generate-api-docs.sh
+          ./scripts/generate-api-docs.sh
 
-      - name: Commit and push changes
-        uses: ad-m/github-push-action@master
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }} # Use the correct, built-in secret
-          branch: ${{ github.ref }}
-          message: "docs: generate API documentation"
+      - name: Commit and push documentation
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "GitHub Action"
+
+          # Fetch the gh-pages-test branch
+          git fetch origin gh-pages-test
+
+          # Create a separate worktree for the branch
+          git worktree add /tmp/gh-pages-test gh-pages-test
+
+          # Copy generated docs into the worktree
+          mkdir -p /tmp/gh-pages-test/docs/api-docs
+          cp -r docs/api-docs/* /tmp/gh-pages-test/docs/api-docs/ || true
+
+          cd /tmp/gh-pages-test
+
+          git add .
+          if git diff --staged --quiet; then
+            echo "✅ No changes to commit"
+          else
+            git commit -m "📄 Update API documentation"
+            git push origin gh-pages-test
+            echo "🚀 Documentation pushed to gh-pages-test branch!"
+          fi
+