Files
healer-man/docs/TEST_DUNGEON_POLICY.md
2026-10-06 22:25:34 -04:00

6.0 KiB

Default test dungeon — Stormwind Stockade: Cellblock Rush

As of 2026-10-05, the project owner's default for new routine live gameplay, mechanics, healing, party, camera, input, performance and browser diagnostics is Stormwind Stockade: Cellblock Rush (bite-sized-stormwind-stockade). In the Dungeons picker, choose the Bite-Sized category and the exact Stormwind Stockade: Cellblock Rush row. The derived run shares Stormwind Stockade's environment and content pack, seals both side wings and keeps its central corridor. It completes after one boss.

Each fresh run selects one of five source bosses from the persisted/shared run ID: Targorr the Dread, Kam Deepfury, Hamhock, Bazil Thredd, or Dextren Ward. A resume or party member reconstructs the same boss. Reusable live harnesses must record the boss actually observed in the entered run; do not assume the seeded choice is Hamhock. The exact authored selection and route are in src/game/dungeons/biteSizedStockades.ts.

Agent workflow

  1. Read AGENTS.md and the relevant canonical vault notes.
  2. Enter the Bite-Sized → Stormwind Stockade: Cellblock Rush row through the normal Dungeons picker. It may use the installed Stockade content pack; follow the normal download confirmation and role-selection flow when needed.
  3. For reusable harnesses, import scripts/playtest-defaults.cjs. Its default ID/title/category are bite-sized-stormwind-stockade, Stormwind Stockade: Cellblock Rush, and Bite-Sized. selectDefaultTestDungeon(page) selects that exact row, and openSelectedDungeonRoles(page) handles the ordinary installed/download flow before waiting for role selection.
  4. For an explicitly requested full-source campaign, use the exported FULL_STOCKADE_DUNGEON_ID, FULL_STOCKADE_DUNGEON_TITLE, and FULL_STOCKADE_BOSS constants. selectFullStockadeDungeon(page) selects the full WoW → Stormwind Stockade row. The campaign harness requires an explicit --route=stormwind-stockade when --campaign-boss-route is used; the source-specific full-campaign wrappers require --full-stockade for a live run. Static --prepare-only checks do not enter a dungeon.
  5. Use ordinary movement/casting for live mechanic and route proof. Read-only telemetry may inspect casts, resources, actor positions and run progress. Label any isolated pre-entry profile preparation or synthetic unit fixture.
  6. Record loaded build assets, actual dungeon ID and selected boss, source identity, mechanic outcome, screenshots, runtime errors and limitations in PLAYTEST_NOTES.md and the scoped report. Inspect screenshots before claiming a visual fix.

Source and completion

The authored full-dungeon recipe is dungeon-pipeline/recipes/stormwind-stockade.json; dungeon-pipeline/runtime-overrides/stormwind-stockade.json owns runtime overrides. src/game/dungeons/biteSizedStockades.ts derives Cellblock Rush without mutating the generated full source definition. Both variants resolve to the Stockade content pack. The catalog is generated by the dungeon pipeline; do not hand-edit its JSON or compressed TypeScript. Existing full-Stockade navigation regressions are in src/game/stockadesNavigation.test.ts.

The full Stockade objective order is Targorr the Dread, Kam Deepfury, Hamhock, Bazil Thredd and Dextren Ward. Dextren Ward is the final objective. A full-source clear claim requires all five native objective IDs and the native full-clear results screen. Cellblock Rush completes after its one selected boss and is evidence for that slice only. Record persistent killed-boss/run progress so natural earlier kills survive endpoint despawning. A zero-engaged pack attempt does not establish a pack kill.

Hamhock's source list includes Nature Chain Lightning 421 and Bloodlust 6742. Chain Lightning has sourced range 30 and three total targets, with nearest visible living jumps within 10 m and profile-specific damage decay. Bloodlust is a haste buff, and its unsupported utility effect is omitted rather than emitted as damage. Use the full Stockade route only when that campaign evidence is explicitly requested. For the focused Vow check, use node scripts/playtest-campaign-boss-pass.cjs --campaign-boss-route --route=stormwind-stockade --stockade-vow-diagnostic. This bounded source-specific diagnostic is an explicit full-dungeon entry and is separate from routine Cellblock Rush checks. Tab selection does not face the target: player combat facing follows cameraYaw. Use ordinary right-mouse drag, verify the actual facing arc and keep pointer lock null. Pace large turns across frames to respect the input manager's delta limits. Hit-test a clear canvas path; boss notifications can cover a fixed starting point even when the game canvas fills the viewport. Credit cancellation only from the same watched live cast, a completed player Vow cast, its owned target aura and disappearance before scheduled release without matching Chain Lightning damage while the target remains alive. Stop gameplay inputs and retain read-only samples through scheduled release plus 100 ms to check that interval directly.

Earlier fixtures and scope

Keep Wailing's existing import/source regressions and dated reports as historical evidence. They do not select the dungeon for future routine live QA. Dedicated legacy Wailing/Lady harnesses are historical reproductions, and a new live run requires the owner's explicit request for that dungeon. Do not relabel their old screenshots or results as Stockade evidence.

Incident analysis may read Barren or another dungeon's captured evidence and source. Generic follow-up validation uses Cellblock Rush; encounter-specific live reproduction follows the user's explicitly requested dungeon. Preserve dated full-Stockade clear reports as historical results; they do not make the full campaign the future default.

Ready-five balance scope, RoM Needs Testing status, saved-profile compatibility, level cap 80 and the no-new-loot-wiring constraint continue to apply. The test fixture choice does not change the game's bundled content or playable dungeons.