Salud de Sesión
RaiSE proporciona dos características que mantienen la higiene de sesión automáticamente: Session Doctor detecta y limpia estado de sesión obsoleto, y Workstream Monitor proporciona insights de productividad al cerrar la sesión.
Session Doctor¶
Qué Hace¶
El Session Doctor se ejecuta automáticamente en rai session start. Verifica estado de sesión obsoleto u huérfano en .raise/rai/personal/ y limpia lo que es seguro eliminar.
Qué Detecta¶
| Hallazgo | Severidad | Qué significa | ¿Auto-limpiar? |
|---|---|---|---|
| Sesión zombie | warning | Puntero de sesión activa >48h sin contenido que preservar | Sí |
| Zombie con contenido | warning | Puntero de sesión activa >48h, tiene narrativa/estado | No — requiere tu revisión |
| Output obsoleto | info | session-output.yaml >24h |
Sí |
| Retención excedida | info | >20 directorios de sesión acumulados | No — decisión en lote |
Cómo Funciona¶
El doctor sigue un patrón de 3 fases:
- Diagnosticar — escanear por problemas, sin efectos secundarios
- Clasificar — separar auto-seguro de necesita-consentimiento
- Ejecutar — limpiar solo ítems autorizados
Los ítems clasificados como "auto-seguros" (zombies vacíos, archivos de output obsoletos) se limpian sin pedir confirmación. Los ítems que podrían contener trabajo que no has guardado requieren consentimiento explícito.
Ejemplo de Output¶
Session Doctor — 2 hallazgo(s):
[!] Sesión zombie: S-E-260401-0900 (72h)
Sin contenido que preservar
Acción: Limpiar puntero obsoleto
[i] session-output.yaml obsoleto (26h)
26.1 KB — seguro eliminar
Acción: Eliminar archivo de output obsoleto
Auto-limpiado:
- Puntero zombie limpiado: S-E-260401-0900
- Output obsoleto eliminado: session-output.yaml
Ejecutar Manualmente¶
Para inspeccionar sin modificar nada:
Omitir (CI/Automatización)¶
Para pipelines CI o scripts que no necesitan verificaciones de salud:
Configuración¶
Umbrales por defecto (aún no configurables por el usuario):
| Umbral | Por defecto | Propósito |
|---|---|---|
| Edad zombie | 48 horas | Cuándo un puntero de sesión activa se considera obsoleto |
| Edad output obsoleto | 24 horas | Cuándo los archivos de output son seguros para eliminar |
| Retención de directorios | 20 | Máximo de directorios de sesión antes de sugerir limpieza |
Workstream Monitor¶
Qué Hace¶
El Workstream Monitor analiza tu historial de git en rai session close y proporciona breves insights de productividad. Es puramente informativo — sugiere mejoras pero nunca bloquea tu trabajo.
Qué Mide¶
| Métrica | Fuente | Qué indica |
|---|---|---|
| Cantidad de commits | git log |
Productividad de la sesión |
| Ratio de commits de test | Asuntos de commit que comienzan con test |
Cumplimiento de TDD |
| Cantidad de reverts | Asuntos de commit que comienzan con Revert |
Estabilidad del enfoque |
| Duración | Timestamps del primer al último commit | Tiempo de la sesión |
Insights¶
El monitor sugiere mejoras cuando los patrones indican margen de mejora:
Bajo cumplimiento de TDD (ratio de test <30%):
El ratio de commits de test es 2/14 (14%). Considera escribir commits de test antes de la implementación (RED-GREEN-REFACTOR).
Alta frecuencia de reverts (>2 reverts):
3 reverts detectados. Considera commits más pequeños y enfocados para reducir la frecuencia de reverts.
Ejemplo de Output¶
Sesión S-E-260403-1000 cerrada.
Patrones agregados: 2
Correcciones registradas: 1
Insights de sesión: 14 commits | Ratio test: 28% | Reverts: 1 | Duración: 95m
Futuro (v3.1+)¶
El monitor actual usa heurísticas simples de git. Mejoras planificadas:
- Detección de tendencias entre sesiones
- Reconocimiento de patrones a nivel de equipo
- Análisis más profundo via agentes async