⚖️ Open Legal Harness — DeepSeek + Twenty CRM + Derecho Procesal Chileno

Un arnés agéntico autónomo y distribución para estudios jurídicos y abogados litigantes en Chile. Integra de manera nativa la interfaz oficial del Studio de DeepSeek, el sistema Twenty CRM (56 800+ estrellas en GitHub) adaptado para términos y plazos judiciales bajo el Art. 66 del Código de Procedimiento Civil (CPC), y los complementos Open Legal Chile y Legal Graphify.

🏛️ Capacidades Principales

1. Interfaz Nativa de DeepSeek Studio con CRM Jurídico Integrado:

   • Conserva la paleta oscura oficial (#0b0f17/#151517), la tipografía y el diseño espacial de DeepSeek.
   • Acceso directo persistente en el riel lateral izquierdo: «CRM Jurídico» con distintivo «Twenty».
   • Conmutación fluida entre el espacio de trabajo local chileno y la instancia incrustada de Twenty CRM.

2. Gestión Procesal y Plazos Fatales (Art. 66 CPC & OJV):

   • Cómputo de días hábiles judiciales (de lunes a sábado), suspendiendo domingos y feriados nacionales de Chile (2026/2027).
   • Vencimiento fatal inexcusable fijado a las 23:59:59 hrs en el buzón de la Oficina Judicial Virtual (OJV, Ley N° 20.886).
   • Semáforos de alerta procesal a 72h, 48h y 24h críticas.
   • Objeto personalizado (Custom Object) LegalDeadlines en Twenty CRM.

3. Catálogo de 17 Herramientas Agénticas (Function Calling):

   • Módulo CRM: Búsqueda de clientes, expedientes, actualización de etapas y bitácora.
   • Twenty CRM: Creación de plazos fatales, radar de vencimientos, exportación de causas y estadísticas.
   • Open Legal Chile: Jurisprudencia de la Corte Suprema, textos normativos de la BCN, proveídos OJV y auto-registro de plazos desde resoluciones judiciales (registrar_resolucion_en_twenty).
   • Legal Graphify: Grafos de causas en formatos Mermaid, GraphML (Gephi) y JSON-LD, extractor de entidades (RUT, Rol/RIT, Artículos y Tribunales) y navegación en el grafo dogmático de 967 nodos.

4. Compatibilidad Universal de Modelos de Lenguaje (LLM):

   • Nube: DeepSeek V3 / R1 (https://api.deepseek.com), OpenAI (gpt-4o, o1), Groq, Gemini o Anthropic vía endpoints OpenAI.
   • Local / Privado (100 % confidencial): Ollama (http://localhost:11434/v1), LM Studio, vLLM o LocalAI.
   • Modo autónomo sin LLM: Motor heurístico y relacional con persistencia SQLite (legal_crm.db).

5. Cálculos Tributarios del SII:

   • Liquidación de boletas de honorarios profesionales de segunda categoría (Ley N° 21.133) con retención legal vigente del 13,75 % y cálculo de cuota litis.

🚀 Puesta en Marcha

Opción 1: Despliegue con Docker Compose (Recomendado)

Levanta la suite completa (DeepSeek UI, Twenty Server, Twenty Worker, PostgreSQL 16 y Redis 7):

docker compose up -d

• Legal Harness & DeepSeek UI: http://localhost:8000
• Twenty CRM: http://localhost:3000

Opción 2: Ejecución Local en Python

# 1. Instalar dependencias
pip install -r requirements.txt

# 2. Iniciar el servidor
./run.sh
# o bien: uvicorn server:app --host 0.0.0.0 --port 8000 --reload

Abre tu navegador en: http://localhost:8000.

🔄 Sincronización Continua Multi-Repo (Upstream)

El repositorio mantiene vinculados los proyectos oficiales mediante submódulos Git:

1. deepseek-ai/deepseek-harness
2. twentyhq/twenty
3. chile-legal/open-legal-chile
4. chile-legal/legal-graphify

Comandos de Sincronización:

# Comprobar actualizaciones oficiales en GitHub:
./sync-upstreams.sh --check

# Aplicar actualizaciones remotas preservando personalizaciones chilenas:
./sync-upstreams.sh --sync

# Ver estado de submódulos y versiones locales:
./sync-upstreams.sh --status

🧪 Pruebas Automatizadas y Auditoría de Seguridad

La suite de pruebas automatizadas registra un 100 % de aprobación (17 de 17 pruebas):

pytest tests/ -v

El código cuenta con certificación de 0,0 % de sobreingeniería (Bloat Score) bajo la Escalera de la Pereza de Ponytail y remediaciones de seguridad contra CORS permisivo (CWE-942), SSRF (CWE-918), DoS por agotamiento de CPU (CWE-400), symlink attacks en archivos temporales (CWE-377) y sanitización de sintaxis Mermaid (CWE-79).

📄 Licencia

Este proyecto se distribuye bajo la licencia Apache 2.0 / MIT en conformidad con las licencias de sus componentes madre de código abierto.