npm - mcp-probe-kit - Versions diffs - 3.3.0 → 3.6.1 - Mend

mcp-probe-kit 3.3.0 → 3.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (88) hide show

package/README.md +781 -765
package/build/index.js +198 -191
package/build/lib/__tests__/agents-md-template.unit.test.js +1 -0
package/build/lib/__tests__/dev-workflow.unit.test.d.ts +1 -0
package/build/lib/__tests__/dev-workflow.unit.test.js +22 -0
package/build/lib/__tests__/handles.unit.test.d.ts +1 -0
package/build/lib/__tests__/handles.unit.test.js +19 -0
package/build/lib/__tests__/mcp-apps.unit.test.d.ts +1 -0
package/build/lib/__tests__/mcp-apps.unit.test.js +52 -0
package/build/lib/__tests__/mcp-tool-skill-registry.unit.test.d.ts +1 -0
package/build/lib/__tests__/mcp-tool-skill-registry.unit.test.js +18 -0
package/build/lib/__tests__/memory-client.unit.test.js +105 -0
package/build/lib/__tests__/spec-gate.unit.test.d.ts +1 -0
package/build/lib/__tests__/spec-gate.unit.test.js +54 -0
package/build/lib/__tests__/task-defaults.unit.test.d.ts +1 -0
package/build/lib/__tests__/task-defaults.unit.test.js +27 -0
package/build/lib/__tests__/workflow-skill-installer.unit.test.d.ts +1 -0
package/build/lib/__tests__/workflow-skill-installer.unit.test.js +110 -0
package/build/lib/__tests__/workspace-root.unit.test.d.ts +1 -0
package/build/lib/__tests__/workspace-root.unit.test.js +31 -0
package/build/lib/agents-md-template.js +10 -2
package/build/lib/dev-workflow.d.ts +36 -0
package/build/lib/dev-workflow.js +497 -0
package/build/lib/handles.d.ts +31 -0
package/build/lib/handles.js +36 -0
package/build/lib/mcp-apps.d.ts +14 -0
package/build/lib/mcp-apps.js +234 -0
package/build/lib/mcp-tool-skill-registry.d.ts +46 -0
package/build/lib/mcp-tool-skill-registry.js +256 -0
package/build/lib/memory-client.d.ts +19 -0
package/build/lib/memory-client.js +69 -0
package/build/lib/memory-orchestration.d.ts +5 -0
package/build/lib/memory-orchestration.js +20 -0
package/build/lib/merge-agents-md.d.ts +2 -2
package/build/lib/merge-agents-md.js +7 -4
package/build/lib/output-schema-registry.d.ts +11 -0
package/build/lib/output-schema-registry.js +80 -0
package/build/lib/spec-gate.d.ts +32 -0
package/build/lib/spec-gate.js +83 -0
package/build/lib/task-defaults.d.ts +6 -0
package/build/lib/task-defaults.js +20 -0
package/build/lib/tool-annotations.js +3 -0
package/build/lib/toolset-manager.js +2 -0
package/build/lib/workflow-skill-installer.d.ts +40 -0
package/build/lib/workflow-skill-installer.js +172 -0
package/build/lib/workflow-skill-template.d.ts +9 -0
package/build/lib/workflow-skill-template.js +85 -0
package/build/lib/workflow-skill-version.d.ts +15 -0
package/build/lib/workflow-skill-version.js +68 -0
package/build/lib/workspace-root.d.ts +4 -0
package/build/lib/workspace-root.js +33 -0
package/build/schemas/basic-tools.d.ts +4 -0
package/build/schemas/basic-tools.js +4 -0
package/build/schemas/index.d.ts +114 -0
package/build/schemas/index.js +1 -0
package/build/schemas/memory-tools.d.ts +83 -0
package/build/schemas/memory-tools.js +43 -0
package/build/schemas/orchestration-tools.d.ts +8 -0
package/build/schemas/orchestration-tools.js +8 -0
package/build/schemas/output/code-insight-tools.d.ts +65 -0
package/build/schemas/output/code-insight-tools.js +42 -0
package/build/schemas/output/memory-tools.d.ts +576 -0
package/build/schemas/output/memory-tools.js +148 -0
package/build/schemas/project-tools.d.ts +19 -0
package/build/schemas/project-tools.js +20 -0
package/build/tools/__tests__/delete_memory_asset.unit.test.d.ts +1 -0
package/build/tools/__tests__/delete_memory_asset.unit.test.js +87 -0
package/build/tools/__tests__/search_memory.unit.test.js +1 -0
package/build/tools/__tests__/start_bugfix.unit.test.js +34 -1
package/build/tools/__tests__/update_memory_asset.unit.test.d.ts +1 -0
package/build/tools/__tests__/update_memory_asset.unit.test.js +82 -0
package/build/tools/__tests__/workflow.unit.test.d.ts +1 -0
package/build/tools/__tests__/workflow.unit.test.js +24 -0
package/build/tools/code_insight.js +5 -1
package/build/tools/delete_memory_asset.d.ts +7 -0
package/build/tools/delete_memory_asset.js +57 -0
package/build/tools/index.d.ts +3 -0
package/build/tools/index.js +3 -0
package/build/tools/init_project.js +170 -158
package/build/tools/search_memory.js +5 -2
package/build/tools/start_bugfix.js +37 -4
package/build/tools/start_feature.js +4 -3
package/build/tools/start_ui.js +5 -4
package/build/tools/update_memory_asset.d.ts +7 -0
package/build/tools/update_memory_asset.js +98 -0
package/build/tools/workflow.d.ts +13 -0
package/build/tools/workflow.js +69 -0
package/package.json +5 -3

