Release Healer Man 0.1.42

PLAYTEST_NOTES.md

@@ -2762,3 +2762,396 @@ Vite's existing large-chunk advisory remains informational.
   passed, along with the native vocation-import regression. The production
   TypeScript/Vite build and release-bundle verification passed. The final
   release candidate check includes the new tests and generated catalogs.
+
+## RoM dungeon enemy durability — September 13, 2026
+
+- Reproduced Barren Caves' low health with a RoM Priest and the four shipped
+  companions. Tested 108 combinations: 12 party seeds at levels 1, 2, 4, 8, 9,
+  20, 40, 70, and 80. The old fallback had 94 health at level 1 and 1,832 at
+  level 80; kills took 0–1.9 seconds from the first damaging NPC hit.
+- Normal RoM dungeons now use a party-health baseline of
+  `1000 + 100 * enemyLevel + 8 * enemyLevel * enemyLevel`, with authored
+  creature/boss multipliers applied separately. This is explicit Healer Man
+  balancing because native RoM creature health tables are not packaged.
+  Barren Caves' Anglo retains his 7.5 multiplier and one-level advantage.
+- Loaded RoM creatures receive the new health when the character levels up.
+  Re-registration preserves wounds as a health percentage and keeps corpses
+  dead. Enemy attack damage also rebases on a level change instead of retaining
+  its original low-level value. Regression checks cover these transitions.
+- With the new health, the 108 isolated party-damage pulls lasted 3–17.5
+  seconds. A separate pull exercised actual enemy attacks and Priest healing
+  before the enemy died, with all companions surviving. These are opening
+  pulls with baseline equipment, rather than an audit of every geared build.
+- Live PC check at 1280×720: created the offline Human Priest Barrenaudit and
+  entered Barren Caves as Healer. A level-1 Cave Sand Bug had 1,108 health.
+  At 10 seconds it still had 374 health, with 734 party damage on the meter.
+  The completed first fight showed 14 seconds and 1,108 total damage:
+  Morgha 370, Ilyen 369, Maerwen 289, and Cael 80. Urgent Heal then restored
+  Maerwen to 407/407 while the next pull was active. No browser errors were
+  captured during that bounded combat check.
+- Concurrent navigation edits triggered development hot reloads around the
+  playtest; the captures above were taken during uninterrupted combat. This
+  check did not complete the dungeon or use physical Ayn Thor hardware.
+  Restored the original Hudtest roster selection, closed the test tab, and
+  stopped the temporary development servers.
+- Evidence: `artifacts/rom-dungeon-health/report.json`,
+  `barren-caves-health.png`, `barren-caves-combat.png`, `barren-caves-healed.png`,
+  `live-combat-dom.txt`, and `browser-errors.json`.
+- Validation: all 407 focused combat, party, CoA, RoM, DPS-meter, stat, and
+  dungeon-scaling tests passed across 52 files. The final production
+  TypeScript/Vite build and release-bundle verification passed.
+
+## 2026-09-13 - WoW dungeon lighting and stair fleet pass
+
+- Applied environment-specific readable lighting to all 54 WoW dungeon entries,
+  using the reviewed Stockades ambient/hemisphere fill as the baseline. Stone,
+  cavern, fire, arcane, crypt, and outdoor profiles preserve distinct coloration.
+  Stockades' existing presentation/three ramps and RuneWaker lighting are unchanged.
+- Scanned every shipped WoW collision package, including authored Wailing
+  Caverns' actual source assets. Added 347 verified walking proxies across 22
+  other dungeons and eight filled navigation portal bridges in Uldaman. Rendered
+  steps and source visual/collision/navigation GLBs remain unchanged.
+- Added package-identity gates and a compiler-independent shared runtime adapter.
+  Collision preparation spatially indexes flights; rejected candidates cannot
+  supply geometry needed by accepted proxies. Existing navigation validation,
+  content, encounter, and availability gates were not promoted to green.
+- Shipping-asset regressions independently pass all 347 new proxies through
+  prepared collision and the live NPC segment validator uphill/downhill at the
+  center and two interior lateral lanes. Exact portal matching and all existing
+  Stockades player/NPC/wall tests pass.
+- The game-playtest visual viewer uses shipped meshes and runtime lighting and
+  material policies without touching saved character/party state. At 1280x720,
+  Uldaman's old/new-fill comparison showed clearer stonework; Wailing Caverns
+  retained green, readable rock; Mechanar retained cool arcane interiors;
+  Scholomance's visible entrance steps/masonry remained intact and readable.
+  Blood Furnace's dark source textures remained visible at its wall-facing
+  entrance viewpoint. Durnholde's visual load completed without console errors.
+- Zul'Farrak entrance/boss views and Durnholde's exterior boss view showed
+  geometry/terrain/viewpoint gaps, recorded for separate investigation. This is
+  not exhaustive staircase certification: curved/short/heavily-decimated flights,
+  rejected candidates, outer stair edges/landing lips, complete dungeon routes,
+  full clears, and physical Android QA still require individual review.
+- Evidence/coverage: `dungeon-pipeline/WOW_ENVIRONMENT_REVIEW.md`,
+  `src/game/generated/wowDungeonStairs.generated.json`, and screenshots in
+  `artifacts/wow-dungeon-environment/`. No hosted release was published.
+- Validation: 247 Vitest files passed, 1,599 tests passed, six existing tests
+  skipped. Production TypeScript/Vite build, texture/performance audits, bundle
+  compression/verification, and release candidate check passed. Existing physics
+  initialization and bundle-size/import advisories remain.
+
+## 2026-09-13 - Dungeon completion results and run leaderboards
+
+- Fixed missing RuneWaker completion bookkeeping for the 21 dungeons with
+  configured bosses. Barren Caves now awards Anglo's objective on his actual
+  death and announces the completed run. Bossless placeholder entries do not
+  fabricate a completion.
+- Run timing starts when the dungeon is playable, survives wipes, pauses, and
+  saved resumes, and freezes at the final-boss objective. Older checkpoints
+  without a recorded start time still announce completion but remain unranked.
+- The results dialog shows the final-boss time, final-clear and full-clear
+  placement, party classes/levels, and defeated bosses. Stay and loot, reopening
+  results, and Return to main menu were verified through the live UI. Returning
+  clears the completed checkpoint.
+- Replaced the dungeon picker's minimap with persistent completion-time
+  leaderboards. Final Boss clears includes all qualifying runs; Full dungeon
+  clears requires every available boss for the selected difficulty. Expanded
+  entries show each party member and boss status. Normal/heroic rankings are
+  separate; disconnected results use an explicitly labeled device leaderboard.
+- An actual combat integration check fought Barren Caves' level-2 Anglo with
+  9,240 health using NPC ability selection, enemy attacks, and Priest healing.
+  NPCs dealt 9,239 damage after a one-damage player tag; healing totaled 441.
+  The final death awarded completion at 84.1 seconds with all companions alive.
+- Manual browser combat confirmed NPC damage and healing on Barren Caves
+  trash. The live results check restored the integration fight's completed
+  checkpoint through an isolated local QA account: 01:24.1 ranked #1 of three
+  seeded local-server entries in both filters. This was not a manual browser
+  full clear and no production leaderboard entries were published.
+- PC results and expanded final/full leaderboard layouts were visually
+  reviewed at 1280x720. The built-in Thor preview displayed the leaderboard,
+  filters, and role-selection control within its 960x540 main surface. Compact
+  480x360 DOM bounds kept the dialog footer inside the viewport; the in-app
+  browser's viewport-override screenshot scaled incorrectly, so that capture
+  does not establish compact visual quality. Physical Thor hardware was not used.
+- Evidence: `artifacts/dungeon-runs/combat-completion.json`, `results-world.png`,
+  `leaderboard-final-expanded.png`, `leaderboard-full-expanded.png`, and
+  `leaderboard-thor.png`. The bounded final browser check captured no errors.
+- Validation: 70 completion, checkpoint, encounter, catalog, client, and UI
+  tests plus the real-combat integration test passed. The 432-test focused
+  combat/party/class/health/input regression suite and 18 server tests passed.
+  Production build, final TypeScript check, and release candidate check passed.
+
+## 2026-09-13 - RoM character nameplate class labels
+
+- RoM overhead nameplates and AI party frames now show the active class alone,
+  or primary/secondary class names joined with `/`, without race or `Primary`.
+- An isolated local fixture using the real scene, party frames, and shared
+  character preview verified `Warrior`, `Priest`, and `Priest/Warrior` labels.
+  The two-class dungeon screenshot showed the label above the rendered body
+  and equipped staff silhouettes. The roster preview also retained its body
+  and equipment. The fixture used in-memory identities without saving a roster.
+- Evidence: `artifacts/rom-nameplates/dungeon-dual-class.png` and
+  `artifacts/rom-nameplates/roster-preview.png`.
+- Validation: 70 avatar, party-store, and mob-nameplate tests passed. Production
+  build, asset audits, compression/bundle verification, and release check passed.
+
+## 2026-09-13 - Dungeon boss durability and difficulty leaderboards
+
+- Campaign bosses now use a level-scaled health floor above their original
+  health when needed. Final bosses receive an additional 1.8 multiplier on
+  that floor. Larger authored health values remain effective.
+- The dungeon browser offers a 1-10 boss difficulty slider, native keyboard
+  adjustment, and controller decrement/increment buttons. Difficulty 1 is
+  Easy; each step adds 25% health and 15% damage to bosses. The selected source
+  Normal/Heroic variant also applies to entry. Trash retains its existing stats.
+- Boss difficulty is fixed at entry, preserved through saves and renderer
+  restarts, and passed from the online group leader to followers. Changing
+  difficulty starts a new run; completed checkpoints also start fresh.
+- Device and world leaderboards isolate each difficulty's final/full-clear
+  records, ranks, and pages. Existing records migrate to a separate legacy
+  bracket. Migration and repeat submissions were verified against SQLite;
+  HTTP tests verify difficulty selection and reject invalid values.
+- Deterministic Ragefire simulations tested 12 RoM party compositions at levels
+  1, 8, 20, 40, and 80 against the shared runtime scaling function. All ordinary
+  boss samples exceeded 25 seconds and final-boss samples exceeded 45 seconds.
+  Additional damage-role Mage samples passed those bounds; at level 8 the
+  ordinary boss took 29.8 seconds and the final boss took 55 seconds. Timings
+  remain dependent on party composition, player actions, and equipment.
+- A final-boss fight with enemy attacks and Priest healing verified repeated
+  attacks, incoming damage, healing, and party survival before the boss died.
+  Balance evidence: `artifacts/boss-difficulty/ragefire-balance.json`.
+- Desktop screenshots at 1280x720 verified the Easy and difficulty-10 layouts,
+  stat preview, and matching leaderboard labels. Pointer and keyboard changes
+  were exercised. At 390x844 the slider remained operable and its DOM width
+  stayed within the viewport, but the in-app browser's viewport-override
+  screenshots scaled incorrectly, as in the earlier compact playtest. Those
+  captures do not establish mobile visual quality. The viewport was restored.
+- Validation: 169 focused game/client/UI tests and 20 server tests passed.
+  The production build, asset audits, bundle verification, and release check
+  passed. Existing RoM nameplate changes were retained.
+
+## 2026-09-13 - Original WoW dungeon atlas
+
+- Added 107 unique original map images across 51 standard WoW dungeons using
+  the supplied patch-enUS-M archive and existing client archives. A duplicated
+  Trial of the Champion floor record is deduplicated before packaging. The
+  source MPQs and Mapster addon were read without modification; no Lua addon
+  code is installed into HealerMan.
+- Coordinate inverses were checked against 10,342 matching source spawns and
+  the event-driven Trial of the Champion source entrance. Maximum discrepancy
+  is 0.189 yards in authored Wailing Caverns rounding; other imported maps
+  have substantially smaller discrepancies. All 107 image checksums match
+  their local immutable content objects.
+- The production preview at localhost:5174 loaded Wailing Caverns and showed
+  original artwork with the player/camera direction, entrance, numbered
+  encounters, and a 45.7%, 60.5% entrance-position readout. The map was visually
+  reviewed at 1280x720, with the rendered dungeon visible behind it. Pressing
+  M opened it; toggling patrol routes then pressing M closed it despite the
+  checkbox retaining focus. Reopening restores the clean default overlay.
+- Evidence: `artifacts/wow-maps/wailing-caverns-atlas.png`. No production-preview
+  errors were captured in the bounded console check. Earlier development HMR
+  errors from concurrent equipment edits were not treated as production errors.
+  Testing used the existing offline Hudtest QA character, not a live account.
+- Multi-floor rendering, floor controls, rebound shortcuts, repeat/capture
+  guards, PNG dimensions/checksums, axis projection, shifted/rotated scene
+  transforms, and RuneWaker survey fallback are covered by automated tests.
+  Every dungeon was not individually traversed in the browser. Auto floor
+  selection is horizontal best fit, not WMO-group/height detection; overlapping
+  stacked rooms require manual floor selection. Mobile hardware was not tested.
+- Tinkertech Showdown, Frozen Reach, and Forgotten Mine have no matching
+  artwork records and retain their survey maps. RuneWaker maps are unchanged.
+  Failed artwork loads also retain a correctly reprojected survey fallback.
+- Validation: 50 focused map/UI/input tests and three BLP/tile-layout tests
+  passed. The production build, texture/performance audits, and compressed
+  release-bundle verification passed. Local downloadable packs were published;
+  no online deployment was performed.
+
+## 2026-09-13 - Boss card collection and leveling loot
+
+- Boss deaths roll a guaranteed Normal card plus independent Rare (1/10),
+  Epic (1/50), and Legendary (1/100) bonuses. The collection catalogue covers
+  330 distinct WoW/RoM bosses and 1,320 rarity variants using existing models.
+  Repeated appearances share counts and list every source dungeon.
+- Copies and the latest claim per boss spawn persist per character through the
+  roster/cloud-save path. Shared-world hydration grants the authority's rolls
+  to followers and ignores duplicate/reconnected and older reward snapshots.
+- Equipment drops and bonus equipment are suppressed below player level 80;
+  existing inventory and authored non-equipment drops are preserved. Level-80
+  equipment loot remains enabled. Bosses without equipment tables award cards.
+- The production browser at 1280x720 verified the main-menu entry, all four
+  Lady Anacondra model portraits, dungeon location, odds, search, All/Earned,
+  dungeon/rarity grouping, and in-dungeon pause-menu access. Roster and dungeon
+  screenshots show player/party bodies and starter weapon/shield silhouettes.
+- At 390x844 the collection switched to two columns, with no horizontal page
+  overflow and dialog bounds within the viewport. The in-app browser again
+  scaled the viewport-override screenshot incorrectly; that capture does not
+  establish mobile visual quality. The viewport was restored.
+- Deterministic tests cover exact odds boundaries, counts, persistence,
+  no-loot-table bosses, loot restrictions, and online replay. Live browser QA
+  did not perform a boss clear; earned-copy display was checked with seeded
+  render tests. Evidence: `artifacts/boss-cards/collection-desktop.png`,
+  `collection-mobile.png`, `roster.png`, and `dungeon.png`.
+
+## WoW and CoA default boss difficulty review — September 13, 2026
+
+- Reviewed all 10 WoW and 21 CoA classes: 61 canonical class-role builds at
+  levels 8, 20, 40, and 80 with three deterministic companion compositions.
+  The 1,464 durability simulations used live boss scaling, starter heirlooms,
+  legal level-appropriate talents, live companion AI, and the existing baseline
+  player rotation. CoA characters currently use WoW companions.
+- Fixed Death Pact and other instant-kill effects bypassing boss health in the
+  player, triggered-spell, and companion paths. Fixed repeated proc activations
+  across branches, duplicate execution of expanded CoA payloads, invented
+  damage on proc auras and Waterfall, and critical-damage talent bonuses
+  affecting ordinary hits. Regenerated the CoA runtime catalog and shards.
+- Raised the shared health floor by 40% to cover the remaining CoA burst.
+  Every class uses the same boss stats at the same level and difficulty.
+  Fastest sampled kills were 26.2 seconds for an ordinary boss and 48.6 for
+  the final boss. All duration assertions passed. The refreshed RoM regression
+  also passed; its level-eight damage-role Mage sample took 41.8/74.9 seconds.
+- Durability samples disabled enemy attacks and stopped at 60 seconds to
+  isolate damage. Most WoW and CoA samples still had a living boss at the cap;
+  these are lower bounds, not proof of typical 25-30/45-second kill times.
+  Default class throughput is still uneven, especially for WoW parties.
+- An additional 26 final-boss attack samples exercised healer builds at levels
+  8 and 80. Paladin, Priest, Shaman, and Tinker kept their parties alive in both.
+  Druid and several CoA samples lost companions; Bloodmage also lost the player
+  at 80. This basic policy can refresh HoTs too early or choose self-healing
+  hybrids, so these outcomes need a dedicated healer rotation/playtest pass
+  before treating them as class throughput limits. No live boss clear was
+  performed in this numerical review.
+- Validation: 122 combat/catalog checks, 91 class-damage/avatar checks, eight
+  RoM boss regressions, TypeScript, and the production build passed. All six
+  large-matrix assertions passed, but its progress reporter timed out during
+  CPU-heavy loops. Added worker yields and reran the affected level-40 test;
+  it exited cleanly without the reporter error.
+- Evidence: `artifacts/boss-difficulty/wow-coa-balance.json` and
+  `artifacts/boss-difficulty/wow-coa-review.md`. Coverage is a canonical build
+  per role with starter gear, rather than every specialization or later gear
+  combination. `npm run release:check` is required for handoff.
+
+## CoA healer rotation pass — September 13, 2026
+
+- Corrected base-mana percentage costs, Tinker's secondary mana maximum,
+  imported heal power/AP/spirit scaling, self-healing riders, and party heal
+  recipients. Removed invented instant heals from conditional procs and
+  invented hostile damage from healing/mitigation tooltip text. Regenerated
+  the CoA runtime catalog and all class shards.
+- Companion support AI maintains existing HoTs, covers other injured allies,
+  and avoids redundant shields. The benchmark player policy now prefers
+  effective emergency/area healing, avoids wasteful self-healing, positions
+  ground heals on the injured ally, and funds rage heals through weapon attacks
+  and actual resource generators. Normal gameplay still uses player input.
+- Tested nine canonical CoA healer builds at levels 8, 20, 40, and 80 against
+  final-boss attacks for 60 seconds with three deterministic WoW companion
+  compositions each: 108 samples. Every player survived and every sample
+  delivered effective ally healing. Entire-party survival was 24/27 at eight,
+  25/27 at twenty, and 27/27 at both forty and eighty.
+- The remaining low-level losses are Primalist companions. Its imported Geode
+  Barrage lacks the server-scripted stone/rage payload; that mechanic still
+  needs implementation. Survival at the time cap does not establish a boss
+  clear, indefinite mana sustainability, or complete CoA mechanic parity.
+- Reran the full WoW/CoA durability and healer-attack suite: all six assertions
+  passed without reporter errors. Fastest sampled ordinary/final kills remain
+  26.2/48.6 seconds. WoW Druid's comparable eight/eighty attack samples now keep
+  the party alive with the revised HoT policy.
+- Validation: 167 combat/catalog/runtime regressions, four healer matrix
+  assertions, 47 avatar checks, TypeScript, the production build, and release
+  bundle validation passed. The final release hygiene check covers untracked
+  regression tests as well as tracked edits.
+- Live production-preview smoke check at 1280x720 used an offline Human Witch
+  Doctor (Brewing). Roster and Wailing Caverns entrance captures show the
+  player and companion bodies and starter weapon/shield silhouettes. This
+  visual check did not perform a live boss clear or validate manual rotations.
+  Evidence: `artifacts/boss-difficulty/coa-healer-smoke/roster.png` and
+  `artifacts/boss-difficulty/coa-healer-smoke/dungeon.png`.
+- Numerical evidence and remaining limitations:
+  `artifacts/boss-difficulty/coa-healer-balance.json`,
+  `artifacts/boss-difficulty/wow-coa-balance.json`, and
+  `artifacts/boss-difficulty/coa-healer-review.md`.
+
+## Primalist rage generation follow-up — September 13, 2026
+
+- Restored Geode Barrage's three physical stone pulses at cast completion,
+  +500ms, and +1000ms, using the ranked parent amount, 23% nature/spell power,
+  and 9% attack power. Each pulse dealing effective damage grants its caster
+  5 rage, for 15 from a full Barrage. Removed the unscheduled hidden placeholder
+  proc so another periodic event cannot substitute for or duplicate the stones.
+- The 5-rage stone amount is HealerMan's normalization using the related
+  imported Geode spell 804002 payload. Barrage's imported DBC does not expose
+  an exact rage amount; this does not establish exact server-script parity.
+  Dead targets and fully absorbed stones grant no rage. Player and companion
+  grants cap at the source pool maximum and synchronize the actor's pools.
+- Seismic Crash grants 20 rage once per cast and executes its initial damage
+  pulse. Seismic Spike grants 4 per target actually damaged. Primalist energize
+  effects retain their power type and convert internal rage units to displayed
+  points: Primal Rush and passive Protective Roar grant 20 rather than 200.
+  Protective Roar retains beneficial party recipients when its payload fires.
+- Scoped imported power-unit conversion to Primalist. A global conversion
+  caused a Bloodmage survival regression; other classes retain their existing
+  script-payload interpretation pending their own power-record review.
+- The benchmark policy considers all usable rage generators, including Crash
+  and Barrage, before rage heals. Normal gameplay still uses player input.
+  All 108 attacking-final-boss CoA healer samples now keep the entire party
+  alive, including the five previously failing low-level Primalist samples.
+  The regression requires zero companion deaths at every tested level.
+- Validation: 207 combat/catalog/runtime/avatar checks passed, including eight
+  focused Primalist checks for timing, coefficients, capped gains, absorbed and
+  dead targets, companion attribution, passive payloads, and Seismic gains.
+  All four strict healer matrix assertions passed. All six WoW/CoA boss suite
+  assertions passed across 1,464 durability runs and 26 attacking-boss samples;
+  fastest sampled ordinary/final kills remain 26.2/48.6 seconds. TypeScript,
+  the production build, release bundle validation, and release hygiene passed.
+- Live production-preview smoke check at 1280x720 used an offline female
+  Tauren Primalist (Life). Roster and Wailing Caverns entrance captures show
+  a character body with a staff and companion bodies with weapon silhouettes.
+  The Tauren identity rendered a human-looking fallback; the optional content
+  service was unavailable in this static preview. These captures establish
+  body/equipment visibility, not correct Tauren appearance. Entrance trash
+  reached level two with the full party alive. Barrage remained locked until
+  level six, so pulse/rage behavior was checked by deterministic runtime tests,
+  rather than a live manual Barrage cast. No live boss clear was performed.
+- Evidence: `artifacts/boss-difficulty/primalist-smoke/roster.png`,
+  `artifacts/boss-difficulty/primalist-smoke/dungeon.png`,
+  `artifacts/boss-difficulty/coa-healer-balance.json`,
+  `artifacts/boss-difficulty/wow-coa-balance.json`, and
+  `artifacts/boss-difficulty/coa-healer-review.md`. Survival at the 60-second
+  cap does not establish a boss clear or indefinite resource sustainability.
+
+## WoW action bars in Ability controls — September 13, 2026
+
+- Added Controller bars / WoW bars selection to Ability controls. On PC, the
+  dialog opens on WoW bars when that UI layout is enabled. The existing three
+  controller layers remain available through the same screen.
+- The WoW editor exposes all five bars and twelve buttons per bar, including
+  inactive bars. Slots show their saved keyboard shortcuts and assigned
+  abilities. Assigning or leaving a slot empty saves immediately through the
+  existing profile UI persistence path and updates the gameplay action bar.
+- Restore Bar resets that bar's abilities to the current character's class
+  defaults; Restore all WoW bars resets all sixty ability slots. Both use a
+  confirmation with cancellation. Keyboard shortcuts, bar geometry, PC/mobile
+  UI templates, and controller bindings remain independent of these resets.
+- Long WoW ability lists scroll inside the picker. Controller navigation keeps
+  the selected control visible. Future abilities retain their unlock-level
+  labels and can be assigned ahead of time; passive abilities are excluded.
+- Live 1280x720 production-preview QA used an isolated offline Human Priest
+  profile at port 5192. Verified first-slot assignment, inactive fifth-bar
+  button-twelve assignment and clearing, canceling a reset, restoring one bar
+  while retaining the fifth-bar assignment, and restoring all WoW bars.
+  Controller Cross retained Smite through the WoW edits and resets.
+- Enabled the WoW layout through Edit UI & templates, confirmed Ability controls
+  opened directly on WoW bars, and changed the first button to Lesser Heal.
+  The gameplay bar updated immediately. After a full page reload and dungeon
+  reentry, both the gameplay bar and editor retained Lesser Heal and key 1.
+  The final picker capture shows access to the late-level abilities and Leave
+  empty while all bar controls stay visible. No browser UI errors were logged.
+- Validation: all 55 UI-layout, action-binding, keybind, profile-sync, input,
+  HUD-layering, and panel-integration tests passed. The production build,
+  including TypeScript with the project's configured 8 GB heap, prebuild asset
+  audits, and postbuild release-bundle validation, passed. A separate manual
+  TypeScript attempt using Node's default heap exhausted memory; the standard
+  build completed successfully. Final release hygiene covers all changed paths.
+- Evidence: `artifacts/ability-controls/wow-bars.png`,
+  `artifacts/ability-controls/controller-bars.png`,
+  `artifacts/ability-controls/wow-picker.png`, and
+  `artifacts/ability-controls/wow-picker-end.png`. Cloud upload and physical
+  gamepad input were not exercised by this offline browser pass.

