Self-Healing Locator Write-Back

The self-healing locator finds an element at a new place at runtime and logs the heal — but the corrected location was then thrown away, so the next run healed from scratch. RepairStore closes that loop: it records the corrected locator (coordinates / VLM description / method) from a heal, auto-applies it when confidence is high enough, otherwise queues it as a pending suggestion for review. A later run reads the learned fix via RepairStore.resolved().

JSON-backed (via the shared json_store helper); pure standard library; confidence and threshold are explicit, so behavior is deterministic and fully unit-testable. Imports no PySide6.

Headless API

from je_auto_control import RepairStore, repair_from_heal

store = RepairStore("repairs.json")
# high-confidence heal -> applied immediately:
store.record("login_btn", method="vlm", coordinates=[120, 64],
             description="Login", confidence=0.95)
store.resolved("login_btn")        # -> {method, coordinates, description}

# low-confidence heal -> queued for review:
s = store.record("save_btn", method="image", coordinates=[5, 5],
                 confidence=0.5)
store.pending()                    # -> [the save_btn suggestion]
store.approve(s.id)                # now store.resolved("save_btn") works

# straight from a HealEvent (object or dict):
repair_from_heal(heal_event, "login_btn", store=store, confidence=0.9)

record auto-applies when confidence >= auto_threshold (default 0.9), else files a pending suggestion; approve / reject decide queued ones; resolved(key) returns the latest applied/approved corrected locator (or None) — the durable fix a future run reuses instead of re-healing.

Executor commands

Command	Effect
`AC_repair_record`	Persist a corrected locator (auto-apply or queue).
`AC_repair_resolved`	Get the learned corrected locator for a key.
`AC_repair_pending`	List suggestions awaiting review.
`AC_repair_approve`	Approve a pending suggestion.

The same operations are exposed as MCP tools (ac_repair_*) and as Script Builder commands under Tools.