fix: remove Google Books from scored platforms and all author-facing UI

.agent/BDD_SPECS.md

@@ -408,10 +408,10 @@ Feature: Platform Presence Scan
     And "open_library" should be verified with a product URL
     And at least 5 platforms should be listed
 
-  Scenario: Scored platforms include Google Books and Open Library
+  Scenario: Scored platforms exclude Google Books (9 channels)
     When I load the scored platform list
-    Then there should be exactly 10 platforms
-    And the platform list should include "google_books"
+    Then there should be exactly 9 platforms
+    And the platform list should not include "google_books"
     And the platform list should include "open_library"
 
 

.agent/BOOK_URL_IMPORT_RULES.md

@@ -25,9 +25,10 @@ deliberate review — not drive-by tweaks.
 | Bookshop.org | HC / eBook / Audiobook **if listed** | curl → ScrapingBee; iTunes for pre-orders |
 | Open Library | **No prices** (discovery) | Edition → parent work; HTTPS covers |
 
-**Not a URL-import platform:** Google Books / Google Play Books.  
-The **Google Books API** remains an internal enricher (ISBN, volume id, title search) for
-locked platforms. Do not re-add `google_books` to `AB_PLATFORMS` or `detect_platform()`.
+**Not a URL-import platform and not a scored presence channel:** Google Books / Google Play Books.  
+The **Google Books API** remains an internal enricher only (ISBN, volume id, title search) for
+locked platforms. Do not re-add `google_books` to `AB_PLATFORMS`, `detect_platform()`, or
+`SCORED_PLATFORMS`. Never show Google Books in Platform Presence, publish-help checklists, or bot Buy CTAs.
 
 Code mirror: `LOCKED_URL_IMPORT_PLATFORMS` in `app/services/book_url_scraper.py` and
 `AB_PLATFORMS` in `app/admin/templates/admin.html` must stay in sync.

.agent/PLATFORM_PRICING_RULES.md

@@ -78,14 +78,15 @@ Amazon HTML: US-locale headers + cookie (`i18n-prefs=USD`) to avoid PKR/wrong cu
 | platform_id | Typical source | Notes |
 |-------------|----------------|-------|
 | amazon | credential → HTML | US headers critical |
-| google_books | credential → API → ISBN fallback | |
 | apple_books | iTunes API | `formattedPrice` |
 | barnes_noble | credential → HTML JSON | |
 | abebooks | credential → HTML itemprop | |
-| kobo, thriftbooks, bookshop | credential only | Often 403 without ScrapingBee |
+| kobo, thriftbooks, bookshop | credential / HTML | Often 403 without ScrapingBee |
 | goodreads | rollup | No direct price on page |
 | open_library | static "Free" | Catalog semantics |
 
+Google Books is **not** a scored or priced channel (API enricher only).
+
 ## 8. Tests
 
 - [x] Unit — `tests/unit/test_platform_pricing.py` (format, HTML extract, API mocks)
@@ -109,7 +110,7 @@ Amazon HTML: US-locale headers + cookie (`i18n-prefs=USD`) to avoid PKR/wrong cu
 - **R-187:** Platform scan cache key version bumped when price/credential logic changes materially
 - **R-PP-010:** Scan enrichment MUST write `format_prices` when parsers find ≥1 format; MUST NOT wipe a richer existing map with a thinner scan result. Single-price fallback MUST NOT invent a binding label — Kobo may use eBook; ThriftBooks / AbeBooks / Bookshop use JSON-LD `bookFormat` when present, otherwise leave `format_prices` empty and keep `list_price` only.
 - **R-PP-011:** `fetch_listing_format_prices` fetches HTML exactly once and passes the raw HTML to format-price parsers — no double HTTP round-trips per listing
