📦 Dependency Management

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐ (P2 Level) Purpose: Cargo/npm依存関係の追加・更新・監査

---

📋 概要

Rust (Cargo) と Node.js (npm) の依存関係管理、 バージョン競合解決、セキュリティ監査を提供します。

---

🎯 P0: 呼び出しトリガー

トリガー	例
依存更新	"update dependencies"
バージョン競合	"why is there a version conflict?"
依存追加	"add a new dependency"
定期更新	"weekly/monthly dependency updates"

---

🔧 P1: コマンド一覧

Cargo（Rust）

コマンド	用途	頻度
cargo add <crate>	依存追加	中
cargo update	全依存更新	週次
cargo update -p <crate>	特定更新	随時
cargo tree	依存ツリー	調査時
cargo audit	セキュリティ監査	週次
cargo-udeps	未使用検出	月次

npm（Node.js）

コマンド	用途	頻度
npm install <pkg>	依存追加	中
npm update	全依存更新	週次
npm audit	セキュリティ監査	週次
npm outdated	古い依存確認	月次

---

🚀 P2: 更新戦略

更新頻度ガイドライン

バージョン	頻度	リスク	例
Patch (x.x.Y)	週次	低	1.0.0 → 1.0.1
Minor (x.Y.0)	月次	中	1.0.0 → 1.1.0
Major (Y.0.0)	四半期	高	1.0.0 → 2.0.0

Pattern 1: 安全な更新

# Step 1: 現状確認
cargo outdated

# Step 2: Patch更新（安全）
cargo update

# Step 3: テスト
cargo test --all

# Step 4: 監査
cargo audit

Pattern 2: 特定クレート更新

# 特定クレートのみ
cargo update -p tokio

# バージョン指定（Cargo.toml）
[dependencies]
tokio = "1.35"  # 1.35.x の最新

Pattern 3: 依存ツリー調査

# 全体ツリー
cargo tree

# 特定クレートの依存元
cargo tree -i tokio

# 重複検出
cargo tree -d

---

⚡ P3: バージョン競合解決

競合パターン

パターン	症状	解決策
複数バージョン	cargo tree -d で検出	統一バージョン指定
非互換feature	コンパイルエラー	feature調整
循環依存	リンクエラー	依存構造見直し

解決例

# Cargo.toml - バージョン統一
[workspace.dependencies]
tokio = { version = "1.35", features = ["full"] }

[dependencies]
tokio = { workspace = true }

# feature競合確認
cargo tree -f "{p} {f}"

---

📊 Workspace依存管理

推奨構造

# ルート Cargo.toml
[workspace]
members = ["crates/*"]

[workspace.dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }

# crates/miyabi-core/Cargo.toml
[dependencies]
tokio = { workspace = true }
serde = { workspace = true }

---

🛡️ セキュリティ監査

自動監査設定

# 監査実行
cargo audit

# 修正可能な脆弱性を自動修正
cargo audit fix

# CI用（失敗時に終了）
cargo audit --deny warnings

未使用依存検出

# インストール
cargo install cargo-udeps

# 実行（nightly必要）
cargo +nightly udeps

---

✅ 成功基準

チェック項目	基準
cargo audit	0 vulnerabilities
cargo tree -d	最小限の重複
cargo-udeps	未使用なし
ビルド	成功
テスト	全パス

---

🔗 関連Skills

• Rust Development: ビルド確認
• Security Audit: 脆弱性対応
• Git Workflow: 更新コミット