Update agent-docusarus-dev.yml

jtviolet · web-flow · commit 98f9e06507dd · 2025-06-17T17:31:48.000-04:00
diff --git a/.github/workflows/agent-docusarus-dev.yml b/.github/workflows/agent-docusarus-dev.yml
@@ -1,51 +1,34 @@
-name: Claude Code Documentation Review
+name: Docusaurus Project Evaluation
 
 on:
-  # Trigger on pull requests to main or dev branch
   pull_request:
     branches: 
       - main
       - dev
     paths-ignore:
       - '**.md'
       - '**.mdx'
-  
-  # Trigger on issue comments (for tagging)
-  issue_comment:
-    types: [created]
-  
-  # Trigger on PR review comments
-  pull_request_review_comment:
-    types: [created]
 
 jobs:
   claude-review:
-    # Only run if it's a PR or if the comment contains the trigger phrase
-    if: |
-      github.event_name == 'pull_request' || 
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude'))
-    
     runs-on: ubuntu-latest
     
     permissions:
       contents: read
       pull-requests: write
-      issues: write
     
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
-          fetch-depth: 0
+          fetch-depth: 2
       
       - name: Fetch system prompt from private repo
         id: fetch-prompt
         env:
-          GH_TOKEN: ${{ secrets.NETWRIX_PROMPT_REPO_TOKEN || secrets.GITHUB_TOKEN }}
+          GH_TOKEN: ${{ secrets.NETWRIX_PROMPT_REPO_TOKEN }}
         run: |
