cmx-sdk 0.2.5 → 0.2.7

package/README.md

@@ -223,6 +223,22 @@ npx cmx-sdk mdx validate --file src/content/post.mdx
 npx cmx-sdk mdx doctor
 ```
 
+### Starter Kit Maintenance
+
+```bash
+# Replace .cmx/studio with the latest distributed Studio app
+npx cmx-sdk update-studio
+
+# Skip confirmation prompt when replacing Studio
+npx cmx-sdk update-studio --force
+
+# Update cmx-sdk dependency in your starter kit root
+npx cmx-sdk update-sdk
+
+# Pin to a specific version or tag
+npx cmx-sdk update-sdk --version 0.2.6
+```
+
 ### Requirements
 
 Set `CMX_API_URL` and `CMX_API_KEY` in your `.env` or `.env.local`:

package/dist/add-studio-YUDYE2OH.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import {
+  downloadStudioFiles
+} from "./chunk-NZQ6SBFS.js";
+import {
+  commandToString,
+  detectPackageManager,
+  findProjectRoot,
+  getInstallCommand,
+  getStudioStandaloneDevCommand
+} from "./chunk-EDXXR5BE.js";
+import "./chunk-IIQLQIDP.js";
+
+// src/commands/add-studio.ts
+import { existsSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+import { config } from "dotenv";
+async function addStudio() {
+  console.log("\n  CMX Studio \u3092\u8FFD\u52A0\u4E2D...\n");
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.error("  \u274C CMX \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093");
+    console.error("     package.json \u306B cmx-sdk \u4F9D\u5B58\u304C\u3042\u308B\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3067\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  const studioDir = join(projectRoot, ".cmx", "studio");
+  if (existsSync(studioDir)) {
+    console.error("  \u274C .cmx/studio/ \u306F\u65E2\u306B\u5B58\u5728\u3057\u307E\u3059");
+    console.error("     \u518D\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3059\u308B\u5834\u5408\u306F\u5148\u306B\u524A\u9664\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  config({ path: join(projectRoot, ".env") });
+  const apiUrl = process.env.CMX_API_URL;
+  const apiKey = process.env.CMX_API_KEY;
+  if (!apiUrl || !apiKey) {
+    console.error("  \u274C CMX_API_URL \u3068 CMX_API_KEY \u304C\u5FC5\u8981\u3067\u3059");
+    console.error("     .env \u306B\u8A8D\u8A3C\u60C5\u5831\u3092\u8A2D\u5B9A\u3057\u3066\u304B\u3089\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  console.log("  \u23F3 Studio \u3092\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u4E2D...");
+  try {
+    await downloadStudioFiles(studioDir, { apiUrl, apiKey });
+    console.log("  \u2713 Studio \u3092\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3057\u307E\u3057\u305F");
+  } catch (error) {
+    console.error("\n  \u274C Studio \u306E\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u306B\u5931\u6557\u3057\u307E\u3057\u305F");
+    console.error(`     ${error instanceof Error ? error.message : "\u4E0D\u660E\u306A\u30A8\u30E9\u30FC"}
+`);
+    process.exit(1);
+  }
+  console.log("\n  \u{1F4E6} Studio \u306E\u4F9D\u5B58\u30D1\u30C3\u30B1\u30FC\u30B8\u3092\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u4E2D...");
+  const pm = detectPackageManager(projectRoot);
+  const installCmd = getInstallCommand(pm);
+  try {
+    execSync(commandToString(installCmd), { cwd: studioDir, stdio: "inherit" });
+  } catch {
+    console.error("\n  \u26A0\uFE0F  \u4F9D\u5B58\u30D1\u30C3\u30B1\u30FC\u30B8\u306E\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u306B\u5931\u6557\u3057\u307E\u3057\u305F");
+    console.error(`     cd .cmx/studio && ${commandToString(installCmd)} \u3067\u624B\u52D5\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3057\u3066\u304F\u3060\u3055\u3044
+`);
+  }
+  console.log("\n  \u2705 CMX Studio \u3092\u8FFD\u52A0\u3057\u307E\u3057\u305F\uFF01\n");
+  console.log("  \u6B21\u306E\u30B9\u30C6\u30C3\u30D7:");
+  console.log("    1. \u30B5\u30A4\u30C8 + Studio \u3092\u8D77\u52D5");
+  console.log("       npx cmx-sdk studio");
+  console.log("    2. Studio \u306E\u307F\u8D77\u52D5");
+  console.log(`       ${getStudioStandaloneDevCommand(pm)}
+`);
+  process.exit(0);
+}
+export {
+  addStudio
+};

package/dist/{chunk-XPP5MZKG.js → chunk-7TDMLYBI.js}

@@ -1,47 +1,17 @@
 #!/usr/bin/env node
+import {
+  detectPackageManager,
+  findProjectRoot,
+  getRunDevCommand,
+  toPlatformCommand
+} from "./chunk-EDXXR5BE.js";
 
 // src/commands/studio.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync } from "fs";
 import { spawn } from "child_process";
-import { join, resolve } from "path";
-function findProjectRoot() {
-  let dir = resolve(process.cwd());
-  const root = resolve("/");
-  while (dir !== root) {
-    const pkgPath = join(dir, "package.json");
-    if (existsSync(pkgPath)) {
-      try {
-        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-        if (pkg.dependencies?.["cmx-sdk"] || pkg.devDependencies?.["cmx-sdk"]) {
-          return dir;
-        }
-      } catch {
-      }
-    }
-    dir = resolve(dir, "..");
-  }
-  return null;
-}
-function detectPackageManager(dir) {
-  if (existsSync(join(dir, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(join(dir, "yarn.lock"))) return "yarn";
-  return "npm";
-}
-function getRunCommand(pm) {
-  if (pm === "pnpm") return { command: "pnpm", args: ["dev"] };
-  if (pm === "yarn") return { command: "yarn", args: ["dev"] };
-  return { command: "npm", args: ["run", "dev"] };
-}
-function toPlatformCommand(command) {
-  if (process.platform === "win32") {
-    if (command === "npm") return "npm.cmd";
-    if (command === "pnpm") return "pnpm.cmd";
-    if (command === "yarn") return "yarn.cmd";
-  }
-  return command;
-}
+import { join } from "path";
 async function studio() {
-  console.log("\n  CMX Studio \u8D77\u52D5\u4E2D...\n");
+  console.log("\n  CMX Studio \u3092\u8D77\u52D5\u3057\u307E\u3059...\n");
   const projectRoot = findProjectRoot();
   if (!projectRoot) {
     console.error("  \u274C CMX \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093");
@@ -56,8 +26,8 @@ async function studio() {
   }
   const rootPm = detectPackageManager(projectRoot);
   const studioPm = detectPackageManager(studioDir);
-  const rootRun = getRunCommand(rootPm);
-  const studioRun = getRunCommand(studioPm);
+  const rootRun = getRunDevCommand(rootPm);
+  const studioRun = getRunDevCommand(studioPm);
   const children = [];
   let shuttingDown = false;
   const shutdown = (exitCode) => {
@@ -74,6 +44,7 @@ async function studio() {
     }, 300).unref();
   };
   const spawnDev = (label, cwd, run) => {
+    const displayLabel = label === "site" ? "\u30B5\u30A4\u30C8" : "Studio";
     const command = toPlatformCommand(run.command);
     const child = spawn(command, run.args, {
       cwd,
@@ -82,7 +53,7 @@ async function studio() {
     });
     child.on("error", (error) => {
       console.error(`
