DCO: AGENTS.md promises identity enforcement that neither the hook nor CI does

Đang mở
#1,014 0 bình luận 0 reaction 2 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@jiwenc-nv đang làm issue này rồi.

Từ ngày 25/8/2026.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

NVIDIA

Two things to settle: a doc claim that is currently false, and — if we want to make it true — which rule survives contact with how the repo is actually used.

The gap

AGENTS.md § Commits states:

The name and e-mail must match the committer's git identity (git config user.name / git config user.email).

A commit-msg pre-commit hook enforces this.

Neither half is enforced:

  • scripts/check_dco_signoff.py matches ^Signed-off-by: \S.*<\S+> and stops. It never reads git config; the identity requirement appears only inside its own error text.
  • .github/workflows/dco.yml checks the trailer is present and well-formed. No identity comparison.

So Signed-off-by: Anybody <[email protected]> passes locally and in CI. That matters because a sign-off certifies that you have the right to submit the work — a trailer naming someone else certifies nothing.

Why the obvious fix is wrong

I wrote the strict version (compare against GIT_COMMITTER_IDENT, require at least one matching trailer), and it passed every case I could invent. Then I ran it against six months of real history:

count share
non-merge commits on main 586
sign-off matches author 155 26%
no sign-off at all 405 69%
sign-off present, does not match 26 4%

The 405 are largely an artifact — 229 carry a (#NNN) subject, i.e. squash merges, where the message is rewritten and the trailer is dropped. What lands on main says little about what the contributor committed.

The 26 real mismatches are the problem, because they are not abuse:

author=farbod-nv <[email protected]>
signed=Farbod Motlagh <[email protected]>       same address; the git name is a GitHub handle

author=rwiltz <[email protected]>
signed=Rafael Wiltz <[email protected]>           GitHub noreply vs corporate address

Both are arguably more DCO-correct than the git identity is: the DCO asks for a real legal name, and git author names are routinely the GitHub handle. A strict name comparison would have blocked at least three contributors mid-workflow to close a gap nobody is exploiting. I closed #1013 for that reason.

What to decide

1. Do we want identity enforcement at all? If not, the fix is one line — stop claiming it in AGENTS.md, keep presence-only checking. That is a legitimate answer; the DCO's force comes from the act of signing, not from a machine verifying the name.

2. If yes, which rule? Candidates, roughly in order of how much they would disrupt:

rule catches breaks
e-mail only, ignore name wrong person entirely noreply-vs-corporate users
e-mail, with *[email protected] → corporate mapping same nothing visible in the sample
warn, do not block nothing, but surfaces it nothing
full name + e-mail everything at least 3 current contributors

3. Local, CI, or both? The hook is commit-msg, so --no-verify bypasses it and CI sees nothing. dco.yml is the only place a guarantee can actually hold — but that changes what CI rejects for everyone, which is why this is an issue and not a PR.

Notes

  • A working strict implementation exists on ivany-nv/dco-identity-check (d132e9a37) if a variant of it turns out to be wanted. Do not merge it as-is.
  • Whatever we pick, AGENTS.md and dco.yml should end up saying the same thing. Today they disagree with each other and with the hook.

cc @jiwenc — you own AGENTS.md § Commits and both DCO checks.

Ngôn ngữ chính
Python
Star
435
Fork
105
Merge trung bình
1 ngày 11 giờ
Pull request đã merge (30 ngày)
166

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của NVIDIA/IsaacCapture

Tất cả issue của NVIDIA/IsaacCapture

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.