Metadata-Version: 2.4
Name: open-legal-harness
Version: 1.0.0
Summary: Arnés agéntico legal chileno con DeepSeek, Twenty CRM y plugins Open Legal Chile y Legal Graphify
Author-email: Pablo Ultrón <contacto@legalharness.cl>
License: Apache-2.0
Project-URL: Homepage, https://elpabloultron.github.io/open-legal-harness/
Project-URL: Repository, https://github.com/elpabloultron/open-legal-harness
Project-URL: Documentation, https://elpabloultron.github.io/open-legal-harness/
Project-URL: Issues, https://github.com/elpabloultron/open-legal-harness/issues
Keywords: legal-tech,chile,deepseek,crm,twenty,cpc,plazos-judiciales,open-legal-chile,legal-graphify,agentes
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Legal Industry
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: pydantic>=2.8.0
Requires-Dist: pydantic-settings>=2.4.0
Requires-Dist: sqlalchemy>=2.0.30
Requires-Dist: networkx>=3.2.0
Requires-Dist: rich>=13.7.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.32.0
Requires-Dist: openai>=1.50.0

# ⚖️ 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):

```bash
docker compose up -d
```
- **Legal Harness & DeepSeek UI:** `http://localhost:8000`
- **Twenty CRM:** `http://localhost:3000`

---

### Opción 2: Ejecución Local en Python
```bash
# 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:
```bash
# 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)**:

```bash
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.
