# 1. Clonar e instalar
git clone https://github.com/oscarzamora/onpe-mcp
cd onpe-mcp
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

# 2. Clonar los datos: scrapers 2026 + dataset histórico 2021
git clone https://github.com/oscarzamora/onpescraper ../onpescraper
git clone https://github.com/oscarzamora/onpe-scraper-2026-2 ../onpe-scraper-2026-2
git clone https://github.com/oscarzamora/peruvoto2021 ../peruvoto2021

# 3. Arrancar el servidor MCP
onpe-mcp

pytest                                  # corre la suite (410+ tests, ~30s)
onpe-mcp                                # arranca servidor MCP (modo stdio)

onpe_health()                           # estado 2026 + 2021, cobertura
onpe_get_mesa("900100")                 # mesa 2026
# "top 5 en Lima 2021"                  # query histórico 2021
# "Keiko vs Sanchez 2V"                 # 2026 segunda vuelta

┌─ Scraper 1V 2026 ┐   ┌─ Bootstrap MCP ──────────────────┐    ┌─ SQLite local ─┐
│  onpescraper     │→  │ onpe_bootstrap_snapshot()        │→   │  92,766 mesas  │
│  output/*.txt    │   │  · mesas_data, votos, grupos     │    │  3.8M votos    │
└──────────────────┘   └──────────────────────────────────┘    └────────────────┘

┌─ Dataset 2021 ──────┐  ┌─ Bootstrap MCP ──────────┐   ┌─ SQLite local ───┐
│ peruvoto2021/data   │→ │ onpe_2021_bootstrap()    │→  │  86,488 mesas    │
│  *.csv (1V+2V)      │  │  · mesas_2021, votos_2021│   │  1.7M votos      │
└─────────────────────┘  │  · 20 partidos (ambas V) │   │  partidos_2021   │
                         └──────────────────────────┘   └──────────────────┘

┌─ Scraper 2V 2026 ──────┐  ┌─ Bootstrap MCP ──────────┐   ┌─ SQLite local ─┐
│ onpe-scraper-2026-2    │→ │ onpe_sv_bootstrap()      │→  │  92,766 mesas  │
│  output/*.txt          │  │  · mesas_sv, votos_sv,   │   │  + agregados   │
│  resumen/*.txt         │  │    reasignados, resumen  │   │  geográficos   │
└────────────────────────┘  └──────────────────────────┘   └────────────────┘

INFO  Bootstrap 1V 2026 desde ../onpescraper/output/ ........ (~30-60 s)
INFO  Bootstrap 2021 desde ../peruvoto2021/data/*.csv ....... (~10-15 s)
INFO  Bootstrap 2V 2026 desde ../onpe-scraper-2026-2/ ....... (~10-20 s)
INFO  Bootstrap resumen 2V desde resumen/ ................... (~5 s)
INFO  Pre-computando agregados geográficos .................. (~5 s)
INFO  Sembrando mapa de transferencia NNLS .................. (~1 s)
INFO  Hidratación completada en ~65s — 2026: 92,766+92,766 mesas · 2021: 86,488 mesas

# === Primera vuelta 2026 ===
onpe_bootstrap_snapshot()             # carga 1V desde ../onpescraper/output/
onpe_bootstrap_atu_manera()           # FALLBACK: descarga CSV público si no hay scraper

# === Dataset histórico 2021 (1V + 2V) ===
onpe_2021_bootstrap()                 # carga CSV oficiales desde ../peruvoto2021/data/

# === Segunda vuelta 2026 ===
onpe_sv_bootstrap()                   # carga 2V desde ../onpe-scraper-2026-2/
onpe_sv_refresh()                     # re-importa 2V (UPSERT) — usar tras `git pull`

# === Catálogos auxiliares ===
onpe_sync_foreign_catalog()           # deshabilitado en local-only (usa datos ya cargados)
onpe_sync_domestic_catalog()          # deshabilitado en local-only (usa datos ya cargados)

onpe_health()                         # estado 2026 (1V+2V) + 2021, cobertura
onpe_sv_cobertura()                   # % actas contabilizadas por departamento (2V 2026)

{
  "status": "ok",
  "hydrated": true,
  "total_mesas_local": 92766,
  "total_votos_local": 3801438,
  "total_mesas_2021_v1": 86488,
  "total_mesas_2021_v2": 86488,
  "sv_total_mesas": 92766,
  "sv_coverage_pct": 98.25,
  "coverage_pct": 99.9,
  "next_step": null
}

cd ../onpe-scraper-2026-2 && git pull   # nuevos datos del scraper

onpe_sv_refresh()                       # UPSERT idempotente en SQLite

# 1) Pull de repos
git pull --ff-only
git -C ../onpescraper pull --ff-only
git -C ../onpe-scraper-2026-2 pull --ff-only
git -C ../peruvoto2021 pull --ff-only

# 2) Hidratación runtime (1V + 2021 + 2V)
python -c "import json; from onpe_mcp.server import onpe_bootstrap_snapshot,onpe_2021_bootstrap,onpe_sv_bootstrap; print(json.dumps(onpe_bootstrap_snapshot(force=True), ensure_ascii=False)); print(json.dumps(onpe_2021_bootstrap(force=True), ensure_ascii=False)); print(json.dumps(onpe_sv_bootstrap(force=True), ensure_ascii=False))"

# 3) Snapshot seguro para build_denorm
python -c "import sqlite3; s=sqlite3.connect('data/onpe_denorm.db'); d=sqlite3.connect('data/source_snapshot.db'); s.backup(d); d.close(); s.close(); print('SNAPSHOT_OK')"

# 4) Materializar denorm BI
python scripts/build_denorm.py --src data/source_snapshot.db --dest data/onpe_denorm.db

# 5) Rehidratar runtime (obligatorio: build_denorm recrea la DB)
python -c "import json; from onpe_mcp.server import onpe_bootstrap_snapshot,onpe_2021_bootstrap,onpe_sv_bootstrap; print(json.dumps(onpe_bootstrap_snapshot(force=True), ensure_ascii=False)); print(json.dumps(onpe_2021_bootstrap(force=True), ensure_ascii=False)); print(json.dumps(onpe_sv_bootstrap(force=True), ensure_ascii=False))"

# 6) Tests
python -m pytest tests -q --tb=short

onpe-mcp/
├── data/
│   ├── onpe_denorm.db   ← SQLite denorm: facts/dims + tablas runtime MCP
│   ├── raw/events.jsonl ← log append-only de cada tool call
│   └── reports/         ← resúmenes markdown diarios
├── src/onpe_mcp/
│   ├── server.py        ← tools MCP + NLU/intent routing
│   ├── storage.py       ← DataStore: todas las queries SQLite
│   ├── onpe_api.py      ← cliente HTTP directo a ONPE
│   ├── gateway.py       ← bridge a onpescraper (import dinámico)
│   ├── knowledge_base.py← 535 hechos verificados sobre el proceso
│   └── config.py        ← Settings desde variables de entorno

python scripts/build_denorm.py                # reconstruye (~108 s, ~1.9 GB)
python scripts/build_denorm.py --validate-only # solo valida (7/7 checks)
python scripts/benchmark_denorm.py            # corre 26 queries baseline legacy vs Denorm

"dame los resultados de la mesa 900100 en 2026"

Mesa 900100 (IEI 326, Amazonas): Contabilizada.
210 votos emitidos de 248 electores hábiles.
Top: Rafael López Aliaga Cazorla 68v, Keiko Fujimori 55v, Roberto Sánchez 24v.

"cuántos electores hábiles tuvo la mesa 004521 y quién ganó ahí"
"qué estado tiene el acta de la mesa 000001"

"cuántos votos sacó Keiko Fujimori a nivel nacional en 2026"

Candidato Keiko Sofía Fujimori Higuchi (partido 1) tiene 5,432,109 votos
y posición 1 en el consolidado 2026.

"cuántos votos obtuvo Rafael López Aliaga en primera vuelta 2026"
"cuántos votos sacó Roberto Sánchez Palomino"
"quién fue el tercer candidato más votado a nivel nacional"
"qué porcentaje alcanzó Fuerza Popular en 2026"

"cuántos votos sacó Pedro Castillo en 2021 segunda vuelta"
"quién ganó en Peru 2021 - primera vuelta"
"qué porcentaje obtuvo Fujimori en 2021 2V"

"top 5 en Puno — quiénes fueron los más votados en 2026"

Top 5 en Puno (4,520 mesas · 946,628 votos emitidos)

1. Keiko Sofía Fujimori Higuchi  — 197,801 votos (20.9%)
2. Roberto Sánchez Palomino      — 178,042 votos (18.8%)
3. Ricardo Belmont Cassinelli    —  98,530 votos (10.4%)
4. Carlos Álvarez Requena        —  73,914 votos  (7.8%)
5. Rafael López Aliaga Cazorla   —  59,703 votos  (6.3%)

"top 3 en Loreto 2026"
"quién ganó en Cusco en primera vuelta 2026"
"cuántos votos sacó López Aliaga en Arequipa 2026"
"quién fue primero en Ayacucho"
"cuántas mesas tiene Ancash y quién ganó"
"top 3 en Amazonas"

"quién ganó en Lima 2021 primera vuelta - top 5"
"top 3 en Puno 2021 segunda vuelta"
"cuántos votos sacó Fujimori en Arequipa 2021"
"quién fue el más votado en Cusco 2021 segunda vuelta"

"top 3 de candidatos en Suecia 2026"
"resultados en Estocolmo 2026 — quién ganó"
"cuántos votos sacó Keiko Fujimori en Chile 2026"
"quién fue el más votado entre los peruanos en España"
"top 5 candidatos en Argentina 2026"
"cuántos votos hubo en las mesas de Estados Unidos"

"cuántas mesas arrancan en 900 y dónde están en 2026"
"top 3 candidatos en las mesas 900K"
"de las mesas que arrancan en 900000, en qué lugares ganó primero López Aliaga"
"cuántos electores hábiles tienen las mesas con prefijo 087"
"cuántas mesas hay en el bloque 150 y qué candidato ganó ahí"

"quién ganó la segunda vuelta a nivel nacional en 2026"
"resultados segunda vuelta en Lima 2026 — top candidatos"
"cuál es la cobertura de actas en segunda vuelta 2026"
"cuántos votos sacó Keiko en segunda vuelta en Cusco"
"compara primera y segunda vuelta de la mesa 000900"
"cómo cambió el voto en Puno entre primera y segunda vuelta 2026"
"qué locales se reasignaron en Trujillo entre vueltas"
"cómo se proyectan los votos del Partido Cívico Obras hacia los finalistas"
"cómo fluyeron los votos en las mesas 900K"
"qué pasó con el voto blanco entre primera y segunda vuelta"

"compara los resultados de Keiko en 2021 primera vuelta vs 2026 primera vuelta"
"cuántos votos sacó Pedro Castillo 2021 segunda vuelta - comparado con alguien en 2026"
"diferencias en Puno entre 2021 y 2026"
"cómo cambió la concentración de votos en Lima entre 2021 y 2026"

"las mesas 900K son fantasma — es verdad?"
"por qué algunas mesas tienen solo 50 votantes"
"hubo fraude en las elecciones 2026"
"qué es el STAE y puede manipular votos"
"por qué hubo mesas que votaron el lunes 13 de abril"
"cuándo fue la segunda vuelta 2026"
"quién pasó a segunda vuelta 2026"
"por qué el sur del Perú vota diferente al norte"
"por qué Fujimori hizo mejor en 2026 que en 2021 en algunas regiones"
"cuál fue el candidato que más mejoró su votación entre 2021 y 2026"

pip install -e ".[dev]"                 # instala con extras dev (pytest, ruff, etc.)
pytest                                  # corre 410+ tests (2026 + 2021)
pytest tests/test_storage_2021.py -v   # solo tests de storage 2021
pytest tests/test_nl_100_year_cases.py -v  # tests de año/routing automático
pytest tests/test_onpe_chat.py -v      # tests de routeo principal
pytest -k "proyeccion_sv"              # solo tests de mapeo transferencia 2026
onpe-mcp                                # arranca servidor MCP (stdio)