Skip to content

ddnet-repo/roadsman

Repository files navigation

Roadsman

GitHub App that auto-closes low-signal PRs. Pay to reopen.

Clear the bar with signal, or clear it with a dollar.

What it does

  1. Watches pull_request.opened events
  2. Runs detection heuristics on title, body, and code patches
  3. If flagged: posts a comment with a payment link, then closes the PR
  4. If clean: does nothing

Not a moderation platform. Not a jury system. A toll road.

Detection signals

  • Emoji in PR title/body
  • Emoji in code
  • AI boilerplate phrases ("This PR implements...", "Key changes:", "Feel free to...")
  • Disproportionately long descriptions for small changes
  • Verbose explanatory code comments
  • Heavy bullet/numbered list formatting

Threshold is score-based. Single weak signals don't trigger. Combined signals do.

Install

Two clicks:

  1. Go to https://github.com/apps/YOUR_APP_NAME/installations/new
  2. Select your repos

That's it.

Permissions granted

  • Pull requests: Read & write (to comment and close)
  • Issues: Read & write (PR comments use the Issues API)
  • Metadata: Read

Cannot push code. Cannot read secrets. Cannot delete anything.

Self-hosting

npm install
npm run build
npm start

Required env vars

GITHUB_APP_ID=
GITHUB_PRIVATE_KEY=           # PEM or base64-encoded PEM
GITHUB_WEBHOOK_SECRET=
STRIPE_PAYMENT_LINK_URL=      # Static link, no processing

Optional

REOPEN_FEE_USD=10             # Shown in comment
PORT=3000
DRY_RUN=false                 # true = log only, no actions

Endpoints

  • POST /webhook — GitHub webhook receiver
  • GET /health — Returns {"status":"ok"}

The contract

If you want a human's time, don't dump slop. If you still want to push slop, drop a buck.

Both are valid. One is cheaper.

License

MIT

About

Pull request traffic control for maintainers.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors