Rev-dep

機能  •   インストール  •   ドキュメント  •   探索ツールキット  •   CLI リファレンス

最新の JavaScript / TypeScript コードベース向けの依存関係分析・最適化ツールキットです。
非常に高速な CLI で依存関係グラフの衛生状態を強制し、未使用コードを削除します。

概要 📣

コードベースが拡大するにつれ、依存関係のメンタルマップを維持することは不可能になります。Rev-dep は、大規模な JS/TS プロジェクト全体でアーキテクチャの整合性と依存関係の衛生状態を強制するために設計された高速静的解析ツールです。

Rev-dep を依存関係グラフのための高速リンターと考えてください。

断片化された複数の低速ツールによる順次チェックを、単一の高性能エンジンに統合します。 Rev-dep は、循環、孤立、モジュール境界などを含むガバナンスチェックの一式を、1 回の並列化パスで実行します。Go で実装されているため Node ベース解析のパフォーマンスボトルネックを回避し、約 150ms で 50 万行以上の LoC プロジェクトを監査できます。 パフォーマンス比較を見る

自動化されたコードベースガバナンス

Rev-dep は受動的なスキャンを超えて能動的な強制へと進み、難しい質問に答え（そして CI を失敗させ）ます：

• アーキテクチャの整合性: 「自分の『ドメイン A』は『ドメイン B』から不正にインポートしていないか？」。
• デッドコードと肥大化: 「これらのファイルは到達不能か、あるいはこれらの node_modules は未使用か？」。
• リファクタリングの安全性: 「どのエントリーポイントが実際にこのユーティリティを使っているのか、循環チェーンはないか？」。
• ワークスペースの衛生状態: 「インポートは一貫しているか、すべての依存関係が宣言されているか？」。

Rev-dep は CI の高速ゲートキーパーとして機能し、反復開発中も依存関係グラフがスリムでアーキテクチャが無傷のままであることを保証します。

なぜ Rev-dep なのか？ 🤔

🏗️ 第一級のモノレポサポート

最新のワークスペース（pnpm、yarn、npm）向けに設計されています。Rev-dep は package.json の exports/imports マップ、TypeScript エイリアスをネイティブに解決し、パッケージ境界を越えた依存関係を追跡します。

🛡️ 設定ベースのコードベースガバナンス

受動的なスキャンを超えてください。設定エンジンを使用してモジュール境界とインポート規約を強制します。衛生チェック一式（循環、孤立、未使用モジュールなど）を単一の並列化パスで実行し、CI の高速ゲートキーパーとして機能させます。

🔍 探索ツールキット

ファイル間の依存関係に関する問題のデバッグを支援する CLI ツールキットです。ファイル間の推移的関係を理解し、問題を修正します。

⚡ 速度と CI 効率のために設計

Go で実装され、Node ベース解析のパフォーマンス負荷を排除しています。ファイルを並列処理することで、Rev-dep は代替ツールよりも 17 倍から 90 倍高速な実行を実現し、CI コストと開発者の待ち時間を大幅に削減します。

Rev-dep は約 150ms で 50 万行以上の LoC プロジェクトを監査できます。 パフォーマンス比較を見る

機能 🚀

ガバナンスとメンテナンス（設定ベース）🛡️

rev-dep config run を使用すると、すべてのパッケージに対して複数のチェックを 1 回のパスで実行できます。

利用可能なチェック：

• moduleBoundaries - モジュール間のアーキテクチャ境界を強制します。
• importConventions - インポートスタイルの規約を強制します（自動修正対応）。
• unusedExportsDetection - 使われていないエクスポートを検出します（自動修正対応）。
• orphanFilesDetection - デッドファイル/孤立ファイルを検出します（自動修正対応）。
• unusedNodeModulesDetection - 宣言されているが使用されていない依存関係を検出します。
• missingNodeModulesDetection - package.json にないインポートを検出します。
• unresolvedImportsDetection - 未解決のインポート要求を検出します。
• circularImportsDetection - 循環インポートを検出します。
• duplicatedCodeDetection - コピー＆ペーストされたコード（繰り返しブロックと JSX 要素）を検出します。
• devDepsUsageOnProdDetection - 本番コードで使用されている開発依存関係を検出します。
• restrictedImportsDetection - 選択したエントリーポイントから許可されていないファイル/モジュールのインポートをブロックします。
• restrictedImportersDetection - どのエントリーポイントが一連のファイル/モジュールに推移的に到達できるかをホワイトリストで制御します。
• restrictedDirectImportersDetection - どのファイルが一連のファイル/モジュールを直接インポートできるかを制限します（非推移的）。

探索的分析（CLIベース）🔍

アドホックな依存関係の探索には CLI コマンドを使用します：

• entry-points - プロジェクトのエントリーポイントを発見します。
• files - 指定されたエントリーポイントの依存関係ツリーファイルを一覧表示します。
• resolve - ファイル間の依存関係パスを追跡します（誰がこのファイルをインポートしているか）。
• imported-by - ファイルを直接インポートしているものを一覧表示します。
• circular - 循環依存関係チェーンを一覧表示します。
• duplicated-code - コピー＆ペーストされたコードブロックと JSX 要素を見つけます。
• node-modules - used、unused、missing、installed の node modules を検査します。
• lines-of-code - 実効 LOC を数えます。
• unresolved - 解決できなかったインポートをファイルごとにグループ化して一覧表示します。
• list-cwd-files - CWD 内のすべてのソースコードファイルを一覧表示します。
• debug - rev-dep が内部的に解析、解決、検出する内容を検査します。

インストール 📦

完全なドキュメント: rev-dep.com/docs/intro

プロジェクトのチェックスクリプトを設定するには、ローカルにインストールします``` yarn add -D rev-dep

入力に翻訳対象のコンテンツが含まれていません（チャンクが空です）。翻訳するテキストが提供された場合は、その内容を日本語に翻訳します。```
npm install -D rev-dep

ルーターはレイヤー2での検出により、プロトコルごとに複数回スキャンされることがあります。スキャンは統合されてルーターは1回だけ表示されますが、検出された情報はすべて表示されます。このツールはデバイスを検出できるだけでなく、DNSルックアップを実行してIPアドレスに一致させることもでき、さらに、検出完了後にインポートフィルタリングを変更する機能も提供します。``` pnpm add -D rev-dep

クイックスタート用の設定ファイルを作成します：```
npx rev-dep config init

CLIツールとしてグローバルにインストールする:``` yarn global add rev-dep

**`curl`** は多くのオプションがありますが、多くの場合デフォルトでレスポンスボディを stdout に出力します。設定は必要ありません。```
npm install -g rev-dep

さらに、Hoaxshell はランダムな鍵を使ったシンプルな暗号化メカニズム（XOR）ですべてのセッション通信を暗号化し、シェルの検知を防ぎます。IDS や AV 製品を回避する効果が非常に高く、企業ネットワーク内でも気づかれずに存在し続けられるほどです。

また、簡単なペイロード生成ツール shellcrafter も同梱されており、Hoaxshell と連携する PowerShell リバースシェルペイロードを自動生成する Web GUI を提供します。

Use Cases

• ペネトレーションテストの実施（例：倫理的ハッキング/レッドチーム演習）
• AV アラートを発生させることなくリモートホストにエージェントをインストールする方法を必要とするシステム管理者``` pnpm global add rev-dep

### ステップバイステップ統合ガイド

あなたのプロジェクトに合ったガイドに従って、ゼロから動作するセットアップまで進められます:

- [モノレポ統合ガイド](https://rev-dep.com/docs/monorepo-integration-guide) - `pnpm`/`yarn`/`npm` ワークスペース向け。
- [シングルワークスペース統合ガイド](https://rev-dep.com/docs/single-workspace-integration-guide) - 単一パッケージのプロジェクト向け。

## **クイック例 💡**

すぐに使える例をいくつか紹介します。ツールの雰囲気をつかむのに最適です:```bash

# Detect circular imports/dependencies
rev-dep circular

# Find copy-pasted code
rev-dep duplicated-code

# Detect unused node modules
rev-dep node-modules unused

# List all entry points in the project
rev-dep entry-points

# Check which files an entry point imports
rev-dep files --entry-point src/index.ts

