tasks: scope 14 — overview pane as phone app grid

Stock ii overview is a desktop workspace pane; on the phone the useful
half is the search. Task swaps the body for a paged icon grid off the
existing LauncherApps desktop-entry service; appgrid (xarbit plasma6
applet) is layout prior art only. OSK/focus-grab patch constraints
called out in-file — that history must not be re-learned the hard way.

docs/tasks/14-overview-appgrid.md

@@ -0,0 +1,50 @@
+# TASK 14 — Overview pane → phone app grid
+
+**Status:** open. Scoped 2026-07-20 from Casey's ask: make the overview
+actually useful on a phone, appgrid-shaped.
+
+## Goal
+
+The shell's overview (`~/.config/quickshell/souveraine/modules/ii/overview/`)
+is stock ii's *desktop* overview — workspace thumbnails + search — patched
+for OSK behavior. On a 5.5" phone the workspace grid is dead weight. Replace
+the pane's body with a paged app grid (the thing a phone home key opens):
+icon grid from the desktop-entry list, alphabetical, paged horizontally,
+long-press for app actions later. Search stays exactly as-is on top — it
+already works and the OSK dance is already solved there.
+
+## Prior art
+
+- `xarbit/plasma6-applet-appgrid` (GitHub) — KDE Plasma 6 applet; steal the
+  layout ideas (grid sizing, page dots, keyboard-less navigation), not code
+  (QML but Plasma-API-bound, and we are not Plasma).
+- In-tree: `services/LauncherApps.qml` (41 lines — already exposes the
+  desktop-entry list the dock/launcher uses) and the overview's
+  `SearchWidget.qml` for how results launch apps.
+- Local reference snapshots in `~/Downloads` / `~/Projects` (Casey: various
+  launcher implementations worth a skim before layout decisions).
+
+## Context / constraints
+
+- The overview files carry a load-bearing 2026-07-07 patch: OSK open/close
+  sync and the focus-grab opt-out (wvkbd/squeekboard can't join Hyprland's
+  focus-grab whitelist). Read the header comments in `Overview.qml` and
+  `OnScreenKeyboard.qml` before touching dismissal logic — two shield-window
+  attempts already failed on device.
+- Icon theme: shell now runs with `QS_ICON_THEME=Papirus-Dark` (drop-in on
+  `souveraine-shell.service`); app icons in /usr/local and ~/.local hicolor
+  prefixes need index.theme present (deploy scripts seed it).
+- Keep the diff-against-upstream-ii discipline: new grid lives in its own
+  QML file(s); Overview.qml only swaps the body widget, so ii updates stay
+  mergeable.
+
+## Acceptance
+
+Overview open → app grid visible, correct icons, tap launches, search still
+works with OSK, close behaves (Escape / toggle / launch). No regression in
+the OSK-open dismissal behavior.
+
+## Connects to
+
+TASK-04 (notification server — same shell), the OSK floating-panel bug
+(separate thread; squeekboard anchoring), launcher desktop-entry hygiene.

docs/tasks/README.md

@@ -22,6 +22,7 @@ plus open threads from the 2026-07-17 session.
 | 9 | [Suspend-resume FTS calibration race](09-suspend-resume-fts.md) | interim-fix | kernel-side; cold-boot only |
 | 12 | [Face auth as a capability factor (Gaze reference)](12-gaze-reference-face-auth.md) | open | per-target: phone needs front-cam bring-up |
 | 13 | [Active Edge (squeeze) as a sensor input](13-active-edge-squeeze.md) | open | substrate up; bring-up unit not drafted |
+| 14 | [Overview pane → phone app grid](14-overview-appgrid.md) | open | shell-side; appgrid prior art linked in-file |
 
 Archived (see `archive/`): 06 qtpim build — retired 2026-07-20, qtpim is
 no longer the contacts path; 10 boot chain — done, we ship our own