Skip to content

3.0.0

Latest

Choose a tag to compare

@efajardo-nv efajardo-nv released this 19 Aug 21:47
· 11 commits to main since this release
f7465a1

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, or failed outcomes.
  • 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.
  • 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-analysis CLI 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.
  • 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/uncertain results, 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.

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-After handling, 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_agent workflow and its SBOM/VDB-oriented functions and data contracts have been replaced by the staged cve_pipeline workflow and structured PipelineInput/PipelineResult models. 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 and uv 0.9.9 or 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 crane on PATH. Docker Compose deployments include the required tool; callers can alternatively provide a pre-extracted root filesystem with filesystem_path.

  • Deployment assets have moved under deploy/, and the deployment and quick-start notebooks have been reworked for the v3 workflow. Review .env.example and 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