Problem
New contributors must remember and type three separate commands to run all checks: uv run pytest, uv run ruff check, uv run pyright. There is no shortcut to run all checks at once, and no format command is documented anywhere.
What to do
Create a Makefile (or justfile) in the project root with targets:
.PHONY: check lint typecheck test format serve dashboard
check: lint typecheck test
lint:
uv run ruff check src tests
typecheck:
uv run pyright
test:
uv run pytest tests/ -v
format:
uv run ruff format src tests
serve:
uv run context-analyzer-tool serve
dashboard:
uv run context-analyzer-tool dashboard
Also update CONTRIBUTING.md to mention make check as the one-stop verification command.
Why this is a good first issue
No code changes, just developer tooling. Great way to improve the contributor experience and learn the project's tool chain.
Problem
New contributors must remember and type three separate commands to run all checks:
uv run pytest,uv run ruff check,uv run pyright. There is no shortcut to run all checks at once, and noformatcommand is documented anywhere.What to do
Create a
Makefile(orjustfile) in the project root with targets:Also update
CONTRIBUTING.mdto mentionmake checkas the one-stop verification command.Why this is a good first issue
No code changes, just developer tooling. Great way to improve the contributor experience and learn the project's tool chain.