[kapumota]

Objetivo

Agregar CI/CD visible con GitHub Actions para validar automáticamente AgentGuard FastPath en cada push y pull request.

Esta fase fortalece el proyecto antes del release v1.0.0, porque permite que un evaluador externo vea que el proyecto compila, ejecuta pruebas y mantiene una ruta de calidad reproducible.

Cambios principales

• Se agregó .github/workflows/agfast-quality.yml.
• Se agregó docs/CI.md.
• Se agregó badge de calidad en README.md.
• Se conserva el workflow existente de seguridad y análisis estático.
• Se agrega un workflow específico para pruebas, evaluación y calidad de agfast.

Validaciones cubiertas por el workflow

El workflow ejecuta:

make clean
make
make test-fastpath
make test-regression
make test-streaming
make test-guardsketch
make test-unit
bash scripts/run_evaluation.sh
make clean

Evaluación experimental en CI

Para evitar tiempos excesivos en GitHub Actions, la evaluación usa un dataset reducido:

AGFAST_EVAL_EVENTS=10000
AGFAST_EVAL_PIDS=300
AGFAST_EVAL_DIR=/tmp/agfast_ci_evaluacion

Esto permite validar el flujo experimental sin versionar resultados generados ni hacer lento cada PR.

Valgrind

Valgrind queda como job separado y opcional.

Se ejecuta en:

• ejecución manual;
• ejecución programada semanal.

Esto evita ralentizar cada push o PR, pero mantiene disponible una validación más profunda de memoria.

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

Esta fase no modifica src/.

Esta fase no modifica tests existentes.

Esta fase no modifica scripts/run_evaluation.sh.

Esta fase no modifica benchmarks.

Esta fase no cambia la lógica de detección.

Esta fase agrega automatización de calidad y documentación de CI.

Criterio de aceptación

La Fase 9.2 se considera correcta si:

• GitHub Actions muestra el workflow AGFast Quality.
• El workflow se ejecuta en pull requests hacia main.
• El workflow se ejecuta en ramas fase-*.
• El badge aparece en README.md.
• El job principal compila y pasa pruebas.
• El job de Valgrind queda disponible como ejecución manual o programada.
• git status --short queda limpio después de make clean.