chore: add a justfile for common dev commands - #1096
Conversation
Wraps the commands already documented in CLAUDE.md (install, test, lint, format, docs-sync) so they are discoverable via `just --list` and harder to get subtly wrong. `just test` mirrors the CI invocation, including the same --ignore set and marker filter. Independent of the RFC 005 work; split out so it can land or be dropped on its own. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
There was a problem hiding this comment.
Stale comment
Reviewed at
c3c04f884500e775512795bc08f5655da7038074. Thetestrecipe currently matches the repository workflow, but the PR body promiseslint,format, anddocs-syncrecipes that are absent from the 23-line justfile, and the file lacks a final newline. Please either add the claimed recipes or narrow the description, add the newline, refresh onto currentmain, and run exact-head CI (only Bugbot has run). No runtime or alignment concern otherwise.Sent by Cursor Automation: Release
|
cursor review |
There was a problem hiding this comment.
APPROVE at 508d8ef1
Useful ergonomic justfile. The test recipe matches the CLAUDE.md CI-safe invocation (same three --ignore flags; file-level PYTHONPATH propagates). Not wheel cargo.
Nit: missing trailing newline (non-blocking). LGTM.
Sent by Cursor Automation: Release
There was a problem hiding this comment.
APPROVE at 3fc52f15 (merge-main only)
Rebased onto main after #1178. Feature tip unchanged from prior review at 58f92f7f (justfile install/test/test-one; final newline fixed). Non-blocking nit still: test-one comment names a stale test_agentic_harness_types.py path.
Root tooling only; not release cargo. Still needs exact-head repository CI.
Sent by Cursor Automation: Release
There was a problem hiding this comment.
APPROVE @ ac5a7ec5
Addresses the prior nit: test-one example now points at the real tests/core/test_state_schema_subclass.py. Recipes still match the narrowed install/test/test-one scope.
Tooling-only; not 0.6.0 wheel cargo. Exact-head repository CI still needed before merge if workflows are gated.
Sent by Cursor Automation: Release
There was a problem hiding this comment.
Merge-main re-APPROVE at fd2eea6b
Ben merged main into this fork tip. Feature diff unchanged: justfile install/test/test-one recipes only; test-one comment now points at a real path.
Fork PR: repository CI still needs Approve-and-run. Not OpenEnv wheel cargo.
Sent by Cursor Automation: Release
There was a problem hiding this comment.
Re-APPROVE at 31bdf238 (merge-main only)
Ben merged main (26c9465e / #1179) into this fork PR. Stable feature patch-id is unchanged vs prior approved tip fd2eea6b (ef1dafed…); justfile blob identical.
Prior technical approval stands. Still needs maintainer Approve and run. Not 0.6.0 wheel cargo.
Sent by Cursor Automation: Release
|
The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update. |


This PR adds a justfile for dependency installation, the test suite, and individual test targets.
Note
Low Risk
Developer tooling only; no runtime, auth, or production code paths change.
Overview
Adds a root
justfileso local dev can usejust install,just test, andjust test-one <path>instead of copying long shell commands from CI or agent docs.It sets
PYTHONPATH=src:envsfor recipes and alignsjust testwith the default CI/local hook behavior: same pytest ignores for browsergym, dipg, and websearch env tests, plus marker filternot integration and not network and not docker.justwith no args lists available recipes.Reviewed by Cursor Bugbot for commit 0a116c8. Bugbot is set up for automated code reviews on this repo. Configure here.