@mandujs/mcp 0.12.1 → 0.13.0

package/src/executor/tool-executor.ts

@@ -1,148 +1,148 @@
-/**
- * MCP Tool Executor
- *
- * 도구 실행 + 훅 + 에러 처리 통합
- */
-
-import type { McpToolPlugin, ManduConfig } from "@mandujs/core";
-import { mcpToolRegistry } from "../registry/mcp-tool-registry.js";
-import { mcpHookRegistry, type McpToolContext } from "../hooks/mcp-hooks.js";
-import { createToolResponse, logToolError, type McpToolResponse } from "./error-handler.js";
-
-/**
- * Tool Executor 옵션
- */
-export interface ToolExecutorOptions {
-  /** 프로젝트 루트 */
-  projectRoot: string;
-  /** Mandu 설정 */
-  config?: ManduConfig;
-  /** 활동 모니터 로깅 함수 */
-  logTool?: (name: string, args?: Record<string, unknown>, result?: unknown, error?: string) => void;
-  /** 결과 로깅 함수 */
-  logResult?: (name: string, result: unknown) => void;
-}
-
-/**
- * 도구 실행 결과
- */
-export interface ExecutionResult {
-  success: boolean;
-  response: McpToolResponse;
-  duration: number;
-  toolName: string;
-}
-
-/**
- * 도구 실행기
- *
- * DNA 기능들(플러그인, 훅, 에러 처리)을 통합한 도구 실행
- */
-export class ToolExecutor {
-  private options: ToolExecutorOptions;
-
-  constructor(options: ToolExecutorOptions) {
-    this.options = options;
-  }
-
-  /**
-   * 도구 실행
-   *
-   * @param name - 도구 이름
-   * @param args - 도구 인자
-   * @returns 실행 결과
-   */
-  async execute(name: string, args: Record<string, unknown> = {}): Promise<ExecutionResult> {
-    const startTime = Date.now();
-
-    // 도구 조회
-    const tool = mcpToolRegistry.get(name);
-    if (!tool) {
-      const response = createToolResponse(name, null, new Error(`Unknown tool: ${name}`));
-      return {
-        success: false,
-        response,
-        duration: Date.now() - startTime,
-        toolName: name,
-      };
-    }
-
-    // 실행 컨텍스트 생성
-    const ctx: McpToolContext = {
-      toolName: name,
-      args,
-      projectRoot: this.options.projectRoot,
-      config: this.options.config,
-      startTime,
-    };
-
-    try {
-      // Pre-Tool 훅 실행
-      await mcpHookRegistry.runPreHooks(ctx);
-
-      // 활동 로깅 (호출)
-      this.options.logTool?.(name, args);
-
-      // 도구 실행
-      const result = await tool.execute(args);
-
-      // 활동 로깅 (결과)
-      this.options.logResult?.(name, result);
-
-      // Post-Tool 훅 실행
-      await mcpHookRegistry.runPostHooks(ctx, result);
-
-      const response = createToolResponse(name, result);
-      return {
-        success: true,
-        response,
-        duration: Date.now() - startTime,
-        toolName: name,
-      };
-    } catch (error) {
-      // 에러 로깅
-      const errorMsg = error instanceof Error ? error.message : String(error);
-      this.options.logTool?.(name, args, null, errorMsg);
-      logToolError(name, error, args);
-
-      // Post-Tool 훅 실행 (에러와 함께)
-      await mcpHookRegistry.runPostHooks(ctx, null, error);
-
-      const response = createToolResponse(name, null, error);
-      return {
-        success: false,
-        response,
-        duration: Date.now() - startTime,
-        toolName: name,
-      };
-    }
-  }
-
-  /**
-   * 설정 업데이트
-   */
-  updateConfig(config: ManduConfig): void {
-    this.options.config = config;
-  }
-
-  /**
-   * 도구 존재 여부 확인
-   */
-  hasTool(name: string): boolean {
-    return mcpToolRegistry.has(name);
-  }
-
-  /**
-   * 등록된 도구 목록
-   */
-  getToolNames(): string[] {
-    return mcpToolRegistry.names;
-  }
-}
-
-/**
- * Tool Executor 팩토리 함수
- */
-export function createToolExecutor(options: ToolExecutorOptions): ToolExecutor {
-  return new ToolExecutor(options);
-}
+/**
+ * MCP Tool Executor
+ *
+ * 도구 실행 + 훅 + 에러 처리 통합
+ */
+
+import type { McpToolPlugin, ManduConfig } from "@mandujs/core";
+import { mcpToolRegistry } from "../registry/mcp-tool-registry.js";
+import { mcpHookRegistry, type McpToolContext } from "../hooks/mcp-hooks.js";
+import { createToolResponse, logToolError, type McpToolResponse } from "./error-handler.js";
+
+/**
+ * Tool Executor 옵션
+ */
+export interface ToolExecutorOptions {
+  /** 프로젝트 루트 */
+  projectRoot: string;
+  /** Mandu 설정 */
+  config?: ManduConfig;
+  /** 활동 모니터 로깅 함수 */
+  logTool?: (name: string, args?: Record<string, unknown>, result?: unknown, error?: string) => void;
+  /** 결과 로깅 함수 */
+  logResult?: (name: string, result: unknown) => void;
+}
+
+/**
+ * 도구 실행 결과
+ */
+export interface ExecutionResult {
+  success: boolean;
+  response: McpToolResponse;
+  duration: number;
+  toolName: string;
+}
+
+/**
+ * 도구 실행기
+ *
+ * DNA 기능들(플러그인, 훅, 에러 처리)을 통합한 도구 실행
+ */
+export class ToolExecutor {
+  private options: ToolExecutorOptions;
+
+  constructor(options: ToolExecutorOptions) {
+    this.options = options;
+  }
+
+  /**
+   * 도구 실행
+   *
+   * @param name - 도구 이름
+   * @param args - 도구 인자
+   * @returns 실행 결과
+   */
+  async execute(name: string, args: Record<string, unknown> = {}): Promise<ExecutionResult> {
+    const startTime = Date.now();
+
+    // 도구 조회
+    const tool = mcpToolRegistry.get(name);
+    if (!tool) {
+      const response = createToolResponse(name, null, new Error(`Unknown tool: ${name}`));
+      return {
+        success: false,
+        response,
+        duration: Date.now() - startTime,
+        toolName: name,
+      };
+    }
+
+    // 실행 컨텍스트 생성
+    const ctx: McpToolContext = {
+      toolName: name,
+      args,
+      projectRoot: this.options.projectRoot,
+      config: this.options.config,
+      startTime,
+    };
+
+    try {
+      // Pre-Tool 훅 실행
+      await mcpHookRegistry.runPreHooks(ctx);
+
+      // 활동 로깅 (호출)
+      this.options.logTool?.(name, args);
+
+      // 도구 실행
+      const result = await tool.execute(args);
+
+      // 활동 로깅 (결과)
+      this.options.logResult?.(name, result);
+
+      // Post-Tool 훅 실행
+      await mcpHookRegistry.runPostHooks(ctx, result);
+
+      const response = createToolResponse(name, result);
+      return {
+        success: true,
+        response,
+        duration: Date.now() - startTime,
+        toolName: name,
+      };
+    } catch (error) {
+      // 에러 로깅
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      this.options.logTool?.(name, args, null, errorMsg);
+      logToolError(name, error, args);
+
+      // Post-Tool 훅 실행 (에러와 함께)
+      await mcpHookRegistry.runPostHooks(ctx, null, error);
+
+      const response = createToolResponse(name, null, error);
+      return {
+        success: false,
+        response,
+        duration: Date.now() - startTime,
+        toolName: name,
+      };
+    }
+  }
+
+  /**
+   * 설정 업데이트
+   */
+  updateConfig(config: ManduConfig): void {
+    this.options.config = config;
+  }
+
+  /**
+   * 도구 존재 여부 확인
+   */
+  hasTool(name: string): boolean {
+    return mcpToolRegistry.has(name);
+  }
+
+  /**
+   * 등록된 도구 목록
+   */
+  getToolNames(): string[] {
+    return mcpToolRegistry.names;
+  }
+}
+
+/**
+ * Tool Executor 팩토리 함수
+ */
+export function createToolExecutor(options: ToolExecutorOptions): ToolExecutor {
+  return new ToolExecutor(options);
+}

