ItemFYI

# Changelog

## 0.2.44

- Added an **ItemFYI: Use current item** keybinding in its own ItemFYI section
  under Options → Keybindings, easy to find by searching for "ItemFYI". The bound key is shown on the button, in its tooltip, and in
  settings, and keeps every mouse-click safety check. Alt-modified bindings
  work too; Alt only starts a drag when the cursor is over the button.
- Added **Only show battle pets you don't own yet**. Pet reminders now say how
  many of the species you own, for example "Battle pet (1/3 owned)".
- Used the client's translated text for "Already known", "Locked",
  right-click-to-open, quest starters, the "Use:" prefix, and red level,
  skill, class, race, and reputation requirements, improving non-English
  clients. Red race requirements now hide items on English clients too.
- The settings **Rescan bags** button now clears session skips like
  `/ifyi scan`, and runs immediately during the login delay.
- `/ifyi unignore` now says when a key is not on the ignore list instead of
  reporting that it was restored.

## 0.2.43

- Keep scanning after an unexpected error in one inventory work tick, instead
  of stalling all reminders until the next reload. The error is still reported.
- Stop a scan timer queued just before a tooltip retry from starting a second,
  parallel work chain that doubled per-frame work during login scans.
- Drop recipes learned from a trainer or another copy as soon as they are
  learned, refreshing only recipe tooltips.
- Only treat a box as locked when its tooltip has Blizzard's own "Locked" status
  line, so items that mention "locked" in their name or flavour text still show.

## 0.2.42

- Recognize Hallow's End bags whose Use line does not say "open". Handful of
  Treats says "Claim your treats", and the pumpkins, Crudely Wrapped Gift, and
  old Treat Bag only say "Right Click to Open".

## 0.2.41

- Recognize explicit House Chest decor deposits even when the generic item
  usability check reports false, including additional copies of learned decor.
  Unmet tooltip requirements still prevent reminders.

## 0.2.40

- Target the displayed pet cage when learning a pet, with combat and
  inventory-interaction safeguards.
- Keep bank updates out of carried-item counts and remove outside-bag entries
  during a full rescan.
- Honor red tooltip requirements on mounts, toys, pets, companions, and Curios;
  refresh eligibility when character requirements change.
- Read the runtime version from addon metadata. Add a matching-tag helper and
  CI checks for the TOC version, release tag, and latest changelog release.
- Document English tooltip coverage and update the CI checkout action.

## 0.2.39

- Stop showing Ancient Hash'ey Battle Arts glove enhancements. These are
  repeatable enchants rather than collection unlocks. Permanent Labyrinth
  Loa power unlocks remain supported.

## 0.2.38

- Recognize stack conversions using "to obtain", including Heroic Soul
  Fragments once at least three are in your bags.
- Recognize Pepe costume unlocks, including A Tiny Explorer's Hat, when the
  usable-item API reports false. Already-known costumes and unmet tooltip
  requirements remain hidden, without additional inventory scanning.

## 0.2.37

- Recognize permanent Loa power consumables and Ancient Hash'ey glove
  enhancements from the Labyrinth of Kindo'jan using their tooltip actions
  rather than item-specific IDs, without extra inventory scanning.

## 0.2.36

- Fixed Companion Curios whose collection Use: action arrives after the rest
  of their tooltip. Combat and Utility Curios now receive bounded follow-up
  reads instead of being cached as non-actionable, without retrying ordinary
  multiline item tooltips.
- Added regression coverage for partially loaded and already-known Curios.

## 0.2.35

- Updated the Retail TOC interface version to 12.1.5 (`120105`).
  No addon functionality has changed in this release.

## 0.2.34

- Automatically refresh quest-starter FYIs on quest acceptance and abandonment
  even when the item stays in the same bag slot. Re-evaluate only remembered
  starters and their tooltips; no full inventory scan is needed.
- Limit retries for unresolved name-only tooltips to two follow-up reads instead
  of four. Completely empty or failed tooltip reads retain their existing
  recovery limit, and delayed actionable Curios remain eligible for retries.

- Recognized Draenor consumables with a `Use: Gain N Garrison Resources`
  tooltip (including Pile of Frostfire Turnips and Icemother Milk) as
  actionable progression items, without adding item-specific rules.

- Reduced reload/login frame hitches by time-slicing bag-slot indexing as
  well as tooltip classification, removing repeated queue compaction and
  front-of-queue shifts, and rebuilding the notification list only after a
  scan batch finishes.
- Retained fresh cross-bag stack totals before classifying and safely revisited
  bags that changed midway through a sliced scan.
- Deferred automatic login scans until the UI has settled, then paced startup
  tooltip reads to one item every 40ms. Manual scans remain immediate.
