broker-sync/broker_sync/providers
Viktor Barzin 1d1e20b72b
Some checks are pending
CI / test (push) Waiting to run
CI / build (push) Blocked by required conditions
CI / deploy (push) Blocked by required conditions
schwab: detect vest-confirmation emails + emit VestEvent
Extends parse_schwab_email to handle Schwab's RSU Release Confirmation
emails alongside the existing trade confirmations. Adds:

- `VestEvent` dataclass in models.py — carries vest_date, ticker,
  shares_vested, shares_sold_to_cover, fmv_at_vest_usd, tax_withheld_usd.
  Written to payslip_ingest.rsu_vest_events by a postgres sink (pending
  a real email fixture + cross-service DB grant).
- `parse_schwab_email_full()` — new entry point returning both
  `list[Activity]` and `VestEvent | None`. The legacy
  `parse_schwab_email()` shape is preserved for existing callers.
- Vest-release dispatch heuristic: HTML body mentions "Release
  Confirmation" / "Award Vesting" / "RSU Release". On match, extract
  vest fields via label regexes; the full vest becomes a BUY Activity
  and the sell-to-cover slice becomes a SELL Activity at the same FMV
  (net zero cash on the day). Gross vest + sell-to-cover returned so
  Wealthfolio gets the full portfolio picture.
- Tests: 3 new (vest roundtrip, unparseable-vest safety, legacy shape
  preserved); existing 6 unchanged.

The regex heuristics will need tightening once a real email sample
exists — the HTML structure observed in public Schwab emails may
differ in material ways. For now, unmatched vest bodies return
empty-result (no Activity, no VestEvent) rather than crashing the
IMAP batch.

Part of: code-860
2026-04-19 18:27:58 +00:00
..
parsers schwab: detect vest-confirmation emails + emit VestEvent 2026-04-19 18:27:58 +00:00
__init__.py Add Provider protocol and normaliser 2026-04-17 19:20:12 +00:00
_checkpoint.py Add per-account cursor Checkpoint helper 2026-04-17 19:30:20 +00:00
base.py Add Provider protocol and normaliser 2026-04-17 19:20:12 +00:00
fidelity_planviewer.py fidelity-planviewer: wire provider to real PlanViewer session + JSON API 2026-04-18 18:47:38 +00:00
finance_mysql.py Add finance_mysql provider + CLI for historical backfill 2026-04-17 22:38:21 +00:00
imap.py imap: route IE BUYs to ISA first-£20k / GIA overflow per UK tax year 2026-04-18 12:02:49 +00:00
invest_engine.py Add InvestEngineProvider — Bearer-token HTTP client 2026-04-17 21:52:26 +00:00
trading212.py Wire T212 pagination, retries, and click<8.2 pin 2026-04-17 19:45:23 +00:00