fleece-cli 0.1.0__tar.gz

fleece_cli-0.1.0/.agents/skills/fleece/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: fleece
+description: Fleece credit card research CLI. Provides live US credit card data via Brave Search — full reports, earning rates, transfer partners, statement credits, recent news, card comparisons, portfolio analysis, ROI estimates, and profile-based recommendations. Use whenever you need current credit card information.
+---
+
+# Fleece Credit Card Research
+
+Live US credit card research backed by Brave Search. All commands output JSON for
+programmatic use. Requires `BRAVE_API_KEY` in the environment.
+
+## Prerequisites
+
+```bash
+# Set in environment or .env file
+export BRAVE_API_KEY=<your_key>
+
+# Run from the fleece project root
+cd /path/to/fleece
+```
+
+## Commands
+
+### Full card report
+```bash
+python cli.py card "<card name>" --json
+```
+Returns fees, welcome offer, earning rates, credits, benefits, and strategy.
+
+### Earning rates
+```bash
+python cli.py rates "<card name>" --json
+python cli.py rates "<card name>" --category "<dining|travel|groceries|gas>" --json
+```
+
+### Transfer partners
+```bash
+python cli.py partners "<card name>" --json
+```
+Returns airline and hotel partners with ratios and transfer timing.
+
+### Statement credits
+```bash
+python cli.py credits "<card name>" --json
+```
+Returns all credits with amounts, cadence, and enrollment requirements.
+
+### Recent news (past month)
+```bash
+python cli.py news "<card name>" --json
+```
+Freshness-filtered to the past month.
+
+### Side-by-side comparison
+```bash
+python cli.py compare "<card A>" "<card B>" --json
+python cli.py compare "<card A>" "<card B>" --aspects "fees,rewards,credits" --json
+```
+
+### Portfolio / wallet analysis
+```bash
+python cli.py wallet "<card 1>" "<card 2>" "<card 3>" --json
+```
+Returns coverage map, overlaps, gaps, and next-card suggestions.
+
+### First-year ROI
+```bash
+python cli.py roi "<card name>" --travel <monthly $> --dining <monthly $> --other <monthly $> --json
+```
+
+### Profile-based recommendations
+```bash
+python cli.py recommend "<spending profile>" --json
+python cli.py recommend "<spending profile>" --preferences "<preferences>" --json
+```
+
+## Output format
+
+Every command with `--json` returns:
+```json
+{
+  "command": "card",
+  "query": "...",
+  "result": "...",
+  "ok": true,
+  "error": null
+}
+```
+
+On error, `ok` is `false` and `error` contains the message. Always check `ok` before using `result`.
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Search / tool error (Brave API failure) |
+| `2` | `BRAVE_API_KEY` not set |
+
+## Stdin piping
+
+The primary argument on any single-card command accepts `-` to read from stdin:
+```bash
+echo "Chase Sapphire Preferred" | python cli.py card - --json
+echo "high dining spend" | python cli.py recommend - --json
+```
+
+The `wallet` command accepts `-` as its sole argument to read newline-delimited card names:
+```bash
+printf "Amex Gold\nChase Freedom Unlimited\nBilt\n" | python cli.py wallet - --json
+```
+
+## Coverage
+
+Supports all major US issuers: Amex, Bank of America, Barclays, Bilt, Capital One,
+Chase, Citi, Discover, Robinhood, U.S. Bank, Wells Fargo.

fleece_cli-0.1.0/.claude/skills/fleece-card.md

@@ -0,0 +1,38 @@
+---
+name: fleece-card
+description: Full credit card report — fees, welcome offer, earning rates, statement credits, benefits, and strategy. Use when asked about a specific card in detail.
+---
+
+# /fleece-card
+
+Fetches a comprehensive report for a US credit card using live Brave Search data.
+
+## When to use
+- User asks about a specific card's details, benefits, or annual fee
+- User wants to know if a card is worth it
+- You need current card info (training data may be stale)
+
+## Usage
+
+```bash
+python cli.py card "<card name>" --json
+```
+
+The `--json` flag returns a structured envelope your can parse:
+```json
+{ "command": "card", "query": "...", "result": "...", "ok": true, "error": null }
+```
+
+Use `result` as your research context, then synthesize a natural answer.
+
+## Exit codes
+- `0` success
+- `1` search error — tell the user and fall back to training data
+- `2` `BRAVE_API_KEY` not configured
+
+## Example
+
+```bash
+python cli.py card "Chase Sapphire Preferred" --json
+python cli.py card "Amex Gold" --json
+```

