theus-cli 0.2.82 → 0.2.84

package/vendor/theus-arsenal/skills/patrones-cdss-clinico/SKILL.md

@@ -1,249 +0,0 @@
----
-name: patrones-cdss-clinico
-description: Patrones de desarrollo de sistemas de soporte a la decisión clínica (CDSS). Verificación de interacciones farmacológicas, validación de dosis, escalas clínicas (NEWS2, qSOFA), clasificación de severidad de alertas e integración en flujos de EMR.
----
-
-# Patrones de desarrollo de CDSS clínico
-
-Patrones para construir sistemas de soporte a la decisión clínica (CDSS) que se integran en flujos de EMR. Los módulos de CDSS son críticos para la seguridad del paciente — tolerancia cero a falsos negativos.
-
-> **Advertencia de seguridad clínica.** Este contenido describe patrones de ingeniería
-> de software para sistemas clínicos; no constituye asesoría médica, farmacológica ni
-> legal, y no sustituye la revisión de profesionales clínicos cualificados ni los
-> procesos regulatorios aplicables. Todo motor CDSS debe ser validado por personal
-> clínico antes de usarse con pacientes reales.
-
-## Cuándo usarla
-
-- Al implementar verificación de interacciones farmacológicas
-- Al construir motores de validación de dosis
-- Al implementar escalas clínicas (NEWS2, qSOFA, APACHE, GCS)
-- Al diseñar sistemas de alerta para valores clínicos anormales
-- Al construir entrada de órdenes de medicación con verificaciones de seguridad
-- Al integrar interpretación de resultados de laboratorio con contexto clínico
-
-## Cómo funciona
-
-El motor CDSS es una **biblioteca de funciones puras sin efectos secundarios**. Entran datos clínicos, salen alertas. Esto lo hace completamente testeable.
-
-Tres módulos primarios:
-
-1. **`checkInteractions(newDrug, currentMeds, allergies)`** — Verifica un fármaco nuevo contra la medicación actual y las alergias conocidas. Devuelve `InteractionAlert[]` ordenado por severidad. Usa el modelo de datos `DrugInteractionPair`.
-2. **`validateDose(drug, dose, route, weight, age, renalFunction)`** — Valida una dosis prescrita contra reglas por peso, ajustadas por edad y ajustadas por función renal. Devuelve `DoseValidationResult`.
-3. **`calculateNEWS2(vitals)`** — National Early Warning Score 2 a partir de `NEWS2Input`. Devuelve `NEWS2Result` con puntaje total, nivel de riesgo y guía de escalamiento.
-
-```
-UI del EMR
-  ↓ (el usuario ingresa datos)
-Motor CDSS (funciones puras, sin efectos secundarios)
-  ├── Verificador de interacciones farmacológicas
-  ├── Validador de dosis
-  ├── Escalas clínicas (NEWS2, qSOFA, etc.)
-  └── Clasificador de alertas
-  ↓ (devuelve alertas)
-UI del EMR (muestra alertas en línea, bloquea si son críticas)
-```
-
-### Verificación de interacciones farmacológicas
-
-```typescript
-interface DrugInteractionPair {
-  drugA: string;           // nombre genérico
-  drugB: string;           // nombre genérico
-  severity: 'critical' | 'major' | 'minor';
-  mechanism: string;
-  clinicalEffect: string;
-  recommendation: string;
-}
-
-function checkInteractions(
-  newDrug: string,
-  currentMedications: string[],
-  allergyList: string[]
-): InteractionAlert[] {
-  if (!newDrug) return [];
-  const alerts: InteractionAlert[] = [];
-  for (const current of currentMedications) {
-    const interaction = findInteraction(newDrug, current);
-    if (interaction) {
-      alerts.push({ severity: interaction.severity, pair: [newDrug, current],
-        message: interaction.clinicalEffect, recommendation: interaction.recommendation });
-    }
-  }
-  for (const allergy of allergyList) {
-    if (isCrossReactive(newDrug, allergy)) {
-      alerts.push({ severity: 'critical', pair: [newDrug, allergy],
-        message: `Reactividad cruzada con alergia documentada: ${allergy}`,
-        recommendation: 'No prescribir sin interconsulta de alergología' });
-    }
-  }
-  return alerts.sort((a, b) => severityOrder(a.severity) - severityOrder(b.severity));
-}
-```
-
-Los pares de interacción deben ser **bidireccionales**: si el fármaco A interactúa con el fármaco B, entonces el fármaco B interactúa con el fármaco A.
-
-### Validación de dosis
-
-```typescript
-interface DoseValidationResult {
-  valid: boolean;
-  message: string;
-  suggestedRange: { min: number; max: number; unit: string } | null;
-  factors: string[];
-}
-
-function validateDose(
-  drug: string,
-  dose: number,
-  route: 'oral' | 'iv' | 'im' | 'sc' | 'topical',
-  patientWeight?: number,
-  patientAge?: number,
-  renalFunction?: number
-): DoseValidationResult {
-  const rules = getDoseRules(drug, route);
-  if (!rules) return { valid: true, message: 'Sin reglas de validación disponibles', suggestedRange: null, factors: [] };
-  const factors: string[] = [];
-
-  // SEGURIDAD: si las reglas requieren peso y falta el peso, BLOQUEAR (no aprobar)
-  if (rules.weightBased) {
-    if (!patientWeight || patientWeight <= 0) {
-      return { valid: false, message: `Se requiere peso para ${drug} (fármaco en mg/kg)`,
-        suggestedRange: null, factors: ['weight_missing'] };
-    }
-    factors.push('weight');
-    const maxDose = rules.maxPerKg * patientWeight;
-    if (dose > maxDose) {
-      return { valid: false, message: `La dosis excede el máximo para ${patientWeight} kg`,
-        suggestedRange: { min: rules.minPerKg * patientWeight, max: maxDose, unit: rules.unit }, factors };
-    }
-  }
-
-  // Ajuste por edad (cuando las reglas definen tramos etarios y se aporta la edad)
-  if (rules.ageAdjusted && patientAge !== undefined) {
-    factors.push('age');
-    const ageMax = rules.getAgeAdjustedMax(patientAge);
-    if (dose > ageMax) {
-      return { valid: false, message: `Excede el máximo ajustado por edad para ${patientAge} años`,
-        suggestedRange: { min: rules.typicalMin, max: ageMax, unit: rules.unit }, factors };
-    }
-  }
-
-  // Ajuste renal (cuando las reglas definen tramos de TFGe y se aporta la TFGe)
-  if (rules.renalAdjusted && renalFunction !== undefined) {
-    factors.push('renal');
-    const renalMax = rules.getRenalAdjustedMax(renalFunction);
-    if (dose > renalMax) {
-      return { valid: false, message: `Excede el máximo ajustado por función renal para TFGe ${renalFunction}`,
-        suggestedRange: { min: rules.typicalMin, max: renalMax, unit: rules.unit }, factors };
-    }
-  }
-
-  // Máximo absoluto
-  if (dose > rules.absoluteMax) {
-    return { valid: false, message: `Excede el máximo absoluto ${rules.absoluteMax}${rules.unit}`,
-      suggestedRange: { min: rules.typicalMin, max: rules.absoluteMax, unit: rules.unit },
-      factors: [...factors, 'absolute_max'] };
-  }
-  return { valid: true, message: 'Dentro del rango',
-    suggestedRange: { min: rules.typicalMin, max: rules.typicalMax, unit: rules.unit }, factors };
-}
-```
-
-### Escalas clínicas: NEWS2
-
-```typescript
-interface NEWS2Input {
-  respiratoryRate: number; oxygenSaturation: number; supplementalOxygen: boolean;
-  temperature: number; systolicBP: number; heartRate: number;
-  consciousness: 'alert' | 'voice' | 'pain' | 'unresponsive';
-}
-interface NEWS2Result {
-  total: number;           // 0-20
-  risk: 'low' | 'low-medium' | 'medium' | 'high';
-  components: Record<string, number>;
-  escalation: string;
-}
-```
-
-Las tablas de puntuación deben coincidir exactamente con la especificación del Royal College of Physicians.
-
-### Severidad de alertas y comportamiento de la UI
-
-| Severidad | Comportamiento en la UI | Acción requerida del clínico |
-|-----------|-------------------------|------------------------------|
-| Crítica | Bloquea la acción. Modal no descartable. Rojo. | Debe documentar el motivo del override para continuar |
-| Mayor | Banner de advertencia en línea. Naranja. | Debe confirmar antes de continuar |
-| Menor | Nota informativa en línea. Amarillo. | Solo para conocimiento, sin acción requerida |
-
-Las alertas críticas NUNCA deben autodescartarse ni implementarse como notificaciones toast. Los motivos de override deben almacenarse en la pista de auditoría.
-
-### Pruebas del CDSS (tolerancia cero a falsos negativos)
-
-```typescript
-describe('CDSS — Seguridad del paciente', () => {
-  INTERACTION_PAIRS.forEach(({ drugA, drugB, severity }) => {
-    it(`detecta ${drugA} + ${drugB} (${severity})`, () => {
-      const alerts = checkInteractions(drugA, [drugB], []);
-      expect(alerts.length).toBeGreaterThan(0);
-      expect(alerts[0].severity).toBe(severity);
-    });
-    it(`detecta ${drugB} + ${drugA} (orden inverso)`, () => {
-      const alerts = checkInteractions(drugB, [drugA], []);
-      expect(alerts.length).toBeGreaterThan(0);
-    });
-  });
-  it('bloquea un fármaco en mg/kg cuando falta el peso', () => {
-    const result = validateDose('gentamicin', 300, 'iv');
-    expect(result.valid).toBe(false);
-    expect(result.factors).toContain('weight_missing');
-  });
-  it('maneja con gracia datos de fármaco malformados', () => {
-    expect(() => checkInteractions('', [], [])).not.toThrow();
-  });
-});
-```
-
-Criterio de aprobación: 100 %. Una sola interacción no detectada es un evento de seguridad del paciente.
-
-### Antipatrones
-
-- Hacer las verificaciones del CDSS opcionales u omitibles sin motivo documentado
-- Implementar las verificaciones de interacción como notificaciones toast
-- Usar tipos `any` para datos de fármacos o datos clínicos
-- Codificar los pares de interacción a mano en lugar de usar una estructura de datos mantenible
-- Silenciar errores dentro del motor CDSS (los fallos deben aflorar de forma ruidosa)
-- Omitir la validación por peso cuando el peso no está disponible (debe bloquear, no aprobar)
-
-## Ejemplos
-
-### Ejemplo 1: verificación de interacción farmacológica
-
-```typescript
-const alerts = checkInteractions('warfarin', ['aspirin', 'metformin'], ['penicillin']);
-// [{ severity: 'critical', pair: ['warfarin', 'aspirin'],
-//    message: 'Riesgo aumentado de sangrado', recommendation: 'Evitar la combinación' }]
-```
-
-### Ejemplo 2: validación de dosis
-
-```typescript
-const ok = validateDose('paracetamol', 1000, 'oral', 70, 45);
-// { valid: true, suggestedRange: { min: 500, max: 4000, unit: 'mg' } }
-
-const bad = validateDose('paracetamol', 5000, 'oral', 70, 45);
-// { valid: false, message: 'Excede el máximo absoluto 4000mg' }
-
-const noWeight = validateDose('gentamicin', 300, 'iv');
-// { valid: false, factors: ['weight_missing'] }
-```
-
-### Ejemplo 3: puntuación NEWS2
-
-```typescript
-const result = calculateNEWS2({
-  respiratoryRate: 24, oxygenSaturation: 93, supplementalOxygen: true,
-  temperature: 38.5, systolicBP: 100, heartRate: 110, consciousness: 'voice'
-});
-// { total: 13, risk: 'high', escalation: 'Revisión clínica urgente. Considerar UCI.' }
-```

