leveret

leveret은 새끼 산토끼입니다. 작고 빠르며, 눈을 뜬 채 태어납니다.

leveret은 코드가 외부로 나가지 않는 팀을 위한 호스팅형 AI 리뷰 봇의 후속작으로, 자체 호스팅 방식의 하이브리드 비공개 코드 리뷰 엔진입니다. 결정적 정적 분석, AST 수준 검색, 그리고 MCP로 노출되는 등급화된 필터링 파이프라인을 갖추고 있으며, 여러분이 가져오는 어떤 리뷰 에이전트로도 구동됩니다(BYOM — Claude Code, MCP를 지원하는 클라이언트를 통한 로컬 모델, 또는 CI 러너). 엔진 레이어 자체는 절대 LLM을 호출하지 않습니다.

프로젝트가 목표로 하는 파이프라인:

[diff] → [deterministic first pass: leveret scan] → [review agent: leads → concerns]
       → [verification agent: refute-or-evidence filter] → [report]

도구

• scan {repo, base? | files?, engines?, delta?} — 변경 집합에 적용 가능한 엔진을 실행하고 정규화된 파인딩(engine, rule, severity, file, line, message, provenance)과 엔진별 상태 보고서를 반환합니다. base ref가 있으면 스캔은 기본적으로 delta 모드입니다. base 트리에 이미 존재하는 파인딩은 기존의 것으로 간주되어 제외되며(집계는 되지만 조용히 무시되지는 않음), 남은 파인딩은 introduced로 태그됩니다. 엔진: semgrep(레지스트리 보안 + 언어별 규칙 세트), gitleaks(base..HEAD 커밋에서 시크릿 탐지), shellcheck, ruff, actionlint, zizmor(워크플로 보안), osv-scanner(lockfile CVE), typos(맞춤법), jscpd(프로필로 제어되는 중복 탐지), 프로필에 선언된 semgrep/ast-grep 규칙 팩, 그리고 custom: 프로필 항목을 통한 임의의 SARIF 출력 명령(레시피: psalm taint, hadolint, trivy, ...)입니다. 파인딩은 리뷰 단서이지, 최종 판정이 아닙니다.

• ast_search {repo, pattern, lang, paths?} — ast-grep을 통한 구조적 패턴 매칭(메타변수, 문법 인식)으로, 텍스트 grep이 잘못 다루는 호출 지점 형태의 질문을 위한 기능입니다.

• context {repo, files} — 파인딩이 아닌 우선순위 신호입니다: 함수별 순환 복잡도(lizard), 12개월 변경량, 마지막 수정 날짜.

Related MCP server: reporelay

실행

npm install && npm run build
node dist/server.js          # stdio MCP server
npm test                     # integration tests (need semgrep, gitleaks, shellcheck, ruff, actionlint, ast-grep on PATH)

Claude Code 등록:

claude mcp add leveret -- node /Users/andre/git/leveret/dist/server.js

상태 / 로드맵

DESIGN.md를 참조하세요 — 아키텍처, 3단계 필터(actionable / priced-noise / false-positive), 리포지토리 내 메모리 저장소, 에이전트 프롬프트 계약, 그리고 도입을 결정하는 검증 벤치마크.

라이선스

AGPL-3.0-or-later.