Phase 1 foundation: Kenya migration via REGION toggle

Adds Kenya as a sibling region to the existing Tamil Nadu / India
pipeline behind a MARKET_INTEL_REGION env toggle (default: kenya).

- config.py loads markets_kenya.json / commodities_kenya.json /
farmers_kenya.json when REGION=kenya, preserving all India behavior
under REGION=india
- 10 KAMIS wholesale markets (Kibuye, Wakulima Nairobi, Kongowea,
Eldoret, Nakuru Wakulima, Kitengela, Kangemi, Karatina, Kathonzweni,
Kaanwa) with coordinates and commodity routing
- 4 commodities: Dry Maize (KAMIS product_id 1), Beans (30), Red Irish
Potato (57), Green Grams (10). Maize seasonal indices derived from
real 2021-2025 KAMIS cache; others from domain research
- 100 Kenyan farmer personas (mixed Swahili/Kikuyu/Luo/Luhya/Kalenjin
names), deterministic seed=42
- src/ingestion/kamis.py: live scrape + demo snapshot path, ports the
benchmark reference parser (expired-cert handling, 3s polite delay,
retry backoff). Plugs into pipeline._step_ingest as a sibling to
fetch_mandi_prices behind REGION dispatch
- src/rag/knowledge_base_kenya.py: 24 chunks across 6 categories
(crop calendars, market institutions, post-harvest, transport,
storage, shocks) with 20 distinct sources (FEWS NET, WFP, KALRO,
CIMMYT, Purdue PICS, KACE, etc.). provider.py switches KB by REGION
- India-specific tests (DPI Aadhaar/KCC module, Tamil-name assertions,
15-mandi/8-35-quintal range assertions) gated behind
@skipif(REGION != india) so Kenya pytest passes clean
- 5 new KAMIS ingestion tests: demo-mode smoke, commodity coverage,
ISO-date URL builder, PRODUCT_IDS pin for the 4 Kenya crops, HTML
fixture parser

E2E acceptance:
- MARKET_INTEL_REGION=india pytest tests/ -> 33 passed
- MARKET_INTEL_REGION=kenya pytest tests/ -> 15 passed, 18 India-only skipped
- MARKET_INTEL_REGION=kenya MARKET_INTEL_DEMO_MODE=1 pipeline.run() ->
7 steps ok, 308 KAMIS records, 100 Kenyan farmer recommendations in 7.2s

Phase 1.4 (Swahili translation + agent region-awareness), 1.5 (frontend
localization), 1.6 (region-parameterized fixtures), and 1.7 (Docker
default + CI matrix) still to come.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

commodities_kenya.json

@@ -0,0 +1,94 @@
+[
+  {
+    "id": "MZE-DRY",
+    "name": "Dry Maize",
+    "agmarknet_name": "Dry maize",
+    "kamis_product_id": 1,
+    "unit": "100kg",
+    "category": "cereal",
+    "perishability": "low",
+    "msp_2025_rs": null,
+    "base_price_rs": 8500,
+    "storage_rate_per_day": 3.0,
+    "spoilage_pct_per_day": 0.0012,
+    "harvest_windows": [
+      {"season": "long_rains", "months": [8, 9, 10]},
+      {"season": "short_rains", "months": [2, 3]}
+    ],
+    "seasonal_indices": {
+      "1": 1.10, "2": 1.13, "3": 1.03, "4": 1.02, "5": 0.88, "6": 0.94,
+      "7": 0.99, "8": 0.94, "9": 0.88, "10": 0.92, "11": 1.16, "12": 1.11
+    },
+    "post_harvest_loss": {"harvesting": 3.0, "threshing": 2.5, "transport": 1.5, "storage_per_month": 2.5},
+    "aliases": ["Dry maize", "Maize (Dry)", "White maize", "Mahindi"]
+  },
+  {
+    "id": "BEN-YGN",
+    "name": "Beans (Yellow-Green)",
+    "agmarknet_name": "Beans",
+    "kamis_product_id": 30,
+    "unit": "100kg",
+    "category": "pulse",
+    "perishability": "low",
+    "msp_2025_rs": null,
+    "base_price_rs": 13500,
+    "storage_rate_per_day": 3.5,
+    "spoilage_pct_per_day": 0.0010,
+    "harvest_windows": [
+      {"season": "long_rains", "months": [7, 8]},
+      {"season": "short_rains", "months": [1, 2]}
+    ],
+    "seasonal_indices": {
+      "1": 0.90, "2": 0.88, "3": 0.95, "4": 1.02, "5": 1.08, "6": 1.12,
+      "7": 0.92, "8": 0.88, "9": 0.95, "10": 1.05, "11": 1.10, "12": 1.15
+    },
+    "post_harvest_loss": {"harvesting": 2.5, "threshing": 2.0, "transport": 1.0, "storage_per_month": 2.0},
+    "aliases": ["Beans (yellow)", "Beans (green)", "Yellow beans", "Maharagwe"]
+  },
+  {
+    "id": "POT-RIR",
+    "name": "Red Irish Potato",
+    "agmarknet_name": "Potato",
+    "kamis_product_id": 57,
+    "unit": "100kg",
+    "category": "vegetable",
+    "perishability": "medium",
+    "msp_2025_rs": null,
+    "base_price_rs": 4500,
+    "storage_rate_per_day": 4.0,
+    "spoilage_pct_per_day": 0.0060,
+    "harvest_windows": [
+      {"season": "long_rains", "months": [7, 8, 9]},
+      {"season": "short_rains", "months": [1, 2]}
+    ],
+    "seasonal_indices": {
+      "1": 0.88, "2": 0.85, "3": 0.95, "4": 1.05, "5": 1.15, "6": 1.18,
+      "7": 0.95, "8": 0.85, "9": 0.90, "10": 1.00, "11": 1.10, "12": 1.14
+    },
+    "post_harvest_loss": {"harvesting": 3.5, "threshing": 0.0, "transport": 2.5, "storage_per_month": 6.0},
+    "aliases": ["Irish potato", "Potato", "Viazi"]
+  },
+  {
+    "id": "GRG-KEN",
+    "name": "Green Grams",
+    "agmarknet_name": "Green grams",
+    "kamis_product_id": 10,
+    "unit": "100kg",
+    "category": "pulse",
+    "perishability": "low",
+    "msp_2025_rs": null,
+    "base_price_rs": 16000,
+    "storage_rate_per_day": 3.5,
+    "spoilage_pct_per_day": 0.0008,
+    "harvest_windows": [
+      {"season": "long_rains", "months": [7, 8]},
+      {"season": "short_rains", "months": [12, 1]}
+    ],
+    "seasonal_indices": {
+      "1": 0.88, "2": 0.92, "3": 1.02, "4": 1.08, "5": 1.12, "6": 1.15,
+      "7": 0.92, "8": 0.88, "9": 0.95, "10": 1.05, "11": 1.10, "12": 0.90
+    },
+    "post_harvest_loss": {"harvesting": 2.5, "threshing": 1.5, "transport": 1.0, "storage_per_month": 1.5},
+    "aliases": ["Green gram", "Ndengu", "Mung bean"]
+  }
+]

config.py

@@ -27,10 +27,18 @@ FEATURED_FARMERS, ...).
 from __future__ import annotations
 
 import json
+import os
 from dataclasses import dataclass
 from pathlib import Path
 
 
+# ── Region toggle ───────────────────────────────────────────────────────
+# Default Kenya per product decision (LastMileBench MI primary panel).
+# Set MARKET_INTEL_REGION=india to load the original Tamil Nadu data.
+
+REGION = os.getenv("MARKET_INTEL_REGION", "kenya")
+
+
 # ── Project root / JSON loader ──────────────────────────────────────────
 
 _ROOT = Path(__file__).resolve().parent
@@ -41,11 +49,24 @@ def _load_json(name: str) -> list[dict]:
         return json.load(fh)
 
 
+# Per-region filenames. Kenya uses *_kenya.json; India (and anything else)
+# uses the original bare filenames so the existing Tamil Nadu pipeline is
+# byte-for-byte unchanged when REGION != "kenya".
+if REGION == "kenya":
+    _MARKETS_FILE = "markets_kenya.json"
+    _COMMODITIES_FILE = "commodities_kenya.json"
+    _FARMERS_FILE = "farmers_kenya.json"
+else:
+    _MARKETS_FILE = "markets.json"
+    _COMMODITIES_FILE = "commodities.json"
+    _FARMERS_FILE = "farmers.json"
+
+
 # ── Commodities ──────────────────────────────────────────────────────────
 # The raw dict shape is preserved so downstream code that indexes with
 # c["id"], c["name"], c["agmarknet_name"], c["category"], etc. keeps working.
 
-COMMODITIES: list[dict] = _load_json("commodities.json")
+COMMODITIES: list[dict] = _load_json(_COMMODITIES_FILE)
 COMMODITY_MAP: dict[str, dict] = {c["id"]: c for c in COMMODITIES}
 CATEGORIES = sorted({c["category"] for c in COMMODITIES})
 
@@ -97,7 +118,7 @@ class Mandi:
     reporting_quality: str  # "good", "moderate", "poor"
 
 
