@mandujs/mcp 0.16.0 → 0.17.1

package/README.md

@@ -167,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
@@ -323,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

package/package.json

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

package/src/tools/ate.ts

@@ -1,5 +1,15 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { ateExtract, ateGenerate, ateRun, ateReport, ateHeal, ateImpact } from "@mandujs/ate";
+import {
+  ateExtract,
+  ateGenerate,
+  ateRun,
+  ateReport,
+  ateHeal,
+  ateImpact,
+  runFullPipeline,
+  analyzeFeedback,
+  applyHeal,
+} from "@mandujs/ate";
 
 export const ateToolDefinitions: Tool[] = [
   {
@@ -46,7 +56,7 @@ export const ateToolDefinitions: Tool[] = [
   },
   {
     name: "mandu.ate.report",
-    description: "ATE: summary.json 생성",
+    description: "ATE: 테스트 리포트 생성 (JSON, HTML, 또는 both)",
     inputSchema: {
       type: "object",
       properties: {
@@ -56,6 +66,7 @@ export const ateToolDefinitions: Tool[] = [
         finishedAt: { type: "string" },
         exitCode: { type: "number" },
         oracleLevel: { type: "string", enum: ["L0", "L1", "L2", "L3"] },
+        format: { type: "string", enum: ["json", "html", "both"], description: "리포트 포맷 (기본값: both)" },
         impact: {
           type: "object",
           properties: {
@@ -94,6 +105,63 @@ export const ateToolDefinitions: Tool[] = [
       required: ["repoRoot"],
     },
   },
+  {
+    name: "mandu.ate.auto_pipeline",
+    description: "ATE: 전체 파이프라인 자동 실행 (Extract → Generate → Run → Report → Heal)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string" },
+        baseURL: { type: "string" },
+        oracleLevel: { type: "string", enum: ["L0", "L1", "L2", "L3"] },
+        ci: { type: "boolean" },
+        useImpactAnalysis: { type: "boolean" },
+        base: { type: "string" },
+        head: { type: "string" },
+        autoHeal: { type: "boolean" },
+        tsconfigPath: { type: "string" },
+        routeGlobs: { type: "array", items: { type: "string" } },
+        buildSalt: { type: "string" },
+      },
+      required: ["repoRoot"],
+    },
+  },
+  {
+    name: "mandu.ate.feedback",
+    description: "ATE: 테스트 실패 원인 분석 및 heal 제안 평가",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string", description: "프로젝트 루트 디렉토리" },
+        runId: { type: "string", description: "테스트 실행 ID" },
+        autoApply: {
+          type: "boolean",
+          description: "자동 적용 가능 여부 (selector-map만 안전)",
+        },
+      },
+      required: ["repoRoot", "runId"],
+    },
+  },
+  {
+    name: "mandu.ate.apply_heal",
+    description: "ATE: heal diff를 실제 코드에 적용 (rollback 가능)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: { type: "string", description: "프로젝트 루트 디렉토리" },
+        runId: { type: "string", description: "테스트 실행 ID" },
+        healIndex: {
+          type: "number",
+          description: "적용할 heal suggestion의 인덱스 (0부터 시작)",
+        },
+        createBackup: {
+          type: "boolean",
+          description: "백업 생성 여부 (기본값: true, 필수 권장)",
+        },
+      },
+      required: ["repoRoot", "runId", "healIndex"],
+    },
+  },
 ];
 
 export function ateTools(projectRoot: string) {
@@ -116,6 +184,7 @@ export function ateTools(projectRoot: string) {
         finishedAt: input.finishedAt,
         exitCode: input.exitCode,
         oracleLevel: input.oracleLevel ?? "L1",
+        format: input.format ?? "both",
         impact: input.impact,
       });
     },
@@ -125,5 +194,26 @@ export function ateTools(projectRoot: string) {
     "mandu.ate.impact": async (args: Record<string, unknown>) => {
       return ateImpact(args as any);
     },
+    "mandu.ate.auto_pipeline": async (args: Record<string, unknown>) => {
+      return await runFullPipeline(args as any);
+    },
+    "mandu.ate.feedback": async (args: Record<string, unknown>) => {
+      const result = analyzeFeedback(args as any);
+      return {
+        ok: true,
+        category: result.category,
+        autoApplicable: result.autoApplicable,
+        priority: result.priority,
+        reasoning: result.reasoning,
+        suggestions: result.suggestions,
+      };
+    },
+    "mandu.ate.apply_heal": async (args: Record<string, unknown>) => {
+      const result = applyHeal(args as any);
+      return {
+        ok: result.success,
+        ...result,
+      };
+    },
   };
 }