mcp-probe-kit 3.0.18 → 3.0.19

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

@@ -4,10 +4,11 @@ import path from 'node:path';
 import { describe, expect, test } from 'vitest';
 import { initProjectContext } from '../init_project_context.js';
 describe('init_project_context 单元测试', () => {
-    test('返回 delegated plan，并预置 code_insight 图谱初始化步骤', async () => {
+    test('返回 delegated plan，含 finalize-agents-md 与 AGENTS.md 模板', async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-init-'));
         const result = await initProjectContext({
             docs_dir: 'docs',
-            project_root: 'E:/workspace/github/mcp-probe-kit',
+            project_root: projectRoot,
         });
         expect(result.isError).toBeFalsy();
         expect('structuredContent' in result).toBe(true);
@@ -15,49 +16,59 @@ describe('init_project_context 单元测试', () => {
             throw new Error('structuredContent 缺失');
         }
         const structured = result.structuredContent;
+        expect(structured.documentation.some((item) => item.path === 'AGENTS.md')).toBe(true);
         expect(structured.documentation.some((item) => item.path === 'docs/graph-insights/latest.md')).toBe(true);
-        expect(structured.documentation.some((item) => item.path === 'docs/graph-insights/latest.json')).toBe(true);
-        expect(structured.metadata?.graphDocs?.latestMarkdownFilePath).toContain('/docs/graph-insights/latest.md');
+        expect(structured.metadata?.layout?.indexPath).toBe('AGENTS.md');
+        expect(structured.metadata?.agentsMdTemplate).toMatch(/mcp-probe:context begin/);
+        expect(structured.metadata?.manifestWritten).toBe('docs/.mcp-probe/layout.json');
+        expect(fs.existsSync(path.join(projectRoot, 'docs', '.mcp-probe', 'layout.json'))).toBe(true);
         const plan = structured.metadata?.plan;
         expect(plan?.mode).toBe('delegated');
         expect(plan.steps.map((step) => step.id)).toEqual([
-            'write-project-context',
+            'write-modular-docs',
             'bootstrap-code-insight',
             'persist-graph-docs',
+            'finalize-agents-md',
         ]);
-        expect(plan.steps[1].action).toMatch(/code_insight/);
+        expect(plan.steps[0].outputs).toContain('docs/project-context.md');
+        expect(plan.steps[3].id).toBe('finalize-agents-md');
     });
-    test('输出文本包含 graph-insights 入口和 delegated plan', async () => {
+    test('输出文本包含 AGENTS.md 与 MCP 触发规则', async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-init-'));
         const result = await initProjectContext({
-            docs_dir: 'docs',
-            project_root: 'E:/workspace/github/mcp-probe-kit',
+            project_root: projectRoot,
         });
         const text = result.content[0].text;
-        expect(text).toMatch(/graph-insights\/latest\.md/);
-        expect(text).toMatch(/delegated plan/);
-        expect(text).toMatch(/code_insight/);
+        expect(text).toMatch(/AGENTS\.md/);
+        expect(text).toMatch(/start_feature/);
+        expect(text).toMatch(/finalize-agents-md/);
     });
-    test('已存在 project-context.md 时不再规划重写上下文文档', async () => {
+    test('已存在 project-context 分类文档时跳过重写 modular', async () => {
         const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-context-'));
-        fs.mkdirSync(path.join(projectRoot, 'docs'), { recursive: true });
+        fs.mkdirSync(path.join(projectRoot, 'docs', 'project-context'), { recursive: true });
         fs.writeFileSync(path.join(projectRoot, 'docs', 'project-context.md'), '# existing context\n', 'utf8');
         const result = await initProjectContext({
             docs_dir: 'docs',
             project_root: projectRoot,
         });
         expect(result.isError).toBeFalsy();
-        expect('structuredContent' in result).toBe(true);
-        if (!('structuredContent' in result)) {
-            throw new Error('structuredContent 缺失');
-        }
         const structured = result.structuredContent;
-        expect(structured.metadata?.projectContextExists).toBe(true);
+        expect(structured.metadata?.legacyProjectContextExists).toBe(true);
         expect(structured.metadata?.plan?.steps.map((step) => step.id)).toEqual([
             'bootstrap-code-insight',
             'persist-graph-docs',
+            'finalize-agents-md',
         ]);
         const text = result.content[0].text;
-        expect(text).toMatch(/已存在（将保留，不覆盖）/);
-        expect(text).toMatch(/不要重写/);
+        expect(text).toMatch(/保留/);
+    });
+    test('已有 AGENTS.md 用户内容时 prepend merge', async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-agents-'));
+        fs.writeFileSync(path.join(projectRoot, 'AGENTS.md'), '# Custom rules\n', 'utf8');
+        const result = await initProjectContext({ project_root: projectRoot });
+        const structured = result.structuredContent;
+        expect(structured.metadata?.agentsMdMergeMode).toBe('prepended');
+        expect(structured.metadata?.agentsMdTemplate).toMatch(/<!-- mcp-probe:context begin/);
+        expect(structured.metadata?.agentsMdTemplate).toContain('# Custom rules');
     });
 });

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

@@ -25,12 +25,13 @@ describe('start_feature 单元测试', () => {
         expect(plan).toBeTruthy();
         expect(plan.mode).toBe('delegated');
         expect(Array.isArray(plan.steps)).toBe(true);
-        expect(plan.steps.length).toBe(3);
+        expect(plan.steps.length).toBeGreaterThanOrEqual(3);
         const tools = plan.steps.map((step) => step.tool);
         expect(tools).toContain('init_project_context');
         expect(tools).toContain('add_feature');
         expect(tools).toContain('estimate');
         const contextStep = plan.steps.find((step) => step.tool === 'init_project_context');
+        expect(contextStep.outputs).toContain('AGENTS.md');
         expect(contextStep.outputs).toContain('docs/graph-insights/latest.md');
         expect(contextStep.outputs).toContain('docs/graph-insights/latest.json');
         expect(contextStep.when).toMatch(/graph-insights\/latest\.md/);

package/build/tools/code_insight.js

@@ -5,7 +5,8 @@ import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { runCodeInsightBridge, } from "../lib/gitnexus-bridge.js";
 import { throwIfAborted, } from "../lib/tool-execution-context.js";
-import { isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
+import { isLikelyProjectNamedRelativePath, buildProjectRootRetryHint, resolveWorkspaceRoot } from "../lib/workspace-root.js";
+import { layoutAbsPath, parseLayoutArgsFromRecord, resolveProjectContextLayout, } from "../lib/project-context-layout.js";
 const ALLOWED_MODES = new Set(["auto", "query", "context", "impact"]);
 const ALLOWED_DIRECTIONS = new Set(["upstream", "downstream"]);
 const DEFAULT_AUTO_QUERY = "项目整体架构 核心流程 关键模块 依赖关系 入口点";
@@ -25,7 +26,7 @@ function buildProjectDocsOutputs(input) {
     if (!projectRoot) {
         return null;
     }
-    const docsRoot = path.join(path.resolve(projectRoot), input.docsDirName || "docs", "graph-insights");
+    const docsRoot = path.join(path.resolve(projectRoot), input.graphDir || "docs/graph-insights");
     const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
     const suffix = makeSafeSegment(input.structured.summary || input.mode);
     const baseName = `${timestamp}-${input.mode}-${suffix}`;
@@ -126,13 +127,13 @@ function formatAmbiguities(ambiguities) {
     })
         .join("\n");
 }
-function createProjectDocsPlan(projectRoot, docsDirName, docsSnapshot) {
-    const docsDir = path.dirname(docsSnapshot.markdownFilePath);
+function createProjectDocsPlan(layout, docsSnapshot) {
+    const docsDir = layout.contextRoot;
     return {
         docsDir,
-        projectContextFilePath: toPosixPath(path.join(path.resolve(projectRoot), docsDirName, "project-context.md")),
-        latestMarkdownFilePath: toPosixPath(path.join(docsDir, "latest.md")),
-        latestJsonFilePath: toPosixPath(path.join(docsDir, "latest.json")),
+        projectContextFilePath: toPosixPath(layoutAbsPath(layout, layout.indexPath)),
+        latestMarkdownFilePath: layout.latestMarkdownPath,
+        latestJsonFilePath: layout.latestJsonPath,
         archiveMarkdownFilePath: docsSnapshot.markdownFilePath,
         archiveJsonFilePath: docsSnapshot.jsonFilePath,
         navigationSnippet: `### [代码图谱洞察](./graph-insights/latest.md)
@@ -264,6 +265,7 @@ export async function codeInsight(args, context) {
             };
         }
         const docsDirName = getString(parsedArgs.docs_dir) || "docs";
+        const layout = resolveProjectContextLayout(projectRoot ? resolveWorkspaceRoot(projectRoot) : resolveWorkspaceRoot(), parseLayoutArgsFromRecord({ docs_dir: docsDirName }));
         const goal = getString(parsedArgs.goal);
         const taskContext = getString(parsedArgs.task_context);
         const direction = normalizeDirection(getString(parsedArgs.direction));
@@ -344,12 +346,12 @@ ${result.warnings.length > 0 ? `警告: ${result.warnings.join(", ")}` : ""}`.tr
         const docsProjectRoot = saveToDocs ? (projectRoot || result.sourceRoot) : "";
         const docsSnapshot = buildProjectDocsOutputs({
             projectRoot: docsProjectRoot,
-            docsDirName,
+            graphDir: layout.graphDir,
             mode,
             structured,
         });
         const projectDocs = docsSnapshot
-            ? createProjectDocsPlan(docsProjectRoot, docsDirName, docsSnapshot)
+            ? createProjectDocsPlan(layout, docsSnapshot)
             : undefined;
         if (projectDocs) {
             structured.projectDocs = projectDocs;