MetaHunt/api/core.lua

if not MTH then
	error("MetaHunt core framework missing: api/core-framework.lua must load before api/core.lua")
end

local function MTH_PT_GetGlobal(name)
	if type(getglobal) == "function" then
		return getglobal(name)
	end
	if _G then
		return _G[name]
	end
	return nil
end

local MTH_ItemLinkCache = nil

local function MTH_GetQualityHexColor(quality)
	local q = tonumber(quality)
	if type(GetItemQualityColor) == "function" and q then
		local _, _, _, colorCode = GetItemQualityColor(q)
		if colorCode and colorCode ~= "" then
			local hex = string.gsub(tostring(colorCode), "|c", "")
			hex = string.gsub(hex, "|r", "")
			hex = string.gsub(hex, "^#", "")
			if string.len(hex) == 8 then return hex end
			if string.len(hex) == 6 then return "ff" .. hex end
		end
	end
	return "ffffffff"
end

function MTH_PrimeItemCache(itemId)
	local id = tonumber(itemId)
	if not id or id <= 0 then return false end
	if type(GetItemInfo) == "function" and GetItemInfo(id) then return true end

	if not MTH_ItemLinkCache then
		MTH_ItemLinkCache = CreateFrame("GameTooltip", "MTH_ItemLinkCache", UIParent, "GameTooltipTemplate")
		if not MTH_ItemLinkCache then return false end
		MTH_ItemLinkCache:SetOwner(UIParent, "ANCHOR_NONE")
	end

	MTH_ItemLinkCache:ClearLines()
	MTH_ItemLinkCache:SetHyperlink("item:" .. tostring(id) .. ":0:0:0")
	return type(GetItemInfo) == "function" and (GetItemInfo(id) ~= nil) or false
end

function MTH_GetClickableItemLink(itemId, fallbackName, tryPrimeCache)
	local id = tonumber(itemId)
	if not id then return nil end

	local itemName = nil
	local itemLink = nil
	local itemQuality = nil
	if type(GetItemInfo) == "function" then
		itemName, itemLink, itemQuality = GetItemInfo(id)
		if (not itemName or itemName == "") and tryPrimeCache then
			MTH_PrimeItemCache(id)
			itemName, itemLink, itemQuality = GetItemInfo(id)
		end
	end

	local displayName = tostring(itemName or fallbackName or ("Item " .. tostring(id)))
	local coreLink = nil
	if itemLink and itemLink ~= "" then
		local _, _, parsedCore = string.find(tostring(itemLink), "|H(item:[^|]+)|h")
		if parsedCore and parsedCore ~= "" then
			coreLink = parsedCore
		elseif string.find(tostring(itemLink), "^item:", 1, true) then
			coreLink = tostring(itemLink)
		end
	end
	if not coreLink then
		coreLink = "item:" .. tostring(id) .. ":0:0:0"
	end

	local colorHex = MTH_GetQualityHexColor(itemQuality)
	return "|c" .. tostring(colorHex) .. "|H" .. tostring(coreLink) .. "|h[" .. tostring(displayName) .. "]|h|r"
end

function MTH_InsertLinkToChat(link)
	if type(link) ~= "string" or link == "" then return false end

	local wimEditBox = MTH_PT_GetGlobal("WIM_EditBoxInFocus")
	if wimEditBox and type(wimEditBox.Insert) == "function" then
		wimEditBox:Insert(link)
		return true
	end

	local chatEditBox = MTH_PT_GetGlobal("ChatFrameEditBox")
	if not chatEditBox then return false end

	if type(chatEditBox.IsVisible) == "function" and chatEditBox:IsVisible() and type(chatEditBox.Insert) == "function" then
		chatEditBox:Insert(link)
		return true
	end

	if type(chatEditBox.Show) == "function" then chatEditBox:Show() end
	if type(chatEditBox.Insert) == "function" then
		chatEditBox:Insert(link)
	elseif type(chatEditBox.SetText) == "function" then
		chatEditBox:SetText(link)
		if type(chatEditBox.HighlightText) == "function" then
			chatEditBox:HighlightText()
		end
	end

	return true
end

-- Slash command handler (original, from backup)
MTH:RegisterSlashAliases("MTH")

