mcp-probe-kit 3.0.8 → 3.0.9

package/README.md

@@ -65,6 +65,7 @@ A powerful MCP (Model Context Protocol) server providing **22 tools** covering t
 ### 🧠 Code Graph Bridge (GitNexus)
 
 - `code_insight` bridges GitNexus by default for query/context/impact analysis
+- The bridge launches `npx -y gitnexus@latest mcp` by default to reduce stale package risk
 - `start_feature` and `start_bugfix` automatically enrich plans with graph context when available
 - If GitNexus is unavailable, the server falls back automatically without breaking orchestration
 - Graph snapshots are exposed as resources (`probe://graph/latest`, `probe://graph/history`, `probe://graph/latest.md`)

package/build/lib/gitnexus-bridge.js

@@ -5,7 +5,7 @@ import * as path from "node:path";
 import { isAbortError, throwIfAborted, } from "./tool-execution-context.js";
 const DEFAULT_CONNECT_TIMEOUT_MS = readIntEnv("MCP_GITNEXUS_CONNECT_TIMEOUT_MS", 12000);
 const DEFAULT_CALL_TIMEOUT_MS = readIntEnv("MCP_GITNEXUS_TIMEOUT_MS", 20000);
-const DEFAULT_GITNEXUS_ARGS = ["-y", "gitnexus", "mcp"];
+const DEFAULT_GITNEXUS_ARGS = ["-y", "gitnexus@latest", "mcp"];
 const FAILURE_CACHE_TTL_MS = readIntEnv("MCP_GITNEXUS_FAILURE_CACHE_TTL_MS", 30000);
 let bridgeFailureUntil = 0;
 let bridgeFailureReason = "";

package/docs/i18n/en.json

@@ -14,21 +14,21 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI Development Enhancement Toolkit · Documentation Center",
-    "version": "v3.0.7",
+    "version": "v3.0.9",
     "quickStart": "Quick Start",
     "visitMainSite": "Visit ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "Quick Start",
-      "description": "Get started with MCP Probe Kit v3.0.7 in 5 minutes",
+      "description": "Get started with MCP Probe Kit v3.0.9 in 5 minutes",
       "installConfig": "Installation & Configuration"
     },
-    "tools": {
-      "title": "Tools Documentation",
-      "description": "Complete reference for 22 practical tools",
-      "allTools": "All Tools"
-    },
+    "tools": {
+      "title": "Tools Documentation",
+      "description": "Complete reference for 22 practical tools, including code graph insight and orchestration workflows",
+      "allTools": "All Tools"
+    },
     "guides": {
       "title": "Guides",
       "description": "Migration guides and best practices",
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "Installation & Configuration",
-    "subtitle": "Get started with MCP Probe Kit v3.0.7 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
+    "subtitle": "Get started with MCP Probe Kit v3.0.9 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
     "breadcrumb": {
       "home": "Documentation",
       "quickStart": "Quick Start",
@@ -202,19 +202,23 @@
         "startProduct": "Product design workflow",
         "startRalph": "Ralph Loop automated development"
       },
-      "uiTools": {
-        "title": "3. New UI/UX Toolset",
-        "description": "Complete UI/UX toolchain:",
-        "designSystem": "Intelligent design system generator",
-        "uiSearch": "UI/UX database search",
-        "syncUiData": "UI/UX data synchronization",
-        "componentCatalog": "Component catalog initialization",
-        "renderUi": "UI rendering engine"
-      },
-      "structuredOutput": {
-        "title": "4. Structured Output Upgrade",
-        "description": "Core and orchestration tools prioritize structured output, consistent and predictable output format, facilitating tool chaining and state tracking."
-      }
+      "uiTools": {
+        "title": "3. New UI/UX Toolset",
+        "description": "Complete UI/UX toolchain:",
+        "designSystem": "Intelligent design system generator",
+        "uiSearch": "UI/UX database search",
+        "syncUiData": "UI/UX data synchronization",
+        "componentCatalog": "Component catalog initialization",
+        "renderUi": "UI rendering engine"
+      },
+      "codeInsight": {
+        "title": "4. New Code Graph Insight",
+        "description": "Use code_insight to bridge GitNexus for call-chain, context, and impact analysis, and feed graphContext into start_feature/start_bugfix."
+      },
+      "structuredOutput": {
+        "title": "5. Structured Output Upgrade",
+        "description": "Core and orchestration tools prioritize structured output, consistent and predictable output format, facilitating tool chaining and state tracking."
+      }
     },
     "steps": {
       "title": "Migration Steps",
@@ -345,31 +349,44 @@
         "q4": "- Do you need verification code?",
         "generate": "→ Generate: Interview record document"
       },
