Paquete · Librería
jw-brain
Second-brain + Bible Knowledge Graph
Construido en la Fase 49 como compiler que extrae el conocimiento del toolkit a un grafo consultable. La Fase 58 añadió el Bible Knowledge Graph JW-puro — versión propia derivada del Estudio Perspicaz de las Escrituras y NWT, NO portada de catálogos académicos inter-religiosos. Schema extendido con Period y Passage + 5 edges temporales (LIVED_IN_PERIOD, ACTIVE_IN_PERIOD, MENTIONED_IN_PASSAGE, LOCATED_IN_PASSAGE, PASSAGE_BELONGS_TO_PERIOD). Cronología JW estricta: 607 a.E.C. para destrucción de Jerusalén, no 587/586 a.E.C. del consenso académico. Atribución explícita a Watch Tower Bible and Tract Society of Pennsylvania.
Funcionalidades
Lo que hace, en detalle.
Second-brain compiler (F49)
Compiler async dual-backend: DuckDB (zero-config, single-file) o Neo4j (relación-pesada, queries Cypher). Wiki sobre Obsidian con human_edited honored (re-compiles no sobreescriben ediciones manuales). Multi-tenant via registry ~/.jw-brain/registry.toml. BrainDomain plugins via F41 entry-points: TJ builtin + financial fixture.
Bible Knowledge Graph JW-puro (F58)
Schema extendido: Person, Place, Period (nuevo), Passage (nuevo). 5 edges nuevas LIVED_IN_PERIOD, ACTIVE_IN_PERIOD, MENTIONED_IN_PASSAGE, LOCATED_IN_PASSAGE, PASSAGE_BELONGS_TO_PERIOD. Loader procedural (NO LLM): BibleLoader.import_periods() materializa los 10 periodos curados; import_insight(jwpub) parsea cabezales del Insight on the Scriptures con catálogo PERSON_HEADWORDS+EXPANDED_PERSON_HEADWORDS (~250 figuras canon × ES+EN) y PLACE_HEADWORDS+EXPANDED_PLACE_HEADWORDS (~150 lugares × ES+EN).
Place geocoords + Period catalog (F58.13 + F58)
16 lugares principales con lat/lon, region, modern_name y eras_active: Jerusalem (31.78N, 35.24E, Judea), Babylon (32.54N, 44.42E, Mesopotamia, modern_name='Hillah, Iraq'), Rome, Athens, Ephesus, Nazareth, Bethlehem, etc. 10 periodos JW chronology: Era Patriarcal (2018-1657 a.E.C.), Cautiverio Egipcio, Jueces, Reino Unido, Reino Dividido, Cautiverio Babilónico (607-537 a.E.C., NO 587/586), Era Persa, Era Helenística, Era Romana, Era Cristiana Primitiva.
CLI 8 comandos + audit headwords (F58.14)
jw brain {init, compile, query, lint, status, snapshot, list, import-bible, learn-headwords}. import-bible --insight <jwpub> hidrata el grafo desde un JWPUB del Insight. learn-headwords --insight <jwpub> extrae cabezales del JWPUB del usuario y los persiste LOCALMENTE en <brain>/extracted_headwords.json (no se redistribuyen) — útil para auditar cobertura del catálogo built-in contra el Insight completo del usuario. Reporta % cobertura.
MCP tools expuestas (F66)
second_brain_status, second_brain_query, second_brain_compile, second_brain_lint, second_brain_snapshot — exponen el knowledge graph del jw-brain a Claude/Cursor/cualquier cliente MCP. Firma usa brain_path: str (path absoluto). Modo 'degraded' cuando jw-brain no instalado o no hay brain configurado.
Consumer F72 doctrinal-drift
El módulo jw_core.drift.brain_source.chunks_from_brain() lee los Publication nodes de cualquier backend que implemente list_nodes(node_type=...) y los convierte en Chunks aptos para analyze_doctrinal_drift — sin que jw-core dependa de jw-brain. Year extraction prioriza props year/published_year/pub_year y si falta cae a published_date[:4]. Language filter opt-in. Embedding inyectable (cualquier provider compatible F33). Cierra el loop write-read entre el grafo y el análisis diacrónico.
Cobertura legal y atribución
Built-in headword catalogs usan solo nombres del canon bíblico (hechos factuales públicos, no copyright). User-extracted desde JWPUB del usuario se queda LOCAL — el toolkit no redistribuye. Cronología JW (607 a.E.C.) triple-anclada en código, comentarios y guía. Atribución obligatoria Watch Tower Bible and Tract Society of Pennsylvania visible en docs/guias/bible-knowledge-graph.md.
En la práctica
Cuatro líneas.
Resultado verificable.
Inicializa un brain + importa Bible KG + query Cypher-style.
# 1. Init brain TJ
jw brain init --brain personal --vault ~/obs/jw
# 2. Importar periodos + Insight JWPUB
jw brain import-bible --brain personal --periods-only
jw brain import-bible --brain personal \
--insight ~/jwpubs/it_S.jwpub --symbol it --meps-language 3
# 3. Query: qué personas se mencionan en Génesis
jw brain query "¿Qué personas viven en Jerusalén durante el reinado de Ezequías?" --brain personal
# 4. Auditar cobertura del catálogo built-in
jw brain learn-headwords --insight ~/jwpubs/it_S.jwpub --brain personal
# → Built-in catalog covers 1842 / 2873 (64%)API pública
Qué exporta el módulo.
Resumen de los símbolos principales. La referencia exhaustiva cubre cada uno con signature, parámetros y ejemplos.
- Compiler async + GraphBackend Protocol
- DuckDBBackend · Neo4jBackend
- BibleLoader · ALL_PERIODS · ALL_PLACES
- InsightParser · EXPANDED_PERSON_HEADWORDS · EXPANDED_PLACE_HEADWORDS
- CLI 9 comandos + MCP second_brain_* tools
Otros paquetes
Explora el resto del monorepo.
jw-core
El núcleo determinístico
jw-cli
Terminal para mortales
jw-mcp
Puente con tu agente
jw-rag
Recuperación híbrida
jw-agents
Orquestación multipaso + agéntica verificable
jw-finetune
Tu modelo, tus datos
jw-eval
Red de seguridad doctrinal
jw-gen
Generación con difusión, uso personal
jw-meeting-media
Reunión-en-vivo · clean-room
jw-interp
Interpretabilidad mecanicista tri-modelo
jw-meeting-scheduler
Solver de asignaciones + importer organized-app
jw-legal
BrainDomain plugin: casos legales TJ vs Estado