Update README and documentation for LOTL onion, fleet intelligence, and AI control

android/README.md

@@ -2,13 +2,16 @@
 
 Install the APK on **your own devices** so the embedded fleet agent joins the command-deck fleet table over WebSocket/C2. CPU mining is **off by default** in the baked config.
 
+Main project overview: [`README.md`](../README.md) · test coverage: [`tests/README.md`](../tests/README.md#apk-fleet-node-mode).
+
 ## Build
 
 Requirements:
 
 - Go 1.26+
+- **JDK 17+** (Android Gradle Plugin 8.x; Java 8 on PATH is not sufficient)
 - Android SDK (`ANDROID_HOME` or `ANDROID_SDK_ROOT`)
-- Gradle wrapper in `agent-app/` (generate once with `gradle wrapper` if missing)
+- Gradle wrapper in `agent-app/` (included; downloads Gradle 8.2 on first run)
 
 ```powershell
 # Windows
@@ -63,6 +66,7 @@ After permissions, a low-priority persistent notification (**Fleet sync**) keeps
 1. `AgentService` extracts `assets/agent` (linux/arm64) to `filesDir/bin/agent-arm64`, marks it executable, and spawns it with `--run`.
 2. Environment sets `HOME`/`TMPDIR` to the app private files directory.
 3. The agent uses forge-baked `builtin.go` values (server URL, worker name, fleet secret). Mining defaults to idle with `IdleThresholdPct: 0` (no CPU mining unless re-forged or changed by policy).
+4. Wrapper sets `AETHERFORGE_PLATFORM=android` before spawn — Crucible shows 🤖, Access Depth uses Wi-Fi/battery/foreground probes, shortened mining onion (foreground service → in-process CPU).
 
 ## Limitations
 
@@ -78,4 +82,9 @@ go test ./android/forge/... -count=1
 bash android/smoke-gradle.sh
 ```
 
+```powershell
+go test ./android/forge/... -count=1
+.\android\smoke-gradle.ps1
+```
+
 `smoke-gradle.sh` validates the Gradle project layout and runs `./gradlew help` when the wrapper is present.