github-issue-tower-defence-management 1.116.2 → 1.116.5

package/.github/workflows/commit-lint.yml

@@ -62,4 +62,4 @@ jobs:
         env:
           NODE_PATH: /tmp/commitlint-run/node_modules
         run: |
-          /tmp/commitlint-run/node_modules/.bin/commitlint --from=origin/main --to=HEAD --config $GITHUB_WORKSPACE/.github/workflows/configs/commitlint.config.js
+          /tmp/commitlint-run/node_modules/.bin/commitlint --from=origin/main --to=HEAD --config $GITHUB_WORKSPACE/.github/workflows/configs/commitlint.config.cjs

package/.github/workflows/configs/commitlint.config.cjs

@@ -0,0 +1,32 @@
+// DO NOT EDIT DIRECTLY.
+// This file is auto-synchronized from HiromiShikata/repositories-management.
+// Direct edits in downstream repositories will be overwritten by the next sync.
+// Update the source file in HiromiShikata/repositories-management instead.
+
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'build',
+        'chore',
+        'ci',
+        'docs',
+        'feat',
+        'fix',
+        'perf',
+        'refactor',
+        'revert',
+        'style',
+        'test',
+        'autogen',
+        'prep',
+        'adapt',
+      ],
+    ],
+    'header-max-length': [0],
+    'body-max-line-length': [0],
+  },
+};

package/.github/workflows/umino-project.yml

@@ -51,6 +51,8 @@ jobs:
   umino-job:
     if: >-
       github.actor != 'dependabot[bot]' &&
