# T017 — Android End-to-End Confirmation (Tier 0-3)

**Goal:** `baolife-fun-balance`  **Task:** T017 (verification only — no product code modified)
**Date:** 2026-05-27
**Author:** GoalBuddy Worker

Honest evidence report. The Android app was built, installed, and launched on a running emulator. The app **renders all the new Tier 0-3 screens in-app** (captured by screenshot), but a live game session against the local Tier 0-3 server was **blocked by an Android cleartext-traffic policy** (not a Tier 0-3 product bug). Server-side oracle behaviors are bound to named passing vitest files; the Android client speaks the **identical WebSocket protocol** the iOS confirmation (T016) used — verified by message-handler and command names in `WebSocketManager.kt` / `WebSocketCommands.kt`.

---

## Environment / setup result

| Item | Result |
|---|---|
| Backend dev server | **UP** — `npm run dev` on `:8001`, DB reachable (44 achievements, 7 daily rewards, 11 quest templates, 59 commands, 6 background jobs). `LISTEN` on `*:8001` confirmed. Log: `/tmp/baolife-dev-t017.log` |
| Android build | **BUILD SUCCESSFUL** — `cd android && ./gradlew :app:assembleDebug` (exit 0). APK: `android/app/build/outputs/apk/debug/app-debug.apk` (28.7 MB). |
| Emulator | **AVAILABLE + BOOTED** — `emulator-5554` (`sdk_gphone64_arm64`, Android 16 / API 36, `sys.boot_completed=1`). AVDs present: `Medium_Phone_API_35`, `Pixel_9_Pro`, `Tester_1..4`. |
| Install | `adb install -r` → **Success**. Package `com.craigvg.lichun_android`. |
| Local-server repoint | **Built-in, no code edit.** `WebSocketManager.serverUrl` reads pref `baolife_e2e/ws_url` first, else falls back to hardcoded `WebSocketEnvironment.PRODUCTION = wss://lichun.app/wss/`. The E2E deep link `baolife://debug/config?wsUrl=...` writes that pref (`MainActivity.applyE2EConfig`). Host reachable from emulator: `nc 10.0.2.2 8001` → **HOST_REACHABLE**. |
| **Live connection** | **BLOCKED (cleartext policy).** With `ws_url=ws://10.0.2.2:8001`, logcat: `WebSocketManager: Connection failed: CLEARTEXT communication to 10.0.2.2 not permitted by network security policy`. The debug build has no `usesCleartextTraffic="true"` / network-security-config, so API 28+ blocks plain `ws://`. Production `wss://` (TLS) is allowed — but **production is a stale branch lacking Tier 0-3** (see below), so connecting to prod would NOT confirm the new behaviors. Per `stop_if`, RUN-connection marked blocked; I did NOT edit the manifest (product code). |

**Production is NOT a valid Tier 0-3 surface.** `ssh lichun-master` git HEAD = `d8fe9981`; `server/src/services/retention/lifeGoals.ts` is **MISSING** on prod (Tier 2-E not deployed). So the only Tier 0-3 backend is the local tree (HEAD `bd8310ad`), which the debug build cannot reach over cleartext.

