earnrate 0.2.6 → 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.
@@ -43,11 +43,11 @@ 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)
 
@@ -61,6 +61,10 @@ Options: `--online` or `--in-store`, `--valuation flat|points-heavy`, `--all`, `
 
 `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
 
 The wallet is a YAML file (`~/.earnrate/wallet.yaml`) listing your cards by ID, which is each card's file name in [`data/cards/`](data/cards). `earnrate add`, `update`, `remove`, `memberships` and `values` write it for you and keep your comments, or you can edit it by hand. Only the cards are required:
@@ -184,7 +188,7 @@ Use the connector (or plugin) or the local extension, not both: each keeps its o
 - `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
@@ -228,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.
@@ -249,7 +253,7 @@ Rotating categories (Freedom Flex) are added each quarter once the issuer posts
 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 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.
+- **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,22 @@
 
 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.

package/data/VERSION

@@ -1 +1 @@
-2026.11.02.2
+2026.11.02.4

package/data/cards/bank-of-america-customized-cash-rewards.yaml

@@ -212,5 +212,4 @@ evidence:
 todo:
   - New accounts earn 6% in the choice category for the first year (an extra 3%, inside the same $2,500 quarterly cap, with no BofA Rewards bonus on the extra 3%). earnrate can't see when an account was opened, so this isn't modeled.
   - 'The BofA Rewards rules use proposed membership ids: bofa-rewards-member, bofa-rewards-preferred-plus, bofa-rewards-preferred-honors and bofa-rewards-premier. Cardholders who joined Preferred Rewards before May 26, 2026 may have an "extended card benefit" that Bank of America doesn''t define.'
-  - With a BofA Rewards tier, a purchase that crosses the $2,500 cap counts the part past the cap at 1% instead of the tier's boosted base rate, so it's slightly understated.
   - "Online shopping counts any online purchase earnrate can't place in an excluded category, including unknown merchants. Bank of America also excludes doctors, government, insurance, schools and other non-retail services, which earnrate can't tell apart."

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

@@ -187,5 +187,4 @@ evidence:
     url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
     quote: 'Earn a $250 bonus after you spend $500 on purchases in the first 3 months from account opening'
 todo:
-  - 'q4-2026-dining: a single dining purchase that crosses the $1,500 cap counts the part over the cap at 1%, not the everyday 3%; whole purchases after the cap correctly fall back to the 3% dining rule.'
   - 'Q2 2027 (Apr-Jun) shows "Coming Soon"; add it after Chase posts it (activation opens March 15, 2027).'

package/dist/brand.js

@@ -5,6 +5,7 @@ export const MCP_SERVER_NAME = 'earnrate';
 export const CONFIG_DIR = '.earnrate'; // under the home directory
 export const WALLET_ENV_VAR = 'EARNRATE_WALLET';
 export const MERCHANT_CACHE_ENV_VAR = 'EARNRATE_MERCHANT_CACHE';
+export const MISSED_ENV_VAR = 'EARNRATE_MISSED_MERCHANTS';
 export const LLM_ENV_VAR = 'EARNRATE_LLM';
 export const LLM_MODEL_ENV_VAR = 'EARNRATE_LLM_MODEL';
 export const LLM_MAX_CALLS_ENV_VAR = 'EARNRATE_LLM_MAX_CALLS';

package/dist/cli/missed.js

@@ -0,0 +1,65 @@
+import { rm } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
+import { CLI_NAME, MISSED_ENV_VAR } from "../brand.js";
+import { loadCatalog } from "../data/load.js";
+import { categoryPhrase, shortDate } from "../engine/text.js";
+import { missedPath, readMissed } from "../merchants/missed.js";
+import { displayPath, USAGE_ERROR } from "./run.js";
+const MISSED_HELP = `Usage: ${CLI_NAME} missed [--clear]
+
+Stores earnrate didn't recognize when you asked about them here (the command
+line or the local MCP server), most asked about first. They're kept only on
+this computer. To suggest one for earnrate's data, open an issue at
+https://github.com/cwasley/earnrate/issues.
+
+Set ${MISSED_ENV_VAR}=off to stop keeping the list, or to a path to keep it
+somewhere else.
+
+Options:
+  --clear      Delete the list.
+  -h, --help   Show this help.
+`;
+export async function runMissed(argv, io) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            options: {
+                clear: { type: 'boolean' },
+                help: { type: 'boolean', short: 'h' },
+            },
+        });
+    }
+    catch (e) {
+        io.stderr(`${e instanceof Error ? e.message : String(e)}\n${MISSED_HELP}`);
+        return USAGE_ERROR;
+    }
+    if (parsed.values.help) {
+        io.stdout(MISSED_HELP);
+        return 0;
+    }
+    const file = missedPath(io.env);
+    if (file === null) {
+        io.stdout(`The list is off (${MISSED_ENV_VAR}=off).\n`);
+        return 0;
+    }
+    if (parsed.values.clear) {
+        await rm(file, { force: true });
+        io.stdout(`Deleted ${displayPath(file)}.\n`);
+        return 0;
+    }
+    const missed = await readMissed(file);
+    if (missed.length === 0) {
+        io.stdout('No unrecognized stores yet.\n');
+        return 0;
+    }
+    const catalog = await loadCatalog();
+    const lines = missed
+        .sort((a, b) => b.count - a.count || b.last_seen.localeCompare(a.last_seen))
+        .map((m) => {
+        const kinds = m.categories.map((c) => categoryPhrase(catalog, c));
+        return `- ${m.name}: ${String(m.count)} ${m.count === 1 ? 'time' : 'times'}, last ${shortDate(m.last_seen)}${kinds.length === 0 ? '' : ` (taken as ${kinds.join(', ')})`}`;
+    });
+    io.stdout(`${lines.join('\n')}\n\nKept in ${displayPath(file)}. Suggest additions at https://github.com/cwasley/earnrate/issues.\n`);
+    return 0;
+}

package/dist/cli/run.js

@@ -14,10 +14,13 @@ import { formatRecommendation, plain, } from "../format/recommendation.js";
 import { DEFAULT_LLM_MODEL } from "../merchants/anthropic.js";
 import { DEFAULT_MAX_CALLS } from "../merchants/fallback.js";
 import { llmEnabled, openLlmSession } from "../merchants/from-env.js";
