fleece-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.agents/skills/fleece/SKILL.md

@@ -1,6 +1,6 @@
 ---
 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.
+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. Install with `pip install fleece-cli`. Use whenever you need current credit card information.
 ---
 
 # Fleece Credit Card Research
@@ -11,66 +11,66 @@ programmatic use. Requires `BRAVE_API_KEY` in the environment.
 ## Prerequisites
 
 ```bash
+# Install once
+pip install fleece-cli
+
 # 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
+fleece 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
+fleece rates "<card name>" --json
+fleece rates "<card name>" --category "<dining|travel|groceries|gas>" --json
 ```
 
 ### Transfer partners
 ```bash
-python cli.py partners "<card name>" --json
+fleece partners "<card name>" --json
 ```
 Returns airline and hotel partners with ratios and transfer timing.
 
 ### Statement credits
 ```bash
-python cli.py credits "<card name>" --json
+fleece 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
+fleece 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
+fleece compare "<card A>" "<card B>" --json
+fleece 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
+fleece 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
+fleece 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
+fleece recommend "<spending profile>" --json
+fleece recommend "<spending profile>" --preferences "<preferences>" --json
 ```
 
 ## Output format
@@ -100,13 +100,13 @@ On error, `ok` is `false` and `error` contains the message. Always check `ok` be
 
 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
+echo "Chase Sapphire Preferred" | fleece card - --json
+echo "high dining spend" | fleece 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
+printf "Amex Gold\nChase Freedom Unlimited\nBilt\n" | fleece wallet - --json
 ```
 
 ## Coverage

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-card.md

@@ -15,7 +15,7 @@ Fetches a comprehensive report for a US credit card using live Brave Search data
 ## Usage
 
 ```bash
-python cli.py card "<card name>" --json
+fleece card "<card name>" --json
 ```
 
 The `--json` flag returns a structured envelope your can parse:
@@ -33,6 +33,6 @@ Use `result` as your research context, then synthesize a natural answer.
 ## Example
 
 ```bash
-python cli.py card "Chase Sapphire Preferred" --json
-python cli.py card "Amex Gold" --json
+fleece card "Chase Sapphire Preferred" --json
+fleece card "Amex Gold" --json
 ```

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-compare.md

@@ -15,8 +15,8 @@ Searches live data for both cards and returns research for a structured comparis
 ## Usage
 
 ```bash
-python cli.py compare "<card A>" "<card B>" --json
-python cli.py compare "<card A>" "<card B>" --aspects "fees,rewards,credits" --json
+fleece compare "<card A>" "<card B>" --json
+fleece compare "<card A>" "<card B>" --aspects "fees,rewards,credits" --json
 ```
 
 Default aspects: `fees,rewards,welcome_offer,credits,transfer_partners`
@@ -24,8 +24,8 @@ 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
+fleece compare "Amex Gold" "Chase Sapphire Preferred" --json
+fleece 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 → fleece_cli-0.2.0}/.claude/skills/fleece-credits.md

@@ -15,12 +15,12 @@ Fetches the full list of statement credits and perks for a card.
 ## Usage
 
 ```bash
-python cli.py credits "<card name>" --json
+fleece credits "<card name>" --json
 ```
 
 ## Example
 
 ```bash
-python cli.py credits "Amex Platinum" --json
-python cli.py credits "Chase Sapphire Reserve" --json
+fleece credits "Amex Platinum" --json
+fleece credits "Chase Sapphire Reserve" --json
 ```

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-news.md

@@ -15,7 +15,7 @@ Searches for the latest news and changes for a card using freshness-filtered res
 ## Usage
 
 ```bash
-python cli.py news "<card name>" --json
+fleece news "<card name>" --json
 ```
 
 Results are filtered to the past month (`freshness=pm`).
@@ -23,6 +23,6 @@ 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 news "Amex Gold" --json
+fleece news "Chase Sapphire Reserve" --json
 ```

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-partners.md

@@ -15,13 +15,13 @@ Fetches transfer partner details for a card's rewards currency.
 ## Usage
 
 ```bash
-python cli.py partners "<card name>" --json
+fleece 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 partners "Chase Sapphire Preferred" --json
+fleece partners "Capital One Venture X" --json
+fleece partners "Amex Platinum" --json
 ```

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-rates.md

@@ -15,8 +15,8 @@ Looks up earning rates for a credit card, with optional category filtering.
 ## Usage
 
 ```bash
-python cli.py rates "<card name>" --json
-python cli.py rates "<card name>" --category "<category>" --json
+fleece rates "<card name>" --json
+fleece rates "<card name>" --category "<category>" --json
 ```
 
 Categories: `dining`, `travel`, `groceries`, `gas`, `streaming`, `drugstores`, etc.
