⚖️ Open Legal Chile

Infraestructura Abierta de Inteligencia Jurídica, Servidor MCP y Conectores Oficiales para el Ordenamiento Jurídico de la República de Chile

📑 Tabla de Contenidos

1. 🌟 Visión, Filosofía y Soberanía Jurídica
2. 🏗️ Arquitectura del Ecosistema
3. ⚡ Instalación y Puesta en Marcha
4. 🔌 Catálogo Exhaustivo de Herramientas MCP (87 Herramientas)
5. 🏛️ Los 10 Conectores Oficiales del Estado de Chile
6. 📚 La Base Doctrinal Canónica y la Dimensión Procesal Forense
7. ⚖️ Módulos Forenses y Pedagógicos de Especialidad
8. 🧠 Catálogo de Skills y Subagentes (18 Especialidades)
9. 💻 Guía Completa de la Consola CLI (openlegal)
10. 🛡️ Certificación de Auditoría Institucional 360° (AUDIT.md)
11. 🧪 Pruebas Automatizadas y Verificación Continua
12. 📜 Licencia, Ética Forense y Responsabilidad Profesional
13. 🌱 Cómo Contribuir

🌟 1. Visión, Filosofía y Soberanía Jurídica

Open Legal Chile es una infraestructura de software de código abierto diseñada para transformar la práctica legal, la docencia universitaria y la investigación forense en la República de Chile.

A diferencia de los modelos de inteligencia artificial genéricos y comerciales diseñados bajo la óptica del Common Law anglosajón, Open Legal Chile fue concebido desde sus cimientos para el Sistema de Derecho Continental (Civil Law) chileno:

🏛️ Principios Fundamentales del Sistema Jurídico Chileno

• Primacía de la Ley Escrita: La ley es una declaración de la voluntad soberana que, manifestada en la forma prescrita por la Constitución, manda, prohíbe o permite (Art. 1 del Código Civil).
• Efecto Relativo de las Sentencias: Las sentencias judiciales no tienen fuerza obligatoria sino respecto de las causas en que actualmente se pronunciaren (Art. 3 inc. 2 del Código Civil). No rige el precedente vinculante anglosajón (stare decisis), pero la unificación jurisprudencial de la Corte Suprema y la doctrina administrativa de la Contraloría (CGR) y la Dirección del Trabajo (DT) fijan los criterios rectores del ordenamiento.
• Prohibición Absoluta de Anglicismos y Figuras Foráneas: Queda terminantemente vetada la extrapolación de conceptos ajenos a la tradición procesal chilena (at-will employment, punitive damages, discovery, subpoena, grand jury, deposition, Title VII, FLSA). Se emplea exclusivamente el léxico forense y sustantivo chileno (necesidades de la empresa, finiquito con reserva de derechos, fuero laboral, tutela de derechos fundamentales, daño moral, daño emergente, lucro cesante, otrosí, reposición, apelación, casación en la forma y en el fondo, presuma OJV).
• Estándar Obligatorio de Citación Oficial:
  • Ley o Código: [BCN - Código Civil, Art. 1545] o [BCN - Ley N° 21.643 Ley Karin, Art. 2]
  • Constitución: [BCN - CPR, Art. 19 N° 1]
  • Fallo Corte Suprema: [CS - Rol N° 12.345-2023, Fecha: 15-11-2023]
  • Dictamen DT: [Dictamen DT N° 1234/15 de 2024]
  • Dictamen CGR: [Dictamen CGR N° E123456 (2024)]
  • Circular SII: [Circular SII N° 45 (2023)]
  • Norma CMF: [NCG CMF N° 461]

🛡️ Soberanía Tecnológica y Secreto Profesional ($0 y Cero API Keys)

El ejercicio del Derecho exige reserva y confidencialidad absoluta:

1. 100% Gratuito y Libre: No requiere licencias comerciales, tokens de pago ni tarjetas de crédito.
2. Cero Fuga de Datos (Zero Data Leak): El Motor Soberano Local y los modelos abiertos vía Ollama (llama3.2, deepseek-r1, qwen2.5) procesan causas, contratos y escritos judicialmente confidenciales de manera 100% local en tu propio computador, preservando el secreto profesional (Art. 247 del Código Penal) y la Ley N° 19.628 sobre Protección de la Vida Privada.
3. Acceso Público a Fuentes del Estado: Las conexiones con la BCN, CGR, DT, PJUD, CNE, CMF, SII, SMA y TDLC operan contra repositorios públicos abiertos del Estado de Chile sin necesidad de registro ni llaves de pago.

🎨 Diseño Legal (Legal Design)

Open Legal Chile adopta los principios del Legal Design Manifesto (Ducato, Haapio, Hagan, Palmirani, Passera y Rossi) y del trabajo del Stanford Legal Design Lab (Margaret Hagan): el derecho se escribe para quien tiene que usarlo, no para quien lo redacta. Los 25 principios y su traducción a reglas verificables de este repositorio están en docs/legal_design.md; la lista corta para revisar una skill, una herramienta o un documento antes de publicarlo está en docs/legal_design_checklist.md.

Dos ejemplos concretos de cómo se aplica acá:

• Compuerta de revisión humana en las 18 skills. Cada SKILL.md de .agents/skills/ declara para quién escribe, cómo se ve su salida y su compuerta de revisión; ninguna promete un producto «listo para presentar». Se verifica corriendo .venv/bin/python -m pytest tests/test_legal_design.py -q.
• Lenguaje claro, no declarado sino hecho. La clínica traduce resoluciones a español llano: clinica_juridica.py convierte «téngase presente» en «el tribunal leyó su documento y lo dejó registrado en la carpeta del juicio». La misma regla —término técnico con su equivalencia simple entre paréntesis la primera vez— rige para todo texto que lee una persona.

