Release Healer Man 0.1.14

.gitignore

@@ -20,5 +20,6 @@ releases/
 /content/
 dist-android/
 .android-public/
+.web-public/
 __pycache__/
 *.pyc

BALANCE_BENCHMARKS.md

@@ -0,0 +1,52 @@
+# Balance benchmarks
+
+The balance benchmark suite provides repeatable evidence for tuning World of Warcraft, CoA, and Runes of Magic classes. It runs fixed builds through versioned damage, tanking, healing, movement, stacking, and resource-endurance scenarios. The goal is to reveal balance changes and outliers, not to name a universally best class.
+
+## Default cohort
+
+The default comparison cohort is level 60, matching CoA's authored cap while keeping the three content sources in one cohort. It uses the `coefficient-empty` preset: no equipment, so the first cohort isolates base kits, scaling coefficients, talents, and resources. Gear-normalized cohorts should be added separately rather than mixed with this one.
+
+Every comparison must use the same gear preset, scenario version, baseline policy ID, duration scale, and seed set. A changed level, gear preset, scenario, policy, or app version creates a new cohort and should not be compared directly with an older one.
+
+Run the suite with:
+
+```sh
+npm run balance:benchmark
+```
+
+Use `npm run balance:smoke` for a short end-to-end check. The full command accepts comma-separated `--class`, `--role`, `--scenario`, and `--seeds` filters, plus `--level`, `--duration-scale`, and `--output`. For example:
+
+```sh
+npm run balance:benchmark -- --class priest,rom-priest --role healer --seeds 1,2,3
+```
+
+The command is the intended stable entry point for the benchmark runner. Its output directory contains:
+
+- `matrix.json`: raw run reports, build and scenario definitions, seed metadata, validation results, ability details, resources, and event counts.
+- `matrix.csv`: one row per scenario, build, and metric, with observed/null counts plus median, p10, and p90 values.
+- `summary.md`: a concise role-separated comparison for review and pull-request evidence.
+
+Keep the JSON artifact when investigating a result. The CSV and Markdown are derived views and can be regenerated from it.
+
+## Reading results
+
+The reported center is the median across validated seeded runs. The p10–p90 interval shows run-to-run spread; a wide interval calls for more seeds or investigation before tuning. Invalid runs are counted but excluded from distributions. An early death or other scenario stop can be a valid outcome and should not be discarded merely because the full duration was not reached.
+
+Interpret each role as a vector of outcomes, not a single ranking:
+
+- Damage builds emphasize DPS and priority-target damage, with deaths and mechanics failures alongside throughput.
+- Tanks emphasize damage taken per second, mitigation, avoidance, threat control, minimum health, survival, and their damage contribution.
+- Healers emphasize healing per second, consumed absorbs, overheal, party health, deaths, and time to resource failure.
+- Movement and stack scenarios add movement interrupts and stack compliance to the relevant role vector.
+
+No composite score is produced. Compare a build only with other builds in the same scenario version and cohort, and inspect the underlying metrics before making a balance change. A null time to resource failure means the resource was not exhausted during that run; it is not zero. Similarly, a null time to first death means no death occurred.
+
+## Limitations
+
+- The baseline policy is a deterministic, maintainable reference policy, not an optimal player rotation. Skilled play may outperform it, and policy changes can move results without a class-data change.
+- The initial `coefficient-empty` cohort does not model production gear breakpoints or itemization. Add explicit equal-budget gear presets for that work.
+- Runes of Magic coverage is primary-class-only initially. Secondary-class and dual-class interactions require their own explicitly versioned cohort when supported.
+- Results cover mechanics represented by the simulator and scenarios; they do not replace live encounter playtesting, usability review, or PvP testing.
+- Small seed sets can miss rare random outcomes. Treat p10 and p90 as descriptive bounds for the sampled runs, not guarantees.
+- Total metrics depend on scenario duration. Compare rates or fixed-duration totals only within the same scenario definition.
+- Gear-stat budgets must be equivalent, but equivalent budgets do not guarantee identical interactions with every class kit.

CONTENT_UPDATES.md

@@ -1,10 +1,12 @@
-# Local-first content updates and Android releases
+# Local-first content updates for browser and Android
 
-Healer Man separates the installed game client from large game content. The
-Android APK contains the React/Three.js runtime, native Android bridge, menus,
-local profile and save support, UI assets, and the Wailing Caverns starter
-pack. Other GLBs, textures, audio, character packs, dungeons, and Manastorm
-stages are published by TrueNAS as optional content.
+Healer Man separates the installed game client from large game content. Both
+the production browser build and Android APK contain a compact required set:
+the React/Three.js runtime, menus, local profile and save support, UI assets,
+starter equipment, Wailing Caverns starter content, and the basic Human
+character model with its default male and female appearances. Android also
+contains its native bridge. Other GLBs, textures, audio, character/skin packs,
+dungeons, and Manastorm stages are published by TrueNAS as optional content.
 
 Single-player is local-first. Starting the game, loading a character, entering
 installed content, simulating combat, and saving progress never require the
@@ -27,16 +29,12 @@ UI behavior, shaders or loaders, native Android code, permissions, or the
 content-manifest schema. A manifest can set `minimumAppVersion` so an older APK
 will not activate incompatible content.
 
