Doom / GZDoom WASM workspace

Local home for the HyperCrab2000 Doom stack. Open individual repos in Cursor (or this folder as a multi-root workspace).

Repo	GitHub	Role
doom-wad-lab	HyperCrab2000/doom-wad-lab	Browser app, WebGL renderer, parity harness
doom-wad-core	HyperCrab2000/doom-wad-core	WAD parse, GZSTATE export (@hypercrab2000/doom-wad-core)
doom-gzengine-core	HyperCrab2000/doom-gzengine-core	Game engine WASM scaffold, GZTICK
gzdoom-project	HyperCrab2000/gzdoom-project	GZDoom fork (-dumpgzstate, build scripts)

Legacy webpack experiment moved to ../doom-legacy-webpack.

Documentation

Document	Description
docs/README.md	Documentation index
docs/TESTING.md	Exhaustive cross-repo testing guide (parallelization, commands, CI)

Per-repo testing docs:

• doom-wad-lab/docs/TESTING.md
• doom-wad-core/docs/TESTING.md
• doom-gzengine-core/docs/TESTING.md
• gzdoom-project/docs/PARITY-TOOLS.md

Quick test smoke

cd doom-wad-core && npm test
cd ../doom-wad-lab && npm run test:unit
# With IWADs + corpus artifacts:
cd ../doom-wad-lab && npm run test:corpus && npm run test:modular

Git author (your GitHub graph)

Cursor sessions may commit as a bot user unless repo-local identity is set. After clone:

./setup-git-author.sh

Pins local user.name / user.email to williamfarmer <william.miles.farmer@gmail.com> in each repo (does not touch global git config).

Layout

IdeaProjects/doom/
  docs/                  # Umbrella docs (TESTING.md, README.md)
  doom-wad-lab/
  doom-wad-core/
  doom-gzengine-core/
  gzdoom-project/
  README.md
  setup-git-author.sh

file:../doom-wad-core links in doom-wad-lab/package.json still work — siblings in this folder.