@mandujs/mcp 0.38.12 → 0.39.0-beta.1

package/README.md

@@ -136,9 +136,9 @@ bunx @mandujs/mcp --root /path/to/project
 
 ### Semantic Slots (RFC-001) 🆕
 
-| Tool | Description |
-|------|-------------|
-| `mandu_get_slot_constraints` | Get recommended slot constraint presets |
+| Tool | Description |
+|------|-------------|
+| `mandu_get_slot_constraints` | Get recommended slot constraint presets |
 
 ### Architecture Negotiation (RFC-001) 🆕
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/mcp",
-  "version": "0.38.12",
+  "version": "0.39.0-beta.1",
   "description": "Mandu MCP Server - Agent-native interface for Mandu framework operations",
   "type": "module",
   "main": "./src/index.ts",
@@ -34,12 +34,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@mandujs/core": "^0.54.20",
-    "@mandujs/ate": "^0.26.1",
-    "@mandujs/skills": "^0.20.1",
+    "@mandujs/core": "^0.55.0-beta.1",
     "@modelcontextprotocol/sdk": "^1.25.3"
   },
   "engines": {
-    "bun": ">=1.3.12"
+    "bun": ">=1.4.0"
   }
 }

package/src/activity-adapter.ts

@@ -1,23 +1,23 @@
-/**
- * ActivityMonitor -> EventBus adapter
- * Emits MCP tool execution events into the unified observability bus.
- */
-
-import { eventBus } from "@mandujs/core";
-
-export function emitMcpEvent(
-  toolName: string,
-  args: unknown,
-  result: unknown,
-  duration: number,
-  success: boolean,
-): void {
-  eventBus.emit({
-    type: "mcp",
-    severity: success ? "info" : "error",
-    source: "mcp",
-    message: `${toolName} ${success ? "ok" : "fail"} ${duration}ms`,
-    duration,
-    data: { tool: toolName, args, success },
-  });
-}
+/**
+ * ActivityMonitor -> EventBus adapter
+ * Emits MCP tool execution events into the unified observability bus.
+ */
+
+import { eventBus } from "@mandujs/core/compat/observability/index";
+
+export function emitMcpEvent(
+  toolName: string,
+  args: unknown,
+  result: unknown,
+  duration: number,
+  success: boolean,
+): void {
+  eventBus.emit({
+    type: "mcp",
+    severity: success ? "info" : "error",
+    source: "mcp",
+    message: `${toolName} ${success ? "ok" : "fail"} ${duration}ms`,
+    duration,
+    data: { tool: toolName, args, success },
+  });
+}

package/src/activity-monitor.ts

@@ -7,16 +7,45 @@
 
 import fs from "fs";
 import path from "path";
