@mandujs/mcp 0.38.11 → 0.39.0-beta.1

package/src/tools/generate.ts

@@ -1,7 +1,8 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { generateManifest, loadManifest, parseResourceSchema, generateResourceArtifacts } from "@mandujs/core";
-import { generateRoutes, type GeneratedMap } from "@mandujs/core/generator";
-import { GENERATED_RELATIVE_PATHS } from "@mandujs/core/paths";
+import { generateManifest, loadManifest } from "@mandujs/core";
+import { parseResourceSchema, generateResourceArtifacts } from "@mandujs/core/compat/resource/index";
+import { generateRoutes, type GeneratedMap } from "@mandujs/core/compat/generator/index";
+import { GENERATED_RELATIVE_PATHS } from "@mandujs/core/compat/paths";
 import { getProjectPaths, readJsonFile } from "../utils/project.js";
 import path from "path";
 import fs from "fs/promises";

package/src/tools/guard.ts

@@ -18,7 +18,7 @@ import {
   type GuardPreset,
   type Violation,
 } from "@mandujs/core";
-import type { GeneratedMap } from "@mandujs/core/generator";
+import type { GeneratedMap } from "@mandujs/core/compat/generator/index";
 import { getProjectPaths, readJsonFile, readConfig } from "../utils/project.js";
 import fs from "fs/promises";
 import path from "path";

package/src/tools/history.ts

