@mandujs/mcp 0.12.2 → 0.16.0

package/src/index.ts

@@ -1,106 +1,106 @@
-#!/usr/bin/env bun
-
-/**
- * @mandujs/mcp - MCP Server for Mandu Framework
- *
- * DNA 기능 통합:
- * - DNA-001: 플러그인 기반 도구 등록
- * - DNA-006: 설정 핫 리로드
- * - DNA-007: 에러 추출 및 분류
- * - DNA-008: 구조화된 로깅
- * - DNA-016: Pre/Post 도구 훅
- */
-
-// Main exports
-export { ManduMcpServer, startServer } from "./server.js";
-
-// Registry exports (DNA-001)
-export {
-  McpToolRegistry,
-  mcpToolRegistry,
-  type ToolRegistration,
-  type RegistryEvent,
-  type RegistryDump,
-} from "./registry/index.js";
-
-// Adapter exports
-export {
-  toolToPlugin,
-  pluginToTool,
-  moduleToPlugins,
-  pluginsToTools,
-  pluginsToHandlers,
-  monitorEventToRecord,
-  recordToMonitorEvent,
-} from "./adapters/index.js";
-
-// Executor exports (DNA-007)
-export {
-  formatMcpError,
-  createToolResponse,
-  isErrorResponse,
-  extractErrorFromResponse,
-  logToolError,
-  ToolExecutor,
-  createToolExecutor,
-  type McpErrorResponse,
-  type McpToolResponse,
-  type ToolExecutorOptions,
-  type ExecutionResult,
-} from "./executor/index.js";
-
-// Hook exports (DNA-016)
-export {
-  mcpHookRegistry,
-  registerDefaultMcpHooks,
-  slowToolLoggingHook,
-  statsCollectorHook,
-  getToolStats,
-  resetToolStats,
-  createArgValidationHook,
-  startMcpConfigWatcher,
-  type McpToolContext,
-  type McpPreToolHook,
-  type McpPostToolHook,
-  type McpConfigWatcherOptions,
-} from "./hooks/index.js";
-
-// Logging exports (DNA-008)
-export {
-  createMcpActivityTransport,
-  setupMcpLogging,
-  teardownMcpLogging,
-  dispatchMonitorEvent,
-  createMcpLogRecord,
-  MCP_TRANSPORT_ID,
-  type McpTransportOptions,
-} from "./logging/index.js";
-
-// Tools exports
-export {
-  registerBuiltinTools,
-  getToolCounts,
-  getToolsSummary,
-} from "./tools/index.js";
-
-// CLI entry point
-import { startServer } from "./server.js";
-import path from "path";
-
-// Start server if run directly
-if (import.meta.main) {
-  const args = process.argv.slice(2);
-  const globalMode = args.includes("--global");
-  const rootIndex = args.indexOf("--root");
-  const rootArg = rootIndex >= 0 ? args[rootIndex + 1] : undefined;
-  const projectRoot = rootArg
-    ? path.resolve(rootArg)
-    : globalMode
-      ? process.cwd()
-      : undefined;
-
-  startServer(projectRoot).catch((error) => {
-    console.error("Failed to start Mandu MCP server:", error);
-    process.exit(1);
-  });
-}
+#!/usr/bin/env bun
+
+/**
+ * @mandujs/mcp - MCP Server for Mandu Framework
+ *
+ * DNA 기능 통합:
+ * - DNA-001: 플러그인 기반 도구 등록
+ * - DNA-006: 설정 핫 리로드
+ * - DNA-007: 에러 추출 및 분류
+ * - DNA-008: 구조화된 로깅
+ * - DNA-016: Pre/Post 도구 훅
+ */
+
+// Main exports
+export { ManduMcpServer, startServer } from "./server.js";
+
+// Registry exports (DNA-001)
+export {
+  McpToolRegistry,
+  mcpToolRegistry,
+  type ToolRegistration,
+  type RegistryEvent,
+  type RegistryDump,
+} from "./registry/index.js";
+
+// Adapter exports
+export {
+  toolToPlugin,
+  pluginToTool,
+  moduleToPlugins,
+  pluginsToTools,
+  pluginsToHandlers,
+  monitorEventToRecord,
+  recordToMonitorEvent,
+} from "./adapters/index.js";
+
+// Executor exports (DNA-007)
+export {
+  formatMcpError,
+  createToolResponse,
+  isErrorResponse,
+  extractErrorFromResponse,
+  logToolError,
+  ToolExecutor,
+  createToolExecutor,
+  type McpErrorResponse,
+  type McpToolResponse,
+  type ToolExecutorOptions,
+  type ExecutionResult,
+} from "./executor/index.js";
+
+// Hook exports (DNA-016)
+export {
+  mcpHookRegistry,
+  registerDefaultMcpHooks,
+  slowToolLoggingHook,
+  statsCollectorHook,
+  getToolStats,
+  resetToolStats,
+  createArgValidationHook,
+  startMcpConfigWatcher,
+  type McpToolContext,
+  type McpPreToolHook,
+  type McpPostToolHook,
+  type McpConfigWatcherOptions,
+} from "./hooks/index.js";
+
+// Logging exports (DNA-008)
+export {
+  createMcpActivityTransport,
+  setupMcpLogging,
+  teardownMcpLogging,
+  dispatchMonitorEvent,
+  createMcpLogRecord,
+  MCP_TRANSPORT_ID,
+  type McpTransportOptions,
+} from "./logging/index.js";
+
+// Tools exports
+export {
+  registerBuiltinTools,
+  getToolCounts,
+  getToolsSummary,
+} from "./tools/index.js";
+
+// CLI entry point
+import { startServer } from "./server.js";
+import path from "path";
+
+// Start server if run directly
+if (import.meta.main) {
+  const args = process.argv.slice(2);
+  const globalMode = args.includes("--global");
+  const rootIndex = args.indexOf("--root");
+  const rootArg = rootIndex >= 0 ? args[rootIndex + 1] : undefined;
+  const projectRoot = rootArg
+    ? path.resolve(rootArg)
+    : globalMode
+      ? process.cwd()
+      : undefined;
+
+  startServer(projectRoot).catch((error) => {
+    console.error("Failed to start Mandu MCP server:", error);
+    process.exit(1);
+  });
+}

