docs: optional catalog_id on POST /api/emails leads the email with the value delta
Summary
Row 5 of chat#1911: the contract for leading a report email with the catalog's value delta. Adds an optional catalog_id (uuid) to SendEmailRequest: when present, the subject is prefixed with the catalog's current estimated value and signed change since the previous measurement, and a valuation hero block is prepended to the body. Single measurement shows a baseline note; an unowned catalog or one with no measurements leaves the email unchanged (best-effort by design - a delta failure must never block a send).
Purely additive anchored edit to SendEmailRequest in accounts.json; JSON re-validated. Links the series contract at Get Catalog Valuations.
Merge order: this PR → the api implementation (stacked on api#795, ref follows). Depends on docs#279 conceptually (the valuations series) but not textually.
🤖 Generated with Claude Code
Summary by cubic
Adds an optional catalog_id (uuid) to SendEmailRequest for POST /api/emails to lead report emails with the catalog’s current value and signed delta, aligning with chat#1911. Additive docs update; existing clients are unaffected.
- New Features
- When
catalog_idis set, the subject is prefixed with the current estimated value and change, and a valuation hero block is added to the body. - Single measurement shows a baseline note; unowned or unmeasured catalogs leave the email unchanged.
- Underlying data comes from the “Get Catalog Valuations” series.
- When