# trickest/cve architecture

> Architecture diagram of the GitHub repository trickest/cve, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trickest/cve
- Repository: https://github.com/trickest/cve

## Overview

CVE PoC is a public index of vulnerability records and links to proof-of-concept material. The main user workflow is to browse or search a CVE record and follow its PoC or reference links; the repository also documents an automated process for discovering, filtering, and publishing records. The year directories hold the catalog, while a small script converts those Markdown records into table data. The collection workflow is described in the README, but its implementation is not present in the supplied tree, so the graph does not infer internal calls between its stages.

Main entry points: [`1999/CVE-1999-0001.md`](https://github.com/trickest/cve/blob/main/1999/CVE-1999-0001.md) (CVE records), [`summary_html/generate_summary_json.py`](https://github.com/trickest/cve/blob/main/summary_html/generate_summary_json.py) (Summary generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["CVE catalog"]
  node_records["CVE records<br/>[CVE-1999-0001.md]"]
end

subgraph group_discovery["PoC discovery"]
  node_reference_search["Reference search"]
  node_github_search["GitHub search"]
  node_merge_filter["Merge and filter"]
  node_markdown_output["Markdown publishing"]
end

subgraph group_consumption["Catalog tools"]
  node_summary_generator["Summary generator"]
  node_table_data["Table JSON data"]
end

node_reader(("Repository user"))
node_cveproject[("cvelistV5")]
node_github_data[("GitHub PoC dataset")]
node_ffuf["ffuf"]
node_blacklist["False-positive blacklist"]
node_shields["shields.io"]
node_html_consumer["Searchable HTML table"]

node_reader -->|"browses"| node_records
node_reader -->|"runs"| node_summary_generator
node_records -->|"reads"| node_summary_generator
node_summary_generator -->|"writes"| node_table_data
node_table_data -->|"feeds"| node_html_consumer
node_cveproject -->|"provides CVEs"| node_reference_search
node_reference_search -->|"checks references"| node_ffuf
node_github_data -->|"provides PoC links"| node_github_search
node_reference_search -->|"supplies results"| node_merge_filter
node_github_search -->|"supplies results"| node_merge_filter
node_merge_filter -->|"filters with"| node_blacklist
node_merge_filter -->|"publishes records"| node_markdown_output
node_markdown_output -->|"updates catalog"| node_records
node_markdown_output -->|"generates badges"| node_shields

click node_records "https://github.com/trickest/cve/blob/main/1999/CVE-1999-0001.md"
click node_summary_generator "https://github.com/trickest/cve/blob/main/summary_html/generate_summary_json.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_records,node_reader toneBlue
class node_reference_search,node_github_search,node_merge_filter,node_markdown_output,node_cveproject,node_github_data toneAmber
class node_summary_generator,node_table_data toneMint
class node_ffuf,node_blacklist,node_shields,node_html_consumer toneIndigo
```

## Components

### CVE catalog

- [CVE records](https://github.com/trickest/cve/blob/main/1999/CVE-1999-0001.md): `1999/CVE-1999-0001.md`

### PoC discovery

- **Reference search**
- **GitHub search**
- **Merge and filter**
- **Markdown publishing**

### Catalog tools

- [Summary generator](https://github.com/trickest/cve/blob/main/summary_html/generate_summary_json.py): `summary_html/generate_summary_json.py`
- **Table JSON data**

### Other components

- **Repository user**
- **cvelistV5**
- **GitHub PoC dataset**
- **ffuf**
- **False-positive blacklist**
- **shields.io**
- **Searchable HTML table**

## Connections

- Repository user → CVE records: browses (evidence: `README.md`)
- Repository user → Summary generator: runs (evidence: `README.md`)
- CVE records → Summary generator: reads (evidence: `summary_html/generate_summary_json.py`)
- Summary generator → Table JSON data: writes (evidence: `summary_html/generate_summary_json.py`)
- Table JSON data → Searchable HTML table: feeds (evidence: `README.md`)
- cvelistV5 → Reference search: provides CVEs (evidence: `README.md`)
- Reference search → ffuf: checks references (evidence: `README.md`)
- GitHub PoC dataset → GitHub search: provides PoC links (evidence: `README.md`)
- Reference search → Merge and filter: supplies results (evidence: `README.md`)
- GitHub search → Merge and filter: supplies results (evidence: `README.md`)
- Merge and filter → False-positive blacklist: filters with (evidence: `README.md`)
- Merge and filter → Markdown publishing: publishes records (evidence: `README.md`)
- Markdown publishing → CVE records: updates catalog (evidence: `README.md`)
- Markdown publishing → shields.io: generates badges (evidence: `README.md`)