🏗️ 2. Arquitectura del Ecosistema

La suite opera bajo el estándar internacional Model Context Protocol (MCP), permitiendo a cualquier agente o entorno interactuar con la infraestructura jurídica chilena:

┌─────────────────────────────────────────────────────────────────────────────────────────┐
│                           CLIENTES Y AGENTES DE IA SOPORTADOS                           │
│                                                                                         │
│   Google Antigravity      Claude Code (CLI)      Claude Desktop      Cursor / VS Code   │
│   (Google AI Pro)         (Anthropic)            (Cowork)            (Codex / Roo Code) │
└────────────────────────────────────────┬────────────────────────────────────────────────┘
                                         │ JSON-RPC 2.0 (stdio)
┌────────────────────────────────────────▼────────────────────────────────────────────────┐
│                       SERVIDOR MAESTRO MCP (mcp_server.py)                              │
│                                                                                         │
│   • 87 Herramientas Forenses Registradas (Suite Edition)                         │
│   • Motor de Agentes Jurídicos Autónomos Soberanos (agents_runtime.py)                  │
│   • Generador Estandarizado de Recursos de Protección OJV (recurso_proteccion.py)       │
│   • Knowledge Graph Jurídico y Ahorro de Tokens (legal_graphify.py)                     │
│   • Telemetría Ética de Adopción y Auto-Actualización (stats_tracker.py, update_checker.py)│
│   • Motor de Estudio de Títulos Decenal CBR (cbr_titles.py)                              │
│   • Auditor de Mandatos Judiciales Art. 7 CPC (cbr_titles.py)                            │
│   • Deconstructor Estructural de Sentencias Art. 170 CPC (sentencias_parser.py)         │
│   • Validador Oficial de RUT y Directorio de Órganos Públicos (entes_publicos.py)       │
│   • Guías Oficiales de la Academia Judicial de Chile (academia_judicial_connector.py)   │
│   • Sincronizador de Biblioteca Online y Datasets Markdown (online_library_sync.py)     │
│   • Motor de Doctrina Canónica FTS5 BM25 (doctrina_connector.py)                        │
│   • Motor de Crítica Forense en 5 Dimensiones (critique.py)                             │
│   • Vigilante de Proveídos y Plazos Fatales OJV (docket_watcher.py)                     │
│   • Simulador Socrático de Examen de Grado (examen_grado.py)                            │
│   • Asistente Social de Clínica Jurídica y Lenguaje Claro (clinica_juridica.py)         │
│   • Módulo de Peritaje OCR y Compilador de Expedientes A4 (pdf_dossier_compiler.py)     │
│   • Modelador de Grafos de Vínculos y Probidad Pública (grafo_vinculos.py)              │
│   • Exportador Forense OJV Ley N° 20.886 (exporters.py)                                 │
└────────────────────────────────────────┬────────────────────────────────────────────────┘
                                         │ Consultas Locales y Red Oficial
┌────────────────────────────────────────▼────────────────────────────────────────────────┐
│                     10 CONECTORES OFICIALES DEL ESTADO DE CHILE                         │
│                                                                                         │
│   [BCN Ley Chile XML]   [Contraloría CGR]   [Dirección del Trabajo DT]  [PJUD / Suprema]│
│   [Tribunal Const.]     [CNE Energía]       [Panel de Expertos]         [CMF Valores]   │
│   [SII Tributario]      [SMA SNIFA Ambient] [TDLC Libre Competencia]                    │
└─────────────────────────────────────────────────────────────────────────────────────────┘

⚡ 3. Instalación y Puesta en Marcha

[!TIP] ¿Deseas instalar Open Legal Chile como Plugin en 1-Click o 1-Comando?
Consulta la guía detallada en PLUGINS.md para Claude Code, Cursor, VS Code, Cline y Smithery.ai.

Instalación en un comando

pip install openlegal-chile && openlegal instalar

openlegal instalar detecta tu harness en la carpeta (Claude Code, Cursor, VS Code, dsh, Codex, Antigravity), escribe su configuración MCP fusionando con lo que ya tenías (con respaldo .bak) y te deja el estado verificado con openlegal doctor. Para agentes, openlegal instalar --json devuelve el mismo resumen en JSON, y desde el harness está la herramienta suite_instalar.

Las otras vías —plugin nativo de Claude Code, autodetección de Cursor / VS Code / Cline, Smithery.ai, instalación desde el código fuente y el mcp_config.json de Antigravity— están en PLUGINS.md. El detalle por cliente —y cómo verificar que el harness ve las herramientas— está en docs/integracion-harness.md.

El paquete incluye el corpus doctrinal (228 documentos chilenos en Markdown: doctrina, apuntes, materiales docentes y guías de la Academia Judicial) y el grafo de conocimiento ya construido, así que graphify_* y doctrina_search funcionan sin clonar nada más. El índice FTS5 de doctrina se construye solo en la primera búsqueda (unos segundos). Si instalas solo los módulos (por ejemplo copiando archivos sueltos), el motor lo dirá en vez de responder "no encontrado" a todo: esa fue la falla silenciosa de las versiones anteriores a la 1.5.4.

