Commit 994b48d
authored
docs: add --min-release-age as supply chain mitigation (#73)
Add dependency cooldown (--min-release-age, npm v11.10.0+) to the
supply chain attack mitigations in the security best practices guide.
Recommend a 1-day cooldown as the minimum effective value.
Every major npm supply chain incident in 2025-2026 had an exposure
window well under 24 hours, making even a 1-day delay sufficient:
- Nx/s1ngularity (Aug 2025): ~4-5h window
https://nx.dev/blog/s1ngularity-postmortem
- Shai-Hulud (Sep 2025): hours before detection
https://www.wiz.io/blog/shai-hulud-npm-supply-chain-attack
- axios (Mar 2026): ~2-3h window, 100M weekly downloads
https://workos.com/blog/axios-npm-supply-chain-attack
- TanStack (May 2026): ~30 min window, 42 packages
https://tanstack.com/blog/npm-supply-chain-compromise-postmortem
Other projects also propose cooldown as a mitigation:
pnpm 11 ships with minimumReleaseAge enabled by default (1 day):
https://pnpm.io/blog/releases/11.0
StepSecurity Secure Registry offers a configurable cooldown and
confirmed their customers were unaffected during the May 2026
@AntV compromise:
https://www.stepsecurity.io/blog/introducing-secure-registry-install-time-defense-for-the-npm-supply-chain
Signed-off-by: Norbert Manthey <nmanthey@amazon.de>1 parent 0de0329 commit 994b48d
1 file changed
Lines changed: 14 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
270 | 270 | | |
271 | 271 | | |
272 | 272 | | |
| 273 | + | |
| 274 | + | |
| 275 | + | |
| 276 | + | |
| 277 | + | |
| 278 | + | |
| 279 | + | |
| 280 | + | |
| 281 | + | |
| 282 | + | |
| 283 | + | |
| 284 | + | |
| 285 | + | |
273 | 286 | | |
274 | 287 | | |
275 | 288 | | |
| |||
485 | 498 | | |
486 | 499 | | |
487 | 500 | | |
| 501 | + | |
0 commit comments