# Crimson Extract

The agent that reads energy contracts, bills and letters and writes a **Crimson Data Bridge**.

It does not invent commission, fair rates, wholesale series or uplifts.

## The product in five parts

1. **Crimson Extract** – the software that takes a folder or zip of files, sorts energy from mortgage, and pulls only the fields that are written on the page.
2. **Crimson Data Bridge** – the Excel workbook those fields go into. Blank cells are listed with a required action.
3. **Crimson Calculator** – the repaired BEC calculator that turns Bridge rows into Method 1 and Method 2 figures.
4. **Crimson Quantum Valuation** – the plain-English report for the solicitor. Facts and sources only. No legal advice.
5. **Weekly review** – a standing suggestion list for the Calculator (interest sources, base costs). A suggestion that is rejected this week is raised again next week. Nothing is applied to a live case until agreed.

## Hard rules

- No rates, no guessing.
- Mortgage SAR packs stay out of the energy Bridge.
- AppleDouble `._` files are discarded.
- Method 1 can be nil if the evidenced comparator is higher than the contract rate.

## Run one case or a batch

```bash
cd bec_agent
python -m src.main --input /path/to/case_folder --bridge data/bridge --output data/output
```

`--dry-run` classifies only.

One case is the same command with one folder. Twenty cases is the same command with a folder of twenty sub-folders or a zip.