earnrate 0.2.5 → 0.2.7

package/README.md

@@ -9,7 +9,7 @@ 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 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), 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. 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-10-24) for how it compares to an existing card-picking MCP server.
@@ -33,7 +33,7 @@ earnrate add amex-gold
 earnrate whole foods 80
 ```
 
-Adding a card tells you anything else it needs to earn correctly, such as the categories you picked on Cash+, Amazon Prime for Prime Visa's 5%, or which rotating categories you've activated. `earnrate update` sets those. Using an AI assistant instead? [Add earnrate to it](#use-it-in-an-ai-assistant-mcp) and ask; name your cards or save them there.
+Adding a card tells you anything else it needs to earn correctly, such as the categories you picked on Cash+, Amazon Prime for Prime Visa's 5%, or which rotating categories you've activated. `earnrate update` and `earnrate memberships` set those. Memberships and point values (`earnrate values`) can be saved without any cards, and every answer uses them. Using an AI assistant instead? [Add earnrate to it](#use-it-in-an-ai-assistant-mcp) and ask; name your cards or save them there.
 
 With the [example wallet](wallet.example.yaml), it prints:
 
@@ -43,22 +43,27 @@ Whole Foods Market · $80
 Use Blue Cash Preferred: 6% back, about $4.80. High confidence.
 
   1. Blue Cash Preferred  6%  $4.80
-     6% cash back from its "us-supermarkets" rule. ...
+     6% cash back on supermarkets. ...
   2. Prime Visa           5%  $4.00
-     5% cash back from its "whole-foods" rule. Online or in-store.
+     5% cash back on Whole Foods Market, with Amazon Prime. ...
   3. Amex Gold            4%  $3.20
-     4x Amex Membership Rewards from its "us-supermarkets" rule. ...
+     4x Amex Membership Rewards on supermarkets. ...
      Valued at 1¢ per point: 4% back.
   + 6 more cards (--all lists them)
 
-Amex Gold beats Blue Cash Preferred here if Amex Membership Rewards (MR) points are worth 1.5¢ or more (you value them at 1¢).
+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¢.
 ```
 
 Options: `--online` or `--in-store`, `--valuation flat|points-heavy`, `--all`, `--json`, `--date`, `--country`. Run `earnrate --help` for details. To keep the wallet somewhere else, set `EARNRATE_WALLET` to its path.
 
