theus-cli-linux-x64 1.2.2 → 1.3.0

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

@@ -1,252 +0,0 @@
----
-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

@@ -1,212 +0,0 @@
----
-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`