build(justfile): Migrate from Makefile to just (#60)

## Summary
- Migrate from Makefile to just command runner (v1.45.0)
- Add `[group]` attributes for organized recipe listing in `just --list`
- Update CI, .tmuxp.yaml, and AGENTS.md to use just commands

## Changes
- Add just 1.45.0 to .tool-versions
- Add root justfile with test, lint, docs, format, and typing groups
- Add docs/justfile with build, validate, dev, and misc groups
- Update .tmuxp.yaml development workflow
- Update CI docs workflow
- Update AGENTS.md documentation
- Remove legacy Makefiles

Author: tony

.github/workflows/docs.yml

@@ -54,6 +54,10 @@ jobs:
         if: env.PUBLISH == 'true'
         run: uv sync --all-extras --dev
 
+      - name: Install just
+        if: env.PUBLISH == 'true'
+        uses: extractions/setup-just@v2
+
       - name: Print python versions
         if: env.PUBLISH == 'true'
         run: |
@@ -63,7 +67,7 @@ jobs:
       - name: Build documentation
         if: env.PUBLISH == 'true'
         run: |
-          pushd docs; make SPHINXBUILD='uv run sphinx-build' html; popd
+          cd docs && just html
 
       - name: Configure AWS Credentials
         if: env.PUBLISH == 'true'

.tmuxp.yaml

@@ -11,8 +11,8 @@ windows:
   panes:
   - focus: true
   - pane
-  - make watch_mypy
-  - make watch_test
+  - just watch-mypy
+  - just watch-test
 - window_name: docs
   layout: main-horizontal
   options:
@@ -22,4 +22,4 @@ windows:
   - focus: true
   - pane
   - pane
-  - make start
+  - just start

.tool-versions

@@ -1,2 +1,3 @@
+just 1.45.0
 uv 0.9.18
 python 3.14 3.13.11 3.12.12 3.11.14 3.10.19

AGENTS.md

@@ -26,6 +26,7 @@ Key features:
 
 This project uses:
 - Python 3.10+
+- [just](https://github.com/casey/just) for command running (see also https://just.systems/)
 - [uv](https://github.com/astral-sh/uv) for dependency management
 - [ruff](https://github.com/astral-sh/ruff) for linting and formatting
 - [mypy](https://github.com/python/mypy) for type checking
@@ -49,7 +50,7 @@ uv pip install --editable . -G dev
 
 ```bash
 # Run all tests
-make test
+just test
 # or directly with pytest
 uv run pytest
 
@@ -60,7 +61,7 @@ uv run pytest tests/test_doctest_docutils.py
 uv run pytest tests/test_doctest_docutils.py::test_function_name
 
 # Run tests with test watcher
-make start
+just start
 # or
 uv run ptw .
 
@@ -72,26 +73,26 @@ uv run ptw . --now --doctest-modules
 
 ```bash
 # Run ruff for linting
-make ruff
+just ruff
 # or directly
 uv run ruff check .
 
 # Format code with ruff
-make ruff_format
+just ruff-format
 # or directly
 uv run ruff format .
 
 # Run ruff linting with auto-fixes
 uv run ruff check . --fix --show-fixes
 
 # Run mypy for type checking
-make mypy
+just mypy
 # or directly
 uv run mypy src tests
 
 # Watch mode for linting (using entr)
-make watch_ruff
-make watch_mypy
+just watch-ruff
+just watch-mypy
 ```
 
 ### Development Workflow
@@ -108,13 +109,13 @@ Follow this workflow for code changes (see `.cursor/rules/dev-loop.mdc`):
 
 ```bash
 # Build documentation
-make build_docs
+just build-docs
 
 # Start documentation server with auto-reload
-make start_docs
+just start-docs
 
 # Update documentation CSS/JS
-make design_docs
+just design-docs
 ```
 
 ## Code Architecture

CHANGES

@@ -30,6 +30,14 @@ $ uvx --from 'gp-libs' --prerelease allow gp-libs
 
 <!-- To maintainers and contributors: Please add notes for the forthcoming version below -->
 
+### Development
+
+- Migrate from Make to just for task running (#60)
+
+  Replaces `Makefile` and `docs/Makefile` with `justfile` and `docs/justfile` using
+  [just](https://just.systems/) 1.45.0. Recipes are organized with `[group]` attributes
+  for improved discoverability via `just --list`.
+
 ### Documentation
 
 - Migrate docs deployment to AWS OIDC authentication and AWS CLI