troytt
/
diablo2-web
1
0
Fork 0
Code Issues 69 Pull Requests Packages Projects Releases Wiki Activity
diablo2-web/TEST_READY.md

5.7 KiB
Raw Blame History

Diablo II v1.13c Parity Test Suite — Readiness Certification (TEST_READY.md)

Date: 2026-10-02
Status: READY (100% PASS RATE)
Target Initiative: Diablo II v1.13c Parity (151 Issues, #562–#712)
Author: Test Writer Specialist Agent (teamwork_preview_test_writer_e2e_1)

1. Executive Summary

The complete 4-tier requirement-driven opaque-box E2E parity test suite for the Diablo II v1.13c initiative is implemented, verified, and certified ready for continuous integration and regression testing.

  • Total Parity Tests: 109 tests across 4 tiers in tests/e2e-parity/.
  • Legacy Migrated Tests: 13 tests across 4 suites migrated from node:test to Vitest.
  • Combined Test Count: 122 tests executed via npx vitest run.
  • Pass Rate: 100% (122 / 122 tests passing cleanly).
  • Production Code Guard: 0 changes to production files (src/**). All modifications strictly confined to tests/** and documentation.

2. Test Coverage & Tier Breakdown

Tier File Path Focus Area Test Count Pass Rate
Tier 1 tests/e2e-parity/tier1-feature-coverage.test.ts Core Feature Coverage across 8 Batches (#562–#712) 48 tests 100% (48/48)
Tier 2 tests/e2e-parity/tier2-boundary-corner.test.ts Boundary, Corner & Edge Cases across 8 Batches 48 tests 100% (48/48)
Tier 3 tests/e2e-parity/tier3-cross-feature.test.ts Pairwise & Multi-Subsystem Cross-Feature Integrations 8 tests 100% (8/8)
Tier 4 tests/e2e-parity/tier4-real-world-scenarios.test.ts Authentic Full-Lifecycle Gameplay Scenarios 5 tests 100% (5/5)
Legacy tests/frontend-flow.test.ts Battle.net Frontend Flow & Asset Verification 6 tests 100% (6/6)
Legacy tests/netproto-bncs-packets.test.ts BNCS Packet Encoders/Decoders 4 tests 100% (4/4)
Legacy tests/netproto-online-flow.test.ts Online Flow Integration 2 tests 100% (2/2)
Legacy tests/e2e-bnet-create-account.test.ts Headless Chromium Browser E2E Account Flow 1 test 100% (1/1)
Total — Full Test Suite 122 tests 100% (122/122)

3. Subsystem Batch Coverage Matrix (Tiers 1 & 2)

Each of the 8 subsystem batches has dedicated 6 primary feature tests and 6 edge/boundary tests:

  1. Batch 1 (Issues #562–#579: Engine Timing, Coordinates & Math):
    • 25Hz tick accumulator (40ms ticks), sub-frame delta accumulation, isometric 2:1 projection math, sub-tile conversions, and diminishing return curves.
  2. Batch 2 (Issues #580–#597: Collision Layer, Floor Grid & Walkability):
    • Universal DT1 loading (Blank.dt1, InvisWal.dt1, Warp.dt1), multi-flag collision masks, void collision blocking, and dynamic entity footprint reservation.
  3. Batch 3 (Issues #598–#615: Player Movement, Pathing & Action States):
    • Posture modes (walk, run, town neutral, town walk), pathing waypoint queues, stamina consumption, and collision obstruction stoppage.
  4. Batch 4 (Issues #616–#633: Character & Monster Animation / DCC Pipeline):
    • DCC direction alignment (8/16/32 directions), animation clip pacing, 1.13c FCR/IAS speed formulas, and cast overlay alignment.
  5. Batch 5 (Issues #634–#651: Renderer & DT1 Tile Pipeline):
    • DT1 block layout decoding (sub-blocks 0..24), SplitMix64 spatial hashing (no periodic stripe artifacts), Bresenham LOS raycasting, and missile projectile physics.
  6. Batch 6 (Issues #652–#669: UI, HUD, Inventory & Tooltip Systems):
    • Grid container placement, item bridging (onlineItemDataToUiInventoryItem), bilingual tooltips, belt drink commands, and weapon swap toggling.
  7. Batch 7 (Issues #670–#703: Network Packet Sync & Message Serialization):
    • Authoritative C2S/S2C packet size validation, S2C movement packet parsing, Battle.net character name filtering, and corpse assignment tracking.
  8. Batch 8 (Issues #704–#712: Tools, Asset Manifest & Headless Auditing):
    • Asset manifest integrity, fail-fast DT1 library audits, and headless level audit verification.

4. Cross-Feature & Gameplay Scenarios (Tiers 3 & 4)

  • Tier 3 (8 Interactions):
    • X1: Movement + Weapon Swap + Skill Cast
    • X2: Collision Grid + Teleport + Town Portal
    • X3: Missile Trajectory + Wall Collision + Impact Overlay
    • X4: S2C Server Correction + Unit Motion Synchronization
    • X5: Item Drop + Inventory Placement + Tooltip Stat Generation
    • X6: Character Selection + Account Validation + Flame Anchor
    • X7: Line-of-Sight Raycast + Viewport Coordinate Culling
    • X8: Stamina / Posture Toggle + Block Chance Degradation
  • Tier 4 (5 Full Scenarios):
    • Scenario 1: Blood Moor Clearing (Town departure, terrain navigation, combat against Fallen, and potion recovery)
    • Scenario 2: Den of Evil Completion (Cave exploration, room visibility, monster clearing count 5 -> 0, and quest completion flag)
    • Scenario 3: Countess Tower Run (Multi-floor cellar descent 21 -> 25, superunique fight, rune drop to ground, pickup into inventory)
    • Scenario 4: Tristram Rescue (Red portal transition 4 -> 38, Griswold combat & movement kiting, Deckard Cain cage interaction & quest update)
    • Scenario 5: Act Boss Kill: Andariel (Catacombs L4 chamber entry, poison spray mechanics & vulnerability, Andariel defeat, Act 1 quest complete, Act 2 Lut Gholein transition)

5. Verification Commands

# Verify the entire 4-tier parity suite (109 tests)
npx vitest run tests/e2e-parity/

# Verify legacy test suites (13 tests)
npx vitest run tests/frontend-flow.test.ts tests/netproto-bncs-packets.test.ts tests/netproto-online-flow.test.ts tests/e2e-bnet-create-account.test.ts

All tests pass cleanly with zero warnings and zero flakes.