@mcpcloud/cli 0.21.2 → 0.22.0-next-20260906224824

package/README.md

@@ -588,6 +588,7 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `mcp skills test-scenarios rm <skill> <scenarioId>` | Archive a skill test scenario |
 | `mcp skills test-scenarios update <skill> <scenarioId>` | Update a skill test scenario (only the flags you pass change) |
 | `mcp skills token <skill>` | Reveal the skill’s runtime bearer token (--rotate issues a new one and invalidates the old) |
+| `mcp skills transfer <skill>` | Move a skill into another organization you administer, keeping its id, versions, runtime deployments, test assets and registry listing. Shows the plan; add --yes to execute. |
 | `mcp skills uninstall <skill>` | Mark the caller's installation of this skill as removed |
 | `mcp skills update <skill>` | Update skill metadata (name, description, visibility) |
 | `mcp skills version <skill> <versionId>` | Show details for one published skill version (workflow summary, triggers, deps) |

package/dist/index.js

@@ -12107,6 +12107,112 @@ function registerSkillPullCommand(skills) {
   }));
 }
 
+// src/commands/skills-transfer.ts
+var TRANSFER_PATH2 = "/api/v1/skill/transfer";
+var TRANSFER_TIMEOUT_MS2 = 180000;
+async function resolveTargetOrganizationId2(reference) {
+  const ref = reference.trim();
+  const data = await api.get("/api/v1/organizations");
+  const rows = data.organizations;
+  const match = rows.find((row) => row.id === ref) ?? rows.find((row) => row.slug === ref) ?? rows.find((row) => row.name.toLowerCase() === ref.toLowerCase());
+  if (!match) {
+    printError(`No organization you belong to matches ${c.bold(ref)} (by id, slug, or name).`);
+    if (rows.length > 0) {
+      printInfo(`  ${c.dim("Yours:")} ${rows.map((row) => `${row.name} (${row.slug ?? row.id})`).join(", ")}`);
+    }
+    throw new CliExitError(1);
+  }
+  return match.id;
+}
+function printPlan2(result) {
+  printKeyValue({
+    skill: `${result.skill.name} (${result.skill.id})`,
+    from: `${result.from.organizationName ?? result.from.organizationId} / ${result.from.projectName ?? result.from.projectId}`,
+    to: `${result.to.organizationName} / ${result.to.projectName ?? result.to.projectId ?? "(new project)"}`
+  });
+  const moving = result.manifest.filter((entry) => entry.count > 0);
+  if (moving.length > 0) {
+    printInfo(c.dim("  Rows that move:"));
+    for (const entry of moving) {
+      printInfo(`    ${entry.table.padEnd(34)} ${entry.count}${entry.more ? "+" : ""}`);
+    }
+  }
+  for (const note of result.plan.notes)
+    printWarn(`  ! ${note}`);
+}
+function reportApiError7(err) {
+  if (err instanceof McpCloudApiError) {
+    printError(`Transfer failed (HTTP ${err.status}): ${err.error.message}`);
+    const blockers = err.error.details?.blockers;
+    if (Array.isArray(blockers)) {
+      for (const blocker of blockers) {
+        printInfo(`  ${c.dim(blocker.code + ":")} ${blocker.message}`);
+      }
+    }
+  } else {
+    printError(`Transfer failed: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  throw new CliExitError(1);
+}
+function registerSkillTransferCommand(skills) {
+  skills.command("transfer <skill>").description("Move a skill into another organization you administer, keeping its id, versions, runtime deployments, test assets and registry listing. Shows the plan; add --yes to execute.").requiredOption("--to-org <organization>", "Destination organization (id, slug, or name) — you must be owner or admin there").option("--to-project <project>", "Destination project (id or name, within the destination organization)").option("--create-project <name>", "Create this project in the destination organization and move the skill into it").option("--org <organizationId>", "Source organization ID").option("--yes", "Execute the transfer (without it, only the plan is shown)").addHelpText("after", [
+    "",
+    "What moves: the skill and its project placement, versions, runtime",
+    "deployments (their URL and token do not change), the runtime token, test",
+    "scenarios and runs, eval suites and runs, autopilot and authoring history,",
+    "execution traces, and the registry listing (installers keep it).",
+    "What stays: invocation history (the source org was billed for it).",
+    "",
+    "Refused while a dependency server lives outside the destination —",
+    "transfer the servers first (`mcp servers transfer`), then the skill.",
+    "Members of the source organization lose access to the skill."
+  ].join(`
+`)).action(runAction(async (skillRef, opts) => {
+    const orgId = await resolveOrgId(opts.org);
+    const skillId = await resolveSkillId(skillRef, orgId);
+    const targetOrganizationId = await resolveTargetOrganizationId2(opts.toOrg);
+    const targetProjectId = await resolveOptionalProjectId(opts.toProject, targetOrganizationId);
+    if (opts.yes && !targetProjectId && !opts.createProject) {
+      printError("Pass --to-project <project> or --create-project <name> for the destination.");
+      throw new CliExitError(1);
+    }
+    const body = {
+      organizationId: orgId,
+      targetOrganizationId,
+      skillId,
+      ...targetProjectId ? { targetProjectId } : {},
+      ...opts.createProject ? { createProjectName: opts.createProject } : {},
+      dryRun: !opts.yes
+    };
+    let result;
+    try {
+      if (opts.yes && !isJsonMode()) {
+        printStep(`Transferring ${c.bold(skillRef)} to ${c.bold(opts.toOrg)}…`);
+      }
+      result = await api.post(TRANSFER_PATH2, body, {
+        timeoutMs: TRANSFER_TIMEOUT_MS2
+      });
+    } catch (err) {
+      reportApiError7(err);
+    }
+    if (isJsonMode()) {
+      printJson(result);
+      return;
+    }
+    printPlan2(result);
+    if (result.dryRun) {
+      printInfo(c.dim(`  → nothing moved. Re-run with --yes${targetProjectId || opts.createProject ? "" : " and --to-project <project> (or --create-project <name>)"} to transfer.`));
+      return;
+    }
+    printSuccess(`${result.skill.name} now lives in ${result.to.organizationName} / ${result.to.projectName ?? result.to.projectId}${result.to.projectCreated ? " (project created)" : ""}. ${result.patchedRows} row(s) rehomed; id unchanged.`);
+    if (result.runtime && result.runtime.failed.length > 0) {
+      printWarn(`  ! ${result.runtime.failed.length} runtime deployment(s) could not be re-published for ${result.to.organizationName}: ${result.runtime.failed.join("; ")}. Run: mcp skills deploy ${skillRef} --org ${result.to.organizationId}`);
+    } else if (result.runtime) {
+      printInfo(`  ${result.runtime.republished} runtime deployment(s) re-published for ${result.to.organizationName}; URL and token unchanged.`);
+    }
+  }));
+}
+
 // src/commands/skills.ts
 async function readStdin3() {
   const chunks = [];
@@ -12141,6 +12247,7 @@ function registerSkillCommands(program) {
   registerSkillTestCommands(skills);
   registerSkillInvokeCommand(skills);
   registerSkillPullCommand(skills);
+  registerSkillTransferCommand(skills);
   skills.command("list").description("List skills in an organization").option("--org <organizationId>", "Organization ID").option("--project <project>", "Filter by project (id or name)").option("--limit <n>", "Maximum results (default 25)", parsePositiveIntOption("limit"), "25").addHelpText("after", [
     "",
     "Examples:",

package/package.json

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