# henry-felix-faure/wave-project architecture

> Architecture diagram of the GitHub repository henry-felix-faure/wave-project, 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/henry-felix-faure/wave-project
- Repository: https://github.com/henry-felix-faure/wave-project

## Overview

WAVE is a CLI for authorized web security assessment. Its principal workflow is `wave scan`: the CLI prepares a run, performs directory and subdomain enumeration, scrapes internal links, runs OWASP header and cryptographic checks, then collects the scanners’ text outputs and generates a categorized PDF report. README capabilities are represented; source excerpts establish the orchestration and file-based reporting flow. The two OWASP checks and subdomain stage remain distinct. Evidence is limited to the README and indexed source excerpts; no additional unsampled wiring is assumed.

Main entry points: [`wave_cli/cli.py`](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/cli.py) (Scan CLI), [`wave_cli/scanners/gobuster_scanner.py`](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/gobuster_scanner.py) (Directory enumeration), [`wave_cli/scanners/subdomain_scanner.py`](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/subdomain_scanner.py) (Subdomain discovery), [`wave_cli/utils.py`](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/utils.py) (Run and output paths)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Scan orchestration"]
  node_cli["Scan CLI<br/>[cli.py]"]
  node_runfiles["Scan output files"]
end

subgraph group_recon["Reconnaissance"]
  node_directory["Directory enumeration"]
  node_links["Internal link scraping"]
  node_subdomains["Subdomain discovery"]
end

subgraph group_owasp["OWASP checks"]
  node_headers["Security headers"]
  node_crypto["Crypto checks"]
end

subgraph group_reporting["Findings and reports"]
  node_findings["Findings collection<br/>[report_parser.py]"]
  node_pdf["PDF report"]
end

subgraph group_support["Scan support"]
  node_run_support["Run and output paths<br/>[utils.py]"]
  node_wordlists["Bundled wordlists"]
end

node_operator(("Scan operator"))
node_gobuster["Gobuster"]
node_target(("Website target"))
node_report_user(("Report recipient"))

node_operator -->|"invokes scan"| node_cli
node_cli -->|"creates run paths"| node_run_support
node_cli -->|"runs scan"| node_directory
node_cli -->|"scrapes links"| node_links
node_cli -->|"runs enumeration"| node_subdomains
node_cli -->|"checks headers"| node_headers
node_cli -->|"checks crypto"| node_crypto
node_directory -->|"executes"| node_gobuster
node_subdomains -->|"executes"| node_gobuster
node_directory -->|"resolves wordlist"| node_run_support
node_subdomains -->|"resolves wordlist"| node_run_support
node_run_support -->|"locates bundled"| node_wordlists
node_directory -->|"writes results"| node_runfiles
node_subdomains -->|"writes results"| node_runfiles
node_links -->|"writes links"| node_runfiles
node_headers -->|"writes results"| node_runfiles
node_crypto -->|"writes results"| node_runfiles
node_cli -->|"collects findings"| node_findings
node_findings -->|"reads scan outputs"| node_runfiles
node_cli -->|"generates report"| node_pdf
node_findings -->|"supplies findings"| node_pdf
node_pdf -->|"produces PDF"| node_report_user
node_cli -->|"accepts target"| node_target