+import { missedPath, missLogAt } from "../merchants/missed.js";
 import { resolvePlace, withCallerCategory } from "../merchants/resolve.js";
 import { packageVersion } from "../version.js";
 import { membershipProblem, parseCliArgs } from "./args.js";
 import { runCheatSheet } from "./cheatsheet.js";
+import { runMissed } from "./missed.js";
+import { runTodo } from "./todo.js";
 import { runBest, runSimulate } from "./explore.js";
 import { runImport } from "./import.js";
 import { runOffers } from "./offers.js";
@@ -47,6 +50,8 @@ Save your cards (optional):
 
 Other commands:
   ${CLI_NAME} cheatsheet                           The best card for each category this quarter.
+  ${CLI_NAME} todo [--ics file]                    What your cards need this quarter, with dates.
+  ${CLI_NAME} missed                               Stores earnrate didn't recognize, kept on this computer.
   ${CLI_NAME} import <statement.csv> --card <id>   Replay a statement against your wallet.
   ${CLI_NAME} offers [--cash | --points]           Rank welcome offers on cards you don't have.
   ${CLI_NAME} mcp                                  Run the MCP server over stdio, for AI assistants.
@@ -160,6 +165,10 @@ export async function run(argv, io) {
         return runBest(argv.slice(1), io);
     if (argv[0] === 'cheatsheet')
         return runCheatSheet(argv.slice(1), io);
+    if (argv[0] === 'todo')
+        return runTodo(argv.slice(1), io);
+    if (argv[0] === 'missed')
+        return runMissed(argv.slice(1), io);
     if (argv[0] === 'simulate')
         return runSimulate(argv.slice(1), io);
     const command = argv[0];
@@ -214,6 +223,12 @@ export async function run(argv, io) {
         merchant = resolved.merchant;
         notices.push(...resolved.notices);
     }
+    const missedFile = missedPath(io.env);
+    if (missedFile !== null &&
+        (merchant.source === 'none' ||
+            merchant.source === 'caller' ||
+            merchant.source === 'llm'))
+        await missLogAt(missedFile).note(purchase.merchant, merchant.source === 'none' ? null : merchant.category, io.today);
     if (loaded === 'none') {
         const saved = await savedSettings(io);
         const explored = exploreCards(catalog, {

package/dist/cli/todo.js

@@ -0,0 +1,62 @@
+import { writeFile } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
+import { CLI_NAME } from "../brand.js";
+import { loadCatalog, walletPath } from "../data/load.js";
+import { checklist, checklistCalendar } from "../engine/checklist.js";
+import { cardText } from "../format/card-text.js";
+import { dateProblem } from "./args.js";
+import { displayPath, readWallet, RUNTIME_ERROR, USAGE_ERROR, } from "./run.js";
+const TODO_HELP = `Usage: ${CLI_NAME} todo [--ics <file>] [--date <YYYY-MM-DD>]
+
+What your saved cards need this period, soonest first: bonuses to activate,
+categories to pick, spending caps running low, welcome bonuses to finish, and
+rotating categories the issuer hasn't posted yet.
+
+Options:
+  --ics <file>          Also write the dated items as a calendar file to import
+                        into your calendar app, with reminders two days before.
+  --date <YYYY-MM-DD>   The day to check. Default: today.
+  -h, --help            Show this help.
+`;
+export async function runTodo(argv, io) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            options: {
+                ics: { type: 'string' },
+                date: { type: 'string' },
+                help: { type: 'boolean', short: 'h' },
+            },
+        });
+    }
+    catch (e) {
+        io.stderr(`${e instanceof Error ? e.message : String(e)}\n${TODO_HELP}`);
+        return USAGE_ERROR;
+    }
+    const { values } = parsed;
+    if (values.help) {
+        io.stdout(TODO_HELP);
+        return 0;
+    }
+    const problem = dateProblem(values.date);
+    if (problem !== null) {
+        io.stderr(`${problem}\n`);
+        return USAGE_ERROR;
+    }
+    const catalog = await loadCatalog();
+    const wallet = await readWallet(walletPath(io.env), io);
+    if (wallet === null)
+        return RUNTIME_ERROR;
+    const today = values.date ?? io.today;
+    const items = checklist(catalog, wallet, today, undefined, cardText(catalog).shortName);
+    io.stdout(items.length === 0
+        ? 'Nothing to do: every bonus is activated, every pick is made, and no cap or welcome bonus needs attention.\n'
+        : `${items.map((i) => `- ${i.text}`).join('\n')}\n`);
+    if (values.ics !== undefined) {
+        const stamp = `${new Date().toISOString().replace(/[-:]/g, '').slice(0, 15)}Z`;
+        await writeFile(values.ics, checklistCalendar(items, stamp));
+        io.stdout(`Wrote ${displayPath(values.ics)}; open it to add the dates to your calendar.\n`);
+    }
+    return 0;
+}

package/dist/cli/wallet.js

