feat(docs): deploy main branch preview alongside PR previews

Extend the docs-preview workflow to also trigger on pushes to main,
deploying a continuously-updated preview at _preview/pr-main/ on
gh-pages. Rename the umbrella directory from pr-preview to _preview.

- Add push:main trigger with same path filters as pull_request
- Use conditional action inputs (deploy+no comment for main, auto for PRs)
- Scope concurrency per-ref with cancel-in-progress
- Update astro landing page regex for the new _preview path

Author: BYK

.github/workflows/docs-preview.yml

@@ -1,6 +1,14 @@
 name: Docs Preview
 
 on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'src/**'
+      - 'script/generate-command-docs.ts'
+      - 'script/generate-skill.ts'
+      - '.github/workflows/docs-preview.yml'
   pull_request:
     paths:
       - 'docs/**'
@@ -13,6 +21,10 @@ permissions:
   contents: write
   pull-requests: write
 
+concurrency:
+  group: docs-preview-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   preview:
     runs-on: ubuntu-latest
@@ -36,8 +48,9 @@ jobs:
       - name: Build Docs for Preview
         working-directory: docs
         env:
-          # Override base path for PR preview (no /cli prefix since preview domain is different)
-          DOCS_BASE_PATH: /pr-preview/pr-${{ github.event.pull_request.number }}
+          DOCS_BASE_PATH: ${{ github.event_name == 'push'
+            && '/_preview/pr-main'
+            || format('/_preview/pr-{0}', github.event.pull_request.number) }}
         run: |
           bun install --frozen-lockfile
           bun run build
@@ -78,6 +91,8 @@ jobs:
         with:
           source-dir: docs/dist/
           preview-branch: gh-pages
-          umbrella-dir: pr-preview
+          umbrella-dir: _preview
           pages-base-url: cli.sentry.dev
-          action: auto
+          action: ${{ github.event_name == 'push' && 'deploy' || 'auto' }}
+          pr-number: ${{ github.event_name == 'push' && 'main' || github.event.pull_request.number }}
+          comment: ${{ github.event_name != 'push' }}

docs/astro.config.mjs

@@ -69,7 +69,7 @@ export default defineConfig({
                 const path = window.location.pathname;
                 // Works with both / (prod) and /pr-preview/pr-XX (preview)
                 return path === '/' || 
-                       /^\\/pr-preview\\/pr-\\d+\\/?$/.test(path);
+                       /^\\/_preview\\/pr-(\\d+|main)\\/?$/.test(path);
               }
               
               function checkAtBottom() {