fix: integrate reader sheets, PDF imports and current data contracts

[Eoic]

Summary

Use the improved EPUB/PDF reader with the client's shared bottom-sheet shell, motion-aware opening loader, and current position persistence. The reader dependency is pinned to the committed revision in PapyrusReader/reader#6.

Complete browser PDF import and OPDS acquisition support with shared PDF metadata extraction, worker hashing/storage, and retry-safe byte handling. Remove pre-release compatibility envelopes, migrations, aliases and tracking-version fallbacks; producers and consumers now use the current contract together. Server cleanup: PapyrusReader/server#14.

Testing

• Full client suite: 1,620 passed, 19 skipped. Final media, acquisition and tracking changes: 45 focused tests passed.
• Locked dependency resolution without the local reader override and 23 reader/page/PDF tests passed against the pushed reader revision.
• Client formatting, analysis, bootstrap checks and production web build passed.
• Actual client iOS simulator sessions passed real-book EPUB navigation, controls, persistence and PDF controls. Desktop Chrome PDF import, rendering, seeking and restart/resume passed with the 883-page MIT SICP PDF.
• See docs/pdf-import-validation.md, the reader validation report and app/integration_test/reader_real_books_test.dart for reproduction and target limitations. Authenticated live synchronization and a fresh native-device PDF picker session were not run.

UI evidence

Desktop Chrome and iOS simulator screenshots were inspected locally. Evidence remains in ignored build directories, including app/build/reader-sheets-validation/ and app/build/pdf-validation/; private book content and local test artifacts are not published in this PR.

Compatibility and migration

Pre-release cleanup intentionally drops old metadata envelope/locator recovery, model aliases and old tracking-contract fallbacks. Current metadata, offline retries and account isolation remain covered. No database schema migration, data reset or version bump is included.

Notes

Merge the reader and server PRs before the coordinating workspace PR. PDF cover thumbnail generation and import password entry remain outside this change. Public Gutenberg fixtures are in the reader repository; private validation books are excluded.

Checklist

• The branch, commits, and pull request title follow the repository conventions.
• The change is complete and limited to the agreed scope.
• Relevant tests have been added or updated.
• Formatting, analysis, and tests pass.
• Documentation, UI evidence, and migration notes are included where relevant.
• No credentials, personal data, copyrighted fixtures, or unrelated generated files are included.
• The branch is up to date with its target branch.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[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-10-10T18:27:33.403484Z	5677ba9	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 85.00000% with 18 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...p/lib/widgets/dashboard/continue_reading_card.dart	0.00%	5 Missing ⚠️
app/lib/pages/shelves_page.dart	0.00%	4 Missing ⚠️
app/lib/services/pdf_metadata.dart	80.00%	4 Missing ⚠️
app/lib/pages/reader_page.dart	83.33%	1 Missing ⚠️
app/lib/powersync/papyrus_powersync_connector.dart	80.00%	1 Missing ⚠️
app/lib/providers/annotations_provider.dart	0.00%	1 Missing ⚠️
app/lib/widgets/book_details/book_header.dart	85.71%	1 Missing ⚠️
.../lib/widgets/dashboard/recently_added_section.dart	0.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!