local function MTH_CommandBook()
	if type(MTH_OpenHunterBook) == "function" then
		MTH_OpenHunterBook()
	elseif type(MTH_ToggleHunterBook) == "function" then
		MTH_ToggleHunterBook()
	else
		MTH:Print("Hunter Book is not available yet")
	end
end

local function MTH_CommandOptions()
	if MTH_OpenOptions then
		MTH_OpenOptions("General")
	else
		MTH:Print("Options window is not available yet")
	end
end

local function MTH_FormatAgeSeconds(seconds)
	local value = tonumber(seconds) or 0
	if value < 0 then value = 0 end
	if value < 60 then
		return tostring(math.floor(value)) .. "s"
	end
	if value < 3600 then
		return tostring(math.floor(value / 60)) .. "m"
	end
	if value < 86400 then
		return tostring(math.floor(value / 3600)) .. "h"
	end
	return tostring(math.floor(value / 86400)) .. "d"
end

local function MTH_CommandPeers()
	if not (MTH and MTH.VersionCheck and type(MTH.VersionCheck.GetTrackedPeers) == "function") then
		MTH:Print("Peer tracker is not available yet")
		return
	end

	local peers = MTH.VersionCheck:GetTrackedPeers()
	local count = table.getn(peers)
	if count <= 0 then
		MTH:Print("No MetaHunt broadcasters seen yet on LFT")
		return
	end

	MTH:Print("MetaHunt broadcasters seen on LFT: " .. tostring(count))
	local now = (type(time) == "function" and time()) or (type(GetTime) == "function" and math.floor(GetTime())) or 0
	local maxRows = math.min(count, 20)
	for i = 1, maxRows do
		local peer = peers[i]
		if type(peer) == "table" then
			local age = MTH_FormatAgeSeconds((now or 0) - (tonumber(peer.lastSeenAt) or 0))
			MTH:Print("- " .. tostring(peer.name or "?") .. " v" .. tostring(peer.versionText or "?") .. " (seen " .. tostring(age) .. " ago)")
		end
	end
	if count > maxRows then
		MTH:Print("... and " .. tostring(count - maxRows) .. " more")
	end
end

local function MTH_CommandPetSpellScanFallback()
	local getSpellName = (type(getglobal) == "function" and getglobal("GetSpellName")) or (_G and _G["GetSpellName"])
	local getSpellTexture = (type(getglobal) == "function" and getglobal("GetSpellTexture")) or (_G and _G["GetSpellTexture"])
	local isPassiveSpell = (type(getglobal) == "function" and getglobal("IsPassiveSpell")) or (_G and _G["IsPassiveSpell"])
	local bookTypePet = (type(getglobal) == "function" and getglobal("BOOKTYPE_PET")) or (_G and _G["BOOKTYPE_PET"])

	local petName = UnitName and UnitName("pet") or nil
	local pets = (type(MTH_PETS_GetRootStore) == "function") and MTH_PETS_GetRootStore() or nil
	local currentPetId = (type(pets) == "table" and type(pets.currentPet) == "table") and pets.currentPet.id or nil

	if type(getSpellName) ~= "function" or not bookTypePet then
		return false, 0
	end

	local rows = {}
	for slot = 1, 200 do
		local name, subText = getSpellName(slot, bookTypePet)
		if not name or name == "" then
			break
		end
		local rankNumber = nil
		if tostring(subText or "") ~= "" then
			local _, _, r = string.find(tostring(subText), "(%d+)")
			rankNumber = tonumber(r)
		end
		if not rankNumber then
			local _, _, r2 = string.find(tostring(name), "(%d+)")
			rankNumber = tonumber(r2)
		end
		local token = string.lower(tostring(name or ""))
		if rankNumber and rankNumber > 0 then
			token = token .. "#" .. tostring(rankNumber)
		end
		table.insert(rows, {
			slot = slot,
			name = tostring(name or ""),
			rank = rankNumber,
			icon = (type(getSpellTexture) == "function") and getSpellTexture(slot, bookTypePet) or nil,
			isPassive = (type(isPassiveSpell) == "function") and (isPassiveSpell(slot, bookTypePet) and true or false) or false,
			token = token,
		})
	end

	local count = table.getn(rows)
	if count > 0 then
		local preview = {}
		local maxPreview = math.min(6, count)
		for i = 1, maxPreview do
			local row = rows[i]
			if type(row) == "table" then
				local line = tostring(row.name or "?")
				local rank = tonumber(row.rank)
				if rank and rank > 0 then
					line = line .. " R" .. tostring(rank)
				end
				table.insert(preview, line)
			end
		end
	end

	if type(MTH_PETS_RecordCurrentPetSpellbookSnapshot) == "function" then
		local persisted, updated = MTH_PETS_RecordCurrentPetSpellbookSnapshot(rows, "petspellscan:core-fallback")
		return true, tonumber(persisted) or count
	else
		return false, count
	end
