From c114f3e99f0b0b806c04952979ac4969bfda9318 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 28 Feb 2026 02:29:43 +0000
Subject: [PATCH] Add debug logging for deal filtering and --debug flag

Log the raw deal count before filtering and log each filtered-out
deal with the reason (savings too low, rating too low) at DEBUG level.
Use --debug flag to enable verbose output for troubleshooting.

https://claude.ai/code/session_01LPpSZFfyh6vdV5HGFWjoQX
---
 gaming_deals_bot/__main__.py   | 11 ++++++++---
 gaming_deals_bot/cheapshark.py |  7 +++++++
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/gaming_deals_bot/__main__.py b/gaming_deals_bot/__main__.py
index c6dd4e4..93c6525 100644
--- a/gaming_deals_bot/__main__.py
+++ b/gaming_deals_bot/__main__.py
@@ -13,17 +13,22 @@ from .config import Config
 from .preflight import run_preflight
 
 
-def setup_logging():
+def setup_logging(*, debug: bool = False):
     logging.basicConfig(
-        level=logging.INFO,
+        level=logging.DEBUG if debug else logging.INFO,
         format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
         stream=sys.stdout,
     )
+    if not debug:
+        # Keep noisy third-party loggers quiet even in debug mode
+        logging.getLogger("httpx").setLevel(logging.WARNING)
+        logging.getLogger("httpcore").setLevel(logging.WARNING)
 
 
 async def main():
     load_dotenv()
-    setup_logging()
+    debug_mode = "--debug" in sys.argv
+    setup_logging(debug=debug_mode)
     logger = logging.getLogger("gaming_deals_bot")
 
     check_mode = "--check" in sys.argv
diff --git a/gaming_deals_bot/cheapshark.py b/gaming_deals_bot/cheapshark.py
index 2037acc..4062cb3 100644
--- a/gaming_deals_bot/cheapshark.py
+++ b/gaming_deals_bot/cheapshark.py
@@ -68,14 +68,21 @@ async def fetch_deals(
         logger.error("CheapShark API error: %s", exc)
         return []
 
+    logger.info(
+        "CheapShark returned %d raw deals (before filtering)", len(raw_deals),
+    )
+
     deals = []
     for d in raw_deals:
         savings = float(d.get("savings", 0))
         rating = float(d.get("dealRating", 0))
+        title = d.get("title", "?")
 
         if savings < min_discount:
+            logger.debug("Filtered out %s: savings %.1f%% < %.1f%%", title, savings, min_discount)
             continue
         if rating < min_rating:
+            logger.debug("Filtered out %s: rating %.1f < %.1f", title, rating, min_rating)
             continue
 
         steam_app_id = d.get("steamAppID") or None