# Find every entry point that depends on a file
rev-dep resolve --file src/utils/math.ts

# Resolve dependency path between files
rev-dep resolve --file src/utils/math.ts --entry-point src/index.ts

Config-Based Checks 🛡️

Rev-dep は、プロジェクトチェックを調整するための設定システムを提供します。設定アプローチは速度を重視して設計されており、プロジェクトチェックを実装する推奨方法です。すべてのチェックを1回のパスで実行できるため、個々のコマンドを別々に実行するよりも大幅に高速です。

利用可能なチェックは次のとおりです:

• moduleBoundaries - モジュール間のアーキテクチャ境界を強制します。
• importConventions - インポートスタイルの規約を強制します（自動修正対応）。
• unusedExportsDetection - 使用されないエクスポートを検出します（自動修正対応）。
• orphanFilesDetection - デッドファイル/孤立ファイルを検出します（自動修正対応）。
• unusedNodeModulesDetection - 宣言されているが使用されていない依存関係を検出します。
• missingNodeModulesDetection - package json に記載されていないインポートを検出します。
• unresolvedImportsDetection - 未解決のインポート要求を検出します。
• circularImportsDetection - 循環インポートを検出します。
• duplicatedCodeDetection - コピー＆ペーストされたコードブロックと JSX 要素を検出します。
• devDepsUsageOnProdDetection - 本番コードで使用されている dev 依存関係を検出します。
• restrictedImportsDetection - 選択したエントリポイントから拒否されたファイル/モジュールのインポートをブロックします。
• restrictedImportersDetection - 一連のファイル/モジュールに推移的に到達できるエントリポイントをホワイトリストに登録します。
• restrictedDirectImportersDetection - 一連のファイル/モジュールを直接インポートできるファイルを制限します（非推移的）。

チェックはワークスペースにグループ化されます。複数のワークスペースを持つことができます（例: monorepo パッケージごと）。

はじめに

プロジェクトで設定ファイルを初期化します:```bash

Create a default configuration file

rev-dep config init

Behavior of `rev-dep config init`:

- Monorepo root: ワークスペースルートで `rev-dep config init` を実行すると、ルートワークスペースと、検出された各ワークスペースパッケージのワークスペースが作成されます。
- Monorepo ワークスペースパッケージまたは通常のプロジェクト: ディレクトリ内で `rev-dep config init` を実行すると、そのディレクトリに対して `path: "."` を持つ単一のワークスペースで config が作成されます。

Run all configured checks (dry run, not fixes applied yet):```bash
# Execute all workspaces and checks defined in the config
rev-dep config run

検出されたすべての問題を一覧表示:```bash

Lists all detected issues, by default lists first five issues for each check

rev-dep config run --list-all-issues

修正可能なすべてのチェックを修正:```bash
# Fix checks configured with autofix
rev-dep config run --fix

Configuration Structure

設定ファイル（rev-dep.config.json(c) または .rev-dep.config.json(c)）を使用すると、複数のワークスペースを定義でき、それぞれでコードベースの異なる部分を対象に、特定のチェックを有効にすることができます。

Quick Start Configuration

クイックスタート設定```jsonc

{ "configVersion": "2.0", "$schema": "https://github.com/jayu/rev-dep/blob/master/config-schema/2.0.schema.json?raw=true", "nodeModulesResolution": { "resolutionType": "entry-package", "includeDevDepsFromRoot": false }, "workspaces": [ { "path": ".", "prodEntryPoints": ["src/main.tsx", "src/pages//*.tsx"], "devEntryPoints": ["scripts/", "**/.test."], "unusedExportsDetection": { "enabled": true, "autofix": true }, "orphanFilesDetection": { "enabled": true, "autofix": true }, "unusedNodeModulesDetection": { "enabled": true }, "circularImportsDetection": { "enabled": true }, "devDepsUsageOnProdDetection": { "enabled": true, "ignoreTypeImports": true } } ] }

#### 包括的な設定例

利用可能なすべてのプロパティを示す包括的な例を以下に示します。```jsonc
{
  "configVersion": "1.10",
  "$schema": "https://github.com/jayu/rev-dep/blob/master/config-schema/1.10.schema.json?raw=true", // enables json autocompletion
  "conditionNames": ["import", "default"],
  "ignoreFiles": ["**/*.test.*"],
  "nodeModulesResolution": { "resolutionType": "entry-package", "includeDevDepsFromRoot": false },
  "workspaces": [
    {
      "path": ".",
      "followMonorepoPackages": true,
      "prodEntryPoints": ["src/main.tsx", "src/pages/**/*.tsx", "src/server.ts"],
      "devEntryPoints": ["scripts/**", "**/*.test.*"],
      "ignoreEntryPoints": ["src/legacy/oldDashboard.tsx"],
      "moduleBoundaries": [
        {
          "name": "ui-components",
          "pattern": "src/components/**/*",
          "allow": ["src/utils/**/*", "src/types/**/*"],
          "deny": ["src/api/**/*"]
        },
        {
          "name": "api-layer",
          "pattern": "src/api/**/*",
          "allow": ["src/utils/**/*", "src/types/**/*"],
          "deny": ["src/components/**/*"]
        }
      ],
      "importConventions": [
        {
          "rule": "relative-internal-absolute-external",
          "autofix": true,
          "domains": [
            {
              "path": "src/features/auth",
              "alias": "@auth",
              "enabled": true
            },
            {
              "path": "src/shared/ui",
              "alias": "@ui-kit",
              "enabled": false // checks disabled for this domain, but alias is still used for absolute imports from other domains
            }
          ]
        }
      ],
      "circularImportsDetection": {
        "enabled": true,
        "ignoreTypeImports": true
      },
      "orphanFilesDetection": {
        "enabled": true,
        "ignoreTypeImports": true,
        "graphExclude": ["**/*.test.*", "**/stories/**/*"],
        "autofix": true
      },
      "unusedNodeModulesDetection": {
        "enabled": true,
        "includeModules": ["@myorg/**"],
        "excludeModules": ["@types/**"],
        "pkgJsonFieldsWithBinaries": ["scripts", "bin"],
        "filesWithBinaries": ["scripts/check-something.sh"],
        "filesWithModules": [".storybook/main.ts"],
        "outputType": "groupByModule"
      },
      "missingNodeModulesDetection": {
        "enabled": true,
        "includeModules": ["lodash", "axios"],
        "excludeModules": ["@types/**"],
        "outputType": "groupByFile"
      },
      "unusedExportsDetection": {
        "enabled": true,
        "autofix": true,
        "ignoreTypeExports": true,
        "graphExclude": ["**/*.stories.tsx"],
        "ignore": {
          "src/types.ts": "B*",
          "**/generated/**/*.ts": "*"
        },
        "ignoreFiles": ["**/*.generated.ts"],
        "ignoreExports": ["default", "unused*"],
      },
      "unresolvedImportsDetection": {
        "enabled": true,
        "ignore": {
          "src/index.ts": "legacy-*"
        },
        "ignoreFiles": ["**/*.generated.ts"],
        "ignoreImports": ["@internal/*"]
      },
      "devDepsUsageOnProdDetection": {
        "enabled": true,
        "ignoreTypeImports": true
      },
      "restrictedImportsDetection": {
        "enabled": true,
        "entryPoints": ["src/server.ts", "src/server/**/*.ts"],
        "graphExclude": ["some-file-coupling-other-files.ts"],
        "denyFiles": ["**/*.tsx"],
        "denyModules": ["react", "react-*"],
        "ignoreMatches": ["src/server/allowed-view.tsx", "react-awsome-lib"],
        "ignoreTypeImports": true
      }
    }
  ]
}

利用可能なプロパティ

ルートレベルプロパティ

