mcp-probe-kit 3.0.16 → 3.0.18

package/build/tools/start_bugfix.js

@@ -6,6 +6,8 @@ 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 { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 function decideTemplateProfile(description) {
     const text = description || '';
     const lengthScore = text.length >= 200 ? 2 : text.length >= 120 ? 1 : 0;
@@ -44,7 +46,7 @@ function resolveTemplateProfile(rawProfile, description) {
         warning: `模板档位 "${rawProfile}" 不支持，已回退为 ${fallback}`,
     };
 }
-const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因分析）
+const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因分析）
 
 ## 🎯 目标
 
@@ -59,21 +61,21 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因
 
 ---
 
-## 📋 步骤 0: 项目上下文与取证基线（自动处理）
+## 📋 步骤 0: 项目上下文与取证基线（自动处理）
 
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. 检查 \`docs/graph-insights/latest.md\` 和 \`docs/graph-insights/latest.json\` 是否存在
-3. **如果任一缺失**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-4. **读取** \`docs/project-context.md\` 与图谱文档
-5. 了解项目的技术栈、架构、测试框架和调用链
-6. 后续步骤参考此上下文
+**操作**:
+1. 检查 \`docs/project-context.md\` 是否存在
+2. 检查 \`docs/graph-insights/latest.md\` 和 \`docs/graph-insights/latest.json\` 是否存在
+3. **如果任一缺失**：
+   - 调用 \`init_project_context\` 工具
+   - 等待生成完成
+4. **读取** \`docs/project-context.md\` 与图谱文档
+5. 了解项目的技术栈、架构、测试框架和调用链
+6. 后续步骤参考此上下文
 
 ---
 
-## 🔍 步骤 1: 先做 TBP 1-7，再决定修复
+## 🔍 步骤 1: 先做 TBP 1-7，再决定修复
 
 **调用工具**: \`fix_bug\`
 
@@ -85,15 +87,15 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因
 }
 \`\`\`
 
-**执行要点**:
-1. 先定义现象，不能泛化
-2. 复盘时间线，尽量带时间/步骤/状态
-3. 明确排除错误方向，并说明为什么不是
-4. 对比成功/失败样本，找分叉点
-5. 定位问题边界（模型 / 状态机 / 工具 / 文件 / 环境）
-6. 用因果句陈述真因：A + B 在条件 D 下导致 C
-7. 闭合证据链后，才进入修复设计
-8. 修复必须说明风险与验证方式
+**执行要点**:
+1. 先定义现象，不能泛化
+2. 复盘时间线，尽量带时间/步骤/状态
+3. 明确排除错误方向，并说明为什么不是
+4. 对比成功/失败样本，找分叉点
+5. 定位问题边界（模型 / 状态机 / 工具 / 文件 / 环境）
+6. 用因果句陈述真因：A + B 在条件 D 下导致 C
+7. 闭合证据链后，才进入修复设计
+8. 修复必须说明风险与验证方式
 
 **产出**: 修复后的代码
 
@@ -123,8 +125,8 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因
 ## ✅ 完成检查
 
 - [ ] 项目上下文已读取
-- [ ] TBP-1~TBP-7 已闭合
-- [ ] 真因已写成因果句
+- [ ] TBP-1~TBP-7 已闭合
+- [ ] 真因已写成因果句
 - [ ] 代码已修复
 - [ ] 测试已添加
 - [ ] 测试已通过
@@ -135,20 +137,20 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南（TBP 8 步真因
 
 完成后，向用户汇总：
 
-1. **TBP 现象**: [精确定义的问题]
-2. **TBP 时间线**: [关键事件顺序]
-3. **已排除方向**: [不是哪些原因]
-4. **问题边界**: [失控发生在哪一层]
-5. **Bug 真因**: [根本原因]
-6. **修复方案**: [修复说明]
-7. **修改文件**: [文件列表]
-8. **测试覆盖**: [测试情况]
+1. **TBP 现象**: [精确定义的问题]
+2. **TBP 时间线**: [关键事件顺序]
+3. **已排除方向**: [不是哪些原因]
+4. **问题边界**: [失控发生在哪一层]
+5. **Bug 真因**: [根本原因]
+6. **修复方案**: [修复说明]
+7. **修改文件**: [文件列表]
+8. **测试覆盖**: [测试情况]
 
 ---
 
 *编排工具: MCP Probe Kit - start_bugfix*
 `;
-const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | TBP 8 步）
+const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | TBP 8 步）
 
 ## 🎯 目标
 修复 Bug：{error_message}
@@ -159,15 +161,15 @@ const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | TBP 8 步）
 
 ## ✅ 执行计划（按顺序）
 
-1) 检查 \`docs/project-context.md\` 与 \`docs/graph-insights/latest.*\`，任一缺失则调用 \`init_project_context\`
-2) 调用 \`fix_bug\`
+1) 检查 \`docs/project-context.md\` 与 \`docs/graph-insights/latest.*\`，任一缺失则调用 \`init_project_context\`
+2) 调用 \`fix_bug\`
 \`\`\`json
-{
-  "error_message": "{error_message}",
-  "stack_trace": "{stack_trace}",
-  "analysis_mode": "{analysis_mode}"
-}
-\`\`\`
+{
+  "error_message": "{error_message}",
+  "stack_trace": "{stack_trace}",
+  "analysis_mode": "{analysis_mode}"
+}
+\`\`\`
 3) 调用 \`gentest\`
 \`\`\`json
 {
@@ -179,22 +181,22 @@ const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格 | TBP 8 步）
 ---
 
 ## ✅ 输出汇总
-1. TBP 现象
-2. TBP 时间线
-3. 已排除方向
-4. 问题边界
-5. Bug 真因
-6. 修复方案
-7. 修改文件
-8. 测试覆盖
+1. TBP 现象
+2. TBP 时间线
+3. 已排除方向
+4. 问题边界
+5. Bug 真因
+6. 修复方案
+7. 修改文件
+8. 测试覆盖
 
 ---
 
 *编排工具: MCP Probe Kit - start_bugfix*
 `;
