chore(dev): add just as the canonical check interface #216

New issue

Closed

opened 2026-05-16 13:53:04 -07:00 by jwilger · 0 comments

jwilger commented

2026-05-16 13:53:04 -07:00

Owner

Goal

Make just the project command interface for local development and CI checks, while keeping Nix optional for developers.

Implements the developer command-surface portion of ADR-0018.

Scope

Add a Justfile.
Add recipes for:
- just fmt
- just clippy
- just test
- just deny
- just build
- just ci
Recipes should call normal tools directly, not wrap commands in nix develop.
Add just to the Nix dev shell.
Update project guidance files that direct contributors/agents to use nix flake check as the primary check command.
Update lefthook.yml to use the new command surface.

Acceptance Criteria

Developers with the required tools on PATH can run just ci without Nix.
Developers who prefer Nix can run nix develop, then just ci.
Project guidance says Nix is optional for developers, but supported for reproducible setup.
No CI workflow restructuring is required in this issue.

Verification

just fmt
just clippy
just test
just deny
just ci
nix develop provides just

Dependencies

Blocked by #215.

## Goal Make `just` the project command interface for local development and CI checks, while keeping Nix optional for developers. Implements the developer command-surface portion of ADR-0018. ## Scope - Add a `Justfile`. - Add recipes for: - `just fmt` - `just clippy` - `just test` - `just deny` - `just build` - `just ci` - Recipes should call normal tools directly, not wrap commands in `nix develop`. - Add `just` to the Nix dev shell. - Update project guidance files that direct contributors/agents to use `nix flake check` as the primary check command. - Update `lefthook.yml` to use the new command surface. ## Acceptance Criteria - Developers with the required tools on `PATH` can run `just ci` without Nix. - Developers who prefer Nix can run `nix develop`, then `just ci`. - Project guidance says Nix is optional for developers, but supported for reproducible setup. - No CI workflow restructuring is required in this issue. ## Verification - `just fmt` - `just clippy` - `just test` - `just deny` - `just ci` - `nix develop` provides `just` ## Dependencies Blocked by #215.

jwilger added the

enhancement

label

2026-05-16 13:53:15 -07:00

jwilger referenced this issue

2026-05-16 13:54:04 -07:00

refactor(nix): keep Nix for tooling, packaging, and NixOS service support #217

jwilger added this to the 1.0 milestone

2026-05-16 13:54:04 -07:00

jwilger added a new dependency

2026-05-16 13:54:34 -07:00

#215 chore(ci): retire release workflow text tests