• configVersion (必須): 設定バージョン文字列
• $schema (任意): 検証用のJSONスキーマ参照
• conditionNames (任意): エクスポート解決用の条件名の配列
• customAssetExtensions (任意): 解決可能なインポートとして扱う追加のアセット拡張子（例: ["glb", "mp3"]）。デフォルトのリストはフォント、画像、設定ファイルの一般的な拡張子をカバーします。
• ignoreFiles (任意): すべてのワークスペースで無視するグローバルなファイルパターン。Gitで無視されたファイルはデフォルトでスキップされます。
• processIgnoredFiles (任意): gitignoreまたはignoreFilesに一致しても処理するグローバルなファイルパターン。
• nodeModulesResolution (任意): missingNodeModules、unusedNodeModules、unresolvedImports のチェックで、各サードパーティインポートがどのpackage.jsonに対して検証されるかを指定します。{ "resolutionType": ..., "includeDevDepsFromRoot": ... } というオブジェクトとして設定します（rev-dep config initが生成する形式）。resolutionTypeは"entry-package"（デフォルト。ワークスペースのエントリpackage.jsonに対して検証）または"nearest-package"（各ファイルを所有するpackage.jsonに対して検証。pnpmのデフォルトレイアウトで使用。各パッケージが自身の依存関係のみを解決する場合）です。includeDevDepsFromRoot（デフォルトfalse）は、モノレポルートでのみ宣言された開発依存関係をパッケージコードが使用しても、missingNodeModulesやunresolvedImportsでフラグを立てないようにします。resolutionTypeの後方互換な省略形として、単純な文字列（例: "nearest-package"）も受け付けられます。すべてのワークスペースに適用されます。docs を参照してください。
• workspaces (必須): ワークスペースオブジェクトの配列

ワークスペースプロパティ

各ワークスペースには次のプロパティを含めることができます:

• path (必須): このワークスペースの対象ディレクトリパス（.またはサブディレクトリ名で始まるパス）
• followMonorepoPackages (任意): モノレポパッケージの解決を制御します。trueはすべてのワークスペースパッケージを対象にし（デフォルト）、falseは無効にし、配列は選択したパッケージ名のみを対象にします。
• prodEntryPoints (任意): 検出器のデフォルトに使用するワークスペースレベルの本番エントリポイントパターン
• devEntryPoints (任意): 検出器のデフォルトに使用するワークスペースレベルの開発エントリポイントパターン
• ignoreEntryPoints (任意): もはや気にしない残りのエントリポイントのためのワークスペースレベルパターン。これらのパターンに一致するファイルは問題として処理されません。孤立ファイルとして報告されることはなく、未使用のエクスポートも報告されません。コミットに残す必要があるが、もはやアプリに配線されていないファイルに便利です。
• moduleBoundaries (任意): モジュール境界ルールの配列
• circularImportsDetection (任意): 循環インポート検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• duplicatedCodeDetection (任意): 重複コード検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• orphanFilesDetection (任意): 孤立ファイル検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• unusedNodeModulesDetection (任意): 未使用ノードモジュール検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• missingNodeModulesDetection (任意): 欠落ノードモジュール検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• unusedExportsDetection (任意): 未使用エクスポート検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• unresolvedImportsDetection (任意): 未解決インポート検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• devDepsUsageOnProdDetection (任意): 制限された開発依存関係の使用検出の設定（単一のオブジェクトまたはオブジェクトの配列）
• restrictedImportsDetection (任意): 選択したエントリポイントから拒否されたファイル/モジュールのインポートを制限します（単一のオブジェクトまたはオブジェクトの配列）
• restrictedImportersDetection (任意): 一連のファイル/モジュールに推移的に到達できるエントリポイントをホワイトリスト化します（単一のオブジェクトまたはオブジェクトの配列）
• restrictedDirectImportersDetection (任意): 一連のファイル/モジュールを直接インポートできるファイルを制限します。非推移的です（単一のオブジェクトまたはオブジェクトの配列）
• importConventions (任意): インポート規約ルールの配列

モジュール境界プロパティ

• name (必須): 境界の名前
• pattern (必須): この境界内のファイルのglobパターン
• allow (任意): 許可されたインポートパターンの配列
• deny (任意): 拒否されたインポートパターンの配列（allowを上書きします）

インポート規約プロパティ

• rule (必須): ルールのタイプ。現時点ではrelative-internal-absolute-externalのみ
• autofix (任意): インポート規約違反を自動的に修正するかどうか（デフォルト: false）
• domains (必須): ドメイン定義の配列。文字列（globパターン）または次のプロパティを持つオブジェクトを指定できます:
  • path (必須): ドメインファイルが含まれるディレクトリ
  • alias (任意): このドメインのコードを絶対インポートする際に使用するエイリアス
  • enabled (任意): このドメインのチェックをスキップするにはfalseに設定します（デフォルト: true）

検出オプションプロパティ

各検出プロパティは次のように設定できます:

• 単一のオブジェクト（1つの検出器インスタンス）、または
• オブジェクトの配列（同じワークスペース内で評価される複数の検出器インスタンス）。

CircularImportsDetection:

• enabled (必須): 循環インポート検出の有効/無効
• ignoreTypeImports (任意): グラフ構築時に型のみのインポートを除外します（デフォルト: false）

DuplicatedCodeDetection:

• enabled (必須): 重複コード検出の有効/無効
• blindIdentifiers (任意): 名前をワイルドカードとして扱い、名前が変更されたコピーも重複としてカウントします（デフォルト: false）
• blindStrings (任意): 文字列とテンプレートの内容をワイルドカードとして扱います（デフォルト: false）
• blindNumbers (任意): 数値リテラルをワイルドカードとして扱います（デフォルト: false）
• minTokens (任意): 報告する最小の重複サイズ（トークン単位、デフォルト: 50）
• minLines (任意): 報告する最小の重複サイズ（行単位、デフォルト: 3）
• minDepth (任意): ブロック自体を含めた最小のネスト深度。2は少なくとも1レベルのネストを必要とします（デフォルト: 0）
• minStatements (任意): 最小ステートメント数。ステートメントブロックにのみ適用されます（デフォルト: 0）
• minDuplicates (任意): チャンクが報告されるために必要なコピー数（デフォルト: 2）
• skipObjects (任意): オブジェクトリテラルのみの重複を報告しません（デフォルト: false）
• ignoreFiles (任意): 分析から除外するglobパターン
• snapshotPath (任意): 承認済みの重複のコミット済みベースラインへのパス（ワークスペースからの相対パス）。これを使用すると、チェックは合計ではなく変更内容を報告します

OrphanFilesDetection:

• enabled (必須): 孤立ファイル検出の有効/無効
• validEntryPoints (任意): 有効なエントリポイントパターンの配列。省略した場合、ワークスペースレベルのprodEntryPoints + devEntryPointsにデフォルト設定されます。
• ignoreTypeImports (任意): グラフ構築時に型のみのインポートを除外します（デフォルト: false）
• graphExclude (任意): グラフ分析から除外するファイルパターン
• autofix (任意): rev-dep config run --fix実行時に検出された孤立ファイルを自動的に削除します（デフォルト: false）

UnusedNodeModulesDetection:

• enabled (必須): 未使用モジュール検出の有効/無効
• includeModules (任意): 分析に含めるモジュールパターン
• excludeModules (任意): 分析から除外するモジュールパターン
• pkgJsonFieldsWithBinaries (任意): バイナリ参照を含むPackage.jsonフィールド（例: lint-staged）。プレーンテキスト検索を実行します
• filesWithBinaries (任意): バイナリ使用を検索するファイルパターン。プレーンテキスト検索を実行します
• filesWithModules (任意): モジュールインポートを検索するJS/TS以外のファイルパターン（例: シェルスクリプト）。プレーンテキスト検索を実行します
• outputType (任意): 出力形式 - "list"、"groupByModule"、"groupByFile"

MissingNodeModulesDetection:

• enabled (必須): 欠落モジュール検出の有効/無効
• includeModules (任意): 分析に含めるモジュールパターン
• excludeModules (任意): 分析から除外するモジュールパターン
• outputType (任意): 出力形式 - "list"、"groupByModule"、"groupByFile"、"groupByModuleFilesCount"

UnusedExportsDetection:

