[Eoic]

Readers can select any library book and track a stopwatch or countdown session from Library → Timer. Sessions persist offline, synchronize between signed-in devices, and contribute saved reading time to statistics and goals.

• Add the digital clock and progress ring, stable responsive controls, single-column setup, optional page progress on valid saves, and focus mode. Countdown stops at its goal. Subsecond stops discard quietly without prompting.
• Persist versioned timer transitions and atomic save transactions through the existing profile-scoped repositories and PowerSync.
• Add Android ongoing notifications with pause/resume/finish and iPhone Live Activities (iOS 16.2+, interactive controls on iOS 17+). Native actions are durably journaled and replay through the same timer provider.
• Show the eight most recent saved reading sessions beside the timer on wide screens and below it on narrow screens. Group paused intervals, omit reversals/completion-only entries, and fill the page to its padded bottom edge while honoring content alignment.
• Apply shared mobile header scroll tint and correct grouped-session goal edits.

Validation:

• Follow-up timer/history changes passed 39 focused widget tests and client quality checks. Rendered left/center desktop layouts and mobile history scrolling were inspected using synthetic test data.
• Client formatting, analysis, and 17 web bootstrap tests passed.
• Full Flutter suite passed with 2,170 tests and 19 skips in a clean checkout of commit 3055aed, after flutter pub get --enforce-lockfile with the committed Git-pinned reader dependency. The implementation checkout with the local reader override also passed.
• Four native iOS XCTest cases passed. Android notification controls were exercised in the background and after process termination on an isolated emulator.
• Android debug, iOS simulator, and web builds passed during implementation. Physical-device acceptance remains unverified.

Requires PapyrusReader/server#61 before client rollout. The opt-in live PowerSync integration test is included but is not counted as passed here. On iPhone, native actions update the Live Activity immediately, while PowerSync reconciliation can wait until the app next runs. APNs background updates are not included. Android distribution requires the Play Console special-use foreground-service declaration. See docs/TIMER_NOTIFICATIONS.md for native verification and platform limits.

No design-feedback files, screenshots, generated previews, build outputs, or local reader dependency overrides are included. The synthetic native test host is retained as a reproducible XCTest/emulator fixture.

Closes #123. Related requirements: FR-5_1 (PapyrusReader/docs#34), FR-5_3 (PapyrusReader/docs#36), and FR-6_3 (PapyrusReader/docs#39).

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-11-06T00:37:21.919026Z	3055aed	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[codecov]

Codecov Report

❌ Patch coverage is 94.62130% with 49 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
app/lib/providers/reading_timer_provider.dart	88.28%	15 Missing ⚠️
app/lib/pages/reading_timer_page.dart	95.59%	14 Missing ⚠️
app/lib/services/reading_timer_notifications.dart	87.69%	8 Missing ⚠️
app/lib/widgets/library/library_drawer.dart	40.00%	3 Missing ⚠️
app/lib/widgets/timer/reading_timer_history.dart	93.33%	3 Missing ⚠️
app/lib/powersync/library_database.dart	97.40%	2 Missing ⚠️
app/lib/config/app_router.dart	50.00%	1 Missing ⚠️
app/lib/main.dart	85.71%	1 Missing ⚠️
app/lib/timer/reading_timer.dart	99.00%	1 Missing ⚠️
app/lib/widgets/shared/searchable_book_field.dart	97.29%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!