mcp-probe-kit 3.6.9 → 3.6.10

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 { extractResolvedSymbolIdFromContext, prepareBridgeWorkspace, resolveExecutableCommand, resolveGitNexusBridgeCommand, resolveSpawnCommand, rerankQueryStructuredContent, } from "../gitnexus-bridge.js";
+import { extractResolvedSymbolIdFromContext, prepareBridgeWorkspace, resolveExecutableCommand, resolveGitNexusBridgeCommand, resolveSpawnCommand, rerankQueryStructuredContent, tryRefreshWorkspaceIndex, } from "../gitnexus-bridge.js";
 const tempRoots = [];
 afterEach(() => {
     while (tempRoots.length > 0) {
@@ -123,6 +123,33 @@ describe("gitnexus-bridge workspace preparation", () => {
         expect(resolved.endsWith(".exe") || resolved === "git" || resolved === "git.cmd").toBe(true);
         expect(spawned.command.toLowerCase()).toContain("git");
     });
+    test("index refresh 失败时返回错误信息而不抛错", async () => {
+        const repoRoot = makeTempDir("gitnexus-index-fail-");
+        fs.mkdirSync(path.join(repoRoot, ".git"));
+        const prevCommand = process.env.MCP_GITNEXUS_COMMAND;
+        const prevPath = process.env.PATH;
+        process.env.MCP_GITNEXUS_COMMAND = path.join(repoRoot, "missing-gitnexus.cmd");
+        process.env.PATH = repoRoot;
+        try {
+            const workspace = await prepareBridgeWorkspace(repoRoot);
+            const error = await tryRefreshWorkspaceIndex(workspace);
+            expect(error).toBeTruthy();
+        }
+        finally {
+            if (prevCommand === undefined) {
+                delete process.env.MCP_GITNEXUS_COMMAND;
+            }
+            else {
+                process.env.MCP_GITNEXUS_COMMAND = prevCommand;
+            }
+            if (prevPath === undefined) {
+                delete process.env.PATH;
+            }
+            else {
+                process.env.PATH = prevPath;
+            }
+        }
+    });
     test("git 目录直接使用源仓库", async () => {
         const repoRoot = makeTempDir("gitnexus-direct-");
         fs.mkdirSync(path.join(repoRoot, ".git"));

package/build/lib/__tests__/task-defaults.unit.test.js

@@ -1,6 +1,7 @@
 import { describe, expect, test, afterEach } from 'vitest';
 import { isAutoTaskTool, shouldAutoEscalateToTask } from '../task-defaults.js';
 const originalDisable = process.env.MCP_DISABLE_AUTO_TASK;
+const originalEnable = process.env.MCP_ENABLE_AUTO_TASK;
 afterEach(() => {
     if (originalDisable === undefined) {
         delete process.env.MCP_DISABLE_AUTO_TASK;
@@ -8,6 +9,12 @@ afterEach(() => {
     else {
         process.env.MCP_DISABLE_AUTO_TASK = originalDisable;
     }
+    if (originalEnable === undefined) {
+        delete process.env.MCP_ENABLE_AUTO_TASK;
+    }
+    else {
+        process.env.MCP_ENABLE_AUTO_TASK = originalEnable;
+    }
 });
 describe('task-defaults', () => {
     test('code_insight 与 scan 属于自动 Task 工具', () => {
@@ -15,12 +22,19 @@ describe('task-defaults', () => {
         expect(isAutoTaskTool('scan_and_extract_patterns')).toBe(true);
         expect(isAutoTaskTool('search_memory')).toBe(false);
     });
-    test('默认对长耗时工具自动升级为 Task', () => {
+    test('默认不自动升级为 Task，避免 Agent 客户端拿不到同步结果', () => {
         delete process.env.MCP_DISABLE_AUTO_TASK;
+        delete process.env.MCP_ENABLE_AUTO_TASK;
+        expect(shouldAutoEscalateToTask('code_insight', false)).toBe(false);
+        expect(shouldAutoEscalateToTask('code_insight', true)).toBe(false);
+    });
+    test('MCP_ENABLE_AUTO_TASK=1 时开启自动 Task', () => {
+        process.env.MCP_ENABLE_AUTO_TASK = '1';
         expect(shouldAutoEscalateToTask('code_insight', false)).toBe(true);
         expect(shouldAutoEscalateToTask('code_insight', true)).toBe(false);
     });
-    test('MCP_DISABLE_AUTO_TASK=1 时关闭自动 Task', () => {
+    test('MCP_DISABLE_AUTO_TASK=1 时强制关闭自动 Task', () => {
+        process.env.MCP_ENABLE_AUTO_TASK = '1';
         process.env.MCP_DISABLE_AUTO_TASK = '1';
         expect(shouldAutoEscalateToTask('code_insight', false)).toBe(false);
     });

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

@@ -98,6 +98,7 @@ export interface BridgeWorkspace {
 export declare function prepareBridgeWorkspace(cwd?: string, signal?: AbortSignal, options?: {
     bootstrap?: boolean;
 }): Promise<BridgeWorkspace>;
+export declare function tryRefreshWorkspaceIndex(workspace: BridgeWorkspace, signal?: AbortSignal): Promise<string | undefined>;
 export declare function runCodeInsightBridge(request: CodeInsightRequest): Promise<CodeInsightBridgeResult>;
 export declare function buildFeatureGraphContext(input: {
     featureName: string;

package/build/lib/gitnexus-bridge.js

@@ -786,12 +786,18 @@ export async function prepareBridgeWorkspace(cwd = process.cwd(), signal, option
     }
     return createTempAnalysisWorkspace(resolvedCwd, signal, options);
 }
-async function ensureWorkspaceIndexed(workspace, signal) {
+export async function tryRefreshWorkspaceIndex(workspace, signal) {
     if (workspace.workspaceMode !== "direct") {
-        return;
+        return undefined;
+    }
+    try {
+        const analyzeCli = resolveGitNexusCliCommand("analyze");
+        await runProcess(analyzeCli.command, analyzeCli.args, workspace.analysisRoot, signal);
+        return undefined;
+    }
+    catch (error) {
+        return normalizeError(error);
     }
-    const analyzeCli = resolveGitNexusCliCommand("analyze");
-    await runProcess(analyzeCli.command, analyzeCli.args, workspace.analysisRoot, signal);
 }
 function isUnsafeHomeRoot(sourceRoot) {
     return path.resolve(sourceRoot) === path.resolve(os.homedir());
@@ -967,12 +973,15 @@ export async function runCodeInsightBridge(request) {
         };
     }
     const workspace = await prepareBridgeWorkspace(requestedProjectRoot, request.signal);
-    await ensureWorkspaceIndexed(workspace, request.signal);
+    const warnings = [];
+    const indexRefreshError = await tryRefreshWorkspaceIndex(workspace, request.signal);
+    if (indexRefreshError) {
+        warnings.push("index_refresh_failed");
+    }
     const effectiveRepo = workspace.workspaceMode === "temp-repo"
         ? workspace.repoName
         : resolvePreferredRepoName(request.repo) || workspace.repoName;
     const { command, args } = launcher;
-    const warnings = [];
     if (workspace.workspaceMode === "temp-repo") {
         warnings.push("temp_repo_workspace");
     }

package/build/lib/task-defaults.d.ts

@@ -1,5 +1,6 @@
 /**
- * 长耗时工具默认走 MCP Task，避免阻塞 stdio 宿主。
+ * 长耗时工具可选走 MCP Task，避免阻塞 stdio 宿主。
+ * 默认关闭：多数 Agent 客户端不会轮询 task 结果，自动升级会导致 code_insight 等“报错/无结果”。
  */
 export declare function isAutoTaskTool(toolName: string): boolean;
 export declare function isAutoTaskEnabled(): boolean;

package/build/lib/task-defaults.js

@@ -1,16 +1,19 @@
 /**
- * 长耗时工具默认走 MCP Task，避免阻塞 stdio 宿主。
+ * 长耗时工具可选走 MCP Task，避免阻塞 stdio 宿主。
+ * 默认关闭：多数 Agent 客户端不会轮询 task 结果，自动升级会导致 code_insight 等“报错/无结果”。
  */
 const AUTO_TASK_TOOLS = new Set(['code_insight', 'scan_and_extract_patterns']);
 export function isAutoTaskTool(toolName) {
     return AUTO_TASK_TOOLS.has(toolName);
 }
+function isTruthyEnv(value) {
+    return Boolean(value && /^(1|true|yes|on)$/i.test(value.trim()));
+}
 export function isAutoTaskEnabled() {
-    const raw = process.env.MCP_DISABLE_AUTO_TASK?.trim();
-    if (raw && /^(1|true|yes|on)$/i.test(raw)) {
+    if (isTruthyEnv(process.env.MCP_DISABLE_AUTO_TASK)) {
         return false;
     }
-    return true;
+    return isTruthyEnv(process.env.MCP_ENABLE_AUTO_TASK);
 }
 export function shouldAutoEscalateToTask(toolName, hasExplicitTaskRequest) {
     if (hasExplicitTaskRequest) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.6.9",
+  "version": "3.6.10",
   "description": "AI-Powered Development Toolkit - MCP Server with 30 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, MCP Skill auto-sync, UI/UX Pro Max, and Requirements Interview.",
   "mcpName": "io.github.mybolide/mcp-probe-kit",
   "type": "module",