@@ -24,6 +24,6 @@ Categories: `dining`, `travel`, `groceries`, `gas`, `streaming`, `drugstores`, e
 ## Example
 
 ```bash
-python cli.py rates "Chase Sapphire Preferred" --json
-python cli.py rates "Amex Gold" --category dining --json
+fleece rates "Chase Sapphire Preferred" --json
+fleece rates "Amex Gold" --category dining --json
 ```

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-recommend.md

@@ -15,8 +15,8 @@ Searches for best-match US credit cards for a given spending profile.
 ## Usage
 
 ```bash
-python cli.py recommend "<spending profile>" --json
-python cli.py recommend "<spending profile>" --preferences "<extra preferences>" --json
+fleece recommend "<spending profile>" --json
+fleece recommend "<spending profile>" --preferences "<extra preferences>" --json
 ```
 
 Keep the profile concise: categories + rough amounts or priorities.
@@ -24,9 +24,9 @@ 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
+fleece recommend "high dining and travel spend, $500/mo dining, $300/mo travel" --json
+fleece recommend "everyday spending, mostly groceries and gas" --preferences "no annual fee" --json
+fleece 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 → fleece_cli-0.2.0}/.claude/skills/fleece-roi.md

@@ -15,7 +15,7 @@ Estimates first-year return on investment for a card based on the user's spendin
 ## Usage
 
 ```bash
-python cli.py roi "<card name>" --travel <monthly $> --dining <monthly $> --other <monthly $> --json
+fleece 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.
@@ -23,8 +23,8 @@ All spend flags are optional and default to `0`. Omit any category the user didn
 ## 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
+fleece roi "Chase Sapphire Preferred" --travel 500 --dining 300 --other 1000 --json
+fleece roi "Amex Gold" --dining 800 --other 500 --json
 ```
 
 The result includes annual spend totals, an assumed cents-per-point value, and live research context.

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.claude/skills/fleece-wallet.md

@@ -18,19 +18,19 @@ Analyzes a multi-card portfolio and identifies optimization opportunities.
 **If the user has a saved profile (most common)** — no args needed; the CLI auto-loads from `fleece.db`:
 
 ```bash
-python cli.py wallet
+fleece wallet
 ```
 
 **To pass cards explicitly:**
 
 ```bash
-python cli.py wallet "Amex Platinum" "Chase Freedom Unlimited" "Bilt"
+fleece wallet "Amex Platinum" "Chase Freedom Unlimited" "Bilt"
 ```
 
 **Agent-friendly JSON output:**
 
 ```bash
-python cli.py wallet --json
+fleece wallet --json
 ```
 
 Cards can come from three sources (in priority order):
@@ -55,8 +55,8 @@ The result includes:
 
 ```bash
 # Auto-load saved wallet (preferred)
-python cli.py wallet
+fleece wallet
 
 # Explicit cards
-python cli.py wallet "Amex Gold" "Chase Sapphire Preferred" "Citi Double Cash"
+fleece wallet "Amex Gold" "Chase Sapphire Preferred" "Citi Double Cash"
 ```

fleece_cli-0.2.0/.github/workflows/publish-skills.yml

@@ -0,0 +1,29 @@
+name: Publish Skills to ClawHub
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - ".agents/skills/**"
+      - ".claude/skills/**"
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: "20"
+
+      - name: Install clawhub
+        run: npm install -g clawhub
+
+      - name: Authenticate
+        run: clawhub login --token "${{ secrets.CLAWHUB_TOKEN }}" --no-browser
+
+      - name: Publish skills
+        run: clawhub sync --root .agents/skills --all --changelog "Automated publish from ${{ github.sha }}"

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/.github/workflows/publish.yml

@@ -9,7 +9,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-python@v5
         with:
@@ -19,7 +19,7 @@ jobs:
 
       - run: python -m build
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v5
         with:
           name: dist
           path: dist/
@@ -31,7 +31,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v5
         with:
           name: dist
           path: dist/

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/CLAUDE.md

@@ -33,12 +33,17 @@ Fleece is a chatbot that:
 - **No structured research**: Lacks the ability to provide specific, verified credit card information (fees, benefits, offers, transfer partners, etc.)
 
 ## Future Integration Opportunities
-- **credit-card-skills integration**: Add specialized research capabilities to access live issuer data
 - **Multi-page app expansion**: Build out the "Credit Cards" discovery page and "My Credit Cards" portfolio management
 - **Database backend**: Store user profiles, card portfolios, and preferences
 
