00Glossary / term
Dependency bump: a change that only updates the version of a dependency.
A dependency bump changes only the version of a package a project uses. Why a pull request that claims to be a bump should be checked for other changes.
01Definition
A version number, and nothing else.
A dependency bump is a change that updates the version of a package a project depends on, usually in a manifest and its lockfile. Tools such as Dependabot and Renovate open thousands of them, and coding agents open more.
Because they are routine, bumps are often merged with a glance. That habit is exactly what makes a mislabelled bump risky.
- Manifest and lockfile only
- Routine and frequent
- Often merged with a glance
02Why check the claim
“Just a bump” should be provable.
A pull request titled as a dependency bump that also edits source files is no longer a bump, whatever its description says. Sometimes that is a legitimate fix bundled in; sometimes it is a mistake; occasionally it is an attempt to hide a change behind a routine label. In every case a reviewer should know.
The check is mechanical: compare the files the change touches with the files a bump is allowed to touch.
- Descriptions are claims
- Extra edits deserve attention
- The check is mechanical
03In Verify
Built: the change-class check.
Verify checks whether a change that claims to be a dependency bump only touches dependency files. If the diff also edits code, the verdict is needs review and the comment names the files. A pure dependency-version bump whose tests pass can be accepted.
Built; Verify is not installable yet.
The waitlist
See this check on your own pull requests.
Verify is not installable yet. Join the waitlist to hear the day it is; teams with coding agents can also become design partners.
Join the waitlist