theus-cli-linux-arm64 0.2.84

package/vendor/theus-arsenal/skills/harness-agente-autonomo/SKILL.md

@@ -0,0 +1,252 @@
+---
+name: harness-agente-autonomo
+description: Convierte el CLI en un sistema de agente autónomo con memoria persistente, operaciones programadas y cola de tareas. Usa esta skill cuando se necesite operación continua, tareas recurrentes o un bucle de agente autodirigido.
+---
+
+# Harness de agente autónomo
+
+Convierte el CLI en un sistema de agente persistente y autodirigido usando funciones nativas y servidores MCP, sin depender de frameworks de agentes externos.
+
+## Consentimiento y límites de seguridad
+
+La operación autónoma debe ser solicitada y acotada explícitamente por el usuario. No crees programaciones recurrentes, despaches agentes remotos, escribas memoria persistente, uses control del navegador/escritorio, publiques externamente, modifiques recursos de terceros ni actúes sobre comunicaciones privadas salvo que el usuario haya aprobado esa capacidad y el espacio de trabajo objetivo para la configuración actual.
+
+Prefiere planes en seco (dry-run) y archivos de cola locales antes de habilitar acciones recurrentes o disparadas por eventos. Mantén credenciales, exportaciones privadas del espacio de trabajo, datasets personales y automatizaciones ligadas a cuentas fuera de los artefactos reutilizables del plugin.
+
+## Cuándo activarla
+
+- El usuario quiere un agente que corra de forma continua o programada.
+- Se configuran flujos automatizados que se disparan periódicamente.
+- Se construye un asistente personal que recuerda contexto entre sesiones.
+- El usuario dice "ejecuta esto cada día", "revisa esto regularmente", "sigue monitoreando".
+- Quiere replicar la funcionalidad de frameworks de agentes autónomos independientes.
+- Necesita automatización de navegador combinada con ejecución programada.
+
+## Arquitectura
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                     Runtime del CLI                          │
+│                                                              │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐   │
+│  │ Tareas   │  │ Despacho │  │ Memoria  │  │ Control de  │   │
+│  │ progra-  │  │ remoto / │  │ persis-  │  │ navegador   │   │
+│  │ madas    │  │ eventos  │  │ tente    │  │             │   │
+│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬──────┘   │
+│       │             │             │               │          │
+│       ▼             ▼             ▼               ▼          │
+│  ┌──────────────────────────────────────────────────────┐    │
+│  │            Capa de skills + agentes del plugin       │    │
+│  │                                                      │    │
+│  │  skills/     agents/     commands/     hooks/        │    │
+│  └──────────────────────────────────────────────────────┘    │
+│       │             │             │               │          │
+│       ▼             ▼             ▼               ▼          │
+│  ┌──────────────────────────────────────────────────────┐    │
+│  │            Capa de servidores MCP                    │    │
+│  │                                                      │    │
+│  │  memoria    github    búsqueda    bd    navegador    │    │
+│  └──────────────────────────────────────────────────────┘    │
+└──────────────────────────────────────────────────────────────┘
+```
+
+## Componentes centrales
+
+### 1. Memoria persistente
+
+Combina archivos de estado del plugin con un servidor MCP de memoria (grafo de conocimiento) para datos estructurados, si el usuario tiene uno configurado.
+
+**Memoria en archivos** (`~/.theus/arsenal/`):
+- Preferencias del usuario, feedback, contexto del proyecto.
+- Archivos markdown con frontmatter, fáciles de releer al iniciar sesión.
+- Desde scripts Node, resuelve la ruta con `require('scripts/lib/agent-data-home.js')` → `resolveAgentDataHome()`.
+
+**Servidor MCP de memoria** (grafo de conocimiento estructurado):
+- Entidades, relaciones, observaciones.
+- Estructura consultable, persistente entre sesiones.
+- Solo si el usuario ya lo tiene instalado; no es parte del CLI.
+
+**Patrones de memoria:**
+
+```
+# Corto plazo: contexto de la sesión actual
+Usa la lista de tareas (TodoWrite) para seguimiento dentro de la sesión
+
+# Medio plazo: archivos de memoria del proyecto
+Escribe en ~/.theus/arsenal/ para recuerdo entre sesiones
+
+# Largo plazo: grafo de conocimiento MCP (si está configurado)
+Crea entidades para datos estructurados permanentes
+Crea relaciones para mapear vínculos
+Añade observaciones con hechos nuevos sobre entidades conocidas
+```
+
+### 2. Operaciones programadas
+
+El CLI no trae un planificador propio: usa el planificador del sistema (cron/launchd) invocando el modo programático del CLI.
+
+**Configurar una tarea recurrente:**
+
+```bash
+# Vía crontab: cada día laborable a las 9:00
+# 0 9 * * 1-5  cd /ruta/al/repo && theus -p "Revisa los PRs abiertos: estado de CI, cambios, problemas. Escribe un resumen en ~/.theus/arsenal/briefing.md"
+
+# Modo programático puntual
+echo "Revisa los PRs abiertos y resume" | theus -p
+```
+
+**Patrones de cron útiles:**
+
+| Patrón | Programación | Caso de uso |
+|--------|--------------|-------------|
+| Standup diario | `0 9 * * 1-5` | Revisar PRs, issues, estado de despliegues |
+| Revisión semanal | `0 10 * * 1` | Métricas de calidad de código, cobertura de tests |
+| Monitor horario | `0 * * * *` | Salud de producción, tasa de errores |
+| Build nocturno | `0 2 * * *` | Suite completa de tests, escaneo de seguridad |
+| Pre-reunión | `*/30 * * * *` | Preparar contexto para reuniones próximas |
+
+### 3. Despacho / agentes por eventos
+
+Dispara sesiones del agente desde eventos externos usando el modo programático.
+
+**Patrones de despacho:**
+
+```bash
+# Disparo desde CI/CD (paso del pipeline)
+theus -p "El build falló en main. Diagnostica y propone un fix." || true
+
+# Disparo desde webhook
+# Webhook de GitHub → script receptor → theus -p → fix → PR
+
+# Disparo desde otro agente
+theus -p "Analiza la salida del escaneo de seguridad y crea issues por cada hallazgo"
+```
+
+### 4. Control de navegador (opcional)
+
+Si el usuario tiene un servidor MCP de automatización de navegador configurado, el harness puede interactuar con interfaces web.
+
+**Capacidades típicas:**
+- Automatización de navegador (navegar, clic, rellenar formularios, capturas).
+- Flujos multi-aplicación basados en capturas.
+
+**Casos de uso dentro del harness:**
+- Testing automatizado de UIs web.
+- Relleno de formularios y entrada de datos.
+- Monitoreo basado en capturas de pantalla.
+
+Requiere permisos explícitos otorgados por el usuario. No asumas acceso.
+
+### 5. Cola de tareas
+
+Mantén una cola persistente de tareas que sobreviva los límites de sesión.
+
+**Implementación:**
+
+```
+# Persistencia de la cola vía archivo de memoria
+Escribe la cola en ~/.theus/arsenal/cola-tareas.md
+
+# Formato de la cola
+---
+name: cola-tareas
+type: project
+description: Cola de tareas persistente para operación autónoma
+---
+
+## Tareas activas
+- [ ] PR #123: revisar y aprobar si el CI está en verde
+- [ ] Monitorear despliegue: consultar /health cada 30 min durante 2 horas
+- [ ] Investigación: encontrar 5 leads en el espacio de tooling de IA
+
+## Completadas
+- [x] Standup diario: revisados 3 PRs, 2 issues
+```
+
+## Equivalencias con frameworks de agentes autónomos
+
+| Componente típico del framework | Equivalente aquí | Cómo |
+|--------------------------------|------------------|------|
+| Gateway/Router | Cron del sistema + `theus -p` | Las tareas programadas disparan sesiones del agente |
+| Sistema de memoria | Archivos en `~/.theus/arsenal/` + MCP de memoria | Persistencia en archivos + grafo de conocimiento |
+| Registro de herramientas | Servidores MCP | Proveedores de herramientas cargados dinámicamente |
+| Orquestación | Skills + agentes del plugin | Las definiciones de skills dirigen el comportamiento |
+| Control de navegador | MCP de navegador | Automatización web bajo permisos explícitos |
+| Gestor de contexto | Gestión de sesiones + memoria | Ciclo de vida de sesión del CLI |
+| Cola de tareas | Lista persistida en memoria | Lista de tareas + archivos de memoria |
+
+## Guía de configuración
+
+### Paso 1: configura los servidores MCP
+
+Asegúrate de que los servidores que el harness usará (memoria, GitHub, búsqueda, navegador) estén registrados en la configuración MCP del CLI. Usa solo servidores que el usuario haya elegido e instalado; ninguno es obligatorio para empezar.
+
+### Paso 2: crea las tareas recurrentes base
+
+```bash
+# Briefing matutino diario (entrada de crontab)
+# 0 9 * * 1-5  theus -p "Revisa mis notificaciones de GitHub, PRs abiertos y pendientes. Escribe un briefing matutino en ~/.theus/arsenal/briefing.md"
+
+# Aprendizaje continuo semanal
+# 0 20 * * 0  theus -p "Extrae patrones de las sesiones de esta semana y actualiza las notas de aprendizaje en ~/.theus/arsenal/"
+```
+
+### Paso 3: inicializa la memoria
+
+```bash
+# Bootstrap de identidad y contexto
+theus -p "Crea notas de memoria en ~/.theus/arsenal/ para: mi perfil, mis proyectos, mis contactos clave. Añade observaciones sobre las prioridades actuales."
+```
+
+### Paso 4: habilita el control de navegador (opcional)
+
+Otorga al servidor MCP de navegador los permisos necesarios, de forma explícita y acotada.
+
+## Flujos de ejemplo
+
+### Revisor de PRs autónomo
+```
+Cron: cada 30 min en horario laboral
+1. Buscar PRs nuevos en los repos vigilados
+2. Por cada PR nuevo:
+   - Traer la rama localmente
+   - Ejecutar los tests
+   - Revisar los cambios con el agente revisor-codigo
+   - Publicar comentarios de revisión vía MCP de GitHub
+3. Actualizar la memoria con el estado de la revisión
+```
+
+### Agente de investigación personal
+```
+Cron: diario a las 6:00
+1. Leer las consultas de búsqueda guardadas en memoria
+2. Ejecutar búsquedas web por cada consulta
+3. Resumir hallazgos nuevos
+4. Comparar contra los resultados de ayer
+5. Escribir el resumen en memoria
+6. Marcar los ítems de alta prioridad para la revisión matutina
+```
+
+### Agente de preparación de reuniones
+```
+Disparo: 30 min antes de cada evento del calendario
+1. Leer los detalles del evento
+2. Buscar en memoria el contexto de los asistentes
+3. Recuperar hilos recientes de correo/chat con los asistentes
+4. Preparar puntos de conversación y propuesta de agenda
+5. Escribir el documento de preparación en memoria
+```
+
+## Restricciones
+
+- Las tareas programadas corren en sesiones aisladas: no comparten contexto con las sesiones interactivas salvo a través de la memoria.
+- El control de navegador requiere permisos explícitos. No asumas acceso.
+- El despacho remoto puede tener límites de tasa. Diseña las tareas recurrentes con intervalos razonables.
+- Mantén los archivos de memoria concisos. Archiva los datos antiguos en lugar de dejar que los archivos crezcan sin límite.
+- Verifica siempre que las tareas programadas terminaron con éxito. Añade manejo de errores a los prompts de cron.
+
+## Skills relacionadas
+
+- `construccion-harness-agentes`
+- `sistema-operativo-agentico`
+- `operaciones-terminal`

package/vendor/theus-arsenal/skills/harness-eval-clinico/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: harness-eval-clinico
+description: Harness de evaluación de seguridad del paciente para despliegues de aplicaciones de salud. Suites automatizadas para exactitud del CDSS, exposición de PHI, integridad de flujos clínicos y cumplimiento de integraciones. Bloquea despliegues ante fallos de seguridad.
+---
+
+# Harness de evaluación clínica — verificación de seguridad del paciente
+
+Sistema de verificación automatizada para despliegues de aplicaciones de salud. Un solo fallo CRÍTICO bloquea el despliegue. La seguridad del paciente no es negociable.
+
+> **Aviso:** esta guía es material de ingeniería y no sustituye la validación clínica, regulatoria ni legal por profesionales cualificados.
+
+> **Nota:** los ejemplos usan Jest como test runner de referencia. Adapta los comandos a tu framework (Vitest, pytest, PHPUnit, etc.) — las categorías de tests y los umbrales de aprobación son agnósticos del framework.
+
+## Cuándo usarla
+
+- Antes de cualquier despliegue de aplicaciones EMR/EHR.
+- Tras modificar la lógica del CDSS (interacciones farmacológicas, validación de dosis, scoring).
+- Tras cambiar esquemas de base de datos que tocan datos de pacientes.
+- Tras modificar autenticación o control de acceso.
+- Durante la configuración del pipeline de CI/CD de aplicaciones de salud.
+- Tras resolver conflictos de merge en módulos clínicos.
+
+## Cómo funciona
+
+El harness ejecuta cinco categorías de tests en orden. Las tres primeras (Exactitud del CDSS, Exposición de PHI, Integridad de datos) son puertas CRÍTICAS que exigen 100 % de aprobación — un solo fallo bloquea el despliegue. Las dos restantes (Flujo clínico, Integraciones) son puertas ALTAS que exigen 95 %+ de aprobación.
+
+Cada categoría se mapea a un patrón de rutas de tests de Jest. El pipeline de CI ejecuta las puertas CRÍTICAS con `--bail` (parar al primer fallo) y aplica umbrales de cobertura con `--coverage --coverageThreshold`.
+
+### Categorías de evaluación
+
+**1. Exactitud del CDSS (CRÍTICA — 100 % exigido)**
+
+Testea toda la lógica de soporte a la decisión clínica: pares de interacciones farmacológicas (en ambos sentidos), reglas de validación de dosis, scoring clínico contra las especificaciones publicadas, cero falsos negativos, cero fallos silenciosos.
+
+```bash
+npx jest --testPathPattern='tests/cdss' --bail --ci --coverage
+```
+
+**2. Exposición de PHI (CRÍTICA — 100 % exigido)**
+
+Testea fugas de información de salud protegida: respuestas de error de la API, salida por consola, parámetros de URL, almacenamiento del navegador, aislamiento entre centros, acceso no autenticado, ausencia de claves de rol de servicio.
+
+```bash
+npx jest --testPathPattern='tests/security/phi' --bail --ci
+```
+
+**3. Integridad de datos (CRÍTICA — 100 % exigido)**
+
+Testea la seguridad de los datos clínicos: consultas bloqueadas, entradas de la traza de auditoría, protección contra borrados en cascada, manejo de ediciones concurrentes, ausencia de registros huérfanos.
+
+```bash
+npx jest --testPathPattern='tests/data-integrity' --bail --ci
+```
+
+**4. Flujo clínico (ALTA — 95 %+ exigido)**
+
+Testea flujos de extremo a extremo: ciclo de vida de la consulta, renderizado de plantillas, conjuntos de medicación, búsqueda de fármacos/diagnósticos, PDF de recetas, alertas de red flags.
+
+```bash
+tmp_json=$(mktemp)
+npx jest --testPathPattern='tests/clinical' --ci --json --outputFile="$tmp_json" || true
+total=$(jq '.numTotalTests // 0' "$tmp_json")
+passed=$(jq '.numPassedTests // 0' "$tmp_json")
+if [ "$total" -eq 0 ]; then
+  echo "No se encontraron tests clínicos" >&2
+  exit 1
+fi
+rate=$(echo "scale=2; $passed * 100 / $total" | bc)
+echo "Tasa de aprobación clínica: ${rate}% ($passed/$total)"
+```
+
+**5. Cumplimiento de integraciones (ALTA — 95 %+ exigido)**
+
+Testea sistemas externos: parseo de mensajes HL7 (v2.x), validación FHIR, mapeo de resultados de laboratorio, manejo de mensajes malformados.
+
+```bash
+tmp_json=$(mktemp)
+npx jest --testPathPattern='tests/integration' --ci --json --outputFile="$tmp_json" || true
+total=$(jq '.numTotalTests // 0' "$tmp_json")
+passed=$(jq '.numPassedTests // 0' "$tmp_json")
+if [ "$total" -eq 0 ]; then
+  echo "No se encontraron tests de integración" >&2
+  exit 1
+fi
+rate=$(echo "scale=2; $passed * 100 / $total" | bc)
+echo "Tasa de aprobación de integraciones: ${rate}% ($passed/$total)"
+```
+
+### Matriz de aprobación/fallo
+
+| Categoría | Umbral | Ante un fallo |
+|-----------|--------|---------------|
+| Exactitud del CDSS | 100 % | **BLOQUEAR despliegue** |
+| Exposición de PHI | 100 % | **BLOQUEAR despliegue** |
+| Integridad de datos | 100 % | **BLOQUEAR despliegue** |
+| Flujo clínico | 95 %+ | ADVERTIR, permitir con revisión |
+| Integraciones | 95 %+ | ADVERTIR, permitir con revisión |
+
+### Integración en CI/CD
+
+```yaml
+name: Puerta de seguridad clínica
+on: [push, pull_request]
+
+jobs:
+  safety-gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm ci
+
+      # Puertas CRÍTICAS — 100 % exigido, parar al primer fallo
+      - name: Exactitud del CDSS
+        run: npx jest --testPathPattern='tests/cdss' --bail --ci --coverage --coverageThreshold='{"global":{"branches":80,"functions":80,"lines":80}}'
+
+      - name: Verificación de exposición de PHI
+        run: npx jest --testPathPattern='tests/security/phi' --bail --ci
+
+      - name: Integridad de datos
+        run: npx jest --testPathPattern='tests/data-integrity' --bail --ci
+
+      # Puertas ALTAS — 95 %+ exigido
+      - name: Flujos clínicos
+        run: |
+          TMP_JSON=$(mktemp)
+          npx jest --testPathPattern='tests/clinical' --ci --json --outputFile="$TMP_JSON" || true
+          TOTAL=$(jq '.numTotalTests // 0' "$TMP_JSON")
+          PASSED=$(jq '.numPassedTests // 0' "$TMP_JSON")
+          if [ "$TOTAL" -eq 0 ]; then
+            echo "::error::No se encontraron tests clínicos"; exit 1
+          fi
+          RATE=$(echo "scale=2; $PASSED * 100 / $TOTAL" | bc)
+          echo "Tasa de aprobación: ${RATE}% ($PASSED/$TOTAL)"
+          if (( $(echo "$RATE < 95" | bc -l) )); then
+            echo "::warning::Tasa de aprobación clínica ${RATE}% por debajo del 95%"
+          fi
+
+      - name: Cumplimiento de integraciones
+        run: |
+          TMP_JSON=$(mktemp)
+          npx jest --testPathPattern='tests/integration' --ci --json --outputFile="$TMP_JSON" || true
+          TOTAL=$(jq '.numTotalTests // 0' "$TMP_JSON")
+          PASSED=$(jq '.numPassedTests // 0' "$TMP_JSON")
+          if [ "$TOTAL" -eq 0 ]; then
+            echo "::error::No se encontraron tests de integración"; exit 1
+          fi
+          RATE=$(echo "scale=2; $PASSED * 100 / $TOTAL" | bc)
+          echo "Tasa de aprobación: ${RATE}% ($PASSED/$TOTAL)"
+          if (( $(echo "$RATE < 95" | bc -l) )); then
+            echo "::warning::Tasa de aprobación de integraciones ${RATE}% por debajo del 95%"
+          fi
+```
+
+### Antipatrones
+
+- Saltarse los tests del CDSS "porque pasaron la última vez".
+- Fijar umbrales CRÍTICOS por debajo del 100 %.
+- Usar `--no-bail` en suites de tests CRÍTICAS.
+- Mockear el motor CDSS en tests de integración (debe testearse la lógica real).
+- Permitir despliegues con la puerta de seguridad en rojo.
+- Ejecutar las suites del CDSS sin `--coverage`.
+
+## Ejemplos
+
+### Ejemplo 1: ejecutar todas las puertas críticas en local
+
+```bash
+npx jest --testPathPattern='tests/cdss' --bail --ci --coverage && \
+npx jest --testPathPattern='tests/security/phi' --bail --ci && \
+npx jest --testPathPattern='tests/data-integrity' --bail --ci
+```
+
+### Ejemplo 2: comprobar la tasa de aprobación de una puerta ALTA
+
+```bash
+tmp_json=$(mktemp)
+npx jest --testPathPattern='tests/clinical' --ci --json --outputFile="$tmp_json" || true
+jq '{
+  passed: (.numPassedTests // 0),
+  total: (.numTotalTests // 0),
+  rate: (if (.numTotalTests // 0) == 0 then 0 else ((.numPassedTests // 0) / (.numTotalTests // 1) * 100) end)
+}' "$tmp_json"
+# Esperado: { "passed": 21, "total": 22, "rate": 95.45 }
+```
+
+### Ejemplo 3: informe de evaluación
+
+```
+## Evaluación clínica: 2026-03-27 [commit abc1234]
+
+### Seguridad del paciente: APROBADO
+
+| Categoría | Tests | Pasan | Fallan | Estado |
+|-----------|-------|-------|--------|--------|
+| Exactitud del CDSS | 39 | 39 | 0 | APROBADO |
+| Exposición de PHI | 8 | 8 | 0 | APROBADO |
+| Integridad de datos | 12 | 12 | 0 | APROBADO |
+| Flujo clínico | 22 | 21 | 1 | 95.5% APROBADO |
+| Integraciones | 6 | 6 | 0 | APROBADO |
+
+### Cobertura: 84 % (objetivo: 80 %+)
+### Veredicto: SEGURO PARA DESPLEGAR
+```
+
+## Skills relacionadas
+
+- `patrones-emr-clinico`
+- `cumplimiento-hipaa`
+- `datos-sensibles-salud`