docs: optional catalog_id on POST /api/emails leads the email with the value delta

SW
4mo ago
+5-0

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_id is 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.