landmines는 Interfere 회사가 프로덕션 환경에서 사용하는 Oxlint 플러그인 규칙 세트입니다. 테스트 관련 규칙으로는 의존성 동작 대체, 고정 시간 sleep, spy 상태 폴링, 테스트 재시도 및 타임아웃 증가가 금지되며, MSW를 통해 모의되지 않은 네트워크 요청을 차단하도록 요구합니다. 스타일 관련 규칙으로는 긴 설명성 주석이 금지됩니다. 구조 관련 규칙으로는 테스트 파일과 구현 파일을 함께 배치하고, 명명 규칙을 통일하며, 패키지 출구를 명시적으로 선언하도록 요구합니다. 일부 규칙은 파일별로 허용 횟수를 설정할 수 있어 기존 프로젝트에서 점진적으로 기준을 강화하는 데 유용합니다.
왜 중요한가 에이전트는 CI를 통과시키기 위해 종종 테스트 대상 객체를 모킹(mocking)하거나, 타임아웃을 늘리거나, 불안정한(flaky) 테스트를 재실행하곤 합니다. 이 규칙들은 이러한 행위를 직접 오류로 보고하고 올바른 수정 방법을 알려줍니다.
스타 수 138 (+40 / 24h)
이유
- 24시간 동안 스타가 40개 증가했으며, Trendshift 기준 당일 순위는 1위입니다(단순히 관심도를 나타냄). MIT 라이선스 적용
- 각 규칙은 README에 무엇을 차단하는지, 어떻게 수정해야 하는지 명확히 기재되어 있습니다.
사용법
- bun add -d oxlint @interfere/landmines를 실행한 후, .oxlintrc.json에서 recommended 구성을 extends하거나 필요한 규칙만 활성화하세요.
리스크
- Oxlint 1.81, Node 22.18 이상의 버전이 필요하며, JavaScript / TypeScript에만 적용됩니다.
- 규칙의 지향점이 강합니다(예: 대부분의 주석 금지, 반환 타입 명시 금지). 전체 세트를 활성화하기 전에 팀의 관행과 부합하는지 확인하세요.