How satwiksaxena1804-dev/vulnreach works
VulnReach scans a Python project, resolves its dependencies and advisory data, builds a conservative call graph, and evaluates whether vulnerable symbols are reachable from application entry points. Users initiate scans through the CLI, desktop GUI, or programmatic API; results include evidence-backed verdicts and console, JSON, Markdown, or OpenVEX reports. Dependency discovery, OSV retrieval, symbol enrichment, and static call analysis are distinct stages. The API source shows the main orchestration; the README documents report formats and optional AI explanations. Some report and GUI wiring is supported by the source index rather than full excerpts.
Main entry points: api.py Analysis API · cli.py CLI · gui.py Desktop GUI · reachability.py Reachability Engine
Components 20
User Interfaces
- CLI
vulnreach/cli.py - Desktop GUI
vulnreach/gui.py - Analysis API
vulnreach/api.py
Static Analysis
- Project Scanner
vulnreach/scanner.py - Dependency Resolver
vulnreach/dependencies.py - Name Resolver
vulnreach/resolution.py - Call Graph
vulnreach/callgraph.py - Analysis Data Model
vulnreach/model.py
Advisory Intelligence
- OSV Advisory Client
vulnreach/osv.py - Version Matching
vulnreach/versions.py - Vulnerable Symbols
vulnreach/symbols.py
Verdicts and Reports
- Reachability Engine
vulnreach/reachability.py - Console Report
vulnreach/report/console.py - JSON Report
vulnreach/report/json_report.py - Markdown Report
vulnreach/report/markdown.py - OpenVEX Report
vulnreach/report/vex.py
Finding Explanations
- Finding Explainer
vulnreach/ai/explain.py
Other components
- Project User
- OSV.dev
- LLM Service
Connections 22
- Project User → CLI: runs scan
README.md - Project User → Desktop GUI: opens interface
README.md - Project User → Analysis API: calls API
vulnreach/api.py - CLI → Analysis API: starts analysis
vulnreach/cli.py - Desktop GUI → Analysis API: starts analysis
vulnreach/gui.py - Analysis API → Project Scanner: scans project
vulnreach/api.py - Analysis API → Dependency Resolver: collects dependencies
vulnreach/api.py - Analysis API → Name Resolver: resolves names
vulnreach/api.py - Analysis API → Call Graph: builds graph
vulnreach/api.py - Analysis API → OSV Advisory Client: queries advisories
vulnreach/api.py - Analysis API → Vulnerable Symbols: enriches advisories
vulnreach/api.py - Analysis API → Reachability Engine: analyzes findings
vulnreach/api.py - OSV Advisory Client → OSV.dev: fetches advisories
README.md - Reachability Engine → Call Graph: searches paths
vulnreach/reachability.py - Reachability Engine → Version Matching: checks affected versions
vulnreach/reachability.py - CLI → Console Report: renders output
vulnreach/cli.py - CLI → JSON Report: writes report
vulnreach/cli.py - CLI → Markdown Report: renders report
vulnreach/cli.py - CLI → OpenVEX Report: builds report
vulnreach/cli.py - Desktop GUI → JSON Report: saves report
vulnreach/gui.py - CLI → Finding Explainer: explains findings
vulnreach/cli.py - Finding Explainer → LLM Service: requests narration
README.md