@mandujs/mcp 0.38.3 → 0.38.5

package/src/tools/ate.ts

@@ -105,11 +105,11 @@ export const ateToolDefinitions: Tool[] = [
           type: "string",
           description: "Dev server URL (default: http://localhost:3333). Must match the running mandu dev server.",
         },
-        ci: { type: "boolean", description: "CI mode: stricter timeouts, no interactive prompts" },
-        timeoutMs: {
-          type: "number",
-          description: "Hard timeout for the whole Playwright process in milliseconds (default: 600000).",
-        },
+        ci: { type: "boolean", description: "CI mode: stricter timeouts, no interactive prompts" },
+        timeoutMs: {
+          type: "number",
+          description: "Hard timeout for the whole Playwright process in milliseconds (default: 600000).",
+        },
         headless: { type: "boolean", description: "Run browsers headlessly (default: true)" },
         browsers: {
           type: "array",
@@ -264,11 +264,11 @@ export const ateToolDefinitions: Tool[] = [
           enum: ["L0", "L1", "L2", "L3"],
           description: "Assertion depth: L0=smoke, L1=HTTP status, L2=contract schema, L3=full behavioral",
         },
-        ci: { type: "boolean", description: "CI mode: stricter timeouts" },
-        timeoutMs: {
-          type: "number",
-          description: "Hard timeout for the whole Playwright process in milliseconds (default: 600000).",
-        },
+        ci: { type: "boolean", description: "CI mode: stricter timeouts" },
+        timeoutMs: {
+          type: "number",
+          description: "Hard timeout for the whole Playwright process in milliseconds (default: 600000).",
+        },
         useImpactAnalysis: {
           type: "boolean",
           description: "Run impact analysis first and only test changed routes (faster in CI)",
@@ -386,7 +386,7 @@ export function ateTools(projectRoot: string, server?: Server) {
       return await ateRun(input);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      const isTimeout = /timeout|timed out|타임아웃/i.test(message);
+      const isTimeout = /timeout|timed out|타임아웃/i.test(message);
       const snap = tracker.snapshot();
       const partial: PartialRunResults = {
         runId: snap.runId ?? `unknown-${Date.now()}`,
@@ -447,21 +447,21 @@ export function ateTools(projectRoot: string, server?: Server) {
         browsers,
         onlyFiles,
         onlyRoutes,
-        grep,
-        timeoutMs,
-        progressToken,
-      } = args as {
+        grep,
+        timeoutMs,
+        progressToken,
+      } = args as {
         repoRoot: string;
         baseURL?: string;
         ci?: boolean;
         headless?: boolean;
         browsers?: ("chromium" | "firefox" | "webkit")[];
         onlyFiles?: string[];
-        onlyRoutes?: string[];
-        grep?: string;
-        timeoutMs?: number;
-        progressToken?: string | number;
-      };
+        onlyRoutes?: string[];
+        grep?: string;
+        timeoutMs?: number;
+        progressToken?: string | number;
+      };
       return await runWithObservability(
         {
           repoRoot,
@@ -469,11 +469,11 @@ export function ateTools(projectRoot: string, server?: Server) {
           ci,
           headless,
           browsers,
-          onlyFiles,
-          onlyRoutes,
-          grep,
-          timeoutMs,
-        },
+          onlyFiles,
+          onlyRoutes,
+          grep,
+          timeoutMs,
+        },
         { progressToken },
       );
     },
@@ -529,10 +529,10 @@ export function ateTools(projectRoot: string, server?: Server) {
     },
     "mandu.ate.auto_pipeline": async (args: Record<string, unknown>) => {
       const {
-        repoRoot, baseURL, oracleLevel, ci, useImpactAnalysis,
-        base, head, autoHeal, tsconfigPath, routeGlobs, buildSalt,
-        timeoutMs,
-      } = args as {
+        repoRoot, baseURL, oracleLevel, ci, useImpactAnalysis,
+        base, head, autoHeal, tsconfigPath, routeGlobs, buildSalt,
+        timeoutMs,
+      } = args as {
         repoRoot: string;
         baseURL?: string;
         oracleLevel?: OracleLevel;
@@ -542,14 +542,14 @@ export function ateTools(projectRoot: string, server?: Server) {
         head?: string;
         autoHeal?: boolean;
         tsconfigPath?: string;
-        routeGlobs?: string[];
-        buildSalt?: string;
-        timeoutMs?: number;
-      };
-      return await runFullPipeline({
-        repoRoot, baseURL, oracleLevel, ci, useImpactAnalysis,
-        base, head, autoHeal, tsconfigPath, routeGlobs, buildSalt, timeoutMs,
-      });
+        routeGlobs?: string[];
+        buildSalt?: string;
+        timeoutMs?: number;
+      };
+      return await runFullPipeline({
+        repoRoot, baseURL, oracleLevel, ci, useImpactAnalysis,
+        base, head, autoHeal, tsconfigPath, routeGlobs, buildSalt, timeoutMs,
+      });
     },
     "mandu.ate.feedback": async (args: Record<string, unknown>) => {
       const { repoRoot, runId, autoApply } = args as {

package/src/tools/composite.ts

@@ -60,10 +60,10 @@ export const compositeToolDefinitions: Tool[] = [
     },
   },
   {
-    name: "mandu.island.add",
-    description:
-      "Create an island component with correct @mandujs/core/client imports and hydration strategy. " +
-      "Generates a .island.tsx file in app/{route}/ with the wrapComponent() island definition.",
+    name: "mandu.island.add",
+    description:
+      "Create an island component with correct @mandujs/core/client imports and hydration strategy. " +
+      "Generates a .island.tsx file in app/{route}/ with the wrapComponent() island definition.",
     annotations: {
       destructiveHint: true,
       readOnlyHint: false,
@@ -474,10 +474,10 @@ function generateMiddlewareSource(preset: string, options: Record<string, string
   return templates[preset] ?? templates.default;
 }
 
-function generateIslandSource(name: string, strategy: string): string {
-  return `"use client";
-import { wrapComponent } from "@mandujs/core/client";
-import { useState } from "react";
+function generateIslandSource(name: string, strategy: string): string {
+  return `"use client";
+import { wrapComponent } from "@mandujs/core/client";
+import { useState } from "react";
 
 interface ${name}Props {
   [key: string]: unknown;
@@ -493,8 +493,8 @@ function ${name}Inner(props: ${name}Props) {
   );
 }
 
-// Route hydration priority should be set on the page/manifest route.
-// Suggested priority for this island: "${strategy}".
-export default wrapComponent(${name}Inner);
-`;
-}
+// Route hydration priority should be set on the page/manifest route.
+// Suggested priority for this island: "${strategy}".
+export default wrapComponent(${name}Inner);
+`;
+}

package/src/tools/hydration.ts

@@ -18,17 +18,17 @@ export const hydrationToolDefinitions: Tool[] = [
     name: "mandu.build",
     description:
       "Build client bundles for hydration. Compiles client slots (.client.ts) into browser-ready JavaScript bundles.",
-    annotations: {
-      destructiveHint: true,
-      readOnlyHint: false,
-      idempotentHint: true,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {
-        minify: {
-          type: "boolean",
-          description: "Minify the output bundles (default: true in production)",
+    annotations: {
+      destructiveHint: true,
+      readOnlyHint: false,
+      idempotentHint: true,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        minify: {
+          type: "boolean",
+          description: "Minify the output bundles (default: true in production)",
         },
         sourcemap: {
           type: "boolean",
@@ -39,67 +39,67 @@ export const hydrationToolDefinitions: Tool[] = [
           items: { type: "string" },
           description:
             "Only rebuild specific islands by routeId. Skips Runtime/Router/Vendor rebuild for faster incremental updates. Omit to rebuild everything.",
-        },
-      },
-      required: [],
-      additionalProperties: false,
-    },
-  },
+        },
+      },
+      required: [],
+      additionalProperties: false,
+    },
+  },
   {
     name: "mandu.build.status",
     description:
       "Get the current build status, bundle manifest, and statistics for client bundles.",
-    annotations: {
-      readOnlyHint: true,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {},
-      required: [],
-      additionalProperties: false,
-    },
-  },
-  {
-    name: "mandu.island.list",
-    description:
-      "Legacy alias for page client mount diagnostics. Prefer mandu.pageClientMount.list for terminology that separates page-level hydration from nested islands.",
-    annotations: {
-      readOnlyHint: true,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {},
-      required: [],
-      additionalProperties: false,
-    },
-  },
-  {
-    name: "mandu.pageClientMount.list",
-    description:
-      "List page-level client mounts: page routes that need a route-level clientModule and bundle. This is distinct from nested islands/partials.",
-    annotations: {
-      readOnlyHint: true,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {},
-      required: [],
-      additionalProperties: false,
-    },
-  },
-  {
-    name: "mandu.hydration.set",
+    annotations: {
+      readOnlyHint: true,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "mandu.island.list",
+    description:
+      "Legacy alias for page client mount diagnostics. Prefer mandu.pageClientMount.list for terminology that separates page-level hydration from nested islands.",
+    annotations: {
+      readOnlyHint: true,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "mandu.pageClientMount.list",
+    description:
+      "List page-level client mounts: page routes that need a route-level clientModule and bundle. This is distinct from nested islands/partials.",
+    annotations: {
+      readOnlyHint: true,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "mandu.hydration.set",
     description:
       "Set hydration configuration for a specific route. Updates the route's hydration strategy and priority.",
-    annotations: {
-      readOnlyHint: false,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {
-        routeId: {
-          type: "string",
-          description: "The route ID to configure",
+    annotations: {
+      readOnlyHint: false,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        routeId: {
+          type: "string",
+          description: "The route ID to configure",
         },
         strategy: {
           type: "string",
@@ -117,25 +117,25 @@ export const hydrationToolDefinitions: Tool[] = [
           type: "boolean",
           description: "Whether to preload the bundle with modulepreload",
         },
-      },
-      required: ["routeId"],
-      additionalProperties: false,
-    },
-  },
-  {
+      },
+      required: ["routeId"],
+      additionalProperties: false,
+    },
+  },
+  {
     name: "mandu.hydration.addClientSlot",
     description:
       "Add a client slot file for a route to enable hydration. Creates the .client.ts file and updates the manifest.",
-    annotations: {
-      destructiveHint: false,
-      readOnlyHint: false,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {
-        routeId: {
-          type: "string",
-          description: "The route ID to add client slot for",
+    annotations: {
+      destructiveHint: false,
+      readOnlyHint: false,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        routeId: {
+          type: "string",
+          description: "The route ID to add client slot for",
         },
         strategy: {
           type: "string",
@@ -147,14 +147,14 @@ export const hydrationToolDefinitions: Tool[] = [
           enum: ["immediate", "visible", "idle", "interaction"],
           description: "Hydration priority (default: visible)",
         },
-      },
-      required: ["routeId"],
-      additionalProperties: false,
-    },
-  },
-];
-
-export function hydrationTools(projectRoot: string) {
+      },
+      required: ["routeId"],
+      additionalProperties: false,
+    },
+  },
+];
+
+export function hydrationTools(projectRoot: string) {
   const paths = getProjectPaths(projectRoot);
 
   const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {
@@ -234,76 +234,76 @@ export function hydrationTools(projectRoot: string) {
       };
     },
 
-    "mandu.pageClientMount.list": async () => {
-      // Load manifest
-      const manifestResult = await loadManifest(paths.manifestPath);
-      if (!manifestResult.success || !manifestResult.data) {
-        return { error: manifestResult.errors };
-      }
-
-      const pageClientMounts = manifestResult.data.routes
-        .filter((route) => route.kind === "page")
-        .map((route) => {
-          const hydration = getRouteHydration(route);
-          const needsClientMount = needsHydration(route);
-          const warning = needsClientMount && !route.clientModule
-            ? `Route has hydration strategy '${hydration.strategy}' but no clientModule; build would emit no route bundle.`
-            : null;
-
-          return {
-            routeId: route.id,
-            pattern: route.pattern,
-            hasClientModule: !!route.clientModule,
-            clientModule: route.clientModule || null,
-            needsClientMount,
-            // Backward compatibility for older agents that read `isIsland`.
-            isIsland: needsClientMount,
-            status: needsClientMount ? (route.clientModule ? "ready" : "broken") : "static",
-            warning,
-            hydration: {
-              strategy: hydration.strategy,
-              priority: hydration.priority,
+    "mandu.pageClientMount.list": async () => {
+      // Load manifest
+      const manifestResult = await loadManifest(paths.manifestPath);
+      if (!manifestResult.success || !manifestResult.data) {
+        return { error: manifestResult.errors };
+      }
+
+      const pageClientMounts = manifestResult.data.routes
+        .filter((route) => route.kind === "page")
+        .map((route) => {
+          const hydration = getRouteHydration(route);
+          const needsClientMount = needsHydration(route);
+          const warning = needsClientMount && !route.clientModule
+            ? `Route has hydration strategy '${hydration.strategy}' but no clientModule; build would emit no route bundle.`
+            : null;
+
+          return {
+            routeId: route.id,
+            pattern: route.pattern,
+            hasClientModule: !!route.clientModule,
+            clientModule: route.clientModule || null,
+            needsClientMount,
+            // Backward compatibility for older agents that read `isIsland`.
+            isIsland: needsClientMount,
+            status: needsClientMount ? (route.clientModule ? "ready" : "broken") : "static",
+            warning,
+            hydration: {
+              strategy: hydration.strategy,
+              priority: hydration.priority,
               preload: hydration.preload,
-            },
-          };
-        });
-
-      const pageClientMountCount = pageClientMounts.filter((i) => i.needsClientMount).length;
-      const staticCount = pageClientMounts.filter((i) => !i.needsClientMount).length;
-      const activeMounts = pageClientMounts.filter((i) => i.needsClientMount);
-      const staticPages = pageClientMounts.filter((i) => !i.needsClientMount);
-
-      return {
-        terminology: {
-          pageClientMount:
-            "A page route whose whole page is hydrated from a route-level clientModule and route bundle.",
-          island:
-            "A nested or route-local island bundle, distinct from page client mounts. Use mandu.runtime.status for both collections.",
-        },
-        totalPages: pageClientMounts.length,
-        pageClientMountCount,
-        staticCount,
-        pageClientMounts: activeMounts,
-        staticPages,
-        // Backward compatibility for older clients.
-        islandCount: pageClientMountCount,
-        islands: activeMounts,
-      };
-    },
-
-    "mandu.island.list": async () => handlers["mandu.pageClientMount.list"]({}),
-
-    "mandu.hydration.set": async (args: Record<string, unknown>) => {
-      const validationError = validateRouteIdArgs(
-        args,
-        "mandu.hydration.set",
-        ["routeId", "strategy", "priority", "preload"],
-      );
-      if (validationError) return { error: validationError };
-
-      const { routeId, strategy, priority, preload } = args as {
-        routeId: string;
-        strategy?: SpecHydrationStrategy;
+            },
+          };
+        });
+
+      const pageClientMountCount = pageClientMounts.filter((i) => i.needsClientMount).length;
+      const staticCount = pageClientMounts.filter((i) => !i.needsClientMount).length;
+      const activeMounts = pageClientMounts.filter((i) => i.needsClientMount);
+      const staticPages = pageClientMounts.filter((i) => !i.needsClientMount);
+
+      return {
+        terminology: {
+          pageClientMount:
+            "A page route whose whole page is hydrated from a route-level clientModule and route bundle.",
+          island:
+            "A nested or route-local island bundle, distinct from page client mounts. Use mandu.runtime.status for both collections.",
+        },
+        totalPages: pageClientMounts.length,
+        pageClientMountCount,
+        staticCount,
+        pageClientMounts: activeMounts,
+        staticPages,
+        // Backward compatibility for older clients.
+        islandCount: pageClientMountCount,
+        islands: activeMounts,
+      };
+    },
+
+    "mandu.island.list": async () => handlers["mandu.pageClientMount.list"]({}),
+
+    "mandu.hydration.set": async (args: Record<string, unknown>) => {
+      const validationError = validateRouteIdArgs(
+        args,
+        "mandu.hydration.set",
+        ["routeId", "strategy", "priority", "preload"],
+      );
+      if (validationError) return { error: validationError };
+
+      const { routeId, strategy, priority, preload } = args as {
+        routeId: string;
+        strategy?: SpecHydrationStrategy;
         priority?: HydrationPriority;
         preload?: boolean;
       };
@@ -357,19 +357,19 @@ export function hydrationTools(projectRoot: string) {
         newHydration,
         message: `Updated hydration config for ${routeId}`,
       };
-    },
-
-    "mandu.hydration.addClientSlot": async (args: Record<string, unknown>) => {
-      const validationError = validateRouteIdArgs(
-        args,
-        "mandu.hydration.addClientSlot",
-        ["routeId", "strategy", "priority"],
-      );
-      if (validationError) return { error: validationError };
-
-      const { routeId, strategy = "island", priority = "visible" } = args as {
-        routeId: string;
-        strategy?: SpecHydrationStrategy;
+    },
+
+    "mandu.hydration.addClientSlot": async (args: Record<string, unknown>) => {
+      const validationError = validateRouteIdArgs(
+        args,
+        "mandu.hydration.addClientSlot",
+        ["routeId", "strategy", "priority"],
+      );
+      if (validationError) return { error: validationError };
+
+      const { routeId, strategy = "island", priority = "visible" } = args as {
+        routeId: string;
+        strategy?: SpecHydrationStrategy;
         priority?: HydrationPriority;
       };
 
@@ -449,31 +449,31 @@ export function hydrationTools(projectRoot: string) {
   };
 
   // Backward-compatible aliases (deprecated)
-  handlers["mandu_build"] = handlers["mandu.build"];
-  handlers["mandu_build_status"] = handlers["mandu.build.status"];
-  handlers["mandu_list_islands"] = handlers["mandu.island.list"];
-  handlers["mandu_page_client_mount_list"] = handlers["mandu.pageClientMount.list"];
-  handlers["mandu_set_hydration"] = handlers["mandu.hydration.set"];
-  handlers["mandu_hydration_set"] = handlers["mandu.hydration.set"];
-  handlers["mandu_add_client_slot"] = handlers["mandu.hydration.addClientSlot"];
-  handlers["mandu_hydration_add_client_slot"] = handlers["mandu.hydration.addClientSlot"];
-
-  return handlers;
-}
-
-function validateRouteIdArgs(
-  args: Record<string, unknown>,
-  toolName: string,
-  allowedKeys: readonly string[],
-): string | null {
-  if (typeof args.routeId !== "string" || args.routeId.trim().length === 0) {
-    const allowed = new Set(allowedKeys);
-    const unknownKeys = Object.keys(args).filter((key) => !allowed.has(key));
-    const got = unknownKeys.length > 0 ? ` (got unknown key${unknownKeys.length === 1 ? "" : "s"} '${unknownKeys.join("', '")}')` : "";
-    return `${toolName}: missing required parameter 'routeId'${got}`;
-  }
-  return null;
-}
+  handlers["mandu_build"] = handlers["mandu.build"];
+  handlers["mandu_build_status"] = handlers["mandu.build.status"];
+  handlers["mandu_list_islands"] = handlers["mandu.island.list"];
+  handlers["mandu_page_client_mount_list"] = handlers["mandu.pageClientMount.list"];
+  handlers["mandu_set_hydration"] = handlers["mandu.hydration.set"];
+  handlers["mandu_hydration_set"] = handlers["mandu.hydration.set"];
+  handlers["mandu_add_client_slot"] = handlers["mandu.hydration.addClientSlot"];
+  handlers["mandu_hydration_add_client_slot"] = handlers["mandu.hydration.addClientSlot"];
+
+  return handlers;
+}
+
+function validateRouteIdArgs(
+  args: Record<string, unknown>,
+  toolName: string,
+  allowedKeys: readonly string[],
+): string | null {
+  if (typeof args.routeId !== "string" || args.routeId.trim().length === 0) {
+    const allowed = new Set(allowedKeys);
+    const unknownKeys = Object.keys(args).filter((key) => !allowed.has(key));
+    const got = unknownKeys.length > 0 ? ` (got unknown key${unknownKeys.length === 1 ? "" : "s"} '${unknownKeys.join("', '")}')` : "";
+    return `${toolName}: missing required parameter 'routeId'${got}`;
+  }
+  return null;
+}
 
 /**
  * Generate a client slot template