@mandujs/mcp 0.19.3 → 0.19.5

package/README.md

@@ -34,18 +34,34 @@ Add to your MCP configuration (`.mcp.json` or `.claude.json`):
   "mcpServers": {
     "mandu": {
       "command": "bunx",
-      "args": ["@mandujs/mcp"],
+      "args": ["mandu-mcp"],
       "cwd": "/path/to/your/project"
     }
   }
 }
 ```
 
+> **Note**: Use `mandu-mcp` (not `@mandujs/mcp`) to avoid conflicts with Python's `mcp` CLI on PATH (#174).
+
 ### Direct Execution
 
 ```bash
 cd /path/to/project
-bunx @mandujs/mcp
+bunx mandu-mcp
+```
+
+### Tool Profiles
+
+Filter available tools via the `MANDU_MCP_PROFILE` env var:
+
+| Profile | Tools | Use Case |
+|---------|-------|----------|
+| `minimal` | ~15 | Read-only operations, safe for autonomous agents |
+| `standard` | ~50 | Default — most common operations |
+| `full` | 85+ | All tools including destructive operations |
+
+```bash
+MANDU_MCP_PROFILE=minimal bunx mandu-mcp
 ```
 
 ### Global Mode
@@ -64,7 +80,7 @@ bunx @mandujs/mcp --root /path/to/project
 
 ---
 
-## Tools (35+)
+## Tools (85+)
 
 ### Spec Management
 
@@ -167,7 +183,7 @@ bunx @mandujs/mcp --root /path/to/project
 | `mandu_list_changes` | View change history |
 | `mandu_prune_history` | Clean old snapshots |
 
-### ATE (Automation Test Engine) 🆕
+### ATE (Automation Test Engine) — 9 tools
 
 | Tool | Description |
 |------|-------------|
@@ -177,19 +193,40 @@ bunx @mandujs/mcp --root /path/to/project
 | `mandu.ate.report` | Generate test summary report |
 | `mandu.ate.heal` | Auto-suggest fixes for failed tests |
 | `mandu.ate.impact` | Compute affected routes (subset testing) |
+| `mandu.ate.auto_pipeline` | Run full pipeline (extract → generate → run → report → heal) |
+| `mandu.ate.feedback` | Analyze failures with 7-category classification |
+| `mandu.ate.apply_heal` | Apply heal diffs safely (with backup) |
+
+### Test Selection (Phase 5) — 3 tools 🆕
+
+| Tool | Description |
+|------|-------------|
+| `mandu.test.smart` | Smart test selection from git diff with priority scoring |
+| `mandu.test.coverage` | Detect coverage gaps in interaction graph |
+| `mandu.test.precommit` | Pre-commit hook: should we test before committing? |
+
+### Composite — 7 tools
+
+| Tool | Description |
+|------|-------------|
+| `mandu.feature.create` | Scaffold full feature (route + contract + slot + island) |
+| `mandu.diagnose` | Multi-aspect project health check |
+| `mandu.island.add` | Add interactive island to route |
+| `mandu.middleware.add` | Add middleware to route |
+| `mandu.test.route` | Quick smoke test for a route |
+| `mandu.deploy.check` | Pre-deploy production readiness check |
+| `mandu.cache.manage` | Manage ISR/SWR cache (list, invalidate, stats) |
 
 ---
 
-## Resources
+## Resources (4)
 
 | URI | Description |
 |-----|-------------|
-| `mandu://spec/manifest` | Current routes.manifest.json |
-| `mandu://generated/map` | Generated files mapping |
-| `mandu://transaction/active` | Active transaction state |
-| `mandu://slots/{routeId}` | Slot file content by route ID |
-| `mandu://watch/warnings` | Recent architecture violation warnings |
-| `mandu://watch/status` | Watcher status (active, uptime, count) |
+| `mandu://routes` | Current routes manifest |
+| `mandu://config` | Parsed `mandu.config.ts` settings |
+| `mandu://errors` | Recent build and runtime errors |
+| `mandu://activity` | **NEW**: Recent observability events + 5-minute stats from EventBus |
 
 ---
 

package/package.json

