GitNexus による影響分析

使用するタイミング

• 「この関数を変更しても安全か？」
• 「X を修正すると何が壊れるか？」
• 「ブラストラディウスを表示して」
• 「このコードは誰が使っているか？」
• 非自明なコード変更を行う前
• コミット前に — 変更が何に影響するかを理解するため

ワークフロー

1. gitnexus_impact({target: "X", direction: "upstream"})  → これに依存しているものを取得
2. READ gitnexus://repo/{name}/processes                   → 影響を受ける実行フローを確認
3. gitnexus_detect_changes()                               → 現在の git 変更を影響を受けるフローにマッピング
4. リスクを評価し、ユーザーに報告

「Index is stale」の場合 → ターミナルで npx -y gitnexus@1.3.11 analyze を実行してください。

チェックリスト

- [ ] gitnexus_impact({target, direction: "upstream"}) で依存関係を検索
- [ ] d=1 の項目を最初に確認（これらは必ず壊れます）
- [ ] 信頼度が高い（>0.8）依存関係をチェック
- [ ] READ processes で影響を受ける実行フローを確認
- [ ] コミット前チェック用に gitnexus_detect_changes() を実行
- [ ] リスクレベルを評価し、ユーザーに報告

出力の理解

深さ	リスクレベル	意味
d=1	必ず壊れます	直接呼び出し元/インポーター
d=2	影響を受ける可能性が高い	間接的な依存関係
d=3	テストが必要な可能性	推移的な影響

リスク評価

影響を受ける項目	リスク
<5 シンボル、プロセスが少数	低
5～15 シンボル、2～5 プロセス	中
>15 シンボルまたはプロセスが多数	高
クリティカルパス（認証、決済）	極高

ツール

gitnexus_impact — シンボルブラストラディウスのための主要ツール：

gitnexus_impact({
  target: "validateUser",
  direction: "upstream",
  minConfidence: 0.8,
  maxDepth: 3
})

→ d=1 (必ず壊れます):
  - loginHandler (src/auth/login.ts:42) [CALLS, 100%]
  - apiMiddleware (src/api/middleware.ts:15) [CALLS, 100%]

→ d=2 (影響を受ける可能性が高い):
  - authRouter (src/routes/auth.ts:22) [CALLS, 95%]

gitnexus_detect_changes — git-diff ベースの影響分析：

gitnexus_detect_changes({scope: "staged"})

→ 変更: 3 ファイル内の 5 シンボル
→ 影響: LoginFlow, TokenRefresh, APIMiddlewarePipeline
→ リスク: 中

例：「validateUser を変更すると何が壊れるか？」

1. gitnexus_impact({target: "validateUser", direction: "upstream"})
   → d=1: loginHandler, apiMiddleware (必ず壊れます)
   → d=2: authRouter, sessionManager (影響を受ける可能性が高い)

2. READ gitnexus://repo/my-app/processes
   → LoginFlow と TokenRefresh が validateUser に関わる

3. リスク: 直接呼び出し元 2 個、プロセス 2 個 = 中程度