@@ -4,7 +4,7 @@ import {
   pruneHistory,
   getChangeStats,
   readSnapshotById,
-} from "@mandujs/core/change";
+} from "@mandujs/core/compat/change/index";
 
 export const historyToolDefinitions: Tool[] = [
   {

package/src/tools/hydration.ts

@@ -7,7 +7,7 @@ import {
   type HydrationPriority,
   type HydrationConfig,
 } from "@mandujs/core";
-import { buildClientBundles, formatSize, type BundleManifest } from "@mandujs/core/bundler";
+import { buildClientBundles, formatSize, type BundleManifest } from "@mandujs/core/compat/bundler/index";
 import { getProjectPaths, readJsonFile, writeJsonFile } from "../utils/project.js";
 import path from "path";
 
@@ -232,39 +232,39 @@ 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 bundleManifest = await readJsonFile<BundleManifest>(
-        path.join(projectRoot, ".mandu", "manifest.json"),
-      );
-      const partialBoundaryCount = Object.keys(bundleManifest?.partials ?? {}).length;
-
-      const pageClientMounts = manifestResult.data.routes
-        .filter((route) => route.kind === "page")
-        .map((route) => {
-          const hydration = getRouteHydration(route);
-          const needsClientMount = needsHydration(route);
-          const clientBoundaryCount = route.boundaries?.length ?? 0;
-          const hasRouteLevelClientMount = needsClientMount && !!route.clientModule;
-          const warning = needsClientMount && !route.clientModule
-            ? `Route has hydration strategy '${hydration.strategy}' but no clientModule; build would emit no route bundle.`
-            : null;
-
+    "mandu.pageClientMount.list": async () => {
+      // Load manifest
+      const manifestResult = await loadManifest(paths.manifestPath);
+      if (!manifestResult.success || !manifestResult.data) {
+        return { error: manifestResult.errors };
+      }
+      const bundleManifest = await readJsonFile<BundleManifest>(
+        path.join(projectRoot, ".mandu", "manifest.json"),
+      );
+      const partialBoundaryCount = Object.keys(bundleManifest?.partials ?? {}).length;
+
+      const pageClientMounts = manifestResult.data.routes
+        .filter((route) => route.kind === "page")
+        .map((route) => {
+          const hydration = getRouteHydration(route);
+          const needsClientMount = needsHydration(route);
+          const clientBoundaryCount = route.boundaries?.length ?? 0;
+          const hasRouteLevelClientMount = needsClientMount && !!route.clientModule;
+          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,
-            hasRouteLevelClientMount,
-            clientBoundaryCount,
-            // Backward compatibility for older agents that read `isIsland`.
-            isIsland: needsClientMount,
-            status: needsClientMount ? (route.clientModule ? "ready" : "broken") : "static",
+            pattern: route.pattern,
+            hasClientModule: !!route.clientModule,
+            clientModule: route.clientModule || null,
+            needsClientMount,
+            hasRouteLevelClientMount,
+            clientBoundaryCount,
+            // Backward compatibility for older agents that read `isIsland`.
+            isIsland: needsClientMount,
+            status: needsClientMount ? (route.clientModule ? "ready" : "broken") : "static",
             warning,
             hydration: {
               strategy: hydration.strategy,
@@ -274,38 +274,38 @@ export function hydrationTools(projectRoot: string) {
           };
         });
 
-      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);
-      const clientBoundaryCount = pageClientMounts.reduce(
-        (count, route) => count + route.clientBoundaryCount,
-        0,
-      );
-
-      return {
-        terminology: {
-          pageClientMount:
-            "A page route whose whole page is hydrated from a route-level clientModule and route bundle.",
-          clientBoundary:
-            "A compiler-discovered nested client component marker recorded on RouteSpec.boundaries.",
-          partialBoundary:
-            "A legacy/runtime partial bundle listed in .mandu/manifest.json partials.",
-          island:
-            "Legacy umbrella term. Prefer pageClientMount, clientBoundary, or partialBoundary for precise reports.",
-        },
-        boundarySummary: {
-          clientBoundaryCount,
-          partialBoundaryCount,
-          pageClientMountCount,
-        },
-        totalPages: pageClientMounts.length,
-        pageClientMountCount,
-        clientBoundaryCount,
-        partialBoundaryCount,
-        staticCount,
-        pageClientMounts: activeMounts,
-        staticPages,
+      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);
+      const clientBoundaryCount = pageClientMounts.reduce(
+        (count, route) => count + route.clientBoundaryCount,
+        0,
+      );
+
+      return {
+        terminology: {
+          pageClientMount:
+            "A page route whose whole page is hydrated from a route-level clientModule and route bundle.",
+          clientBoundary:
+            "A compiler-discovered nested client component marker recorded on RouteSpec.boundaries.",
+          partialBoundary:
+            "A legacy/runtime partial bundle listed in .mandu/manifest.json partials.",
+          island:
+            "Legacy umbrella term. Prefer pageClientMount, clientBoundary, or partialBoundary for precise reports.",
+        },
+        boundarySummary: {
+          clientBoundaryCount,
+          partialBoundaryCount,
+          pageClientMountCount,
+        },
+        totalPages: pageClientMounts.length,
+        pageClientMountCount,
+        clientBoundaryCount,
+        partialBoundaryCount,
+        staticCount,
+        pageClientMounts: activeMounts,
+        staticPages,
         // Backward compatibility for older clients.
         islandCount: pageClientMountCount,
         islands: activeMounts,

package/src/tools/index.ts

@@ -28,46 +28,14 @@ export { brainTools, brainToolDefinitions } from "./brain.js";
 export { runtimeTools, runtimeToolDefinitions } from "./runtime.js";
 export { seoTools, seoToolDefinitions } from "./seo.js";
 export { projectTools, projectToolDefinitions, getDevServerState } from "./project.js";
-export { ateTools, ateToolDefinitions, atePhase5ToolDefinitions, createAtePhase5Handlers } from "./ate.js";
-export { ateContextTools, ateContextToolDefinitions } from "./ate-context.js";
-export { ateRunTools, ateRunToolDefinitions } from "./ate-run.js";
-export { ateFlakesTools, ateFlakesToolDefinitions } from "./ate-flakes.js";
-export { atePromptTools, atePromptToolDefinitions } from "./ate-prompt.js";
-export { ateExemplarTools, ateExemplarToolDefinitions } from "./ate-exemplar.js";
-export { ateSaveTools, ateSaveToolDefinitions } from "./ate-save.js";
-export { ateBoundaryProbeTools, ateBoundaryProbeToolDefinitions } from "./ate-boundary-probe.js";
-export { ateRecallTools, ateRecallToolDefinitions } from "./ate-recall.js";
-export { ateRememberTools, ateRememberToolDefinitions } from "./ate-remember.js";
-export { ateCoverageTools, ateCoverageToolDefinitions } from "./ate-coverage.js";
-// Phase C tool suite
-export { ateMutateTools, ateMutateToolDefinitions } from "./ate-mutate.js";
-export {
-  ateMutationReportTools,
-  ateMutationReportToolDefinitions,
-} from "./ate-mutation-report.js";
-export {
-  ateOraclePendingTools,
-  ateOraclePendingToolDefinitions,
-} from "./ate-oracle-pending.js";
-export {
-  ateOracleVerdictTools,
-  ateOracleVerdictToolDefinitions,
-} from "./ate-oracle-verdict.js";
-export {
-  ateOracleReplayTools,
-  ateOracleReplayToolDefinitions,
-} from "./ate-oracle-replay.js";
 export { resourceTools, resourceToolDefinitions } from "./resource.js";
 export { componentTools, componentToolDefinitions } from "./component.js";
 export { kitchenTools, kitchenToolDefinitions } from "./kitchen.js";
 export { compositeTools, compositeToolDefinitions } from "./composite.js";
 // Phase 14.3 — AI/agent loop-closure tool suite
 export { runTestsTools, runTestsToolDefinitions } from "./run-tests.js";
-export { deployPreviewTools, deployPreviewToolDefinitions } from "./deploy-preview.js";
-export { deployPlanTools, deployPlanToolDefinitions } from "./deploy-plan.js";
 export { designTools, designToolDefinitions } from "./design.js";
 export { aiBriefTools, aiBriefToolDefinitions } from "./ai-brief.js";
-export { loopCloseTools, loopCloseToolDefinitions } from "./loop-close.js";
 // #243 — docs search/get for agents grounding answers in real framework docs
 export { docsTools, docsToolDefinitions } from "./docs.js";
 // #240 guardrail-default — lint run + setup for existing projects
@@ -103,48 +71,13 @@ import { brainTools, brainToolDefinitions } from "./brain.js";
 import { runtimeTools, runtimeToolDefinitions } from "./runtime.js";
 import { seoTools, seoToolDefinitions } from "./seo.js";
 import { projectTools, projectToolDefinitions } from "./project.js";
-import { ateTools, ateToolDefinitions, atePhase5ToolDefinitions, createAtePhase5Handlers } from "./ate.js";
-import { ateContextTools, ateContextToolDefinitions } from "./ate-context.js";
-import { ateRunTools, ateRunToolDefinitions } from "./ate-run.js";
-import { ateFlakesTools, ateFlakesToolDefinitions } from "./ate-flakes.js";
-import { atePromptTools, atePromptToolDefinitions } from "./ate-prompt.js";
-import { ateExemplarTools, ateExemplarToolDefinitions } from "./ate-exemplar.js";
-import { ateSaveTools, ateSaveToolDefinitions } from "./ate-save.js";
-import {
-  ateBoundaryProbeTools,
-  ateBoundaryProbeToolDefinitions,
-} from "./ate-boundary-probe.js";
-import { ateRecallTools, ateRecallToolDefinitions } from "./ate-recall.js";
-import { ateRememberTools, ateRememberToolDefinitions } from "./ate-remember.js";
-import { ateCoverageTools, ateCoverageToolDefinitions } from "./ate-coverage.js";
-// Phase C tool suite
-import { ateMutateTools, ateMutateToolDefinitions } from "./ate-mutate.js";
-import {
-  ateMutationReportTools,
-  ateMutationReportToolDefinitions,
-} from "./ate-mutation-report.js";
-import {
-  ateOraclePendingTools,
-  ateOraclePendingToolDefinitions,
-} from "./ate-oracle-pending.js";
-import {
-  ateOracleVerdictTools,
-  ateOracleVerdictToolDefinitions,
-} from "./ate-oracle-verdict.js";
-import {
-  ateOracleReplayTools,
-  ateOracleReplayToolDefinitions,
-} from "./ate-oracle-replay.js";
 import { resourceTools, resourceToolDefinitions } from "./resource.js";
 import { componentTools, componentToolDefinitions } from "./component.js";
 import { kitchenTools, kitchenToolDefinitions } from "./kitchen.js";
 import { compositeTools, compositeToolDefinitions } from "./composite.js";
 import { runTestsTools, runTestsToolDefinitions } from "./run-tests.js";
-import { deployPreviewTools, deployPreviewToolDefinitions } from "./deploy-preview.js";
-import { deployPlanTools, deployPlanToolDefinitions } from "./deploy-plan.js";
 import { designTools, designToolDefinitions } from "./design.js";
 import { aiBriefTools, aiBriefToolDefinitions } from "./ai-brief.js";
-import { loopCloseTools, loopCloseToolDefinitions } from "./loop-close.js";
 import { docsTools, docsToolDefinitions } from "./docs.js";
 import { lintTools, lintToolDefinitions } from "./lint.js";
 // Phase 18.ι — AI refactor MCP tools
@@ -207,66 +140,15 @@ export const TOOL_MODULES: ToolModule[] = [
   { category: "runtime", definitions: runtimeToolDefinitions, handlers: runtimeTools },
   { category: "seo", definitions: seoToolDefinitions, handlers: seoTools },
   { category: "project", definitions: projectToolDefinitions, handlers: projectTools, requiresServer: true },
-  // ate + ate-run accept an optional Server so notifications/progress
-  // can flow (issue #238). `acceptsServer: true` forwards the server
-  // when available but still registers when it isn't — callers that
-  // boot without an MCP transport get progress no-oped silently.
-  { category: "ate", definitions: ateToolDefinitions, handlers: ateTools, acceptsServer: true },
-  { category: "ate-phase5", definitions: atePhase5ToolDefinitions, handlers: createAtePhase5Handlers },
-  { category: "ate-context", definitions: ateContextToolDefinitions, handlers: ateContextTools },
-  { category: "ate-run", definitions: ateRunToolDefinitions, handlers: ateRunTools, acceptsServer: true },
-  { category: "ate-flakes", definitions: ateFlakesToolDefinitions, handlers: ateFlakesTools },
-  { category: "ate-prompt", definitions: atePromptToolDefinitions, handlers: atePromptTools },
-  { category: "ate-exemplar", definitions: ateExemplarToolDefinitions, handlers: ateExemplarTools },
-  { category: "ate-save", definitions: ateSaveToolDefinitions, handlers: ateSaveTools },
-  // Phase B tool suite
-  {
-    category: "ate-boundary-probe",
-    definitions: ateBoundaryProbeToolDefinitions,
-    handlers: ateBoundaryProbeTools,
-  },
-  { category: "ate-recall", definitions: ateRecallToolDefinitions, handlers: ateRecallTools },
-  { category: "ate-remember", definitions: ateRememberToolDefinitions, handlers: ateRememberTools },
-  {
-    category: "ate-coverage",
-    definitions: ateCoverageToolDefinitions,
-    handlers: ateCoverageTools,
-  },
-  // Phase C tool suite
-  { category: "ate-mutate", definitions: ateMutateToolDefinitions, handlers: ateMutateTools },
-  {
-    category: "ate-mutation-report",
-    definitions: ateMutationReportToolDefinitions,
-    handlers: ateMutationReportTools,
-  },
-  {
-    category: "ate-oracle-pending",
-    definitions: ateOraclePendingToolDefinitions,
-    handlers: ateOraclePendingTools,
-  },
-  {
-    category: "ate-oracle-verdict",
-    definitions: ateOracleVerdictToolDefinitions,
-    handlers: ateOracleVerdictTools,
-  },
-  {
-    category: "ate-oracle-replay",
-    definitions: ateOracleReplayToolDefinitions,
-    handlers: ateOracleReplayTools,
-  },
   { category: "resource", definitions: resourceToolDefinitions, handlers: resourceTools },
   { category: "component", definitions: componentToolDefinitions, handlers: componentTools },
   { category: "kitchen", definitions: kitchenToolDefinitions, handlers: kitchenTools },
   { category: "composite", definitions: compositeToolDefinitions, handlers: compositeTools },
   // Phase 14.3 — AI/agent loop-closure suite
   { category: "run-tests", definitions: runTestsToolDefinitions, handlers: runTestsTools },
-  { category: "deploy-preview", definitions: deployPreviewToolDefinitions, handlers: deployPreviewTools },
-  // #250 — DeployIntent inspection / compile (Phase 1)
-  { category: "deploy-plan", definitions: deployPlanToolDefinitions, handlers: deployPlanTools },
   // #245 M4 — Design system discovery (DESIGN.md / Guard / component inventory)
   { category: "design", definitions: designToolDefinitions, handlers: designTools },
   { category: "ai-brief", definitions: aiBriefToolDefinitions, handlers: aiBriefTools },
-  { category: "loop-close", definitions: loopCloseToolDefinitions, handlers: loopCloseTools },
   { category: "docs", definitions: docsToolDefinitions, handlers: docsTools },
   { category: "lint", definitions: lintToolDefinitions, handlers: lintTools },
   // Phase 18.ι — AI refactor tools (destructive writes; dry-run by default)

package/src/tools/kitchen.ts

@@ -4,10 +4,10 @@
  * Enables any MCP-compatible agent to read client-side errors in real-time.
  */
 
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { loadManduConfig } from "@mandujs/core";
-import { getDevServerState } from "./project.js";
-import { readRuntimeControl } from "../utils/runtime-control.js";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { loadManduConfig } from "@mandujs/core";
+import { getDevServerState } from "./project.js";
+import { readRuntimeControl } from "../utils/runtime-control.js";
 
 export const kitchenToolDefinitions: Tool[] = [
   {
@@ -20,18 +20,18 @@ export const kitchenToolDefinitions: Tool[] = [
     inputSchema: {
       type: "object",
       properties: {
-        clear: {
-          type: "boolean",
-          description: "Clear errors after reading (default: false)",
-        },
-        baseURL: {
-          type: "string",
-          description: "Explicit dev server URL. Overrides runtime-control/config discovery.",
-        },
-        port: {
-          type: "number",
-          description: "Explicit dev server port. Overrides runtime-control/config discovery.",
-        },
+        clear: {
+          type: "boolean",
+          description: "Clear errors after reading (default: false)",
+        },
+        baseURL: {
+          type: "string",
+          description: "Explicit dev server URL. Overrides runtime-control/config discovery.",
+        },
+        port: {
+          type: "number",
+          description: "Explicit dev server port. Overrides runtime-control/config discovery.",
+        },
       },
       required: [],
     },
@@ -56,19 +56,19 @@ export const kitchenToolDefinitions: Tool[] = [
           description:
             "Include the extended diagnose report. Default true. Set false to lower latency when a11y_hints / package_export_gaps are noisy.",
         },
-        includeDiff: {
-          type: "boolean",
-          description:
-            "Include git diff against MANDU_DIFF_BASE (default HEAD). Default true. Set false to skip when git is unavailable.",
-        },
-        baseURL: {
-          type: "string",
-          description: "Explicit dev server URL. Overrides runtime-control/config discovery.",
-        },
-        port: {
-          type: "number",
-          description: "Explicit dev server port. Overrides runtime-control/config discovery.",
-        },
+        includeDiff: {
+          type: "boolean",
+          description:
+            "Include git diff against MANDU_DIFF_BASE (default HEAD). Default true. Set false to skip when git is unavailable.",
+        },
+        baseURL: {
+          type: "string",
+          description: "Explicit dev server URL. Overrides runtime-control/config discovery.",
+        },
+        port: {
+          type: "number",
+          description: "Explicit dev server port. Overrides runtime-control/config discovery.",
+        },
       },
       required: [],
     },
@@ -76,32 +76,32 @@ export const kitchenToolDefinitions: Tool[] = [
 ];
 
 /**
- * Resolve the dev server base URL. Prefers explicit args, then
- * `.mandu/runtime-control.json` from the running dev/start process, then
- * captured stdout, then config/default 3333. Shared by every Kitchen-backed
- * MCP tool so they all agree on where to fetch from.
+ * Resolve the dev server base URL. Prefers explicit args, then
+ * `.mandu/runtime-control.json` from the running dev/start process, then
+ * captured stdout, then config/default 3333. Shared by every Kitchen-backed
+ * MCP tool so they all agree on where to fetch from.
  */
-async function resolveDevServerBaseUrl(
-  projectRoot: string,
-  args: { baseURL?: unknown; port?: unknown } = {},
-): Promise<string> {
-  if (typeof args.baseURL === "string" && args.baseURL.trim()) {
-    return args.baseURL.trim().replace(/\/+$/, "");
-  }
-
-  const explicitPort = normalizePort(args.port);
-  if (explicitPort) {
-    return `http://localhost:${explicitPort}`;
-  }
-
-  const control = await readRuntimeControl(projectRoot);
-  if (control?.baseUrl) {
-    return control.baseUrl.replace(/\/+$/, "");
-  }
-
-  let port: number | undefined;
-
-  const serverState = getDevServerState();
+async function resolveDevServerBaseUrl(
+  projectRoot: string,
+  args: { baseURL?: unknown; port?: unknown } = {},
+): Promise<string> {
+  if (typeof args.baseURL === "string" && args.baseURL.trim()) {
+    return args.baseURL.trim().replace(/\/+$/, "");
+  }
+
+  const explicitPort = normalizePort(args.port);
+  if (explicitPort) {
+    return `http://localhost:${explicitPort}`;
+  }
+
+  const control = await readRuntimeControl(projectRoot);
+  if (control?.baseUrl) {
+    return control.baseUrl.replace(/\/+$/, "");
+  }
+
+  let port: number | undefined;
+
+  const serverState = getDevServerState();
   if (serverState) {
     for (const line of serverState.output) {
       const portMatch = line.match(/https?:\/\/localhost:(\d+)/);
@@ -115,21 +115,21 @@ async function resolveDevServerBaseUrl(
     const config = await loadManduConfig(projectRoot);
     port = config.server?.port ?? 3333;
   }
-
-  return `http://localhost:${port}`;
-}
-
-function normalizePort(value: unknown): number | undefined {
-  const raw = typeof value === "number" ? value : typeof value === "string" ? Number.parseInt(value, 10) : NaN;
-  if (!Number.isInteger(raw) || raw < 1 || raw > 65535) return undefined;
-  return raw;
-}
+
+  return `http://localhost:${port}`;
+}
+
+function normalizePort(value: unknown): number | undefined {
+  const raw = typeof value === "number" ? value : typeof value === "string" ? Number.parseInt(value, 10) : NaN;
+  if (!Number.isInteger(raw) || raw < 1 || raw > 65535) return undefined;
+  return raw;
+}
 
 export function kitchenTools(projectRoot: string) {
   const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {
-    "mandu.kitchen.errors": async (args: Record<string, unknown>) => {
-      const { clear = false } = args as { clear?: boolean };
-      const baseUrl = await resolveDevServerBaseUrl(projectRoot, args);
+    "mandu.kitchen.errors": async (args: Record<string, unknown>) => {
+      const { clear = false } = args as { clear?: boolean };
+      const baseUrl = await resolveDevServerBaseUrl(projectRoot, args);
 
       try {
         // Fetch errors from Kitchen API
@@ -185,12 +185,12 @@ export function kitchenTools(projectRoot: string) {
      */
     "mandu.devtools.context": async (args: Record<string, unknown>) => {
       const {
-        includeBundle = true,
-        includeDiagnose = true,
-        includeDiff = true,
-      } = args as { includeBundle?: boolean; includeDiagnose?: boolean; includeDiff?: boolean };
-
-      const baseUrl = await resolveDevServerBaseUrl(projectRoot, args);
+        includeBundle = true,
+        includeDiagnose = true,
+        includeDiff = true,
+      } = args as { includeBundle?: boolean; includeDiagnose?: boolean; includeDiff?: boolean };
+
+      const baseUrl = await resolveDevServerBaseUrl(projectRoot, args);
       const params = new URLSearchParams();
       if (!includeBundle) params.set("bundle", "0");
       if (!includeDiagnose) params.set("diagnose", "0");