earnrate 0.2.15 → 0.2.17

package/README.md

@@ -9,14 +9,14 @@ I wanted a ghost card: one card that always charges the best of my cards. The ca
 
 **earnrate is the best-card decision layer for people and AI agents.** Give it a merchant, and it tells you which credit card earns the most there, from your own cards or from every card it knows, and why. Save your cards and it tracks your caps and chosen categories. It's valuation-aware and transparent about its assumptions. It never sees a card number.
 
-- Runs on your machine, in your browser at [earnrate.dev](https://earnrate.dev) (which you can add to your phone's Home Screen and use offline), or in Claude as a connector at `https://mcp.earnrate.dev`, with nothing to install. No account and no affiliate links; the hosted server counts requests by tool name, nothing about what you ask. See the [privacy page](https://earnrate.dev/privacy).
+- Runs on your machine, in your browser at [earnrate.dev](https://earnrate.dev) (which you can add to your phone's Home Screen and use offline), or in Claude as a connector at `https://mcp.earnrate.dev`, with nothing to install. earnrate.dev and Claude can share one wallet. No account and no affiliate links; the hosted server counts requests by tool name, nothing about what you ask. See the [privacy page](https://earnrate.dev/privacy).
 - U.S. cards and U.S. merchants, for now.
 
 > **Status:** early, and it works: the engine, CLI, optional Claude merchant lookup, MCP server and the hosted Claude connector. See [the benchmark](docs/benchmark.md) (run 2026-11-03) for how it compares to an existing card-picking MCP server.
 
 ## Try it
 
-Needs Node 22 or later.
+Needs Node 22 or later (the published package is compiled JavaScript).
 
 ```sh
 npm install -g earnrate
@@ -55,7 +55,7 @@ Use Blue Cash Preferred: 6% back, about $4.80. High confidence.
 Amex Gold beats Blue Cash Preferred here if Amex Membership Rewards (MR) points are worth more than 1.5¢ (you value them at 1¢).
 
 Assumes Whole Foods Market codes as supermarkets (MCC 5411).
-Values points at: Amex Membership Rewards (MR) at 1¢, SoFi Member Rewards at 1¢, Chase Ultimate Rewards (UR) at 1¢.
+Point values: Amex Membership Rewards (MR) at 1¢, SoFi Member Rewards at 1¢ and Chase Ultimate Rewards (UR) at 1¢.
 ```
 
 Options: `--online` or `--in-store`, `--paying card|apple-pay|google-pay|paypal`, `--valuation flat|points-heavy`, `--cards`, `--member`, `--category`, `--all`, `--json`, `--date`, `--country`. Run `earnrate --help` for details. To keep the wallet somewhere else, set `EARNRATE_WALLET` to its path.
@@ -157,13 +157,19 @@ Every purchase on the card counts. Once earnrate knows how much you've spent on
 
 Some cards give dollars back for spending at a named store, up to a limit each period: Amex Platinum's $75 a quarter at lululemon, Amex Gold's $7 a month at Dunkin', Blue Cash Preferred's $10 a month on Disney+, Hulu or ESPN subscriptions. The purchase still earns the card's rate; the credit comes on top. Asking about the store with no cards saved lists the cards with a credit there first, "With a statement credit", in dollars ("$75 back each quarter, then 1x Amex Membership Rewards"), then the usual ranking by rate. A search for a kind of purchase ("clothing") doesn't.
 
-With a saved wallet, a credit counts only once you mark it enrolled (these all need enrolling with the issuer), and only while some is left this period. Given an amount, its dollars count toward that card's return and can make it the pick; without one, the answer shows what's left. Recording a purchase from an AI assistant uses it up, and `earnrate todo` reminds you to enroll and to use what's left before the period ends:
+With a saved wallet, a credit that needs enrolling with the issuer counts only once you mark it enrolled, one that doesn't (like Amex Gold's Uber Cash) counts right away, and either only while some is left this period. Given an amount, its dollars count toward that card's return and can make it the pick; without one, the answer shows what's left. Recording a purchase from an AI assistant uses it up, and `earnrate todo` reminds you to enroll and to use what's left before the period ends:
 
 ```sh
 earnrate update amex-platinum --enrolled lululemon --credit-used lululemon=40
 ```
 
-In the wallet file that's `enrolled: [lululemon]` and `credit_usage: { lululemon: { period: 2026-Q4, used: 40 } }` on the card. On earnrate.dev it's in the card's settings. The cheat sheet, simulations and welcome-offer comparisons leave credits out.
+In the wallet file that's `enrolled: [lululemon]` and `credit_usage: { lululemon: { period: 2026-Q4, used: 40 } }` on the card. On earnrate.dev it's in the card's settings, where each credit is "Enrolled", "Not yet" or "I don't use this" (or "Using it" for one that needs no enrolling).
+
+A credit you don't use can be marked so: `earnrate update amex-gold --skipped-credits dunkin`, `skipped_credits: [dunkin]` in the file. It then counts nowhere: not toward a pick, not against the fee, and not on the to-do list. For cards named with `--cards`, `--enrolled amex-platinum=lululemon` and `--skipped-credits amex-gold=dunkin` do the same for one answer.
+
+Some credits pay only on a purchase of a certain size (Citi Strata Premier's $100 off a Citi Travel hotel stay of $500 or more), and some end on a date the issuer sets (Sapphire Reserve's Lyft credit, through Sep 30, 2027). Card listings say so; a purchase too small earns no credit, and after the end date the credit counts nowhere. Rules work the same way: Amex Business Platinum's 2x on a purchase of $5,000 or more applies only when the amount is given, and an answer without one says what it would earn.
+
+Annual-fee math counts the credits you use on cards you hold, a full period's worth each period: simulating spending with your own cards says "Amex Gold's fee counts $204 a year of credits you use: Dunkin' and Uber." For a card you don't hold, the ranking leaves its credits out, since they're worth it only if you'd spend at those places anyway, and shows what it would net if you used them all beside it: in `simulate`, `offers`, the annual-fee math on each card's page and the site's spending tab. The cheat sheet picks by rate alone and leaves credits out.
 
 ### Which new card?
 
@@ -225,7 +231,7 @@ Spotted a wrong rate, or want a card added? [Open an issue](https://github.com/c
 
 ## Use it in an AI assistant (MCP)
 
-**In Claude, nothing to install:** add a custom connector (Settings → Connectors) with the address `https://mcp.earnrate.dev`. It works in Claude on the web, desktop and phone. When you add it, an earnrate page opens once, where you start an anonymous wallet: no email, just a recovery code you keep. Then ask anything: with no cards saved it answers from every card. Name your cards for answers about yours, and save them to track caps and welcome bonuses across your Claude apps. From the chat you can export the wallet for the command line, switch to another one, or delete it. In Claude Code:
+**In Claude, nothing to install:** add a custom connector (Settings → Connectors) with the address `https://mcp.earnrate.dev`. It works in Claude on the web, desktop and phone. When you add it, an earnrate page opens once, where you start an anonymous wallet: no email, just a recovery code you keep. Then ask anything: with no cards saved it answers from every card. Name your cards for answers about yours, and save them to track caps and welcome bonuses across your Claude apps. From the chat you can export the wallet for the command line, switch to another one, or delete it. To use the same wallet on earnrate.dev, choose "Use the same wallet as Claude" in My wallet there. In Claude Code:
 
 ```sh
 claude mcp add --transport http earnrate https://mcp.earnrate.dev
@@ -315,14 +321,14 @@ earnrate needs no account. The local version has no telemetry; the hosted server
 - **What it stores locally:** your wallet, a YAML file on your computer (`~/.earnrate/wallet.yaml` unless you set `EARNRATE_WALLET`). It lists cards by product ID, like `amex-gold`, plus your category picks, activations and how much you've spent toward caps. earnrate never asks for or stores card numbers, expiry dates, security codes or bank logins. When you ask about a store earnrate doesn't recognize, its name goes in `~/.earnrate/missed-merchants.json` (`earnrate missed` lists them; `EARNRATE_MISSED_MERCHANTS=off` keeps no list).
 - **What the local version sends:** nothing, by default. The optional merchant lookup (off unless you turn it on with your own Anthropic API key) sends only the name of a store earnrate doesn't recognize to Anthropic's API, and saves the answer in `~/.earnrate/merchant-cache.json`.
 - **AI assistants:** when you use earnrate through Claude or another assistant, that assistant's provider sees the conversation, including earnrate's answers, under its own privacy policy.
-- **earnrate.dev:** everything you enter on the site stays in your browser, except when you add the cheat sheet to Apple Wallet: then pass.earnrate.dev receives what the pass needs (card IDs, picks, activations, checkout names, memberships and the date) and keeps none of it. The site counts which of its parts get used, by name only, and counts visits with Cloudflare Web Analytics, without cookies.
+- **earnrate.dev:** everything you enter on the site stays in your browser, except when you add the cheat sheet to Apple Wallet: then pass.earnrate.dev receives what the pass needs (card IDs, picks, activations, checkout names, memberships and the date) and keeps none of it. If you turn on syncing with Claude, the wallet (cards, picks, activations, memberships, point values, cap and spending totals, credits used and not used, opening dates) goes to mcp.earnrate.dev and is stored encrypted, like the connector's; a purchase you record is sent so its totals can be updated, and only the totals are kept. Searches, stores and amounts you ask about still never leave the browser. The sign-in stays in a cookie the page's scripts can't read. The site counts which of its parts get used, by name only, and counts visits with Cloudflare Web Analytics, without cookies.
 - **Retention:** locally, your data lives only in files you control, for as long as you keep them. Delete the wallet file, or clear the site's data in your browser, to remove it. A saved wallet on mcp.earnrate.dev lasts until you delete it or leave it unused for 13 months (a week, if it's never used); the record that an app is connected goes after 90 days unused.
 - **Terms:** [earnrate.dev/terms](https://earnrate.dev/terms).
 - **Contact:** [hello@earnrate.dev](mailto:hello@earnrate.dev).
 
 ## Working on earnrate
 
-Development needs Node 24 or later.
+Development needs Node 24 or later: the repo runs its TypeScript directly, with no build step. The published package is compiled and runs on Node 22 or later.
 
 ```sh
 git clone https://github.com/cwasley/earnrate.git && cd earnrate

package/data/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 Every change to card rules, merchants, categories or currencies under `data/`. Bump `data/VERSION` (`YYYY.MM.DD`, plus `.N` for a second release on the same day) and add a section here in the same commit. Each row cites the issuer page the new value came from.
 
+## 2026.11.07
+
+New terms the engine can now express, each quoted from the issuer:
+
+- `amex-business-platinum`: 2X on any single eligible purchase of $5,000 or more (`large-purchases`, `min_amount: 5000`), inside the $2 million yearly cap shared with its 2X categories. Sources: [Amex](https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-business-platinum-credit-card-amex/), [offer terms](https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/business-platinum-charge-card/64281-9-0#offer-terms).
+- New statement credits with a minimum purchase: `citi-strata-premier`'s $100 Annual Hotel Benefit (a Citi Travel hotel stay of $500 or more, once a calendar year), `wells-fargo-autograph-journey`'s $50 airline credit (an airline purchase of $50 or more, once a year) and `barclays-jetblue-plus`'s $100 JetBlue Vacations credit (a package of $100 or more, once a calendar year). Sources: [Citi](https://www.citi.com/credit-cards/citi-strata-premier-credit-card), [Wells Fargo](https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/), [Barclays terms](https://www.barclaycardus.com/applycontent/TnCs.jsp?tc48255).
+- Credits that end on a date take `valid_to`, quoted from each card's page: the Instacart credits on 10 Chase cards and `chase-sapphire-reserve`'s StubHub and Peloton credits (through 2027-12-31) and Lyft credit (through 2027-09-30). They stop counting after that day.
+- Spend milestones that start later take `valid_from`: `chase-ihg-one-rewards`'s 4th Reward Night free after $5,000 a calendar year and `chase-ihg-one-rewards-business`'s Diamond Elite status after $50,000, both from 2027-01-01. Source: [Chase](https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/one-rewards), [Chase business](https://creditcards.chase.com/business-credit-cards/IHG/business).
+- `chase-prime-visa`'s welcome offer is a $200 Amazon Gift Card for Prime members (was $150), labeled limited-time with no end date. Source: [Chase](https://creditcards.chase.com/cash-back-credit-cards/amazon-prime-rewards).
+
+## 2026.11.06.2
+
+Wording only; no rates changed. `chase-freedom-flex`'s Q4 2026 dining, grocery and American Red Cross rules list their explanatory quote first ("For Dining purchases, you will earn 7% cash back…"), so answers show it rather than a run-together category list. The notes for O'Reilly Auto Parts, Advance Auto Parts and NAPA Auto Parts say "An auto parts store" (was "A auto parts store").
+
 ## 2026.11.06.1
 
 Wording only; no rates changed. Ten categories take `preposition: on`, so answers and pages say "on flights" rather than "at flights": `dining.fast_food`, `grocery.online`, `gas.grocery_store`, `gas.superstore`, `transit.rideshare`, `travel.flights`, `travel.car_rental`, `travel.cruise`, `home_improvement` and `other`.

package/data/VERSION

@@ -1 +1 @@
-2026.11.06.1
+2026.11.07

package/data/cards/amex-business-platinum.yaml

@@ -56,6 +56,12 @@ rules:
     geography: us_only
     cap: key-business-categories
     note: U.S. shipping providers. Shares the $2 million yearly cap.
+  - id: large-purchases
+    match: { any: true }
+    rate: 2
+    min_amount: 5000
+    cap: key-business-categories
+    note: A single eligible purchase of $5,000 or more, anywhere. It doesn't count if the merchant splits a purchase into charges under $5,000. A large purchase in a 2X category earns 2X once, and 5X travel wins over it. Shares the $2 million yearly cap.
 # Not modeled: the hotel and Airbnb credits (only some Amex Travel bookings),
 # the airline fee credit (an airline you pick), Adobe and the extra Dell
 # credit (after a spending total), the 35% Pay with Points airline bonus and
@@ -99,6 +105,15 @@ credits:
     note: "Bought directly from Dell Technologies in the U.S. The extra $1,000 after $5,000 of Dell purchases in a year isn't modeled."
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: large-purchases
+    url: https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-business-platinum-credit-card-amex/
+    quote: 'Earn 2X points on eligible purchases in key business categories, or on single purchases of $5K or more.'
+  - rule: large-purchases
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/business-platinum-charge-card/64281-9-0#offer-terms
+    quote: 'or (4) eligible purchases of $5,000 or more'
+  - rule: large-purchases
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/business-platinum-charge-card/64281-9-0#offer-terms
+    quote: 'a purchase transaction of $5,000 or more will not qualify if the merchant divides the purchase'
   - rule: base_rate
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/business-platinum-charge-card/64281-9-0#offer-terms
     quote: 'Basic Card Members will get 1 Membership Rewards® point for each dollar charged for eligible purchases'
@@ -178,7 +193,6 @@ evidence:
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/business-platinum-charge-card/64281-9-0#offer-terms
     quote: 'Each Card Account can receive up to $150 in statement credits for eligible purchases with Dell Technologies'
 todo:
-  - "Any eligible purchase of $5,000 or more earns 2X (inside the same $2 million yearly cap). earnrate has no rule condition on purchase size, so this isn't modeled."
   - "Software and cloud system providers count toward the electronics category, but earnrate has no software or cloud category, so only electronics stores are modeled. Construction material and hardware suppliers are modeled as earnrate's home improvement category."
   - 'From February 17, 2027, U.S. shipping providers count only when bought directly from UPS, FedEx, USPS, Auctane, DHL, Worldwide Express and Old Dominion Freight Line. Not modeled yet.'
   - 'Amex''s rewards terms count eligible purchases as "purchases for goods and services minus returns and other credits" and don''t say whether that takes out benefit statement credits. Its credits are modeled as earning the card''s rate on the whole purchase, with the credit on top.'

package/data/cards/barclays-jetblue-plus.yaml

@@ -32,7 +32,24 @@ rules:
     exclude: { categories: [superstore, warehouse_club] }
     rate: 2
     note: Grocery stores and supermarkets, by merchant category code. Warehouse-type stores like Target and Walmart generally don't count.
+# Merchant statement credits, on top of what the purchase earns.
+credits:
+  - id: jetblue-vacations
+    match: { merchants: [jetblue-vacations] }
+    amount: 100
+    period: calendar_year
+    min_amount: 100
+    note: One $100 credit a calendar year on a JetBlue Vacations package of $100 or more (after returns and credits), booked at jetbluevacations.com or 844-JB-VACAY. It posts 6-8 weeks after the purchase.
 evidence:
+  - rule: jetblue-vacations
+    url: https://www.barclaycardus.com/applycontent/TnCs.jsp?tc48255
+    quote: 'For each calendar year that you purchase a JetBlue Vacations package of $100 or more with your Card Account'
+  - rule: jetblue-vacations
+    url: https://www.barclaycardus.com/applycontent/TnCs.jsp?tc48255
+    quote: 'Limit of one $100 statement credit per calendar year per Card Account.'
+  - rule: jetblue-vacations
+    url: https://cards.barclaycardus.com/banking/cards/jetblue-plus-card/
+    quote: 'after you purchase a JetBlue Vacations package of $100 or more with your JetBlue Plus Card.'
   - rule: base_rate
     url: https://www.barclaycardus.com/applycontent/TnCs.jsp?tc48255
     quote: 'You earn 1 TrueBlue point for every $1 spent on all other Net Purchases'
@@ -82,5 +99,6 @@ evidence:
     url: https://www.barclaycardus.com/applycontent/TnCs.jsp?tc48255
     quote: 'Foreign Transaction 0% of each transaction in U.S. dollars.'
 todo:
-  - Not modeled (perks, not points per dollar) the 5,000-point anniversary bonus, 10% of points back on JetBlue Award Flights, 50% off inflight food and drink, the free first checked bag and the yearly $100 JetBlue Vacations statement credit.
+  - Not modeled (perks, not points per dollar) the 5,000-point anniversary bonus, 10% of points back on JetBlue Award Flights, 50% off inflight food and drink and the free first checked bag.
   - Card spending earns Mosaic tiles toward JetBlue elite status, which isn't modeled.
+  - "The issuer's terms don't say whether purchases a credit pays for earn rewards. Its credits are modeled as earning the card's rate on the whole purchase, with the credit on top."

package/data/cards/chase-freedom-flex.yaml

@@ -139,31 +139,31 @@ evidence:
     quote: 'Earn 2% total cash back on Lyft rides with your Freedom Flex card through September 30, 2027'
   - rule: q4-2026-grocery
     url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
-    quote: 'CURRENT QUARTER Grocery Stores'
+    quote: 'Activate each quarter to earn 5% cash back on up to $1,500 in combined purchases'
   - rule: q4-2026-grocery
     url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
-    quote: 'Activate each quarter to earn 5% cash back on up to $1,500 in combined purchases'
+    quote: 'CURRENT QUARTER Grocery Stores'
   - rule: q4-2026-grocery
     url: https://www.chase.com/personal/credit-cards/rewards-category-faq
     quote: 'Purchases made at gas stations from merchants who also operate grocery stores are not included'
   - rule: q4-2026-grocery
     url: https://www.chase.com/personal/credit-cards/freedom/flex-learnmore
     quote: 'This quarter, the deadline for activation is December 14, 2026'
+  - rule: q4-2026-dining
+    url: https://www.chase.com/personal/credit-cards/freedom/flex-learnmore
+    quote: 'For Dining purchases, you will earn 7% cash back (3% Dining cash back + 4% bonus category cash back)'
   - rule: q4-2026-dining
     url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
     quote: 'Dining American Red Cross'
   - rule: q4-2026-dining
     url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
     quote: '5% Cash Back rewards total for each $1 spent until $1,500 is spent'
-  - rule: q4-2026-dining
+  - rule: q4-2026-american-red-cross
     url: https://www.chase.com/personal/credit-cards/freedom/flex-learnmore
-    quote: 'For Dining purchases, you will earn 7% cash back (3% Dining cash back + 4% bonus category cash back)'
+    quote: 'To ensure your charitable donation is eligible for the 5% total Cash Back reward'
   - rule: q4-2026-american-red-cross
     url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
     quote: 'American Red Cross'
-  - rule: q4-2026-american-red-cross
-    url: https://www.chase.com/personal/credit-cards/freedom/flex-learnmore
-    quote: 'To ensure your charitable donation is eligible for the 5% total Cash Back reward'
   - rule: q4-2026-american-red-cross
     url: https://www.chase.com/personal/credit-cards/freedom/flex-learnmore
     quote: 'Local chapters may not be eligible due to transaction processing procedures'

package/data/cards/chase-ihg-one-rewards-business.yaml

@@ -56,20 +56,37 @@ milestones:
     rewards:
       - a free night at IHG hotels (up to 50,000 points)
     note: 'Use it within 12 months.'
-# Merchant statement credits, on top of what the purchase earns.
+  # Merchant statement credits, on top of what the purchase earns.
+  - id: diamond-status
+    spend: 50000
+    period: calendar_year
+    rewards:
+      - Diamond Elite status
+    valid_from: 2027-01-01
+    note: For the primary cardmember only. Status lasts the rest of the calendar year you qualify and the next.
 credits:
   - id: instacart
     match: { merchants: [instacart] }
     amount: 10
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
   - id: expensify
     match: { merchants: [expensify] }
     amount: 100
     period: calendar_year
     note: 'Bought directly from Expensify on expensify.com or in its app, applied automatically.'
 evidence:
+  - rule: diamond-status
+    url: https://creditcards.chase.com/business-credit-cards/IHG/business
+    quote: 'Starting January 1, 2027, after spending $50,000 with your IHG One Rewards Business Credit Card'
+  - rule: diamond-status
+    url: https://creditcards.chase.com/business-credit-cards/IHG/business
+    quote: 'will qualify for IHG One Rewards Diamond Elite Status for the remainder of the calendar year'
+  - rule: instacart
+    url: https://creditcards.chase.com/business-credit-cards/IHG/business
+    quote: 'from 5/1/2025 through 12/31/2027'
   - rule: base_rate
     url: https://creditcards.chase.com/business-credit-cards/IHG/business
     quote: 'Earn 3X points per $1 spent on all other purchases.'
@@ -143,6 +160,5 @@ evidence:
     url: https://creditcards.chase.com/business-credit-cards/IHG/business
     quote: 'Enjoy up to $100 in statement credits towards Expensify purchases each calendar year.'
 todo:
-  - "Starting January 1, 2027, $50,000 of purchases in a calendar year earns Diamond Elite status. It isn't listed as a milestone yet, because a milestone has no start date."
   - The $100 airline statement credit (after $250 on flights bought directly each calendar year) isn't modeled.
   - "The issuer's terms don't say whether purchases a credit pays for earn rewards. Its credits are modeled as earning the card's rate on the whole purchase, with the credit on top."

package/data/cards/chase-ihg-one-rewards-premier-select.yaml

@@ -55,10 +55,14 @@ credits:
     amount: 10
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
 todo:
   - "The issuer's terms don't say whether purchases a credit pays for earn rewards. Its credits are modeled as earning the card's rate on the whole purchase, with the credit on top."
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
+    quote: 'from 5/1/2025 through 12/31/2027'
   - rule: base_rate
     url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
     quote: 'Earn 3X points per $1 spent on all other purchases.'

package/data/cards/chase-ihg-one-rewards-premier.yaml

@@ -59,8 +59,12 @@ credits:
     amount: 10
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
+    quote: 'from 5/1/2025 through 12/31/2027'
   - rule: base_rate
     url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
     quote: 'Earn 3X points per $1 spent on all other purchases.'

package/data/cards/chase-ihg-one-rewards.yaml

@@ -70,7 +70,20 @@ milestones:
     rewards:
       - Gold Elite status
     note: "Every purchase on the card counts, by transaction date; balance transfers, cash advances and cash-like transactions don't. Status lasts through the end of the next calendar year. Chase says to allow 6-8 weeks for it to post."
+  - id: fourth-night-free
+    spend: 5000
+    period: calendar_year
+    rewards:
+      - a 4th Reward Night free on four-night award stays
+    valid_from: 2027-01-01
+    note: 'From 2027 the benefit needs this spending; through 2026 it comes with the card. It lasts the rest of the year you qualify and the next, on consecutive four-night standard-room Reward Night stays at one hotel (not paid or Points & Cash stays). Chase says to allow 6-8 weeks for it to be turned on.'
 evidence:
+  - rule: fourth-night-free
+    url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/one-rewards
+    quote: 'Starting in 2027, spend $5,000 on purchases in a calendar year and unlock a 4th Reward Night free'
+  - rule: fourth-night-free
+    url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/one-rewards
+    quote: 'After December 31, 2026: You will have to meet an annual spend requirement to enjoy this benefit.'
   - rule: base_rate
     url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/one-rewards
     quote: 'Earn 2X points per $1 spent on all other purchases.'
@@ -122,5 +135,3 @@ evidence:
   - rule: foreign_transaction_fee
     url: https://sites.chase.com/services/creatives/pricingandterms.html/content/dam/pricingandterms/LGC65295.html
     quote: 'Foreign Transactions None Penalty Fees'
-todo:
-  - "Starting in 2027, $5,000 of purchases in a calendar year unlocks a 4th Reward Night free on four-night award stays. It isn't listed as a milestone yet, because a milestone has no start date."

package/data/cards/chase-ink-business-cash.yaml

@@ -70,11 +70,15 @@ credits:
     amount: 20
     period: month
     enroll: true
-    note: "Instacart credits in an Instacart Business account, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits in an Instacart Business account, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
 todo:
   - "The issuer's terms don't say whether purchases a credit pays for earn rewards. Its credits are modeled as earning the card's rate on the whole purchase, with the credit on top."
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/business-credit-cards/ink/cash
+    quote: 'from 5/1/2025 through 12/31/2027'
   - rule: base_rate
     url: https://creditcards.chase.com/business-credit-cards/ink/cash
     quote: 'Earn 1% cash back on all other purchases'

package/data/cards/chase-ink-business-unlimited.yaml

@@ -43,11 +43,15 @@ credits:
     amount: 20
     period: month
     enroll: true
-    note: "Instacart credits in an Instacart Business account, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits in an Instacart Business account, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
 todo:
   - "The issuer's terms don't say whether purchases a credit pays for earn rewards. Its credits are modeled as earning the card's rate on the whole purchase, with the credit on top."
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/business-credit-cards/ink/unlimited
+    quote: 'from 5/1/2025 through 12/31/2027'
   - rule: base_rate
     url: https://creditcards.chase.com/business-credit-cards/ink/unlimited
     quote: 'Earn unlimited 1.5% Cash Back rewards on every purchase made for your business.'

package/data/cards/chase-prime-visa.yaml

@@ -14,10 +14,10 @@ base_rate: 1
 annual_fee: 0
 foreign_transaction_fee: 0
 welcome_offer:
-  dollars: 150
+  dollars: 200
   spend: 0
   months: 1
-  note: 'A $150 Amazon Gift Card loaded into your Amazon account on approval, not cash back; there''s no spend requirement, so spend 0 and months 1 stand in for "on approval". For Prime members. Chase: available "if you do not currently have an Amazon Visa or Prime Visa credit card", and the gift card "is only awarded to new cardmembers and at the time of card approval."'
+  note: 'Labeled a limited-time offer (up from $150), with no end date given. A $200 Amazon Gift Card loaded into your Amazon account on approval, not cash back; there''s no spend requirement, so spend 0 and months 1 stand in for "on approval". For Prime members; without Prime it''s $60. Chase: available "if you do not currently have an Amazon Visa or Prime Visa credit card", and the gift card "is only awarded to new cardmembers and at the time of card approval."'
 rules:
   - id: amazon
     match: { merchants: [amazon] }
@@ -132,7 +132,7 @@ evidence:
     quote: 'Annual Membership Fee None'
   - rule: welcome_offer
     url: https://creditcards.chase.com/cash-back-credit-cards/amazon-prime-rewards
-    quote: "Prime members, get a $150 Amazon Gift Card instantly loaded into your Amazon account's Gift Card Balance"
+    quote: "Prime members, get a $200 Amazon Gift Card instantly loaded into your Amazon account's Gift Card Balance"
   - rule: foreign_transaction_fee
     url: https://sites.chase.com/services/creatives/pricingandterms.html/content/dam/pricingandterms/LGC59329.html
     quote: 'Foreign Transactions None Penalty Fees'

package/data/cards/chase-sapphire-reserve.yaml

@@ -70,20 +70,29 @@ credits:
     amount: 150
     period: half_year
     enroll: true
-    note: 'StubHub and viagogo, through December 31, 2027. Activate once on chase.com.'
+    valid_to: 2027-12-31
+    note: 'StubHub and viagogo. Activate once on chase.com.'
   - id: lyft-credit
     match: { merchants: [lyft] }
     amount: 10
     period: month
-    note: 'A $10 Lyft credit in the app each month, through September 30, 2027, once the card is added to Lyft. Rides only, not memberships, fees, tips or taxes.'
+    valid_to: 2027-09-30
+    note: 'A $10 Lyft credit in the app each month, once the card is added to Lyft. Rides only, not memberships, fees, tips or taxes.'
   - id: peloton-credit
     match: { merchants: [peloton-membership] }
     amount: 10
     period: month
     enroll: true
-    note: 'Peloton memberships (All-Access, Rental, App+, Guide, App One, Strength+), through December 31, 2027. Activate once on chase.com.'
+    valid_to: 2027-12-31
+    note: 'Peloton memberships (All-Access, Rental, App+, Guide, App One, Strength+). Activate once on chase.com.'
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: stubhub
+    url: https://creditcards.chase.com/rewards-credit-cards/sapphire/reserve
+    quote: 'for a maximum of $300 annually for StubHub and viagogo purchases through 12/31/2027'
+  - rule: peloton-credit
+    url: https://creditcards.chase.com/rewards-credit-cards/sapphire/reserve
+    quote: 'Get $10 in statement credits per month on eligible Peloton memberships through 12/31/2027'
   - rule: base_rate
     url: https://creditcards.chase.com/rewards-credit-cards/sapphire/reserve
     quote: "You'll earn 1 point for each $1 spent on all other purchases"

package/data/cards/chase-united-business.yaml

@@ -57,7 +57,8 @@ credits:
     amount: 10
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
   - id: rideshare
     match: { categories: [transit.rideshare] }
     amount: 8
@@ -71,6 +72,9 @@ credits:
     note: 'Flights booked directly with JSX.'
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/business-credit-cards/united/united-business-card
+    quote: 'from 3/23/2025 through 12/31/2027'
   - rule: annual_fee
     url: https://creditcards.chase.com/business-credit-cards/united/united-business-card
     quote: '$150 Annual Fee'

package/data/cards/chase-united-club-business.yaml

@@ -50,7 +50,8 @@ credits:
     amount: 20
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027. Each credit applies to one order."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Each credit applies to one order."
   - id: rideshare
     match: { categories: [transit.rideshare] }
     amount: 12
@@ -69,6 +70,9 @@ credits:
     note: 'Hotel stays prepaid through Renowned Hotels and Resorts for United cardmembers.'
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/business-credit-cards/united/united-club-business
+    quote: 'from 3/23/2025 through 12/31/2027'
   - rule: annual_fee
     url: https://creditcards.chase.com/business-credit-cards/united/united-club-business
     quote: 'ANNUAL FEE $695'

package/data/cards/chase-united-club.yaml

@@ -68,7 +68,8 @@ credits:
     amount: 20
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027. Each credit applies to one order."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Each credit applies to one order."
   - id: rideshare
     match: { categories: [transit.rideshare] }
     amount: 12
@@ -87,6 +88,9 @@ credits:
     note: 'Hotel stays prepaid through Renowned Hotels and Resorts for United cardmembers.'
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/travel-credit-cards/united/united-club
+    quote: 'from 3/23/2025 through 12/31/2027'
   - rule: annual_fee
     url: https://creditcards.chase.com/travel-credit-cards/united/united-club
     quote: 'ANNUAL FEE $695'

package/data/cards/chase-united-explorer.yaml

@@ -55,7 +55,8 @@ credits:
     amount: 10
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card."
   - id: rideshare
     match: { categories: [transit.rideshare] }
     amount: 5
@@ -69,6 +70,9 @@ credits:
     note: 'Flights booked directly with JSX.'
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/travel-credit-cards/united/united-explorer
+    quote: 'from 3/23/2025 through 12/31/2027'
   - rule: annual_fee
     url: https://creditcards.chase.com/travel-credit-cards/united/united-explorer
     quote: '$0 intro annual fee for the first year, then $150'

package/data/cards/chase-united-quest.yaml

@@ -89,7 +89,8 @@ credits:
     amount: 15
     period: month
     enroll: true
-    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Through December 31, 2027. Each credit applies to one order."
+    valid_to: 2027-12-31
+    note: "Instacart credits, which need an active Instacart+ membership: activate Chase's complimentary one with the card. Each credit applies to one order."
   - id: rideshare
     match: { categories: [transit.rideshare] }
     amount: 8
@@ -108,6 +109,9 @@ credits:
     note: 'Hotel stays prepaid through Renowned Hotels and Resorts for United cardmembers.'
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: instacart
+    url: https://creditcards.chase.com/travel-credit-cards/united/united-quest
+    quote: 'from 3/23/2025 through 12/31/2027'
   - rule: annual_fee
     url: https://creditcards.chase.com/travel-credit-cards/united/united-quest
     quote: 'ANNUAL FEE $350'

package/data/cards/citi-strata-premier.yaml

@@ -54,9 +54,22 @@ rules:
     exclude: { categories: [gas.superstore] }
     rate: 3
     note: Only merchants coded as gas stations or EV charging. Excludes warehouse clubs, discount stores, department stores and convenience stores.
-# Not modeled: the $100 Annual Hotel Benefit.
+# Merchant statement credits, on top of what the purchase earns.
+credits:
+  - id: annual-hotel-benefit
+    match: { merchants: [citi-travel-hotels] }
+    amount: 100
+    period: calendar_year
+    min_amount: 500
+    note: "$100 off one hotel stay of $500 or more before taxes and fees, booked with Citi Travel (cititravel.com or 1-833-737-1288) and prepaid with the card, ThankYou points or both. Applied at booking. Air-and-hotel and hotel-and-car packages don't count. The $100 earns no points."
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: annual-hotel-benefit
+    url: https://www.citi.com/credit-cards/citi-strata-premier-credit-card
+    quote: 'Once per calendar year, enjoy $100 off a single hotel stay of $500 or more (excluding taxes and fees)'
+  - rule: annual-hotel-benefit
+    url: https://www.citi.com/credit-cards/citi-strata-premier-credit-card
+    quote: 'when booked through cititravel.com or 1-833-737-1288'
   - rule: base_rate
     url: https://www.citi.com/credit-cards/citi-strata-premier-credit-card
     quote: '1 point per dollar spent on All Other Purchases'

package/data/cards/wells-fargo-autograph-journey.yaml

@@ -35,9 +35,22 @@ rules:
     match: { categories: [travel] }
     rate: 3
     note: Car rentals, cruise lines, travel agencies, discount travel sites, timeshares and campgrounds.
-# Not modeled: the $50 yearly statement credit after a $50 airline purchase.
+# Merchant statement credits, on top of what the purchase earns.
+credits:
+  - id: airline-credit
+    match: { categories: [travel.flights] }
+    amount: 50
+    period: cardmember_year
+    min_amount: 50
+    note: "Applied automatically on the first purchase of $50 or more each year at a merchant coded as an airline (not charter or private jets). The first year runs from account opening; after that each year starts the first of the month after the annual fee is charged, modeled as the card's anniversary."
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
+  - rule: airline-credit
+    url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
+    quote: 'Plus a $50 annual statement credit with $50 minimum airline purchase'
+  - rule: airline-credit
+    url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
+    quote: 'when your card is used for your first airline purchase of at least $50'
   - rule: base_rate
     url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
     quote: '1 rewards point will be earned per $1 spent on other net purchases'
@@ -71,3 +84,5 @@ evidence:
   - rule: foreign_transaction_fee
     url: https://www.wellsfargo.com/credit-cards/autograph-journey-visa/terms/
     quote: 'Foreign Transaction None'
+todo:
+  - "The issuer's terms don't say whether purchases a credit pays for earn rewards. Its credits are modeled as earning the card's rate on the whole purchase, with the credit on top."

package/data/merchants/overrides.yaml

@@ -1005,7 +1005,7 @@
   category: other
   online:
     category: online_retail
-  note: A auto parts store, with no bonus category in store. Its website counts as online retail.
+  note: An auto parts store, with no bonus category in store. Its website counts as online retail.
 - id: advance-auto-parts
   name: Advance Auto Parts
   aliases: [advance auto]
@@ -1013,7 +1013,7 @@
   category: other
   online:
     category: online_retail
-  note: A auto parts store, with no bonus category in store. Its website counts as online retail.
+  note: An auto parts store, with no bonus category in store. Its website counts as online retail.
 - id: napa-auto-parts
   name: NAPA Auto Parts
   aliases: [napa auto]
@@ -1021,7 +1021,7 @@
   category: other
   online:
     category: online_retail
-  note: A auto parts store, with no bonus category in store. Its website counts as online retail.
+  note: An auto parts store, with no bonus category in store. Its website counts as online retail.
 - id: discount-tire
   name: Discount Tire
   aliases: [americas tire]