Auction Oracle addon (WoW: Forever)

A small, read-only addon that records two things for the desktop app:

full auction-house listings, which give market depth, slippage and liquidation prices;
your profession recipes, which give exact reagent quantities, product quantity and skill-up colours.

The app works without the addon. The addon only makes the data more precise.

Install

Copy the folder addon/AuctionOracle to: World of Warcraft\_classic_beta_\Interface\AddOns\AuctionOracle The product folder may have a different name on your install. Use the one that contains WTF and Interface.
Restart the game, or type /reload.
Make sure Auction Oracle is enabled in the AddOns list.

Use

Command	What it does
`/ao ruleset normal`	Tells the addon which ruleset you play on (`normal`, `pvp`, `rp`, `rppvp`). The game API does not expose it. Do this once.
`/ao scan`	With the auction house open, asks for one full snapshot (`C_AuctionHouse.ReplicateItems`). Limited to one every 15 min (server cooldown).
`/ao recipes`	Records the recipes of the profession window that is currently open. This also happens automatically when you open a profession.
`/ao status` / `/ao clear`	Shows what is stored / deletes the stored scans.

Then type /reload (or log out) so the game writes WTF\Account\<ACCOUNT>\SavedVariables\AuctionOracle.lua. In the desktop app, open Settings → Addon SavedVariables path and point it at that file. It is imported at every collection. You can also import it by hand:

auction-oracle import-addon "C:\...\WTF\Account\NAME\SavedVariables\AuctionOracle.lua"

Compliance

This addon only does things that the built-in UI and long-standing addons (Auctionator-style) also do:

No automation. A scan starts only from a slash command you type, at an auction house you opened.
No purchases, bids, posts or cancellations. No PlaceBid, PostItem, CancelAuction or StartCommoditiesPurchase calls exist in the code.
No network messages, no injection, no memory reading. Data leaves the game only through the standard SavedVariables file.
Seller names are not recorded.
Throttling is respected. The addon has its own 15-minute cooldown and handles a refused pcall.

Read Blizzard's current UI Add-On Development Policy before redistributing the addon publicly.

Known limits

Items with random suffixes ("of the Bear") are recorded under their base item id.
Struct field names for GetRecipeSchematic follow the modern client (outputItemID, reagentSlotSchematics, quantityRequired). Every call is wrapped in pcall / nil checks, so if Forever's struct differs, recipes are skipped instead of causing errors. Check this in game with /ao recipes and then /ao status.