@mandujs/mcp 0.13.0 → 0.17.0

package/README.md

@@ -27,7 +27,7 @@ MCP (Model Context Protocol) enables AI agents to directly interact with the Man
 
 ### Claude Code / Claude Desktop
 
-Add to your MCP configuration (`.mcp.json` or `.claude.json`):
+Add to your MCP configuration (`.mcp.json` or `.claude.json`):
 
 ```json
 {
@@ -72,10 +72,9 @@ bunx @mandujs/mcp --root /path/to/project
 |------|-------------|
 | `mandu_list_routes` | List all routes with details |
 | `mandu_get_route` | Get specific route by ID |
-| `mandu_add_route` | Add new route to manifest |
-| `mandu_update_route` | Modify existing route |
+| `mandu_add_route` | Add new route (scaffolds app/ files) |
 | `mandu_delete_route` | Remove route from manifest |
-| `mandu_validate_spec` | Validate manifest schema |
+| `mandu_validate_manifest` | Validate manifest schema |
 
 ### Code Generation
 
@@ -168,6 +167,17 @@ bunx @mandujs/mcp --root /path/to/project
 | `mandu_list_changes` | View change history |
 | `mandu_prune_history` | Clean old snapshots |
 
+### ATE (Automation Test Engine) 🆕
+
+| Tool | Description |
+|------|-------------|
+| `mandu.ate.extract` | Extract interaction graph from codebase |
+| `mandu.ate.generate` | Generate Playwright test scenarios |
+| `mandu.ate.run` | Execute Playwright tests with artifacts |
+| `mandu.ate.report` | Generate test summary report |
+| `mandu.ate.heal` | Auto-suggest fixes for failed tests |
+| `mandu.ate.impact` | Compute affected routes (subset testing) |
+
 ---
 
 ## Resources
@@ -267,7 +277,7 @@ Agent:
      methods: ["GET", "POST"],
      slotModule: "spec/slots/users.slot.ts"
    })
-   → Adds route to manifest
+   → Adds route to manifest and scaffolds app/ files
 
 4. mandu_generate()
    → Creates route handlers
@@ -324,6 +334,91 @@ Agent:
    → Stops watching
 ```
 
+### ATE E2E Testing Workflow
+
+```mermaid
+graph TD
+    A[mandu.ate.extract] -->|interaction-graph.json| B[mandu.ate.generate]
+    B -->|Playwright specs| C[mandu.ate.run]
+    C -->|Test results| D{Success?}
+    D -->|Yes| E[mandu.ate.report]
+    D -->|No| F[mandu.ate.heal]
+    F -->|Suggestions| G[Apply fixes]
+    G --> C
+
+    H[mandu.ate.impact] -->|Affected routes| B
+
+    style A fill:#e1f5ff
+    style B fill:#e1f5ff
+    style C fill:#fff4e1
+    style D fill:#ffe1e1
+    style E fill:#e1ffe1
+    style F fill:#ffe1e1
+    style H fill:#f5e1ff
+```
+
+**Example: Full ATE Pipeline**
+
+```typescript
+// 1. Extract interaction graph
+await mandu.ate.extract({
+  repoRoot: process.cwd(),
+  routeGlobs: ["app/**/page.tsx"]
+});
+
+// 2. Optional: Compute impact for subset testing
+const impact = mandu.ate.impact({
+  repoRoot: process.cwd(),
+  base: "main",
+  head: "HEAD"
+});
+
+// 3. Generate test scenarios
+mandu.ate.generate({
+  repoRoot: process.cwd(),
+  oracleLevel: "L1",
+  onlyRoutes: impact.selectedRoutes  // Subset testing
+});
+
+// 4. Run tests
+const result = await mandu.ate.run({
+  repoRoot: process.cwd(),
+  baseURL: "http://localhost:3333",
+  ci: true
+});
+
+// 5. Generate report
+await mandu.ate.report({
+  repoRoot: process.cwd(),
+  runId: result.runId,
+  startedAt: result.startedAt,
+  finishedAt: result.finishedAt,
+  exitCode: result.exitCode,
+  oracleLevel: "L1"
+});
+
+// 6. Heal if failed
+if (result.exitCode !== 0) {
+  const healing = mandu.ate.heal({
+    repoRoot: process.cwd(),
+    runId: result.runId
+  });
+
+  console.log("Healing suggestions:");
+  healing.suggestions.forEach(s => console.log(s.diff));
+}
+```
+
+**ATE Use Cases:**
+
+- 🤖 **Agent-driven testing**: Claude Code generates and runs E2E tests
+- 🔄 **Self-healing tests**: Auto-suggest selector fixes when tests fail
+- 🎯 **Impact-based testing**: Run only tests affected by code changes
+- 📊 **Multi-oracle validation**: L0 (smoke) → L1 (structure) → L2 (behavior) → L3 (domain)
+- 🚀 **CI/CD ready**: GitHub Actions, GitLab CI integration
+
+**Learn More**: [ATE MCP Integration Guide](../ate/docs/mcp-integration.md)
+
 ---
 
 ## Architecture Integration
@@ -355,7 +450,7 @@ The MCP server integrates with Mandu Guard to enforce architecture rules:
 ## Requirements
 
 - Bun >= 1.0.0
-- @mandujs/core >= 0.9.25
+- @mandujs/core >= 0.13.0
 
 ## Related Packages
 
@@ -364,4 +459,4 @@ The MCP server integrates with Mandu Guard to enforce architecture rules:
 
 ## License
 
-MIT
+MPL-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/mcp",
-  "version": "0.13.0",
+  "version": "0.17.0",
   "description": "Mandu MCP Server - Agent-native interface for Mandu framework operations",
   "type": "module",
   "main": "./src/index.ts",
@@ -32,7 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@mandujs/core": "^0.13.0",
+    "@mandujs/core": "^0.16.0",
+    "@mandujs/ate": "0.16.0",
     "@modelcontextprotocol/sdk": "^1.25.3"
   },
   "engines": {

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";
+
+/**
+ * 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,88 +1,88 @@
-/**
- * MCP Tool Adapter
- *
- * MCP SDK Tool을 DNA-001 McpToolPlugin으로 변환
- */
-
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { McpToolPlugin } from "@mandujs/core";
-
-/**
- * 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 Record<string, unknown>,
-    execute: handler,
-  };
-}
-
-/**
- * McpToolPlugin을 MCP SDK Tool로 변환 (역방향)
- */
-export function pluginToTool(plugin: McpToolPlugin): Tool {
-  return {
-    name: plugin.name,
-    description: plugin.description,
-    inputSchema: plugin.inputSchema,
-  };
-}
-
-/**
- * 기존 도구 모듈(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";
+
+/**
+ * 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 Record<string, unknown>,
+    execute: handler,
+  };
+}
+
+/**
+ * McpToolPlugin을 MCP SDK Tool로 변환 (역방향)
+ */
+export function pluginToTool(plugin: McpToolPlugin): Tool {
+  return {
+    name: plugin.name,
+    description: plugin.description,
+    inputSchema: plugin.inputSchema,
+  };
+}
+
+/**
+ * 기존 도구 모듈(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;
+}