Justfile for Developer Workflows

Context

Add a justfile so common dev tasks (linting, testing, building, publishing, docs) are single commands. The project uses uv, hatch, ruff, and pytest. Docs are static HTML in docs/.

Phase 1: Create the justfile

Create justfile at the project root with these recipes:

default — list available recipes (just --list)

ruff — ruff check --fix src/ tests/ && ruff format src/ tests/

test — uv run pytest

check — run ruff then test

build — clean dist/ then uv build

publish — clean dist/, build, then uv publish

docs — open docs/index.html in the browser

Phase 2: Verify

Run just --list to confirm all recipes parse

Run just ruff to smoke-test

Notes

No standalone clean recipe — cleaning is built into build and publish.

All recipes verified. just --list shows all 7 recipes. just ruff runs correctly (found a pre-existing lint issue in cli.py:287).

docs recipe uses open || xdg-open for macOS/Linux compatibility.