Para leer documentos escaneados o fotografiados (boletas, escrituras, expedientes) no hay nada que instalar aparte: el OCR viaja dentro del paquete (RapidOCR). pip install openlegal-chile deja el motor robusto listo, sin extras ni comandos adicionales. Tesseract queda como respaldo del sistema operativo: sirve para escaneos limpios pero falla con fotos torcidas o de baja resolución (en pruebas con dos boletas notariales fotografiadas: 0 caracteres con Tesseract a cualquier rotación, 553 y 525 caracteres con RapidOCR). El extractor informa siempre qué motor usó y, si una página no rinde texto, lo advierte en vez de reportar éxito. Para ver qué quedó instalado:

openlegal doctor

Además, openlegal ocr <documento.pdf> [--contexto "expediente con plazo corriendo"] recomienda —con razonamiento chileno— cómo extraerlo: nativo si ya trae capa de texto; si está escaneado, el motor y el DPI según el tipo (expediente, escritura notarial, sentencia antigua, documento administrativo, tabla) y doble pasada cuando hay plazos en juego (art. 66 CPC). La misma recomendación está en el MCP como ocr_plan_documento.

⚙️ Modos de Inferencia: Soberano vs. Modelos Externos

Open Legal Chile opera por defecto en Modo Soberano (100% gratuito y sin enviar datos al exterior):

• Motor Soberano: Se activa automáticamente sin necesidad de configurar claves.
• Ollama Local (Opcional): Si tienes Ollama corriendo en localhost:11434, la suite detecta y utiliza tus modelos locales de forma inmediata.
• Proveedores Comerciales (Opcionales): Si decides voluntariamente conectar APIs comerciales de pago, puedes configurar las variables en tu archivo .env:
  bash

  Copy

  # Totalmente opcionales (el sistema funciona al 100% sin ellas)
  ANTHROPIC_API_KEY="sk-ant-..."
  GEMINI_API_KEY="AIzaSy..."
  DEEPSEEK_API_KEY="sk-..."
  OPENAI_API_KEY="sk-..."
  

🌐 El corpus publicado en Hugging Face

Todo el corpus vive en el dataset público pablobenavidesj/doctrina-jurisprudencia-chile, en Markdown y con índices para agentes (llms.txt):

Cada obra trae al final un bloque «Véase también» con sus conexiones medidas (grafo de citas, normas compartidas y guías que la usan). La cita oficial es [BCN - Código, Art. N], siempre con el texto literal del artículo; el detalle del grafo está en docs/grafo.md y la medición del ahorro en docs/medicion_tokens.md.

🔌 4. Catálogo Exhaustivo de Herramientas MCP (87 Herramientas Oficiales)

El servidor MCP expone 87 herramientas oficiales categorizadas funcionalmente:

A. Legislación y Códigos de la República

B. Jurisprudencia y Dictámenes Vinculantes

C. Regulación Sectorial e Instituciones Públicas

D. Doctrina Dogmática y Dimensión Procesal Forense

E. Docencia y Examen de Grado

F. Vigilancia Procesal y Proveídos Judiciales

G. Clínica Jurídica y Lenguaje Claro

H. Transparencia, Probidad y Modelado de Redes

I. Peritaje Documental y Tramitación OJV

J. Privacidad (ARCO) y Propiedad Industrial (INAPI)

K. Investigación Analítica Asistida (Google NotebookLM)

L. Práctica Forense Inmobiliaria, Títulos CBR y Mandato Judicial

M. Derecho Intertemporal y Consultas BCN Históricas

N. Sector Público, Regulación y Verificación de RUT

O. Análisis Forense de Sentencias Judiciales y Proveídos OJV

P. Resoluciones Administrativas y Tribunales Especiales

Q. Academia Judicial de Chile y Biblioteca Online de Markdown

R. Telemetría Ética, Métricas de Adopción y Actualizaciones Automáticas

S. Knowledge Graph Jurídico y Optimización de Tokens (el motor interno legal_graphify.py)

T. Recursos Constitucionales y Estandarización OJV

U. Ecosistema de Agentes Jurídicos Autónomos

V. Mesa de Entrada de Casos

• caso_analizar: recibe una carpeta de expediente, un texto o una consulta en lenguaje natural y devuelve un plan —materia, fuero probable, instituciones, herramientas en orden con su por qué, y lo que falta—. No modifica nada ni consulta servicios externos. La materia la decide con reglas (Rol/RIT y palabras clave chilenas), no adivinando.
• caso_ejecutar: ejecuta ese plan contra las fuentes reales (BCN, PJUD, CGR, DT, SII, CMF, SMA, doctrina indexada y los documentos de la carpeta). Cada paso informa su estado; uno que falla queda anotado con su error y uno sin parámetros se saltea con su motivo. Nunca devuelve un resultado inventado.

🏛️ 5. Los 10 Conectores Oficiales del Estado de Chile

Cada conector fue desarrollado para comunicarse directamente con las plataformas públicas del Estado, almacenando respuestas en una base de datos local SQLite (openlegal_cache.db) para garantizar velocidad y funcionamiento offline:

1. 📜 Biblioteca del Congreso Nacional (BCN Ley Chile):
   • Mecanismo: Consulta directa al portal público XML de la BCN (leychile.cl/Consulta/obtxml).
   • Cobertura: Toda la legislación de la República y los 9 Códigos positivos actualizados en tiempo real. No requiere registro ni API key.
2. 🏛️ Contraloría General de la República (CGR):
   • Mecanismo: API REST abierta de jurisprudencia administrativa.
   • Cobertura: Más de 50.000 dictámenes sobre confianza legítima a contrata, estatuto administrativo y probidad, más 9.600 Informes de Auditoría.