• enabled (必須): 未使用エクスポート検出の有効/無効
• validEntryPoints (任意): エクスポートが未使用として報告されないファイルのglobパターン。省略した場合、ワークスペースレベルのprodEntryPoints + devEntryPointsにデフォルト設定されます。
• ignoreTypeExports (任意): 分析からexport type / export interfaceをスキップします（デフォルト: false）
• graphExclude (任意): 未使用エクスポート分析から除外するファイルパターン
• ignore (任意): 抑制するエクスポート名/指定子のglobに対するファイルパスglob（ワークスペースパスディレクトリからの相対）のマップ。各値は文字列または文字列の配列にできます
• ignoreFiles (任意): ファイルパスglob。一致するファイルからの未使用エクスポートはすべて抑制されます
• ignoreExports (任意): グローバルに抑制するエクスポート名/指定子（またはglob）（"default"をサポート）
• autofix (任意): rev-dep config run --fix実行時に修正可能な未使用エクスポートの変更を自動的に適用します（デフォルト: false）

UnresolvedImportsDetection:

• enabled (必須): 未解決インポート検出の有効/無効
• ignore (任意): 抑制するインポートリクエストのglobに対するファイルパスglob（ワークスペースパスディレクトリからの相対）のマップ。各値は文字列または文字列の配列にできます
• ignoreFiles (任意): ファイルパスglob。一致するファイルからの未解決インポートはすべて抑制されます
• ignoreImports (任意): 未解決結果でグローバルに抑制するインポートリクエスト（またはglob）

DevDepsUsageOnProdDetection:

• enabled (必須): 制限された開発依存関係の使用検出の有効/無効
• prodEntryPoints (任意): 依存関係をトレースする元となる本番エントリポイントパターン。省略した場合、ワークスペースレベルのprodEntryPointsにデフォルト設定されます。
• ignoreTypeImports (任意): グラフ走査とモジュールマッチングから型のみのインポートを除外します（デフォルト: false）

RestrictedImportsDetection:

• enabled (必須): 制限付きインポート検出の有効/無効
• entryPoints (有効時に必須): 到達可能な依存関係グラフを構築するために使用するエントリポイントパターン（ここではワークスペースレベルのエントリポイントは適用されません）
• graphExclude (任意): 制限付きインポートのグラフ分析から除外するファイルパターン
• denyFiles (任意): 拒否されたファイルパスパターン（例: ["**/*.tsx"]）
• denyModules (任意): 拒否されたモジュールパターン（例: ["react", "react-*"]）
• ignoreMatches (任意): 制限付きインポートの結果から抑制するファイル/モジュールパターン
• ignoreTypeImports (任意): 走査から型のみのインポートを除外します（デフォルト: false）

パフォーマンスの利点

設定アプローチには大きなパフォーマンス上の利点があります:

• 単一の依存関係ツリー構築: すべてのワークスペースに対して1つの包括的な依存関係ツリーを構築します
• 並列ワークスペース実行: 複数のワークスペースを同時に処理します
• 並列チェック実行: 各ワークスペース内の有効なすべてのチェックを並列に実行します
• 最適化されたファイル検出: ファイルを一度検出し、すべてのチェックで再利用します

これにより、設定ベースのチェックは個々のコマンドを順次実行するよりも高速になります。特に複数のサブパッケージを持つ大規模なコードベースで顕著です。

探索的ツールキット 🔧

実用的な例を使って、rev-dep CLIコマンドを使用してプロジェクトのコード品質チェックを探索、デバッグ、構築する方法を示します。

ファイルがプロジェクト内のどこで使用されているかを特定する方法```

rev-dep resolve --file path/to/file.ts

そのファイルを暗黙的に必要とするすべてのエントリポイントと、解決パスが表示されます。

### **ファイルが使用されているか確認する方法**```
rev-dep resolve --file path/to/file.ts --compact-summary

ファイルに間接的に依存しているエントリポイントの数を表示します。

デッドファイルの特定方法```

rev-dep entry-points

必要に応じて `--result-exclude` を使用してフレームワークのエントリポイントを除外します。

たとえば、pages router を使用する場合は Next.js の有効なエントリポイントを除外し、scripts ディレクトリ（スクリプトは有効なエントリポイントです）を除外し、すべてのテストファイルを除外します:```
rev-dep entry-points --result-exclude "pages/**","scripts/**","**/*.test.*"

エントリポイントがインポートするすべてのファイルを一覧表示する方法```

rev-dep files --entry-point path/to/file.ts

重いコンポーネントや意図しない依存関係を特定するのに役立ちます。

### **エントリポイントの不要なインポートを削減する方法**

1. インポートされたすべてのファイルを一覧表示する:   ```
   rev-dep files --entry-point path/to/entry.ts

2. 不審なファイルを特定します。
3. それらが含まれる理由を追跡します: ``` rev-dep resolve --file path/to/suspect --entry-points path/to/entry.ts --all
   root@kitploit:~

循環依存を検出する方法```

rev-dep circular

### **重複コードを検出する方法**```
rev-dep duplicated-code

繰り返された行ではなく、繰り返されたコードブロックとJSX要素（抽出可能な単位）を報告します。--blind-identifiers を追加すると、変数がリネームされたコピーも検出できます。

未使用の node modules を見つける方法```

rev-dep node-modules unused

### **不足している node モジュールを見つける方法**```
rev-dep node-modules missing

node_modules のスペース使用量を確認する方法```

rev-dep node-modules dirs-size

### **本番コードで使用されている開発依存関係を検出する方法**```
rev-dep config run

devDepsUsageOnProdDetection が設定で有効になっている場合、rev-dep は次の処理を行います:

1. 指定された本番エントリポイントから依存関係グラフをトレースする
2. それらのエントリポイントから到達可能なすべてのファイルを特定する
3. インポートされたモジュールのいずれかが package.json の devDependencies にリストされているかを確認する
4. 開発依存関係がどこで使用されているかを示す違反を報告する

出力例:``` ❌ Restricted Dev Dependencies Usage Issues (2): lodash (dev dependency) - src/components/Button.tsx (from entry point: src/pages/index.tsx) - src/utils/helpers.ts (from entry point: src/pages/index.tsx) eslint (dev dependency) - src/config/eslint-config.js (from entry point: src/server.ts)

**重要な注意事項：**
- タイプのみのインポート（例：`import type { ReactNode } from 'react'`）は、`ignoreTypeImports` が有効な場合に無視されます
- package.json の `devDependencies` からの依存関係のみがフラグ付けされます
- `dependencies` からの本番依存関係は許可されます
- 本番ビルドでの実行時障害を防ぐのに役立ちます

## モノレポでの作業 🏗️

Rev-dep はモノレポプロジェクトを第一級でサポートし、ワークスペースパッケージ間での正確な依存関係分析を可能にします。

### followMonorepoPackages フラグ

`--follow-monorepo-packages` フラグは、モノレポのワークスペースパッケージからのインポート解決を有効にします。デフォルトでは、このフラグは単一パッケージプロジェクトとの互換性を維持するために `false` に設定されています。```bash
# Enable monorepo package resolution
rev-dep circular --follow-monorepo-packages
rev-dep resolve --file src/utils.ts --follow-monorepo-packages
rev-dep entry-points --follow-monorepo-packages

有効にすると、rev-dep は次のことを行います:

• ワークスペースパッケージを検出し、モノレポ構成をスキャンして自動的に行います
• パッケージ間のインポートを解決し、ワークスペース内で行います
• package.json の exports に従い、適切なモジュール解決を行います

Exports マップのサポート

Rev-dep は、package.json ファイルの exports フィールドを完全にサポートしています。これは、最新の Node.js プロジェクトでパッケージのエントリポイントを定義する標準的な方法です。

exports マップのサポートには、以下が含まれます:

• node、import、default、カスタム条件などの条件を使用する条件付き exports
• 柔軟なサブパスマッピングのためのワイルドカードパターン
• シンプルなメインエクスポート定義のためのシュガーシンタックス
• 複雑な解決シナリオのためのネストされた条件

Condition Names フラグ

どの条件付き exports を解決するかを制御するには、--condition-names フラグを使用します。これにより、パッケージの exports を解決する際の条件の優先順位を指定できます:```bash

Resolve exports for different environments

rev-dep circular --condition-names=node,import,default rev-dep resolve --file src/utils.ts --condition-names=import,node rev-dep entry-points --condition-names=default,node,import

条件は指定された順序で処理され、最初に一致した条件が使用されます。一般的な条件は次のとおりです:
- `node` - Node.js 環境
- `import` - ES モジュール
- `require` - CommonJS
- `default` - フォールバック条件
- プロジェクトまたはビルドツール固有のカスタム条件

exports を含む package.json の例:```json
{
  "name": "@myorg/utils",
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "require": "./dist/index.js",
      "default": "./dist/index.js"
    },
    "./helpers": "./dist/helpers.js",
    "./types/*": "./dist/types/*.d.ts"
  }
}

