fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all \u003cpre\u003e\u003ccode\u003e blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length \u003e 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(backend): Handle different GitHub token types in OAuth scope check - #850

Merged
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365
Feb 4, 2026
Merged

fix(backend): Handle different GitHub token types in OAuth scope check#850
brendan-kellam merged 4 commits into
mainfrom
bkellam/fix-SOU-365

Conversation

@brendan-kellam

@brendan-kellambrendan-kellam commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add token type detection for GitHub tokens based on their prefixes (ghp_, gho_, ghu_, ghs_, github_pat_)
  • Update getOAuthScopesForAuthenticatedUser to return null for token types that don't support scope introspection
  • Skip pre-flight scope validation for GitHub App tokens and fine-grained PATs, relying on runtime error handling instead
  • Add improved error handling for 401/403 responses with helpful re-authorization messages

Token Type Support

Token TypePrefixScope Check via x-oauth-scopes
Personal Access Token (classic)ghp_✅ Yes
OAuth App user tokengho_✅ Yes
GitHub App user tokenghu_❌ No (skip check)
GitHub App installation tokenghs_❌ No (skip check)
Fine-grained PATgithub_pat_❌ No (skip check)

Test plan

  • Unit tests added for detectGitHubTokenType and supportsOAuthScopeIntrospection
  • Test with OAuth app token (gho_) - should validate scopes via header

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed account permission syncing failures when authenticating with GitHub App user tokens.
    • Improved error handling for insufficient repository access permissions with clearer re-authentication guidance.
  • New Features

    • Enhanced error messages to guide users on re-authorizing with GitHub when required permissions are lacking.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

The PR adds GitHub token-type detection and conditional scope introspection to address permission syncing failures with app user tokens. It introduces token classification utilities, modifies scope retrieval to support optional introspection, adds repository listing capabilities, and implements error handling for missing permissions with re-authorization guidance.

Changes

Cohort / File(s)Summary
GitHub Token Infrastructure
packages/backend/src/github.ts
Added GitHubTokenType union with token prefixes, detection logic via detectGitHubTokenType(), scope introspection support via supportsOAuthScopeIntrospection(), and SCOPE_INTROSPECTABLE_TOKEN_TYPES constant. Modified getOAuthScopesForAuthenticatedUser() to accept optional token and return null for non-introspectable tokens. Added getReposForAuthenticatedUser() for authenticated user repository listing.
Permission Syncer Error Handling
packages/backend/src/ee/accountPermissionSyncer.ts
Integrated token-type aware scope introspection into GitHub authentication flow. Added scope validation with error messaging advising re-authorization. Wrapped repository listing in try/catch to handle 401/403 errors with user-facing re-authentication guidance.
Test Coverage
packages/backend/src/github.test.ts
Added comprehensive test suites for detectGitHubTokenType() covering multiple token-type scenarios and supportsOAuthScopeIntrospection() with boolean expectations.
Changelog
CHANGELOG.md
Documented fix for account-driven permission syncing failure when authenticating with GitHub App user token.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

sourcebot-team

Suggested reviewers

  • msukkari
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the primary change: handling different GitHub token types in OAuth scope checks, which aligns with the main objective of the PR to detect token types and conditionally perform scope introspection.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bkellam/fix-SOU-365

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

1 similar comment
@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.


@claude

claudeBot commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@CHANGELOG.md`:
- Line 13: Update the CHANGELOG entry line that reads "account driven permission
syncing" to use the hyphenated adjective "account-driven permission syncing";
locate the exact string in the CHANGELOG.md entry (the line beginning "- [EE]
Fixed issue where account driven permission syncing...") and replace "account
driven" with "account-driven".
🧹 Nitpick comments (1)
packages/backend/src/ee/accountPermissionSyncer.ts (1)

194-208: Consider extracting the HTTP error check into a shared utility.

The error status checking pattern here duplicates logic from isHttpError in github.ts (lines 80-85). Consider exporting that helper function and reusing it here for consistency.

♻️ Optional refactor

In packages/backend/src/github.ts, export the helper:

-const isHttpError = (error: unknown, status: number): boolean => {+export const isHttpError = (error: unknown, status: number): boolean => {

Then in this file:

 import {
createOctokitFromToken,
getOAuthScopesForAuthenticatedUser as getGitHubOAuthScopesForAuthenticatedUser,
getReposForAuthenticatedUser,
+ isHttpError,
} from "../github.js";
 } catch (error) {
- if (error && typeof error === 'object' && 'status' in error) {- const status = (error as { status: number }).status;- if (status === 401 || status === 403) {- throw new Error(- `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` +- `Please re-authorize with GitHub to grant the necessary access.`- );- }+ if (isHttpError(error, 401) || isHttpError(error, 403)) {+ const status = (error as { status: number }).status;+ throw new Error(+ `GitHub API returned ${status} error. Your token may have expired or lacks the required permissions. ` ++ `Please re-authorize with GitHub to grant the necessary access.`+ );
}
throw error;
}

Comment threadCHANGELOG.md
@brendan-kellam
brendan-kellam merged commit 4d37b18 into mainFeb 4, 2026
12 checks passed
@brendan-kellam
brendan-kellam deleted the bkellam/fix-SOU-365 branch February 4, 2026 00:43
@github-actionsgithub-actionsBot mentioned this pull request Feb 4, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@brendan-kellam