package/build/index.js CHANGED Viewed

@@ -5,11 +5,17 @@ import { InMemoryTaskMessageQueue, InMemoryTaskStore, } from "@modelcontextproto
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ProgressNotificationSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { initProject, gencommit, codeReview, codeInsight, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, checkSpec, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct, gitWorkReport, searchMemory, readMemoryAsset, memorizeAsset, scanAndExtractPatterns } from "./tools/index.js";
+import { initProject, gencommit, codeReview, codeInsight, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, checkSpec, workflow, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct, gitWorkReport, searchMemory, readMemoryAsset, memorizeAsset, deleteMemoryAsset, updateMemoryAsset, scanAndExtractPatterns } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { filterTools, getToolsetFromEnv } from "./lib/toolset-manager.js";
 import { withToolAnnotations } from "./lib/tool-annotations.js";
+import { withOutputSchema } from "./lib/output-schema-registry.js";
+import { shouldAutoEscalateToTask } from "./lib/task-defaults.js";
+import { attachHandles } from "./lib/handles.js";
+import { buildMcpAppHtml, isMcpUiAppTool } from "./lib/mcp-apps.js";
+import { ensureMcpProbeKitBootstrapForToolCall, } from "./lib/workflow-skill-installer.js";
+import { resolveWorkspaceRoot } from "./lib/workspace-root.js";
 import { isAbortError, } from "./lib/tool-execution-context.js";
 const EXTENSIONS_CAPABILITY_KEY = "io.github.mybolide/extensions";
 const MAX_UI_APP_RESOURCES = 30;
@@ -82,80 +88,6 @@ function withTraceMeta(result, traceMeta) {
         },
     };
 }
