theus-cli-darwin-x64 0.2.84

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

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

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