Healing rules

Healing means re-finding a step's element after the page changed. When a step no longer resolves because an element moved, was renamed or restyled, the platform re-resolves it, marks the test as healed and records the change for review.

What is healed, what waits

aitp.config.yaml sets the split:

aitp.config.yaml

1heal:2  auto: locator, layout     # what is healed without a human3  review: text, order       # what waits for review4ci:5  failOnHealedPending: true

Setting	Meaning
`heal.auto`	Change types healed without a human.
`heal.review`	Change types that wait for a person to approve.
`ci.failOnHealedPending`	Exit code 2 while healed steps wait for review.

What is never healed

A behaviour change is not healed. If the page does something different, the test fails and goes to triage.

Reviewing healed steps

terminal

$npx aitp heal --review

This lists healed steps since the last run for approval.