3. 💼 Dirección del Trabajo (DT):
   • Mecanismo: Catálogo institucional abierto de dictámenes y pronunciamientos doctrinales.
   • Cobertura: Jurisprudencia vinculante sobre despidos (Art. 161), Ley Karin (Ley 21.643), reducción de jornada 40 Horas (Ley 21.561) y finiquitos.
4. ⚖️ Poder Judicial (PJUD) & Corte Suprema:
   • Mecanismo: Base estructurada local (jurisprudencia_judicial.db) con indexación de fallos rectores.
   • Cobertura: Sentencias de Unificación de Doctrina Laboral (Art. 483 CT), Recursos de Protección y Casación Civil.
5. 🛡️ Tribunal Constitucional (TC):
   • Mecanismo: Repositorio de requerimientos de inaplicabilidad por inconstitucionalidad (Art. 93 N° 6 CPR) y sentencias de inconstitucionalidad (Art. 93 N° 7 CPR).
6. ⚡ Comisión Nacional de Energía (CNE):
   • Mecanismo: Portal de Datos Abiertos Energía Abierta.
   • Cobertura: Capacidad instalada (MW), 1.342 centrales generadoras, 3.754 proyectos en el Sistema de Evaluación de Impacto Ambiental (SEA).
7. 🔌 Panel de Expertos de la Ley Eléctrica:
   • Mecanismo: API pública de discrepancias técnicas y tarifarias.
   • Cobertura: Dictámenes vinculantes e inapelables sobre la Ley General de Servicios Eléctricos (DFL 4/2006).
8. 🏢 Comisión para el Mercado Financiero (CMF):
   • Mecanismo: Servicio público de consulta normativa.
   • Cobertura: Normas de Carácter General (NCG 461, gobiernos corporativos, sostenibilidad) y circulares del mercado bancario y de valores.
9. 💰 Servicio de Impuestos Internos (SII):
   • Mecanismo: Índice oficial de resoluciones y circulares tributarias (2020 a 2026).
10. 🌱 Superintendencia del Medio Ambiente (SMA / SNIFA):
    • Mecanismo: Sistema Nacional de Información de Fiscalización Ambiental (SNIFA).
    • Cobertura: Expedientes sancionatorios ambientales y Programas de Cumplimiento (PdC).

📚 6. La Base Doctrinal Canónica y la Dimensión Procesal Forense

En la tradición jurídica chilena, un manual o tratado nunca es un compendio puramente teórico o abstracto: no hay derecho subjetivo sin acción procesal que lo tutele.

Open Legal Chile cuenta con una base dogmática de tratados canónicos indexados en SQLite con búsqueda de texto completo FTS5 y ranking BM25 (doctrina.db):

📖 Tratadistas Canónicos Digitalizados

• Teoría General del Acto Jurídico: Víctor Vial del Río
• Derecho Sucesorio y Partición: Manuel Somarriva Undurraga
• Obligaciones y Derecho de Familia: René Ramos Pazos
• Los Contratos (Parte General): Jorge López Santa María
• Bienes y Derechos Reales: Daniel Peñailillo Arévalo
• Responsabilidad Extracontractual: Enrique Barros Bourie
• Derecho Comercial, Sociedades (SpA) e Insolvencia: Ricardo Sandoval López
• Bases Fundamentales del Derecho Administrativo: Eduardo Soto Kloss
• Derecho Administrativo General: Jorge Bermúdez Soto
• Disposiciones Comunes y Juicio Ordinario: Alejandro Romero Seguel y Fernando Orellana Torres
• Teoría General de los Recursos Procesales: Mario Mosquera Ruiz y Cristián Maturana Miquel
• Derecho Penal (Parte General): Enrique Cury Urzúa
• Derecho del Trabajo y Relaciones Laborales: Sergio Gamonal Contreras
• Derecho Constitucional y Acciones: José Luis Cea Egaña
• Buenas Prácticas Judiciales y Formación: Academia Judicial de Chile (21 Guías Oficiales)

🏛️ Los 7 Pilares de la Dimensión Procesal Forense

Cada institución doctrinal no solo define el instituto, sino que detalla su aplicación práctica en tribunales:

1. Vía Procesal / Tipo de Procedimiento: Juicio Ordinario de Mayor Cuantía (Art. 254 CPC), Juicio Sumario (Art. 680 CPC), Juicio Ejecutivo (Art. 434 CPC), Tutela Laboral (Art. 485 CT), Recurso de Protección (Art. 20 CPR).
2. Tribunal Competente: Reglas de competencia absoluta (materia, cuantía, fuero) y relativa (territorio) del Código Orgánico de Tribunales (COT).
3. Legitimación Procesal: Quién puede demandar (legitimación activa: ej. dueño, poseedor regular en acción publiciana Art. 894 CC, trabajador, sindicato) y contra quién se dirige la pretensión (legitimación pasiva).
4. Carga Probatoria (Onus Probandi): Asignación de la prueba según el Art. 1698 del Código Civil, estándar de prueba tasada vs. sana crítica, y prueba por indicios (Art. 493 CT).
5. Medidas Precautorias y Cautelares: Medidas prejudiciales (Arts. 273 y 279 CPC) y precautorias de aseguramiento del Art. 290 del CPC (secuestro, interventor, retención y prohibición de celebrar actos y contratos).
6. Plazos Fatales y Términos Probatorios: Emplazamiento (15/18 días + tabla), términos probatorios (20 días ordinario, 8 días sumario, 10 días ejecutivo) y plazos de recursos (apelación 5/10 días, casación 15 días, protección 30 días corridos).
7. Defensas y Excepciones Típicas: Excepciones dilatorias (Art. 303 CPC), excepciones de fondo y perentorias (exceptio non adimpleti contractus Art. 1552 CC, caducidad, prescripción extintiva).

