TL;DR

The software check-up.

Five pieces work together to check whether an open source project is safe. Here they are as a trip to the doctor.

Meet the cast

Each card links to the real thing.

The checklist

OSPS Baseline

A list of things every healthy project should do. "Lock the front door. Tell people how to report a problem."

The nurse

pvtr-github-repo-scanner

Knows the checklist by heart. Looks at a GitHub project and marks every item on the list.

The clinic

privateer (the pvtr command)

The building where nurses work. You walk in, and it calls the right nurse for you.

The training kit

privateer-sdk

Everything you need to train a new nurse. The clinic is built from it too.

The scoreboard

grc.store

A public wall where results get pinned. Anyone can walk by and see who's healthy.

What a check-up looks like

Run it once by hand, or let a GitHub Action run it on a schedule.

  1. Open the clinicrun pvtr run
  2. The nurse checksevery item on ๐Ÿ“‹
  3. A report card PassedFailedNeedsReview
  4. Pin it upon grc.store

How they lean on each other

The kit builds the clinic and the nurse. The nurse reads the checklist. The grades go to the scoreboard.

  1. Kitbuilds
  2. Clinicand
  3. Nursewho reads
  4. Checklistand sends grades to
  5. Scoreboard 

The funny part

The clinic gets a check-up too.

Every week the nurse checks pvtr and privateer-sdk, the very clinic it works in. Their report cards hang on the scoreboard like everyone else's.

Try it in 5 minutes → Read the full introduction