-const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（TBP RCA Loop）
+const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（TBP RCA Loop）
 
-本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 TBP 8 步真因分析所需证据。
+本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 TBP 8 步真因分析所需证据。
 
 ## 🎯 目标
 修复 Bug：{error_message}
@@ -210,7 +212,7 @@ const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（TBP RCA
 ## 🔁 执行步骤（每轮）
 
 ### 1) 生成待确认问题
-使用 \`ask_user\` 提问，问题来源于 TBP 清单（现象/时间线/对比样本/边界/验证）。
+使用 \`ask_user\` 提问，问题来源于 TBP 清单（现象/时间线/对比样本/边界/验证）。
 
 **调用示例**:
 \`\`\`json
@@ -229,20 +231,20 @@ const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（TBP RCA
 - Assumption：无法确认但补全（需确认）
 
 ### 3) 自检与结束
-若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入 TBP-6/7/8 修复流程。
+若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入 TBP-6/7/8 修复流程。
 
 ---
 
 ## ✅ 结束后继续
 当满足结束条件时，执行：
-1. 调用 \`fix_bug\` 完成 TBP 8 步分析与修复方案
+1. 调用 \`fix_bug\` 完成 TBP 8 步分析与修复方案
 2. 调用 \`gentest\` 生成回归测试
 
 ---
 
 *编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
-const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（TBP RCA Loop | 严格）
+const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（TBP RCA Loop | 严格）
 
 本模式用于稳健补全关键信息，不改变用户意图。
 
@@ -317,6 +319,20 @@ export async function startBugfix(args, context) {
         const stackTrace = getString(parsedArgs.stack_trace);
         const codeContext = getString(parsedArgs.code_context);
         const projectRoot = getString(parsedArgs.project_root);
+        if (isLikelyProjectNamedRelativePath(projectRoot)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `拒绝执行 bugfix 编排：project_root 不能传带项目名的半相对路径，例如 ${projectRoot}。请改为传项目根目录绝对路径。`,
+                    }],
+                isError: true,
+                structuredContent: {
+                    error_code: "INVALID_PROJECT_ROOT",
+                    rejected_project_root: projectRoot,
+                    retry_hint: buildProjectRootRetryHint(projectRoot),
+                },
+            };
+        }
         const analysisMode = ((getString(parsedArgs.analysis_mode) || "tbp8").toLowerCase() === "tbp8"
             ? "tbp8"
             : "tbp8");
@@ -359,7 +375,7 @@ export async function startBugfix(args, context) {
             latestMarkdownPath: "docs/graph-insights/latest.md",
             latestJsonPath: "docs/graph-insights/latest.json",
         };
-        const resolvedProjectRoot = path.resolve(projectRoot || process.cwd());
+        const resolvedProjectRoot = resolveWorkspaceRoot(projectRoot);
         const bootstrapState = {
             projectContextExists: fs.existsSync(path.join(resolvedProjectRoot, "docs", "project-context.md")),
             latestMarkdownExists: fs.existsSync(path.join(resolvedProjectRoot, "docs", "graph-insights", "latest.md")),
@@ -388,19 +404,21 @@ export async function startBugfix(args, context) {
         ]
             .filter(Boolean)
             .join("\n\n");
-        const graphGuideSection = `
-
-## 🧠 代码图谱上下文
-- 基线入口: ${graphDocs.latestMarkdownPath}
-- 基线结构化副本: ${graphDocs.latestJsonPath}
-- 基线状态: ${graphDocsMissing ? "缺失（需要补初始化）" : "可用"}
-- 任务级收敛: ${graphContext.available ? "可用" : "降级"}
-- 任务级摘要: ${graphContext.summary}
+        const graphGuideSection = `
+
+## 🧠 代码图谱上下文
+- 基线入口: ${graphDocs.latestMarkdownPath}
+- 基线结构化副本: ${graphDocs.latestJsonPath}
+- 基线状态: ${graphDocsMissing ? "缺失（需要补初始化）" : "可用"}
+- 任务级收敛: ${graphContext.available ? "可用" : "降级"}
+- 任务级摘要: ${graphContext.summary}
 ${graphContext.highlights.length > 0
             ? `- 任务级线索:\n${graphContext.highlights.slice(0, 3).map((item) => `  - ${item}`).join("\n")}`
-            : "- 任务级线索: 无"}
-- 使用方式: 先读取基线图谱，再用本次任务图谱做 TBP-4 / TBP-5 / TBP-6 的边界与真因收敛
+            : "- 任务级线索: 无"}
+- 使用方式: 先读取基线图谱，再用本次任务图谱做 TBP-4 / TBP-5 / TBP-6 的边界与真因收敛
 `;