-The browser build remains a full build served by TrueNAS. It receives client
-code when the app checkout is pulled, rebuilt, and restarted. The Android build
-is deliberately separate and compact so the APK does not inherit the complete
-multi-gigabyte browser asset catalog.
-
-Measured on August 14, 2026, the production browser `dist` is 3.88 GiB across
-18,895 files; GLBs account for 3.75 GiB. The compact Android `dist-android` is
-148.0 MiB across 5,561 files, including 47.8 MiB of starter GLBs. The final
-signed APK will be smaller because Android packages compress eligible files;
-record its exact size after the first release build.
+Production builds deliberately stage only required content. `npm run build`
+prepares `.web-public` and emits the compact browser `dist`; Android prepares
+`.android-public` and emits `dist-android`. The development server continues to
+use the source `public` tree so asset-pipeline work remains convenient. The
+complete source catalog and published immutable objects stay on TrueNAS, not in
+every player's initial browser or Android installation.
 
 ## Content manifest
 
@@ -56,8 +54,9 @@ The runtime continues to request stable paths such as:
 ```
 
 The content resolver maps that path to a verified file in Android app-private
-storage. Filenames are therefore not used as version numbers and runtime code
-does not need to know the hash.
+storage or, in production browsers, to the app-managed content cache through a
+same-origin service worker. Filenames are therefore not used as version numbers
+and runtime code does not need to know the hash.
 
 ## Safe publication and activation
 
@@ -68,17 +67,34 @@ Publication order is intentionally atomic:
 3. Write the versioned manifest.
 4. Replace `manifest.json` only after all referenced objects exist.
 
-On a device, the client fetches the small manifest and compares it with its
-installed manifest. Only missing or hash-mismatched objects are downloaded.
-Android streams each object to a `.part` file, supports HTTP range resume,
-verifies its size and SHA-256, then renames it into the object cache. The active
-logical-path map changes only after the complete pack verifies. An interrupted
-or corrupt update leaves the previous pack playable.
+The client fetches the small manifest and compares it with its bundled and
+installed file identities. Only missing or hash-mismatched objects are
+downloaded. Browsers download into a temporary Cache Storage staging area,
+verify every object's byte count and SHA-256, and promote the pack to the active
+cache only after the complete pack succeeds. Android streams each object to a
+`.part` file, supports HTTP range resume, verifies its size and SHA-256, then
+renames it into the object cache. An interrupted or corrupt update leaves the
+previous pack playable on either platform.
 
-The starter pack is bundled into the APK. Downloaded packs live under Android's
-app-private files directory, outside the packaged web bundle, and survive an
-APK update. Players may remove optional packs through the content manager; save
-data is stored separately and is never removed with content.
+The Downloads screen uses the same lifecycle in browser and Android. A missing
+pack offers **Download**, an installed pack with changed files offers
+**Update**, and an installed optional pack offers **Remove**. Required packs are
+marked as included and cannot be removed. Browser packs live in the app-managed
+cache; Android packs live in app-private storage and survive APK updates. Save
+data and roster identities are stored separately and are never removed with
+content.
+
+Character packs are presentation-only. When a selected race's pack is absent,
+removed, disabled, or fails to load, the shared character renderer uses the
+matching-gender basic Human model and default appearance. The saved race, class,
+equipment, progression, and appearance choices remain intact and become visible
+again after the pack is installed.
+
+Generated spell effects and synthesized combat cues are the default. The
+`core:combat-media` pack containing packaged original spell visuals and sounds
+is never part of required bootstrap content. Original mode becomes available
+only after an explicit download and falls back to generated effects if the pack
+is later removed.
 
 ## Offline behavior
 
@@ -87,6 +103,8 @@ data is stored separately and is never removed with content.
 - The last verified content map is read synchronously from local storage.
 - A failed update check is silent outside the content manager.
 - A failed or interrupted download never replaces active content.
+- Missing optional character packs fall back to the basic Human model.
+- Generated spell effects remain available without original spell media.
 - Local saves are authoritative during play and cloud synchronization retries
   when connectivity returns.
 - Content that has never been downloaded is clearly marked as unavailable
@@ -104,9 +122,10 @@ Keeping the runtime in the APK is what makes offline startup reliable.
 /mnt/usbssds/apps/healer-man/backups   Database backups
 ```
 
-The Node server exposes the content volume at `/content`. Manifests use
-`no-cache`; immutable hashed objects use long-lived cache headers and support
-byte ranges for resumed downloads.
+The Node server exposes the compact production browser client at `/` and the
+complete downloadable-content volume at `/content`. Manifests use `no-cache`;
+immutable hashed objects use long-lived cache headers and support byte ranges
+for resumed downloads.
 
 After pulling source on TrueNAS, publish content before restarting the app:
 
@@ -121,15 +140,29 @@ discover a manifest whose files have not been published.
 ## Pack policy
 
 Packs are player-facing groups while files remain individually addressable.
-This permits a fast initial pack install and small later patches. Current pack
-IDs are derived predictably:
+This permits a compact initial install and small later patches. Required pack
+IDs include:
 
 ```text
+core:runtime
+core:ui
+core:equipment
+core:character-basic
 dungeon:wailing-caverns
+```
+
+`core:character-basic` owns the two basic Human rigs, the character manifest,
+and only the default texture selections needed by the fallback. The remaining
+human customizations and every non-Human character model/skin are optional.
+
+Downloadable pack IDs include:
+
+```text
 dungeon:forsaken-abbey
 characters:wow335a-v1
 characters:ascension-v1
 characters:runewaker-v1
+core:combat-media
 manastorm:<stage-id>
 shared:creatures
 ```

DEPLOYMENT.md

@@ -24,8 +24,9 @@ container, rebuilding `dist`, or pulling source must not replace the database.
 TrueNAS Gitea stores the source repository and APK release attachments; it is
 not the game database.
 