- Added `/ifyi perf` to report scan progress, tooltip reads, retries, and
  peak work-tick time when diagnosing reload frame hitches.
- Added `/ifyi perfitems` to identify the remaining items with incomplete
  tooltips, including item ID, bag/slot, read attempts, and sampled text,
  without rescanning the inventory.
- Stopped treating every normal item without a Use: line as incomplete. Fully
  populated crafting-reagent and equipment tooltips are cached after one read
  instead of receiving repeated scheduled retries, while short/name-only
  tooltips still retry for late-arriving Curio and similar Use: lines.
- Recognized all eight Ahn'Qiraj scarabs (20858–20865) and Dark Iron
  Residue (18945) as inert name-only turn-in materials, eliminating four
  unnecessary delayed tooltip retries per item without skipping legitimate
  incomplete learnable tooltips.

## 0.2.33

- Detected loot-specialization gear tokens such as Baleful Armament. Their
  Use line creates a soulbound item for your loot specialization, so the
  tier-token check was missing them.

## 0.2.32

- Detected Blingtron messages such as Encoded Message. Their Use line says
  "Decode the message" or "Decrypt the message", so the openable check was
  missing them.
- Detected the Jeweled Arakkoa Effigy from Tanaan Jungle. Using it pries out
  the three Arakkoa eyes, but its Use line does not say "open".

## 0.2.31

- Detected Warlords tier tokens such as Shoulders of the Iron Vanquisher. Their
  Use line creates a "Tier 17 item" rather than a "set item", so the tier-token
  check was missing them.

## 0.2.30

- Detected the Delve-O-Bot 7001 software update chip. It is a miscellaneous
  Airship Schematic with a Use line and no spell, so the usable-item check
  was hiding it.

## 0.2.29

- The +N list now counts each caged battle pet on its own. Those cages share
  one item, so every pet was showing the total number of cages.

## 0.2.28

- Hid quest starters you have already accepted or completed, such as Eye of
  C'Thun, Direbrew's Dire Brew, Blood of the Unmaker, and Nal'hadar Battery
  Core. Starters you have not begun still show.

## 0.2.27

- Hid quest starters whose quest is already completed, such as Direbrew's Dire
  Brew and Pit Fighter. Unfinished starters such as Celestial Invitation still
  show.

## 0.2.26

- Detected quest starters that have no Use spell, such as Celestial Invitation.
  Those items only say "This Item Begins a Quest", so the usable-item check was
  hiding them and the tooltip never finished loading.

## 0.2.25

- Detected weapon illusion items, such as Illusion: Mongoose, from their
  "Collect the weapon enchantment appearance" use text.

## 0.2.24

- Moved the button size slider below the category list so the Quests checkbox
  no longer sits on top of it.

## 0.2.23

- Detected reputation tokens whose amount uses a thousands separator, such as
  Grants 1,000 reputation, and the older commendation lines that put the
  faction name or the amount in a different place.

## 0.2.22

- Hovering the +N count lists the other waiting items, including each item's
  reason, while clicks on that corner still use the current item.

## 0.2.21

- Detected bag items that begin a quest from the "This Item Begins a Quest"
  line or an explicit begin or start action, and added a Quests category so
  those items can be shown or hidden on their own.

## 0.2.20

- Added CurseForge packaging so tagged releases can be built automatically
  without shipping tests, tools, or GitHub files in the addon zip.
- Rewrote the player README and moved maintainer release notes to
  CONTRIBUTING.md.
- Added GitHub issue templates so bugs and suggestions can be logged in this
  repository.

## 0.2.19

- Detected Drakewatcher Manuscripts, Airship Schematics, and other Rostrum of
  Transformation customizations from item type or use text, covering every
  dragonriding mount rather than a single drake.
- Detected Pepe costume unlocks such as A Tiny Dragon Goblet from their
  "when summoned, Pepe will sometimes be dressed" use text.

## 0.2.18

- Refreshed the button tooltip when the current item changes while the cursor
  is still hovering, instead of keeping the previous item's tooltip.

## 0.2.17

- Updated the button icon when loot replaces a cache in the same bag slot,
  instead of keeping the opened container's artwork.

## 0.2.16

- Stopped looted Companion Curios from being ignored when Blizzard first
  returns a name-only tooltip. Those slots now retry and reload item data
  until the Use: line is available, instead of being cached as finished.

## 0.2.15

- Replaced full-bag reclassification with a dirty-bag inventory index and a
  time-sliced work queue so routine bag, mail, vendor, and combat events no
  longer rebuild every tooltip.
- Kept `/ifyi scan` and the settings rescan authoritative when later bag events
  coalesce, retried incomplete tooltips per slot, and refreshed requirement
  colours from targeted character-state and collection events.

## 0.2.14