+        const memoryContext = await loadMemoryInjectionContext([errorMessage, stackTrace, codeContext].filter(Boolean).join("\n"));
+        const memoryGuideSection = renderMemoryGuideSection(memoryContext);
         if (requirementsMode === "loop") {
             throwIfAborted(context?.signal, "start_bugfix(loop) 已取消");
             await reportToolProgress(context, 70, "start_bugfix: 生成 loop 计划");
@@ -476,6 +494,7 @@ ${graphContext.highlights.length > 0
                         },
                         outputs: [],
                     },
+                    ...(memoryContext.enabled ? [buildMemoryPlanStep()] : []),
                 ],
             };
             const header = renderOrchestrationHeader({
@@ -485,7 +504,10 @@ ${graphContext.highlights.length > 0
                     '按 Requirements Loop 规则提问并更新结构化输出',
                     '满足结束条件后按 delegated plan 执行修复与测试',
                 ],
-                notes: headerNotes,
+                notes: [
+                    ...headerNotes,
+                    ...(memoryContext.enabled ? ['记忆系统: 已启用，优先复用历史修复经验并在结束后评估沉淀'] : []),
+                ],
             });
             const loopTemplate = profileDecision.resolved === 'strict'
                 ? LOOP_PROMPT_TEMPLATE_STRICT
