@mcpcloud/cli 0.7.0-next-20260628020545 → 0.9.1-next-20260709201721

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);
@@ -8766,6 +8816,210 @@ function registerApiKeyCommands(program2) {
   }));
 }
 
+// src/commands/domains-namespaces.ts
+var NAMESPACE_STATUS_LABELS = {
+  pending_verification: "verifying",
+  verified: "verified",
+  removed: "removed"
+};
+function printNamespaceRecords(namespace) {
+  printInfo(`Create these DNS records once for ${namespace.parentDomain} — every future subdomain is then covered:`);
+  const rows = [
+    {
+      type: "TXT",
+      name: namespace.verificationTxt.name,
+      value: namespace.verificationTxt.value
+    }
+  ];
+  if (namespace.wildcardCname) {
+    rows.push({
+      type: "CNAME",
+      name: namespace.wildcardCname.name,
+      value: namespace.wildcardCname.value
+    });
+  }
+  printList(rows, [
+    { key: "type", label: "Type", width: 6 },
+    { key: "name", label: "Name", width: 44 },
+    { key: "value", label: "Value", width: 44 }
+  ], rows);
+}
+function registerDomainNamespaceCommands(domains) {
+  const namespaces = domains.command("namespaces").description("Verify a parent domain once, then attach subdomains to any server with no further DNS work");
+  namespaces.command("list").description("List the domain namespaces in an organization").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.get("/api/v1/domains/namespaces", { organization_id: organizationId });
+    printList(data.namespaces.map((namespace) => ({
+      parent: namespace.parentDomain,
+      status: NAMESPACE_STATUS_LABELS[namespace.status],
+      wildcard: namespace.wildcardConfigured ? "configured" : "—",
+      verified: namespace.verifiedAt ? formatDate(namespace.verifiedAt) : "—"
+    })), [
+      { key: "parent", label: "Parent domain", width: 32 },
+      { key: "status", label: "Status", width: 12 },
+      { key: "wildcard", label: "Wildcard", width: 12 },
+      { key: "verified", label: "Verified", width: 22 }
+    ], data);
+  }));
+  namespaces.command("add <parentDomain>").description("Register a domain namespace and print its one-time DNS records (admin role required)").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (parentDomain, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const namespace = await api.post("/api/v1/domains/namespaces", { organizationId, parentDomain });
+    if (isJsonMode()) {
+      printJson(namespace);
+      return;
+    }
+    printSuccess(`${namespace.parentDomain} namespace added.`);
+    printNamespaceRecords(namespace);
+    printInfo("Verification runs automatically — or run `mcp domains namespaces verify <parentDomain>` to check now.");
+  }));
+  namespaces.command("verify <parentDomain>").description("Check the namespace verification records now").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (parentDomain, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.post("/api/v1/domains/namespaces/verify", {
+      organizationId,
+      parentDomain
+    });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    if (data.verified) {
+      printSuccess(`${data.namespace.parentDomain} is verified. Attach subdomains with \`mcp domains add <label>.${data.namespace.parentDomain} --server <id>\`.`);
+    } else {
+      printInfo(data.error ?? "Not verified yet — DNS may still be propagating.");
+      printNamespaceRecords(data.namespace);
+    }
+  }));
+  namespaces.command("remove <parentDomain>").description("Remove a domain namespace — existing attached hostnames keep working (admin role required)").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (parentDomain, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.delete("/api/v1/domains/namespaces", { organizationId, parentDomain });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    printSuccess(`${parentDomain} namespace removed. Hostnames already attached under it keep serving.`);
+  }));
+}
+
+// src/commands/domains.ts
+var STATUS_LABELS = {
+  pending_verification: "verifying dns",
+  pending_cert: "issuing certificate",
+  active: "active",
+  failed: "attention needed",
+  removed: "removed"
+};
+function printDnsRecords(domain, cnameTarget) {
+  printInfo(`Create these DNS records for ${domain.hostname}:`);
+  const rows = [
+    { type: "CNAME", name: domain.hostname, value: cnameTarget }
+  ];
+  if (domain.ownershipVerification) {
+    rows.push({
+      type: "TXT",
+      name: domain.ownershipVerification.name,
+      value: domain.ownershipVerification.value
+    });
+  }
+  for (const record of domain.certificateValidationRecords) {
+    rows.push({ type: "TXT", name: record.name, value: record.value });
+  }
+  printList(rows, [
+    { key: "type", label: "Type", width: 6 },
+    { key: "name", label: "Name", width: 44 },
+    { key: "value", label: "Value", width: 44 }
+  ], rows);
+}
+function printDomainStatus(domain) {
+  printKeyValue({
+    hostname: domain.hostname,
+    status: STATUS_LABELS[domain.status],
+    url: domain.status === "active" ? `https://${domain.hostname}/mcp` : "—",
+    "last checked": domain.lastSyncedAt ? formatDate(domain.lastSyncedAt) : "—",
+    ...domain.lastError ? { error: domain.lastError } : {}
+  });
+}
+function registerDomainCommands(program2) {
+  const domains = program2.command("domains").description("Serve servers from custom domains you own (Pro+)");
+  registerDomainNamespaceCommands(domains);
+  domains.command("list").description("List the custom domains in an organization").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.get("/api/v1/domains", {
+      organization_id: organizationId
+    });
+    if (!data.allowed) {
+      printInfo("Bring your own domain requires the Pro plan or higher for this organization.");
+      if (isJsonMode())
+        printJson(data);
+      return;
+    }
+    printList(data.domains.map((domain) => ({
+      hostname: domain.hostname,
+      status: STATUS_LABELS[domain.status],
+      server: domain.serverId,
+      added: formatDate(domain.createdAt)
+    })), [
+      { key: "hostname", label: "Hostname", width: 36 },
+      { key: "status", label: "Status", width: 20 },
+      { key: "server", label: "Server", width: 34 },
+      { key: "added", label: "Added", width: 22 }
+    ], data);
+    if (!isJsonMode()) {
+      printInfo(`${data.used} of ${data.limit === null ? "unlimited" : data.limit} domains used.`);
+    }
+  }));
+  domains.command("add <hostname>").description("Attach a custom domain to a server (admin role required)").requiredOption("--server <serverId>", "Server id to attach the domain to").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.post("/api/v1/domains", {
+      organizationId,
+      serverId: opts.server,
+      hostname: hostname2
+    });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    printSuccess(`${data.domain.hostname} added.`);
+    printDnsRecords(data.domain, data.cnameTarget);
+    printInfo("Verification runs automatically once the records propagate — or run `mcp domains status <hostname>` to check now.");
+  }));
+  domains.command("status <hostname>").description("Recheck a custom domain against Cloudflare and show status").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const domain = await api.post("/api/v1/domains/recheck", { organizationId, hostname: hostname2 });
+    if (isJsonMode()) {
+      printJson(domain);
+      return;
+    }
+    printDomainStatus(domain);
+    if (domain.status === "active") {
+      printSuccess("Domain is verified and serving traffic.");
+    }
+  }));
+  domains.command("remove <hostname>").description("Remove a custom domain — traffic on it stops immediately (admin role required)").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.delete("/api/v1/domains", {
+      organizationId,
+      hostname: hostname2
+    });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    printSuccess(`${hostname2} removed. The platform URL is unaffected.`);
+  }));
+  domains.command("transfer <hostname>").description("Move a custom domain to another server without certificate churn (admin role required)").requiredOption("--server <serverId>", "Target server id").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const domain = await api.post("/api/v1/domains/transfer", { organizationId, serverId: opts.server, hostname: hostname2 });
+    if (isJsonMode()) {
+      printJson(domain);
+      return;
+    }
+    printSuccess(`${domain.hostname} now serves server ${domain.serverId}.`);
+    if (domain.status === "active") {
+      printInfo("Routing re-pointed — no DNS or certificate changes needed.");
+    }
+  }));
+}
+
 // src/commands/config.ts
 import { homedir as homedir2 } from "node:os";
 import { join as join11 } from "node:path";
@@ -29822,7 +30076,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.",
@@ -35523,6 +35777,7 @@ function createProgram() {
   registerToolCommands(program2);
   registerSkillCommands(program2);
   registerApiKeyCommands(program2);
+  registerDomainCommands(program2);
   registerDeploymentCommands(program2);
   registerOrgCommands(program2);
   registerUsageCommands(program2);

package/package.json

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