-_MARKETS_RAW = _load_json("markets.json")
+_MARKETS_RAW = _load_json(_MARKETS_FILE)
 
 MANDIS: list[Mandi] = [
     Mandi(
@@ -118,6 +139,10 @@ MANDIS: list[Mandi] = [
 
 MANDI_MAP: dict[str, Mandi] = {m.mandi_id: m for m in MANDIS}
 
+# Region-neutral alias: downstream code that isn't India-specific should
+# prefer MARKETS over MANDIS (the Indian term).
+MARKETS: list[Mandi] = MANDIS
+
 
 # ── API Endpoints ────────────────────────────────────────────────────────
 
@@ -154,12 +179,16 @@ class FarmerPersona:
     featured: bool = False  # Precomputed live in the weekly run for the demo UI
 
 
-# Curated, hand-written personas loaded from farmers.json. These drive the
-# screenshots, the tour narrative, and the featured demo cards. Every
-# curated persona is marked featured=True so they get precomputed
-# RECOMMEND calls every weekly pipeline run.
-_FARMERS_RAW = _load_json("farmers.json")
+# Curated, hand-written personas loaded from the region's farmers JSON.
+# India: 3 curated personas drive the demo UI; the other 97 are procedurally
+# generated to reach TARGET_FARMER_COUNT. Kenya: the JSON already contains
+# all 100 personas, so every entry is loaded and procedural generation
+# contributes zero additional farmers.
+_FARMERS_RAW = _load_json(_FARMERS_FILE)
 
+# Only the first 3 personas are marked featured=True (precomputed
+# RECOMMEND in the weekly pipeline). For India this covers the full
+# curated set; for Kenya it caps precomputed runs at 3 demo cards.
 _CURATED_FARMERS: list[FarmerPersona] = [
     FarmerPersona(
         farmer_id=f["farmer_id"],
@@ -171,9 +200,9 @@ _CURATED_FARMERS: list[FarmerPersona] = [
         quantity_quintals=float(f["quantity_quintals"]),
         has_storage=bool(f["has_storage"]),
         notes=f.get("notes", ""),
-        featured=True,
+        featured=(i < 3),
     )
-    for f in _FARMERS_RAW
+    for i, f in enumerate(_FARMERS_RAW)
 ]
 
 
@@ -259,3 +288,7 @@ SAMPLE_FARMERS: list[FarmerPersona] = (
 # Featured subset: only these farmers get precomputed RECOMMEND calls in the
 # weekly pipeline. The rest are available for on-demand computation.
 FEATURED_FARMERS: list[FarmerPersona] = [f for f in SAMPLE_FARMERS if f.featured]
+
+# Region-neutral alias: downstream code that isn't India-specific should
+# prefer FARMERS over SAMPLE_FARMERS.
+FARMERS: list[FarmerPersona] = SAMPLE_FARMERS

data/demo_snapshots/kamis/kamis_demo_snapshot.csv

@@ -0,0 +1,133 @@
+State,District,Market,Commodity,Variety,Min Price,Max Price,Modal Price,Arrivals (Tonnes),Price Date
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,17/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,17/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,17/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,17/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,16/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,16/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,16/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,16/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,15/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,15/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,15/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,15/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,14/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,14/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,14/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,14/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,13/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,13/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,13/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,13/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,10/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,10/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,10/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,10/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,09/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,09/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,09/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,09/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,07/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,07/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,07/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,07/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,02/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,02/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,02/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,02/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,01/04/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,01/04/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,01/04/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,01/04/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,31/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,31/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,31/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,31/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,30/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,30/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,30/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,30/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,27/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,27/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,27/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,27/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,26/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,25/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,25/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,25/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,25/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,24/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,24/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,24/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,24/03/2026
+Nairobi,Nairobi,Kangemi Market,Dry maize,,5000.0,5000.0,5000.0,,23/03/2026
+Nairobi,Nairobi,Kangemi Market,Beans (yellow-green),,15000.0,15000.0,15000.0,,23/03/2026
+Nairobi,Nairobi,Kangemi Market,Red irish potato,,4000.0,4000.0,4000.0,,23/03/2026
+Nairobi,Nairobi,Kangemi Market,Green grams,,17500.0,17500.0,17500.0,,23/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,23/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,23/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,23/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,23/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5500.0,6500.0,6500.0,,19/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16500.0,19500.0,19500.0,,19/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4400.0,5200.0,5200.0,,19/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,19250.0,22750.0,22750.0,,19/03/2026
+Nairobi,Nairobi,Kawangware,Dry maize,,5389.0,6500.0,6500.0,,18/03/2026
+Nairobi,Nairobi,Kawangware,Beans (yellow-green),,16167.0,19500.0,19500.0,,18/03/2026
+Nairobi,Nairobi,Kawangware,Red irish potato,,4311.2,5200.0,5200.0,,18/03/2026
+Nairobi,Nairobi,Kawangware,Green grams,,18861.5,22750.0,22750.0,,18/03/2026
+Nairobi,Nairobi,Kangemi Market,Dry maize,,5000.0,5000.0,5000.0,,18/03/2026
+Nairobi,Nairobi,Kangemi Market,Beans (yellow-green),,15000.0,15000.0,15000.0,,18/03/2026
+Nairobi,Nairobi,Kangemi Market,Red irish potato,,4000.0,4000.0,4000.0,,18/03/2026
+Nairobi,Nairobi,Kangemi Market,Green grams,,17500.0,17500.0,17500.0,,18/03/2026
+Nakuru,Nakuru,Molo,Dry maize,,4444.0,4444.0,4444.0,,27/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,13332.0,13332.0,13332.0,,27/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3555.2,3555.2,3555.2,,27/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15554.0,15554.0,15554.0,,27/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4444.0,4444.0,4444.0,,26/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,13332.0,13332.0,13332.0,,26/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3555.2,3555.2,3555.2,,26/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15554.0,15554.0,15554.0,,26/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4556.0,4556.0,4556.0,,24/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,13668.0,13668.0,13668.0,,24/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3644.8,3644.8,3644.8,,24/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15946.0,15946.0,15946.0,,24/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4556.0,4556.0,4556.0,,23/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,13668.0,13668.0,13668.0,,23/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3644.8,3644.8,3644.8,,23/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15946.0,15946.0,15946.0,,23/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4556.0,4556.0,4556.0,,22/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,13668.0,13668.0,13668.0,,22/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3644.8,3644.8,3644.8,,22/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15946.0,15946.0,15946.0,,22/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4333.0,4333.0,4333.0,,21/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,12999.0,12999.0,12999.0,,21/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3466.4,3466.4,3466.4,,21/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15165.5,15165.5,15165.5,,21/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4444.0,4444.0,4444.0,,20/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,13332.0,13332.0,13332.0,,20/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3555.2,3555.2,3555.2,,20/05/2025
+Nakuru,Nakuru,Molo,Green grams,,15554.0,15554.0,15554.0,,20/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,4222.0,4222.0,4222.0,,19/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,12666.0,12666.0,12666.0,,19/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3377.6,3377.6,3377.6,,19/05/2025
+Nakuru,Nakuru,Molo,Green grams,,14777.0,14777.0,14777.0,,19/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,3778.0,3778.0,3778.0,,17/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,11334.0,11334.0,11334.0,,17/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3022.4,3022.4,3022.4,,17/05/2025
+Nakuru,Nakuru,Molo,Green grams,,13223.0,13223.0,13223.0,,17/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,3778.0,3778.0,3778.0,,16/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,11334.0,11334.0,11334.0,,16/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3022.4,3022.4,3022.4,,16/05/2025
+Nakuru,Nakuru,Molo,Green grams,,13223.0,13223.0,13223.0,,16/05/2025
+Nakuru,Nakuru,Molo,Dry maize,,3778.0,3778.0,3778.0,,15/05/2025
+Nakuru,Nakuru,Molo,Beans (yellow-green),,11334.0,11334.0,11334.0,,15/05/2025
+Nakuru,Nakuru,Molo,Red irish potato,,3022.4,3022.4,3022.4,,15/05/2025
+Nakuru,Nakuru,Molo,Green grams,,13223.0,13223.0,13223.0,,15/05/2025

farmers_kenya.json

@@ -0,0 +1,1302 @@
+[
+  {
+    "farmer_id": "FMR-K0001",
+    "name": "Mogaka Okoth",
+    "location_name": "Kisumu",
+    "latitude": -0.2377,
+    "longitude": 34.6848,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 9.9,
+    "has_storage": false,
+    "distance_to_market_km": 4.5,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder dry maize farmer in Kisumu. 4.5 km to Kibuye; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0002",
+    "name": "Juma Odhiambo",
+    "location_name": "Kisumu",
+    "latitude": -0.0681,
+    "longitude": 34.6118,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 12.7,
+    "has_storage": true,
+    "distance_to_market_km": 18.2,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder dry maize farmer in Kisumu. 18.2 km to Kibuye; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0003",
+    "name": "Owino Muriuki",
+    "location_name": "Kisumu",
+    "latitude": -0.1193,
+    "longitude": 34.7371,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 33.3,
+    "has_storage": false,
+    "distance_to_market_km": 1.2,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder beans farmer in Kisumu. 1.2 km to Kibuye; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0004",
+    "name": "Jepkorir Kosgei",
+    "location_name": "Kisumu",
+    "latitude": -0.1618,
+    "longitude": 34.6669,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 8.6,
+    "has_storage": true,
+    "distance_to_market_km": 13.9,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder beans farmer in Kisumu. 13.9 km to Kibuye; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0005",
+    "name": "Kaloki Mwikali",
+    "location_name": "Kisumu",
+    "latitude": -0.0031,
+    "longitude": 34.8212,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 9.4,
+    "has_storage": true,
+    "distance_to_market_km": 32.4,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder green grams farmer in Kisumu. 32.4 km to Kibuye; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0006",
+    "name": "Wanjala Kibet",
+    "location_name": "Kisumu",
+    "latitude": -0.072,
+    "longitude": 34.8137,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 28.1,
+    "has_storage": false,
+    "distance_to_market_km": 27.3,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder dry maize farmer in Kisumu. 27.3 km to Kibuye; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0007",
+    "name": "Okoth Ochieng",
+    "location_name": "Kisumu",
+    "latitude": -0.1312,
+    "longitude": 34.7383,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 10.7,
+    "has_storage": false,
+    "distance_to_market_km": 13.1,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder beans farmer in Kisumu. 13.1 km to Kibuye; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0008",
+    "name": "Kamau Wekesa",
+    "location_name": "Kisumu",
+    "latitude": -0.085,
+    "longitude": 34.6757,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 18.3,
+    "has_storage": false,
+    "distance_to_market_km": 34.6,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder beans farmer in Kisumu. 34.6 km to Kibuye; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0009",
+    "name": "Asha Nafula",
+    "location_name": "Kisumu",
+    "latitude": -0.0398,
+    "longitude": 34.8552,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 13.0,
+    "has_storage": true,
+    "distance_to_market_km": 2.1,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder dry maize farmer in Kisumu. 2.1 km to Kibuye; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0010",
+    "name": "Wafula Kinyanjui",
+    "location_name": "Kisumu",
+    "latitude": -0.1819,
+    "longitude": 34.8852,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 16.0,
+    "has_storage": true,
+    "distance_to_market_km": 23.3,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder green grams farmer in Kisumu. 23.3 km to Kibuye; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0011",
+    "name": "Korir Omondi",
+    "location_name": "Kisumu",
+    "latitude": -0.1657,
+    "longitude": 34.6763,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 23.9,
+    "has_storage": true,
+    "distance_to_market_km": 26.4,
+    "nearest_market_id": "MKT-KIB",
+    "notes": "Smallholder green grams farmer in Kisumu. 26.4 km to Kibuye; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0012",
+    "name": "Mutembei Juma",
+    "location_name": "Nairobi",
+    "latitude": -1.3335,
+    "longitude": 36.9762,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 22.8,
+    "has_storage": true,
+    "distance_to_market_km": 4.1,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder beans farmer in Nairobi. 4.1 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0013",
+    "name": "Kinuthia Ouma",
+    "location_name": "Nairobi",
+    "latitude": -1.2539,
+    "longitude": 36.9146,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 25.9,
+    "has_storage": false,
+    "distance_to_market_km": 14.1,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder green grams farmer in Nairobi. 14.1 km to Nairobi Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0014",
+    "name": "Kipkoech Mogaka",
+    "location_name": "Nairobi",
+    "latitude": -1.3667,
+    "longitude": 36.843,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 28.8,
+    "has_storage": false,
+    "distance_to_market_km": 4.9,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder dry maize farmer in Nairobi. 4.9 km to Nairobi Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0015",
+    "name": "Wafula Kosgei",
+    "location_name": "Nairobi",
+    "latitude": -1.4086,
+    "longitude": 36.8074,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 5.1,
+    "has_storage": false,
+    "distance_to_market_km": 25.6,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder green grams farmer in Nairobi. 25.6 km to Nairobi Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0016",
+    "name": "Halima Barasa",
+    "location_name": "Nairobi",
+    "latitude": -1.2898,
+    "longitude": 36.7089,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 34.5,
+    "has_storage": true,
+    "distance_to_market_km": 18.3,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 18.3 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0017",
+    "name": "Muthama Wafula",
+    "location_name": "Nairobi",
+    "latitude": -1.2803,
+    "longitude": 36.9106,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 26.0,
+    "has_storage": true,
+    "distance_to_market_km": 17.6,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder dry maize farmer in Nairobi. 17.6 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0018",
+    "name": "Musyoka Kiprop",
+    "location_name": "Nairobi",
+    "latitude": -1.3703,
+    "longitude": 36.7493,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 8.0,
+    "has_storage": true,
+    "distance_to_market_km": 17.5,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder dry maize farmer in Nairobi. 17.5 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0019",
+    "name": "Said Opiyo",
+    "location_name": "Nairobi",
+    "latitude": -1.4036,
+    "longitude": 36.8196,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 14.3,
+    "has_storage": true,
+    "distance_to_market_km": 30.7,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder beans farmer in Nairobi. 30.7 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0020",
+    "name": "Ouma Muriuki",
+    "location_name": "Nairobi",
+    "latitude": -1.2155,
+    "longitude": 36.884,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 19.0,
+    "has_storage": true,
+    "distance_to_market_km": 23.8,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 23.8 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0021",
+    "name": "Hassan Abdalla",
+    "location_name": "Nairobi",
+    "latitude": -1.4058,
+    "longitude": 36.7444,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 5.7,
+    "has_storage": false,
+    "distance_to_market_km": 19.8,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 19.8 km to Nairobi Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0022",
+    "name": "Wanjiku Mbugua",
+    "location_name": "Nairobi",
+    "latitude": -1.2297,
+    "longitude": 36.6947,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 36.7,
+    "has_storage": true,
+    "distance_to_market_km": 30.2,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder dry maize farmer in Nairobi. 30.2 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0023",
+    "name": "Nabwire Nzioka",
+    "location_name": "Nairobi",
+    "latitude": -1.2414,
+    "longitude": 36.7413,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 30.3,
+    "has_storage": false,
+    "distance_to_market_km": 31.0,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder beans farmer in Nairobi. 31.0 km to Nairobi Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0024",
+    "name": "Nafula Mutembei",
+    "location_name": "Nairobi",
+    "latitude": -1.1999,
+    "longitude": 36.7341,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 28.1,
+    "has_storage": true,
+    "distance_to_market_km": 13.0,
+    "nearest_market_id": "MKT-NWK",
+    "notes": "Smallholder dry maize farmer in Nairobi. 13.0 km to Nairobi Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0025",
+    "name": "Muthoni Ochieng",
+    "location_name": "Mombasa",
+    "latitude": -4.1595,
+    "longitude": 39.7561,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 13.7,
+    "has_storage": true,
+    "distance_to_market_km": 7.5,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder dry maize farmer in Mombasa. 7.5 km to Kongowea; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0026",
+    "name": "Jepkorir Simiyu",
+    "location_name": "Mombasa",
+    "latitude": -4.0941,
+    "longitude": 39.6125,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 20.5,
+    "has_storage": false,
+    "distance_to_market_km": 30.3,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder dry maize farmer in Mombasa. 30.3 km to Kongowea; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0027",
+    "name": "Muthoni Muriuki",
+    "location_name": "Mombasa",
+    "latitude": -3.9269,
+    "longitude": 39.8283,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 10.8,
+    "has_storage": true,
+    "distance_to_market_km": 17.5,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder beans farmer in Mombasa. 17.5 km to Kongowea; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0028",
+    "name": "Kipchumba Ndungu",
+    "location_name": "Mombasa",
+    "latitude": -4.1283,
+    "longitude": 39.5382,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 14.3,
+    "has_storage": false,
+    "distance_to_market_km": 27.7,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder green grams farmer in Mombasa. 27.7 km to Kongowea; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0029",
+    "name": "Jepkorir Kathambi",
+    "location_name": "Mombasa",
+    "latitude": -4.1313,
+    "longitude": 39.6266,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 25.3,
+    "has_storage": false,
+    "distance_to_market_km": 19.4,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder dry maize farmer in Mombasa. 19.4 km to Kongowea; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0030",
+    "name": "Nyokabi Gitau",
+    "location_name": "Mombasa",
+    "latitude": -4.0024,
+    "longitude": 39.6885,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 7.0,
+    "has_storage": false,
+    "distance_to_market_km": 18.3,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder beans farmer in Mombasa. 18.3 km to Kongowea; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0031",
+    "name": "Njenga Kinyanjui",
+    "location_name": "Mombasa",
+    "latitude": -3.9751,
+    "longitude": 39.6082,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 38.0,
+    "has_storage": false,
+    "distance_to_market_km": 20.4,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder dry maize farmer in Mombasa. 20.4 km to Kongowea; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0032",
+    "name": "Wangari Otieno",
+    "location_name": "Mombasa",
+    "latitude": -4.0519,
+    "longitude": 39.7127,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 37.7,
+    "has_storage": false,
+    "distance_to_market_km": 7.9,
+    "nearest_market_id": "MKT-KON",
+    "notes": "Smallholder Irish potato farmer in Mombasa. 7.9 km to Kongowea; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0033",
+    "name": "Nabwire Mwikali",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.483,
+    "longitude": 35.3213,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 21.0,
+    "has_storage": false,
+    "distance_to_market_km": 32.6,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 32.6 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0034",
+    "name": "Njeri Mwenda",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.5506,
+    "longitude": 35.2887,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 7.6,
+    "has_storage": true,
+    "distance_to_market_km": 8.2,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder dry maize farmer in Uasin Gishu. 8.2 km to Eldoret Main; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0035",
+    "name": "Kaloki Kinyanjui",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.6281,
+    "longitude": 35.2307,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 20.3,
+    "has_storage": true,
+    "distance_to_market_km": 19.5,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder dry maize farmer in Uasin Gishu. 19.5 km to Eldoret Main; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0036",
+    "name": "Salim Mwangi",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.5647,
+    "longitude": 35.2862,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 8.6,
+    "has_storage": true,
+    "distance_to_market_km": 30.9,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder Irish potato farmer in Uasin Gishu. 30.9 km to Eldoret Main; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0037",
+    "name": "Githinji Ouma",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.446,
+    "longitude": 35.3012,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 17.0,
+    "has_storage": false,
+    "distance_to_market_km": 24.4,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder Irish potato farmer in Uasin Gishu. 24.4 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0038",
+    "name": "Halima Kathambi",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.4396,
+    "longitude": 35.3922,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 8.2,
+    "has_storage": true,
+    "distance_to_market_km": 15.4,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder dry maize farmer in Uasin Gishu. 15.4 km to Eldoret Main; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0039",
+    "name": "Wanjiku Chebet",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.5956,
+    "longitude": 35.3109,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 10.7,
+    "has_storage": false,
+    "distance_to_market_km": 16.0,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 16.0 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0040",
+    "name": "Asha Mwangi",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.3979,
+    "longitude": 35.4033,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 36.6,
+    "has_storage": false,
+    "distance_to_market_km": 19.6,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder Irish potato farmer in Uasin Gishu. 19.6 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0041",
+    "name": "Mutembei Omondi",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.4932,
+    "longitude": 35.1323,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 36.5,
+    "has_storage": false,
+    "distance_to_market_km": 28.1,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 28.1 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0042",
+    "name": "Mwende Nabwire",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.5689,
+    "longitude": 35.3199,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 32.3,
+    "has_storage": true,
+    "distance_to_market_km": 31.1,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 31.1 km to Eldoret Main; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0043",
+    "name": "Moraa Ouma",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.642,
+    "longitude": 35.1908,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 39.2,
+    "has_storage": false,
+    "distance_to_market_km": 28.6,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder dry maize farmer in Uasin Gishu. 28.6 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0044",
+    "name": "Mumbi Barasa",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.5853,
+    "longitude": 35.2195,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 33.1,
+    "has_storage": false,
+    "distance_to_market_km": 30.4,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 30.4 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0045",
+    "name": "Wafula Owino",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.4791,
+    "longitude": 35.1314,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 12.8,
+    "has_storage": false,
+    "distance_to_market_km": 28.8,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 28.8 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0046",
+    "name": "Shikuku Mutua",
+    "location_name": "Uasin Gishu",
+    "latitude": 0.4312,
+    "longitude": 35.3178,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 16.5,
+    "has_storage": false,
+    "distance_to_market_km": 30.4,
+    "nearest_market_id": "MKT-ELD",
+    "notes": "Smallholder beans farmer in Uasin Gishu. 30.4 km to Eldoret Main; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0047",
+    "name": "Barasa Korir",
+    "location_name": "Nakuru",
+    "latitude": -0.2607,
+    "longitude": 36.0499,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 16.6,
+    "has_storage": false,
+    "distance_to_market_km": 1.9,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder Irish potato farmer in Nakuru. 1.9 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0048",
+    "name": "Wekesa Barasa",
+    "location_name": "Nakuru",
+    "latitude": -0.2789,
+    "longitude": 36.2251,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 8.8,
+    "has_storage": false,
+    "distance_to_market_km": 15.8,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder dry maize farmer in Nakuru. 15.8 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0049",
+    "name": "Mutua Mohamed",
+    "location_name": "Nakuru",
+    "latitude": -0.2712,
+    "longitude": 36.0834,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 36.5,
+    "has_storage": true,
+    "distance_to_market_km": 7.5,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder beans farmer in Nakuru. 7.5 km to Nakuru Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0050",
+    "name": "Chepngetich Kamau",
+    "location_name": "Nakuru",
+    "latitude": -0.2971,
+    "longitude": 36.172,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 30.2,
+    "has_storage": false,
+    "distance_to_market_km": 26.2,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder Irish potato farmer in Nakuru. 26.2 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0051",
+    "name": "Musyoka Mohamed",
+    "location_name": "Nakuru",
+    "latitude": -0.4321,
+    "longitude": 36.1293,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 26.8,
+    "has_storage": true,
+    "distance_to_market_km": 23.6,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder beans farmer in Nakuru. 23.6 km to Nakuru Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0052",
+    "name": "Makokha Kwamboka",
+    "location_name": "Nakuru",
+    "latitude": -0.3603,
+    "longitude": 36.0525,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 29.4,
+    "has_storage": true,
+    "distance_to_market_km": 19.9,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder beans farmer in Nakuru. 19.9 km to Nakuru Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0053",
+    "name": "Nzioka Barasa",
+    "location_name": "Nakuru",
+    "latitude": -0.2684,
+    "longitude": 36.0203,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 34.2,
+    "has_storage": true,
+    "distance_to_market_km": 11.3,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder Irish potato farmer in Nakuru. 11.3 km to Nakuru Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0054",
+    "name": "Mutembei Chepkoech",
+    "location_name": "Nakuru",
+    "latitude": -0.3136,
+    "longitude": 36.0626,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 22.9,
+    "has_storage": false,
+    "distance_to_market_km": 28.0,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder dry maize farmer in Nakuru. 28.0 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0055",
+    "name": "Awino Otieno",
+    "location_name": "Nakuru",
+    "latitude": -0.368,
+    "longitude": 36.1292,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 16.7,
+    "has_storage": false,
+    "distance_to_market_km": 28.8,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder Irish potato farmer in Nakuru. 28.8 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0056",
+    "name": "Shikuku Nafula",
+    "location_name": "Nakuru",
+    "latitude": -0.2111,
+    "longitude": 35.9742,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 13.6,
+    "has_storage": false,
+    "distance_to_market_km": 17.2,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder dry maize farmer in Nakuru. 17.2 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0057",
+    "name": "Kamau Mwenda",
+    "location_name": "Nakuru",
+    "latitude": -0.3288,
+    "longitude": 36.1189,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 30.1,
+    "has_storage": true,
+    "distance_to_market_km": 14.1,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder dry maize farmer in Nakuru. 14.1 km to Nakuru Wakulima; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0058",
+    "name": "Adhiambo Kamau",
+    "location_name": "Nakuru",
+    "latitude": -0.1853,
+    "longitude": 36.1881,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 32.2,
+    "has_storage": false,
+    "distance_to_market_km": 8.4,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder dry maize farmer in Nakuru. 8.4 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0059",
+    "name": "Hassan Kinoti",
+    "location_name": "Nakuru",
+    "latitude": -0.438,
+    "longitude": 36.0048,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 21.0,
+    "has_storage": false,
+    "distance_to_market_km": 28.2,
+    "nearest_market_id": "MKT-NAK",
+    "notes": "Smallholder dry maize farmer in Nakuru. 28.2 km to Nakuru Wakulima; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0060",
+    "name": "Asha Kipchumba",
+    "location_name": "Kajiado",
+    "latitude": -1.3397,
+    "longitude": 37.0761,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 33.5,
+    "has_storage": true,
+    "distance_to_market_km": 31.3,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder green grams farmer in Kajiado. 31.3 km to Kitengela; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0061",
+    "name": "Rehema Abdalla",
+    "location_name": "Kajiado",
+    "latitude": -1.3555,
+    "longitude": 37.0318,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 20.8,
+    "has_storage": false,
+    "distance_to_market_km": 26.6,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder beans farmer in Kajiado. 26.6 km to Kitengela; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0062",
+    "name": "Barasa Nyaboke",
+    "location_name": "Kajiado",
+    "latitude": -1.4793,
+    "longitude": 36.8805,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 7.7,
+    "has_storage": true,
+    "distance_to_market_km": 10.7,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder beans farmer in Kajiado. 10.7 km to Kitengela; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0063",
+    "name": "Mutua Muriuki",
+    "location_name": "Kajiado",
+    "latitude": -1.6005,
+    "longitude": 36.8539,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 29.3,
+    "has_storage": true,
+    "distance_to_market_km": 25.0,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder beans farmer in Kajiado. 25.0 km to Kitengela; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0064",
+    "name": "Chepkoech Chebet",
+    "location_name": "Kajiado",
+    "latitude": -1.4619,
+    "longitude": 36.9334,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 34.2,
+    "has_storage": false,
+    "distance_to_market_km": 14.2,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder dry maize farmer in Kajiado. 14.2 km to Kitengela; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0065",
+    "name": "Wambui Jepkorir",
+    "location_name": "Kajiado",
+    "latitude": -1.4816,
+    "longitude": 37.0915,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 31.4,
+    "has_storage": false,
+    "distance_to_market_km": 30.0,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder beans farmer in Kajiado. 30.0 km to Kitengela; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0066",
+    "name": "Chebet Njiru",
+    "location_name": "Kajiado",
+    "latitude": -1.4004,
+    "longitude": 36.9725,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 36.4,
+    "has_storage": true,
+    "distance_to_market_km": 17.6,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder green grams farmer in Kajiado. 17.6 km to Kitengela; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0067",
+    "name": "Amina Njoroge",
+    "location_name": "Kajiado",
+    "latitude": -1.508,
+    "longitude": 37.0094,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 30.3,
+    "has_storage": false,
+    "distance_to_market_km": 29.6,
+    "nearest_market_id": "MKT-KTG",
+    "notes": "Smallholder beans farmer in Kajiado. 29.6 km to Kitengela; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0068",
+    "name": "Moraa Njiru",
+    "location_name": "Nairobi",
+    "latitude": -1.4099,
+    "longitude": 36.7144,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 28.2,
+    "has_storage": true,
+    "distance_to_market_km": 3.9,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 3.9 km to Kangemi Market; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0069",
+    "name": "Kipkoech Simiyu",
+    "location_name": "Nairobi",
+    "latitude": -1.4029,
+    "longitude": 36.7099,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 20.9,
+    "has_storage": false,
+    "distance_to_market_km": 12.5,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder dry maize farmer in Nairobi. 12.5 km to Kangemi Market; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0070",
+    "name": "Barasa Rehema",
+    "location_name": "Nairobi",
+    "latitude": -1.3423,
+    "longitude": 36.6208,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 31.2,
+    "has_storage": false,
+    "distance_to_market_km": 2.8,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder dry maize farmer in Nairobi. 2.8 km to Kangemi Market; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0071",
+    "name": "Onyango Kinyanjui",
+    "location_name": "Nairobi",
+    "latitude": -1.1836,
+    "longitude": 36.7917,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 38.2,
+    "has_storage": true,
+    "distance_to_market_km": 7.8,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder dry maize farmer in Nairobi. 7.8 km to Kangemi Market; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0072",
+    "name": "Auma Musyoka",
+    "location_name": "Nairobi",
+    "latitude": -1.3801,
+    "longitude": 36.797,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 38.2,
+    "has_storage": true,
+    "distance_to_market_km": 16.8,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 16.8 km to Kangemi Market; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0073",
+    "name": "Muthama Wekesa",
+    "location_name": "Nairobi",
+    "latitude": -1.2362,
+    "longitude": 36.8853,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 9.0,
+    "has_storage": false,
+    "distance_to_market_km": 28.9,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 28.9 km to Kangemi Market; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0074",
+    "name": "Githinji Njoroge",
+    "location_name": "Nairobi",
+    "latitude": -1.1393,
+    "longitude": 36.7689,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 18.9,
+    "has_storage": true,
+    "distance_to_market_km": 25.3,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder beans farmer in Nairobi. 25.3 km to Kangemi Market; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0075",
+    "name": "Nyaboke Mueni",
+    "location_name": "Nairobi",
+    "latitude": -1.3874,
+    "longitude": 36.8279,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 26.0,
+    "has_storage": false,
+    "distance_to_market_km": 5.1,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder Irish potato farmer in Nairobi. 5.1 km to Kangemi Market; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0076",
+    "name": "Wangari Korir",
+    "location_name": "Nairobi",
+    "latitude": -1.2582,
+    "longitude": 36.7947,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 22.7,
+    "has_storage": false,
+    "distance_to_market_km": 12.6,
+    "nearest_market_id": "MKT-KGM",
+    "notes": "Smallholder dry maize farmer in Nairobi. 12.6 km to Kangemi Market; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0077",
+    "name": "Amina Owino",
+    "location_name": "Nyeri",
+    "latitude": -0.5032,
+    "longitude": 37.092,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 29.8,
+    "has_storage": false,
+    "distance_to_market_km": 15.8,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder beans farmer in Nyeri. 15.8 km to Karatina; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0078",
+    "name": "Wafula Njiru",
+    "location_name": "Nyeri",
+    "latitude": -0.4009,
+    "longitude": 37.1228,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 25.7,
+    "has_storage": true,
+    "distance_to_market_km": 12.0,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder Irish potato farmer in Nyeri. 12.0 km to Karatina; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0079",
+    "name": "Kariuki Nzioka",
+    "location_name": "Nyeri",
+    "latitude": -0.3688,
+    "longitude": 37.0565,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 24.9,
+    "has_storage": true,
+    "distance_to_market_km": 23.7,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder beans farmer in Nyeri. 23.7 km to Karatina; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0080",
+    "name": "Fatuma Chepkoech",
+    "location_name": "Nyeri",
+    "latitude": -0.5787,
+    "longitude": 37.0469,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 16.9,
+    "has_storage": false,
+    "distance_to_market_km": 30.9,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder beans farmer in Nyeri. 30.9 km to Karatina; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0081",
+    "name": "Barasa Mwangi",
+    "location_name": "Nyeri",
+    "latitude": -0.4783,
+    "longitude": 37.0406,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 30.2,
+    "has_storage": false,
+    "distance_to_market_km": 17.6,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder dry maize farmer in Nyeri. 17.6 km to Karatina; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0082",
+    "name": "Kibet Kathambi",
+    "location_name": "Nyeri",
+    "latitude": -0.4988,
+    "longitude": 36.9885,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 12.8,
+    "has_storage": true,
+    "distance_to_market_km": 24.5,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder beans farmer in Nyeri. 24.5 km to Karatina; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0083",
+    "name": "Mutembei Cherop",
+    "location_name": "Nyeri",
+    "latitude": -0.4913,
+    "longitude": 37.1426,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 39.9,
+    "has_storage": true,
+    "distance_to_market_km": 19.7,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder beans farmer in Nyeri. 19.7 km to Karatina; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0084",
+    "name": "Korir Muthama",
+    "location_name": "Nyeri",
+    "latitude": -0.5413,
+    "longitude": 37.0525,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 11.7,
+    "has_storage": false,
+    "distance_to_market_km": 5.1,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder Irish potato farmer in Nyeri. 5.1 km to Karatina; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0085",
+    "name": "Otieno Wanjala",
+    "location_name": "Nyeri",
+    "latitude": -0.5684,
+    "longitude": 37.1286,
+    "primary_commodity": "POT-RIR",
+    "quantity_quintals": 25.6,
+    "has_storage": false,
+    "distance_to_market_km": 26.8,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder Irish potato farmer in Nyeri. 26.8 km to Karatina; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0086",
+    "name": "Maina Wanjala",
+    "location_name": "Nyeri",
+    "latitude": -0.5444,
+    "longitude": 37.0916,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 5.5,
+    "has_storage": true,
+    "distance_to_market_km": 19.2,
+    "nearest_market_id": "MKT-KRT",
+    "notes": "Smallholder beans farmer in Nyeri. 19.2 km to Karatina; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0087",
+    "name": "Muthoni Mwende",
+    "location_name": "Makueni",
+    "latitude": -1.8908,
+    "longitude": 37.5379,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 8.6,
+    "has_storage": true,
+    "distance_to_market_km": 1.4,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder beans farmer in Makueni. 1.4 km to Kathonzweni; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0088",
+    "name": "Cherop Khamis",
+    "location_name": "Makueni",
+    "latitude": -1.9978,
+    "longitude": 37.7896,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 37.9,
+    "has_storage": false,
+    "distance_to_market_km": 17.2,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder beans farmer in Makueni. 17.2 km to Kathonzweni; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0089",
+    "name": "Kipchumba Kathambi",
+    "location_name": "Makueni",
+    "latitude": -2.0778,
+    "longitude": 37.6888,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 10.3,
+    "has_storage": false,
+    "distance_to_market_km": 28.6,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder dry maize farmer in Makueni. 28.6 km to Kathonzweni; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0090",
+    "name": "Mwangi Mueni",
+    "location_name": "Makueni",
+    "latitude": -2.0645,
+    "longitude": 37.7293,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 25.9,
+    "has_storage": false,
+    "distance_to_market_km": 22.0,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder green grams farmer in Makueni. 22.0 km to Kathonzweni; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0091",
+    "name": "Nzioka Abdalla",
+    "location_name": "Makueni",
+    "latitude": -1.8274,
+    "longitude": 37.5892,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 39.7,
+    "has_storage": false,
+    "distance_to_market_km": 11.4,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder green grams farmer in Makueni. 11.4 km to Kathonzweni; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0092",
+    "name": "Kwamboka Ochieng",
+    "location_name": "Makueni",
+    "latitude": -1.8157,
+    "longitude": 37.5623,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 14.3,
+    "has_storage": true,
+    "distance_to_market_km": 3.8,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder dry maize farmer in Makueni. 3.8 km to Kathonzweni; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0093",
+    "name": "Rehema Mbugua",
+    "location_name": "Makueni",
+    "latitude": -2.053,
+    "longitude": 37.6226,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 25.8,
+    "has_storage": true,
+    "distance_to_market_km": 10.9,
+    "nearest_market_id": "MKT-KTZ",
+    "notes": "Smallholder green grams farmer in Makueni. 10.9 km to Kathonzweni; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0094",
+    "name": "Simiyu Mwenda",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.2936,
+    "longitude": 37.68,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 32.6,
+    "has_storage": false,
+    "distance_to_market_km": 22.3,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder beans farmer in Tharaka Nithi. 22.3 km to Kaanwa; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0095",
+    "name": "Owino Ali",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.2806,
+    "longitude": 37.6774,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 36.8,
+    "has_storage": true,
+    "distance_to_market_km": 29.1,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder dry maize farmer in Tharaka Nithi. 29.1 km to Kaanwa; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0096",
+    "name": "Awino Kiprop",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.1365,
+    "longitude": 37.8573,
+    "primary_commodity": "BEN-YGN",
+    "quantity_quintals": 20.4,
+    "has_storage": true,
+    "distance_to_market_km": 16.9,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder beans farmer in Tharaka Nithi. 16.9 km to Kaanwa; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0097",
+    "name": "Kipchumba Muthama",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.1649,
+    "longitude": 37.7581,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 25.9,
+    "has_storage": false,
+    "distance_to_market_km": 31.2,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder dry maize farmer in Tharaka Nithi. 31.2 km to Kaanwa; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0098",
+    "name": "Karimi Ndinda",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.3072,
+    "longitude": 37.6787,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 34.3,
+    "has_storage": false,
+    "distance_to_market_km": 20.6,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder green grams farmer in Tharaka Nithi. 20.6 km to Kaanwa; no storage; must sell at harvest."
+  },
+  {
+    "farmer_id": "FMR-K0099",
+    "name": "Wafula Maina",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.0861,
+    "longitude": 37.6626,
+    "primary_commodity": "GRG-KEN",
+    "quantity_quintals": 27.8,
+    "has_storage": true,
+    "distance_to_market_km": 32.1,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder green grams farmer in Tharaka Nithi. 32.1 km to Kaanwa; has dry storage shed."
+  },
+  {
+    "farmer_id": "FMR-K0100",
+    "name": "Mutembei Mohamed",
+    "location_name": "Tharaka Nithi",
+    "latitude": -0.1246,
+    "longitude": 37.7575,
+    "primary_commodity": "MZE-DRY",
+    "quantity_quintals": 21.5,
+    "has_storage": true,
+    "distance_to_market_km": 14.9,
+    "nearest_market_id": "MKT-KAN",
+    "notes": "Smallholder dry maize farmer in Tharaka Nithi. 14.9 km to Kaanwa; has dry storage shed."
+  }
+]

markets_kenya.json

@@ -0,0 +1,132 @@
+[
+  {
+    "mandi_id": "MKT-KIB",
+    "name": "Kibuye",
+    "district": "Kisumu",
+    "state": "Kisumu",
+    "latitude": -0.0952,
+    "longitude": 34.7523,
+    "market_type": "wholesale",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "GRG-KEN"],
+    "avg_daily_arrivals_tonnes": 340.0,
+    "enam_integrated": false,
+    "reporting_quality": "good"
+  },
+  {
+    "mandi_id": "MKT-NWK",
+    "name": "Nairobi Wakulima",
+    "district": "Nairobi",
+    "state": "Nairobi",
+    "latitude": -1.2921,
+    "longitude": 36.8270,
+    "market_type": "terminal",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "POT-RIR", "GRG-KEN"],
+    "avg_daily_arrivals_tonnes": 620.0,
+    "enam_integrated": false,
+    "reporting_quality": "good"
+  },
+  {
+    "mandi_id": "MKT-KON",
+    "name": "Kongowea",
+    "district": "Mombasa",
+    "state": "Mombasa",
+    "latitude": -4.0277,
+    "longitude": 39.6876,
+    "market_type": "terminal",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "POT-RIR", "GRG-KEN"],
+    "avg_daily_arrivals_tonnes": 480.0,
+    "enam_integrated": false,
+    "reporting_quality": "good"
+  },
+  {
+    "mandi_id": "MKT-ELD",
+    "name": "Eldoret Main",
+    "district": "Uasin Gishu",
+    "state": "Uasin Gishu",
+    "latitude": 0.5143,
+    "longitude": 35.2698,
+    "market_type": "wholesale",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "POT-RIR"],
+    "avg_daily_arrivals_tonnes": 410.0,
+    "enam_integrated": false,
+    "reporting_quality": "good"
+  },
+  {
+    "mandi_id": "MKT-NAK",
+    "name": "Nakuru Wakulima",
+    "district": "Nakuru",
+    "state": "Nakuru",
+    "latitude": -0.3031,
+    "longitude": 36.0800,
+    "market_type": "wholesale",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "POT-RIR"],
+    "avg_daily_arrivals_tonnes": 295.0,
+    "enam_integrated": false,
+    "reporting_quality": "good"
+  },
+  {
+    "mandi_id": "MKT-KTG",
+    "name": "Kitengela",
+    "district": "Kajiado",
+    "state": "Kajiado",
+    "latitude": -1.4747,
+    "longitude": 36.9587,
+    "market_type": "regulated",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "GRG-KEN"],
+    "avg_daily_arrivals_tonnes": 95.0,
+    "enam_integrated": false,
+    "reporting_quality": "poor"
+  },
+  {
+    "mandi_id": "MKT-KGM",
+    "name": "Kangemi Market",
+    "district": "Nairobi",
+    "state": "Nairobi",
+    "latitude": -1.2680,
+    "longitude": 36.7462,
+    "market_type": "wholesale",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "POT-RIR"],
+    "avg_daily_arrivals_tonnes": 175.0,
+    "enam_integrated": false,
+    "reporting_quality": "moderate"
+  },
+  {
+    "mandi_id": "MKT-KRT",
+    "name": "Karatina",
+    "district": "Nyeri",
+    "state": "Nyeri",
+    "latitude": -0.4833,
+    "longitude": 37.1333,
+    "market_type": "wholesale",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "POT-RIR"],
+    "avg_daily_arrivals_tonnes": 230.0,
+    "enam_integrated": false,
+    "reporting_quality": "good"
+  },
+  {
+    "mandi_id": "MKT-KTZ",
+    "name": "Kathonzweni",
+    "district": "Makueni",
+    "state": "Makueni",
+    "latitude": -1.9500,
+    "longitude": 37.6500,
+    "market_type": "regulated",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "GRG-KEN"],
+    "avg_daily_arrivals_tonnes": 85.0,
+    "enam_integrated": false,
+    "reporting_quality": "moderate"
+  },
+  {
+    "mandi_id": "MKT-KAN",
+    "name": "Kaanwa",
+    "district": "Tharaka Nithi",
+    "state": "Tharaka Nithi",
+    "latitude": -0.1650,
+    "longitude": 37.7600,
+    "market_type": "regulated",
+    "commodities_traded": ["MZE-DRY", "BEN-YGN", "GRG-KEN"],
+    "avg_daily_arrivals_tonnes": 70.0,
+    "enam_integrated": false,
+    "reporting_quality": "poor"
+  }
+]

