docs: add read:user to required token scopes #67
Reference in New Issue
Block a user
Delete Branch "issue-66"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
The
read:userscope is needed for the bot to self-request as a reviewer on PRs. Without it, the bot still functions but cannot add itself to the reviewer list.Closes #66
Security Review
Summary
The change updates documentation to include the optional
read:userscope and clarifies its purpose. There are no code changes and CI passed.Recommendation
APPROVE — This PR only adjusts README guidance around token scopes, adding
read:useras optional for self-requesting as a reviewer. No security-impacting code changes are present and CI has passed. Approve as-is.Review by security
Evaluated against
4a1cb6b4Sonnet Review
Summary
This is a pure documentation change adding the
read:userscope to the README's token scopes table, along with a clarifying note about its optional nature. CI passed, the change is accurate and well-worded.Findings
README.mdRecommendation
APPROVE — Approve. The change correctly documents the
read:userscope as optional but recommended, replaces a previously inaccurate statement ('Noread:userscope needed'), and CI passed. The only finding is a one-character difference in a Markdown table separator that has no functional impact.Review by sonnet
Evaluated against
4a1cb6b4@@ -330,3 +330,3 @@| Scope | Purpose ||-------|---------||-------|--------|[NIT] The header separator row changed from
|-------|---------|to|-------|--------|(one fewer dash in the second column). Both are valid Markdown table syntax, but the inconsistency with the surrounding table style is trivially cosmetic.Gpt Review
Summary
Documentation update correctly adds the read:user scope and clarifies its optional nature. CI has passed and the change is limited to README content.
Findings
README.mdread:user). Consider renaming to 'Token Scopes' or splitting into 'Required' and 'Optional' for clarity.Recommendation
APPROVE — The change is a straightforward documentation improvement that adds the read:user scope and clarifies behavior without it. Since CI passed and there are no code changes, this can be merged as-is. Optionally, consider adjusting the section title or separating required vs optional scopes to avoid confusion.
Review by gpt
Evaluated against
4a1cb6b4@@ -329,11 +329,12 @@ All flags have environment variable equivalents:### Token Scopes Required[NIT] Section title says 'Token Scopes Required' but the table includes an optional scope (
read:user). Consider renaming to 'Token Scopes' or splitting into 'Required' and 'Optional' for clarity.Self-review: PASS
No blocking issues found.
Observations:
|---------|→|--------|). Markdown renders identically either way — cosmetic NIT only, not blocking.The change is coherent (single purpose: document
read:userscope), fits the codebase style, accurately reflects theRequestReviewerfunctionality ingitea/client.go, and is complete for a documentation-only PR.Ready for human review.