Engineer GitHub OAuth Scope Validation for Required Repository Permission Grants

[temma02]

Description

Implement validation of GitHub OAuth scopes to ensure that the granted token has all the repository permissions required for deployment operations, preventing failures mid-deployment due to insufficient scopes.

Requirements and Context

• Security: Tokens must have the required scopes before deployment
• Testing: Test scope validation scenarios
• Documentation: Document the required scopes

Suggested Execution

Branch: feat/issue-122-github-oauth-scope-validation

Implement Changes

• Add OAuth scope validation after GitHub authentication
• Verify the token has all required repository scopes
• Prompt for re-authorization if required scopes are missing
• Surface a clear error listing the missing scopes

Test and Commit

• Test acceptance when all required scopes are granted
• Test detection of missing scopes
• Document the required scopes

Example Commit Message

feat(auth): add GitHub OAuth scope validation for required repository permissions

- Validate token has all required repository scopes
- Prompt for re-authorization on missing scopes
- Surface clear missing-scope errors

Guidelines

• Validate scopes before starting deployment
• List missing scopes clearly to the user
• Prompt for re-authorization when needed