-      "estimate": {
-        "title": "1.3 Workload Estimation",
-        "description": "Use",
-        "description2": "tool to estimate development time and resources.",
-        "task": "Implement user authentication functionality",
-        "output": "→ Output:",
-        "sp": "- Story Points: 8 SP",
-        "time": "- Time Range: Optimistic 3 days / Normal 5 days / Pessimistic 8 days",
-        "risk": "- Risk: Third-party login integration may be delayed"
-      }
-    },
+      "estimate": {
+        "title": "1.3 Workload Estimation",
+        "description": "Use",
+        "description2": "tool to estimate development time and resources.",
+        "task": "Implement user authentication functionality",
+        "output": "→ Output:",
+        "sp": "- Story Points: 8 SP",
+        "time": "- Time Range: Optimistic 3 days / Normal 5 days / Pessimistic 8 days",
+        "risk": "- Risk: Third-party login integration may be delayed"
+      },
+      "codeInsight": {
+        "title": "1.4 Existing Code Graph Insight",
+        "description": "Use",
+        "description2": "to quickly analyze call chains, context, and impact, then carry graph context into start_feature/start_bugfix.",
+        "example1": "You: Analyze the login and token refresh call chain and tell me which modules will be affected",
+        "goal": "Find the existing login and token refresh flow",
+        "taskContext": "Preparing to modify the auth module",
+        "output": "→ Output:",
+        "item1": "- Related execution flows / call chains",
+        "item2": "- Key symbols and file locations",
+        "item3": "- _meta.graph.snapshotUri / markdownFilePath",
+        "item4": "- graphContext that can be passed into start_feature / start_bugfix"
+      }
+    },
     "common": {
       "bestPractice": "Best Practice"
     },
     "stage2": {
       "title": "Stage 2: Feature Development",
-      "workflow": {
-        "title": "2.1 Complete Feature Development Workflow (Recommended)",
-        "description": "Use",
-        "description2": "workflow orchestration to complete from spec to estimation with one click.",
-        "example1": "You: Develop user authentication feature",
-        "step1": "✓ Check project context",
-        "step2": "✓ Generate feature specification document",
-        "step3": "✓ Estimate development workload",
-        "step4": "✓ Output complete development plan"
+      "workflow": {
+        "title": "2.1 Complete Feature Development Workflow (Recommended)",
+        "description": "Use",
+        "description2": "workflow orchestration to complete from spec to estimation with one click.",
+        "example1": "You: Develop user authentication feature",
+        "step1": "✓ Check project context and available graph snapshots",
+        "step2": "✓ Generate feature specification document",
+        "step3": "✓ Estimate development workload",
+        "step4": "✓ Output complete development plan"
       },
       "ui": {
         "title": "2.2 UI Development Workflow",
@@ -413,15 +430,15 @@
     },
     "stage4": {
       "title": "Stage 4: Bug Fixing",
-      "bugfix": {
-        "title": "4.1 Systematic Bug Fix (Recommended)",
-        "description": "Use",
-        "description2": "workflow for one-stop solution from analysis to testing.",
-        "example1": "You: Login function is throwing an error",
-        "step1": "✓ Check project context",
-        "step2": "✓ Analyze error cause",
-        "step3": "✓ Locate problem code",
-        "step4": "✓ Provide fix solution",
+      "bugfix": {
+        "title": "4.1 Systematic Bug Fix (Recommended)",
+        "description": "Use",
+        "description2": "workflow for one-stop solution from analysis to testing.",
+        "example1": "You: Login function is throwing an error",
+        "step1": "✓ Check project context and available graph snapshots",
+        "step2": "✓ Analyze error cause",
+        "step3": "✓ Locate problem code",
+        "step4": "✓ Provide fix solution",
         "step5": "✓ Generate test cases"
       },
       "quick": {
@@ -516,3 +533,4 @@
     }
   }
 }
+

package/docs/i18n/ja.json

@@ -14,21 +14,21 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI開発強化ツールキット · ドキュメントセンター",
-    "version": "v3.0.7",
+    "version": "v3.0.9",
     "quickStart": "クイックスタート",
     "visitMainSite": "ByteZoneXを訪問"
   },
   "sections": {
     "quickStart": {
       "title": "クイックスタート",
-      "description": "5分でMCP Probe Kit v3.0.7を始める",
+      "description": "5分でMCP Probe Kit v3.0.9を始める",
       "installConfig": "インストールと設定"
     },
-    "tools": {
-      "title": "ツールドキュメント",
-      "description": "22の実用的なツールの完全なリファレンス",
-      "allTools": "すべてのツール"
-    },
+    "tools": {
+      "title": "ツールドキュメント",
+      "description": "22の実用的なツールの完全なリファレンス。コードグラフ洞察とオーケストレーションを含む",
+      "allTools": "すべてのツール"
+    },
     "guides": {
       "title": "ガイド",
       "description": "移行ガイドとベストプラクティス",
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "インストールと設定",
-    "subtitle": "5分でMCP Probe Kit v3.0.7を始める。Cursor、Cline、Claude Desktopをサポート",
+    "subtitle": "5分でMCP Probe Kit v3.0.9を始める。Cursor、Cline、Claude Desktopをサポート",
     "breadcrumb": {
       "home": "ドキュメント",
       "quickStart": "クイックスタート",
@@ -202,19 +202,23 @@
         "startProduct": "製品設計ワークフロー",
         "startRalph": "Ralph Loop自動化開発"
       },
-      "uiTools": {
-        "title": "3. 新しいUI/UXツールセット",
-        "description": "完全なUI/UXツールチェーン：",
-        "designSystem": "インテリジェントデザインシステムジェネレーター",
-        "uiSearch": "UI/UXデータベース検索",
-        "syncUiData": "UI/UXデータ同期",
-        "componentCatalog": "コンポーネントカタログ初期化",
-        "renderUi": "UIレンダリングエンジン"
-      },
-      "structuredOutput": {
-        "title": "4. 構造化出力のアップグレード",
-        "description": "コアおよびオーケストレーションツールは構造化出力を優先し、一貫性のある予測可能な出力形式で、ツールの連携と状態追跡を容易にします。"
-      }
+      "uiTools": {
+        "title": "3. 新しいUI/UXツールセット",
+        "description": "完全なUI/UXツールチェーン：",
+        "designSystem": "インテリジェントデザインシステムジェネレーター",
+        "uiSearch": "UI/UXデータベース検索",
+        "syncUiData": "UI/UXデータ同期",
+        "componentCatalog": "コンポーネントカタログ初期化",
+        "renderUi": "UIレンダリングエンジン"
+      },
+      "codeInsight": {
+        "title": "4. 新しいコードグラフ洞察",
+        "description": "code_insight で GitNexus をブリッジし、呼び出し連鎖・コンテキスト・影響範囲を分析し、graphContext を start_feature/start_bugfix に渡せます。"
+      },
+      "structuredOutput": {
+        "title": "5. 構造化出力のアップグレード",
+        "description": "コアおよびオーケストレーションツールは構造化出力を優先し、一貫性のある予測可能な出力形式で、ツールの連携と状態追跡を容易にします。"
+      }
     },
     "steps": {
       "title": "移行手順",
@@ -345,31 +349,44 @@
         "q4": "- 認証コードは必要ですか？",
         "generate": "→ 生成：インタビュー記録ドキュメント"
       },
-      "estimate": {
-        "title": "1.3 作業量見積もり",
-        "description": "使用",
-        "description2": "ツールで開発時間とリソースを見積もり。",
-        "task": "ユーザー認証機能を実装",
-        "output": "→ 出力：",
-        "sp": "- ストーリーポイント：8 SP",
-        "time": "- 時間範囲：楽観的 3日 / 通常 5日 / 悲観的 8日",
-        "risk": "- リスク：サードパーティログイン統合が遅延する可能性"
-      }
-    },
+      "estimate": {
+        "title": "1.3 作業量見積もり",
+        "description": "使用",
+        "description2": "ツールで開発時間とリソースを見積もり。",
+        "task": "ユーザー認証機能を実装",
+        "output": "→ 出力：",
+        "sp": "- ストーリーポイント：8 SP",
+        "time": "- 時間範囲：楽観的 3日 / 通常 5日 / 悲観的 8日",
+        "risk": "- リスク：サードパーティログイン統合が遅延する可能性"
+      },
+      "codeInsight": {
+        "title": "1.4 既存コードグラフの洞察",
+        "description": "使用",
+        "description2": "呼び出し連鎖、コンテキスト、影響範囲を素早く分析し、その結果を start_feature/start_bugfix に渡します。",
+        "example1": "あなた: ログインとトークン更新の呼び出し連鎖を分析し、どのモジュールに影響するか教えてください",
+        "goal": "既存のログインとトークン更新フローを見つける",
+        "taskContext": "認証モジュールを変更する準備",
+        "output": "→ 出力：",
+        "item1": "- 関連する実行フロー / 呼び出し連鎖",
+        "item2": "- 重要なシンボルとファイル位置",
+        "item3": "- _meta.graph.snapshotUri / markdownFilePath",
+        "item4": "- start_feature / start_bugfix に渡せる graphContext"
+      }
+    },
     "common": {
       "bestPractice": "ベストプラクティス"
     },
     "stage2": {
       "title": "ステージ 2：機能開発",
-      "workflow": {
-        "title": "2.1 完全な機能開発ワークフロー（推奨）",
-        "description": "使用",
-        "description2": "ワークフローオーケストレーションで、仕様から見積もりまでワンクリックで完了。",
-        "example1": "あなた: ユーザー認証機能を開発",
-        "step1": "✓ プロジェクトコンテキストを確認",
-        "step2": "✓ 機能仕様ドキュメント生成",
-        "step3": "✓ 開発作業量を見積もり",
-        "step4": "✓ 完全な開発計画を出力"
+      "workflow": {
+        "title": "2.1 完全な機能開発ワークフロー（推奨）",
+        "description": "使用",
+        "description2": "ワークフローオーケストレーションで、仕様から見積もりまでワンクリックで完了。",
+        "example1": "あなた: ユーザー認証機能を開発",
+        "step1": "✓ プロジェクトコンテキストと利用可能なグラフスナップショットを確認",
+        "step2": "✓ 機能仕様ドキュメント生成",
+        "step3": "✓ 開発作業量を見積もり",
+        "step4": "✓ 完全な開発計画を出力"
       },
       "ui": {
         "title": "2.2 UI開発ワークフロー",
@@ -413,15 +430,15 @@
     },
     "stage4": {
       "title": "ステージ 4：バグ修正",
-      "bugfix": {
-        "title": "4.1 体系的なバグ修正（推奨）",
-        "description": "使用",
-        "description2": "ワークフローで、分析からテストまでワンストップソリューション。",
-        "example1": "あなた: ログイン機能がエラーを出しています",
-        "step1": "✓ プロジェクトコンテキストを確認",
-        "step2": "✓ エラー原因を分析",
-        "step3": "✓ 問題コードを特定",
-        "step4": "✓ 修正案を提供",
+      "bugfix": {
+        "title": "4.1 体系的なバグ修正（推奨）",
+        "description": "使用",
+        "description2": "ワークフローで、分析からテストまでワンストップソリューション。",
+        "example1": "あなた: ログイン機能がエラーを出しています",
+        "step1": "✓ プロジェクトコンテキストと利用可能なグラフスナップショットを確認",
+        "step2": "✓ エラー原因を分析",
+        "step3": "✓ 問題コードを特定",
+        "step4": "✓ 修正案を提供",
         "step5": "✓ テストケースを生成"
       },
       "quick": {
@@ -516,3 +533,4 @@
     }
   }
 }
+

package/docs/i18n/ko.json

@@ -14,21 +14,21 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 개발 강화 툴킷 · 문서 센터",
-    "version": "v3.0.7",
+    "version": "v3.0.9",
     "quickStart": "빠른 시작",
     "visitMainSite": "ByteZoneX 방문"
   },
   "sections": {
     "quickStart": {
       "title": "빠른 시작",
-      "description": "5분 안에 MCP Probe Kit v3.0.7 시작하기",
+      "description": "5분 안에 MCP Probe Kit v3.0.9 시작하기",
       "installConfig": "설치 및 구성"
     },
-    "tools": {
-      "title": "도구 문서",
-      "description": "22개 실용 도구의 완전한 참조",
-      "allTools": "모든 도구"
-    },
+    "tools": {
+      "title": "도구 문서",
+      "description": "22개 실용 도구의 완전한 참조. 코드 그래프 인사이트와 오케스트레이션 포함",
+      "allTools": "모든 도구"
+    },
     "guides": {
       "title": "가이드",
       "description": "마이그레이션 가이드 및 모범 사례",
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "설치 및 구성",
-    "subtitle": "5분 안에 MCP Probe Kit v3.0.7 시작하기. Cursor, Cline, Claude Desktop 지원",
+    "subtitle": "5분 안에 MCP Probe Kit v3.0.9 시작하기. Cursor, Cline, Claude Desktop 지원",
     "breadcrumb": {
       "home": "문서",
       "quickStart": "빠른 시작",
@@ -202,19 +202,23 @@
         "startProduct": "제품 설계 워크플로",
         "startRalph": "Ralph Loop 자동화 개발"
       },
-      "uiTools": {
-        "title": "3. 새로운 UI/UX 도구 세트",
-        "description": "완전한 UI/UX 도구 체인：",
-        "designSystem": "지능형 디자인 시스템 생성기",
-        "uiSearch": "UI/UX 데이터베이스 검색",
-        "syncUiData": "UI/UX 데이터 동기화",
-        "componentCatalog": "컴포넌트 카탈로그 초기화",
-        "renderUi": "UI 렌더링 엔진"
-      },
-      "structuredOutput": {
-        "title": "4. 구조화된 출력 업그레이드",
-        "description": "핵심 및 오케스트레이션 도구는 구조화된 출력을 우선시하며, 일관되고 예측 가능한 출력 형식으로 도구 연결 및 상태 추적을 용이하게 합니다."
-      }
+      "uiTools": {
+        "title": "3. 새로운 UI/UX 도구 세트",
+        "description": "완전한 UI/UX 도구 체인：",
+        "designSystem": "지능형 디자인 시스템 생성기",
+        "uiSearch": "UI/UX 데이터베이스 검색",
+        "syncUiData": "UI/UX 데이터 동기화",
+        "componentCatalog": "컴포넌트 카탈로그 초기화",
+        "renderUi": "UI 렌더링 엔진"
+      },
+      "codeInsight": {
+        "title": "4. 새로운 코드 그래프 인사이트",
+        "description": "code_insight 로 GitNexus 를 브리지하여 호출 체인, 컨텍스트, 영향 범위를 분석하고 graphContext 를 start_feature/start_bugfix 에 넘길 수 있습니다."
+      },
+      "structuredOutput": {
+        "title": "5. 구조화된 출력 업그레이드",
+        "description": "핵심 및 오케스트레이션 도구는 구조화된 출력을 우선시하며, 일관되고 예측 가능한 출력 형식으로 도구 연결 및 상태 추적을 용이하게 합니다."
+      }
     },
     "steps": {
       "title": "마이그레이션 단계",
@@ -345,31 +349,44 @@
         "q4": "- 인증 코드가 필요한가요?",
         "generate": "→ 생성：인터뷰 기록 문서"
       },
-      "estimate": {
-        "title": "1.3 작업량 추정",
-        "description": "사용",
-        "description2": "도구로 개발 시간과 리소스 추정.",
-        "task": "사용자 인증 기능 구현",
-        "output": "→ 출력:",
-        "sp": "- 스토리 포인트: 8 SP",
-        "time": "- 시간 범위: 낙관적 3일 / 정상 5일 / 비관적 8일",
-        "risk": "- 위험: 제3자 로그인 통합이 지연될 수 있음"
-      }
-    },
+      "estimate": {
+        "title": "1.3 작업량 추정",
+        "description": "사용",
+        "description2": "도구로 개발 시간과 리소스 추정.",
+        "task": "사용자 인증 기능 구현",
+        "output": "→ 출력:",
+        "sp": "- 스토리 포인트: 8 SP",
+        "time": "- 시간 범위: 낙관적 3일 / 정상 5일 / 비관적 8일",
+        "risk": "- 위험: 제3자 로그인 통합이 지연될 수 있음"
+      },
+      "codeInsight": {
+        "title": "1.4 기존 코드 그래프 인사이트",
+        "description": "사용",
+        "description2": "호출 체인, 컨텍스트, 영향 범위를 빠르게 분석하고 그 결과를 start_feature/start_bugfix 에 전달합니다.",
+        "example1": "당신: 로그인과 토큰 갱신 호출 체인을 분석해서 어떤 모듈이 영향받는지 알려주세요",
+        "goal": "기존 로그인 및 토큰 갱신 흐름 찾기",
+        "taskContext": "인증 모듈 수정 준비",
+        "output": "→ 출력:",
+        "item1": "- 관련 실행 흐름 / 호출 체인",
+        "item2": "- 핵심 심볼과 파일 위치",
+        "item3": "- _meta.graph.snapshotUri / markdownFilePath",
+        "item4": "- start_feature / start_bugfix 에 전달 가능한 graphContext"
+      }
+    },
     "common": {
       "bestPractice": "모범 사례"
     },
     "stage2": {
       "title": "단계 2: 기능 개발",
-      "workflow": {
-        "title": "2.1 완전한 기능 개발 워크플로우 (권장)",
-        "description": "사용",
-        "description2": "워크플로우 오케스트레이션으로 사양에서 추정까지 원클릭 완료.",
-        "example1": "당신: 사용자 인증 기능 개발",
-        "step1": "✓ 프로젝트 컨텍스트 확인",
-        "step2": "✓ 기능 사양 문서 생성",
-        "step3": "✓ 개발 작업량 추정",
-        "step4": "✓ 완전한 개발 계획 출력"
+      "workflow": {
+        "title": "2.1 완전한 기능 개발 워크플로우 (권장)",
+        "description": "사용",
+        "description2": "워크플로우 오케스트레이션으로 사양에서 추정까지 원클릭 완료.",
+        "example1": "당신: 사용자 인증 기능 개발",
+        "step1": "✓ 프로젝트 컨텍스트와 사용 가능한 그래프 스냅샷 확인",
+        "step2": "✓ 기능 사양 문서 생성",
+        "step3": "✓ 개발 작업량 추정",
+        "step4": "✓ 완전한 개발 계획 출력"
       },
       "ui": {
         "title": "2.2 UI 개발 워크플로우",
@@ -413,15 +430,15 @@
     },
     "stage4": {
       "title": "단계 4: 버그 수정",
-      "bugfix": {
-        "title": "4.1 체계적인 버그 수정 (권장)",
-        "description": "사용",
-        "description2": "워크플로우로 분석에서 테스트까지 원스톱 솔루션.",
-        "example1": "당신: 로그인 기능에서 오류가 발생했습니다",
-        "step1": "✓ 프로젝트 컨텍스트 확인",
-        "step2": "✓ 오류 원인 분석",
-        "step3": "✓ 문제 코드 위치 파악",
-        "step4": "✓ 수정 방안 제공",
+      "bugfix": {
+        "title": "4.1 체계적인 버그 수정 (권장)",
+        "description": "사용",
+        "description2": "워크플로우로 분석에서 테스트까지 원스톱 솔루션.",
+        "example1": "당신: 로그인 기능에서 오류가 발생했습니다",
+        "step1": "✓ 프로젝트 컨텍스트와 사용 가능한 그래프 스냅샷 확인",
+        "step2": "✓ 오류 원인 분석",
+        "step3": "✓ 문제 코드 위치 파악",
+        "step4": "✓ 수정 방안 제공",
         "step5": "✓ 테스트 케이스 생성"
       },
       "quick": {
@@ -516,3 +533,4 @@
     }
   }
 }
+

package/docs/i18n/zh-CN.json

@@ -14,21 +14,21 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 开发增强工具集 · 文档中心",
-    "version": "v3.0.7",
+    "version": "v3.0.9",
     "quickStart": "快速开始",
     "visitMainSite": "访问主站 ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "快速开始",
-      "description": "5 分钟快速上手 MCP Probe Kit v3.0.7",
+      "description": "5 分钟快速上手 MCP Probe Kit v3.0.9",
       "installConfig": "安装配置"
     },
-    "tools": {
-      "title": "工具文档",
-      "description": "22 个实用工具的完整参考",
-      "allTools": "所有工具"
-    },
+    "tools": {
+      "title": "工具文档",
+      "description": "22 个实用工具的完整参考，含图谱洞察与编排工作流",
+      "allTools": "所有工具"
+    },
     "guides": {
       "title": "指南",
       "description": "迁移指南和最佳实践",
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "安装配置",
-    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.7，支持 Cursor、Cline 和 Claude Desktop",
+    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.9，支持 Cursor、Cline 和 Claude Desktop",
     "breadcrumb": {
       "home": "文档首页",
       "quickStart": "快速开始",
@@ -202,19 +202,23 @@
         "startProduct": "产品设计工作流",
         "startRalph": "Ralph Loop 自动化开发"
       },
-      "uiTools": {
-        "title": "3. 新增 UI/UX 工具集",
-        "description": "完整的 UI/UX 工具链：",
-        "designSystem": "智能设计系统生成器",
-        "uiSearch": "UI/UX 数据库搜索",
-        "syncUiData": "UI/UX 数据同步",
-        "componentCatalog": "组件目录初始化",
-        "renderUi": "UI 渲染引擎"
-      },
-      "structuredOutput": {
-        "title": "4. 结构化输出升级",
-        "description": "核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。"
-      }
+      "uiTools": {
+        "title": "3. 新增 UI/UX 工具集",
+        "description": "完整的 UI/UX 工具链：",
+        "designSystem": "智能设计系统生成器",
+        "uiSearch": "UI/UX 数据库搜索",
+        "syncUiData": "UI/UX 数据同步",
+        "componentCatalog": "组件目录初始化",
+        "renderUi": "UI 渲染引擎"
+      },
+      "codeInsight": {
+        "title": "4. 新增代码图谱洞察",
+        "description": "通过 code_insight 桥接 GitNexus，分析调用链、上下文和影响范围，并为 start_feature/start_bugfix 提供 graphContext 增强。"
+      },
+      "structuredOutput": {
+        "title": "5. 结构化输出升级",
+        "description": "核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。"
+      }
     },
     "steps": {
       "title": "迁移步骤",
@@ -345,31 +349,44 @@
         "q4": "- 是否需要验证码？",
         "generate": "→ 生成：访谈记录文档"
       },
-      "estimate": {
-        "title": "1.3 工作量估算",
-        "description": "使用",
-        "description2": "工具估算开发时间和资源。",
-        "task": "实现用户认证功能",
-        "output": "→ 输出：",
-        "sp": "- 故事点：8 SP",
-        "time": "- 时间范围：乐观 3天 / 正常 5天 / 悲观 8天",
-        "risk": "- 风险点：第三方登录集成可能延期"
-      }
-    },
+      "estimate": {
+        "title": "1.3 工作量估算",
+        "description": "使用",
+        "description2": "工具估算开发时间和资源。",
+        "task": "实现用户认证功能",
+        "output": "→ 输出：",
+        "sp": "- 故事点：8 SP",
+        "time": "- 时间范围：乐观 3天 / 正常 5天 / 悲观 8天",
+        "risk": "- 风险点：第三方登录集成可能延期"
+      },
+      "codeInsight": {
+        "title": "1.4 现有代码图谱洞察",
+        "description": "使用",
+        "description2": "快速分析调用链、上下文和影响范围，并为后续 start_feature/start_bugfix 提供图谱上下文。",
+        "example1": "你: 请分析登录与 token 刷新相关的调用链，看看改动会影响哪些模块",
+        "goal": "找出现有登录与 token 刷新流程",
+        "taskContext": "准备修改认证模块",
+        "output": "→ 输出：",
+        "item1": "- 相关执行流 / 调用链",
+        "item2": "- 关键符号与文件位置",
+        "item3": "- _meta.graph.snapshotUri / markdownFilePath",
+        "item4": "- 可继续用于 start_feature / start_bugfix 的 graphContext"
+      }
+    },
     "common": {
       "bestPractice": "最佳实践"
     },
     "stage2": {
       "title": "阶段 2：功能开发",
-      "workflow": {
-        "title": "2.1 完整功能开发流程（推荐）",
-        "description": "使用",
-        "description2": "工作流编排，一键完成从规格到估算。",
-        "example1": "你: 开发用户认证功能",
-        "step1": "✓ 检查项目上下文",
-        "step2": "✓ 生成功能规格文档",
-        "step3": "✓ 估算开发工作量",
-        "step4": "✓ 输出完整开发计划"
+      "workflow": {
+        "title": "2.1 完整功能开发流程（推荐）",
+        "description": "使用",
+        "description2": "工作流编排，一键完成从规格到估算。",
+        "example1": "你: 开发用户认证功能",
+        "step1": "✓ 检查项目上下文与可用图谱快照",
+        "step2": "✓ 生成功能规格文档",
+        "step3": "✓ 估算开发工作量",
+        "step4": "✓ 输出完整开发计划"
       },
       "ui": {
         "title": "2.2 UI 开发流程",
@@ -413,15 +430,15 @@
     },
     "stage4": {
       "title": "阶段 4：Bug 修复",
-      "bugfix": {
-        "title": "4.1 系统化 Bug 修复（推荐）",
-        "description": "使用",
-        "description2": "工作流，从分析到测试一站式解决。",
-        "example1": "你: 登录功能报错了",
-        "step1": "✓ 检查项目上下文",
-        "step2": "✓ 分析错误原因",
-        "step3": "✓ 定位问题代码",
-        "step4": "✓ 提供修复方案",
+      "bugfix": {
+        "title": "4.1 系统化 Bug 修复（推荐）",
+        "description": "使用",
+        "description2": "工作流，从分析到测试一站式解决。",
+        "example1": "你: 登录功能报错了",
+        "step1": "✓ 检查项目上下文与可用图谱快照",
+        "step2": "✓ 分析错误原因",
+        "step3": "✓ 定位问题代码",
+        "step4": "✓ 提供修复方案",
         "step5": "✓ 生成测试用例"
       },
       "quick": {
@@ -516,3 +533,4 @@
     }
   }
 }
+

package/docs/index.html

@@ -181,7 +181,7 @@
         <div class="max-w-[800px] mx-auto">
             <h1 class="text-3xl sm:text-4xl md:text-5xl font-bold mb-3 tracking-tight" data-i18n="hero.title">🚀 MCP Probe Kit</h1>
             <p class="text-base sm:text-lg opacity-95 mb-2" data-i18n="hero.subtitle">AI 开发增强工具集 · 文档中心</p>
-            <div class="inline-block bg-white/20 px-3 py-1 rounded-full text-sm font-semibold mb-6 md:mb-8">v3.0.7</div>
+            <div class="inline-block bg-white/20 px-3 py-1 rounded-full text-sm font-semibold mb-6 md:mb-8">v3.0.9</div>
             <div class="flex gap-3 md:gap-4 justify-center flex-wrap">
                 <a href="./pages/getting-started.html" class="bg-white text-primary px-5 py-2.5 sm:px-6 sm:py-3 rounded-md text-sm sm:text-base font-semibold hover:-translate-y-0.5 hover:shadow-lg transition-all duration-200 inline-flex items-center gap-1.5 no-underline cursor-pointer border-0" data-i18n="hero.quickStart">快速开始</a>
                 <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="bg-white/15 text-white px-5 py-2.5 sm:px-6 sm:py-3 rounded-md text-sm sm:text-base font-semibold hover:bg-white/25 transition-all duration-200 inline-flex items-center gap-1.5 no-underline border border-white/30" data-i18n="hero.visitMainSite">
@@ -202,7 +202,7 @@
                         <span data-i18n="sections.quickStart.title">快速开始</span>
                     </h2>
                 </div>
-                <p class="text-text-secondary text-sm mb-4 leading-relaxed" data-i18n="sections.quickStart.description">5 分钟快速上手 MCP Probe Kit v3.0.7</p>
+                <p class="text-text-secondary text-sm mb-4 leading-relaxed" data-i18n="sections.quickStart.description">5 分钟快速上手 MCP Probe Kit v3.0.9</p>
                 <nav class="flex flex-col gap-0">
                     <a href="./pages/getting-started.html" class="flex items-center justify-between px-3 py-2.5 -mx-3 text-text-primary text-sm font-medium rounded-md transition-all duration-200 hover:bg-bg-hover hover:text-primary no-underline">
                         <span data-i18n="sections.quickStart.installConfig">安装配置</span>
@@ -219,7 +219,7 @@
                         <span data-i18n="sections.tools.title">工具文档</span>
                     </h2>
                 </div>
-                <p class="text-text-secondary text-sm mb-4 leading-relaxed" data-i18n="sections.tools.description">22 个实用工具的完整参考</p>
+                <p class="text-text-secondary text-sm mb-4 leading-relaxed" data-i18n="sections.tools.description">22 个实用工具的完整参考，含图谱洞察与编排工作流</p>
                 <nav class="flex flex-col gap-0">
                     <a href="./pages/all-tools.html" class="flex items-center justify-between px-3 py-2.5 -mx-3 text-text-primary text-sm font-medium rounded-md transition-all duration-200 hover:bg-bg-hover hover:text-primary no-underline">
                         <div class="flex items-center gap-2">
@@ -323,4 +323,5 @@
     </script>
     <script src="./assets/js/i18n.js"></script>
 </body>
-</html>
+</html>
+

package/docs/pages/all-tools.html

@@ -156,12 +156,12 @@
                 <h1 class="text-2xl sm:text-3xl font-bold text-text-primary mb-2" data-i18n="sidebar.allTools">所有工具</h1>
                 <p class="text-sm sm:text-base text-text-secondary" id="page-subtitle">MCP Probe Kit 提供 22 个实用工具，核心与编排工具支持结构化输出</p>
                 <div class="flex flex-wrap items-center gap-2 mt-3 text-xs text-text-tertiary">
-                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.7</span>
+                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.9</span>
                     <span>MCP 2025-11-25</span>
                     <span>SDK 1.27.1</span>
                 </div>
                 <div class="flex flex-wrap items-center gap-2 mt-2 text-xs text-text-tertiary">
-                    <span>📦 v3.0.7</span>
+                    <span>📦 v3.0.9</span>
                     <span>·</span>
                     <span><span data-i18n="footer.lastUpdate">最后更新</span>：2026-03-11</span>
                     <span>·</span>
@@ -512,3 +512,4 @@
     </script>
 </body>
 </html>
+

package/docs/pages/examples.html

@@ -148,7 +148,7 @@
                 <h1 class="text-2xl sm:text-3xl font-bold text-text-primary mb-2" data-i18n="examples.title">最佳实践</h1>
                 <p class="text-sm sm:text-base text-text-secondary" data-i18n="examples.subtitle">MCP Probe Kit 融合完整研发流程，从需求到上线的最佳实践指南</p>
                 <div class="flex flex-wrap items-center gap-2 mt-3 text-xs text-text-tertiary">
-                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.7</span>
+                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.9</span>
                     <span>MCP 2025-11-25</span>
                     <span>SDK 1.27.1</span>
                 </div>
@@ -327,28 +327,54 @@ description: "<span data-i18n="examples.stage1.interview.desc">实现用户登
                     </div>
                 </div>
                 
-                <div>
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>📊</span>
-                        <span data-i18n="examples.stage1.estimate.title">1.3 工作量估算</span>
-                    </h3>
+                <div>
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>📊</span>
+                        <span data-i18n="examples.stage1.estimate.title">1.3 工作量估算</span>
+                    </h3>
                     <p class="text-text-secondary text-sm pl-7 mb-3"><span data-i18n="examples.stage1.estimate.description">使用</span> <code class="bg-gray-200 px-1 rounded text-xs">estimate</code> <span data-i18n="examples.stage1.estimate.description2">工具估算开发时间和资源。</span></p>
                     <div class="bg-slate-900 rounded-lg overflow-hidden ml-7">
                         <div class="flex items-center justify-between px-3 py-2 bg-slate-800">
                             <span class="text-xs text-slate-300 font-medium" data-i18n="examples.common.bestPractice">最佳实践</span>
                         </div>
-                        <pre class="code-block p-4 text-sm text-slate-200 overflow-x-auto"><code>AI: 使用 estimate 工具
-task_description: "<span data-i18n="examples.stage1.estimate.task">实现用户认证功能</span>"
-experience_level: "mid"
-team_size: 2
-
-<span data-i18n="examples.stage1.estimate.output">→ 输出：</span>
-  <span data-i18n="examples.stage1.estimate.sp">- 故事点：8 SP</span>
-  <span data-i18n="examples.stage1.estimate.time">- 时间范围：乐观 3天 / 正常 5天 / 悲观 8天</span>
-  <span data-i18n="examples.stage1.estimate.risk">- 风险点：第三方登录集成可能延期</span></code></pre>
-                    </div>
-                </div>
-            </section>
+                        <pre class="code-block p-4 text-sm text-slate-200 overflow-x-auto"><code>AI: 使用 estimate 工具
+task_description: "<span data-i18n="examples.stage1.estimate.task">实现用户认证功能</span>"
+experience_level: "mid"
+team_size: 2
+
+<span data-i18n="examples.stage1.estimate.output">→ 输出：</span>
+  <span data-i18n="examples.stage1.estimate.sp">- 故事点：8 SP</span>
+  <span data-i18n="examples.stage1.estimate.time">- 时间范围：乐观 3天 / 正常 5天 / 悲观 8天</span>
+  <span data-i18n="examples.stage1.estimate.risk">- 风险点：第三方登录集成可能延期</span></code></pre>
+                    </div>
+                </div>
+
+                <div class="mt-4">
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>🕸️</span>
+                        <span data-i18n="examples.stage1.codeInsight.title">1.4 现有代码图谱洞察</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7 mb-3"><span data-i18n="examples.stage1.codeInsight.description">使用</span> <code class="bg-gray-200 px-1 rounded text-xs">code_insight</code> <span data-i18n="examples.stage1.codeInsight.description2">快速分析调用链、上下文和影响范围，并为后续 start_feature/start_bugfix 提供图谱上下文。</span></p>
+                    <div class="bg-slate-900 rounded-lg overflow-hidden ml-7">
+                        <div class="flex items-center justify-between px-3 py-2 bg-slate-800">
+                            <span class="text-xs text-slate-300 font-medium" data-i18n="examples.common.bestPractice">最佳实践</span>
+                        </div>
+                        <pre class="code-block p-4 text-sm text-slate-200 overflow-x-auto"><code><span data-i18n="examples.stage1.codeInsight.example1">你: 请分析登录与 token 刷新相关的调用链，看看改动会影响哪些模块</span>
+
+AI: 使用 code_insight 工具
+mode: "query"
+query: "login token refresh auth flow"
+goal: "<span data-i18n="examples.stage1.codeInsight.goal">找出现有登录与 token 刷新流程</span>"
+task_context: "<span data-i18n="examples.stage1.codeInsight.taskContext">准备修改认证模块</span>"
+
+<span data-i18n="examples.stage1.codeInsight.output">→ 输出：</span>
+  <span data-i18n="examples.stage1.codeInsight.item1">- 相关执行流 / 调用链</span>
+  <span data-i18n="examples.stage1.codeInsight.item2">- 关键符号与文件位置</span>
+  <span data-i18n="examples.stage1.codeInsight.item3">- _meta.graph.snapshotUri / markdownFilePath</span>
+  <span data-i18n="examples.stage1.codeInsight.item4">- 可继续用于 start_feature / start_bugfix 的 graphContext</span></code></pre>
+                    </div>
+                </div>
+            </section>
 
             <!-- 阶段 2：开发阶段 -->
             <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
@@ -371,12 +397,12 @@ description: "用户认证功能，支持邮箱登录和 Google 登录"
 feature_name: "user-auth"
 
 <span data-i18n="examples.stage0.workflow.autoExecute">→ 自动执行：</span>
-  <span data-i18n="examples.stage2.workflow.step1">✓ 检查项目上下文</span>
-  <span data-i18n="examples.stage2.workflow.step2">✓ 生成功能规格文档</span>
-  <span data-i18n="examples.stage2.workflow.step3">✓ 估算开发工作量</span>
-  <span data-i18n="examples.stage2.workflow.step4">✓ 输出完整开发计划</span></code></pre>
-                    </div>
-                </div>
+  <span data-i18n="examples.stage2.workflow.step1">✓ 检查项目上下文与可用图谱快照</span>
+  <span data-i18n="examples.stage2.workflow.step2">✓ 生成功能规格文档</span>
+  <span data-i18n="examples.stage2.workflow.step3">✓ 估算开发工作量</span>
+  <span data-i18n="examples.stage2.workflow.step4">✓ 输出完整开发计划</span></code></pre>
+                    </div>
+                </div>
                 
                 <div class="mb-4">
                     <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
@@ -480,12 +506,12 @@ error_message: "TypeError: Cannot read property 'token' of undefined"
 stack_trace: "at login.js:45:12"
 
 <span data-i18n="examples.stage0.workflow.autoExecute">→ 自动执行：</span>
-  <span data-i18n="examples.stage4.bugfix.step1">✓ 检查项目上下文</span>
-  <span data-i18n="examples.stage4.bugfix.step2">✓ 分析错误原因</span>
-  <span data-i18n="examples.stage4.bugfix.step3">✓ 定位问题代码</span>
-  <span data-i18n="examples.stage4.bugfix.step4">✓ 提供修复方案</span>
-  <span data-i18n="examples.stage4.bugfix.step5">✓ 生成测试用例</span></code></pre>
-                    </div>
+  <span data-i18n="examples.stage4.bugfix.step1">✓ 检查项目上下文与可用图谱快照</span>
+  <span data-i18n="examples.stage4.bugfix.step2">✓ 分析错误原因</span>
+  <span data-i18n="examples.stage4.bugfix.step3">✓ 定位问题代码</span>
+  <span data-i18n="examples.stage4.bugfix.step4">✓ 提供修复方案</span>
+  <span data-i18n="examples.stage4.bugfix.step5">✓ 生成测试用例</span></code></pre>
+                    </div>
                 </div>
                 
                 <div>
@@ -687,4 +713,5 @@ max_minutes: 25
     </script>
     <script src="../assets/js/i18n.js"></script>
 </body>
-</html>
+</html>
+

package/docs/pages/getting-started.html

@@ -154,9 +154,9 @@
             <!-- 页面标题 -->
             <div class="mb-6">
                 <h1 class="text-2xl sm:text-3xl font-bold text-text-primary mb-2" data-i18n="gettingStarted.title">安装配置</h1>
-                    <p class="text-sm sm:text-base text-text-secondary" data-i18n="gettingStarted.subtitle">5 分钟快速上手 MCP Probe Kit v3.0.7，支持 Cursor、Cline 和 Claude Desktop</p>
+                    <p class="text-sm sm:text-base text-text-secondary" data-i18n="gettingStarted.subtitle">5 分钟快速上手 MCP Probe Kit v3.0.9，支持 Cursor、Cline 和 Claude Desktop</p>
                 <div class="flex flex-wrap items-center gap-2 mt-3 text-xs text-text-tertiary">
-                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.7</span>
+                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.9</span>
                     <span>MCP 2025-11-25</span>
                     <span>SDK 1.27.1</span>
                 </div>
@@ -587,4 +587,4 @@ npm run build</code></pre>
     </script>
     <script src="../assets/js/i18n.js"></script>
 </body>
-</html>
+</html>

package/docs/pages/migration.html

@@ -148,7 +148,7 @@
                 <h1 class="text-2xl sm:text-3xl font-bold text-text-primary mb-2" data-i18n="migration.title">v3.0 迁移指南</h1>
                 <p class="text-sm sm:text-base text-text-secondary" data-i18n="migration.subtitle">从 v2.x 平滑迁移到 v3.0，了解重大变更和新特性</p>
                 <div class="flex flex-wrap items-center gap-2 mt-3 text-xs text-text-tertiary">
-                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.7</span>
+                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.9</span>
                     <span>MCP 2025-11-25</span>
                     <span>SDK 1.27.1</span>
                 </div>
@@ -205,14 +205,22 @@
                     </ul>
                 </div>
                 
-                <div>
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>📊</span>
-                        <span data-i18n="migration.changes.structuredOutput.title">4. 结构化输出升级</span>
-                    </h3>
-                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.structuredOutput.description">核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。</p>
-                </div>
-            </section>
+                <div>
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>📊</span>
+                        <span data-i18n="migration.changes.codeInsight.title">4. 新增代码图谱洞察</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.codeInsight.description">通过 code_insight 桥接 GitNexus，分析调用链、上下文和影响范围，并为 start_feature/start_bugfix 提供 graphContext 增强。</p>
+                </div>
+
+                <div>
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>🧩</span>
+                        <span data-i18n="migration.changes.structuredOutput.title">5. 结构化输出升级</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.structuredOutput.description">核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。</p>
+                </div>
+            </section>
 
             <!-- 迁移步骤 -->
             <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
@@ -296,4 +304,5 @@ npm update -g mcp-probe-kit</code></pre>
     </script>
     <script src="../assets/js/i18n.js"></script>
 </body>
-</html>
+</html>
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.8",
+  "version": "3.0.9",
   "description": "AI-Powered Development Toolkit - MCP Server with 22 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "mcpName": "io.github.mybolide/mcp-probe-kit",
   "type": "module",
@@ -77,3 +77,4 @@
     "vitest": "^4.0.18"
   }
 }
+