Fix-it release responding to Palace's dogfood report against v0.3.0a2.
One HIGH-severity (type_text was reporting wrong focus signal under HID dispatch), two MEDIUM (OCR confidence on stylized covers, stale-MCP-after-upgrade), and four QoL additions plus a first-pass docs starter set.
Fixed
type_textreportsinjection_methodanddispatch_succeeded. Soft-keyboard heuristic was the wrong signal under HID dispatch — the keystrokes always land but the keyboard isn't drawn. New fields are reliable; the legacykeyboard_visibleandfocused_fieldstay for cliclick-path debugging.- OCR confidence is dictionary-gated. Stylized covers used to OCR as
"Sary of the Canadan liothest"with confidence1.0. Newconfidence_band(high/medium/low) and a clamped legacyconfidencefield flag misreads even when the OCR engine reports high internal confidence.raw_confidenceexposes the unclamped score for diagnostics. - Stale-MCP detection. When the loaded simdrive version differs from the version on disk (after
pip install --upgradewithout restarting), every tool response carries a_simdrive_warningside-channel field flagging the drift.
Added
versionMCP tool. Zero-arg →{version, loaded_at, disk_version, drift}. No more guessing whether the running server matches the on-disk package.clear_fieldMCP tool +type_text(clear_first: true)flag. Sends Cmd-A then delete via HID. Replaces the five-press_key idiom for clearing search fields.- Icon-glyph semantic-name aliases.
find_by_text(marks, "search")now matches the magnifying-glass OCR-misread `"Q/"`. Seed whitelist covers search, back, forward, settings, menu, close, add. Palace can extend. docs/LIMITATIONS.mdanddocs/BEST_PRACTICES.md. First-pass docs covering documentation-only items from the dogfood: Dynamic Island modals, xctrace ceiling, MFA hard-wall, HID + debounce-window rule, text-resolution rapid-cycle fallback.
Install
```bash
pip install --pre --upgrade simdrive
```
After upgrade, restart your MCP host (the new stale-MCP detector will warn you if you forget).
Numbers
- 29 MCP tools (was 27 — added
versionandclear_field) - 91 / 91 unit tests passing (11 new)
- Live smoke verified
type_textreturnsinjection_method="hid"+dispatch_succeeded=Trueon iOS 26.3 sim