chore: add docs deploy workflow

Author: sergeyshmakov

.github/workflows/deploy-docs.yml

@@ -3,7 +3,9 @@ name: Deploy Docs
 on:
   push:
     branches: [main]
-    paths: ["docs/**"]
+    paths:
+      - "docs/**"
+      - ".github/workflows/deploy-docs.yml"
   workflow_dispatch:
 
 permissions:
@@ -26,7 +28,7 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-node@v4
         with:
-          node-version: lts/*
+          node-version: 24.14.0
       - name: Install dependencies
         working-directory: docs
         run: npm ci
@@ -47,3 +49,23 @@ jobs:
     steps:
       - id: deployment
         uses: actions/deploy-pages@v4
+      - name: Refresh root sitemap
+        env:
+          GH_TOKEN: ${{ secrets.PAGES_REFRESH_TOKEN }}
+          PAGE_URL: ${{ steps.deployment.outputs.page_url }}
+          SOURCE_REPOSITORY: ${{ github.repository }}
+          SOURCE_RUN_ID: ${{ github.run_id }}
+          SOURCE_SHA: ${{ github.sha }}
+        run: |
+          if [ -z "$GH_TOKEN" ]; then
+            echo "PAGES_REFRESH_TOKEN is not configured; skipping root sitemap refresh."
+            exit 0
+          fi
+
+          curl -fsSL \
+            -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer $GH_TOKEN" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            https://api.github.com/repos/sergeyshmakov/sergeyshmakov.github.io/dispatches \
+            -d "{\"event_type\":\"project-docs-deployed\",\"client_payload\":{\"repository\":\"$SOURCE_REPOSITORY\",\"page_url\":\"$PAGE_URL\",\"run_id\":\"$SOURCE_RUN_ID\",\"sha\":\"$SOURCE_SHA\"}}"