fleece_cli-0.1.0/.claude/skills/fleece-compare.md

@@ -0,0 +1,31 @@
+---
+name: fleece-compare
+description: Side-by-side comparison of two credit cards across fees, rewards, welcome offers, credits, and transfer partners. Use when asked which card is better.
+---
+
+# /fleece-compare
+
+Searches live data for both cards and returns research for a structured comparison.
+
+## When to use
+- User asks "which is better" between two specific cards
+- User is deciding between two cards and wants a comparison
+- User wants to see how two cards stack up on a specific dimension
+
+## Usage
+
+```bash
+python cli.py compare "<card A>" "<card B>" --json
+python cli.py compare "<card A>" "<card B>" --aspects "fees,rewards,credits" --json
+```
+
+Default aspects: `fees,rewards,welcome_offer,credits,transfer_partners`
+
+## Example
+
+```bash
+python cli.py compare "Amex Gold" "Chase Sapphire Preferred" --json
+python cli.py compare "Capital One Venture X" "Chase Sapphire Reserve" --json
+```
+
+After receiving the result, synthesize a clear recommendation based on the user's stated priorities.

fleece_cli-0.1.0/.claude/skills/fleece-credits.md

@@ -0,0 +1,26 @@
+---
+name: fleece-credits
+description: Statement credits and perks for a credit card — amounts, cadence, enrollment requirements. Use when asked how to offset the annual fee or what credits are available.
+---
+
+# /fleece-credits
+
+Fetches the full list of statement credits and perks for a card.
+
+## When to use
+- User asks what credits a card offers
+- User wants to know how to offset the annual fee
+- User asks about dining, travel, streaming, or hotel credits
+
+## Usage
+
+```bash
+python cli.py credits "<card name>" --json
+```
+
+## Example
+
+```bash
+python cli.py credits "Amex Platinum" --json
+python cli.py credits "Chase Sapphire Reserve" --json
+```

fleece_cli-0.1.0/.claude/skills/fleece-news.md

@@ -0,0 +1,28 @@
+---
+name: fleece-news
+description: Recent changes to a credit card in the past month — benefit cuts, fee increases, new perks, or limited-time offers. Use when asked if anything changed recently.
+---
+
+# /fleece-news
+
+Searches for the latest news and changes for a card using freshness-filtered results.
+
+## When to use
+- User asks if a card's benefits have changed recently
+- User heard something changed and wants confirmation
+- You want to verify your training data is still accurate
+
+## Usage
+
+```bash
+python cli.py news "<card name>" --json
+```
+
+Results are filtered to the past month (`freshness=pm`).
+
+## Example
+
+```bash
+python cli.py news "Amex Gold" --json
+python cli.py news "Chase Sapphire Reserve" --json
+```

fleece_cli-0.1.0/.claude/skills/fleece-partners.md

@@ -0,0 +1,27 @@
+---
+name: fleece-partners
+description: Transfer partners for a credit card's rewards program — airlines and hotels, transfer ratios, and timing. Use when asked about moving points or miles.
+---
+
+# /fleece-partners
+
+Fetches transfer partner details for a card's rewards currency.
+
+## When to use
+- User asks what airlines or hotels they can transfer points to
+- User wants to know transfer ratios or how long transfers take
+- User is planning a specific redemption and needs partner details
+
+## Usage
+
+```bash
+python cli.py partners "<card name>" --json
+```
+
+## Example
+
+```bash
+python cli.py partners "Chase Sapphire Preferred" --json
+python cli.py partners "Capital One Venture X" --json
+python cli.py partners "Amex Platinum" --json
+```

fleece_cli-0.1.0/.claude/skills/fleece-rates.md