💡 Optimización de Tokens Medida (mediana 99,9 %; ficha 91 tokens vs. obra 96.536)

Mediante el compilador scripts/doctrina_parser.py, los textos crudos y transcripciones doctrinales son depurados de ruido editorial y convertidos en Markdown de Alta Densidad Dogmática para alimentar el grafo. Ese compilador no promete un ahorro propio: los ahorros que publica este proyecto son los del grafo al consultar un subgrafo en vez de la obra completa, y se miden, no se estiman — ver docs/medicion_tokens.md.

⚖️ 7. Módulos Forenses y Pedagógicos de Especialidad

🔍 A. Motor de Crítica Forense en 5 Dimensiones (critique.py)

Inspirado en los mecanismos de auto-revisión y auditoría de calidad de escritos judiciales, evalúa borradores en 5 dimensiones obligatorias:

1. Jerarquía Normativa y Legalidad: Comprueba conformidad con la Constitución y leyes vigentes, purga de terminología de Common Law y estándar de citación oficial.
2. Doctrina y Jurisprudencia Aplicable: Exige fundamentación en los criterios rectores de la Corte Suprema, CGR o DT.
3. Estructura Forense OJV (Ley N° 20.886): Fiscaliza la presencia de presuma, comparecencia, relación fáctica, fundamentación de derecho, petitorio y otrosíes.
4. Coherencia Fáctica y Carga Probatoria (Art. 1698 CC): Evalúa la congruencia entre hechos afirmados y la pretensión deducida.
5. Compuertas Éticas y Plazos Fatales: Advierte sobre riesgos de preclusión y exige la validación humana de un abogado habilitado.

⏱️ B. Vigilante Procesal de Proveídos (docket_watcher.py)

Automatiza el control procesal del despacho:

• Lectura de Proveídos: Detecta y clasifica resoluciones judiciales de la OJV ("traslado", "autos para resolver", "téngase por contestada", "recibida la causa a prueba").
• Cómputo de Plazos Fatales: Calcula automáticamente el vencimiento de plazos en días hábiles judiciales (excluyendo domingos y feriados conforme al Art. 66 del CPC).
• Vigilancia Contractual: Monitorea ventanas críticas de desahucio y preaviso en contratos civiles y comerciales.

🎓 C. Simulador Socrático de Examen de Grado (examen_grado.py)

Diseñado para la preparación rigurosa del examen final de licenciatura en Derecho:

• Interrogador Dinámico: Plantea preguntas doctrinales y contrapreguntas socráticas exigiendo exactitud conceptual.
• Generador de Cédulas: Genera cédulas completas por materia (Derecho Civil y Derecho Procesal) con pauta de corrección para el docente.
• Flashcards Mnemotécnicas: Fichas de estudio rápido con definiciones sacramentales y plazos procesales fatales.

🤝 D. Clínica Jurídica y Lenguaje Claro (clinica_juridica.py)

Herramienta de vinculación con el medio y asistencia judicial social:

• Traductor a Lenguaje Claro: Transforma resoluciones judiciales densas en explicaciones accesibles y pedagógicas para usuarios de escasos recursos.
• Triaje Social de Casos: Fichas de ingreso estructuradas para causas de alimentos, violencia intrafamiliar y juicios de precario.
• Auditoría de Pasantes: Revisa formalmente los escritos de estudiantes en práctica antes del visado y firma del abogado tutor.

🌐 E. Modelado de Redes y Probidad Pública (grafo_vinculos.py e infoprobidad_connector.py)

• Extracción InfoProbidad: Parsea Declaraciones de Intereses y Patrimonio (DIP) bajo la Ley N° 20.880.
• Grafos de Vínculos: Modela relaciones societarias, vínculos familiares y relaciones contractuales con el Estado en diagramas Mermaid y estructuras JSON.

📑 F. Peritaje OCR y Compilador de Expedientes (forensic_ocr.py y pdf_dossier_compiler.py)

• OCR Pericial: Extracción de texto de fojas escaneadas con preservación de fidelidad documental.
• Compilador A4 Foliado: Ensambla demandas, recursos y anexos probatorios en un expediente único con carátula institucional y foliado electrónico.

🏡 G. Estudio de Títulos Inmobiliarios, CBR y Mandato Judicial (cbr_titles.py)

• Estudio Decenal de Dominio (10 años): Reglas de prescripción adquisitiva extraordinaria (Arts. 2510 y 2511 Código Civil), saneamiento de vicios y auditoría de los 4 registros del CBR (Propiedad, Hipotecas y Gravámenes, Interdicciones y Prohibiciones, Repertorio).
• Detección de Banderas Rojas: Alerta automática sobre rupturas en la tradición, falta de posesión efectiva o de inscripción especial de herencia (Art. 688 CC), embargos y medidas precautorias.
• Auditoría de Mandatos Judiciales (Ley N° 18.120 y Art. 7 CPC): Verificación de patrocinio habilitado y comprobación expresa de las facultades extraordinarias del Art. 7 inc. 2 CPC (desistirse, transigir, percibir, comprometer).

⚖️ H. Analizador Estructural de Sentencias y Proveídos OJV (sentencias_parser.py)

