The companion half of the ring protocol, offered less as finished UI than as
an executable answer to "what does this ring data actually mean" -- the part
that took two sessions to work out and that a future contributor would
otherwise have to redo.
- app/health/: wire->domain conversion, an append-only on-device store with
deduping ingest, rollups, a per-day step-bucket ledger, sleep stage mapping
(0=wake 1=REM 2=light 3=deep, verified against 34 real nights), and chart
derivations.
- app/apps/health/: a glasses glance page over that store.
- tools/health-preview.cjs: renders the real chart code headlessly, so layout
can be checked without an emulator.
- 26 new tests, all passing.
Three clock frames meet in this data and mixing them up causes real bugs, so
they are documented at each site. The ring's clock is deliberately set to
now + 4h (matching what a real Even write carries), so every timestamp it
reports is in that shifted frame and must be corrected on read. Sleep is the
exception: it needs -8h, twice the correction, confirmed against a known
night. Why the ring wants these quantities is unexplained -- the code says so
rather than inventing a tidy mechanism, because the tidy story was tried and
measurement falsified it.
Collection runs on a wall-clock-aligned tick at :01 and :31. Aligned because
the ring's step buckets close on 10-minute boundaries, and because an elapsed
timer drifts off the boundary it is meant to track; offset by a minute because
firing exactly on the boundary risks catching a bucket before it is finalised.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Correctness:
- Pair-glasses flows no longer strand the app in the manual-disconnected
state: the pre-scan disconnect is followed by resumeAutoReconnect(), and
the config page's scan hand-off drops the live link too.
- The mixed-arms serial warning is reachable now: pairs() groups by the
canonical serial key, and a lone left + lone right with different serials
get the mismatch warning on both rows (it previously required two
different serials inside one serial-keyed group, which cannot happen).
- A selected pair that degrades to one arm (prune while the page is open)
is deselected, and Save never pads a missing arm from stored addresses.
- DiscoveryAggregator.ingest no longer lets a bonded re-emit or split
advertisement overwrite the note/name/flag learned from a full
advertisement, and reclassifies split reports using remembered fields so
a nameless half doesn't drop the arm.
- estimateProximity ignores the advertised TX Power Level (radiated power,
not measured-power-at-1m); the calibration table is the only reference.
- Saving a ring without a glasses pair updates the stored identity's ring
name/address instead of leaving the previous ring on record.
- Ring detection requires the stock "EVEN R1" name prefix in both the TS
classifier and the Java pre-filter; a bare "R1" substring matched
unrelated devices, and ring rows are always selectable.
- One-shot scans keep every sample (buildAddressSet merges them through
DiscoveryAggregator), and flash-flow address resolution takes left/right
from one serial-joined complete pair instead of latest-per-role.
Lifecycle:
- The pairing scan and its refresh timer pause on app suspend and resume
with the app, and the model's app-event hooks are detached when the page
is left for good.
Cleanup:
- One MAC normalizer (even-advertisement.normalizeMacAddress, re-exported
by device-addresses), used for the ring "Yours" comparison too.
- One serial-equality definition (serialKey/serialsMatch); the containment
fallback in isPreviouslyPaired is gone.
- Shared formatErrorMessage replaces five per-view-model copies; shared
hex-util replaces the duplicate TS hex codecs; one Java bytesToHex in
FaceclawFirmwareUtil replaces three hand-rolled encoders.
- glassesRow/ringRow share a presentation-base helper; dead row address
fields, the constant glassesSectionVisibility, the identical-branch
status ternary, and zoneRank/ZONE_ORDER are removed.
- .gitignore now actually covers .test-build/ as tests/README claims.
UI:
- Dark-mode styles for the pairing page: readable instructions, dark-gray
cards with consistent light text; light mode keeps its current look.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016ZqzwmRQ3HQxasBz5rYyZV