Repository navigation
vulners-cli v1.6.0
Feature release powered by go-vulners v1.5.1, adding reachability-aware repository scanning, structured offline matching, and a unified scan output across host and web targets, with stricter resource bounds and security hardening.
New features
Scanning
- Reachability-aware
vulners scan repo— online Go scans usegovulncheckto separate reachable findings from imported-only advisories, enriched with Vulners severity data;--fail-onignores imported-only findings and fails closed on reachable findings with unknown severity - Structured offline matching — match cached bulletins by component name, version, and CPE
- Affected-product matching — exact, wildcard, CPE, and relational version ranges shared by online and offline scans
- Unified host and web output —
scan hostandscan webnow emit the commoncomponents,findings, andsummarystructure;--planworks without connections, credential prompts, or API calls - Nested npm v1 lockfiles — dependencies are collected recursively and deduplicated
- Image scan accuracy — preserve SBOM-only OS findings and use Debian package architecture from image PURLs
- Full offline syncs — replace stored collections so bulletins deleted upstream are removed
go.modpath support — pass ago.modfile directly to the Go inventory collector
Configuration
VULNERS_HTTP_TIMEOUT/http_timeout— configure the per-request API timeout, including large offline collection downloads (default 120s)
Fixes & improvements
- SBOM and image scans accept EPSS objects from the API and preserve nested EPSS scores
- Normalize advisory Go pseudo-versions such as
0.0.0+20231218163308+9d2ee975ef9f - Read web CVSS scores from nested metric providers so
--fail-onevaluates web findings correctly - Populate govulncheck fixed versions and CVE aliases, and merge duplicate findings for the same advisory and module
- Prefer populated CVSS data when the API returns an empty
cvss3object alongsidecvss - Use aggregate audit CVSS when host audit findings omit a per-vulnerability score
- Fail without partial findings on version-range or pagination errors; offline scans fail on lookup errors
- Usage and configuration errors now exit with code 2; runtime errors remain code 3
- Missing API keys, unsupported output formats, and invalid
--fail-onvalues are usage errors on every command - Scanner and inventory failures abort scans instead of being skipped, and output close errors are propagated
- Scan inventories are capped at 10,000 components and online matching at 1,000 API search requests; overflow fails without a partial report
- Require
0600permissions for Unix config files, report files, cache databases, and SQLite sidecars, and0750for the.vulnersdirectory - Reject passwords embedded in host URIs, validate host targets before connecting, and require a WinRM username with a warning for cleartext HTTP
- Sanitize terminal control characters and escape Markdown output
- Limit Go, Python, SBOM, npm lockfile, and VEX inputs to 64 MiB; cap captured host command output at 64 MiB and stderr at 1 MiB
- Require products in OpenVEX statements and scope suppression to the matching PURL, CPE, or
name@version - Address 13 standard-library vulnerabilities by updating to Go 1.26.10
Other changes
- VScanner support retired — the
vscancommand group, client wiring, and output schemas are removed - Update
go-vulnersto v1.5.1 - Update Go to 1.26.10, refresh dependencies, and pin goreleaser to v2.12.7
- Reorganize documentation with the Diátaxis framework
- Add opt-in live SBOM and web policy integration tests (
just test-integration)
Full Changelog: v1.5.2...v1.6.0