@@ -0,0 +1,29 @@
+---
+name: fleece-rates
+description: Earning rates for a credit card by spend category — points, miles, or cash back per dollar. Optionally filter to a specific category like dining or travel.
+---
+
+# /fleece-rates
+
+Looks up earning rates for a credit card, with optional category filtering.
+
+## When to use
+- User asks how many points/miles/cash back a card earns
+- User wants to know the best card for a specific spend category
+- You need to compare multipliers across categories
+
+## Usage
+
+```bash
+python cli.py rates "<card name>" --json
+python cli.py rates "<card name>" --category "<category>" --json
+```
+
+Categories: `dining`, `travel`, `groceries`, `gas`, `streaming`, `drugstores`, etc.
+
+## Example
+
+```bash
+python cli.py rates "Chase Sapphire Preferred" --json
+python cli.py rates "Amex Gold" --category dining --json
+```

fleece_cli-0.1.0/.claude/skills/fleece-recommend.md

@@ -0,0 +1,32 @@
+---
+name: fleece-recommend
+description: Card recommendations matched to a spending profile and preferences. Use when the user asks for the best card for their situation without naming a specific card.
+---
+
+# /fleece-recommend
+
+Searches for best-match US credit cards for a given spending profile.
+
+## When to use
+- User asks "what's the best card for me?"
+- User describes their spending habits and wants recommendations
+- User states a preference (no annual fee, travel perks, cash back, etc.)
+
+## Usage
+
+```bash
+python cli.py recommend "<spending profile>" --json
+python cli.py recommend "<spending profile>" --preferences "<extra preferences>" --json
+```
+
+Keep the profile concise: categories + rough amounts or priorities.
+
+## Example
+
+```bash
+python cli.py recommend "high dining and travel spend, $500/mo dining, $300/mo travel" --json
+python cli.py recommend "everyday spending, mostly groceries and gas" --preferences "no annual fee" --json
+python cli.py recommend "frequent international traveler" --preferences "priority pass lounge access" --json
+```
+
+After receiving results, present 2–3 top recommendations with a brief rationale for each.

fleece_cli-0.1.0/.claude/skills/fleece-roi.md

@@ -0,0 +1,31 @@
+---
+name: fleece-roi
+description: First-year ROI estimate for a credit card given monthly spend on travel, dining, and other. Calculates welcome bonus value + earn + credits minus annual fee.
+---
+
+# /fleece-roi
+
+Estimates first-year return on investment for a card based on the user's spending.
+
+## When to use
+- User asks if a card is worth it for them specifically
+- User provides their spending habits and wants a value estimate
+- User wants to compare first-year value across cards
+
+## Usage
+
+```bash
+python cli.py roi "<card name>" --travel <monthly $> --dining <monthly $> --other <monthly $> --json
+```
+
+All spend flags are optional and default to `0`. Omit any category the user didn't mention.
+
+## Example
+
+```bash
+python cli.py roi "Chase Sapphire Preferred" --travel 500 --dining 300 --other 1000 --json
+python cli.py roi "Amex Gold" --dining 800 --other 500 --json
+```
+
+The result includes annual spend totals, an assumed cents-per-point value, and live research context.
+Present the math clearly and note that exact welcome bonus amounts should be verified with the issuer.

fleece_cli-0.1.0/.claude/skills/fleece-wallet.md

@@ -0,0 +1,62 @@
+---
+name: fleece-wallet
+description: Portfolio analysis for a set of cards the user holds — category coverage map, overlaps, gaps, and next-card suggestions. Use when asked how to maximize an existing wallet.
+---
+
+# /fleece-wallet
+
+Analyzes a multi-card portfolio and identifies optimization opportunities.
+
+## When to use
+- User asks how many cards they have
+- User lists their current cards and asks how to maximize
+- User asks what category gaps exist in their wallet
+- User asks which card to use for a specific purchase given what they hold
+
+## Usage
+
+**If the user has a saved profile (most common)** — no args needed; the CLI auto-loads from `fleece.db`:
+
+```bash
+python cli.py wallet
+```
+
+**To pass cards explicitly:**
+
+```bash
+python cli.py wallet "Amex Platinum" "Chase Freedom Unlimited" "Bilt"
+```
+
+**Agent-friendly JSON output:**
+
+```bash
+python cli.py wallet --json
+```
+
+Cards can come from three sources (in priority order):
+1. Arguments passed directly on the command line
+2. `--from-profile` / `-p` flag (reads `user_cards.json`)
+3. No args + saved profile exists → auto-loads from `fleece.db`
+
+> **Do not query `fleece.db` directly with SQLite.** The CLI fetches live data via
+> Brave Search and returns a richer analysis (category rates, transfer partners,
+> recent benefit changes). Raw DB queries only give you stored card names and
+> cannot surface live earning rates or gaps.
+
+## Output
+
+The result includes:
+- **Category coverage map** — which card wins each spend category and at what rate
+- **Overlaps** — redundant benefits across cards (e.g., two dining multipliers in different currencies)
+- **Gaps** — categories earning only 1x with no bonus card
+- **1–2 complementary card suggestions** to plug the biggest gaps
+
+## Example
+
+```bash
+# Auto-load saved wallet (preferred)
+python cli.py wallet
+
+# Explicit cards
+python cli.py wallet "Amex Gold" "Chase Sapphire Preferred" "Citi Double Cash"
+```