@@ -1,44 +1,44 @@
-{
-  "name": "@mandujs/mcp",
-  "version": "0.19.3",
-  "description": "Mandu MCP Server - Agent-native interface for Mandu framework operations",
-  "type": "module",
-  "main": "./src/index.ts",
-  "bin": {
-    "mandu-mcp": "./src/index.ts",
-    "mandujs-mcp": "./src/index.ts",
-    "mcp": "./src/index.ts"
-  },
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "files": [
-    "src/**/*"
-  ],
-  "keywords": [
-    "mandu",
-    "mcp",
-    "model-context-protocol",
-    "ai",
-    "agent",
-    "code-generation"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/konamgil/mandu.git",
-    "directory": "packages/mcp"
-  },
-  "author": "konamgil",
-  "license": "MPL-2.0",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@mandujs/core": "^0.20.0",
-    "@mandujs/ate": "^0.18.0",
-    "@modelcontextprotocol/sdk": "^1.25.3"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
-  }
-}
+{
+  "name": "@mandujs/mcp",
+  "version": "0.19.5",
+  "description": "Mandu MCP Server - Agent-native interface for Mandu framework operations",
+  "type": "module",
+  "main": "./src/index.ts",
+  "bin": {
+    "mandu-mcp": "./src/index.ts",
+    "mandujs-mcp": "./src/index.ts",
+    "mcp": "./src/index.ts"
+  },
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "files": [
+    "src/**/*"
+  ],
+  "keywords": [
+    "mandu",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "code-generation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/konamgil/mandu.git",
+    "directory": "packages/mcp"
+  },
+  "author": "konamgil",
+  "license": "MPL-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mandujs/core": "^0.21.0",
+    "@mandujs/ate": "^0.18.0",
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/src/activity-monitor.ts

@@ -277,6 +277,10 @@ export class ActivityMonitor {
   private summaryTimer: NodeJS.Timeout | null = null;
   private summaryCounts = { total: 0, info: 0, warn: 0, error: 0 };
   private lastToolArgs = new Map<string, Record<string, unknown> | null>();
+  // Phase 1-3: 도구 호출 시작 시간 추적 (duration 계산용)
+  private toolStartTimes = new Map<string, number>();
+  // Phase 5-1: 에이전트 세션 식별 (MCP 클라이언트별 추적)
+  public sessionId: string = crypto.randomUUID();
 
   constructor(projectRoot: string) {
     this.projectRoot = projectRoot;
@@ -380,17 +384,23 @@ export class ActivityMonitor {
         fingerprint: `tool:error:${name}:${argsStr}`,
         data: { tool: name, tag, args, argsSummary: argsStr, error },
       });
-      // Phase 1-3: MCP 도구 에러 → EventBus
+      // Phase 1-3: MCP 도구 에러 → EventBus (sessionId + duration 포함)
+      const startTime = this.toolStartTimes.get(name);
+      this.toolStartTimes.delete(name);
       eventBus.emit({
         type: "mcp",
         severity: "error",
         source: "mcp",
         message: `${name} ❌ ${error}`,
-        data: { tool: name, args, error },
+        duration: startTime ? Date.now() - startTime : undefined,
+        data: { tool: name, args, error, sessionId: this.sessionId },
       });
       return;
     }
 
+    // Phase 1-3: 도구 호출 시작 시간 기록 (logResult에서 duration 계산)
+    this.toolStartTimes.set(name, Date.now());
+
     this.enqueue({
       ts: new Date().toISOString(),
       type: "tool.call",
@@ -398,14 +408,6 @@ export class ActivityMonitor {
       source: "tool",
       data: { tool: name, tag, args, argsSummary: argsStr },
     });
-    // Phase 1-3: MCP 도구 호출 → EventBus
-    eventBus.emit({
-      type: "mcp",
-      severity: "info",
-      source: "mcp",
-      message: `${name} ✅`,
-      data: { tool: name, args },
-    });
   }
 
   /**
@@ -419,6 +421,18 @@ export class ActivityMonitor {
     const summary = summarizeResult(result);
     const tag = TOOL_ICONS[name] || name.replace("mandu_", "").toUpperCase();
 
+    // Phase 1-3: 도구 완료 시 duration 계산 및 EventBus emit (Phase 5-1: sessionId 포함)
+    const startTime = this.toolStartTimes.get(name);
+    this.toolStartTimes.delete(name);
+    eventBus.emit({
+      type: "mcp",
+      severity: "info",
+      source: "mcp",
+      message: `${name} ✅`,
+      duration: startTime ? Date.now() - startTime : undefined,
+      data: { tool: name, args: lastArgs, sessionId: this.sessionId },
+    });
+
     if (summary) {
       this.enqueue({
         ts: new Date().toISOString(),

package/src/new-resources.ts

@@ -1,119 +1,145 @@
-/**
- * MCP Resources for Mandu Framework
- *
- * Project state data exposed via the MCP resource protocol.
- */
-
-import type { Resource } from "@modelcontextprotocol/sdk/types.js";
-import path from "path";
-import { readConfig, readJsonFile } from "./utils/project.js";
-import { loadManduConfig, loadManifest } from "@mandujs/core";
-import { getDevServerState } from "./tools/project.js";
-
-export const manduResourceDefinitions: Resource[] = [
-  {
-    uri: "mandu://routes",
-    name: "Route Manifest",
-    description: "Current project route manifest (JSON)",
-    mimeType: "application/json",
-  },
-  {
-    uri: "mandu://config",
-    name: "Mandu Config",
-    description: "Parsed mandu.config.ts settings",
-    mimeType: "application/json",
-  },
-  {
-    uri: "mandu://errors",
-    name: "Recent Errors",
-    description: "Recent build and runtime errors",
-    mimeType: "application/json",
-  },
-];
-
-type ResourceReadResult = { uri: string; mimeType: string; text: string };
-type ResourceHandler = () => Promise<ResourceReadResult>;
-
-function jsonResult(uri: string, data: unknown): ResourceReadResult {
-  return { uri, mimeType: "application/json", text: JSON.stringify(data, null, 2) };
-}
-
-export function manduResourceHandlers(projectRoot: string): Record<string, ResourceHandler> {
-  const manifestPath = path.join(projectRoot, ".mandu", "routes.manifest.json");
-
-  return {
-    "mandu://routes": async () => {
-      const result = await loadManifest(manifestPath);
-      if (!result.success || !result.data) {
-        return jsonResult("mandu://routes", {
-          error: "Failed to load route manifest",
-          details: result.errors,
-          hint: "Run 'mandu generate' or 'mandu dev' to create the manifest.",
-        });
-      }
-      return jsonResult("mandu://routes", {
-        version: result.data.version,
-        routeCount: result.data.routes.length,
-        routes: result.data.routes.map((r) => ({
-          id: r.id, pattern: r.pattern, kind: r.kind, module: r.module,
-          slotModule: r.slotModule ?? null, clientModule: r.clientModule ?? null,
-        })),
-      });
-    },
-
-    "mandu://config": async () => {
-      try {
-        const config = await loadManduConfig(projectRoot);
-        return jsonResult("mandu://config", {
-          server: config.server ?? {},
-          guard: config.guard ?? {},
-          build: config.build ?? {},
-          dev: config.dev ?? {},
-          fsRoutes: config.fsRoutes ?? {},
-          seo: config.seo ?? {},
-        });
-      } catch {
-        const raw = await readConfig(projectRoot);
-        return jsonResult("mandu://config", raw ?? {
-          error: "No mandu.config.ts/js/json found",
-          hint: "Create a mandu.config.ts in the project root.",
-        });
-      }
-    },
-
-    "mandu://errors": async () => {
-      const errors: unknown[] = [];
-
-      // Try Kitchen DevTools error log from running dev server
-      let port: number | undefined;
-      const serverState = getDevServerState();
-      if (serverState) {
-        for (const line of serverState.output) {
-          const m = line.match(/https?:\/\/localhost:(\d+)/);
-          if (m) port = parseInt(m[1], 10);
-        }
-      }
-      if (port) {
-        try {
-          const res = await fetch(`http://localhost:${port}/__kitchen/api/errors`);
-          if (res.ok) {
-            const body = (await res.json()) as { errors: unknown[] };
-            if (body.errors?.length) errors.push(...body.errors);
-          }
-        } catch { /* dev server not reachable */ }
-      }
-
-      // Read local error log file
-      const loggedErrors = await readJsonFile<unknown[]>(
-        path.join(projectRoot, ".mandu", "errors.json"),
-      );
-      if (Array.isArray(loggedErrors)) errors.push(...loggedErrors);
-
-      return jsonResult("mandu://errors", {
-        count: errors.length,
-        errors,
-        source: port ? "kitchen+log" : "log",
-      });
-    },
-  };
-}
+/**
+ * MCP Resources for Mandu Framework
+ *
+ * Project state data exposed via the MCP resource protocol.
+ */
+
+import type { Resource } from "@modelcontextprotocol/sdk/types.js";
+import path from "path";
+import { readConfig, readJsonFile } from "./utils/project.js";
+import { loadManduConfig, loadManifest } from "@mandujs/core";
+import { eventBus } from "@mandujs/core/observability";
+import { getDevServerState } from "./tools/project.js";
+
+export const manduResourceDefinitions: Resource[] = [
+  {
+    uri: "mandu://routes",
+    name: "Route Manifest",
+    description: "Current project route manifest (JSON)",
+    mimeType: "application/json",
+  },
+  {
+    uri: "mandu://config",
+    name: "Mandu Config",
+    description: "Parsed mandu.config.ts settings",
+    mimeType: "application/json",
+  },
+  {
+    uri: "mandu://errors",
+    name: "Recent Errors",
+    description: "Recent build and runtime errors",
+    mimeType: "application/json",
+  },
+  {
+    uri: "mandu://activity",
+    name: "Recent Activity",
+    description: "Recent observability events (HTTP, MCP, Guard) from EventBus + 5-minute stats",
+    mimeType: "application/json",
+  },
+];
+
+type ResourceReadResult = { uri: string; mimeType: string; text: string };
+type ResourceHandler = () => Promise<ResourceReadResult>;
+
+function jsonResult(uri: string, data: unknown): ResourceReadResult {
+  return { uri, mimeType: "application/json", text: JSON.stringify(data, null, 2) };
+}
+
+export function manduResourceHandlers(projectRoot: string): Record<string, ResourceHandler> {
+  const manifestPath = path.join(projectRoot, ".mandu", "routes.manifest.json");
+
+  return {
+    "mandu://routes": async () => {
+      const result = await loadManifest(manifestPath);
+      if (!result.success || !result.data) {
+        return jsonResult("mandu://routes", {
+          error: "Failed to load route manifest",
+          details: result.errors,
+          hint: "Run 'mandu generate' or 'mandu dev' to create the manifest.",
+        });
+      }
+      return jsonResult("mandu://routes", {
+        version: result.data.version,
+        routeCount: result.data.routes.length,
+        routes: result.data.routes.map((r) => ({
+          id: r.id, pattern: r.pattern, kind: r.kind, module: r.module,
+          slotModule: r.slotModule ?? null, clientModule: r.clientModule ?? null,
+        })),
+      });
+    },
+
+    "mandu://config": async () => {
+      try {
+        const config = await loadManduConfig(projectRoot);
+        return jsonResult("mandu://config", {
+          server: config.server ?? {},
+          guard: config.guard ?? {},
+          build: config.build ?? {},
+          dev: config.dev ?? {},
+          fsRoutes: config.fsRoutes ?? {},
+          seo: config.seo ?? {},
+        });
+      } catch {
+        const raw = await readConfig(projectRoot);
+        return jsonResult("mandu://config", raw ?? {
+          error: "No mandu.config.ts/js/json found",
+          hint: "Create a mandu.config.ts in the project root.",
+        });
+      }
+    },
+
+    "mandu://activity": async () => {
+      // Phase 5-3: AI 에이전트가 EventBus 활동을 직접 조회 가능
+      const recent = eventBus.getRecent(20);
+      const stats = eventBus.getStats(5 * 60 * 1000); // last 5 minutes
+      return jsonResult("mandu://activity", {
+        recent: recent.map((e) => ({
+          ts: new Date(e.timestamp).toISOString(),
+          type: e.type,
+          severity: e.severity,
+          source: e.source,
+          message: e.message,
+          duration: e.duration,
+          correlationId: e.correlationId,
+        })),
+        stats,
+        windowMs: 5 * 60 * 1000,
+      });
+    },
+
+    "mandu://errors": async () => {
+      const errors: unknown[] = [];
+
+      // Try Kitchen DevTools error log from running dev server
+      let port: number | undefined;
+      const serverState = getDevServerState();
+      if (serverState) {
+        for (const line of serverState.output) {
+          const m = line.match(/https?:\/\/localhost:(\d+)/);
+          if (m) port = parseInt(m[1], 10);
+        }
+      }
+      if (port) {
+        try {
+          const res = await fetch(`http://localhost:${port}/__kitchen/api/errors`);
+          if (res.ok) {
+            const body = (await res.json()) as { errors: unknown[] };
+            if (body.errors?.length) errors.push(...body.errors);
+          }
+        } catch { /* dev server not reachable */ }
+      }
+
+      // Read local error log file
+      const loggedErrors = await readJsonFile<unknown[]>(
+        path.join(projectRoot, ".mandu", "errors.json"),
+      );
+      if (Array.isArray(loggedErrors)) errors.push(...loggedErrors);
+
+      return jsonResult("mandu://errors", {
+        count: errors.length,
+        errors,
+        source: port ? "kitchen+log" : "log",
+      });
+    },
+  };
+}