Overview

Last updated: July 24, 2026

WoWCheck Module Overview (wowcheck)

The wowcheck package provides specialized integrations for querying World of Warcraft (WoW) character data, armory prices, and game telemetry.

Key Features

  • Character Lookup: Queries external APIs (like Raider.IO or Blizzard APIs) to retrieve character item levels, achievements, and progression.
  • Auction House (AH) Lookup: Fetches current market prices for WoW items (gold, silver, copper).
  • Assistant Bridge: The wow_tool_bridge.go file exposes these capabilities as tools (wow_character_lookup, wow_ah_price_lookup) for the assistant module.

Key Files

  • wowcheck/wowcheck.go: The core logic and API client for WoW data.
  • wowcheck/wow_tool_bridge.go: The adapter that registers WoW capabilities as tools within the assistant ecosystem.
  • wowcheck/wowcharts.go: SVG progress chart generation per metric (90d/180d toggle). Added July 2026 (commit 1d25cd66).
  • wowcheck/wowchecksite.go: Web dashboard handlers — character pages, realm overview, chart rendering.
  • wowcheck/wowchecksite_test.go: httptest smoke tests — handlers, path traversal 404, chart render. Added July 2026.

Integration Flow

  1. Tool Invocation: An agent (e.g., nikki) decides to use the wow_character_lookup tool.
  2. Bridge: The request hits assistant.wow_character_lookup, which formats the arguments and calls wowcheck.
  3. API Call: wowcheck.go makes the external HTTP request to the gaming APIs.
  4. Formatting: The raw JSON is parsed into a clean summary (Level, Item Level, Achievements).
  5. Return: The data is returned as a ToolResult for the agent to analyze.

Site Overhaul (July 2026)

Major web dashboard overhaul in commit 1d25cd66:

  • SVG Progress Charts: Per-metric charts on character pages with 90d/180d toggle (wowcharts.go)
  • Path Traversal Fix: Character/realm query params now allowlisted via single TrackedCharacters list — prevents arbitrary file reads
  • Performance: ID→name maps replace per-ID JSON re-parsing (O(n²) → O(n) fix)
  • Templating: Templates parsed once; render buffered (no half-written 500s on errors)
  • Trophy Rename: Bogus "Heirlooms" trophy renamed to "Housing Decor"
  • Recent Items: Shared helper de-dupes ~200 lines; char page shows recent housing decor
  • Tests: httptest smoke tests for handlers, traversal 404s, chart rendering

Guidance for AI Agents

  • Character Mapping: Be aware that users often have multiple characters. Ensure you specify the correct character_name, realm, and region when using the lookup tools.
  • Data Freshness: API data might have a slight delay compared to live in-game status.

Cross-References