timeprice 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b400f9dc1652d4476d884f59a2721e4f07338e76c5cc7afab50896267e1123c
-  data.tar.gz: 1a894e2464aa1f1495ddaa24c284b819a8afc07309cd3080f7c8c70744959ef2
+  metadata.gz: a91644504f73e6324d522d189233539a5515ca51cf0be58b1a34da90ff78220d
+  data.tar.gz: f6120dc38bb433e1dc8ac56e523b3c547d9323b578f34a27bddee3e43b48c9a2
 SHA512:
-  metadata.gz: 1f2c0b9ae5a4f8de71bdfdfb28f911b676773d406f86149b0c12ad5fbeb002ad51e42d43ed9f21d41c6ddd1a5b2760c2df58796759f66e7b78ac0dc784cee971
-  data.tar.gz: 8dc9e2ff73ddf7d0126538794bb4612a8709881628b713a1e878fe8fba7eddd510597f5a4f0a07e8c9d3b63cc751880df9150db208616f7fc52306ae2474bd10
+  metadata.gz: b8b0f99a9962bad944a02499761a586e860d50a3707e70de4d1549c6bf624ea5bf1a9d1d2beae488abdfc6646d825320259a196bfac177e64c25edab90e721e5
+  data.tar.gz: 54bb2545e7c9f9bbdb202994f3d5f53bb020a36bde0a2d8627c734a1c0e4312fcbe0237ce2b23409af9253ddc809ae74129dec43b17b94c559bcefa8917142cf

data/CHANGELOG.md

@@ -5,6 +5,39 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-05-11
+
+### Changed
+- **Schema v1 → v2.** Two structural data-layer changes, bundled under a
+  single bump:
+  - FX year files gain an optional top-level `annual` block. World Bank's
+    annual VND/USD average is stored there exactly once per year instead of
+    being broadcast across every daily date key. `Exchange.lookup_usd_base`
+    falls back from daily to annual when no daily entry exists within ±7
+    days and tags the result with `Granularity::ANNUAL`. `Compare` merges
+    FX granularity with CPI granularity (worst-precision wins).
+  - CPI provenance moves from a per-period map (`{"2025-01": "bls", ...}`)
+    to a compact range list (`[{series, from, to, provider}, ...]`). Single
+    -provider files (US/UK/EU/JP) collapse to 1–2 ranges; VN keeps the
+    WB→IMF transition explicit. ~42 kb saved across the 5 CPI files; one
+    real US data gap at 2025-10 is now visible instead of buried.
+- `country_file.rb` rebase label now preserves the original base reference
+  alongside the rebase date (e.g. `"2010=100 (rebased 2026-05-11)"`).
+
+### Added
+- Multi-source CPI chain for Vietnam: IMF Data Portal CPI dataflow
+  (`api.imf.org`, SDMX 2.1) is the monthly primary; World Bank `FP.CPI.TOTL`
+  remains as the annual fallback. The on-disk `data/cpi/vn.json` gains two
+  additive fields — `provenance` (per-period source id) and `providers`
+  (per-source status array) — so consumers can see which upstream supplied
+  each datapoint. Schema version is unchanged; old readers ignore the new
+  fields. Other country files (US, UK, EU, JP) gain the same fields on the
+  next refresh.
+- Internal: `Sources::Provider` / `Sources::CountryFile` / `Sources::MergePolicy`
+  seam for layering multiple providers into a single country file with
+  per-period provenance. Designed so future fresher sources (e.g. JP via
+  e-Stat) can be added as one more entry without further plumbing.
+
 ## [0.3.0] - 2026-05-11
 
 ### Added

data/DATA_LICENSES.md

@@ -12,7 +12,8 @@ string.
 | UK Office for National Statistics | `D7BT` (UK CPI all-items) | Open Government Licence v3.0 | https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/ | Contains public sector information licensed under the Open Government Licence v3.0 |
 | Eurostat | `prc_hicp_midx` (Euro area HICP) | Eurostat reuse policy — free reuse with source attribution | https://ec.europa.eu/eurostat/about-us/policies/copyright | Source: Eurostat |
 | World Bank | `FP.CPI.TOTL` (JP CPI fallback) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | Source: World Bank, FP.CPI.TOTL |
