## Cities database

The file `cities.db` is generated at build time from:

1. **GeoNames `cities500.zip`** — https://download.geonames.org/export/dump/cities500.zip
   Contains ~200 k cities with population ≥ 500, each carrying lat/lng, ISO country,
   admin1, population, elevation, and IANA tzid.
2. **Hebcal major-cities JSON** — Hebrew aliases for ~400 major Jewish-community cities,
   merged into the `name_he` column.

### Regenerate

```
python3 tools/build_cities_db.py \
    --geonames cities500.zip \
    --hebcal   hebcal_cities.json \
    --out      core/location/src/main/assets/databases/cities.db
```

The output schema matches `CitiesDatabase` / `CityEntity`; Room opens it in read-only
mode via `createFromAsset(…)`.

Do not commit the binary blob to VCS if it exceeds 50 MB; the build script is
reproducible from the source archives above.
