android: the real client — backend, notifications, Live Update, Glyph

The app module was a design gallery: tokens, type and a dial, with no backend,
no notification and nothing driving the rear matrix. This is the rest of it.

**One engine, three views.** `TimerEngine` lives on the Application, not in a
ViewModel, because the Compose screen, the foreground service's notification
and the Glyph must show the *same* second. Two engines polling the same backend
drift apart within seconds and the user sees a notification disagreeing with
the dial. It polls, ticks from a monotonic anchor, and puts every reply through
`:core`'s `reconcile`.

`pomodoro.state()` does not finish an interval whose time is up — it reports
`remaining_seconds = 0` and waits for a client to call `complete`. The tick
loop does, behind the same re-entry guard `desktop/controller.py` uses, since
without one a 1 Hz tick at zero fires `complete` every second until the reply
lands.

**Notifications.** Two channels, because the running interval must be silent
and its *end* must not; one channel cannot be both, and a user who silences a
buzzing countdown has silenced the only part that mattered. The ongoing one is
an Android 16 Live Update: promotion needs `setOngoing` + `setRequestPromotedOngoing`
+ a `ProgressStyle`, and missing any one renders it as an ordinary notification
with no error and no log. Its segments come from `:core`'s `dialTickCount`, so
the status bar, the dial and the Glyph ring agree on what one tick is worth.

**Glyph.** `GlyphMatrixManager.init()` binds `com.nothing.thirdparty/.GlyphService`
and *discards* the boolean `bindService` returns — so on Android 11+ a missing
`<queries>` entry makes the package invisible, the bind silently fail, and the
matrix stay dark with no exception, no log and `onServiceConnected` never
arriving. That was the whole of "the glyph does not work". The manifest now
declares it and `MatrixGlyphDisplay` checks visibility itself rather than
leaving the next person with the same dead end.

The SDK's licence forbids redistribution (clause 2.1(c)), so the .aar stays
git-ignored and `fetch-glyph-sdk.sh` downloads it. Without it a second source
set compiles a no-op display: the app builds, installs and runs with an inert
rear panel, which is also the correct behaviour on any phone that is not a
Nothing.

Verified on the device (Phone (3), Android 16), debug and release: onboarding
against kadence.timka.su, the Live Update with `shortCriticalText` and a 600s
progress track, the matrix accepting 625-dot frames, tasks opening in the Jira
app, and R8 leaving the DTOs decodable. 225 tests, none needing a device.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

android/fetch-glyph-sdk.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Fetch Nothing's Glyph Matrix SDK into app/libs/.
+#
+# The .aar is not on Maven and its licence (clause 2.1(c)) forbids
+# redistribution, so it cannot be committed — hence this script and the
+# .gitignore entry. Without it the build still works: `app/build.gradle.kts`
+# compiles the no-op display instead and the rear matrix is simply inert.
+#
+#   ./fetch-glyph-sdk.sh        # or: make glyph-sdk
+set -euo pipefail
+
+HERE=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+DEST="$HERE/app/libs/glyph-matrix-sdk-2.0.aar"
+KIT=https://github.com/Nothing-Developer-Programme/GlyphMatrix-Developer-Kit
+RAW="$KIT/raw/main/glyph-matrix-sdk-2.0.aar"
+
+if [[ -f $DEST && ${1:-} != --force ]]; then
+    echo "already present: $DEST"
+    echo "(pass --force to re-download)"
+    exit 0
+fi
+
+mkdir -p "$(dirname "$DEST")"
+echo "downloading the Glyph Matrix SDK from $KIT"
+tmp=$(mktemp)
+trap 'rm -f "$tmp"' EXIT
+curl -fsSL -o "$tmp" "$RAW"
+
+# An .aar is a zip holding classes.jar; a redirect to an HTML error page is not.
+if ! unzip -l "$tmp" 2>/dev/null | grep -q classes.jar; then
+    echo "error: what came back is not an .aar. Download it by hand from" >&2
+    echo "  $KIT" >&2
+    echo "and put it at $DEST" >&2
+    exit 1
+fi
+
+mv "$tmp" "$DEST"
+trap - EXIT
+echo "installed $DEST ($(du -h "$DEST" | cut -f1))"
+echo
+echo "Licence: Nothing's Glyph SDK EULA — see $KIT/blob/main/LICENSE.md."
+echo "It is not redistributable, which is why this file is git-ignored."