K-Forge / K-Forge/Beetle

Registro de decisiones

Open
#178 0 comments 0 reactions 1 assignee Claimed by @RodriKonrad View on GitHub
fase-2
Dominant language
Shell
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Qué es esta tarea

Registrar en un log estructurado la razón por la cual el detector tomó cada decisión: por qué disparó un incidente, por qué lo descartó como pico temporal, por qué lo suprimió por deduplicación. Es la trazabilidad del detector.

## Qué se debe hacer

- Para cada ciclo de evaluación, registrar:
- Señales recibidas y sus valores
- Estado actual de cada contador de persistencia
- Decisión tomada (ignorar / marcar candidato / confirmar incidente / suprimir duplicado)
- Razón de la decisión en texto legible
- Usar el módulo `logging` de Python con salida a journald
- Nivel INFO para decisiones normales, WARNING para incidentes confirmados

## Por qué importa

Cuando el detector falla (falso positivo o falso negativo), el registro de decisiones es lo que permite diagnosticar el bug. Sin él, depurar la lógica de detección requiere adivinar. Es especialmente crítico porque la Fase 2 concentra el 80% del riesgo técnico del proyecto (roadmap, sección de dependencias).

## Criterio de avance

Cada decisión del detector (disparar, descartar, suprimir) queda registrada en journald con timestamp, señales involucradas y razón. Se puede consultar con `journalctl -u doctorjk` y reconstruir la secuencia de decisiones.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.