-  \u274C ${label} \u306E\u8D77\u52D5\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${error.message}
+  \u274C ${displayLabel} \u306E\u8D77\u52D5\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${error.message}
 `);
       shutdown(1);
     });
@@ -90,14 +61,15 @@ async function studio() {
       if (shuttingDown) return;
       const detail = signal ? `signal ${signal}` : `code ${code ?? 1}`;
       console.error(`
-  \u26A0\uFE0F  ${label} \u30D7\u30ED\u30BB\u30B9\u304C\u7D42\u4E86\u3057\u307E\u3057\u305F (${detail})
+  \u26A0\uFE0F  ${displayLabel} \u30D7\u30ED\u30BB\u30B9\u304C\u7D42\u4E86\u3057\u307E\u3057\u305F (${detail})
 `);
       shutdown(code ?? 1);
     });
     children.push(child);
   };
-  console.log("  - site   : http://localhost:4000");
-  console.log("  - studio : http://localhost:4001\n");
+  console.log("  \u8D77\u52D5URL:");
+  console.log("    \u30B5\u30A4\u30C8 : http://localhost:4000");
+  console.log("    Studio : http://localhost:4001\n");
   spawnDev("site", projectRoot, rootRun);
   spawnDev("studio", studioDir, studioRun);
   process.on("SIGINT", () => shutdown(0));

package/dist/chunk-EDXXR5BE.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+
+// src/commands/project-context.ts
+import { existsSync, readFileSync } from "fs";
+import { join, resolve } from "path";
+function findProjectRoot(startDir = process.cwd()) {
+  let dir = resolve(startDir);
+  const root = resolve("/");
+  while (dir !== root) {
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        if (pkg.dependencies?.["cmx-sdk"] || pkg.devDependencies?.["cmx-sdk"]) {
+          return dir;
+        }
+      } catch {
+      }
+    }
+    dir = resolve(dir, "..");
+  }
+  return null;
+}
+function detectPackageManager(dir) {
+  if (existsSync(join(dir, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(dir, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function toPlatformCommand(command) {
+  if (process.platform === "win32") {
+    if (command === "npm") return "npm.cmd";
+    if (command === "pnpm") return "pnpm.cmd";
+    if (command === "yarn") return "yarn.cmd";
+  }
+  return command;
+}
+function getInstallCommand(pm) {
+  if (pm === "yarn") return { command: "yarn", args: [] };
+  return { command: pm, args: ["install"] };
+}
+function getRunDevCommand(pm) {
+  if (pm === "pnpm") return { command: "pnpm", args: ["dev"] };
+  if (pm === "yarn") return { command: "yarn", args: ["dev"] };
+  return { command: "npm", args: ["run", "dev"] };
+}
+function getAddDependencyCommand(pm, packageSpec) {
+  if (pm === "pnpm") return { command: "pnpm", args: ["add", packageSpec] };
+  if (pm === "yarn") return { command: "yarn", args: ["add", packageSpec] };
+  return { command: "npm", args: ["install", packageSpec] };
+}
+function commandToString(command) {
+  return [command.command, ...command.args].join(" ");
+}
+function getStudioStandaloneDevCommand(pm) {
+  if (pm === "pnpm") return "pnpm --dir .cmx/studio dev";
+  if (pm === "yarn") return "yarn --cwd .cmx/studio dev";
+  return "npm --prefix .cmx/studio run dev";
+}
+function readSdkVersion(projectRoot) {
+  const pkgPath = join(projectRoot, "package.json");
+  if (!existsSync(pkgPath)) return null;
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return pkg.dependencies?.["cmx-sdk"] ?? pkg.devDependencies?.["cmx-sdk"] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  findProjectRoot,
+  detectPackageManager,
+  toPlatformCommand,
+  getInstallCommand,
+  getRunDevCommand,
+  getAddDependencyCommand,
+  commandToString,
+  getStudioStandaloneDevCommand,
+  readSdkVersion
+};

package/dist/chunk-FPQYL5GE.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import {
+  downloadStudioFiles
+} from "./chunk-NZQ6SBFS.js";
+import {
+  commandToString,
+  detectPackageManager,
+  findProjectRoot,
+  getInstallCommand,
+  getStudioStandaloneDevCommand
+} from "./chunk-EDXXR5BE.js";
+
+// src/commands/update-studio.ts
+import { confirm } from "@inquirer/prompts";
+import { execSync } from "child_process";
+import { config } from "dotenv";
+import { existsSync, mkdirSync, renameSync, rmSync } from "fs";
+import { join } from "path";
+function formatBackupTimestamp(date = /* @__PURE__ */ new Date()) {
+  const yyyy = String(date.getFullYear());
+  const mm = String(date.getMonth() + 1).padStart(2, "0");
+  const dd = String(date.getDate()).padStart(2, "0");
+  const hh = String(date.getHours()).padStart(2, "0");
+  const mi = String(date.getMinutes()).padStart(2, "0");
+  const ss = String(date.getSeconds()).padStart(2, "0");
+  return `${yyyy}${mm}${dd}-${hh}${mi}${ss}`;
+}
+function restoreStudioFromBackup(studioDir, backupDir) {
+  if (existsSync(studioDir)) {
+    rmSync(studioDir, { recursive: true, force: true });
+  }
+  renameSync(backupDir, studioDir);
+}
+async function updateStudio(options = {}) {
+  console.log("\n  CMX Studio \u3092\u66F4\u65B0\u3057\u307E\u3059...\n");
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.error("  \u274C CMX \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093");
+    console.error("     package.json \u306B cmx-sdk \u4F9D\u5B58\u304C\u3042\u308B\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3067\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  const studioDir = join(projectRoot, ".cmx", "studio");
+  if (!existsSync(join(studioDir, "package.json"))) {
+    console.error("  \u274C .cmx/studio \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093");
+    console.error("     \u5148\u306B npx cmx-sdk add-studio \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  if (!options.force) {
+    const accepted = await confirm({
+      message: "\u65E2\u5B58\u306E .cmx/studio \u3092\u6700\u65B0\u69CB\u6210\u3067\u7F6E\u63DB\u3057\u307E\u3059\u3002\u7D9A\u884C\u3057\u307E\u3059\u304B\uFF1F",
+      default: true
+    });
+    if (!accepted) {
+      console.log("\n  \u66F4\u65B0\u3092\u30AD\u30E3\u30F3\u30BB\u30EB\u3057\u307E\u3057\u305F\u3002\n");
+      process.exit(0);
+    }
+  }
+  config({ path: join(projectRoot, ".env") });
+  const apiUrl = process.env.CMX_API_URL;
+  const apiKey = process.env.CMX_API_KEY;
+  if (!apiUrl || !apiKey) {
+    console.error("  \u274C CMX_API_URL \u3068 CMX_API_KEY \u304C\u5FC5\u8981\u3067\u3059");
+    console.error("     .env \u306B\u8A8D\u8A3C\u60C5\u5831\u3092\u8A2D\u5B9A\u3057\u3066\u304B\u3089\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  const timestamp = formatBackupTimestamp();
+  const cmxDir = join(projectRoot, ".cmx");
+  const backupDir = join(cmxDir, `studio.backup-${timestamp}`);
+  const nextStudioDir = join(cmxDir, `.studio-update-${timestamp}`);
+  mkdirSync(cmxDir, { recursive: true });
+  let movedToBackup = false;
+  console.log("  \u23F3 Studio \u3092\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u3057\u3066\u7F6E\u63DB\u4E2D...");
+  try {
+    renameSync(studioDir, backupDir);
+    movedToBackup = true;
+    await downloadStudioFiles(nextStudioDir, { apiUrl, apiKey });
+    renameSync(nextStudioDir, studioDir);
+  } catch (error) {
+    rmSync(nextStudioDir, { recursive: true, force: true });
+    console.error("\n  \u274C Studio \u306E\u66F4\u65B0\u306B\u5931\u6557\u3057\u307E\u3057\u305F");
+    console.error(`     ${error instanceof Error ? error.message : "\u4E0D\u660E\u306A\u30A8\u30E9\u30FC"}`);
+    if (movedToBackup && existsSync(backupDir)) {
+      try {
+        restoreStudioFromBackup(studioDir, backupDir);
+        console.error("  \u21A9 \u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u304B\u3089\u5FA9\u65E7\u3057\u307E\u3057\u305F\n");
+      } catch (restoreError) {
+        console.error(`  \u26A0\uFE0F  \u81EA\u52D5\u5FA9\u65E7\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${restoreError instanceof Error ? restoreError.message : "\u4E0D\u660E\u306A\u30A8\u30E9\u30FC"}`);
+        console.error(`     \u624B\u52D5\u3067 ${backupDir} \u3092 ${studioDir} \u306B\u623B\u3057\u3066\u304F\u3060\u3055\u3044
+`);
+      }
+    }
+    process.exit(1);
+  }
+  const pm = detectPackageManager(projectRoot);
+  const installCommand = getInstallCommand(pm);
+  let installSucceeded = false;
+  console.log("\n  \u{1F4E6} Studio \u306E\u4F9D\u5B58\u30D1\u30C3\u30B1\u30FC\u30B8\u3092\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u4E2D...");
+  try {
+    execSync(commandToString(installCommand), { cwd: studioDir, stdio: "inherit" });
+    installSucceeded = true;
+  } catch {
+    console.error("\n  \u26A0\uFE0F  \u4F9D\u5B58\u30D1\u30C3\u30B1\u30FC\u30B8\u306E\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u306B\u5931\u6557\u3057\u307E\u3057\u305F");
+    console.error(`     cd .cmx/studio && ${commandToString(installCommand)} \u3092\u624B\u52D5\u3067\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044`);
+    console.error(`     \u5FC5\u8981\u306A\u3089\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u3092\u5FA9\u5143: ${backupDir}
+`);
+  }
+  if (installSucceeded) {
+    rmSync(backupDir, { recursive: true, force: true });
+  }
+  console.log("\n  \u2705 CMX Studio \u3092\u66F4\u65B0\u3057\u307E\u3057\u305F\uFF01\n");
+  console.log("  \u6B21\u306E\u30B9\u30C6\u30C3\u30D7:");
+  console.log("    1. \u30B5\u30A4\u30C8 + Studio \u3092\u8D77\u52D5");
+  console.log("       npx cmx-sdk studio");
+  console.log("    2. Studio \u306E\u307F\u8D77\u52D5");
+  console.log(`       ${getStudioStandaloneDevCommand(pm)}`);
+  if (!installSucceeded) {
+    console.log("    3. \u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u3092\u4FDD\u6301\u3057\u3066\u3044\u307E\u3059");
+    console.log(`       ${backupDir}`);
+  }
+  console.log("");
+  process.exit(0);
+}
+
+export {
+  formatBackupTimestamp,
+  restoreStudioFromBackup,
+  updateStudio
+};

package/dist/chunk-NZQ6SBFS.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import {
+  cleanupTempFile,
+  downloadTarball
+} from "./chunk-IIQLQIDP.js";
+
+// src/commands/studio-distribution.ts
+import { mkdirSync } from "fs";
+import { dirname, join } from "path";
+import { extract } from "tar";
+function isStudioEntry(path) {
+  const parts = path.split("/");
+  return parts.length >= 3 && parts[1] === ".cmx" && parts[2] === "studio";
+}
+async function downloadStudioFiles(studioDir, options) {
+  const parentDir = dirname(studioDir);
+  const tmpFile = join(parentDir, `.tmp-studio-tarball-${Date.now()}.tar.gz`);
+  const normalizedApiUrl = options.apiUrl.replace(/\/$/, "");
+  const downloadUrl = `${normalizedApiUrl}/api/v1/sdk/download/studio`;
+  const headers = { Authorization: `Bearer ${options.apiKey}` };
+  mkdirSync(parentDir, { recursive: true });
+  await downloadTarball(downloadUrl, tmpFile, { headers });
+  mkdirSync(studioDir, { recursive: true });
+  await extract({
+    file: tmpFile,
+    cwd: studioDir,
+    strip: 2,
+    filter: isStudioEntry
+  });
+  cleanupTempFile(tmpFile);
+}
+
+export {
+  downloadStudioFiles
+};

package/dist/chunk-S3TFTN6H.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import {
+  commandToString,
+  detectPackageManager,
+  findProjectRoot,
+  getAddDependencyCommand,
+  readSdkVersion
+} from "./chunk-EDXXR5BE.js";
+
+// src/commands/update-sdk.ts
+import { execSync } from "child_process";
+function resolveRequestedVersion(version) {
+  if (version === void 0) return "latest";
+  const normalized = version.trim();
+  if (normalized.length === 0) {
+    throw new Error("--version \u306B\u7A7A\u6587\u5B57\u306F\u6307\u5B9A\u3067\u304D\u307E\u305B\u3093");
+  }
+  return normalized;
+}
+async function updateSdk(options = {}) {
+  console.log("\n  cmx-sdk \u306E\u4F9D\u5B58\u30D0\u30FC\u30B8\u30E7\u30F3\u3092\u66F4\u65B0\u3057\u307E\u3059...\n");
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.error("  \u274C CMX \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093");
+    console.error("     package.json \u306B cmx-sdk \u4F9D\u5B58\u304C\u3042\u308B\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3067\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\n");
+    process.exit(1);
+  }
+  let version;
+  try {
+    version = resolveRequestedVersion(options.version);
+  } catch (error) {
+    console.error(`  \u274C ${error instanceof Error ? error.message : "\u4E0D\u660E\u306A\u30A8\u30E9\u30FC"}
+`);
+    process.exit(1);
+  }
+  const currentVersion = readSdkVersion(projectRoot);
+  const pm = detectPackageManager(projectRoot);
+  const dependencySpec = `cmx-sdk@${version}`;
+  const addCommand = getAddDependencyCommand(pm, dependencySpec);
+  console.log(`  \u73FE\u5728\u306E\u30D0\u30FC\u30B8\u30E7\u30F3: ${currentVersion ?? "\u4E0D\u660E"}`);
+  console.log(`  \u23F3 \u5B9F\u884C\u30B3\u30DE\u30F3\u30C9: ${commandToString(addCommand)}`);
+  try {
+    execSync(commandToString(addCommand), { cwd: projectRoot, stdio: "inherit" });
+  } catch {
+    console.error("\n  \u274C cmx-sdk \u306E\u66F4\u65B0\u306B\u5931\u6557\u3057\u307E\u3057\u305F");
+    console.error(`     \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30EB\u30FC\u30C8\u3067 ${commandToString(addCommand)} \u3092\u624B\u52D5\u3067\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044
+`);
+    process.exit(1);
+  }
+  const updatedVersion = readSdkVersion(projectRoot);
+  console.log("\n  \u2705 cmx-sdk \u3092\u66F4\u65B0\u3057\u307E\u3057\u305F\uFF01");
+  console.log(`  \u66F4\u65B0\u5F8C\u30D0\u30FC\u30B8\u30E7\u30F3: ${updatedVersion ?? "\u4E0D\u660E"}`);
+  console.log("\n  \u6B21\u306E\u30B9\u30C6\u30C3\u30D7:");
+  console.log("    1. \u578B\u751F\u6210\u3092\u518D\u5B9F\u884C");
+  console.log("       npx cmx-sdk codegen types");
+  console.log("    2. \u6574\u5408\u6027\u30C1\u30A7\u30C3\u30AF");
+  console.log("       npx cmx-sdk codegen check\n");
+  process.exit(0);
+}
+
+export {
+  resolveRequestedVersion,
+  updateSdk
+};