@@ -495,7 +517,8 @@ ${graphContext.highlights.length > 0
                 .replace(/{analysis_mode}/g, analysisMode)
                 .replace(/{question_budget}/g, String(questionBudget))
                 .replace(/{assumption_cap}/g, String(assumptionCap)))
-                + graphGuideSection;
+                + graphGuideSection
+                + memoryGuideSection;
             const loopReport = {
                 mode: 'loop',
                 round: 1,
@@ -546,7 +569,10 @@ ${graphContext.highlights.length > 0
                 '按 delegated plan 顺序调用工具',
                 '完成修复并生成回归测试',
             ],
-            notes: headerNotes,
+            notes: [
+                ...headerNotes,
+                ...(memoryContext.enabled ? ['记忆系统: 已启用，必要时先读取相似历史资产'] : []),
+            ],
         });
         const promptTemplate = profileDecision.resolved === 'strict'
             ? PROMPT_TEMPLATE_STRICT
@@ -556,7 +582,8 @@ ${graphContext.highlights.length > 0
             .replace(/{stack_trace}/g, stackTrace)
             .replace(/{analysis_mode}/g, analysisMode)
             .replace(/{stack_trace_section}/g, stackTraceSection))
-            + graphGuideSection;
+            + graphGuideSection
+            + memoryGuideSection;
         const plan = {
             mode: 'delegated',
             steps: [
@@ -591,6 +618,7 @@ ${graphContext.highlights.length > 0
                     },
                     outputs: [],
                 },
+                ...(memoryContext.enabled ? [buildMemoryPlanStep()] : []),
             ],
         };
         // 创建结构化的 Bug 修复报告

package/build/tools/start_feature.d.ts

@@ -5,4 +5,24 @@ export declare function startFeature(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;
 }>;

package/build/tools/start_feature.js

