cve-lite-cli 1.12.0 → 1.13.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 +52 -2
- package/dist/index.js +3 -7
- package/dist/output/formatters.js +31 -17
- package/dist/output/printers.js +42 -159
- package/dist/parsers/npm-lock-graph.js +10 -5
- package/dist/parsers/package-lock.js +6 -2
- package/dist/parsers/yarn-lock.js +31 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
[](https://github.com/marketplace/actions/cve-lite-cli)
|
|
7
7
|
[](https://github.com/OWASP/cve-lite-cli/blob/main/LICENSE)
|
|
8
8
|
[](https://github.com/OWASP/cve-lite-cli)
|
|
9
|
+
[](https://www.bestpractices.dev/projects/12731)
|
|
9
10
|
|
|
10
11
|
<div align="center">
|
|
11
12
|
<a href="https://owasp.org/cve-lite-cli">
|
|
@@ -39,7 +40,8 @@
|
|
|
39
40
|
<a href="https://owasp.org/cve-lite-cli/docs/html-report">HTML Report</a> •
|
|
40
41
|
<a href="https://owasp.org/cve-lite-cli/docs/comparison">Compare</a> •
|
|
41
42
|
<a href="https://owasp.org/cve-lite-cli/docs/roadmap">Roadmap</a> •
|
|
42
|
-
<a href="https://github.com/OWASP/cve-lite-cli/blob/main/src/docs/CONTRIBUTING.md">Contributing</a>
|
|
43
|
+
<a href="https://github.com/OWASP/cve-lite-cli/blob/main/src/docs/CONTRIBUTING.md">Contributing</a> •
|
|
44
|
+
<a href="https://owasp.org/slack/invite">Join Slack</a>
|
|
43
45
|
</p>
|
|
44
46
|
</div>
|
|
45
47
|
|
|
@@ -110,7 +112,7 @@ No account. No configuration. No source code leaves your machine.
|
|
|
110
112
|
</td>
|
|
111
113
|
</tr>
|
|
112
114
|
<tr>
|
|
113
|
-
<td align="center"><sub>Default scan output · <a href="https://owasp.org/cve-lite-cli/docs/
|
|
115
|
+
<td align="center"><sub>Default scan output · <a href="https://owasp.org/cve-lite-cli/docs/reading-output">output guide</a></sub></td>
|
|
114
116
|
<td align="center"><sub>Generated with <code>--report</code> · <a href="https://owasp.org/cve-lite-cli/docs/html-report">HTML report guide</a></sub></td>
|
|
115
117
|
</tr>
|
|
116
118
|
</table>
|
|
@@ -375,6 +377,52 @@ npm install
|
|
|
375
377
|
npm run build
|
|
376
378
|
```
|
|
377
379
|
|
|
380
|
+
## Governance
|
|
381
|
+
|
|
382
|
+
CVE Lite CLI is an OWASP Incubator Project maintained by Sonu Kapoor as project lead. The project follows a single-maintainer (benevolent dictator) governance model. The project lead makes final decisions on scope, design direction, and releases after considering input from contributors and the wider community.
|
|
383
|
+
|
|
384
|
+
### Roles
|
|
385
|
+
|
|
386
|
+
- **Project lead** — currently Sonu Kapoor. Owns the roadmap, sets release cadence, reviews and merges pull requests, and acts as the OWASP project leader for the Foundation.
|
|
387
|
+
- **Contributors** — anyone who opens an issue, proposes a pull request, or improves the documentation. No prior commit history is required to contribute, and contributions are welcome from outside OWASP.
|
|
388
|
+
|
|
389
|
+
### Decision-making
|
|
390
|
+
|
|
391
|
+
- Significant changes (new features, breaking changes, scope decisions) start as a GitHub issue so the design can be discussed in public before code is written.
|
|
392
|
+
- Pull requests are reviewed by the project lead. Small fixes can land directly. Larger changes may require revision or follow-up issues.
|
|
393
|
+
- Releases are cut by the project lead when accumulated changes warrant a version bump, following the process in [CONTRIBUTING.md](https://github.com/OWASP/cve-lite-cli/blob/main/src/docs/CONTRIBUTING.md).
|
|
394
|
+
|
|
395
|
+
### Dispute resolution
|
|
396
|
+
|
|
397
|
+
Technical disagreements are resolved by the project lead after weighing contributor input. Disputes that relate to community standards or [Code of Conduct](https://github.com/OWASP/cve-lite-cli/blob/main/CODE_OF_CONDUCT.md) enforcement can be escalated to the OWASP Foundation, which acts as a backstop for the project's community norms.
|
|
398
|
+
|
|
399
|
+
This governance model may evolve as the contributor base grows. Any change to the model will be documented here and announced via the GitHub repository.
|
|
400
|
+
|
|
401
|
+
## Security and verification
|
|
402
|
+
|
|
403
|
+
CVE Lite CLI signs both the source code release and the build artifact for each release. Either signature is sufficient on its own.
|
|
404
|
+
|
|
405
|
+
**Source code (signed git tags).** Starting with releases after v1.12.1, every release tag is a GPG-signed annotated tag. The project lead's public key is published at [`https://github.com/sonukapoor.gpg`](https://github.com/sonukapoor.gpg). The private key is held only on the project lead's local machine — not on GitHub, not on the npm registry, not in CI. Verify with:
|
|
406
|
+
|
|
407
|
+
```bash
|
|
408
|
+
curl -sSL https://github.com/sonukapoor.gpg | gpg --import
|
|
409
|
+
git tag -v vX.Y.Z
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
**Release tarball (Sigstore Artifact Attestations).** Each GitHub release attaches an `cve-lite-cli-X.Y.Z.tgz` asset signed at build time via [GitHub Artifact Attestations](https://docs.github.com/en/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds). The signing keys are ephemeral OIDC-issued keys generated per build, providing SLSA Level 2 equivalent build provenance. Verify with:
|
|
413
|
+
|
|
414
|
+
```bash
|
|
415
|
+
gh attestation verify cve-lite-cli-X.Y.Z.tgz --repo OWASP/cve-lite-cli
|
|
416
|
+
```
|
|
417
|
+
|
|
418
|
+
**npm-installed package.** The npm registry adds an ECDSA signature to every published package, independent of the project's own signing keys above:
|
|
419
|
+
|
|
420
|
+
```bash
|
|
421
|
+
npm audit signatures
|
|
422
|
+
```
|
|
423
|
+
|
|
424
|
+
For full verification details, fingerprints, and security issue reports, see [SECURITY.md](https://github.com/OWASP/cve-lite-cli/blob/main/src/docs/SECURITY.md). For the project's threat model, trust boundaries, and how common implementation weaknesses are countered, see the [Security Assurance Case](https://owasp.org/cve-lite-cli/docs/security-assurance-case).
|
|
425
|
+
|
|
378
426
|
## Contributing
|
|
379
427
|
|
|
380
428
|
Feedback on output clarity, remediation guidance, ecosystem coverage, and CI usage is especially valuable.
|
|
@@ -399,6 +447,8 @@ Helpful feedback includes reproducible bug reports, real-world lockfile edge cas
|
|
|
399
447
|
|
|
400
448
|
For security-related reporting: [SECURITY.md](https://github.com/OWASP/cve-lite-cli/blob/main/src/docs/SECURITY.md)
|
|
401
449
|
|
|
450
|
+
This project follows a [Code of Conduct](https://github.com/OWASP/cve-lite-cli/blob/main/CODE_OF_CONDUCT.md). Please review it before participating.
|
|
451
|
+
|
|
402
452
|
If CVE Lite CLI helps your release workflow, a [GitHub star](https://github.com/OWASP/cve-lite-cli) helps more developers find it.
|
|
403
453
|
|
|
404
454
|
---
|
package/dist/index.js
CHANGED
|
@@ -18,7 +18,7 @@ import { getCliVersion } from "./utils/version-info.js";
|
|
|
18
18
|
import { isLikelyBlockedAdvisoryRequestError } from "./utils/network.js";
|
|
19
19
|
import { logInfo, logWarn, printCacheSummary, serializeFinding, sortFindingsForOutput } from "./output/formatters.js";
|
|
20
20
|
import { buildReportData, writeHtmlReport } from "./output/html-reporter.js";
|
|
21
|
-
import { printSummary, printActionSummary,
|
|
21
|
+
import { printSummary, printActionSummary, printSuggestedFixCommands, printSuggestedFixCommandSkips, printCoverage, printSkippedDependencies, printTable, printFinalStatus, printCompactOutput } from "./output/printers.js";
|
|
22
22
|
let parsedArgs = null;
|
|
23
23
|
try {
|
|
24
24
|
parsedArgs = parseArgs(process.argv.slice(2));
|
|
@@ -202,29 +202,25 @@ if (parsedArgs) {
|
|
|
202
202
|
printSummary(scanState.sorted, packages.length, scanInput);
|
|
203
203
|
printActionSummary(scanState.sorted);
|
|
204
204
|
printSuggestedFixCommands(scanState.sorted, scanInput, { offline });
|
|
205
|
-
printPriorityFixes(scanState.sorted);
|
|
206
|
-
printFixPlan(scanState.sorted);
|
|
207
205
|
printSuggestedFixCommandSkips(scanState.sorted, scanInput, { offline });
|
|
208
|
-
printCoverage([...scanInput.notes, ...scanState.coverage]);
|
|
209
206
|
if (scanInput.skippedDependencies.length > 0) {
|
|
210
207
|
printSkippedDependencies(scanInput.skippedDependencies);
|
|
211
208
|
}
|
|
212
209
|
if (scanState.sorted.length > 0) {
|
|
213
|
-
printGroupSummary(scanState.sorted);
|
|
214
210
|
if (scanState.tableFindings.length > 0) {
|
|
215
211
|
printTable(scanState.tableFindings, options.all ? null : scanState.minSeverity);
|
|
216
|
-
printPathHints(scanState.tableFindings);
|
|
217
212
|
}
|
|
218
213
|
else {
|
|
219
214
|
logInfo(`No findings met the table threshold of ${scanState.minSeverity}. Re-run with --all to show everything.`, options);
|
|
220
215
|
}
|
|
221
216
|
}
|
|
217
|
+
printCoverage([...scanInput.notes, ...scanState.coverage]);
|
|
222
218
|
printFinalStatus(scanState.sorted);
|
|
223
219
|
}
|
|
224
220
|
else {
|
|
225
221
|
// Simplified output - cleaner, focused view
|
|
226
222
|
const offline = !!options.offline || !!options.offlineDb;
|
|
227
|
-
printCompactOutput(scanState.sorted, scanInput, { offline });
|
|
223
|
+
printCompactOutput(scanState.sorted, scanInput, { offline, all: !!options.all });
|
|
228
224
|
}
|
|
229
225
|
if (options.report) {
|
|
230
226
|
const outputDir = path.resolve(typeof options.report === "string" ? options.report : "./cve-report");
|
|
@@ -26,8 +26,13 @@ export function formatRelationshipLabel(value) {
|
|
|
26
26
|
return chalk.gray(value);
|
|
27
27
|
}
|
|
28
28
|
export function getRecommendedAction(finding) {
|
|
29
|
-
|
|
30
|
-
|
|
29
|
+
// Prefer the registry-validated target over the raw advisory hint when
|
|
30
|
+
// available — they can disagree (the hint may not be published on npm or
|
|
31
|
+
// may itself be vulnerable), and the validated target is what the fix
|
|
32
|
+
// command actually uses.
|
|
33
|
+
const directTarget = finding.validatedFirstFixedVersion ?? finding.firstFixedVersion;
|
|
34
|
+
if (finding.relationship === "direct" && directTarget) {
|
|
35
|
+
return `Upgrade ${finding.pkg.name} to ${directTarget}+ in this project.`;
|
|
31
36
|
}
|
|
32
37
|
if (finding.relationship === "direct") {
|
|
33
38
|
return `Review and upgrade ${finding.pkg.name} directly in this project.`;
|
|
@@ -43,16 +48,20 @@ export function getRecommendedAction(finding) {
|
|
|
43
48
|
return `Upgrade ${finding.recommendedParentUpgrade.package} from ${finding.recommendedParentUpgrade.currentVersion} to ${finding.recommendedParentUpgrade.targetVersion} to stop pulling in vulnerable ${finding.pkg.name}.`;
|
|
44
49
|
}
|
|
45
50
|
const parent = getPrimaryParent(finding);
|
|
46
|
-
if (parent &&
|
|
47
|
-
return `Upgrade ${parent} — no safe version was identified automatically. Check for a release that resolves ${finding.pkg.name} to ${
|
|
51
|
+
if (parent && directTarget) {
|
|
52
|
+
return `Upgrade ${parent} — no safe version was identified automatically. Check for a release that resolves ${finding.pkg.name} to ${directTarget}+.`;
|
|
48
53
|
}
|
|
49
54
|
if (parent) {
|
|
50
55
|
return `Review ${parent}; it currently pulls in vulnerable ${finding.pkg.name}.`;
|
|
51
56
|
}
|
|
52
|
-
|
|
53
|
-
|
|
57
|
+
// No parent identifiable: either dependencyPaths is empty, or the path is
|
|
58
|
+
// a degenerate length-2 chain (project -> vulnerable, common when the
|
|
59
|
+
// package is hoisted to top-level node_modules). The advice is the same
|
|
60
|
+
// either way — inspect the lockfile or run `<pm> ls` to find the parent.
|
|
61
|
+
if (directTarget) {
|
|
62
|
+
return `No parent dependency was identified for ${finding.pkg.name} in the lockfile. Run \`npm ls ${finding.pkg.name}\` (or your package manager equivalent) to find which package pulls it in, then upgrade toward ${directTarget}+.`;
|
|
54
63
|
}
|
|
55
|
-
return `
|
|
64
|
+
return `No parent dependency was identified for ${finding.pkg.name} in the lockfile. Run \`npm ls ${finding.pkg.name}\` (or your package manager equivalent) to find which package pulls it in.`;
|
|
56
65
|
}
|
|
57
66
|
export function summarizeRisk(finding) {
|
|
58
67
|
let risk = "";
|
|
@@ -71,14 +80,16 @@ export function summarizeRisk(finding) {
|
|
|
71
80
|
else if (finding.relationship === "transitive" && finding.recommendedParentUpgrade) {
|
|
72
81
|
risk = `Transitive issue. A specific parent upgrade target was found for ${finding.recommendedParentUpgrade.package}.`;
|
|
73
82
|
}
|
|
74
|
-
else if (finding.relationship === "transitive" && finding.firstFixedVersion) {
|
|
75
|
-
|
|
83
|
+
else if (finding.relationship === "transitive" && (finding.validatedFirstFixedVersion ?? finding.firstFixedVersion)) {
|
|
84
|
+
const target = finding.validatedFirstFixedVersion ?? finding.firstFixedVersion;
|
|
85
|
+
risk = `Transitive issue. Look for a parent dependency upgrade that pulls in ${target}+`;
|
|
76
86
|
}
|
|
77
87
|
else if (finding.relationship === "transitive") {
|
|
78
88
|
risk = "Transitive issue. Review the parent path and check whether an upstream package can be upgraded.";
|
|
79
89
|
}
|
|
80
|
-
else if (finding.firstFixedVersion) {
|
|
81
|
-
|
|
90
|
+
else if (finding.validatedFirstFixedVersion ?? finding.firstFixedVersion) {
|
|
91
|
+
const target = finding.validatedFirstFixedVersion ?? finding.firstFixedVersion;
|
|
92
|
+
risk = `A fixed-version hint exists. Aim for at least ${target}.`;
|
|
82
93
|
}
|
|
83
94
|
else {
|
|
84
95
|
risk = "Review this finding and inspect the dependency path for the safest upgrade path.";
|
|
@@ -94,8 +105,11 @@ export function summarizeRisk(finding) {
|
|
|
94
105
|
return risk;
|
|
95
106
|
}
|
|
96
107
|
export function summarizeNextAction(finding) {
|
|
97
|
-
|
|
98
|
-
|
|
108
|
+
// Prefer the registry-validated target over the raw advisory hint so this
|
|
109
|
+
// line agrees with the fix-command table. See getRecommendedAction.
|
|
110
|
+
const directTarget = finding.validatedFirstFixedVersion ?? finding.firstFixedVersion;
|
|
111
|
+
if (finding.relationship === "direct" && directTarget) {
|
|
112
|
+
return `Upgrade ${finding.pkg.name} toward ${directTarget}.`;
|
|
99
113
|
}
|
|
100
114
|
if (finding.relationship === "direct") {
|
|
101
115
|
return `Review and upgrade ${finding.pkg.name} directly in this project.`;
|
|
@@ -111,11 +125,11 @@ export function summarizeNextAction(finding) {
|
|
|
111
125
|
return `Upgrade ${finding.recommendedParentUpgrade.package} ${finding.recommendedParentUpgrade.currentVersion} -> ${finding.recommendedParentUpgrade.targetVersion}.`;
|
|
112
126
|
}
|
|
113
127
|
const parent = getPrimaryParent(finding);
|
|
114
|
-
if (parent &&
|
|
115
|
-
return `Upgrade ${parent} — no safe version identified. Find a release resolving ${finding.pkg.name} to ${
|
|
128
|
+
if (parent && directTarget) {
|
|
129
|
+
return `Upgrade ${parent} — no safe version identified. Find a release resolving ${finding.pkg.name} to ${directTarget}+.`;
|
|
116
130
|
}
|
|
117
|
-
if (
|
|
118
|
-
return `No
|
|
131
|
+
if (directTarget) {
|
|
132
|
+
return `No parent identified in the lockfile. Run \`npm ls ${finding.pkg.name}\` to find the parent, then upgrade toward ${directTarget}+.`;
|
|
119
133
|
}
|
|
120
134
|
return `Inspect the parent dependency chain for ${finding.pkg.name} and choose the safest available upgrade.`;
|
|
121
135
|
}
|
package/dist/output/printers.js
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
import { chalk, stripAnsi } from "../utils/chalk.js";
|
|
2
|
-
import {
|
|
3
|
-
import { buildSuggestedFixCommandPlan, findSuggestedCommandForFinding } from "../remediation/fix-commands.js";
|
|
2
|
+
import { buildSuggestedFixCommandPlan } from "../remediation/fix-commands.js";
|
|
4
3
|
import { isMajorVersionBump } from "../utils/version.js";
|
|
5
4
|
import { getPrimaryParent } from "../utils/finding.js";
|
|
6
|
-
import { formatSeverityLabel, formatRelationshipLabel
|
|
5
|
+
import { formatSeverityLabel, formatRelationshipLabel } from "./formatters.js";
|
|
7
6
|
export function printSummary(findings, packageCount, scanInput) {
|
|
8
7
|
if (findings.length === 0) {
|
|
9
8
|
if (scanInput.mode === "manifest-fallback") {
|
|
@@ -22,7 +21,7 @@ export function printSummary(findings, packageCount, scanInput) {
|
|
|
22
21
|
unknown: findings.filter(f => f.severity === "unknown").length
|
|
23
22
|
};
|
|
24
23
|
console.log(chalk.redBright(`✗ Found ${findings.length} package(s) with known OSV matches from ${scanInput.source}`));
|
|
25
|
-
console.log(
|
|
24
|
+
console.log(renderSeverityTable(counts));
|
|
26
25
|
}
|
|
27
26
|
export function printActionSummary(findings) {
|
|
28
27
|
if (findings.length === 0)
|
|
@@ -42,88 +41,6 @@ export function printActionSummary(findings) {
|
|
|
42
41
|
console.log(`- ${chalk.blueBright(String(uniqueAdvisories))} unique advisories matched overall.`);
|
|
43
42
|
console.log(`- ${chalk.blue(String(fixable))} package${fixable === 1 ? "" : "s"} include a fixed-version hint from OSV.`);
|
|
44
43
|
}
|
|
45
|
-
export function printPriorityFixes(findings) {
|
|
46
|
-
if (findings.length === 0)
|
|
47
|
-
return;
|
|
48
|
-
const scored = [...findings].sort((a, b) => {
|
|
49
|
-
const sevDelta = severityOrder[b.severity] - severityOrder[a.severity];
|
|
50
|
-
if (sevDelta !== 0)
|
|
51
|
-
return sevDelta;
|
|
52
|
-
const relScore = (f) => f.relationship === "direct" ? 2 : f.relationship === "transitive" ? 1 : 0;
|
|
53
|
-
const relDelta = relScore(b) - relScore(a);
|
|
54
|
-
if (relDelta !== 0)
|
|
55
|
-
return relDelta;
|
|
56
|
-
const fixedDelta = Number(Boolean(b.firstFixedVersion)) - Number(Boolean(a.firstFixedVersion));
|
|
57
|
-
if (fixedDelta !== 0)
|
|
58
|
-
return fixedDelta;
|
|
59
|
-
return a.pkg.name.localeCompare(b.pkg.name);
|
|
60
|
-
});
|
|
61
|
-
const top = scored.slice(0, 5);
|
|
62
|
-
console.log("");
|
|
63
|
-
console.log(chalk.bold.magenta("🚀 Top priority fixes"));
|
|
64
|
-
for (const finding of top) {
|
|
65
|
-
let usageNote = "";
|
|
66
|
-
if (finding.usage) {
|
|
67
|
-
usageNote = finding.usage.imported ? `, imported in ${finding.usage.files.length} file${finding.usage.files.length === 1 ? "" : "s"}` : `, no direct import found`;
|
|
68
|
-
}
|
|
69
|
-
console.log(`- ${chalk.whiteBright(finding.pkg.name)}@${chalk.white(finding.pkg.version)} (${formatSeverityLabel(finding.severity)}, ${formatRelationshipLabel(finding.relationship)}${usageNote})`);
|
|
70
|
-
console.log(` Risk: ${summarizeRisk(finding)}`);
|
|
71
|
-
const parent = getPrimaryParent(finding);
|
|
72
|
-
if (parent)
|
|
73
|
-
console.log(` Parent: ${parent}`);
|
|
74
|
-
if (finding.recommendedNpmTransitiveRemediation?.kind === "update-parent-within-range") {
|
|
75
|
-
console.log(` Target: npm update ${finding.recommendedNpmTransitiveRemediation.package} (pulls in ${finding.pkg.name}@${finding.recommendedNpmTransitiveRemediation.targetChildVersion} within range)`);
|
|
76
|
-
}
|
|
77
|
-
else if (finding.recommendedParentUpgrade) {
|
|
78
|
-
console.log(` Target: ${finding.recommendedParentUpgrade.package} ${finding.recommendedParentUpgrade.currentVersion} -> ${finding.recommendedParentUpgrade.targetVersion}`);
|
|
79
|
-
}
|
|
80
|
-
console.log(` Next: ${summarizeNextAction(finding)}`);
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
export function printFixPlan(findings) {
|
|
84
|
-
if (findings.length === 0)
|
|
85
|
-
return;
|
|
86
|
-
const directUrgent = findings.filter(f => f.relationship === "direct" && (f.severity === "critical" || f.severity === "high"));
|
|
87
|
-
const transitiveUrgent = findings.filter(f => f.relationship === "transitive" && (f.severity === "critical" || f.severity === "high"));
|
|
88
|
-
const directMedium = findings.filter(f => f.relationship === "direct" && f.severity === "medium");
|
|
89
|
-
console.log("");
|
|
90
|
-
console.log(chalk.bold.green("📋 Suggested fix plan"));
|
|
91
|
-
if (directUrgent.length > 0) {
|
|
92
|
-
console.log(chalk.green("1) Upgrade these direct critical/high dependencies first:"));
|
|
93
|
-
for (const finding of directUrgent.slice(0, 5)) {
|
|
94
|
-
console.log(` - ${finding.pkg.name}@${finding.pkg.version}: ${getRecommendedAction(finding)}`);
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
if (transitiveUrgent.length > 0) {
|
|
98
|
-
console.log(chalk.yellow("2) Review these urgent transitive issues next:"));
|
|
99
|
-
for (const finding of transitiveUrgent.slice(0, 5)) {
|
|
100
|
-
console.log(` - ${finding.pkg.name}@${finding.pkg.version}: ${getRecommendedAction(finding)}`);
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
if (directMedium.length > 0) {
|
|
104
|
-
console.log(chalk.blue("3) Clean up these medium direct dependencies after the urgent fixes:"));
|
|
105
|
-
for (const finding of directMedium.slice(0, 5)) {
|
|
106
|
-
console.log(` - ${finding.pkg.name}@${finding.pkg.version}: ${getRecommendedAction(finding)}`);
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
const grouped = new Map();
|
|
110
|
-
for (const finding of findings) {
|
|
111
|
-
const existing = grouped.get(finding.pkg.name) ?? [];
|
|
112
|
-
existing.push(finding);
|
|
113
|
-
grouped.set(finding.pkg.name, existing);
|
|
114
|
-
}
|
|
115
|
-
const dupes = [...grouped.entries()]
|
|
116
|
-
.filter(([, items]) => items.length > 1)
|
|
117
|
-
.sort((a, b) => b[1].length - a[1].length || a[0].localeCompare(b[0]))
|
|
118
|
-
.slice(0, 5);
|
|
119
|
-
if (dupes.length > 0) {
|
|
120
|
-
console.log(chalk.magenta("4) Consolidate duplicated vulnerable packages where possible:"));
|
|
121
|
-
for (const [name, items] of dupes) {
|
|
122
|
-
const versions = [...new Set(items.map(item => item.pkg.version))].sort().join(", ");
|
|
123
|
-
console.log(` - ${name}: vulnerable versions present -> ${versions}`);
|
|
124
|
-
}
|
|
125
|
-
}
|
|
126
|
-
}
|
|
127
44
|
export function printSuggestedFixCommands(findings, scanInput, options) {
|
|
128
45
|
const plan = buildSuggestedFixCommandPlan(findings, scanInput, options);
|
|
129
46
|
if (!plan)
|
|
@@ -219,18 +136,6 @@ export function printSkippedDependencies(skipped) {
|
|
|
219
136
|
console.log(`${chalk.yellow("•")} ...and ${skipped.length - 10} more`);
|
|
220
137
|
}
|
|
221
138
|
}
|
|
222
|
-
export function printGroupSummary(findings) {
|
|
223
|
-
const direct = findings.filter(f => f.relationship === "direct");
|
|
224
|
-
const transitive = findings.filter(f => f.relationship === "transitive");
|
|
225
|
-
const unknown = findings.filter(f => f.relationship === "unknown");
|
|
226
|
-
console.log("");
|
|
227
|
-
console.log(chalk.bold.green("Where the issues are"));
|
|
228
|
-
console.log(`- Direct dependencies: ${chalk.green(String(direct.length))}`);
|
|
229
|
-
console.log(`- Transitive dependencies: ${chalk.yellow(String(transitive.length))}`);
|
|
230
|
-
if (unknown.length > 0) {
|
|
231
|
-
console.log(`- Unclear relationship: ${chalk.magenta(String(unknown.length))}`);
|
|
232
|
-
}
|
|
233
|
-
}
|
|
234
139
|
export function printTable(findings, threshold) {
|
|
235
140
|
const headers = ["Package", "Version", "Severity", "Type", "Usage", "Fixed", "IDs"];
|
|
236
141
|
const rawRows = findings.map(f => {
|
|
@@ -277,26 +182,8 @@ export function printTable(findings, threshold) {
|
|
|
277
182
|
console.log(renderRow(decorated, widths));
|
|
278
183
|
}
|
|
279
184
|
console.log(line("└", "┴", "┘"));
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
export function printPathHints(findings) {
|
|
283
|
-
const withPaths = findings.filter(f => (f.dependencyPaths ?? []).length > 0);
|
|
284
|
-
if (withPaths.length === 0)
|
|
285
|
-
return;
|
|
286
|
-
console.log("");
|
|
287
|
-
console.log(chalk.bold.cyan("Dependency paths to inspect"));
|
|
288
|
-
for (const finding of withPaths.slice(0, 10)) {
|
|
289
|
-
const examples = finding.dependencyPaths.slice(0, 3).map(p => p.join(" -> "));
|
|
290
|
-
console.log(`- ${finding.pkg.name}@${finding.pkg.version}`);
|
|
291
|
-
for (const example of examples) {
|
|
292
|
-
console.log(` ${chalk.gray(example)}`);
|
|
293
|
-
}
|
|
294
|
-
if (finding.recommendedNpmTransitiveRemediation?.kind === "update-parent-within-range") {
|
|
295
|
-
console.log(` Recommended parent update: ${chalk.bold.cyan(`npm update ${finding.recommendedNpmTransitiveRemediation.package}`)}`);
|
|
296
|
-
}
|
|
297
|
-
else if (finding.recommendedParentUpgrade) {
|
|
298
|
-
console.log(` Recommended parent upgrade: ${chalk.bold.cyan(finding.recommendedParentUpgrade.package)} ${finding.recommendedParentUpgrade.currentVersion} -> ${finding.recommendedParentUpgrade.targetVersion}`);
|
|
299
|
-
}
|
|
185
|
+
if (threshold) {
|
|
186
|
+
console.log(chalk.gray("Tip: use --all to include low/unknown findings, or --min-severity high to focus only on urgent issues."));
|
|
300
187
|
}
|
|
301
188
|
}
|
|
302
189
|
export function printFinalStatus(findings) {
|
|
@@ -422,45 +309,6 @@ export function printCompactOutput(findings, scanInput, options) {
|
|
|
422
309
|
}
|
|
423
310
|
}
|
|
424
311
|
}
|
|
425
|
-
// Top Priority Fix section
|
|
426
|
-
if (urgentFindings.length > 0) {
|
|
427
|
-
const topFinding = urgentFindings[0];
|
|
428
|
-
console.log("────────────────────────────────");
|
|
429
|
-
console.log(chalk.bold("🚀 Top Priority Issue"));
|
|
430
|
-
console.log("────────────────────────────────\n");
|
|
431
|
-
if (topFinding.relationship === "direct" && topFinding.firstFixedVersion) {
|
|
432
|
-
console.log(`Upgrade ${chalk.whiteBright(topFinding.pkg.name)} → ${topFinding.firstFixedVersion}`);
|
|
433
|
-
}
|
|
434
|
-
else if (topFinding.relationship === "direct") {
|
|
435
|
-
console.log(`Upgrade ${chalk.whiteBright(topFinding.pkg.name)} to latest safe version`);
|
|
436
|
-
}
|
|
437
|
-
else if (topFinding.recommendedNpmTransitiveRemediation?.kind === "update-parent-within-range") {
|
|
438
|
-
console.log(`Update ${chalk.whiteBright(topFinding.recommendedNpmTransitiveRemediation.package)} within current range`);
|
|
439
|
-
}
|
|
440
|
-
else if (topFinding.recommendedParentUpgrade) {
|
|
441
|
-
console.log(`Upgrade ${chalk.whiteBright(topFinding.recommendedParentUpgrade.package)} ${topFinding.recommendedParentUpgrade.currentVersion} → ${topFinding.recommendedParentUpgrade.targetVersion}`);
|
|
442
|
-
}
|
|
443
|
-
else {
|
|
444
|
-
const parent = getPrimaryParent(topFinding);
|
|
445
|
-
if (parent) {
|
|
446
|
-
console.log(`Upgrade ${chalk.whiteBright(parent)} to resolve ${topFinding.pkg.name}`);
|
|
447
|
-
}
|
|
448
|
-
else {
|
|
449
|
-
console.log(`No dependency path found — inspect lockfile to identify which package pulls in ${chalk.whiteBright(topFinding.pkg.name)}`);
|
|
450
|
-
}
|
|
451
|
-
}
|
|
452
|
-
if (plan) {
|
|
453
|
-
const topFindingCommand = findSuggestedCommandForFinding(plan, topFinding);
|
|
454
|
-
if (topFindingCommand) {
|
|
455
|
-
console.log(chalk.gray("Command:"));
|
|
456
|
-
console.log(renderCommandCallout(topFindingCommand));
|
|
457
|
-
}
|
|
458
|
-
else {
|
|
459
|
-
console.log(chalk.gray("No confident automatic command is available for this issue yet."));
|
|
460
|
-
}
|
|
461
|
-
}
|
|
462
|
-
console.log("");
|
|
463
|
-
}
|
|
464
312
|
// Summary
|
|
465
313
|
console.log("────────────────────────────────");
|
|
466
314
|
console.log("Summary");
|
|
@@ -490,7 +338,12 @@ export function printCompactOutput(findings, scanInput, options) {
|
|
|
490
338
|
console.log(`${chalk.cyan(String(direct))} ${chalk.white("direct")}` +
|
|
491
339
|
`${chalk.gray(" · ")}` +
|
|
492
340
|
`${chalk.cyan(String(transitive))} ${chalk.white("transitive")}`);
|
|
493
|
-
|
|
341
|
+
if (options?.all) {
|
|
342
|
+
printTable(findings, null);
|
|
343
|
+
}
|
|
344
|
+
else {
|
|
345
|
+
console.log("");
|
|
346
|
+
}
|
|
494
347
|
// Footer
|
|
495
348
|
const urgentCount = counts.critical + counts.high;
|
|
496
349
|
if (urgentCount > 0) {
|
|
@@ -499,9 +352,39 @@ export function printCompactOutput(findings, scanInput, options) {
|
|
|
499
352
|
else {
|
|
500
353
|
console.log(chalk.yellow(`▲ Scan complete. ${findings.length} issue${findings.length === 1 ? "" : "s"} found.`));
|
|
501
354
|
}
|
|
502
|
-
|
|
355
|
+
if (!options?.all) {
|
|
356
|
+
console.log(chalk.gray(`Run with ${chalk.whiteBright("--verbose")} for fix plan, paths, and full table.`));
|
|
357
|
+
}
|
|
503
358
|
console.log("");
|
|
504
359
|
}
|
|
360
|
+
function renderSeverityTable(counts) {
|
|
361
|
+
const labels = ["Critical", "High", "Medium", "Low", "Unknown"];
|
|
362
|
+
const coloredValues = [
|
|
363
|
+
chalk.redBright(String(counts.critical)),
|
|
364
|
+
chalk.red(String(counts.high)),
|
|
365
|
+
chalk.yellow(String(counts.medium)),
|
|
366
|
+
chalk.blueBright(String(counts.low)),
|
|
367
|
+
chalk.magenta(String(counts.unknown)),
|
|
368
|
+
];
|
|
369
|
+
const rawValues = [
|
|
370
|
+
String(counts.critical),
|
|
371
|
+
String(counts.high),
|
|
372
|
+
String(counts.medium),
|
|
373
|
+
String(counts.low),
|
|
374
|
+
String(counts.unknown),
|
|
375
|
+
];
|
|
376
|
+
const widths = labels.map((label, i) => Math.max(label.length, rawValues[i].length));
|
|
377
|
+
const line = (left, mid, right) => left + widths.map(w => "─".repeat(w + 2)).join(mid) + right;
|
|
378
|
+
const pad = (text, raw, width) => {
|
|
379
|
+
const pad = width - raw.length;
|
|
380
|
+
const left = Math.floor(pad / 2);
|
|
381
|
+
const right = pad - left;
|
|
382
|
+
return " ".repeat(left + 1) + text + " ".repeat(right + 1);
|
|
383
|
+
};
|
|
384
|
+
const headerRow = "│" + labels.map((label, i) => ` ${label.padStart(Math.floor((widths[i] - label.length) / 2) + label.length).padEnd(widths[i])} `).join("│") + "│";
|
|
385
|
+
const valueRow = "│" + coloredValues.map((val, i) => pad(val, rawValues[i], widths[i])).join("│") + "│";
|
|
386
|
+
return [line("┌", "┬", "┐"), headerRow, line("├", "┼", "┤"), valueRow, line("└", "┴", "┘")].join("\n");
|
|
387
|
+
}
|
|
505
388
|
function colorFixSectionTitle(severity, title) {
|
|
506
389
|
if (severity === "critical")
|
|
507
390
|
return chalk.redBright(title);
|
|
@@ -56,21 +56,26 @@ export function loadNpmLockGraph(filePath, options) {
|
|
|
56
56
|
resolveEdgesForParent(node.packagePath, dependencyRangesByNodeId.get(node.id) ?? {}, resolutionBasePathsByNodeId.get(node.id) ?? [node.packagePath], nodeIdByPackagePath, childNodeIdsByParentNodeId, parentNodeIdsByChildNodeId, rangeByParentNodeId);
|
|
57
57
|
}
|
|
58
58
|
if (options?.includePaths !== false) {
|
|
59
|
+
const MAX_PATHS_PER_NODE = 5;
|
|
60
|
+
const MAX_PATH_DEPTH = 10;
|
|
59
61
|
const queue = entryPackages.map((entryNodeId) => ({
|
|
60
62
|
nodeId: entryNodeId,
|
|
61
63
|
path: ["project", nodesById.get(entryNodeId)?.name ?? entryNodeId],
|
|
62
64
|
}));
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
continue;
|
|
65
|
+
let queueHead = 0;
|
|
66
|
+
while (queueHead < queue.length) {
|
|
67
|
+
const current = queue[queueHead++];
|
|
67
68
|
rememberPath(pathSetByNodeId, current.nodeId, current.path);
|
|
69
|
+
if (current.path.length >= MAX_PATH_DEPTH)
|
|
70
|
+
continue;
|
|
68
71
|
for (const childNodeId of childNodeIdsByParentNodeId.get(current.nodeId) ?? []) {
|
|
69
72
|
const childNode = nodesById.get(childNodeId);
|
|
70
73
|
if (!childNode)
|
|
71
74
|
continue;
|
|
72
|
-
const nextPath = [...current.path, childNode.name];
|
|
73
75
|
const beforeSize = pathSetByNodeId.get(childNodeId)?.size ?? 0;
|
|
76
|
+
if (beforeSize >= MAX_PATHS_PER_NODE)
|
|
77
|
+
continue;
|
|
78
|
+
const nextPath = [...current.path, childNode.name];
|
|
74
79
|
rememberPath(pathSetByNodeId, childNodeId, nextPath);
|
|
75
80
|
const afterSize = pathSetByNodeId.get(childNodeId)?.size ?? 0;
|
|
76
81
|
if (afterSize > beforeSize) {
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import fs from "node:fs";
|
|
2
2
|
import { upsertPackage, normalizeNodeModulesPath } from "./utils.js";
|
|
3
|
+
import { loadNpmLockGraph } from "./npm-lock-graph.js";
|
|
3
4
|
export function loadFromPackageLock(filePath, prodOnly) {
|
|
4
5
|
const raw = JSON.parse(fs.readFileSync(filePath, "utf8"));
|
|
5
6
|
const map = new Map();
|
|
6
7
|
if (raw.packages && typeof raw.packages === "object") {
|
|
8
|
+
const graph = loadNpmLockGraph(filePath, { includePaths: true });
|
|
7
9
|
for (const [pkgPath, meta] of Object.entries(raw.packages)) {
|
|
8
10
|
if (!pkgPath || pkgPath === "")
|
|
9
11
|
continue;
|
|
@@ -16,8 +18,10 @@ export function loadFromPackageLock(filePath, prodOnly) {
|
|
|
16
18
|
continue;
|
|
17
19
|
if (prodOnly && dev)
|
|
18
20
|
continue;
|
|
19
|
-
const
|
|
20
|
-
|
|
21
|
+
const nodeIds = graph.nodeIdsFor(name, version);
|
|
22
|
+
const graphPaths = nodeIds.flatMap(id => graph.pathsFor(id));
|
|
23
|
+
const paths = graphPaths.length > 0 ? graphPaths : [normalizeNodeModulesPath(pkgPath)];
|
|
24
|
+
upsertPackage(map, { name, version, ecosystem: "npm", dev, paths });
|
|
21
25
|
}
|
|
22
26
|
}
|
|
23
27
|
if (map.size === 0 && raw.dependencies && typeof raw.dependencies === "object") {
|
|
@@ -1,8 +1,39 @@
|
|
|
1
1
|
import fs from "node:fs";
|
|
2
2
|
import { parse as parseYarnLock } from "yarn-lockfile";
|
|
3
3
|
import { upsertPackage } from "./utils.js";
|
|
4
|
+
function isYarnBerry(content) {
|
|
5
|
+
return content.startsWith('__metadata:') || content.includes('\n__metadata:');
|
|
6
|
+
}
|
|
7
|
+
function loadFromYarnBerryLock(content) {
|
|
8
|
+
const map = new Map();
|
|
9
|
+
const blocks = content.split(/\n\n+/);
|
|
10
|
+
for (const block of blocks) {
|
|
11
|
+
const lines = block.trim().split('\n');
|
|
12
|
+
if (!lines[0] || lines[0].startsWith('__metadata'))
|
|
13
|
+
continue;
|
|
14
|
+
const resolutionLine = lines.find((l) => l.trim().startsWith('resolution:'));
|
|
15
|
+
if (!resolutionLine)
|
|
16
|
+
continue;
|
|
17
|
+
const resMatch = resolutionLine.match(/resolution:\s+"(.+)"/);
|
|
18
|
+
if (!resMatch)
|
|
19
|
+
continue;
|
|
20
|
+
const resolution = resMatch[1];
|
|
21
|
+
const npmIdx = resolution.lastIndexOf('@npm:');
|
|
22
|
+
if (npmIdx < 0)
|
|
23
|
+
continue;
|
|
24
|
+
const name = resolution.slice(0, npmIdx);
|
|
25
|
+
const version = resolution.slice(npmIdx + 5);
|
|
26
|
+
if (!name || !version)
|
|
27
|
+
continue;
|
|
28
|
+
upsertPackage(map, { name, version, ecosystem: 'npm', paths: [['project', name]] });
|
|
29
|
+
}
|
|
30
|
+
return [...map.values()];
|
|
31
|
+
}
|
|
4
32
|
export function loadFromYarnLock(filePath) {
|
|
5
33
|
const content = fs.readFileSync(filePath, "utf8");
|
|
34
|
+
if (isYarnBerry(content)) {
|
|
35
|
+
return loadFromYarnBerryLock(content);
|
|
36
|
+
}
|
|
6
37
|
const parsed = parseYarnLock(content);
|
|
7
38
|
if (parsed.type !== "success" || !parsed.object) {
|
|
8
39
|
throw new Error("Could not parse yarn.lock");
|