jevscan-evm

```
     ██╗███████╗██╗   ██╗███████╗ ██████╗ █████╗ ███╗   ██╗      ███████╗██╗   ██╗███╗   ███╗
     ██║██╔════╝██║   ██║██╔════╝██╔════╝██╔══██╗████╗  ██║      ██╔════╝██║   ██║████╗ ████║
     ██║█████╗  ██║   ██║███████╗██║     ███████║██╔██╗ ██║█████╗█████╗  ██║   ██║██╔████╔██║
██   ██║██╔══╝  ╚██╗ ██╔╝╚════██║██║     ██╔══██║██║╚██╗██║╚════╝██╔══╝  ╚██╗ ██╔╝██║╚██╔╝██║
╚█████╔╝███████╗ ╚████╔╝ ███████║╚██████╗██║  ██║██║ ╚████║      ███████╗ ╚████╔╝ ██║ ╚═╝ ██║
 ╚════╝ ╚══════╝  ╚═══╝  ╚══════╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═══╝      ╚══════╝  ╚═══╝  ╚═╝     ╚═╝
```

**Produce a heat map of likely bugs - in seconds, for pennies - built with TypeSafe's [Jev](https://docs.typesafe.ai).**

> **Warning:** this is a 100% vibe-coded proof of concept. I did not read one line of the code. Use at your own risk.

## Quick start

Python 3.11+ and a TypeSafe API key ([console.typesafe.ai](https://console.typesafe.ai)).

### Installation

```sh
git clone https://github.com/devtooligan/jevscan-evm.git && cd jevscan-evm
pip install aiohttp
cp .env.example .env              # then set TYPESAFE_API_KEY in .env
```

### Usage

```sh
python jevscan.py /path/to/repo
```

Results land in `out/<repo>/HEATMAP.md`. Settings (which folder, which files, thresholds) live in `jevscan.toml`; pass your own overrides with `--config` — see [docs/CONFIG.md](docs/CONFIG.md).

## What it checks

| Layer      | Questions | From                                                                                                                                                                                 |
| ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------