mcp-probe-kit 3.2.0 → 3.6.0

package/build/tools/search_memory.js

@@ -2,6 +2,7 @@ import { parseArgs, getString, getNumber } from '../utils/parseArgs.js';
 import { okStructured } from '../lib/response.js';
 import { createMemoryClient } from '../lib/memory-client.js';
 import { formatSearchMemoryResultsText, shouldShowSourceInSearch, } from '../lib/memory-orchestration.js';
+import { attachHandles, buildMemoryAssetHandles } from '../lib/handles.js';
 import { getMemoryConfig } from '../lib/memory-config.js';
 import { handleToolError } from '../utils/error-handler.js';
 export async function searchMemory(args) {
@@ -46,12 +47,14 @@ export async function searchMemory(args) {
             tags: item.tags,
             sourcePath: shouldShowSourceInSearch(item, config) ? item.sourcePath : undefined,
         }));
-        return okStructured(formatSearchMemoryResultsText(results, config), {
+        return okStructured(formatSearchMemoryResultsText(results, config), attachHandles({
             enabled: true,
             query,
             count: results.length,
             results: items,
-        });
+        }, {
+            memory_assets: buildMemoryAssetHandles(items),
+        }));
     }
     catch (error) {
         return handleToolError(error, 'search_memory');

package/build/tools/start_bugfix.js

@@ -1,13 +1,15 @@
 import * as fs from "node:fs";
 import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
+import { attachHandles } from "../lib/handles.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { BugFixReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 import { buildBugfixGraphContext } from "../lib/gitnexus-bridge.js";
-import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, } from "../lib/memory-orchestration.js";
+import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, buildOrchestrationHandles, } from "../lib/memory-orchestration.js";
 import { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 import { layoutAbsPath, parseLayoutArgsFromRecord, resolveProjectContextLayout, } from "../lib/project-context-layout.js";
+import { buildCheckSpecPlanStep, renderSpecGatePromptSection, resolveBugfixSpecGate, } from "../lib/spec-gate.js";
 function decideTemplateProfile(description) {
     const text = description || '';
     const lengthScore = text.length >= 200 ? 2 : text.length >= 120 ? 1 : 0;
@@ -120,6 +122,8 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因
 
 **产出**: 测试代码
 
+{spec_gate_section}
+
 ---
 
 ## ✅ 完成检查
@@ -177,6 +181,7 @@ const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | TBP 8 步）
   "framework": "[根据项目上下文选择: jest/vitest/mocha]"
 }
 \`\`\`
+{spec_gate_section}
 
 ---
 
@@ -307,6 +312,8 @@ export async function startBugfix(args, context) {
                 stack_trace: ["stack", "trace", "堆栈", "调用栈"],
                 code_context: ["code_context", "code", "context", "相关代码", "代码上下文"],
                 project_root: ["projectRoot", "project_path", "projectPath", "root", "project_root", "项目路径", "项目根目录"],
+                docs_dir: ["dir", "output", "目录", "文档目录"],
+                feature_name: ["name", "feature", "spec", "功能名", "功能名称", "规格"],
                 analysis_mode: ["analysis_mode", "methodology", "rca", "tbp", "分析方法"],
                 template_profile: ["profile", "template_profile", "模板档位", "模板模式"],
                 requirements_mode: ["mode", "requirements_mode", "loop", "需求模式"],
@@ -320,6 +327,7 @@ export async function startBugfix(args, context) {
         const codeContext = getString(parsedArgs.code_context);
         const projectRoot = getString(parsedArgs.project_root);
         const docsDir = getString(parsedArgs.docs_dir) || "docs";
+        const featureNameInput = getString(parsedArgs.feature_name);
         if (isLikelyProjectNamedRelativePath(projectRoot)) {
             return {
                 content: [{
@@ -388,6 +396,18 @@ export async function startBugfix(args, context) {
             layoutManifest: layout.manifestPath,
         };
         const graphDocsMissing = !bootstrapState.latestMarkdownExists || !bootstrapState.latestJsonExists;
+        const specGate = resolveBugfixSpecGate({
+            featureName: featureNameInput,
+            projectRoot: layout.projectRoot,
+            docsDir,
+            hintText: combinedText,
+        });
+        const specGateSection = specGate ? renderSpecGatePromptSection(specGate) : '';
+        if (specGate) {
+            headerNotes.push(specGate.detected
+                ? `规格闸门: 已自动关联 ${specGate.specDir}/，修复后需 check_spec`
+                : `规格闸门: 关联 ${specGate.specDir}/，修复后需 check_spec`);
+        }
         const graphContext = await buildBugfixGraphContext({
             errorMessage,
             stackTrace,
@@ -571,7 +591,7 @@ ${graphContext.highlights.length > 0
                 },
             };
             await reportToolProgress(context, 95, "start_bugfix: loop 输出已生成");
-            return okStructured(guide, loopReport, {
+            return okStructured(guide, attachHandles(loopReport, buildOrchestrationHandles(memoryContext)), {
                 schema: RequirementsLoopSchema,
                 note: 'AI 应按轮次澄清 Bug 需求并更新结构化输出，满足结束条件后再进入 fix_bug / gentest',
             });
@@ -598,7 +618,8 @@ ${graphContext.highlights.length > 0
             .replace(/{error_message}/g, errorMessage)
             .replace(/{stack_trace}/g, stackTrace)
             .replace(/{analysis_mode}/g, analysisMode)
-            .replace(/{stack_trace_section}/g, stackTraceSection);
+            .replace(/{stack_trace_section}/g, stackTraceSection)
+            .replace(/{spec_gate_section}/g, specGateSection);
         const guide = header + memoryGuideSection + renderedPrompt + graphGuideSection;
         const plan = {
             mode: 'delegated',
@@ -635,6 +656,7 @@ ${graphContext.highlights.length > 0
                     },
                     outputs: [],
                 },
+                ...(specGate ? [buildCheckSpecPlanStep(specGate.featureName, specGate.docsDir)] : []),
                 ...(memoryContext.enabled ? [buildMemoryPlanStep('bugfix')] : []),
             ],
         };
@@ -659,6 +681,13 @@ ${graphContext.highlights.length > 0
                     status: 'pending',
                     description: '调用 gentest 工具生成测试用例',
                 },
+                ...(specGate
+                    ? [{
+                            name: '规格闸门校验',
+                            status: 'pending',
+                            description: `修复后调用 check_spec 校验 ${specGate.specDir}/`,
+                        }]
+                    : []),
             ],
             artifacts: [],
             nextSteps: [
@@ -670,6 +699,9 @@ ${graphContext.highlights.length > 0
                 '调用 fix_bug 工具分析问题并形成因果句真因',
                 '调用 gentest 工具生成回归测试',
                 '运行测试验证修复',
+                ...(specGate
+                    ? [`修复后调用 check_spec 校验 ${specGate.specDir}/，未通过先补规格再重跑`]
+                    : []),
             ],
             rootCause: '待分析（需要调用 fix_bug 工具）',
             fixPlan: '待制定（需要调用 fix_bug 工具）',
@@ -709,10 +741,11 @@ ${graphContext.highlights.length > 0
                     graphDocsMissing,
                 },
                 graphContext,
+                ...(specGate ? { specGate } : {}),
             },
         };
         await reportToolProgress(context, 95, "start_bugfix: 执行计划输出已生成");
-        return okStructured(guide, bugfixReport, {
+        return okStructured(guide, attachHandles(bugfixReport, buildOrchestrationHandles(memoryContext)), {
             schema: BugFixReportSchema,
             note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent 中的状态',
         });

package/build/tools/start_feature.js

@@ -1,11 +1,12 @@
 import * as fs from "node:fs";
 import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
+import { attachHandles } from "../lib/handles.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { FeatureReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 import { buildFeatureGraphContext } from "../lib/gitnexus-bridge.js";
-import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, } from "../lib/memory-orchestration.js";
+import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, buildOrchestrationHandles, } from "../lib/memory-orchestration.js";
 import { resolveWorkspaceRoot, toWorkspacePath, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 import { layoutAbsPath, parseLayoutArgsFromRecord, resolveProjectContextLayout, } from "../lib/project-context-layout.js";
 /**
@@ -463,7 +464,7 @@ ${graphContext.highlights.length > 0
                 },
             };
             await reportToolProgress(context, 95, "start_feature: loop 输出已生成");
-            return okStructured(guide, loopReport, {
+            return okStructured(guide, attachHandles(loopReport, buildOrchestrationHandles(memoryContext)), {
                 schema: RequirementsLoopSchema,
                 note: 'AI 应按轮次澄清需求并更新结构化输出，满足结束条件后再进入 add_feature / estimate',
             });
@@ -595,7 +596,7 @@ ${graphContext.highlights.length > 0
             },
         };
         await reportToolProgress(context, 95, "start_feature: 执行计划输出已生成");
-        return okStructured(guide, featureReport, {
+        return okStructured(guide, attachHandles(featureReport, buildOrchestrationHandles(memoryContext)), {
             schema: FeatureReportSchema,
             note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent 中的状态和估算信息',
         });

package/build/tools/start_product.js

@@ -89,7 +89,7 @@ export async function startProduct(args, context) {
             ],
             notes: [buildSkillHeaderNote(skillBridge)],
         });
-        const guidanceText = header + skillBridgeSection + `# 🚀 产品设计工作流执行指导
+        const guidanceText = header + skillBridgeSection + `# 🚀 产品设计工作流执行指导
 
 基于${requirementsSource}，请按照以下步骤完成从需求到 HTML 原型的完整产品设计流程。
 

package/build/tools/start_ui.js

@@ -10,14 +10,26 @@
 import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { getReasoningEngine } from "./ui-ux-tools.js";
 import { okStructured } from "../lib/response.js";
+import { attachHandles } from "../lib/handles.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { buildSkillBridgePlanStep, buildSkillHeaderNote, detectSkillBridge, renderSkillBridgeSection, } from "../lib/skill-bridge.js";
 import { UIReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
 import { detectProjectType } from "../lib/project-detector.js";
 import { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
-import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, } from "../lib/memory-orchestration.js";
+import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, buildOrchestrationHandles, } from "../lib/memory-orchestration.js";
 import { isShadcnStack } from "../lib/shadcn-ui.js";
+import { renderUiHardRules, renderUiBannedList, renderPreFlightChecklist } from "../lib/quality-constraints.js";
+/** 渲染代码步骤统一注入的 UI 硬约束 + 黑名单 + 交付前自检 */
+const UI_CONSTRAINTS_BLOCK = `
+
+---
+
+${renderUiHardRules()}
+
+${renderUiBannedList()}
+
+${renderPreFlightChecklist()}`;
 function buildShadcnBlocksPlanStep(description, framework) {
     if (!isShadcnStack(framework)) {
         return [];
@@ -262,6 +274,10 @@ A: 不需要。如果文件已存在，直接跳过步骤 1。
 
 **Q: 如何使用自定义模板？**
 A: 在 \`docs/ui/\` 目录创建 JSON 模板文件，然后在步骤 4 中指定模板路径。
+
+---
+
+${UI_CONSTRAINTS_BLOCK}
 `;
 const PROMPT_TEMPLATE_STRICT = `# UI 开发编排（严格）
 
@@ -339,6 +355,8 @@ const PROMPT_TEMPLATE_STRICT = `# UI 开发编排（严格）
 ## 步骤 7: 更新项目上下文索引
 
 将 UI 文档链接添加到 \`docs/project-context.md\`
+
+${UI_CONSTRAINTS_BLOCK}
 `;
 const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 UI 需求澄清与补全（Requirements Loop）
 
@@ -765,7 +783,7 @@ start_ui <描述> --requirements_mode=loop
                 },
             };
             await reportToolProgress(context, 95, "start_ui: loop 输出已生成");
