Líneas base y diffs del walker
Las líneas base y diffs comparan dos walks autónomos para la misma aplicación. Ayudan a separar hallazgos nuevos, persistentes y resueltos y muestran dónde cambió el estado UI registrado.
Una línea base es una referencia de comparación, no una certificación. Fíjala solo tras revisar su objetivo, estado de autenticación, límites, hallazgos y cobertura.
Flujo recomendado
- Ejecuta y revisa un walk conocido como bueno.
- Fíjalo con
set_walk_baseline. - Despliega un cambio y ejecuta un walk nuevo con configuración comparable.
- Llama
diff_walkscon los dos ID de walk. - Inspecciona el informe recursivo y todo hallazgo blocker/major.
- Ejecuta escenarios guardados para flujos donde importa cobertura determinista.
set_walk_baseline(
walk_id="<reviewed-walk>",
app_name="my-app",
notes="Reviewed staging reference for revision <sha>"
)
diff_walks(
base_walk_id="<reviewed-walk>",
new_walk_id="<candidate-walk>"
)Límites de identidad y comparación
Los estados tienen dirección por contenido desde firmas de ruta y DOM. Los hallazgos se unen con claves de deduplicación normalizadas. Eso hace posibles comparaciones estables, pero el contenido dinámico aún puede hacer que una pantalla lógica parezca nueva, y la normalización puede ocasionalmente fusionar o dividir hallazgos de forma inesperada.
Para una comparación defendible, mantén alineadas estas entradas:
- aplicación y entorno;
- cuenta y rol autenticados;
- URL seed y orígenes permitidos;
- modo walker, límites de estado/profundidad/acción y perfil fuzz; y
- feature flags y datos de prueba.
Si esas entradas difieren, documenta la diferencia en lugar de tratar conteos como señal de regresión con calidad de release.
Herramientas disponibles
| Tool | Purpose |
|---|---|
set_walk_baseline | Pin one reviewed walk per owner/app key |
get_walk_baseline / list_walk_baselines | Inspect current references |
clear_walk_baseline | Remove a pin without deleting the walk |
diff_walks | Compare states and findings across two owned walks |
walk_recursive_report | Render the recorded state tree with change annotations |
walk_findings_to_tickets | Produce tracker payloads for selected findings |
run_all_app_scenarios | Queue the saved scenarios for an app |
La exportación a tickets devuelve payloads JSON para Linear, Jira o GitHub. No los publica. Revisa títulos, enlaces de evidencia, severidad, contenido sensible, proyecto y asignado antes de enviar algo a un tracker externo.
Interpretación de release
Una señal útil de candidato es:
- ningún hallazgo blocker o major nuevo en cobertura comparable;
- el hallazgo objetivo aparece resuelto;
- escenarios guardados importantes pasan en el entorno previsto; y
- alguien revisa estados eliminados o cobertura reducida.
No llames verde a un release solo porque findings_new es cero. Un login fallido, timeout temprano, frontera más pequeña o tester no disponible también pueden producir menos hallazgos.