slop-grader

slop-grader는 줄 규칙과 문서 규칙을 나눈다. 줄 규칙은 문장을 하나씩 특정 패턴에 비추고, 문서 규칙은 어조와 흐름 같은 부드러운 특성으로 글 전체를 채점한다. 둘 다 같은 파이프라인을 지나며, 깨끗한 줄은 보고서에서 아예 빠지므로 실패한 부분만 보인다.

규칙은 코드가 아니라 Markdown 파일로 쓴다. 규칙 하나는 평문 질문에 참·거짓 기준을 붙인 것이다. 프로그래밍을 모르는 사람도 초안을 쓸 수 있고, 개발자는 그것을 실행에 넣을 수 있다. no-ai-slop, article-scores, tech-docs, grammar-english 같은 내장 규칙 세트가 흔한 경우를 그대로 덮는다. no-ai-slop 규칙 세트는 새 초안에서 AI 글쓰기를 가장 빠르게 탐지하는 길이고, 자체 규칙 세트는 자신만의 표현을 겨냥하게 해준다.

구독은 없다. 도구가 실제로 던진 질문에만 비용을 내고, TypeSafe AI나 OpenRouter 키로 청구된다. 이 텍스트 채점 CLI는 검사 자체에 값을 매긴다. 16줄 샘플을 53개 규칙으로 검사하면 약 0.5센트, 2,100단어 글을 42개 규칙으로 검사하면 7.6센트 근처다.

모든 줄은 내용과 규칙 기준의 해시로 캐시된다. 문서를 고쳐 다시 실행한다. 손대지 않은 줄은 API 호출 없이 캐시에서 돌아온다. 덕분에 편집, 수정, 재실행의 루프가 긴 파일에서도 빠르고 싸다. 완전한 훑기를 원하면 --no-cache로 끌 수 있다.

--json 옵션으로 사람이 읽는 보고서를 JSON으로 바꾼다. 위반은 줄 번호, 문제가 된 텍스트, 발동한 규칙 이름으로 나오고, 여기에 신뢰도 값이 붙은 문서별 점수가 더해진다. 이 형식은 터미널을 읽는 사람이 아니라 CI 파이프라인과 편집기 연동에 흘려보내기 위한 것이다.

도구는 두 백엔드와 이야기한다. Jev에 직접 접근하는 TypeSafe AI와 OpenRouter다. 환경 변수에서 어느 쪽을 쓸지 스스로 알아내며, --provider로 강제할 수도 있다. 기본 모델은 jev-1.13.0이고, 실행마다 덮어쓸 수 있다.

--check 옵션은 아무것도 채점하지 않고 1센트도 쓰지 않은 채 규칙 세트 문법을 검증한다. 새 규칙 세트를 쓰면 먼저 검사하자. 그러면 실제 텍스트에 적용하기 전에 문법이 통과하는지 알 수 있다.