-            return okStructured(guide, loopReport, {
+            return okStructured(guide, attachHandles(loopReport, buildOrchestrationHandles(memoryContext)), {
                 schema: RequirementsLoopSchema,
                 note: 'AI 应按轮次澄清 UI 需求并更新结构化输出，满足结束条件后再执行 UI 计划',
             });
@@ -1018,7 +1036,7 @@ ${recommendation.reasoning}
                 },
             };
             await reportToolProgress(context, 95, "start_ui: auto 输出已生成");
-            return okStructured(smartPlan, uiReport, {
+            return okStructured(smartPlan, attachHandles(uiReport, buildOrchestrationHandles(memoryContext)), {
                 schema: UIReportSchema,
                 note: 'AI 应该按照智能计划执行步骤，并在每个步骤完成后更新 structuredContent',
             });
@@ -1221,7 +1239,7 @@ start_ui "设置页面" --framework=react
             },
         };
         await reportToolProgress(context, 95, "start_ui: manual 输出已生成");
-        return okStructured(guide, uiReport, {
+        return okStructured(guide, attachHandles(uiReport, buildOrchestrationHandles(memoryContext)), {
             schema: UIReportSchema,
             note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent',
         });

package/build/tools/ui-ux-tools.d.ts

@@ -26,6 +26,9 @@ export interface CreationGuidance {
     layout: string[];
     config: string[];
     tips: string[];
+    hardRules: string;
+    banned: string;
+    preFlight: string;
 }
 /**
  * UI 设计系统输出接口（重构版）