jevlint (Jev query linter)

It reads the request body you would send to System One — a state and the questions about it — and reports where the query is written in a way the model is documented to handle badly. Findings name the defect, where it is and what to change; the shipped broken-triage example reports one error, two warnings and three advisories.

check --static-only needs no key, makes no calls and costs nothing. The full check needs TYPESAFE_API_KEY in the environment or in a .env in the working directory, and costs two Jev calls per question plus two for the query. The --openrouter flag sends checks through OpenRouter instead and reads OPENROUTER_API_KEY.

The repo ships three implementations over one shared catalogue of checks: PHP under php/, JavaScript under js/, and Python under python/. Called as a library, the Linter class returns the report instead of printing it, with documented entry points for PHP, JavaScript and Python.

As a dependency it installs with composer require --dev phox/jevlint (PHP 8.3+), npm install --save-dev @phox-js/jevlint (Node 20.19+) or pip install jevlint (Python 3.10+). From a clone, composer install and ./jevlint run the PHP version; the JavaScript build needs npm install and npm run build, and Python pip install -e .

Yes — point it at the request body you would send: ./jevlint check your-query.json --static-only runs the rules that need no key, and dropping --static-only adds the checks that ask Jev. The commands run from the repository root where examples/ sits, and ./jevlint help lists the rest.

The project site at fox-islam.github.io/jevlint has an examples page with three queries containing a defect, the report each one produces, and the same query rewritten. The README also links docs on evidence quality, programmatic output and adding a language.

No. This is fox-islam's Python-first jevlint with PHP and JavaScript ports, hosted at fox-islam.github.io/jevlint. It is a different project from ice-hazymoon's @hazymoon/jevlint and from codegirl-007's Go jevlint already listed in this directory, though all three lint code or queries with Jev.