# Geography challenge: sources and credits

Research cut-off: **10 November 2026**. `input-lock.json` pins the source files
used by the offline build. The ignored cache is
`/home/eric/Work/Projects/Apps/KnowSoda/previews/geo-challenge/data/raw/`.
The other geography worktree and its cache were read only. Existing CLDR,
Wikidata licence and UN membership downloads were copied, not downloaded again.
No direct WPP download existed in that cache: its population series was WDI,
which is not a substitute for the requested WPP edition.

Every request made by `download.py`, including SPARQL requests, uses
`KnowSodaArt/0.1 (https://github.com/ericpastorm/KnowSoda)`. No email address,
account, login or API key is used. `build.py` never accesses the network.

## Unicode CLDR 48 (`unicode-cldr-48`)

- Publisher/version: Unicode, release 48 (2025), `common/main/en.xml`, `es.xml`,
  `pt.xml`, and `common/supplemental/supplementalData.xml`.
- Data: [release-48](https://github.com/unicode-org/cldr/tree/release-48).
  `es` supplies the Spain default; `pt` supplies the Brazilian default, not `pt_PT`.
- Fields: territory display names; language display names and script names;
  `territoryInfo/languagePopulation@populationPercent` and `@officialStatus`;
  **`territoryContainment/group@contains` supplies all five regional rounds**.
  Traverse the normal geographic tree from `001`; exclude `status=grouping`,
  `status=deprecated` and `grouping=true`. Membership groups overlap and are not rounds.
- Licence: [Unicode License v3](https://raw.githubusercontent.com/unicode-org/cldr/release-48/LICENSE).
  Verbatim: “Permission is hereby granted, free of charge, to any person obtaining a copy”.
- Required notice: include the **complete** [Unicode notice](licenses/UNICODE.txt)
  with redistributed data.
- Credit: **Unicode CLDR 48, © 2004–2025 Unicode, Inc., Unicode License v3.
  Country-label, regional-round and display adaptations by KnowSoda.**
- Individual language observation years are **not verified**: the release year
  is not a survey year. Speaker percentages overlap and include second languages.
  The brief fact selects the largest reported share and says “Widely spoken”.
  It does not claim that the language is legally official. Where CLDR lacks a
  translated language name, the seven-code Wikidata supplement supplies it.
  `apc` retains the northern variety used by this CLDR table; the broader merged
  Levantine-language entity is not substituted for its estimate.

## World Population Prospects 2024 (`un-wpp-2024`)

- Publisher: United Nations, DESA, Population Division.
- Edition: WPP 2024, Online Edition; demographic indicators, medium variant.
- [Download catalogue](https://population.un.org/wpp/assets/downloads.json)
  and [CSV download](https://population.un.org/wpp/assets/Excel%20Files/1_Indicator%20%28Standard%29/CSV_FILES/WPP2024_Demographic_Indicators_Medium.csv.gz).
- Field: **`TPopulation1July`**, source unit thousands, year **2026**,
  `Variant=Medium`; converted to people using decimal arithmetic. All 193 rows
  are **projections**, not censuses or 2026 observations. The raw thousand value,
  location ID and location footnote are retained. Display rounding does not alter
  the stored number.
- Licence: **[CC BY 3.0 IGO](https://creativecommons.org/licenses/by/3.0/igo/)**.
  The publisher's catalogue, `CSV format` footer, says:
  “made available under a Creative Commons license CC BY 3.0 IGO”.
  This dataset-specific grant is separate from the general UN website terms.
- Credit: **United Nations, Department of Economic and Social Affairs,
  Population Division (2024). World Population Prospects 2024, Online Edition.
  CC BY 3.0 IGO. 2026 medium projections; selection, unit conversion and display
  rounding by KnowSoda.**

## UN M49 (`un-m49`) and UN membership (`un-members`)

- Publisher: United Nations Statistics Division (classification); United Nations
  (membership list).
- [M49 overview](https://unstats.un.org/unsd/methodology/m49/overview/), downloaded
  10 November 2026; [UN members](https://www.un.org/en/about-us/member-states),
  reused snapshot of 9 November 2026.
- **Cross-check only:** compare the cached M49 round and leaf geographical-group
  codes with the independently generated CLDR assignments. All **193 agree**;
  there are **no country differences**. CLDR flattens some hierarchy levels,
  including Africa's subregions; the comparison accounts for M49 intermediate
  groups. M49 does not choose or overwrite a bundled assignment.
- Eligibility remains exactly `scripts/flags/members.py`'s 193 ISO2 codes.
  The generated `region_detail` is wholly CLDR-derived; the previous `m49` object
  is removed in schema 2. No M49 hierarchy table or wording is bundled.
- Terms: [United Nations Terms of Use](https://www.un.org/en/about-us/terms-of-use).
  Verbatim restriction: “personal, non-commercial use, without any right to resell
  or redistribute them or to compile or create derivative works therefrom”.
  A dataset-specific open M49 redistribution grant remains **not verified**.
  The selected redistribution source is now explicitly licensed **Unicode CLDR**.
- Research credit: **Unicode CLDR 48 territory containment; independently
  cross-checked against United Nations Statistics Division M49 on 10 November
  2026. UN member scope checked 9 November 2026.**
- These statistical groupings do not settle sovereignty, borders, nationality or
  physical continental boundaries. Dependencies and observer states are excluded.
  Naoero is the English name in the cached UN membership list; its code remains NR.

## Wikidata (`wikidata`)

- [Query service](https://query.wikidata.org/); snapshot 10 November 2026.
  Exact GET query URLs and returned data are cached and pinned.
- Fields: country ISO2 (`P297`), capital statements (`P36`) with start/end dates
  and rank, city labels (`rdfs:label`, including `mul` for shared proper names),
  city coordinates (`P625`), language-code labels (`P220`).
- Licence: **CC0**. [Licensing page](https://www.wikidata.org/wiki/Wikidata:Licensing):
  “released into the public domain under Creative Commons Zero”.
- Credit (recommended, not a CC0 attribution condition): **Wikidata contributors,
  CC0; snapshot 10 November 2026. Capital selection and language-authority
  corrections by KnowSoda.**
- Coordinates are representative city points. They are not boundaries, city
  centroids measured by this project, or coordinates of the executive office.
  Only terrestrial WKT points are accepted. Multiple coordinate statements use
  the first frozen result; their source precision is not a precision guarantee.
- Wikidata is not treated as proof of legal capital status. Historical/future
  statements are filtered, multiple current choices are reviewed explicitly,
  and the legal/reference evidence is recorded separately.

## World Development Indicators surface area (`world-bank-wdi-area`)

- Publisher: World Bank; upstream FAO electronic files and national statistics.
- [Series and metadata](https://api.worldbank.org/v2/sources/2/series/AG.SRF.TOTL.K2/metadata?format=json).
  API snapshot 10 November 2026; latest available observation in 2020–2025.
- Field: `AG.SRF.TOTL.K2`, **surface area in square kilometres**, including inland
  waters and some coastal waterways. Each country's actual year is retained.
  This is neither land-only area nor an area computed from the silhouette.
- Licence: **CC BY 4.0**. The series metadata's `License_Type` says “CC BY-4.0”
  and points to [World Bank data licences](https://datacatalog.worldbank.org/public-licenses#cc-by).
- Credit: **World Bank, World Development Indicators, surface area
  (AG.SRF.TOTL.K2), based on FAO and national sources. CC BY 4.0; accessed
  10 November 2026. Latest-observation selection and display rounding by KnowSoda.**
- Preserve national-source boundary conventions; do not reconcile territorial
  disputes by changing published numbers or summing observer-state rows.

## Spanish naming authority (`rae-dpd`)

- [RAE/ASALE, Países y capitales, con sus gentilicios](https://www.rae.es/dpd/ayuda/paises-y-capitales-con-sus-gentilicios),
  **DPD, second edition**, online snapshot 10 November 2026.
- This is the edition actually read. The requested **Ortografía (2010) country
  appendix was not verified**: attempted appendix/PDF URLs returned the general
  Ortografía index or 404. It is not falsely cited as the source of this table.
  Round 2 also verified [FundéuRAE's Esuatini recommendation](https://www.fundeu.es/recomendacion/suazilandia-o-esuatini-mejor-que-swazilandia-y-eswatini/),
  27 March 2019: both Suazilandia and Esuatini are accepted Spanish spellings.
  The Fundéu page itself refers to the 2010 appendix; this does not mean the whole
  appendix was retrieved. Its footer licences its own content under
  **CC BY-SA 3.0 Unported**, with the wording
  “Creative Commons Reconocimiento-CompartirIgual 3.0 Unported”.
  Credit: **FundéuRAE, Suazilandia/Esuatini recommendation (2019), CC BY-SA 3.0.**
  This licence is not attributed to the separate RAE DPD publication.
- Use: check Spanish factual place-name spellings. It is not a legal-capital
  authority. Its Nusantara, Malabo, Colombo, Melekeok, Bairiki and Yaren entries
  cannot determine the question's city or legal status; see the explicit rules.
- Open reuse licence for the publication: **not verified**; no licence quote
  establishing an open grant was found. Its definitions, prose and whole appendix
  are not redistributed; only individual factual names and references are used.
- Credit: **Spanish place-name spellings checked against RAE/ASALE,
  Diccionario panhispánico de dudas, 2nd edition, country/capital list,
  consulted 10 November 2026.**

## Brazilian Portuguese naming authority (`funag-itamaraty`)

- [FUNAG/Itamaraty, Topônimos e gentílicos](https://funag.gov.br/manual/index.php?title=Top%C3%B4nimos_e_gent%C3%ADlicos&oldid=684),
  Manual de redação oficial e diplomática do Itamaraty, revision **684**, last
  modified **8 September 2026** according to the page.
- Cross-check: [Itamaraty's current country list](https://www.gov.br/mre/pt-br/assuntos/relacoes-bilaterais/todos-os-paises).
- Use: Brazilian country and city spelling; primary diplomatic reference for
  capitals and split seats, with numbered notes. FUNAG's table omits Bahrain,
  Italy and Sierra Leone; their labels retain Wikidata, with the country names
  checked against Itamaraty's list. FUNAG lists Melekeok and Colombo: the quiz
  instead asks Ngerulmud and explicitly **legislative** Kotte.
- Open reuse licence for the manual: **not verified**. No open licence quote is
  asserted. Only factual names and citations are included, not the manual's prose.
  The general gov.br footer licence is not assumed to license a different host.
- Credit: **Brazilian Portuguese place names checked against FUNAG/Itamaraty,
  Manual de redação oficial e diplomática, Topônimos e gentílicos, revision 684
  (8 September 2026), and Itamaraty's bilateral country list.**

## Constitutions and national government evidence

`capital.sources` gives the specific instrument, edition, article and link for
each included legal provision. **Constitute Project is a translation mirror,
not the issuing legislature.** The legal instruments are primary texts; the
mirror's translations and currentness are not independently guaranteed. No
blanket “all 193 constitutions verified” claim is made. Known obsolete or
non-designating provisions are excluded and recorded in `LEGAL_WARNINGS`.
For other countries, `legal_verification` says **not verified** and distinguishes
the available official diplomatic reference from a constitutional declaration.

- [Constitute catalogue](https://www.constituteproject.org/service/constitutions?lang=en):
  cached 10 November 2026; exact editions and anchors are in each country.
  Reuse licence for the translations: **not verified**. No legal-text quotations
  or translations are redistributed in the JSON. Credit: **National constitutions,
  editions and articles cited per country; English translations consulted through
  the Constitute Project.**
- [Equatorial Guinea, Decreto Ley 1/2026](https://www.guineaecuatorialpress.com/noticias/decreto_ley_por_el_que_se_declara_la_ciudad_de_la_paz_djibloho_capital_de_la_republica_de_guinea_ecuatorial):
  2 January 2026, **Artículo Único 1–2**, and final provision. Names Ciudad de la
  Paz and gives offices one year to relocate. The final provision conditions
  effectiveness on promulgation and Gazette publication; the Gazette issue
  itself was **not verified**. The government's publication and FUNAG's September
  update both treat the capital designation as made. Article-specific reuse
  wording: “con la mención de la fuente de origen de la misma”. The site's general
  footer is more restrictive; no broad open licence is inferred.
  Credit: **Oficina de Información y Prensa de Guinea Ecuatorial, Decreto Ley
  1/2026 (2 January 2026).**
- [Swiss FDFA, Political system](https://www.aboutswitzerland.eda.admin.ch/en/political-system),
  published 29 April 2026: no de jure capital; Bern is the federal city.
  [South African Government, South Africa at a glance](https://www.gov.za/about-sa/south-africa-glance):
  three capital functions and the Constitutional Court in Johannesburg.
  Open publication licences: **not verified**; factual references only.
  Credit: **Swiss Federal Department of Foreign Affairs; South African Government,
  official country information, consulted 10 November 2026.**
- [Indonesian Constitutional Court, decision 71/PUU-XXIV/2026](https://s.mkri.id/public/content/persidangan/putusan/putusan_mkri_14254_1778573044.pdf),
  **12 May 2026**, paragraphs **3.12–3.13**, printed **pp. 53–55**, ruling p. 56.
  Primary judgment retrieved directly from `s.mkri.id`; it reproduces **Law 3/2022
  art. 39(1)** and confirms that Jakarta retains the capital's functions until
  the presidential transfer decree. [Official summary](https://s.mkri.id/public/content/persidangan/sinopsis/ikhtisar_4913_2971_ikhtisar%20Put%2071_2026%20(sudah%20koreksi).pdf)
  and [court's English account](https://en.mkri.id/news/details/2026-05-12/Capital_Relocation_Depends_on_Issuance_of_Presidential_Decree)
  also retrieved. The full judgment is the controlling source here.
  Open publication licence: **not verified**; original factual summary only.
  Credit: **Mahkamah Konstitusi Republik Indonesia, decision 71/PUU-XXIV/2026,
  12 May 2026, paras. 3.12–3.13; Law 3/2022 art. 39(1).**
- Later-decree check on **10 November 2026**: [Setkab search](https://setkab.go.id/?s=keppres+pemindahan)
  plus [JDIH Setneg](https://jdih.setneg.go.id/produk-hukum/instrumen/keputusan)'s
  public `api/hukumproduk/produkhukum` endpoint. A 2026 `pemindahan` query returned
  zero results; a 2026 `KEPPRES` query returned six records, latest dated 2 July,
  none transferring the capital. Exact POST parameters and responses are pinned.
  Domain-restricted indexed searches found no later operative decree either.
  **No transfer decree found; registry completeness through November not verified.**
  Jakarta is enabled under the owner's instruction. The older
  [Setkab readiness explanation](https://setkab.go.id/penandatanganan-keppres-pemindahan-ibu-kota-presiden-ikn-nusantara-harus-semuanya-sudah-siap/)
  remains historical context, not proof of 2026 non-issuance.
- **Equatorial Guinea round-2 Gazette evidence:** signed originals of
  [Decreto-Ley 1/2026](https://boe.gob.gq/files/LA%20PAZ%20CAPITAL%20DE%20G.E..pdf)
  and [ratifying Ley 4/2026, 10 April](https://boe.gob.gq/files/Ley%20que%20Declara%20la%20Ciudad%20de%20la%20Paz%2C%20Capital%20de%20G.E..pdf)
  were located using the official BOE search, downloaded and visually checked.
  Decree: Artículo Único 1–2, p. 3; final provision, p. 4. Law: Artículo Único,
  p. 1; final provision, p. 2. Exact electronic verification codes are recorded
  in `capital.sources`. The Gazette site displays instrument dates but no issue
  number or separately dated publication stamp. **Original numbered Gazette
  issue/effective publication date remains not verified.**
  Open reuse licence: **not verified**; no source prose reproduced in the bundle.
  Credit: **Boletín Oficial del Estado de Guinea Ecuatorial, Decreto-Ley 1/2026
  and Ley 4/2026; consulted 10 November 2026.**

## Current capital notes and English spelling checks (round 2)

- [UNFICYP, About the buffer zone](https://unficyp.unmissions.org/en/about-buffer-zone),
  updated 22 November 2025: Nicosia's division by the UN-controlled buffer zone.
- [UN Special Envoy for Yemen, visit to Aden](https://osesgy.unmissions.org/en/news/un-special-envoy-for-yemen-concludes-visit-to-aden),
  9 April 2026: meetings with the recognised government's prime minister,
  ministers and central bank governor in Aden. The [9 October briefing](https://osesgy.unmissions.org/en/news/briefing-by-the-un-special-envoy-for-yemen-hans-grundberg-to-the-security-council-3)
  provides the later government/Ansar Allah context.
- [UNSMIL Political Roadmap](https://unsmil.unmissions.org/en/political-roadmap),
  updated 22 July 2026; [October Security Council briefing report](https://unsmil.unmissions.org/en/news/hold-spoilers-accountable-srsg-urges-security-council-as-libya-take-critical-steps);
  [6 November Benghazi visit](https://unsmil.unmissions.org/en/news/srsg-hanna-tetteh-concludes-two-day-visit-to-benghazi-urges-swift-progress-on-the):
  continuing rival eastern/western institutions and work towards a unified executive.
- [Qatar News Agency, Sudan government return](https://qna.org.qa/en/News-Area/News/2026-1/12/sudans-government-officially-returns-to-khartoum-after-25-years),
  12 January 2026, reports the prime minister's announcement on **11 January**.
  Port Sudan is therefore described in past tense. This is an official news agency's
  report of an announcement, not a legal instrument or an audit of every office.
- [UN Demographic Yearbook 2024, table 8](https://unstats.un.org/unsd/demographic-social/products/dyb/documents/DYB2024/table08.pdf):
  English **Sana'a**, capital-city entry (upper-case in the original table).
  Used for spelling, not for legal capital selection, current population, or regions.
  English country overrides now use CLDR's actual `alt=variant` labels **Congo (DRC)**
  and **Congo (Republic)** and `alt=short` **Myanmar** instead of citing the flag module
  as a naming authority. Naoero and Cabo Verde follow the cached UN member list.
- These pages are factual reference sources, not bulk redistributed datasets.
  Dataset-specific open licences for these UN pages and the QNA story are
  **not verified**; no open grant or licence quote is invented. The already-quoted
  general UN terms remain applicable to the UN pages. Source prose, photographs
  and legal translations are not bundled; the three-language notes are original
  short factual summaries. Credit: **UNFICYP; OSESGY; UNSMIL; Qatar News Agency;
  United Nations Statistics Division, Demographic Yearbook 2024, table 8.
  Consulted 10 November 2026; note translations by KnowSoda.**

Wikipedia pages were used only to discover links to primary sources. They are
not data or legal sources for the generated country table. Failed searches,
irrelevant responses and exploratory downloads are not promoted into evidence.

## Suggested combined credit

**Country names and language estimates: Unicode CLDR 48 (Unicode License v3).
City coordinates and base labels: Wikidata (CC0). Population: UN DESA Population
Division, World Population Prospects 2024, Online Edition (CC BY 3.0 IGO), 2026
medium projections. Area: World Bank WDI / FAO (CC BY 4.0). Geographical grouping:
Unicode CLDR 48 territory containment (Unicode License v3), cross-checked with UN M49. Spanish and Brazilian Portuguese spellings
checked against RAE/ASALE and FUNAG/Itamaraty. Selection, translations of notes,
unit conversion and rounding by KnowSoda. Legal sources are cited per country.**

Include the linked licences and complete Unicode notice. CLDR supplies the
redistributable regional grouping; M49 is only a comparison. This combined credit
does not grant rights that a source has not granted.