-import type { Subprocess } from "bun";
-import { eventBus } from "@mandujs/core/observability";
-import type { AteMonitorEvent } from "@mandujs/ate";
-
-/**
- * Local alias — reserved in case we need to accept slightly looser
- * shapes at the subscription boundary (forward-compat with events
- * emitted by newer ATE versions). Today it is a direct re-export.
- */
-type AteMonitorEventShape = AteMonitorEvent;
+import type { Subprocess } from "bun";
+import { eventBus } from "@mandujs/core/compat/observability/index";
+
+/**
+ * Labs event wire shape. MCP observes the Core event bus without taking a
+ * runtime or type dependency on @mandujs/ate. The optional ATE package owns
+ * production of these events; this adapter intentionally knows only the
+ * fields it renders.
+ */
+type AteMonitorEventShape =
+  | { kind: "run_start"; runId: string; specPaths: string[] }
+  | { kind: "spec_progress"; runId: string; specPath: string; phase: string }
+  | {
+      kind: "spec_done";
+      runId: string;
+      specPath: string;
+      status: "pass" | "fail" | "skip";
+      durationMs: number;
+    }
+  | {
+      kind: "failure_captured";
+      runId: string;
+      specPath: string;
+      failure: { kind: string };
+    }
+  | {
+      kind: "artifact_saved";
+      runId: string;
+      specPath?: string;
+      path: string;
+    }
+  | {
+      kind: "run_end";
+      runId: string;
+      passed: number;
+      failed: number;
+      skipped: number;
+      durationMs: number;
+    };
 
 const TOOL_ICONS: Record<string, string> = {
   // Spec

package/src/adapters/index.ts

@@ -1,20 +1,20 @@
-/**
- * MCP Adapters
- *
- * DNA 기능과 MCP 간의 변환 어댑터
- */
-
-export {
-  toolToPlugin,
-  pluginToTool,
-  moduleToPlugins,
-  pluginsToTools,
-  pluginsToHandlers,
-} from "./tool-adapter.js";
-
-export {
-  monitorEventToRecord,
-  recordToMonitorEvent,
-  severityToLevel,
-  levelToSeverity,
-} from "./monitor-adapter.js";
+/**
+ * MCP Adapters
+ *
+ * DNA 기능과 MCP 간의 변환 어댑터
+ */
+
+export {
+  toolToPlugin,
+  pluginToTool,
+  moduleToPlugins,
+  pluginsToTools,
+  pluginsToHandlers,
+} from "./tool-adapter.js";
+
+export {
+  monitorEventToRecord,
+  recordToMonitorEvent,
+  severityToLevel,
+  levelToSeverity,
+} from "./monitor-adapter.js";

package/src/adapters/monitor-adapter.ts

@@ -1,100 +1,100 @@
-/**
- * Monitor Event Adapter
- *
- * ActivityMonitor 이벤트와 DNA-008 LogTransportRecord 간 변환
- */
-
-import type { LogTransportRecord } from "@mandujs/core";
-
-/**
- * Monitor 이벤트 타입 (ActivityMonitor에서 사용)
- */
-export interface MonitorEvent {
-  ts: string;
-  type: string;
-  severity: MonitorSeverity;
-  source: string;
-  message?: string;
-  data?: Record<string, unknown>;
-  actionRequired?: boolean;
-  fingerprint?: string;
-  count?: number;
-  schemaVersion?: string;
-}
-
-export type MonitorSeverity = "info" | "warn" | "error";
-export type LogLevel = "debug" | "info" | "warn" | "error";
-
-/**
- * MonitorSeverity → LogLevel 변환
- */
-export function severityToLevel(severity: MonitorSeverity): LogLevel {
-  switch (severity) {
-    case "error":
-      return "error";
-    case "warn":
-      return "warn";
-    case "info":
-    default:
-      return "info";
-  }
-}
-
-/**
- * LogLevel → MonitorSeverity 변환
- */
-export function levelToSeverity(level: LogLevel): MonitorSeverity {
-  switch (level) {
-    case "error":
-      return "error";
-    case "warn":
-      return "warn";
-    case "debug":
-    case "info":
-    default:
-      return "info";
-  }
-}
-
-/**
- * MonitorEvent → LogTransportRecord 변환
- *
- * ActivityMonitor 이벤트를 DNA-008 로깅 시스템으로 전송할 때 사용
- */
-export function monitorEventToRecord(event: MonitorEvent): LogTransportRecord {
-  return {
-    timestamp: event.ts,
-    level: severityToLevel(event.severity),
-    meta: {
-      type: event.type,
-      source: event.source,
-      fingerprint: event.fingerprint,
-      count: event.count,
-      actionRequired: event.actionRequired,
-      schemaVersion: event.schemaVersion,
-      ...event.data,
-    },
-  };
-}
-
-/**
- * LogTransportRecord → MonitorEvent 변환 (역방향)
- *
- * DNA-008 로그를 ActivityMonitor에서 표시할 때 사용
- */
-export function recordToMonitorEvent(record: LogTransportRecord): MonitorEvent {
-  const meta = record.meta ?? {};
-
-  return {
-    ts: record.timestamp,
-    type: (meta.type as string) ?? "log",
-    severity: levelToSeverity(record.level),
-    source: (meta.source as string) ?? "unknown",
-    message: record.error?.message,
-    data: meta,
-    actionRequired: (meta.actionRequired as boolean) ?? false,
-    fingerprint: meta.fingerprint as string | undefined,
-    count: meta.count as number | undefined,
-    schemaVersion: meta.schemaVersion as string | undefined,
-  };
-}
+/**
+ * Monitor Event Adapter
+ *
+ * ActivityMonitor 이벤트와 DNA-008 LogTransportRecord 간 변환
+ */
+
+import type { LogTransportRecord } from "@mandujs/core/compat/logging/index";
+
+/**
+ * Monitor 이벤트 타입 (ActivityMonitor에서 사용)
+ */
+export interface MonitorEvent {
+  ts: string;
+  type: string;
+  severity: MonitorSeverity;
+  source: string;
+  message?: string;
+  data?: Record<string, unknown>;
+  actionRequired?: boolean;
+  fingerprint?: string;
+  count?: number;
+  schemaVersion?: string;
+}
+
+export type MonitorSeverity = "info" | "warn" | "error";
+export type LogLevel = "debug" | "info" | "warn" | "error";
+
+/**
+ * MonitorSeverity → LogLevel 변환
+ */
+export function severityToLevel(severity: MonitorSeverity): LogLevel {
+  switch (severity) {
+    case "error":
+      return "error";
+    case "warn":
+      return "warn";
+    case "info":
+    default:
+      return "info";
+  }
+}
+
+/**
+ * LogLevel → MonitorSeverity 변환
+ */
+export function levelToSeverity(level: LogLevel): MonitorSeverity {
+  switch (level) {
+    case "error":
+      return "error";
+    case "warn":
+      return "warn";
+    case "debug":
+    case "info":
+    default:
+      return "info";
+  }
+}
+
+/**
+ * MonitorEvent → LogTransportRecord 변환
+ *
+ * ActivityMonitor 이벤트를 DNA-008 로깅 시스템으로 전송할 때 사용
+ */
+export function monitorEventToRecord(event: MonitorEvent): LogTransportRecord {
+  return {
+    timestamp: event.ts,
+    level: severityToLevel(event.severity),
+    meta: {
+      type: event.type,
+      source: event.source,
+      fingerprint: event.fingerprint,
+      count: event.count,
+      actionRequired: event.actionRequired,
+      schemaVersion: event.schemaVersion,
+      ...event.data,
+    },
+  };
+}
+
+/**
+ * LogTransportRecord → MonitorEvent 변환 (역방향)
+ *
+ * DNA-008 로그를 ActivityMonitor에서 표시할 때 사용
+ */
+export function recordToMonitorEvent(record: LogTransportRecord): MonitorEvent {
+  const meta = record.meta ?? {};
+
+  return {
+    ts: record.timestamp,
+    type: (meta.type as string) ?? "log",
+    severity: levelToSeverity(record.level),
+    source: (meta.source as string) ?? "unknown",
+    message: record.error?.message,
+    data: meta,
+    actionRequired: (meta.actionRequired as boolean) ?? false,
+    fingerprint: meta.fingerprint as string | undefined,
+    count: meta.count as number | undefined,
+    schemaVersion: meta.schemaVersion as string | undefined,
+  };
+}

package/src/adapters/tool-adapter.ts

@@ -1,90 +1,90 @@
-/**
- * MCP Tool Adapter
- *
- * MCP SDK Tool을 DNA-001 McpToolPlugin으로 변환
- */
-
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { McpToolPlugin } from "@mandujs/core/plugins";
-
-/**
- * MCP SDK Tool을 McpToolPlugin으로 변환
- *
- * @example
- * ```ts
- * const plugin = toolToPlugin(
- *   { name: "my_tool", description: "...", inputSchema: {} },
- *   async (args) => ({ success: true })
- * );
- * ```
- */
-export function toolToPlugin(
-  definition: Tool,
-  handler: (args: Record<string, unknown>) => Promise<unknown>
-): McpToolPlugin {
-  return {
-    name: definition.name,
-    description: definition.description ?? "",
-    inputSchema: definition.inputSchema as unknown as Record<string, unknown>,
-    ...(definition.annotations && { annotations: definition.annotations as unknown as Record<string, unknown> }),
-    execute: handler as (input: unknown) => Promise<unknown>,
-  };
-}
-
-/**
- * McpToolPlugin을 MCP SDK Tool로 변환 (역방향)
- */
-export function pluginToTool(plugin: McpToolPlugin): Tool {
-  return {
-    name: plugin.name,
-    description: plugin.description,
-    inputSchema: plugin.inputSchema as Tool["inputSchema"],
-    ...(plugin.annotations && { annotations: plugin.annotations as Tool["annotations"] }),
-  };
-}
-
-/**
- * 기존 도구 모듈(definitions + handlers)을 플러그인 배열로 변환
- *
- * @example
- * ```ts
- * const plugins = moduleToPlugins(
- *   specToolDefinitions,
- *   specTools(projectRoot)
- * );
- * ```
- */
-export function moduleToPlugins(
-  definitions: Tool[],
-  handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>>
-): McpToolPlugin[] {
-  return definitions.map((def) => {
-    const handler = handlers[def.name];
-    if (!handler) {
-      throw new Error(`Handler not found for tool: ${def.name}`);
-    }
-    return toolToPlugin(def, handler);
-  });
-}
-
-/**
- * 플러그인 배열을 MCP SDK Tool 배열로 변환
- */
-export function pluginsToTools(plugins: McpToolPlugin[]): Tool[] {
-  return plugins.map(pluginToTool);
-}
-
-/**
- * 플러그인 배열을 핸들러 맵으로 변환
- */
-export function pluginsToHandlers(
-  plugins: McpToolPlugin[]
-): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {
-  const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {};
-
-  for (const plugin of plugins) {
-    handlers[plugin.name] = async (args) => plugin.execute(args);
-  }
-
-  return handlers;
-}
+/**
+ * MCP Tool Adapter
+ *
+ * MCP SDK Tool을 DNA-001 McpToolPlugin으로 변환
+ */
+
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpToolPlugin } from "@mandujs/core/plugins";
+
+/**
+ * MCP SDK Tool을 McpToolPlugin으로 변환
+ *
+ * @example
+ * ```ts
+ * const plugin = toolToPlugin(
+ *   { name: "my_tool", description: "...", inputSchema: {} },
+ *   async (args) => ({ success: true })
+ * );
+ * ```
+ */
+export function toolToPlugin(
+  definition: Tool,
+  handler: (args: Record<string, unknown>) => Promise<unknown>
+): McpToolPlugin {
+  return {
+    name: definition.name,
+    description: definition.description ?? "",
+    inputSchema: definition.inputSchema as unknown as Record<string, unknown>,
+    ...(definition.annotations && { annotations: definition.annotations as unknown as Record<string, unknown> }),
+    execute: handler as (input: unknown) => Promise<unknown>,
+  };
+}
+
+/**
+ * McpToolPlugin을 MCP SDK Tool로 변환 (역방향)
+ */
+export function pluginToTool(plugin: McpToolPlugin): Tool {
+  return {
+    name: plugin.name,
+    description: plugin.description,
+    inputSchema: plugin.inputSchema as Tool["inputSchema"],
+    ...(plugin.annotations && { annotations: plugin.annotations as Tool["annotations"] }),
+  };
+}
+
+/**
+ * 기존 도구 모듈(definitions + handlers)을 플러그인 배열로 변환
+ *
+ * @example
+ * ```ts
+ * const plugins = moduleToPlugins(
+ *   specToolDefinitions,
+ *   specTools(projectRoot)
+ * );
+ * ```
+ */
+export function moduleToPlugins(
+  definitions: Tool[],
+  handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>>
+): McpToolPlugin[] {
+  return definitions.map((def) => {
+    const handler = handlers[def.name];
+    if (!handler) {
+      throw new Error(`Handler not found for tool: ${def.name}`);
+    }
+    return toolToPlugin(def, handler);
+  });
+}
+
+/**
+ * 플러그인 배열을 MCP SDK Tool 배열로 변환
+ */
+export function pluginsToTools(plugins: McpToolPlugin[]): Tool[] {
+  return plugins.map(pluginToTool);
+}
+
+/**
+ * 플러그인 배열을 핸들러 맵으로 변환
+ */
+export function pluginsToHandlers(
+  plugins: McpToolPlugin[]
+): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {
+  const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {};
+
+  for (const plugin of plugins) {
+    handlers[plugin.name] = async (args) => plugin.execute(args);
+  }
+
+  return handlers;
+}

package/src/executor/index.ts

@@ -1,22 +1,22 @@
-/**
- * MCP Executor
- *
- * 도구 실행 및 에러 처리
- */
-
-export {
-  formatMcpError,
-  createToolResponse,
-  isErrorResponse,
-  extractErrorFromResponse,
-  logToolError,
-  type McpErrorResponse,
-  type McpToolResponse,
-} from "./error-handler.js";
-
-export {
-  ToolExecutor,
-  createToolExecutor,
-  type ToolExecutorOptions,
-  type ExecutionResult,
-} from "./tool-executor.js";
+/**
+ * MCP Executor
+ *
+ * 도구 실행 및 에러 처리
+ */
+
+export {
+  formatMcpError,
+  createToolResponse,
+  isErrorResponse,
+  extractErrorFromResponse,
+  logToolError,
+  type McpErrorResponse,
+  type McpToolResponse,
+} from "./error-handler.js";
+
+export {
+  ToolExecutor,
+  createToolExecutor,
+  type ToolExecutorOptions,
+  type ExecutionResult,
+} from "./tool-executor.js";