mcp-probe-kit 3.0.16 → 3.0.17

package/build/tools/__tests__/cursor-history.unit.test.js

@@ -0,0 +1,87 @@
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+const listConversationsMock = vi.fn();
+const searchHistoryMock = vi.fn();
+const readConversationMock = vi.fn();
+vi.mock('../../lib/cursor-history-client.js', () => ({
+    createCursorHistoryClient: () => ({
+        listConversations: listConversationsMock,
+        searchHistory: searchHistoryMock,
+        readConversation: readConversationMock,
+    }),
+}));
+import { cursorListConversations } from '../cursor_list_conversations.js';
+import { cursorSearchConversations } from '../cursor_search_conversations.js';
+import { cursorReadConversation } from '../cursor_read_conversation.js';
+beforeEach(() => {
+    listConversationsMock.mockReset();
+    searchHistoryMock.mockReset();
+    readConversationMock.mockReset();
+});
+afterEach(() => {
+    vi.clearAllMocks();
+});
+describe('cursor history tools', () => {
+    test('cursor_list_conversations 返回摘要列表', async () => {
+        listConversationsMock.mockResolvedValue([
+            { composerId: 'c1', name: '新需求', source: 'composerHeaders' },
+        ]);
+        const result = await cursorListConversations({ title_query: '新需求', limit: 10 });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('已获取 1 条 Cursor 会话摘要');
+        expect(result.structuredContent.count).toBe(1);
+        expect(listConversationsMock).toHaveBeenCalledWith({
+            titleQuery: '新需求',
+            workspaceQuery: '',
+            includeArchived: false,
+            limit: 10,
+        });
+    });
+    test('cursor_search_conversations 缺少 query 时返回错误', async () => {
+        const result = await cursorSearchConversations({});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('缺少必填参数: query');
+    });
+    test('cursor_search_conversations 返回命中结果', async () => {
+        searchHistoryMock.mockResolvedValue([
+            { composerId: 'c1', conversationName: '新需求', bubbleId: 'b1', type: 1, text: '我们先聊需求' },
+        ]);
+        const result = await cursorSearchConversations({ query: '需求', composer_id: 'c1', limit: 5 });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.structuredContent.count).toBe(1);
+        expect(searchHistoryMock).toHaveBeenCalledWith({
+            query: '需求',
+            composerId: 'c1',
+            limit: 5,
+        });
+    });
+    test('cursor_read_conversation 返回消息时间线', async () => {
+        readConversationMock.mockResolvedValue({
+            composerId: 'c1',
+            messages: [
+                { bubbleId: 'b1', type: 1, text: '我们先聊需求' },
+                { bubbleId: 'b2', type: 2, text: '听懂了' },
+            ],
+        });
+        const result = await cursorReadConversation({ composer_id: 'c1', limit: 50, include_empty: true });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('共 2 条消息');
+        expect(result.structuredContent.messageCount).toBe(2);
+        expect(readConversationMock).toHaveBeenCalledWith({
+            composerId: 'c1',
+            limit: 50,
+            includeEmpty: true,
+        });
+    });
+});

package/build/tools/__tests__/memorize_asset.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/__tests__/memorize_asset.unit.test.js

@@ -0,0 +1,68 @@
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+const upsertAssetMock = vi.fn();
+const isEnabledMock = vi.fn();
+vi.mock('../../lib/memory-client.js', () => ({
+    createMemoryClient: () => ({
+        isEnabled: isEnabledMock,
+        upsertAsset: upsertAssetMock,
+    }),
+}));
+import { memorizeAsset } from '../memorize_asset.js';
+beforeEach(() => {
+    isEnabledMock.mockReset();
+    upsertAssetMock.mockReset();
+});
+afterEach(() => {
+    vi.clearAllMocks();
+});
+describe('memorize_asset 单元测试', () => {
+    const validArgs = {
+        name: 'AppError',
+        description: '统一错误封装',
+        summary: '用于标准化应用错误处理',
+        content: 'export class AppError extends Error {}',
+    };
+    test('记忆服务未开启时返回跳过结果而不是报错', async () => {
+        isEnabledMock.mockReturnValue(false);
+        const result = await memorizeAsset(validArgs);
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('记忆服务未开启');
+        expect(result.structuredContent).toEqual({ enabled: false, stored: false });
+        expect(upsertAssetMock).not.toHaveBeenCalled();
+    });
+    test('记忆服务开启时写入资产', async () => {
+        isEnabledMock.mockReturnValue(true);
+        upsertAssetMock.mockResolvedValue({
+            id: 'asset-1',
+            name: 'AppError',
+            type: 'code',
+            description: '统一错误封装',
+            summary: '用于标准化应用错误处理',
+            content: 'export class AppError extends Error {}',
+            tags: [],
+            confidence: 0.7,
+            createdAt: '2026-01-01T00:00:00.000Z',
+            updatedAt: '2026-01-01T00:00:00.000Z',
+        });
+        const result = await memorizeAsset(validArgs);
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('已沉淀记忆资产: AppError');
+        expect(result.structuredContent.enabled).toBe(true);
+        expect(result.structuredContent.stored).toBe(true);
+        expect(upsertAssetMock).toHaveBeenCalledTimes(1);
+        expect(upsertAssetMock).toHaveBeenCalledWith(expect.objectContaining({
+            name: 'AppError',
+            description: '统一错误封装',
+            summary: '用于标准化应用错误处理',
+            content: 'export class AppError extends Error {}',
+        }));
+    });
+});

