{
  "schemaVersion": 1,
  "preparedOn": "2026-08-29",
  "status": "technical-provenance-resolved-geonames-cc-by-4.0",
  "sourceArchive": {
    "provider": "GeoNames",
    "dataset": "cities500.zip",
    "sourceUrl": "https://download.geonames.org/export/dump/cities500.zip",
    "directoryUrl": "https://download.geonames.org/export/dump/",
    "directoryTimestampAsDisplayed": "2026-08-29 03:53",
    "directoryTimestampTimezone": "not-stated-by-upstream-directory",
    "retrievedAt": "2026-08-29T19:18:48+03:00",
    "archiveByteLength": 13544221,
    "archiveSha256": "920bbad86c70e9e586bf2c67b0a0f582c4a6bbf6bc4fa649fe7c3381802dfabb",
    "member": "cities500.txt",
    "memberByteLength": 40766996,
    "memberRecordCount": 235549,
    "memberSha256": "131e1adb11c3f7c2a659496db44b7a99d0ff259e458ff1e52608d15764c7b9cb",
    "retainedOutsideRepository": true,
    "publisherChecksumAvailableInDirectoryReadme": false,
    "hashRole": "AstroMega retrieval receipt; not an upstream signature"
  },
  "sourceSubset": {
    "path": "src/lib/data/cities-geonames-2026-08-29.json",
    "byteLength": 69909,
    "sha256": "04fe1e9fe72028e09f8f8ae87052fbcc9b60a0d68c9e495b77a65d6fd74c5744",
    "recordCount": 124
  },
  "runtime": {
    "catalog": "src/lib/cities.ts",
    "displayNameRegionOrderPreserved": true,
    "coordinatePolicy": "exact pinned GeoNames snapshot values without rounding"
  },
  "generation": {
    "script": "scripts/import-geonames-cities.mjs",
    "command": "node scripts/import-geonames-cities.mjs --source-zip /path/to/cities500.zip",
    "rawArchiveCommittedToRepository": false
  },
  "contracts": {
    "displayNameRegionOrderSha256": "650a0c0444a814238286e2b3302647ba1b35a69e4c91d6de3af3a37eae02a3da",
    "fixedNameRegionGeonameIdSha256": "71336cab27d1419ca5f04eac129e506a7cf7f8dbd31d5431dceb98eb4cf6fc92"
  },
  "validation": {
    "uniqueGeonameIds": 124,
    "turkeyProvinceCentres": 81,
    "worldCities": 43,
    "uniqueTurkeyAdmin1Codes": 81,
    "turkeyFeatureCodes": {
      "PPLA": 80,
      "PPLC": 1,
      "pplcRecord": "Ankara"
    },
    "explicitCityCentreAliases": {
      "Hatay (Antakya)": {
        "geonameId": 323779,
        "sourceName": "Antakya"
      },
      "Kocaeli (İzmit)": {
        "geonameId": 745028,
        "sourceName": "İzmit"
      },
      "Sakarya (Adapazarı)": {
        "geonameId": 752850,
        "sourceName": "Adapazarı"
      }
    },
    "sourceDomainEdgeCases": {
      "Lefkoşa": {
        "displayRegion": "KKTC",
        "countryCode": "CY"
      },
      "Hong Kong": {
        "displayRegion": "Çin",
        "countryCode": "HK"
      }
    }
  },
  "migrationEvidence": {
    "previousCatalogSha256": "e12f14740e227992a9ed7a65e736d340ff75574e99e5cddb71fca7be0d8760d6",
    "currentToSourceCoordinateDistanceKm": {
      "mean": 1.074,
      "median": 0.564,
      "p95": 4.312,
      "maximum": 14.718,
      "atOrBelowOneKm": 90,
      "atOrBelowTwoKm": 108,
      "aboveFiveKm": 5
    }
  },
  "license": {
    "spdx": "CC-BY-4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "providerUrl": "https://www.geonames.org/",
    "notice": "docs/licenses/GeoNames-CC-BY-4.0-NOTICE.txt"
  },
  "attribution": "Coordinates, GeoNames identifiers and source place names are derived from GeoNames (https://www.geonames.org/) under CC BY 4.0. AstroMega selected and ordered 124 records, retained curated Turkish display names and region labels, mapped three province labels to city-centre records, and converted TSV fields to application JSON/runtime format. GeoNames does not endorse AstroMega."
}
