# blowmamain-spec/vuln-fab architecture

> Architecture diagram of the GitHub repository blowmamain-spec/vuln-fab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blowmamain-spec/vuln-fab
- Repository: https://github.com/blowmamain-spec/vuln-fab

## Overview

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: [`src/vulnfab/core/engine.py`](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/engine.py) (Scan orchestration), [`src/vulnfab/cli.py`](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/cli.py) (CLI commands), [`src/vulnfab/plugins/registry.py`](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/plugins/registry.py) (Plugin registry), [`src/vulnfab/core/report.py`](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/report.py) (Report model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["CLI and reporting"]
  node_cli["CLI commands<br/>[cli.py]"]
  node_report["Report model<br/>[report.py]"]
  node_reporters["Output formats"]
end

subgraph group_analysis["Core analysis"]
  node_engine["Scan orchestration<br/>[engine.py]"]
  node_loader["File loading<br/>[loader.py]"]
  node_parser["Parsing<br/>[parsing.py]"]
  node_lowering["Language lowering"]
  node_tir["Taint IR<br/>[tir.py]"]
  node_rules["Rule definitions<br/>[rules.py]"]
  node_pattern["Pattern matching<br/>[matcher.py]"]
  node_schema["Schema checks<br/>[schemarules.py]"]
end

subgraph group_stacks["Stack plugins"]
  node_registry["Plugin registry<br/>[registry.py]"]
  node_django["Django analysis"]
  node_laravel["Laravel analysis"]
  node_supabase["Supabase analysis"]
  node_typescript["TypeScript analysis"]
end

subgraph group_supplemental["Additional scans"]
  node_history["History scan<br/>[history.py]"]
  node_secrets["Secret scanning<br/>[envfiles.py]"]
  node_infra["Infrastructure scan<br/>[infra.py]"]
  node_sca["Dependency scan<br/>[sca.py]"]
end

node_user(("Engineer"))

node_user -->|"invokes"| node_cli
node_cli -->|"starts scan"| node_engine
node_engine -->|"loads files"| node_loader
node_engine -->|"parses files"| node_parser
node_engine -->|"lowers code"| node_lowering
node_lowering -->|"produces IR"| node_tir
node_engine -->|"loads rules"| node_rules
node_engine -->|"runs rules"| node_pattern
node_pattern -->|"uses parsed files"| node_parser
node_engine -->|"runs checks"| node_schema
node_registry -->|"discovers plugin"| node_django
node_registry -->|"discovers plugin"| node_laravel
node_registry -->|"discovers plugin"| node_supabase
node_registry -->|"discovers plugin"| node_typescript
node_engine -->|"builds report"| node_report
node_cli -->|"selects format"| node_reporters
node_report -->|"renders findings"| node_reporters
node_cli -.->|"enables scan"| node_history
node_cli -.->|"scans secrets"| node_secrets
node_cli -.->|"scans infrastructure"| node_infra
node_cli -.->|"scans dependencies"| node_sca

click node_cli "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/cli.py"
click node_engine "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/engine.py"
click node_loader "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/loader.py"
click node_parser "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/parsing.py"
click node_lowering "https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/core/lower"
click node_tir "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/tir.py"
click node_rules "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/rules.py"
click node_pattern "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/matcher.py"
click node_schema "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/schemarules.py"
click node_registry "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/plugins/registry.py"
click node_django "https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/django"
click node_laravel "https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/laravel"
click node_supabase "https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/supabase"
click node_typescript "https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/typescript"
click node_report "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/report.py"
click node_reporters "https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/reporters"
click node_history "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/history.py"
click node_secrets "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/envfiles.py"
click node_infra "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/infra.py"
click node_sca "https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/sca.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_report,node_reporters toneBlue
class node_engine,node_loader,node_parser,node_lowering,node_tir,node_rules,node_pattern,node_schema toneAmber
class node_registry,node_django,node_laravel,node_supabase,node_typescript toneMint
class node_history,node_secrets,node_infra,node_sca toneRose
class node_user toneIndigo
```

## Components

### CLI and reporting

- [CLI commands](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/cli.py): `src/vulnfab/cli.py`
- [Report model](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/report.py): `src/vulnfab/core/report.py`
- [Output formats](https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/reporters): `src/vulnfab/reporters`

### Core analysis

- [Scan orchestration](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/engine.py): `src/vulnfab/core/engine.py`
- [File loading](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/loader.py): `src/vulnfab/core/loader.py`
- [Parsing](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/parsing.py): `src/vulnfab/core/parsing.py`
- [Language lowering](https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/core/lower): `src/vulnfab/core/lower`
- [Taint IR](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/tir.py): `src/vulnfab/core/tir.py`
- [Rule definitions](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/rules.py): `src/vulnfab/core/rules.py`
- [Pattern matching](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/matcher.py): `src/vulnfab/core/matcher.py`
- [Schema checks](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/core/schemarules.py): `src/vulnfab/core/schemarules.py`

### Stack plugins

- [Plugin registry](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/plugins/registry.py): `src/vulnfab/plugins/registry.py`
- [Django analysis](https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/django): `src/vulnfab/plugins/django`
- [Laravel analysis](https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/laravel): `src/vulnfab/plugins/laravel`
- [Supabase analysis](https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/supabase): `src/vulnfab/plugins/supabase`
- [TypeScript analysis](https://github.com/blowmamain-spec/vuln-fab/tree/claude/magical-sagan-mnen4s/src/vulnfab/plugins/typescript): `src/vulnfab/plugins/typescript`

### Additional scans

- [History scan](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/history.py): `src/vulnfab/scanners/history.py`
- [Secret scanning](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/envfiles.py): `src/vulnfab/scanners/envfiles.py`
- [Infrastructure scan](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/infra.py): `src/vulnfab/scanners/infra.py`
- [Dependency scan](https://github.com/blowmamain-spec/vuln-fab/blob/claude/magical-sagan-mnen4s/src/vulnfab/scanners/sca.py): `src/vulnfab/scanners/sca.py`

### Other components

- **Engineer**

## Connections

- Engineer → CLI commands: invokes (evidence: `README.md`)
- CLI commands → Scan orchestration: starts scan (evidence: `src/vulnfab/cli.py`)
- Scan orchestration → File loading: loads files (evidence: `src/vulnfab/core/engine.py`)
- Scan orchestration → Parsing: parses files (evidence: `src/vulnfab/core/engine.py`)
- Scan orchestration → Language lowering: lowers code (evidence: `src/vulnfab/core/engine.py`)
- Language lowering → Taint IR: produces IR (evidence: `src/vulnfab/core/lower/__init__.py`)
- Scan orchestration → Rule definitions: loads rules (evidence: `src/vulnfab/core/engine.py`)
- Scan orchestration → Pattern matching: runs rules (evidence: `src/vulnfab/core/engine.py`)
- Pattern matching → Parsing: uses parsed files (evidence: `src/vulnfab/core/matcher.py`)
- Scan orchestration → Schema checks: runs checks (evidence: `src/vulnfab/core/engine.py`)
- Plugin registry → Django analysis: discovers plugin (evidence: `src/vulnfab/plugins/registry.py`)
- Plugin registry → Laravel analysis: discovers plugin (evidence: `src/vulnfab/plugins/registry.py`)
- Plugin registry → Supabase analysis: discovers plugin (evidence: `src/vulnfab/plugins/registry.py`)
- Plugin registry → TypeScript analysis: discovers plugin (evidence: `src/vulnfab/plugins/registry.py`)
- Scan orchestration → Report model: builds report (evidence: `src/vulnfab/core/engine.py`)
- CLI commands → Output formats: selects format (evidence: `src/vulnfab/cli.py`)
- Report model → Output formats: renders findings (evidence: `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
