diff --git a/docs/loop-diy-whats-new.md b/docs/loop-diy-whats-new.md index ec4c6d1894..dd9d861fce 100644 --- a/docs/loop-diy-whats-new.md +++ b/docs/loop-diy-whats-new.md @@ -1,9 +1,9 @@ # Loop DIY — What's New -*User-facing guide to the changes on the `next-dev` line, from the two Tidepool → DIY -syncs (2026-03-10 and 2026-05-11) plus everything DIY has added since.* +*User-facing guide to the changes on the `next-dev` line, from the Tidepool → DIY +syncs (2026-03-10, 2026-05-11 and 2026-10-12) plus everything DIY has added since.* -Last updated: 2026-07-14. +Last updated: 2026-10-26. This document explains **what changed for you as a user**. For merge mechanics, conflict resolutions, testing checklists, and data-migration internals, see the @@ -17,17 +17,21 @@ DIY Loop absorbed roughly two years of Tidepool's work on Loop, then kept going DIY-only features on top. The headline user-visible changes: - **Presets are completely redesigned** — typed presets (Pre-Meal / Activity / Custom), - evidence-based activity presets, day-of-week scheduling, safety guardrails, and a - short required training before you can create custom presets. + evidence-based activity presets you can hide, day-of-week scheduling, safety guardrails, + and a short required training before you can create custom presets. - **A new Glucose Alerts system** — your own high/low/urgent-low/predicted-low - thresholds with selectable alert sounds, shown and edited in **your** glucose unit - (mg/dL *or* mmol/L), plus true critical alerts on iOS 26 without a special entitlement. + thresholds with purpose-made alarm sounds, shown and edited in **your** glucose unit + (mg/dL *or* mmol/L), alarms that play through silent mode, and true critical alerts on + iOS 26 without a special entitlement. - **A Statistics page** — a standard Ambulatory Glucose Profile (AGP) report with - time-in-range, GMI, and glucose variability over 7–90 days. + time-in-range, GMI, and glucose variability over 7–90 days, plus daily insulin totals. - **More devices** — Omnipod, Medtrum, Eversense, and FreeStyle Libre 3 are all - supported alongside the existing pumps and CGMs. -- **A smarter forecast and a cleaner algorithm** under the hood. -- **A redesigned main screen**, plus Apple Watch, HUD, and history improvements. + supported alongside the existing pumps and CGMs, and a Dexcom G7 can be paired directly, + without the Dexcom app, and read by the Apple Watch. +- **A smarter forecast and a cleaner algorithm** under the hood, plus opt-in + **Algorithm Experiments**. +- **A redesigned main screen** with display options, plus Apple Watch, HUD, history, and + support improvements. --- @@ -63,6 +67,11 @@ Four ready-made activity presets ship for everyone (customizable, not deletable) so *"give me 21% of normal insulin"* is one number instead of three. If you change a preset from its defaults, it's marked as **modified**. +**Don't want them?** Turn off **Show Activity Presets** in the Options section of the +Presets screen. They disappear from the phone and watch preset lists, their scheduled +reminders stop, and the exercise chapter of the training becomes optional. History and a +preset that's already running keep their names. + ### New safety behavior - **High insulin-needs mitigation** — if you push a preset's insulin needs above ~165%, @@ -101,24 +110,53 @@ A new glucose-alert system, styled after standalone-receiver alerts: - **Your own thresholds** for **Urgent Low**, **Low**, **High**, and **Predicted Low**. - **Displayed and edited in your glucose unit** — mg/dL or mmol/L, matching every other screen. The picker steps by 1 mg/dL or 0.1 mmol/L as appropriate. -- **Selectable alert sounds** per alert, and a **"Delay 1st Alert"** option for highs so - you aren't nagged the moment you cross the line. +- **A "Delay 1st Alert"** option for highs, so you aren't nagged the moment you cross the + line. - **Only the most severe low-side alert fires** — you won't get a Low and an Urgent Low buzzing at the same time, and a predicted-low alert is suppressed if you're already at or below your Low threshold. +- **A test alert on every alarm**, so you can hear exactly what it will sound like. + +### Alarm sounds + +Each glucose alarm has its own purpose-made sounds, contributed by @dnzxy from Trio, where +they replaced a much-complained-about tone set: + +- **Acoustic** and **Electronic** sets, each at **Mild**, **Medium** or **Harsh**. Every + level is its own recording, not the same file made louder, and each alarm's set is + written for that alarm, so you can tell Urgent Low from High by ear. +- **Voice** alerts in a male or female voice. +- **New default: Acoustic Medium** for all four alarms. If you never picked a sound, + you'll hear the new one after updating; if you did pick one, you keep it. All the + previous tones (and a few new ones) are under **Other Sounds** in the picker. + +### Alarms through silent mode + +Low, High and Predicted Low each have a **Play Through Silent Mode** switch next to their +sound. With it on, Loop plays the sound itself, so the ring/silent switch doesn't mute it. +It's on by default for Low and Predicted Low and off for High. Urgent Low already broke +through silent mode and is unchanged. All alarms are also normalized to an even loudness. ### Critical alerts on iOS 26 without an entitlement DIY builds don't have Apple's official critical-alert entitlement. On **iOS 26 and later**, Loop now uses Apple's **AlarmKit** to deliver true critical alerts that break through silent mode and Focus — no entitlement required. When it can't, it falls back to -boosting system volume and playing a bundled critical sound. Tapping **Stop** on the -alarm acknowledges the underlying Loop alert. Builds without the entitlement include an -in-app FAQ explaining how alerts behave. +boosting system volume and playing the whole alarm sound. Tapping **Stop** on the alarm +acknowledges the underlying Loop alert, and alarms are stopped correctly after Loop +relaunches. Builds without the entitlement include an in-app FAQ explaining how alerts +behave. + +### Alert History + +**Settings → Alert Management → History** lists every alert Loop has recorded over the +last ~90 days, grouped by day, with when it was issued, acknowledged or retracted. --- -## Statistics — Ambulatory Glucose Profile (DIY, new since the sync) +## Statistics (DIY, new since the sync) + +### Ambulatory Glucose Profile **Settings → Statistics** opens a standard **AGP report**: @@ -133,26 +171,50 @@ in-app FAQ explaining how alerts behave. This is powered by a longer on-device glucose history (now kept for **90 days**), so the report has enough data to be meaningful without waiting on slow HealthKit queries. +### Daily insulin + +A **Daily Insulin** section shows your average total per day, today so far, and the split +between basal and bolus (and how much of the bolus was automatic), with a chart of each +day. **"Usually X U by