- Stopped currency-only world quest turn-ins from reclassifying every bag
  slot. Quest-log scans now run only when a weekly treatise completion flag
  actually changes; bag rewards still refresh through normal bag events.

## 0.2.13

- Stopped treating every bag scan as a full tooltip refetch. Unchanged slots
  reuse cached snapshots, but each scan still runs live collection and
  usability checks. Using an item only refreshes other copies of that item.
  Login and a manual scan still fetch fresh tooltips.

## 0.2.12

- Stopped opening a vendor from immediately reclassifying every bag slot. That
  hitch stacked with auto-sell addons as junk left the bags. Merchant and other
  inventory-routing window scans now wait for bag events to settle and reuse
  unchanged tooltip snapshots.

## 0.2.11

- Stopped leaving combat from immediately reclassifying every bag slot, which
  froze the client as loot such as Cursed Surge bags appeared. Combat-end
  scans now wait for bag events to settle and reuse unchanged tooltip snapshots.

## 0.2.10

- Coalesced mailbox and other bag bursts into one scan after items stop
  arriving, and reused tooltip snapshots for unchanged slots so picking up
  mail no longer reclassifies the whole bag on every item.

## 0.2.9

- Stopped bag rescans on `GET_ITEM_INFO_RECEIVED` and `ITEM_DATA_LOAD_RESULT`
  unless ItemFYI previously asked for that item, so hovering tooltips no longer
  hitch while every bag slot is reclassified.

## 0.2.8

- Identified caged battle pets from TooltipData's `battlePetSpeciesID` field,
  battle-pet tooltip type, and companion-pet item class so bag scans skip
  `SetBagItem` after a reload even when the nested `battlePet` table is absent.

## 0.2.7

- Stopped bag scans from erroring on caged battle pets after a reload, when
  Blizzard's pet tooltip tries to anchor to a GameTooltip that has no points yet.
- Kept Lua 5.1 tests passing when pet-journal lookup returns no species ID.

## 0.2.6

- Detected WoD garrison bag items from their use text, including naval
  equipment such as Ice Cutter and Trained Shark Tank, follower upgrades, and
  building blueprints.
- Detected reputation tokens such as Legion insignias whose use text grants a
  numeric amount of reputation, including after the faction is at Paragon.

## 0.2.5

- Hid the battle-pet companion tooltip when leaving the ItemFYI button, and
  stopped bag scans from leaving a pet card stuck over other items.

## 0.2.4

- Tightened the attention glow so it sits closer to the icon.
- Added a settings toggle to show or hide the attention glow.

## 0.2.3

- Sized the attention glow outside the icon and raised the stack count above it
  so the quantity is no longer hidden by the proc sparkle.

## 0.2.2

- Detected bag items whose use text is `Disenchant this item to produce ...`,
  such as Darkmoon Faire Discarded Weapons, using the same processing path as
  salvage. Ordinary gear that can be disenchanted with Enchanting remains
  excluded.

## 0.2.1

- Detected 12.1 Venomous Abyss tier tokens such as Venomcast Relic, whose use
  text creates a soulbound set slot item for the current class rather than a
  loot-specialization class-set item.

## 0.2.0

- Stopped Alt-drag from using the current item when click-on-press is enabled.
- Stopped `Use: Opens ...` portal and similar text from matching as openables.
- Required Voidshards and Void Vestiges to be usable before they are offered.
- Switched the attention glow to `ActionButtonSpellAlertManager`, with the
  deprecated overlay-glow helpers as a fallback.
- Replaced the deprecated Options slider template with `UISliderTemplate` and
  addon-owned labels.
- Cached each bag tooltip once per scan, including requirement colours and
  battle-pet metadata.
- Hid appearances already known to `C_TransmogCollection` while still showing
  Warband tokens on the wrong armour class.
- Rescanned after loot-spec changes and player quest-log updates so weekly
  treatises and spec-specific tokens refresh without a bag event.
- Listed ignored item names in settings and added `/ifyi ignored`.
- Documented that a bare `/ifyi` opens settings, and registered the Addon
  Compartment entry.
- Confirmed the embedded EditModeExpanded-1.0 library is still upstream MINOR
  118 for 12.1.

- Added generic learnable visual-effect detection for all five Coiled Huntress
  pearls: Cerulean, Sinful, Amber, Cursebound, and Blighted.
- Renamed the transmog setting to **Transmog & visual unlocks** to reflect the
  additional learnable family it controls.
- Generalized word-number stack conversions such as `Combine two ... to create
  ...`, allowing Venom-Cursed Fragments and similarly worded items to work
  without item-ID rules.
- Generalized explicit single-item gutting and salvage actions, replacing the
  Shimmersiren and Rotten Rimefin Tuna ID rules with guarded tooltip detection.
- Documented the detection hierarchy and the narrow cases where explicit item
  data remains necessary, reducing the exception list from 68 to 64 rules.
