GitHub PR Automation Suite

This Val Town project includes several tools for automating GitHub pull request workflows:

1. PR Approval Notifier: Sends notifications to Slack when a PR is approved, with an optional merge button
2. PR Auto-Assign: Automatically assigns the PR author as an assignee when a PR is opened
3. PR Title Prefixer: Automatically prefixes PR titles with the linked issue number
4. PR Label Inheritor: Automatically copies labels from linked issues to the PR

This Val sends notifications to Slack when a GitHub pull request is approved, with an optional merge button that appears when all required checks are passing.

1. Create a GitHub Personal Access Token (PAT):

   • Go to GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
   • Create a new token with these permissions:
     • Repository access: Select repositories you want to monitor
     • Permissions:
       • Pull requests: Read and Write
       • Contents: Read and Write (for merging)
       • Metadata: Read-only
   • Save the token for the next step

2. Set up a GitHub Webhook:

   • Go to your repository → Settings → Webhooks → Add webhook
   • Payload URL: The URL of the respective Val
   • Content type: application/json
   • Select "Let me select individual events"
   • Check only "Pull request reviews"
   • Ensure "Active" is checked
   • Click "Add webhook"

1. Create a Slack App:

   • Go to Slack API Apps → Create New App → From scratch
   • Name your app and select your workspace
   • Click "Create App"

2. Enable Interactivity:

   • In your Slack app settings, go to "Interactivity & Shortcuts"
   • Toggle "Interactivity" to On
   • Set the Request URL to the URL of the respective val
   • Save Changes

3. Create an Incoming Webhook:

   • In your Slack app settings, go to "Incoming Webhooks"
   • Toggle "Activate Incoming Webhooks" to On
   • Click "Add New Webhook to Workspace"
   • Select the channel where notifications should be posted
   • Copy the Webhook URL for the next step

1. Add Environment Variables:

   • In Val Town, add these environment variables:
     • GITHUB_TOKEN: Your GitHub Personal Access Token
     • SLACK_WEBHOOK_URL: Your Slack Incoming Webhook URL

2. Get the Val URL:

   • Copy the Val's URL to use in the GitHub webhook and Slack app settings

1. GitHub sends a webhook event when a PR is reviewed
2. This Val filters for approval events
3. When an approval is detected, it:
   • Fetches detailed PR information
   • Checks if the PR is mergeable and all required checks are passing
   • Sends a formatted message to Slack
   • Includes a merge button if the PR can be merged
4. If the merge button is clicked, the Val:
   • Receives the event from Slack
   • Uses the GitHub API to merge the PR
   • Sends a confirmation message back to Slack

The github-pr-auto-assign.ts val automatically assigns the PR author as an assignee when a PR is opened.

Setup:

• Create a GitHub webhook with the "Pull requests" event
• Point it to the auto-assign val URL
• Add GITHUB_TOKEN as an environment variable in Val Town with these permissions:
  • For classic tokens: Include the "repo" scope
  • For fine-grained tokens: Ensure "Pull requests" has "Read and Write" access
  • Token must be created by a user with write access to the repository

Troubleshooting:

• If you see a "403: Resource not accessible by personal access token" error, your token doesn't have sufficient permissions. Create a new token with the permissions listed above.

The github-pr-title-prefix.ts val automatically prefixes PR titles with the linked issue number (inline, in the description) when a PR is opened or edited.

Setup:

• Create a GitHub webhook with the "Pull requests" event
• Point it to the title prefixer val URL
• Ensure your GitHub token has appropriate permissions

The github-pr-inherit-labels.ts val automatically copies labels from linked issues to the PR when a PR is opened or edited.

Setup:

• Create a GitHub webhook with the "Pull requests" event
• Point it to the label inheritor val URL
• Ensure your GitHub token has appropriate permissions