# Local usability improvements

These changes are in this local clone and the portfolio source download. They have not been pushed to GitHub.

## Run

```sh
./run.sh --analyze
./run.sh --report --format html -o report.html
```

The launcher creates `.venv` and installs `requirements.txt` on first use. Python 3.12 is the verified runtime. Override the interpreter with `PYTHON_BIN` or use a prepared environment through `PROJECT_PYTHON`.

## Changes

- Added a virtual-environment launcher.
- Prevented overflow for very long password estimates.
- Escaped dynamic strings in HTML reports and made recommendation ordering stable.

## Verification and scope

2 regression tests passed: long passwords and HTML injection. Strength scores remain heuristic estimates, not breach-database lookups.

## Run the regression tests

```sh
.venv/bin/python -m pip install -r requirements-dev.txt
.venv/bin/python -m pytest -q
```