package/vendor/theus-arsenal/skills/patrones-cisco-ios/SKILL.md

@@ -1,148 +0,0 @@
----
-name: patrones-cisco-ios
-description: Patrones de revisión para Cisco IOS e IOS-XE — comandos show, jerarquía de configuración,
-  máscaras wildcard, ubicación de ACLs, higiene de interfaces y verificación segura en ventanas de cambio.
----
-
-# Patrones de Cisco IOS
-
-Usa esta skill al revisar fragmentos de configuración de Cisco IOS o IOS-XE, al construir una lista de verificación para una ventana de cambio, o al explicar cómo recolectar evidencia de un router o switch sin empeorar el incidente.
-
-## Cuándo usarla
-
-- Al revisar configuración IOS o IOS-XE antes de un cambio planificado.
-- Al elegir comandos `show` de solo lectura para diagnóstico.
-- Al verificar máscaras wildcard de ACLs y la dirección en la interfaz.
-- Al explicar los modos de configuración global, de interfaz, de proceso de enrutamiento y de línea.
-- Al confirmar que un cambio quedó en la running config y se guardó de forma intencional.
-
-## Reglas de operación
-
-Trata los ejemplos de IOS como patrones, no como cambios de producción listos para pegar. Confirma la plataforma, los nombres de interfaz, la configuración actual, la ruta de rollback y el acceso fuera de banda antes de tocar un equipo real.
-
-Prefiere este flujo:
-
-1. Captura el estado actual con comandos de solo lectura.
-2. Revisa la configuración candidata exacta.
-3. Confirma que el acceso de gestión no puede quedar bloqueado.
-4. Aplica el cambio más pequeño posible dentro de una ventana de mantenimiento.
-5. Relee el estado, compáralo con la línea base y guarda solo después de validar.
-
-## Referencia de modos
-
-```text
-Router> enable
-Router# show running-config
-Router# configure terminal
-Router(config)# interface GigabitEthernet0/1
-Router(config-if)# description ENLACE-A-CORE
-Router(config-if)# no shutdown
-Router(config-if)# exit
-Router(config)# end
-Router# show running-config interface GigabitEthernet0/1
-```
-
-La `running-config` es memoria activa. La `startup-config` es lo que sobrevive a un reinicio. No guardes un cambio solo porque el comando fue aceptado; valida primero el comportamiento y luego usa `copy running-config startup-config` si el cambio está aprobado.
-
-## Recolección de solo lectura
-
-```text
-show version
-show inventory
-show processes cpu sorted
-show memory statistics
-show logging
-show running-config | section line vty
-show running-config | section interface
-show running-config | section router bgp
-show ip interface brief
-show interfaces
-show interfaces status
-show vlan brief
-show mac address-table
-show spanning-tree
-show ip route
-show ip protocols
-show ip access-lists
-show route-map
-show ip prefix-list
-```
-
-Recolecta la sección específica que necesitas en lugar de volcar la configuración completa en un ticket cuando esta pueda contener secretos, nombres de clientes o topología privada.
-
-## Máscaras wildcard
-
-Las ACLs de IOS y muchas sentencias de enrutamiento usan máscaras wildcard, no máscaras de subred.
-
-```text
-Máscara de subred   Máscara wildcard
-255.255.255.255     0.0.0.0
-255.255.255.252     0.0.0.3
-255.255.255.0       0.0.0.255
-255.255.0.0         0.0.255.255
-```
-
-Revisa las máscaras wildcard antes de desplegar. Una máscara de subred usada por accidente como wildcard puede coincidir con mucho más tráfico del previsto.
-
-```text
-ip access-list extended WEB-IN
-  10 permit tcp 192.0.2.0 0.0.0.255 any eq 443
-  999 deny ip any any log
-```
-
-Toda ACL tiene un deny implícito al final. Añade un deny explícito con log cuando el objetivo operativo incluya observar los descartes, y confirma que el volumen de logging es seguro.
-
-## Revisión de ubicación de ACLs
-
-Antes de aplicar una ACL a una interfaz, responde estas preguntas:
-
-- ¿Qué dirección de tráfico se está filtrando, `in` o `out`?
-- ¿El tráfico de gestión proviene de un jump host o una subred de gestión conocidos?
-- ¿Hay un permit explícito para el enrutamiento, DNS, NTP, monitoreo o tráfico de aplicación requeridos?
-- ¿Hay contadores de aciertos disponibles desde una fuente de prueba segura?
-- ¿Existe un comando de rollback y una ruta activa de consola o fuera de banda?
-
-No pruebes la alcanzabilidad quitando protecciones de firewall o ACLs. Lee primero contadores, logs y estado de rutas.
-
-## Higiene de interfaces
-
-```text
-interface GigabitEthernet0/1
- description ENLACE-A-CORE
- switchport mode trunk
- switchport trunk allowed vlan 10,20,30
- switchport trunk native vlan 999
- no shutdown
-```
-
-Usa descripciones claras, modo de switchport explícito y VLANs nativas documentadas. En interfaces enrutadas, confirma la máscara, el direccionamiento del par y el proceso de enrutamiento antes de asumir que el estado del enlace implica que el reenvío es correcto.
-
-## Verificación en ventana de cambio
-
-Usa comprobaciones antes/después que correspondan al cambio real.
-
-```text
-show running-config | section interface GigabitEthernet0/1
-show interfaces GigabitEthernet0/1
-show logging | include GigabitEthernet0/1|changed state|line protocol
-show ip route <prefijo>
-show ip access-lists <nombre>
-```
-
-Para cambios de enrutamiento, captura también el estado de vecinos y las tablas de rutas antes y después. Para cambios de ACL, compara contadores de aciertos desde una fuente de prueba planificada en lugar de confiar en un ping genérico.
-
-## Antipatrones
-
-- Aplicar una configuración generada sin un diff específico del equipo.
-- Guardar la configuración antes de que pasen las comprobaciones posteriores al cambio.
-- Usar una máscara de subred donde IOS espera una máscara wildcard.
-- Aplicar una ACL en la dirección equivocada de la interfaz.
-- Diagnosticar deshabilitando ACLs, políticas de rutas o autenticación.
-- Pegar configuraciones completas en herramientas públicas sin sanear secretos y topología.
-
-## Ver también
-
-- Agente: `revisor-config-red`
-- Agente: `diagnosticador-redes`
-- Skill: `validacion-config-red`
-- Skill: `salud-interfaces-red`