Resolve degrades gracefully when BGG_API_TOKEN is missing

A 401 on an uncached title no longer aborts the run: cached titles
resolve and save, blocked titles are listed with registration/token
instructions and left out of matches.csv so a future run picks them
up untouched. Supports the take-photos-now, resolve-later workflow.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

tests/test_resolve.py

@@ -294,3 +294,52 @@ def test_wrong_year_hint_never_drives_a_version(client):
     assert (row.match_status, row.bgg_id) == ("auto", 2529)
     assert row.version_status == "version_unknown"
     assert row.version_id is None
+
+
+# -- graceful degradation without a BGG token ---------------------------
+
+
+def test_run_resolve_saves_progress_when_token_missing(tmp_path):
+    """Cached titles resolve; uncached ones wait for the token instead of
+    crashing the run and losing everything."""
+    import shutil as _shutil
+
+    partial_cache = tmp_path / "cache"
+    partial_cache.mkdir()
+    for f in FIXTURES.glob("search_query=Catan-*"):
+        _shutil.copy(f, partial_cache / f.name)
+
+    data_dir = tmp_path / "data"
+    data_dir.mkdir()
+    (data_dir / "titles.json").write_text(
+        json.dumps(
+            [
+                {"title_raw": "Catan", "source_photos": ["a.jpg"]},
+                {"title_raw": "Wingspan", "source_photos": ["a.jpg"]},
+            ]
+        )
+    )
+    cfg = Config(data_dir=data_dir)
+    unauthorized = BGGClient(
+        cache_dir=partial_cache,
+        transport=httpx.MockTransport(
+            lambda req: httpx.Response(401, text="Unauthorized")
+        ),
+    )
+
+    rows = run_resolve(cfg, client=unauthorized)
+    assert [r.title_raw for r in rows] == ["Catan"]  # cached one made it
+
+    with cfg.matches_path.open(newline="") as f:
+        saved = list(csv.DictReader(f))
+    assert len(saved) == 1  # blocked title left for a future run
+
+    # future run (fixtures now "recorded"): picks up only the blocked title
+    full = BGGClient(
+        cache_dir=FIXTURES,
+        transport=httpx.MockTransport(
+            lambda req: (_ for _ in ()).throw(AssertionError("network"))
+        ),
+    )
+    rows2 = run_resolve(cfg, client=full)
+    assert [r.title_raw for r in rows2] == ["Wingspan"]