• Desglose Estructural Art. 170 CPC: Segmentación automática de sentencias conforme al Auto Acordado de 1907 (parte expositiva, considerandos de hecho y considerandos de derecho, parte resolutiva y votos disidentes o prevenciones).
• Régimen de Costas (Art. 144 CPC): Detección de condena total o exención por haber litigado con motivo plausible.
• Intérprete de Proveídos OJV: Análisis de cargas procesales y efectos jurídicos de decretos de mera tramitación ("Téngase presente", "Como se pide", "Traslado", "Autos para fallo").

🌿 I. Tribunales Ambientales y Compendios de Jurisprudencia (tribunales_ambientales_connector.py)

• Los 3 Tribunales Ambientales (Ley N° 20.600): Cobertura del 1TA (Antofagasta), 2TA (Santiago) y 3TA (Valdivia).
• Compendios Anuales de Jurisprudencia Ambiental: Catálogo y buscador de anuarios y criterios sistematizados sobre demandas por Daño Ambiental (Art. 17 N° 2), reclamaciones contra la SMA (Art. 17 N° 1 y 3) y humedales urbanos (Ley N° 21.202).

🏛️ J. Academia Judicial de Chile y Biblioteca Online de Markdown (academia_judicial_connector.py y online_library_sync.py)

• Guías Oficiales de Formación Judicial: Ingesta y consulta de las 22+ guías oficiales de guias.academiajudicial.cl (Penal, Determinación de Penas, Preparación de Juicio Oral, Familia, Laboral, Ética e Inteligencia Artificial en tribunales).
• Biblioteca Online en Markdown: Publicación y empaquetado gratuito del corpus para Hugging Face Datasets (pablobenavidesj/doctrina-jurisprudencia-chile), releases comprimidos de GitHub y carpetas estructuradas para Google Drive y Google NotebookLM.
• Catálogo eficiente para agentes (2026-09-25): el dataset suma llms.txt (mapa del corpus y formato de cita), data/catalogo/instituciones_lite.jsonl (fichas sin el texto íntegro: 11,5 MB en vez de 83,6 MB), data/catalogo/train_lite.jsonl (índice de obras: 0,1 MB en vez de 74,9 MB), data/catalogo/indice_citas.jsonl (documento · secciones · enlace directo para citas a pie de página) y data/catalogo/indice_agentes.json (rutas «tema → archivo»).
• Textos íntegros nuevos (2026-09-25): jurisprudencia_tc/ con las 966 sentencias del Tribunal Constitucional de los últimos dos años en Markdown (ficha de cita + texto completo, descargadas del buscador oficial) y publicaciones_ambientales/ con los anuarios y boletines de los Tribunales Ambientales (78 publicaciones). Se convierten con scripts/tc_pdfs_a_md.py y scripts/publicaciones_a_md.py.
• Dataset de entrenamiento aparte: las versiones plenas (train.jsonl 74,9 MB e instituciones.jsonl 83,6 MB) viven en pablobenavidesj/doctrina-jurisprudencia-chile-training; el dataset principal quedó en ~168 MB con el corpus íntegro en doctrina/ y las versiones «puntero».
• Jurisprudencia ampliada (2026-09-25): 886 sentencias de los Tribunales Ambientales (1TA 111 · 2TA 441 · 3TA 334), 78 publicaciones oficiales de jurisprudencia ambiental (anuarios y boletines 2TA/3TA), 70 523 sentencias de la Corte Suprema y 966 del Tribunal Constitucional de los últimos dos años, con rol, sala, fecha, recurso, resultado y ministros (los textos de la Suprema quedan bajo sesión PJUD; el TC incluye enlace al PDF oficial).
• Biblioteca ambiental (2026-09-28): colección nueva biblioteca_ambiental/ con 87 documentos convertidos a Markdown —los 6 libros del Concurso Nacional de Comentarios de Sentencias, los 14 informes en derecho de los Tribunales Ambientales, los foros, manuales y material docente— más los anuarios y boletines al día (78 publicaciones). El módulo especial ambiental_consulta_maestra (herramienta 87) consulta todo junto con openlegal ambiental "…".

🧠 K. El grafo interno: reducción de tokens con conocimiento conectado (legal_graphify.py)

• Grafo Multidimensional de Dogmática Jurídica: 14.050 nodos interconectados (instituciones dogmáticas, artículos de los Códigos BCN, fallos rectores de la Corte Suprema y del Tribunal Constitucional, publicaciones de los Tribunales Ambientales, biblioteca ambiental y tratadistas canónicos) y 31.017 aristas relacionales (52 comunidades, modularidad 0,641).
• Ahorro de Tokens Medido (mediana 99,9 %; medición 2026-09-28 sobre 9.863 instituciones): En lugar de inyectar la obra doctrinal completa (mediana 96.536 tokens; máximo 313.985), el motor extrae un subgrafo conexo hiper-denso de 27 a 544 tokens (mediana 91) en formato estructurado (definición canónica, artículos concordantes, criterio CS rector y operativa procesal forense). Medición reproducible con .venv/bin/python scripts/medir_ahorro_tokens.py → docs/medicion_tokens.md.
• Diagramas Mermaid en Vivo: Generación de diagramas de flujo relacional para visualizar el razonamiento dogmático de cada institución en tiempo real.
• Integración con Graphify (grafo de código + grafo jurídico): Cómo se fusionan ambos grafos, qué se midió y por qué no se mantiene un fork, en docs/integracion_graphify.md.
• Comando CLI y Herramienta MCP: Disponible como openlegal graph "concepto" y mediante la herramienta MCP graphify_consulta_subgrafo. Compatible con Graphify Labs CLI (python -m graphify query "...") y exportación interactiva a navegador (graphify-out/graph.html).

