[Client] Mobile

.cursor/rules/deobfuscate-on-learn.mdc

@@ -0,0 +1,37 @@
+---
+description: On any evidenced understanding of obfuscated client code, run void-client-deobfuscate skill
+alwaysApply: true
+---
+
+# Deobfuscate when you learn
+
+When you **figure out** what an obfuscated class / method / field / constant / flow does (call sites, strings, protocol, bit flags — not guesses), **do not leave the names as-is**.
+
+## Mandatory next step
+
+1. Read and follow the skill:
+   `.cursor/skills/void-client-deobfuscate/SKILL.md`
+2. Also follow the workspace rename+comment rule (`void-client-deobfuscate.mdc`).
+3. Apply a small lote: rename with evidence, comment densely, sync reflection strings if needed, verify.
+
+## Triggers (any of these)
+
+- Bugfix that reveals intent (`item` console echo, camera, packets, …)
+- You can explain a `method####` / `anInt####` / `aBoolean####` / opaque class in plain English
+- A misnamed type (e.g. “NumberFormatter” that is actually an item def)
+- User asks to clarify / rename / “desofuscar”
+
+## Do not skip
+
+- Waiting for the user to say `/void-client-deobfuscate` — if you learned it, deobfuscate in the same turn (or immediately after the fix).
+- Renaming without evidence, global replace of non-unique `methodNNN`, or skipping `check_reflection.py` when hosts look up members by string.
+
+## Verify before claiming done
+
+```bash
+python3 .cursor/skills/void-client-deobfuscate/scripts/check_reflection.py
+./gradlew :client:compileJava
+cd ios && ./gradlew compileJava
+```
+
+Commit / push only when the user asks.

.cursor/rules/lean-ctx.mdc

@@ -0,0 +1,38 @@
+---
+description: "lean-ctx hybrid: MUST use ctx_read/ctx_search (MCP) + lean-ctx -c (CLI). NEVER use native Read/Grep/Shell."
+alwaysApply: true
+---
+
+# lean-ctx — Context Engineering Layer
+<!-- lean-ctx-rules-v12 -->
+
+## Mode: Hybrid (MCP reads + CLI shell)
+
+CRITICAL: ALWAYS use lean-ctx tools. This is NOT optional.
+
+## Tool Mapping (MANDATORY)
+| Instead of | MUST USE | Example |
+|------------|----------|---------|
+| Read/cat/head/tail | `ctx_read(path, mode)` | `ctx_read("src/main.rs")` (omit mode = auto) |
+| Grep/rg/find | `ctx_search(pattern, path)` | `ctx_search("fn handle", "src/")` |
+| Shell/bash | `lean-ctx -c "<cmd>"` | `lean-ctx -c "cargo test"` |
+| ls/find | `lean-ctx ls [path]` | `lean-ctx ls src/ --depth 3` |
+| Edit (when Read unavail.) | `ctx_edit(path, old, new)` | `ctx_edit("f.rs", "old", "new")` |
+
+## ctx_read Modes (omit mode to auto-select — recommended)
+| Goal | Mode |
+|------|------|
+| Exploring / unsure (default) | `auto` |
+| Edit target | `full` |
+| API surface | `signatures` |
+| Post-edit check | `diff` |
+| Overview | `map` |
+| Region | `lines:N-M` |
+
+## Workflow: Orient → Locate → Read → Edit → Verify → Record
+Use `ctx_overview` or `ctx_compose` first. Then `ctx_search`/`ctx_semantic_search`.
+Read with `ctx_read(path, mode)`. Edit with native Edit or `ctx_edit`.
+Verify: `ctx_read(path, "diff")` + `lean-ctx -c "test cmd"`.
+
+REMINDER: You MUST use lean-ctx tools. NEVER use native Read, Grep, or Shell directly.
+<!-- /lean-ctx -->

.cursor/rules/lean-ctx.mdc.bak