@@ -208,7 +208,7 @@ export async function runWalletCommand(command, argv, io) {
     if (command === 'memberships') {
         if (positionals.length === 0 && !values.none) {
             const held = await heldWallet(io);
-            io.stdout(`Yours: ${held && held.memberships.length > 0 ? held.memberships.join(', ') : 'none'}\nKnown: ${knownMemberships(catalog).join(', ')}\n`);
+            io.stdout(`Yours: ${held && held.memberships.length > 0 ? held.memberships.map((m) => `${membershipName(catalog, m)} (${m})`).join(', ') : 'none'}\nKnown: ${knownMemberships(catalog).join(', ')}\n`);
             return 0;
         }
         if (positionals.length > 0 && values.none) {

package/dist/engine/cheat-sheet.js

@@ -4,6 +4,7 @@ import { bonusStatus } from "./bonus.js";
 import { EPSILON, isClose } from "./compare.js";
 import { periodKey } from "./periods.js";
 import { recommend } from "./recommend.js";
+import { checklist } from "./checklist.js";
 import { setupNotes } from "./setup.js";
 import { capitalize, feeText, listed, money, shortDate } from "./text.js";
 // The everyday kinds of purchase: the cheat sheet's rows and the site's
@@ -82,10 +83,18 @@ export function cheatSheet(catalog, wallet, date, items = EVERYDAY_PURCHASES) {
                 : 'It trails the listed cards everywhere, so use it on everyday spending only as needed to reach the bonus.'}`,
         ];
     });
+    // Picks and activations in plain words, as the to-do list says them; the
+    // setup notes name ids for an agent to set.
+    const todo = checklist(catalog, wallet, date).filter((i) => i.kind === 'pick' || i.kind === 'activate');
     const notes = [
         ...new Set([
             ...bonuses,
-            ...wallet.cards.flatMap((held) => setupNotes(catalog, wallet, held, date).map((n) => n.text)),
+            ...todo.map((i) => i.text),
+            ...wallet.cards.flatMap((held) => setupNotes(catalog, wallet, held, date)
+                .filter((n) => n.kind !== 'pick' && n.kind !== 'activation')
+                .map((n) => n.kind === 'membership'
+                ? n.text.replace(/ \([a-z0-9-]+\)/g, '')
+                : n.text)),
         ]),
     ];
     const [year, q] = (periodKey('quarter', date, null) ?? '').split('-');

package/dist/engine/checklist.js

@@ -0,0 +1,152 @@
+import { daysBetween, periodEnd, periodKey } from "./periods.js";
+import { CAP_PERIODS, choiceName, listed, money, shortDate, wholeDollars, } from "./text.js";
+import { optionName } from "./rule-text.js";
+import { activationsDue, walletSummary, } from "./wallet-summary.js";
+// What the wallet's cards need this period, soonest first: bonuses to
+// activate, categories to pick, caps running low, welcome bonuses to finish,
+// and rotating categories the issuer hasn't posted yet.
+export function checklist(catalog, wallet, today, summary = walletSummary(catalog, wallet, today), 
+// A shorter card name than the issuer's full one, where the caller has it.
+shortName) {
+    const items = [];
+    for (const held of wallet.cards) {
+        const card = catalog.cards.find((c) => c.id === held.id);
+        const s = summary.cards.find((c) => c.cardId === held.id);
+        if (!card || !s)
+            continue;
+        const name = s.checkoutLabel ?? shortName?.(card.id) ?? s.cardName;
+        for (const a of activationsDue(catalog, card, held, today)) {
+            const starts = a.from !== null && a.from > today
+                ? `, starting ${shortDate(a.from)}`
+                : '';
+            items.push({
+                kind: 'activate',
+                cardId: card.id,
+                text: `Activate ${name}'s bonus on ${a.what}${starts}${a.activateBy === null ? '' : `, by ${shortDate(a.activateBy)}`}.`,
+                due: a.activateBy ?? (a.from !== null && a.from > today ? a.from : a.to),
+            });
+        }
+        const picked = (id) => s.chosen?.picks[id] !== undefined;
+        const current = s.chosen?.current === true;
+        const unpicked = card.choices.filter((c) => !c.default &&
+            !(current && picked(c.id)) &&
+            c.period !== 'until_changed');
+        const [first] = unpicked;
+        if (first) {
+            const period = first.period === 'until_changed'
+                ? null
+                : periodKey(first.period, today, null);
+            items.push({
+                kind: 'pick',
+                cardId: card.id,
+                text: `Pick ${name}'s ${listed(unpicked.map((c) => choiceName(c.id)))} categories for this ${first.period.replace('_', ' ')}; until then they earn the base rate.`,
+                due: period === null ? null : periodEnd(period),
+            });
+        }
+        else {
+            // Picks made for this period: near its end, a reminder to make the
+            // next period's (Cash+ asks each quarter).
+            const ending = card.choices.find((c) => c.period !== 'until_changed' && !c.default && current);
+            const period = ending === undefined || ending.period === 'until_changed'
+                ? null
+                : periodKey(ending.period, today, null);
+            const end = period === null ? null : periodEnd(period);
+            if (ending && end !== null && daysBetween(today, end) <= 14)
+                items.push({
+                    kind: 'pick',
+                    cardId: card.id,
+                    text: `Pick ${name}'s categories for next ${ending.period.replace('_', ' ')}; this one ends ${shortDate(end)}.`,
+                    due: end,
+                });
+        }
+        // A pick earnrate assumes because none was saved: worth confirming.
+        const assumed = card.choices.filter((c) => c.default && !picked(c.id));
+        if (assumed.length > 0)
+            items.push({
+                kind: 'pick',
+                cardId: card.id,
+                text: `${name}'s ${listed(assumed.map((c) => choiceName(c.id)))} pick is assumed to be ${listed(assumed.flatMap((c) => (c.default ?? []).map((o) => optionName(catalog, card, c.id, o))))}; set it if you picked something else.`,
+                due: null,
+            });
+        for (const cap of s.caps) {
+            // Only caps nearly used up: the rest aren't something to do.
+            if (cap.remaining === null || cap.remaining > cap.amount * 0.25)
+                continue;
+            const resets = cap.currentPeriod === null ? null : periodEnd(cap.currentPeriod);
+            items.push({
+                kind: 'cap',
+                cardId: card.id,
+                text: cap.remaining === 0
+                    ? `${name}'s ${cap.label} cap is used up${resets === null ? '' : ` until ${shortDate(resets)}`}; another card may earn more there.`
+                    : `${name}: ${money(cap.remaining)} left of ${money(cap.amount)} ${CAP_PERIODS[cap.period]} at the bonus rate on ${cap.label}.`,
+                due: resets,
+            });
+        }
+        const b = s.bonus;
+        if (b?.state === 'open' && b.remaining !== null && b.deadline !== null) {
+            const weeks = Math.max(1, (b.daysLeft ?? 7) / 7);
+            items.push({
+                kind: 'bonus',
+                cardId: card.id,
+                text: `${name}'s welcome bonus: ${money(b.remaining)} to go by ${shortDate(b.deadline)}, about ${wholeDollars(b.remaining / weeks)} a week.`,
+                due: b.deadline,
+            });
+        }
+        if (s.rotationGap !== null) {
+            items.push({
+                kind: 'rotation',
+                cardId: card.id,
+                text: `${name}'s ${s.rotationGap} categories aren't out yet; earnrate adds them once the issuer posts them.`,
+                due: null,
+            });
+        }
+    }
+    return items.sort((a, b) => (a.due ?? '9999').localeCompare(b.due ?? '9999') ||
+        a.cardId.localeCompare(b.cardId));
+}
+// An all-day calendar event for each dated action (activations, picks,
+// welcome-bonus deadlines), with a reminder two days before. Built on the
+// device: nothing is sent anywhere.
+export function checklistCalendar(items, stamp) {
+    const escape = (t) => t.replace(/\\/g, '\\\\').replace(/[,;]/g, (c) => `\\${c}`);
+    const fold = (line) => {
+        const parts = [];
+        for (let i = 0; i < line.length; i += 73)
+            parts.push(line.slice(i, i + 73));
+        return parts.join('\r\n ');
+    };
+    const day = (d) => d.replace(/-/g, '');
+    const next = (d) => {
+        const t = new Date(`${d}T00:00:00Z`);
+        t.setUTCDate(t.getUTCDate() + 1);
+        return t.toISOString().slice(0, 10);
+    };
+    const events = items
+        .filter((i) => i.due !== null && i.kind !== 'cap' && i.kind !== 'rotation')
+        .flatMap((i) => {
+        const due = i.due ?? '';
+        return [
+            'BEGIN:VEVENT',
+            `UID:${i.kind}-${i.cardId}-${due}@earnrate.dev`,
+            `DTSTAMP:${stamp}`,
+            `DTSTART;VALUE=DATE:${day(due)}`,
+            `DTEND;VALUE=DATE:${day(next(due))}`,
+            fold(`SUMMARY:${escape(i.text)}`),
+            'BEGIN:VALARM',
+            'TRIGGER:-P2D',
+            'ACTION:DISPLAY',
+            fold(`DESCRIPTION:${escape(i.text)}`),
+            'END:VALARM',
+            'END:VEVENT',
+        ];
+    });
+    return [
+        'BEGIN:VCALENDAR',
+        'VERSION:2.0',
+        'PRODID:-//earnrate//checklist//EN',
+        'CALSCALE:GREGORIAN',
+        ...events,
+        'END:VCALENDAR',
+        '',
+    ].join('\r\n');
+}