-Large runtime assets are published separately under `/app/content`. Android
-clients download verified content objects from `/content` and retain them in
+Large runtime assets are published separately under `/app/content`. Production
+browser and Android clients download verified content objects from `/content`;
+browsers retain them in an app-managed cache and Android retains them in
 app-private storage for offline play. See `CONTENT_UPDATES.md` for the manifest,
 atomic activation, compatibility, and rollback contract.
 
@@ -55,9 +56,10 @@ Container/host port:
 ```
 
 The Gitea bare repository is not runnable. Clone it with Git; never copy it
-with `cp`. The checkout contains several gigabytes of required GLB assets, so
-the initial clone and first build will take substantially longer than later
-fast-forward updates.
+with `cp`. The checkout contains several gigabytes of content-source GLB assets,
+so the initial clone and first content publication will take substantially
+longer than later fast-forward updates. Production browser and Android bundles
+stage only their compact required-content subset.
 
 Do not turn the GLBs into Git LFS pointers without also changing this deployment
 procedure. Gitea keeps LFS objects outside the bare repository, so a bare-path
@@ -80,7 +82,8 @@ git branch --show-current
 
 If the repository slug differs, change both the remote URL here and every
 `healer-man.git` bare-repository path below. Do not commit `.env` files,
-keystores, API tokens, `content`, `dist`, `dist-android`, or `.android-public`.
+keystores, API tokens, `content`, `dist`, `dist-android`, `.web-public`, or
+`.android-public`.
 
 On TrueNAS, confirm the bare repository path. If the first command fails, use
 the search command:
@@ -154,8 +157,9 @@ account/cloud-save data; `/app/content` owns downloadable manifests and
 immutable content objects. Never mount a volume at `/app/data`, because that
 would hide the checkout's required `/app/data/loot/schema.sql`. The
 startup command installs locked dependencies, initializes the schema, publishes
-new or changed content objects, builds the full browser bundle, and starts the
-combined static/API/content server. Existing content objects are reused.
+new or changed content objects, builds the compact required-content browser
+bundle, and starts the combined static/API/content server. Existing content
+objects are reused.
 
 After startup, test on the LAN:
 
@@ -220,8 +224,8 @@ git rev-parse HEAD
 
 Before `git commit`, read the staged file list printed by `git status --short`.
 Do not commit a `.env` file, password, API token, keystore, APK, database,
-`content/`, `dist/`, `dist-android/`, or `.android-public/` output. The final
-command prints the exact deployed commit ID.
+`content/`, `dist/`, `dist-android/`, `.web-public/`, or `.android-public/`
+output. The final command prints the exact deployed commit ID.
 
 Next, open the TrueNAS Apps UI and **stop** `healer-man`. Open a TrueNAS shell
 and run these exact commands:
@@ -247,11 +251,12 @@ sudo git -C /mnt/usbssds/apps/healer-man/app rev-parse HEAD
 The TrueNAS commit ID must match the one printed on the development PC. Start
 `healer-man` in the TrueNAS Apps UI afterward. Container startup
 publishes immutable content objects and replaces `manifest.json` only after all
-objects exist, then rebuilds the browser client and starts the server. Android
-devices discover the small new manifest and download only missing or changed
-files. Asset-only updates do not require a new APK. A failed fast-forward pull
-deliberately leaves the running checkout unchanged; resolve diverged history on
-the development machine rather than forcing the TrueNAS checkout.
+objects exist, then rebuilds the browser client and starts the server. Browser
+and Android clients discover the small new manifest and download only missing
+or changed files for packs the player installed. Asset-only updates do not
+require a new APK. A failed fast-forward pull deliberately leaves the running
+checkout unchanged; resolve diverged history on the development machine rather
+than forcing the TrueNAS checkout.
 
 After the logs say the server is listening on port `4173`, run on TrueNAS:
 
@@ -286,9 +291,10 @@ copies; it does not replace dataset-level protection.
 ## APK releases and Obtainium
 
 Keep APK binaries out of the Git branch. The Android build uses `dist-android`,
-which contains the game runtime, UI, equipment, and Wailing Caverns starter
-content rather than the full multi-gigabyte browser catalog. Downloaded packs
-survive APK updates.
+which contains the game runtime, UI, starter equipment, basic Human character,
+and Wailing Caverns starter content. Optional character/skin packs, original
+spell media, dungeons, and other large content remain outside the APK.
+Downloaded packs survive APK updates.
 
 Install JDK 21 and Android SDK Platform 36 on the development PC and set
 `JAVA_HOME` plus `ANDROID_SDK_ROOT`. The build wrapper also recognizes the

PLAYTEST_NOTES.md

@@ -1451,3 +1451,206 @@ Vite's existing large-chunk advisory remains informational.
   passed all 755 cases across 132 files (including the 28 avatar cases), and the
   TypeScript production build completed successfully with 983 modules
   transformed. The existing large-chunk advisory remains informational.
+
+# 2026-08-28 — configurable render caps and idle-loop efficiency
+
+- Opened the saved Human Priest roster after a fresh client reload. The full
+  body and starter staff rendered correctly in the single character-preview
+  canvas, which reported the persisted 30 FPS preview cap and manual frame loop.
+- Entered Wailing Caverns as healer and exercised the gameplay setting live.
+  The performance probe settled at about 30.5 FPS for the 30 FPS option and 60
+  FPS for the 60 FPS option; combat and fixed-step physics continued normally.
+- Pausing switched the dungeon canvas to demand rendering. Its performance
+  counters remained byte-for-byte unchanged over 1.4 seconds, confirming that
+  the local paused scene did not keep rendering in the background.
+- Returned gameplay rendering to the default 60 FPS and left the character
+  preview at 30 FPS. Evidence reviewed during the browser run included the
+  roster-preview and live dungeon screenshots. The final fresh session emitted
+  no errors; the existing third-party initialization deprecation warning
+  remained non-blocking.
+- Verification: the focused efficiency tests passed all 83 cases, all 28 avatar
+  tests passed, the complete Vitest suite passed all 809 cases across 148 files,
+  and the production build completed with 1,043 modules transformed. KTX2 and
+  environment-performance audits remained green; the existing large-chunk
+  advisory remains informational.
+
+# 2026-08-30 — authored weapon grips and ready stances
+
+- Reloaded the offline client and switched a Human female preview directly
+  between Hunter, Warrior, and Priest. The bow, sword/shield, and staff changed
+  immediately to their native HoldBow, Ready1H, and Ready2HL poses; no stale
+  class pose or backward procedural axis remained.
+- Verified RuneWaker Human Warrior and Scout previews against their explicit
+  hand/shield locator frames. The one-hand, shield, and bow silhouettes used the
+  RuneWaker socket-axis adapter and remained proportionate to the character.
+  Also checked the Ascension Human Ranger fallback with its bow visible in a
+  supported ready pose.
+- The saved Human Priest roster preview showed the complete body and staff with
+  both hands aligned to the shaft. In Wailing Caverns, the player and party
+  equipment remained attached through live combat animation without a second
+  local weapon swing or load-time placement jump.
+- Evidence: `playtest-artifacts/2026-08-30-weapon-grip/weapon-grip-roster.png`,
+  `human-hunter-holdbow.png`, `human-warrior-ready1h.png`,
+  `human-priest-ready2hl.png`, `runewaker-warrior-sockets.png`,
+  `runewaker-scout-bow.png`, `ascension-ranger-bow.png`, and
+  `weapon-grip-dungeon.png`.
+- Verification: all 41 avatar tests passed, the 37-test focused weapon/stance
+  suite passed, and the production build completed with 1,047 modules
+  transformed. Asset audits remained green with zero KTX2 fallbacks and zero
+  environment-performance regressions; the existing large-chunk advisory
+  remains informational.
+
+# 2026-08-30 — bounded combat VFX bursts and silent audio default
+
+- Created a fresh offline Human Priest and confirmed the in-game Options panel
+  opened with **Master volume** at 0%. Gameplay and preview frame-rate controls,
+  VFX quality, and per-actor VFX/audio controls remained available.
+- Entered Wailing Caverns as healer, sent the party into combat, and captured a
+  live four-effect spell burst. High quality reported four active effect systems
+  and zero combat point lights; additive particles, impacts, melee arcs, the HUD,
+  and combat telegraphs remained visible.
+- The captured burst reported 60 FPS, a 16.7 ms average frame, a 16.8 ms slowest
+  frame, 258 draw calls, and 353,526 triangles at 1.5 pixel ratio. A three-second
+  combat sample reached five concurrent effects, stayed between 54.1 and 60 FPS,
+  and returned to a 16.7 ms frame average.
+- A cold Vite dynamic import failed once while first opening character creation;
+  reloading after compilation resolved it. The final dungeon run had no further
+  errors; the existing third-party initialization deprecation warning remained.
+- Verification: the complete Vitest suite passed all 839 cases across 153 files,
+  the production build completed with 1,047 modules transformed, KTX2 and
+  environment-performance audits remained green, and the release-candidate
+  check passed. The existing large-chunk advisory remains informational.
+
+# 2026-08-31 — Shadowfang Keep navigation freeze regression
+
+- Reproduced the reported freeze with the saved Human Priest at the Shadowfang
+  Keep entrance. The visible scene fell to roughly 4–11 FPS with 91–225 ms
+  average frames and repeated 500+ ms slow frames, without a runtime exception.
+- Traced the stall to synchronous construction of the provisional 545,171-
+  triangle party-navigation graph after the dungeon became visible. A direct
+  benchmark blocked the main thread for roughly 8 seconds and consumed about
+  800 MiB of heap; its subsequent entrance surface/path queries also failed.
+- Added a navigation policy that keeps reviewed, budgeted graphs enabled while
+  unvalidated or over-50,000-triangle graphs use the existing local and
+  breadcrumb party-follow fallback. Shadowfang therefore avoids the unusable
+  graph, while Wailing Caverns retains its reviewed navigation.
+- Re-entered Shadowfang from a clean reload and kept the live scene open beyond
+  the former graph-build window. Eight consecutive samples held 59–60 FPS at
+  about 16.7 ms per frame; the slowest final sampled frame was 25.8 ms. The party,
+  HUD, minimap, combat state, and full environment remained responsive and
+  visible in the reviewed screenshot. No new browser errors were emitted.
+- Verification: all 20 focused navigation cases passed, the complete Vitest
+  suite passed all 844 cases across 154 files, the production build completed
+  with 1,048 modules transformed, KTX2 and environment-performance audits
+  remained green, and the release-candidate check passed. The existing
+  large-chunk advisory remains informational.
+
+# 2026-08-31 — dungeon-fleet startup freeze audit
+
+- Audited the complete registered fleet: 84 regular-dungeon navigation assets,
+  all 75 Manastorm package assets, and all 470 published Manastorm stages. Every
+  referenced navigation GLB exists and parses. Under the reviewed 50,000-
+  triangle policy, 31 regular and 41 Manastorm package graphs remain enabled;
+  the other 53 regular and 34 Manastorm packages use breadcrumb following.
+- Added an actual-geometry triangle check before navigation allocations. This
+  prevents stale catalog metadata from bypassing the synchronous-build ceiling;
+  Wailing Caverns metadata was corrected from 32,077 to 45,732 triangles.
+- Found nine zero-length imported patrol routes that could throw during scene
+  render: one in Scholomance, two in Botanica, two in Magister's Terrace, and
+  four in Escape from Durnholde. Catalog generation now preserves those actors
+  as static spawns, and runtime normalization provides the same defense for
+  future malformed imports. All remaining 752 regular patrols and every
+  effective Manastorm stage patrol have usable routes.
+- Live entrance checks loaded Scholomance, Escape from Durnholde, and Forgotten
+  Mine without a scene error or startup freeze. Scholomance settled near 28.5
+  FPS at 946 draw calls; Durnholde near 29 FPS at 3,663 draw calls; Forgotten
+  Mine near 50 FPS at 1,502 draw calls after staged loading. These identify
+  remaining environment/population throughput work, but are separate from the
+  fixed startup-crash and synchronous-navigation failure modes.
+- Verification: the complete Vitest suite passed all 850 cases across 155
+  files, the production build completed with 1,048 modules transformed, all
+  106 environment assets passed their performance audit with no regressions,
+  the KTX2 audit found no fallback textures, and the release-candidate check
+  passed. The existing large-chunk advisory remains informational.
+
+# 2026-09-04 — optional content offload and basic Human fallback
+
+- Built and served the production browser output from a clean localhost origin.
+  A fresh Undead female Priest preview rendered with the real bundled Human
+  female rig and default textures while retaining the Undead/Priest identity in
+  the roster. No optional character pack had been installed.
+- Entered Wailing Caverns as healer from a separate clean browser origin. The
+  Undead player, Undead tank, and Goblin party member all rendered through the
+  matching basic Human fallbacks while their saved race, role, class, equipment,
+  and party labels remained intact. The dungeon stayed playable and emitted no
+  new error; only the existing third-party initialization deprecation warning
+  appeared.
+- Exercised the browser Downloads lifecycle with a small local two-revision
+  content fixture. Missing character and original-media packs showed Download;
+  a verified install showed Remove; the changed revision showed Update and
+  Remove together; and applying Update returned the pack to offline-ready state.
+- Reloaded after service-worker activation. The application and lazy JavaScript
+  chunks loaded normally, while the content worker continued to reserve managed
+  character, creature, equipment, game, and UI paths for bundled or verified
+  cached content. The initial broad `/assets/` interception found during this
+  playtest was corrected before the final run.
+- In-dungeon Options showed Generated as the active default, kept Original
+  disabled until its optional spell-effects-and-sounds pack is downloaded, and
+  exposed a Download action for that pack.
+- Evidence:
+  `playtest-artifacts/2026-09-04-optional-content/roster-undead-priest-basic-human-fallback.png`,
+  `dungeon-optional-models-basic-human-fallback.png`,
+  `browser-downloads-optional-packs.png`, and
+  `browser-downloads-update-and-remove.png`.
+- Verification: all 43 avatar tests passed; the complete Vitest suite passed all
+  896 cases across 164 files; production browser and Android builds completed;
+  both binary inventories contained only the two Human rigs, starter equipment,
+  and Wailing Caverns content; and neither output contained optional character
+  packs, original combat media, or WAV files. KTX2 and environment-performance
+  audits remained green, and the release-candidate check passed. The existing
+  large-chunk advisory remains informational.
+
+# 2026-09-05 — Power Word: Shield live character anchoring
+
+- Installed the optional Original Spell Effects & Sounds pack through the
+  production Downloads screen, enabled it, and selected Original spell visuals.
+- Entered Wailing Caverns as a Human Priest and cast Power Word: Shield on both
+  the party tank and the player while exercising party movement and combat. The
+  persistent original aura stayed at the rendered character root instead of
+  following the throttled gameplay-position snapshot, with no inherited camera
+  or character rotation.
+- Reviewed live dungeon screenshots before and during the movement test. The
+  browser emitted no new errors; only the existing third-party initialization
+  deprecation warning remained.
+- Verification: all 899 Vitest cases passed across 165 files, including three
+  new visual-anchor registry cases. The production build completed with 920
+  modules transformed, and asset audits remained green. The existing
+  large-chunk advisory remains informational.
+
+# 2026-09-05 — modular RuneWaker boss mechanics
+
+- Built a temporary local production content feed for Forsaken Abbey and the
+  first two Ystra Labyrinth boss rooms, then installed each pack through the
+  browser Downloads workflow with checksum verification.
+- Loaded the source-backed Specter Guardian Creator encounter. Its mechanic
+  panel appeared below the minimap and buff/debuff strips with Guard Bomb,
+  Transport Magic, and Meteor Shower countdowns. A live Meteor Shower cast
+  showed its one-second cast warning over the boss.
+- The first pass exposed that four countdown rows could crowd the boss's
+  pending 80%, 60%, 40%, and 20% phase triggers out of the panel. The timeline
+  now limits only countdown rows and always retains every pending health
+  threshold. The corrected production build displayed all eight rows without
+  covering the central playfield.
+- Loaded Rune Guardian Leader in Ystra Labyrinth Boss Room 2. Its source-backed
+  Manastorms Duo Lv5 mechanic displayed a large purple circular floor warning
+  while the matching panel row counted down at 0.6 seconds. The area indicator,
+  cast timing, party damage, and effect/debuff presentation all advanced in the
+  live encounter.
+- Browser logs contained no uncaught application errors. The existing
+  third-party initialization deprecation warning remained; WebGL context-lost
+  messages corresponded to intentional production rebuild reloads and opening
+  replacement test tabs.
+- Verification: the full suite passed all 913 cases across 169 files, and the
+  corrected production build completed with 923 modules transformed. KTX2 and
+  environment-performance audits remained green, and the release-candidate
+  check passed.

README.md

@@ -41,6 +41,28 @@ npm test
 npm run build
 ```
 