-          # Fetch the system prompt file from the private repository
-          echo "Fetching system prompt from netwrix/action-agent-prompts..."
+          echo "Fetching system prompt..."
           
           RESPONSE=$(curl -s -w "\n%{http_code}" \
                -H "Authorization: token $GH_TOKEN" \
@@ -56,199 +39,107 @@ jobs:
           CONTENT=$(echo "$RESPONSE" | head -n-1)
           
           if [ "$HTTP_CODE" != "200" ]; then
-            echo "Failed to fetch system prompt file (HTTP $HTTP_CODE)"
-            echo "Response: $CONTENT"
+            echo "Failed to fetch system prompt (HTTP $HTTP_CODE)"
             exit 1
           fi
           
-          # Save the content to a file
           echo "$CONTENT" > /tmp/system-prompt.md
-          
-          # Verify the file was created and has content
-          if [ ! -s /tmp/system-prompt.md ]; then
-            echo "System prompt file is empty"
-            exit 1
-          fi
-          
           echo "System prompt fetched successfully"
-          echo "File size: $(wc -c < /tmp/system-prompt.md) bytes"
-      
-      - name: Determine trigger context
-        id: context
-        run: |
-          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
-            echo "is_pr=true" >> $GITHUB_OUTPUT
-            echo "is_comment=false" >> $GITHUB_OUTPUT
-            echo "trigger_type=pull_request" >> $GITHUB_OUTPUT
-          else
-            echo "is_pr=false" >> $GITHUB_OUTPUT
-            echo "is_comment=true" >> $GITHUB_OUTPUT
-            echo "trigger_type=${{ github.event_name }}" >> $GITHUB_OUTPUT
-          fi
-      
-      - name: Extract comment prompt (if triggered by comment)
-        id: extract-prompt
-        if: steps.context.outputs.is_comment == 'true'
-        run: |
-          # Extract the comment after the trigger phrase
-          COMMENT="${{ github.event.comment.body }}"
-          # Remove @claude and trim whitespace
-          PROMPT=$(echo "$COMMENT" | sed 's/@claude//' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-          
-          # If prompt is empty after removing trigger, provide a default
-          if [ -z "$PROMPT" ]; then
-            PROMPT="Please review the changes in this PR and provide feedback on documentation-related aspects."
-          fi
-          
-          echo "comment_prompt<<EOF" >> $GITHUB_OUTPUT
-          echo "$PROMPT" >> $GITHUB_OUTPUT
-          echo "EOF" >> $GITHUB_OUTPUT
       
-      - name: Check for important file changes
+      - name: Check for Docusaurus changes
         id: check-files
-        if: steps.context.outputs.is_pr == 'true'
         run: |
-          # Get list of changed files
-          CHANGED_FILES=$(git diff --name-only origin/${{ github.base_ref }}...HEAD || git diff --name-only HEAD~1)
+          CHANGED_FILES=$(git diff --name-only HEAD~1)
           
-          # Check if docusaurus.config.js or sidebar files were modified
-          IMPORTANT_FILES=$(echo "$CHANGED_FILES" | grep -E "(docusaurus\.config\.js|.*sidebar.*\.js)" || true)
+          # Focus on Docusaurus infrastructure files
+          DOCUSAURUS_FILES=$(echo "$CHANGED_FILES" | grep -E "(docusaurus\.config\.js|sidebars?\.js|babel\.config\.js|package\.json|\.github/|src/)" || true)
           
-          # Check for any non-markdown changes
-          NON_MD_FILES=$(echo "$CHANGED_FILES" | grep -v -E "\.(md|mdx)$" || true)
-          
-          if [ -n "$IMPORTANT_FILES" ]; then
-            echo "has_important_changes=true" >> $GITHUB_OUTPUT
-            echo "### 🎯 Important Documentation Files Changed" >> $GITHUB_STEP_SUMMARY
-            echo '```' >> $GITHUB_STEP_SUMMARY
-            echo "$IMPORTANT_FILES" >> $GITHUB_STEP_SUMMARY
-            echo '```' >> $GITHUB_STEP_SUMMARY
+          if [ -z "$DOCUSAURUS_FILES" ]; then
+            echo "No Docusaurus infrastructure files changed. Skipping review."
+            echo "skip_review=true" >> $GITHUB_OUTPUT
           else
-            echo "has_important_changes=false" >> $GITHUB_OUTPUT
-          fi
-          
-          if [ -n "$NON_MD_FILES" ]; then
-            echo "### 📝 Non-Markdown Files Changed" >> $GITHUB_STEP_SUMMARY
+            echo "skip_review=false" >> $GITHUB_OUTPUT
+            echo "### 🎯 Docusaurus Files Changed" >> $GITHUB_STEP_SUMMARY
             echo '```' >> $GITHUB_STEP_SUMMARY
-            echo "$NON_MD_FILES" >> $GITHUB_STEP_SUMMARY
+            echo "$DOCUSAURUS_FILES" >> $GITHUB_STEP_SUMMARY
             echo '```' >> $GITHUB_STEP_SUMMARY
           fi
       
-      - name: Prepare review prompt
-        id: prepare-prompt
+      - name: Create review prompt
+        if: steps.check-files.outputs.skip_review != 'true'
         run: |
-          if [[ "${{ steps.context.outputs.is_pr }}" == "true" ]]; then
-            # For PRs, create a comprehensive review prompt
-            PROMPT="You are reviewing a pull request for a Docusaurus-based documentation site. "
-            
-            if [[ "${{ steps.check-files.outputs.has_important_changes }}" == "true" ]]; then
-              PROMPT+="IMPORTANT: This PR includes changes to critical configuration files (docusaurus.config.js and/or sidebar files). Please pay special attention to these changes. "
-            fi
-            
-            PROMPT+="Please review the changes and check for:
-            
-            1. **Configuration Integrity**: Ensure docusaurus.config.js changes are valid and won't break the build
-            2. **Sidebar Structure**: Verify sidebar configurations are properly formatted and all referenced docs exist
-            3. **Build Impact**: Identify any changes that might affect the documentation build process
-            4. **Link Validity**: Check that internal links and references are correct
-            5. **Best Practices**: Ensure changes follow Docusaurus best practices
-            6. **Performance**: Flag any changes that might impact site performance
-            
-            Focus primarily on non-markdown files that affect the documentation infrastructure.
-            
-            Provide specific, actionable feedback with code suggestions where appropriate."
-          else
-            # For comments, use the extracted prompt
-            PROMPT="${{ steps.extract-prompt.outputs.comment_prompt }}"
-          fi
-          
-          # Save prompt to file
-          echo "$PROMPT" > /tmp/review-prompt.txt
-          echo "Review prompt prepared successfully"
-          
-          # Read system prompt for append_system_prompt
-          SYSTEM_PROMPT=$(cat /tmp/system-prompt.md)
-          echo "system_prompt<<EOF" >> $GITHUB_OUTPUT
-          echo "$SYSTEM_PROMPT" >> $GITHUB_OUTPUT
-          echo "EOF" >> $GITHUB_OUTPUT
+          cat > /tmp/review-prompt.txt << 'EOF'
+          Review this pull request focusing exclusively on Docusaurus infrastructure and configuration files. 
+
+          Analyze changes to:
+          - docusaurus.config.js (site configuration, plugins, themes)
+          - sidebars.js (navigation structure)
+          - package.json (dependencies, scripts)
+          - Build configuration files
+          - Source code in src/ directory
+          - GitHub Actions workflows
+
+          For each issue found, provide:
+          1. Clear explanation of the problem
+          2. Specific code suggestion with reasoning
+          3. Potential impact on the documentation site
+
+          Ignore all .md and .mdx files - focus only on the technical infrastructure.
+          EOF
       
       - name: Run Claude Code Review
+        if: steps.check-files.outputs.skip_review != 'true'
         id: claude-review
         uses: anthropics/claude-code-base-action@beta
         with:
           prompt_file: /tmp/review-prompt.txt
-          append_system_prompt: ${{ steps.prepare-prompt.outputs.system_prompt }}
-          allowed_tools: ""  # Empty string allows all tools
+          append_system_prompt_file: /tmp/system-prompt.md
+          allowed_tools: "Read,Grep,Glob,LS"
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          timeout_minutes: "45"
-          max_turns: "150"
-          model: "claude-opus-4-20250514"
-      
-      - name: Generate GitHub App token (for commenting)
-        id: app-token
-        if: success() || failure()
-        uses: actions/create-github-app-token@v2
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID || vars.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
+          timeout_minutes: "15"
+          max_turns: "20"
+          model: "claude-3-opus-20240229"
       
       - name: Post review summary
-        if: (success() || failure()) && steps.context.outputs.is_pr == 'true'
+        if: steps.claude-review.conclusion == 'success'
         uses: actions/github-script@v7
         with:
-          github-token: ${{ steps.app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          github-token: ${{ secrets.NETWRIX_PROMPT_REPO_TOKEN }}
           script: |
             const fs = require('fs');
             const executionFile = '${{ steps.claude-review.outputs.execution_file }}';
             
-            let reviewContent = '';
-            let status = '${{ steps.claude-review.outputs.conclusion }}';
+            if (!fs.existsSync(executionFile)) {
+              console.log('No execution file found');
+              return;
+            }
             
-            if (status === 'success' && fs.existsSync(executionFile)) {
-              try {
-                const executionLog = JSON.parse(fs.readFileSync(executionFile, 'utf8'));
-                
-                // Find the last assistant message which should contain the review
-                for (let i = executionLog.length - 1; i >= 0; i--) {
-                  if (executionLog[i].role === 'assistant' && executionLog[i].content) {
-                    reviewContent = executionLog[i].content;
-                    break;
-                  }
+            try {
+              const executionLog = JSON.parse(fs.readFileSync(executionFile, 'utf8'));
+              
+              // Get Claude's final response
+              let reviewContent = '';
+              for (let i = executionLog.length - 1; i >= 0; i--) {
+                if (executionLog[i].role === 'assistant' && executionLog[i].content) {
+                  reviewContent = executionLog[i].content;
+                  break;
                 }
-              } catch (error) {
-                console.error('Error parsing execution log:', error);
-                reviewContent = 'Error: Could not parse Claude\'s response.';
               }
-            } else if (status === 'failure') {
-              reviewContent = '⚠️ The review could not be completed. Please check the action logs for details.';
+              
+              const summary = `## 🤖 Claude Docusaurus Review
+              
+              ${reviewContent}
+              
+              ---
+              <sub>Automated review by Claude Code</sub>`;
+              
+              await github.rest.issues.createComment({
+                issue_number: context.issue.number,
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                body: summary
+              });
+              
+            } catch (error) {
+              console.error('Error processing review:', error);
             }
-            
-            const summary = `## 🤖 Claude Documentation Review
-            
-            ${reviewContent || 'No review content was generated.'}
-            
-            ---
-            <sub>Generated by Claude Code Documentation Review Action</sub>`;
-            
-            await github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: summary
-            });
-      
-      - name: Add workflow summary
-        if: always()
-        run: |
-          echo "## 📊 Claude Review Summary" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "- **Trigger Type**: ${{ steps.context.outputs.trigger_type }}" >> $GITHUB_STEP_SUMMARY
-          echo "- **Review Status**: ${{ steps.claude-review.outputs.conclusion || 'Not completed' }}" >> $GITHUB_STEP_SUMMARY
-          echo "- **Important Files Changed**: ${{ steps.check-files.outputs.has_important_changes || 'N/A' }}" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          
-          if [ -f "${{ steps.claude-review.outputs.execution_file }}" ]; then
-            echo "✅ Review completed. Check the PR comments for Claude's feedback." >> $GITHUB_STEP_SUMMARY
-          else
-            echo "❌ Review did not complete successfully." >> $GITHUB_STEP_SUMMARY
-          fi
