build: Replace Makefile with justfile

Migrate the primary development tasks from make to just:

- Add a justfile with the build, format, lint, test, watch, and version
  recipes, keeping the quiet output of the Makefile's @-prefixed rules.
- Install just in CI via the shared setup action and in the devcontainer.
- Point the workflows, the postgenerate npm script, the README, and
  .editorconfig at just.

The tag message in the version recipe is now the version, as intended.
In the Makefile, `-m "$(poetry version -s)"` was expanded by make rather
than the shell, so it produced an empty message.

Author: claude

.devcontainer/Dockerfile

@@ -5,6 +5,8 @@ FROM mcr.microsoft.com/vscode/devcontainers/python:${VARIANT}
 ARG NODE_VERSION="24"
 ARG POETRY_VERSION="1.8.2"
 ARG POETRY_SRC="https://install.python-poetry.org"
+ARG JUST_VERSION="1.57.0"
+ARG JUST_SRC="https://just.systems/install.sh"
 
 # https://github.com/microsoft/vscode-dev-containers/blob/main/containers/go/.devcontainer/base.Dockerfile
 ENV USERNAME=vscode
@@ -25,6 +27,9 @@ RUN curl -fsSL -o install-poetry.py "${POETRY_SRC}" \
  && python install-poetry.py --version $POETRY_VERSION \
  && rm install-poetry.py
 
+RUN mkdir -p .local/bin \
+ && curl -fsSL "${JUST_SRC}" | bash -s -- --tag "${JUST_VERSION}" --to /home/vscode/.local/bin
+
 RUN mkdir -p .config/git \
  && echo ".vscode/*" >> .config/git/ignore \
  && echo "*.code-workspace" >> .config/git/ignore \

.devcontainer/devcontainer.json

@@ -4,6 +4,7 @@
   "build": {
     "dockerfile": "Dockerfile",
     "args": {
+      "JUST_VERSION": "1.57.0",
       "NODE_VERSION": "24",
       "POETRY_VERSION": "1.8.2",
       "VARIANT": "3.12"

.editorconfig

@@ -11,5 +11,5 @@ indent_size = 2
 [*.py]
 indent_size = 4
 
-[Makefile]
-indent_style = tab
+[justfile]
+indent_size = 4

.github/actions/setup/action.yml

@@ -11,6 +11,10 @@ inputs:
     description: The Poetry version.
     required: false
     default: '1.8.2'
+  just_version:
+    description: The just version.
+    required: false
+    default: '1.57.0'
   install_dependencies:
     description: Install dependencies.
     required: false
@@ -36,6 +40,10 @@ runs:
           ~/.local/bin
           ~/.local/share/pypoetry
           ~/Library/Application Support/pypoetry
+    - name: Setup just
+      uses: extractions/setup-just@v4
+      with:
+        just-version: ${{ inputs.just_version }}
     - name: Setup Python
       uses: actions/setup-python@v5
       with:

.github/workflows/_build.yml

@@ -37,7 +37,7 @@ jobs:
         with:
           python_version: ${{ inputs.python_version }}
       - name: Build
-        run: make build
+        run: just build
       - name: Upload artifact
         uses: actions/upload-artifact@v7
         if: inputs.upload_artifact == 'true'

.github/workflows/check.yml

@@ -36,7 +36,7 @@ jobs:
       - name: Setup Node.js
         uses: ./.github/actions/setup-node
       - name: Test
-        run: make test
+        run: just test
   lint:
     name: Lint (Python ${{ matrix.python }})
     runs-on: ubuntu-latest
@@ -55,7 +55,7 @@ jobs:
         with:
           python_version: ${{ matrix.python }}
       - name: Lint
-        run: make lint
+        run: just lint
   build:
     name: Build (Python ${{ matrix.python }} on ${{ matrix.os_name }})
     uses: ./.github/workflows/_build.yml

.github/workflows/format.yml

@@ -32,7 +32,7 @@ jobs:
       - name: Setup Node.js
         uses: ./.github/actions/setup-node
       - name: Format
-        run: make format
+        run: just format
       - name: Format with Prettier
         run: npm run format
       - name: Commit

.github/workflows/version.yml

@@ -34,4 +34,4 @@ jobs:
       - name: Cut ${{ github.event.inputs.version }} version
         run: |
           poetry version "${{ github.event.inputs.version }}"
-          make version
+          just version

Makefile

@@ -452,9 +452,9 @@ Run each command below in a separate terminal window:
 
 ::
 
-    $ make watch
+    $ just watch
 
-Primary development tasks are defined in the ``Makefile``.
+Primary development tasks are defined in the ``justfile``.
 
 Source Code
 ~~~~~~~~~~~
@@ -471,7 +471,7 @@ Clone the project with
 Requirements
 ~~~~~~~~~~~~
 
-You will need `Python 3`_ and Poetry_ and Node.js_ with npm_.
+You will need `Python 3`_ and Poetry_ and Node.js_ with npm_ and just_.
 
 Install the development dependencies with
 
@@ -480,6 +480,7 @@ Install the development dependencies with
     $ poetry install
     $ npm install
 
+.. _just: https://just.systems/
 .. _Node.js: https://nodejs.org/
 .. _npm: https://www.npmjs.com/
 .. _Poetry: https://poetry.eustace.io/
@@ -492,20 +493,20 @@ Lint code with
 
 ::
 
-    $ make lint
+    $ just lint
 
 
 Run tests with
 
 ::
 
-    $ make test
+    $ just test
 
 Run tests on changes with
 
 ::
 
-    $ make watch
+    $ just watch
 
 Publishing
 ~~~~~~~~~~