+## Content downloads
+
+Production browser and Android builds ship a compact required set: the game
+runtime, interface, starter equipment, Wailing Caverns starter content, and a
+basic male/female Human character model with its default appearance. Large
+character and skin libraries, additional dungeons, Manastorm stages, and the
+original spell-effects and sound pack are optional downloads.
+
+Open **Downloads** from the main menu to download, update, or remove optional
+packs on either platform. Browser downloads live in an app-managed verified
+cache; Android downloads live in app-private storage. Removing a pack never
+removes a roster or save. If a character's model/skin pack is unavailable, the
+shared character renderer displays the matching-gender basic Human while
+preserving that character's identity and progress for a later reinstall.
+
+Generated spell effects and synthesized combat cues are the default and need
+no original-media download. Players who want the packaged original visuals and
+sounds can download that pack explicitly, select **Original** effects, and
+remove the pack again to reclaim its storage. See
+[`CONTENT_UPDATES.md`](CONTENT_UPDATES.md) for the content lifecycle and release
+contract.
+
 ## Conquest of Azeroth classes
 
 All 21 CoA classes use a checked-in live Vol'Jin catalog generated from
@@ -181,12 +203,13 @@ npm run android:apk
 The debug APK is written under `android/app/build/outputs/apk/debug/`. To build
 and install directly onto a connected device, use `npm run android:install`.
 
