Update doc-sync (#1763)

Author: tarrencev

.github/workflows/docs-sync.yml

@@ -35,7 +35,7 @@ jobs:
         run: |
           # Check if changes require documentation updates
           NEEDS_DOCS_UPDATE=false
-          
+
           # Define patterns that typically require docs updates
           DOCS_PATTERNS=(
             "^src/.*\.ts$"
@@ -49,7 +49,7 @@ jobs:
             "^api/"
             "^schema/"
           )
-          
+
           while IFS= read -r file; do
             for pattern in "${DOCS_PATTERNS[@]}"; do
               if [[ $file =~ $pattern ]]; then
@@ -58,7 +58,7 @@ jobs:
               fi
             done
           done <<< "${{ steps.changed-files.outputs.changed_files }}"
-          
+
           echo "needs_update=$NEEDS_DOCS_UPDATE" >> $GITHUB_OUTPUT
           echo "Files that may need docs updates: ${{ steps.changed-files.outputs.changed_files }}"
 
@@ -70,13 +70,13 @@ jobs:
           token: ${{ secrets.CREATE_PR_TOKEN }}
           path: docs-repo
 
-      - name: Analyze changes and create docs PR
+      - name: Analyze changes and update docs
         if: steps.check-docs.outputs.needs_update == 'true'
         uses: anthropics/claude-code-action@beta
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           direct_prompt: |
-            I need you to analyze the changes in this controller repository PR and determine if the documentation in the cartridge-gg/docs repository needs to be updated.
+            I need you to analyze the changes in this controller repository PR and update the documentation in the cartridge-gg/docs repository accordingly.
 
             **PR Information:**
             - Title: ${{ github.event.pull_request.title }}
@@ -88,25 +88,65 @@ jobs:
             2. Check the docs-repo directory to see what documentation currently exists
             3. Determine if any existing documentation needs updates or if new documentation should be created
             4. If updates are needed:
-               - Create or update the appropriate documentation files
+               - Create or update the appropriate documentation files in the docs-repo directory
                - Ensure the documentation accurately reflects the current state of the controller
                - Follow the existing documentation style and structure
-               - Create a new branch in the docs repo
-               - Commit the changes with a descriptive message
-               - Create a pull request in the docs repository
+               - Focus on user-facing changes, API changes, new features, or breaking changes
 
             **Important guidelines:**
             - Only create documentation updates if they are actually needed
-            - Focus on user-facing changes, API changes, new features, or breaking changes
             - Don't document internal implementation details unless they affect usage
             - If no documentation updates are needed, simply state that and exit
+            - DO NOT create git branches, commits, or PRs - just update the files
+
+            The docs repository is checked out in the `docs-repo` directory. Please analyze the controller changes and update the documentation files accordingly.
+
+          allowed_tools: "Read,Write,Edit,MultiEdit,Glob,Grep"
+
+      - name: Create branch and commit changes
+        if: steps.check-docs.outputs.needs_update == 'true'
+        working-directory: docs-repo
+        run: |
+          # Configure git
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Check if there are any changes
+          if [ -n "$(git status --porcelain)" ]; then
+            # Create new branch
+            BRANCH_NAME="docs-update-$(date +%s)"
+            git checkout -b "$BRANCH_NAME"
+            
+            # Add and commit changes
+            git add .
+            git commit -m "docs: Update documentation for controller PR #${{ github.event.pull_request.number }}
 
-            The docs repository is checked out in the `docs-repo` directory. Please analyze the controller changes and update the documentation accordingly.
+            Updates documentation to reflect changes made in:
+            ${{ github.event.pull_request.title }}
+            
+            Related controller PR: cartridge-gg/controller#${{ github.event.pull_request.number }}"
+            
+            # Push branch
+            git push origin "$BRANCH_NAME"
+            
+            # Create PR
+            gh pr create \
+              --title "docs: Update documentation for controller PR #${{ github.event.pull_request.number }}" \
+              --body "This PR updates the documentation to reflect changes made in cartridge-gg/controller#${{ github.event.pull_request.number }}
+
+            **Original PR Details:**
+            - Title: ${{ github.event.pull_request.title }}
+            - Files changed: ${{ steps.changed-files.outputs.changed_files }}
 
-          allowed_tools: "Bash(git *),Bash(cd *),Read,Write,Edit,MultiEdit,Glob,Grep"
+            Please review the documentation changes to ensure they accurately reflect the controller updates."
+          else
+            echo "No documentation changes were made by Claude"
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.CREATE_PR_TOKEN }}
 
       - name: Cleanup
         if: always()
         run: |
           # Clean up any temporary files or directories
-          rm -rf docs-repo || true
+          rm -rf docs-repo || true