docs/WOW_DUNGEON_MAPS.md

@@ -0,0 +1,48 @@
+# WoW dungeon atlas
+
+Press **M** in a loaded WoW dungeon to open its original game map. The atlas
+shows a white player marker with camera direction, a green entrance, and gold
+numbered encounter markers. Patrol routes are optional. The minimap and companion
+map use the same artwork and coordinate projection.
+
+Multi-floor dungeons have a floor selector. Auto chooses the smallest containing
+map rectangle; it is a horizontal best fit, not the WoW client's WMO-group floor
+detection. Select a floor manually when stacked rooms overlap. Coordinates outside
+the selected floor are not clamped to a misleading marker at the map edge.
+
+The current import includes 51 standard WoW dungeons and 107 unique map images. The
+custom Tinkertech Showdown, Frozen Reach, and Forgotten Mine have no matching map
+records in the supplied archives and retain their survey maps. RuneWaker maps are
+unchanged. Missing images also fall back to the survey projection.
+
+## Reimporting
+
+Run `npm run dungeon:maps:import` from the HealerMan project root. An optional
+archive argument replaces the default `../downloads/patch-enUS-M.MPQ`.
+`WOW_CLIENT_ROOT` supplies the client archives for original Wrath map tiles;
+`WOW_DUNGEON_WORK_ROOT` supplies runtime drafts for alignment checks. Defaults
+are `../wow335a` and `../HealerMan-Storage/pipeline-work/dungeons`.
+
+The importer reads the patch and client archives without modifying them. It
+decodes BLP2 tiles into cropped 1002x668 PNGs, reads WorldMapArea/DungeonMap bounds,
+and inverts the reviewed scene coordinate mapper, including shifted ADT packages
+and rotated global WMOs. It verifies alignment against imported creature spawns
+or the source entrance for an event-driven arena without static actors.
+Wailing Caverns retains its authored coordinate convention.
+
+Images live in `public/assets/game/dungeons/<id>/maps/`, so existing dungeon
+content-pack rules include them. Runtime metadata is generated in
+`src/game/generated/wowDungeonMaps.generated.json`; provenance and coverage are in
+`dungeon-pipeline/WOW_DUNGEON_MAP_REPORT.json`. Changes to environment checksums or
+coordinate conventions require reimporting. Mapster is a Lua WoW-client addon;
+HealerMan does not execute or install it.
+
+After reimporting, run `npm run content:publish` to update the local downloadable
+content catalog and `npm run build` to refresh the bundled Wailing Caverns atlas.
+Those commands prepare local artifacts; they do not deploy the online game.
+
+## Verification
+
+Run `npm test -- --run src/game/wowDungeonMap.test.ts src/ui/DungeonMapGraphic.test.ts src/ui/MapPanel.test.ts`
+and `node --test scripts/lib/wow-map-image.test.mjs`. Visual evidence and observed
+limitations are recorded in `PLAYTEST_NOTES.md`.