-function escapeHtml(value) {
-    return value
-        .replace(/&/g, "&amp;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;")
-        .replace(/'/g, "&#39;");
-}
-function isUiTool(name) {
-    return [
-        "ui_design_system",
-        "ui_search",
-        "sync_ui_data",
-        "start_ui",
-        "start_product",
-    ].includes(name);
-}
-function buildUiResourceHtml(name, args, result) {
-    const structured = result.structuredContent
-        ? JSON.stringify(result.structuredContent, null, 2)
-        : "{}";
-    const argJson = JSON.stringify(args ?? {}, null, 2);
-    const textBlocks = Array.isArray(result.content)
-        ? result.content
-            .map((item) => {
-            if (!item || typeof item !== "object") {
-                return "";
-            }
-            const text = item.text;
-            return typeof text === "string" ? text : "";
-        })
-            .filter(Boolean)
-            .join("\n\n")
-        : "";
-    const now = new Date().toISOString();
-    return `<!doctype html>
-<html lang="zh-CN">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>${escapeHtml(name)} · MCP Apps</title>
-  <style>
-    :root { color-scheme: light; }
-    body { font-family: "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif; margin: 0; background: #f4f7fb; color: #1e2a35; }
-    .wrap { max-width: 960px; margin: 0 auto; padding: 24px; }
-    .card { background: #fff; border-radius: 14px; padding: 18px; box-shadow: 0 4px 18px rgba(30,42,53,.08); margin-bottom: 16px; }
-    h1 { margin: 0 0 8px; font-size: 24px; }
-    h2 { margin: 0 0 10px; font-size: 16px; color: #2f4a65; }
-    pre { white-space: pre-wrap; word-break: break-word; background: #0f1720; color: #d9e7f7; border-radius: 10px; padding: 12px; font-size: 12px; line-height: 1.45; }
-    .meta { color: #4f6880; font-size: 12px; }
-  </style>
-</head>
-<body>
-  <div class="wrap">
-    <div class="card">
-      <h1>${escapeHtml(name)}</h1>
-      <div class="meta">Generated at ${escapeHtml(now)} · MCP Apps preview</div>
-    </div>
-    <div class="card">
-      <h2>Text Output</h2>
-      <pre>${escapeHtml(textBlocks || "(no text output)")}</pre>
-    </div>
-    <div class="card">
-      <h2>Structured Content</h2>
-      <pre>${escapeHtml(structured)}</pre>
-    </div>
-    <div class="card">
-      <h2>Arguments</h2>
-      <pre>${escapeHtml(argJson)}</pre>
-    </div>
-  </div>
-</body>
-</html>`;
-}
 function putUiAppResource(toolName, args, result) {
     const uid = `${Date.now()}-${Math.random().toString(16).slice(2, 10)}`;
     const uri = `ui://mcp-probe-kit/${toolName}/${uid}`;
@@ -164,7 +96,7 @@ function putUiAppResource(toolName, args, result) {
         name: `UI Preview · ${toolName}`,
         description: `MCP Apps preview generated by ${toolName}`,
         mimeType: "text/html",
-        text: buildUiResourceHtml(toolName, args, result),
+        text: buildMcpAppHtml(toolName, args, result),
         createdAt: new Date().toISOString(),
     };
     uiAppResources.set(uri, entry);
@@ -253,6 +185,53 @@ function renderGraphSnapshotMarkdown(snapshot) {
         "",
     ].join("\n");
 }
+function buildGraphHistorySummary(summaryLimit = 200) {
+    const items = graphSnapshotOrder
+        .slice()
+        .reverse()
+        .map((id) => graphSnapshots.get(id))
+        .filter((item) => Boolean(item))
+        .map((item) => ({
+        id: item.id,
+        uri: item.uri,
+        toolName: item.toolName,
+        createdAt: item.createdAt,
+        status: item.status,
+        summary: trimText(item.summary, summaryLimit),
+        files: {
+            json: item.jsonFilePath ?? null,
+            markdown: item.markdownFilePath ?? null,
+        },
+    }));
+    return { count: items.length, items };
+}
+function buildGraphFilesIndex(fileLimit = 40) {
+    const latestId = graphSnapshotOrder[graphSnapshotOrder.length - 1];
+    const latest = latestId ? (graphSnapshots.get(latestId) ?? null) : null;
+    const hasDir = fs.existsSync(graphSnapshotDir);
+    const files = hasDir
+        ? fs
+            .readdirSync(graphSnapshotDir, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && /\.(json|md)$/i.test(entry.name))
+            .map((entry) => toPosixPath(path.join(graphSnapshotDir, entry.name)))
+            .sort((a, b) => b.localeCompare(a))
+            .slice(0, fileLimit)
+        : [];
+    return {
+        snapshotDir: toPosixPath(graphSnapshotDir),
+        exists: hasDir,
+        latest: latest
+            ? {
+                id: latest.id,
+                uri: latest.uri,
+                toolName: latest.toolName,
+                jsonFilePath: latest.jsonFilePath ?? null,
+                markdownFilePath: latest.markdownFilePath ?? null,
+            }
+            : null,
+        files,
+    };
+}
 function persistGraphSnapshot(snapshot) {
     try {
         ensureGraphSnapshotDir();
@@ -384,13 +363,49 @@ function rememberGraphSnapshot(toolName, result) {
     }
     return snapshot;
 }
-function decorateResult(toolName, args, raw, traceMeta) {
+function withStructuredHandles(result, handles) {
+    if (!result.structuredContent || typeof result.structuredContent !== "object" || Array.isArray(result.structuredContent)) {
+        return result;
+    }
+    return {
+        ...result,
+        structuredContent: attachHandles(result.structuredContent, handles),
+    };
+}
+function withBootstrapMeta(result, bootstrap) {
+    if (!bootstrap) {
+        return result;
+    }
+    const base = result.structuredContent &&
+        typeof result.structuredContent === "object" &&
+        !Array.isArray(result.structuredContent)
+        ? result.structuredContent
+        : {};
+    return {
+        ...result,
+        structuredContent: {
+            ...base,
+            mcp_probe_bootstrap: {
+                projectRoot: bootstrap.projectRoot,
+                skill: bootstrap.skill,
+                agentsMd: bootstrap.agentsMd,
+                workspaceWarning: bootstrap.workspaceWarning ?? null,
+            },
+        },
+    };
+}
+function decorateResult(toolName, args, raw, traceMeta, bootstrap = null) {
     let result = withTraceMeta(raw, traceMeta);
+    result = withBootstrapMeta(result, bootstrap);
     const snapshot = rememberGraphSnapshot(toolName, result);
     if (snapshot) {
         result = withGraphSnapshotMeta(result, snapshot);
+        result = withStructuredHandles(result, {
+            graph_snapshot: snapshot.uri,
+            graph_resource: snapshot.uri,
+        });
     }
-    if (uiAppsEnabled && isUiTool(toolName) && !result.isError) {
+    if (uiAppsEnabled && isMcpUiAppTool(toolName) && !result.isError) {
         const resourceUri = putUiAppResource(toolName, args, result);
         result = withUiResourceMeta(result, resourceUri);
     }
@@ -411,68 +426,122 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     const filteredTools = filterTools(allToolSchemas, toolset);
     console.error(`[MCP Probe Kit] 当前工具集: ${toolset} (${filteredTools.length}/${allToolSchemas.length} 个工具)`);
     return {
-        tools: filteredTools.map(withToolAnnotations),
+        tools: filteredTools.map((tool) => withOutputSchema(withToolAnnotations(tool))),
     };
 });
 async function executeTool(name, args, context) {
+    const bootstrap = ensureMcpProbeKitBootstrapForToolCall(name, args);
+    if (bootstrap?.workspaceWarning) {
+        console.error(`[MCP Probe Kit] ${bootstrap.workspaceWarning}`);
+    }
+    if (bootstrap?.skill.created) {
+        console.error(`[MCP Probe Kit] 已创建 MCP Skill: ${bootstrap.skill.skillRelPath} (v${bootstrap.skill.version})`);
+    }
+    else if (bootstrap?.skill.updated) {
+        console.error(`[MCP Probe Kit] 已升级 MCP Skill: ${bootstrap.skill.skillRelPath} ${bootstrap.skill.previousVersion ?? "?"} → v${bootstrap.skill.version}`);
+    }
+    if (bootstrap?.agentsMd.created) {
+        console.error(`[MCP Probe Kit] 已创建 AGENTS.md（含 Skill 引用）: ${bootstrap.agentsMd.path}`);
+    }
+    else if (bootstrap?.agentsMd.updated) {
+        console.error(`[MCP Probe Kit] 已更新 AGENTS.md（添加 Skill 引用）: ${bootstrap.agentsMd.path}`);
+    }
+    let result;
     switch (name) {
         case "init_project":
-            return await initProject(args);
+            result = (await initProject(args));
+            break;
         case "gencommit":
-            return await gencommit(args);
+            result = (await gencommit(args));
+            break;
         case "code_review":
-            return await codeReview(args);
+            result = (await codeReview(args));
+            break;
         case "code_insight":
-            return await codeInsight(args, context);
+            result = (await codeInsight(args, context));
+            break;
         case "gentest":
-            return await gentest(args);
+            result = (await gentest(args));
+            break;
         case "refactor":
-            return await refactor(args);
+            result = (await refactor(args));
+            break;
         case "init_project_context":
-            return await initProjectContext(args);
+            result = (await initProjectContext(args));
+            break;
+        case "workflow":
+            result = (await workflow(args));
+            break;
         case "add_feature":
-            return await addFeature(args);
+            result = (await addFeature(args));
+            break;
         case "check_spec":
-            return await checkSpec(args);
+            result = (await checkSpec(args));
+            break;
         case "fix_bug":
-            return await fixBug(args);
+            result = (await fixBug(args));
+            break;
         case "estimate":
-            return await estimate(args);
+            result = (await estimate(args));
+            break;
         case "start_feature":
-            return await startFeature(args, context);
+            result = (await startFeature(args, context));
+            break;
         case "start_bugfix":
-            return await startBugfix(args, context);
+            result = (await startBugfix(args, context));
+            break;
         case "start_onboard":
-            return await startOnboard(args, context);
+            result = (await startOnboard(args, context));
+            break;
         case "start_ralph":
-            return await startRalph(args, context);
+            result = (await startRalph(args, context));
+            break;
         case "interview":
-            return await interview(args);
+            result = (await interview(args));
+            break;
         case "ask_user":
-            return await askUser(args);
+            result = (await askUser(args));
+            break;
         case "ui_design_system":
-            return await uiDesignSystem(args);
+            result = (await uiDesignSystem(args));
+            break;
         case "ui_search":
-            return await uiSearch(args);
+            result = (await uiSearch(args));
+            break;
         case "sync_ui_data":
-            return await syncUiData(args, context);
+            result = (await syncUiData(args, context));
+            break;
         case "start_ui":
-            return await startUi(args, context);
+            result = (await startUi(args, context));
+            break;
         case "start_product":
-            return await startProduct((args ?? {}), context);
+            result = (await startProduct((args ?? {}), context));
+            break;
         case "git_work_report":
-            return await gitWorkReport(args);
+            result = (await gitWorkReport(args));
+            break;
         case "search_memory":
-            return await searchMemory(args);
+            result = (await searchMemory(args));
+            break;
         case "read_memory_asset":
-            return await readMemoryAsset(args);
+            result = (await readMemoryAsset(args));
+            break;
         case "memorize_asset":
-            return await memorizeAsset(args);
+            result = (await memorizeAsset(args));
+            break;
+        case "delete_memory_asset":
+            result = (await deleteMemoryAsset(args));
+            break;
+        case "update_memory_asset":
+            result = (await updateMemoryAsset(args));
+            break;
         case "scan_and_extract_patterns":
-            return await scanAndExtractPatterns(args);
+            result = (await scanAndExtractPatterns(args));
+            break;
         default:
             throw new Error(`未知工具: ${name}`);
     }
+    return { bootstrap, result };
 }
 function makeToolError(errorMessage) {
     return {
@@ -491,8 +560,11 @@ function isTerminalTaskStatus(status) {
 // 处理工具调用
 server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     const { name, arguments: args } = request.params;
-    const taskRequest = request.params.task;
+    let taskRequest = request.params.task;
     const traceMeta = getTraceMeta(extra._meta);
+    if (shouldAutoEscalateToTask(name, Boolean(taskRequest))) {
+        taskRequest = taskRequest ?? {};
+    }
     const emitProgress = async (progress, message) => {
         const progressToken = extra._meta?.progressToken;
         if (progressToken === undefined) {
@@ -562,11 +634,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
         void (async () => {
             try {
                 await taskContext.reportProgress?.(5, `开始执行工具: ${name}`);
-                const rawResult = await executeTool(name, args, taskContext);
+                const { bootstrap, result: rawResult } = await executeTool(name, args, taskContext);
                 if (!rawResult || typeof rawResult !== "object") {
                     throw new Error(`工具 ${name} 返回了无效响应`);
                 }
-                const result = decorateResult(name, args, rawResult, traceMeta);
+                const result = decorateResult(name, args, rawResult, traceMeta, bootstrap);
                 const latestTask = await extra.taskStore?.getTask(task.taskId);
                 if (!latestTask || isTerminalTaskStatus(latestTask.status)) {
                     return;
@@ -617,12 +689,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     try {
         ensureNotAborted();
         await emitProgress(5, `开始执行工具: ${name}`);
-        const rawResult = await executeTool(name, args, toolContext);
+        const { bootstrap, result: rawResult } = await executeTool(name, args, toolContext);
         if (!rawResult || typeof rawResult !== "object") {
             throw new Error(`工具 ${name} 返回了无效响应`);
         }
         ensureNotAborted();
-        const result = decorateResult(name, args, rawResult, traceMeta);
+        const result = decorateResult(name, args, rawResult, traceMeta, bootstrap);
         await emitProgress(100, `工具执行完成: ${name}`);
         return result;
     }
@@ -637,7 +709,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
         return withTraceMeta(makeToolError(errorMessage), traceMeta);
     }
 });
-// 定义资源列表
+// 定义资源列表（Cursor 设置页会展示为条目；仅保留 status + graph/latest，其余 URI 仍可 ReadResource）
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
     const resources = [
         {
@@ -648,41 +720,11 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
         },
         {
             uri: "probe://graph/latest",
-            name: "图谱快照（最新）",
-            description: "最近一次 code_insight 或 start_* 生成的图谱快照",
-            mimeType: "application/json",
-        },
-        {
-            uri: "probe://graph/history",
-            name: "图谱快照（历史）",
-            description: `最近 ${graphSnapshotOrder.length} 条图谱快照摘要`,
-            mimeType: "application/json",
-        },
-        {
-            uri: "probe://graph/latest.md",
-            name: "图谱快照（最新 Markdown）",
-            description: "最近一次图谱快照的 Markdown 视图",
-            mimeType: "text/markdown",
-        },
-        {
-            uri: "probe://graph/files",
-            name: "图谱快照（文件索引）",
-            description: `图谱快照落盘目录: ${toPosixPath(graphSnapshotDir)}`,
+            name: "图谱快照",
+            description: "最新图谱快照（含历史摘要与落盘索引；Markdown 可读 probe://graph/latest.md）",
             mimeType: "application/json",
         },
     ];
-    for (const id of graphSnapshotOrder.slice().reverse().slice(0, 10)) {
-        const snapshot = graphSnapshots.get(id);
-        if (!snapshot) {
-            continue;
-        }
-        resources.push({
-            uri: snapshot.uri,
-            name: `图谱快照 · ${snapshot.toolName}`,
-            description: `${snapshot.status} · ${trimText(snapshot.summary, 120)} (${snapshot.createdAt})`,
-            mimeType: "application/json",
-        });
-    }
     if (uiAppsEnabled) {
         for (const uri of uiAppResourceOrder.slice().reverse()) {
             const entry = uiAppResources.get(uri);
@@ -810,6 +852,13 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                             json: snapshot.jsonFilePath ?? null,
                             markdown: snapshot.markdownFilePath ?? null,
                         },
+                        history: buildGraphHistorySummary(),
+                        fileIndex: buildGraphFilesIndex(),
+                        relatedUris: {
+                            markdown: "probe://graph/latest.md",
+                            history: "probe://graph/history",
+                            files: "probe://graph/files",
+                        },
                     }, null, 2),
                 },
             ],
@@ -846,67 +895,24 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
         };
     }
     if (uri === "probe://graph/history") {
-        const history = graphSnapshotOrder
-            .slice()
-            .reverse()
-            .map((id) => graphSnapshots.get(id))
-            .filter((item) => Boolean(item))
-            .map((item) => ({
-            id: item.id,
-            uri: item.uri,
-            toolName: item.toolName,
-            createdAt: item.createdAt,
-            status: item.status,
-            summary: trimText(item.summary, 200),
-            files: {
-                json: item.jsonFilePath ?? null,
-                markdown: item.markdownFilePath ?? null,
-            },
-        }));
+        const history = buildGraphHistorySummary();
         return {
             contents: [
                 {
                     uri,
                     mimeType: "application/json",
-                    text: JSON.stringify({
-                        count: history.length,
-                        items: history,
-                    }, null, 2),
+                    text: JSON.stringify(history, null, 2),
                 },
             ],
         };
     }
     if (uri === "probe://graph/files") {
-        const latestId = graphSnapshotOrder[graphSnapshotOrder.length - 1];
-        const latest = latestId ? graphSnapshots.get(latestId) ?? null : null;
-        const hasDir = fs.existsSync(graphSnapshotDir);
-        const files = hasDir
-            ? fs
-                .readdirSync(graphSnapshotDir, { withFileTypes: true })
-                .filter((entry) => entry.isFile() && /\.(json|md)$/i.test(entry.name))
-                .map((entry) => toPosixPath(path.join(graphSnapshotDir, entry.name)))
-                .sort((a, b) => b.localeCompare(a))
-                .slice(0, 40)
-            : [];
         return {
             contents: [
                 {
                     uri,
                     mimeType: "application/json",
-                    text: JSON.stringify({
-                        snapshotDir: toPosixPath(graphSnapshotDir),
-                        exists: hasDir,
-                        latest: latest
-                            ? {
-                                id: latest.id,
-                                uri: latest.uri,
-                                toolName: latest.toolName,
-                                jsonFilePath: latest.jsonFilePath ?? null,
-                                markdownFilePath: latest.markdownFilePath ?? null,
-                            }
-                            : null,
-                        files,
-                    }, null, 2),
+                    text: JSON.stringify(buildGraphFilesIndex(), null, 2),
                 },
             ],
         };
@@ -948,7 +954,8 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("MCP Probe Kit 服务器已启动");
+    const workspace = resolveWorkspaceRoot("");
+    console.error(`MCP Probe Kit v${VERSION} 已启动 | workspace=${workspace}`);
 }
 // 启动服务器
 main().catch((error) => {

package/build/lib/__tests__/agents-md-template.unit.test.js CHANGED Viewed

@@ -20,6 +20,7 @@ describe('generateAgentsMdInner', () => {
         expect(md).toContain('记忆');
         expect(md).toContain('start_bugfix');
         expect(md).toContain('memorize_asset');
+        expect(md).toContain('mcp-probe-kit/SKILL.md');
         expect(md).toContain('bugfix');
         expect(md).toContain('search_memory');
         expect(md).toContain('自动注入');

package/build/lib/__tests__/dev-workflow.unit.test.d.ts ADDED Viewed

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

package/build/lib/__tests__/dev-workflow.unit.test.js ADDED Viewed

@@ -0,0 +1,22 @@
+import { describe, expect, test } from 'vitest';
+import { buildDevWorkflow, detectWorkflowScenario } from '../dev-workflow.js';
+describe('dev-workflow', () => {
+    test('识别 bugfix 场景', () => {
+        const result = detectWorkflowScenario('登录报错 NullReference 需要排查修复');
+        expect(result.scenario).toBe('bugfix');
+    });
+    test('识别 feature 场景', () => {
+        const result = detectWorkflowScenario('开发用户认证新功能');
+        expect(result.scenario).toBe('feature');
+    });
+    test('bugfix 计划首工具为 start_bugfix', () => {
+        const plan = buildDevWorkflow('TypeError in checkout');
+        expect(plan.firstTool).toBe('start_bugfix');
+        expect(plan.phases.some((p) => p.steps.some((s) => s.tool === 'start_bugfix'))).toBe(true);
+    });
+    test('显式 scenario 覆盖推断', () => {
+        const plan = buildDevWorkflow('随便', { scenario: 'ui' });
+        expect(plan.scenario).toBe('ui');
+        expect(plan.firstTool).toBe('start_ui');
+    });
+});

package/build/lib/__tests__/handles.unit.test.d.ts ADDED Viewed

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

package/build/lib/__tests__/handles.unit.test.js ADDED Viewed

@@ -0,0 +1,19 @@
+import { describe, expect, test } from 'vitest';
+import { attachHandles, buildMemoryAssetHandles, mergeHandles, } from '../../lib/handles.js';
+describe('handles', () => {
+    test('buildMemoryAssetHandles 生成 read 默认工具名', () => {
+        const handles = buildMemoryAssetHandles([{ id: 'a-1', name: 'demo' }]);
+        expect(handles).toEqual([{ id: 'a-1', name: 'demo', tool: 'read_memory_asset' }]);
+    });
+    test('attachHandles 合并已有 handles', () => {
+        const result = attachHandles({ handles: { graph_resource: 'probe://graph/latest' } }, { memory_assets: buildMemoryAssetHandles([{ id: 'x' }]) });
+        expect(result.handles.graph_resource).toBe('probe://graph/latest');
+        expect(result.handles.memory_assets).toHaveLength(1);
+    });
+    test('mergeHandles 后者覆盖 graph 字段', () => {
+        expect(mergeHandles({ graph_resource: 'a' }, { graph_resource: 'b', graph_snapshot: 'probe://graph/s1' })).toEqual({
+            graph_resource: 'b',
+            graph_snapshot: 'probe://graph/s1',
+        });
+    });
+});

package/build/lib/__tests__/mcp-apps.unit.test.d.ts ADDED Viewed

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

package/build/lib/__tests__/mcp-apps.unit.test.js ADDED Viewed

@@ -0,0 +1,52 @@
+import { describe, expect, test } from 'vitest';
+import { buildCodeInsightAppHtml, buildSearchMemoryAppHtml, isMcpUiAppTool, } from '../mcp-apps.js';
+describe('mcp-apps', () => {
+    test('search_memory 与 code_insight 属于 UI App 工具', () => {
+        expect(isMcpUiAppTool('search_memory')).toBe(true);
+        expect(isMcpUiAppTool('code_insight')).toBe(true);
+        expect(isMcpUiAppTool('gencommit')).toBe(false);
+    });
+    test('search_memory App 渲染命中卡片与 handles', () => {
+        const html = buildSearchMemoryAppHtml({ query: 'proxy bug' }, {
+            structuredContent: {
+                query: 'proxy bug',
+                count: 1,
+                results: [
+                    {
+                        id: 'asset-1',
+                        name: 'feishu-proxy',
+                        type: 'bugfix',
+                        score: 0.88,
+                        summary: 'proxy mismatch',
+                        content: '【修复】done',
+                        tags: ['bugfix'],
+                    },
+                ],
+                handles: {
+                    memory_assets: [{ id: 'asset-1', tool: 'read_memory_asset' }],
+                },
+            },
+        });
+        expect(html).toContain('search_memory');
+        expect(html).toContain('feishu-proxy');
+        expect(html).toContain('asset-1');
+        expect(html).toContain('read_memory_asset');
+        expect(html).toContain('proxy mismatch');
+    });
+    test('code_insight App 渲染状态与执行表', () => {
+        const html = buildCodeInsightAppHtml({ mode: 'auto' }, {
+            structuredContent: {
+                status: 'ok',
+                provider: 'gitnexus',
+                summary: 'login flow analyzed',
+                mode: { requested: 'auto', resolved: 'query' },
+                executions: [{ tool: 'query', ok: true, text: 'found login handler' }],
+                handles: { graph_resource: 'probe://graph/latest' },
+            },
+        });
+        expect(html).toContain('code_insight');
+        expect(html).toContain('login flow analyzed');
+        expect(html).toContain('probe://graph/latest');
+        expect(html).toContain('found login handler');
+    });
+});

package/build/lib/__tests__/mcp-tool-skill-registry.unit.test.d.ts ADDED Viewed

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