M5: farm-source for recommended sets (close the gear loop)

The build recommender now lists WHERE to farm each recommended artifact set,
joining the set->drop-region tables (drops.json) with the set id<->name map
(artifact_sets.json). "needs Speed set" -> "Dragon's Lair"; "Offense" ->
"Ice Golem Peak". recommend_sets now returns internal codes (mapped to UI
names + drop lookup at display); only sets dropping in a named dungeon are
listed as farmable. Wired into m5_recommender --builds.

Closes the recommender loop: team -> per-hero build (masteries/sets/blessing/
stats/readiness) -> where to farm the gear.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: SnoopLawg

docs/m5_recommender_guide.md

@@ -53,7 +53,9 @@ Maps the hero's game-truth kit → relevant masteries (filtered to the location)
 artifact sets, blessing, and stat focus — and checks the user's **actual ACC**
 against the floor (`[READY: you have 423]` / `[GAP: need +M]`). Set bonuses are
 game-truth (`artifact_sets.json`); the role→set mapping is heuristic. Set names
-are shown in UI form (internal `CriticalDamage` → "Savage/Cruel").
+are shown in UI form (internal `CriticalDamage` → "Savage/Cruel"). It also lists
+**where to farm** each recommended set, joining the set→drop-region tables
+(`drops.json`) so "needs Speed set" → "farm Dragon's Lair".
 
 ### What to pull / build next
 ```bash

tools/m5_build_recommender.py

@@ -243,15 +243,63 @@ def recommend_sets(hero: dict, location: str, valid_sets: set) -> list:
     if location in ("arena", "tt"):
         picks = ["AttackSpeed", "CriticalDamage", "CriticalChance"] + picks
     # Dedup preserving order, keep only sets that exist in game data.
+    # Returns INTERNAL codes (callers map to UI via SET_UI_NAME for display
+    # and pass codes to recommend_farm for the drop-location lookup).
     seen, out = set(), []
     for s in picks:
         if s in seen or s not in valid_sets:
             continue
         seen.add(s)
-        out.append(SET_UI_NAME.get(s, s))
+        out.append(s)
     return out[:5]
 
 
+# Region code -> readable farm location (named dungeons; RegionN = campaign).
+FARM_REGION_NAME = {
+    "DragonsLair": "Dragon's Lair", "IceGolemCave": "Ice Golem Peak",
+    "FireGolemCave": "Fire Knight Castle", "SpiderCave": "Spider's Den",
+    "MinotaurLabyrinth": "Minotaur", "EventDungeon": "Event Dungeon",
+}
+
+
+def _set_drop_regions() -> dict:
+    """internal set name -> sorted list of readable drop locations (named
+    dungeons first; campaign RegionN bucketed as 'Campaign')."""
+    af = json.loads((STATIC / "artifact_sets.json").read_text(encoding="utf-8"))
+    arows = next((v for k, v in af.items() if k != "_meta" and isinstance(v, list)), [])
+    id_to_name = {r["id"]: r["set"] for r in arows}
+    name_to_id = {r["set"]: r["id"] for r in arows}
+    drops = json.loads((STATIC / "drops.json").read_text(encoding="utf-8")).get("regions", {})
+    from collections import defaultdict
+    id_to_regions = defaultdict(set)
+    for rname, info in drops.items():
+        for diff in info.get("by_difficulty", []):
+            for sid in (diff.get("set_drops") or {}).keys():
+                id_to_regions[int(sid)].add(rname)
+    out = {}
+    for sname, sid in name_to_id.items():
+        locs = []
+        for r in sorted(id_to_regions.get(sid, [])):
+            if r in FARM_REGION_NAME:
+                locs.append(FARM_REGION_NAME[r])
+            elif "Campaign" not in locs:
+                locs.append("Campaign")
+        out[sname] = locs
+    return out
+
+
+def recommend_farm(rec_set_internal: list, drop_map: dict) -> list:
+    """Given recommended internal set codes, return 'Set -> location(s)' lines.
+    Only sets that drop in a named dungeon are actionable to farm."""
+    lines = []
+    for code in rec_set_internal:
+        locs = [l for l in drop_map.get(code, []) if l != "Campaign"]
+        if locs:
+            ui = SET_UI_NAME.get(code, code)
+            lines.append(f"{ui}: {', '.join(locs)}")
+    return lines
+
+
 def recommend_blessing(hero: dict, location: str, brel: list) -> list:
     provides = set(hero.get("provides", []))
     role = hero.get("synergy_role", "")
@@ -335,7 +383,13 @@ def main() -> None:
             print(f"    {tree}: {names}")
     print()
     sets = recommend_sets(hero, args.location, _load_valid_sets())
-    print(f"  Artifact sets (role-fit): {', '.join(sets) if sets else '(role-standard)'}")
+    sets_ui = [SET_UI_NAME.get(s, s) for s in sets]
+    print(f"  Artifact sets (role-fit): {', '.join(sets_ui) if sets_ui else '(role-standard)'}")
+    farm = recommend_farm(sets, _set_drop_regions())
+    if farm:
+        print("  Farm sets from:")
+        for f in farm:
+            print(f"    - {f}")
     print()
     bl = recommend_blessing(hero, args.location, brel)
     print(f"  Blessing (relevant + role-fit): {', '.join(bl) if bl else '(role-standard)'}")

tools/m5_recommender.py

@@ -356,9 +356,10 @@ def main() -> None:
                 f"{t}: {', '.join(p['name'] for p in by_tree[t])}"
                 for t in ("Attack", "Defence", "Support") if by_tree.get(t))
             sets = brmod.recommend_sets(hero, args.location, valid_sets)
+            sets_ui = [brmod.SET_UI_NAME.get(s, s) for s in sets]
             print(f"\n  {name}:")
             print(f"    masteries: {masts}")
-            print(f"    sets:      {', '.join(sets) if sets else '(role-standard)'}")
+            print(f"    sets:      {', '.join(sets_ui) if sets_ui else '(role-standard)'}")
             print(f"    blessing:  {', '.join(bl) if bl else '(role-standard)'}")
             for s in brmod.recommend_stats(hero, args.location, computed):
                 print(f"    stat: {s}")