Baseline e diff walker
Baseline e diff confrontano due walk autonome per la stessa applicazione. Aiutano a separare finding nuovi, persistenti e risolti e mostrano dove lo stato UI registrato è cambiato.
Una baseline è riferimento di confronto, non certificazione. Pin solo dopo revisione target, stato autenticazione, limiti, finding e copertura.
Flusso consigliato
- Esegui e rivedi walk known-good.
- Pin con
set_walk_baseline. - Deploya cambio ed esegui nuova walk con configurazione comparabile.
- Chiama
diff_walkscon i due ID walk. - Ispeziona report ricorsivo e ogni finding blocker/major.
- Esegui scenari salvati per flussi dove copertura deterministica conta.
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>"
)Limiti identità e confronto
Gli stati sono content-addressed da firme route e DOM. I finding sono uniti con chiavi deduplicazione normalizzate. Questo rende possibili confronti stabili, ma contenuto dinamico può far sembrare nuovo uno schermo logicamente uguale, e normalizzazione può occasionalmente unire o dividere finding in modo inatteso.
Per confronto difendibile, allinea questi input:
- applicazione e ambiente;
- account e ruolo autenticati;
- URL seed e origin consentite;
- modalità walker, limiti stato/profondità/azione e profilo fuzz; e
- feature flag e dati test.
Se quegli input differiscono, documenta la differenza invece di trattare conteggi come segnale regressione qualità release.
Tool disponibili
| Tool | Scopo |
|---|---|
set_walk_baseline | Pin una walk revisionata per chiave owner/app |
get_walk_baseline / list_walk_baselines | Ispeziona riferimenti correnti |
clear_walk_baseline | Rimuove pin senza eliminare walk |
diff_walks | Confronta stati e finding tra due walk possedute |
walk_recursive_report | Renderizza albero stati registrato con annotazioni cambio |
walk_findings_to_tickets | Produce payload tracker per finding selezionati |
run_all_app_scenarios | Accoda scenari salvati per app |
Export ticket restituisce payload JSON per Linear, Jira o GitHub. Non li pubblica. Rivedi titoli, link evidenza, severità, contenuto sensibile, progetto e assignee prima di inviare a tracker esterno.
Interpretazione release
Un segnale candidato utile è:
- nessun finding blocker o major nuovo in copertura comparabile;
- finding targetato appare risolto;
- scenari salvati importanti passano nell’ambiente previsto; e
- qualcuno rivede stati rimossi o copertura ridotta.
Non chiamare release green solo perché findings_new è zero. Login fallito,
timeout precoce, frontiera più piccola o tester non disponibile possono anche
produrre meno finding.