src/ingestion/kamis.py

@@ -0,0 +1,578 @@
+"""
+KAMIS (Kenya Agricultural Market Information System) price client.
+
+Primary data source for Kenya wholesale/retail prices, run by the Kenya
+Ministry of Agriculture, Livestock and Fisheries. It publishes daily
+market reports across 47 counties with wholesale and retail quotes per
+commodity, variety, and market via the public search portal at
+`https://kamis.kilimo.go.ke/site/market_search`.
+
+The portal's HTTPS cert is expired/self-signed as of 2026-04 so we
+disable verification (the data is public).
+
+Shape mirrors `src.ingestion.agmarknet.fetch_mandi_prices` so the
+`pipeline.MarketIntelligencePipeline._step_ingest` helpers can plug
+this in as a sibling `PriceSource` once Phase 1.1 wires the region
+dispatch.
+
+Implementation ported from
+`lastmile-bench/lastmile_bench/benchmarks/market_intelligence/sources/kamis.py`
+(the benchmark reference) — trimmed to drop pydantic + tenacity so we
+don't take new dependencies on the production app.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import csv
+import logging
+import os
+import re
+import time
+from datetime import date, datetime, timedelta
+from pathlib import Path
+from typing import Any, Iterable, Sequence
+from urllib.parse import urlencode
+
+import httpx
+from bs4 import BeautifulSoup
+
+from src.ingestion.agmarknet import PriceRecord
+
+log = logging.getLogger(__name__)
+
+# --- KAMIS portal configuration -----------------------------------------
+
+PORTAL_BASE_URL = "https://kamis.kilimo.go.ke/site/market_search"
+
+KAMIS_ATTRIBUTION = (
+    "Kenya Ministry of Agriculture, Livestock and Fisheries, "
+    "Kenya Agricultural Market Information System (KAMIS). "
+    "Daily wholesale and retail price reports by market and county, "
+    "scraped from https://kamis.kilimo.go.ke under the Kenya Access "
+    "to Information Act 2016 transparency provisions."
+)
+
+# KAMIS product catalog. Integer IDs come from the portal's
+# `<option value="N">Name</option>` tags on the search page.
+PRODUCT_IDS: dict[str, int] = {
+    "Dry maize": 1,
+    "Red sorghum": 2,
+    "Wheat": 3,
+    "Rice": 4,
+    "Green grams": 10,
+    "Ground nuts": 12,
+    "Beans (yellow-green)": 30,
+    "Finger millet": 54,
+    "White sorghum": 56,
+    "Red irish potato": 57,
+    "Sweet potatoes": 59,
+}
+
+# Aliases so callers can pass a commodity dict whose `name` or `kamis_name`
+# lands on a canonical key in PRODUCT_IDS. Keep this small; Phase 1.1 will
+# move the canonical mapping into `commodities.json::kamis_name`.
+_COMMODITY_ALIASES: dict[str, str] = {
+    "maize": "Dry maize",
+    "dry maize": "Dry maize",
+    "beans": "Beans (yellow-green)",
+    "green grams": "Green grams",
+    "red irish potato": "Red irish potato",
+    "irish potato": "Red irish potato",
+    "potato": "Red irish potato",
+}
+
+_POLITE_DELAY_SECONDS = 3.0
+_MAX_RETRIES = 5
+_TIMEOUT_SECONDS = 45.0
+_USER_AGENT = (
+    "Mozilla/5.0 (compatible; market-intelligence/0.1; "
+    "+https://crop-pricing.jeff-levine.com) research scraper"
+)
+
+# Module-level timestamp backing the polite-delay throttle. KAMIS has no
+# published rate limit; 3s/request matches the benchmark reference and
+# avoids tripping whatever the portal's operational limits are.
+_last_request_at = 0.0
+
+
+# --- Public entry point --------------------------------------------------
+
+
+async def fetch_kamis_prices(
+    markets: Sequence[Any] | None = None,
+    commodities: Sequence[dict] | None = None,
+    days_back: int = 30,
+) -> dict[str, list[PriceRecord]]:
+    """Fetch daily KAMIS prices and return the Agmarknet PriceRecord shape.
+
+    Parameters
+    ----------
+    markets
+        Iterable of market/mandi objects. Each must expose `mandi_id`,
+        `name`, and `district` attributes (the current `config.Mandi`
+        dataclass satisfies this; a Phase 1.1 Kenya `Market` dataclass
+        will also satisfy this if it keeps the same field names, or a
+        plain dict with those keys will work via the adaptor below).
+        If None, raises — KAMIS has no implicit region default.
+    commodities
+        Iterable of commodity dicts (as loaded from commodities.json).
+        Each must have an `id` key and at least one of: `kamis_name`,
+        `name`, or an entry in `_COMMODITY_ALIASES`.
+    days_back
+        How many days of history to fetch per (market, commodity).
+
+    Returns
+    -------
+    dict[str, list[PriceRecord]]
+        Price records keyed by `mandi_id`, each record with `source="kamis"`.
+        Currency is KES, unit is "kg" (KAMIS publishes KES per kilogram);
+        downstream reconciliation / forecasting treats `modal_price_rs` as
+        a numeric local-currency-per-standard-unit quote regardless of
+        region, matching how the portable base `PriceSource` protocol
+        already documents `currency` as caller-supplied.
+
+    Demo mode
+    ---------
+    Setting ``MARKET_INTEL_DEMO_MODE`` to a truthy value routes reads
+    through a committed CSV snapshot at
+    ``data/demo_snapshots/kamis/kamis_demo_snapshot.csv`` so tests and
+    the weekly pipeline can run deterministically without hitting the
+    live portal. Missing snapshot → empty result + a warning (the
+    pipeline is designed to tolerate empty ingestion from any single
+    source).
+    """
+    if markets is None or commodities is None:
+        raise ValueError(
+            "fetch_kamis_prices requires explicit markets + commodities; "
+            "KAMIS has no implicit region default."
+        )
+
+    market_list = list(markets)
+    commodity_list = list(commodities)
+
+    demo_mode = os.environ.get("MARKET_INTEL_DEMO_MODE", "").lower() in (
+        "1", "true", "yes"
+    )
+    if demo_mode:
+        log.info(
+            "KAMIS: DEMO mode — reading snapshot for %d markets x %d commodities",
+            len(market_list), len(commodity_list),
+        )
+        return _load_demo_snapshot(market_list, commodity_list, days_back)
+
+    log.info(
+        "KAMIS: LIVE mode — fetching from %s for %d markets x %d commodities",
+        PORTAL_BASE_URL, len(market_list), len(commodity_list),
+    )
+    return await _fetch_live(market_list, commodity_list, days_back)
+
+
+# --- Live scrape path ----------------------------------------------------
+
+
+async def _fetch_live(
+    markets: list[Any],
+    commodities: list[dict],
+    days_back: int,
+) -> dict[str, list[PriceRecord]]:
+    """Hit the live portal with a 3s polite delay + retry-with-backoff.
+
+    Runs the blocking httpx call inside `asyncio.to_thread` so this
+    coroutine composes with the pipeline's asyncio.gather without us
+    having to rewrite the parser async-native.
+    """
+    end = date.today()
+    start = end - timedelta(days=days_back)
+    results: dict[str, list[PriceRecord]] = {_market_id(m): [] for m in markets}
+
+    # Suppress urllib3 InsecureRequestWarning once up front (KAMIS cert is expired).
+    import urllib3
+    urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+    for commodity in commodities:
+        product_id = _resolve_product_id(commodity)
+        if product_id is None:
+            log.warning(
+                "KAMIS: no PRODUCT_IDS mapping for commodity %s — skipping",
+                commodity.get("id") or commodity.get("name"),
+            )
+            continue
+
+        for market in markets:
+            county = _market_county(market)
+            url = build_search_url(
+                product_id=product_id,
+                county=county,
+                start=start,
+                end=end,
+            )
+            try:
+                html = await asyncio.to_thread(_fetch_html_with_retry, url)
+            except Exception as exc:
+                log.warning(
+                    "KAMIS: fetch failed for %s / %s (%s): %s",
+                    _market_id(market), commodity.get("id"), url, exc,
+                )
+                continue
+
+            raw_records = parse_search_result_html(html)
+            filtered = _filter_by_market(raw_records, market)
+            for rec in filtered:
+                results[_market_id(market)].append(
+                    _to_price_record(rec, market=market, commodity=commodity)
+                )
+
+    total = sum(len(v) for v in results.values())
+    log.info("KAMIS: fetched %d price records across %d markets", total, len(markets))
+    return results
+
+
+def _fetch_html_with_retry(url: str) -> str:
+    """Synchronous GET with 3s polite delay + exponential backoff.
+
+    KAMIS's cert is expired/self-signed → `verify=False`. We don't fall
+    back to HTTP because the portal 301-redirects HTTP→HTTPS.
+    """
+    last_exc: Exception | None = None
+    for attempt in range(_MAX_RETRIES):
+        _polite_delay()
+        try:
+            with httpx.Client(
+                follow_redirects=True,
+                timeout=_TIMEOUT_SECONDS,
+                headers={"User-Agent": _USER_AGENT, "Accept": "text/html"},
+                verify=False,
+            ) as client:
+                resp = client.get(url)
+            resp.raise_for_status()
+            return resp.text
+        except (httpx.HTTPError, httpx.TimeoutException) as exc:
+            last_exc = exc
+            backoff = min(30.0, 2.0 * (2 ** attempt))
+            log.debug(
+                "KAMIS: fetch attempt %d/%d failed (%s); retrying in %.1fs",
+                attempt + 1, _MAX_RETRIES, exc, backoff,
+            )
+            time.sleep(backoff)
+    assert last_exc is not None
+    raise last_exc
+
+
+def _polite_delay() -> None:
+    """Block until `_POLITE_DELAY_SECONDS` have elapsed since the last call."""
+    global _last_request_at
+    now = time.monotonic()
+    elapsed = now - _last_request_at
+    if elapsed < _POLITE_DELAY_SECONDS:
+        time.sleep(_POLITE_DELAY_SECONDS - elapsed)
+    _last_request_at = time.monotonic()
+
+
+# --- URL + HTML parsing (ported from the benchmark reference) -----------
+
+
+def build_search_url(
+    *,
+    product_id: int,
+    county: str | None = None,
+    start: date,
+    end: date,
+    per_page: int = 2000,
+) -> str:
+    """Build a KAMIS market_search URL with ISO-format dates.
+
+    The localized date form in the UI fails silently. `county` is
+    optional; if None, the query spans all counties.
+    """
+    params: list[tuple[str, str]] = [
+        ("product[]", str(product_id)),
+        ("start", start.isoformat()),
+        ("end", end.isoformat()),
+        ("per_page", str(per_page)),
+    ]
+    if county is not None:
+        params.insert(0, ("county[]", county))
+    return f"{PORTAL_BASE_URL}?{urlencode(params)}"
+
+
+_DATE_FORMATS = ("%Y-%m-%d", "%d-%b-%Y", "%d/%m/%Y")
+_PRICE_RE = re.compile(r"([0-9][0-9,]*(?:\.[0-9]+)?)")
+
+
+def _parse_price(raw: str) -> float | None:
+    cleaned = (raw or "").strip().replace(",", "")
+    if not cleaned or cleaned in {"-", "--"}:
+        return None
+    m = _PRICE_RE.search(cleaned)
+    if not m:
+        return None
+    try:
+        return float(m.group(1))
+    except ValueError:
+        return None
+
+
+def _parse_date(raw: str) -> date | None:
+    cleaned = re.sub(r"\s+", " ", raw or "").strip()
+    for fmt in _DATE_FORMATS:
+        try:
+            return datetime.strptime(cleaned, fmt).date()
+        except ValueError:
+            continue
+    return None
+
+
+def parse_search_result_html(html: str) -> list[dict[str, Any]]:
+    """Parse a KAMIS /site/market_search response into raw row dicts.
+
+    Returns dicts (not a typed record) so the caller can map into the
+    app's existing `PriceRecord` dataclass. Each dict has keys:
+        market, product, variety, wholesale, retail, volume, county,
+        price_date.
+    Rows missing both prices or with an unparseable date are dropped.
+    """
+    soup = BeautifulSoup(html, "html.parser")
+    tbody = soup.find("tbody")
+    if tbody is None:
+        return []
+    out: list[dict[str, Any]] = []
+    for tr in tbody.find_all("tr", recursive=False):
+        cells = [td.get_text(strip=True) for td in tr.find_all("td")]
+        if len(cells) != 10:
+            continue
+        wholesale = _parse_price(cells[5])
+        retail = _parse_price(cells[6])
+        price_date = _parse_date(cells[9])
+        if price_date is None:
+            continue
+        if wholesale is None and retail is None:
+            continue
+        wholesale = wholesale if wholesale is not None else retail
+        retail = retail if retail is not None else wholesale
+        out.append({
+            "market": cells[0],
+            "product": cells[1],
+            "variety": cells[2],
+            "wholesale": wholesale,
+            "retail": retail,
+            "volume": cells[7],
+            "county": cells[8],
+            "price_date": price_date,
+        })
+    return out
+
+
+# --- Demo-mode snapshot reader ------------------------------------------
+
+
+def _demo_snapshot_path() -> Path:
+    """Resolve the committed KAMIS snapshot relative to the project root."""
+    # src/ingestion/kamis.py → project root is parents[2]
+    return (
+        Path(__file__).resolve().parents[2]
+        / "data" / "demo_snapshots" / "kamis" / "kamis_demo_snapshot.csv"
+    )
+
+
+def _load_demo_snapshot(
+    markets: list[Any],
+    commodities: list[dict],
+    days_back: int,
+) -> dict[str, list[PriceRecord]]:
+    """Read the committed CSV snapshot and filter to requested markets × commodities.
+
+    The snapshot has the same 10-column shape as
+    `records_to_csv_rows` in the benchmark — this lets us reuse
+    lastmile-bench raw_cache exports unchanged.
+    """
+    path = _demo_snapshot_path()
+    results: dict[str, list[PriceRecord]] = {_market_id(m): [] for m in markets}
+    if not path.exists():
+        log.warning("KAMIS demo: snapshot missing at %s — returning empty", path)
+        return results
+
+    commodity_lookup = _build_commodity_lookup(commodities)
+    if not commodity_lookup:
+        log.warning("KAMIS demo: no commodity name mappings — returning empty")
+        return results
+
+    # Build a market lookup keyed by normalized market name so we can
+    # match against the "Market" CSV column. Duck-typed — works for
+    # `config.Mandi` and for any Phase 1.1 Kenya market object that
+    # exposes `name`.
+    market_by_name: dict[str, Any] = {
+        _norm(getattr(m, "name", "")): m for m in markets
+    }
+
+    with open(path, newline="", encoding="utf-8") as fh:
+        reader = csv.DictReader(fh)
+        for row in reader:
+            market_obj = market_by_name.get(_norm(row.get("Market", "")))
+            if market_obj is None:
+                continue
+            commodity = commodity_lookup.get(_norm(row.get("Commodity", "")))
+            if commodity is None:
+                continue
+            price_date = _parse_date(row.get("Price Date", ""))
+            if price_date is None:
+                continue
+            modal = _safe_float(row.get("Modal Price"))
+            if modal is None or modal <= 0:
+                continue
+            min_price = _safe_float(row.get("Min Price")) or modal
+            max_price = _safe_float(row.get("Max Price")) or modal
+            arrivals = _safe_float(row.get("Arrivals (Tonnes)")) or 0.0
+            results[_market_id(market_obj)].append(PriceRecord(
+                mandi_id=_market_id(market_obj),
+                commodity_id=commodity["id"],
+                date=price_date.strftime("%Y-%m-%d"),
+                min_price_rs=min_price,
+                max_price_rs=max_price,
+                modal_price_rs=modal,
+                arrivals_tonnes=arrivals,
+                source="kamis",
+                freshness_hours=24.0,
+                quality_flag="good",
+            ))
+
+    total = sum(len(v) for v in results.values())
+    log.info("KAMIS demo: loaded %d records across %d markets from %s",
+             total, len(markets), path.name)
+    return results
+
+
+# --- Helpers -------------------------------------------------------------
+
+
+def _resolve_product_id(commodity: dict) -> int | None:
+    """Map a commodity dict to a KAMIS product_id.
+
+    Tries `commodity["kamis_name"]`, `commodity["name"]`,
+    `commodity["id"]`, then the alias table. Returns None if nothing
+    matches — the caller logs and skips.
+    """
+    for key in ("kamis_name", "name", "id"):
+        raw = commodity.get(key)
+        if not raw:
+            continue
+        if raw in PRODUCT_IDS:
+            return PRODUCT_IDS[raw]
+        canonical = _COMMODITY_ALIASES.get(_norm(raw))
+        if canonical and canonical in PRODUCT_IDS:
+            return PRODUCT_IDS[canonical]
+    return None
+
+
+def _build_commodity_lookup(commodities: list[dict]) -> dict[str, dict]:
+    """Map normalized commodity names back to the commodity dict.
+
+    Used by the demo reader to assign `commodity_id` to each CSV row.
+    """
+    out: dict[str, dict] = {}
+    for c in commodities:
+        for key in ("kamis_name", "name", "id"):
+            val = c.get(key)
+            if val:
+                out[_norm(val)] = c
+        # also register the aliased canonical name
+        for key in ("kamis_name", "name", "id"):
+            val = c.get(key)
+            canonical = _COMMODITY_ALIASES.get(_norm(val or ""))
+            if canonical:
+                out[_norm(canonical)] = c
+    return out
+
+
+def _filter_by_market(
+    rows: list[dict[str, Any]], market: Any
+) -> list[dict[str, Any]]:
+    """Keep only the rows whose "market" cell matches the passed market.
+
+    KAMIS county queries return all markets in the county — we filter
+    client-side to honor the caller's `markets=` argument.
+    """
+    target = _norm(getattr(market, "name", ""))
+    if not target:
+        return rows
+    return [r for r in rows if _norm(r.get("market", "")) == target]
+
+
+def _to_price_record(
+    raw: dict[str, Any], *, market: Any, commodity: dict
+) -> PriceRecord:
+    """Convert a parsed KAMIS row into the app's Agmarknet-shaped PriceRecord.
+
+    We emit the **retail** price as `modal_price_rs` (KAMIS doesn't
+    publish a modal; retail is the consumer-facing quote that a farmer
+    would compare a selling offer against), wholesale as `min_price_rs`,
+    and retail as `max_price_rs`. `arrivals_tonnes` stays 0 because
+    KAMIS's "volume" field is an unconfirmed unit.
+    """
+    wholesale = float(raw["wholesale"])
+    retail = float(raw["retail"])
+    return PriceRecord(
+        mandi_id=_market_id(market),
+        commodity_id=commodity["id"],
+        date=raw["price_date"].strftime("%Y-%m-%d"),
+        min_price_rs=wholesale,
+        max_price_rs=retail,
+        modal_price_rs=retail,
+        arrivals_tonnes=0.0,
+        source="kamis",
+        freshness_hours=24.0,
+        quality_flag="good",
+    )
+
+
+def _market_id(market: Any) -> str:
+    """Return the market's ID, tolerating both `mandi_id` and `market_id`."""
+    for attr in ("mandi_id", "market_id", "id"):
+        val = getattr(market, attr, None)
+        if val:
+            return str(val)
+    if isinstance(market, dict):
+        for k in ("mandi_id", "market_id", "id"):
+            if market.get(k):
+                return str(market[k])
+    raise ValueError(f"Market has no mandi_id / market_id / id: {market!r}")
+
+
+def _market_county(market: Any) -> str | None:
+    """Best-effort extraction of a KAMIS-compatible county string.
+
+    Tries `county`, then `district`, then `state`. Returns None if
+    nothing is set so the URL builder queries all counties.
+    """
+    for attr in ("county", "district", "state"):
+        val = getattr(market, attr, None)
+        if val:
+            return str(val)
+    if isinstance(market, dict):
+        for k in ("county", "district", "state"):
+            if market.get(k):
+                return str(market[k])
+    return None
+
+
+def _norm(s: str) -> str:
+    return re.sub(r"\s+", " ", (s or "").strip().lower())
+
+
+def _safe_float(v: Any) -> float | None:
+    if v is None or v == "":
+        return None
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        return None
+
+
+__all__ = [
+    "PORTAL_BASE_URL",
+    "KAMIS_ATTRIBUTION",
+    "PRODUCT_IDS",
+    "fetch_kamis_prices",
+    "build_search_url",
+    "parse_search_result_html",
+]

