[Eoic]

Issue and requirements

Closes #108. Implements the device-folder portion of FR-2_6. Documentation: PapyrusReader/docs#90.

Summary

Users can connect a folder from Library, preview its contents, and import local book copies while offline. Later scans add new files without replacing existing books or modifying their sources.

• Add profile-local connections, recoverable import jobs, content-hash duplicate detection, deletion exclusions and explicit changed-file review.
• Support native directory access and browser handles/fallbacks, lifecycle scans, local media recovery and normal account uploads.
• Add Library folder management, compact setup/details/edit sheets, source-folder advanced filters and stable progress layouts.
• Package web dependencies for offline reopening. Fix Apple build settings and Linux linker setup, and run folder tests in Windows/Linux packaging CI.

Testing

• Clean checkout with the committed reader pin and no override: locked dependency resolution, analysis and 152 focused tests passed.
• Previous workspace review: full client suite (2,018 passed, 19 skipped), client quality checks, Node/browser tests and offline-packaging tests passed.
• All 76 folder tests passed in Ubuntu 24.04 x64. Web, Android, macOS, iOS simulator, unsigned iOS release and Linux release builds passed.
• The complete local two-client sync harness passed, including offline folder import, restart, upload, deletion and account isolation.
• Workflow lint, shell checks and patch whitespace checks passed.

The workspace platform builds and live harness used the existing local reader override. The clean-checkout tests above and CI validate the committed dependency.

UI evidence

Responsive widget tests cover folder tables, setup/details/edit sheets, source filters, stable status/progress geometry, large text and e-ink. From app/, generate review captures with:

flutter test test/folders/watched_folders_page_test.dart --dart-define=FOLDER_DESIGN_CAPTURE=true

Captures are written to ignored build/folder-review/ within the app directory. No generated captures are committed.

Compatibility and migration

No new server endpoint, replicated field or server migration. Folder state remains in a separate profile-local database and guest libraries stay local. Existing imports use their current behavior unless a caller opts into a preallocated book ID.

The live test database required the existing b9c0d1e2f345 migration. Apple dependency minimums now match the app's existing iOS 15/macOS 12 requirements. Debug simulator builds use the host architecture.

Notes

Windows native execution is pending CI. Physical picker, revoked-permission, bookmark, cloud-placeholder and removable-drive acceptance remain release checks in the documentation. Browser headless acceptance used real persisted handles with a substituted picker and does not establish OS-picker acceptance.

Checklist

• Branch, commit and title follow repository conventions.
• Changes are scoped to the feature and supporting build fixes.
• Relevant tests are added or updated.
• Local formatting, analysis and focused tests pass.
• Documentation, UI validation instructions and migration notes are included.
• No credentials, personal data, copyrighted fixtures or unrelated generated files are included.
• Branch is up to date with development.

[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-01T01:16:05.527604Z	a8b09fe	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.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a8b09fe7e6

ℹ️ 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[codecov]

Codecov Report

❌ Patch coverage is 80.99520% with 317 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
app/lib/folders/watched_folders.dart	88.00%	62 Missing ⚠️
app/lib/widgets/folders/folder_issues_sheet.dart	0.00%	61 Missing ⚠️
app/lib/folders/folder_import_target.dart	0.00%	60 Missing ⚠️
app/lib/pages/watched_folders_page.dart	70.68%	34 Missing ⚠️
app/lib/folders/directory_access_native.dart	62.35%	32 Missing ⚠️
app/lib/widgets/add_book/connect_folder_sheet.dart	83.45%	22 Missing ⚠️
app/lib/main.dart	64.28%	10 Missing ⚠️
app/lib/widgets/folders/edit_folder_sheet.dart	84.74%	9 Missing ⚠️
app/lib/widgets/folders/folder_details_sheet.dart	93.07%	9 Missing ⚠️
...widgets/profile/storage_sync_settings_section.dart	30.00%	7 Missing ⚠️
... and 7 more

📢 Thoughts on this report? Let us know!

[EARL146]

feat: import books from watched device folders feature was successfully merged into the development branch.

• Merge commit: ab3653b
• 7 CI checks: Passed
• Auto-merge: Successful
• Feature branch: Deleted
• Documentation PR: Merged