[saksham2001]

Summary

Brings iOS level with what the Android app (foureight84/PulseLoopAndroid) has merged since its last iOS sync (Oct 14). Each change follows Android's behaviour, written as Swift in the existing iOS style; Android PR numbers are in brackets. Stacked on #142 (feat/ring-clear-after-sync), so the diff here is only this work.

Ring fixes

• LuckRing (TK18) steps and distance [[Feature]: No circadian timing guidance (caffeine / light / wind-down windows) #118]: each sport record is the day's running total so far, but iOS added every update together (one export: about 9,000 steps for a real 668). Records now set the day's total. A one-time repair, LuckRing only, fixes days already over-counted.
• LuckRing HRV removed [Export the four ring metrics that stopped short of Apple Health #122]: the ring's "HRV" byte doesn't behave like HRV in ms, and the vendor app never shows it. HRV is no longer requested, stored or shown for this ring.
• CRP / R11 sleep filed a day early [Readiness score: detail screen with contributor breakdown and trend (3/5) #108, [Feature]: Apple Health is export-only — no CGM or scale data can come in #119]: the ring's sleep day starts at 20:00, so every sync after 8 PM put that morning's night on the previous day. The dating rule is fixed, and sleep requests are skipped within 5 minutes of 20:00. Android also added a one-time cleanup of nights already stored on the wrong day, then removed it (f04a76a) because it left real nights empty. It is not included here, so nights stored before this fix stay where they are.
• CRP spot HR and SpO₂ [[Bug]: Ring data never cleared #91, Rework HR zones: evidence-based thresholds, distinct colors, configurable modes #95]: the R11 answers with one result frame. iOS sent those readings through the 6-sample heart-rate check, so good readings failed. A new CRPSpotMeasurement ends the measurement on that one result.

Sleep

• Records card [feat(pairing): add Colmi R08 ring support #71, Apple Health sync with per-type toggles, workout export, and profile import #80, [Bug]: Background syncs not working #92, Add RWfit ring family support #130]: shows each ring record of the night, with the "Awake Xm between" gaps. A record can be:
  • deleted (it stays deleted after a re-sync);
  • trimmed;
  • extended over time the ring missed. Added minutes count as asleep, but stay out of the stage breakdown and the score, and show as a hatched "Added by you" band.
  • New SwiftData model SleepRecordEdit; SleepStageBlock.recordStartAt; SleepStage.added.
• Gaps [[Feature]: No daily movement score, and no training load #116]: a gap under 60 s inside a record no longer becomes an Awake minute. Gaps between records are rounded rather than cut down, and they're drawn on the sleep chart.
• Sleep quiet hours [fix(activity): correct Year trends per-day average for the current month #79, Readiness score: Today card and Settings (2/5) #105]: an opt-in clock schedule that trims imported sleep to the window and keeps a night whole across a long waking inside it. Android's Bedtime / Do Not Disturb source is left out because it relies on an Android-only notification listener.

Vitals and Activity

• Delete a single reading [feat: Liquid Glass UI for iOS 26+ #62]: from the vital's detail screen. A deleted reading stays deleted after a re-sync, and is also removed from Apple Health if PulseLoop exported it. New SwiftData model MeasurementDeletion.
• Vital detail periods [[Feature]: No illness early-warning (Symptom Radar equivalent) #117]:
  • Day is now midnight to midnight, with previous/next day buttons.
  • Week is the 7 days ending today; Month is the calendar month.
  • The chart axis spans the whole period, so gaps show where the ring wasn't worn.
• Activity [Apple Health sync with per-type toggles, workout export, and profile import #80, feat(pairing): add Colmi R08 ring support #71, [Feature]: No illness early-warning (Symptom Radar equivalent) #117]:
  • Day-by-day navigation.
  • A RECORDS list of the day's activity blocks; each can be deleted and stays deleted after a re-sync.
  • A day with no data shows "—" instead of today's numbers.
  • Calories are calculated the same way as on Today.
• Estimated stress [feat(pairing): add Colmi R08 ring support #71]: for rings that report HRV but never stress, stress is estimated from HRV and labelled ESTIMATED.

YCBT rings and battery

• Estimated hourly SpO₂ [Add .appleExerciseTime to Healthkit so it syncs with Fitness rings #129, [Bug]: Colmi R09 called R09_9D07 can't connect #134]:
  • Hourly SpO₂ that a YCBT ring calculates from heart rate is detected from that ring's own data and labelled as estimated.
  • It is hidden by default; a setting shows it again.
  • It is never exported to Apple Health, and neither is respiratory rate from YCBT rings, which is also calculated from heart rate.
• Longer intervals [[Bug]: Colmi R09 called R09_9D07 can't connect #134, feat(vitals): Measure HR/SpO₂ countdown redesign + robust measurement #66]: heart-rate interval of 30–120 min on YCBT rings, plus a separate SpO₂ interval sent to the ring. Android's background timer that starts its own SpO₂ readings is not ported: iOS can't run Bluetooth work on a timer in the background.
• Battery [feat(pairing): add Colmi R08 ring support #71]: gridlines on the battery chart and an estimate of the time left, based on the current discharge rate.

Coach

• Delete conversations [Add support for local LLM #133]: past conversations can be deleted one at a time or all at once. A reply arriving after its conversation was deleted no longer brings it back.
• Gemini errors [Time the day around the user's own sleep schedule #127, Apple Health sync with per-type toggles, workout export, and profile import #80]:
  • When Google refuses web search with a 429, the answer is sent once without web search, and that key skips web search for the rest of the session.
  • A 503 is retried twice, after 2 s and then 4 s.
• Live model lists [Stop dropping REM sleep, and let the coach say so #120]: model lists come live from OpenAI, Gemini, OpenRouter and MiniMax.
  • Settings warns when the saved model is no longer listed, and notes OpenRouter retirement dates.
  • OpenRouter models outside the presets use the reasoning levels OpenRouter reports for them.

Other

• ActivityRecorderService moved out of PulseServices.swift unchanged, so that file stays under SwiftLint's 1000-line error limit.

Data: three SwiftData additions (SleepRecordEdit, MeasurementDeletion, plus new fields with defaults on existing models). DataArchive carries all of them as optional fields, so older exports still import.

Related issues

Ports Android PRs #62, #71, #80, #91, #92, #95, #108, #116, #117, #118, #119, #120, #122, #127, #129, #130, #133, #134 (foureight84/PulseLoopAndroid). Builds on #142.

Type of change

• 🐛 Bug fix (non-breaking change that fixes an issue)
• ✨ New feature (non-breaking change that adds functionality)
• 📟 New / improved wearable support (BLE driver layer)
• 🤖 Coach / LLM change (tools, prompts, orchestration)
• 🎨 UI / DesignSystem change
• 🧹 Refactor / chore (no behavior change)
• 📝 Docs only
• ⚠️ Breaking change (existing data, settings, or APIs change)

How was this tested?

• Added / updated unit tests (PulseLoopTests): Android's test cases were ported where they exist.
• Ran the test suite locally: 1460 tests, 0 failures.
• Tested on a physical device with a real ring — model: not yet
• Tested with demo data (-seedDemo YES, no hardware): Vitals detail, the Activity day view and records, and the Sleep records card were checked in the simulator.

Not checked yet:

• In the simulator: the sleep record edit sheet, the quiet-hours settings, the coach history sheet and model picker, the battery estimate, and the measurement settings.

Needs a real ring before merge:

• TK18: step totals and the one-time repair on real over-counted data.
• R11:
  • sleep synced after 20:00;
  • a night that starts before 20:00 and crosses midnight (also open on Android);
  • spot HR (about 17 s) and SpO₂ (about 48 s) ending on the ring's result.
• YCBT: the 120-min heart-rate interval (verified only on Android), the SpO₂ interval, and estimated-SpO₂ detection on real data.

Privacy & data

• This change does not send health data off-device without explicit user action.
  • The model-list requests send only the user's own API key, to that provider, in a header.
  • Deleted readings are removed from Apple Health; nothing new is exported.
• No secrets, API keys, or personal data are committed.
• N/A

Screenshots / recordings

Not attached.

Checklist

• My code follows the project's style (SwiftLint passes: no errors).
• I ran the tests and they pass.
• I updated docs / README where relevant (docs/hardware/colmi.md, luckring.md, tk5.md, r10m.md).
• I read the Contributing guide.