Start with the source of truth for the layer you are changing.
| Change | Begin with |
|---|---|
| Grammar or validation | language/v1, qql-core, conformance fixtures |
| Plan semantics | qql-plan and runtime plan tests |
| REST/gRPC behavior | shared plan plus both transport projections |
| SDK API | Rust implementation and every affected binding |
| Documentation | current fixtures, crate APIs, and generated declarations |
Core checks
RUSTC_WRAPPER= cargo test --workspace --all-targets RUSTC_WRAPPER= cargo clippy --workspace --all-targets -- -D warningsPull request expectations
Section titled “Pull request expectations”- Add valid and invalid fixtures for language changes.
- Regenerate canonical AST snapshots from qql-core output.
- Keep Python, Node.js, and WASM contracts aligned.
- Verify both REST and gRPC projections for transport changes.
- Add or update executable documentation examples.