ci: fix agent docs generation and remove PR Pages deployment

Author: briandominick

.github/workflows/main.yml

@@ -56,11 +56,10 @@ jobs:
       - name: Install dependencies
         run: bundle install
 
-      - name: Generate agent docs
-        run: bundle exec rake labdev:sync:docs
-
-      - name: Build gem package
-        run: bundle exec rake gemdo:build_gem
+      - name: Build site and gem
+        run: |
+          bundle exec rake build_site
+          bundle exec rake gemdo:build_gem
 
       - name: Upload site artifact
         uses: actions/upload-artifact@v4
@@ -76,48 +75,32 @@ jobs:
           path: gems/docopslab-dev/pkg/*.gem
           retention-days: 30
 
-  # Deploy staging preview for PRs
-  deploy-staging:
-    name: Deploy PR Preview
+  # PR artifacts comment
+  pr-artifacts:
+    name: PR Artifacts
     if: github.event_name == 'pull_request'
     needs: build-site
     runs-on: ubuntu-latest
-    environment:
-      name: pr-preview-${{ github.event.pull_request.number }}
-      url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - name: Download site artifact
-        uses: actions/download-artifact@v4
-        with:
-          name: site-${{ github.sha }}
-          path: _site
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v4
-
-      - name: Upload to Pages
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: _site
-
-      - name: Deploy to GitHub Pages (Preview)
-        id: deployment
-        uses: actions/deploy-pages@v4
-
-      - name: Comment PR with preview URL
+      - name: Comment PR with artifact info
         uses: actions/github-script@v7
         with:
           script: |
-            const url = '${{ steps.deployment.outputs.page_url }}';
-            const body = `## 🚀 Preview Deployment Ready!
+            const body = `## ✅ Build Complete!
+            
+            Your changes have been built successfully. Download the artifacts to review:
             
-            Your changes have been deployed to a preview environment:
+            - **Site Build**: Available in workflow artifacts as \`site-${{ github.sha }}\`
+            - **Gem Package**: Available in workflow artifacts as \`gem-${{ github.sha }}\`
             
-            **Preview URL:** ${url}
+            To preview the site locally:
+            \`\`\`bash
+            SHA=${{ github.sha }} GITHUB_TOKEN=<your-token> bundle exec rake review:serve
+            \`\`\`
             
-            This preview will be updated automatically with new commits to this PR.
+            This will automatically fetch, extract, and serve the review site at http://localhost:4001
             
-            ℹ️ Preview deployments are temporary and will be removed after the PR is merged or closed.`;
+            This build will be updated automatically with new commits to this PR.`;
             
             github.rest.issues.createComment({
               issue_number: context.issue.number,