mcp-probe-kit 3.6.5 → 3.6.9

package/build/schemas/project-tools.d.ts

@@ -22,7 +22,7 @@ export declare const projectToolSchemas: readonly [{
     };
 }, {
     readonly name: "init_project_context";
-    readonly description: "生成/更新项目上下文：默认写入 AGENTS.md（含 MCP 与 GitNexus 触发规则）及 docs/project-context/。新功能请先 start_feature，修 bug 请先 start_bugfix。完成后 Agent 应阅读 AGENTS.md。";
+    readonly description: "生成/更新项目上下文写作计划（delegated）：MCP 写入 AGENTS.md 与 layout.json；project-context 分类文档与 graph-insights 由 Agent 按返回的 plan 落盘。新功能请先 start_feature，修 bug 请先 start_bugfix。";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/build/schemas/project-tools.js

@@ -25,7 +25,7 @@ export const projectToolSchemas = [
     },
     {
         name: "init_project_context",
-        description: "生成/更新项目上下文：默认写入 AGENTS.md（含 MCP 与 GitNexus 触发规则）及 docs/project-context/。新功能请先 start_feature，修 bug 请先 start_bugfix。完成后 Agent 应阅读 AGENTS.md。",
+        description: "生成/更新项目上下文写作计划（delegated）：MCP 写入 AGENTS.md 与 layout.json；project-context 分类文档与 graph-insights 由 Agent 按返回的 plan 落盘。新功能请先 start_feature，修 bug 请先 start_bugfix。",
         inputSchema: {
             type: "object",
             properties: {

package/build/tools/__tests__/add_feature.write.unit.test.js

@@ -15,8 +15,11 @@ describe("add_feature 不落盘", () => {
             });
             expect(result.isError).toBeFalsy();
             const structured = result.structuredContent;
+            expect(structured.summary).toBe("已生成功能规格写作计划：user-auth");
             expect(structured.pendingFiles).toHaveLength(3);
+            expect(structured.specPaths).toHaveLength(3);
             expect(structured.writtenFiles).toBeUndefined();
+            expect(result._meta?.note).toMatch(/不代写文件/);
             expect(fs.existsSync(path.join(projectRoot, "docs", "specs", "user-auth", "requirements.md"))).toBe(false);
             const text = String(result.content[0].text);
             expect(text).toMatch(/由 Agent 落盘/);

package/build/tools/__tests__/init_project.write.unit.test.js

@@ -13,6 +13,9 @@ describe("init_project 落盘边界", () => {
         });
         expect(result.isError).toBeFalsy();
         const structured = result.structuredContent;
+        expect(structured.summary).toBe("已生成项目初始化写作计划，请 Agent 按指南落盘 docs/specs/scripts/src");
+        expect(structured.nextSteps[0]).toContain("MCP 仅写入 Skill 与 AGENTS.md");
+        expect(structured.nextSteps[0]).toContain("Agent 须按指南手动落盘");
         expect(structured.writtenFiles.length).toBe(2);
         expect(structured.pendingFiles.length).toBeGreaterThan(0);
         expect(fs.existsSync(path.join(projectRoot, "AGENTS.md"))).toBe(true);

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

@@ -25,6 +25,21 @@ describe("init_project_context 单元测试", () => {
         expect(fs.existsSync(path.join(projectRoot, "docs", "project-context", "tech-stack.md"))).toBe(false);
         const plan = structured.metadata?.plan;
         expect(plan?.mode).toBe("delegated");
+        expect(structured.summary).toMatch(/写作计划/);
+        expect(structured.summary).not.toMatch(/^生成 .*项目上下文/);
+        expect(structured.nextSteps?.[0]).toMatch(/不会自动生成完整/);
+        const legacyDoc = structured.documentation?.find((doc) => doc.path === "docs/project-context.md");
+        expect(legacyDoc).toMatchObject({
+            exists: false,
+            written: false,
+            agent_action_required: true,
+        });
+        const agentsDoc = structured.documentation?.find((doc) => doc.path === "AGENTS.md");
+        expect(agentsDoc).toMatchObject({
+            exists: true,
+            written: true,
+            agent_action_required: false,
+        });
         expect(plan.steps.map((step) => step.id)).toEqual([
             "write-modular-docs",
             "bootstrap-code-insight",
@@ -59,6 +74,19 @@ describe("init_project_context 单元测试", () => {
             "persist-graph-docs",
         ]);
         expect(structured.pendingFiles.every((f) => !f.path.startsWith("docs/project-context"))).toBe(true);
+        expect(structured.summary).toMatch(/保留现有分类文档/);
+        const legacyDoc = structured.documentation?.find((doc) => doc.path === "docs/project-context.md");
+        expect(legacyDoc).toMatchObject({
+            exists: true,
+            written: true,
+            agent_action_required: false,
+        });
+        const graphDoc = structured.documentation?.find((doc) => doc.path === "docs/graph-insights/latest.md");
+        expect(graphDoc).toMatchObject({
+            exists: false,
+            written: false,
+            agent_action_required: true,
+        });
         expect(fs.readFileSync(path.join(projectRoot, "docs", "project-context.md"), "utf8")).toBe("# existing context\n");
         expect(fs.existsSync(path.join(projectRoot, "AGENTS.md"))).toBe(true);
         const text = result.content[0].text;

package/build/tools/add_feature.js

@@ -296,7 +296,7 @@ ${fenceClose}
             reason: "由 Agent 根据本工具返回的模板写入",
         }));
         const structuredData = {
-            summary: `功能规格：${featureName}`,
+            summary: `已生成功能规格写作计划：${featureName}`,
             featureName,
             requirements: ["见 requirements.md 模板"],
             tasks: [{ id: "1", title: "按模板创建 specs 文档", description: "将下方模板落盘并补充真实内容" }],

package/build/tools/init_project.js

@@ -4,6 +4,7 @@ import { ensureMcpProbeKitBootstrap } from "../lib/workflow-skill-installer.js";
 import { MCP_PROBE_SKILL_REL_PATH } from "../lib/workflow-skill-template.js";
 import { resolveWorkspaceRootWithMeta } from "../lib/workspace-root.js";
 import { toPosixPath } from "../lib/project-context-layout.js";
+const AGENT_MANUAL_WRITE_NOTICE = "MCP 仅写入 Skill 与 AGENTS.md；Agent 须按指南手动落盘 pendingFiles 中的 docs、specs、scripts、src。";
 /**
  * init_project 工具
  *
@@ -226,7 +227,7 @@ ${warningBlock}
 MCP 已写入 Skill 与 AGENTS.md。请按上述步骤由 Agent 创建 docs、scripts、src 及 specs 文档。`;
         // 创建结构化数据对象
         const structuredData = {
-            summary: `初始化项目：${projectName}`,
+            summary: "已生成项目初始化写作计划，请 Agent 按指南落盘 docs/specs/scripts/src",
             projectName: projectName,
             projectRoot: toPosixPath(projectRoot),
             bootstrap: {
@@ -255,11 +256,12 @@ MCP 已写入 Skill 与 AGENTS.md。请按上述步骤由 Agent 创建 docs、sc
             writtenFiles: bootstrapWritten,
             pendingFiles,
             nextSteps: [
-                '确认 Skill 与 AGENTS.md 已落盘',
-                '按指南创建 docs/ 文档与 specs',
-                '创建 scripts/ 辅助脚本',
-                '创建 src/ 源代码目录',
-                '运行 init_project_context 生成完整上下文与图谱',
+                AGENT_MANUAL_WRITE_NOTICE,
+                "确认 Skill 与 AGENTS.md 已落盘",
+                "按指南创建 docs/ 文档与 specs",
+                "创建 scripts/ 辅助脚本",
+                "创建 src/ 源代码目录",
+                "运行 init_project_context 生成完整上下文与图谱",
             ]
         };
         return okStructured(message, structuredData, {

package/build/tools/init_project_context.js

@@ -6,9 +6,13 @@ import { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRoo
 import { detectDocumentLocale, layoutAbsPath, legacyProjectContextExists, parseLayoutArgsFromRecord, resolveProjectContextLayout, toPosixPath, writeLayoutManifest, } from "../lib/project-context-layout.js";
 import { mergeAgentsMdBlock } from "../lib/merge-agents-md.js";
 import { generateAgentsMdInner } from "../lib/agents-md-template.js";
-import { formatFileDeliverySection, writeProjectFile, } from "../lib/file-delivery.js";
+import { ensureHarnessAdapters } from "../lib/harness-adapters.js";
+import { generateWorkflowSkillContent, MCP_PROBE_SKILL_REL_PATH } from "../lib/workflow-skill-template.js";
+import { getMcpProbeSkillVersion } from "../lib/workflow-skill-version.js";
+import { buildFileStatusEntries, formatFileDeliverySection, writeProjectFile, } from "../lib/file-delivery.js";
 import * as fs from "fs";
 import * as path from "path";
+const AGENT_MANUAL_WRITE_NOTICE = "本工具不会自动生成完整 project-context 与图谱内容，Agent 必须根据 metadata.plan 与 pendingFiles 手动写入这些文件。";
 /**
  * init_project_context 工具
  *
@@ -177,14 +181,26 @@ async function generateProjectContext(layout, projectRoot) {
             category: detection.category,
             docs,
             projectRootPosix: layout.projectRootPosix,
-            graphReady: false,
+            graphReady: fs.existsSync(layoutAbsPath(layout, layout.latestMarkdownPath)),
+            contextReady: modularExists,
         });
         const mergedAgents = mergeAgentsMdBlock(existingAgentsRaw, agentsInner);
-        const manifestWritten = writeLayoutManifest(projectRootAbs, layout);
+        const skillPath = layoutAbsPath(layout, MCP_PROBE_SKILL_REL_PATH);
+        const skillContent = fs.existsSync(skillPath)
+            ? fs.readFileSync(skillPath, "utf8")
+            : generateWorkflowSkillContent(getMcpProbeSkillVersion());
+        const harnessResult = ensureHarnessAdapters(projectRootAbs, skillContent, layout.indexPath);
+        const manifestWritten = writeLayoutManifest(projectRootAbs, layout, harnessResult.layoutHarness);
         const agentsMdWritten = writeProjectFile(projectRootAbs, layout.indexPath, mergedAgents.content, "always");
         const writtenFiles = [
             agentsMdWritten,
             { path: manifestWritten, action: "updated" },
+            ...harnessResult.adapters
+                .filter((a) => a.created || a.updated)
+                .map((a) => ({
+                path: a.path,
+                action: (a.created ? "created" : "updated"),
+            })),
         ];
         const pendingFiles = [
             ...(modularExists
@@ -260,22 +276,43 @@ async function generateProjectContext(layout, projectRoot) {
         const header = renderOrchestrationHeader({
             tool: "init_project_context",
             goal: modularExists
-                ? "补齐图谱（保留现有分类文档；AGENTS.md 已由 MCP 写入）"
-                : "写入 AGENTS.md 与 layout，由 Agent 生成 project-context 与图谱",
+                ? "已生成 delegated 写作计划（保留现有分类文档；AGENTS.md 已由 MCP 写入）"
+                : "已生成 delegated 写作计划（AGENTS.md 与 layout 已由 MCP 写入）",
             tasks: modularExists
-                ? ["保留现有分类文档", "code_insight + Agent 落盘图谱"]
-                : ["MCP 已写 AGENTS.md 与 layout", "Agent 写分类文档", "code_insight + Agent 落盘图谱"],
+                ? ["保留现有分类文档", "Agent 按 plan 落盘图谱"]
+                : ["Agent 按 plan 落盘 project-context 分类文档", "code_insight + Agent 落盘图谱"],
             notes: [
                 `项目根目录: ${toPosixPath(resolvedRoot)}`,
                 `上下文目录: ${docsDir}`,
                 `索引: ${layout.indexPath}`,
                 `layout: ${manifestWritten}（已服务端写入）`,
+                AGENT_MANUAL_WRITE_NOTICE,
             ],
         });
+        const documentationDefs = [
+            { path: layout.indexPath, purpose: "Harness 入口（MCP 触发规则，省 token）" },
+            {
+                path: layout.legacyIndexPath,
+                purpose: "项目上下文索引（写代码前优先读，链到分类文档）",
+            },
+            ...docs.map((doc) => ({
+                path: `${layout.modularDir}/${doc.file}`,
+                purpose: doc.purpose,
+            })),
+            {
+                path: layout.latestMarkdownPath,
+                purpose: "最新代码图谱洞察（由 code_insight 维护）",
+            },
+            {
+                path: layout.latestJsonPath,
+                purpose: "最新代码图谱结构化结果（由 code_insight 维护）",
+            },
+            { path: layout.manifestPath, purpose: "layout manifest（工具链路径发现）" },
+        ];
         const structuredData = {
             summary: modularExists
-                ? `检测到现有项目上下文，补齐图谱与 ${layout.indexPath}`
-                : `生成 ${detection.category} 项目上下文与 ${layout.indexPath}`,
+                ? "已生成上下文写作计划（保留现有分类文档），请 Agent 按 plan 落盘图谱文件"
+                : "已生成上下文写作计划，请 Agent 按 plan 落盘文件",
             mode: "modular",
             projectOverview: {
                 name: projectInfo.name,
@@ -283,31 +320,16 @@ async function generateProjectContext(layout, projectRoot) {
                 techStack: detection.framework ? [detection.framework] : [],
                 architecture: detection.category,
             },
-            documentation: [
-                { path: layout.indexPath, purpose: "Harness 入口（MCP 触发规则，省 token）" },
-                {
-                    path: layout.legacyIndexPath,
-                    purpose: "项目上下文索引（写代码前优先读，链到分类文档）",
-                },
-                ...docs.map((doc) => ({
-                    path: `${layout.modularDir}/${doc.file}`,
-                    purpose: doc.purpose,
-                })),
-                {
-                    path: layout.latestMarkdownPath,
-                    purpose: "最新代码图谱洞察（由 code_insight 维护）",
-                },
-                {
-                    path: layout.latestJsonPath,
-                    purpose: "最新代码图谱结构化结果（由 code_insight 维护）",
-                },
-                { path: layout.manifestPath, purpose: "layout manifest（工具链路径发现）" },
-            ],
+            documentation: buildFileStatusEntries(projectRootAbs, documentationDefs, writtenFiles, pendingFiles).map((entry) => ({
+                ...entry,
+                purpose: entry.purpose ?? "",
+            })),
             nextSteps: [
+                AGENT_MANUAL_WRITE_NOTICE,
                 ...(modularExists
                     ? [`保留 ${layout.legacyIndexPath} 与分类文档`]
                     : [`由 Agent 按模板创建 ${layout.modularDir}/ 分类文档`]),
-                "调用 code_insight，由 Agent 落盘图谱",
+                "调用 code_insight，由 Agent 按 metadata.plan 落盘图谱",
                 `${layout.indexPath} 与 ${manifestWritten} 已由 MCP 写入（mergeMode: ${mergedAgents.mergeMode}）`,
             ],
             writtenFiles,

package/package.json

@@ -1,84 +1,84 @@
-{
-  "name": "mcp-probe-kit",
-  "version": "3.6.5",
-  "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",
-  "main": "build/index.js",
-  "bin": {
-    "mcp-probe-kit": "build/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
-    "watch": "tsc --watch",
-    "dev": "tsc && node build/index.js",
-    "test": "vitest --run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "sync-ui-data": "tsx scripts/sync-ui-data.ts",
-    "sync-version": "node scripts/sync-version.mjs",
-    "verify-workflow-skill": "tsx scripts/verify-workflow-skill.ts",
-    "sync-workflow-skill": "tsx scripts/sync-workflow-skill.ts",
-    "prebuild": "npm run sync-version && npm run sync-ui-data && npm run verify-workflow-skill && npm run sync-workflow-skill",
-    "docs:serve": "npx http-server docs -p 8080 -o"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "cursor",
-    "ai-tools",
-    "development-tools",
-    "code-quality",
-    "code-review",
-    "refactor",
-    "debugging",
-    "sql-generator",
-    "ui-generator",
-    "react",
-    "vue",
-    "typescript",
-    "git-tools",
-    "ai-assistant"
-  ],
-  "author": {
-    "name": "小墨 (Kyle)",
-    "url": "https://www.bytezonex.com/"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mybolide/mcp-probe-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
-  },
-  "homepage": "https://mcp-probe-kit.bytezonex.com",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "build",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "cross-spawn": "^7.0.6",
-    "csv-parse": "^6.1.0",
-    "tar": "^7.5.6"
-  },
-  "devDependencies": {
-    "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^20.0.0",
-    "@types/tar": "^6.1.13",
-    "@vitest/ui": "^4.0.18",
-    "fast-check": "^4.5.3",
-    "tsx": "^4.21.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "mcp-probe-kit",
+  "version": "3.6.9",
+  "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",
+  "main": "build/index.js",
+  "bin": {
+    "mcp-probe-kit": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
+    "watch": "tsc --watch",
+    "dev": "tsc && node build/index.js",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "sync-ui-data": "tsx scripts/sync-ui-data.ts",
+    "sync-version": "node scripts/sync-version.mjs",
+    "verify-workflow-skill": "tsx scripts/verify-workflow-skill.ts",
+    "sync-workflow-skill": "tsx scripts/sync-workflow-skill.ts",
+    "prebuild": "npm run sync-version && npm run sync-ui-data && npm run verify-workflow-skill && npm run sync-workflow-skill",
+    "docs:serve": "npx http-server docs -p 8080 -o"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "ai-tools",
+    "development-tools",
+    "code-quality",
+    "code-review",
+    "refactor",
+    "debugging",
+    "sql-generator",
+    "ui-generator",
+    "react",
+    "vue",
+    "typescript",
+    "git-tools",
+    "ai-assistant"
+  ],
+  "author": {
+    "name": "小墨 (Kyle)",
+    "url": "https://www.bytezonex.com/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mybolide/mcp-probe-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
+  },
+  "homepage": "https://mcp-probe-kit.bytezonex.com",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cross-spawn": "^7.0.6",
+    "csv-parse": "^6.1.0",
+    "tar": "^7.5.6"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^20.0.0",
+    "@types/tar": "^6.1.13",
+    "@vitest/ui": "^4.0.18",
+    "fast-check": "^4.5.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  }
+}