end

local function MTH_CommandFoodData(limitText)
	if type(FOM_PrintCollectedFoodData) ~= "function" then
		MTH:Print("Food data command is not available yet")
		return
	end
	local trimmed = string.gsub(tostring(limitText or ""), "^%s+", "")
	trimmed = string.gsub(trimmed, "%s+$", "")
	if string.lower(trimmed) == "purge" then
		if type(FOM_PruneCollectedFoodData) ~= "function" then
			MTH:Print("Food data purge is not available yet")
			return
		end
		local removed = tonumber(FOM_PruneCollectedFoodData()) or 0
		MTH:Print("Food data purge removed rows: " .. tostring(removed))
		return
	end
	if trimmed == "" then
		FOM_PrintCollectedFoodData(nil)
		return
	end
	local limit = tonumber(trimmed)
	if not limit then
		MTH:Print("Usage: /mth food [limit|purge]")
		return
	end
	FOM_PrintCollectedFoodData(limit)
end

if type(MTH_PS_ScanNow) ~= "function" then
	function MTH_PS_ScanNow(trigger)
		local ok, count = MTH_CommandPetSpellScanFallback()
		return ok and true or false, tonumber(count) or 0, false
	end
end

if type(MTH_PSP_RequestScan) ~= "function" then
	local mthPsFallbackLastScan = 0
	function MTH_PSP_RequestScan(trigger, minIntervalSeconds)
		local now = tonumber(time()) or 0
		local minInterval = tonumber(minIntervalSeconds) or 1
		local triggerText = tostring(trigger or "request")
		if minInterval > 0 and (now - mthPsFallbackLastScan) < minInterval then
			return false
		end
		local ok = MTH_PS_ScanNow(triggerText)
		if ok then
			mthPsFallbackLastScan = now
		end
		return ok and true or false
	end
end

if type(MTH_CommandPetSpellScan) ~= "function" then
	function MTH_CommandPetSpellScan()
		local ok, count = MTH_PS_ScanNow("manual-core-fallback")
		if not (MTH and MTH.IsMessageEnabled) or MTH:IsMessageEnabled("spellbookScan", false) then
			MTH:Print("Pet spellbook scan: " .. tostring(count or 0) .. " spell(s). ok=" .. tostring(ok and true or false))
		end
	end
end

