===============================================================================
Vamoose's Housing Decor Crafting Helper - Version 1.8.0
===============================================================================

MAJOR NEW FEATURES
==================

Material Source Categorization - NOW WORKING!
---------------------------------------------
* NEW: ReagentSources.lua database with 337 reagents categorized
* Materials now properly grouped into:
  - To Buy (30 vendor items: vials, threads, dyes, flux, etc.)
  - To Gather (170 items: herbs, ore, cloth, leather, gems, etc.)
  - To Craft (128 items: bars, bolts, lumber, engineering parts, etc.)
* No more "Unknown" category for common materials!

Dynamic Recipe Knowledge Detection
----------------------------------
* Recipe "known" status now detected via C_TradeSkillUI at runtime
* No longer relies on spellID in database (Blizzard API doesn't provide these)
* Gold highlighting for known recipes works correctly
* Cache rebuilds automatically when you learn new recipes

Material Tooltip Enhancement
----------------------------
* Hovering over materials shows which shopping list recipes need them
* Displays recipe name with quantity if multiple (e.g., "Stoppered Black Potion (x2)")
* Shows amount needed from each recipe
* Works for materials shared across multiple recipes

Auctionator Shopping List Integration
-------------------------------------
* Shift-click materials to add to Auctionator "Housing Materials" list
* Accumulates items (doesn't overwrite like search)
* Falls back to AH search if Auctionator not installed
* TSM search supported as secondary fallback

Database Migration System
-------------------------
* Automatic migration when database version changes
* Shopping list items updated to match new database format
* Preserves your quantities and selections
* Shows "Migrated X items" message on upgrade


UI IMPROVEMENTS
===============

* Tooltips show context-aware shift-click behavior
* Material tooltips now show "Needed for:" section with recipe breakdown
* Shopping list items retain correct reagent data after migration


TECHNICAL IMPROVEMENTS
======================

New File: ReagentSources.lua
----------------------------
* Separate database for reagent categorization
* 337 reagents mapped to Vendor/Gathering/Crafted sources
* Generated from HouseDecorDB.lua analysis
* Easy to update without touching main addon

Architecture Changes
--------------------
* PlayerKnowsRecipe() now takes recipe NAME, not spellID
* BuildKnownRecipeCache() queries C_TradeSkillUI.GetAllRecipeIDs()
* Only caches recipes where recipeInfo.learned == true
* Cache invalidates on TRADE_SKILL_LIST_UPDATE and NEW_RECIPE_LEARNED events
* AggregateMaterials() tracks recipe details per reagent for tooltips

Database Version System
-----------------------
* DB_VERSION = 3 (triggers migration from v1.6/v1.7)
* Migration matches recipes by name, updates itemID/reagents
* Reagent sources looked up from ReagentSources table during migration


BUG FIXES
=========

* FIXED: All materials showing under "Unknown/Other" category
* FIXED: Recipe gold highlighting not working (was using wrong spellID)
* FIXED: Unlearned recipes incorrectly marked as known
* FIXED: Shopping list reagents missing source field after migration


FILE CHANGES
============

* HousingDecorGuide.lua: ~3,720 lines (up from 3,539)
* HousingDecorGuide.toc: Updated to v1.8.0, added ReagentSources.lua
* ReagentSources.lua: NEW - 350 lines, reagent categorization
* HouseDecorDB.lua: No changes required (spellID no longer used for knowledge)


UPGRADE NOTES
=============

* NEW FILE: Copy ReagentSources.lua to your addon folder
* Migration runs automatically on first load
* You'll see "Migrated X shopping list items" message
* Existing shopping lists are preserved and updated
* To force re-migration: /run HDG_Settings.dbVersion = 0 ReloadUI()


KNOWN LIMITATIONS
=================

* Recipe knowledge requires opening profession window at least once per session
* Some very new or obscure reagents may still show as "Unknown"


===============================================================================
For bug reports and feature requests, please visit:
https://www.curseforge.com/wow/addons/housing-decor-crafting-helper
===============================================================================
