[UtkuDenizAltiok]

What was wrong

The wind-down nudge fires at wake time − sleep need − 30 min lead. Both platforms describe it as timed from the
user's usual sleep need (Apple: "A calm nudge 8h 30m before your usual wake time"; Android: "timed from your wake
time and usual sleep need"). The need it actually used is windDown.sleepNeedMinutes, which defaults to 8 h and
which nothing on either platform ever writes (no UI, no backup key, no caller of the setter).

Every other surface uses the personal need: the Sleep tab's debt card, ledger and trend need line
(SleepModel.debtNeedMin / Kotlin SleepModelLogic), and the Rest score, all through
AnalyticsEngine.Rest.personalizedNeedHours (upper-quartile night, floored at the 8 h adult target, capped at
9.5 h). So a long sleeper whose Sleep tab says "8h 40m needed" is reminded as if they need 8 h, and the Apple
Alarms copy states a need no other screen states.

A second, smaller Apple bug in the same copy: it printed sleepNeedMinutes / 60 hours beside leadMinutes
minutes, which only adds up while the need is a whole number of hours (an 8h 40m need + 30 min lead read
"8h 30m").

The change

The stored value stays (the scheduler, and Android's boot receiver, run without the database), but the app keeps
it equal to the Sleep tab's need:

• Apple: WindDownNudge.adoptSleepNeed(normativeNeedMin:), called from AppModel's repo.$days sink with
  SleepModel.debtNeedMin(days:).
• Android: WindDownStore.adoptSleepNeed(normativeNeedMin), called from the recentDays collector with a new
  debtNeedMin(days) in SleepModelLogic.kt, which buildSleepModel now also uses (the same expression,
  extracted, so the two cannot drift).

Both write only when the rounded need changes (it moves over weeks) and reschedule only then, and only while the
nudge is on. An empty history emission is skipped so a launch cannot reset a learned need to 8 h and back.

Behaviour change, stated plainly: because the personal need never drops below 8 h, the nudge only ever moves
earlier, and only for people whose longer nights run past 8 h. Anyone with fewer than 7 nights, or whose
upper-quartile night is at or below 8 h, sees no change.

The Apple copy now states need + lead (WindDownNudge.offsetHoursMinutes); same strings, no new translations.
Android's existing copy ("timed from your wake time and usual sleep need") is now accurate as written.

Parity

The rounding helper (WindDownNudge.needMinutes(fromNormativeNeedMin:) / WindDownStore.needMinutes) rounds half
away from zero after clamping to the store's 5–11 h (clamping first so neither Int(_:) traps nor Math.round
saturates). Verified by oracle, not by reading: the Swift body was compiled standalone over 28 inputs (ties,
bounds, negative, huge, NaN, ±∞) and its stdout is pasted verbatim as the expected string in the Kotlin test; the
Swift test asserts the same list.

Tests

• StrandTests/WindDownSleepNeedTests.swift: the oracle list; adopt only when the rounded need moves; ten nights
  with an 8h 40m upper quartile give the Sleep tab's 520-minute need and move a 07:00 nudge from 22:30 to 21:50;
  the copy sum (8h 40m + 30m → 9h 10m).
• android/.../alarm/WindDownSleepNeedTest.kt: the same oracle, adopt-on-change, and the same 22:30 → 21:50 case
  through debtNeedMin.

Verification

• NOOPiOS simulator build; Strand macOS build + StrandTests (2306, 0 failures, 2 skipped as before).
• Fork Android CI (assembleFullDebug + testFullDebugUnitTest) green on this head: https://github.com/UtkuDenizAltiok/noop/actions/runs/42258465615
• Tools/i18n_audit.py --ci upstream/main exit 0, Tools/doc_comment_lint.py clean, Tools unit tests 338 OK,
  parity governance acceptance 50 OK.
• Not hardware-dependent (a local notification time); not observed firing on a device in this PR.

Related

• Refs Fix #201: re-fold the HRV baseline on a window switch instead of restarting calibration #207 (the nudge), Sleep Need bedtime notification parity #750 and Sleep Planner: local bedtime recommendation and sleep-need plan #758 (a bedtime recommendation / Sleep Planner from the personal need). This is
  only the narrow piece those build on: the existing nudge uses the existing need. No planner, no new setting.
• fix(alarm): move per-day wake times into alarm settings #2700 edits the same Apple Alarms line ("The nudge fires … before this.") and nudgeMinuteOfDay; the hunks do
  not overlap except that one copy line, so whichever lands second needs a one-line rebase.

🤖 Generated with Claude Code

[UtkuDenizAltiok]

The Strand (macOS) leg of App build shows as cancelled, but it never ran: GitHub could not assign a macOS runner ("The job was not acquired by Runner of type hosted even after multiple attempts", no steps executed). Every leg that ran passed, including NOOPiOS. On this head (eb0391a0) the Strand macOS build and StrandTests pass locally (2306 tests, 0 failures). A re-run of that leg should clear it.