2026-08-16 22:04:11 +03:00
|
|
|
# Development workflow
|
|
|
|
|
|
|
|
|
|
Use the pinned Rust 1.94.0 toolchain and Python 3.11+. The root Makefile and
|
|
|
|
|
justfile expose the baseline verification matrix:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
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.
|