+      github.actor != 'renovate[bot]' &&
+      github.actor != 'app/dependabot' &&
       ((github.event_name != 'issue_comment') ||
        (github.event.comment.user.login == 'HiromiShikata' &&
         (contains(github.event.comment.body, '/createissue') ||
@@ -277,7 +279,9 @@ jobs:
     name: Check linked issues in pull requests
     if: >-
       (github.event_name == 'pull_request') &&
-      github.actor != 'dependabot[bot]'
+      github.actor != 'dependabot[bot]' &&
+      github.actor != 'renovate[bot]' &&
+      github.actor != 'app/dependabot'
     steps:
       - uses: step-security/harden-runner@v2
         with:
@@ -291,9 +295,11 @@ jobs:
           owner: HiromiShikata
       - uses: nearform-actions/github-action-check-linked-issues@7140e2e01aa0c18b8ac61bddf5e89abde1ca760e
         id: check-linked-issues
-        if: github.event.pull_request.user.login != 'dependabot[bot]'
+        if: >-
+          github.event.pull_request.user.login != 'dependabot[bot]' &&
+          github.event.pull_request.user.login != 'app/dependabot'
         with:
-          exclude-branches: 'release/**, dependabot/**, project-common/**, renovate/**'
+          exclude-branches: 'release/**, dependabot/**, dependabot-**, project-common/**, renovate/**'
           github-token: ${{ steps.app-token.outputs.token }}
           loose-matching: true
           skip-linked-issues-check-label: ''

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.116.5](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/compare/v1.116.4...v1.116.5) (2026-06-29)
+
+
+### Bug Fixes
+
+* **test:** use sessionKey not sessionId on ClaudeLiveSession literals in LiveSessionOauthTokenSelectHandler test ([#1089](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/issues/1089)) ([b649c7f](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/commit/b649c7f9243e09b6c973c3d9d545014c0eb1b7f2))
+
+## [1.116.4](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/compare/v1.116.3...v1.116.4) (2026-06-29)
+
+
+### Bug Fixes
+
+* **console:** retry transient GitHub rate-limit on item operations with bounded backoff and clear error classification ([#1082](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/issues/1082)) ([61657ed](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/commit/61657edb588f7ba381009fb15d7a52960dda8ad6))
+
 ## [1.116.2](https://github.com/HiromiShikata/npm-cli-github-issue-tower-defence-management/compare/v1.116.1...v1.116.2) (2026-06-29)
 
 

package/README.md

@@ -110,9 +110,9 @@ Each project's status and story options are loaded lazily the first time a `pjco
 
 The `checkIssueReviewReadiness` sub-command lets an agent self-check whether an issue is currently review-ready. It does NOT change the issue Status field and does NOT post any comment. It writes a single JSON line to stdout of the shape `{ "reviewReady": boolean, "rejections": [{ "type": string, "detail": string }] }` and exits 0 on a successful evaluation regardless of readiness; a non-zero exit indicates an operational error (auth failure, network error). The rejection types include: `ISSUE_NOT_FOUND`, `NO_REPORT_FROM_AGENT_BOT`, `REPORT_HAS_NEXT_STEP`, `PULL_REQUEST_NOT_FOUND`, `PULL_REQUEST_IS_DRAFT`, `PULL_REQUEST_CONFLICTED`, `ANY_CI_JOB_FAILED_OR_IN_PROGRESS`, `REQUIRED_CI_JOB_NEVER_STARTED`, `ANY_REVIEW_COMMENT_NOT_RESOLVED`, and `MULTIPLE_PULL_REQUESTS_FOUND`. The `--projectUrl` option is optional; when omitted the command still runs using only the issue URL.
 
-The `selectOauthToken` sub-command reads the same per-token rate-limit cache that the `startDaemon` proxy writes (see "Claude OAuth Token Rotation" below) and prints exactly one token string to stdout so a caller can choose an appropriate token before launching Claude Code. It is read-only: it never starts the proxy, never mutates any cache file, and never writes the token anywhere. Selection runs in two stages. First, a candidate filter keeps tokens whose 5-hour window is at least 60% free (5-hour utilization at most 0.40) AND whose 7-day window is at least 30% free (7-day utilization at most 0.70), where "% free" is `1 - utilization`. A token with no cache file, or whose window reset epoch has already passed, is treated as fully free (utilization 0) for these checks. Second, among the surviving candidates it selects the single token whose 7-day window reset epoch is nearest in the future (soonest reset), so weekly quota that would otherwise reset unused is consumed first; a candidate with no active 7-day window is treated as having the farthest reset (now + 7 days) and therefore sorts last. The selected token string is written to stdout (pipeable) and the per-candidate decision trace is written to stderr. When no token passes the filter, nothing is written to stdout and the command exits non-zero with an explanatory message on stderr. The token-list path comes from `--tokenListJsonPath` or the `CLAUDE_CODE_OAUTH_TOKEN_LIST_JSON_PATH` environment variable; the cache directory comes from `--cacheDir` or the `TDPM_RATELIMIT_CACHE_DIR` environment variable, defaulting to `${XDG_CACHE_HOME:-~/.cache}/tdpm/ratelimit`.
+The `selectOauthToken` sub-command reads the same per-token rate-limit cache that the `startDaemon` proxy writes (see "Claude OAuth Token Rotation" below) and prints exactly one token string to stdout so a caller can choose an appropriate token before launching Claude Code. It is read-only: it never starts the proxy, never mutates any cache file, and never writes the token anywhere. Selection runs in two stages. First, a candidate filter keeps tokens whose 5-hour window is at least 60% free (5-hour utilization at most 0.40) AND whose 7-day window is at least 7% free (7-day utilization at most 0.93), where "% free" is `1 - utilization`. A token with no cache file, or whose window reset epoch has already passed, is treated as fully free (utilization 0) for these checks. Second, among the surviving candidates it selects the single token whose 7-day window reset epoch is nearest in the future (soonest reset), so weekly quota that would otherwise reset unused is consumed first; a candidate with no active 7-day window is treated as having the farthest reset (now + 7 days) and therefore sorts last. The selected token string is written to stdout (pipeable) and the per-candidate decision trace is written to stderr. When no token passes the filter, nothing is written to stdout and the command exits non-zero with an explanatory message on stderr. The token-list path comes from `--tokenListJsonPath` or the `CLAUDE_CODE_OAUTH_TOKEN_LIST_JSON_PATH` environment variable; the cache directory comes from `--cacheDir` or the `TDPM_RATELIMIT_CACHE_DIR` environment variable, defaulting to `${XDG_CACHE_HOME:-~/.cache}/tdpm/ratelimit`.
 
-The `selectLiveSessionOauthToken` sub-command picks a token for a new live interactive Claude Code session a human is about to start, so that concurrent interactive sessions spread across distinct tokens instead of stacking onto the same one. It loads the token list and reads the same per-token rate-limit cache as `selectOauthToken`, and it is read-only in exactly the same way: it never starts the proxy, never mutates any cache file, and never writes the token anywhere. It applies the identical rate-limit eligibility filter as `selectOauthToken` (5-hour window at least 60% free AND 7-day window at least 30% free, with a missing cache file or an expired window treated as fully free). It additionally measures current live occupancy per token by scanning running Claude Code processes on the local Linux host: for each process under `/proc` it reads the NUL-separated `/proc/<pid>/environ` and, when the process is a Claude Code process, takes its `CLAUDE_CODE_OAUTH_TOKEN` and `CLAUDE_CODE_SESSION_ID`. A token's occupancy is the number of distinct `CLAUDE_CODE_SESSION_ID` values bound to it, so child processes that inherit one session id count once. Processes without `CLAUDE_CODE_OAUTH_TOKEN` (for example API-key sessions) are ignored, and a process whose environ cannot be read is skipped. Among the eligible tokens it selects the one with the fewest live sessions (ideally zero), breaking ties by the soonest 7-day reset. The selected token string is written to stdout (pipeable) and the per-candidate decision trace is written to stderr; when no token passes the filter, nothing is written to stdout and the command exits non-zero with an explanatory message on stderr. The token-list path and cache directory are resolved exactly as for `selectOauthToken`. Because occupancy is read from `/proc/<pid>/environ`, this sub-command is Linux-specific.
+The `selectLiveSessionOauthToken` sub-command picks a token for a new live interactive Claude Code session a human is about to start, so that concurrent interactive sessions spread across distinct tokens instead of stacking onto the same one. It loads the token list and reads the same per-token rate-limit cache as `selectOauthToken`, and it is read-only in exactly the same way: it never starts the proxy, never mutates any cache file, and never writes the token anywhere. It applies the identical rate-limit eligibility filter as `selectOauthToken` (5-hour window at least 60% free AND 7-day window at least 7% free, with a missing cache file or an expired window treated as fully free). It additionally measures current live occupancy per token by scanning running Claude Code processes on the local Linux host: for each process under `/proc` it reads the NUL-separated `/proc/<pid>/environ` and, when the process is a Claude Code process, takes its `CLAUDE_CODE_OAUTH_TOKEN` and `CLAUDE_CODE_SESSION_ID`. A token's occupancy is the number of distinct `CLAUDE_CODE_SESSION_ID` values bound to it, so child processes that inherit one session id count once. Processes without `CLAUDE_CODE_OAUTH_TOKEN` (for example API-key sessions) are ignored, and a process whose environ cannot be read is skipped. Among the eligible tokens it selects the one with the fewest live sessions (ideally zero), breaking ties by the soonest 7-day reset. The selected token string is written to stdout (pipeable) and the per-candidate decision trace is written to stderr; when no token passes the filter, nothing is written to stdout and the command exits non-zero with an explanatory message on stderr. The token-list path and cache directory are resolved exactly as for `selectOauthToken`. Because occupancy is read from `/proc/<pid>/environ`, this sub-command is Linux-specific.
 
 The `countInTmuxByHumanSessionsPerToken` sub-command reports, per Claude Code OAuth token, how many live interactive sessions running under that token belong to an issue that is currently in the GitHub Project Status `In Tmux by human`. It is read-only: it never starts the proxy, never mutates any cache file, and never writes any token anywhere. It enumerates live interactive sessions by scanning running processes on the local Linux host: for each process under `/proc` it reads the NUL-separated `/proc/<pid>/cmdline` and selects only processes launched for an interactive session, identified by a `--name <issue-url>` argument whose value is an HTTP or HTTPS URL; `Take ownership` background spawns (which have no `--name` argument) are excluded. For each selected process it reads `/proc/<pid>/environ` and takes its `CLAUDE_CODE_OAUTH_TOKEN` and `CLAUDE_CODE_SESSION_ID`; a process missing either is skipped, and a process whose files cannot be read is skipped. It then loads the project's issues with their Status (reusing the same on-disk issue cache the daemon uses, honoring `allowIssueCacheMinutes`), keeps only the sessions whose `--name` issue URL maps to an open issue in Status `In Tmux by human`, and counts the distinct `CLAUDE_CODE_SESSION_ID` values per token so child processes that inherit one session id count once. It writes one tab-separated line per token to stdout in the form `<tokenName>\t<count>` (the token name comes from the token list; the raw token value is never printed), and writes the per-run decision trace to stderr. The token-list path comes from `--tokenListJsonPath`, the `claudeCodeOauthTokenListJsonPath` config value, or the `CLAUDE_CODE_OAUTH_TOKEN_LIST_JSON_PATH` environment variable. Because occupancy is read from `/proc/<pid>/cmdline` and `/proc/<pid>/environ`, this sub-command is Linux-specific.
 

package/bin/adapter/repositories/ProcClaudeLiveSessionRepository.js

@@ -39,6 +39,7 @@ const path = __importStar(require("path"));
 const DEFAULT_PROC_DIRECTORY = '/proc';
 const OAUTH_TOKEN_ENVIRON_KEY = 'CLAUDE_CODE_OAUTH_TOKEN';
 const SESSION_ID_ENVIRON_KEY = 'CLAUDE_CODE_SESSION_ID';
+const CONFIG_DIR_ENVIRON_KEY = 'CLAUDE_CONFIG_DIR';
 const isClaudeProcessCommand = (command) => {
     if (command.length === 0) {
         return false;
@@ -78,17 +79,28 @@ class ProcClaudeLiveSessionRepository {
                 return null;
             }
             const token = environ.get(OAUTH_TOKEN_ENVIRON_KEY);
-            const sessionId = environ.get(SESSION_ID_ENVIRON_KEY);
-            if (token === undefined ||
-                token.length === 0 ||
-                sessionId === undefined ||
-                sessionId.length === 0) {
+            if (token === undefined || token.length === 0) {
+                return null;
+            }
+            const sessionKey = this.deriveSessionKey(environ);
+            if (sessionKey === null) {
                 return null;
             }
             if (!this.isClaudeProcess(processIdDirectory)) {
                 return null;
             }
-            return { token, sessionId };
+            return { token, sessionKey };
+        };
+        this.deriveSessionKey = (environ) => {
+            const configDir = environ.get(CONFIG_DIR_ENVIRON_KEY);
+            if (configDir !== undefined && configDir.length > 0) {
+                return configDir;
+            }
+            const sessionId = environ.get(SESSION_ID_ENVIRON_KEY);
+            if (sessionId !== undefined && sessionId.length > 0) {
+                return sessionId;
+            }
+            return null;
         };
         this.isClaudeProcess = (processIdDirectory) => {
             const basePath = path.join(this.procDirectory, processIdDirectory);

package/bin/adapter/repositories/ProcClaudeLiveSessionRepository.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProcClaudeLiveSessionRepository.js","sourceRoot":"","sources":["../../../src/adapter/repositories/ProcClaudeLiveSessionRepository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ProcClaudeLiveSessionRepository.js","sourceRoot":"","sources":["../../../src/adapter/repositories/ProcClaudeLiveSessionRepository.ts"],"names":[],"mappings":"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"}

package/bin/adapter/repositories/issue/ApiV3CheerioRestIssueRepository.js

@@ -7,6 +7,7 @@ exports.ApiV3CheerioRestIssueRepository = void 0;
 const typia_1 = __importDefault(require("typia"));
 const BaseGitHubRepository_1 = require("../BaseGitHubRepository");
 const utils_1 = require("../utils");
+const githubRateLimitRetry_1 = require("./githubRateLimitRetry");
 function isIssueTimelineResponse(value) {
     if (typeof value !== 'object' || value === null)
         return false;
@@ -156,7 +157,7 @@ const fnmatch = (pattern, str) => {
     }
 };
 class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubRepository {
-    constructor(apiV3IssueRepository, restIssueRepository, graphqlProjectItemRepository, localStorageCacheRepository, localStorageRepository, ghToken = process.env.GH_TOKEN || 'dummy') {
+    constructor(apiV3IssueRepository, restIssueRepository, graphqlProjectItemRepository, localStorageCacheRepository, localStorageRepository, ghToken = process.env.GH_TOKEN || 'dummy', sleep = githubRateLimitRetry_1.realSleep) {
         super(localStorageRepository, ghToken);
         this.apiV3IssueRepository = apiV3IssueRepository;
         this.restIssueRepository = restIssueRepository;
@@ -164,6 +165,8 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         this.localStorageCacheRepository = localStorageCacheRepository;
         this.localStorageRepository = localStorageRepository;
         this.ghToken = ghToken;
+        this.sleep = sleep;
+        this.fetchWithRateLimitRetry = (request) => (0, githubRateLimitRetry_1.fetchWithGitHubRateLimitRetry)(request, this.sleep);
         this.updateStatus = async (project, issue, statusId) => {
             await this.graphqlProjectItemRepository.updateProjectField(project.id, project.status.fieldId, issue.itemId, { singleSelectOptionId: statusId });
         };
@@ -578,7 +581,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             let after = null;
             let hasNextPage = true;
             while (hasNextPage) {
-                const response = await fetch('https://api.github.com/graphql', {
+                const response = await this.fetchWithRateLimitRetry(() => fetch('https://api.github.com/graphql', {
                     method: 'POST',
                     headers: {
                         Authorization: `Bearer ${this.ghToken}`,
@@ -588,7 +591,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                         query,
                         variables: { owner, repo, issueNumber, after },
                     }),
-                });
+                }));
                 if (!response.ok) {
                     throw new Error(`Failed to fetch issue timeline from GitHub GraphQL API: HTTP ${response.status}`);
                 }
@@ -728,7 +731,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         }
       }
     `;
-            const response = await fetch('https://api.github.com/graphql', {
+            const response = await this.fetchWithRateLimitRetry(() => fetch('https://api.github.com/graphql', {
                 method: 'POST',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
@@ -738,7 +741,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                     query,
                     variables: { owner, repo, prNumber },
                 }),
-            });
+            }));
             if (!response.ok) {
                 throw new Error(`Failed to fetch pull request from GitHub GraphQL API: HTTP ${response.status}`);
             }
@@ -757,14 +760,14 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         };
         this.closePullRequest = async (prUrl) => {
             const { owner, repo, issueNumber: prNumber } = this.parseIssueUrl(prUrl);
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}`, {
                 method: 'PATCH',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     'Content-Type': 'application/json',
                 },
                 body: JSON.stringify({ state: 'closed' }),
-            });
+            }));
             if (!response.ok) {
                 const reason = await this.formatGitHubErrorWithStatus(response);
                 throw new Error(`Failed to close PR ${prUrl}: ${reason}`);
@@ -774,16 +777,17 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             const { owner, repo, issueNumber } = this.parseIssueUrl(issueUrl);
             const ownerSegment = encodeURIComponent(owner);
             const repoSegment = encodeURIComponent(repo);
-            const response = await fetch(`https://api.github.com/repos/${ownerSegment}/${repoSegment}/issues/${issueNumber}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${ownerSegment}/${repoSegment}/issues/${issueNumber}`, {
                 method: 'PATCH',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     'Content-Type': 'application/json',
                 },
                 body: JSON.stringify({ state: 'closed', state_reason: stateReason }),
-            });
+            }));
             if (!response.ok) {
-                throw new Error(`Failed to close issue ${issueUrl}: HTTP ${response.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(response);
+                throw new Error(`Failed to close issue ${issueUrl}: ${reason}`);
             }
         };
         this.getPullRequestChangedFilePaths = async (prUrl) => {
@@ -793,15 +797,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             let page = 1;
             let hasMore = true;
             while (hasMore) {
-                const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/files?per_page=${perPage}&page=${page}`, {
+                const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}/files?per_page=${perPage}&page=${page}`, {
                     method: 'GET',
                     headers: {
                         Authorization: `Bearer ${this.ghToken}`,
                         Accept: 'application/vnd.github+json',
                     },
-                });
+                }));
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch changed files for PR ${prUrl}: HTTP ${response.status}`);
+                    const reason = await this.formatGitHubErrorWithStatus(response);
+                    throw new Error(`Failed to fetch changed files for PR ${prUrl}: ${reason}`);
                 }
                 const body = await response.json();
                 if (!isPullRequestFilesResponse(body)) {
@@ -821,7 +826,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         };
         this.approvePullRequest = async (prUrl) => {
             const { owner, repo, issueNumber: prNumber } = this.parseIssueUrl(prUrl);
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/reviews`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}/reviews`, {
                 method: 'POST',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
@@ -829,7 +834,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                     Accept: 'application/vnd.github+json',
                 },
                 body: JSON.stringify({ event: 'APPROVE' }),
-            });
+            }));
             if (!response.ok) {
                 const reason = await this.formatGitHubErrorWithStatus(response);
                 throw new Error(`Failed to approve PR ${prUrl}: ${reason}`);
@@ -851,7 +856,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                     },
                 ],
             };
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/reviews`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}/reviews`, {
                 method: 'POST',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
@@ -859,7 +864,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                     Accept: 'application/vnd.github+json',
                 },
                 body: JSON.stringify(reviewBody),
