@mcpcloud/cli 0.7.0-next-20260628020545 → 0.8.0-next-20260701231709

package/dist/index.js

@@ -4691,6 +4691,52 @@ function registerServerLifecycleCommands(servers) {
     if (opts.wait && !waitDone)
       throw new CliExitError(1);
   }));
+  servers.command("regenerate <serverId>").description("Re-fetch a server's source spec and rebuild its tools with the current codegen (preserves customizations). Wraps POST /api/v1/server/regenerate.").option("--org <organizationId>", "Organization ID").option("--project <projectId>", "Project ID (defaults to the server's project)").option("--source-url <url>", "Override the stored spec source URL (needed for GraphQL servers whose introspection endpoint wasn't persisted)").addHelpText("after", [
+    "",
+    "Regenerate re-introspects/re-parses the source and rebuilds each tool with",
+    "the current codegen, so codegen fixes reach existing servers. It does not",
+    "deploy — run `mcp servers deploy` afterwards to ship the rebuilt bundle.",
+    "",
+    "Examples:",
+    "  # Propagate codegen fixes into an existing server, then deploy:",
+    "  $ mcp servers regenerate srv_123 && mcp servers deploy srv_123 --wait",
+    "",
+    "  # GraphQL server whose introspection endpoint must be supplied:",
+    "  $ mcp servers regenerate srv_123 --source-url https://api.example.com/graphql"
+  ].join(`
+`)).action(runAction(async (serverId, opts) => {
+    const orgId = await resolveOrgId(opts.org);
+    let projectId = opts.project;
+    if (!projectId) {
+      const serverData = await api.get("/api/v1/server", { organizationId: orgId, serverId });
+      projectId = serverData.server.projectId;
+    }
+    if (!isJsonMode()) {
+      printStep(`Regenerating ${c.bold(serverId)} from its source spec…`);
+    }
+    const data = await api.post("/api/v1/server/regenerate", {
+      organizationId: orgId,
+      projectId,
+      serverId,
+      ...opts.sourceUrl ? { sourceUrl: opts.sourceUrl } : {}
+    });
+    const r = data.regeneration;
+    if (isJsonMode()) {
+      printJson({ regeneration: r });
+      return;
+    }
+    printSuccess(`Regenerated ${c.bold(serverId)} (${r.sourceType}).`);
+    printKeyValue({
+      "tools updated": String(r.updated),
+      "tools added": String(r.inserted),
+      "tools dropped from spec": String(r.removed),
+      generation: r.generationStatus
+    });
+    if (r.removed > 0) {
+      printInfo(c.dim(`  → ${r.removed} operation(s) no longer in the spec were kept, not deleted (removal stays a manual action): ${r.removedKeys.slice(0, 5).join(", ")}`));
+    }
+    printInfo(c.dim(`  → run \`mcp servers deploy ${serverId} --wait\` to ship the regenerated bundle.`));
+  }));
 }
 
 // src/commands/servers-mutations.ts
