test: verify SDK docs token

Author: rodnnnney

.github/workflows/test-docs-token.yml

@@ -0,0 +1,59 @@
+name: Test SDK docs token
+
+on:
+  push:
+    branches:
+      - codex/test-sdk-docs-token-20260720122015
+
+permissions: {}
+
+jobs:
+  create-and-clean-up-demo2-pr:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Verify branch and pull-request access
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT }}
+          TEST_BRANCH: automation/test-sdk-docs-token-${{ github.run_id }}
+        run: |
+          set -euo pipefail
+          test -n "$GH_TOKEN" || {
+            echo "::error::GH_PAT is not configured."
+            exit 1
+          }
+
+          PR_NUMBER=""
+          cleanup() {
+            set +e
+            if [ -n "$PR_NUMBER" ]; then
+              gh pr close "$PR_NUMBER" --repo TextQLLabs/demo2 >/dev/null 2>&1
+            fi
+            gh api --method DELETE \
+              "repos/TextQLLabs/demo2/git/refs/heads/${TEST_BRANCH}" \
+              >/dev/null 2>&1
+          }
+          trap cleanup EXIT
+
+          MAIN_SHA=$(gh api repos/TextQLLabs/demo2/git/ref/heads/main --jq '.object.sha')
+          gh api --method POST repos/TextQLLabs/demo2/git/refs \
+            -f ref="refs/heads/${TEST_BRANCH}" \
+            -f sha="$MAIN_SHA" >/dev/null
+
+          CONTENT=$(printf '%s\n' \
+            'Temporary file used to verify SDK docs automation access.' \
+            | base64 -w 0)
+          gh api --method PUT \
+            repos/TextQLLabs/demo2/contents/.github/sdk-docs-token-test.md \
+            -f message='test: verify SDK docs automation access' \
+            -f content="$CONTENT" \
+            -f branch="$TEST_BRANCH" >/dev/null
+
+          PR_URL=$(gh pr create \
+            --repo TextQLLabs/demo2 \
+            --base main \
+            --head "$TEST_BRANCH" \
+            --draft \
+            --title 'test: verify SDK docs automation access' \
+            --body 'Temporary automated test. This PR is closed and its branch deleted by the same workflow.')
+          PR_NUMBER=${PR_URL##*/}
+          echo "Successfully created ${PR_URL}; cleaning it up now."