mdscript: Instructions file for Claude Code

MDS (Markdown Script)

Composable LLM prompt template compiler. Rust core (crates/) with WASM, native Node.js (napi-rs), and native Python (PyO3) bindings, plus npm packages (packages/).

Build and test

cargo test --workspace                        # 590+ Rust tests
cargo fmt --all --check && cargo clippy --workspace --all-targets -- -D warnings
RUSTDOCFLAGS="-D warnings" cargo doc -p mds-core --no-deps   # CI rustdoc gate: catches broken intra-doc links
# Windows local twin — clippy only (cannot link/run). Windows tests run only in the
# `rust-windows` CI job (`Rust — clippy, test (windows-latest)`):
rustup target add x86_64-pc-windows-msvc
cargo clippy -p mds-core -p mds-cli --all-targets --target x86_64-pc-windows-msvc -- -D warnings
npm ci && npm run build -w @mdscript/mds-wasm && npm run build --workspaces --if-present
# The native addon is NOT built by `--workspaces` (its script is `build:native`, not
# `build`); needs the Rust toolchain. Without it @mdscript/mds silently falls back to WASM.
npm run build:native -w @mdscript/mds-napi
npm test --workspaces --if-present

# Python bindings (crates/mds-python) — 0 Rust tests by design; test via pytest:
python -m venv .venv && . .venv/bin/activate     # maturin develop needs a venv
pip install "maturin==1.13.3" pytest mypy pyright
maturin develop -m crates/mds-python/Cargo.toml && pytest crates/mds-python/tests -q

Release

All packages ship as a single coordinated release at the same version, driven by release.yml. Release via tag-push:

node scripts/bump-version.mjs X.Y.Z   # bump all manifests + stamp CHANGELOG
# land the bump on main via PR (CI-gated), then:
git tag -a vX.Y.Z -m vX.Y.Z && git push origin vX.Y.Z

Pushing the vX.Y.Z tag triggers release.yml: build 7 native targets + WASM, A3 name-gate, publish to crates.io and npm (with provenance), create a GitHub Release. Run gh workflow run release.yml (no inputs) for a dry-run that validates the build + A3 gate and publishes nothing.