mitchellh/vouch — 5.2k★ trên GitHub (Nushell). A community trust management system based on explicit vouches to participate.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
People must be vouched for before
interacting with certain parts of a project (the exact parts are
configurable to the project to enforce). People can also be explicitly
denounced to block them from interacting with the project.
The implementation is generic and can be used by any project on any code forge,
but we provide GitHub integration out of the box via GitHub actions
and the CLI.
The vouch list is maintained in a single flat file using a minimal format
that can be trivially parsed using standard POSIX tools and any programming
language without external libraries.
This project is based on the already successful system in use by
the Pi project. I took what they
already do and extracted it into a more generalizable system with some
other changes.
[!WARNING]
This is an experimental system in use by Ghostty.
We'll continue to improve the system based on experience and feedback.
Why?
Open source has always worked on a system of trust and verify.
Historically, the effort required to understand a codebase, implement
a change, and submit that change for review was high enough that it
naturally filtered out many low quality contributions from unqualified people.
For over 20 years of my life, this was enough for my projects as well
as enough for most others.
Unfortunately, the landscape has changed particularly with the advent
of AI tools that allow people to trivially create plausible-looking but
extremely low-quality contributions with little to no true understanding.
Contributors can no longer be trusted based on the minimal barrier to entry
to simply submit a change.
But, open source still works on trust! And every project has a definite
group of trusted individuals (maintainers) and a larger group of probably
trusted individuals (active members of the community in any form). So,
let's move to an explicit trust model where trusted individuals can vouch
for others, and those vouched individuals can then contribute.
Who is Vouched?
Who and how someone is vouched or denounced is left entirely up to the
project integrating the system. Additionally, what consequences
a vouched or denounced person has is also fully up to the project.
Implement a policy that works for your project and community.
Usage
GitHub
Integrating vouch into a GitHub project is easy with the
provided GitHub Actions.
By choosing which actions to use, you can fully control how
users are vouched and what they can or can't do.
For an example, look at this repository! It fully integrates vouch.
Below is a list of the actions and a brief description of their function.
See the linked README in the action directory for full usage details.
Action
Trigger
Description
check-issue
issues
Check if an issue author is vouched on open or reopen. Bots and collaborators with write access are automatically allowed. Optionally auto-close and lock issues from unvouched or denounced users.
check-pr
pull_request_target
Check if a PR author is vouched on open or reopen. Bots and collaborators with write access are automatically allowed. Optionally auto-close PRs from unvouched or denounced users.
check-user
Any
Check if a GitHub user is vouched. Outputs the user's status and fails the step by default if the user is not vouched. Set allow-fail to only report via output.
manage-by-discussion
discussion_comment
Let collaborators vouch, denounce, or unvouch users via discussion comments. Updates the vouched file and commits the change.
manage-by-issue
issue_comment
Let collaborators vouch or denounce users via issue comments. Updates the vouched file and commits the change.
sync-codeowners
Any
Sync CODEOWNERS owners into the vouch list by vouching missing users.
setup-vouch
Any
Install the vouch CLI on PATH. Nushell is installed automatically if not already available.
CLI
The CLI is implemented as a Nushell module and only requires
Nushell to run. There are no other external dependencies.
Integrated Help
This is Nushell, so you can get help on any command:
use vouch *
help add
help check
help denounce
help gh-check-issue
help gh-check-pr
help gh-manage-by-issue
Responds to comments from collaborators with sufficient role
(admin, maintain, write, or triage by default):
vouch — vouches for the issue author
vouch @user — vouches for a specific user
vouch <reason> — vouches for the issue author with a reason
vouch @user <reason> — vouches for a specific user with a reason
denounce — denounces the issue author
denounce @user — denounces a specific user
denounce <reason> — denounces the issue author with a reason
denounce @user <reason> — denounces a specific user with a reason
Keywords are customizable via --vouch-keyword and --denounce-keyword.
You can also allow specific managers listed in a separate VOUCHED file
via --vouched-managers.
Outputs status: vouched, denounced, or unchanged.
Library
The module also exports a lib submodule for scripting:
use vouch/lib.nu *
let records = open VOUCHED.td
$records | check-user "mitchellh" --default-platform github # "vouched", "denounced", or "unknown"
$records | add-user "newuser" # returns updated table
$records | denounce-user "badactor" "reason" # returns updated table
$records | remove-user "olduser" # returns updated table
Vouched File Format
The vouch list is stored in a .td file. See
VOUCHED.example.td for an example. The file is
looked up at VOUCHED.td or .github/VOUCHED.td by default.
# Comments start with #
username
platform:username
-platform:denounced-user
-platform:denounced-user reason for denouncement
One handle per line (without @), sorted alphabetically.
Optionally specify a platform prefix: platform:username (e.g., github:mitchellh).
Denounce a user by prefixing with -.
Optionally add details after a space following the handle.
The from td and to td commands are exported by the module, so
Nushell's open command works natively with .td files to decode
into structured tables and encode back to the file format with
comments and whitespace preserved.
[!NOTE]
What is .td? This stands for "Trustdown," a play on the
word "Markdown." I intend to formalize a specification for trust
lists (with no opinion on how they're created or used) so that software
systems like this Vouch project and others can coordinate with each
other. I'm not ready to publish a specification until vouch itself
stabilizes usage more.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/mitchellh/vouch là nguồn chính thức.
mitchellh/vouch có bao nhiêu sao?
mitchellh/vouch có 5.2k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/mitchellh/vouch. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
mitchellh/vouch có phải mã nguồn mở không?
Có — mitchellh/vouch phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/mitchellh/vouch.
mitchellh/vouch còn đang phát triển không?
Commit gần nhất trên mitchellh/vouch là 1 tháng trước (theo timestamp GitHub). Repo có 92 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
mitchellh/vouch là gì?
mitchellh/vouch (mitchellh/vouch) là dự án Nushell trên GitHub. Theo mô tả gốc: A community trust management system based on explicit vouches to participate.
mitchellh/vouch so với các dự án Automation khác thế nào?
mitchellh/vouch được TopGit xếp vào nhóm Automation, với 5.2k sao GitHub và viết bằng Nushell. Xem trang chủ đề Automation trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về vouch?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về vouch.