package/build/tools/code_insight.d.ts

@@ -44,5 +44,25 @@ export declare function codeInsight(args: any, context?: ToolExecutionContext):
         text: string;
     }[];
     isError: boolean;
+    structuredContent: {
+        error_code: string;
+        rejected_project_root: string;
+        retry_hint: {
+            preferred: {
+                project_root: string;
+                path: string;
+            };
+            fallback: {
+                project_root: string;
+            };
+        };
+    };
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+    structuredContent?: undefined;
 }>;
 export {};

package/build/tools/code_insight.js

@@ -5,6 +5,7 @@ import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { runCodeInsightBridge, } from "../lib/gitnexus-bridge.js";
 import { throwIfAborted, } from "../lib/tool-execution-context.js";
+import { isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 const ALLOWED_MODES = new Set(["auto", "query", "context", "impact"]);
 const ALLOWED_DIRECTIONS = new Set(["upstream", "downstream"]);
 const DEFAULT_AUTO_QUERY = "项目整体架构 核心流程 关键模块 依赖关系 入口点";
@@ -248,6 +249,20 @@ export async function codeInsight(args, context) {
         const filePath = getString(parsedArgs.file_path);
         const repo = getString(parsedArgs.repo);
         const projectRoot = getString(parsedArgs.project_root);
+        if (isLikelyProjectNamedRelativePath(projectRoot)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `拒绝执行 code_insight：project_root 不能传带项目名的半相对路径，例如 ${projectRoot}。请改为传项目根目录绝对路径。`,
+                    }],
+                isError: true,
+                structuredContent: {
+                    error_code: "INVALID_PROJECT_ROOT",
+                    rejected_project_root: projectRoot,
+                    retry_hint: buildProjectRootRetryHint(projectRoot),
+                },
+            };
+        }
         const docsDirName = getString(parsedArgs.docs_dir) || "docs";
         const goal = getString(parsedArgs.goal);
         const taskContext = getString(parsedArgs.task_context);

package/build/tools/cursor_list_conversations.d.ts

@@ -0,0 +1,7 @@
+export declare function cursorListConversations(args: any): Promise<import("../lib/response.js").ToolResponse | {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+}>;

package/build/tools/cursor_list_conversations.js

@@ -0,0 +1,35 @@
+import { parseArgs, getString, getNumber, getBoolean } from '../utils/parseArgs.js';
+import { okStructured } from '../lib/response.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { createCursorHistoryClient } from '../lib/cursor-history-client.js';
+export async function cursorListConversations(args) {
+    try {
+        const parsed = parseArgs(args, {
+            defaultValues: {
+                title_query: '',
+                workspace_query: '',
+                include_archived: false,
+                limit: 20,
+            },
+            fieldAliases: {
+                title_query: ['title', 'name_query', 'query'],
+                workspace_query: ['workspace', 'workspace_path'],
+                include_archived: ['archived'],
+            },
+        });
+        const client = createCursorHistoryClient();
+        const conversations = await client.listConversations({
+            titleQuery: getString(parsed.title_query),
+            workspaceQuery: getString(parsed.workspace_query),
+            includeArchived: getBoolean(parsed.include_archived, false),
+            limit: getNumber(parsed.limit, 20),
+        });
+        return okStructured(`已获取 ${conversations.length} 条 Cursor 会话摘要。`, {
+            count: conversations.length,
+            conversations,
+        });
+    }
+    catch (error) {
+        return handleToolError(error, 'cursor_list_conversations');
+    }
+}

package/build/tools/cursor_read_conversation.d.ts

@@ -0,0 +1,7 @@
+export declare function cursorReadConversation(args: any): Promise<import("../lib/response.js").ToolResponse | {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+}>;

package/build/tools/cursor_read_conversation.js