dungeon-pipeline/WOW_DUNGEON_MAP_REPORT.json

@@ -0,0 +1,388 @@
+{
+  "source": "patch-enUS-M.MPQ",
+  "sourceSha256": "b69713077e19498d20efa5eeaefdba98850764db6bdc99e292bfbdf7b1c858d6",
+  "imported": [
+    {
+      "id": "shadowfang-keep",
+      "floors": 7,
+      "checkedSpawns": 109,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "stormwind-stockade",
+      "floors": 1,
+      "checkedSpawns": 93,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004000000000026205
+    },
+    {
+      "id": "deadmines",
+      "floors": 2,
+      "checkedSpawns": 179,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00005830951894693099
+    },
+    {
+      "id": "wailing-caverns",
+      "floors": 1,
+      "checkedSpawns": 251,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.188595526192965
+    },
+    {
+      "id": "razorfen-kraul",
+      "floors": 1,
+      "checkedSpawns": 179,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006573939954203296
+    },
+    {
+      "id": "blackfathom-deeps",
+      "floors": 3,
+      "checkedSpawns": 201,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "uldaman",
+      "floors": 2,
+      "checkedSpawns": 302,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "gnomeregan",
+      "floors": 4,
+      "checkedSpawns": 371,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "sunken-temple",
+      "floors": 3,
+      "checkedSpawns": 244,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "razorfen-downs",
+      "floors": 1,
+      "checkedSpawns": 192,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 5.084354071042896e-13
+    },
+    {
+      "id": "scarlet-monastery",
+      "floors": 4,
+      "checkedSpawns": 310,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "zulfarrak",
+      "floors": 1,
+      "checkedSpawns": 251,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "blackrock-spire",
+      "floors": 7,
+      "checkedSpawns": 565,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "blackrock-depths",
+      "floors": 2,
+      "checkedSpawns": 1040,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "scholomance",
+      "floors": 4,
+      "checkedSpawns": 327,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00009095950916596921
+    },
+    {
+      "id": "stratholme",
+      "floors": 2,
+      "checkedSpawns": 430,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 9.096057172999542e-13
+    },
+    {
+      "id": "maraudon",
+      "floors": 2,
+      "checkedSpawns": 525,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "ragefire-chasm",
+      "floors": 1,
+      "checkedSpawns": 127,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "dire-maul",
+      "floors": 6,
+      "checkedSpawns": 755,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006403124240144967
+    },
+    {
+      "id": "shattered-halls",
+      "floors": 1,
+      "checkedSpawns": 198,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006403124237426248
+    },
+    {
+      "id": "blood-furnace",
+      "floors": 1,
+      "checkedSpawns": 139,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006403124237384636
+    },
+    {
+      "id": "hellfire-ramparts",
+      "floors": 1,
+      "checkedSpawns": 85,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006753673068807912
+    },
+    {
+      "id": "steamvault",
+      "floors": 2,
+      "checkedSpawns": 127,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "underbog",
+      "floors": 1,
+      "checkedSpawns": 161,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.0000617170964964256
+    },
+    {
+      "id": "slave-pens",
+      "floors": 1,
+      "checkedSpawns": 122,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.0000640312423744012
+    },
+    {
+      "id": "arcatraz",
+      "floors": 3,
+      "checkedSpawns": 84,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "botanica",
+      "floors": 1,
+      "checkedSpawns": 171,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006403124237384636
+    },
+    {
+      "id": "mechanar",
+      "floors": 2,
+      "checkedSpawns": 84,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.000046699999999996744
+    },
+    {
+      "id": "shadow-labyrinth",
+      "floors": 1,
+      "checkedSpawns": 189,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00006403124237426248
+    },
+    {
+      "id": "sethekk-halls",
+      "floors": 2,
+      "checkedSpawns": 104,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00005324368507145524
+    },
+    {
+      "id": "mana-tombs",
+      "floors": 1,
+      "checkedSpawns": 119,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.000056568542495137386
+    },
+    {
+      "id": "auchenai-crypts",
+      "floors": 2,
+      "checkedSpawns": 93,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00005415025392387915
+    },
+    {
+      "id": "magisters-terrace",
+      "floors": 2,
+      "checkedSpawns": 147,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00007071067811848996
+    },
+    {
+      "id": "black-morass",
+      "floors": 1,
+      "checkedSpawns": 134,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "escape-from-durnholde",
+      "floors": 1,
+      "checkedSpawns": 380,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "utgarde-keep",
+      "floors": 3,
+      "checkedSpawns": 112,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004700000000001925
+    },
+    {
+      "id": "utgarde-pinnacle",
+      "floors": 2,
+      "checkedSpawns": 83,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "the-nexus",
+      "floors": 1,
+      "checkedSpawns": 234,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "the-oculus",
+      "floors": 5,
+      "checkedSpawns": 112,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "culling-of-stratholme",
+      "floors": 2,
+      "checkedSpawns": 209,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "halls-of-stone",
+      "floors": 1,
+      "checkedSpawns": 76,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "draktharon-keep",
+      "floors": 2,
+      "checkedSpawns": 99,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "azjol-nerub",
+      "floors": 3,
+      "checkedSpawns": 70,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "halls-of-lightning",
+      "floors": 2,
+      "checkedSpawns": 112,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "gundrak",
+      "floors": 2,
+      "checkedSpawns": 85,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "violet-hold",
+      "floors": 2,
+      "checkedSpawns": 8,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "ahnkahet-old-kingdom",
+      "floors": 1,
+      "checkedSpawns": 133,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004999999999988347
+    },
+    {
+      "id": "forge-of-souls",
+      "floors": 1,
+      "checkedSpawns": 41,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "trial-of-the-champion",
+      "floors": 1,
+      "checkedSpawns": 0,
+      "checkedEntrances": 1,
+      "maxAlignmentError": 0
+    },
+    {
+      "id": "pit-of-saron",
+      "floors": 1,
+      "checkedSpawns": 167,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0.00004000000000026205
+    },
+    {
+      "id": "halls-of-reflection",
+      "floors": 1,
+      "checkedSpawns": 13,
+      "checkedEntrances": 0,
+      "maxAlignmentError": 0
+    }
+  ],
+  "skipped": [
+    {
+      "id": "tinkertech-showdown",
+      "reason": "No matching WorldMapArea record"
+    },
+    {
+      "id": "frozen-reach",
+      "reason": "No matching WorldMapArea record"
+    },
+    {
+      "id": "forgotten-mine",
+      "reason": "No matching WorldMapArea record"
+    }
+  ],
+  "coordinateSources": [
+    "WorldMapArea.dbc",
+    "DungeonMap.dbc"
+  ],
+  "layoutSource": "https://github.com/wowgaming/3.3.5-interface-files/blob/main/WorldMapFrame.xml",
+  "archives": [
+    "patch-enUS-M.MPQ",
+    "patch-enUS-3.MPQ",
+    "patch-enUS.MPQ",
+    "patch-enUS-2.MPQ"
+  ]
+}