**Screenshots captured** (under `/tmp/t017-shots/`):
- `01-current.png` — Home "what now" hub while reconnecting: "All caught up!" + **Do an Activity** / **Life Goals** buttons, Stats card (Health/Happiness/Intelligence/**Prestige**), tab bar Home/Activities/Social/Store.
- `02-lifegoals.png` — **Life Goals** screen: "Life Score 0", "Active 0 / Completed 0", empty state "No life goals yet — ... as you grow through each life stage."
- `05-activities.png` — Activities tab: top **"Do an Activity Now"** button + Current/Jobs/Activities/Habits sub-tabs.
- `06-perform-activity.png` — **Do an Activity** (PerformActivityScreen): Study (+Int, 10e), Exercise (+Health -Stress, 15e), Socialize (+Social +Happiness -Stress, 8e), Side Hustle (+Money, Age 14+, 18e), Hobby (+Creativity +Happiness, 6e). Footer: "Activities spend a free slot in your day and apply their effects right away." Buttons gated ("Low energy"/"Age 14+") because no connected character.
- `07-achievements.png` — **Achievement Collection**: "Achievements 0/0 unlocked" progress bar, filter chips All/Career/Relationships/Education/Wealth, empty state.

(Empty/zeroed data on each new screen is expected — they are data-driven by `lifeGoalsUpdate` / `achievementsList` / `playerObject`, which require a connected playing character. The **screens themselves render and navigate correctly**.)

---

## The 10 oracle points — Android classification

The Android client uses the **same backend and the same WS protocol** as iOS. Verified protocol parity in `network/WebSocketManager.kt`: inbound handlers `"lifeSummaryEvent"`, `"offlineDigest"`, `"lifeGoalsUpdate"`, `"achievementsList"`, `"achievementUnlocked"`, `"questionEvent"`, `"messageEvent"`, `"u"`, `"playerObject"`; outbound (`utils/WebSocketCommands.kt`) `performActivity`, `startNewLife`. So the 8 server-side points T016 confirmed via tests apply identically to Android. The 14 oracle-mapped test files were re-run this session against the local Tier 0-3 tree: **14 files / 91 tests, all passed.**

| # | Oracle point | Android classification | Evidence |
|---|---|---|---|
| 1 | Income accrues + expenses paid over time | **CONFIRMED-VIA-BACKEND-TEST** | `tests/game/playerSession.weekTick.test.ts` + `tests/game/weeklyFinances.shared.test.ts` (Fix 0-A: online economy unfrozen, online delta == offline shared delta). Android shows money via `playerObject`/`u` (`GameStateViewModel.money`). Not seen live (no connection). |
| 2 | Negative affinity persists across overnight day-tick | **CONFIRMED-VIA-BACKEND-TEST** | `tests/utils/statUtils.affinity.test.ts` + `tests/game/gameEngine.affinityMirror.test.ts` (Fix 0-B: range -100..100, clampPlayerStats preserves negatives). Android `Person.affinity: Int` carries it verbatim. |
| 3 | Event prompt pauses simulation online | **CONFIRMED-VIA-BACKEND-TEST** | `tests/game/playerSession.promptPause.test.ts` (Fix 0-D: pauses + saves previousGameSpeed; passive resolve does not pause). Android handles `questionEvent` → EventModal; pause is purely server-side. |
| 4 | Onboarding guided actions land correctly | **CONFIRMED-VIA-SOURCE + partial in-app** | The 0-E/0-F fixes were iOS-specific. Android onboarding is its own flow (`ui/screens/onboarding/*`); the launched app showed the home "what now" hub with working Do-an-Activity / Life-Goals navigation and a correct Home/Activities/Social/Store tab bar (`01-current.png`). Android did not have the iOS tab-index bug. Full onboarding walkthrough not exercised (no live character). |
| 5 | Death → summary + score + new-life/legacy | **CONFIRMED-VIA-BACKEND-TEST** (UI present) | `tests/game/death.shared.test.ts`, `tests/services/health/lifeSummary.test.ts`, `tests/handlers/startNewLife.test.ts`, `tests/services/health/legacy.test.ts` (all pass). Android UI present: `ui/screens/character/DeathScreen.kt` auto-routes on `player.status=="dead"` (`MainNavigation.kt:162 "dead" -> nav.resetTo(DeathKey)`); `FamilyTreeScreen.kt` for legacy; handler `lifeSummaryEvent` + outbound `startNewLife`. Not reachable without playing to death. |
| 6 | Welcome-back offline digest | **CONFIRMED-VIA-BACKEND-TEST** (UI present) | `tests/game/offlineDigest.test.ts` (emits + clears one-time). Android UI present: `WelcomeBackOverlay` in `ui/components/ModalOverlayHost.kt`, fed by `offlineDigest` flow + `handleOfflineDigest` handler. Needs a real offline window to fire. |
| 7 | Floating stat deltas / visible feedback | **CONFIRMED-VIA-SOURCE (PARITY AHEAD OF iOS)** | Android **already implements** this (iOS marked it NEEDS-MANUAL). `ui/components/feedback/FloatingDeltaOverlay.kt` observes `GameStateViewModel.statDeltas` and renders chips, rendered at `MainNavigation.kt:523`; deltas emitted in `WebSocketManager` (line ~238) on tracked value changes, model `StatDelta` in `domain/models/Engagement.kt`. Not seen animate live (deltas fire on `u`/`batch_update` from a connected game). |
| 8 | Player-initiated activity | **CONFIRMED-IN-APP** | `06-perform-activity.png`: the **Do an Activity** screen renders the five activity types (study/exercise/socialize/side-hustle/hobby) with energy costs + age gating + "spends a free slot... applies effects right away" copy. Outbound command wired: `GameStateViewModel.performActivity` → `WebSocketCommands.performActivity("activityId")`. Backend: `tests/handlers/performActivity.test.ts` (9 tests pass). Could not submit a real activity (0 energy / disconnected). |
| 9 | Affinity payoff (favors/loans/crisis/inheritance) | **CONFIRMED-VIA-BACKEND-TEST** | `tests/services/relationships/favors.test.ts` + inheritance bias in `tests/services/health/legacy.test.ts` (pass). Android has **no distinct `requestFavor` command** — favors resolve server-side and ripple to the client via `playerObject`/`messageEvent`, which Android handles. So it is surfaced, not client-initiated. Not seen live. |
| 10 | Visible life goals with progress | **CONFIRMED-IN-APP** | `02-lifegoals.png`: **Life Goals** screen renders (Life Score, Active/Completed counts, slate area, empty state). Reachable from Home hub button AND MoreScreen ("Life Goals — Track your long-term aspirations"). Handler `lifeGoalsUpdate` wired. Backend: `tests/services/retention/lifeGoals.test.ts` + `.integration.test.ts` (pass). Slate empty (no connected character). |

**Tally (Android):** CONFIRMED-IN-APP = 2 (points 8, 10) · CONFIRMED-VIA-BACKEND-TEST = 6 (points 1,2,3,5,6,9) · CONFIRMED-VIA-SOURCE = 2 (point 4 onboarding parity + partial in-app; point 7 floating-delta UI present & wired).

> Notable: **point 7 (floating stat deltas) is implemented and wired on Android** — the one point iOS could only mark NEEDS-MANUAL. Android UI parity for the new behaviors is therefore *ahead* of iOS here.

---

## Android UI-parity notes — new screens present in the built app

Confirmed present in source AND in the running build (navigation wired):

| New behavior | Android screen / component | Reachable via |
|---|---|---|
| Life Goals (Tier 2-E) | `ui/screens/retention/LifeGoalsScreen.kt` | Home hub "Life Goals" button + MoreScreen "Life Goals" — **screenshot `02`** |
| Achievement Collection (Tier 2-G) | `ui/screens/retention/AchievementCollectionScreen.kt` (+ `AchievementDetailScreen`, `AchievementUnlockModal`) | MoreScreen "Collection"; deep link `baolife://achievements` — **screenshot `07`** |
| Prestige (Tier 2-G) | `ui/screens/character/PrestigeScreen.kt` | MoreScreen "Prestige — What your prestige unlocks" (`MainNavigation.kt:395/485`); Prestige stat on Home card (screenshot `01`) |
| Perform Activity (Tier 1-C) | `ui/screens/activities/PerformActivityScreen.kt` | Activities tab "Do an Activity Now" + MoreScreen "Do an Activity" — **screenshot `06`** |
| Death summary (Tier 2-A) | `ui/screens/character/DeathScreen.kt` + `domain/models/LifeSummary.kt` | Auto-route on `player.status=="dead"` (`MainNavigation.kt:162`) |
| Legacy / family tree (Tier 2-B) | `ui/screens/character/FamilyTreeScreen.kt` | Character detail |
| Welcome-back digest (Tier 2-C) | `WelcomeBackOverlay` in `ui/components/ModalOverlayHost.kt` | Modal overlay on `offlineDigest` |
| Floating stat deltas (Tier 3-A) | `ui/components/feedback/FloatingDeltaOverlay.kt` | Global overlay (`MainNavigation.kt:523`) |
| Quest depth / daily quests (Tier 2-G) | `ui/screens/retention/DailyQuestsScreen.kt`, `QuestDepthSection.kt`, `DailyRewardsScreen.kt` | MoreScreen |

All new WS message types and commands are handled: `lifeSummaryEvent`, `offlineDigest`, `lifeGoalsUpdate`, `achievementsList/Unlocked`, `questionEvent`; outbound `performActivity`, `startNewLife`.

---

## Limitation found (NOT classified as a Tier 0-3 product bug)

**Android debug build cannot connect to a local cleartext (`ws://`) dev server.** No `usesCleartextTraffic="true"` and no network-security-config in `AndroidManifest.xml`, so API 28+ blocks plain WebSocket to `10.0.2.2:8001`. Production `wss://` (TLS) works, but production is a stale pre-Tier-0-3 branch. This is a debug-build configuration gap, not a Tier 0-3 regression, and is harness-only (production uses TLS). I did NOT modify the manifest (verification-only task). **Recommended follow-up (separate task):** add a debug-only network-security-config (or `usesCleartextTraffic` in the debug manifest) so the existing `baolife://debug/config?wsUrl=` E2E path can drive a local server — this would unblock full in-app run-confirmation of points 1,2,3,5,6,9 on Android, matching the iOS gap.

---

## Bottom line

- **Build: BUILD SUCCESSFUL** (`./gradlew :app:assembleDebug`, exit 0; APK 28.7 MB).
- **Emulator/run: emulator booted, APK installed and launched.** The app renders the home "what now" hub and **all new Tier 0-3 screens** (Life Goals, Achievement Collection, Perform Activity captured by screenshot; Prestige/Death/Legacy/Welcome-back/Floating-deltas confirmed present + nav-wired in source). **A live game session was blocked** by an Android cleartext policy against the local server (production is stale, so not a valid Tier 0-3 surface) — RUN-connection is the only blocked portion.
- **10-point classification: 2 CONFIRMED-IN-APP (8, 10), 6 CONFIRMED-VIA-BACKEND-TEST (1,2,3,5,6,9), 2 CONFIRMED-VIA-SOURCE (4, 7).** Android client speaks the identical protocol; 14 oracle-mapped test files / 91 tests passed on the local Tier 0-3 tree this session. Point 7 (floating deltas) is implemented on Android — parity ahead of iOS.
- **No Tier 0-3 product bug found.** One debug-build cleartext-config gap noted as a follow-up.

Android UI parity for the Tier 0-3 surfacing is **confirmed present in the built app.**