how to contribute development workflow

Development workflow

The development loop is short: sync dependencies, make a focused change, run fast validators, then run the full CI-equivalent checks before committing.

Local loop

uv sync --extra kuzu --dev
uv run ruff format .
uv run ruff check .
uv run python -m unittest discover -s tests -v

For changes to graph behavior, run the graph tests directly:

uv run python -m unittest tests.test_graph -v

Change map

If you change	Also check
`src/lode/daemon.py`	`openapi/loded.openapi.yml`, `docs/api/loded.md`, `tests/test_e2e.py`
`src/lode/indexer.py`	`tests/test_lode.py`, `tests/test_graph.py`
`src/lode/graph.py`	`tests/test_graph.py`, impact CLI smoke tests
`src/lode/storage.py`	search, symbol, embedding, and index tests
`pyproject.toml`	`uv.lock`, CI validators, dependency hygiene

Release workflow

Publishing is handled by .github/workflows/publish.yml for v* tags or manual dispatch. Version bumps need coordinated changes in pyproject.toml, src/lode/__init__.py, uv.lock, and tests/smoke_test.py.