# vegax123/vulnradar architecture

> Architecture diagram of the GitHub repository vegax123/vulnradar, 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/vegax123/vulnradar
- Repository: https://github.com/vegax123/vulnradar

## Overview

VulnRadar is currently a minimal Python package, not yet a vulnerability scanner: its only runtime capability is displaying the package version through the CLI. The README explicitly says lockfile parsing, vulnerability lookup, matching, scoring, SBOM generation, persistence, API, and dashboard functionality have not been implemented. The Phase 0 experiments are prototypes, not shipped product components, so they are omitted. The graph shows the current CLI path only.

Main entry points: [`src/vulnradar/cli/__init__.py`](https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/cli/__init__.py) (Version CLI), [`src/vulnradar/__main__.py`](https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/__main__.py) (Module entry), [`src/vulnradar/__init__.py`](https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/__init__.py) (Version metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("CLI user"))
node_entry["Module entry<br/>[__main__.py]"]
node_cli["Version CLI<br/>[__init__.py]"]
node_version["Version metadata<br/>[__init__.py]"]

node_user -->|"requests version"| node_cli
node_entry -->|"calls run"| node_cli
node_cli -->|"reads version"| node_version

click node_entry "https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/__main__.py"
click node_cli "https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/cli/__init__.py"
click node_version "https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/__init__.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_user toneBlue
class node_entry,node_cli,node_version toneTeal
```

## Components

### Other components

- **CLI user**
- [Module entry](https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/__main__.py): `src/vulnradar/__main__.py`
- [Version CLI](https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/cli/__init__.py): `src/vulnradar/cli/__init__.py`
- [Version metadata](https://github.com/vegax123/vulnradar/blob/main/src/vulnradar/__init__.py): `src/vulnradar/__init__.py`

## Connections

- CLI user → Version CLI: requests version (evidence: `README.md`)
- Module entry → Version CLI: calls run (evidence: `src/vulnradar/__main__.py`)
- Version CLI → Version metadata: reads version (evidence: `src/vulnradar/cli/__init__.py`)