モノレポ解決の仕組み

1. モノレポ検出: followMonorepoPackages が有効な場合、rev-dep はワークスペース設定 (pnpm-workspace.yaml、package.json の workspaces など) をスキャンします。

2. パッケージ解決: ワークスペースパッケージへのインポートは、パッケージの exports 設定を使用して解決され、exports が定義されていない場合は main/module フィールドにフォールバックします。

3. 依存関係の検証: このツールは、対象パッケージが利用側の dependencies または devDependencies にリストされている場合にのみ、パッケージ間インポートを許可することを検証します。

4. パス解決: すべてのパスは各パッケージのルートを基準に解決され、モノレポ全体で正確な依存関係の追跡を保証します。

これにより、rev-dep は、コード品質とアーキテクチャを維持するためにパッケージ間の依存関係の理解が不可欠な大規模モノレポプロジェクトで特に効果的です。

パフォーマンス比較 ⚡

rev-dep は、複数のサブパッケージを含む 500k+ 行のコードのモノレポに対して、複数のチェックを約 150ms で実行できます。

Madge、dpdm、dependency-cruiser、skott、knip、depcheck などの類似ツールよりも優れたパフォーマンスを発揮します。

以下は、rev-dep と代替ツール間の特定タスクのパフォーマンス比較です。

プラットフォーム: WSL Linux Debian Intel(R) Core(TM) i9-14900KF CPU

測定条件: hyperfine -w 4 -r 8 (4回のウォームアップ + 8回の測定実行)

プロジェクト: 580k 行のコード、6024 のソースコードファイルからなる next.js アプリ

循環チェックのパフォーマンス比較

以下の表は、循環インポート検出を実行するさまざまなツール間のパフォーマンス比較を示しています。

rev-dep の循環チェックは、最速の代替ツールより 約20倍 高速です。

* knip は常に型のみのインポートエッジを無視し、それらを含めるフラグを提供しません。このコードベースのすべての循環には 少なくとも1つが含まれるため、knip は 0 循環を報告します。その 3 040 ms は実際の完全な 分析であり、単により小さいグラフに対するものです。同じルールを適用する rev-dep circular -t は、 143.3 ms ± 10.3 で正確に一致します（0 循環）。

プラットフォーム: WSL Linux Debian Intel(R) Core(TM) i9-14900KF CPU

測定条件: hyperfine -w 4 -r 8 (4回のウォームアップ + 8回の測定実行)

プロジェクト: 580k 行のコード、6024 のソースコードファイルからなる next.js アプリ

平均時間と使用コマンドを含む詳細な測定結果は PERFORMANCE.md を参照してください。

CLI リファレンス 📖

rev-dep circular

プロジェクト内の循環依存関係を検出します

構文

プロジェクトを分析して、モジュール間の循環依存関係を検出します。 循環依存関係はデバッグが難しい問題を引き起こす可能性があるため、通常は避けるべきです。``` rev-dep circular [flags]

#### 使用例```
rev-dep circular --ignore-types-imports

オプション```

  --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)

-c, --cwd string Working directory for the command (default "$PWD") --follow-monorepo-packages strings Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names -h, --help help for circular -t, --ignore-type-imports Exclude type imports from the analysis --process-ignored-files strings Glob patterns to process even if they are ignored by gitignore or exclude patterns --tsconfig-json string Path to tsconfig.json (default: ./tsconfig.json) -v, --verbose Show warnings and verbose output

### rev-dep config

rev-dep 設定ファイルを作成および実行します

#### 概要

rev-dep 設定ファイルを作成および実行するためのコマンドです。

#### オプション```
  -c, --cwd string   Working directory (default "$PWD")
  -h, --help         help for config

rev-dep config run

(.)rev-dep.config.json(c) で定義されたすべてのチェックを実行します

概要

(.)rev-dep.config.json(c) を処理し、ワークスペースごとに有効なすべてのチェック（循環インポート、孤立ファイル、モジュール境界、インポート規約、Node モジュール、未使用エクスポート、未解決インポート、制限付きインポート、制限付き開発依存関係の使用）を実行します。``` rev-dep config run [flags]

#### オプション```
  -c, --cwd string                  Working directory (default "$PWD")
      --fix                         Automatically fix fixable issues
      --format string               Output format (json, issues-list)
  -h, --help                        help for run
      --lint-config                 Also lint the config after running; prints only error/warning counts and fails (non-zero exit) on any lint error. Use 'config lint' for details and --fix
      --lint-config-rules strings   Which lint rules to run with --lint-config (comma-separated). Default: all. Implies --lint-config
      --list-all-issues             List all issues instead of limiting output
      --recheck                     Run all checks again after '--fix' to validate the final state
      --update-snapshot             Rewrite every configured duplicated-code snapshot from this run, acknowledging what it found.
  -v, --verbose                     Show warnings and verbose output
      --workspaces strings          Subset of workspaces to run (comma-separated list of workspace paths)

rev-dep config init

新しい rev-dep.config.json ファイルを初期化します

概要

デフォルト設定で現在のディレクトリに新しい rev-dep.config.json 構成ファイルを作成します。``` rev-dep config init [flags]

#### オプション```
  -c, --cwd string   Working directory (default "$PWD")
  -h, --help         help for init

rev-dep config lint

何にも一致しない設定の glob/パスパターンをレポートします（必要に応じて削除します）

概要

(.)rev-dep.config.json(c) を走査して、発見されたファイルまたはモジュールのいずれにも一致しなくなった「無効な」glob およびパスパターン（ignore パターン、 エントリポイントパターン、ワークスペースパス、グラフ除外、拒否されたファイル/モジュール、 および類似のもの）を探します。時間の経過とともに、設定には 名前が変更されたり削除されたりしたファイルのパターンが蓄積されます。このコマンドはそれらを表面化させ、 設定を簡潔に保ちます。

--fix を指定すると、無効なパターンはその場で削除され、すべてのコメントとフォーマットが保持されます。 一部のパターンはレポートされますが、自動削除されることはありません。削除すると、チェックの 動作が変わったり、設定が無効になる可能性があるためです - ワークスペースパス、必須のエントリポイント/ファイル /モジュール、モジュール境界セレクタなど。これらは「自動削除されない」とマークされ、 手動で解決する必要があります。``` rev-dep config lint [flags]

#### オプション```
  -c, --cwd string      Working directory (default "$PWD")
      --fix             Remove dead patterns from the config file (preserves comments and formatting)
  -h, --help            help for lint
      --rules strings   Lint rules to run (comma-separated): orphan-file-globs, orphan-module-globs, overlapping-globs, trailing-commas, compact. Default: all. orphan-file-globs/overlapping-globs use file discovery; orphan-module-globs parses the dependency tree; trailing-commas and compact only read the config file.
  -v, --verbose         Show warnings and verbose output

rev-dep config migrate

v2 設定を v3 (2.0) スキーマにアップグレードします

Synopsis

rev-dep.config.json を v2 スキーマから v3 (config version 2.0) にアップグレードします。

安全で曖昧さのない変更をその場で適用します（トップレベルの 'rules' 配列を 'workspaces' にリネームし、'configVersion' を 2.0 に更新し、circular-imports 検出器から廃止された 'algorithm' オプションを削除します）。すべてのコメントと書式を保持します。コミットする前に git で変更内容を確認してください。

次に、自動では変更できなかった内容をリスト表示します。v3 のより厳格で gitignore に整合したルールの下でマッチセットが変化した可能性のある glob パターンと、設定ファイルの編集では対応できない動作変更です。これらは手動で確認してください - v3 の破壊的変更ガイドを参照してください。``` rev-dep config migrate [flags]

#### オプション```
  -c, --cwd string   Working directory (default "$PWD")
  -h, --help         help for migrate

rev-dep debug

パーサーとリゾルバーの内部を検査するためのデバッグツール