dungeon-pipeline/WOW_ENVIRONMENT_REVIEW.md

@@ -0,0 +1,119 @@
+# WoW dungeon lighting and stair review - 2026-09-13
+
+## Implemented coverage
+
+All 54 campaign WoW dungeons now receive environment-specific lighting using
+Stockades' reviewed ambient/hemisphere fill as the baseline. Stone, cavern,
+fire, arcane, crypt, and outdoor profiles preserve atmosphere without applying
+the old dark expansion palettes. Stockades' existing presentation and three
+reviewed stair proxies remain unchanged. RuneWaker environments are excluded.
+
+The fleet scan produced 347 additional collision-verified walking proxies in
+22 dungeons, and eight filled Recast boundary bridges in Uldaman. This makes
+350 walking proxies including the three existing Stockades flights. Visual
+stairs remain steps: source visual/collision/navigation GLBs were not modified.
+The shared prepared collision is used by players, companions, and enemies.
+
+| Dungeon | Additional walking proxies | Additional navigation bridges |
+| --- | ---: | ---: |
+| Shadowfang Keep | 41 | 0 |
+| Blackfathom Deeps | 5 | 0 |
+| Uldaman | 5 | 8 |
+| Gnomeregan | 4 | 0 |
+| Sunken Temple | 2 | 0 |
+| Scarlet Monastery | 37 | 0 |
+| Zul'Farrak | 1 | 0 |
+| Scholomance | 36 | 0 |
+| Stratholme | 12 | 0 |
+| Blood Furnace | 1 | 0 |
+| Shadow Labyrinth | 1 | 0 |
+| Mana-Tombs | 3 | 0 |
+| Auchenai Crypts | 5 | 0 |
+| Magister's Terrace | 10 | 0 |
+| Escape From Durnholde | 120 | 0 |
+| Utgarde Keep | 8 | 0 |
+| Utgarde Pinnacle | 32 | 0 |
+| Culling of Stratholme | 11 | 0 |
+| Halls of Stone | 2 | 0 |
+| Halls of Lightning | 1 | 0 |
+| Pit of Saron | 1 | 0 |
+| Halls of Reflection | 9 | 0 |
+
+The machine-readable `src/game/generated/wowDungeonStairs.generated.json`
+records a scan for every WoW dungeon, including entries with no accepted new
+proxy, collision package identities, candidate/rejection counts, and exact
+navigation portals. Authored Wailing Caverns is scanned against its actual
+source assets, rather than the campaign's separate canonical package.
+
+## Safety and verification
+
+- Require repeated short risers with consistent rise/run and overlapping width.
+- Merge compatible continuous flights; independently verify short fallbacks
+  when a merged flight is unsafe.
+- Rebuild after rejected proxies are removed, so accepted paths do not depend
+  on rejected geometry edits.
+- Check real terrain support and capsule sweeps uphill/downhill along the center
+  and two interior lateral lanes at approximately 0.35m intervals.
+- Fill only separate existing boundary portals wholly within a verified flight.
+  Do not invent off-mesh links across unrelated floors or walls.
+- Gate generated coordinates by collision package URL/checksum identity, and
+  navigation identity where exact portal bridges are present.
+- Keep existing validation/availability gates unchanged. Stair checks do not
+  certify boss routes, encounters, resets, checkpoints, or complete runs.
+- Spatially index ramp footprints during preparation to avoid checking every
+  ramp against every vertex in large, multi-chunk environments.
+
+The shipping-asset regression tests independently exercise all 347 new proxies
+through `prepareCollision` and the live NPC direct-segment validator in both
+directions and all three tested lanes. All generated portals match the actual
+shipping navigation vertices. Existing Stockades player/NPC/wall regressions pass.
+
+Full validation: 247 Vitest files passed, 1,599 tests passed, six existing tests
+skipped. Production TypeScript/Vite build, texture/performance audits, bundle
+compression/verification, and release candidate checking passed. Existing
+physics initialization and bundle-size/import advisories remain.
+
+## Visual evidence and remaining QA
+
+The local visual viewer uses the runtime definitions/material policy, shipped
+GLBs, Meshopt/KTX2 decoding, ACES tone mapping, and 1280x720 screenshots. It does
+not modify saved characters or party state. Evidence is under
+`artifacts/wow-dungeon-environment/` (ignored QA artifacts).
+
+Uldaman's new/old-fill comparison shows clearer stone walls, columns, and floor
+tiles. Wailing Caverns retains green coloration with readable rock formations.
+Mechanar retains cool purple/blue interiors and unchanged visible steps.
+Scholomance's entrance stairs and masonry remain visible with the crypt profile.
+Blood Furnace's dark source textures remain atmospheric; the entrance viewpoint
+faces a nearby wall, so this is not a full-room traversal review.
+
+Zul'Farrak showed a geometry/viewpoint gap in the standalone entrance and boss
+views. Do not treat its lighting profile or passing isolated proxy sweep as an
+end-to-end visual/playability pass. Durnholde's large package completed loading
+without console errors; its cavern entrance and outdoor fort masonry/trees were
+readable, but the boss viewpoint also showed missing terrain/viewpoint coverage.
+That environment needs a separate terrain/spawn review and live traversal check.
+
+This is not an exhaustive certification that every staircase is repaired.
+Conservative repeated-riser detection can miss curved flights, one/two-step
+transitions, and heavily decimated source geometry. A rejected candidate may be
+decorative, lack headroom/ground, or require an individually reviewed footprint.
+An entry with no new proxy is not proof that it contains no stairs. Full-dungeon
+actor traversal, entrance/exit lips, outer stair edges, manual review of rejected
+or undetected flights, full clears, and physical Android QA remain open.
+
+## Repeating the checks
+
+Requires the project's Node 24 runtime for native TypeScript pipeline execution.
+
+```text
+npm run dungeon:wow:stairs:audit
+npm run dungeon:wow:stairs:refresh
+npm run dungeon:wow:stairs:audit -- scholomance --diagnostics
+node scripts/dungeon-pipeline/audit-wow-stairs.ts wailing-caverns --update
+npm test -- --run src/game/wowDungeonStairAssets.test.ts
+```
+
+The audit is read-only by default. Refresh writes the full generated catalog;
+`--update` replaces only the named entry while retaining the other entries.
+Campaign regeneration does not erase the runtime lighting/stair adapter.

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "healer-man",
-  "version": "0.1.38",
+  "version": "0.1.42",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "healer-man",
-      "version": "0.1.38",
+      "version": "0.1.42",
       "dependencies": {
         "@capacitor/android": "8.4.1",
         "@capacitor/core": "8.4.1",

package.json

@@ -1,7 +1,7 @@
 {
   "name": "healer-man",
   "private": true,
-  "version": "0.1.38",
+  "version": "0.1.42",
   "type": "module",
   "scripts": {
     "dev": "vite --host 0.0.0.0",
@@ -45,6 +45,7 @@
     "dungeon:epoch:sync": "node scripts/dungeon-pipeline/sync-epoch-dungeons.mjs",
     "dungeon:source:azerothcore": "node scripts/dungeon-pipeline/import-azerothcore-world.mjs",
     "dungeon:catalog": "node scripts/dungeon-pipeline/compile-campaign-catalog.mjs",
+    "dungeon:maps:import": "node scripts/dungeon-pipeline/import-wow-maps.mjs",
     "dungeon:canonicalize-environments": "node scripts/dungeon-pipeline/relink-canonical-environments.mjs",
     "dungeon:dedupe-creatures": "node scripts/dungeon-pipeline/dedupe-shared-creatures.mjs",
     "dungeon:test-creature-animation-policy": "node --test scripts/dungeon-pipeline/runtime-creature-animations.test.mjs",
@@ -56,6 +57,8 @@
     "dungeon:five-player:verify": "node scripts/dungeon-pipeline/verify-five-player-dungeon-imports.mjs",
     "dungeon:wow:audit": "vite-node scripts/dungeon-pipeline/audit-wow-dungeon-content.mjs",
     "dungeon:wow:functionality:audit": "vite-node scripts/dungeon-pipeline/audit-wow-dungeon-functionality.ts",
+    "dungeon:wow:stairs:audit": "node --max-old-space-size=8192 scripts/dungeon-pipeline/audit-wow-stairs.ts",
+    "dungeon:wow:stairs:refresh": "node --max-old-space-size=8192 scripts/dungeon-pipeline/audit-wow-stairs.ts --write",
     "dungeon:wow:test": "vitest run src/game/wowDungeonContent.test.ts",
     "dungeon:wow:export-tool:test": "node --test scripts/dungeon-pipeline/wow-export-tool.test.mjs",
     "dungeon:ascension:recovery:validate": "node scripts/dungeon-pipeline/validate-ascension-custom-dungeon-recovery.mjs --skip-dbc",