PIR: Add email fallback

[landomen]

Task/Issue URL: https://app.asana.com/1/137249556945/task/1214973541222181?focus=true

Description

Adds email fallback for the email confirmation job record.

Steps to test this PR

See https://app.asana.com/1/137249556945/task/1214973541222183?focus=true

UI changes

No UI changes

---

Note

Medium Risk
Changes the email address persisted for email-confirmation job records, which can affect downstream polling/confirmation flows if the fallback is incorrect or empty.

Overview
Ensures email-confirmation job records are populated even when an ExtractedProfile has no email by adding an optional generatedEmail to BrokerRecordEmailConfirmationNeeded and falling back to it when marking an opt-out as waiting for confirmation.

Updates BrokerStepCompletedEventHandler to forward State.generatedEmailData.emailAddress into that state, and adds tests covering both the forwarding behavior and the fallback selection logic.

^{Reviewed by Cursor Bugbot for commit 438c3f9. Bugbot is set up for automated code reviews on this repo. Configure here.}

[landomen]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• PIR: Add email fallback #8656 👈 (View in Graphite)
• PIR: Add getEmailData pixel #8642
• PIR: Fix email data handling #8641
• PIR: Clear emailExtractedData on step completion #8612
• PIR: Update completeRequestData to support scans and email extracted data #8583
• PIR: Add email polling mechanism #8581
• PIR: Add handling of GenerateEmail action #8294
• PIR: Add broker step action handler logic #8282
• PIR: Add state engine models for email flexibility #8233
• PIR: Add new email flexibility action models #8232
• develop

This stack of pull requests is managed by Graphite. Learn more about stacking.