Bible Knowledge Graph (Fase 58)

Hidrata jw-brain con un knowledge graph bíblico (personas, lugares, periodos, pasajes) construido desde fuentes JW puras: Estudio Perspicaz de las Escrituras (Insight on the Scriptures) y NWT/NWTsty.

Por qué versión propia y no `theographic-bible-metadata`

El KG académico upstream incorpora datos de tradiciones no-JW (Catholic Encyclopedia, Jewish Encyclopedia, ISBE). Para mantener el toolkit doctrinalmente puro, derivamos los datos del Insight oficial Watch Tower, así la cronología refleja la postura JW (p. ej. destrucción de Jerusalén en 607 a.E.C., NO en 587/586 a.E.C. del consenso académico).

Atribución

Los datos generados localmente son derivados del Estudio Perspicaz de las Escrituras (Insight on the Scriptures), © Watch Tower Bible and Tract Society of Pennsylvania. El toolkit no redistribuye texto ni media; solo procesa el JWPUB que el usuario descarga oficialmente de jw.org.

Schema añadido

F58 amplía el tj domain de jw-brain:

Nodos: Period, Passage (nuevos). Person, Place ya existían en F49.
Edges: LIVED_IN_PERIOD, ACTIVE_IN_PERIOD, MENTIONED_IN_PASSAGE, LOCATED_IN_PASSAGE, PASSAGE_BELONGS_TO_PERIOD.

Pipeline

BibleLoader.import_periods() — hidrata 10 nodos Period desde catálogo curado en código (period_catalog.py). Mutable solo editando ese archivo.
BibleLoader.import_insight(jwpub_path) — parsea cabezales del Insight, clasifica por catálogo (PERSON_HEADWORDS/PLACE_HEADWORDS), extrae primera-mención por regex sobre <a class="b">, emite Person/Place/ Passage con edges MENTIONED_IN_PASSAGE/LOCATED_IN_PASSAGE.

Uso

# 1) Inicializa un brain (si no existe)
jw brain init --domain tj --brain personal --vault ~/obs/jw

# 2) Importa solo el catálogo de periodos (siempre primero)
jw brain import-bible --brain personal --periods-only

# 3) Importa el Insight (descargado de jw.org)
jw brain import-bible --brain personal --insight ~/jwpubs/it_S.jwpub --symbol it --meps-language 3

Queries habilitadas

Con el grafo poblado, queries antes imposibles ahora funcionan:

¿Qué personas se mencionan en el libro de Génesis?
→ MATCH (p:Person)-[:MENTIONED_IN_PASSAGE]->(pa:Passage) WHERE pa.book_num=1 RETURN p.name
¿Qué lugares estuvieron activos durante el Cautiverio Babilónico?
→ MATCH (pl:Place)-[:ACTIVE_IN_PERIOD]->(p:Period) WHERE p.slug='babylonian_exile' RETURN pl.name
¿Qué pasajes mencionan tanto a Abraham como a Jerusalén?
(combinación de dos hops, ver tests/test_imports_bible_e2e.py)

Idempotencia

import-bible es idempotente por canonical_id (person:abraham, place:jerusalem, period:patriarchal, passage:1:11:26). Re-correr sobre el mismo JWPUB no duplica nodos ni edges.

Auditar cobertura sobre el Insight completo (F58.14)

El catálogo built-in expandido (EXPANDED_PERSON_HEADWORDS + EXPANDED_PLACE_HEADWORDS) cubre ~250 personas y ~150 lugares del canon bíblico común (ES + EN). Para auditar qué fracción del Insight del usuario cubre el built-in, usa:

jw brain learn-headwords --brain personal --insight ~/jwpubs/it_S.jwpub

Esto extrae los cabezales (title) de cada documento del JWPUB y los persiste localmente en <brain>/extracted_headwords.json. La salida JSON incluye coverage_pct — la fracción del Insight cubierta por el built-in.

Privacidad/copyright: la extracción se queda en la máquina del usuario. El toolkit no redistribuye ni sincroniza este archivo. El JWPUB debe haberse descargado oficialmente de jw.org.

Limitaciones

Catálogo built-in cubre ~250 personas y ~150 lugares del canon bíblico común (figuras y geografías mencionadas en NWT, formas ES + EN). No pretende ser exhaustivo de las miles de entradas del Insight. Para auditar tu cobertura ejecuta jw brain learn-headwords --insight <jwpub> (no redistribuye contenido).
Conceptos teológicos (Trinidad, Reino, Espíritu Santo) no se importan como nodos — son artículos del Insight, pero no encajan en el schema Person/Place/Period/Passage y van a otro flujo (RAG semántico).
✅ Geocoordenadas de 16 lugares principales (Jerusalem, Babylon, Rome, Athens, Ephesus, Antioch, etc.) hidratadas desde place_catalog.py. Los lugares fuera del catálogo se upsertan sin coordenadas.