# E-036 — El KPI de cobertura contaba eventos de workflow como ediciones

## Contexto y jerarquía

- Fecha: 2026-08-11.
- Objetivo principal: hacer estadísticamente válidos e interpretables los KPIs de telemetría de Objective Guard.
- Objetivo de ronda: corregir el denominador de cobertura preflight y aislar la telemetría de workflow de las observaciones de edición.
- Pregunta de producto: si la cobertura reportada medía realmente ediciones observadas con preflight.

## Trayectoria observada y evidencia

La revisión del inventario mostró que `deriveKpis` calculaba los eventos posteriores como `report.events - pre_edit.total`. Ese conjunto incluía `PostToolUse` y `task-flow`, por lo que el KPI mezclaba ediciones y eventos de workflow. En el inventario registrado había 255 eventos `PreToolUse`, 326 `PostToolUse` y 69 `task-flow`.

## Comportamiento esperado y real del guard

Esperado: `preflight_coverage` debe comparar intentos de edición observados con sus eventos pre-edición correspondientes.

Real: el denominador incluía cualquier evento que no fuera `PreToolUse`. La cobertura resultaba artificialmente baja y `observed_structured_edits` no describía una cantidad de ediciones.

## Clasificación, corrección y límites

Esto es un falso negativo estadístico de observabilidad, no un fallo del detector de código. La corrección deriva `edit_observations` exclusivamente de eventos `PostToolUse`, excluye `task-flow` del denominador y añade pruebas de regresión para ambos casos.

La corrección asume que `PostToolUse` representa una observación de edición en los hooks actuales; no prueba que todos los mecanismos de escritura posibles estén instrumentados.

## Impacto sobre la tesis y seguimiento

La señal reduce la confianza en las cifras históricas de cobertura: el valor pasó de aproximadamente 63% a 75,22% con el mismo inventario al eliminar la contaminación por workflow. Los valores históricos deben reinterpretarse, no compararse directamente con los nuevos sin una etiqueta de versión semántica.

Seguimiento verificable: versionar el esquema del KPI o etiquetar el cambio de definición en exportaciones históricas y medir por harness la cobertura de eventos `PostToolUse` frente a `PreToolUse`.