🧠 8. Catálogo de Skills y Subagentes (19 Especialidades)

El directorio agents/ incluye 19 perfiles de especialidad jurídica adaptados al sistema continental chileno (importados y des-anglosajonizados de claude-for-legal):

1. chilean-employment-legal (agente-laboral): Despidos (Art. 161/160 CT), Ley Karin (21.643), 40 Horas (21.561), finiquitos y doctrina DT.

2. chilean-litigation-legal (agente-litigios): Demandas OJV Ley N° 20.886, recursos de protección estandarizados (Acta N.° 94-2015), cronología de hechos, recursos procesales y medidas precautorias.

3. chilean-real-estate-cbr (agente-inmobiliario): Estudio de títulos decenal (10 años), tradición dominical, gravámenes hipotecarios, prohibiciones registrales y mandatos judiciales (Art. 7 CPC).

4. chilean-dogmatic-graphify (agente-dogmatico): Estratega de alta dogmática, subsunción técnico-jurídica, el corpus doctrinal completo (228 obras y materiales + 21 guías judiciales) y deducción con subgrafos LegalGraphify (ahorro de tokens mediano: 99,9 %; ficha 91 vs. obra 96.536).

5. chilean-administrative-legal (agente-regulatorio): Dictámenes e informes CGR, compras públicas (Ley 19.886) y vigilancia regulatoria.

6. chilean-energy-legal (agente-energia): Contratos PPA de clientes libres, transmisión eléctrica Ley 20.936 y discrepancias del Panel de Expertos.

7. chilean-environmental-legal (agente-ambiental): Fiscalizaciones SMA (SNIFA), infracciones a RCAs y Programas de Cumplimiento.

8. chilean-contract-legal (agente-contratos): Revisión de contratos, NDAs, cláusula penal (CC) y Ley 19.496 de Protección al Consumidor.

9. chilean-corporate-legal (agente-corporativo): Constitución de SpA (Ley 20.659) y S.A. (18.046), compliance CMF/SII y libre competencia (DL 211).

10. chilean-forensic-evidence (agente-forense): Peritaje documental de expedientes escaneados, OCR PaddleOCR/Tesseract y auditoría red-team.

11. chilean-probity-investigation (agente-probidad): Cruce de declaraciones patrimoniales DIP (InfoProbidad) y conflictos de interés.

12. chilean-dossier-assembly (agente-expedientes): Ensamblaje pericial de expedientes foliados con separadores probatorios y marcadores TOC.

13. chilean-notebooklm-grounding (agente-investigacion-ia): Investigación con citas fidedignas conectada a Google NotebookLM.

14. chilean-socratic-bar-exam (agente-grado): Interrogador socrático para egresados de derecho que preparan su Examen de Grado.

15. chilean-docket-watcher (agente-vigilante): Monitoreo de proveídos de la OJV y cálculo de plazos fatales en días hábiles judiciales.

16. chilean-legal-clinic (agente-clinica): Asistencia jurídica social para consultorios CAJ y traductor a Lenguaje Claro.

17. chilean-privacy-ip (agente-propiedad-datos): Tramitación de Derechos ARCO (Ley 19.628) y factibilidad marcaria ante INAPI.

18. chilean-doctrine-ingestion (agente-ingestor): Asimilación e ingesta de doctrina jurídica chilena, conversión a Markdown canónico RAE/ASALE y sincronización en caliente del Knowledge Graph y SQLite FTS5.

19. chilean-case-intake (agente-mesa): Mesa de entrada de casos: carpeta, texto o consulta → plan de herramientas → ejecución → expediente, con lo que falte declarado y la compuerta de revisión.

🤖 Motor de Agentes Jurídicos Autónomos (agents_runtime.py)

La suite incorpora un runtime de agentes con dos modalidades de ejecución:

1. Modo Determinista Soberano (100 % Offline, Cero API Keys): Pipelines deterministas especializados que resuelven tareas forenses complejas (generación y ensamblaje de recursos de protección, auditoría decenal de títulos CBR, fiscalización DIP CGR, tutelas laborales, asimilación dogmática) utilizando únicamente las herramientas locales de Open Legal Chile sin enviar datos a servidores externos.
2. Modo Asistido por LLM (ReAct Multi-Proveedor): Orquestación de agentes con modelos externos o locales (Ollama, DeepSeek, Claude, Gemini, OpenAI) con ciclos de Pensamiento / Acción / Observación, inyección de doctrina y auto-crítica forense en 5 dimensiones.

💻 9. Guía Completa de la Consola CLI (openlegal)

Open Legal Chile incluye una potente interfaz de línea de comandos accesible mediante openlegal:

# Menú interactivo de la consola (opciones [0] a [18])
openlegal

# Listar agentes jurídicos autónomos disponibles (19 perfiles)
openlegal agent list

# Ejecutar un agente en modo determinista soberano (100 % local)
openlegal agent run litigios "Generar recurso de protección por corte arbitrario de agua potable"
openlegal agent run inmobiliario "Auditar cadena de dominio CBR decenal"
openlegal agent run ingestor /ruta/al/archivo.pdf

# Conversación interactiva con un agente especializado
openlegal agent chat dogmatico

# Exportar perfiles de subagentes para Google Antigravity o Claude Code
openlegal agent export --format antigravity

