@mandujs/mcp 0.9.15 → 0.9.17

package/package.json

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

package/src/server.ts

@@ -20,6 +20,7 @@ import { contractTools, contractToolDefinitions } from "./tools/contract.js";
 import { brainTools, brainToolDefinitions } from "./tools/brain.js";
 import { resourceHandlers, resourceDefinitions } from "./resources/handlers.js";
 import { findProjectRoot } from "./utils/project.js";
+import { applyWarningInjection } from "./utils/withWarnings.js";
 import { ActivityMonitor } from "./activity-monitor.js";
 import { startWatcher } from "../../core/src/index.js";
 
@@ -64,7 +65,7 @@ export class ManduMcpServer {
   }
 
   private getAllToolHandlers(): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {
-    return {
+    const handlers = {
       ...specTools(this.projectRoot),
       ...generateTools(this.projectRoot),
       ...transactionTools(this.projectRoot),
@@ -75,6 +76,8 @@ export class ManduMcpServer {
       ...contractTools(this.projectRoot),
       ...brainTools(this.projectRoot, this.server, this.monitor),
     };
+
+    return applyWarningInjection(handlers);
   }
 
   private registerToolHandlers(): void {
@@ -221,10 +224,13 @@ export class ManduMcpServer {
           logger: "mandu-watch",
           data: {
             type: "watch_warning",
+            severity: warning.level || "warn",
             ruleId: warning.ruleId,
             file: warning.file,
             message: warning.message,
             event: warning.event,
+            agentAction: warning.agentAction || null,
+            agentCommand: warning.agentCommand || null,
           },
         }).catch(() => {});
       });

package/src/tools/brain.ts

@@ -262,11 +262,14 @@ export function brainTools(projectRoot: string, server?: Server, monitor?: Activ
               logger: "mandu-watch",
               data: {
                 type: "watch_warning",
+                severity: warning.level || "warn",
                 ruleId: warning.ruleId,
                 file: warning.file,
                 message: warning.message,
                 event: warning.event,
                 timestamp: warning.timestamp.toISOString(),
+                agentAction: warning.agentAction || null,
+                agentCommand: warning.agentCommand || null,
               },
             }).catch(() => {});
 

package/src/tools/hydration.ts

@@ -318,8 +318,8 @@ export function hydrationTools(projectRoot: string) {
         };
       }
 
-      // Create client slot file
-      const clientModulePath = `spec/slots/${routeId}.client.ts`;
+      // Create client slot file in apps/web/components/ (not spec/slots/)
+      const clientModulePath = `apps/web/components/${routeId}.client.tsx`;
       const clientFilePath = path.join(projectRoot, clientModulePath);
 
       // Check if file already exists

package/src/utils/withWarnings.ts

@@ -0,0 +1,83 @@
+/**
+ * Watcher Warning Injection for Mutation Tools
+ *
+ * Mutation 도구(write_slot, add_route, generate 등) 실행 후
+ * watcher 경고를 자동으로 응답에 포함시킨다.
+ *
+ * MCP notification이 Claude Code에 전달되지 않는 문제를 해결.
+ */
+
+import { getWatcher } from "../../../core/src/index.js";
+
+const MUTATION_TOOLS = new Set([
+  "mandu_write_slot",
+  "mandu_add_route",
+  "mandu_update_route",
+  "mandu_delete_route",
+  "mandu_generate",
+  "mandu_build",
+  "mandu_commit",
+  "mandu_add_client_slot",
+  "mandu_set_hydration",
+  "mandu_create_contract",
+  "mandu_update_route_contract",
+  "mandu_sync_contract_slot",
+]);
+
+/** watcher debounce(300ms) + 여유분 */
+const WARNING_WAIT_MS = 400;
+
+type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
+
+/**
+ * Mutation 도구 핸들러를 감싸서, 실행 후 발생한 watcher 경고를
+ * 응답 객체의 `_warnings` 필드에 자동 포함시킨다.
+ */
+export function applyWarningInjection(
+  handlers: Record<string, ToolHandler>
+): Record<string, ToolHandler> {
+  const wrapped: Record<string, ToolHandler> = {};
+
+  for (const [name, handler] of Object.entries(handlers)) {
+    if (MUTATION_TOOLS.has(name)) {
+      wrapped[name] = wrapWithWarnings(handler);
+    } else {
+      wrapped[name] = handler;
+    }
+  }
+
+  return wrapped;
+}
+
+function wrapWithWarnings(handler: ToolHandler): ToolHandler {
+  return async (args: Record<string, unknown>) => {
+    const watcher = getWatcher();
+    const beforeCount = watcher?.getRecentWarnings(100).length ?? 0;
+
+    const result = await handler(args);
+
+    // watcher debounce 대기
+    await new Promise((resolve) => setTimeout(resolve, WARNING_WAIT_MS));
+
+    const allWarnings = watcher?.getRecentWarnings(100) ?? [];
+    const newWarnings = allWarnings.slice(beforeCount);
+
+    if (
+      newWarnings.length > 0 &&
+      typeof result === "object" &&
+      result !== null
+    ) {
+      return {
+        ...(result as Record<string, unknown>),
+        _warnings: newWarnings.map((w) => ({
+          ruleId: w.ruleId,
+          file: w.file,
+          message: w.message,
+          level: w.level ?? "warn",
+        })),
+      };
+    }
+
+    return result;
+  };
+}