cve-lite-cli 1.16.0 โ 1.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -9
- package/dist/output/formatters.js +3 -0
- package/dist/output/html-reporter.js +3 -1
- package/dist/output/printers.js +13 -5
- package/dist/output/sarif.js +1 -0
- package/dist/parsers/index.js +31 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -25,9 +25,9 @@
|
|
|
25
25
|
|
|
26
26
|
<table>
|
|
27
27
|
<tr>
|
|
28
|
-
<td align="center" width="33%"><p
|
|
29
|
-
<td align="center" width="33%"><p
|
|
30
|
-
<td align="center" width="33%"><p
|
|
28
|
+
<td align="center" width="33%"><p>๐</p><strong>OWASP Incubator Project</strong><br/><sub>Peer-reviewed by the org behind the OWASP Top 10 โ<br/>the security standard followed by millions of developers</sub></td>
|
|
29
|
+
<td align="center" width="33%"><p>๐ฏ</p><strong>Remediation-first</strong><br/><sub>Validated fix commands + parent-aware<br/>transitive guidance โ not just CVE IDs</sub></td>
|
|
30
|
+
<td align="center" width="33%"><p>๐</p><strong>Runs locally</strong><br/><sub>Nothing leaves your machine โ not your<br/>code, not your dependency tree</sub></td>
|
|
31
31
|
</tr>
|
|
32
32
|
</table>
|
|
33
33
|
|
|
@@ -47,6 +47,23 @@
|
|
|
47
47
|
|
|
48
48
|
---
|
|
49
49
|
|
|
50
|
+
<div align="center">
|
|
51
|
+
|
|
52
|
+
**Package Managers**
|
|
53
|
+
|
|
54
|
+
<table border="0" cellspacing="0" cellpadding="12">
|
|
55
|
+
<tr>
|
|
56
|
+
<td align="center"><img src="https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons/npm/npm-original-wordmark.svg" width="48" height="48" alt="npm"/><br/><sub><b>npm</b></sub></td>
|
|
57
|
+
<td align="center"><img src="https://cdn.simpleicons.org/pnpm" width="48" height="48" alt="pnpm"/><br/><sub><b>pnpm</b></sub></td>
|
|
58
|
+
<td align="center"><img src="https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons/yarn/yarn-original.svg" width="48" height="48" alt="Yarn"/><br/><sub><b>Yarn</b></sub></td>
|
|
59
|
+
<td align="center"><img src="https://cdn.simpleicons.org/bun" width="48" height="48" alt="Bun"/><br/><sub><b>Bun</b></sub></td>
|
|
60
|
+
</tr>
|
|
61
|
+
</table>
|
|
62
|
+
|
|
63
|
+
</div>
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
50
67
|
## The problem with how security scanning works today
|
|
51
68
|
|
|
52
69
|
Most security tooling is designed around pipelines, not people.
|
|
@@ -160,6 +177,8 @@ For full CI patterns including offline workflows, git hooks, and scripted automa
|
|
|
160
177
|
|
|
161
178
|
## How it compares
|
|
162
179
|
|
|
180
|
+
No other free tool combines all of the following: lockfile scanning across npm, pnpm, Yarn, and Bun; parent-aware transitive remediation that tells you which package to upgrade (not just which one is vulnerable); fix version validation before suggesting an upgrade; and a fully offline advisory DB for restricted environments.
|
|
181
|
+
|
|
163
182
|
| Capability | CVE Lite CLI | npm audit | OSV-Scanner | Snyk CLI | Socket CLI |
|
|
164
183
|
|---|:---:|:---:|:---:|:---:|:---:|
|
|
165
184
|
| JS/TS lockfile scanning | โ
| โ
| โ
| โ
| โ
|
|
|
@@ -178,6 +197,9 @@ For full CI patterns including offline workflows, git hooks, and scripted automa
|
|
|
178
197
|
|
|
179
198
|
The transitive parent guidance is a key difference: CVE Lite CLI avoids recommending direct installs for packages that are only present transitively. For npm lockfiles, it can identify when `npm update <parent>` is enough to re-resolve a known non-vulnerable child within the current parent range, and when the parent package itself needs an upgrade.
|
|
180
199
|
|
|
200
|
+
### About Socket CLI
|
|
201
|
+
Socket provides deep supply-chain analysis (malware, typosquatting, maintainer risk) but requires a paid account for full features. CVE Lite CLI remains one of the few fully free, offline, and account-free options with strong transitive analysis.
|
|
202
|
+
|
|
181
203
|
For detailed per-tool analysis, see [Comparison with other tools](https://owasp.org/cve-lite-cli/docs/comparison).
|
|
182
204
|
|
|
183
205
|
## Real-world validation
|
|
@@ -187,14 +209,22 @@ CVE Lite CLI has been evaluated against real open-source projects to verify that
|
|
|
187
209
|
- [OWASP Juice Shop](https://owasp.org/cve-lite-cli/docs/case-studies/owasp-juice-shop) โ scanning a deliberately vulnerable application with known dependency issues
|
|
188
210
|
- [NestJS](https://owasp.org/cve-lite-cli/docs/case-studies/nestjs) โ working through a real transitive dependency remediation sequence across a widely-used Node.js framework
|
|
189
211
|
- [Analog](https://owasp.org/cve-lite-cli/docs/case-studies/analog) โ scanning a modern pnpm v9 Angular monorepo (3,367 packages) with unexpected toolchain vulnerabilities
|
|
212
|
+
- [Ghost](https://owasp.org/cve-lite-cli/docs/case-studies/ghost) โ 26 vulnerable packages across 4,447 resolved in a professionally maintained CMS โ every one transitive, including a critical XSS in the library responsible for making user content safe
|
|
190
213
|
|
|
191
214
|
These are not demos. They are documented scans against real codebases with real findings, recorded before and after applying fix commands.
|
|
192
215
|
|
|
193
216
|
If you maintain an open-source JavaScript or TypeScript project and want CVE Lite CLI evaluated on it, open an issue and share the repository. Strong candidates may be turned into future public case studies.
|
|
194
217
|
|
|
218
|
+
## Press
|
|
219
|
+
|
|
220
|
+
- **[CVE Lite CLI: Open-source dependency vulnerability scanner](https://www.helpnetsecurity.com/2026/05/20/cve-lite-cli-open-source-dependency-vulnerability-scanner/)** โ Help Net Security, May 2026
|
|
221
|
+
- **[Review of CVE Lite CLI](https://developmentcurated.com/testing-and-security/review-of-cve-lite-cli/)** โ Development Curated (Sebastian Raiffen, IT Security Consultant), April 2026
|
|
222
|
+
|
|
195
223
|
## Recognized by OWASP
|
|
196
224
|
|
|
197
|
-
|
|
225
|
+
OWASP (Open Web Application Security Project) is the globally recognized nonprofit behind the security standards followed by millions of developers worldwide โ most notably the [OWASP Top 10](https://owasp.org/www-project-top-ten/), the most widely cited web application security reference in the industry. Organizations from startups to Fortune 500 companies use OWASP guidelines as the foundation of their security programs.
|
|
226
|
+
|
|
227
|
+
CVE Lite CLI is an [OWASP Incubator Project](https://owasp.org/cve-lite-cli) โ reviewed and accepted by the OWASP community as a vendor-neutral, open source security tool. Being part of OWASP means:
|
|
198
228
|
|
|
199
229
|
- **Peer-reviewed** by security professionals
|
|
200
230
|
- **Community-driven** development and governance
|
|
@@ -365,12 +395,14 @@ See the [Offline Advisory DB guide](https://owasp.org/cve-lite-cli/docs/offline-
|
|
|
365
395
|
|
|
366
396
|
## Who uses it
|
|
367
397
|
|
|
368
|
-
CVE Lite CLI is a
|
|
398
|
+
CVE Lite CLI is the only free, OWASP-recognized vulnerability scanner purpose-built for JavaScript and TypeScript that combines validated fix commands, parent-aware transitive remediation, and offline scanning in a single lightweight CLI.
|
|
399
|
+
|
|
400
|
+
It is a good fit for:
|
|
369
401
|
|
|
370
|
-
- **Independent developers and OSS maintainers** โ quick pre-release check without any platform overhead
|
|
371
|
-
- **Startups and small teams** โ lightweight CI gate at no cost
|
|
372
|
-
- **Consultants** โ
|
|
373
|
-
- **Enterprise teams with restricted networks** โ offline advisory DB
|
|
402
|
+
- **Independent developers and OSS maintainers** โ quick pre-release check without any platform overhead or cost
|
|
403
|
+
- **Startups and small teams** โ lightweight CI gate at no cost, with fix commands ready to run immediately
|
|
404
|
+
- **Consultants** โ scan a client project in seconds and hand over a concrete, copy-and-run remediation plan
|
|
405
|
+
- **Enterprise teams with restricted networks** โ offline advisory DB removes the need for runtime outbound calls during scans
|
|
374
406
|
- **Teams running npm, pnpm, Yarn, and Bun** โ unified scanning across all four package managers in one tool
|
|
375
407
|
|
|
376
408
|
See the [CI and Workflow Integration guide](https://owasp.org/cve-lite-cli/docs/ci-integration) for concrete patterns across these scenarios.
|
|
@@ -28,6 +28,7 @@ export function renderHtmlReport(data) {
|
|
|
28
28
|
if (sev in counts)
|
|
29
29
|
counts[sev]++;
|
|
30
30
|
}
|
|
31
|
+
const totalCVEs = new Set(data.findings.flatMap(f => f.vulnerabilities.map(v => v.id))).size;
|
|
31
32
|
const noticesHtml = renderNotices(data.notes, data.warnings);
|
|
32
33
|
const fixPlanHtml = renderFixPlan(data.suggestedFixCommands);
|
|
33
34
|
const findingRowsHtml = data.findings.map(renderFindingRow).join("\n");
|
|
@@ -211,7 +212,8 @@ button.header-link:hover{color:#58a6ff;border-color:#58a6ff}
|
|
|
211
212
|
<div class="sev-card high"><span class="count">${counts.high}</span><span class="label">High</span></div>
|
|
212
213
|
<div class="sev-card medium"><span class="count">${counts.medium}</span><span class="label">Medium</span></div>
|
|
213
214
|
<div class="sev-card low"><span class="count">${counts.low}</span><span class="label">Low</span></div>
|
|
214
|
-
<div class="sev-card total"><span class="count">${data.findings.length}</span><span class="label">
|
|
215
|
+
<div class="sev-card total"><span class="count">${data.findings.length}</span><span class="label">Packages</span></div>
|
|
216
|
+
<div class="sev-card total"><span class="count">${totalCVEs}</span><span class="label">CVEs</span></div>
|
|
215
217
|
</div>
|
|
216
218
|
|
|
217
219
|
${fixPlanHtml}
|
package/dist/output/printers.js
CHANGED
|
@@ -2,7 +2,7 @@ import { chalk, stripAnsi } from "../utils/chalk.js";
|
|
|
2
2
|
import { buildSuggestedFixCommandPlan } from "../remediation/fix-commands.js";
|
|
3
3
|
import { isMajorVersionBump } from "../utils/version.js";
|
|
4
4
|
import { getPrimaryParent } from "../utils/finding.js";
|
|
5
|
-
import { formatSeverityLabel, formatRelationshipLabel } from "./formatters.js";
|
|
5
|
+
import { countUniqueAdvisories, formatSeverityLabel, formatRelationshipLabel } from "./formatters.js";
|
|
6
6
|
export function printSummary(findings, packageCount, scanInput) {
|
|
7
7
|
if (findings.length === 0) {
|
|
8
8
|
if (scanInput.mode === "manifest-fallback") {
|
|
@@ -13,6 +13,9 @@ export function printSummary(findings, packageCount, scanInput) {
|
|
|
13
13
|
}
|
|
14
14
|
return;
|
|
15
15
|
}
|
|
16
|
+
const totalCVEs = countUniqueAdvisories(findings);
|
|
17
|
+
const pkgLabel = findings.length === 1 ? "package" : "packages";
|
|
18
|
+
const cveLabel = totalCVEs === 1 ? "CVE" : "CVEs";
|
|
16
19
|
const counts = {
|
|
17
20
|
critical: findings.filter(f => f.severity === "critical").length,
|
|
18
21
|
high: findings.filter(f => f.severity === "high").length,
|
|
@@ -20,7 +23,7 @@ export function printSummary(findings, packageCount, scanInput) {
|
|
|
20
23
|
low: findings.filter(f => f.severity === "low").length,
|
|
21
24
|
unknown: findings.filter(f => f.severity === "unknown").length
|
|
22
25
|
};
|
|
23
|
-
console.log(chalk.redBright(`โ Found ${findings.length}
|
|
26
|
+
console.log(chalk.redBright(`โ Found ${findings.length} ${pkgLabel} (${totalCVEs} ${cveLabel}) with known OSV matches from ${scanInput.source}`));
|
|
24
27
|
console.log(renderSeverityTable(counts));
|
|
25
28
|
}
|
|
26
29
|
export function printActionSummary(findings) {
|
|
@@ -29,7 +32,7 @@ export function printActionSummary(findings) {
|
|
|
29
32
|
const direct = findings.filter(f => f.relationship === "direct").length;
|
|
30
33
|
const transitive = findings.filter(f => f.relationship === "transitive").length;
|
|
31
34
|
const unknown = findings.filter(f => f.relationship === "unknown").length;
|
|
32
|
-
const uniqueAdvisories =
|
|
35
|
+
const uniqueAdvisories = countUniqueAdvisories(findings);
|
|
33
36
|
const fixable = findings.filter(f => Boolean(f.firstFixedVersion)).length;
|
|
34
37
|
console.log("");
|
|
35
38
|
console.log(chalk.bold.cyan("Quick take"));
|
|
@@ -38,7 +41,7 @@ export function printActionSummary(findings) {
|
|
|
38
41
|
if (unknown > 0) {
|
|
39
42
|
console.log(`- ${chalk.magenta(String(unknown))} package${unknown === 1 ? "" : "s"} could not be clearly classified as direct or transitive.`);
|
|
40
43
|
}
|
|
41
|
-
console.log(`- ${chalk.blueBright(String(uniqueAdvisories))}
|
|
44
|
+
console.log(`- ${chalk.blueBright(String(uniqueAdvisories))} CVE${uniqueAdvisories === 1 ? "" : "s"} matched overall.`);
|
|
42
45
|
console.log(`- ${chalk.blue(String(fixable))} package${fixable === 1 ? "" : "s"} include a fixed-version hint from OSV.`);
|
|
43
46
|
}
|
|
44
47
|
export function printSuggestedFixCommands(findings, scanInput, options) {
|
|
@@ -367,7 +370,12 @@ export function printCompactOutput(findings, scanInput, options) {
|
|
|
367
370
|
parts.push(chalk.green(`${counts.low} low`));
|
|
368
371
|
if (counts.unknown > 0)
|
|
369
372
|
parts.push(chalk.gray(`${counts.unknown} unknown`));
|
|
370
|
-
|
|
373
|
+
const compactCVEs = countUniqueAdvisories(findings);
|
|
374
|
+
const compactPkgLabel = findings.length === 1 ? "package" : "packages";
|
|
375
|
+
const compactCveLabel = compactCVEs === 1 ? "CVE" : "CVEs";
|
|
376
|
+
console.log(`${chalk.whiteBright(String(findings.length))} ${compactPkgLabel}` +
|
|
377
|
+
chalk.gray(" ยท ") +
|
|
378
|
+
`${chalk.whiteBright(String(compactCVEs))} ${compactCveLabel}`);
|
|
371
379
|
console.log(parts.join(chalk.gray(" ยท ")));
|
|
372
380
|
console.log(`${chalk.cyan(String(direct))} ${chalk.white("direct")}` +
|
|
373
381
|
`${chalk.gray(" ยท ")}` +
|
package/dist/output/sarif.js
CHANGED
|
@@ -7,6 +7,7 @@ import { severityToSarifLevel } from "../utils/severity.js";
|
|
|
7
7
|
const SARIF_RULE_NAME = "VulnerableDependency";
|
|
8
8
|
const LOCKFILE_NAMES = {
|
|
9
9
|
"package-lock": "package-lock.json",
|
|
10
|
+
"npm-shrinkwrap": "npm-shrinkwrap.json",
|
|
10
11
|
"pnpm-lock": "pnpm-lock.yaml",
|
|
11
12
|
"yarn-lock": "yarn.lock",
|
|
12
13
|
"bun-lock": "bun.lockb",
|
package/dist/parsers/index.js
CHANGED
|
@@ -8,6 +8,7 @@ import { loadFromPnpmLock } from "./pnpm-lock.js";
|
|
|
8
8
|
import { loadFromYarnLock } from "./yarn-lock.js";
|
|
9
9
|
export function loadPackages(projectRoot, prodOnly, maxDepth) {
|
|
10
10
|
const rootBunLock = path.join(projectRoot, "bun.lock");
|
|
11
|
+
const rootShrinkwrap = path.join(projectRoot, "npm-shrinkwrap.json");
|
|
11
12
|
const rootPackageLock = path.join(projectRoot, "package-lock.json");
|
|
12
13
|
const rootPnpmLock = path.join(projectRoot, "pnpm-lock.yaml");
|
|
13
14
|
const rootYarnLock = path.join(projectRoot, "yarn.lock");
|
|
@@ -25,6 +26,20 @@ export function loadPackages(projectRoot, prodOnly, maxDepth) {
|
|
|
25
26
|
skippedDependencies: []
|
|
26
27
|
};
|
|
27
28
|
}
|
|
29
|
+
if (fs.existsSync(rootShrinkwrap)) {
|
|
30
|
+
return {
|
|
31
|
+
mode: "resolved-lockfile",
|
|
32
|
+
source: "npm-shrinkwrap",
|
|
33
|
+
filePath: rootShrinkwrap,
|
|
34
|
+
packages: loadFromPackageLock(rootShrinkwrap, prodOnly),
|
|
35
|
+
notes: [
|
|
36
|
+
"Scanned resolved dependency versions from npm-shrinkwrap.json.",
|
|
37
|
+
"Dependency paths are derived from lockfile package locations."
|
|
38
|
+
],
|
|
39
|
+
warnings: [],
|
|
40
|
+
skippedDependencies: []
|
|
41
|
+
};
|
|
42
|
+
}
|
|
28
43
|
if (fs.existsSync(rootPackageLock)) {
|
|
29
44
|
return {
|
|
30
45
|
mode: "resolved-lockfile",
|
|
@@ -67,7 +82,7 @@ export function loadPackages(projectRoot, prodOnly, maxDepth) {
|
|
|
67
82
|
skippedDependencies: []
|
|
68
83
|
};
|
|
69
84
|
}
|
|
70
|
-
const discoveredLockfiles = findFiles(projectRoot, ["bun.lock", "package-lock.json", "pnpm-lock.yaml", "yarn.lock"], maxDepth);
|
|
85
|
+
const discoveredLockfiles = findFiles(projectRoot, ["bun.lock", "npm-shrinkwrap.json", "package-lock.json", "pnpm-lock.yaml", "yarn.lock"], maxDepth);
|
|
71
86
|
if (discoveredLockfiles.length > 0) {
|
|
72
87
|
const selected = chooseBestLockfile(discoveredLockfiles);
|
|
73
88
|
const selectedName = path.basename(selected);
|
|
@@ -85,6 +100,20 @@ export function loadPackages(projectRoot, prodOnly, maxDepth) {
|
|
|
85
100
|
skippedDependencies: []
|
|
86
101
|
};
|
|
87
102
|
}
|
|
103
|
+
if (selectedName === "npm-shrinkwrap.json") {
|
|
104
|
+
return {
|
|
105
|
+
mode: "resolved-lockfile",
|
|
106
|
+
source: "npm-shrinkwrap",
|
|
107
|
+
filePath: selected,
|
|
108
|
+
packages: loadFromPackageLock(selected, prodOnly),
|
|
109
|
+
notes: [
|
|
110
|
+
`Scanned resolved dependency versions from ${relativeOrName(projectRoot, selected)}.`,
|
|
111
|
+
"Dependency paths are derived from lockfile package locations."
|
|
112
|
+
],
|
|
113
|
+
warnings: ["No supported lockfile was found at the repo root, so a nested lockfile was used instead."],
|
|
114
|
+
skippedDependencies: []
|
|
115
|
+
};
|
|
116
|
+
}
|
|
88
117
|
if (selectedName === "package-lock.json") {
|
|
89
118
|
return {
|
|
90
119
|
mode: "resolved-lockfile",
|
|
@@ -166,7 +195,7 @@ export function loadPackages(projectRoot, prodOnly, maxDepth) {
|
|
|
166
195
|
export function buildNoPackagesMessage(projectRoot) {
|
|
167
196
|
return [
|
|
168
197
|
"No scannable packages were found.",
|
|
169
|
-
"Supported inputs: bun.lock, package-lock.json, pnpm-lock.yaml, yarn.lock, or package.json with exact pinned versions.",
|
|
198
|
+
"Supported inputs: bun.lock, npm-shrinkwrap.json, package-lock.json, pnpm-lock.yaml, yarn.lock, or package.json with exact pinned versions.",
|
|
170
199
|
`Searched under: ${projectRoot}`
|
|
171
200
|
].join(" ");
|
|
172
201
|
}
|