@@ -0,0 +1,42 @@
+---
+description: "lean-ctx: context compression layer. Tools replace native Read/Grep/Shell — see tool descriptions."
+globs: **/*
+alwaysApply: true
+---
+
+# lean-ctx — Context Engineering Layer
+<!-- lean-ctx-rules-v12 -->
+
+## Tool Mapping (MANDATORY — use instead of native equivalents)
+| Instead of | Use | Example |
+|------------|-----|---------|
+| Read/cat/head/tail | `ctx_read(path, mode)` | `ctx_read("src/main.rs")` (omit mode = auto) |
+| Grep/rg/find | `ctx_search(pattern, path)` | `ctx_search("fn handle", "src/")` |
+| Shell/bash | `ctx_shell(command)` | `ctx_shell("cargo test")` |
+| ls/find (tree) | `lean-ctx ls [path]` or `ctx_tree(path)` | `ctx_tree("src", depth=3)` |
+| Edit (when Read unavailable) | `ctx_edit(path, old, new)` | `ctx_edit("f.rs", "old", "new")` |
+
+## ctx_read Mode Selection (omit mode to auto-select — recommended)
+| Goal | Mode | When |
+|------|------|------|
+| Exploring / unsure | `auto` (default) | Omit mode; system picks optimal |
+| Edit this file | `full` | Right before an edit |
+| Understand API | `signatures` | Context-only, won't edit |
+| Large file overview | `map` | >500 lines, won't edit |
+| Re-read after edit | `diff` | Post-edit verification |
+| Specific region | `lines:N-M` | Know exact location |
+
+## Workflow
+1. **Orient:** `ctx_overview(task)` or `ctx_compose(task, path)`
+2. **Locate:** `ctx_search(pattern, path)` or `ctx_semantic_search(query)`
+3. **Read:** `ctx_read(path, mode)` — pick mode from table above
+4. **Edit:** `ctx_edit(path, old, new)` or native Edit
+5. **Verify:** `ctx_read(path, "diff")` + `ctx_shell("test command")`
+6. **Record:** `ctx_knowledge(action="remember", content="...")`
+
+## Session
+- **Start:** `ctx_session(action="status")` + `ctx_knowledge(action="wakeup")`
+- **End:** `ctx_session(action="decision", content="what was done + next steps")`
+
+NEVER use native Read/Grep/Shell when ctx_* equivalents are available.
+<!-- /lean-ctx -->

.cursor/skills/run-mobile-device/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: run-mobile-device
+description: >-
+  Build, install, and launch Void OSRS on a physical iPad, Apple TV, or Android phone.
+  Use when the user says restart, deploy, run on device, iPad, Apple TV, tvOS,
+  make android, install, or relaunch the mobile client.
+---
+
+# Run Void on device
+
+Game server must already be up on **TCP 43594**.
+
+This skill lives in the **void-client** repo. Run scripts from `void-client/` (this directory).
+
+**Always execute the scripts** (do not paste gradle/signing flags by hand):
+
+| Device | Command | `block_until_ms` |
+| iPad | `bash .cursor/skills/run-mobile-device/scripts/ios-device.sh` | `240000` |
+| Apple TV | `bash .cursor/skills/run-mobile-device/scripts/tvos-device.sh` | `300000` |
+| Android USB | `bash .cursor/skills/run-mobile-device/scripts/android-device.sh` | `180000` |
+
+When the user says **restart** / **deploy** without a platform:
+
+1. Just edited `ios/` for tvOS / Apple TV → tvOS script.
+2. Just edited `ios/` or `GameController.java` → iPad script.
+3. Just edited `android/` or `MainActivity.java` → Android script.
+4. Else: iPad if `xcrun devicectl list devices` shows a physical iPad `available`; else Apple TV if available; else Android if `adb devices` has `device`.
+
+Do **not** use `make ios` for a physical iPad (Simulator only).
+
+## iOS iPad
+
+The script: checks arm64 JDK 17 → **`robovmInstall`** (flat signed bundle in `build/robovm/`) → **always** re-wrap into a fresh `Void.app` → **`devicectl install` + `launch`**.
+
+Do **not** reuse a previous `Void.app` — `robovmInstall` writes beside it; keeping the old wrap installs a stale binary. Do **not** use `launchIOSDevice` (AppLauncher `--console` hangs).
+
+Defaults (override with env):
+
+| Env | Default |
+|-----|---------|
+| `JAVA_17` | `$HOME/.jdks/jdk-17.0.20.1+1/Contents/Home` |
+| `IOS_UDID` | `00008120-000E7D8830214932` (hardware UDID, **not** the `Identifier` from `devicectl list`) |
+| `IOS_SIGN_IDENTITY` | `Apple Development: Matheus Gois (885DD2XQL9)` |
+| `IOS_PROVISIONING_PROFILE` | `bdd4f76c-78f2-493c-b2e0-66f72e688f77` |
+
+If install fails, re-query UDID:
+
+```bash
+xcrun devicectl list devices
+xcrun devicectl device info details --device iPad   # Hardware.UDID
+```
+
+Signing rediscovery: `security find-identity -v -p codesigning`. Team `CTAFH43K36`.
+
+Bundle id: `world.gregs.voidosrs.ios`.
+
+Simulator only if asked: `make ios` / `make ios-relaunch`.
+
+## Apple TV (tvOS)
+
+Same wrap/`devicectl` flow as iPad, but **`-Pvoid.platform=tvos`** → patched RoboVM uses **AppleTVOS.sdk** (`robovm-tvos.xml`, bundle `world.gregs.voidosrs.tvos`).
+
+| Env | Default |
+|-----|---------|
+| `TVOS_UDID` | `7d5160e9f84ba36ad9abee5c1aff2fd89c2e7b07` (TV Sala - Gois) |
+| `TVOS_PROVISIONING_PROFILE` | `39f19b56-ca6f-4e80-90f5-187667971c3e` (tvOS Team Provisioning Profile: *) |
+| `IOS_SIGN_IDENTITY` | same as iPad |
+
+Requires the patched plugin jar (`ios/tools/patches/apply_tvos_robovm_patch.py`). Input: DualShock / Siri Remote (`GCMicroGamepad`) + on-screen keyboard.
+
+```bash
+make tvos-sim     # Apple TV Simulator (simctl; no signing)
+make tvos-device  # physical Apple TV
+```
+
+Simulator note: RoboVM only matches iPhone/iPad device families, so `tvos-sim.sh` builds with `skipLaunch` then installs via `simctl` onto an Apple TV runtime (Mach-O stamped `TVOSSIMULATOR`).
+
+## Android USB
+
+The script refuses to hang if `adb devices` is empty. Then `make android` (installDebug + reverse `:43594` + launch).
+
+- Package `world.gregs.voidosrs.android` / `.MainActivity`
+- USB reverse → phone uses host `127.0.0.1:43594`
+- LAN: `make android-server SERVER_IP=<lan-ip>`
+- Logs: `make android-log`
+- Already installed: `make android-run`
+
+## Server host
+
+Saved in `{user.home}/void-server.txt` (in-app picker). Do not change unless asked.
+
+Overrides: `-Dvoid.server=<host>` (host only, no `http://` / port). Android also `adb shell setprop debug.void.server <host>` then relaunch.

.cursor/skills/run-mobile-device/scripts/android-device.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Install debug APK, adb reverse :43594, launch MainActivity.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+
+devices="$(adb devices | awk 'NR>1 && $2=="device" {print $1}')"
+if [[ -z "$devices" ]]; then
+  echo "no Android device (adb devices empty / unauthorized). Plug in USB and authorize." >&2
+  adb devices -l >&2
+  exit 1
+fi
+
+cd "$ROOT"
+make android
+echo "OK — android launched"

.cursor/skills/run-mobile-device/scripts/inject-tvos-icons.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Compile tvOS brandassets (App Icon + Top Shelf) into Assets.car and merge
+# the actool partial Info.plist into the app. RoboVM's actool always targets
+# iphoneos, so this must run after the .app is assembled.
+set -euo pipefail
+
+APP="${1:?usage: inject-tvos-icons.sh /path/to/Void.app}"
+ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+ASSETS="$ROOT/ios/data/Assets.xcassets"
+TMP="$(mktemp -d "${TMPDIR:-/tmp}/void-tvos-icons.XXXXXX")"
+trap 'rm -rf "$TMP"' EXIT
+
+if [[ ! -d "$ASSETS/App Icon & Top Shelf Image.brandassets" ]]; then
+  echo "missing tvOS brandassets under $ASSETS" >&2
+  exit 1
+fi
+if [[ ! -d "$APP" || ! -f "$APP/Info.plist" ]]; then
+  echo "not an app bundle: $APP" >&2
+  exit 1
+fi
+
+xcrun actool "$ASSETS" \
+  --compile "$TMP" \
+  --platform appletvos \
+  --minimum-deployment-target 13.0 \
+  --target-device tv \
+  --app-icon "App Icon & Top Shelf Image" \
+  --output-partial-info-plist "$TMP/partial.plist" \
+  --compress-pngs \
+  --errors --warnings \
+  --output-format human-readable-text >/dev/null
+
+if [[ ! -f "$TMP/Assets.car" ]]; then
+  echo "actool did not produce Assets.car" >&2
+  exit 1
+fi
+
+cp "$TMP/Assets.car" "$APP/Assets.car"
+
+# Merge CFBundleIcons + TVTopShelfImage from actool partial into Info.plist.
+python3 - "$APP/Info.plist" "$TMP/partial.plist" <<'PY'
+import plistlib, sys
+app_path, partial_path = sys.argv[1], sys.argv[2]
+with open(app_path, "rb") as f:
+    info = plistlib.load(f)
+with open(partial_path, "rb") as f:
+    partial = plistlib.load(f)
+for key in ("CFBundleIcons", "TVTopShelfImage"):
+    if key in partial:
+        info[key] = partial[key]
+info["CFBundleIconName"] = "App Icon & Top Shelf Image"
+with open(app_path, "wb") as f:
+    plistlib.dump(info, f)
+PY
+
+echo "injected tvOS App Icon + Top Shelf into $APP"

.cursor/skills/run-mobile-device/scripts/ios-device.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# Build + sign via robovmInstall, wrap flat installDir into Void.app, then
+# install/launch on iPad via devicectl (no AppLauncher --console hang).
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+IOS="$ROOT/ios"
+INSTALL_DIR="$IOS/build/robovm"
+APP="$INSTALL_DIR/Void.app"
+JAVA_17="${JAVA_17:-$HOME/.jdks/jdk-17.0.20.1+1/Contents/Home}"
+UDID="${IOS_UDID:-00008120-000E7D8830214932}"
+SIGN_ID="${IOS_SIGN_IDENTITY:-Apple Development: Matheus Gois (885DD2XQL9)}"
+PROFILE="${IOS_PROVISIONING_PROFILE:-bdd4f76c-78f2-493c-b2e0-66f72e688f77}"
+BUNDLE="${IOS_BUNDLE:-world.gregs.voidosrs.ios}"
+
+if [[ ! -x "$JAVA_17/bin/java" ]]; then
+  echo "missing arm64 JDK 17 at JAVA_17=$JAVA_17" >&2
+  exit 1
+fi
+if ! "$JAVA_17/bin/java" -XshowSettings:properties -version 2>&1 | grep -q 'os.arch = aarch64'; then
+  echo "JAVA_17 must be arm64 (os.arch=aarch64)" >&2
+  "$JAVA_17/bin/java" -XshowSettings:properties -version 2>&1 | grep os.arch >&2 || true
+  exit 1
+fi
+
+# robovmInstall always writes flat into INSTALL_DIR. A leftover Void.app from the
+# previous wrap makes getAppDir prefer it and our old script would install that
+# stale bundle instead of the freshly linked binary.
+rm -rf "$APP"
+
+cd "$IOS"
+JAVA_HOME="$JAVA_17" PATH="$JAVA_17/bin:$PATH" ./gradlew --no-daemon robovmInstall \
+  -Probovm.arch=arm64 \
+  -Probovm.iosSkipSigning=false \
+  -Probovm.iosSignIdentity="$SIGN_ID" \
+  -Probovm.iosProvisioningProfile="$PROFILE"
+
+if [[ ! -x "$INSTALL_DIR/Void" || ! -f "$INSTALL_DIR/Info.plist" ]]; then
+  echo "build finished but flat install missing ($INSTALL_DIR/Void)" >&2
+  ls -la "$INSTALL_DIR" >&2 || true
+  exit 1
+fi
+
+# Wrap flat installDir → Void.app for devicectl (every run, never reuse stale wrap).
+mkdir -p "$APP"
+shopt -s nullglob
+for item in "$INSTALL_DIR"/*; do
+  base="$(basename "$item")"
+  case "$base" in
+    Void.app|.gitkeep|ipabuild|*.ipa) continue ;;
+  esac
+  mv "$item" "$APP/"
+done
+shopt -u nullglob
+
+if [[ ! -x "$APP/Void" ]]; then
+  echo "failed to assemble $APP" >&2
+  ls -la "$APP" >&2 || true
+  exit 1
+fi
+
+echo "installing $APP ($(du -sh "$APP/Void" | awk '{print $1}'))…"
+xcrun devicectl device install app --device "$UDID" "$APP"
+if ! xcrun devicectl device process launch --device "$UDID" "$BUNDLE"; then
+  echo "install OK — unlock the iPad and relaunch:" >&2
+  echo "  xcrun devicectl device process launch --device $UDID $BUNDLE" >&2
+  exit 1
+fi
+echo "OK — launched $BUNDLE on $UDID"