-Android uses a separate compact `dist-android` build. It bundles the client,
-interface, equipment, and Wailing Caverns starter content while optional
-dungeons, character packs, and Manastorm stages are downloaded into app-private
-storage. Installed content and local saves remain playable without a server
-connection and survive APK updates. See `CONTENT_UPDATES.md` for the update
-contract and `DEPLOYMENT.md` for TrueNAS publishing and signed Gitea releases.
+Android uses a compact `dist-android` build with the same required-content
+boundary as the production browser build. Optional dungeons, character/skin
+packs, Manastorm stages, and original spell media are downloaded into
+app-private storage. Installed content and local saves remain playable without
+a server connection and survive APK updates. See `CONTENT_UPDATES.md` for the
+update contract and `DEPLOYMENT.md` for TrueNAS publishing and signed Gitea
+releases.
 
 ## Runtime details
 
@@ -206,6 +229,8 @@ contract and `DEPLOYMENT.md` for TrueNAS publishing and signed Gitea releases.
   compressed in GPU memory instead of expanding to uncompressed RGBA textures.
 - Missing production GLBs activate a small cave proxy; malformed assets activate
   the recoverable scene-error screen.
+- Missing optional character or skin packs render the built-in basic Human
+  model instead of hiding the player, party member, or roster preview.
 - The controller action HUD displays only the active eight-slot layer. Its
   face-button diamond, shoulders, and D-pad keep the physical controller layout
   visible without showing all 24 bindings over the playfield.