-- **R-PP-012:** Discovery platforms (goodreads, open_library, google_books) return `format_prices: {}` from enrichment; their single `list_price` is preserved as-is
+- **R-PP-012:** Discovery platforms (goodreads, open_library) return `format_prices: {}` from enrichment; their single `list_price` is preserved as-is. Google Books is not a scored platform.
 - **R-PP-013:** `fetch_listing_price` remains a backward-compatible thin wrapper over `fetch_listing_format_prices` returning only the primary formatted string
 - **R-PP-014:** Apple Books enrichment MUST query iTunes `entity=ebook` and `entity=audiobook` so both digital formats can populate `format_prices` when available
 - **R-PP-015:** Presence enrichment MUST call the same deep format parsers as source import — Amazon, BN, ThriftBooks, AbeBooks, Bookshop, Kobo — after one HTML fetch. Never invent missing format keys.

.agent/PRICE_INTELLIGENCE_RULES.md

@@ -59,7 +59,8 @@ No new endpoints.
 3. No verified listings → warm text + existing `get_book_links` Buy button
 
 **Never show as Buy / price rows in chat:** `google_books`, `goodreads`, `open_library`
-(`BOT_CHAT_EXCLUDED_PLATFORMS`). Google Books remains an internal enricher only.
+(`BOT_CHAT_EXCLUDED_PLATFORMS`). Google Books is also removed from Platform Presence /
+`SCORED_PLATFORMS` — API enricher only, never a listed channel.
 
 ## 7. Tests
 

app/admin/templates/admin.html