概要

rev-dep がファイルを解析し、依存関係を解決する方法を検査するためのデバッグツール。出力は semver に従いません。

オプション```

-h, --help help for debug

### rev-dep debug get-tree-for-cwd

デバッグ: 解析用の完全な依存関係ツリーを表示します

#### 概要

完全な依存関係ツリーを検査するためのデバッグツールです。出力はsemverに従いません。```
rev-dep debug get-tree-for-cwd [flags]

オプション```

  --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)
  --cwd string                                                  Working directory for the command (default "$PWD")
  --follow-monorepo-packages strings                            Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names

-h, --help help for get-tree-for-cwd -t, --ignore-type-imports Exclude type imports from the analysis --include-dev-deps-from-root Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot --node-modules-resolution string Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package") --tsconfig-json string Path to tsconfig.json (default: ./tsconfig.json) -v, --verbose Show warnings and verbose output

### rev-dep debug list-cwd-files

現在の作業ディレクトリ内のすべてのファイルを一覧表示します

#### 概要

指定されたディレクトリ内のすべてのファイルを再帰的に一覧表示し、
結果をフィルタリングするオプションを備えています。```
rev-dep debug list-cwd-files [flags]

例```

rev-dep debug list-cwd-files --include='.ts' --exclude='.test.ts'

#### オプション```
      --count             Only display the count of matching files
      --cwd string        Directory to list files from (default "$PWD")
      --exclude strings   Exclude files matching these glob patterns
  -h, --help              help for list-cwd-files
      --include strings   Only include files matching these glob patterns

rev-dep debug parse-file

デバッグ: 単一ファイルの解析済みインポートを表示します

概要

パーサーが特定のファイルをどのように処理するかを調査するためのデバッグツールです。出力はsemverに従いません。``` rev-dep debug parse-file [flags]

#### オプション```
      --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)
      --cwd string                                                  Working directory for the command (default "$PWD")
      --file string                                                 file to parse
      --follow-monorepo-packages strings                            Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names
  -h, --help                                                        help for parse-file
      --include-dev-deps-from-root                                  Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot
      --node-modules-resolution string                              Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package")
      --tsconfig-json string                                        Path to tsconfig.json (default: ./tsconfig.json)
  -v, --verbose                                                     Show warnings and verbose output

rev-dep debug parse-tsconfig

デバッグ: 解析されたTypeScript設定エイリアスを表示

概要

TypeScript設定がどのように解析され、どのエイリアスが抽出されるかを検査するためのデバッグツールです。出力はsemverに従いません。``` rev-dep debug parse-tsconfig [flags]

#### オプション```
  -h, --help              help for parse-tsconfig
      --tsconfig string   Path to TypeScript configuration file

rev-dep duplicated-code

プロジェクトのファイル内（およびファイル間）で重複したコードを検出します

概要

すべてのソースファイルをスキャンし、コピー＆ペースト可能なチャンク（波括弧ブロックとJSX要素）を、あらゆるネストレベルで探し、複数回出現するものを報告します。

比較ではフォーマットとコメントは完全に無視されるため、インデントし直したコピーでも一致します。

4つのフィルタが、報告する価値があるものを決定します。--min-tokens と --min-lines はサイズを測定し、--min-depth と --min-statements は複雑さを測定します。これは、重複した3キーの設定オブジェクトと重複したロジックを区別する要素であり、サイズの下限では区別できません。なぜなら、オブジェクトのキーや文字列値は長くなる可能性があるからです。--min-duplicates は、資格を得るために必要なコピー数を設定します。

デフォルトでは、コードは記述されたとおりに一致する必要があります。各 --blind-* フラグは、比較からトークンのカテゴリを1つ除外し、それらは自由に組み合わせられます：

--blind-identifiers 名前がワイルドカードになり、変数、関数、コンポーネントが リネームされたコピーでも報告されます --blind-strings 文字列とテンプレートの内容がワイルドカードになります --blind-numbers 数値リテラルがワイルドカードになります``` rev-dep duplicated-code [flags]

#### 使用例```
rev-dep duplicated-code --cwd ./src --blind-identifiers

オプション```

  --blind-identifiers               Ignore the spelling of names, so a copy whose variables, functions or components were renamed still counts as duplication.
  --blind-numbers                   Ignore the value of numeric literals, so a copy with different constants still counts
  --blind-strings                   Ignore the text of string and template literals, so a copy with different messages or keys still counts

-c, --cwd string Working directory for the command (default "$PWD") -f, --format string Output format: "human" or "json". JSON reports every finding with its canonical hash and the byte and line range of each occurrence, for comparing against another run or another tool (default "human") -h, --help help for duplicated-code --ignore-files strings Glob patterns of files to leave out of the analysis. --json-snippets Include the source of each finding in JSON output. Off by default because snippets dominate the file size and a comparison keyed on ranges does not need them --min-depth int Smallest duplication to report, in nesting levels counting the block itself. 1 admits everything; 2 requires at least one nested level, which is what filters out flat objects and single JSX elements however long their keys or strings are --min-duplicates int How many copies a chunk needs before it is reported. Raise to 3 to ignore code that has only been copied once (default 2) --min-lines int Smallest duplication to report, in lines of the first occurrence (default 3) --min-statements int Smallest duplication to report, in statements directly inside the block. Applies only to statement blocks (function and control-flow bodies); object literals and JSX elements are expressions and are not filtered by it - use --min-depth for those --min-tokens int Smallest duplication to report, in tokens. Tokens rather than characters because the count does not change when a --blind-* flag is applied, so one number means the same amount of code whatever is being ignored (default 50) --process-ignored-files strings Glob patterns to analyse even when gitignore excludes them. --skip-objects Do not report duplications that are only object literals. --snapshot string Path to a JSON snapshot of acknowledged duplications. With it, the command reports what changed since the snapshot instead of everything that exists, and exits non-zero on any difference --update-snapshot Rewrite the --snapshot file from this run, acknowledging everything it found. Always explicit: nothing updates a snapshot on its own

### rev-dep entry-points

プロジェクト内のすべてのエントリポイントを検出して一覧表示します

#### Synopsis

プロジェクト構造を分析して、潜在的なエントリポイントをすべて特定します。
アプリケーションのアーキテクチャと依存関係を理解するのに役立ちます。```
rev-dep entry-points [flags]

例```

rev-dep entry-points --print-deps-count

#### オプション```
      --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)
  -n, --count                                                       Only display the number of entry points found
  -c, --cwd string                                                  Working directory for the command (default "$PWD")
      --follow-monorepo-packages strings                            Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names
      --graph-exclude strings                                       Exclude files matching these glob patterns from analysis
  -h, --help                                                        help for entry-points
  -t, --ignore-type-imports                                         Exclude type imports from the analysis
      --print-deps-count                                            Show the number of dependencies for each entry point
      --process-ignored-files strings                               Glob patterns to process even if they are ignored by gitignore or exclude patterns
      --result-exclude strings                                      Exclude files matching these glob patterns from results
      --result-include strings                                      Only include files matching these glob patterns in results
      --tsconfig-json string                                        Path to tsconfig.json (default: ./tsconfig.json)
  -v, --verbose                                                     Show warnings and verbose output

rev-dep files

エントリポイントの依存関係ツリー内のすべてのファイルを一覧表示します

概要

指定されたエントリポイントが必要とするすべてのファイルを再帰的に検索して一覧表示します。``` rev-dep files [flags]

#### 例```
rev-dep files --entry-point src/index.ts

オプション```

  --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)

-n, --count Only display the count of files in the dependency tree -c, --cwd string Working directory for the command (default "$PWD") -p, --entry-point string Entry point file to analyze (required) --follow-monorepo-packages strings Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names -h, --help help for files -t, --ignore-type-imports Exclude type imports from the analysis --process-ignored-files strings Glob patterns to process even if they are ignored by gitignore or exclude patterns --tsconfig-json string Path to tsconfig.json (default: ./tsconfig.json) -v, --verbose Show warnings and verbose output

### rev-dep imported-by

指定されたファイルを直接インポートするすべてのファイルを一覧表示します

#### 概要

プロジェクト内で指定されたファイルを直接インポートするすべてのファイルを検索して一覧表示します。
これは、特定のファイルへの変更が及ぼす影響を理解するのに役立ちます。```
rev-dep imported-by [flags]

