From 90dc71a8d7d59eaaba2d01f2451801dd470b9ccf Mon Sep 17 00:00:00 2001
From: jth-nw <james.haytko@netwrix.com>
Date: Thu, 12 Mar 2026 15:22:18 -0500
Subject: [PATCH] fix: cap Vale inline comments at 25 to avoid GitHub rate
 limits

Post first 25 Vale issues as inline comments and overflow the rest into
a collapsible details section in the review body. Applies to both the
initial review and post-fix re-run.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .github/workflows/claude-doc-pr.yml | 39 +++++++++++++++++++++++------
 1 file changed, 32 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/claude-doc-pr.yml b/.github/workflows/claude-doc-pr.yml
index b7378f0ed6..c95ce1db3b 100644
--- a/.github/workflows/claude-doc-pr.yml
+++ b/.github/workflows/claude-doc-pr.yml
@@ -111,11 +111,23 @@ jobs:
           echo "vale_count=$VALE_COUNT" >> "$GITHUB_OUTPUT"
 
           if [ "$VALE_COUNT" -gt 0 ]; then
-            echo "Posting $VALE_COUNT Vale inline comments"
-            # Post as a PR review with inline comments
+            MAX_INLINE=25
+            INLINE_COMMENTS=$(echo "$COMMENTS_JSON" | jq ".[:$MAX_INLINE]")
+            OVERFLOW=$((VALE_COUNT - MAX_INLINE))
+            if [ "$OVERFLOW" -lt 0 ]; then OVERFLOW=0; fi
+
+            if [ "$OVERFLOW" -gt 0 ]; then
+              OVERFLOW_MD=$(echo "$COMMENTS_JSON" | jq -r ".[$MAX_INLINE:][] | \"- **\(.path)** line \(.line): \(.body)\"")
+              REVIEW_BODY=$(printf "**Vale found %d issue(s).** First %d shown as inline comments.\n\n<details>\n<summary>%d more issue(s)</summary>\n\n%s\n\n</details>" \
+                "$VALE_COUNT" "$MAX_INLINE" "$OVERFLOW" "$OVERFLOW_MD")
+            else
+              REVIEW_BODY="**Vale found ${VALE_COUNT} issue(s).** See inline comments below."
+            fi
+
+            echo "Posting $VALE_COUNT Vale issues ($MAX_INLINE inline, $OVERFLOW overflow)"
             jq -n \
-              --arg body "**Vale found ${VALE_COUNT} issue(s).** See inline comments below." \
-              --argjson comments "$COMMENTS_JSON" \
+              --arg body "$REVIEW_BODY" \
+              --argjson comments "$INLINE_COMMENTS" \
               '{"body": $body, "event": "COMMENT", "comments": $comments}' \
               | gh api repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/reviews \
                   --input - 2>&1
@@ -411,10 +423,23 @@ jobs:
           done <<< "$CHANGED_MD_FILES"
 
           if [ "$VALE_COUNT" -gt 0 ]; then
-            echo "Vale still found $VALE_COUNT issue(s) after fixes"
+            MAX_INLINE=25
+            INLINE_COMMENTS=$(echo "$COMMENTS_JSON" | jq ".[:$MAX_INLINE]")
+            OVERFLOW=$((VALE_COUNT - MAX_INLINE))
+            if [ "$OVERFLOW" -lt 0 ]; then OVERFLOW=0; fi
+
+            if [ "$OVERFLOW" -gt 0 ]; then
+              OVERFLOW_MD=$(echo "$COMMENTS_JSON" | jq -r ".[$MAX_INLINE:][] | \"- **\(.path)** line \(.line): \(.body)\"")
+              REVIEW_BODY=$(printf "**Vale found %d remaining issue(s) after fixes.** First %d shown as inline comments.\n\n<details>\n<summary>%d more issue(s)</summary>\n\n%s\n\n</details>" \
+                "$VALE_COUNT" "$MAX_INLINE" "$OVERFLOW" "$OVERFLOW_MD")
+            else
+              REVIEW_BODY="**Vale found ${VALE_COUNT} remaining issue(s) after fixes.** See inline comments below."
+            fi
+
+            echo "Vale still found $VALE_COUNT issue(s) after fixes ($MAX_INLINE inline, $OVERFLOW overflow)"
             jq -n \
-              --arg body "**Vale found ${VALE_COUNT} remaining issue(s) after fixes.** See inline comments below." \
-              --argjson comments "$COMMENTS_JSON" \
+              --arg body "$REVIEW_BODY" \
+              --argjson comments "$INLINE_COMMENTS" \
               '{"body": $body, "event": "COMMENT", "comments": $comments}' \
               | gh api repos/${REPO}/pulls/${PR_NUMBER}/reviews --input - 2>&1
           else