Files
healer-man/docs/TEST_DUNGEON_POLICY.md
T
2026-10-04 22:51:21 -04:00

84 lines
4.9 KiB
Markdown

# Default test dungeon — Stormwind Stockade
The project owner selected **Stormwind Stockade** on 2026-10-04 as the default
for new routine gameplay, mechanics, healing, party, camera, input, performance
and browser diagnostics. The runtime ID is `stormwind-stockade`; the UI title is
`Stormwind Stockade`. This replaces Wailing Caverns as the routine test dungeon.
Mode-specific Bite-Sized spawn/Race diagnostics use `bite-sized-stormwind-stockade`
as their default Stockade fixture. They remain distinct from the full dungeon
required for ordinary mechanics and campaign-route proof.
## Agent workflow
1. Read `AGENTS.md` and the relevant canonical vault notes.
2. Use the full Stockade dungeon from **Dungeons → WoW → Stormwind Stockade**.
Install and verify its content through the normal entry/download flow when
required. Do not fall back to bundled Wailing content.
3. For reusable harnesses, import `scripts/playtest-defaults.cjs`. Its exports
are `DEFAULT_TEST_DUNGEON_ID`, `DEFAULT_TEST_DUNGEON_TITLE`, and
`DEFAULT_TEST_DUNGEON_BOSS` (Hamhock for generic Boss Testing).
`selectDefaultTestDungeon(page)` selects the exact full-dungeon row;
`openSelectedDungeonRoles(page)` handles both installed content and the normal
download confirmation before waiting for role selection.
4. 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.
5. Record loaded build assets, source boss identity, actual mechanic outcome,
screenshots, runtime errors and limitations in `PLAYTEST_NOTES.md` and the
scoped report. Inspect the screenshots before claiming a visual fix.
## Source and completion
The authored recipe is `dungeon-pipeline/recipes/stormwind-stockade.json`;
`dungeon-pipeline/runtime-overrides/stormwind-stockade.json` owns runtime
overrides. The catalog is generated by the dungeon pipeline; do not hand-edit
its JSON or compressed TypeScript. The existing Stockade navigation regressions
are in `src/game/stockadesNavigation.test.ts`.
The current full-dungeon objective order is Targorr the Dread, Kam Deepfury,
Hamhock, Bazil Thredd and Dextren Ward. Dextren Ward is the final objective.
A normal full-clear claim requires all five objectives and the native results
screen; reaching an anchor or clearing a Bite-Sized variant is separate proof.
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 is a real damaging cast with sourced range 30; its chain fan-out
remains unsupported. Bloodlust is a haste buff, and its unsupported utility
effect is omitted rather than emitted as damage. Use the actual imported
timing/control/immunity data for live interrupt proof; do not carry Lady
Anacondra's IDs or casts into a Stockade test.
For a focused ordinary-campaign Vow check, use
`node scripts/playtest-campaign-boss-pass.cjs --campaign-boss-route --route=stormwind-stockade --stockade-vow-diagnostic`.
This bounded diagnostic is separate from full-clear proof. 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 Stockade; encounter-specific live
reproduction follows the user's explicitly requested dungeon. This policy
replaces the previously proposed additional Wailing clear with a Stockade
full-route/full-clear attempt.
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.