v0.5.1

VocGear

v0.5.1 (2026-10-05)

Full Changelog Previous Releases

• fix: announce melee/ranged weapon swaps instead of auto-equipping
  A sword over a hunter's bow disables the action bar, and Pawn scores ranged as plain 2H (the ilvl path has no weapon check at all). Cross-kind swaps now announce once per session; same-kind upgrades still equip.
• docs: sources of truth for WoW API and Lua references
  Agents and contributors verify every API fact against Blizzard's own
  documentation for the build in the .toc (the in-game /api docs, or
  the wow-ui-source mirror's Blizzard_APIDocumentationGenerated), then
  Blizzard's UI source, then the Lua 5.1 manual; the wiki is for prose
  only, and fandom-era mirrors never. .luacheckrc's read_globals is the
  enforced allowlist of verified names. Documented in FAMILY.md (same in
  every sibling), AGENTS.md, and the lint config itself.
  Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
  Claude-Session: https://claude.ai/code/session\_019atPxjwbdGxYef6zgN2yxG

v0.5.0

VocGear

v0.5.0 (2026-10-05)

Full Changelog Previous Releases

• chore: tag workflow to cut releases from anywhere
  Actions > tag > Run workflow creates the version tag on main and
  dispatches the release workflow at it, for places that cannot push
  tags directly. release.yml accepts the dispatch; the push trigger is
  unchanged.
  Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
  Claude-Session: https://claude.ai/code/session\_019atPxjwbdGxYef6zgN2yxG
• docs: adopt FAMILY.md, the Voc family conventions
  FAMILY.md is the contract every Voc addon follows: principles, naming,
  slash grammar, chat voice, settings, layout, tests, releases, docs.
  README and AGENTS.md follow its templates and link the siblings.
  Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
  Claude-Session: https://claude.ai/code/session\_019atPxjwbdGxYef6zgN2yxG
• chore: addon-list icon and Bags & Inventory category
  Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
  Claude-Session: https://claude.ai/code/session\_019atPxjwbdGxYef6zgN2yxG
• chore: luacheck config and test workflow
  Lint declares the addon's own globals and the WoW API it reads; CI
  runs the headless tests on Lua 5.1 plus luacheck on every push.
  Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
  Claude-Session: https://claude.ai/code/session\_019atPxjwbdGxYef6zgN2yxG
• feat: shared slash grammar and chat voice
  /vg help lists every subcommand, /vg on|off sets auto-equip explicitly,
  and an unrecognized subcommand prints help instead of toggling, so a
  typo can never switch the addon off. /vocgear is back as a documented
  long form. Chat lines go through ns.say with the family's colored
  prefix. Tests run on Lua 5.1 as well as 5.4 and move to tests/run.lua.
  Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
  Claude-Session: https://claude.ai/code/session\_019atPxjwbdGxYef6zgN2yxG
• fix: harden SavedVariables, scans, and sheet-button init
  • Recover corrupt SavedVariables and wrong-typed settings to defaults instead of erroring
  • Malformed Pawn answers can no longer wedge the scan; bad items read as unsure and retry
  • Sheet button is ensured on every addon load so the lazy character UI cannot strand it
  • Guard optional slider label-formatter and malformed scale-list shapes
  • Regression tests 31-36: corrupt SVs, malformed Pawn data, late char UI, no global leaks

v0.4.0

VocGear

v0.4.0 (2026-10-05)

Full Changelog Previous Releases

• fix: dock sheet button next to Pawn instead of overlapping
  Anchor to PawnUI_InventoryPawnButton following its side, matched 24px height, re-place on Pawn load/move, sheet-bottom fallback without Pawn.
• feat: declare Pawn as required dependency
  OptionalDeps to RequiredDeps: without Pawn the client now reports VocGear unloadable instead of idling silently. Runtime guards stay as API-drift safety.

v0.3.0

VocGear

v0.3.0 (2026-10-05)

Full Changelog Previous Releases

• docs: scan command, sheet button, fix stale problem statement
• test: cover manual trigger, callbacks, sheet button
  29 tests, 106 checks. New: checkNow re-announce, /vg scan, setting-callback rescan, button create/label/click/tooltip/visibility, missing-frame safety.
• feat: manual check trigger and character-sheet button
  checkNow clears one-shot announces then runs the normal scan; /vg scan; panel edits rescan immediately; Check Bags button on PaperDollFrame with tooltip plus sheetButton visibility setting.
• docs: add voc family footer
• chore: add curseforge and wago project ids
• refactor: consolidate slash commands to /vg
  Remove the undocumented /vocgear alias; /vg (toggle, announce, config) is the only command, matching the README.

v0.2.0

VocGear

v0.2.0 (2026-10-04)

Full Changelog Previous Releases

• docs: guard, heirloom option, slider; drop quest/loot
• test: cover guard, armor, heirloom, slider; drop quest/loot tests
  27 tests, 88 checks. New: swap-memory break/expiry, manual-swap respect, breaker trip/resume, armor gate incl. fail-open, heirloom keep/replace, slider range + label. Removed quest/loot coverage with the features.
• feat: loop guard, armor-type gate, heirloom protection
  Swap memory + per-slot circuit breaker stop A->B->A equip ping-pong. Item-level upgrades now require PawnIsArmorBestTypeForPlayer. New keepHeirlooms option (default on) never displaces rarity-7 gear. Threshold slider shows its value and steps in 5s. Quest picker and loot advisor removed: Pawn annotates those surfaces natively.
• docs: describe config build in README and AGENTS.md
• test: cover config behaviors in stub harness
  25 tests, 80 checks: threshold, scale filter, ilvl toggle, audit mode, two-slot resolution, quest off/highlight/auto, loot NEED/GREED/silent, Settings registration, slash commands.
• feat: addon config with equip rules, quest picker, loot advisor
  Settings panel (Settings > AddOns > VocGear, /vg config) with 9 options: master switch, announcements, audit mode, minimum upgrade % slider, ring/trinket auto-equip, item-level upgrades, Pawn scale picker, quest rewards off/highlight/auto, loot advisor. Scoring moves to PawnGetItemData + PawnIsItemAnUpgrade directly for percent margins and replaced-slot targeting.
• docs: note live-test junction in AGENTS.md
  AddOns\VocGear is a directory junction to this repo; edits go live on /reload. Records recreate/remove commands.

v0.1.0

VocGear

v0.1.0 (2026-10-04)

Full Changelog Previous Releases

• docs: adopt tag-driven versioning (same scheme as vocwarbank)
  VERSIONING.md with semver + alpha/beta channels, immutable tags, changelog from commit subjects. .pkgmeta ignores tests, AGENTS.md, VERSIONING.md so releases ship only the addon.
• test: add stub-harness regression suite for bag scans
  tests/scan_test.lua runs under plain lua with stubbed WoW/Pawn APIs: 11 tests, 22 checks covering equip, announce, combat, disabled, slash toggles, and SavedVariables rebinding.
• fix: persist settings, equip exact variants, retry when Pawn loads late
  Rebind SavedVariables on ADDON_LOADED (client replaces the global after file load). Classify slots via C_Item.GetItemInfoInstant; unknown slots announce instead of equip. Equip and flag by full item link so bonus variants resolve exactly. One delayed rescan when Pawn is not ready yet.
• docs: add AGENTS.md code map
• refactor: namespace audit, move module state onto ns
• feat: VocGear v1, auto-equip Pawn upgrades