How blowmamain-spec/vuln-fab works
vulnfab is a multi-stack static application security scanner. Its primary workflow is scan <path>: the CLI starts a scan, which loads and analyzes repository files, applies rules and stack checks, then returns findings for reporting. The README also documents history/diff scanning, secret and infrastructure checks, dependency vulnerability scanning, rule inspection, and stack-specific analysis. The graph reflects shown calls and documented capabilities; some scanner and plugin wiring is unsampled, so those links are omitted rather than inferred.
Main entry points: engine.py Scan orchestration · cli.py CLI commands · registry.py Plugin registry · report.py Report model
Components 21
CLI and reporting
- CLI commands
src/vulnfab/cli.py - Report model
src/vulnfab/core/report.py - Output formats
src/vulnfab/reporters
Core analysis
- Scan orchestration
src/vulnfab/core/engine.py - File loading
src/vulnfab/core/loader.py - Parsing
src/vulnfab/core/parsing.py - Language lowering
src/vulnfab/core/lower - Taint IR
src/vulnfab/core/tir.py - Rule definitions
src/vulnfab/core/rules.py - Pattern matching
src/vulnfab/core/matcher.py - Schema checks
src/vulnfab/core/schemarules.py
Stack plugins
- Plugin registry
src/vulnfab/plugins/registry.py - Django analysis
src/vulnfab/plugins/django - Laravel analysis
src/vulnfab/plugins/laravel - Supabase analysis
src/vulnfab/plugins/supabase - TypeScript analysis
src/vulnfab/plugins/typescript
Additional scans
- History scan
src/vulnfab/scanners/history.py - Secret scanning
src/vulnfab/scanners/envfiles.py - Infrastructure scan
src/vulnfab/scanners/infra.py - Dependency scan
src/vulnfab/scanners/sca.py
Other components
- Engineer
Connections 21
- Engineer → CLI commands: invokes
README.md - CLI commands → Scan orchestration: starts scan
src/vulnfab/cli.py - Scan orchestration → File loading: loads files
src/vulnfab/core/engine.py - Scan orchestration → Parsing: parses files
src/vulnfab/core/engine.py - Scan orchestration → Language lowering: lowers code
src/vulnfab/core/engine.py - Language lowering → Taint IR: produces IR
src/vulnfab/core/lower/__init__.py - Scan orchestration → Rule definitions: loads rules
src/vulnfab/core/engine.py - Scan orchestration → Pattern matching: runs rules
src/vulnfab/core/engine.py - Pattern matching → Parsing: uses parsed files
src/vulnfab/core/matcher.py - Scan orchestration → Schema checks: runs checks
src/vulnfab/core/engine.py - Plugin registry → Django analysis: discovers plugin
src/vulnfab/plugins/registry.py - Plugin registry → Laravel analysis: discovers plugin
src/vulnfab/plugins/registry.py - Plugin registry → Supabase analysis: discovers plugin
src/vulnfab/plugins/registry.py - Plugin registry → TypeScript analysis: discovers plugin
src/vulnfab/plugins/registry.py - Scan orchestration → Report model: builds report
src/vulnfab/core/engine.py - CLI commands → Output formats: selects format
src/vulnfab/cli.py - Report model → Output formats: renders findings
src/vulnfab/reporters/html_reporter.py - CLI commands → History scan: enables scan
- CLI commands → Secret scanning: scans secrets
- CLI commands → Infrastructure scan: scans infrastructure
- CLI commands → Dependency scan: scans dependencies