click node_cli "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/cli.py"
click node_directory "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/gobuster_scanner.py"
click node_links "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/internal_links_scraper.py"
click node_subdomains "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/subdomain_scanner.py"
click node_headers "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/owasp/A02_security_headers.py"
click node_crypto "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/owasp/A04_cryptographic_failures.py"
click node_findings "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/report_parser.py"
click node_pdf "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/report_generator.py"
click node_run_support "https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/utils.py"
click node_wordlists "https://github.com/henry-felix-faure/wave-project/tree/main/wave_cli/wordlists"

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_runfiles toneBlue
class node_directory,node_links,node_subdomains toneAmber
class node_headers,node_crypto toneMint
class node_findings,node_pdf toneRose
class node_run_support,node_wordlists,node_operator,node_gobuster,node_target,node_report_user toneIndigo
```

## Components

### Scan orchestration

- [Scan CLI](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/cli.py): `wave_cli/cli.py`
- **Scan output files**

### Reconnaissance

- [Directory enumeration](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/gobuster_scanner.py): `wave_cli/scanners/gobuster_scanner.py`
- [Internal link scraping](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/internal_links_scraper.py): `wave_cli/scanners/internal_links_scraper.py`
- [Subdomain discovery](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/subdomain_scanner.py): `wave_cli/scanners/subdomain_scanner.py`

### OWASP checks

- [Security headers](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/owasp/A02_security_headers.py): `wave_cli/scanners/owasp/A02_security_headers.py`
- [Crypto checks](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/scanners/owasp/A04_cryptographic_failures.py): `wave_cli/scanners/owasp/A04_cryptographic_failures.py`

### Findings and reports

- [Findings collection](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/report_parser.py): `wave_cli/report_parser.py`
- [PDF report](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/report_generator.py): `wave_cli/report_generator.py`

### Scan support

- [Run and output paths](https://github.com/henry-felix-faure/wave-project/blob/main/wave_cli/utils.py): `wave_cli/utils.py`
- [Bundled wordlists](https://github.com/henry-felix-faure/wave-project/tree/main/wave_cli/wordlists): `wave_cli/wordlists`

### Other components

- **Scan operator**
- **Gobuster**
- **Website target**
- **Report recipient**

## Connections

- Scan operator → Scan CLI: invokes scan (evidence: `wave_cli/cli.py`)
- Scan CLI → Run and output paths: creates run paths (evidence: `wave_cli/cli.py`)
- Scan CLI → Directory enumeration: runs scan (evidence: `wave_cli/cli.py`)
- Scan CLI → Internal link scraping: scrapes links (evidence: `wave_cli/cli.py`)
- Scan CLI → Subdomain discovery: runs enumeration (evidence: `wave_cli/cli.py`)
- Scan CLI → Security headers: checks headers (evidence: `wave_cli/cli.py`)
- Scan CLI → Crypto checks: checks crypto (evidence: `wave_cli/cli.py`)
- Directory enumeration → Gobuster: executes (evidence: `wave_cli/scanners/gobuster_scanner.py`)
- Subdomain discovery → Gobuster: executes (evidence: `wave_cli/scanners/subdomain_scanner.py`)
- Directory enumeration → Run and output paths: resolves wordlist (evidence: `wave_cli/scanners/gobuster_scanner.py`)
- Subdomain discovery → Run and output paths: resolves wordlist (evidence: `wave_cli/scanners/subdomain_scanner.py`)
- Run and output paths → Bundled wordlists: locates bundled (evidence: `wave_cli/utils.py`)
- Directory enumeration → Scan output files: writes results (evidence: `wave_cli/scanners/gobuster_scanner.py`)
- Subdomain discovery → Scan output files: writes results (evidence: `wave_cli/scanners/subdomain_scanner.py`)
- Internal link scraping → Scan output files: writes links (evidence: `wave_cli/scanners/internal_links_scraper.py`)
- Security headers → Scan output files: writes results (evidence: `wave_cli/scanners/owasp/A02_security_headers.py`)
- Crypto checks → Scan output files: writes results (evidence: `wave_cli/scanners/owasp/A04_cryptographic_failures.py`)
- Scan CLI → Findings collection: collects findings (evidence: `wave_cli/cli.py`)
- Findings collection → Scan output files: reads scan outputs (evidence: `wave_cli/report_parser.py`)
- Scan CLI → PDF report: generates report (evidence: `wave_cli/cli.py`)
- Findings collection → PDF report: supplies findings (evidence: `wave_cli/cli.py`)
- PDF report → Report recipient: produces PDF (evidence: `wave_cli/report_generator.py`)
- Scan CLI → Website target: accepts target (evidence: `wave_cli/cli.py`)
