Companion Scanner data sources - compiled 2026-11-07
==================================================

Pet catalogue and acquisition categories:
https://wowclassicforever.info/companion-pets/
122 unique pet-card species records were present in the supplied page.
Its heading count was different; this addon counts the actual records.
The page mixes Forever client facts with explicitly labeled Classic sources.
Unknown acquisition methods remain unknown. Acquisition notes are factual
summaries; the page's descriptions and artwork have not been republished.

Vendor behavior/reference cross-check:
https://www.wowhead.com/classic/guide/classic-companion-pets
Each mapped vendor also has its Wowhead Classic NPC URL in Data.lua.
This cross-check identifies Flik as a Darkmoon Faire vendor (not a permanent
Thunder Bluff shop), limited-stock frogs/kittens, and Magus Tirth's trading
interaction. Classic references are not proof of current Forever availability.

Item identifiers:
https://foreverchanges.pro/
Local public ForeverChanges 1.60.1.70790 item snapshot, retrieved 2026-11-06.
Teaching items are matched by exact item name, with separate original and
Forever special-edition variants where names overlap.

Summoning spell IDs and estimated vendor base prices:
Existing public Forever 1.60.1.70450 client-item reference snapshot in the
ForeverGear build workspace (research/forever-data-audit/items.js).
Only learn-spell effects supply learned-spell fallback IDs. Generic teaching
spell 55884 is not treated as ownership. Prices are estimates; live merchant
observations take precedence. No live Wowhead pricing is claimed.

Reference vendor coordinates and stock:
Questie/QuestieDB data/Forever, snapshot commit ce594c4, dated 2026-09-28,
from research/forever-data-audit/questie.js in the build workspace.
Factual vendor/quest giver coordinates, quest requirements and teaching-item IDs are used.
No Questie addon code or libraries are included.

Drop markers added in 1.0.1:
The supplied pet page lists Black Tabby from Dalaran Spellscribe, Siamese from
Cookie, and Green Wing Macaw from Defias Pirate. Reference cross-checks:
https://www.wowhead.com/classic/npc=1920/dalaran-spellscribe
https://www.wowhead.com/classic/npc=657/defias-pirate
https://www.wowhead.com/classic/guide/classic-companion-pets
Spellscribe coordinates use the Questie Forever reference above; marked as
an approximate rare spawn area. Dungeon drops use the existing ForeverGear
Forever entrance record (Westfall 42.56, 71.69), not an invented boss position
on the outdoor map. Classic loot references remain labeled as such.

OpenMap compatibility in 1.0.1:
Public OpenMapAPI v4 inspected in the user's installed OpenMap/API.lua.
Uses CanvasFromWorldPos, ArtTopLevel, view-change callbacks and the menu
toggle registration API. No OpenMap implementation or art is redistributed.

OneForAll compatibility in 1.0.2:
Reviewed the user's installed OneForAll/MinimapCollector.lua. Calls its
MinimapCollectorRefresh entry point after the launcher exists; respects its
existing collector setting and lets it own button placement/restoration.
No OneForAll source code or assets are included in this addon package.

Current Forever API verification:
https://github.com/Gethe/wow-ui-source/tree/forever/Interface/AddOns/Blizzard_APIDocumentationGenerated
PetJournalInfoDocumentation.lua: GetOwnedPetIDs/GetPetInfoTableByPetID.
MerchantFrameDocumentation.lua: C_MerchantFrame.GetItemInfo.
MapDocumentation.lua: map projection and world coordinates.
FrameAPICharacterModelBaseDocumentation.lua and SimpleModelAPIDocumentation.lua:
pet display/creature models, rotation and model readiness. Preview identifiers
come directly from the current client's GetPetInfoTableBySpeciesID result.

Reference addon supplied by the user:
Books_on_map_Forever 2.0.4, author Daeler, from
"Adds icons on map for Book Collection.zip".
Reviewed for the requested map-pin/proximity workflow. This implementation
is independent; no Books addon source, libraries or artwork are distributed.
Artwork and interface templates are referenced from the user's WoW client.

The reproducible builder is scripts/build-companion-scanner-data.mjs in the
ForeverGear workspace; its input manifest is in research/companion-scanner/.