+## CLI — Redemption Commands
+The `fleece flights` and `fleece hotels` commands are merged from the former `pointsyeah-cli` project (now archived). They generate PointsYeah search URLs with no API key required — pure stdlib, zero external dependencies. Source lives in `pointsyeah.py`.
+
 ## Development Notes
 - Author: Yuan Chen
 - Created: March 16, 2025
 - Uses custom CSS styling (style.css)
-- Requires OpenAI API key (entered via sidebar, not stored)
+- Requires OpenAI API key (entered via sidebar, not stored)
+
+## Infrastructure Notes
+- **Databricks**: No Databricks resources are available at the moment. The Databricks App deployment workflow has been removed. Do not suggest or implement Databricks-based solutions until resources are provisioned.

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: fleece-cli
-Version: 0.1.0
-Summary: Credit card research CLI — live data via Brave Search, designed for humans and AI agents.
+Version: 0.2.0
+Summary: Credit card research and redemption CLI — live data via Brave Search, PointsYeah URL generation, designed for humans and AI agents.
 Author-email: Yuan Chen <cysbc1999@gmail.com>
 License: MIT
 License-File: LICENSE

{fleece_cli-0.1.0 → fleece_cli-0.2.0}/cli.py

@@ -309,6 +309,73 @@ def recommend(
     _run_search(_get_wrapper(key), query, "recommend", as_json)
 
 
+# ---------------------------------------------------------------------------
+# Redemption — PointsYeah URL generation (no API key required)
+# ---------------------------------------------------------------------------
+
+CABINS = ["economy", "premium-economy", "business", "first"]
+
+
+@app.command()
+def flights(
+    origin:      Annotated[str, typer.Argument(help="Origin airport code (e.g. JFK).")],
+    destination: Annotated[str, typer.Argument(help="Destination airport code (e.g. LAX).")],
+    date:        Annotated[str,  typer.Option("--date", help="Departure date (YYYY-MM-DD).")],
+    return_date: Annotated[Optional[str], typer.Option("--return", help="Return date (YYYY-MM-DD).")] = None,
+    adults:      Annotated[int,  typer.Option("--adults", min=1)] = 1,
+    cabin:       Annotated[str,  typer.Option("--cabin", help=f"Cabin class: {', '.join(CABINS)}.")] = "economy",
+    open_url:    Annotated[bool, typer.Option("--open", help="Open URL in browser.")] = False,
+    as_json:     JsonOpt = False,
+):
+    """Generate a PointsYeah flight search URL and optionally open it."""
+    import webbrowser
+    from pointsyeah import FlightsQuery, build_flights_url
+
+    if cabin not in CABINS:
+        _error_exit(f"Invalid cabin '{cabin}'. Choose from: {', '.join(CABINS)}")
+
+    q = FlightsQuery(origin=origin, destination=destination, date=date,
+                     return_date=return_date, adults=adults, cabin=cabin)
+    url = build_flights_url(q)
+
+    if as_json:
+        import dataclasses
+        typer.echo(json.dumps({"command": "flights", **dataclasses.asdict(q), "url": url, "ok": True, "error": None}))
+    else:
+        typer.echo(url)
+
+    if open_url:
+        webbrowser.open(url)
+
+
+@app.command()
+def hotels(
+    location: Annotated[str, typer.Argument(help="City, area, or hotel keyword.")],
+    checkin:  Annotated[str, typer.Option("--checkin",  help="Check-in date (YYYY-MM-DD).")],
+    checkout: Annotated[str, typer.Option("--checkout", help="Check-out date (YYYY-MM-DD).")],
+    guests:   Annotated[int, typer.Option("--guests", min=1)] = 1,
+    rooms:    Annotated[int, typer.Option("--rooms",  min=1)] = 1,
+    open_url: Annotated[bool, typer.Option("--open", help="Open URL in browser.")] = False,
+    as_json:  JsonOpt = False,
+):
+    """Generate a PointsYeah hotel search URL and optionally open it."""
+    import webbrowser
+    from pointsyeah import HotelsQuery, build_hotels_url
+
+    q = HotelsQuery(location=location, checkin=checkin, checkout=checkout,
+                    guests=guests, rooms=rooms)
+    url = build_hotels_url(q)
+
+    if as_json:
+        import dataclasses
+        typer.echo(json.dumps({"command": "hotels", **dataclasses.asdict(q), "url": url, "ok": True, "error": None}))
+    else:
+        typer.echo(url)
+
+    if open_url:
+        webbrowser.open(url)
+
+
 # ---------------------------------------------------------------------------
 # cards — profile management (read/write user_cards.json)
 # ---------------------------------------------------------------------------

fleece_cli-0.2.0/docs/CNAME

@@ -0,0 +1 @@
+getfleece.io