package/dist/engine/evaluate.js

@@ -147,14 +147,14 @@ function capState(rule, card, held, date) {
     const { period, spent } = capUsed(cap, key, held, date);
     return { key, cap, period, remaining: Math.max(0, cap.amount - spent) };
 }
-function rateAfterCap(rate, cap, amount) {
+function rateAfterCap(rate, cap, afterCap, amount) {
     if (!cap)
         return rate;
     if (amount !== null && amount > 0) {
         const inCap = Math.min(amount, cap.remaining);
-        return (inCap * rate + (amount - inCap) * cap.cap.then_rate) / amount;
+        return (inCap * rate + (amount - inCap) * afterCap) / amount;
     }
-    return cap.remaining > 0 ? rate : cap.cap.then_rate;
+    return cap.remaining > 0 ? rate : afterCap;
 }
 // On equal rates an uncapped rule wins, so spend that can earn the same
 // without a cap doesn't use one up. Otherwise the earlier rule stays.
@@ -170,24 +170,31 @@ export function evaluateCard(card, held, ctx) {
         nominalRate: card.base_rate,
         rate: card.base_rate,
         cap: null,
+        afterCap: null,
     };
     let best = base;
     let nominal = base;
     const blocked = [];
+    const applying = [];
     for (const rule of card.rules) {
         const status = applicability(card, rule, ctx, held, picked);
         if (status === 'no')
             continue;
-        if (status === 'needs-activation') {
+        if (status === 'needs-activation')
             blocked.push(rule);
-            continue;
-        }
+        else
+            applying.push(rule);
+    }
+    const uncapped = Math.max(card.base_rate, ...applying.filter((r) => r.cap === undefined).map((r) => r.rate));
+    for (const rule of applying) {
         const cap = capState(rule, card, held, ctx.date);
+        const afterCap = cap ? Math.max(cap.cap.then_rate, uncapped) : null;
         const earning = {
             rule,
             nominalRate: rule.rate,
-            rate: rateAfterCap(rule.rate, cap, ctx.amount),
+            rate: rateAfterCap(rule.rate, cap, afterCap ?? rule.rate, ctx.amount),
             cap,
+            afterCap,
         };
         if (beats(earning, earning.rate, best, best.rate))
             best = earning;

package/dist/engine/explore.js

@@ -5,7 +5,7 @@ import { choicePeriod, periodKey } from "./periods.js";
 import { recommend } from "./recommend.js";
 import { rotationGap } from "./rotation.js";
 import { membershipsUsed } from "./setup.js";
-import { optionName } from "./wallet-summary.js";
+import { optionName } from "./rule-text.js";
 import { CAP_PERIODS, categoryPhrase, choiceName, codesAs, earnText, listed, money, PICK_PERIODS, pointValuesText, } from "./text.js";
 import { cardValuation } from "./valuation.js";
 import { EPSILON } from "./compare.js";
@@ -99,7 +99,7 @@ function requirementsFor(catalog, card, held, wallet, merchant, purchase) {
             ? {
                 amount: cap.amount,
                 period: cap.period,
-                thenRate: cap.then_rate,
+                thenRate: best.afterCap ?? cap.then_rate,
                 currency: cardValuation(catalog, wallet, card).currency,
             }
             : null,

package/dist/engine/recommend.js

@@ -1,7 +1,9 @@
 import { findMerchant, resolveMerchant, resolveMerchantById, } from "../merchants/resolve.js";
 import { bonusStatus } from "./bonus.js";
 import { evaluateCard, purchaseContext, usableAt, } from "./evaluate.js";
+import { membershipName } from "./memberships.js";
 import { daysBetween } from "./periods.js";
+import { ruleWhat } from "./rule-text.js";
 import { rotationGap } from "./rotation.js";
 import { EPSILON, isClose } from "./compare.js";
 import { CAP_ADJECTIVES, categoryPhrase, codesAs, currencyLabel, currencyName, earnText, money, NETWORK_NAMES, num, pct, pointValuesText, roundCents, shortDate, wholeDollars, } from "./text.js";
@@ -84,7 +86,7 @@ function reasoningFor(catalog, wallet, entry, amount) {
     const currency = valuation.currency;
     if (best.rule) {
         const note = best.rule.note ? ` ${best.rule.note}` : '';
-        lines.push(`${earnText(catalog, best.nominalRate, currency)} from its "${best.rule.id}" rule.${note}`);
+        lines.push(`${earnText(catalog, best.nominalRate, currency)} on ${ruleWhat(catalog, best.rule)}${best.rule.requires?.membership === undefined ? '' : `, with ${membershipName(catalog, best.rule.requires.membership)}`}.${note}`);
     }
     else {
         lines.push(`${earnText(catalog, card.base_rate, currency)}, its base rate. No bonus category applies here.`);
@@ -92,7 +94,7 @@ function reasoningFor(catalog, wallet, entry, amount) {
     const cap = best.cap;
     if (cap && amount !== null && amount > cap.remaining) {
         const over = amount - cap.remaining;
-        lines.push(`${money(cap.remaining)} earns ${earnText(catalog, best.nominalRate, currency)} before the cap, then ${money(over)} earns ${earnText(catalog, cap.cap.then_rate, currency)}: ${num(best.rate)} per dollar overall.`);
+        lines.push(`${money(cap.remaining)} earns ${earnText(catalog, best.nominalRate, currency)} before the cap, then ${money(over)} earns ${earnText(catalog, best.afterCap ?? cap.cap.then_rate, currency)}: ${num(best.rate)} per dollar overall.`);
     }
     if (valuation.pooledFrom !== null) {
         const partners = card.pools_into?.when_wallet_has ?? [];
@@ -121,17 +123,17 @@ function warningsFor(catalog, entry, purchase) {
             warnings.push(`Add this card's anniversary (MM-DD) to your wallet so its ${capLabel(best)} can be tracked.`);
         }
         else if (purchase.amount !== null && purchase.amount > remaining) {
-            warnings.push(`This purchase crosses the ${capLabel(best)} on "${best.rule.id}": only ${money(remaining)} is left for ${period}.`);
+            warnings.push(`This purchase crosses the ${capLabel(best)} on ${ruleWhat(catalog, best.rule)}: only ${money(remaining)} is left for ${period}.`);
         }
         else if (remaining < cap.amount * NEAR_CAP_SHARE) {
-            warnings.push(`Only ${money(remaining)} left of the ${capLabel(best)} on "${best.rule.id}" for ${period}.`);
+            warnings.push(`Only ${money(remaining)} left of the ${capLabel(best)} on ${ruleWhat(catalog, best.rule)} for ${period}.`);
         }
     }
     if (nominal.rule &&
         nominal.cap &&
         nominal !== best &&
         nominal.cap.remaining === 0) {
-        warnings.push(`The ${capLabel(nominal)} on "${nominal.rule.id}" is used up for ${nominal.cap.period ?? 'this period'}, so it earns ${earnText(catalog, nominal.cap.cap.then_rate, valuation.currency)} until it resets.`);
+        warnings.push(`The ${capLabel(nominal)} on ${ruleWhat(catalog, nominal.rule)} is used up for ${nominal.cap.period ?? 'this period'}, so it earns ${earnText(catalog, nominal.afterCap ?? nominal.cap.cap.then_rate, valuation.currency)} until it resets.`);
     }
     if (best.rule?.unverified !== undefined) {
         warnings.push(`This rate isn't confirmed against the issuer's terms yet: ${best.rule.unverified}`);

package/dist/engine/rule-text.js

@@ -0,0 +1,47 @@
+import { findMerchant } from "../merchants/resolve.js";
+import { categoryPhrase, choiceName, listed, words } from "./text.js";
+// What a rule or a pick covers, in words, for answers and wallet lists.
+// Travel-site bookings ("Flight through Amex Travel") read mid-sentence in
+// lower case and plural; brand names ("Airbnb through Amex Travel") keep theirs.
+const BOOKING = /^(Attraction|Car rental|Cruise|Flight|Hotel|Vacation rental)\b/;
+function merchantName(catalog, id) {
+    const merchant = findMerchant(catalog, id);
+    const name = merchant?.name ?? words(id);
+    return merchant?.kind === 'booking'
+        ? name.replace(BOOKING, (kind) => `${kind.toLowerCase()}s`)
+        : name;
+}
+export function optionName(catalog, card, choiceId, option) {
+    const o = card.choices.find((c) => c.id === choiceId)?.options[option];
+    if (!o)
+        return words(option);
+    const parts = [
+        ...o.categories.map((c) => categoryPhrase(catalog, c)),
+        ...o.merchants.map((m) => merchantName(catalog, m)),
+    ];
+    if (o.online)
+        parts.push('online shopping');
+    return parts.length > 0 ? listed(parts) : words(option);
+}
+// What a rule covers, as a list of phrases.
+export function ruleParts(catalog, rule) {
+    if (rule.match.any)
+        return ['everything else'];
+    if (rule.match.choice !== undefined)
+        return [`your ${choiceName(rule.match.choice)} picks`];
+    const merchants = rule.match.merchants ?? [];
+    // A long list of one kind of store reads as "select streaming services".
+    const kinds = new Set(merchants.map((m) => findMerchant(catalog, m)?.category));
+    const [kind] = kinds;
+    const merchantParts = merchants.length > 4 && kinds.size === 1 && kind !== undefined
+        ? [`select ${categoryPhrase(catalog, kind)}`]
+        : merchants.map((m) => merchantName(catalog, m));
+    const parts = [
+        ...(rule.match.categories ?? []).map((c) => categoryPhrase(catalog, c)),
+        ...merchantParts,
+    ];
+    return parts.length > 0 ? parts : [words(rule.id)];
+}
+export function ruleWhat(catalog, rule) {
+    return listed(ruleParts(catalog, rule));
+}

package/dist/engine/wallet-summary.js

@@ -1,66 +1,19 @@
-import { findMerchant } from "../merchants/resolve.js";
 import { bonusStatus } from "./bonus.js";
 import { activationGroup, capUsed, isActivated, pickedCategories, } from "./evaluate.js";
 import { membershipName } from "./memberships.js";
+import { optionName, ruleParts, ruleWhat } from "./rule-text.js";
 import { daysBetween, inEffect, periodEnd } from "./periods.js";
 import { STALE_AFTER_DAYS } from "./recommend.js";
 import { rotationGap } from "./rotation.js";
 import { activationRules } from "./setup.js";
-import { CAP_PERIODS, categoryPhrase, choiceName, currencyLabel, earnText, listed, shortDate, wholeDollars, words, } from "./text.js";
+import { CAP_PERIODS, choiceName, currencyLabel, earnText, listed, shortDate, wholeDollars, words, } from "./text.js";
 import { cardValuation, currencyValuation } from "./valuation.js";
-// Travel-site bookings ("Flight through Amex Travel") read mid-sentence in
-// lower case and plural; brand names ("Airbnb through Amex Travel") keep theirs.
-const BOOKING = /^(Attraction|Car rental|Cruise|Flight|Hotel|Vacation rental)\b/;
-function merchantName(catalog, id) {
-    const merchant = findMerchant(catalog, id);
-    const name = merchant?.name ?? words(id);
-    return merchant?.kind === 'booking'
-        ? name.replace(BOOKING, (kind) => `${kind.toLowerCase()}s`)
-        : name;
-}
-export function optionName(catalog, card, choiceId, option) {
-    const o = card.choices.find((c) => c.id === choiceId)?.options[option];
-    if (!o)
-        return words(option);
-    const parts = [
-        ...o.categories.map((c) => categoryPhrase(catalog, c)),
-        ...o.merchants.map((m) => merchantName(catalog, m)),
-    ];
-    if (o.online)
-        parts.push('online shopping');
-    return parts.length > 0 ? listed(parts) : words(option);
-}
-// What a rule covers, as a list of phrases.
-function ruleParts(catalog, rule) {
-    if (rule.match.choice !== undefined)
-        return [`your ${choiceName(rule.match.choice)} picks`];
-    const merchants = rule.match.merchants ?? [];
-    // A long list of one kind of store reads as "select streaming services".
-    const kinds = new Set(merchants.map((m) => findMerchant(catalog, m)?.category));
-    const [kind] = kinds;
-    const merchantParts = merchants.length > 4 && kinds.size === 1 && kind !== undefined
-        ? [`select ${categoryPhrase(catalog, kind)}`]
-        : merchants.map((m) => merchantName(catalog, m));
-    const parts = [
-        ...(rule.match.categories ?? []).map((c) => categoryPhrase(catalog, c)),
-        ...merchantParts,
-    ];
-    return parts.length > 0 ? parts : [words(rule.id)];
-}
-function ruleWhat(catalog, rule) {
-    return listed(ruleParts(catalog, rule));
-}
 const matchKeys = (rule) => rule.match.choice !== undefined
     ? []
     : [
         ...(rule.match.categories ?? []).map((c) => `category:${c}`),
         ...(rule.match.merchants ?? []).map((m) => `merchant:${m}`),
     ];
-// Every bonus rate the cardholder gets now, best first, so none reads as the
-// base rate. Rates behind a membership the wallet lacks are left out, and so
-// is a lower tier that an uncapped, always-on higher rate fully covers (Prime
-// Visa's 3% without Prime, once Prime is held). Rules at the same rate share
-// a line.
 // "first $1,500 a quarter, combined": how much of a rate's spending earns it.
 function capLimit(card, shown, rule) {
     if (rule.cap === undefined)
@@ -74,6 +27,11 @@ function capLimit(card, shown, rule) {
         shown.filter((r) => r.cap === rule.cap).length > 1;
     return `first ${wholeDollars(cap.amount)} ${CAP_PERIODS[cap.period]}${shared ? ', combined' : ''}`;
 }
+// Every bonus rate the cardholder gets now, best first, so none reads as the
+// base rate. Rates behind a membership the wallet lacks are left out, and so
+// is a lower tier that an uncapped, always-on higher rate fully covers (Prime
+// Visa's 3% without Prime, once Prime is held). Rules at the same rate share
+// a line.
 function headlineRates(catalog, wallet, card, held, currency, today) {
     const shown = card.rules
         .filter((r) => inEffect(r, today) &&
@@ -91,6 +49,16 @@ function headlineRates(catalog, wallet, card, held, currency, today) {
             .flatMap(matchKeys);
         if (keys.length > 0 && keys.every((k) => higher.includes(k)))
             continue;
+        // A membership tier's higher rate on the same purchases replaces the
+        // card's own (BofA Rewards tiers), cap or not.
+        const replaced = shown.some((h) => h !== r &&
+            h.rate > r.rate &&
+            h.requires?.membership !== undefined &&
+            r.requires?.membership === undefined &&
+            JSON.stringify(h.match) === JSON.stringify(r.match) &&
+            JSON.stringify(h.exclude) === JSON.stringify(r.exclude));
+        if (replaced)
+            continue;
         const pending = r.requires?.activation && !isActivated(card, held, r.id);
         const key = [
             `${earnText(catalog, r.rate, currency)} on`,
@@ -109,10 +77,14 @@ function headlineRates(catalog, wallet, card, held, currency, today) {
             const after = `${limit}${activate}`;
             return `${head} ${listed(whats)}${after === '' ? '' : ` (${after.replace(/^, /, '')})`}`;
         }),
-        `${earnText(catalog, card.base_rate, currency)} on everything else`,
+        ...(shown.some((r) => r.match.any && r.rate > card.base_rate)
+            ? []
+            : [`${earnText(catalog, card.base_rate, currency)} on everything else`]),
     ];
 }
-function toActivate(catalog, card, held, today) {
+// Bonuses current or starting soon that the card hasn't activated, one per
+// activation group (one activation covers a quarter's categories).
+export function activationsDue(catalog, card, held, today) {
     const seen = new Set();
     const out = [];
     for (const id of activationRules(card, today)) {
@@ -123,18 +95,25 @@ function toActivate(catalog, card, held, today) {
             seen.add(g);
         const rules = card.rules.filter((r) => group.includes(r.id));
         const first = rules[0];
-        const deadline = first?.activate_by === undefined
-            ? ''
-            : `, activate by ${shortDate(first.activate_by)}`;
-        const when = first?.valid_from !== undefined && first.valid_to !== undefined
-            ? ` (${shortDate(first.valid_from)} to ${shortDate(first.valid_to)}${deadline})`
-            : deadline === ''
-                ? ''
-                : ` (${deadline.slice(2)})`;
-        out.push(`${rules.map((r) => ruleWhat(catalog, r)).join(', ')}${when}`);
+        out.push({
+            what: rules.map((r) => ruleWhat(catalog, r)).join(', '),
+            from: first?.valid_from ?? null,
+            to: first?.valid_to ?? null,
+            activateBy: first?.activate_by ?? null,
+        });
     }
     return out;
 }
+function toActivate(catalog, card, held, today) {
+    return activationsDue(catalog, card, held, today).map((a) => {
+        const deadline = a.activateBy === null ? '' : `activate by ${shortDate(a.activateBy)}`;
+        const dates = a.from !== null && a.to !== null
+            ? `${shortDate(a.from)} to ${shortDate(a.to)}`
+            : '';
+        const when = [dates, deadline].filter((x) => x !== '').join(', ');
+        return `${a.what}${when === '' ? '' : ` (${when})`}`;
+    });
+}
 function capSummaries(catalog, card, held, today) {
     const caps = new Map();
     for (const shared of card.caps)

package/dist/format/wallet.js

@@ -1,4 +1,10 @@
 import { money, NETWORK_NAMES, shortDate } from "../engine/text.js";
+// "To do now", above the card details; nothing when all's done.
+export function formatChecklist(items) {
+    return items.length === 0
+        ? ''
+        : `To do now:\n${items.map((i) => `- ${i.text}`).join('\n')}\n\n`;
+}
 export function formatWalletSummary(summary) {
     const cards = summary.cards.map((c) => {
         const label = c.checkoutLabel

package/dist/mcp/context.js

@@ -61,10 +61,14 @@ export function makeContext(deps) {
     // neither ever overrides a merchant earnrate already knows.
     async function resolve(merchant, channel, category) {
         const known = resolvePlace(catalog, merchant, channel);
-        if (known.source !== 'none' || category !== null || !deps.llm) {
-            return { merchant: withCallerCategory(known, category), notices: [] };
-        }
-        return deps.llm.resolve(catalog, merchant, channel);
+        const resolved = known.source !== 'none' || category !== null || !deps.llm
+            ? { merchant: withCallerCategory(known, category), notices: [] }
+            : await deps.llm.resolve(catalog, merchant, channel);
+        const source = resolved.merchant.source;
+        if (deps.missed &&
+            (source === 'none' || source === 'caller' || source === 'llm'))
+            await deps.missed.note(merchant, source === 'none' ? null : resolved.merchant.category, deps.today());
+        return resolved;
     }
     // Cards named in the conversation come first, then the saved wallet; with
     // neither (null), answers cover every card earnrate knows.

package/dist/mcp/schemas.js

@@ -86,6 +86,14 @@ export const WalletSummarySchema = z.object({
         redemption: z.string().nullable(),
     })),
     started: z.string().nullable(),
+    checklist: z
+        .array(z.object({
+        kind: z.enum(['activate', 'pick', 'cap', 'bonus', 'rotation']),
+        cardId: z.string(),
+        text: z.string(),
+        due: z.string().nullable(),
+    }))
+        .optional(),
     cards: z.array(z.object({
         cardId: z.string(),
         cardName: z.string(),

package/dist/mcp/serve.js

@@ -3,12 +3,15 @@ import { FileWalletStore } from "../data/file-store.js";
 import { loadCatalog, walletPath } from "../data/load.js";
 import { localToday as today } from "../engine/periods.js";
 import { llmEnabled, openLlmSession } from "../merchants/from-env.js";
+import { missedPath, missLogAt } from "../merchants/missed.js";
 import { packageVersion } from "../version.js";
 import { createEarnrateServer } from "./server.js";
 // stdout carries the protocol, so diagnostics go to stderr only.
 export async function serveMcp(env) {
     const version = await packageVersion();
     const catalog = await loadCatalog();
+    const missedFile = missedPath(env);
+    const missed = missedFile === null ? null : missLogAt(missedFile);
     let llm = null;
     if (llmEnabled(env)) {
         const opened = await openLlmSession({ env, today });
@@ -26,6 +29,7 @@ export async function serveMcp(env) {
         savedWallets: 'file',
         today,
         llm,
+        missed,
         version,
     }));
 }

package/dist/mcp/server.js

@@ -39,7 +39,7 @@ const WHICH_WALLET = {
 };
 const instructions = (savedWallets) => `earnrate answers which credit card earns the most for a purchase, from each issuer's own terms. Anyone can use it without entering anything: with no cards given, best_card_for_purchase, best_cards_for, cheat_sheet, simulate_spending and compare_welcome_offers answer from every card earnrate knows, and that's a complete answer. Never require the user's cards, and don't ask what they spend unless the answer depends on it; simulate_spending assumes typical amounts when none are given and says so.
 
-Personalizing is optional. If the user names their cards, pass them as \`cards\` (ids from search_cards) for that answer; nothing is saved. After answering, offer once to save those cards so earnrate remembers them, and save them with add_card only if the user says yes. ${SAVING[savedWallets]} When a card needs category picks, memberships like Amazon Prime, or activations, ask the user rather than guessing.
+Personalizing is optional. If the user names their cards, pass them as \`cards\` (ids from search_cards) for that answer; nothing is saved. After answering, offer once to save those cards so earnrate remembers them, and save them with add_card only if the user says yes. ${SAVING[savedWallets]} When a card needs category picks, memberships like Amazon Prime, or activations, ask the user rather than guessing. When the user asks what to do with their cards (this quarter, or what they're forgetting), call list_wallet: it starts with a to-do list.
 
 The wallet lists cards by product id, never card numbers; never ask for card numbers, expiry dates or security codes.
 

package/dist/mcp/tools/wallet.js

@@ -3,8 +3,11 @@ import { membershipsFor, needsAnniversary } from "../../engine/setup.js";
 import { choiceName, currencyLabel, listed, money, shortDate, words, } from "../../engine/text.js";
 import { membershipName } from "../../engine/memberships.js";
 import { profileText, VALUATION_PROFILES } from "../../engine/profiles.js";
-import { optionName, walletSummary } from "../../engine/wallet-summary.js";
-import { formatBooking, formatWalletSummary } from "../../format/wallet.js";
+import { optionName } from "../../engine/rule-text.js";
+import { walletSummary } from "../../engine/wallet-summary.js";
+import { checklist } from "../../engine/checklist.js";
+import { cardText } from "../../format/card-text.js";
+import { formatBooking, formatChecklist, formatWalletSummary, } from "../../format/wallet.js";
 import { fail } from "../context.js";
 import { CardChange, CardId, cardInput, ChannelInput, DateInput, Merchant, } from "../inputs.js";
 import { RecordResultSchema, WalletChangeSchema, WalletSummarySchema, } from "../schemas.js";
@@ -52,7 +55,7 @@ export function registerWalletTools(server, deps, ctx, inputs) {
     const { catalog, store } = deps;
     server.registerTool('list_wallet', {
         title: 'List wallet',
-        description: `Lists the user's cards: checkout label, network, rewards currency and its value, spending caps with how much is left this period, chosen bonus categories (and whether they're current), welcome-bonus progress, which stores a store card works at, when each card's data was last verified, the point values the user saved, and (for the hosted wallet) when it was started. ${ctx.walletUse}`,
+        description: `Starts with a to-do list for the user's cards right now (bonuses to activate and their deadlines, categories to pick or confirm, caps nearly used up, welcome bonuses to finish and the weekly pace); use it when the user asks what to do with their cards this quarter or what they're forgetting. Then lists the user's cards: checkout label, network, rewards currency and its value, spending caps with how much is left this period, chosen bonus categories (and whether they're current), welcome-bonus progress, which stores a store card works at, when each card's data was last verified, the point values the user saved, and (for the hosted wallet) when it was started. ${ctx.walletUse}`,
         outputSchema: WalletSummarySchema,
         annotations: {
             title: 'List wallet',
@@ -64,9 +67,11 @@ export function registerWalletTools(server, deps, ctx, inputs) {
         if (typeof read === 'string')
             return fail(read);
         const started = deps.savedWallets === 'account' ? await deps.store.started() : null;
+        const base = walletSummary(catalog, read.wallet, deps.today());
         const summary = {
-            ...walletSummary(catalog, read.wallet, deps.today()),
+            ...base,
             started,
+            checklist: checklist(catalog, read.wallet, deps.today(), base, cardText(catalog).shortName),
         };
         const when = started === null
             ? `This is ${ctx.walletName}.\n`
@@ -75,7 +80,7 @@ export function registerWalletTools(server, deps, ctx, inputs) {
             content: [
                 {
                     type: 'text',
-                    text: `${when}${read.start === null ? '' : `${read.start}\n`}${formatWalletSummary(summary)}`,
+                    text: `${when}${read.start === null ? '' : `${read.start}\n`}${formatChecklist(summary.checklist)}${formatWalletSummary(summary)}`,
                 },
             ],
             structuredContent: summary,

package/dist/merchants/missed.js

@@ -0,0 +1,78 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { z } from 'zod';
+import { CONFIG_DIR, MISSED_ENV_VAR } from "../brand.js";
+import { normalizeMerchantName } from "./resolve.js";
+const MissedFileSchema = z.object({
+    version: z.literal(1),
+    merchants: z.record(z.string(), z.object({
+        name: z.string(),
+        count: z.number().int().positive(),
+        last_seen: z.string(),
+        categories: z.array(z.string()).default([]),
+    })),
+});
+const MAX = 500;
+// $EARNRATE_MISSED_MERCHANTS names another file, or "off" keeps no log.
+export function missedPath(env = process.env) {
+    const given = env[MISSED_ENV_VAR]?.trim();
+    if (given === 'off')
+        return null;
+    return given || path.join(homedir(), CONFIG_DIR, 'missed-merchants.json');
+}
+export async function readMissed(file) {
+    try {
+        const parsed = MissedFileSchema.safeParse(JSON.parse(await readFile(file, 'utf8')));
+        return parsed.success ? Object.values(parsed.data.merchants) : [];
+    }
+    catch {
+        return [];
+    }
+}
+// Writes are queued, so concurrent tool calls never lose a count. A file that
+// can't be read as a log is left alone.
+export function missLogAt(file) {
+    let queue = Promise.resolve();
+    return {
+        note(name, category, today) {
+            const key = normalizeMerchantName(name);
+            if (key === '')
+                return Promise.resolve();
+            const run = queue.then(async () => {
+                let merchants = {};
+                try {
+                    const parsed = MissedFileSchema.safeParse(JSON.parse(await readFile(file, 'utf8')));
+                    if (!parsed.success)
+                        return;
+                    merchants = parsed.data.merchants;
+                }
+                catch (e) {
+                    if (!(e instanceof Error && 'code' in e && e.code === 'ENOENT'))
+                        return;
+                }
+                const seen = merchants[key];
+                merchants[key] = {
+                    name: name.trim(),
+                    count: (seen?.count ?? 0) + 1,
+                    last_seen: today,
+                    categories: [
+                        ...new Set([
+                            ...(seen?.categories ?? []),
+                            ...(category === null ? [] : [category]),
+                        ]),
+                    ],
+                };
+                const kept = Object.entries(merchants)
+                    .sort(([, a], [, b]) => b.last_seen.localeCompare(a.last_seen))
+                    .slice(0, MAX);
+                await mkdir(path.dirname(file), { recursive: true });
+                const tmp = `${file}.${String(process.pid)}.tmp`;
+                await writeFile(tmp, `${JSON.stringify({ version: 1, merchants: Object.fromEntries(kept) }, null, 2)}\n`);
+                await rename(tmp, file);
+            });
+            queue = run.catch(() => undefined);
+            return run.catch(() => undefined);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "earnrate",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Which credit card earns the most at a merchant, from your cards or every card, and why",
   "keywords": [
     "credit cards",