[kapumota]

Objetivo

Implementar un MVP de GuardSketch en userspace antes de intentar una integración eBPF.

Esta fase valida la idea de GuardSketch en una ruta controlada, reproducible y sin dependencias del kernel. El objetivo es reducir riesgo técnico antes de llevar el diseño a eBPF.

Cambios principales

• Se agregó src/agfast_parts/guardsketch.c.
• Se agregó docs/GUARDSKETCH.md.
• Se agregó tests/test_guardsketch.sh.
• Se agregó el target make test-guardsketch.

Alcance técnico

El MVP incluye:

• Bloom por PID.
• Count-Min Sketch pequeño.
• Contador de drops simulado.
• Ventana corta.
• Comparación entre riesgo exacto y riesgo aproximado.
• Prueba autocontenida en userspace.

Validación ejecutada

make clean
make
make test-fastpath
make test-regression
make test-streaming
make test-guardsketch
make clean

Resultado esperado

make test-guardsketch debe compilar el prototipo de GuardSketch como unidad autocontenida y finalizar con:

Pruebas GuardSketch superadas

Estrategia de merge

Para este PR se recomienda usar Merge pull request.

No se recomienda usar Squash and merge, porque esta rama representa una fase completa del proyecto y conviene conservar la trazabilidad técnica.

Alcance excluido

Esta fase no agrega eBPF.

Esta fase no modifica ebpf/.

Esta fase no agrega loader con libbpf.

Esta fase no agrega ring buffer.

Esta fase no agrega mapas eBPF.

Esta fase no integra GuardSketch al CLI principal.

Esta fase no modifica el flujo normal de agfast.

Criterio de aceptación

La Fase 8 se considera correcta si:

• make sigue compilando el proyecto normal.
• make test-fastpath pasa.
• make test-regression pasa.
• make test-streaming pasa.
• make test-guardsketch pasa.
• GuardSketch queda validado primero en userspace.
• No se rompe la preparación eBPF opcional de la Fase 7.