package/src/tools/ate.ts

@@ -0,0 +1,129 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ateExtract, ateGenerate, ateRun, ateReport, ateHeal, ateImpact } from "@mandujs/ate";
+
+export const ateToolDefinitions: Tool[] = [
+  {
+    name: "mandu.ate.extract",
+    description: "ATE: AST 기반 상호작용 그래프 추출",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        tsconfigPath: { type: "string" },
+        routeGlobs: { type: "array", items: { type: "string" } },
+        buildSalt: { type: "string" },
+      },
+      required: ["repoRoot"],
+    },
+  },
+  {
+    name: "mandu.ate.generate",
+    description: "ATE: 시나리오 생성 + Playwright spec codegen",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        oracleLevel: { type: "string", enum: ["L0", "L1", "L2", "L3"] },
+        onlyRoutes: { type: "array", items: { type: "string" } },
+      },
+      required: ["repoRoot"],
+    },
+  },
+  {
+    name: "mandu.ate.run",
+    description: "ATE: Playwright runner 실행(artifacts 수집)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        baseURL: { type: "string" },
+        ci: { type: "boolean" },
+        headless: { type: "boolean" },
+        browsers: { type: "array", items: { type: "string", enum: ["chromium", "firefox", "webkit"] } },
+      },
+      required: ["repoRoot"],
+    },
+  },
+  {
+    name: "mandu.ate.report",
+    description: "ATE: summary.json 생성",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        runId: { type: "string" },
+        startedAt: { type: "string" },
+        finishedAt: { type: "string" },
+        exitCode: { type: "number" },
+        oracleLevel: { type: "string", enum: ["L0", "L1", "L2", "L3"] },
+        impact: {
+          type: "object",
+          properties: {
+            mode: { type: "string", enum: ["full", "subset"] },
+            changedFiles: { type: "array", items: { type: "string" } },
+            selectedRoutes: { type: "array", items: { type: "string" } },
+          },
+          required: ["mode", "changedFiles", "selectedRoutes"],
+        },
+      },
+      required: ["repoRoot", "runId", "startedAt", "finishedAt", "exitCode"],
+    },
+  },
+  {
+    name: "mandu.ate.heal",
+    description: "ATE: 실패 원인 분류 + 복구 제안(diff) 생성 (자동 커밋 금지)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        runId: { type: "string" },
+      },
+      required: ["repoRoot", "runId"],
+    },
+  },
+  {
+    name: "mandu.ate.impact",
+    description: "ATE: git diff 기반 subset 계산",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        base: { type: "string" },
+        head: { type: "string" },
+      },
+      required: ["repoRoot"],
+    },
+  },
+];
+
+export function ateTools(projectRoot: string) {
+  return {
+    "mandu.ate.extract": async (args: Record<string, unknown>) => {
+      return await ateExtract(args as any);
+    },
+    "mandu.ate.generate": async (args: Record<string, unknown>) => {
+      return ateGenerate(args as any);
+    },
+    "mandu.ate.run": async (args: Record<string, unknown>) => {
+      return await ateRun(args as any);
+    },
+    "mandu.ate.report": async (args: Record<string, unknown>) => {
+      const input = args as any;
+      return await ateReport({
+        repoRoot: input.repoRoot,
+        runId: input.runId,
+        startedAt: input.startedAt,
+        finishedAt: input.finishedAt,
+        exitCode: input.exitCode,
+        oracleLevel: input.oracleLevel ?? "L1",
+        impact: input.impact,
+      });
+    },
+    "mandu.ate.heal": async (args: Record<string, unknown>) => {
+      return ateHeal(args as any);
+    },
+    "mandu.ate.impact": async (args: Record<string, unknown>) => {
+      return ateImpact(args as any);
+    },
+  };
+}