src/pipeline.py

@@ -22,6 +22,7 @@ from config import (
     MANDIS,
     MANDI_MAP,
     PIPELINE_STEPS,
+    REGION,
     SAMPLE_FARMERS,
     FEATURED_FARMERS,
     SEASONAL_INDICES,
@@ -29,6 +30,7 @@ from config import (
 )
 from src.ingestion.agmarknet import fetch_mandi_prices, PriceRecord
 from src.ingestion.enam_scraper import fetch_enam_prices
+from src.ingestion.kamis import fetch_kamis_prices
 from src.ingestion.nasa_power import fetch_all_mandis_nasa_power, DailyReading
 from src.extraction.agent import ExtractionAgent, RuleBasedExtractor
 from src.reconciliation.agent import ReconciliationAgent, RuleBasedReconciler
@@ -226,6 +228,15 @@ class MarketIntelligencePipeline:
 
         try:
             async def _ingest_agmarknet():
+                # Under Kenya, the primary wholesale source is KAMIS (no eNAM).
+                if REGION == "kenya":
+                    try:
+                        self._agmarknet_prices = await fetch_kamis_prices(
+                            MANDIS, COMMODITIES, days_back=self.days_back,
+                        )
+                    except Exception as e:
+                        errors.append(f"KAMIS fetch failed: {e}")
+                    return
                 try:
                     self._agmarknet_prices = await fetch_mandi_prices(
                         MANDIS, COMMODITIES, days_back=self.days_back,
@@ -234,6 +245,9 @@ class MarketIntelligencePipeline:
                     errors.append(f"Agmarknet fetch failed: {e}")
 
             async def _ingest_enam():
+                if REGION == "kenya":
+                    self._enam_prices = {m.mandi_id: [] for m in MANDIS}
+                    return
                 try:
                     self._enam_prices = await fetch_enam_prices(
                         MANDIS, COMMODITIES, days_back=min(14, self.days_back),

src/rag/knowledge_base_kenya.py

@@ -0,0 +1,339 @@
+"""
+Kenya agricultural marketing knowledge base for RAG retrieval.
+
+~25 knowledge chunks covering bimodal crop calendars, NCPB/KAMIS/county
+institutions, post-harvest handling (aflatoxin, PICS, metal silos),
+transport (A-roads vs feeder roads, Mombasa corridor), storage
+(NCPB depots, CACs, warehouse receipts), and shocks (2022 Horn of
+Africa drought, 2023-24 El Nino floods, IPC classifications).
+
+Used by the recommendation agent when REGION=kenya. Sibling to
+knowledge_base.py (Tamil Nadu / India). Schema matches the India
+module exactly: KnowledgeChunk dataclass with id/title/source/category/text.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class KnowledgeChunk:
+    id: str
+    title: str
+    source: str
+    category: str
+    text: str
+
+
+KNOWLEDGE_CHUNKS: list[KnowledgeChunk] = [
+
+    # -- Crop Calendars -------------------------------------------------
+
+    KnowledgeChunk(
+        "CC-001", "Maize Long Rains Calendar - Rift Valley and Western Kenya",
+        "MoALF Kenya Crop Production Guidelines 2023; FEWS NET Kenya Seasonal Monitor",
+        "crop_calendar",
+        "The Long Rains are Kenya's primary cropping season and produce roughly 70-80% of the national maize crop. "
+        "Land preparation begins Feb-Mar, planting Mar-May as rains establish, vegetative growth Apr-Jun, "
+        "and harvest Jul-Sep in most zones. Main producing counties: Trans-Nzoia, Uasin Gishu, Nakuru, Narok, "
+        "Bungoma, Kakamega, Nyandarua. Rift Valley high-altitude zones (Trans-Nzoia, Uasin Gishu) harvest "
+        "latest (Sep-Nov) because of longer maturation at altitude. Wholesale maize price troughs typically "
+        "arrive Aug-Oct when Western and Rift Valley grain floods Nairobi, Kisumu, Eldoret, and Nakuru markets."
+    ),
+    KnowledgeChunk(
+        "CC-002", "Maize Short Rains Calendar - Eastern and Coastal Kenya",
+        "MoALF Kenya Crop Production Guidelines 2023; KALRO Maize Agronomy Manual",
+        "crop_calendar",
+        "The Short Rains (Oct-Dec) are the secondary season and dominate Eastern, lower Central, and Coastal "
+        "Kenya, where a single unimodal rainy season is unreliable. Planting Oct-Nov, harvest Jan-Feb. "
+        "Key counties: Machakos, Makueni, Kitui, Embu, Tharaka-Nithi, Kilifi, Kwale. Short Rains maize is "
+        "far more vulnerable to dry spells -- the 2022 consecutive failure of five rainy seasons devastated "
+        "this region. Short Rains harvest pushes a secondary price trough in Feb-Mar in Machakos, Mwingi, "
+        "and Wote markets, though volumes are a fraction of the Long Rains crop."
+    ),
+    KnowledgeChunk(
+        "CC-003", "Maize Moisture and Safe-Storage Thresholds",
+        "KALRO Post-Harvest Handbook; FAO Kenya Aflatoxin Mitigation Guide",
+        "crop_calendar",
+        "Maize at harvest is typically 18-25% moisture and must be dried to 13.5% or below before storage. "
+        "Above 13.5% moisture, Aspergillus flavus growth accelerates and aflatoxin contamination risk rises "
+        "sharply; above 18% grain may rot within weeks. Sun-drying on raised tarpaulins or drying cribs over "
+        "5-10 days is standard for smallholders; avoid drying on bare ground (soil contamination and re-wetting). "
+        "NCPB rejects deliveries above 13.5% moisture. Traders discount roughly KES 100-200 per 90kg bag for "
+        "each percentage point above 13.5%, and a heavily aflatoxin-positive lot may be unsellable entirely."
+    ),
+    KnowledgeChunk(
+        "CC-004", "Bean Crop Calendar - Bimodal Smallholder Staple",
+        "KALRO Legumes Research Programme; MoALF Pulses Strategy 2020-2025",
+        "crop_calendar",
+        "Beans (Rosecoco, Mwitemania, Mwezi Moja, Wairimu) are grown in both rainy seasons on 75-90 day cycles, "
+        "shorter than maize, and are frequently intercropped with maize. Long Rains: plant Mar-Apr, harvest "
+        "Jun-Jul. Short Rains: plant Oct-Nov, harvest Jan-Feb. Main counties: Nakuru, Narok, Bomet, Kirinyaga, "
+        "Meru, Embu, Machakos. Beans are drought-sensitive at flowering (days 35-45); mid-season dry spells "
+        "routinely cut yields 30-50%. Post-harvest beans must be dried to <13% moisture; bruchid weevils are "
+        "the primary storage pest and destroy improperly-stored lots within 2-3 months."
+    ),
+    KnowledgeChunk(
+        "CC-005", "Irish Potato Calendar - Nyandarua, Meru, and Nakuru",
+        "National Potato Council of Kenya; KALRO Tigoni",
+        "crop_calendar",
+        "Irish potato (Shangi, Dutch Robijn, Asante) is grown at 1,800-3,000m altitude on a 3-4 month cycle "
+        "tied to the rains. Long Rains planting Mar-Apr, harvest Jun-Aug. Short Rains planting Oct-Nov, "
+        "harvest Feb-Mar. Production is concentrated in Nyandarua (~40% of national output), Meru, Elgeyo "
+        "Marakwet, Nakuru, Bomet, and Bungoma. Shangi dominates (~80% of market) because it ripens quickly "
+        "and handles transport, but it has very short dormancy (2-3 weeks) -- farmers cannot hold crop, "
+        "which drives distress selling at harvest and extreme price swings. Nyandarua farm-gate prices have "
+        "swung from KES 800 to KES 3,500 per 110kg bag within a single season."
+    ),
+
+    # -- Market Institutions --------------------------------------------
+
+    KnowledgeChunk(
+        "MI-001", "NCPB - National Cereals and Produce Board",
+        "NCPB Annual Reports; MoALF Strategic Food Reserve Policy",
+        "market_institution",
+        "NCPB is Kenya's parastatal grain buyer of last resort and operator of the Strategic Food Reserve. "
+        "When activated by the Cabinet Secretary, NCPB offers a Guaranteed Minimum Return Price (GMRP) for "
+        "maize -- recent GMRP levels have ranged KES 3,000-5,200 per 90kg bag, well above distress-sale "
+        "farm-gate levels in surplus seasons. NCPB operates ~110 depots nationwide with concentration in "
+        "Rift Valley and Western counties. Payment delays of 30-90 days are common; smallholders need "
+        "registration, ID, and land documentation. Intake quality standards: <13.5% moisture, <3% foreign "
+        "matter, aflatoxin within codex limits. When GMRP is not activated, NCPB buys at market rates or not at all."
+    ),
+    KnowledgeChunk(
+        "MI-002", "KAMIS - Kenya Agricultural Market Information System",
+        "KAMIS Portal; MoALF Market Information Unit",
+        "market_institution",
+        "KAMIS is the MoALF-run market information service (kamis.kilimo.go.ke) that publishes daily, weekly, "
+        "and monthly wholesale prices for 40+ commodities across 60+ markets nationwide. Coverage is strongest "
+        "for Nairobi (Wakulima, Kangemi, Gikomba), Mombasa (Kongowea), Eldoret, Kisumu (Kibuye), and Nakuru. "
+        "Daily prices reflect wholesale trades and typically sit 15-40% above farm-gate. KAMIS is the canonical "
+        "source for price reconciliation and for retrospective benchmark panels. Gaps: farm-gate prices are "
+        "not systematically collected, and rural market coverage thins outside the main trunk corridors."
+    ),
+    KnowledgeChunk(
+        "MI-003", "County Governments Post-2013 Devolution",
+        "Constitution of Kenya 2010, Fourth Schedule; Kenya Devolution Working Paper (World Bank 2020)",
+        "market_institution",
+        "Agriculture is a devolved function under Kenya's 2010 Constitution -- each of the 47 counties runs "
+        "its own Department of Agriculture with budgets for extension, input subsidies (often fertilizer and "
+        "certified seed), market infrastructure, and cooperative support. Practical consequences for farmers: "
+        "input subsidy program eligibility, cooperative registration, and county market fees all vary by county. "
+        "Meru and Nyandarua run active potato-sector programs; Kakamega and Bungoma run maize-and-dairy extension; "
+        "ASAL counties (Kitui, Makueni, Turkana) focus on drought-tolerant sorghum and millet. National-level "
+        "MoALF still sets price-support policy (NCPB, GMRP) and runs KAMIS."
+    ),
+    KnowledgeChunk(
+        "MI-004", "SACCOs and Cooperatives for Rural Finance and Aggregation",
+        "SASRA Annual Supervision Report; Co-operative Bank of Kenya Agri-SACCO Study",
+        "market_institution",
+        "SACCOs (Savings and Credit Cooperatives) are the backbone of Kenyan rural finance. Regulated by "
+        "SASRA, farmer SACCOs pool member savings, provide input credit (fertilizer, seed on 3-6 month terms), "
+        "and aggregate produce for bulk sale. Agricultural SACCOs are strongest in coffee (Mt. Kenya), dairy "
+        "(Rift Valley), and tea (Kericho, Nandi) zones; maize and bean cooperatives are weaker but growing. "
+        "Typical benefits of SACCO membership: input credit at 12-15% annual (vs. 25%+ from informal lenders), "
+        "shared transport to terminal markets, and access to NCPB delivery letters. Dormant and weak-governance "
+        "cooperatives are common -- farmers should verify SASRA registration before committing savings."
+    ),
+
+    # -- Post-Harvest Handling -----------------------------------------
+
+    KnowledgeChunk(
+        "PH-001", "Aflatoxin Risk in Kenya - Regions and History",
+        "Kenya Ministry of Health Aflatoxin Surveillance; Lewis et al. 2005 (2004 Machakos Outbreak)",
+        "post_harvest",
+        "Aflatoxin contamination is Kenya's most severe post-harvest food-safety risk, caused by Aspergillus "
+        "flavus on improperly-dried maize. The 2004 outbreak centered on Makueni and Machakos killed 125+ "
+        "people from acute aflatoxicosis -- still among the largest aflatoxin mortality events ever recorded. "
+        "High-risk zones: Eastern Kenya lower midlands (Machakos, Makueni, Kitui, Embu, Tharaka-Nithi) where "
+        "Short Rains harvests coincide with lingering humidity, and coastal Kenya (Kilifi, Kwale, Taita-Taveta) "
+        "year-round. Rift Valley Long Rains crops are lower-risk because harvest falls in the drier Jul-Sep "
+        "window. Aflasafe KE01 biocontrol is available through KALRO and reduces field contamination 80-90% "
+        "when applied 2-3 weeks before flowering."
+    ),
+    KnowledgeChunk(
+        "PH-002", "PICS Bags - Hermetic Triple-Layer Storage",
+        "Purdue Improved Crop Storage (PICS) Project; KENAFF Distribution Records",
+        "post_harvest",
+        "PICS (Purdue Improved Crop Storage) bags are triple-layer hermetic storage sacks -- two polyethylene "
+        "liners inside a woven polypropylene outer bag -- that suffocate storage pests (maize weevil, larger "
+        "grain borer, bruchid) within 10-14 days of sealing, without any chemicals. A 90kg PICS bag costs "
+        "KES 250-400 in Kenyan agrovet shops (2024-2025), reusable 2-3 seasons. Storage loss drops from "
+        "20-30% over 6 months (open-weave gunny bags + actellic dusting) to under 2% with PICS. Distribution "
+        "in Kenya runs through KENAFF (Kenya National Farmers' Federation), KALRO, and private agrovet chains "
+        "(Farmers Choice, Pwani, Amiran). Adoption is highest in Western Kenya and Rift Valley."
+    ),
+    KnowledgeChunk(
+        "PH-003", "Metal Silo Program - CIMMYT, KALRO, EGSP",
+        "CIMMYT Effective Grain Storage Project (EGSP) 2008-2016; KALRO Post-Harvest Unit",
+        "post_harvest",
+        "Metal silos (galvanized sheet steel, 180-3,000kg capacity) are the premium on-farm storage option, "
+        "disseminated in Kenya through the CIMMYT-led Effective Grain Storage Project with KALRO and the "
+        "Ministry of Agriculture (2008-2016). A 900kg silo costs KES 18,000-30,000 through trained artisans "
+        "in Nakuru, Bungoma, and Embu. Storage losses drop to near zero over 12+ months. Economics work for "
+        "farmers with >10 bags to store who want to capture the Oct-trough to Mar-peak maize price cycle "
+        "(15-25% seasonal spread). Adoption remains limited by upfront cost; SACCOs and county agriculture "
+        "departments occasionally subsidize silos for smallholder cooperatives."
+    ),
+    KnowledgeChunk(
+        "PH-004", "WFP and FAO Post-Harvest Programs (P4P and Successors)",
+        "WFP Kenya Country Strategic Plan; FAO Kenya Resilience Programme",
+        "post_harvest",
+        "WFP's Purchase for Progress (P4P, 2008-2014) demonstrated smallholder aggregation into WFP's Kenya "
+        "food-aid supply chain, sourcing maize and pulses from producer organizations at prices above farm-gate "
+        "in exchange for quality and volume commitments. P4P successors under WFP Country Strategic Plans "
+        "continue smallholder sourcing in Bungoma, Busia, Makueni, Kitui, and Trans-Nzoia. FAO's Kenya "
+        "Resilience and Food Systems programmes fund post-harvest training, hermetic storage subsidies, and "
+        "aflatoxin testing equipment at county level. Participating farmer groups typically see 20-30% price "
+        "uplift on the sold portion plus training in quality grading and moisture testing."
+    ),
+
+    # -- Transport ------------------------------------------------------
+
+    KnowledgeChunk(
+        "TR-001", "Kenya Road Network - Classes A, B, C and Corridor Geography",
+        "Kenya National Highways Authority (KeNHA); Kenya Rural Roads Authority (KeRRA)",
+        "transport",
+        "Kenya's classified road network has roughly 161,000 km, of which only ~14,000 km is paved. "
+        "Class A roads are international trunk corridors (A1 Malaba-Kisumu-Kisii-Isebania west corridor and "
+        "A109 Nairobi-Mombasa, the Northern Corridor). Class B are national trunks linking regions. "
+        "Class C are primary feeder roads. Classes D and E are rural feeders, almost entirely unpaved and "
+        "often impassable in heavy rain. Almost all maize moves on paved A/B roads once aggregated, but the "
+        "first 5-50 km from farm to market centre is on D/E feeders -- this is where weather disruption, "
+        "broken bridges, and seasonal impassability hit smallholders hardest."
+    ),
+    KnowledgeChunk(
+        "TR-002", "Transport Cost Deltas - Paved vs Unpaved",
+        "Kenya Transport Sector Study (World Bank 2022); KENHA Haulage Cost Schedules",
+        "transport",
+        "Typical truckage costs (2024) for maize and produce: Paved trunk road (A/B), 30-tonne truck: "
+        "KES 7-12 per tonne-km. Gravel/unpaved feeder road: KES 15-25 per tonne-km, sometimes higher in wet "
+        "season because of reduced load factors and longer transit time. Small-vehicle rates: pickup (1-2t) "
+        "KES 25-40 per tonne-km; matatu-sized 7t lorries KES 15-20 per tonne-km. Farmers selling 5-20 bags "
+        "typically cannot fill a full truck and pay a premium for shared or piecemeal transport. Concrete "
+        "example: Trans-Nzoia to Nairobi (~380 km paved trunk) runs ~KES 180-220 per 90kg bag on a full lorry; "
+        "the final 15 km from farm to Kitale collection point can cost another KES 40-80 per bag."
+    ),
+    KnowledgeChunk(
+        "TR-003", "Aggregators, Brokers, and Farmer Transport Options",
+        "Tegemeo Institute Smallholder Market Access Study 2021",
+        "transport",
+        "Most Kenyan smallholders sell to itinerant middlemen (brokers, 'madalali') who bring lorries or "
+        "pickups to the farm gate or village market. Broker margins are typically 10-25% above farm-gate to "
+        "wholesale-market prices, reflecting risk, financing, and transport. Alternatives for farmers: "
+        "deliver to a county NCPB depot (requires registration and the depot being open for GMRP intake), "
+        "aggregate through a SACCO or cooperative for shared truckage, or use a matatu/boda-boda for very "
+        "small volumes to the nearest market centre. The smaller the volume, the weaker the farmer's "
+        "bargaining position -- sub-10-bag smallholders routinely accept 20-35% below the KAMIS wholesale "
+        "price reported for the nearest town."
+    ),
+    KnowledgeChunk(
+        "TR-004", "Mombasa Port Bottlenecks and Seasonal Congestion",
+        "Kenya Ports Authority Performance Reports; Shippers Council of Eastern Africa",
+        "transport",
+        "The Nairobi-Mombasa A109 corridor is Kenya's transport spine. Mombasa Port handles imports for the "
+        "entire Northern Corridor (including landlocked Uganda, Rwanda, South Sudan, eastern DRC), which "
+        "competes with outbound agricultural freight for the same truck fleet. Peak congestion windows: "
+        "Nov-Jan (holiday consumer imports) and Mar-May (fertilizer and agro-input imports before Long Rains) "
+        "push per-tonne-km haulage rates up 15-30%. The 2023-24 El Nino floods cut the A109 at multiple "
+        "points (including the long-running Mtito Andei washout) and diverted freight for weeks. SGR "
+        "(Standard Gauge Railway) handles containerized freight but has limited relevance for bulk "
+        "agricultural produce moving on short domestic hops."
+    ),
+    KnowledgeChunk(
+        "TR-005", "County Road Quality - Nyandarua Potato Case",
+        "Nyandarua County Integrated Development Plan; National Potato Council of Kenya",
+        "transport",
+        "Road quality varies dramatically by county and is a first-order determinant of farm-gate price. "
+        "Nyandarua -- Kenya's largest potato producer -- is notorious for poor feeder roads connecting "
+        "Kinangop, Ol Kalou, and Ndaragwa to the tarmac network. In the Mar-May Long Rains, Nyandarua feeder "
+        "roads become impassable for days at a time, trapping potato harvests at the farm and forcing distress "
+        "sales to brokers who own 4WD trucks at steep discounts. By contrast, Meru and Nakuru potato zones "
+        "have better C-class road coverage and farm-gate to wholesale price spreads are 15-20 percentage "
+        "points narrower. Farmers and aggregators in rain-affected counties should plan sales windows around "
+        "forecast dry spells."
+    ),
+
+    # -- Storage --------------------------------------------------------
+
+    KnowledgeChunk(
+        "ST-001", "NCPB Depot Storage - Access, Fees, Capacity",
+        "NCPB Operations Manual; Kenya Grain Council Storage Directory",
+        "storage",
+        "NCPB operates ~110 depots with combined storage capacity around 2.0 million bags (180,000 MT) of "
+        "grain. Beyond buyer-of-last-resort procurement, NCPB also rents storage to traders and farmer "
+        "groups at KES 8-15 per 90kg bag per month (varies by depot and season). Access for smallholders "
+        "is mediated by registration requirements (national ID, KRA PIN, cooperative or group membership). "
+        "Major depots: Eldoret, Kitale, Bungoma, Nakuru, Meru, Nairobi Industrial Area. Smallholder "
+        "deposits have to meet intake quality standards (<13.5% moisture, clean). Warehouse-receipt-backed "
+        "lending against NCPB stock exists but is limited in practice."
+    ),
+    KnowledgeChunk(
+        "ST-002", "Community Aggregation Centres (CACs)",
+        "AGRA Kenya Smallholder Aggregation Review; MoALF Cooperative Sub-Sector Report",
+        "storage",
+        "Community Aggregation Centres are smallholder-focused collection and short-term storage facilities, "
+        "typically county-government-built or AGRA/NGO-funded structures of 50-500 MT capacity. CACs allow "
+        "farmers to pool grain, share drying floors and moisture meters, and negotiate as a unit with traders "
+        "or with NCPB. Strongest CAC networks are in Bungoma, Busia, Trans-Nzoia, and Meru. Storage fees are "
+        "nominal (KES 5-10 per bag per month) but capacity is limited and governance is uneven -- some CACs "
+        "are effectively dormant. CAC membership typically provides the bridge smallholders need to access "
+        "the warehouse receipt system or direct NCPB delivery."
+    ),
+    KnowledgeChunk(
+        "ST-003", "Warehouse Receipt System - KACE and WRC",
+        "Kenya Agricultural Commodity Exchange (KACE); Warehouse Receipt System Council Act 2019",
+        "storage",
+        "Kenya's Warehouse Receipt System, formalized under the Warehouse Receipt System Council Act 2019, "
+        "remains nascent relative to more mature counterparts (e.g., Zambia, Uganda). KACE (Kenya Agricultural "
+        "Commodity Exchange) pioneered receipt-based trading and price-discovery bulletin services, and a "
+        "small network of licensed warehouses issues negotiable receipts usable as loan collateral. Typical "
+        "all-in cost (storage + fumigation + receipt fees): KES 40-80 per 90kg bag per month. Pledge-loan "
+        "advance against receipt: 50-70% of market value at 12-15% annual. System is most functional for "
+        "maize in Rift Valley warehouses; coverage for pulses, sorghum, and perishables is thin."
+    ),
+
+    # -- Shocks ---------------------------------------------------------
+
+    KnowledgeChunk(
+        "SH-001", "2020-2023 Horn of Africa Drought - Five Failed Rainy Seasons",
+        "FEWS NET Horn of Africa Special Report 2023; WFP VAM Kenya Drought Impact Assessment",
+        "shock",
+        "The 2020-2023 Horn of Africa drought was the longest and most severe drought in the region since "
+        "at least 1981, defined by five consecutive below-average rainy seasons (2020 Short Rains through "
+        "2022 Short Rains). In Kenya the ASAL counties -- Turkana, Marsabit, Mandera, Wajir, Garissa, "
+        "Isiolo, Samburu, Tana River, Kitui, Makueni -- bore the brunt, with ~4.4 million people food-"
+        "insecure at the 2022 peak. Maize wholesale prices in affected northern and eastern markets "
+        "(Garissa, Wajir, Mandera, Kitui, Marsabit) spiked 60-100% above five-year averages. Short Rains "
+        "2023 brought partial recovery but the humanitarian caseload remained elevated into 2024. The "
+        "drought is the signature shock in the first half of the LastMileBench Kenya benchmark window."
+    ),
+    KnowledgeChunk(
+        "SH-002", "2023-24 El Nino Floods - October Onwards",
+        "Kenya Red Cross Situation Reports 2023-24; World Weather Attribution El Nino Kenya Analysis",
+        "shock",
+        "The Short Rains 2023 season (Oct-Dec) delivered an El Nino-driven above-average rainfall that "
+        "tipped into widespread flooding from late October 2023 through April 2024. Impacts: Tana River "
+        "overflow and dam spillover (Garsen, Tana Delta), landslide-driven road closures in Rift Valley "
+        "(Elgeyo Marakwet, West Pokot), inundated maize-harvest areas in lower Eastern Kenya just as Short "
+        "Rains crops were being brought in, and multiple cuts to the A109 Nairobi-Mombasa highway. More "
+        "than 300 deaths and 500,000 displaced at peak in April-May 2024. Maize transit times from "
+        "Trans-Nzoia and Uasin Gishu to Nairobi lengthened by 30-60% for weeks, widening producer-to-"
+        "wholesale spreads. This is the second signature shock in the LastMileBench Kenya benchmark window."
+    ),
+    KnowledgeChunk(
+        "SH-003", "IPC/FEWS NET Food Security Classifications for Kenya",
+        "IPC Global Partners; FEWS NET Kenya Food Security Outlook (https://fews.net/east-africa/kenya)",
+        "shock",
+        "FEWS NET and the IPC (Integrated Food Security Phase Classification) use a five-phase scale: "
+        "1-Minimal, 2-Stressed, 3-Crisis, 4-Emergency, 5-Famine. Kenya's ASAL counties have been chronically "
+        "in Phase 2 (Stressed) or Phase 3 (Crisis) since the mid-2000s, with brief escalations to Phase 4 "
+        "(Emergency) during acute drought peaks -- including much of 2022 across northern and eastern "
+        "counties. Agricultural high-potential zones (Rift Valley, Western, Central) typically sit in Phase 1. "
+        "FEWS NET publishes a Kenya Food Security Outlook every four months with updated county-level maps, "
+        "the canonical reference for cross-regional food-security context in the benchmark panel."
+    ),
+]
+
+KNOWLEDGE_BASE = KNOWLEDGE_CHUNKS

src/rag/provider.py

@@ -12,7 +12,12 @@ from __future__ import annotations
 import logging
 from typing import Any
 
-from src.rag.knowledge_base import KNOWLEDGE_BASE, KnowledgeChunk
+from config import REGION
+
+if REGION == "kenya":
+    from src.rag.knowledge_base_kenya import KNOWLEDGE_BASE, KnowledgeChunk
+else:
+    from src.rag.knowledge_base import KNOWLEDGE_BASE, KnowledgeChunk
 
 log = logging.getLogger(__name__)
 

tests/fixtures/kamis_nakuru_dry_maize_sample.html

@@ -0,0 +1,566 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>KAMIS</title>
+  <!-- Global site tag (gtag.js) - Google Analytics -->
+    <script async src="https://www.googletagmanager.com/gtag/js?id=G-LVPBH4Z6YM"></script>
+    <script>
+      window.dataLayer = window.dataLayer || [];
+      function gtag(){dataLayer.push(arguments);}
+      gtag('js', new Date());
+    
+      gtag('config', 'G-LVPBH4Z6YM');
+    </script>
+    <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Abril+Fatface" />
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/all.min.css" integrity="sha512-iBBXm8fW90+nuLcSKlbmrPcLa0OT92xO1BIsZ+ywDWZCvqsWgccV3gFoRBv0z+8dLJgyAHIhR35VZc2oM/gI1w==" crossorigin="anonymous" />
+    <link rel="stylesheet" href="https://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
+    <link href="https://fonts.googleapis.com/css?family=Open+Sans:300,300i,400,400i,600,600i,700,700i|Nunito:300,300i,400,400i,600,600i,700,700i|Poppins:300,300i,400,400i,500,500i,600,600i,700,700i" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/frontpage-vendor/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/frontpage-vendor/bootstrap-icons/bootstrap-icons.css" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/frontpage-vendor/aos/aos.css" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/frontpage-vendor/remixicon/remixicon.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/frontpage-vendor/swiper/swiper-bundle.min.css" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/frontpage-vendor/glightbox/css/glightbox.min.css" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/general.css?v=1.125" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/sections.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/breadcrumbs.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/back-to-top.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/header.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/navigation-menu.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/hero-section.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/about.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/values.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/counts.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/features.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/services.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/pricing.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/faq.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/counts.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/features.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/services.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/pricing.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/faq.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/portfolio.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/testimonials.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/team.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/clients.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/blog.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/contact.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/product-item.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/footer.css?v=1.124" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/price-watch.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/latest-reports.css?v=1.123" rel="stylesheet">
+    <link href="https://kamis.kilimo.go.ke/resources/css/frontpage/highchart.css?v=1.123" rel="stylesheet">
+    <link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/1.10.24/css/jquery.dataTables.css">
+    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/Zebra_datepicker/1.9.18/css/bootstrap/zebra_datepicker.css" integrity="sha512-jGnP90W9TO7rAXE8dkl8c91DsyVxOKkMP7+fvYGW90qfp5QfHwinUADn4K+jyhDKdynKbS6DR+1UAiEyFl1dcQ==" crossorigin="anonymous" />
+    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js"
+      integrity="sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy"
+      crossorigin="anonymous"></script>
+    <script type="text/javascript" charset="utf8" src="https://cdn.datatables.net/1.10.24/js/jquery.dataTables.js"></script>
+    <script src="https://code.highcharts.com/highcharts.js"></script>
+    <script src="https://code.highcharts.com/modules/series-label.js"></script>
+    <script src="https://code.highcharts.com/modules/exporting.js"></script>
+    <script src="https://code.highcharts.com/modules/export-data.js"></script>
+    <script src="https://code.highcharts.com/modules/accessibility.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/select2/4.0.3/js/select2.min.js"></script>
+    <link href="https://cdnjs.cloudflare.com/ajax/libs/select2/4.0.3/css/select2.min.css" rel="stylesheet" />
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/Zebra_datepicker/1.9.18/zebra_datepicker.min.js" integrity="sha512-+jF6u7aOmduPkX9JBkvp1B5XgGqvfc3fPGWJG43Ci18tZ4hR1jgHMrlWrM8ai73KzuMc6hvp+9S2k9ggGKYTiw==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/Zebra_datepicker/1.9.18/css/bootstrap/zebra_datepicker.css" integrity="sha512-jGnP90W9TO7rAXE8dkl8c91DsyVxOKkMP7+fvYGW90qfp5QfHwinUADn4K+jyhDKdynKbS6DR+1UAiEyFl1dcQ==" crossorigin="anonymous" referrerpolicy="no-referrer" />
+   <script src="https://cdnjs.cloudflare.com/ajax/libs/axios/0.21.1/axios.min.js" integrity="sha512-bZS47S7sPOxkjU/4Bt0zrhEtWx0y0CRkhEp8IckzK+ltifIIE9EMIMTuT/mEzoIMewUINruDBIR/jJnbguonqQ==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+   <meta name="description" content="KAMIS" />
+		<meta name="keywords" content="market, prices" />
+		<meta name="author" content="KAMIS" />  </head>
+  <body>
+    <header id="header" class="header fixed-top" style="padding: 0.4em;">
+           
+<div class="container container-xl d-flex align-items-center justify-content-between mt-2">
+        <a href="https://kamis.kilimo.go.ke/" class="logo d-flex align-items-center">
+           <img src="https://kamis.kilimo.go.ke/resources/frontpage-images/logo.jpg" alt="logo"> 
+        </a>
+        <nav id="navbar" class="navbar">
+          <ul>
+            <!--<li class=""><a class="nav-link scrollto active" href="https://kamis.kilimo.go.ke/">HOME</a></li>-->
+            <li class=""><a class="nav-link scrollto" href="https://kamis.kilimo.go.ke/">HOME</a></li>
+            <li class=""><a class="nav-link" href="https://kamis.kilimo.go.ke/index.php/site/about">ABOUT</a></li>
+                        <li class="dropdown"><a><span>MARKETS</span></a>
+              <ul>
+                <li><a href="https://kamis.kilimo.go.ke/site/market">Commodity Prices</a></li>
+                <li><a href="https://kamis.kilimo.go.ke/site/market_search">Price Search</a></li>
+              </ul>
+            </li>
+            <li class="dropdown"><a><span>CROSS-BORDER</span></a>
+              <ul>
+                 <li><a href="https://kamis.kilimo.go.ke/site/border">Trade Volumes</a></li>
+                <li><a href="https://kamis.kilimo.go.ke/site/border_search">Volume Search</a></li>
+              </ul>
+            </li>
+			          </ul>
+          <i class="bi bi-list mobile-nav-toggle"></i>
+        </nav>
+      </div>    </header>
+    <section id="body-section" class="mt-3" >
+        <div class="container">
+            <div class="row">
+   <div class="col-lg-12">
+      <h1 class="page-header" style="font-size: 1.5rem;">Market
+         <small>prices</small>
+      </h1>
+      <ol class="breadcrumb">
+         <li><a href="https://kamis.kilimo.go.ke/">Home</a></li>
+         | 
+         <li class="active">Market Search</li>
+      </ol>
+   </div>
+</div>
+<div class="row">
+<div class="col-lg-12">
+   <div class="panel panel-default">
+      <div class="panel-body">
+         <div class="card bg-light">
+            <div class="card-body">
+               <form role="form" action="market_search" method="get">
+                  <div class="row">
+                     <div class="col-md-4">
+                        <div class="form-group">
+                           <label>County</label>
+                           <select name="county[]" class="form-control" id="selCounty"  multiple="multiple">
+                              <option value="">--Please select--</option>
+                                                            <option value="Nairobi">Nairobi</option>
+                                                            <option value="Machakos">Machakos</option>
+                                                            <option value="Uasin-gishu">Uasin-gishu</option>
+                                                            <option value="Mombasa">Mombasa</option>
+                                                            <option value="Embu">Embu</option>
+                                                            <option value="Isiolo">Isiolo</option>
+                                                            <option value="Kitui">Kitui</option>
+                                                            <option value="Nakuru">Nakuru</option>
+                                                            <option value="Kakamega">Kakamega</option>
+                                                            <option value="Kisumu">Kisumu</option>
+                                                            <option value="Busia">Busia</option>
+                                                            <option value="Migori">Migori</option>
+                                                            <option value="Marsabit">Marsabit</option>
+                                                            <option value="Kajiado">Kajiado</option>
+                                                            <option value="Taveta">Taveta</option>
+                                                            <option value="Kwale">Kwale</option>
+                                                            <option value="Trans-nzoia">Trans-nzoia</option>
+                                                            <option value="Bomet">Bomet</option>
+                                                            <option value="Garissa">Garissa</option>
+                                                            <option value="Muranga">Muranga</option>
+                                                            <option value="Nyandarua">Nyandarua</option>
+                                                            <option value="Wajir">Wajir</option>
+                                                            <option value="Meru">Meru</option>
+                                                            <option value="Narok">Narok</option>
+                                                            <option value="Kericho">Kericho</option>
+                                                            <option value="Nyamira">Nyamira</option>
+                                                            <option value="Taita-taveta">Taita-taveta</option>
+                                                            <option value="Lamu">Lamu</option>
+                                                            <option value="Tana-river">Tana-river</option>
+                                                            <option value="Kilifi">Kilifi</option>
+                                                            <option value="Kiambu">Kiambu</option>
+                                                            <option value="Nyeri">Nyeri</option>
+                                                            <option value="Elgeyo-marakwet">Elgeyo-marakwet</option>
+                                                            <option value="West-pokot">West-pokot</option>
+                                                            <option value="Samburu">Samburu</option>
+                                                            <option value="Laikipia">Laikipia</option>
+                                                            <option value="Baringo">Baringo</option>
+                                                            <option value="Mandera">Mandera</option>
+                                                            <option value="Makueni">Makueni</option>
+                                                            <option value="Tharaka-nithi">Tharaka-nithi</option>
+                                                            <option value="Kirinyaga">Kirinyaga</option>
+                                                            <option value="Vihiga">Vihiga</option>
+                                                            <option value="Siaya">Siaya</option>
+                                                            <option value="Nandi">Nandi</option>
+                                                            <option value="Homa-bay">Homa-bay</option>
+                                                            <option value="Kisii">Kisii</option>
+                                                            <option value="Turkana">Turkana</option>
+                                                            <option value="Test">Test</option>
+                                                            <option value="Bungoma">Bungoma</option>
+                                                         </select>
+                        </div>
+                     </div>
+                     <div class="col-md-4">
+                        <div class="form-group">
+                           <label>Markets</label>
+                           <select name="market[]" class="multiple-select form-control" id="selMarket" multiple="multiple">
+                              <option value="">--Please select--</option>
+                           </select>
+                        </div>
+                     </div>
+                     <div class="col-md-4">
+                        <div class="form-group">
+                           <label>Product</label>
+                           <select name="product[]" class="multiple-select form-control" id="selProduct" multiple="multiple">
+                              <option value="">--Please select--</option>
+                                                            <option value="1">Dry maize</option>
+                                                            <option value="2">Red sorghum</option>
+                                                            <option value="3">Wheat</option>
+                                                            <option value="4">Rice</option>
+                                                            <option value="10">Green grams</option>
+                                                            <option value="12">Ground nuts</option>
+                                                            <option value="29">Beans red haricot (wairimu)</option>
+                                                            <option value="30">Beans (yellow-green)</option>
+                                                            <option value="50">Dolichos lablab (njahi)</option>
+                                                            <option value="51">Pearl rush millet</option>
+                                                            <option value="54">Finger millet</option>
+                                                            <option value="56">White sorghum</option>
+                                                            <option value="57">Red irish potato</option>
+                                                            <option value="58">Cabbages</option>
+                                                            <option value="59">Sweet potatoes</option>
+                                                            <option value="60">Carrots</option>
+                                                            <option value="61">Tomatoes</option>
+                                                            <option value="64">Beans rosecoco</option>
+                                                            <option value="65">Beans (mwitemania)</option>
+                                                            <option value="66">Beans (mwezi moja)</option>
+                                                            <option value="67">Beans (canadian wonder)</option>
+                                                            <option value="68">Tilapia</option>
+                                                            <option value="70">Goat milk (at collection point)</option>
+                                                            <option value="72">Eggs</option>
+                                                            <option value="73">Meat beef</option>
+                                                            <option value="74">Meat mutton</option>
+                                                            <option value="75">Meat indiginous chicken</option>
+                                                            <option value="76">Meat broiler</option>
+                                                            <option value="77">Omena</option>
+                                                            <option value="78">Cat fish(mkizi/fume)</option>
+                                                            <option value="79">Haplochromis</option>
+                                                            <option value="80">Trout</option>
+                                                            <option value="81">Common carp</option>
+                                                            <option value="82">Protopterus</option>
+                                                            <option value="83">Black bass</option>
+                                                            <option value="84">Labeo</option>
+                                                            <option value="85">Mormyrus</option>
+                                                            <option value="86">Eel	</option>
+                                                            <option value="87">African butter catfish</option>
+                                                            <option value="89">Synodontis</option>
+                                                            <option value="90">Alestes</option>
+                                                            <option value="91">Barbus</option>
+                                                            <option value="93">Snappers(tazanda)</option>
+                                                            <option value="94">Rabbitfish (tafi/tasi)</option>
+                                                            <option value="95">Mixed demersal</option>
+                                                            <option value="96">Barracuda(kasumba)</option>
+                                                            <option value="97">Tuna</option>
+                                                            <option value="98">Mackerel</option>
+                                                            <option value="99">Kingfish (nguru)</option>
+                                                            <option value="100">Sharks</option>
+                                                            <option value="101">Sardines</option>
+                                                            <option value="102">Swordfishes</option>
+                                                            <option value="103">Lobster(kamba mawe)</option>
+                                                            <option value="104">Prawns</option>
+                                                            <option value="107">Mud crabs</option>
+                                                            <option value="108">Golden (deep-sea) crabs kaa</option>
+                                                            <option value="109">Fresh water shrimp</option>
+                                                            <option value="110">Octopus (pweza)</option>
+                                                            <option value="111">Cuttlefish</option>
+                                                            <option value="112">Squid(ngisi)</option>
+                                                            <option value="113">Oysters</option>
+                                                            <option value="114">Fish oil</option>
+                                                            <option value="115">Fish maws</option>
+                                                            <option value="117">Nile perch skins</option>
+                                                            <option value="121">Black nightshade (managu/ osuga)</option>
+                                                            <option value="122">Spider flower (saga)</option>
+                                                            <option value="123">Amaranthus (terere)</option>
+                                                            <option value="124">Jute plant (murenda)</option>
+                                                            <option value="125">Passion fruits</option>
+                                                            <option value="127">Oranges</option>
+                                                            <option value="128">Tree tomato</option>
+                                                            <option value="129">Pepino melon</option>
+                                                            <option value="130">Thorn melon</option>
+                                                            <option value="131">Yam</option>
+                                                            <option value="133">Cow milk(at collection point)</option>
+                                                            <option value="134">Camel milk(at collection point)</option>
+                                                            <option value="138">Camel milk(processed)</option>
+                                                            <option value="139">Goat milk (processed)</option>
+                                                            <option value="140">Cattle</option>
+                                                            <option value="141">Pork</option>
+                                                            <option value="142">Avocado</option>
+                                                            <option value="143">Arrow root</option>
+                                                            <option value="145">Lemons</option>
+                                                            <option value="147">Mangoes</option>
+                                                            <option value="148">Limes</option>
+                                                            <option value="149">Green maize</option>
+                                                            <option value="150">Water melon</option>
+                                                            <option value="151">Pineapples</option>
+                                                            <option value="152">Pawpaw</option>
+                                                            <option value="153">Cow milk(processd)</option>
+                                                            <option value="154">Kales/sukuma wiki</option>
+                                                            <option value="158">Dry onions</option>
+                                                            <option value="159">Spring onions</option>
+                                                            <option value="160">Fresh peas</option>
+                                                            <option value="161">Spinach</option>
+                                                            <option value="162">Cassava fresh</option>
+                                                            <option value="163">White irish potatoes</option>
+                                                            <option value="164">Cassava chips (dry)</option>
+                                                            <option value="165">Chillies</option>
+                                                            <option value="166">Lettuce</option>
+                                                            <option value="167">Sheep</option>
+                                                            <option value="168">Goat</option>
+                                                            <option value="169">Donkey</option>
+                                                            <option value="170">Pumpkin</option>
+                                                            <option value="171">Butternuts</option>
+                                                            <option value="172">Capsicums</option>
+                                                            <option value="173">Cucumber</option>
+                                                            <option value="174">Egg plant (brinjals)</option>
+                                                            <option value="175">Cauliflower</option>
+                                                            <option value="177">French beans</option>
+                                                            <option value="178">Ginger</option>
+                                                            <option value="180">Garlic</option>
+                                                            <option value="182">Njugu mawe</option>
+                                                            <option value="183">Beans rosecoco (nyayo)</option>
+                                                            <option value="184">Nile perch</option>
+                                                            <option value="186">Camel</option>
+                                                            <option value="187">Rabbit</option>
+                                                            <option value="188">Pigeon peas</option>
+                                                            <option value="189">Cowpeas</option>
+                                                            <option value="190">Scavengers (changu/tangu)</option>
+                                                            <option value="191">Parrotfishes(pono)</option>
+                                                            <option value="192">Groupers</option>
+                                                            <option value="193">Grunt(taamamba/kora)</option>
+                                                            <option value="194">Mullets(fumi)</option>
+                                                            <option value="195">Surgeonfishes</option>
+                                                            <option value="196">Threadfin breams</option>
+                                                            <option value="197">Goatfishes</option>
+                                                            <option value="198">Rayfish</option>
+                                                            <option value="199">Needlefishes</option>
+                                                            <option value="200">Jacks/trevallies(kolekole)</option>
+                                                            <option value="201">Halfbeaks</option>
+                                                            <option value="202">Anchovies</option>
+                                                            <option value="203">Sailfishes</option>
+                                                            <option value="204">Wolf herrings</option>
+                                                            <option value="205">Marlins</option>
+                                                            <option value="206">Jobfish</option>
+                                                            <option value="207">Mixed pelagics</option>
+                                                            <option value="208">Camel meat</option>
+                                                            <option value="209">Meat chevon</option>
+                                                            <option value="210">Rabbit meat </option>
+                                                            <option value="211">Pigs</option>
+                                                            <option value="212">Honey</option>
+                                                            <option value="213">Cattle hide</option>
+                                                            <option value="214">Camel hide</option>
+                                                            <option value="215">Goat skin</option>
+                                                            <option value="216">Sheep skin</option>
+                                                            <option value="217">Fertilizer</option>
+                                                            <option value="218">Tea</option>
+                                                            <option value="219">Coffee</option>
+                                                            <option value="220">Wheat bran</option>
+                                                            <option value="221">Maize bran</option>
+                                                            <option value="222">Sunflower cake</option>
+                                                            <option value="223">Cotton seed</option>
+                                                            <option value="224">Cotton</option>
+                                                            <option value="226">Banana (ripening)</option>
+                                                            <option value="227">Chicken</option>
+                                                            <option value="228">Macadamia seed</option>
+                                                            <option value="229">Cashewnuts (korosho)</option>
+                                                            <option value="230">Cowpea leaves (kunde)</option>
+                                                            <option value="231">Nderema- vine spinach</option>
+                                                            <option value="233">Pumpkin leaves</option>
+                                                            <option value="234">Ethiopian kales -kanzira</option>
+                                                            <option value="235">Indigenous crotolaria (mito/miro)</option>
+                                                            <option value="237">Soybean oil</option>
+                                                            <option value="238">Coconut oil</option>
+                                                            <option value="239">Sunflower seeds</option>
+                                                            <option value="240">Sunflower oil</option>
+                                                            <option value="241">Walnut seed</option>
+                                                            <option value="242">Coriander (dhania)</option>
+                                                            <option value="243">Grapes</option>
+                                                            <option value="244">Apples</option>
+                                                            <option value="245">Dry peas</option>
+                                                            <option value="246">Mixed beans</option>
+                                                            <option value="247">Rockcode(tewa)</option>
+                                                            <option value="248">Queenfish (pandu)</option>
+                                                            <option value="249">Maize flour</option>
+                                                            <option value="251">Duck</option>
+                                                            <option value="255">Banana (cooking)</option>
+                                                            <option value="256">Banana (plantain)</option>
+                                                            <option value="257">Courgette</option>
+                                                            <option value="258">Broccoli</option>
+                                                            <option value="259">Lentils</option>
+                                                            <option value="261">Fish scales</option>
+                                                            <option value="262">Tangerine (sandara)</option>
+                                                            <option value="265">Wheat flour</option>
+                                                            <option value="267">Paddy rice</option>
+                                                            <option value="269">Beans (yellow)</option>
+                                                            <option value="270">Coconut</option>
+                                                            <option value="272">Okra (lady's fingers or gumbo)</option>
+                                                            <option value="273">Dragon fruit</option>
+                                                         </select>
+                        </div>
+                     </div>
+                  </div>
+                  <div class="row">
+                     <div class="col-md-4">
+                        <div class="form-group">
+                           <label for="inputStart">Start Date</label>
+                           <input type="text" name="start" class="form-control form-date" id="dateStartSearch" value="2024-01-15">
+                        </div>
+                     </div>
+                     <div class="col-md-4">
+                        <div class="form-group">
+                           <label for="inputEnd">End Date</label>
+                           <input type="text" name="end" class="form-control form-date" id="dateEndSearch" value="2024-01-20">
+                        </div>
+                     </div>
+                     <div class="col-md-4">
+                        <div class="form-group">
+                           <label>Entries:</label>
+                           <select id="selPerPage" name="per_page" class="page-size form-control" onchange='this.form.submit()'>
+                              <option value="10">10</option>
+                              <option value="50">50</option>
+                              <option value="100">100</option>
+                              <option value="500">500</option>
+                              <option value="1500">1500</option>
+                               <option value="3000">3000</option>
+                                                         </select>
+                        </div>
+                     </div>
+                  </div>
+                  <div class="row">
+                     <div class="col-md-4 offset-md-8">
+                        <div class="form-group">
+                           <input type="submit" value="Filter Prices" class="btn btn-primary w-100 mt-3">
+                        </div>
+                     </div>
+                  </div>
+               </form>
+            </div>
+         </div>
+      </div>
+   </div>
+</div>
+<div class="col-lg-12 mt-3">
+   <div class="panel panel-default">
+      <div class="panel-body">
+         <div class="card bg-light">
+            <div class="card-body">
+               <div class="row  d-flex align-items-center justify-content-between mt-1 mb-3">
+                  <div class="pull-left col-lg-6">
+                     <ul class="pagination"><li class="active"><a href="#">1</a></li><li><a href="https://kamis.kilimo.go.ke/site/market_search/5?product%5B0%5D=1&county%5B0%5D=Nakuru&start=2024-01-15&end=2024-01-20&per_page=5" data-ci-pagination-page="2">2</a></li><li><a href="https://kamis.kilimo.go.ke/site/market_search/10?product%5B0%5D=1&county%5B0%5D=Nakuru&start=2024-01-15&end=2024-01-20&per_page=5" data-ci-pagination-page="3">3</a></li><li><a href="https://kamis.kilimo.go.ke/site/market_search/15?product%5B0%5D=1&county%5B0%5D=Nakuru&start=2024-01-15&end=2024-01-20&per_page=5" data-ci-pagination-page="4">4</a></li><li><a href="https://kamis.kilimo.go.ke/site/market_search/5?product%5B0%5D=1&county%5B0%5D=Nakuru&start=2024-01-15&end=2024-01-20&per_page=5" data-ci-pagination-page="2" rel="next">&gt;</a><li></ul>                  </div>
+                  <div class="pull-right col-lg-2">
+                     <a href="https://kamis.kilimo.go.ke/site/market_search?product%5B%5D=1&county%5B%5D=Nakuru&start=2024-01-15&end=2024-01-20&per_page=5&export=excel" class="btn btn-default mr-2 mt-2 mb-2 btn-export"><i class="fas fa-file-excel"></i> Export to Excel</a>                  </div>
+               </div>
+               <div class="row">
+                  <div class="col-md-12">
+                     <div class="table-responsive"> 
+                        <table class="table table-bordered table-condensed">
+<thead>
+<tr>
+<th>Market</th><th>Commodity</th><th>Classification</th><th>Grade</th><th>Sex</th><th>Wholesale</th><th>Retail</th><th>Supply Volume</th><th>County</th><th>Date</th></tr>
+</thead>
+<tbody>
+<tr>
+<td>Molo</td><td>Dry Maize</td><td>White Maize</td><td>-</td><td>-</td><td> - </td><td>40.00/Kg</td><td>2100.00</td><td>Nakuru</td><td>2024-01-20</td></tr>
+<tr>
+<td>Molo</td><td>Dry Maize</td><td>White Maize</td><td>-</td><td>-</td><td> - </td><td>3600.00/Kg</td><td>2400.00</td><td>Nakuru</td><td>2024-01-19</td></tr>
+<tr>
+<td>Nakuru Wakulima</td><td>Dry Maize</td><td>Yellow Maize</td><td>-</td><td>-</td><td>70.00/Kg</td><td> - </td><td></td><td>Nakuru</td><td>2024-01-19</td></tr>
+<tr>
+<td>Nakuru Wakulima</td><td>Dry Maize</td><td>White Maize</td><td>-</td><td>-</td><td>46.67/Kg</td><td> - </td><td>4590.00</td><td>Nakuru</td><td>2024-01-19</td></tr>
+<tr>
+<td>Molo</td><td>Dry Maize</td><td>White Maize</td><td>-</td><td>-</td><td> - </td><td>151.11/Kg</td><td>2400.00</td><td>Nakuru</td><td>2024-01-19</td></tr>
+</tbody>
+</table>                     </div>
+                  </div>
+               </div>
+            </div>
+         </div>
+      </div>
+   </div>
+</div>
+<script type="text/javascript">
+   $(document).ready(function() {
+      $('#selPerPage').select2({placeholder : "Select Page"});
+      if(("5")){
+            $('#selPerPage').select2('destroy');
+            $('#selPerPage').val("5").select2();
+      }
+       $('#selProduct').select2({
+           placeholder : "Select Product",
+       });
+       if(["1"]){
+            $('#selProduct').val(["1"])
+            $('#selProduct').trigger('change');
+        }
+   
+       $('#selMarket').select2({
+           placeholder : "Select Market",
+       });
+       
+          $('#selCounty').select2({
+              placeholder : "Select County",
+          });
+          if(["Nakuru"]){
+            $('#selCounty').val(["Nakuru"])
+            $('#selCounty').trigger('change');
+            fetchMarkets();
+          }
+      
+           $('#dateStartSearch').Zebra_DatePicker({
+               show_icon: false,
+           });
+           if("2024-01-15"){
+               $("#dateStartSearch").val("2024-01-15");
+           }
+        $('#dateEndSearch').Zebra_DatePicker({
+               show_icon: false
+           });
+           if("2024-01-20"){
+               $("#dateEndSearch").val("2024-01-20");
+           }
+       $('#selCounty').change(function(){
+           fetchMarkets();
+        });
+   });
+   function fetchMarkets(){
+       let select_value = $('#selCounty').val();
+           axios.get("https:\/\/kamis.kilimo.go.ke\/"+'index.php/site/county_markets',{
+                  params: {
+                    counties: select_value
+                  }
+                }).then((response) => {
+               var items = [];
+               $('#selMarket').val(null).trigger('change');
+                   $('#selMarket').find('option').remove().end();
+                   console.log(response);
+                   response.data.forEach((j) => {
+                       if(null){
+                           $("#selMarket").append(new Option( j.trade_point_name,j.id, false, false));
+                            $('#selMarket').val(null);
+                            $('#selMarket').trigger('change');
+                            return;
+                       }
+                       $("#selMarket").append(new Option( j.trade_point_name,j.id, false, false)).trigger('change');
+                   });
+           });
+   }
+   //   </script>
+        </div>
+    </section>
+    <a href="#" class="back-to-top d-flex align-items-center justify-content-center"><i
+        class="bi bi-arrow-up-short"></i></a>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/bootstrap/js/bootstrap.bundle.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/aos/aos.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/php-email-form/validate.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/swiper/swiper-bundle.min.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/purecounter/purecounter.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/isotope-layout/isotope.pkgd.min.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/frontpage-vendor/glightbox/js/glightbox.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/select2@4.1.0-beta.1/dist/js/select2.min.js"></script>
+    <script src="https://kamis.kilimo.go.ke/resources/js/frontpage/main.js"></script>
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/fake_data.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/agricultural-inputs/table.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/agricultural-inputs/graph.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/agricultural-inputs/whats-new.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/crops/table.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/crops/graph.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/crops/whats-new.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/fisheries/table.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/fisheries/graph.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/fisheries/whats-new.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/livestock/table.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/livestock/graph.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/livestock/whats-new.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/agricultural/table.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/agricultural/graph.js"></script>-->
+    <!--<script src="https://kamis.kilimo.go.ke/resources/js/frontpage/agricultural/whats-new.js"></script>-->
+</body>
+</html>

tests/test_dpi.py

@@ -3,10 +3,23 @@
 Covers the Aadhaar + Land Record + KCC services, the deterministic
 registry, DPIAgent composite, and the KCC-aware credit readiness
 integration. No DB, no API key, no network.
+
+Kenya has no equivalent DPI stack (Aadhaar/KCC are India-specific) so
+this whole module is India-only. Phase 1.6 will introduce parallel
+Kenya DPI tests if/when a Kenya DPI subsystem exists.
 """
 
 from __future__ import annotations
 
+import pytest
+
+from config import REGION
+
+pytestmark = pytest.mark.skipif(
+    REGION != "india",
+    reason="DPI subsystem is India-specific (Aadhaar/KCC); no Kenya equivalent yet",
+)
+
 
 # ---------------------------------------------------------------------------
 # Module imports

tests/test_kamis_ingestion.py

@@ -0,0 +1,174 @@
+"""Smoke tests for the KAMIS ingestion source.
+
+Runs entirely in demo mode (no network) against the committed snapshot
+at ``data/demo_snapshots/kamis/kamis_demo_snapshot.csv`` plus a static
+HTML fixture copied from the lastmile-bench benchmark repo.
+
+These tests deliberately construct their own lightweight market and
+commodity objects rather than importing ``config.MANDIS`` — the
+Kenya-migration ``config.py`` changes land in a parallel Phase 1.1
+task, and we don't want this test's stability to depend on that
+landing first.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+from dataclasses import dataclass
+from datetime import date, datetime
+from pathlib import Path
+
+import pytest
+
+from src.ingestion.kamis import (
+    PRODUCT_IDS,
+    build_search_url,
+    fetch_kamis_prices,
+    parse_search_result_html,
+)
+
+
+# --- Minimal Kenya-shaped market stub -----------------------------------
+# Kept inline so the test doesn't couple to whatever Phase 1.1 picks for
+# the canonical Kenya market dataclass. The ingestion module only reads
+# `mandi_id`, `name`, and `district` / `county`, so this stub suffices.
+@dataclass
+class _KenyaMarket:
+    mandi_id: str
+    name: str
+    district: str  # KAMIS county
+
+
+# Three KAMIS markets that actually appear in the demo snapshot.
+_DEMO_MARKETS = [
+    _KenyaMarket(mandi_id="KE-NAI-KAW", name="Kawangware", district="Nairobi"),
+    _KenyaMarket(mandi_id="KE-NAI-KAN", name="Kangemi Market", district="Nairobi"),
+    _KenyaMarket(mandi_id="KE-NAK-MOL", name="Molo", district="Nakuru"),
+]
+
+# The four Kenya priority crops for the market-intelligence pivot.
+_DEMO_COMMODITIES: list[dict] = [
+    {"id": "dry_maize", "name": "Dry maize", "kamis_name": "Dry maize"},
+    {"id": "beans", "name": "Beans", "kamis_name": "Beans (yellow-green)"},
+    {"id": "red_irish_potato", "name": "Red irish potato",
+     "kamis_name": "Red irish potato"},
+    {"id": "green_grams", "name": "Green grams", "kamis_name": "Green grams"},
+]
+
+
+# --- Tests --------------------------------------------------------------
+
+
+def test_demo_mode_returns_valid_price_records(monkeypatch: pytest.MonkeyPatch) -> None:
+    """End-to-end demo-mode smoke test.
+
+    Drives `fetch_kamis_prices` against the committed snapshot and
+    asserts every returned record has the schema the downstream
+    reconciliation / forecasting / optimization steps expect.
+    """
+    monkeypatch.setenv("MARKET_INTEL_DEMO_MODE", "1")
+
+    result = asyncio.run(fetch_kamis_prices(
+        markets=_DEMO_MARKETS,
+        commodities=_DEMO_COMMODITIES,
+        days_back=60,
+    ))
+
+    # Keys are mandi IDs, at least one market has data.
+    assert set(result.keys()) == {m.mandi_id for m in _DEMO_MARKETS}
+    all_records = [r for recs in result.values() for r in recs]
+    assert len(all_records) > 0, "demo snapshot returned zero records"
+
+    # Every record has the schema the pipeline downstream depends on.
+    valid_commodity_ids = {c["id"] for c in _DEMO_COMMODITIES}
+    valid_mandi_ids = {m.mandi_id for m in _DEMO_MARKETS}
+    for rec in all_records:
+        assert rec.source == "kamis"
+        assert rec.mandi_id in valid_mandi_ids, f"unknown mandi_id: {rec.mandi_id}"
+        assert rec.commodity_id in valid_commodity_ids, (
+            f"unknown commodity_id: {rec.commodity_id}"
+        )
+        # ISO date string
+        parsed = datetime.strptime(rec.date, "%Y-%m-%d").date()
+        assert parsed <= date.today() + timedelta_days(1), "date in far future"
+        # Positive prices
+        assert rec.modal_price_rs > 0, f"non-positive modal: {rec}"
+        assert rec.min_price_rs > 0, f"non-positive min: {rec}"
+        assert rec.max_price_rs > 0, f"non-positive max: {rec}"
+        # Quality flag is one of the documented values
+        assert rec.quality_flag in {"good", "stale", "anomalous", "missing"}
+
+
+def test_demo_mode_covers_at_least_two_commodities(monkeypatch: pytest.MonkeyPatch) -> None:
+    """Guard against a regression where the snapshot or filter loses variety."""
+    monkeypatch.setenv("MARKET_INTEL_DEMO_MODE", "1")
+    result = asyncio.run(fetch_kamis_prices(
+        markets=_DEMO_MARKETS,
+        commodities=_DEMO_COMMODITIES,
+        days_back=60,
+    ))
+    observed = {r.commodity_id for recs in result.values() for r in recs}
+    assert len(observed) >= 2, (
+        f"expected >=2 commodities in demo snapshot, got {observed}"
+    )
+
+
+def test_build_search_url_uses_iso_dates() -> None:
+    """Hard-guard against the localized-date footgun documented in the
+    benchmark reference (localized dates fail silently with "No Data")."""
+    url = build_search_url(
+        product_id=1,
+        county="Nairobi",
+        start=date(2026, 1, 1),
+        end=date(2026, 4, 1),
+    )
+    assert "start=2026-01-01" in url
+    assert "end=2026-04-01" in url
+    assert "product%5B%5D=1" in url  # product[]=1 URL-encoded
+    assert "county%5B%5D=Nairobi" in url
+
+
+def test_product_ids_covers_four_kenya_priority_crops() -> None:
+    """Pin the four v0.1 Kenya crops — if any of these IDs change upstream
+    the test fails fast instead of silently returning zero rows."""
+    assert PRODUCT_IDS["Dry maize"] == 1
+    assert PRODUCT_IDS["Beans (yellow-green)"] == 30
+    assert PRODUCT_IDS["Red irish potato"] == 57
+    assert PRODUCT_IDS["Green grams"] == 10
+
+
+# --- HTML parser test (fixture-based) -----------------------------------
+
+
+_FIXTURE_PATH = (
+    Path(__file__).parent / "fixtures" / "kamis_nakuru_dry_maize_sample.html"
+)
+
+
+@pytest.mark.skipif(
+    not _FIXTURE_PATH.exists(),
+    reason="KAMIS HTML fixture not available; copy from lastmile-bench",
+)
+def test_parse_search_result_html_on_nakuru_fixture() -> None:
+    """Parse the committed HTML fixture and assert the core row shape.
+
+    Using the fixture rather than live fetch keeps the test hermetic.
+    """
+    html = _FIXTURE_PATH.read_text(encoding="utf-8")
+    rows = parse_search_result_html(html)
+    assert len(rows) > 0, "fixture parsed to zero rows — parser regression"
+    for row in rows:
+        assert row["market"], "empty market cell"
+        assert row["product"], "empty product cell"
+        assert row["wholesale"] is not None and row["wholesale"] > 0
+        assert row["retail"] is not None and row["retail"] > 0
+        assert isinstance(row["price_date"], date)
+
+
+# --- tiny helper --------------------------------------------------------
+
+
+def timedelta_days(n: int):  # tiny local shim so we don't add another import
+    from datetime import timedelta
+    return timedelta(days=n)

tests/test_smoke.py

@@ -18,6 +18,13 @@ from __future__ import annotations
 
 import pytest
 
+from config import REGION
+
+_india_only = pytest.mark.skipif(
+    REGION != "india",
+    reason="India-specific assertions (15 mandis, Tamil names, quintal range); Kenya parity tests in Phase 1.6",
+)
+
 
 # ---------------------------------------------------------------------------
 # Module imports
@@ -58,6 +65,7 @@ def test_imports_optimizer():
 # ---------------------------------------------------------------------------
 
 
+@_india_only
 def test_mandis_and_commodities_loaded():
     """15 Tamil Nadu mandis and 10 commodities are registered."""
     from config import COMMODITIES, MANDIS, MANDI_MAP
@@ -75,6 +83,7 @@ def test_pilot_registry_has_100_farmers():
     assert len(SAMPLE_FARMERS) == 100
 
 
+@_india_only
 def test_featured_subset_is_three_curated_farmers():
     """FEATURED_FARMERS is exactly the 3 hand-written personas."""
     from config import FEATURED_FARMERS, SAMPLE_FARMERS
@@ -108,6 +117,7 @@ def test_generated_farmers_use_mandi_commodities():
         )
 
 
+@_india_only
 def test_generated_farmers_have_plausible_quantities():
     """Generated quantities stay in the 8-35 quintal pilot range."""
     from config import SAMPLE_FARMERS