-            });
+            }));
             if (!response.ok) {
                 const reason = await this.formatGitHubErrorWithStatus(response);
                 throw new Error(`Failed to request changes on PR ${prUrl}: ${reason}`);
@@ -868,15 +873,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         this.fetchPullRequestHeadSha = async (owner, repo, prNumber, prUrl) => {
             const ownerSegment = encodeURIComponent(owner);
             const repoSegment = encodeURIComponent(repo);
-            const response = await fetch(`https://api.github.com/repos/${ownerSegment}/${repoSegment}/pulls/${prNumber}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${ownerSegment}/${repoSegment}/pulls/${prNumber}`, {
                 method: 'GET',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     Accept: 'application/vnd.github+json',
                 },
-            });
+            }));
             if (!response.ok) {
-                throw new Error(`Failed to fetch head commit for PR ${prUrl}: HTTP ${response.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(response);
+                throw new Error(`Failed to fetch head commit for PR ${prUrl}: ${reason}`);
             }
             const body = await response.json();
             if (!isRecord(body) ||
@@ -891,7 +897,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             const commitId = await this.fetchPullRequestHeadSha(owner, repo, prNumber, prUrl);
             const ownerSegment = encodeURIComponent(owner);
             const repoSegment = encodeURIComponent(repo);
-            const response = await fetch(`https://api.github.com/repos/${ownerSegment}/${repoSegment}/pulls/${prNumber}/comments`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${ownerSegment}/${repoSegment}/pulls/${prNumber}/comments`, {
                 method: 'POST',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
@@ -905,7 +911,7 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                     line,
                     side,
                 }),
