[ymote]

Integrates the five phone-shell branches into feat/mobile-shell (merge commits, one per branch, in the order gestures → shade → pages → island → groups), connects the seams between them, and verifies the combined shell on the desktop captures and on the OnePlus (bf0a4730, 1080x2340).

Gesture layer (src/mobile_gestures.rs, PR #21)

GestureRecognizer is the single owner of the shell's finger: bottom band → HomeUp / held → Switcher / horizontal flick → QuickSwitch; top band → ShadePull (left half notifications, right half controls); side bands → Back; the home page body → PageSwipe / HomeSearch. Every surface reads PhoneState::gesture_out (the live gesture each frame, then Commit/Cancel for exactly one stepped frame, then None). Exclusion zones let an app own an edge (ClientSlot::owns_edges), and the keyboard owns the bottom band. Logs wm: gesture commit … / wm: gesture cancel ….
Verified on device: commit HomeUp from App|Drawer|Recents, HomeUp { progress: 1.0, held: true } → commit Switcher from App (int-4-recents.png), commit QuickSwitch(Right) from App (int-4-quickswitch.png, Sheets brought back over Reference). Not verified: Back from the left edge (Android's own gesture nav eats x<67).

Shade (src/mobile_shade.rs, PR #19)

Notifications sheet on the left half, controls (brightness/volume sliders, Wi-Fi/Bluetooth/Torch/Rotation/DND toggles) on the right; opens from ShadePull/Commit(Shade), pages switch with a sideways drag or PageSwipe while open, closes with an upward drag/flick or a tap on the dimmed backdrop; WmRequest::Notify and notify() post cards; the bar's battery mirrors in. Frosted backdrop of the finished scene.
Verified on device: commit Shade(Notifications) from Home → int-1-shade-notif.png (three cards, Clear all), commit Shade(Controls) from Home → int-1-shade-controls.png (62 % / 45 %, Wi-Fi active), swipe up → int-1-closed-a.png / int-1-closed-b.png (home again). Desktop: int-shade-notif.png, int-shade-controls.png.

Home pages (src/mobile_pages.rs, PR #18)

The pager: glance page left of page 0 (date, running apps, the glance feed), the favorites that overflow page 0 on spill pages, the App Library stand-in at the right end; PageSwipe drags, Commit(Page) animates one position, reaching the library position opens the existing Drawer; indicator dots tap to jump; page:<n> test action.
Verified on device (commit Page(Right) from Home, Page(Left), Page(Left)): int-2b-glance.png (At a glance, "4 apps"), int-2b-back-home.png (page 0), int-2b-drawer.png (Search apps + the four apps). Desktop: int-page-glance.png.

Live island (src/mobile_island.rs, PR #17)

A pill under the status bar for live activities (elapsed, segmented progress, countdown), expanding to a card with actions; producers post Reports from anywhere (install_producers(), the AppCard ActivityReporter behind app-appcard); three quick taps on the clock push the demo; docks with a shade pull and hides while the shade is open.
Verified on device: int-3-pill.png (AppCard glyph, "Fetching forecast", the dot ring, two sibling dots), int-3-expanded.png (Writing weather card 00:05 / Fetching forecast 1/3 + Open / Pomodoro 24:54 + Stop), int-3-shade-over-pill.png (pill gone under the sheet), int-3-pill-back.png (pill back after the sheet closes; one sibling finished meanwhile). Also visible above the apps in int-4-split.png. Desktop: int-island-demo.png, int-island-expand.png.

Tile groups (src/mobile_groups.rs, PR #20)

Group chips in the page-0 tile layout ("Work / App pair", "Media / App pair"), a frosted sub-window with member cells and "Open both", app pairs as a split screen with a draggable divider (its band is an exclusion zone), a Split button on Recents cards to pair from there; leaving the app screen or Commit(HomeUp) ends the split. phone:<ios|android>, group:<name>, split:<a>,<b> test actions.
Verified on device: int-4-group-open.png (Work: Sheets, Reference, Open both), int-4-split.png (Sheets live in the top half, Reference in the bottom, divider pill; log split screen 1 | 2), int-4-home-from-split.png (bottom swipe leaves the split). Desktop: int-groups-home.png, int-groups-open.png, int-groups-split.png.

Seams connected (separate commits after the merges)

• Exclusion zones: draw_phone_scene clears once per frame, then the shade's sheet, the split divider, edge-owning apps and the keyboard add. The shade and the groups used to remove-and-re-add inside step, which ran before the draw-time clear, so their zones never survived to a touch.
• Island → shade: PhoneState::step drains mobile_island::take_docked() into ShadeState::post (absorb_docked, unit-tested), stamped on the shade's clock; island.set_shade_open(shade.wants_open()) every frame so the pill hides under the open sheet and returns as it closes (a pull in progress still docks the pill).
• Hit order: the closed shade's status-bar tap targets are registered right after the status bar, under the island's clock/pill hits (hits are last-wins) — before this the triple-tap and the pill tap opened the shade. A drag starting on those halves is the recognizer's ShadePull; a finger on the open sheet releases the recognizer at Down.
• Commit delivered once: the frame handler aged gesture_out after phone.step, so every Commit/Cancel reached the surfaces on two frames — the pager jumped two positions per swipe (glance straight into the drawer on the phone). The ageing now runs before the step.
• A vertical swipe over a notification card pulls the sheet shut (sideways still slides the card).
• The old mobile_app.rs swipe-left → Drawer fallback was already gone with the recognizer; the pager's library position opens the Drawer.
• Overlay order: apps/home → island → groups overlay → keyboard → shade (topmost). Group chips ride the pager's page-0 translation.

Known limits

• Android's own gesture navigation eats swipes from x<67 and from y≥2278 / y<80: the left-edge Back cannot be driven or used on this device; bottom swipes are started at y=2260.
• The shade's frosted backdrop is vertically flipped on Android (the GL snapshot is upside down; visible in int-1-shade-notif.png as the mirrored clock).
• AppCard's own notifications are not mirrored into the shade; only activities the island drops on overflow are docked.
• fetch activities are not produced by any real source yet (the demo's "Fetching forecast" is the only one).
• The island demo re-pushes the same three ids, so the dock-on-overflow path was exercised by the unit test, not on the device.

Tests

cargo test (default members): 254 passed, 0 failed (252 after the merges, +1 card-swipe close, +1 island→shade seam). cargo check --features app-appcard and cargo check -p octosense --features mobile-apps clean. Phone APK built with the bundled liboctos.so and the AppCard, Sheets, Reference and Photos modules linked; logcat shows no panic across the run.

🤖 Generated with Claude Code

[ymote]

Closing as superseded: every commit in this stack (#22–#28) is already on OctoSense-ROM main, where the phone shell continued. Per ADR 0001 the phone layer moves into the shared crates/shell from that copy when OctoSense-Desktop and OctoSense-ROM are merged into one OctoSense repository, so nothing here is lost. #25's octos-app pin is obsolete: AppCard now comes from OctoSense-System-Apps on octos main. The branches are kept.

🤖 Generated with Claude Code