feat: add EPSS Priority Signal (severity x exploitation likelihood) - #1067
Merged
Conversation
…kelihood Introduces a four-tier priority classification per finding by combining CVSS-derived severity with EPSS exploitation likelihood percentile. Tiers: fix_now (high impact + top-10% EPSS), fix_soon (high impact), monitor (lower severity + top-10% EPSS), low_priority (all else). Null when no EPSS data is available. Surfaces in terminal compact mode (Fix Now label), verbose table (EPSS Priority column), JSON (prioritySignal field), and HTML report (column, detail badge with raw percentile, and four-tier legend). Closes #1066
Merged
This was referenced Sep 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Combines CVSS-derived severity with EPSS exploitation likelihood percentile into a single actionable priority tier per finding - the first free JS/TS vulnerability scanner to ship this classification built in.
Four tiers
fix_now- critical or high severity + EPSS top 10% (top 10% most likely to be exploited across all published CVEs)fix_soon- critical or high severity, EPSS below top 10%monitor- medium or lower severity, EPSS top 10%low_priority- medium or lower severity, EPSS below top 10%Surfaces in
⚡ Fix Nowinline forfix_nowfindings onlyprioritySignalfield on each finding (nullwhen no EPSS data is available)Changes
src/utils/priority-signal.ts- classification logic, label maps, legend descriptionssrc/output/formatters.ts-prioritySignaladded toserializeFinding()src/output/printers.ts- EPSS Priority column, type-safe signal coloring, sort by percentilesrc/output/html-reporter.ts- EPSS and EPSS Priority columns, detail panel, legendsrc/output/multi-folder-html-reporter.ts- matching columns and legendexamples/priority-signal/- example fixture with real high-EPSS packageswebsite/docs/cli-reference.md- EPSS Priority Signal section and updated flag descriptionsCloses #1066