fix: align JSDoc and error message with fallback behavior

Address review feedback: the docs/error now accurately reflect that
COPILOT_GITHUB_TOKEN is a fallback (not prohibited), while still
recommending GITHUB_TOKEN as the preferred token for repo API calls.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: tidy-dev

dist/index.js

@@ -36211,15 +36211,15 @@ async function findPRsViaMergeCommits(baseRef, headRef) {
 }
 /**
  * Get the token for GitHub repo API calls (fetching PRs, comparing commits).
- * Uses GITHUB_TOKEN which is automatically provided by GitHub Actions with
- * appropriate repo permissions. COPILOT_GITHUB_TOKEN is reserved for Copilot
- * CLI authentication and may not have repo access.
+ * Prefer GITHUB_TOKEN, which is automatically provided by GitHub Actions with
+ * appropriate repo permissions. Fall back to COPILOT_GITHUB_TOKEN if needed,
+ * but it may not have repo access.
  */
 function getApiToken() {
     const token = process.env.GITHUB_TOKEN || process.env.COPILOT_GITHUB_TOKEN;
     if (!token) {
-        throw new Error('GITHUB_TOKEN must be set for repo API calls. ' +
-            'COPILOT_GITHUB_TOKEN is used for Copilot CLI authentication only.');
+        throw new Error('Either GITHUB_TOKEN or COPILOT_GITHUB_TOKEN must be set for repo API calls. ' +
+            'Prefer GITHUB_TOKEN; COPILOT_GITHUB_TOKEN may not have sufficient repo permissions.');
     }
     return token;
 }

dist/index.js.map

@@ -152,17 +152,17 @@ async function findPRsViaMergeCommits(
 
 /**
  * Get the token for GitHub repo API calls (fetching PRs, comparing commits).
- * Uses GITHUB_TOKEN which is automatically provided by GitHub Actions with
- * appropriate repo permissions. COPILOT_GITHUB_TOKEN is reserved for Copilot
- * CLI authentication and may not have repo access.
+ * Prefer GITHUB_TOKEN, which is automatically provided by GitHub Actions with
+ * appropriate repo permissions. Fall back to COPILOT_GITHUB_TOKEN if needed,
+ * but it may not have repo access.
  */
 function getApiToken(): string {
   const token =
     process.env.GITHUB_TOKEN || process.env.COPILOT_GITHUB_TOKEN
   if (!token) {
     throw new Error(
-      'GITHUB_TOKEN must be set for repo API calls. ' +
-        'COPILOT_GITHUB_TOKEN is used for Copilot CLI authentication only.'
+      'Either GITHUB_TOKEN or COPILOT_GITHUB_TOKEN must be set for repo API calls. ' +
+        'Prefer GITHUB_TOKEN; COPILOT_GITHUB_TOKEN may not have sufficient repo permissions.'
     )
   }
   return token