landmines は、Interfere 社が本番環境で使用している Oxlint プラグインルールのセットです。テスト関連のルールでは、依存関係の動作の置き換え、固定時間の sleep、spy の状態のポーリング、テストのリトライ、タイムアウトの延長が禁止されており、MSW による未モックのネットワークリクエストのインターセプトが要求されます。スタイル関連のルールでは、長文の説明コメントが禁止されています。構造関連のルールでは、テストファイルと実装ファイルを同じ場所に配置すること、命名規則の統一、パッケージのエクスポートの明示的な宣言が要求されます。一部のルールでは、ファイルごとに許可回数を設定できるため、既存のプロジェクトで段階的にルールを厳格化しやすい設計になっています。
なぜ重要か エージェントは CI を緑にするために、テスト対象のモック化、タイムアウトの延長、不安定なテストのリトライを行いがちですが、これらのルールはそれらを直接エラーとして検出し、修正方法を指示します。
スター数 138(+40 / 24時間)
理由
- 24 時間で新たに 40 スターを獲得し、Trendshift の当日ランキングで第 1 位(注目度のみを示す);MIT ライセンス
- 各ルールについて、README にて検出対象と推奨される修正方法が明記されている
使い方
- bun add -d oxlint @interfere/landmines を実行し、.oxlintrc.json で recommended 設定を extends するか、必要なルールのみを有効にする
リスク
- Oxlint 1.81、Node 22.18 以上が必要;JavaScript / TypeScript のみに対応
- ルールの方向性が強い(例:大部分のコメントの禁止、戻り値の型の記述の禁止など);全ルールを有効にする前に、チームの慣習に合致するか確認すること