package/src/tools/generate.ts

@@ -1,5 +1,5 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { loadManifest, generateRoutes, type GeneratedMap } from "@mandujs/core";
+import { loadManifest, generateRoutes, generateManifest, GENERATED_RELATIVE_PATHS, type GeneratedMap } from "@mandujs/core";
 import { getProjectPaths, readJsonFile } from "../utils/project.js";
 
 export const generateToolDefinitions: Tool[] = [
@@ -36,7 +36,10 @@ export function generateTools(projectRoot: string) {
     mandu_generate: async (args: Record<string, unknown>) => {
       const { dryRun } = args as { dryRun?: boolean };
 
-      // Load manifest
+      // Regenerate manifest from FS Routes first
+      const fsResult = await generateManifest(projectRoot);
+
+      // Load the freshly generated manifest
       const manifestResult = await loadManifest(paths.manifestPath);
       if (!manifestResult.success || !manifestResult.data) {
         return { error: manifestResult.errors };
@@ -50,11 +53,11 @@ export function generateTools(projectRoot: string) {
 
         for (const route of routes) {
           // Server handler
-          wouldCreate.push(`apps/server/generated/routes/${route.id}.route.ts`);
+          wouldCreate.push(`${GENERATED_RELATIVE_PATHS.serverRoutes}/${route.id}.route.ts`);
 
           // Page component (for page kind)
           if (route.kind === "page") {
-            wouldCreate.push(`apps/web/generated/routes/${route.id}.route.tsx`);
+            wouldCreate.push(`${GENERATED_RELATIVE_PATHS.webRoutes}/${route.id}.route.tsx`);
           }
 
           // Slot file (only if not exists)

package/src/tools/guard.ts

@@ -303,6 +303,11 @@ export const guardToolDefinitions: Tool[] = [
           enum: ["auth", "crud", "api", "ui", "integration", "data", "util", "config", "other"],
           description: "Feature category (auto-detected if not specified)",
         },
+        preset: {
+          type: "string",
+          enum: ["fsd", "clean", "hexagonal", "atomic", "cqrs", "mandu"],
+          description: "Architecture preset (default: mandu). Use 'cqrs' for Command/Query separation.",
+        },
       },
       required: ["intent"],
     },
@@ -332,6 +337,11 @@ export const guardToolDefinitions: Tool[] = [
           type: "boolean",
           description: "If true, overwrite existing files (default: false)",
         },
+        preset: {
+          type: "string",
+          enum: ["fsd", "clean", "hexagonal", "atomic", "cqrs", "mandu"],
+          description: "Architecture preset (default: mandu)",
+        },
       },
       required: ["intent"],
     },
@@ -437,7 +447,7 @@ export function guardTools(projectRoot: string) {
       switch (error.errorType) {
         case "SPEC_ERROR":
           analysis.category = "Specification Error";
-          analysis.fixLocation = error.fix?.file || "spec/routes.manifest.json";
+          analysis.fixLocation = error.fix?.file || ".mandu/routes.manifest.json";
           analysis.actions = [
             "Check the spec file for JSON syntax errors",
             "Validate route IDs are unique",
@@ -966,11 +976,12 @@ Mandu.filling()
     // ═══════════════════════════════════════════════════════════════════════════
 
     mandu_negotiate: async (args: Record<string, unknown>) => {
-      const { intent, requirements, constraints, category } = args as {
+      const { intent, requirements, constraints, category, preset } = args as {
         intent: string;
         requirements?: string[];
         constraints?: string[];
         category?: FeatureCategory;
+        preset?: GuardPreset;
       };
 
       if (!intent) {
@@ -985,6 +996,7 @@ Mandu.filling()
         requirements,
         constraints,
         category,
+        preset,
       };
 
       const result = await negotiate(request, projectRoot);
@@ -1029,11 +1041,12 @@ Mandu.filling()
     },
 
     mandu_generate_scaffold: async (args: Record<string, unknown>) => {
-      const { intent, category, dryRun = false, overwrite = false } = args as {
+      const { intent, category, dryRun = false, overwrite = false, preset } = args as {
         intent: string;
         category?: FeatureCategory;
         dryRun?: boolean;
         overwrite?: boolean;
+        preset?: GuardPreset;
       };
 
       if (!intent) {
@@ -1044,7 +1057,7 @@ Mandu.filling()
       }
 
       // 먼저 협상하여 구조 계획 얻기
-      const plan = await negotiate({ intent, category }, projectRoot);
+      const plan = await negotiate({ intent, category, preset }, projectRoot);
 
       if (!plan.approved) {
         return {

package/src/tools/hydration.ts

@@ -318,8 +318,8 @@ export function hydrationTools(projectRoot: string) {
         };
       }
 
-      // Create client slot file in apps/web/components/ (not spec/slots/)
-      const clientModulePath = `apps/web/components/${routeId}.client.tsx`;
+      // Create client slot file in spec/slots/
+      const clientModulePath = `spec/slots/${routeId}.client.tsx`;
       const clientFilePath = path.join(projectRoot, clientModulePath);
 
       // Check if file already exists
@@ -378,19 +378,19 @@ function generateClientSlotTemplate(routeId: string, slotModule?: string): strin
     .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
     .join("");
 
-  const typeImport = slotModule
-    ? `// Import types from server slot if needed (adjust path to your project)
-// import type { LoaderData } from "../../../spec/slots/${routeId}.slot";
-
-`
-    : "";
+  const typeImport = slotModule
+    ? `// Import types from server slot if needed (adjust path to your project)
+// import type { LoaderData } from "../../../spec/slots/${routeId}.slot";
+
+`
+    : "";
 
   return `/**
  * ${pascalCase} Client Slot
  * 브라우저에서 실행되는 클라이언트 로직
  */
 
-import { ManduClient } from "@mandujs/core/client";
+import { ManduClient } from "@mandujs/core/client";
 import { useState, useCallback } from "react";
 
 ${typeImport}// 서버에서 전달받는 데이터 타입
@@ -399,7 +399,7 @@ interface ServerData {
   [key: string]: unknown;
 }
 
-export default ManduClient.island<ServerData>({
+export default ManduClient.island<ServerData>({
   /**
    * Setup Phase
    * - 서버 데이터를 받아 클라이언트 상태 초기화

package/src/tools/index.ts

@@ -22,6 +22,7 @@ export { brainTools, brainToolDefinitions } from "./brain.js";
 export { runtimeTools, runtimeToolDefinitions } from "./runtime.js";
 export { seoTools, seoToolDefinitions } from "./seo.js";
 export { projectTools, projectToolDefinitions } from "./project.js";
+export { ateTools, ateToolDefinitions } from "./ate.js";
 
 // 도구 모듈 import (등록용)
 import { specTools, specToolDefinitions } from "./spec.js";
@@ -36,13 +37,14 @@ import { brainTools, brainToolDefinitions } from "./brain.js";
 import { runtimeTools, runtimeToolDefinitions } from "./runtime.js";
 import { seoTools, seoToolDefinitions } from "./seo.js";
 import { projectTools, projectToolDefinitions } from "./project.js";
+import { ateTools, ateToolDefinitions } from "./ate.js";
 
 /**
  * 도구 모듈 정보
  */
 interface ToolModule {
   category: string;
-  definitions: typeof specToolDefinitions;
+  definitions: any;
   handlers: (
     projectRoot: string,
     server?: Server,
@@ -67,6 +69,7 @@ const TOOL_MODULES: ToolModule[] = [
   { category: "runtime", definitions: runtimeToolDefinitions, handlers: runtimeTools },
   { category: "seo", definitions: seoToolDefinitions, handlers: seoTools },
   { category: "project", definitions: projectToolDefinitions, handlers: projectTools as ToolModule["handlers"], requiresServer: true },
+  { category: "ate", definitions: ateToolDefinitions as any, handlers: ateTools as any },
 ];
 
 /**