Pet quests and murloc alerts (1.0.5):
Questie/QuestieDB data/Forever snapshot above supplies quest IDs, giver
locations, minimum levels and prerequisites. The supplied pet catalogue
supplies quest reward associations; they remain reference data. Includes
3721; Sprite Darter chain 2969/2970/2972/3841/3842/3843/4297/4298;
4729/4862; Children's Week 1468/172 -> 171/5502; and 9319/9386.
No reward/item-to-species match was assumed for CLUCK or entitlement quests.
Live quest item links take precedence and can record new pet reward sources.
QuestLogDocumentation.lua and GossipInfoDocumentation.lua from the current
Forever UI source verify quest-completion, log and current-offer APIs.
Murky species 107 uses current C_PetJournal display/creature identifiers.
Fallback art: Interface/Icons/INV_Misc_Head_Murloc_01 from the WoW install.
No Blizzard artwork or models are redistributed in the ZIP.

Forever acquisition update (1.0.11; reviewed 2026-11-07):
https://www.wowhead.com/forever/items/miscellaneous/companions
https://www.wowhead.com/forever/guide/collections/pets-locations-sources
Confirmed relationships add eight pets to existing vendor stocks, plus
Prairie Wolf Pup from Mayhoa Skyhoof (268745). Her 37 route samples come from
the rendered map at https://www.wowhead.com/forever/npc=268745/mayhoa-skyhoof
Six representative patrol pins avoid crowding the map; all samples are used
for proximity and nearest-point selection. A recent NPC sighting is required.
Drop relationships: Baby Crocolisk (282047) / Sewer Beast (3581), Shaking Egg
(282637; Condor Hatchling) / Lord Condar (14268), Tallstrider Hatchling (284176)
/ Strider Clutchmother (2172). Coordinates use the Forever Questie snapshot.
Older missing teaching-item records are repaired with named ForeverChanges
items and catalogue species IDs. No drop rate is assumed.
The same Forever guide supplies the new quest/currency/reputation notes.
Snowy Wolf Pup remains explicitly unknown in that guide. Unverified vendor
or quest giver coordinates are not mapped. Reviewed facts are stored in
research/companion-scanner/forever-sources-20261107.json in the workspace.

Complete item-list audit (1.0.12; reviewed 2026-11-07):
All three rendered pages of the supplied Forever companion item list were
read: 50 + 50 + 2 = 102 distinct item IDs. The immutable input snapshot is
research/companion-scanner/wowhead-list-20261107.json; the builder checks every
ID and writes catalogue-coverage.json. Listed source categories are displayed
as database claims, not proof of currently obtainable stock or precise locations.
The Minfernal teaching item (284214) is explicitly linked to species 5174
in the older pet catalogue and now has a named record in the item snapshot.
13 remaining items have no verified species mapping: familiar scrolls, Chicken
Egg, Green Helper Box, Baby Shark, Pet Fish, Pet Stone and five turtle eggs.
They use separate item-reference keys, inventory checks and icon previews;
they never masquerade as Pet Journal species or trigger pet proximity alerts.
Mage scroll requirements and temporary duration use the ForeverChanges snapshot.
Jang (15078) is linked from Bitter Baitling in the current item list; his
26.7, 76.3 Stranglethorn location uses the existing Forever Questie snapshot.
The guide supplies the 1 Extravagant Extravaganza Coin cost.

Location-specific mutes and collection colors (1.0.13):
Mute records use per-character source IDs, trigger map/coordinates, the alert
radius and the exact popup pet IDs. They do not change global pet ignores or
map visibility. Trigger snapshots prevent movement after opening the popup
from changing the area being ignored.
Collection colors use the existing guarded Pet Journal/spell/inventory scan.
Native item tooltips follow the same TooltipDataProcessor item-post-call and
legacy OnTooltipSetItem patterns already used by Forever BiS in this client.
Only visible public tooltip frames are handled; private scanner tooltips and
restricted values are ignored. Temporary/item-only entries stay distinct.

Blizzard Pet Journal integration (1.0.14):
Reviewed the current public Forever UI source on 2026-11-07:
https://github.com/Gethe/wow-ui-source/tree/forever/Interface/AddOns/Blizzard_Collections
Shared/Blizzard_PetCollection.lua and .xml verify PetJournal, RightInset,
PetJournalPetCard.speciesID/petID, PetInfo and PetJournal_UpdatePetCard.
Camelot/Blizzard_CollectionsOverrides.lua and Shared/Blizzard_Collections.xml
verify the Forever collections host. Local research copies are kept only
in the workspace, not redistributed. The journal module is original code.
The integration adds a toggled child view over the lower-right content area
and securely observes pet-card updates. It does not replace native functions,
change pet-list filters, summon pets or alter protected actions.
