Goodfaith

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.

  1. 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: .github/goodfaith.json and .github/VOUCHED.td.

    Install on GitHub
  2. 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
    }
    Open on GitHub

    Already use mitchellh/vouch? Goodfaith reads the same .github/VOUCHED.td, so the people on it skip the gate.

  3. 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.