package/src/hooks/config-watcher.ts

@@ -1,174 +1,174 @@
-/**
- * MCP Config Watcher
- *
- * DNA-006 설정 핫 리로드와 MCP 서버 통합
- */
-
-import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { watchConfig, hasConfigChanged, type ManduConfig } from "@mandujs/core";
-import { mcpToolRegistry } from "../registry/mcp-tool-registry.js";
-
-/**
- * MCP Config Watcher 옵션
- */
-export interface McpConfigWatcherOptions {
-  /** MCP Server 인스턴스 */
-  server?: Server;
-  /** 설정 변경 콜백 */
-  onReload?: (config: ManduConfig) => void | Promise<void>;
-  /** MCP 설정 변경 시 콜백 */
-  onMcpConfigChange?: (config: ManduConfig) => void | Promise<void>;
-  /** 에러 콜백 */
-  onError?: (error: unknown) => void;
-  /** 디바운스 딜레이 (ms) */
-  debounceMs?: number;
-}
-
-/**
- * Config Watcher 결과
- */
-export interface McpConfigWatcher {
-  /** 감시 중지 */
-  stop: () => void;
-  /** 수동 리로드 */
-  reload: () => Promise<ManduConfig | undefined>;
-  /** 현재 설정 */
-  getConfig: () => ManduConfig | undefined;
-}
-
-/**
- * MCP 서버 설정 감시 시작
- *
- * @example
- * ```ts
- * const watcher = await startMcpConfigWatcher(projectRoot, {
- *   server,
- *   onReload: (config) => {
- *     console.log("Config reloaded:", config);
- *   },
- * });
- *
- * // 나중에 중지
- * watcher.stop();
- * ```
- */
-export async function startMcpConfigWatcher(
-  projectRoot: string,
-  options: McpConfigWatcherOptions = {}
-): Promise<McpConfigWatcher> {
-  const {
-    server,
-    onReload,
-    onMcpConfigChange,
-    onError,
-    debounceMs = 200,
-  } = options;
-
-  const watcher = await watchConfig(
-    projectRoot,
-    async (newConfig, event) => {
-      // MCP 서버에 알림
-      if (server) {
-        try {
-          await server.sendLoggingMessage({
-            level: "info",
-            logger: "mandu-config",
-            data: {
-              type: "config_reload",
-              changedSections: event.changedSections,
-              path: event.path,
-            },
-          });
-        } catch {
-          // 알림 실패 무시
-        }
-      }
-
-      // MCP 관련 설정 변경 확인
-      if (event.previous && event.current) {
-        if (hasConfigChanged(event.previous, event.current, "mcp")) {
-          // MCP 설정 변경 시 도구 재초기화 등 필요한 작업
-          if (server) {
-            try {
-              await server.sendLoggingMessage({
-                level: "warning",
-                logger: "mandu-config",
-                data: {
-                  type: "mcp_config_changed",
-                  message: "MCP configuration changed. Some tools may need reinitialization.",
-                },
-              });
-            } catch {
-              // 알림 실패 무시
-            }
-          }
-
-          await onMcpConfigChange?.(newConfig);
-        }
-
-        // Guard 설정 변경 확인
-        if (hasConfigChanged(event.previous, event.current, "guard")) {
-          if (server) {
-            try {
-              await server.sendLoggingMessage({
-                level: "info",
-                logger: "mandu-config",
-                data: {
-                  type: "guard_config_changed",
-                  message: "Guard configuration changed. Architecture rules updated.",
-                },
-              });
-            } catch {
-              // 알림 실패 무시
-            }
-          }
-        }
-      }
-
-      // 일반 콜백
-      await onReload?.(newConfig);
-    },
-    {
-      debounceMs,
-      immediate: false,
-      onError: (err) => {
-        console.error("[MCP:ConfigWatcher] Error:", err);
-
-        if (server) {
-          server.sendLoggingMessage({
-            level: "error",
-            logger: "mandu-config",
-            data: {
-              type: "config_error",
-              error: err instanceof Error ? err.message : String(err),
-            },
-          }).catch(() => {});
-        }
-
-        onError?.(err);
-      },
-    }
-  );
-
-  return watcher;
-}
-
-/**
- * 설정 변경 시 도구 재등록이 필요한지 확인
- */
-export function needsToolReregistration(
-  previous: ManduConfig | undefined,
-  current: ManduConfig | undefined
-): boolean {
-  if (!previous || !current) return false;
-
-  // MCP 플러그인 설정 변경
-  const prevPlugins = (previous as Record<string, unknown>).mcpPlugins;
-  const currPlugins = (current as Record<string, unknown>).mcpPlugins;
-
-  if (JSON.stringify(prevPlugins) !== JSON.stringify(currPlugins)) {
-    return true;
-  }
-
-  return false;
-}
+/**
+ * MCP Config Watcher
+ *
+ * DNA-006 설정 핫 리로드와 MCP 서버 통합
+ */
+
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { watchConfig, hasConfigChanged, type ManduConfig } from "@mandujs/core";
+import { mcpToolRegistry } from "../registry/mcp-tool-registry.js";
+
+/**
+ * MCP Config Watcher 옵션
+ */
+export interface McpConfigWatcherOptions {
+  /** MCP Server 인스턴스 */
+  server?: Server;
+  /** 설정 변경 콜백 */
+  onReload?: (config: ManduConfig) => void | Promise<void>;
+  /** MCP 설정 변경 시 콜백 */
+  onMcpConfigChange?: (config: ManduConfig) => void | Promise<void>;
+  /** 에러 콜백 */
+  onError?: (error: unknown) => void;
+  /** 디바운스 딜레이 (ms) */
+  debounceMs?: number;
+}
+
+/**
+ * Config Watcher 결과
+ */
+export interface McpConfigWatcher {
+  /** 감시 중지 */
+  stop: () => void;
+  /** 수동 리로드 */
+  reload: () => Promise<ManduConfig | undefined>;
+  /** 현재 설정 */
+  getConfig: () => ManduConfig | undefined;
+}
+
+/**
+ * MCP 서버 설정 감시 시작
+ *
+ * @example
+ * ```ts
+ * const watcher = await startMcpConfigWatcher(projectRoot, {
+ *   server,
+ *   onReload: (config) => {
+ *     console.log("Config reloaded:", config);
+ *   },
+ * });
+ *
+ * // 나중에 중지
+ * watcher.stop();
+ * ```
+ */
+export async function startMcpConfigWatcher(
+  projectRoot: string,
+  options: McpConfigWatcherOptions = {}
+): Promise<McpConfigWatcher> {
+  const {
+    server,
+    onReload,
+    onMcpConfigChange,
+    onError,
+    debounceMs = 200,
+  } = options;
+
+  const watcher = await watchConfig(
+    projectRoot,
+    async (newConfig, event) => {
+      // MCP 서버에 알림
+      if (server) {
+        try {
+          await server.sendLoggingMessage({
+            level: "info",
+            logger: "mandu-config",
+            data: {
+              type: "config_reload",
+              changedSections: event.changedSections,
+              path: event.path,
+            },
+          });
+        } catch {
+          // 알림 실패 무시
+        }
+      }
+
+      // MCP 관련 설정 변경 확인
+      if (event.previous && event.current) {
+        if (hasConfigChanged(event.previous, event.current, "mcp")) {
+          // MCP 설정 변경 시 도구 재초기화 등 필요한 작업
+          if (server) {
+            try {
+              await server.sendLoggingMessage({
+                level: "warning",
+                logger: "mandu-config",
+                data: {
+                  type: "mcp_config_changed",
+                  message: "MCP configuration changed. Some tools may need reinitialization.",
+                },
+              });
+            } catch {
+              // 알림 실패 무시
+            }
+          }
+
+          await onMcpConfigChange?.(newConfig);
+        }
+
+        // Guard 설정 변경 확인
+        if (hasConfigChanged(event.previous, event.current, "guard")) {
+          if (server) {
+            try {
+              await server.sendLoggingMessage({
+                level: "info",
+                logger: "mandu-config",
+                data: {
+                  type: "guard_config_changed",
+                  message: "Guard configuration changed. Architecture rules updated.",
+                },
+              });
+            } catch {
+              // 알림 실패 무시
+            }
+          }
+        }
+      }
+
+      // 일반 콜백
+      await onReload?.(newConfig);
+    },
+    {
+      debounceMs,
+      immediate: false,
+      onError: (err) => {
+        console.error("[MCP:ConfigWatcher] Error:", err);
+
+        if (server) {
+          server.sendLoggingMessage({
+            level: "error",
+            logger: "mandu-config",
+            data: {
+              type: "config_error",
+              error: err instanceof Error ? err.message : String(err),
+            },
+          }).catch(() => {});
+        }
+
+        onError?.(err);
+      },
+    }
+  );
+
+  return watcher;
+}
+
+/**
+ * 설정 변경 시 도구 재등록이 필요한지 확인
+ */
+export function needsToolReregistration(
+  previous: ManduConfig | undefined,
+  current: ManduConfig | undefined
+): boolean {
+  if (!previous || !current) return false;
+
+  // MCP 플러그인 설정 변경
+  const prevPlugins = (previous as Record<string, unknown>).mcpPlugins;
+  const currPlugins = (current as Record<string, unknown>).mcpPlugins;
+
+  if (JSON.stringify(prevPlugins) !== JSON.stringify(currPlugins)) {
+    return true;
+  }
+
+  return false;
+}