Warconomy
Operator

Freshness matrix

A read-only currentness matrix for every important data surface: its source, the latest data date, when the source was last checked, the update cadence, the refresh command, and an honest freshness status. Dates are read from the committed snapshots; nothing is invented. This page changes no values.

The currentness of every major Warconomy data surface in one read-only matrix. 10 surfaces tracked; 6 have an on-demand refresh command. Each row names the source, the latest data date, the last source check (read from the committed snapshot's accessed date), the cadence and an honest status — so lagged-but-accurate official data reads as accurate, not stale. This page changes nothing; it tells a maintainer what to refresh and when.

  • 10 surfaces; statuses: 2 watch · 2 monthly · 3 annual · 1 citation-only · 1 scenario · 1 editorial.
  • Latest data date and last-checked date are read from the committed snapshots.
  • Refresh commands are on-demand; the default build never touches the network.
  • Machine-readable at /operator/freshness/data.json.

Monthly data (2)

RouteSourceLatest dataCheckedCadenceRefreshNext action
Commodity explorer (oil, gas, grains, fertilizer, metals)World Bank Commodity Markets (Pink Sheet)2024-12monthlynpm run commodities:ingest:worldbankRefresh monthly when the Pink Sheet updates.
Commodity & food price history (FAO + World Bank)FAO Food Price Index, World Bank Pink SheetFAO 2026-05 · WB 2024-12monthlynpm run commodities:ingest && npm run commodities:ingest:worldbankRefresh monthly; FAO releases early each month.

Annual official data (3)

RouteSourceLatest dataCheckedCadenceRefreshNext action
War & GDP historical comparisonWorld Bank World Development Indicatorsannual; latest year varies by countryannualnpm run wars:gdpRefresh annually; World Bank revises prior years.
Conflict economies (macro indicators)World Bank World Development Indicatorsannual; latest year varies by countryannualnpm run worldbank:macroRefresh annually.
War, population & economic scarringWorld Bank WDI, UN WPP via World Bankannual; latest year varies by countryannualnpm run worldbank:humancapital && npm run population:ingestRefresh annually.

Watchlist (2)

RouteSourceLatest dataCheckedCadenceRefreshNext action
Current signals watchlistEIA, IEA, OFAC, FAO GIEWS, IMF PortWatch, UNHCR, IOM, USGS, SIPRIn/a (watchlist)as-reviewed—Re-read every ~120 days; retire or update any item that no longer reflects the structural picture.
Russia–Ukraine hubWorld Bank prices, Warconomy briefingsfeatured chart: WB 2024-12as-reviewed—Watch items reviewed with the /current watchlist.

Scenario (1)

RouteSourceLatest dataCheckedCadenceRefreshNext action
Scenario Lab (educational calculators)World Bank Brent baseline, FAO Food Price Index baselinebaselines: WB 2024-12, FAO 2026-05monthly—No separate refresh; baselines update with the commodity ingest.

Citation-only (1)

RouteSourceLatest dataCheckedCadenceRefreshNext action
Critical mineralsWorld Bank metal prices, USGS Mineral Commodity SummariesWB prices 2024-12monthlynpm run commodities:ingest:worldbankRefresh metal prices monthly; USGS figures need a reviewed source packet (manual).

Editorial (1)

RouteSourceLatest dataCheckedCadenceRefreshNext action
Conflict mapWarconomy editorial (links to source-backed pages)n/a (orientation map)as-reviewed—Review region copy as conflict hubs evolve.

Source endpoint check (6/7 reachable)

On-demand availability + latest-date probe of the source endpoints (npm run current:check), last run June 25, 2026. Records reachability and dates only — never article text, never a claim. "Unreachable" means it could not be checked then, not that data is wrong.

SourceReachableHTTPLatestNote
FAO Food Price Index (CSV)yes2002026-06-05—
World Bank Pink Sheet (XLSX)yes2002025-01-03—
World Bank Indicators APIyes2002026-04-08—
GDELT DOC 2.0 (availability only)yes200——
ReliefWeb v2 (needs approved appname)no403——
IMF PortWatch portalyes200——
USGS Mineral Commodity Summaries (citation-only; blocks bots)yes2002026-06-25—

Manual setup:

  • ReliefWeb v2 requires a free, manually-approved appname (register at https://apidoc.reliefweb.int/parameters#appname). Until approved it returns 403; it is cited as a 'watch on' source only.
  • USGS pages block automated requests; mineral production/reserve figures stay citation-only and need a reviewed source packet.
  • EIA / FRED would need an optional, uncommitted env key (not yet wired); they are not required for any build.

Media-attention monitor (detect-only, deferred): npm run attention:check probes GDELT for coverage volume only (never article text) across the conflict-economy topics. It is deferred from any public or prominent surface: GDELT is heavily rate-limited (only ~2 of 8 topics returned data per run in testing) and attention is not truth or economic impact. Kept as an on-demand operator tool only.

Monthly refresh runbook

Warconomy validates locally (no hosted CI), so refreshes are a short manual runbook rather than a scheduled job — which keeps the default build network-free and avoids auto-publishing anything. Roughly monthly:

  1. Check what is newer: npm run current:check and npm run commodities:check-refresh (detect-only; never auto-ingests).
  2. If a commodity source flags a new release, re-ingest it: npm run commodities:ingest (FAO) and/or npm run commodities:ingest:worldbank (Pink Sheet, incl. metals).
  3. Refresh macro layers annually: npm run worldbank:macro, npm run worldbank:humancapital, npm run wars:gdp, npm run population:ingest.
  4. Review the git diff of the generated snapshot — confirm the latest period advanced, values are plausible, and the source schema did not change — then run npm run validate:release and commit by hand.
  5. Re-read the current-signals watchlist at its review cadence; update any item that no longer reflects the structural picture.

Nothing here runs automatically and nothing auto-publishes a claim — a human reviews every diff before it ships.

Related