npm - theus-cli - Versions diffs - 0.2.83 → 0.2.85 - Mend

theus-cli 0.2.83 → 0.2.85

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (738) hide show

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

@@ -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 DELETED Viewed

@@ -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`