[EPAC-917]: Daily Parliament digest notification (iOS)

[riddim-developer-bot]

Summary

Adds an opt-in once-per-sitting-day local notification that summarizes the day's parliamentary activity (subject count, top three subjects, attendance estimate, and one optional vote summary). Content is composed from authoritative Hansard subjects and recorded-division results only — no generated or paraphrased text. Linear: EPAC-917.

Behavior

• Fires within iOS background refresh after today's Hansard ingests, and opportunistically on app foreground (scenePhase .active).
• Only on confirmed sitting days (Hansard published, not just scheduled), between 17:00 and 23:00 local time, once per calendar day.
• Tapping opens cabinetdoor://sitting/<yyyy-MM-dd>, routing the user to today's sitting in the Debates calendar via the existing deep-link router.
• Default off. Opt in from onboarding screen 4 ("Daily Parliament summary") or Settings → Notifications → Daily Parliament summary.

Architecture

Clean Architecture shape exactly as named in the issue.

• Use case: SendDailyParliamentDigest composes a DailyDigest value object from four read ports and hands it to DigestNotificationPort. The use case owns timing policy (window + sitting-day + dedupe); adapters are pure plumbing.
• Entities (ios/epac/Domain/Entities/): DailyDigest; NotificationPreferences (renamed from User to avoid a collision with ExyteChat.User in the same module).
• Ports (ios/epac/Domain/Ports/):
  • HansardReadPort — sitting-day, subject count, top subjects
  • VoteReadPort — attendance estimate, daily vote summary
  • DigestNotificationPort — UNUserNotificationCenter delivery
  • UserPreferenceReadPort — daily-digest opt-in flag
  • DigestDeliveryRecordPort — last-delivered day (dedupe)
• Adapters (ios/epac/Data/Adapters/):
  • SwiftDataHansardReadAdapter — reads Hansard / OrderOfBusiness / SubjectOfBusiness
  • SwiftDataVoteReadAdapter — averages (yea+nay+paired)/338 across the day's RecordedVote rows for attendance; first vote of the day for the summary
  • LiveDigestNotificationAdapter — schedules a local notification with userInfo[date] for the tap handler
  • UserDefaultsDigestDeliveryRecordAdapter — once-per-day dedupe key
  • UserPreferenceAdapter — opt-in flag (UserDefaults)
• Composition root: BackgroundRefreshManager.sendDailyDigestIfEligible(container:) wires the use case after Fetch.backgroundRefresh() (which now also downloads today's Hansard) and is invoked on scenePhase .active.
• Tap deep link: AppDelegate adopts UNUserNotificationCenterDelegate; didReceive parses userInfo[date] and calls UIApplication.shared.open on cabinetdoor://sitting/<yyyy-MM-dd>, which the existing ContentView deep-link router routes to the Parliament tab.

docs/architecture/use-case-catalog.md is updated with the use case, entities, and ports.

Acceptance criteria

• Fires within 60 minutes of full Hansard ingestion on sitting days — wired into background refresh after Fetch.downloadHansard(Date()) succeeds, with the use case re-checking eligibility.
• Content: subject count, attendance estimate (from vote records when available), top 3 subjects, vote result if any — all from the official record.
• Sent only on confirmed sitting days — HansardReadPort.isSittingDay returns true only when Hansard exists for that date.
• Opt-in toggle in onboarding screen 4 and in Settings → Notifications.
• Default off; user must explicitly enable.
• Notification taps to today's sitting in the Debates calendar via cabinetdoor://sitting/<yyyy-MM-dd>.
• PR linked in this ticket (after creation).

Test plan

• xcodebuild build on iPhone 17 Pro (iOS 26.5) simulator — BUILD SUCCEEDED
• SendDailyParliamentDigestTests — 9 cases: opt-in, start/end-hour boundaries (minute precision), non-sitting day, dedupe, top-subjects limit propagation. All pass.
• DailyDigestFormatterTests — 6 cases for title/body composition. All pass.
• SnapshotTests.testNotificationsSettings_dailyDigest (light/dark/a11y) — passes.
• SnapshotTests.testSettings_root snapshots regenerated for the new Notifications row — passes.
• swiftlint --strict on changed files — zero violations.
• Live verification on a real sitting day with simulator notifications enabled — captured under the Project's Human Handoff issue per the issue's external-validation note (gates: none).

Boundary notes

• The use case never imports UserNotifications, SwiftData, or any UI framework.
• All displayed text is composed from typed values by DailyDigestFormatter (framework-free, verbatim authoritative content).
• French strings added alongside English in Localizable.strings.

🤖 Generated with Claude Code