-`earnrate cheatsheet` prints the card to use for each everyday kind of purchase this quarter (groceries, dining, gas, Amazon, Costco, travel, streaming, drugstores, everything else), with your caps, picks and activations as they are now. It's also in the My wallet tab on [earnrate.dev](https://earnrate.dev).
+`earnrate cheatsheet` prints the card to use for each everyday kind of purchase this quarter (groceries, dining, gas, Amazon, Costco, travel, streaming, drugstores, everything else), with your caps, picks and activations as they are now. `--cards` uses cards you name instead, and `--every-card` picks from every card to show what's worth getting. It's also in the My wallet tab on [earnrate.dev](https://earnrate.dev).
+
+`earnrate todo` lists what your saved cards need this quarter, soonest first: bonuses to activate (with Chase's deadline), categories to pick, caps running low and welcome bonuses to finish. `--ics earnrate.ics` also writes the dates as a calendar file with reminders. My wallet on earnrate.dev shows the same list as "To do now", with an "Add the dates to your calendar" button.
+
+`earnrate missed` lists the stores earnrate didn't recognize when you asked here, most asked about first. They're kept only on your computer; [open an issue](https://github.com/cwasley/earnrate/issues) to suggest one for the data.
 
 ### Your wallet
 
@@ -114,7 +119,7 @@ While the bonus is open and you're behind an even pace to the deadline, that car
 
 ### Which new card?
 
-These compare every card earnrate knows:
+These compare every card earnrate knows that's open to new applicants:
 
 ```sh
 earnrate best groceries                               # every card, ranked for one purchase
@@ -122,13 +127,13 @@ earnrate simulate groceries=600 dining=300 other=1000 # best cards and pairs for
 earnrate simulate groceries=600 other=1000 --wallet   # what a new card would add to yours
 ```
 
-`best` ranks every card earnrate knows for a merchant or a category, each set up at its best (the right category pick, activated, cap unused), with its annual fee and what earning the rate takes. Rates that need a membership like Amazon Prime are listed separately unless you pass `--member amazon-prime`, and a card that needs a membership to get (Costco Anywhere) says so. `simulate` spends your monthly amounts for a year, applying caps as they fill and reset, and ranks single cards and two-card pairs by rewards minus annual fees, counting the cost of a membership a card needs (Costco's, for Costco Anywhere) unless you pass `--member costco` or spend at Costco. Both take `--no-fee`, `--cash` or `--points`, `--issuer`, `--business` and `--valuation`. Welcome bonuses are left out of both; for those:
+`best` ranks every card earnrate knows for a merchant or a category, each set up at its best (the right category pick, activated, cap unused), with its annual fee and what earning the rate takes. Rates that need a membership like Amazon Prime are listed separately unless you've saved it (`earnrate memberships amazon-prime`) or pass `--member amazon-prime`, and a card that needs a membership to get (Costco Anywhere) says so. `simulate` spends your monthly amounts for a year, applying caps as they fill and reset, and ranks single cards and two-card pairs by rewards minus annual fees, counting the cost of a membership a card needs (Costco's, for Costco Anywhere) unless you have it or spend at Costco. Both take `--no-fee`, `--cash` or `--points`, `--issuer`, `--business` and `--valuation`. Welcome bonuses are left out of both; for those:
 
 ```sh
 earnrate offers --cash
 ```
 
-Ranks the welcome offers on cards you don't have by first-year value: the bonus at your point values minus the first year's annual fee (and a membership the card needs, if you don't have it). An offer the issuer rules out because of a card in your wallet is marked "likely not eligible" and listed last. `--points`, `--no-fee` and `--business` narrow it down. Each offer is the public one on the issuer's page, checked weekly like the earning rules, with the issuer's eligibility rules in its note. Offers can differ by person and by how you apply, and it covers only the cards earnrate knows. There are no affiliate or apply links.
+Ranks the welcome offers on cards you don't have by first-year value: the bonus at your point values minus the first year's annual fee (and a membership the card needs, if you don't have it). An offer the issuer rules out because of a card in your wallet (or one you name with `--cards`) is marked "likely not eligible" and listed last. `--points`, `--no-fee` and `--business` narrow it down. Each offer is the public one on the issuer's page, checked weekly like the earning rules, with the issuer's eligibility rules in its note. Offers can differ by person and by how you apply, and it covers only the cards earnrate knows. There are no affiliate or apply links.
 
 ### Import a statement
 
@@ -142,9 +147,9 @@ earnrate import gold.csv:amex-gold sapphire.csv:chase-sapphire-preferred
 It totals what each card earned against the best card in your wallet for each purchase, lists the merchants where another card would have earned the most, and flags merchants your issuer codes differently than earnrate assumes. Name several statements, each with its card, to get one report across them. It reads Amex and Chase activity CSVs. Download the CSV rather than a PDF statement: Chase's PDFs print the full card number in the payment coupon, and earnrate never handles card numbers.
 
 - It's a dry run unless you pass `--apply`, which records cap usage for the current period and spending toward an open welcome bonus in your wallet. Refunds lower both.
-- Only the date, description, amount, category and (for Chase) transaction type columns are read. The statements themselves are never stored: `--apply` writes cap and bonus totals plus a hash of each recorded purchase to `~/.earnrate/imported.json`, so importing the same file twice never counts twice.
+- Only the date, description, amount, category and (for Chase) transaction type columns are read. The statements themselves are never stored: `--apply` writes cap and bonus totals to your wallet, and a hash of each recorded purchase to `imported.json` beside it, so importing the same file twice never counts twice.
 - For a merchant earnrate doesn't know, it uses the statement's category and marks the row, since another issuer may code it differently.
-- `--valuation points-heavy` values points at transfer rates instead of your wallet's values, which can change which card wins.
+- `--valuation points-heavy` values Amex and Chase points at transfer rates instead of your wallet's values, which can change which card wins.
 
 ## Supported cards
 
@@ -176,16 +181,18 @@ claude mcp add --transport http earnrate https://mcp.earnrate.dev
 
 Or install it as a Claude Code plugin, which connects Claude Code and Cowork to the same server: `/plugin marketplace add cwasley/earnrate`, then `/plugin install earnrate@earnrate`.
 
+Use the connector (or plugin) or the local extension, not both: each keeps its own wallet, and with both connected Claude may answer from either. Each one says which wallet it used.
+
 **Or run it on your computer:** `earnrate mcp` runs earnrate as a local MCP server over stdio, with 14 tools (the connector has the same ones, plus `export_wallet`, `import_wallet`, `delete_wallet` and `switch_wallet` for its saved wallets):
 
 - `best_card_for_purchase`: which card to use, with reasons
 - `best_cards_for` and `simulate_spending`: compare every card earnrate knows, for one purchase or a year of spending, with no wallet needed
 - `resolve_merchant`: how a merchant was identified
-- `list_wallet`: your cards, caps left this period, chosen categories, welcome-bonus progress and the point values you've set
+- `list_wallet`: a to-do list for your cards right now, then your cards, caps left this period, chosen categories, welcome-bonus progress and the point values you've set
 - `cheat_sheet`: the card to use for each everyday kind of purchase this quarter
 - `compare_welcome_offers`: the best public sign-up offers on cards you don't have
 - `record_purchase`: books a purchase against its cap and any open welcome bonus in your wallet file, keeping your comments
-- `search_cards`, `add_card`, `update_card`, `remove_card`, `set_memberships` and `set_point_values`: set up the wallet in conversation, including what your points are worth
+- `search_cards`, `add_card`, `update_card`, `remove_card`, `set_memberships` and `set_point_values`: set up the wallet in conversation, including what your points are worth (memberships and point values need no cards)
 
 Saving cards is optional: name them in the conversation for one answer, or ask the assistant to save them, and it finds them, adds them, and asks about anything a card needs, like this quarter's Cash+ picks.
 
@@ -225,7 +232,7 @@ merchant text
 - **Merchants resolve to a category plus the assumption behind it.** "Whole Foods codes as a supermarket (MCC 5411)" is stated in the answer, and venues that can code more than one way (a restaurant inside a stadium or hotel) come back at medium confidence with the alternative spelled out. Unknown merchants fall back to base rates, or to an opt-in, cached and labeled Claude guess.
 - **The engine is pure and deterministic.** Given a purchase, a date and a set of cards (yours, or every card), it checks every rule against network acceptance, the date window, caps already used (split when a purchase straddles one), quarterly picks and activations, then values points at your cents-per-point, including pooling (Freedom Unlimited points are worth Sapphire points when you hold both). Ties, the valuation at which the runner-up would win, stale data, and a rotating card whose new quarter isn't in the data yet all show up in the answer.
 - **Wallet edits keep your file intact.** Adding or changing a card, or recording a purchase, splices in only the lines that changed and checks the result before saving, so comments and formatting in your YAML survive.
-- **Drift detection.** A weekly GitHub Action opens each issuer page in a headless browser, checks every quote is still there, and opens an issue when terms move. It stores only hashes of issuer text. A daily one checks earnrate.dev and the hosted server end to end (sign in, ask, save a card, delete the wallet) and opens an issue if anything fails.
+- **Drift detection.** A weekly GitHub Action opens each issuer page in a headless browser, checks every quote is still there, and opens an issue when terms move. It stores only hashes of issuer text. An hourly check confirms earnrate.dev and the hosted server are up, and a daily one checks them end to end (a browser load of the site, sign in, ask, save a card, delete the wallet, and the server's error counts), opening an issue if anything fails.
 - **Tested end to end.** Golden cases written from issuer terms, CLI snapshot tests, an MCP round trip over real stdio, an install test that packs and installs the npm package, and a check that no committed file contains a card number. CI runs all of it on every push.
 
 The code is TypeScript run directly by Node 24 (`src/`), with the engine in `src/engine/`, merchant resolution in `src/merchants/`, and the CLI and MCP server as thin layers over them. `site/` is earnrate.dev, which runs the same engine in the browser, and `remote/` is the hosted server at mcp.earnrate.dev.
@@ -243,10 +250,10 @@ Rotating categories (Freedom Flex) are added each quarter once the issuer posts
 
 ## Privacy Policy
 
-earnrate needs no account. The local version has no telemetry; the hosted server counts requests by method and tool name only. The full policy is at [earnrate.dev/privacy](https://earnrate.dev/privacy); in short:
+earnrate needs no account. The local version has no telemetry; the hosted server counts requests and errors by method, tool name or page only, never what was asked. The full policy is at [earnrate.dev/privacy](https://earnrate.dev/privacy); in short:
 
-- **The Claude connector:** earnrate's server at mcp.earnrate.dev receives each question Claude asks it (a store or kind of purchase, and any amount, spending or cards you gave) and answers without keeping it; request logging is off. It counts requests by method and tool name only. Connecting it starts an anonymous wallet (a recovery code, no email). It holds cards only if you save some: card IDs and the details you gave, never card numbers, and is encrypted with its own key that only your recovery code or your connected apps can unlock. Delete it any time; it's deleted automatically after 13 months unused, or a week if it's never used.
-- **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.
+- **The Claude connector:** earnrate's server at mcp.earnrate.dev receives each question Claude asks it (a store or kind of purchase, and any amount, spending or cards you gave) and answers without keeping it; request logging is off. It counts requests and errors by method, tool name or page only. Connecting it starts an anonymous wallet (a recovery code, no email). It holds only what you save: card IDs and the details you gave, memberships and point values, never card numbers, and is encrypted with its own key that only your recovery code or your connected apps can unlock. Delete it any time; it's deleted automatically after 13 months unused, or a week if it's never used.
+- **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. The site counts visits with Cloudflare Web Analytics, without cookies.

package/data/CHANGELOG.md

@@ -2,6 +2,62 @@
 
 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.02.4
+
+Customized Cash's todo about purchases that cross the $2,500 quarterly cap is resolved: past the cap, a BofA Rewards tier's boosted base rate now applies. No rates changed.
+
+| Card                                    | Field | Old → new                     | Source |
+| --------------------------------------- | ----- | ----------------------------- | ------ |
+| bank-of-america-customized-cash-rewards | todo  | removed the cap-crossing note | n/a    |
+
+## 2026.11.02.3
+
+The engine now prices spending past a cap at the card's best uncapped rate for that purchase when it beats the cap's own rate, so Freedom Flex's todo about crossing its $1,500 quarterly cap is resolved. No rates changed.
+
+| Card               | Field | Old → new                     | Source                                                                                 |
+| ------------------ | ----- | ----------------------------- | -------------------------------------------------------------------------------------- |
+| chase-freedom-flex | todo  | removed the cap-crossing note | [Freedom Flex FAQ](https://www.chase.com/personal/credit-cards/freedom/flex-learnmore) |
+
+## 2026.11.02.2
+
+Rules can carry `activate_by`, the issuer's activation deadline, so answers mention it only while a bonus isn't activated. No rates changed.
+
+| Card               | Field                 | Old → new                                                                | Source                                                                                                                                                   |
+| ------------------ | --------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| chase-freedom-flex | q4-2026-*.activate_by | "Activate by December 14, 2026" in each note → `activate_by: 2026-12-14` | [Freedom Flex FAQ](https://www.chase.com/personal/credit-cards/freedom/flex-learnmore): "This quarter, the deadline for activation is December 14, 2026" |
+
+## 2026.11.02.1
+
+A fine-print pass: every card was checked against all of its issuer's pages (card page, rates and fees, rewards and offer terms, FAQ), and the readable ones were added to `source_urls` so the weekly check watches them. All 57 cards are now `verified_by: claude`, last verified 2026-11-01. Most changes add fine-print quotes and exclusions to notes; these change answers:
+
+| Card                                            | Field                                     | Old → new                                                                             | Source                                                                                                                                     |
+| ----------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| chase-freedom-flex                              | q4-2026-dining.rate                       | 5 → 7                                                                                 | [Freedom Flex FAQ](https://www.chase.com/personal/credit-cards/freedom/flex-learnmore): "For Dining purchases, you will earn 7% cash back" |
+| chase-freedom-flex                              | q1-2027-streaming.match                   | streaming category → Chase's 18 listed services                                       | [rewards category FAQ](https://www.chase.com/personal/credit-cards/rewards-category-faq)                                                   |
+| chase-sapphire-preferred                        | streaming.match                           | streaming category → Chase's 18 listed services                                       | [rewards category FAQ](https://www.chase.com/personal/credit-cards/rewards-category-faq)                                                   |
+| chase-sapphire-preferred                        | peloton (new)                             | 5x through 2027-12-31, U.S.                                                           | [card page](https://creditcards.chase.com/rewards-credit-cards/sapphire/preferred)                                                         |
+| chase-prime-visa                                | whole-foods.geography                     | worldwide → us_only                                                                   | [card page](https://creditcards.chase.com/cash-back-credit-cards/amazon-prime-rewards)                                                     |
+| amex-platinum                                   | prepaid-car-rental-amex-travel (new)      | 1x → 2x on prepaid Amex Travel car rentals                                            | [offer terms](https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms)                |
+| amex-blue-cash-preferred                        | us-streaming.exclude                      | + Fandango at Home (not on Amex's list)                                               | [Amex rewards categories](https://www.americanexpress.com/us/content/rewards-info/retail.html)                                             |
+| amex-blue-cash-everyday                         | us-online-retail.match                    | + superstores and drugstores, online                                                  | [Amex rewards categories](https://www.americanexpress.com/us/content/rewards-info/retail.html)                                             |
+| capital-one-savor                               | grocery-stores.exclude                    | + warehouse clubs, convenience stores                                                 | [disclosures](https://disclosures.capitalone.com/disclosure.42167.en-US.html)                                                              |
+| citi-custom-cash                                | top-category                              | restaurants pick split out; Dodger Stadium and Bellagio earn 5% under their own picks | [Custom Cash terms](https://www.thankyou.com/ccterms)                                                                                      |
+| citi-aadvantage-executive                       | welcome_offer                             | 125,000 / $15,000 / 5 months → 80,000 / $8,000 / 3 months                             | [card page](https://www.citi.com/credit-cards/citi-aadvantage-executive-world-legend-mastercard)                                           |
+| usbank-cash-plus                                | five-percent.exclude, two-percent.exclude | + parking and tolls; + fast food at 2%                                                | [sample merchants](https://cashplus.usbank.com/cash-plus/samplemerchants)                                                                  |
+| wells-fargo-autograph                           | dining.exclude, gas.exclude               | + DoorDash, Uber Eats; + superstore and grocery-store gas                             | [Autograph terms](https://www.wellsfargo.com/credit-cards/autograph-visa/terms/)                                                           |
+| bank-of-america-atmos-rewards-ascent, -business | 2x rules exclude                          | + parking (MCC 7523)                                                                  | [Ascent terms](https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081060&productoffercode=RS&locale=en_US)       |
+| td-bank-nordstrom-visa                          | caterers (new)                            | 2x at caterers (MCC 5811)                                                             | [Nordstrom Visa terms](https://www.nordstrom.com/browse/nordy-club/terms-conditions)                                                       |
+| merchants/seed.yaml                             | peacock, showtime (new)                   | streaming merchants on Chase's list                                                   | [rewards category FAQ](https://www.chase.com/personal/credit-cards/rewards-category-faq)                                                   |
+
+## 2026.11.02
+
+Issuer names and the words people search for them by (`bofa`, `amex`) move from code to `data/issuers.yaml`; every card's issuer must be listed there. Cash+'s annual fee quote now matches both layouts of U.S. Bank's page. No rates changed.
+
+| File or card     | Field               | Old → new                                    | Source                                                                                     |
+| ---------------- | ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| issuers.yaml     | (new)               | names and search words for the 10 issuers    | n/a                                                                                        |
+| usbank-cash-plus | annual_fee evidence | "ANNUAL FEE $0 Annual fee" → "$0 Annual fee" | [card page](https://www.usbank.com/credit-cards/cash-plus-visa-signature-credit-card.html) |
+
 ## 2026.11.01.7
 
 Currencies can name how a redemption reads (`redemption_names`), so a wallet valuing SoFi points by redeeming into a SoFi account says so. No rates changed.

package/data/VERSION

@@ -1 +1 @@
-2026.11.01.7
+2026.11.02.4

package/data/cards/amex-blue-business-plus.yaml

@@ -3,10 +3,11 @@ name: American Express Blue Business Plus Credit Card
 issuer: amex
 network: amex
 currency: MR
-last_verified: 2026-10-26
-verified_by: collin
+last_verified: 2026-11-01
+verified_by: claude
 source_urls:
   - https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-blue-business-plus-credit-card-amex/
+  - https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/bluebusinessplus-credit-card/45094-9-0
 base_rate: 1
 business: true
 annual_fee: 0
@@ -15,7 +16,7 @@ welcome_offer:
   spend: 5000
   months: 3
   varies: true
-  note: 'The public offer is "as high as" 50,000 points; Amex shows the exact amount after you apply. "Welcome offers vary and you may not be eligible for an offer." The card-specific eligibility rules are in the offer terms, which the headless browser can''t load.'
+  note: 'The public offer is "as high as" 50,000 points; Amex shows the exact amount after you apply and before you accept. Not available if you have or have had this Card or previous versions of it, and Amex may also decline based on your card history. One offer per Card Account.'
 rules:
   - id: amex-travel
     match:
@@ -29,7 +30,7 @@ rules:
           amex-travel-cruises,
         ]
     rate: 2
-    note: Purchases on AmexTravel.com or the Amex Travel app. They don't count toward the $50,000 cap.
+    note: Scheduled flights, prepaid hotels, prepaid car rentals, cruises and prepaid Airbnb stays booked on AmexTravel.com or the Amex Travel app. Non-prepaid hotels and car rentals earn 1X. They don't count toward the $50,000 cap.
   - id: everyday-purchases
     match: { any: true }
     rate: 2
@@ -50,14 +51,21 @@ evidence:
   - rule: amex-travel
     url: https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-blue-business-plus-credit-card-amex/
     quote: 'Eligible purchases on AmexTravel.com also earn 2X points and will not count toward the first $50,000'
+  - rule: amex-travel
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/bluebusinessplus-credit-card/45094-9-0
+    quote: 'Eligible travel bookings do NOT include non-prepaid car rentals, non-prepaid hotels'
+  - rule: everyday-purchases
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/bluebusinessplus-credit-card/45094-9-0
+    quote: 'For the first $50,000 in eligible purchases in each calendar year you also earn one additional point'
   - rule: annual_fee
     url: https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-blue-business-plus-credit-card-amex/
     quote: 'Annual Fee: $0'
+  - rule: welcome_offer
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/bluebusinessplus-credit-card/45094-9-0
+    quote: 'if you have or have had this Card or previous versions of this Card'
   - rule: welcome_offer
     url: https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-blue-business-plus-credit-card-amex/
     quote: 'AS HIGH AS 50,000 Membership Rewards® Points'
   - rule: welcome_offer
     url: https://www.americanexpress.com/us/credit-cards/business/business-credit-cards/american-express-blue-business-plus-credit-card-amex/
     quote: 'after you spend $5,000 in purchases on your new Card within the first 3 months of Card Membership'
-todo:
-  - 'The offer-terms page (https://www.americanexpress.com/en-us/credit-cards/apply/terms/business/prospect/bluebusinessplus-credit-card/53591-9-0) returned only 735 characters to the headless browser, so it was not checked. Rates come from the card page only; what counts as an eligible purchase is unconfirmed.'

package/data/cards/amex-blue-cash-everyday.yaml

@@ -3,11 +3,12 @@ name: American Express Blue Cash Everyday Card
 issuer: amex
 network: amex
 currency: cash
-last_verified: 2026-10-31
+last_verified: 2026-11-01
 verified_by: claude
 source_urls:
   - https://www.americanexpress.com/us/credit-cards/card/blue-cash-everyday/
   - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-everyday-credit-card/25330-10-0
+  - https://www.americanexpress.com/us/content/rewards-info/retail.html
 base_rate: 1
 annual_fee: 0
 welcome_offer:
@@ -30,6 +31,8 @@ rules:
       categories:
         [
           online_retail,
+          superstore,
+          drugstore,
           department_store,
           clothing,
           electronics,
@@ -41,7 +44,7 @@ rules:
     channel: online
     geography: us_only
     cap: { amount: 6000, period: calendar_year, then_rate: 1 }
-    note: U.S. merchants selling physical goods, paid on their website or app. Not restaurants, supermarkets, gas, car dealers, travel, entertainment or services. Ordered online but paid in store, in-store mobile wallet, phone or mail orders, and buy-now-pay-later don't count.
+    note: U.S. merchants selling physical goods, paid on their website or app, such as Amazon.com, Walmart.com, Chewy.com, Wayfair.com and drugstore sites. Not restaurants, supermarkets, gas, car dealers, travel, entertainment or services, and not online grocery orders, food delivery, rideshare, streaming or wireless bills. Ordered online but paid in store, in-store mobile wallet, phone or mail orders, and buy-now-pay-later don't count.
   - id: us-gas
     match: { categories: [gas] }
     exclude: { categories: [gas.grocery_store, gas.superstore] }
@@ -68,6 +71,12 @@ evidence:
   - rule: us-online-retail
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-everyday-credit-card/25330-10-0
     quote: 'from a U.S. retail merchant that sells physical goods or merchandise directly to consumers'
+  - rule: us-online-retail
+    url: https://www.americanexpress.com/us/content/rewards-info/retail.html
+    quote: 'Major retailers (e.g., Amazon.com, Walmart.com)'
+  - rule: us-online-retail
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-everyday-credit-card/25330-10-0
+    quote: 'Basic Card Members will not receive 3% cash back for purchases ordered online but paid for in store'
   - rule: us-gas
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-everyday-credit-card/25330-10-0
     quote: '3% cash back on the first $6,000 of purchases of gasoline at gas stations'
@@ -87,4 +96,4 @@ evidence:
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-everyday-credit-card/25330-10-0
     quote: 'if you have or have had this Card, the Cash Magnet® Card, the Blue Cash Preferred® Card'
 todo:
-  - 'Amazon is filed as online retail, so it earns 3% here; superstore sites (walmart.com, target.com) and online drugstores may too, but the terms define the category by merchant code and type of goods, so they are not modeled.'
+  - "Amex's online retail examples name Walmart.com and drug stores, so superstore and drugstore sites earn 3% here; online grocery orders don't, but a grocery order on walmart.com or target.com can't be told apart from other purchases there. Warehouse club sites (costco.com, samsclub.com) aren't named, so they aren't modeled."

package/data/cards/amex-blue-cash-preferred.yaml

@@ -3,11 +3,12 @@ name: American Express Blue Cash Preferred Card
 issuer: amex
 network: amex
 currency: cash
-last_verified: 2026-10-31
+last_verified: 2026-11-01
 verified_by: claude
 source_urls:
   - https://www.americanexpress.com/us/credit-cards/card/blue-cash-preferred/
   - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
+  - https://www.americanexpress.com/us/content/rewards-info/retail.html
 base_rate: 1
 annual_fee: 95
 first_year_fee: 0
@@ -27,13 +28,14 @@ rules:
     note: Superstores, convenience stores, warehouse clubs and meal-kit delivery services are not supermarkets.
   - id: us-streaming
     match: { categories: [streaming] }
+    exclude: { merchants: [fandango-at-home] }
     rate: 6
     geography: us_only
-    note: Select providers only (list at americanexpress.com/rewards-info). Subscriptions bundled with or billed by another company (cable, phone, a car maker) may not count.
+    note: Only providers on Amex's Select U.S. Streaming Subscriptions list (americanexpress.com/rewards-info), such as Netflix, Hulu, Disney+, HBO Max, Spotify, Apple Music, YouTube TV and SiriusXM. Subscriptions bundled with or billed by another company (cable, phone, a car maker) may not count.
   - id: transit
     match: { categories: [transit] }
     rate: 3
-    note: Trains, taxis, rideshare, ferries, tolls, parking, buses and subways. Airfare, car rental and cruises aren't transit.
+    note: Trains, taxis, rideshare, ferries, tolls, parking, buses and subways. Airfare, car rental, cruises and trams aren't transit.
   - id: us-gas
     match: { categories: [gas] }
     exclude: { categories: [gas.grocery_store, gas.superstore] }
@@ -48,15 +50,27 @@ evidence:
   - rule: us-supermarkets
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
     quote: 'at supermarkets located in the U.S. (superstores, convenience stores, warehouse clubs,'
+  - rule: us-supermarkets
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
+    quote: '6% cash back on the first $6,000 of eligible purchases in a calendar year'
   - rule: us-streaming
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
     quote: '6% cash back on eligible purchases of U.S. streaming subscriptions'
+  - rule: us-streaming
+    url: https://www.americanexpress.com/us/content/rewards-info/retail.html
+    quote: 'must be made from a provider that is included on our list of Select U.S. Streaming Subscriptions'
   - rule: transit
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
     quote: '3% cash back on eligible purchases on transit, including trains,'
+  - rule: transit
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
+    quote: '(airfare, car rental and cruises are not considered transit)'
   - rule: us-gas
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
     quote: 'purchases of gasoline at gas stations located in the U.S.'
+  - rule: us-gas
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/blue-cash-preferred-credit-card/25330-10-0#offer-terms
+    quote: 'superstores, supermarkets and warehouse clubs that sell gasoline are not considered gas stations'
   - rule: annual_fee
     url: https://www.americanexpress.com/us/credit-cards/card/blue-cash-preferred/
     quote: '$0 intro annual fee for the first year, then $95'

package/data/cards/amex-gold.yaml

@@ -3,11 +3,12 @@ name: American Express Gold Card
 issuer: amex
 network: amex
 currency: MR
-last_verified: 2026-10-24
-verified_by: collin
+last_verified: 2026-11-01
+verified_by: claude
 source_urls:
   - https://www.americanexpress.com/us/credit-cards/card/gold-card/
   - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
+  - https://www.americanexpress.com/us/content/rewards-info/retail.html
 base_rate: 1
 annual_fee: 325
 welcome_offer:
@@ -23,7 +24,7 @@ rules:
     rate: 4
     cap: { amount: 50000, period: calendar_year, then_rate: 1 }
     exclude: { merchants: [dodger-stadium, bellagio], mccs: [5813] }
-    note: Worldwide. Not at restaurants inside hotels, casinos or event venues, or at bars, bakeries, cafeterias or caterers. Third-party delivery counts only in the U.S.
+    note: Worldwide, fast food included. Not at restaurants inside hotels, casinos or event venues, at events or for event tickets, or at bars, nightclubs, breweries, bakeries, cafeterias, caterers, theatre clubs or meeting venues. Third-party delivery counts only in the U.S.
   - id: us-supermarkets
     match: { categories: [grocery.supermarket] }
     exclude: { categories: [superstore, warehouse_club, convenience_store] }
@@ -64,12 +65,27 @@ evidence:
   - rule: restaurants
     url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
     quote: '4X POINTS At Restaurants Worldwide, on up to $50K'
+  - rule: restaurants
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
+    quote: 'on the first $50,000 of eligible purchases per calendar year at restaurants worldwide'
+  - rule: restaurants
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
+    quote: 'purchases at bars, nightclubs, cafeterias, caterers, theatre clubs, breweries, bakeries, and meeting venues'
+  - rule: restaurants
+    url: https://www.americanexpress.com/us/content/rewards-info/retail.html
+    quote: 'fast food restaurants are included in the global restaurants rewards category'
   - rule: us-supermarkets
     url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
     quote: '4X POINTS On Groceries At U.S. supermarkets, on up to $25K'
+  - rule: us-supermarkets
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
+    quote: 'warehouse clubs, and meal-kit delivery services are not considered supermarkets'
   - rule: flights
     url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
     quote: '3X POINTS On Flights Booked through AmexTravel.com or Amex Travel App™'
+  - rule: flights
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
+    quote: 'charged directly with passenger airlines (charter flights and private jet flights are excluded)'
   - rule: prepaid-hotels-amex-travel
     url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
     quote: '5X Points per dollar spent on Prepaid Hotels booked through AmexTravel.com'

package/data/cards/amex-platinum.yaml

@@ -3,8 +3,8 @@ name: The Platinum Card from American Express
 issuer: amex
 network: amex
 currency: MR
-last_verified: 2026-10-24
-verified_by: collin
+last_verified: 2026-11-01
+verified_by: claude
 source_urls:
   - https://www.americanexpress.com/us/credit-cards/card/platinum/
   - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
@@ -37,10 +37,14 @@ rules:
     match: { merchants: [airbnb-amex-travel] }
     rate: 5
     note: Prepaid Airbnb stays booked through Amex Travel, with your Airbnb account linked to Amex.
+  - id: prepaid-car-rental-amex-travel
+    match: { merchants: [amex-travel-car-rentals] }
+    rate: 2
+    note: Prepaid car rentals only.
   - id: cruises-amex-travel
     match: { merchants: [amex-travel-cruises] }
     rate: 2
-    note: Platinum's only 2x Amex Travel booking type.
+    note: Cruises booked and charged through AmexTravel.com or by phone with Amex Travel. Payments made directly to the cruise line don't count.
 # Issuer text backing each rule; `yarn check-sources` checks it weekly.
 evidence:
   - rule: base_rate
@@ -49,6 +53,15 @@ evidence:
   - rule: flights
     url: https://www.americanexpress.com/us/credit-cards/card/platinum/
     quote: '5X POINTS On Flights Booked directly with airlines or through'
+  - rule: flights
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
+    quote: 'air tickets on scheduled flights, of up to $500,000 in charges per calendar year'
+  - rule: flights
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
+    quote: 'charter flights, private jet flights, flights that are part of tours, cruises, or travel packages'
+  - rule: prepaid-car-rental-amex-travel
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
+    quote: 'prepaid car rental bookings through AmexTravel.com or the Amex Travel'
   - rule: prepaid-hotels-amex-travel
     url: https://www.americanexpress.com/us/credit-cards/card/platinum/
     quote: '5X POINTS On Prepaid Hotels Booked through American Express Travel ®'
@@ -58,6 +71,9 @@ evidence:
   - rule: cruises-amex-travel
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
     quote: 'only eligible for 1 additional point on cruise reservations'
+  - rule: cruises-amex-travel
+    url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
+    quote: 'prepaid cruise reservations booked through AmexTravel.com or by calling the phone number'
   - rule: flights-amex-travel
     url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
     quote: 'booked directly with passenger airlines or through American Express Travel'

package/data/cards/bank-of-america-atmos-rewards-ascent.yaml

@@ -3,7 +3,7 @@ name: Atmos Rewards Ascent Visa Signature Credit Card
 issuer: bank-of-america
 network: visa
 currency: atmos-points
-last_verified: 2026-10-31
+last_verified: 2026-11-01
 verified_by: claude
 source_urls:
   - https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
@@ -22,8 +22,9 @@ rules:
     note: Card points only; points and status from flying aren't card earnings.
   - id: gas-ev-cable-streaming-transit
     match: { categories: [gas, ev_charging, tv_internet, streaming, transit] }
+    exclude: { mccs: [7523] }
     rate: 2
-    note: Local transit includes rideshare. Bank of America says "cable"; internet-only or phone bills may not count.
+    note: Local transit includes rideshare, trains, buses, ferries and tolls; parking isn't on Bank of America's list. Cable means cable, satellite and other pay TV or streaming; internet-only or phone bills may not count.
   - id: alaska-and-hawaiian-with-boa-account
     match: { merchants: [alaska-airlines, hawaiian-airlines] }
     rate: 3.3
@@ -31,6 +32,7 @@ rules:
     note: 3x plus the 10% rewards bonus for holding an eligible Bank of America account.
   - id: gas-ev-cable-streaming-transit-with-boa-account
     match: { categories: [gas, ev_charging, tv_internet, streaming, transit] }
+    exclude: { mccs: [7523] }
     rate: 2.2
     requires: { membership: bank-of-america-account }
     note: 2x plus the 10% rewards bonus for holding an eligible Bank of America account.
@@ -49,6 +51,12 @@ evidence:
   - rule: gas-ev-cable-streaming-transit
     url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
     quote: 'eligible gas, EV charging station, cable, streaming services and local transit purchases, including rideshare'
+  - rule: gas-ev-cable-streaming-transit
+    url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081060&productoffercode=RS&locale=en_US
+    quote: 'Passenger Railways; Taxicabs and Limousines (including rideshare); Bus Lines; Tolls and Bridge Fees'
+  - rule: gas-ev-cable-streaming-transit
+    url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081060&productoffercode=RS&locale=en_US
+    quote: 'Cable, Satellite and Other Pay Television/Radio/Streaming Services'
   - rule: alaska-and-hawaiian-with-boa-account
     url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
     quote: '10% rewards bonus on all points earned from card purchases if you have an eligible Bank of America® account'

package/data/cards/bank-of-america-atmos-rewards-business.yaml

@@ -3,8 +3,8 @@ name: Atmos Rewards Visa Signature Business Card
 issuer: bank-of-america
 network: visa
 currency: atmos-points
-last_verified: 2026-10-26
-verified_by: collin
+last_verified: 2026-11-01
+verified_by: claude
 source_urls:
   - https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
   - https://www.bankofamerica.com/smallbusiness/credit-cards/terms-and-conditions/?campaignid=4080500&productoffercode=CX&locale=en_US
@@ -23,8 +23,9 @@ rules:
     note: Card points only; points and status from flying aren't card earnings.
   - id: gas-ev-shipping-transit
     match: { categories: [gas, ev_charging, shipping, transit] }
+    exclude: { mccs: [7523] }
     rate: 2
-    note: Local transit includes rideshare.
+    note: Local transit includes rideshare, trains, buses, ferries and tolls; parking isn't on Bank of America's list. Shipping is motor freight carriers and courier services.
   - id: alaska-and-hawaiian-with-boa-account
     match: { merchants: [alaska-airlines, hawaiian-airlines] }
     rate: 3.3
@@ -32,6 +33,7 @@ rules:
     note: 3x plus the 10% rewards bonus when the company has an eligible Bank of America small business account.
   - id: gas-ev-shipping-transit-with-boa-account
     match: { categories: [gas, ev_charging, shipping, transit] }
+    exclude: { mccs: [7523] }
     rate: 2.2
     requires: { membership: bank-of-america-small-business-account }
     note: 2x plus the 10% rewards bonus when the company has an eligible Bank of America small business account.
@@ -50,6 +52,12 @@ evidence:
   - rule: gas-ev-shipping-transit
     url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
     quote: 'eligible gas, EV charging station, shipping and local transit purchases, including rideshare'
+  - rule: gas-ev-shipping-transit
+    url: https://www.bankofamerica.com/smallbusiness/credit-cards/terms-and-conditions/?campaignid=4080500&productoffercode=CX&locale=en_US
+    quote: 'Motor Freight Carriers, Courier Services; Local and Suburban Commuter Passenger Transportation, Including Ferries'
+  - rule: gas-ev-shipping-transit
+    url: https://www.bankofamerica.com/smallbusiness/credit-cards/terms-and-conditions/?campaignid=4080500&productoffercode=CX&locale=en_US
+    quote: 'Passenger Railways; Taxicabs and Limousines (including rideshare); Bus Lines; Tolls and Bridge Fees'
   - rule: alaska-and-hawaiian-with-boa-account
     url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
     quote: 'earn a 10% rewards bonus on all points earned from card purchases'
@@ -62,6 +70,9 @@ evidence:
   - rule: annual_fee
     url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
     quote: 'Plus, a low annual fee of $70 for the company and $25 per card.'
+  - rule: annual_fee
+    url: https://www.bankofamerica.com/smallbusiness/credit-cards/terms-and-conditions/?campaignid=4080500&productoffercode=CX&locale=en_US
+    quote: '$70 for the company and $25 per card.'
   - rule: welcome_offer
     url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
     quote: 'Limited-time online offer: 70,000 bonus points + $99 Companion Fare'

package/data/cards/bank-of-america-atmos-rewards-summit.yaml

@@ -3,7 +3,7 @@ name: Atmos Rewards Summit Visa Infinite Credit Card
 issuer: bank-of-america
 network: visa
 currency: atmos-points
-last_verified: 2026-10-31
+last_verified: 2026-11-01
 verified_by: claude
 source_urls:
   - https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
@@ -48,6 +48,9 @@ evidence:
   - rule: dining
     url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
     quote: 'Earn 3 points for every $1 spent on eligible dining, foreign transaction, Alaska Airlines and Hawaiian Airlines purchases.'
+  - rule: dining
+    url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081112&productoffercode=S2&locale=en_US
+    quote: 'Caterers, Eating Places, Restaurants, Bars, Cocktail Lounges, Discotheques, Nightclubs'
   - rule: alaska-and-hawaiian-with-boa-account
     url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
     quote: '10% rewards bonus on all points earned from card purchases if you have an eligible Bank of America® account'