- Added generic numeric stack-conversion detection for tooltip actions such as
  Bloom Baubles, using the whole-bag count and Blizzard's usability result.
- Renamed the container setting to **Openables & stack combines** to reflect the
  actions it controls.
- Added Fractured Spark of Starlight conversion when at least two usable
  fragments are present across equipped bags.
- Stopped housing plans with unmet profession or skill requirements from being
  offered to characters that cannot add them.
- Prevented slot-targeted appearance actions from selling or moving their item
  inside merchant and other inventory-routing windows.
- Slot-targeted appearances now explain that their merchant window will close
  before use. WoW does not reliably reopen a fully closed vendor interaction,
  so ItemFYI leaves it closed rather than promising an unsafe or inconsistent
  handoff. Clients unable to close it safely hide the action instead.
- Other risky inventory-routing interactions still suppress slot-targeted
  actions until their window closes; safe item-ID actions remain available.
- Added generic support for directly usable legacy tier tokens that create a
  class-set item for the current loot specialization.
- Added class-restriction filtering so tier tokens for an ineligible character
  are not offered even when Blizzard's generic usability result is incomplete.
- Added threshold-aware gutting and cleaning for Draenor fish, shown only when
  the tooltip-required batch of five is available across equipped bags.
- Added Rotten Rimefin Tuna salvage while deliberately excluding Frosted
  Rimefin Tuna because defrosting starts a one-hour expiry timer.
- Added Shimmersiren as an explicit profession action for gutting from the
  ItemFYI button.
- Added profession knowledge consumables across Midnight, The War Within, and
  Dragonflight, including one-time treasures and patron-order rewards detected
  from their explicit study action.
- Added weekly completion gates for all Thalassian, Algari, Undermine, and
  Draconic Treatises so used treatises do not remain queued until reset.
- Renamed the profession setting to cover both permanent skill and knowledge
  items; temporary profession buffs remain excluded.
- Added a toggleable profession skill category for permanent increases such as
  Muck-Covered Writings, including stated-cap and unmet-requirement checks.
- Added a toggleable Companion Curios category for items with an explicit action
  to add the Curio to the companion collection.
- Fixed recipe filtering when Blizzard's generic item-usability result remains
  true despite a red unmet profession or skill requirement in the tooltip.
- Fixed equippable appearance items such as unsupported weapon types trying to
  equip instead of invoking their Warband collection action.
- Uses exact bag-slot actions only for equippable appearance tokens, while
  retaining item-ID actions for vendor containers and other items.
- Invalidates slot-targeted actions as soon as their bag changes and blocks
  those actions in combat to prevent stale slots from using another item.
- Stopped recipes with unmet profession, specialization, or skill requirements
  from appearing on characters that cannot learn them.
- Added threshold-aware support for Ascendant Voidshards at five and Void
  Vestiges at four.
- Counts threshold items across all equipped bags, including split stacks.
- Added threshold-aware support for Venom-Cursed Fragments, shown only when at
  least two are available to combine.
- Fixed Pet Journal species lookup and added detection for non-battle companion
  items such as Emberlyn.
- Stopped background bag scans from hiding tooltips owned by bags, vendors, or
  other UI elements.
- Stopped completed appearance caches, including Cache of Void-Touched
  Legwear, from appearing when their tooltip says every contained look is
  already collected.
- Fixed left-click actions for both click-on-press and click-on-release settings.
- Added optional EllesmereUI and ElvUI skin adapters while preserving ItemFYI's
  built-in dark style as the fallback.
- Stopped non-usable housing dyes and tooltip-marked locked lockboxes from
  appearing as actionable items.
- Removed the button title and Blizzard quick-slot border while retaining the
  dark padded background around the item icon.
- Added Blizzard Edit Mode support with per-layout button positions.
- Added an Edit Mode placeholder so the button remains selectable when no
  actionable item is waiting.
- Preserved Alt-drag positioning and migrated the existing saved position.
- Added a native Blizzard AddOns settings panel.
- Changed bare `/ifyi` to open settings while keeping `/ifyi help` and all
  existing commands.
- Added category toggles, button sizing, position reset, dismissed-item cleanup,
  and manual bag rescanning.
- Deferred button layout changes made during combat until combat ends.

## 0.1.0 — MVP

- Added event-driven scanning of all equipped bags.
- Added a single secure action button with exact bag-slot targeting.
- Added mount, toy, battle-pet, housing-decor, transmog-token, recipe, and
  container detection.
- Added explicit Midnight Dawncrest and 12.1 Mistcrest container rules.
- Added session skip and persistent ignore controls.
- Added combat-safe deferred refreshes, candidate reasons, `+N` count, movable
  position, slash commands, and local validation tests.