function SlashCmdList.MTH(msg, editbox)
	if MTH and MTH.ApplyClassGate and MTH:ApplyClassGate("slash") then
		return
	end

	msg = msg or ""
	msg = string.gsub(tostring(msg), "^%s+", "")
	msg = string.gsub(msg, "%s+$", "")
	local lowerMsg = string.lower(msg)
	local _, _, lowerCmd, lowerArg = string.find(lowerMsg, "^(%S+)%s*(.-)%s*$")
	if msg == "" then
		MTH:Print("Available: /mth options, /mth book, /mth food")
	elseif lowerMsg == "err" or lowerMsg == "errors" or lowerMsg == "debug" then
		if MTH_DebugFrame and MTH_DebugFrame.Toggle then
			MTH_DebugFrame:Toggle()
		else
			MTH:Print("Debug frame is not available.")
		end
	elseif lowerMsg == "options" then
		MTH_CommandOptions()
	elseif lowerMsg == "book" or lowerMsg == "hunterbook" then
		MTH_CommandBook()
	elseif lowerMsg == "peers" or lowerMsg == "who" then
		MTH_CommandPeers()
	elseif lowerCmd == "trainscan" or lowerCmd == "petscan" then
		if type(MTH_CommandTrainScan) == "function" then
			MTH_CommandTrainScan()
		else
			MTH:Print("Train scan is not available.")
		end
	elseif lowerCmd == "fx" or lowerCmd == "fireworks" or lowerCmd == "celebrate" then
		-- TEMP: preview the pet-ability celebration effect.
		if type(MTH_Celebrate) == "function" then
			local label = msg
			local _, _, rest = string.find(msg, "^%S+%s+(.-)%s*$")
			if rest and rest ~= "" then
				MTH_Celebrate("New Pet Ability!", rest)
			else
				MTH_Celebrate("New Pet Ability!", "Growl (Rank 3)")
			end
		else
			-- Self-diagnosing: report which piece failed to load so we can tell
			-- a stale UI from a genuine load error.
			MTH:Print("Celebration effect is not available. Diagnostics:")
			MTH:Print("  PizzaSauce global: " .. type(PizzaSauce))
			MTH:Print("  MTH_Celebrate: " .. type(MTH_Celebrate))
			MTH:Print("  MTH_FX_IsEnabled: " .. type(MTH_FX_IsEnabled))
			MTH:Print("  MTH_SetupAnimationsOptions: " .. type(MTH_SetupAnimationsOptions))
			MTH:Print("  -> If these are 'nil', do /reload (your UI is running code from before the feature was added).")
		end
	elseif lowerCmd == "fxdebug" then
		-- TEMP: dump the animation load-path tracers so we can see exactly where
		-- fx-celebrate.lua / options-animations.lua aborted at load time.
		MTH:Print("=== MetaHunt animation load debug ===")
		MTH:Print("Globals: PizzaSauce=" .. type(PizzaSauce)
			.. " CreateFrame=" .. type(CreateFrame)
			.. " MTH=" .. type(MTH))
		if type(MTH_FX_DBG) == "table" then
			MTH:Print("fx-celebrate: step=" .. tostring(MTH_FX_DBG.step)
				.. " sauceType=" .. tostring(MTH_FX_DBG.sauceType)
				.. " registerOk=" .. tostring(MTH_FX_DBG.registerOk)
				.. " registerSkipped=" .. tostring(MTH_FX_DBG.registerSkipped))
			if MTH_FX_DBG.registerErr ~= nil then
				MTH:Print("fx-celebrate: registerErr=" .. tostring(MTH_FX_DBG.registerErr))
			end
			MTH:Print("fx-celebrate: hasCelebrate=" .. tostring(MTH_FX_DBG.hasCelebrate)
				.. " hasIsEnabled=" .. tostring(MTH_FX_DBG.hasIsEnabled)
				.. " hasAnimEnabled=" .. tostring(MTH_FX_DBG.hasAnimEnabled))
		else
			MTH:Print("fx-celebrate: MTH_FX_DBG is " .. type(MTH_FX_DBG) .. " (file did not reach its first line)")
		end
		if type(MTH_ANIM_DBG) == "table" then
			MTH:Print("options-animations: step=" .. tostring(MTH_ANIM_DBG.step)
				.. " ready=" .. tostring(MTH_ANIM_DBG.ready)
				.. " hasSetup=" .. tostring(MTH_ANIM_DBG.hasSetup))
			MTH:Print("options-animations: req=" .. tostring(MTH_ANIM_DBG.reqType)
				.. " getFrame=" .. tostring(MTH_ANIM_DBG.getFrameType)
				.. " clear=" .. tostring(MTH_ANIM_DBG.clearType)
				.. " checkbox=" .. tostring(MTH_ANIM_DBG.checkboxType))
			MTH:Print("options-animations: setupCalled=" .. tostring(MTH_ANIM_DBG.setupCalled)
				.. " setupResult=" .. tostring(MTH_ANIM_DBG.setupResult)
				.. " containerType=" .. tostring(MTH_ANIM_DBG.containerType)
				.. " fxEnabledType=" .. tostring(MTH_ANIM_DBG.fxEnabledType))
		else
			MTH:Print("options-animations: MTH_ANIM_DBG is " .. type(MTH_ANIM_DBG) .. " (file did not reach its first line)")
		end
		MTH:Print("=== end animation load debug ===")
	elseif lowerMsg == "zoneinfo" then
		-- Dumps all available zone data for the current zone, for adding to ds-zones / ds-minimap-sizes
		pcall(SetMapToCurrentZone)
		local zoneName    = (type(GetRealZoneText) == "function" and GetRealZoneText()) or ""
		local subZone     = (type(GetSubZoneText)  == "function" and GetSubZoneText())  or ""
		local zoneText    = (type(GetZoneText)      == "function" and GetZoneText())     or ""
		local areaId      = nil
		if type(GetCurrentMapAreaID) == "function" then
			local ok, v = pcall(GetCurrentMapAreaID)
			if ok then areaId = v end
		end
		local cx, cy = nil, nil
		if type(GetPlayerMapPosition) == "function" then
			local ok, x, y = pcall(GetPlayerMapPosition, "player")
			if ok then cx, cy = x, y end
		end
		local contId = nil
		if type(GetCurrentMapContinent) == "function" then
			local ok, v = pcall(GetCurrentMapContinent)
			if ok then contId = v end
		end
		MTH:Print("|cffffff00=== Zone Info ===|r")
		MTH:Print("GetRealZoneText: |cffffaa00" .. tostring(zoneName) .. "|r")
		MTH:Print("GetZoneText:     |cffffaa00" .. tostring(zoneText) .. "|r")
		MTH:Print("GetSubZoneText:  |cffffaa00" .. tostring(subZone) .. "|r")
		MTH:Print("AreaID (GetCurrentMapAreaID): |cff88ffff" .. tostring(areaId) .. "|r")
		MTH:Print("ContinentID: |cff88ffff" .. tostring(contId) .. "|r")
		if cx and cy then
			MTH:Print(string.format("Player map pos: |cff88ffff%.4f, %.4f|r  (display: %.1f, %.1f)", cx, cy, cx*100, cy*100))
		end
		-- Also check if zone is in our tables
		local inZones = MTH_DS_Zones and MTH_DS_Zones[tonumber(areaId)] and "YES" or "not in MTH_DS_Zones"
		local inSizes = MTH_DS_MinimapSizes and MTH_DS_MinimapSizes[tonumber(areaId)] and "YES" or "not in ds-minimap-sizes"
		MTH:Print("MTH_DS_Zones entry:        " .. inZones)
		MTH:Print("MTH_DS_MinimapSizes entry: " .. inSizes)
	elseif lowerMsg == "npcid" then
		-- Print the creature entry ID of the current target, or arm a listener for next NPC interaction
		local function MTH_ParseCreatureEntryFromAnyGuid(guid)
			if type(guid) ~= "string" or guid == "" then return nil end
			-- Format 1: TBC-style "Creature-realm-map-inst-?-ENTRY-spawn"
			local _, _, id1 = string.find(guid, "^Creature%-%d+%-%d+%-%d+%-%d+%-(%d+)%-%d+$")
			if id1 then return tonumber(id1) end
			-- Format 2: vanilla hex "0xF130EEEEEECCCCCC" — entry is bits 24-47 = hex chars 7-12
			if string.sub(guid, 1, 2) == "0x" and string.len(guid) >= 14 then
				local entryHex = string.sub(guid, 7, 12)  -- 24 bits = up to 16M
				local parsed = tonumber(entryHex, 16)
				if parsed and parsed > 0 then return parsed end
			end
			return nil
		end

		local function MTH_PrintNpcId(unitToken)
			unitToken = unitToken or "target"
			local name  = (type(UnitName)  == "function") and UnitName(unitToken)  or "?"
			local level = (type(UnitLevel) == "function") and UnitLevel(unitToken) or "?"
			-- Try UnitGUID first, then GetUnitGUID (TurtleWoW nameplate API)
			local guid = nil
			if type(UnitGUID) == "function" then
				local ok, g = pcall(UnitGUID, unitToken)
				if ok and g and g ~= "" then guid = g end
			end
			if (not guid or guid == "") and type(GetUnitGUID) == "function" then
				local ok, g = pcall(GetUnitGUID, unitToken)
				if ok and g and g ~= "" then guid = g end
			end
			local creatureId = MTH_ParseCreatureEntryFromAnyGuid(guid)
			if creatureId then
				MTH:Print(string.format("|cffffff00NPC:|r %s  |cffffff00ID:|r |cff88ffff%s|r  lvl: %s", tostring(name), tostring(creatureId), tostring(level)))
			else
				MTH:Print(string.format("|cffffff00NPC:|r %s  lvl: %s  |cffff8800GUID: %s|r", tostring(name), tostring(level), tostring(guid or "nil")))
				MTH:Print("|cffaaaaaa(Could not parse creature ID from GUID)|r")
			end
		end

		-- Try current target first
		local hasTarget = (type(UnitExists) == "function") and UnitExists("target")
		if hasTarget then
			MTH_PrintNpcId("target")
		end

		-- Arm a one-shot frame for MERCHANT_SHOW / TRAINER_LIST_UPDATE / GOSSIP_SHOW
		if not _G["MTH_NpcIdListenerFrame"] then
			local f = CreateFrame("Frame", "MTH_NpcIdListenerFrame")
			f:RegisterEvent("MERCHANT_SHOW")
			f:RegisterEvent("TRAINER_LIST_UPDATE")
			f:RegisterEvent("GOSSIP_SHOW")
			f:SetScript("OnEvent", function()
				MTH_PrintNpcId("target")
				this:UnregisterEvent("MERCHANT_SHOW")
				this:UnregisterEvent("TRAINER_LIST_UPDATE")
				this:UnregisterEvent("GOSSIP_SHOW")
				_G["MTH_NpcIdListenerFrame"] = nil
			end)
			if not hasTarget then
				MTH:Print("|cffaaffaaArmed.|r Open any vendor, trainer, or stable master to capture their ID.")
			end
		end
	elseif lowerCmd == "dev" then
		if lowerArg == "petmigrate" then
			if type(MTH_CommandPetsMigrate) == "function" then
				MTH_CommandPetsMigrate()
			else
				MTH:Print("Pet migration command unavailable.")
			end
		else
			MTH:Print("Dev commands: /mth dev petmigrate")
		end
	elseif lowerCmd == "food" then
		local sub = lowerArg
		local function MTH_FoodItemLabel(itemId)
			local id = tonumber(itemId)
			if not id then return tostring(itemId) end
			if type(GetItemInfo) == "function" then
				local name = GetItemInfo(id)
				if name and name ~= "" then
					return "|cffffcc00" .. name .. "|r |cffaaaaaa(" .. id .. ")|r"
				end
			end
			return "|cffaaaaaa" .. tostring(id) .. "|r"
		end
		if sub == "" or sub == "status" then
			-- Show quarantine and exception state
			local feedStore = type(MTH_CharSavedVariables) == "table" and MTH_CharSavedVariables.feedTracking or nil
			local quarantine = feedStore and feedStore.fomQuarantine and feedStore.fomQuarantine.byFamily or nil
			local exceptions = feedStore and feedStore.exceptions and feedStore.exceptions.byItemId or nil
			MTH:Print("|cffffff00=== Feed-O-Matic Status ===|r")
			-- Quarantine
			local qCount = 0
			if type(quarantine) == "table" then
				for family, byItem in pairs(quarantine) do
					if type(byItem) == "table" then
						for itemId, _ in pairs(byItem) do
							qCount = qCount + 1
							MTH:Print("  |cffff8800Quarantine:|r " .. MTH_FoodItemLabel(itemId) .. " (family=" .. tostring(family) .. ")")
						end
					end
				end
			end
			if qCount == 0 then MTH:Print("  Quarantine: |cff00ff00empty|r") end
			-- Core exceptions
			local eCount = 0
			if type(exceptions) == "table" then
				for itemId, _ in pairs(exceptions) do
					if type(itemId) == "number" then  -- skip string-key dupes
						eCount = eCount + 1
						MTH:Print("  |cffff4444Exception block:|r " .. MTH_FoodItemLabel(itemId))
					end
				end
			end
			if eCount == 0 then MTH:Print("  Exception blocks: |cff00ff00none|r") end
			-- FOM_RemovedFoods
			local rCount = 0
			if type(FOM_RemovedFoods) == "table" then
				for diet, list in pairs(FOM_RemovedFoods) do
					if type(list) == "table" then
						for _, itemId in ipairs(list) do
							rCount = rCount + 1
							MTH:Print("  |cffaaaaaaRemoved food:|r " .. MTH_FoodItemLabel(itemId) .. " (diet=" .. tostring(diet) .. ")")
						end
					end
				end
			end
			if rCount == 0 then MTH:Print("  Removed foods: |cff00ff00none|r") end
			MTH:Print("|cffaaaaaa/mth food unban <id>|r — unban one item   |cffaaaaaa/mth food reset|r — clear all bans")
		elseif string.find(sub, "^unban%s") or sub == "unban" then
			local _, _, itemArg = string.find(lowerArg, "^unban%s+(%S+)")
			local itemId = tonumber(itemArg)
			if not itemId then
				MTH:Print("|cffff4444Usage:|r /mth food unban <itemId>")
				MTH:Print("Example: /mth food unban 8952")
			elseif type(FOM_ClearItemBans) ~= "function" then
				MTH:Print("|cffff4444Error:|r Feed-O-Matic not loaded.")
			else
				local label = MTH_FoodItemLabel(itemId)
				FOM_ClearItemBans(itemId)
				MTH:Print("|cff00ff00Unbanned " .. label .. "|r — removed from quarantine, exceptions and removed-foods list.")
			end
		elseif sub == "reset" then
			local feedStore = type(MTH_CharSavedVariables) == "table" and MTH_CharSavedVariables.feedTracking or nil
			if feedStore then
				if feedStore.fomQuarantine then feedStore.fomQuarantine = { byFamily = {} } end
				if feedStore.exceptions then feedStore.exceptions = { byItemId = {} } end
			end
			if type(FOM_RemovedFoods) == "table" then
				for diet, _ in pairs(FOM_RemovedFoods) do FOM_RemovedFoods[diet] = {} end
			end
			if type(FOM_FEED_SCAN_CACHE) ~= "nil" then FOM_FEED_SCAN_CACHE = nil end
			MTH:Print("|cff00ff00All Feed-O-Matic bans and quarantines cleared.|r")
		else
			MTH:Print("|cffffff00/mth food|r — show quarantine/ban status")
			MTH:Print("|cffffff00/mth food unban <itemId>|r — remove one item from all bans")
			MTH:Print("|cffffff00/mth food reset|r — clear ALL bans and quarantines")
		end
	elseif lowerCmd == "zbar" and lowerArg == "debug" then
		-- Dump the live state of every zBar button to chat so we can see which one is the ghost.
		local p = function(s) MTH:Print("[zBar] " .. tostring(s), "debug") end
		local root = (type(MTH_ZH_GetSavedRoot) == "function") and MTH_ZH_GetSavedRoot() or ZHunterMod_Saved
		local zs   = root and root["_zbar"]
		p("=== zBar debug ===")
		p("enabled=" .. tostring(zs and zs.enabled) .. "  anchor=" .. tostring(getglobal("MTH_ZBar_Anchor") ~= nil))
		p("direction=" .. tostring(zs and zs.direction) .. "  childexpand=" .. tostring(zs and zs.childexpand) .. "  childarrange=" .. tostring(zs and zs.childarrange))
		local allButtons = {
			"zButtonAspect","zButtonAmmo","zButtonTrack","zButtonTrap",
			"zButtonPet","zButtonRanged","zButtonMounts","zButtonCompanions","zButtonToys",
		}
		for _, bname in ipairs(allButtons) do
			local btn = getglobal(bname)
			local shown   = btn and btn.IsShown and btn:IsShown()
			local bsaved  = root and type(root[bname]) == "table" and root[bname]
			local enabled = bsaved and bsaved["enabled"]
			local zvis    = zs and zs.visible and zs.visible[bname]
			local x, y, point = "?", "?", "?"
			if btn and btn.GetPoint then
				local pt, _, _, bx, by = btn:GetPoint()
				point = tostring(pt)
				x = tostring(bx and math.floor(bx + 0.5) or "?")
				y = tostring(by and math.floor(by + 0.5) or "?")
			end
			local bmtname = btn and tostring(btn.name) or "nil"
			p(bname .. ":  shown=" .. tostring(shown) ..
				"  enabled=" .. tostring(enabled) ..
				"  zbarVisible=" .. tostring(zvis) ..
				"  btn.name=" .. bmtname ..
				"  anchor=(" .. point .. " " .. x .. "," .. y .. ")")
		end
		p("=== end ===")
	else
		MTH:Print("Unknown command: " .. tostring(msg))
		MTH:Print("Available: /mth options, /mth book, /mth npcid, /mth food")
	end
end

-- Initialize on load
MTH:InitSavedVariables()
if type(MTH_ST_InitBootstrap) == "function" then
	MTH_ST_InitBootstrap()
end
if type(MTH_TR_InitBootstrap) == "function" then
	MTH_TR_InitBootstrap()
elseif type(MTH_PT_InitBootstrap) == "function" then
	MTH_PT_InitBootstrap()
end
if type(MTH_PS_InitService) == "function" then
	MTH_PS_InitService()
end