例```

rev-dep imported-by --file src/utils/helpers.ts

#### オプション```
      --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)
  -n, --count                                                       Only display the count of importing files
  -c, --cwd string                                                  Working directory for the command (default "$PWD")
  -f, --file string                                                 Target file to find importers for (required)
      --follow-monorepo-packages strings                            Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names
  -h, --help                                                        help for imported-by
      --list-imports                                                List the import identifiers used by each file
      --process-ignored-files strings                               Glob patterns to process even if they are ignored by gitignore or exclude patterns
      --tsconfig-json string                                        Path to tsconfig.json (default: ./tsconfig.json)
  -v, --verbose                                                     Show warnings and verbose output

rev-dep lines-of-code

プロジェクト内のコメントと空行を除いた、実際のコード行数を数えます``` rev-dep lines-of-code [flags]

#### 例```
rev-dep lines-of-code

オプション```

-c, --cwd string Directory to analyze (default "$PWD") -h, --help help for lines-of-code

### rev-dep list-cwd-files

現在の作業ディレクトリ内のすべてのファイルを一覧表示します

#### 概要

指定されたディレクトリ内のすべてのファイルを再帰的に一覧表示し、
結果をフィルタリングするオプションを備えています。```
rev-dep list-cwd-files [flags]

使用例```

rev-dep list-cwd-files --include='.ts' --exclude='.test.ts'

#### オプション```
      --count             Only display the count of matching files
      --cwd string        Directory to list files from (default "$PWD")
      --exclude strings   Exclude files matching these glob patterns
  -h, --help              help for list-cwd-files
      --include strings   Only include files matching these glob patterns

rev-dep unresolved

プロジェクト内の未解決インポートを一覧表示します

概要

インポート解決中に解決できなかったインポートを検出して一覧表示します。インポートをファイルごとにグループ化します。``` rev-dep unresolved [flags]

#### オプション```
      --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)
      --custom-asset-extensions strings                             Additional asset extensions treated as resolvable (e.g. glb,mp3)
  -c, --cwd string                                                  Working directory for the command (default "$PWD")
      --follow-monorepo-packages strings                            Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names
  -h, --help                                                        help for unresolved
      --ignore stringToString                                       Map of file path (relative to cwd) to exact import request to ignore (e.g. --ignore src/index.ts=some-module) (default [])
      --ignore-files strings                                        File path glob patterns to ignore in unresolved output
      --ignore-imports strings                                      Import requests to ignore globally in unresolved output
      --include-dev-deps-from-root                                  Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot
      --node-modules-resolution string                              Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package")
      --process-ignored-files strings                               Glob patterns to process even if they are ignored by gitignore or exclude patterns
      --tsconfig-json string                                        Path to tsconfig.json (default: ./tsconfig.json)
  -v, --verbose                                                     Show warnings and verbose output

rev-dep node-modules

Node.js の依存関係を分析・管理する

概要

Node.js モジュールの依存関係を分析・管理するためのツールです。 プロジェクト内の未使用・欠落・重複した依存関係を特定するのに役立ちます。

使用例```

rev-dep node-modules used -p src/index.ts rev-dep node-modules unused --exclude-modules=@types/* rev-dep node-modules missing --entry-points=src/main.ts

#### オプション```
  -h, --help   help for node-modules

rev-dep node-modules analyze-size

node_modules のディスク使用量を分析

概要

node_modules ディレクトリの詳細なサイズ分析を提供します。 容量を圧迫する依存関係を特定するのに役立ちます。``` rev-dep node-modules analyze-size [flags]

#### 使用例```
rev-dep node-modules analyze-size

オプション```

-c, --cwd string Working directory for the command (default "$PWD") -h, --help help for analyze-size

### rev-dep node-modules dirs-size

node_modules ディレクトリ内の累積ファイルサイズを計算します

#### 概要

現在のディレクトリとそのサブディレクトリ内の node_modules フォルダのサイズを計算して表示します。
表示されるサイズは、ディスク上で実際に占有されるファイルサイズよりも小さくなります。このツールは、ディスク上のファイルサイズ（ディスクブロックの使用に関連）ではなく、実際のファイルサイズを計算します。```
rev-dep node-modules dirs-size [flags]

使用例```

rev-dep node-modules dirs-size

#### オプション```
  -c, --cwd string   Working directory for the command (default "$PWD")
  -h, --help         help for dirs-size

rev-dep node-modules installed-duplicates

重複したパッケージのインストールを検出して最適化します

概要

node_modules に複数回インストールされているパッケージを特定します。 重複したパッケージ間にシンボリックリンクを作成することで、ストレージを最適化できます。``` rev-dep node-modules installed-duplicates [flags]

#### 使用例```
rev-dep node-modules installed-duplicates --optimize --size-stats

オプション```

-c, --cwd string Working directory for the command (default "$PWD") -h, --help help for installed-duplicates --isolate Create symlinks only within the same top-level node_module directories. By default optimize creates symlinks between top-level node_module directories (eg. when workspaces are used). Needs --optimize flag to take effect --optimize Automatically create symlinks to deduplicate packages --size-stats Print node modules dirs size before and after optimization. Might take longer than optimization itself --verbose Show detailed information about each optimization

### rev-dep node-modules インストール済み

プロジェクト内のインストール済み npm パッケージをすべて一覧表示します。

#### Synopsis

node_modules ディレクトリを再帰的にスキャンして、インストール済みのすべてのパッケージを一覧表示します。
モノレポ全体の依存関係の監査に役立ちます。```
rev-dep node-modules installed [flags]

例```

rev-dep node-modules installed --include-modules=@myorg/*

#### オプション```
  -c, --cwd string                Working directory for the command (default "$PWD")
  -e, --exclude-modules strings   list of modules to exclude from the output
  -h, --help                      help for installed
  -i, --include-modules strings   list of modules to include in the output

rev-dep node-modules 欠落

package.json にリストされていないインポート済みパッケージを探します

概要

コード内でインポートされているが、package.json の dependencies に宣言されていないパッケージを特定します。``` rev-dep node-modules missing [flags]

#### 例```
rev-dep node-modules missing --entry-points=src/main.ts

オプション```

  --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)

-n, --count Only display the count of modules -c, --cwd string Working directory for the command (default "$PWD") -p, --entry-points strings Entry point file(s) to start analysis from (default: auto-detected) -e, --exclude-modules strings list of modules to exclude from the output -b, --files-with-binaries strings Additional files to search for binary usages. Use paths relative to cwd -m, --files-with-node-modules strings Additional files to search for module imports. Use paths relative to cwd --follow-monorepo-packages strings Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names --group-by-file Organize output by project file path --group-by-module Organize output by npm package name --group-by-module-files-count Organize output by npm package name and show count of files using it -h, --help help for missing -t, --ignore-type-imports Exclude type imports from the analysis --include-dev-deps-from-root Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot -i, --include-modules strings list of modules to include in the output --node-modules-resolution string Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package") --pkg-fields-with-binaries strings Additional package.json fields to check for binary usages --tsconfig-json string Path to tsconfig.json (default: ./tsconfig.json) -v, --verbose Show warnings and verbose output --zero-exit-code Use this flag to always return zero exit code

### rev-dep node-modules prune-docs

インストール済みの node_modules パッケージから markdown/docs 系ファイルを削除します

#### 概要

グロブパターンに基づいて、インストール済みの node_modules パッケージからファイルを削除します。
README/LICENSE/docs ファイルを整理して依存関係のサイズを削減するのに役立ちます。```
rev-dep node-modules prune-docs [flags]

