Development workflow

Use the pinned Rust 1.94.0 toolchain and Python 3.11+. The root Makefile and justfile expose the baseline verification matrix:

make fmt
make check
make test
make lint
make python-test
# or: make verify

make verify formats, checks, tests, lints, and runs Python SDK tests. It may rewrite formatting, so use cargo fmt --all -- --check when a read-only CI check is needed. Run cargo test -p CRATE while iterating, then the workspace suite before review.

Cargo is offline by default. New dependencies require a deliberate lockfile update and a reproducible way to populate the cache; never hide a fetch behind tests. The local pre-commit hooks run Rust format checking and Python syntax compilation.

For changes under python/lawsynth, run PYTHONPATH=python/lawsynth/src python3 -m pytest -q python/lawsynth/tests. Use maturin develop before tests that need the native extension.

TypeScript packages

Node 22 and pnpm 10.18.2 are the workspace baseline. pnpm-workspace.yaml enrolls only world-schema, api-client, state-store, chart-core, and design-system; do not run workspace checks as evidence that planned apps or unenrolled packages work. After installing the locked workspace dependencies, run:

pnpm build
pnpm typecheck
pnpm test

For a focused package, change into packages/world-schema (or another enrolled package) and run its declared npm test / npm run typecheck script. The TypeScript layer validates source contracts and UI data; it does not replace Rust bundle decoding or simulation.