Package development

​

Development checkout

git clone https://github.com/langstate/langstate.git
cd langstate
git checkout df40bc49bc8e3a51b2bb695b30ff93ef81b2cc4b
cd packages/langstate
poetry install --no-root --with dev

​

Test commands

poetry run python -m pytest -q

poetry run python -m pytest tests/unit/state/test_interpretive_state.py -q
poetry run python -m pytest tests/integration/core/test_state_from_openapi.py -q

poetry run python -m pytest --cov=core --cov-report=term-missing

​

Contribution boundaries

• Add tests beside source changes, including import and Pydantic-shape coverage for public contracts.
• Treat packaging and a stable installed import surface as explicit release work, not as already solved.
• Keep concrete behavior and forward-looking architecture distinct in change descriptions.
• If a source change alters names, fields, imports, or verification output, update this documentation repository and its pinned commit in the same release process.