# 依賴分析 (deps)

> **執行方式**：以下 `agent-ide` 指 `node ${PLUGIN_ROOT}/bin/agent-ide.js`
> （PLUGIN_ROOT = 此 skill 所在 repo 根目錄，往上三層）

分析專案依賴關係，檢測循環依賴和孤立檔案。

## 子命令

| 子命令 | 說明 |
|--------|------|
| `graph` | 完整依賴圖 |
| `cycles` | 循環依賴分析 |
| `impact` | 影響分析 |
| `orphans` | 孤立檔案分析 |

## 用法

```bash
# 基本分析（預設顯示循環依賴和孤立檔案）
agent-ide deps --path . --format json

# 完整依賴圖
agent-ide deps --path . --format json --all

# 使用子命令
agent-ide deps graph --path . --format json
agent-ide deps cycles --path . --format json
agent-ide deps orphans --path . --format json
```

## 參數

| 參數 | 說明 |
|------|------|
| `--path` | 專案路徑 |
| `--all` | 顯示完整依賴圖 |
| `--format` | 輸出格式：`json`、`summary` |

## 輸出格式

### json（預設）

```json
{
  "command": "deps",
  "success": true,
  "cycles": [
    { "cycle": ["a.ts", "b.ts", "c.ts"], "length": 3 }
  ],
  "orphans": ["src/utils/unused.ts"],
  "graph": {
    "nodes": [{ "id": "src/index.ts", "label": "index" }],
    "edges": [{ "from": "src/index.ts", "to": "src/app.ts" }]
  },
  "summary": {
    "totalScanned": 50,
    "totalFiles": 50,
    "totalDependencies": 120,
    "cyclesFound": 1,
    "orphanedFiles": 3
  }
}
```

### summary

```
🔍 分析依賴關係...
未發現循環依賴

孤立檔案: 12 個
  - src/index.ts
  - src/quality-test/error-handling-bad.ts
  - src/quality-test/naming-violations.ts
  - src/utils/array-utils.ts
  - src/utils/date-utils.ts
  ... 還有 7 個
```

## 欄位說明

| 欄位 | 說明 |
|------|------|
| `cycles` | 循環依賴列表 |
| `cycles[].cycle` | 循環路徑 |
| `cycles[].length` | 循環長度 |
| `orphans` | 孤立檔案列表（無被引用） |
| `graph.nodes` | 依賴圖節點 |
| `graph.edges` | 依賴圖邊 |
| `summary.cyclesFound` | 發現的循環數 |
| `summary.orphanedFiles` | 孤立檔案數 |