Repository navigation
What's Changed
Notable Features and Improvements
- Introduce a new evidence-first, multi-agent vulnerability analysis pipeline by @shawn-davis in #177 and @hsin-c in #182
- Replaces the previous linear CVE/SBOM workflow with three coordinated stages: CVE research and container analysis, exploitability analysis, and VEX categorization.
- Produces cited vulnerability research, container-specific evidence, exploitability assessments, analyst-reviewable Markdown reports, and structured JSON VEX results.
- Uses deterministic pre-triage for clear cases and deeper model-assisted analysis for ambiguous findings.
- Add first-class multi-vulnerability analysis by @hsin-c and @efajardo-nv in #177
- Accepts one or more CVE or GHSA identifiers for a container image.
- Reuses shared container evidence while processing vulnerabilities concurrently.
- Preserves successful results when an individual vulnerability fails and reports aggregate
complete,partial, orfailedoutcomes.
- Add automatic container filesystem materialization and evidence caching by @efajardo-nv in #177
- Resolves mutable image references to immutable digests and extracts container root filesystems with
crane. - Supports caller-provided root filesystems for offline or controlled environments.
- Adds digest-keyed image caching, semantic per-stage report caching, provenance validation, and canonical CVE/GHSA alias handling.
- Resolves mutable image references to immutable digests and extracts container root filesystems with
- Add a production-oriented service and integration layer by @efajardo-nv in #182
- Supports synchronous and asynchronous execution, Dask-backed scheduling, progress reporting, preflight and readiness checks, report discovery, and structured terminal results.
- Adds optional OAuth2/OIDC JWT bearer-token validation.
- Adds optional completion webhooks with OAuth2 client-credentials authentication, HMAC signing, durable SQLite delivery tracking, stable event identifiers, retries, and caller-provided correlation context.
- Add a supported Docker Compose deployment and new
vuln-analysisCLI by @efajardo-nv in #177 and @hsin-c in #182- Reorganizes deployment assets under
deploy/and provides API, JupyterLab, and NGINX caching-proxy services. - Adds host UID/GID handling, health checks, lifecycle helpers, and optional self-hosted NIM configuration.
- Adds CLI commands for preflight validation, cache inspection and pruning, and standalone agent-input generation.
- Reorganizes deployment assets under
- Modernize evaluation and quality tooling by @shawn-davis in #177 and @hsin-c in #182
- Adds a CVE report judge, updated benchmark datasets, explicit handling for
unknown/uncertainresults, and accuracy, precision, recall, F1, and confusion-matrix metrics. - Adds watchdog and deadline handling for long-running evaluations and broad regression coverage across the pipeline, caching, extraction, authentication, webhooks, and multi-vulnerability behavior.
- Adds a CVE report judge, updated benchmark datasets, explicit handling for
Bug Fixes
- Harden stage-cache cleanup, report normalization and discovery, evaluator input handling, OAuth timeouts, and SQLite connection lifecycle by @shawn-davis in #185
- Enforce filesystem containment and public-network URL boundaries; improve subprocess, image extraction, cache, VEX validation, and evaluation failure handling by @hsin-c in #186
- Add webhook delivery leases, outbound path sanitization, bounded retries, and durable dead-letter handling by @efajardo-nv in #187
- Improve webhook
Retry-Afterhandling, retry accounting, error redaction, and dead-letter observability by @efajardo-nv in #188 - Further harden webhook configuration, OSV requests, artifact discovery, archive inspection, redirects, response limits, and process cleanup by @hsin-c in #190
Breaking Changes
-
Version 3.0 is a major architectural release and is not API-compatible with the 2.x workflow. The legacy linear
cve_agentworkflow and its SBOM/VDB-oriented functions and data contracts have been replaced by the stagedcve_pipelineworkflow and structuredPipelineInput/PipelineResultmodels. See #177 and #182. -
Python support changes from Python 3.11-3.12 to Python 3.13 (
>=3.13,<3.14). Recreate local environments with a supported Python version anduv 0.9.9or newer. -
The runtime is updated to NeMo Agent Toolkit 1.8.0 and the current LangGraph/LangChain stack. Users who directly extend the blueprint with NAT components must update their registrations, imports, workflow configuration, and input/output handling for the new pipeline.
-
The CVE Researcher now uses shared infrastructure from the NVIDIA AI-Q Blueprint, included as a Git submodule. Source checkouts must initialize it before installing dependencies:
git submodule update --init --recursive
-
Automatic local container extraction requires
craneonPATH. Docker Compose deployments include the required tool; callers can alternatively provide a pre-extracted root filesystem withfilesystem_path. -
Deployment assets have moved under
deploy/, and the deployment and quick-start notebooks have been reworked for the v3 workflow. Review.env.exampleand regenerate local configuration instead of reusing 2.x Compose and workflow settings unchanged.
Other Changes
- Add repository-level, security-focused CodeRabbit review configuration by @efajardo-nv in #184
New Contributors
Full Changelog: 2.1.0...3.0.0