@@ -5571,7 +5571,6 @@ const AB_PP_STATUS = {
 const AB_PP_CHECKLISTS = {
   amazon: ['ISBN or ASIN', 'Cover JPG (2560×1600 min)', 'KDP account & bank details', 'Book description & categories'],
   apple_books: ['EPUB file', 'ISBN (recommended)', 'Apple ID & iTunes Connect', 'Cover image'],
-  google_books: ['EPUB or PDF', 'Cover image', 'Google Books partner account', 'Book metadata'],
   barnes_noble: ['EPUB file', 'ISBN', 'B&N Press account', 'Cover & description'],
   kobo: ['EPUB file', 'ISBN (recommended)', 'Kobo Writing Life account', 'Cover image'],
   bookshop: ['ISBN', 'Distributor or direct upload path', 'Book metadata'],
@@ -5579,6 +5578,7 @@ const AB_PP_CHECKLISTS = {
   goodreads: ['Author profile', 'Book ISBN for linking', 'Cover & description'],
   thriftbooks: ['ISBN', 'Inventory listing', 'Condition & pricing'],
   abebooks: ['ISBN', 'Seller account', 'Book condition & pricing'],
+  open_library: ['ISBN', 'Open Library edition record', 'Cover & description'],
   };
 
 let _abSupportConfig = { support_email: null };

app/schemas/admin.py

@@ -239,9 +239,9 @@ class RateSessionRequest(BaseModel):
 # ─── Publishing Help ───────────────────────────────────────────────────────────
 
 _VALID_PLATFORM_IDS = frozenset({
-    "amazon", "apple_books", "google_books", "barnes_noble", "kobo",
+    "amazon", "apple_books", "barnes_noble", "kobo",
     "goodreads", "thriftbooks", "abebooks", "bookshop", "open_library",
-    "bookshop", "walmart", "goodreads", "thriftbooks", "abebooks",
+    "walmart",
 })
 
 

app/services/catalog_hub.py

@@ -36,9 +36,7 @@ VERIFIED_THRESHOLD = 0.85
 LIKELY_THRESHOLD = 0.70
 
 # Import platform IDs that map to scored platform IDs
-SOURCE_PLATFORM_ALIASES: dict[str, str] = {
-    "google_play": "google_books",
-}
+SOURCE_PLATFORM_ALIASES: dict[str, str] = {}
 
 
 @dataclass
@@ -298,14 +296,6 @@ def discover_platform_hit(
         if url and classify_retailer_url(url, platform_id) == "product":
             return PlatformHit(1.0, url, isbn_match=True)
 
-    if platform_id == "google_books":
-        if snap.gb_volume_id and snap.gb_confidence >= VERIFIED_THRESHOLD:
-            return PlatformHit(
-                snap.gb_confidence,
-                snap.google_books_url(),
-                snap.gb_confidence >= 0.95,
-            )
-
     if platform_id == "open_library" and snap.ol_confidence >= VERIFIED_THRESHOLD:
         url = snap.open_library_url()
         if url:

app/services/isbn_catalog.py

@@ -487,33 +487,9 @@ async def verify_isbn_anchor(
             snippet = (resp.text or "")[:120_000].lower()
             tokens = [t for t in re.sub(r"[^\w\s]", " ", core).split() if len(t) > 3]
             if tokens and sum(1 for t in tokens[:3] if t.lower() in snippet) < 2:
-                # #region agent log
-                try:
-                    import time as _tv, json as _jv
-                    with open("debug-7c8974.log", "a") as _fv:
-                        _fv.write(_jv.dumps({"sessionId":"7c8974","hypothesisId":"A","location":"isbn_catalog.py:verify_isbn_anchor","message":"anchor_title_fail","data":{"platform":platform_id,"anchor":anchor,"final":final,"clean":clean,"found_tokens":sum(1 for t in tokens[:3] if t.lower() in snippet)},"timestamp":int(_tv.time()*1000)}) + "\n")
-                except Exception:
-                    pass
-                # #endregion
                 return None
-        # #region agent log
-        try:
-            import time as _tv2, json as _jv2
-            with open("debug-7c8974.log", "a") as _fv2:
-                _fv2.write(_jv2.dumps({"sessionId":"7c8974","hypothesisId":"A","location":"isbn_catalog.py:verify_isbn_anchor","message":"anchor_success","data":{"platform":platform_id,"anchor":anchor,"final":final,"clean":clean,"status":resp.status_code},"timestamp":int(_tv2.time()*1000)}) + "\n")
-        except Exception:
-            pass
-        # #endregion
         return clean
     except Exception as exc:
-        # #region agent log
-        try:
-            import time as _tve, json as _jve
-            with open("debug-7c8974.log", "a") as _fve:
-                _fve.write(_jve.dumps({"sessionId":"7c8974","hypothesisId":"A","location":"isbn_catalog.py:verify_isbn_anchor","message":"anchor_exception","data":{"platform":platform_id,"anchor":anchor,"error":str(exc)[:200]},"timestamp":int(_tve.time()*1000)}) + "\n")
-        except Exception:
-            pass
-        # #endregion
         logger.debug(
             "ISBN anchor verify failed",
             platform=platform_id,

app/services/platform_presence.py

@@ -39,7 +39,7 @@ logger = structlog.get_logger(__name__)
 
 _SCAN_TIMEOUT = 10.0
 _MAX_CONCURRENT = 6
-_SCAN_CACHE_PREFIX = "platform_scan:v13:"
+_SCAN_CACHE_PREFIX = "platform_scan:v14:"
 _SCAN_CACHE_TTL = 21_600  # 6h
 
 Status = Literal["verified", "likely", "not_found", "checking", "error", "skipped"]
@@ -51,7 +51,6 @@ PLATFORM_BENEFITS: dict[str, str] = {
     "amazon": "Largest US ebook and print discovery channel",
     "barnes_noble": "US brick-and-mortar and Nook readers",
     "goodreads": "Social discovery and reader reviews",
-    "google_books": "Google Books catalog and preview reach",
     "apple_books": "Reach readers on iPhone, iPad, and Mac",
     "kobo": "Strong global indie and Rakuten audience",
     "thriftbooks": "Secondary-market demand signal",
@@ -60,11 +59,11 @@ PLATFORM_BENEFITS: dict[str, str] = {
     "open_library": "Free open catalog and lending discovery",
 }
 
+# Google Books is never scored / shown — API enricher only (not a retail channel).
 SCORED_PLATFORMS: list[dict] = [
     {"platform_id": "amazon", "display_name": "Amazon", "weight": 2.0},
     {"platform_id": "barnes_noble", "display_name": "Barnes & Noble", "weight": 1.0},
     {"platform_id": "goodreads", "display_name": "Goodreads", "weight": 1.0},
-    {"platform_id": "google_books", "display_name": "Google Books", "weight": 1.2},
     {"platform_id": "apple_books", "display_name": "Apple Books", "weight": 1.2},
     {"platform_id": "kobo", "display_name": "Kobo", "weight": 1.0},
     {"platform_id": "thriftbooks", "display_name": "ThriftBooks", "weight": 0.8},
@@ -302,13 +301,11 @@ class CatalogContext:
     retailer_links: dict[str, str] = field(default_factory=dict)
 
 
-# Goodreads BookLink name → platform_id
+# Goodreads BookLink name → platform_id (Google Books / Play never mapped — not a scored channel)
 _BOOKLINK_PLATFORM_KEYS: list[tuple[str, tuple[str, ...]]] = [
     ("amazon", ("amazon",)),
     ("barnes_noble", ("barnes", "noble")),
     ("kobo", ("kobo",)),
-    ("google_books", ("google books", "google play")),
-    ("google_play", ("google play",)),
     ("apple_books", ("apple books", "ibooks")),
     ("bookshop", ("bookshop",)),
     ("thriftbooks", ("thriftbooks",)),
@@ -512,7 +509,8 @@ async def _build_catalog_context(
             gr_links = {
                 pid: url
                 for pid, raw in parse_goodreads_book_links(page_html).items()
-                if (url := sanitize_platform_url(raw, pid))
+                if pid not in ("google_play", "google_books")
+                and (url := sanitize_platform_url(raw, pid))
             }
             ctx.retailer_links = merge_retailer_links(ctx.retailer_links, gr_links)
     if ctx.goodreads_url:
@@ -601,6 +599,8 @@ def presence_dict_from_db_listings(
     platforms: list[PlatformListing] = []
     for row in listings:
         pid = row.platform_id
+        if pid == "google_books":
+            continue
         cfg = cfg_by_id.get(pid, {})
         raw_fps = row.format_prices if isinstance(getattr(row, "format_prices", None), dict) else {}
         platforms.append(PlatformListing(
@@ -690,10 +690,8 @@ async def _load_goodreads_hub(
         page_html = await _fetch_goodreads_book_page(client, book_id, book_path)
         if page_html:
             for pid, raw in parse_goodreads_book_links(page_html).items():
-                if pid == "google_play":
-                    if "books.google.com" not in raw and "/store/books/details" not in raw:
-                        continue
-                    pid = "google_books"
+                if pid in ("google_play", "google_books"):
+                    continue
                 clean = sanitize_platform_url(raw, pid)
                 if clean:
                     links[pid] = clean
@@ -716,10 +714,8 @@ async def _load_goodreads_hub(
         page_html = await _fetch_goodreads_book_page(client, book_id, book_path)
         if page_html:
             for pid, raw in parse_goodreads_book_links(page_html).items():
-                if pid == "google_play":
-                    if "books.google.com" not in raw and "/store/books/details" not in raw:
-                        continue
-                    pid = "google_books"
+                if pid in ("google_play", "google_books"):
+                    continue
                 clean = sanitize_platform_url(raw, pid)
                 if clean:
                     links[pid] = clean
@@ -754,15 +750,6 @@ def _finalize_listing_url(listing: PlatformListing) -> None:
                 clean = rewritten
         except Exception:
             pass
-    # #region agent log
-    _cls = classify_retailer_url(clean, pid) if clean else "none"
-    try:
-        import time as _t2, json as _j2
-        with open("debug-7c8974.log", "a") as _f2:
-            _f2.write(_j2.dumps({"sessionId":"7c8974","hypothesisId":"B","location":"platform_presence.py:_finalize","message":"finalize_url","data":{"pid":pid,"raw":listing.listing_url,"clean":clean,"cls":_cls},"timestamp":int(_t2.time()*1000)}) + "\n")
-    except Exception:
-        pass
-    # #endregion
     if not clean or classify_retailer_url(clean, pid) != "product":
         listing.listing_url = None
         listing.status = "not_found"
@@ -961,16 +948,6 @@ async def scan_platform_presence(
             author=snap.author or author,
         )
 
-        # #region agent log
-        import time as _time
-        try:
-            with open("debug-7c8974.log", "a") as _f:
-                import json as _j
-                _f.write(_j.dumps({"sessionId":"7c8974","hypothesisId":"A-D","location":"platform_presence.py:after_enrich","message":"retailer_links_after_enrich","data":{"links":{k:v for k,v in (snap.retailer_links or {}).items()}},"timestamp":int(_time.time()*1000)}) + "\n")
-        except Exception:
-            pass
-        # #endregion
-
         if not snap.asin:
             resolved_asin = _extract_asin(scan_isbn or isbn)
             if not resolved_asin and gr_links.get("amazon"):

app/services/platform_pricing.py

@@ -33,8 +33,8 @@ logger = structlog.get_logger(__name__)
 
 _PRICE_TIMEOUT = 12.0
 
-# Goodreads is discovery-only — no single list price on the page.
-_NO_PRICE_PLATFORMS = frozenset({"goodreads"})
+# Goodreads / Google Books — never retail list-price channels.
+_NO_PRICE_PLATFORMS = frozenset({"goodreads", "google_books"})
 
 # Discovery / enricher-only — never fetch HTML for format prices (exclude open_library which returns Free).
 _NO_FORMAT_PLATFORMS = frozenset({"goodreads", "google_books"})
@@ -416,9 +416,6 @@ async def fetch_listing_price(
             return hit
 
     # Priority 2: built-in free logic
-    if platform_id == "google_books":
-        return await fetch_google_books_price(client, listing_url, ctx)
-
     if platform_id == "apple_books":
         return await fetch_apple_books_price(client, listing_url, ctx)
 
@@ -589,7 +586,7 @@ def _deep_format_prices_from_html(platform_id: str, html: str) -> dict[str, str]
 
 def _single_price_credential_format(platform_id: str) -> str:
     """Best-effort format label for a single credential price (empty if unknown)."""
-    if platform_id in {"kobo", "google_books"}:
+    if platform_id == "kobo":
         return "eBook"
     # Print-focused / mixed retailers: don't guess a binding.
     return ""

static/admin.html

@@ -839,7 +839,7 @@ function renderPreview(data) {
     showAlert('error', data.error + ' — please fill in details manually.');
   } else if (data.error || (data.warnings && data.warnings.length)) {
     const m = data.error || data.warnings.join('; ');
-    showAlert('warning', '⚠️ Partial data enriched via Google Books/Open Library: ' + m);
+    showAlert('warning', '⚠️ Partial data enriched via catalog APIs: ' + m);
   } else { hideAlert(); }
 
   setFetchState('preview');

static/import-book.html

@@ -749,12 +749,11 @@
     { name: 'Amazon',          icon: '🛒' },
     { name: 'Barnes & Noble',  icon: '📕' },
     { name: 'Goodreads',       icon: '⭐' },
-    { name: 'Google Books',    icon: '🔍' },
     { name: 'Apple Books',     icon: '🍎' },
     { name: 'Kobo',            icon: '📖' },
     { name: 'ThriftBooks',     icon: '💸' },
     { name: 'AbeBooks',        icon: '🏛️' },
-    { name: 'WorldCat',        icon: '🌍' },
+    { name: 'Bookshop.org',    icon: '📚' },
     { name: 'Open Library',    icon: '🏛' },
   ];
 
@@ -899,7 +898,7 @@
       showAlert('error', data.error + ' — please fill in the details manually.');
     } else if (data.error || (data.warnings && data.warnings.length)) {
       const msg = data.error || data.warnings.join('; ');
-      showAlert('warning', '⚠️ Partial data — some fields enriched via Google Books/Open Library: ' + msg);
+      showAlert('warning', '⚠️ Partial data — some fields enriched via catalog APIs: ' + msg);
     } else {
       hideAlert();
     }

tests/bdd/features/platform_presence.feature

@@ -1,5 +1,5 @@
 Feature: Platform Presence Scan
-  API-first discovery across 10 public book platforms.
+  API-first discovery across 9 public book platforms (Google Books excluded).
 
   Scenario: Kindle-only Amazon book finds Amazon and Goodreads
     Given a sample book "amazon_kindle"
@@ -15,8 +15,8 @@ Feature: Platform Presence Scan
     And "open_library" should be verified with a product URL
     And at least 5 platforms should be listed
 
-  Scenario: Platform list matches the 10 supported retailers
+  Scenario: Platform list matches the 9 supported retailers
     When I load the scored platform list
-    Then there should be exactly 10 platforms
-    And the platform list should include "google_books"
+    Then there should be exactly 9 platforms
+    And the platform list should not include "google_books"
     And the platform list should include "open_library"

tests/bdd/steps/platform_steps.py

@@ -69,3 +69,8 @@ def step_platform_count(context, count):
 @then('the platform list should include "{platform_id}"')
 def step_platform_in_list(context, platform_id):
     assert platform_id in context.platform_ids
+
+
+@then('the platform list should not include "{platform_id}"')
+def step_platform_not_in_list(context, platform_id):
+    assert platform_id not in context.platform_ids

tests/unit/test_catalog_hub.py

@@ -15,8 +15,9 @@ from app.services.isbn_catalog import classify_retailer_url, sanitize_platform_u
 
 
 class TestNormalizeSourcePlatform:
-    def test_google_play_maps_to_google_books(self):
-        assert normalize_source_platform("google_play") == "google_books"
+    def test_google_play_not_aliased_to_scored_platform(self):
+        # Google Books is not a scored channel; Play stays as itself.
+        assert normalize_source_platform("google_play") == "google_play"
 
     def test_amazon_unchanged(self):
         assert normalize_source_platform("amazon") == "amazon"
@@ -36,11 +37,11 @@ class TestDiscoverPlatformHit:
         assert hit.confidence == 1.0
         assert hit.listing_url == "https://www.amazon.com/dp/B0DHWS3P6T"
 
-    def test_google_books_api_verified(self):
+    def test_google_books_never_discovered_as_listing(self):
         snap = self._snap(gb_volume_id="abc123", gb_confidence=0.92)
         hit = discover_platform_hit("google_books", snap)
-        assert hit.listing_url == "https://books.google.com/books?id=abc123"
-        assert hit.confidence >= 0.85
+        assert hit.listing_url is None
+        assert hit.confidence == 0.0
 
     def test_open_library_verified(self):
         snap = self._snap(isbn13="9780593128251", ol_confidence=0.90, ol_key="/works/OL123W")

tests/unit/test_platform_presence.py

@@ -298,9 +298,9 @@ async def test_build_catalog_uses_slug_fetch_and_bookshop_isbn():
 
 
 @pytest.mark.asyncio
-async def test_scan_cache_key_busted_for_v13():
+async def test_scan_cache_key_busted_for_v14():
     from app.services.platform_presence import scan_cache_key
-    assert scan_cache_key("https://example.com/book").startswith("platform_scan:v13:")
+    assert scan_cache_key("https://example.com/book").startswith("platform_scan:v14:")
 
 
 @pytest.mark.asyncio
@@ -341,11 +341,12 @@ async def test_scan_mocks_catalog_hub():
             author="Jane Author",
             isbn="9780306406157",
         )
-    assert len(SCORED_PLATFORMS) == 10
+    assert len(SCORED_PLATFORMS) == 9
     verified_ids = {p.platform_id for p in scan.platforms if p.status == "verified"}
-    assert "google_books" in verified_ids
+    assert "google_books" not in verified_ids
     assert "goodreads" in verified_ids
     assert "open_library" in verified_ids
+    assert "google_books" not in {p["platform_id"] for p in SCORED_PLATFORMS}
 
 
 def test_replace_from_scan_defaults_visible_in_widget_false():