Review: UI fixes, search, pet care, chat, settings, and audits (#18)

## Summary

Draft PR for branch \cursor-review-implement\ into \main\.

### Included work (existing commits only)
- Audits, integration test harness, bootstrap, theme switching, and
related project updates.
- Attachments flow and chat UX, pet selectors, achievements/badges in
settings, search fixes, and other UI/controller changes from the review
pass.

### Notes
- Opened as **draft** for review; no additional commits were made for
this PR.

### How to verify
- \lutter analyze\
- Run on Android emulator and spot-check: Home, Search, Discovery, Pet
Care, Chat, Settings, notifications.

Made with [Cursor](https://cursor.com)

Author: syed-reza98

.agents/skills/android-adb/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: android-adb
+description: Android device control via raw ADB commands. Use for device/emulator discovery, USB or Wi-Fi connection, app launch/force-stop, tap/swipe/keyevent/text input, screenshots, UI hierarchy dump, and ADB troubleshooting.
+---
+
+# Android ADB
+
+Reference for controlling Android devices with raw `adb` commands.
+
+## Execution Constraints
+
+- Use `adb -s <serial>` whenever more than one device is connected.
+- Confirm screen resolution before coordinate actions: `adb -s SERIAL shell wm size`.
+- Ask for missing required inputs before executing (serial, package/activity, coordinates, APK path).
+- Surface actionable stderr on failure (authorization, cable/network, tcpip state).
+- Prefer ADB Keyboard broadcast for CJK and special character input when ADB Keyboard is installed.
+
+## Device And Server
+
+```bash
+# Start ADB server
+adb start-server
+
+# Stop ADB server
+adb kill-server
+
+# List devices
+adb devices -l
+
+# Target a specific device (use when multiple devices are online)
+adb -s SERIAL <command>
+```
+
+## Wi-Fi Connection
+
+```bash
+# Enable tcpip (USB required first)
+adb -s SERIAL tcpip 5555
+
+# Get device IP
+adb -s SERIAL shell ip route | grep src
+# or
+adb -s SERIAL shell ip addr show wlan0
+
+# Connect over network
+adb connect <ip>:5555
+
+# Disconnect
+adb disconnect <ip>:5555
+```
+
+## Device State
+
+```bash
+# Screen size
+adb -s SERIAL shell wm size
+
+# Current foreground app (package/activity from mCurrentFocus)
+adb -s SERIAL shell dumpsys window | grep -E 'mCurrentFocus|mFocusedApp'
+
+# Get home launcher package (for back-home detection)
+adb -s SERIAL shell cmd package resolve-activity --brief -c android.intent.category.HOME
+
+# Raw shell command
+adb -s SERIAL shell <command>
+```
+
+## App Lifecycle
+
+```bash
+# Verify package installed
+adb -s SERIAL shell pm list packages | grep <package>
+
+# Launch by package (via monkey)
+adb -s SERIAL shell monkey -p <package> -c android.intent.category.LAUNCHER 1
+
+# Launch by activity
+adb -s SERIAL shell am start -W -n <package>/<activity>
+
+# Launch by URI/scheme
+adb -s SERIAL shell am start -W -a android.intent.action.VIEW -d "<scheme://path>"
+
+# Force-stop
+adb -s SERIAL shell am force-stop <package>
+```
+
+## Input Actions
+
+```bash
+# Tap
+adb -s SERIAL shell input tap X Y
+
+# Double tap (two taps with short delay)
+adb -s SERIAL shell input tap X Y && sleep 0.1 && adb -s SERIAL shell input tap X Y
+
+# Long press (swipe to same point with duration)
+adb -s SERIAL shell input swipe X Y X Y 3000
+
+# Swipe
+adb -s SERIAL shell input swipe X1 Y1 X2 Y2 [duration_ms]
+
+# Key event
+adb -s SERIAL shell input keyevent KEYCODE_BACK
+adb -s SERIAL shell input keyevent KEYCODE_HOME
+adb -s SERIAL shell input keyevent KEYCODE_ENTER
+
+# Return to home (press BACK repeatedly, check foreground against home launcher)
+for i in $(seq 1 20); do
+  adb -s SERIAL shell input keyevent KEYCODE_BACK
+  sleep 0.5
+  # Check if home reached by comparing current focus to home package
+  CURRENT=$(adb -s SERIAL shell dumpsys window | grep mCurrentFocus)
+  echo "Round $i: $CURRENT"
+done
+```
+
+## Text Input
+
+```bash
+# Plain text input (ASCII only, spaces escaped as %s)
+adb -s SERIAL shell input text "hello%sworld"
+
+# Input via ADB Keyboard (supports CJK and special characters)
+# First ensure ADB Keyboard is active:
+adb -s SERIAL shell ime set com.android.adbkeyboard/.AdbIME
+# Then send text (base64 encoded):
+adb -s SERIAL shell am broadcast -a ADB_INPUT_B64 --es msg "$(echo -n 'your text' | base64)"
+
+# Clear text via ADB Keyboard
+adb -s SERIAL shell am broadcast -a ADB_CLEAR_TEXT
+```
+
+## Screenshot And UI Tree
+
+```bash
+# Screenshot to local file
+adb -s SERIAL exec-out screencap -p > screenshot.png
+
+# Screenshot to device then pull
+adb -s SERIAL shell screencap -p /sdcard/screen.png
+adb -s SERIAL pull /sdcard/screen.png ./screen.png
+
+# Dump UI hierarchy XML
+adb -s SERIAL shell uiautomator dump /sdcard/window_dump.xml
+adb -s SERIAL pull /sdcard/window_dump.xml ./window_dump.xml
+```
+
+## App Install And Uninstall
+
+```bash
+# Install APK (replace existing)
+adb -s SERIAL install -r /path/to/app.apk
+
+# Uninstall
+adb -s SERIAL uninstall <package>
+```
+
+## Common Keycodes
+
+| Keycode | Description |
+|---------|-------------|
+| `KEYCODE_BACK` | Back button |
+| `KEYCODE_HOME` | Home button |
+| `KEYCODE_ENTER` | Enter/confirm |
+| `KEYCODE_DEL` | Delete/backspace |
+| `KEYCODE_VOLUME_UP` | Volume up |
+| `KEYCODE_VOLUME_DOWN` | Volume down |
+| `KEYCODE_POWER` | Power button |
+| `KEYCODE_TAB` | Tab key |
+| `KEYCODE_ESCAPE` | Escape key |

.claude/skills/android-adb

@@ -0,0 +1 @@
+../../.agents/skills/android-adb

.claude/skills/android-emulator-skill/scripts/emu_health_check.ps1

@@ -1,4 +1,4 @@
-`<#
+<#
 .SYNOPSIS
 Android Emulator Testing Environment Health Check
 
@@ -109,7 +109,7 @@ if (Get-Command adb -ErrorAction SilentlyContinue) {
     if (-not [string]::IsNullOrWhiteSpace($env:ANDROID_HOME)) {
         $platformToolsPath = Join-Path $env:ANDROID_HOME 'platform-tools'
         if ((Test-Path (Join-Path $platformToolsPath 'adb.exe')) -or (Test-Path (Join-Path $platformToolsPath 'adb'))) {
-            $env:PATH += ";$platformToolsPath"
+            $env:PATH = $env:PATH + ';' + $platformToolsPath
             Check-Warning "ADB found in SDK but not in PATH. Adding it temporarily."
             Check-Passed "ADB is installed"
         } else {
@@ -138,7 +138,7 @@ if (Get-Command emulator -ErrorAction SilentlyContinue) {
     if (-not [string]::IsNullOrWhiteSpace($env:ANDROID_HOME)) {
         $emulatorPath = Join-Path $env:ANDROID_HOME 'emulator'
         if ((Test-Path (Join-Path $emulatorPath 'emulator.exe')) -or (Test-Path (Join-Path $emulatorPath 'emulator'))) {
-            $env:PATH += ";$emulatorPath"
+            $env:PATH = $env:PATH + ';' + $emulatorPath
             Check-Warning "Emulator found in SDK but not in PATH. Adding it temporarily."
             Check-Passed "Emulator is installed"
         } else {

.codex

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "appium-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "appium-mcp@latest"
+      ]
+    }
+  }
+}

.gemini/settings.json

@@ -37,6 +37,9 @@ jobs:
   build:
     runs-on: macos-latest
     timeout-minutes: 30
+    env:
+      SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+      SUPABASE_ANON_KEY: ${{ secrets.SUPABASE_ANON_KEY }}
 
     steps:
       - name: Checkout repository
@@ -195,7 +198,9 @@ jobs:
               flutter build ios --no-codesign --simulator
             else
               echo "Building Flutter iOS Release..."
-              flutter build ios --release --no-codesign
+              flutter build ios --release --no-codesign \
+                --dart-define=SUPABASE_URL="$SUPABASE_URL" \
+                --dart-define=SUPABASE_ANON_KEY="$SUPABASE_ANON_KEY"
             fi
             cd "$IOS_PATH"
           elif [ "$PROJECT_TYPE" = "reactnative" ] || [ "$PROJECT_TYPE" = "expo" ]; then

.github/workflows/ios-build.yml

@@ -32,6 +32,7 @@ migrate_working_dir/
 .pub/
 /build/
 /coverage/
+config/dart_define.json
 
 # Symbolication related
 app.*.symbols

.gitignore

@@ -0,0 +1 @@
+../../.agents/skills/android-adb