fix: document review thread resolve limits

Author: 777genius

dist/index.js

@@ -27564,9 +27564,9 @@ ${this.ledger.statusText(loaded.payload, headSha)}` : `ReviewRouter override led
         `${resolved ? "Resolved" : "Unresolved"} ReviewRouter conversation for comment ${parentCommentId}`
       );
     } catch (error2) {
+      const reason = sanitizeNoticeError(error2);
       logger.warn(
-        `Failed to ${resolved ? "resolve" : "unresolve"} ReviewRouter conversation for comment ${parentCommentId}`,
-        error2
+        `Failed to ${resolved ? "resolve" : "unresolve"} ReviewRouter conversation for comment ${parentCommentId}: ${reason}`
       );
     }
   }

dist/index.js.map

@@ -305,6 +305,8 @@ If a blocking inline finding is a verified false positive, reply to that specifi
 
 The reason is optional. The installer generates a second non-required workflow, `.github/workflows/review-router-interaction.yml`, for `/rr ...` replies and optional discussion replies. `/rr skip` does not run Codex and does not checkout pull request code. It only verifies the command, updates the signed PR ledger, and reruns the failed `ReviewRouter / review` check when the token has `actions: write`.
 
+ReviewRouter also attempts to mark the skipped review thread as resolved. GitHub does not currently allow the standard `github-actions[bot]` token to run the `resolveReviewThread` GraphQL mutation, even with `pull-requests: write`, so this is best-effort in Actions bot mode. GitHub App bot mode can use the App installation token when GitHub grants that mutation to the App.
+
 Permission policy:
 
 - Critical and Major findings require `maintain` or `admin`.

docs/install.md

@@ -256,9 +256,9 @@ export class ReviewInteractionHandler {
         `${resolved ? 'Resolved' : 'Unresolved'} ReviewRouter conversation for comment ${parentCommentId}`
       );
     } catch (error) {
+      const reason = sanitizeNoticeError(error);
       logger.warn(
-        `Failed to ${resolved ? 'resolve' : 'unresolve'} ReviewRouter conversation for comment ${parentCommentId}`,
-        error as Error
+        `Failed to ${resolved ? 'resolve' : 'unresolve'} ReviewRouter conversation for comment ${parentCommentId}: ${reason}`
       );
     }
   }