@@ -0,0 +1,36 @@
+import { parseArgs, getString, getNumber, getBoolean } from '../utils/parseArgs.js';
+import { okStructured } from '../lib/response.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { createCursorHistoryClient } from '../lib/cursor-history-client.js';
+export async function cursorReadConversation(args) {
+    try {
+        const parsed = parseArgs(args, {
+            defaultValues: {
+                composer_id: '',
+                limit: 200,
+                include_empty: false,
+            },
+            fieldAliases: {
+                composer_id: ['conversation_id', 'chat_id'],
+            },
+        });
+        const composerId = getString(parsed.composer_id).trim();
+        if (!composerId) {
+            throw new Error('缺少必填参数: composer_id');
+        }
+        const client = createCursorHistoryClient();
+        const conversation = await client.readConversation({
+            composerId,
+            limit: getNumber(parsed.limit, 200),
+            includeEmpty: getBoolean(parsed.include_empty, false),
+        });
+        return okStructured(`已读取 Cursor 会话 ${composerId}，共 ${conversation.messages.length} 条消息。`, {
+            composerId,
+            messageCount: conversation.messages.length,
+            conversation,
+        });
+    }
+    catch (error) {
+        return handleToolError(error, 'cursor_read_conversation');
+    }
+}

package/build/tools/cursor_search_conversations.d.ts

@@ -0,0 +1,7 @@
+export declare function cursorSearchConversations(args: any): Promise<import("../lib/response.js").ToolResponse | {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+}>;

package/build/tools/cursor_search_conversations.js

@@ -0,0 +1,36 @@
+import { parseArgs, getString, getNumber } from '../utils/parseArgs.js';
+import { okStructured } from '../lib/response.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { createCursorHistoryClient } from '../lib/cursor-history-client.js';
+export async function cursorSearchConversations(args) {
+    try {
+        const parsed = parseArgs(args, {
+            defaultValues: {
+                query: '',
+                composer_id: '',
+                limit: 20,
+            },
+            primaryField: 'query',
+            fieldAliases: {
+                composer_id: ['conversation_id', 'chat_id'],
+            },
+        });
+        const query = getString(parsed.query).trim();
+        if (!query) {
+            throw new Error('缺少必填参数: query');
+        }
+        const client = createCursorHistoryClient();
+        const matches = await client.searchHistory({
+            query,
+            composerId: getString(parsed.composer_id),
+            limit: getNumber(parsed.limit, 20),
+        });
+        return okStructured(`已找到 ${matches.length} 条 Cursor 历史命中。`, {
+            count: matches.length,
+            matches,
+        });
+    }
+    catch (error) {
+        return handleToolError(error, 'cursor_search_conversations');
+    }
+}

package/build/tools/index.d.ts

@@ -16,5 +16,11 @@ export { interview } from "./interview.js";
 export { askUser } from "./ask_user.js";
 export { uiDesignSystem, uiSearch, syncUiData } from "./ui-ux-tools.js";
 export { startUi } from "./start_ui.js";
+export { readMemoryAsset } from "./read_memory_asset.js";
+export { memorizeAsset } from "./memorize_asset.js";
+export { scanAndExtractPatterns } from "./scan_and_extract_patterns.js";
+export { cursorListConversations } from "./cursor_list_conversations.js";
+export { cursorSearchConversations } from "./cursor_search_conversations.js";
+export { cursorReadConversation } from "./cursor_read_conversation.js";
 export { startProduct } from "./start_product.js";
 export { gitWorkReport } from "./git_work_report.js";

package/build/tools/index.js

@@ -19,6 +19,13 @@ export { askUser } from "./ask_user.js";
 // UI/UX Pro Max 工具
 export { uiDesignSystem, uiSearch, syncUiData } from "./ui-ux-tools.js";
 export { startUi } from "./start_ui.js";
+// 记忆工具
+export { readMemoryAsset } from "./read_memory_asset.js";
+export { memorizeAsset } from "./memorize_asset.js";
+export { scanAndExtractPatterns } from "./scan_and_extract_patterns.js";
+export { cursorListConversations } from "./cursor_list_conversations.js";
+export { cursorSearchConversations } from "./cursor_search_conversations.js";
+export { cursorReadConversation } from "./cursor_read_conversation.js";
 // 产品设计工作流
 export { startProduct } from "./start_product.js";
 // Git 工具

package/build/tools/init_project_context.d.ts

@@ -6,4 +6,23 @@
  * @param args.project_root - 项目根目录，默认当前目录
  * @returns MCP 响应，包含文档生成指导
  */
-export declare function initProjectContext(args: any): Promise<import("../lib/response.js").ToolResponse>;
+export declare function initProjectContext(args: any): Promise<import("../lib/response.js").ToolResponse | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+    structuredContent: {
+        error_code: string;
+        rejected_project_root: string;
+        retry_hint: {
+            preferred: {
+                project_root: string;
+                path: string;
+            };
+            fallback: {
+                project_root: string;
+            };
+        };
+    };
+}>;