mcp-probe-kit 3.3.0 → 3.6.1

package/build/tools/init_project.js

@@ -1,5 +1,8 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
+import { ensureMcpProbeKitBootstrap } from "../lib/workflow-skill-installer.js";
+import { MCP_PROBE_SKILL_REL_PATH } from "../lib/workflow-skill-template.js";
+import { resolveWorkspaceRoot } from "../lib/workspace-root.js";
 /**
  * init_project 工具
  *
@@ -13,174 +16,183 @@ export async function initProject(args) {
             defaultValues: {
                 input: "",
                 project_name: "新项目",
+                project_root: "",
             },
             primaryField: "input", // 纯文本输入默认映射到 input 字段
             fieldAliases: {
                 input: ["requirement", "description", "需求", "项目需求"],
                 project_name: ["name", "project", "项目名", "项目名称"],
+                project_root: ["root", "path", "项目路径"],
             },
         });
         const input = getString(parsedArgs.input);
         const projectName = getString(parsedArgs.project_name) || "新项目";
+        const projectRoot = resolveWorkspaceRoot(getString(parsedArgs.project_root));
+        const bootstrap = ensureMcpProbeKitBootstrap(projectRoot);
         const featureSlug = projectName.toLowerCase().replace(/\s+/g, '-');
-        const message = `你需要按照 Spec-Driven Development（规范驱动开发）的方式初始化项目，参考 https://github.com/github/spec-kit 的工作流程。
-
-📋 **项目需求**：
-${input}
-
-🎯 **初始化步骤**：
-
-**第一步：创建项目基础结构**
-在当前工作区创建以下目录和文件：
-
-\`\`\`
-.
-├── docs/
-│   ├── project-context.md           # 项目上下文（技术栈、架构、规范）
-│   ├── constitution.md              # 项目宪法（核心原则和约束）
-│   └── specs/
-│       └── ${featureSlug}/
-│           ├── requirements.md      # 需求文档（EARS 格式）
-│           ├── design.md            # 设计文档
-│           ├── tasks.md             # 任务分解
-│           └── research.md          # 技术调研
-├── scripts/
-│   ├── check-prerequisites.sh
-│   └── setup.sh
-└── src/                             # 源代码目录
-\`\`\`
-
-**第二步：生成 project-context.md**
-在 \`docs/project-context.md\` 中记录项目的核心信息：
-- 项目概览（名称、版本、类型、描述）
-- 技术栈（语言、框架、构建工具、测试框架）
-- 项目结构（目录说明、入口文件）
-- 架构模式（设计模式、模块划分）
-- 编码规范（代码风格、命名规范）
-- 依赖管理（主要依赖列表）
-- 开发流程（常用命令）
-
-**第三步：生成 constitution.md**
-在 \`docs/constitution.md\` 中定义项目的核心原则：
-- 代码风格规范
-- 架构原则
-- 安全准则
-- 测试要求
-- 文档标准
-
-**第四步：生成 requirements.md（需求文档）**
-在 \`docs/specs/${featureSlug}/requirements.md\` 中详细描述：
-- 功能概述
-- 术语定义
-- 需求列表（使用 EARS 格式）
-  - 用户故事（As a... I want... So that...）
-  - 验收标准（WHEN/WHILE/IF...THEN...SHALL）
-- 非功能需求（性能、安全、兼容性）
-- 依赖关系
-
-**EARS 格式说明**：
-| 模式 | 格式 | 适用场景 |
-|------|------|----------|
-| Ubiquitous | THE [system] SHALL [response] | 始终适用的需求 |
-| Event-driven | WHEN [trigger], THE [system] SHALL [response] | 事件触发的需求 |
-| State-driven | WHILE [condition], THE [system] SHALL [response] | 状态相关的需求 |
-| Unwanted | IF [condition], THEN THE [system] SHALL [response] | 异常处理需求 |
-
-**第五步：生成 design.md（设计文档）**
-在 \`docs/specs/${featureSlug}/design.md\` 中描述：
-- 技术方案（技术选型及理由）
-- 架构设计（系统架构图）
-- 数据模型（数据结构定义）
-- API 设计（接口定义）
-- 文件结构（新增/修改的文件）
-- 设计决策（重要决策及理由）
-- 风险评估
-
-**第六步：生成 research.md（技术调研）**
-在 \`docs/specs/${featureSlug}/research.md\` 中记录：
-- 技术栈调研结果
-- 版本兼容性确认
-- 潜在风险识别
-- 最佳实践记录
-- 参考文档链接
-
-**第七步：生成 tasks.md（任务分解）**
-在 \`docs/specs/${featureSlug}/tasks.md\` 中分解任务：
-
-\`\`\`markdown
-# 任务清单：${projectName}
-
-## 概述
-实现 ${projectName} 的任务分解。
-
----
-
-## 任务列表
-
-### 阶段 1: 项目初始化
-- [ ] 1.1 搭建项目骨架
-  - 创建目录结构
-  - 初始化 package.json
-  - _需求: 1.1_
-
-- [ ] 1.2 配置开发环境
-  - 配置 TypeScript/ESLint/Prettier
-  - _需求: 1.1_
-
-### 阶段 2: 核心功能实现
-- [ ] 2.1 实现数据模型
-  - 定义数据结构
-  - _需求: 2.1_
-
-- [ ] 2.2 实现业务逻辑
-  - 核心功能开发
-  - 依赖: 任务 2.1
-  - _需求: 2.2_
-
-### 阶段 3: 集成测试
-- [ ] 3.1 编写测试用例
-  - 单元测试
-  - 集成测试
-  - _需求: 3.1_
-
----
-
-## 检查点
-- [ ] 阶段 1 完成后：项目可运行
-- [ ] 阶段 2 完成后：核心功能可用
-- [ ] 阶段 3 完成后：测试通过
-
----
-
-## 文件变更清单
-| 文件 | 操作 | 说明 |
-|------|------|------|
-| src/index.ts | 新建 | 入口文件 |
-| package.json | 新建 | 项目配置 |
-
----
-
-**标记说明**：
-- [P]: 可以并行执行的任务
-- 依赖: 必须在指定任务完成后才能开始
-- _需求: x.x_: 关联的需求编号
-\`\`\`
-
-**第八步：生成辅助脚本**
-创建项目管理脚本：
-- \`scripts/check-prerequisites.sh\`: 检查环境依赖
-- \`scripts/setup.sh\`: 自动化项目初始化
-
-📝 **注意事项**：
-1. 所有文档统一放在 \`docs/\` 目录下
-2. 功能规格放在 \`docs/specs/{feature-name}/\` 目录
-3. 所有文件使用 Markdown 格式，保持清晰的结构
-4. 遵循项目 constitution 中定义的原则
-5. 任务分解要足够细致，每个任务应该在 2-4 小时内完成
-6. 标记清楚任务之间的依赖关系
-7. 识别可以并行执行的任务以优化开发效率
-
-🚀 **开始执行**：
+        const message = `你需要按照 Spec-Driven Development（规范驱动开发）的方式初始化项目，参考 https://github.com/github/spec-kit 的工作流程。
+
+📋 **项目需求**：
+${input}
+
+📌 **MCP Skill 已同步**（项目根: \`${projectRoot}\`）：
+- \`${MCP_PROBE_SKILL_REL_PATH}\`${bootstrap.skill.created ? "（已创建）" : bootstrap.skill.updated ? "（已升级）" : "（已是最新）"}
+- \`${bootstrap.agentsMd.path}\`${bootstrap.agentsMd.created ? "（已创建）" : bootstrap.agentsMd.updated ? "（已更新）" : ""}
+${bootstrap.workspaceWarning ? `\n⚠️ ${bootstrap.workspaceWarning}\n` : ""}
+
+🎯 **初始化步骤**：
+
+**第一步：创建项目基础结构**
+在当前工作区创建以下目录和文件：
+
+\`\`\`
+.
+├── docs/
+│   ├── project-context.md           # 项目上下文（技术栈、架构、规范）
+│   ├── constitution.md              # 项目宪法（核心原则和约束）
+│   └── specs/
+│       └── ${featureSlug}/
+│           ├── requirements.md      # 需求文档（EARS 格式）
+│           ├── design.md            # 设计文档
+│           ├── tasks.md             # 任务分解
+│           └── research.md          # 技术调研
+├── scripts/
+│   ├── check-prerequisites.sh
+│   └── setup.sh
+└── src/                             # 源代码目录
+\`\`\`
+
+**第二步：生成 project-context.md**
+在 \`docs/project-context.md\` 中记录项目的核心信息：
+- 项目概览（名称、版本、类型、描述）
+- 技术栈（语言、框架、构建工具、测试框架）
+- 项目结构（目录说明、入口文件）
+- 架构模式（设计模式、模块划分）
+- 编码规范（代码风格、命名规范）
+- 依赖管理（主要依赖列表）
+- 开发流程（常用命令）
+
+**第三步：生成 constitution.md**
+在 \`docs/constitution.md\` 中定义项目的核心原则：
+- 代码风格规范
+- 架构原则
+- 安全准则
+- 测试要求
+- 文档标准
+
+**第四步：生成 requirements.md（需求文档）**
+在 \`docs/specs/${featureSlug}/requirements.md\` 中详细描述：
+- 功能概述
+- 术语定义
+- 需求列表（使用 EARS 格式）
+  - 用户故事（As a... I want... So that...）
+  - 验收标准（WHEN/WHILE/IF...THEN...SHALL）
+- 非功能需求（性能、安全、兼容性）
+- 依赖关系
+
+**EARS 格式说明**：
+| 模式 | 格式 | 适用场景 |
+|------|------|----------|
+| Ubiquitous | THE [system] SHALL [response] | 始终适用的需求 |
+| Event-driven | WHEN [trigger], THE [system] SHALL [response] | 事件触发的需求 |
+| State-driven | WHILE [condition], THE [system] SHALL [response] | 状态相关的需求 |
+| Unwanted | IF [condition], THEN THE [system] SHALL [response] | 异常处理需求 |
+
+**第五步：生成 design.md（设计文档）**
+在 \`docs/specs/${featureSlug}/design.md\` 中描述：
+- 技术方案（技术选型及理由）
+- 架构设计（系统架构图）
+- 数据模型（数据结构定义）
+- API 设计（接口定义）
+- 文件结构（新增/修改的文件）
+- 设计决策（重要决策及理由）
+- 风险评估
+
+**第六步：生成 research.md（技术调研）**
+在 \`docs/specs/${featureSlug}/research.md\` 中记录：
+- 技术栈调研结果
+- 版本兼容性确认
+- 潜在风险识别
+- 最佳实践记录
+- 参考文档链接
+
+**第七步：生成 tasks.md（任务分解）**
+在 \`docs/specs/${featureSlug}/tasks.md\` 中分解任务：
+
+\`\`\`markdown
+# 任务清单：${projectName}
+
+## 概述
+实现 ${projectName} 的任务分解。
+
+---
+
+## 任务列表
+
+### 阶段 1: 项目初始化
+- [ ] 1.1 搭建项目骨架
+  - 创建目录结构
+  - 初始化 package.json
+  - _需求: 1.1_
+
+- [ ] 1.2 配置开发环境
+  - 配置 TypeScript/ESLint/Prettier
+  - _需求: 1.1_
+
+### 阶段 2: 核心功能实现
+- [ ] 2.1 实现数据模型
+  - 定义数据结构
+  - _需求: 2.1_
+
+- [ ] 2.2 实现业务逻辑
+  - 核心功能开发
+  - 依赖: 任务 2.1
+  - _需求: 2.2_
+
+### 阶段 3: 集成测试
+- [ ] 3.1 编写测试用例
+  - 单元测试
+  - 集成测试
+  - _需求: 3.1_
+
+---
+
+## 检查点
+- [ ] 阶段 1 完成后：项目可运行
+- [ ] 阶段 2 完成后：核心功能可用
+- [ ] 阶段 3 完成后：测试通过
+
+---
+
+## 文件变更清单
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| src/index.ts | 新建 | 入口文件 |
+| package.json | 新建 | 项目配置 |
+
+---
+
+**标记说明**：
+- [P]: 可以并行执行的任务
+- 依赖: 必须在指定任务完成后才能开始
+- _需求: x.x_: 关联的需求编号
+\`\`\`
+
+**第八步：生成辅助脚本**
+创建项目管理脚本：
+- \`scripts/check-prerequisites.sh\`: 检查环境依赖
+- \`scripts/setup.sh\`: 自动化项目初始化
+
+📝 **注意事项**：
+1. 所有文档统一放在 \`docs/\` 目录下
+2. 功能规格放在 \`docs/specs/{feature-name}/\` 目录
+3. 所有文件使用 Markdown 格式，保持清晰的结构
+4. 遵循项目 constitution 中定义的原则
+5. 任务分解要足够细致，每个任务应该在 2-4 小时内完成
+6. 标记清楚任务之间的依赖关系
+7. 识别可以并行执行的任务以优化开发效率
+
+🚀 **开始执行**：
 现在请按照上述步骤创建项目结构和所有必需的文档。`;
         // 创建结构化数据对象
         const structuredData = {

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_ui.js

@@ -10,13 +10,14 @@
 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 硬约束 + 黑名单 + 交付前自检 */
@@ -782,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 计划',
             });
@@ -1035,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',
             });
@@ -1238,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/update_memory_asset.d.ts

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