@@ -6,6 +6,8 @@ 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 { resolveWorkspaceRoot, toWorkspacePath, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 /**
  * start_feature 智能编排工具
  *
@@ -64,15 +66,15 @@ const PROMPT_TEMPLATE = `# 🚀 新功能开发编排（委托式）
 
 ## ✅ 执行计划（按顺序）
 
-### 0) 项目上下文（如缺失）
-**检查**:
-- \`{docs_dir}/project-context.md\`
-- \`{docs_dir}/graph-insights/latest.md\`
-- \`{docs_dir}/graph-insights/latest.json\`
-**缺失则调用**: \`init_project_context\`
-\`\`\`json
-{ "docs_dir": "{docs_dir}", "project_root": "{project_root}" }
-\`\`\`
+### 0) 项目上下文（如缺失）
+**检查**:
+- \`{docs_dir}/project-context.md\`
+- \`{docs_dir}/graph-insights/latest.md\`
+- \`{docs_dir}/graph-insights/latest.json\`
+**缺失则调用**: \`init_project_context\`
+\`\`\`json
+{ "docs_dir": "{docs_dir}", "project_root": "{project_root}" }
+\`\`\`
 
 ### 1) 生成功能规格
 **调用**: \`add_feature\`
@@ -100,12 +102,12 @@ const PROMPT_TEMPLATE = `# 🚀 新功能开发编排（委托式）
 
 ---
 
-## ✅ 输出汇总（执行完成后）
-1. 规格文档位置: \`{docs_dir}/specs/{feature_name}/\`
-2. 图谱入口: \`{docs_dir}/graph-insights/latest.md\`
-3. 估算结果: 故事点 + 时间区间
-4. 主要风险（如有）
-5. 下一步: 按 tasks.md 开始开发
+## ✅ 输出汇总（执行完成后）
+1. 规格文档位置: \`{docs_dir}/specs/{feature_name}/\`
+2. 图谱入口: \`{docs_dir}/graph-insights/latest.md\`
+3. 估算结果: 故事点 + 时间区间
+4. 主要风险（如有）
+5. 下一步: 按 tasks.md 开始开发
 
 ---
 
@@ -204,6 +206,20 @@ export async function startFeature(args, context) {
         let description = getString(parsedArgs.description);
         const docsDir = getString(parsedArgs.docs_dir) || "docs";
         const projectRoot = getString(parsedArgs.project_root);
+        if (isLikelyProjectNamedRelativePath(projectRoot)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `拒绝执行 feature 编排：project_root 不能传带项目名的半相对路径，例如 ${projectRoot}。请改为传项目根目录绝对路径。`,
+                    }],
+                isError: true,
+                structuredContent: {
+                    error_code: "INVALID_PROJECT_ROOT",
+                    rejected_project_root: projectRoot,
+                    retry_hint: buildProjectRootRetryHint(projectRoot),
+                },
+            };
+        }
         const templateProfile = getString(parsedArgs.template_profile) || "auto";
         const requirementsMode = getString(parsedArgs.requirements_mode) || "steady";
         const maxRounds = getNumber(parsedArgs.loop_max_rounds, 2);
@@ -240,7 +256,7 @@ export async function startFeature(args, context) {
             latestMarkdownPath: `${docsDir}/graph-insights/latest.md`,
             latestJsonPath: `${docsDir}/graph-insights/latest.json`,
         };
-        const resolvedProjectRoot = path.resolve(projectRoot || process.cwd());
+        const resolvedProjectRoot = resolveWorkspaceRoot(projectRoot);
         const bootstrapState = {
             projectContextExists: fs.existsSync(path.join(resolvedProjectRoot, docsDir, "project-context.md")),
             latestMarkdownExists: fs.existsSync(path.join(resolvedProjectRoot, docsDir, "graph-insights", "latest.md")),
@@ -256,18 +272,18 @@ export async function startFeature(args, context) {
         const graphStatusNote = graphContext.available
             ? `任务图谱收敛: 可用（${graphContext.mode}）`
             : "任务图谱收敛: 已降级（自动回退）";
-        const graphGuideSection = `
-
-## 🧠 代码图谱上下文
-- 基线入口: ${graphDocs.latestMarkdownPath}
-- 基线结构化副本: ${graphDocs.latestJsonPath}
-- 基线状态: ${graphDocsMissing ? "缺失（需要补初始化）" : "可用"}
-- 任务级收敛: ${graphContext.available ? "可用" : "降级"}
-- 任务级摘要: ${graphContext.summary}
+        const graphGuideSection = `
+
+## 🧠 代码图谱上下文
+- 基线入口: ${graphDocs.latestMarkdownPath}
+- 基线结构化副本: ${graphDocs.latestJsonPath}
+- 基线状态: ${graphDocsMissing ? "缺失（需要补初始化）" : "可用"}
+- 任务级收敛: ${graphContext.available ? "可用" : "降级"}
+- 任务级摘要: ${graphContext.summary}
 ${graphContext.highlights.length > 0
             ? `- 任务级线索:\n${graphContext.highlights.slice(0, 3).map((item) => `  - ${item}`).join("\n")}`
-            : "- 任务级线索: 无"}
-- 使用方式: 先参考基线图谱，再使用本次任务图谱线索约束模块边界和改动范围
+            : "- 任务级线索: 无"}
+- 使用方式: 先参考基线图谱，再使用本次任务图谱线索约束模块边界和改动范围
 `;
         const estimateCodeContext = [
             `参考生成的 ${docsDir}/specs/${featureName}/tasks.md`,
@@ -281,6 +297,8 @@ ${graphContext.highlights.length > 0
         ]
             .filter(Boolean)
             .join("\n");
+        const memoryContext = await loadMemoryInjectionContext(`${featureName}\n${description}`);
+        const memoryGuideSection = renderMemoryGuideSection(memoryContext);
         if (requirementsMode === "loop") {
             throwIfAborted(context?.signal, "start_feature(loop) 已取消");
             await reportToolProgress(context, 70, "start_feature: 生成 loop 计划");
@@ -355,6 +373,7 @@ ${graphContext.highlights.length > 0
                         },
                         outputs: [],
                     },
+                    ...(memoryContext.enabled ? [buildMemoryPlanStep()] : []),
                 ],
             };
             const header = renderOrchestrationHeader({
@@ -364,15 +383,20 @@ ${graphContext.highlights.length > 0
                     '按 Requirements Loop 规则提问并更新结构化输出',
                     '满足结束条件后生成规格并完成估算',
                 ],
-                notes: [`模板档位: ${templateProfile}`, graphStatusNote],
+                notes: [
+                    `模板档位: ${templateProfile}`,
+                    graphStatusNote,
+                    ...(memoryContext.enabled ? ['记忆系统: 已启用，按需读取历史资产并在结束后评估是否沉淀'] : []),
+                ],
             });
             const guide = (header + LOOP_PROMPT_TEMPLATE
                 .replace(/{feature_name}/g, featureName)
                 .replace(/{description}/g, description)
-                .replace(/{project_root}/g, (projectRoot || process.cwd()).replace(/\\/g, "/"))
+                .replace(/{project_root}/g, toWorkspacePath(projectRoot))
                 .replace(/{question_budget}/g, String(questionBudget))
                 .replace(/{assumption_cap}/g, String(assumptionCap)))
-                + graphGuideSection;
+                + graphGuideSection
+                + memoryGuideSection;
             const loopReport = {
                 mode: 'loop',
                 round: 1,
@@ -419,7 +443,11 @@ ${graphContext.highlights.length > 0
                 '按 delegated plan 顺序调用工具',
                 '生成规格文档并完成工作量估算',
             ],
-            notes: [`模板档位: ${templateProfile}`, graphStatusNote],
+            notes: [
+                `模板档位: ${templateProfile}`,
+                graphStatusNote,
+                ...(memoryContext.enabled ? ['记忆系统: 已启用，先复用摘要资产，必要时读取详情'] : []),
+            ],
         });
         const guide = (header + PROMPT_TEMPLATE
             .replace(/{feature_name}/g, featureName)
@@ -427,7 +455,8 @@ ${graphContext.highlights.length > 0
             .replace(/{docs_dir}/g, docsDir)
             .replace(/{project_root}/g, (projectRoot || process.cwd()).replace(/\\/g, "/"))
             .replace(/{template_profile}/g, templateProfile))
-            + graphGuideSection;
+            + graphGuideSection
+            + memoryGuideSection;
         const plan = {
             mode: 'delegated',
             steps: [
@@ -461,6 +490,7 @@ ${graphContext.highlights.length > 0
                     },
                     outputs: [],
                 },
+                ...(memoryContext.enabled ? [buildMemoryPlanStep()] : []),
             ],
         };
         // 创建结构化的功能开发报告

package/build/tools/start_onboard.d.ts

@@ -5,4 +5,24 @@ export declare function startOnboard(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;
 }>;

package/build/tools/start_onboard.js

@@ -3,6 +3,7 @@ import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { OnboardingReportSchema } from "../schemas/structured-output.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
+import { isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 /**
  * start_onboard 智能编排工具
  *
@@ -111,6 +112,20 @@ export async function startOnboard(args, context) {
         });
         const projectPath = getString(parsedArgs.project_path) || ".";
         const docsDir = getString(parsedArgs.docs_dir) || "docs";
+        if (isLikelyProjectNamedRelativePath(projectPath)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `拒绝执行项目上手编排：project_path 不能传带项目名的半相对路径，例如 ${projectPath}。请改为传项目根目录绝对路径。`,
+                    }],
+                isError: true,
+                structuredContent: {
+                    error_code: "INVALID_PROJECT_ROOT",
+                    rejected_project_root: projectPath,
+                    retry_hint: buildProjectRootRetryHint(projectPath),
+                },
+            };
+        }
         throwIfAborted(context?.signal, "start_onboard 已取消");
         await reportToolProgress(context, 85, "start_onboard: 生成执行计划");
         const header = renderOrchestrationHeader({

package/build/tools/start_ui.d.ts

@@ -17,4 +17,24 @@ export declare function startUi(args: any, context?: ToolExecutionContext): Prom
         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;
 }>;