docs: update README, CHANGELOG, CLAUDE.md for v0.22.0

- Tool count 51 → 52, test count 144 → 148
- Added cdp_set_shared_value to CDP tools list
- New benchmark row (Glass UI stories)
- New troubleshooting entries (NativeWind corruption, Reanimated scroll)
- Full CHANGELOG for v0.22.0 with all 13 fixes + security update
- Added expo-blur to tested libraries

Author: Lykhoyda

CHANGELOG.md

@@ -4,6 +4,36 @@ All notable changes to rn-dev-agent will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.22.0] — 2026-04-16
+
+### Added
+- **`cdp_set_shared_value` tool** — Drive Reanimated SharedValue animations by testID for proof captures when gesture/scroll synthesis is unavailable. Walks the React fiber tree, finds the named prop, sets `.value` on the JS thread (D623).
+- **Fast-runner auto-restart** — When fast-runner dies mid-session, `tryFastRunner` automatically attempts one restart using the session's deviceId. `isFastRunnerAvailable()` now probes process liveness via `kill(pid, 0)` instead of just checking state file (D620).
+- **Reload counter + NativeWind corruption warning** — `cdp_status` warns after 5+ `cdp_reload` calls in a session: "NativeWind stylesheet may be corrupted" (D622).
+- **Auto-open device session in Phase 5.5** — The 8-phase pipeline skill now mandates opening a device session at verification start, preventing fallback to bash commands (D619).
+- **9 new unit tests** for deviceId parsing — covers all 4 agent-device response shapes, UDID regex validation, priority ordering, and edge cases. Test count: 139 → 148 (D625).
+
+### Fixed
+- **B103: `cdp_navigate` false success** — Fallback navigation path now verifies the target screen exists in the navigation state after dispatch. Returns error if screen not found in any navigator (D616).
+- **B106: `device_scroll`/`device_swipe` deadlock on Reanimated screens** — Routes through fast-runner HID synthesis when available, bypassing agent-device daemon's `waitForIdle` which deadlocks with Reanimated worklets (D610).
+- **B107: `deviceId` parsing for agent-device v0.8.0** — Parses `data.device_udid`, `data.id`, and `data.device.id` (when object). Prefers `device_udid` over generic `id`. Validates against UDID regex before `ensureFastRunner` (D611, D618).
+- **R2: `device_screenshot` ignores requested path** — Fast-runner screenshot tier now copies the captured PNG to the requested output path instead of always writing to `/tmp` (D617).
+- **R5: Scroll amount semantics diverge** — Dropped `* 2` factor in fast-runner scroll computation to match agent-device daemon's interpretation of `amount` (D621).
+- **MCP-only proof capture enforcement** — Added "Never use `xcrun simctl` for screenshots" and "Never use `sleep` for settling" to skill boundaries (D624).
+
+### Security
+- **hono 4.12.12 → 4.12.14** — Fixes HTML injection in JSX SSR (Dependabot #5). Transitive dep of `@modelcontextprotocol/sdk`.
+
+### Changed
+- MCP tool count: 51 → 52 (`cdp_set_shared_value`). CDP tools: 24 → 25.
+- Plugin version: 0.21.1 → 0.22.0. MCP server: 0.16.0 → 0.17.0.
+- Decisions logged: D610-D625 (16 new).
+
+## [0.21.1] — 2026-04-15
+
+### Fixed
+- **MCP tools unavailable in spawned subagents** (GH #31) — Agents split into protocol playbooks (parent-session-only) and spawnable workers.
+
 ## [0.19.2] — 2026-04-13
 
 ### Fixed

CLAUDE.md

@@ -78,9 +78,9 @@ Fallback: `xcrun simctl` (iOS) + `adb` (Android) for device lifecycle when agent
 
 ### MCP Server (cdp-bridge)
 
-51 tools exposed via MCP:
+52 tools exposed via MCP:
 
-**CDP tools** (24 — React internals via Chrome DevTools Protocol over WebSocket):
+**CDP tools** (25 — React internals via Chrome DevTools Protocol over WebSocket):
 - `cdp_status` — health check with domain capabilities + reconnect state
 - `cdp_connect` / `cdp_disconnect` / `cdp_targets` — connection management
 - `cdp_evaluate` — arbitrary JS execution in Hermes
@@ -95,6 +95,7 @@ Fallback: `xcrun simctl` (iOS) + `adb` (Android) for device lifecycle when agent
 - `cdp_cpu_profile` — CPU profiling with hot function ranking
 - `cdp_object_inspect` — handle-based lazy object inspection
 - `cdp_exception_breakpoint` — catch exceptions with timed capture
+- `cdp_set_shared_value` — set Reanimated SharedValue by testID for proof captures
 - `collect_logs` — parallel multi-source log collection
 
 **Device tools** (14 — native interaction via agent-device CLI):

README.md

@@ -2,7 +2,7 @@
 
 A [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin that turns Claude into a React Native development partner. It explores your codebase, designs architecture, implements features, then **verifies everything live on the simulator** — reading the component tree, store state, and navigation stack through Chrome DevTools Protocol.
 
-**51 MCP tools** | **5 agents** | **13 commands** | **46 best-practice rules** | [Full documentation](https://lykhoyda.github.io/rn-dev-agent/)
+**52 MCP tools** | **5 agents** | **13 commands** | **148 tests** | **46 best-practice rules** | [Full documentation](https://lykhoyda.github.io/rn-dev-agent/)
 
 ---
 
@@ -103,11 +103,11 @@ if (__DEV__) {
 
 ## MCP Tools
 
-51 tools across three layers. [Full reference](https://lykhoyda.github.io/rn-dev-agent/tools/)
+52 tools across three layers. [Full reference](https://lykhoyda.github.io/rn-dev-agent/tools/)
 
 | Category | Count | Examples | Docs |
 |----------|-------|---------|------|
-| **CDP** (React internals) | 24 | `cdp_component_tree`, `cdp_store_state`, `cdp_evaluate`, `cdp_network_body` | [CDP tools](https://lykhoyda.github.io/rn-dev-agent/tools/#cdp-tools) |
+| **CDP** (React internals) | 25 | `cdp_component_tree`, `cdp_store_state`, `cdp_evaluate`, `cdp_set_shared_value` | [CDP tools](https://lykhoyda.github.io/rn-dev-agent/tools/#cdp-tools) |
 | **Device** (native interaction) | 14 | `device_find`, `device_press`, `device_fill`, `device_screenshot` | [Device tools](https://lykhoyda.github.io/rn-dev-agent/tools/#device-tools) |
 | **Testing** (E2E + proof) | 13 | `proof_step`, `cross_platform_verify`, `maestro_run` | [Testing tools](https://lykhoyda.github.io/rn-dev-agent/tools/#testing-tools) |
 
@@ -118,7 +118,7 @@ Claude Code
   ├── Skills (knowledge) + Agents (protocols) + Commands (entry points)
   │
   ├── MCP Server (CDP Bridge) ─── WebSocket → Metro → Hermes CDP
-  │   51 tools: component tree, store state, profiling, network, interaction
+  │   52 tools: component tree, store state, profiling, network, interaction
   │
   └── Bash (device lifecycle)
       xcrun simctl / adb / maestro-runner / agent-device
@@ -130,15 +130,16 @@ Claude Code
 
 ## Benchmarks
 
-35 stories completed on the test app. [Full benchmarks](https://lykhoyda.github.io/rn-dev-agent/benchmarks/)
+38 stories completed on the test app (35 Ralph Loop + 3 Liquid Glass). [Full benchmarks](https://lykhoyda.github.io/rn-dev-agent/benchmarks/)
 
 | Complexity | Time | Crashes | Manual interventions |
 |-----------|------|---------|---------------------|
 | Simple (search, toggle, store) | 3-5 min | 0 | 0 |
 | Medium (forms, charts, lists) | 5-10 min | 0 | 0 |
 | Complex (3-step wizard, onboarding) | 11-25 min | 0 | 0 |
+| Glass UI (BlurView, Reanimated, haptics) | 27-90 min | 0 | 1 (Metro restart) |
 
-**Libraries tested:** react-hook-form, zod, @tanstack/react-query, @gorhom/bottom-sheet, @shopify/flash-list, zustand, react-native-svg, expo-notifications, react-native-reanimated, react-native-gesture-handler, expo-haptics
+**Libraries tested:** react-hook-form, zod, @tanstack/react-query, @gorhom/bottom-sheet, @shopify/flash-list, zustand, react-native-svg, expo-notifications, react-native-reanimated, react-native-gesture-handler, expo-haptics, expo-blur
 
 ## Troubleshooting
 
@@ -151,6 +152,8 @@ Claude Code
 | Plugin not detected | `/plugin install rn-dev-agent@Lykhoyda-rn-dev-agent` then `/reload-plugins` |
 | Tools fail after upgrade | Restart Claude Code ([why](https://lykhoyda.github.io/rn-dev-agent/troubleshooting/)) |
 | Spawned subagent says "MCP tools unavailable" | Never spawn `rn-tester` / `rn-debugger` via Task tool — MCP stdio doesn't propagate to subprocesses (GH #31). Use `/rn-dev-agent:test-feature` or `/rn-dev-agent:debug-screen` instead; protocols run inline in the parent session. |
+| Blank white screen after many reloads | NativeWind stylesheet corruption after 5+ `cdp_reload` cycles. Kill Metro, restart it, relaunch the app. `cdp_status` warns when reload count is high. |
+| `device_scroll` times out on Reanimated screens | agent-device daemon `waitForIdle` deadlocks with Reanimated worklets. Fixed in v0.22.0 — scroll routes through fast-runner HID synthesis. Ensure fast-runner is healthy via device session. |
 
 [Full troubleshooting guide](https://lykhoyda.github.io/rn-dev-agent/troubleshooting/)
 
@@ -171,7 +174,7 @@ cd rn-dev-agent/scripts/cdp-bridge && npm install && npm run build && cd ../..
 cd /path/to/your-rn-app && claude --plugin-dir /path/to/rn-dev-agent
 ```
 
-Tests: `cd scripts/cdp-bridge && npm test` (144 tests, [CI](../../actions))
+Tests: `cd scripts/cdp-bridge && npm test` (148 tests, [CI](../../actions))
 
 ## License