feat: add webhook handler for worlddriven-migrate app #329
+522
−2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Implement the backend support for a separate GitHub App that handles repository transfers to the worlddriven organization. Changes: - Add /api/webhooks/migrate endpoint for the migrate app - Add migrationHandler.js with transfer logic: - findApprovedMigrationPR: checks for approved PRs in documentation repo - transferRepository: calls GitHub transfer API - triggerPRChecks: re-runs CI after successful transfer - Add getInstallationAccessToken to githubApp.js for multi-app support - Update .env-example with migrate app credentials The migrate app uses a separate minimal permission set (administration only) to enable transfers without requiring elevated permissions on the main worlddriven app. Flow: 1. User installs worlddriven-migrate app on their repo 2. Webhook triggers, checks for approved migration PR 3. If approved, transfers repo to worlddriven org 4. Comments on PR and triggers CI re-run Relates to worlddriven/documentation#23
Contributor
🤖 Worlddriven Status📊 Live Status Dashboard🗓️ Merge Date: 2025-12-28 at 02:09:09 UTC (in 2 days) 🎯 Want to influence when this merges?Your review matters! As a contributor to this project, your voice helps determine the merge timeline. How to review:
Your options:
💡 Pro tip: The more contributors who agree, the faster this gets merged! 📊 View detailed stats on the dashboard 📋 Recent Activity• 2025-12-26, 07:19:12 - Pull request opened This comment is automatically updated by worlddriven |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Implement backend support for the
worlddriven-migrateGitHub App, which handles repository transfers to the worlddriven organization.This is part of the new migration approach that uses a separate GitHub App (with only
administrationpermission) instead of collaborator invitations, solving the limitation that personal repositories cannot grant admin access to collaborators.Changes
POST /api/webhooks/migrate- webhook handler for the migrate appsrc/helpers/migrationHandler.js- migration logicfindApprovedMigrationPR()- finds approved PRs in documentation repotransferRepository()- calls GitHub transfer APIcheckPRApprovalStatus()- verifies worlddriven voting approvaltriggerPRChecks()- re-runs CI after transfersrc/helpers/githubApp.js- addedgetInstallationAccessToken()for multi-app support.env-example- documented new environment variablesMigration Flow
Environment Variables
New variables needed for the migrate app:
MIGRATE_APP_ID- GitHub App IDMIGRATE_APP_PRIVATE_KEY- GitHub App private keyRelated
Test Plan
Next Steps
worlddriven-migrateGitHub App manually in GitHub UI