mcp-probe-kit 3.0.14 → 3.0.15

package/build/lib/__tests__/gitnexus-bridge.unit.test.js

@@ -3,7 +3,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 import spawn from "cross-spawn";
 import { afterEach, describe, expect, test } from "vitest";
-import { prepareBridgeWorkspace, resolveExecutableCommand, resolveGitNexusBridgeCommand, resolveSpawnCommand, rerankQueryStructuredContent, } from "../gitnexus-bridge.js";
+import { extractResolvedSymbolIdFromContext, prepareBridgeWorkspace, resolveExecutableCommand, resolveGitNexusBridgeCommand, resolveSpawnCommand, rerankQueryStructuredContent, } from "../gitnexus-bridge.js";
 const tempRoots = [];
 afterEach(() => {
     while (tempRoots.length > 0) {
@@ -87,6 +87,14 @@ describe("gitnexus-bridge workspace preparation", () => {
         expect(reranked.structuredContent.processes[0].heuristicLabel).toBe("Login -> GenerateToken");
         expect(reranked.note).toMatch(/Top matches/i);
     });
+    test("impact 可复用 context 解析出的 symbol id", () => {
+        expect(extractResolvedSymbolIdFromContext({
+            target: { id: "Method:sysAuthController.js:login:18", name: "login" },
+        })).toBe("Method:sysAuthController.js:login:18");
+        expect(extractResolvedSymbolIdFromContext({
+            symbol: { uid: "Function:src/auth.ts:login" },
+        })).toBe("Function:src/auth.ts:login");
+    });
     test.runIf(process.platform === "win32")("Windows 下带空格路径的 cmd 可执行文件可以真实启动", async () => {
         const root = makeTempDir("gitnexus-space-");
         const executable = path.join(root, "Program Files", "tool.cmd");

package/build/lib/gitnexus-bridge.d.ts

@@ -77,6 +77,7 @@ export declare function resolveSpawnCommand(command: string, args: string[], pla
     command: string;
     args: string[];
 };
+export declare function extractResolvedSymbolIdFromContext(value: unknown): string | undefined;
 export declare function rerankQueryStructuredContent(structuredContent: unknown, hints: {
     query?: string;
     goal?: string;

package/build/lib/gitnexus-bridge.js

@@ -370,6 +370,29 @@ function isNonCallableSymbolKind(kind) {
         || normalized.includes("process")
         || normalized.includes("package");
 }
+export function extractResolvedSymbolIdFromContext(value) {
+    const record = toRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const direct = [record.uid, record.id, record.targetUid, record.targetId]
+        .find((item) => typeof item === "string" && item.trim());
+    if (typeof direct === "string") {
+        return direct.trim();
+    }
+    for (const key of ["target", "symbol", "node", "element"]) {
+        const nested = toRecord(record[key]);
+        if (!nested) {
+            continue;
+        }
+        const candidate = [nested.uid, nested.id]
+            .find((item) => typeof item === "string" && item.trim());
+        if (typeof candidate === "string") {
+            return candidate.trim();
+        }
+    }
+    return undefined;
+}
 function normalizeImpactTargetByContext(contextExecution, originalTarget) {
     const target = toRecord(contextExecution.structuredContent)?.target;
     const kind = inferSymbolKind(target);
@@ -1029,6 +1052,7 @@ export async function runCodeInsightBridge(request) {
                 warnings.push("缺少 target/uid 参数，已跳过 impact");
                 return;
             }
+            let impactTarget = request.uid || request.target;
             if (!request.uid && request.target) {
                 let contextExecution = getLastExecutionByTool(executions, "context");
                 if (!contextExecution) {
@@ -1049,10 +1073,14 @@ export async function runCodeInsightBridge(request) {
                         warnings.push("impact_target_non_callable");
                         return;
                     }
+                    const resolvedTargetId = extractResolvedSymbolIdFromContext(contextExecution.structuredContent);
+                    if (resolvedTargetId) {
+                        impactTarget = resolvedTargetId;
+                    }
                 }
             }
             executions.push(await callBridgeTool(client, "impact", {
-                target: request.uid || request.target,
+                target: impactTarget,
                 direction: request.direction || "upstream",
                 ...(request.maxDepth ? { maxDepth: request.maxDepth } : {}),
                 ...(typeof request.includeTests === "boolean"

package/docs/i18n/en.json

@@ -93,6 +93,8 @@
         "item1": "The first cold start may take 20+ seconds while npx checks or downloads dependencies.",
         "item2": "Some GitNexus dependencies use tree-sitter native modules and may require Visual Studio Build Tools.",
         "item3": "If your MCP client supports env, prefer a preinstalled gitnexus CLI and raise GitNexus timeouts.",
+        "item4": "Quick install Build Tools on Windows: winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "Quick install command:",
         "exampleTitle": "Example using a preinstalled gitnexus CLI:"
       },
       "source": {

package/docs/i18n/ja.json

@@ -93,6 +93,8 @@
         "item1": "初回のコールドスタートでは、npx が依存関係を確認またはダウンロードするため 20 秒以上かかることがあります。",
         "item2": "GitNexus の一部依存関係は tree-sitter ネイティブモジュールを使用しており、Windows では Visual Studio Build Tools が必要になる場合があります。",
         "item3": "MCP クライアントが env をサポートしている場合は、プリインストール済みの gitnexus CLI を優先し、GitNexus のタイムアウトを引き上げてください。",
+        "item4": "Windows では winget で Build Tools をすばやくインストールできます：winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "クイックインストールコマンド：",
         "exampleTitle": "プリインストール済み gitnexus CLI を使う設定例："
       },
       "source": {

package/docs/i18n/ko.json

@@ -93,6 +93,8 @@
         "item1": "첫 콜드 스타트에서는 npx 가 의존성을 확인하거나 다운로드하므로 20초 이상 걸릴 수 있습니다.",
         "item2": "GitNexus 의 일부 의존성은 tree-sitter 네이티브 모듈을 사용하며 Windows 에서는 Visual Studio Build Tools 가 필요할 수 있습니다.",
         "item3": "MCP 클라이언트가 env 를 지원하면, 미리 설치한 gitnexus CLI 를 우선 사용하고 GitNexus 타임아웃을 늘리세요.",
+        "item4": "Windows 에서 Build Tools 빠른 설치: winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "빠른 설치 명령:",
         "exampleTitle": "미리 설치한 gitnexus CLI 를 사용하는 구성 예시:"
       },
       "source": {

package/docs/i18n/zh-CN.json

@@ -93,6 +93,8 @@
         "item1": "首次冷启动时，npx 可能检查或下载依赖，耗时可能超过 20 秒。",
         "item2": "GitNexus 的部分依赖使用 tree-sitter 原生模块，在 Windows 上可能需要 Visual Studio Build Tools。",
         "item3": "如果 MCP 客户端支持 env，优先使用预装的 gitnexus CLI，并适当增大 GitNexus 超时。",
+        "item4": "Windows 下可用 winget 快速安装 Build Tools：winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "快速安装命令：",
         "exampleTitle": "使用预装 gitnexus CLI 的配置示例："
       },
       "source": {

package/docs/pages/getting-started.html

@@ -317,7 +317,10 @@ npm run build</code></pre>
                             <li data-i18n="gettingStarted.step1.windowsGraph.item1">The first cold start may take 20+ seconds while npx checks or downloads dependencies.</li>
                             <li data-i18n="gettingStarted.step1.windowsGraph.item2">Some GitNexus dependencies use tree-sitter native modules and may require Visual Studio Build Tools.</li>
                             <li data-i18n="gettingStarted.step1.windowsGraph.item3">If your MCP client supports env, prefer a preinstalled gitnexus CLI and raise GitNexus timeouts.</li>
+                            <li data-i18n="gettingStarted.step1.windowsGraph.item4">Quick install Build Tools on Windows: winget install Microsoft.VisualStudio.2022.BuildTools</li>
                         </ul>
+                        <p class="mb-2" data-i18n="gettingStarted.step1.windowsGraph.quickInstallTitle">Quick install command:</p>
+                        <pre class="code-block mb-3 p-3 text-sm text-slate-200 bg-slate-900 rounded overflow-x-auto"><code>winget install Microsoft.VisualStudio.2022.BuildTools</code></pre>
                         <p class="mb-2" data-i18n="gettingStarted.step1.windowsGraph.exampleTitle">Example using a preinstalled gitnexus CLI:</p>
                         <div class="bg-slate-900 rounded-lg overflow-hidden">
                             <div class="flex items-center justify-between px-3 py-2 bg-slate-800">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.14",
+  "version": "3.0.15",
   "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",