Skip to content

fix(github): resume installation permission upgrades - #27

Merged
realmroot[bot] merged 13 commits into
mainfrom
codex/github-administration-scope
Aug 14, 2026
Merged

fix(github): resume installation permission upgrades#27
realmroot[bot] merged 13 commits into
mainfrom
codex/github-administration-scope

Conversation

@realmroot

@realmroot realmroot Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Outcome

GitHub App permission increases now target the exact installation instead of the new-install account selector. The Adapter keeps the original authorization intent on a waiting page, observes the signed new_permissions_accepted webhook, and resumes the same Realmroot approval automatically.

The permission-review URL is derived from the canonical installation html_url, so personal and organization installations use their correct GitHub settings paths.

Review-environment acceptance

  1. Deploy this PR to adapters.realmroot.dev with an existing personal or organization GitHub App installation.
  2. Add a repository permission to the GitHub App that the installation has not accepted.
  3. Request its mapped scope for that installation Context from realmroot agent request.
  4. On the Realmroot Agent resource access page, choose Update permissions and authorize the matching GitHub user.
  5. Confirm the Adapter waiting page opens the exact installation permission-review page, not the App installation account selector.
  6. Accept the new permission in GitHub. Confirm the GitHub window closes and the original Realmroot approval becomes authorizable without starting a second request.
  7. Authorize it and run a real realmroot exec github --context <context> -- gh api ... operation requiring that permission.
  8. Repeat the request and confirm an already accepted permission skips the GitHub update step.

Verification

  • pnpm run docs:check
  • pnpm run typecheck
  • pnpm run lint
  • pnpm run test:unit (161 tests)
  • pnpm run test:integration (15 tests)
  • pnpm run build
  • Live personal installation saltbo (152267965): permission update, automatic transaction resume, Agent authorization, and provider API reachability passed.
  • Live organization installation realmroot (152329382): canonical organization permission URL, automatic transaction resume, and GET /repos/realmroot/adapters/rulesets returned 200.

🤖 Created by Jarvis via Realmroot

@realmroot
realmroot Bot requested a review from saltbo as a code owner August 14, 2026 04:42
@realmroot
realmroot Bot merged commit d5be4e9 into main Aug 14, 2026
2 checks passed
@realmroot
realmroot Bot deleted the codex/github-administration-scope branch August 14, 2026 20:17
Sign up for free to 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