fleece_cli-0.1.0/.devcontainer/devcontainer.json

@@ -0,0 +1,33 @@
+{
+  "name": "Python 3",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/python:1-3.11-bullseye",
+  "customizations": {
+    "codespaces": {
+      "openFiles": [
+        "README.md",
+        "fleece.py"
+      ]
+    },
+    "vscode": {
+      "settings": {},
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance"
+      ]
+    }
+  },
+  "updateContentCommand": "[ -f packages.txt ] && sudo apt update && sudo apt upgrade -y && sudo xargs apt install -y <packages.txt; [ -f requirements.txt ] && pip3 install --user -r requirements.txt; pip3 install --user streamlit; echo '✅ Packages installed and Requirements met'",
+  "postAttachCommand": {
+    "server": "streamlit run fleece.py --server.enableCORS false --server.enableXsrfProtection false"
+  },
+  "portsAttributes": {
+    "8501": {
+      "label": "Application",
+      "onAutoForward": "openPreview"
+    }
+  },
+  "forwardPorts": [
+    8501
+  ]
+}

fleece_cli-0.1.0/.github/workflows/databricks-app-deploy.yml

@@ -0,0 +1,40 @@
+name: Deploy Databricks App
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  DATABRICKS_HOST: ${{ secrets.DATABRICKS_HOST }}
+  DATABRICKS_TOKEN: ${{ secrets.DATABRICKS_TOKEN }}
+  APP_NAME: ${{ vars.DATABRICKS_APP_NAME || 'fleece' }}
+  WORKSPACE_USER: ${{ vars.DATABRICKS_WORKSPACE_USER }}
+  SOURCE_CODE_PATH: /Workspace/Users/${{ vars.DATABRICKS_WORKSPACE_USER }}/fleece
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Databricks CLI
+        uses: databricks/setup-cli@main
+
+      - name: Sync source code to workspace
+        run: |
+          databricks sync . "$SOURCE_CODE_PATH" --exclude ".git"
+
+      - name: Create app if missing
+        run: |
+          databricks apps create "$APP_NAME" || true
+
+      - name: Deploy app
+        run: |
+          databricks apps deploy "$APP_NAME" --source-code-path "$SOURCE_CODE_PATH"

fleece_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - run: pip install build
+
+      - run: python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

fleece_cli-0.1.0/.gitignore

@@ -0,0 +1,137 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+.idea
+.env
+user_cards.json
+user_cards.json.bak
+fleece.db
+
+user_cards.json

fleece_cli-0.1.0/.streamlit/config.toml

@@ -0,0 +1,3 @@
+[theme]
+base="light"
+primaryColor="#1c1c1c"

fleece_cli-0.1.0/Advertiser Disclosure.md

@@ -0,0 +1,5 @@
+Advertiser Disclosure:
+Some of the card links and other products that appear on this website are from companies which AskSebby will earn an affiliate commission or referral bonus. AskSebby is part of an affiliate sales network and receives compensation for sending traffic to partner sites, such as CreditCards.com. This compensation may impact how and where products appear on this site (including, for example, the order in which they appear). This site does not include all credit card companies or all available credit card offers.
+
+Editorial Note:
+Opinions expressed here are the author's alone, not those of any bank, credit card issuer, airlines or hotel chain, vendors or companies, and have not been reviewed, approved, or otherwise endorsed by any of these entities.