-            });
+            }));
             if (!response.ok) {
                 const reason = await this.formatGitHubErrorWithStatus(response);
                 throw new Error(`Failed to create review comment on PR ${prUrl}: ${reason}`);
@@ -943,7 +949,17 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         };
         this.formatGitHubErrorWithStatus = async (response) => {
             const status = `HTTP ${response.status}`;
+            const bodyText = await response.clone().text();
             const reason = await this.readGitHubErrorReason(response);
+            if ((0, githubRateLimitRetry_1.hasRateLimitSignals)(response.status, response.headers, bodyText)) {
+                const resetIso = (0, githubRateLimitRetry_1.computeRateLimitResetIso)(response.headers);
+                const resetSuffix = resetIso === null ? '' : ` (resets at ${resetIso})`;
+                return `${status} GitHub rate limit exceeded, please retry shortly${resetSuffix}`;
+            }
+            if (response.status === 403) {
+                const permissionSuffix = reason === null ? '' : ` ${reason}`;
+                return `${status} permission denied, the token cannot perform this operation${permissionSuffix}`;
+            }
             if (reason === null) {
                 return status;
             }
@@ -951,14 +967,15 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         };
         this.deletePullRequestBranch = async (prUrl, branchName) => {
             const { owner, repo } = this.parseIssueUrl(prUrl);
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/git/refs/heads/${encodeURIComponent(branchName)}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/git/refs/heads/${encodeURIComponent(branchName)}`, {
                 method: 'DELETE',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                 },
-            });
+            }));
             if (!response.ok && response.status !== 422) {
-                throw new Error(`Failed to delete branch ${branchName} for PR ${prUrl}: HTTP ${response.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(response);
+                throw new Error(`Failed to delete branch ${branchName} for PR ${prUrl}: ${reason}`);
             }
         };
         this.createCommentByUrl = async (issueOrPrUrl, commentBody) => {
@@ -966,15 +983,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         };
         this.getIssueOrPullRequestBody = async (url) => {
             const { owner, repo, issueNumber } = this.parseIssueUrl(url);
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/issues/${issueNumber}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`, {
                 method: 'GET',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     Accept: 'application/vnd.github+json',
                 },
-            });
+            }));
             if (!response.ok) {
-                throw new Error(`Failed to fetch body for ${url}: HTTP ${response.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(response);
+                throw new Error(`Failed to fetch body for ${url}: ${reason}`);
             }
             const body = await response.json();
             if (!isIssueOrPullRequestBodyResponse(body)) {
@@ -989,15 +1007,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             let page = 1;
             let hasMore = true;
             while (hasMore) {
-                const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/issues/${issueNumber}/comments?per_page=${perPage}&page=${page}`, {
+                const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}/comments?per_page=${perPage}&page=${page}`, {
                     method: 'GET',
                     headers: {
                         Authorization: `Bearer ${this.ghToken}`,
                         Accept: 'application/vnd.github+json',
                     },
-                });
+                }));
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch comments for ${url}: HTTP ${response.status}`);
+                    const reason = await this.formatGitHubErrorWithStatus(response);
+                    throw new Error(`Failed to fetch comments for ${url}: ${reason}`);
                 }
                 const body = await response.json();
                 if (!isIssueCommentsResponse(body)) {
@@ -1024,15 +1043,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             if (!isPr) {
                 return null;
             }
-            const detailResponse = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}`, {
+            const detailResponse = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}`, {
                 method: 'GET',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     Accept: 'application/vnd.github+json',
                 },
-            });
+            }));
             if (!detailResponse.ok) {
-                throw new Error(`Failed to fetch detail for PR ${prUrl}: HTTP ${detailResponse.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(detailResponse);
+                throw new Error(`Failed to fetch detail for PR ${prUrl}: ${reason}`);
             }
             const detailBody = await detailResponse.json();
             if (!isPullRequestDetailResponse(detailBody)) {
@@ -1059,15 +1079,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             let page = 1;
             let hasMore = true;
             while (hasMore) {
-                const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/files?per_page=${perPage}&page=${page}`, {
+                const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}/files?per_page=${perPage}&page=${page}`, {
                     method: 'GET',
                     headers: {
                         Authorization: `Bearer ${this.ghToken}`,
                         Accept: 'application/vnd.github+json',
                     },
-                });
+                }));
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch files for PR ${prUrl}: HTTP ${response.status}`);
+                    const reason = await this.formatGitHubErrorWithStatus(response);
+                    throw new Error(`Failed to fetch files for PR ${prUrl}: ${reason}`);
                 }
                 const body = await response.json();
                 if (!isPullRequestDetailFilesResponse(body)) {
@@ -1101,15 +1122,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             let page = 1;
             let hasMore = true;
             while (hasMore) {
-                const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/commits?per_page=${perPage}&page=${page}`, {
+                const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}/commits?per_page=${perPage}&page=${page}`, {
                     method: 'GET',
                     headers: {
                         Authorization: `Bearer ${this.ghToken}`,
                         Accept: 'application/vnd.github+json',
                     },
-                });
+                }));
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch commits for PR ${prUrl}: HTTP ${response.status}`);
+                    const reason = await this.formatGitHubErrorWithStatus(response);
+                    throw new Error(`Failed to fetch commits for PR ${prUrl}: ${reason}`);
                 }
                 const body = await response.json();
                 if (!isPullRequestCommitsResponse(body)) {
@@ -1135,15 +1157,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
         this.getIssueOrPullRequestState = async (url) => {
             const { owner, repo, issueNumber, isPr } = this.parseIssueUrl(url);
             if (isPr) {
-                const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${issueNumber}`, {
+                const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${issueNumber}`, {
                     method: 'GET',
                     headers: {
                         Authorization: `Bearer ${this.ghToken}`,
                         Accept: 'application/vnd.github+json',
                     },
-                });
+                }));
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch state for ${url}: HTTP ${response.status}`);
+                    const reason = await this.formatGitHubErrorWithStatus(response);
+                    throw new Error(`Failed to fetch state for ${url}: ${reason}`);
                 }
                 const body = await response.json();
                 if (!isPullRequestDetailResponse(body)) {
@@ -1151,15 +1174,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
                 }
                 return { state: body.state, merged: body.merged, isPullRequest: true };
             }
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/issues/${issueNumber}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`, {
                 method: 'GET',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     Accept: 'application/vnd.github+json',
                 },
-            });
+            }));
             if (!response.ok) {
-                throw new Error(`Failed to fetch state for ${url}: HTTP ${response.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(response);
+                throw new Error(`Failed to fetch state for ${url}: ${reason}`);
             }
             const body = await response.json();
             if (!isIssueOrPullRequestStateResponse(body)) {
@@ -1172,15 +1196,16 @@ class ApiV3CheerioRestIssueRepository extends BaseGitHubRepository_1.BaseGitHubR
             if (!isPr) {
                 return null;
             }
-            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}`, {
+            const response = await this.fetchWithRateLimitRetry(() => fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${prNumber}`, {
                 method: 'GET',
                 headers: {
                     Authorization: `Bearer ${this.ghToken}`,
                     Accept: 'application/vnd.github+json',
                 },
-            });
+            }));
             if (!response.ok) {
-                throw new Error(`Failed to fetch summary for PR ${prUrl}: HTTP ${response.status}`);
+                const reason = await this.formatGitHubErrorWithStatus(response);
+                throw new Error(`Failed to fetch summary for PR ${prUrl}: ${reason}`);
             }
             const body = await response.json();
             if (!isPullRequestDetailResponse(body)) {