complete milestone 1

CLAUDE.md

@@ -186,9 +186,17 @@ The designer-test (`designer-test/`) provides automated UI testing:
 ### Test Architecture
 
 1. **WindowController**: Finds designer window, sends mouse/keyboard events via Windows SendInput API
-2. **HierarchyReader**: Parses UI hierarchy JSON to find elements by ID/class
+2. **HierarchyReader**: Parses UI hierarchy JSON to find elements by ID/class (with retry logic and exponential backoff)
 3. **LogParser**: Monitors log file for navigation events
 4. **TestRunner**: Orchestrates test execution, reports results
+5. **UIInspector**: Dumps UI hierarchy with atomic writes (temp file + rename pattern)
+
+### Key Implementation Details
+
+- **Path Normalization**: RmlUi uses `|` instead of `:` in Windows paths (e.g., `D|\Dev\...`). The UIInspector normalizes paths for correct document matching.
+- **Atomic File Writes**: Hierarchy files are written to `.tmp` then renamed to prevent partial reads.
+- **Retry with Backoff**: HierarchyReader retries up to 10 times with exponential backoff (30ms base) and validates JSON completeness.
+- **Dynamic Back Button**: `GoHome()` finds back buttons from hierarchy by class (`app-bar-nav` or `browser-nav-btn`) instead of fixed coordinates.
 
 ### Writing Tests
 
@@ -291,6 +299,15 @@ Back buttons use `app-bar-nav` class for automated GoHome:
 </div>
 ```
 
+Browser uses `browser-nav-btn` class for its toolbar back button:
+```html
+<div class="app-bar-nav browser-nav-btn" onclick="goBack()">
+    <img src="../../icons/back.tga"/>
+</div>
+```
+
+The test framework's `FindBackButton()` searches for both classes to handle all screen layouts.
+
 ## Material Design Resources
 
 Material Design icons and components are available in the MosisDesigner repository:
@@ -373,6 +390,36 @@ CSS/JS component library implementing Material Design (reference implementation)
 
 ## Android Device Testing
 
+### Prerequisites
+
+```bash
+# Check connected device
+adb devices -l
+
+# Verify Mosis app is installed
+adb shell pm list packages | grep mosis
+```
+
+### Build and Install
+
+```bash
+# Build debug APK
+./gradlew assembleDebug
+
+# Install on device
+adb install -r build/outputs/apk/debug/MosisService-debug.apk
+
+# Launch the app
+adb shell am start -n com.omixlab.mosis/.MainActivity
+```
+
+### Run Gradle Connected Tests
+
+```bash
+# Run all connected Android tests
+./gradlew connectedAndroidTest
+```
+
 ### Event Injection via ADB
 
 Inject touch events for automated testing:
@@ -399,6 +446,48 @@ adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
 | dock-messages | 0.39 | 0.97 |
 | dock-contacts | 0.61 | 0.97 |
 | dock-browser | 0.84 | 0.97 |
+| back-button | 0.10 | 0.05 |
+
+### Full Navigation Test Sequence
+
+```bash
+# Clear logs and run navigation test sequence
+adb logcat -c
+
+# Click Phone dock icon
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.16 --ef y 0.97
+sleep 2
+
+# Click back to return home
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.1 --ef y 0.05
+sleep 2
+
+# Click Messages dock icon
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.39 --ef y 0.97
+sleep 2
+
+# Click back to return home
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.1 --ef y 0.05
+sleep 2
+
+# Click Contacts dock icon
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.61 --ef y 0.97
+sleep 2
+
+# Click back to return home
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.1 --ef y 0.05
+sleep 2
+
+# Click Browser dock icon
+adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
+    --es touch_type "click" --ef x 0.84 --ef y 0.97
+```
 
 ### Reading Logs
 
@@ -406,6 +495,25 @@ adb shell am broadcast -a com.omixlab.mosis.INJECT_TOUCH \
 # Filter for Mosis logs
 adb logcat -s MosisTest ServiceTester RMLUI
 
+# Filter for navigation events
+adb logcat -d | grep -iE "navigat|loaded|goBack|rml"
+
 # Save to file
 adb logcat -s MosisTest > mosis-log.txt
+
+# Clear logs
+adb logcat -c
+```
+
+### Expected Log Output
+
+Successful navigation shows these log patterns:
+```
+RMLUI: navigateTo called with: dialer
+Loading screen: apps/dialer/dialer.rml
+RMLUI: Navigated to: dialer (history depth: 1)
+
+RMLUI: goBack called (history depth: 1)
+Loading screen: apps/home/home.rml
+RMLUI: Back to: home
 ```