# LedgerSprout Category Registry

Drop `.yaml` files here to define or override auto-categorization rules.
Each file declares **one category** and a list of regex patterns matched
case-insensitively against the transaction description.

## File format

```yaml
name: My Category Name     # required — display name shown in the UI
priority: 65               # optional, default 50 — higher = matched first
patterns:                  # required — list of Python regex strings
  - "acme corp|widget co"
  - "consulting fee"
```

## Precedence

Rules in this directory are evaluated **before** the built-in defaults.
If your file uses the same `name` as a built-in, it **replaces** that built-in
entirely so you get full control over the patterns.

The first rule (highest priority) whose pattern matches the description wins.

## Built-in default categories

| Name                  | Priority |
|-----------------------|----------|
| Fees & Interest       | 80       |
| Income                | 70       |
| Food & Dining         | 60       |
| Transportation        | 60       |
| Entertainment         | 60       |
| Subscriptions         | 60       |
| Healthcare            | 60       |
| Utilities             | 60       |
| Mortgage & Rent       | 60       |
| Investments           | 60       |
| Travel                | 50       |
| Shopping              | 50       |
| Transfers             | 30       |

See `examples/` for ready-to-use YAML files you can copy into this directory.
