feat: add audit:repositories command

[dblandin]

Fetch and display information for repositories within the Artsy GitHub organization.

Initially to be used to aid in our switch from a default branch of master to main.

Usage:

$ artsy audit:repositories
$ artsy audit:repositories --csv
$ artsy audit:repositories --csv --default-branch=main
$ artsy audit:repositories --csv --default-branch=main --pushed=">2021-05-01"

@kajatiger Thought this might be a useful command to help with artsy/README#387!

[kajatiger]

Wow, this is a great idea! I was wondering how I could test this out locally. Can I somehow install the branch version with the npm command and try out the commands?
It could also be interesting to expand this with informations about maintainance/usage of the repository to discover unused or dead repos in order to keep the organization clean.

[artsyit]

🚀 PR was released in v0.18.0 🚀

[dblandin]

Wow, this is a great idea! I was wondering how I could test this out locally. Can I somehow install the branch version with the npm command and try out the commands?

We should definitely add some development instructions in the README!

The process right now would be to clone the repo locally, checkout the branch, install dependencies, setup, environment variables necessary... and then you can run against the local project via:

$ bin/run [command]
$ bin/run audit:repositories --csv

It could also be interesting to expand this with informations about maintainance/usage of the repository to discover unused or dead repos in order to keep the organization clean.

I like that idea! Another thought I have it that this would potentially made a good Peril task/rule. We have a similar rule that checks every day for repositories without a license and mangees a GitHub issue on the repository (link). We might consider a similar "Switch default branch to main" GitHub issue rule.