例```

rev-dep node-modules prune-docs --defaults rev-dep node-modules prune-docs --patterns ".md,README.md,docs/**" rev-dep node-modules prune-docs --defaults --patterns ".txt"

#### オプション```
  -c, --cwd string         Working directory for the command (default "$PWD")
      --defaults           Use default prune patterns: LICENSE, README.md, docs/**
  -h, --help               help for prune-docs
      --pattern strings    Alias for --patterns
  -p, --patterns strings   Glob patterns (relative to each package root) of files to remove, e.g. "*.md,README.md,docs/**"

rev-dep node-modules unused

コード内でインポートされていないインストール済みパッケージを検索します

概要

package.json の依存関係をコードベース内の実際のインポートと比較して、 未使用の可能性があるパッケージを特定します。``` rev-dep node-modules unused [flags]

#### 例```
rev-dep node-modules unused --exclude-modules=@types/*

オプション```

  --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)

-n, --count Only display the count of modules -c, --cwd string Working directory for the command (default "$PWD") -p, --entry-points strings Entry point file(s) to start analysis from (default: auto-detected) -e, --exclude-modules strings list of modules to exclude from the output -b, --files-with-binaries strings Additional files to search for binary usages. Use paths relative to cwd -m, --files-with-node-modules strings Additional files to search for module imports. Use paths relative to cwd --follow-monorepo-packages strings Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names -h, --help help for unused -t, --ignore-type-imports Exclude type imports from the analysis --include-dev-deps-from-root Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot -i, --include-modules strings list of modules to include in the output --node-modules-resolution string Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package") --pkg-fields-with-binaries strings Additional package.json fields to check for binary usages --tsconfig-json string Path to tsconfig.json (default: ./tsconfig.json) -v, --verbose Show warnings and verbose output --zero-exit-code Use this flag to always return zero exit code

### rev-dep node-modules 使用

コード内でインポートされているすべての npm パッケージを一覧表示します

#### 概要

コードを解析して、実際に使用されている npm パッケージを特定します。
プロジェクトの実行時依存関係を把握するのに役立ちます。```
rev-dep node-modules used [flags]

使用例```

rev-dep node-modules used -p src/index.ts --group-by-module

#### オプション```
      --condition-names strings                                     List of conditions for package.json imports resolution (e.g. node, imports, default)
  -n, --count                                                       Only display the count of modules
  -c, --cwd string                                                  Working directory for the command (default "$PWD")
  -p, --entry-points strings                                        Entry point file(s) to start analysis from (default: auto-detected)
  -e, --exclude-modules strings                                     list of modules to exclude from the output
  -b, --files-with-binaries strings                                 Additional files to search for binary usages. Use paths relative to cwd
  -m, --files-with-node-modules strings                             Additional files to search for module imports. Use paths relative to cwd
      --follow-monorepo-packages strings                            Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names
      --group-by-entry-point                                        Organize output by entry point file path
      --group-by-entry-point-modules-count                          Organize output by entry point and show count of unique modules
      --group-by-file                                               Organize output by project file path
      --group-by-module                                             Organize output by npm package name
      --group-by-module-entry-points-count                          Organize output by npm package name and show count of entry points using it
      --group-by-module-files-count                                 Organize output by npm package name and show count of files using it
      --group-by-module-show-entry-points                           Organize output by npm package name and list entry points using it
  -h, --help                                                        help for used
  -t, --ignore-type-imports                                         Exclude type imports from the analysis
      --include-dev-deps-from-root                                  Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot
  -i, --include-modules strings                                     list of modules to include in the output
      --node-modules-resolution string                              Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package")
      --pkg-fields-with-binaries strings                            Additional package.json fields to check for binary usages
      --tsconfig-json string                                        Path to tsconfig.json (default: ./tsconfig.json)
  -v, --verbose                                                     Show warnings and verbose output

rev-dep resolve

プロジェクト内のファイル間の依存関係パスをトレースして表示します

概要

指定されたファイル間の依存関係チェーンを分析して表示します。 コードベースの各部分がどのように接続されているかを理解するのに役立ちます。``` rev-dep resolve [flags]

#### 使用例```
rev-dep resolve -p src/index.ts -f src/utils/helpers.ts

オプション```

-a, --all Show all possible resolution paths, not just the first one --compact-summary Display a compact summary of found paths --condition-names strings List of conditions for package.json imports resolution (e.g. node, imports, default) -c, --cwd string Working directory for the command (default "$PWD") -p, --entry-points strings Entry point file(s) or glob pattern(s) to start analysis from (default: auto-detected) -f, --file string Target file to check for dependencies --follow-monorepo-packages strings Enable resolution of imports from monorepo workspace packages. Pass without value to follow all, or pass package names --graph-exclude strings Glob patterns to exclude files from dependency analysis -h, --help help for resolve -t, --ignore-type-imports Exclude type imports from the analysis --include-dev-deps-from-root Treat the monorepo root package.json devDependencies as available to package code, so they are not reported as missing or unresolved. Mirrors config nodeModulesResolution.includeDevDepsFromRoot --module string Target node module name to check for dependencies --node-modules-resolution string Which package.json each import is validated against: 'entry-package' (the cwd package.json, default) or 'nearest-package' (each file's own nearest package.json) (default "entry-package") --process-ignored-files strings Glob patterns to process even if they are ignored by gitignore or exclude patterns --tsconfig-json string Path to tsconfig.json (default: ./tsconfig.json) -v, --verbose Show warnings and verbose output

<!-- cli-docs-end -->


## 用語集 📚

**rev-dep** が扱う問題領域で使われる用語は、混乱を招くことがあります。
ここでは、概念を理解するための小さな用語集を紹介します。

### 依存関係（Dependency）

*依存関係*（dependency）は文字通りに理解できます。プロジェクトの依存関係グラフの文脈では、以下を指す場合があります：

* **node module / パッケージ**（パッケージはプロジェクトやファイルの依存関係）、または
* **ソースコードファイル**（あるファイルが別のファイルをインポートする場合、そのファイルは依存関係になります）。

### エントリポイント（Entry point）

*エントリポイント*とは、**他のどのファイルからもインポートされない**ソースファイルです。
以下を表すことができます：

* アプリケーションのメインエントリ
* 個々のページや機能
* 設定ファイルやテストのブートストラップファイル

- プロジェクト構造によって異なります。

### 未使用 / デッドファイル（Unused / Dead file）

ファイルが*未使用*または*デッド*と見なされる条件は、次のとおりです：

* **エントリポイント**であり（何もインポートしない）、**かつ**
* 実行しても**意味のある出力**や副作用が**発生しない**。

実際には、このようなファイルは安全に削除できることがよくあります。

### 循環依存（Circular dependency）

*循環依存*は、ファイルがインポートの連鎖を通じて**直接的または間接的に自分自身をインポートする**場合に発生します。

これは、予測不能な実行時動作、未初期化の値、または微妙なバグを引き起こす可能性があります。
ただし、**TypeScript の型のみのインポート**間の循環依存は通常は無害です。

### 逆依存関係（Reverse dependency、または「依存元」（dependents））

特定のファイルを*インポートする*ファイル。
「このファイルを変更または削除したら、何が壊れるか？」という質問に答えるのに役立ちます。

### インポートグラフ / 依存関係グラフ（Import graph / Dependency graph）

ファイルやモジュールが互いにどのようにインポートし合うかを視覚的に表現したものです。

### 欠落した依存関係 / 未使用の node module（Missing dependency / unused node module）

コードがインポートしているにもかかわらず、**package.json に記載されていない**モジュール。

### 未使用の依存関係 / 未使用の node module（Unused dependency / unused node module）

**package.json に記載されている**が、ソースコード内で**一切インポートされていない**依存関係。

### ルートディレクトリ / プロジェクトルート（Root directory / Project root）

依存関係分析の開始点として使用される最上位ディレクトリ。

## テレメトリ

Rev-Dep は、`rev-dep config run` の間だけ、単一の**匿名**イベントを収集します。詳細は[テレメトリのドキュメント](https://rev-dep.com/docs/telemetry)をご覧ください。

`REV_DEP_TELEMETRY_OFF=true` を設定すると、完全にオプトアウトできます。

## 🇵🇱 と 🇯🇵 で 🧠 により [@jayu](https://github.com/jayu) が制作

この小さなソフトウェアが、プロジェクトの複雑さを発見し理解する助けとなり、リファクタリングの際に自信を持てるようになることを願っています。このツールが役に立ったなら、遠慮なく ⭐ を付けてください！

### 私の他のプロジェクト

- [CodeQue - 構造的なコード検索](https://codeque.co)
- [構造的コード検索 VSCode](https://marketplace.visualstudio.com/items?itemName=CodeQue.codeque)