Put Goodfaith on a repository
Install the GitHub App, set your bounds in one file, and the next stranger's pull request meets the two doors: a free vouch, or a refundable PayPal hold.
Use a test repository. This hosted Goodfaith runs on PayPal's sandbox for the PayPal AI Hackathon, so a hold there needs a PayPal sandbox account and no real money moves. A live install needs its own PayPal app, as the README describes.
Install the app
Choose the repositories it may act on. It writes a check, comments and a label on a stranger's pull request, and closes one only when a maintainer forfeits. It reads that pull request's diff for the AI's brief, and two files:
Install on GitHub.github/goodfaith.jsonand.github/VOUCHED.td.Set the bounds
Maintainers set them in the repository, through the same review as any other change, and anyone can read them. Without a file, the defaults below apply.
The AI picks low, medium or high, and code turns that into the smallest, usual or largest hold. It can never name another amount.
// .github/goodfaith.json { "min_cents": 200, "default_cents": 500, "max_cents": 2500, "appeal_days": 7, "payout_receiver": null, "trust_earned_elsewhere": true }Already use mitchellh/vouch? Goodfaith reads the same
.github/VOUCHED.td, so the people on it skip the gate.Check it
Goodfaith reads what the gate will read on the next stranger's pull request, and says what it found. Anyone can run this check, so it reads public repositories only, and a private one shows as not installed.
Then
A stranger's pull request gets a check and one comment with both doors. A maintainer answers with !vouch, a review, or !forfeit <reason>, and every step lands on the public ledger. To see both sides first without installing anything, try it on the demo repository.