@@ -4901,6 +4947,12 @@ function looksLikeGraphql(spec) {
 }
 async function readSpecSource(spec, override, options = {}) {
   const trimmedSpec = spec.trim();
+  if (override === "graphql") {
+    if (!isHttpUrl(trimmedSpec)) {
+      throw new Error("--source-type graphql requires the GraphQL endpoint URL to introspect " + `(e.g. --spec https://api.example.com/graphql), got: ${spec}`);
+    }
+    return { sourceType: "graphql", sourceUrl: trimmedSpec };
+  }
   if (override === "url" || !override && isHttpUrl(trimmedSpec)) {
     if (!isHttpUrl(trimmedSpec)) {
       throw new Error(`--source-type url requires an http(s) --spec URL, got: ${spec}`);
@@ -4923,15 +4975,12 @@ async function readSpecSource(spec, override, options = {}) {
   if (!content.trim()) {
     throw new Error("The spec is empty — nothing to ingest.");
   }
-  let sourceType;
-  if (override === "openapi" || override === "graphql") {
-    sourceType = override;
-  } else if (/\.(graphql|gql)$/i.test(pathHint) || looksLikeGraphql(content)) {
-    sourceType = "graphql";
-  } else {
-    sourceType = "openapi";
+  if (override !== "openapi") {
+    if (/\.(graphql|gql)$/i.test(pathHint) || looksLikeGraphql(content)) {
+      throw new Error("This looks like a GraphQL schema. Import GraphQL from its endpoint URL: " + "`--spec https://api.example.com/graphql --source-type graphql` " + "(SDL-file import is not supported).");
+    }
   }
-  return { sourceType, rawSpec: content };
+  return { sourceType: "openapi", rawSpec: content };
 }
 function buildIngestBody(args) {
   const body = {
@@ -4939,10 +4988,10 @@ function buildIngestBody(args) {
     projectId: args.projectId,
     sourceType: args.payload.sourceType
   };
-  if (args.payload.sourceType === "url") {
-    body["sourceUrl"] = args.payload.sourceUrl;
-  } else {
+  if (args.payload.sourceType === "openapi") {
     body["rawSpec"] = args.payload.rawSpec;
+  } else {
+    body["sourceUrl"] = args.payload.sourceUrl;
   }
   return body;
 }
@@ -4977,12 +5026,13 @@ function validateSourceType(value) {
   return v;
 }
 function registerServerSpecCommands(servers) {
-  servers.command("ingest").description("Create a server from an OpenAPI/GraphQL spec (file, URL, or @- stdin). Wraps POST /api/v1/server/ingest.").requiredOption("--project <projectId>", "Project to create the server in").requiredOption("--spec <file|url>", "Spec source: a local file, an http(s) URL (fetched server-side), or @- for stdin").option("--org <organizationId>", "Organization ID").option("--source-type <type>", `Override spec classification: ${SOURCE_TYPES.join(" | ")} (auto-detected by default)`).addHelpText("after", [
+  servers.command("ingest").description("Create a server from an OpenAPI spec (file, URL, or @- stdin) or a GraphQL endpoint. Wraps POST /api/v1/server/ingest.").requiredOption("--project <projectId>", "Project to create the server in").requiredOption("--spec <file|url>", "OpenAPI spec (local file, http(s) URL, or @- for stdin), or — with --source-type graphql — the GraphQL endpoint URL to introspect").option("--org <organizationId>", "Organization ID").option("--source-type <type>", `Override spec classification: ${SOURCE_TYPES.join(" | ")} (OpenAPI auto-detected; graphql requires an endpoint URL)`).addHelpText("after", [
     "",
     "Examples:",
     "  $ mcp servers ingest --project proj_123 --spec ./openapi.yaml",
     "  $ mcp servers ingest --project proj_123 --spec https://api.example.com/openapi.json",
-    "  $ cat schema.graphql | mcp servers ingest --project proj_123 --spec @-"
+    "  # GraphQL: introspect a live endpoint (POST) — pass the URL, not SDL.",
+    "  $ mcp servers ingest --project proj_123 --spec https://api.example.com/graphql --source-type graphql"
   ].join(`
 `)).action(runAction(async (opts) => {
     const orgId = await resolveOrgId(opts.org);
@@ -29822,7 +29872,7 @@ async function pickServerName(override) {
   return name;
 }
 function registerInitCommand(program2) {
-  program2.command("init").description("Guided onboarding: pick org → pick/create project → create a server (empty skeleton, or generated from an OpenAPI/GraphQL spec via --from-spec)").option("--org <organizationId>", "Organization ID").option("--project <projectId>", "Reuse an existing project instead of creating one").option("--name <serverName>", "Name for the new server (skeleton path only)").option("--from-spec <file|url>", "Build the server from an OpenAPI/GraphQL spec: a local file, http(s) URL (fetched server-side), or @- for stdin").option("--source-type <type>", `Override spec classification: ${SOURCE_TYPES.join(" | ")} (auto-detected by default)`).option("--deploy", "After importing the spec, deploy the server").option("--wait", "With --deploy, follow events until the deploy is terminal").option("--wait-timeout <seconds>", "Max seconds to wait for a terminal deploy state (default 300)", "300").addHelpText("after", [
+  program2.command("init").description("Guided onboarding: pick org → pick/create project → create a server (empty skeleton, or generated from an OpenAPI/GraphQL spec via --from-spec)").option("--org <organizationId>", "Organization ID").option("--project <projectId>", "Reuse an existing project instead of creating one").option("--name <serverName>", "Name for the new server (skeleton path only)").option("--from-spec <file|url>", "Build from an OpenAPI spec (local file, http(s) URL, or @- for stdin), or — with --source-type graphql — a GraphQL endpoint URL to introspect").option("--source-type <type>", `Override spec classification: ${SOURCE_TYPES.join(" | ")} (OpenAPI auto-detected; graphql requires an endpoint URL)`).option("--deploy", "After importing the spec, deploy the server").option("--wait", "With --deploy, follow events until the deploy is terminal").option("--wait-timeout <seconds>", "Max seconds to wait for a terminal deploy state (default 300)", "300").addHelpText("after", [
     "",
     "Two modes:",
     "  Skeleton (default): resolve org → pick/create project → create an empty server.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpcloud/cli",
-  "version": "0.7.0-next-20260628020545",
+  "version": "0.8.0-next-20260701231709",
   "description": "The official CLI for MCPCloud — manage projects, servers, skills, and API keys from the terminal",
   "type": "module",
   "bin": {