-| World Bank | `FP.CPI.TOTL` (VN CPI) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | Source: World Bank, FP.CPI.TOTL |
+| World Bank | `FP.CPI.TOTL` (VN CPI, annual fallback) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | Source: World Bank, FP.CPI.TOTL |
+| International Monetary Fund | CPI dataflow `VNM.CPI._T.IX.M` via IMF Data Portal (VN CPI, monthly primary) | Free reuse with attribution per IMF terms | https://www.imf.org/external/terms.htm | Source: IMF Data Portal CPI dataflow |
 | European Central Bank (via Frankfurter) | Daily reference rates, USD base, EUR/GBP/JPY | ECB reference rates — free reuse; Frankfurter is a non-commercial republisher with no separate license | https://www.ecb.europa.eu/services/disclaimer/html/index.en.html | FX data: European Central Bank reference rates via Frankfurter |
 | World Bank | `PA.NUS.FCRF` (VND annual average FX, broadcast daily) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | VND FX: World Bank, PA.NUS.FCRF |
 

data/README.md

@@ -98,7 +98,7 @@ Coverage is derived from the bundled `data/` files. Re-check with `timeprice sou
 | United Kingdom | GBP | ONS CPI all-items (`D7BT`) | Monthly + annual | 1988-01 → present |
 | Eurozone (EA) | EUR | Eurostat HICP (`prc_hicp_midx`) | Monthly + annual | 1996-01 → present |
 | Japan | JPY | World Bank `FP.CPI.TOTL` (fallback) | Annual | 1960 → 2024 |
-| Vietnam | VND | World Bank `FP.CPI.TOTL` | Annual | 1995 → 2024 |
+| Vietnam | VND | IMF Data Portal CPI dataflow (monthly primary) + World Bank `FP.CPI.TOTL` (annual fallback) | Monthly + annual | 1995 → present |
 
 **FX (USD base):** ECB reference rates via Frankfurter for **EUR / GBP / JPY**, daily
 1999 → present. **VND** uses the World Bank annual average (`PA.NUS.FCRF`) broadcast to
@@ -258,7 +258,7 @@ license — see `DATA_LICENSES.md` and `NOTICE` for the full table and license U
 - **UK CPI:** Contains public sector information licensed under the Open Government Licence v3.0.
 - **Eurozone HICP:** Source: Eurostat (reuse permitted with attribution).
 - **Japan CPI (fallback):** Source: World Bank, FP.CPI.TOTL (CC BY 4.0).
-- **Vietnam CPI:** Source: World Bank, FP.CPI.TOTL (CC BY 4.0).
+- **Vietnam CPI:** Sources: IMF Data Portal CPI dataflow (monthly primary); World Bank, FP.CPI.TOTL (annual fallback, CC BY 4.0).
 - **FX rates:** European Central Bank reference rates via Frankfurter.
 - **VND FX (annual broadcast):** World Bank, PA.NUS.FCRF (CC BY 4.0).
 

data/data/cpi/eu.json

@@ -395,7 +395,29 @@
     "2025-11": 129.33,
     "2025-12": 129.56
   },
-  "schema_version": 1,
+  "provenance": [
+    {
+      "series": "monthly",
+      "from": "1996-01",
+      "to": "2025-12",
+      "provider": "eurostat"
+    },
+    {
+      "series": "annual",
+      "from": "1996",
+      "to": "2025",
+      "provider": "eurostat"
+    }
+  ],
+  "providers": [
+    {
+      "fetched_at": "2026-05-11",
+      "id": "eurostat",
+      "label": "Eurostat prc_hicp_midx (HICP, EA all current members, CP00, 2015=100)",
+      "status": "ok"
+    }
+  ],
+  "schema_version": 2,
   "source": "Eurostat prc_hicp_midx (HICP, EA all current members, CP00, 2015=100)",
   "updated_at": "2026-05-11"
 }

data/data/cpi/jp.json

@@ -69,7 +69,23 @@
   "base_year": "2010=100",
   "country": "JP",
   "monthly": {},
-  "schema_version": 1,
-  "source": "World Bank FP.CPI.TOTL (annual)",
+  "provenance": [
+    {
+      "series": "annual",
+      "from": "1960",
+      "to": "2024",
+      "provider": "world_bank"
+    }
+  ],
+  "providers": [
+    {
+      "fetched_at": "2026-05-11",
+      "id": "world_bank",
+      "label": "World Bank FP.CPI.TOTL (annual, JP fallback)",
+      "status": "ok"
+    }
+  ],
+  "schema_version": 2,
+  "source": "World Bank FP.CPI.TOTL (annual, JP fallback)",
   "updated_at": "2026-05-11"
 }

data/data/cpi/uk.json

@@ -502,7 +502,29 @@
     "2026-02": 140.1,
     "2026-03": 141.0
   },
-  "schema_version": 1,
+  "provenance": [
+    {
+      "series": "monthly",
+      "from": "1988-01",
+      "to": "2026-03",
+      "provider": "ons"
+    },
+    {
+      "series": "annual",
+      "from": "1988",
+      "to": "2025",
+      "provider": "ons"
+    }
+  ],
+  "providers": [
+    {
+      "fetched_at": "2026-05-11",
+      "id": "ons",
+      "label": "ONS D7BT — UK CPI all-items index (2015=100)",
+      "status": "ok"
+    }
+  ],
+  "schema_version": 2,
   "source": "ONS D7BT — UK CPI all-items index (2015=100)",
   "updated_at": "2026-05-11"
 }

data/data/cpi/us.json

@@ -474,7 +474,35 @@
     "2026-02": 326.785,
     "2026-03": 330.213
   },
-  "schema_version": 1,
+  "provenance": [
+    {
+      "series": "monthly",
+      "from": "1990-01",
+      "to": "2025-09",
+      "provider": "bls"
+    },
+    {
+      "series": "monthly",
+      "from": "2025-11",
+      "to": "2026-03",
+      "provider": "bls"
+    },
+    {
+      "series": "annual",
+      "from": "1990",
+      "to": "2024",
+      "provider": "bls"
+    }
+  ],
+  "providers": [
+    {
+      "fetched_at": "2026-05-11",
+      "id": "bls",
+      "label": "BLS CUUR0000SA0 (CPI-U, U.S. city average, all items)",
+      "status": "ok"
+    }
+  ],
+  "schema_version": 2,
   "source": "BLS CUUR0000SA0 (CPI-U, U.S. city average, all items)",
   "updated_at": "2026-05-11"
 }

data/data/cpi/vn.json

@@ -1,40 +1,368 @@
 {
   "annual": {
-    "1995": 40.1657203822899,
-    "1996": 42.4451250139849,
-    "1997": 43.8074123636177,
-    "1998": 46.9905457039141,
-    "1999": 48.9251945689942,
-    "2000": 48.0884087276966,
-    "2001": 47.8808858390548,
-    "2002": 49.7151204031794,
-    "2003": 51.3232296369754,
-    "2004": 55.3033191440045,
-    "2005": 59.8849626753953,
-    "2006": 64.3272394775767,
-    "2007": 69.6949931031089,
-    "2008": 85.8053032346153,
-    "2009": 91.5688306084694,
-    "2010": 100.0,
-    "2011": 118.677732277071,
-    "2012": 129.471120024261,
-    "2013": 138.006729874285,
-    "2014": 143.643689923265,
-    "2015": 144.550370194288,
-    "2016": 148.407332801278,
-    "2017": 153.631652156685,
-    "2018": 159.069641224583,
-    "2019": 163.516947912918,
-    "2020": 168.783721483338,
-    "2021": 171.880422664063,
-    "2022": 177.305841095852,
-    "2023": 183.073410082137,
-    "2024": 189.702668041402
+    "1995": 21.083683,
+    "1996": 22.280182,
+    "1997": 22.995271,
+    "1998": 24.666152,
+    "1999": 25.681683,
+    "2000": 25.24244,
+    "2001": 25.133507,
+    "2002": 26.096,
+    "2003": 26.94,
+    "2004": 29.03,
+    "2005": 31.435,
+    "2006": 33.766,
+    "2007": 36.584,
+    "2008": 45.041,
+    "2009": 48.066,
+    "2010": 52.492,
+    "2011": 62.296,
+    "2012": 67.961,
+    "2013": 72.442,
+    "2014": 75.401,
+    "2015": 75.877,
+    "2016": 77.901,
+    "2017": 80.644,
+    "2018": 83.498,
+    "2019": 85.833,
+    "2020": 88.597,
+    "2021": 90.223,
+    "2022": 93.071,
+    "2023": 96.098,
+    "2024": 99.578,
+    "2025": 102.874
   },
-  "base_year": "2010=100",
+  "base_year": "2010=100 (rebased 2026-05-11)",
   "country": "VN",
-  "monthly": {},
-  "schema_version": 1,
-  "source": "World Bank FP.CPI.TOTL (annual)",
+  "monthly": {
+    "2001-12": 25.36739008790192,
+    "2002-01": 25.6322671259501,
+    "2002-02": 26.19617700272103,
+    "2002-03": 25.98660758669925,
+    "2002-04": 25.98660758669925,
+    "2002-05": 26.06456740945937,
+    "2002-06": 26.09063197686882,
+    "2002-07": 26.06454134489196,
+    "2002-08": 26.09060588623681,
+    "2002-09": 26.14278709800931,
+    "2002-10": 26.22121545930331,
+    "2002-11": 26.29987910568129,
+    "2002-12": 26.37877874299829,
+    "2003-01": 26.61618775168532,
+    "2003-02": 27.20174388222234,
+    "2003-03": 27.03853341892901,
+    "2003-04": 27.03853341892901,
+    "2003-05": 27.01149488551009,
+    "2003-06": 26.93046040085359,
+    "2003-07": 26.84966901965102,
+    "2003-08": 26.82281935063134,
+    "2003-09": 26.84964216998203,
+    "2003-10": 26.79594288564206,
+    "2003-11": 26.95671854295585,
+    "2003-12": 27.17237229129956,
+    "2004-01": 27.47126838650379,
+    "2004-02": 28.29540643809896,
+    "2004-03": 28.52176968960372,
+    "2004-04": 28.66437853805172,
+    "2004-05": 28.92235794489419,
+    "2004-06": 29.15373680845335,
+    "2004-07": 29.2995054924956,
+    "2004-08": 29.47530252545062,
+    "2004-09": 29.56372843302695,
+    "2004-10": 29.56372843302695,
+    "2004-11": 29.62285588989299,
+    "2004-12": 29.80059302523241,
+    "2005-01": 30.12839954850992,
+    "2005-02": 30.88160953722271,
+    "2005-03": 30.91249114675989,
+    "2005-04": 31.09796609364044,
+    "2005-05": 31.25345592410867,
+    "2005-06": 31.3784697478051,
+    "2005-07": 31.50398362679629,
+    "2005-08": 31.62999956130347,
+    "2005-09": 31.88303955779397,
+    "2005-10": 32.01057171602509,
+    "2005-11": 32.13861400288924,
+    "2005-12": 32.39572291491234,
+    "2006-01": 32.7844715898913,
+    "2006-02": 33.47294549327901,
+    "2006-03": 33.30558076581261,
+    "2006-04": 33.3721919273442,
+    "2006-05": 33.58296366583273,
+    "2006-06": 33.71393722412947,
+    "2006-07": 33.84542157930353,
+    "2006-08": 33.97403418130488,
+    "2006-09": 34.07595628384884,
+    "2006-10": 34.1577385789301,
+    "2006-11": 34.36610078426154,
+    "2006-12": 34.54480450833974,
+    "2007-01": 34.90752495567728,
+    "2007-02": 35.66501824721547,
+    "2007-03": 35.58655520707158,
+    "2007-04": 35.76092932758621,
+    "2007-05": 36.03628848340863,
+    "2007-06": 36.34259693551766,
+    "2007-07": 36.68421734671151,
+    "2007-08": 36.88598054211842,
+    "2007-09": 37.0740990428832,
+    "2007-10": 37.34844737580054,
+    "2007-11": 37.80783327852289,
+    "2007-12": 38.90804122692791,
+    "2008-01": 39.83405260812879,
+    "2008-02": 41.25214488097813,
+    "2008-03": 42.48558401291938,
+    "2008-04": 43.42026686120363,
+    "2008-05": 45.11799929547667,
+    "2008-06": 46.08352448039987,
+    "2008-07": 46.60426830702839,
+    "2008-08": 47.33129489261806,
+    "2008-09": 47.41649122342474,
+    "2008-10": 47.32639989010025,
+    "2008-11": 46.9667192509355,
+    "2008-12": 46.64734556002912,
+    "2009-01": 46.79661706582125,
+    "2009-02": 47.34413748549132,
+    "2009-03": 47.263652451766,
+    "2009-04": 47.42907523534718,
+    "2009-05": 47.63776316638273,
+    "2009-06": 47.89977086379782,
+    "2009-07": 48.14884967228953,
+    "2009-08": 48.26440691150305,
+    "2009-09": 48.56364623435439,
+    "2009-10": 48.74333172542149,
+    "2009-11": 49.01142004991128,
+    "2009-12": 49.68777764660009,
+    "2010-01": 50.36353142259381,
+    "2010-02": 51.3506566384767,
+    "2010-03": 51.73578656326526,
+    "2010-04": 51.80821666445386,
+    "2010-05": 51.94809884944788,
+    "2010-06": 52.06238466691662,
+    "2010-07": 52.0936220977168,
+    "2010-08": 52.21343742854153,
+    "2010-09": 52.89743345885546,
+    "2010-10": 53.45285651017339,
+    "2010-11": 54.44707964126261,
+    "2010-12": 55.52513181815963,
+    "2011-01": 56.49126911179558,
+    "2011-02": 57.67193663623217,
+    "2011-03": 58.92341766123841,
+    "2011-04": 60.87967512759147,
+    "2011-05": 62.22511594791128,
+    "2011-06": 62.90336971174353,
+    "2011-07": 63.63933913737092,
+    "2011-08": 64.23118499134844,
+    "2011-09": 64.75788070827751,
+    "2011-10": 64.99100907882735,
+    "2011-11": 65.24447401423478,
+    "2011-12": 65.59026972651019,
+    "2012-01": 66.2461724237753,
+    "2012-02": 67.15374498598106,
+    "2012-03": 67.2611909779586,
+    "2012-04": 67.29482157344756,
+    "2012-05": 67.4159522522798,
+    "2012-06": 67.24067077642384,
+    "2012-07": 67.04567283117221,
+    "2012-08": 67.46806057000863,
+    "2012-09": 68.95235790254878,
+    "2012-10": 69.53845294472042,
+    "2012-11": 69.86528367356061,
+    "2012-12": 70.05391993947929,
+    "2013-01": 70.92959393872272,
+    "2013-02": 71.86586457871388,
+    "2013-03": 71.72931943601428,
+    "2013-04": 71.74366529990154,
+    "2013-05": 71.70061910072155,
+    "2013-06": 71.73646941027194,
+    "2013-07": 71.93015787767966,
+    "2013-08": 72.5271781880644,
+    "2013-09": 73.29596627685785,
+    "2013-10": 73.65511651161448,
+    "2013-11": 73.905543907754,
+    "2013-12": 74.28246218168351,
+    "2014-01": 74.79501117073714,
+    "2014-02": 75.2063837321762,
+    "2014-03": 74.87547564375458,
+    "2014-04": 74.93537602426964,
+    "2014-05": 75.08524677631816,
+    "2014-06": 75.31050251664709,
+    "2014-07": 75.48371667243535,
+    "2014-08": 75.64978084911479,
+    "2014-09": 75.95237997251125,
+    "2014-10": 76.0359275904809,
+    "2014-11": 75.83063058598673,
+    "2014-12": 75.64863707258034,
+    "2015-01": 75.49733979843514,
+    "2015-02": 75.45959112853596,
+    "2015-03": 75.57278051522873,
+    "2015-04": 75.67858240795007,
+    "2015-05": 75.7996681398028,
+    "2015-06": 76.06496697829202,
+    "2015-07": 76.16385143536395,
+    "2015-08": 76.11053673935893,
+    "2015-09": 75.9507046122065,
+    "2015-10": 76.03425038727993,
+    "2015-11": 76.08762643105179,
+    "2015-12": 76.10033306466573,
+    "2016-01": 76.09896325867051,
+    "2016-02": 76.41797011265116,
+    "2016-03": 76.8531704524429,
+    "2016-04": 77.11047486711699,
+    "2016-05": 77.52748831519887,
+    "2016-06": 77.88760349842286,
+    "2016-07": 77.98729963090072,
+    "2016-08": 78.06715862572312,
+    "2016-09": 78.49114136421927,
+    "2016-10": 79.1440306780866,
+    "2016-11": 79.52447603355643,
+    "2016-12": 79.70539421653243,
+    "2017-01": 80.06916963573691,
+    "2017-02": 80.25637135434519,
+    "2017-03": 80.42330460676249,
+    "2017-04": 80.42587815250957,
+    "2017-05": 80.00167749824163,
+    "2017-06": 79.8647946280418,
+    "2017-07": 79.95240630774892,
+    "2017-08": 80.68572977840341,
+    "2017-09": 81.16346998442135,
+    "2017-10": 81.49916209627693,
+    "2017-11": 81.60633349443398,
+    "2017-12": 81.77476896676635,
+    "2018-01": 82.19026656788647,
+    "2018-02": 82.78795418636781,
+    "2018-03": 82.565171801653,
+    "2018-04": 82.63403115493541,
+    "2018-05": 83.08727881582027,
+    "2018-06": 83.59286490741486,
+    "2018-07": 83.51712977180858,
+    "2018-08": 83.89471071550687,
+    "2018-09": 84.39262582360362,
+    "2018-10": 84.67247177083406,
+    "2018-11": 84.42827636224732,
+    "2018-12": 84.2140818251166,
+    "2019-01": 84.29678005346895,
+    "2019-02": 84.97250304237694,
+    "2019-03": 84.79440067600062,
+    "2019-04": 85.05700893489386,
+    "2019-05": 85.47633998894268,
+    "2019-06": 85.39753080347333,
+    "2019-07": 85.55261271941242,
+    "2019-08": 85.79224558763903,
+    "2019-09": 86.06274853797704,
+    "2019-10": 86.56630167967305,
+    "2019-11": 87.39958889964116,
+    "2019-12": 88.62230914834711,
+    "2020-01": 89.71484497552845,
+    "2020-02": 89.5650211844189,
+    "2020-03": 88.92266085248433,
+    "2020-04": 87.55067311819099,
+    "2020-05": 87.52423281490988,
+    "2020-06": 88.10049236376315,
+    "2020-07": 88.45227762977117,
+    "2020-08": 88.51799767205,
+    "2020-09": 88.6282025791517,
+    "2020-10": 88.70433420516683,
+    "2020-11": 88.69688304109376,
+    "2020-12": 88.7880634368604,
+    "2021-01": 88.8434671884452,
+    "2021-02": 90.19219986383278,
+    "2021-03": 89.95075534479714,
+    "2021-04": 89.9163042055001,
+    "2021-05": 90.0587316313616,
+    "2021-06": 90.22750169443844,
+    "2021-07": 90.78907766498517,
+    "2021-08": 91.01414378851628,
+    "2021-09": 90.45395173349824,
+    "2021-10": 90.27023975752753,
+    "2021-11": 90.55991695690955,
+    "2021-12": 90.39546014771545,
+    "2022-01": 90.56865784935815,
+    "2022-02": 91.47651807564073,
+    "2022-03": 92.118408802977,
+    "2022-04": 92.28827514880957,
+    "2022-05": 92.63703254059693,
+    "2022-06": 93.27196676163082,
+    "2022-07": 93.64067084623942,
+    "2022-08": 93.6453528797819,
+    "2022-09": 94.01815502959602,
+    "2022-10": 94.15466939069903,
+    "2022-11": 94.51923627057985,
+    "2022-12": 94.507421366046,
+    "2023-01": 94.99441810834519,
+    "2023-02": 95.4208480512336,
+    "2023-03": 95.20529235548587,
+    "2023-04": 94.87921422916828,
+    "2023-05": 94.88633017023547,
+    "2023-06": 95.1400562171107,
+    "2023-07": 95.57275319278612,
+    "2023-08": 96.41484472116771,
+    "2023-09": 97.45602862931165,
+    "2023-10": 97.536137484845,
+    "2023-11": 97.77851478649475,
+    "2023-12": 97.8917423066175,
+    "2024-01": 98.19657814598979,
+    "2024-02": 99.21517125109811,
+    "2024-03": 98.98439676276803,
+    "2024-04": 99.0567543568016,
+    "2024-05": 99.10321197459496,
+    "2024-06": 99.26702958398901,
+    "2024-07": 99.73884577560173,
+    "2024-08": 99.73814760368128,
+    "2024-09": 100.0224013243518,
+    "2024-10": 100.3556759655645,
+    "2024-11": 100.4836294524206,
+    "2024-12": 100.7719169853196,
+    "2025-01": 101.7606910347796,
+    "2025-02": 102.1054562560054,
+    "2025-03": 102.0824159102041,
+    "2025-04": 102.151239382923,
+    "2025-05": 102.3146951306302,
+    "2025-06": 102.8050623737519,
+    "2025-07": 102.91690051692,
+    "2025-08": 102.9685181214591,
+    "2025-09": 103.4072677600416,
+    "2025-10": 103.6137381781981,
+    "2025-11": 104.08,
+    "2025-12": 104.28,
+    "2026-01": 104.33,
+    "2026-02": 105.52,
+    "2026-03": 106.83
+  },
+  "provenance": [
+    {
+      "series": "monthly",
+      "from": "2001-12",
+      "to": "2026-03",
+      "provider": "imf"
+    },
+    {
+      "series": "annual",
+      "from": "1995",
+      "to": "2001",
+      "provider": "world_bank"
+    },
+    {
+      "series": "annual",
+      "from": "2002",
+      "to": "2025",
+      "provider": "imf"
+    }
+  ],
+  "providers": [
+    {
+      "fetched_at": "2026-05-11",
+      "id": "world_bank",
+      "label": "World Bank FP.CPI.TOTL (annual)",
+      "status": "ok"
+    },
+    {
+      "fetched_at": "2026-05-11",
+      "id": "imf",
+      "label": "IMF Data Portal CPI dataflow (monthly) + World Bank FP.CPI.TOTL (annual)",
+      "status": "ok"
+    }
+  ],
+  "schema_version": 2,
+  "source": "IMF Data Portal CPI dataflow (monthly) + World Bank FP.CPI.TOTL (annual)",
   "updated_at": "2026-05-11"
 }

data/data/fx/usd/1983.json

@@ -1,12 +1,11 @@
 {
+  "schema_version": 2,
   "base": "USD",
-  "rates": {
-    "1983-01-02": {
-      "VND": 1.0
-    }
-  },
-  "schema_version": 1,
-  "source": "Frankfurter (ECB) for EUR/GBP/JPY; World Bank PA.NUS.FCRF for VND (annual avg, broadcast to every day in year)",
+  "year": 1983,
+  "source": "Frankfurter (ECB) for EUR/GBP/JPY (daily); World Bank PA.NUS.FCRF for VND (annual)",
   "updated_at": "2026-05-11",
-  "year": 1983
+  "rates": {},
+  "annual": {
+    "VND": 1.0
+  }
 }

data/data/fx/usd/1986.json

@@ -1,12 +1,11 @@
 {
+  "schema_version": 2,
   "base": "USD",
-  "rates": {
-    "1986-01-02": {
-      "VND": 22.94
-    }
-  },
-  "schema_version": 1,
-  "source": "Frankfurter (ECB) for EUR/GBP/JPY; World Bank PA.NUS.FCRF for VND (annual avg, broadcast to every day in year)",
+  "year": 1986,
+  "source": "Frankfurter (ECB) for EUR/GBP/JPY (daily); World Bank PA.NUS.FCRF for VND (annual)",
   "updated_at": "2026-05-11",
-  "year": 1986
+  "rates": {},
+  "annual": {
+    "VND": 22.94
+  }
 }