Fine-grained tokenでgh pr readyが使えない（GraphQL権限不足）

[ikeisuke]

概要

Fine-grained personal access tokenで gh pr ready を実行すると以下のエラーが発生する。

API call failed: GraphQL: Resource not accessible by personal access token (markPullRequestReadyForReview)

現状の権限設定

• Token種別: Fine-grained personal access token (github_pat_)
• Pull requests: Read and Write
• Issues: Read and Write
• Workflows: Read and Write

原因

GitHubのFine-grained tokenではGraphQL Mutationの一部（markPullRequestReadyForReview）がサポートされていない可能性がある。

影響

• gh pr ready が実行不可
• gh pr merge も同様に影響を受ける可能性あり

対応案

• Classic token（repo スコープ）への切り替えを検討
• またはGitHub側のFine-grained token対応を待つ
• 当面はブラウザからReady化で回避

[ikeisuke]

追加調査

影響範囲

Fine-grained tokenで使えないGraphQL Mutation:

• markPullRequestReadyForReview → gh pr ready が失敗
• mergePullRequest → gh pr merge が失敗

原因

GitHub Fine-grained tokenはREST APIの権限スコープに基づいているが、上記のGraphQL Mutationはまだサポート対象外。Pull requests の Read and Write 権限があっても使えない。

対応策

1. Classic token（repo スコープ）に切り替える — 全操作可能、最も確実
2. Fine-grained token + ブラウザ操作を併用 — 現在の運用
3. GitHub側の対応を待つ — Fine-grained tokenのGraphQL対応は進行中だが時期不明

参考

• Support fine-grained Personal Access Tokens (PAT v2) cli/cli#6680
• https://github.com/orgs/community/discussions/36441