[ljmerza]

Summary

A package can now carry the retailer order it belongs to, next to its tracking number:

• order_number and order_link are optional package fields. link is still the carrier tracking page.
• tracking_number stays the key, so stored packages, hidden numbers, services and live-status lookups are unchanged.

Card support: ljmerza/tracking-number-card (branch feat/order-numbers).

Changes

• parsers_list.py: find_carrier() passes order_number/order_link through. It used to drop every key except tracking number, carrier, origin and link. Also registers the Stride Rite parser before generic.
• coordinator.py:
  • Dedup priority: a store's parser beats a carrier's, which beats generic. A number seen in both a TCGplayer and a USPS email now shows retailer TCGplayer instead of USPS. Order fields and the earliest first_seen are merged in from the other duplicates.
  • Order-only entries: an entry where tracking_number == order_number is dropped once the same order has a real tracking number. Hidden tracking numbers count, so hiding the tracking number also hides the order.
  • Carry-forward: order fields are kept from the previous scan after the store's email ages out of the search window.
  • Generic fallback: the generic parser only runs on an email when no specific parser found anything in it. Before, it ran on every email, because its domain is ''.
• parsers/tcgplayer.py:
  • Every package gets the order number and order-history link.
  • USPS/UPS numbers now link to the carrier instead of tcgp.shipment.co; shipment.co is kept for numbers no carrier pattern recognises.
  • Seller orders without tracking also set order_number, so they collapse into a tracking entry later.
• parsers/stride_rite.py (new): parses the Shopify shipping email ("A shipment from order SR… is on the way"). It extracts the carrier tracking number, the SR order number and the "View your order" link. Before, only the generic parser picked these emails up, labelled "Generic".
• scripts/run_parsers.py: mirrors the generic fallback, prints order numbers, and checks an optional expected.order_number.
• Both READMEs: Stride Rite, a note on order fields, and the store-wins note on retailer.

Testing

• python3 scripts/run_parsers.py → 35/35 fixtures pass. The fixtures are kept locally in the gitignored .data/.
  • Includes a new, trimmed Stride Rite shipping email.
  • Expected order numbers were added to the three TCGplayer fixtures (Direct, seller-shipped, Tracking Added).
• A coordinator test with stubbed IMAP runs _fetch_and_parse_emails and _convert_to_packages: 14/14 checks pass. Against main, 8 of the 14 fail.
  • Stride Rite is not labelled Generic.
  • Store beats carrier, with the order merged and the earliest first_seen kept.
  • An order-only entry is dropped (also when the tracking number is hidden), and kept when it's alone.
  • Order fields carry forward.
  • Generic still catches unknown senders.
• Ran live in Home Assistant against a real inbox. Stride Rite and a TCGplayer USPS package show the correct retailer, carrier link and order.
• ruff check reports nothing new: the same 3 warnings as main.