Card Identity
Purpose
Centralized card-name resolution used by all commands in the card suite. Every user-facing command should call this logic as step 1 before doing any research.
Resolution Steps
- Normalize input — strip extra whitespace, fix common abbreviations (e.g., "CSP" → "Chase Sapphire Preferred", "Amex" → "American Express").
- Parse components — extract issuer, card family, and card variant separately when possible.
- Check issuer scope — verify the issuer is in the approved list from ../card-shared/source-policy.yaml. If not, return a short failure: "This card is not from a supported issuer."
- Resolve variant — if the input maps to exactly one variant, proceed with confident match. If multiple variants are plausible, follow the ambiguity rules below.
Business vs Personal
- Both personal and business credit cards are supported.
- If the user specifies "business" or "biz", resolve to the business variant.
- If a card name exists in both personal and business versions and the user doesn't specify, treat it as ambiguous — return a numbered choice list with both variants.
- Common business indicators: "business", "biz", "Business Platinum", "Ink", "Spark", etc.
Ambiguity Handling
- If the input maps to 2+ plausible variants (e.g., "Chase Sapphire" → Preferred or Reserve, or "Amex Gold" → personal or business):
- Return a numbered choice list and stop. Do not guess.
- Format: one card per line with issuer, family, variant.
- If no plausible match exists:
- Return a short failure: "Could not match a card. Try including the full card name with issuer."
Confident Match Output
When the match is confident, the calling command should:
- Omit the
## Card Identity section from user-facing output.
- Populate the card identity YAML keys (
card_name, issuer, network, card_family, card_variant) in the internal YAML block.
Weak / Unconfirmed Match Output
When the match is the best-supported variant but not certain:
- Show the
## ⚠️ Card Identity section in user-facing output with the matched variant and a note about competing matches.
- Set
status: unconfirmed on the relevant summary field.
- List competing variants in
confidence_notes.
Common Abbreviations
Only shorthands and ambiguous names need entries here. Cards with full, unambiguous names (e.g., "Chase Marriott Bonvoy Boundless", "Chase United Explorer", "American Express Hilton Honors Aspire") are resolved via search — no table entry needed.
| Input |
Resolved |
| CSP |
Chase Sapphire Preferred |
| CSR |
Chase Sapphire Reserve |
| CFU |
Chase Freedom Unlimited |
| CFF |
Chase Freedom Flex |
| CIP |
Chase Ink Business Preferred |
| CIC |
Chase Ink Business Cash |
| CIU |
Chase Ink Business Unlimited |
| Amex Gold |
American Express Gold Card |
| Amex Plat |
American Express Platinum Card |
| Amex Biz Gold |
American Express Business Gold Card |
| Amex Biz Plat |
American Express Business Platinum Card |
| Amex Blue Biz Plus |
American Express Blue Business Plus Card |
| Amex Blue Biz Cash |
American Express Blue Business Cash Card |
| Venture X |
Capital One Venture X Rewards Credit Card |
| Venture X Business |
Capital One Venture X Business Card |
| Savor |
Capital One SavorOne / Savor (ambiguous — ask) |
| Spark Cash Plus |
Capital One Spark Cash Plus |
| Spark Miles |
Capital One Spark Miles |
| Double Cash |
Citi Double Cash Card |
| Custom Cash |
Citi Custom Cash Card |
| Ink Preferred |
Chase Ink Business Preferred |
| Ink Cash |
Chase Ink Business Cash |
| Ink Unlimited |
Chase Ink Business Unlimited |
| Bilt |
Bilt Blue / Obsidian / Palladium (ambiguous — ask) |
| Robinhood |
Robinhood Gold Card / Cash Card (ambiguous — ask) |
| Aviator Red |
Barclays AAdvantage Aviator Red World Elite Mastercard |
| Wyndham Rewards |
Barclays Wyndham Rewards Earner Card / Plus / Business (ambiguous — ask) |
| Altitude Reserve |
U.S. Bank Altitude Reserve Visa Infinite Card |
| Altitude Connect |
U.S. Bank Altitude Connect Visa Signature Card |
| Altitude Go |
U.S. Bank Altitude Go Visa Signature Card |
| Delta Gold |
American Express Delta SkyMiles Gold Card |
| Delta Platinum |
American Express Delta SkyMiles Platinum Card |
| Delta Reserve |
American Express Delta SkyMiles Reserve Card |
| Delta Biz Gold |
American Express Delta SkyMiles Gold Business Card |
| Delta Biz Plat |
American Express Delta SkyMiles Platinum Business Card |
| Delta Biz Reserve |
American Express Delta SkyMiles Reserve Business Card |
Rules Reference
Full rules at ../card-shared/card-identity-rules.md.
1---2name: card-identity3description: Resolve a card name to an exact issuer, family, and variant. This is a hidden shared skill used internally by all card commands as their first step. Not user-facing.4---56# Card Identity78## Purpose910Centralized card-name resolution used by all commands in the card suite. Every user-facing command should call this logic as step 1 before doing any research.1112## Resolution Steps13141. **Normalize input** — strip extra whitespace, fix common abbreviations (e.g., "CSP" → "Chase Sapphire Preferred", "Amex" → "American Express").152. **Parse components** — extract issuer, card family, and card variant separately when possible.163. **Check issuer scope** — verify the issuer is in the approved list from [../card-shared/source-policy.yaml](../card-shared/source-policy.yaml). If not, return a short failure: "This card is not from a supported issuer."174. **Resolve variant** — if the input maps to exactly one variant, proceed with confident match. If multiple variants are plausible, follow the ambiguity rules below.1819## Business vs Personal2021- Both personal and business credit cards are supported.22- If the user specifies "business" or "biz", resolve to the business variant.23- If a card name exists in both personal and business versions and the user doesn't specify, treat it as **ambiguous** — return a numbered choice list with both variants.24- Common business indicators: "business", "biz", "Business Platinum", "Ink", "Spark", etc.2526## Ambiguity Handling2728- If the input maps to 2+ plausible variants (e.g., "Chase Sapphire" → Preferred or Reserve, or "Amex Gold" → personal or business):29 - Return a **numbered choice list** and stop. Do not guess.30 - Format: one card per line with issuer, family, variant.31- If no plausible match exists:32 - Return a short failure: "Could not match a card. Try including the full card name with issuer."3334## Confident Match Output3536When the match is confident, the calling command should:37- **Omit** the `## Card Identity` section from user-facing output.38- Populate the card identity YAML keys (`card_name`, `issuer`, `network`, `card_family`, `card_variant`) in the internal YAML block.3940## Weak / Unconfirmed Match Output4142When the match is the best-supported variant but not certain:43- **Show** the `## ⚠️ Card Identity` section in user-facing output with the matched variant and a note about competing matches.44- Set `status: unconfirmed` on the relevant summary field.45- List competing variants in `confidence_notes`.4647## Common Abbreviations4849Only shorthands and ambiguous names need entries here. Cards with full, unambiguous names (e.g., "Chase Marriott Bonvoy Boundless", "Chase United Explorer", "American Express Hilton Honors Aspire") are resolved via search — no table entry needed.5051| Input | Resolved |52|---|---|53| CSP | Chase Sapphire Preferred |54| CSR | Chase Sapphire Reserve |55| CFU | Chase Freedom Unlimited |56| CFF | Chase Freedom Flex |57| CIP | Chase Ink Business Preferred |58| CIC | Chase Ink Business Cash |59| CIU | Chase Ink Business Unlimited |60| Amex Gold | American Express Gold Card |61| Amex Plat | American Express Platinum Card |62| Amex Biz Gold | American Express Business Gold Card |63| Amex Biz Plat | American Express Business Platinum Card |64| Amex Blue Biz Plus | American Express Blue Business Plus Card |65| Amex Blue Biz Cash | American Express Blue Business Cash Card |66| Venture X | Capital One Venture X Rewards Credit Card |67| Venture X Business | Capital One Venture X Business Card |68| Savor | Capital One SavorOne / Savor (ambiguous — ask) |69| Spark Cash Plus | Capital One Spark Cash Plus |70| Spark Miles | Capital One Spark Miles |71| Double Cash | Citi Double Cash Card |72| Custom Cash | Citi Custom Cash Card |73| Ink Preferred | Chase Ink Business Preferred |74| Ink Cash | Chase Ink Business Cash |75| Ink Unlimited | Chase Ink Business Unlimited |76| Bilt | Bilt Blue / Obsidian / Palladium (ambiguous — ask) |77| Robinhood | Robinhood Gold Card / Cash Card (ambiguous — ask) |78| Aviator Red | Barclays AAdvantage Aviator Red World Elite Mastercard |79| Wyndham Rewards | Barclays Wyndham Rewards Earner Card / Plus / Business (ambiguous — ask) |80| Altitude Reserve | U.S. Bank Altitude Reserve Visa Infinite Card |81| Altitude Connect | U.S. Bank Altitude Connect Visa Signature Card |82| Altitude Go | U.S. Bank Altitude Go Visa Signature Card |83| Delta Gold | American Express Delta SkyMiles Gold Card |84| Delta Platinum | American Express Delta SkyMiles Platinum Card |85| Delta Reserve | American Express Delta SkyMiles Reserve Card |86| Delta Biz Gold | American Express Delta SkyMiles Gold Business Card |87| Delta Biz Plat | American Express Delta SkyMiles Platinum Business Card |88| Delta Biz Reserve | American Express Delta SkyMiles Reserve Business Card |8990## Rules Reference9192Full rules at [../card-shared/card-identity-rules.md](../card-shared/card-identity-rules.md).
jiahongc