@mandujs/mcp 0.9.10 → 0.9.12

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "@mandujs/mcp",
-  "version": "0.9.10",
-  "description": "Mandu MCP Server - Agent-native interface for Mandu framework operations",
-  "type": "module",
-  "main": "./src/index.ts",
-  "bin": {
-    "mandu-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": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@mandujs/core": "^0.9.10",
-    "@modelcontextprotocol/sdk": "^1.25.3"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
-  }
-}
+{
+  "name": "@mandujs/mcp",
+  "version": "0.9.12",
+  "description": "Mandu MCP Server - Agent-native interface for Mandu framework operations",
+  "type": "module",
+  "main": "./src/index.ts",
+  "bin": {
+    "mandu-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": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mandujs/core": "^0.9.12",
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/src/resources/handlers.ts

@@ -2,6 +2,7 @@ import type { Resource } from "@modelcontextprotocol/sdk/types.js";
 import {
   loadManifest,
   getTransactionStatus,
+  getWatcher,
   type GeneratedMap,
   type SpecLock,
 } from "@mandujs/core";
@@ -39,6 +40,18 @@ export const resourceDefinitions: Resource[] = [
     description: "Slot file content for a specific route",
     mimeType: "text/typescript",
   },
+  {
+    uri: "mandu://watch/warnings",
+    name: "Watch Warnings",
+    description: "Recent file watcher warnings (architecture rule violations)",
+    mimeType: "application/json",
+  },
+  {
+    uri: "mandu://watch/status",
+    name: "Watch Status",
+    description: "File watcher status (active/inactive, uptime, rule count)",
+    mimeType: "application/json",
+  },
 ];
 
 type ResourceHandler = (params: Record<string, string>) => Promise<unknown>;
@@ -172,5 +185,44 @@ export function resourceHandlers(
         content,
       };
     },
+
+    "mandu://watch/warnings": async () => {
+      const watcher = getWatcher();
+      if (!watcher) {
+        return { active: false, warnings: [] };
+      }
+
+      const warnings = watcher.getRecentWarnings(50);
+      return {
+        active: true,
+        count: warnings.length,
+        warnings: warnings.map((w) => ({
+          ruleId: w.ruleId,
+          file: w.file,
+          message: w.message,
+          event: w.event,
+          timestamp: w.timestamp.toISOString(),
+        })),
+      };
+    },
+
+    "mandu://watch/status": async () => {
+      const watcher = getWatcher();
+      if (!watcher) {
+        return { active: false };
+      }
+
+      const status = watcher.getStatus();
+      return {
+        active: status.active,
+        rootDir: status.rootDir,
+        fileCount: status.fileCount,
+        warningCount: status.recentWarnings.length,
+        uptime: status.startedAt
+          ? Math.floor((Date.now() - status.startedAt.getTime()) / 1000)
+          : 0,
+        startedAt: status.startedAt?.toISOString() || null,
+      };
+    },
   };
 }

package/src/server.ts

@@ -36,6 +36,7 @@ export class ManduMcpServer {
         capabilities: {
           tools: {},
           resources: {},
+          logging: {},
         },
       }
     );
@@ -68,7 +69,7 @@ export class ManduMcpServer {
       ...slotTools(this.projectRoot),
       ...hydrationTools(this.projectRoot),
       ...contractTools(this.projectRoot),
-      ...brainTools(this.projectRoot),
+      ...brainTools(this.projectRoot, this.server),
     };
   }
 

package/src/tools/brain.ts

@@ -11,6 +11,7 @@
  */
 
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import {
   loadManifest,
   runGuardCheck,
@@ -69,6 +70,16 @@ export const brainToolDefinitions: Tool[] = [
       required: [],
     },
   },
+  {
+    name: "mandu_watch_stop",
+    description:
+      "Stop file watching and clean up MCP notification subscriptions.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
   // Architecture tools (v0.2)
   {
     name: "mandu_check_location",
@@ -126,7 +137,10 @@ export const brainToolDefinitions: Tool[] = [
   },
 ];
 
-export function brainTools(projectRoot: string) {
+/** Module-level unsubscribe handle for MCP warning notifications */
+let mcpWarningUnsubscribe: (() => void) | null = null;
+
+export function brainTools(projectRoot: string, server?: Server) {
   const paths = getProjectPaths(projectRoot);
 
   return {
@@ -221,11 +235,45 @@ export function brainTools(projectRoot: string) {
           debounceMs,
         });
 
+        // Register MCP notification handler
+        let notifications = false;
+        if (server) {
+          // Clean up previous subscription
+          if (mcpWarningUnsubscribe) {
+            mcpWarningUnsubscribe();
+            mcpWarningUnsubscribe = null;
+          }
+
+          mcpWarningUnsubscribe = watcher.onWarning((warning) => {
+            // Push logging message (Claude Code receives in real-time)
+            server.sendLoggingMessage({
+              level: "warning",
+              logger: "mandu-watch",
+              data: {
+                type: "watch_warning",
+                ruleId: warning.ruleId,
+                file: warning.file,
+                message: warning.message,
+                event: warning.event,
+                timestamp: warning.timestamp.toISOString(),
+              },
+            }).catch(() => {});
+
+            // Resource update notification
+            server.sendResourceUpdated({
+              uri: "mandu://watch/warnings",
+            }).catch(() => {});
+          });
+
+          notifications = true;
+        }
+
         const status = watcher.getStatus();
 
         return {
           success: true,
           message: "Watch started successfully",
+          notifications: notifications ? "enabled" : "disabled",
           status: {
             active: status.active,
             rootDir: status.rootDir,
@@ -239,7 +287,8 @@ export function brainTools(projectRoot: string) {
             "CONTRACT_NAMING - Contract 파일 네이밍 규칙",
             "FORBIDDEN_IMPORT - Generated 파일의 금지된 import 감지",
           ],
-          tip: "Watch emits warnings only - it never blocks operations",
+          logFile: ".mandu/watch.log",
+          tip: "Run `tail -f .mandu/watch.log` in another terminal for real-time warnings.",
         };
       } catch (error) {
         return {
@@ -288,6 +337,28 @@ export function brainTools(projectRoot: string) {
       }
     },
 
+    mandu_watch_stop: async () => {
+      try {
+        // Clean up MCP notification subscription
+        if (mcpWarningUnsubscribe) {
+          mcpWarningUnsubscribe();
+          mcpWarningUnsubscribe = null;
+        }
+
+        stopWatcher();
+
+        return {
+          success: true,
+          message: "Watch stopped and notifications cleaned up",
+        };
+      } catch (error) {
+        return {
+          error: "Failed to stop watch",
+          details: error instanceof Error ? error.message : "Unknown error",
+        };
+      }
+    },
+
     // Architecture tools (v0.2)
     mandu_check_location: async (args: Record<string, unknown>) => {
       const { path: filePath, content } = args as {