RELEASE_RUNBOOK.md

@@ -71,9 +71,12 @@ file, use the shorter procedure at the end. Those updates can be published by
 the server and downloaded by an already-installed APK without an Obtainium
 release.
 
-Single-player remains offline-capable. A fresh APK includes the runtime and
-starter content. Additional content that a player has downloaded is retained
-in Android app-private storage and can be used offline after download.
+Single-player remains offline-capable. A fresh APK includes the runtime,
+interface, starter equipment, Wailing Caverns, and the basic Human character
+fallback. Additional content that a player has downloaded is retained in
+Android app-private storage and can be used offline after download. Generated
+spell effects are available without downloading the optional original-media
+pack.
 
 ## Fixed locations
 
@@ -287,7 +290,8 @@ git diff --cached --check
 ```
 
 Do not continue if the staged list contains a keystore, APK, `.env` file,
-database, `content/`, `dist/`, `dist-android/`, or `.android-public/` output.
+database, `content/`, `dist/`, `dist-android/`, `.web-public/`, or
+`.android-public/` output.
 Unstage any accidental file with `git restore --staged -- <path>` without
 deleting the local file.
 

dungeon-pipeline/README.md

@@ -73,6 +73,23 @@ attaches native animated client models by display ID. It writes:
 - `src/game/generated/dungeonCampaignCatalog.compressed.ts`, the bundled catalog
 - `src/game/generated/dungeonAvailability.json`, the generated availability list
 
+Boss specials are compiled as independent mechanic records. AzerothCore
+SmartAI timers and health events are imported automatically; C++ encounter
+spells are imported from the pinned script checkout. Add or override a boss in
+`dungeon-pipeline/boss-mechanics.json` when an encounter needs hand-authored
+targeting, summon behavior, timing, or telegraph geometry. Use `mode: "replace"`
+to make that list authoritative or `mode: "append"` to layer entries ahead of
+the imported mechanics, then run `npm run dungeon:catalog`. The generated
+`combat.mechanicIds` list is the stable loadout boundary intended for later
+encounter randomization.
+
+The same catalog also stores Runewaker kits under
+`rw-<dungeon>-<entity-id>` keys. Run `npm run runewaker:bosses:refresh` to
+rebuild those records from preserved RuneWaker spell/Lua evidence, regenerate
+the population packages, and run `npm run runewaker:audit:gameplay`. A record
+whose preserved source has no recoverable combat ability is explicitly marked
+`source.kind: "healer-man-source-gap"` rather than being claimed as authentic.
+
 Stock AzerothCore population is used for the standard dungeons. The three
 Ascension-specific instances—Tinkertech Showdown, Frozen Reach, and Forgotten
 Mine—keep their client encounter identities and use an explicit procedural
@@ -229,4 +246,4 @@ Kresh is intentionally recorded as a source-faithful melee-only boss: entry
 3653 has no spell or SmartAI row in the pinned AzerothCore snapshot. Trial of
 the Champion is likewise documented as a boss-arena population rather than a
 trash route. These exceptions are asserted by exact dungeon/entity IDs; any
-new basic-only boss or mob-less dungeon fails the batch.
+new basic-only boss or mob-less dungeon fails the batch.

dungeon-pipeline/recipes/ahnkahet-old-kingdom.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/arcatraz.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TempestKeepArcane",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/auchenai-crypts.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounDraenei",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/azjol-nerub.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/black-morass.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "burning-crusade",
   "extraction": {

dungeon-pipeline/recipes/blackfathom-deeps.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Blackfathom",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [20, 30]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/blackrock-depths.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/BlackrockDepths",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [50, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/blackrock-spire.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/BlackRockSpire",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [55, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/blood-furnace.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/HellfireDemon",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [58, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/botanica.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TempestKeepAtrium",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/culling-of-stratholme.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/dire-maul.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/DireMaul",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [0, 0, 0], "yawDegrees": 180},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [50, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/draktharon-keep.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/escape-from-durnholde.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "burning-crusade",
   "extraction": {

dungeon-pipeline/recipes/forge-of-souls.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/gnomeregan.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/GnomeragonInstance",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [25, 40]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/gundrak.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/halls-of-lightning.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/halls-of-reflection.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/halls-of-stone.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/hellfire-ramparts.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/HellfireRampart",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [1262.4427, -60.8902, 1622.5397], "yawDegrees": 262.143},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [58, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/magisters-terrace.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Sunwell5ManFix",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [70, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/mana-tombs.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounEthereal",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/maraudon.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Mauradon",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [40, 55]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/mechanar.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TempestKeepFactory",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/pit-of-saron.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/ragefire-chasm.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/OrgrimmarInstance",
   "environmentMode": "global-wmo",
+  "globalWmoAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [13, 25]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/razorfen-downs.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/RazorfenDowns",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-2402.2809, 62, 1208.3219], "yawDegrees": 0},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [35, 50]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/razorfen-kraul.json

@@ -8,7 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/RazorfenKraulInstance",
   "environmentMode": "global-wmo",
-  "globalWmoSourceBasis": "flip-x",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-1952.1803, 87.684, 1587.8923], "yawDegrees": -133},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [25, 40]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/scarlet-monastery.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a",
   "mapDirectory": "World/Maps/MonasteryInstances",
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
+  "adtSourceBasis": "z-y-negative-x",
   "difficultyVariants": [
     { "id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [26, 45] }
   ],

dungeon-pipeline/recipes/scholomance.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/SchoolofNecromancy",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-141.694, 148.0683, 105.6784], "yawDegrees": 1},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [55, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/sethekk-halls.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounDemon",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/shadow-labyrinth.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounShadow",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/shadowfang-keep.json

@@ -7,12 +7,14 @@
   "expansion": "classic",
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Shadowfang",
-  "environmentMode": "global-wmo",
+  "environmentMode": "detect",
+  "coordinateAlignment": "source",
+  "adtSourceBasis": "z-y-negative-x",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [18, 30]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},
-  "extraction": {"rootWmo": "World/wmo/Dungeon/LD_ShadowFang/LD_ShadowFang.wmo", "doodadSets": ["Set_$DefaultGlobal"]},
-  "navigation": {"cellSize": 0.2, "cellHeight": 0.1, "agentHeight": 1.8, "agentRadius": 0.36, "agentMaxClimb": 0.5, "agentMaxSlope": 50},
+  "extraction": {"adtTiles": "all-present"},
+  "navigation": {"cellSize": 0.2, "cellHeight": 0.1, "tileSize": 256, "retainTileIntermediates": false, "agentHeight": 1.8, "agentRadius": 0.36, "agentMaxClimb": 0.5, "agentMaxSlope": 50},
   "review": {"entrance": "required", "bossOrder": "required", "optionalEncounters": "required", "presentation": "required", "offMeshLinks": "required"},
   "exceptions": []
 }

dungeon-pipeline/recipes/shattered-halls.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/HellfireMilitary",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/slave-pens.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/CoilfangDraenei",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/steamvault.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/CoilfangPumping",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/stratholme.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Stratholme",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-3449.6608, 144.3848, -3379.6966], "yawDegrees": 0},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [55, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/sunken-temple.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/SunkenTemple",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [45, 55]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/the-nexus.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/the-oculus.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/trial-of-the-champion.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/uldaman.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Uldaman",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [
     {
       "id": "normal",

dungeon-pipeline/recipes/underbog.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/CoilfangMarsh",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/utgarde-keep.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/utgarde-pinnacle.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/violet-hold.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/zulfarrak.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TanarisInstance",
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
+  "adtSourceBasis": "z-y-negative-x",
   "difficultyVariants": [
     { "id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [40, 54] }
   ],

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "healer-man",
-  "version": "0.1.6",
+  "version": "0.1.14",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "healer-man",
-      "version": "0.1.6",
+      "version": "0.1.14",
       "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.6",
+  "version": "0.1.14",
   "type": "module",
   "scripts": {
     "dev": "vite --host 0.0.0.0",
@@ -10,17 +10,20 @@
     "db:backup": "node scripts/backup-game-database.mjs",
     "server:test": "node --test server/*.test.mjs",
     "content:publish": "node scripts/content/publish-content.mjs",
+    "web:prepare": "node scripts/content/prepare-web-bootstrap.mjs",
     "android:prepare": "node scripts/content/prepare-android-bootstrap.mjs",
     "content:test": "node --test scripts/content/*.test.mjs",
-    "effects:generate": "node scripts/combat-effects/generate-manifest.mjs --package-audio",
-    "effects:audit": "node scripts/combat-effects/generate-manifest.mjs --package-audio --audit",
+    "effects:generate": "node scripts/combat-effects/generate-manifest.mjs --package-audio && node scripts/combat-effects/package-priest-original.mjs",
+    "effects:audit": "node scripts/combat-effects/generate-manifest.mjs --package-audio --audit && node scripts/combat-effects/package-priest-original.mjs --audit",
+    "effects:priest": "node scripts/combat-effects/package-priest-original.mjs",
     "effects:test": "node --test scripts/combat-effects/*.test.mjs",
     "wow335:abilities": "node scripts/generate-wow335-abilities.mjs",
     "coa:sync": "node scripts/sync-ascension-coa.mjs",
     "coa:sync:live": "node scripts/sync-ascension-coa.mjs --tooltips",
     "coa:icons": "node scripts/export-spell-icons.mjs",
     "ascension:talents": "node scripts/generate-wow335-talents.mjs ../wow335a/Interface/AddOns/PlayerBotManager/PBM/PBM_TalentData.lua ../LadiksMPQEditor/client-current/area-52/patch-D/DBFilesClient/Spell.dbc src/game/wow335Talents.generated.ts ../LadiksMPQEditor/client-current/area-52/patch-D/DBFilesClient/Talent.dbc",
-    "ascension:sync": "npm run coa:sync && npm run wow335:abilities && npm run ascension:talents && npm run coa:icons",
+    "catalogs:shard": "vite-node scripts/generate-catalog-shards.ts",
+    "ascension:sync": "npm run coa:sync && npm run wow335:abilities && npm run ascension:talents && npm run coa:icons && npm run catalogs:shard",
     "manastorm:import": "node scripts/manastorm-import/cli.mjs",
     "manastorm:forensics": "node scripts/manastorm-import/forensics-cli.mjs",
     "manastorm:sync": "npm run manastorm:import && npm run manastorm:forensics && npm run coa:icons",
@@ -71,6 +74,7 @@
     "runewaker:register:all": "node scripts/runewaker-pipeline/cli.mjs register-all",
     "runewaker:refresh:all": "node scripts/runewaker-pipeline/cli.mjs refresh-all",
     "runewaker:spells:refresh": "node scripts/runewaker-pipeline/export-spell-catalog.mjs",
+    "runewaker:bosses:refresh": "npm run runewaker:spells:refresh && node scripts/runewaker-pipeline/import-boss-mechanics.mjs",
     "runewaker:players:refresh": "node scripts/runewaker-pipeline/export-player-catalog.mjs && npm run runewaker:players:avatars",
     "runewaker:players:avatars": "node scripts/runewaker-pipeline/build-population.mjs --recipe scripts/runewaker-pipeline/recipes/runewaker-player-avatars.json --actors-only && node scripts/runewaker-pipeline/finalize-player-avatar-manifest.mjs",
     "runewaker:paperdolls:refresh": "node scripts/runewaker-pipeline/refresh-paperdoll-appearances.mjs",
@@ -91,7 +95,10 @@
     "assets:ktx2:creatures": "node scripts/asset-pipeline/compress-creature-ktx2.mjs",
     "assets:ktx2:audit": "node scripts/asset-pipeline/audit-ktx2.mjs --visual-only --require-all",
     "assets:ktx2:refresh-metadata": "node scripts/asset-pipeline/refresh-ktx2-metadata.mjs",
-    "prebuild": "npm run loot:generate && npm run assets:ktx2:audit",
+    "assets:performance:audit": "node scripts/asset-pipeline/audit-environment-performance.mjs",
+    "balance:benchmark": "vite-node scripts/combat-benchmark/run.ts",
+    "balance:smoke": "vite-node scripts/combat-benchmark/run.ts --class mage --role damage --scenario damage-single-burst --seeds 1 --duration-scale 0.2",
+    "prebuild": "npm run loot:generate && npm run web:prepare && npm run assets:ktx2:audit && npm run assets:performance:audit",
     "build": "node --max-old-space-size=8192 node_modules/typescript/bin/tsc -b && node --max-old-space-size=8192 node_modules/vite/bin/vite.js build",
     "build:android:web": "npm run prebuild && npm run android:prepare && node --max-old-space-size=8192 node_modules/typescript/bin/tsc -b && node --max-old-space-size=8192 node_modules/vite/bin/vite.js build --mode android",
     "android:sync": "npm run build:android:web && cap sync android",