# Servidor MCP estándar para agentes de IA (87 herramientas)
openlegal mcp

# Chat jurídico interactivo con RAG soberano chileno
openlegal chat

# Búsqueda jurídica universal cruzada en los 10 organismos del Estado
openlegal search "confianza legitima contrata"

# Auditar un escrito bajo las 5 dimensiones forenses
openlegal critique escrito.txt

# Generar un borrador procesal formal OJV
openlegal generate demanda_civil

# Iniciar interrogación socrática para Examen de Grado
openlegal grado civil

# Analizar un proveído judicial y calcular sus plazos fatales
openlegal vigilar "Téngase por contestada la demanda y traslado para réplica"

# Traducir una resolución a Lenguaje Claro para usuarios de consultorio
openlegal clinica "Autos para fallo"

# Tramitar solicitud de Derechos ARCO de datos personales
openlegal arco

# Evaluar viabilidad de marca en INAPI
openlegal inapi "InnoJuris"

# Ejecutar auditoría integral 360° del sistema
openlegal audit

# Exportar escrito formal OJV a HTML, Markdown y JSON
openlegal export

# Búsqueda en los tratados canónicos de Derecho Chileno (FTS5 BM25)
openlegal doctrina "simulacion y error sustancial"

# Consultar las guías de formación de la Academia Judicial
openlegal guias "determinacion de penas"

# El módulo especial de derecho ambiental (sentencias TA, anuarios, boletines y biblioteca)
openlegal ambiental "daño ambiental en humedales urbanos"

# Consultar estadísticas globales de adopción (PyPI / GitHub)
openlegal stats

# Comprobar y ejecutar la auto-actualización de la Suite
openlegal update

# Diagnóstico real de la suite (mide OCR, corpus, grafo, citas y herramientas MCP)
openlegal doctor
openlegal check   # alias del anterior

🛡️ 10. Certificación de Auditoría Institucional 360° (AUDIT.md)

Open Legal Chile está certificado mediante una suite de auditoría integral de 9 capas que se ejecuta tanto localmente como en GitHub Actions:

./audit.sh
# O vía CLI:
openlegal audit

Consulta el informe institucional pormenorizado en AUDIT.md.

🧪 11. Pruebas Automatizadas y Verificación Continua

python3 -m pytest tests/ -v
# ============================== 406 passed ==============================

Las pruebas tardan entre 15 y 60 segundos según la red: varias consultan en vivo portales del Estado (BCN, DT, CGR, PJUD). Las que fallan por eso se saltan con pytest.skip, no se dan por pasadas.

• .github/workflows/ci.yml: Matriz de integración continua en Ubuntu y Windows probando Python 3.10, 3.11, 3.12, 3.13 y 3.14.
• .github/workflows/audit.yml: Auditoría de seguridad y calidad estricta en cada commit y Pull Request.
• .github/workflows/state-api-monitor.yml: Monitor programado diario que verifica la disponibilidad y tiempos de respuesta de los portales del Estado de Chile.
• scripts/bench_rendimiento.py: Benchmarks versionados (arranque MCP, carga del grafo, FTS trigram, consulta ambiental y consulta_maestra) que escriben su serie en docs/bench_rendimiento.md; --comparar imprime los deltas contra la corrida guardada.

📜 12. Licencia, Ética Forense y Responsabilidad Profesional

Licencia Apache 2.0

Open Legal Chile está licenciado bajo la Licencia Apache 2.0 (LICENSE). Permite el uso libre, estudio, modificación y redistribución tanto en ámbitos académicos como profesionales y comerciales.

Compuerta de Validación Profesional Obligatoria

⚖️ Aviso Forense y Deontológico: Open Legal Chile es una infraestructura de asistencia técnica, investigación y docencia. Todo borrador, escrito, dictamen o análisis producido mediante inteligencia artificial debe ser obligatoriamente revisado y refrendado por un abogado habilitado para el ejercicio de la profesión antes de su firma, patrocinio o ingreso formal en la Oficina Judicial Virtual (OJV) o sede administrativa.

🌱 13. Cómo Contribuir

Las contribuciones académicas y técnicas de estudiantes, docentes y abogados son bienvenidas:

1. Revisa la Guía de Contribución y el Código de Conducta.
2. Abre un issue o envía un Pull Request con nuevas fichas doctrinales o mejoras a los conectores.
3. Para sumar nuevas obras a la biblioteca dogmática, utiliza la herramienta scripts/doctrina_parser.py siguiendo el estándar de compresión de tokens.

Desarrollado con vocación pública y rigor dogmático para la comunidad jurídica de la República de Chile.

Citas y formato de entrega

• Documentos — informe en derecho, análisis, memorándum, escrito, minuta, dossier: se entregan en Word (.docx), no en PDF, para que se puedan modificar; las citas van a pie de página, numeradas, con fuente · identificador · enlace.
• Conversación: la respuesta va primero y las citas van al final, después del texto.

Venga la fuente de donde venga —conectores del Estado (BCN, CGR, DT, SII, CMF, SMA, PJUD), doctrina indexada, guías de la Academia Judicial o el corpus de Hugging Face—. Si no hay fuente identificable se dice «sin fuente verificable», y un dato con varias fuentes se cita con todas.

---
Fuentes:
1. [BCN - Código del Trabajo, Art. 161] https://www.bcn.cl/leychile/...
2. [Academia Judicial — Guía para la conducción de la audiencia preparatoria laboral]
3. [Doctrina — Barros Bourie] doctrina/civil/...