@rainbow-robotics/muscat-plugin-kit 1.10.1-dev.1 → 1.10.1

package/cli/src/update.mjs

@@ -1,295 +1,295 @@
-// muscat-pk update — update the CLI itself AND the plugin project's JS deps.
-//
-// Three install modes are handled:
-//   binary  : Bun self-contained binary downloaded from S3
-//             → re-download from S3, replace process.execPath
-//   npm -g  : globally installed Node.js package
-//             → npm install -g @rainbow-robotics/muscat-plugin-kit@<tag>
-//   local   : plugin project's node_modules (fallback)
-//             → <pm> add @rainbow-robotics/muscat-plugin-kit@<tag>
-//
-// After updating the CLI itself, also bumps the plugin project's local deps
-// and migrates the project structure if it's outdated (src/ → ui/, root main.py → py/).
-import { execSync, spawn, spawnSync } from "node:child_process";
-import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { findPluginRoot, isLocalKitInstall, KIT_PUBLISHED_NAME, kitVersion, log, parseArgs, prompt } from "./util.mjs";
-
-const PLUGIN_UI_PACKAGE = "@rainbow-robotics/plugin-ui";
-const S3_BASE = "https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit";
-
-const isBinaryMode = typeof Bun !== "undefined";
-
-// ── helpers ───────────────────────────────────────────────────────────────────
-
-function detectPm(root) {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(root, "package.json"), "utf8"));
-    if (pkg.packageManager) return pkg.packageManager.split("@")[0];
-  } catch { /* ignore */ }
-  if (existsSync(resolve(root, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(resolve(root, "yarn.lock"))) return "yarn";
-  if (existsSync(resolve(root, "bun.lockb"))) return "bun";
-  return "npm";
-}
-
-async function fetchText(url) {
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`HTTP ${res.status}: ${url}`);
-  return (await res.text()).trim();
-}
-
-async function fetchBinary(url) {
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`HTTP ${res.status}: ${url}`);
-  return Buffer.from(await res.arrayBuffer());
-}
-
-function s3BinaryName() {
-  const platform = process.platform;
-  const arch = process.arch;
-  const plat = platform === "win32" ? "win" : platform === "darwin" ? "darwin" : "linux";
-  const cpu = arch === "arm64" ? "arm64" : "x64";
-  const ext = platform === "win32" ? ".exe" : "";
-  return `muscat-pk-${plat}-${cpu}${ext}`;
-}
-
-async function resolveS3Version(tag) {
-  const pointer = tag === "dev" ? "dev-version.txt" : "latest-version.txt";
-  return fetchText(`${S3_BASE}/${pointer}`);
-}
-
-// ── self-update: binary ───────────────────────────────────────────────────────
-
-async function updateBinary(tag) {
-  const version = await resolveS3Version(tag);
-  const current = kitVersion();
-  if (version === current) {
-    log.ok(`Already up to date (v${current})`);
-    return;
-  }
-
-  const binaryName = s3BinaryName();
-  const url = `${S3_BASE}/v${version}/${binaryName}`;
-  log.step(`Downloading binary: v${current} → v${version}`);
-
-  const data = await fetchBinary(url);
-  const execPath = process.execPath;
-
-  if (process.platform === "win32") {
-    // Windows: cannot overwrite a running .exe — write .new then schedule replacement
-    const newPath = execPath + ".new";
-    writeFileSync(newPath, data);
-
-    // PowerShell snippet that waits for this process to exit, then renames
-    const ps = `Start-Sleep -Milliseconds 500; Move-Item -Force '${newPath}' '${execPath}'`;
-    spawn("powershell", ["-NoProfile", "-Command", ps], {
-      detached: true,
-      stdio: "ignore",
-    }).unref();
-
-    log.ok(`v${version} will be applied on next run.`);
-  } else {
-    // macOS / Linux: 실행 중인 파일에 덮어쓰면 Linux 는 ETXTBSY. 같은 디렉토리에 쓰고 rename 으로 바꿔치기한다.
-    const newPath = execPath + ".new";
-    writeFileSync(newPath, data);
-    chmodSync(newPath, 0o755);
-    try {
-      renameSync(newPath, execPath);
-    } catch (err) {
-      if (err?.code !== "EACCES" && err?.code !== "EPERM") throw err;
-      log.info("  sudo is required...");
-      const r = spawnSync("sudo", ["mv", "-f", newPath, execPath], { stdio: "inherit" });
-      if (r.status !== 0) throw new Error(`sudo mv failed: ${execPath}`);
-    }
-    log.ok(`Updated to v${version}.`);
-  }
-}
-
-// ── self-update: npm global ───────────────────────────────────────────────────
-
-function updateNpmGlobal(tag) {
-  log.step(`npm install -g ${KIT_PUBLISHED_NAME}@${tag}`);
-  execSync(`npm install -g ${KIT_PUBLISHED_NAME}@${tag}`, { stdio: "inherit" });
-  log.ok("Global CLI updated.");
-}
-
-// ── project structure migration ───────────────────────────────────────────────
-
-function detectOldStructure(root) {
-  const issues = [];
-
-  // src/ exists (old UI dir) or vite.config references src/content.tsx
-  const hasSrcDir = existsSync(resolve(root, "src"));
-  const hasUiDir  = existsSync(resolve(root, "ui"));
-  const viteRef   = (() => {
-    try {
-      return readFileSync(resolve(root, "vite.config.ts"), "utf8").includes("src/content.tsx");
-    } catch { return false; }
-  })();
-  if ((hasSrcDir || viteRef) && !hasUiDir) {
-    issues.push({ kind: "src→ui", desc: "src/  →  ui/  (+ vite.config.ts, tsconfig.json)" });
-  }
-
-  if (existsSync(resolve(root, "main.py")) && !existsSync(resolve(root, "py"))) {
-    issues.push({ kind: "main→py", desc: "main.py  →  py/main.py" });
-  }
-  if (existsSync(resolve(root, "backend"))) {
-    issues.push({ kind: "backend→py", desc: "backend/  →  py/" });
-  }
-  return issues;
-}
-
-async function migrateStructure(root, issues) {
-  log.warn("This plugin project's structure is outdated:");
-  for (const issue of issues) log.info("  • " + issue.desc);
-  log.warn("Files will be moved and modified. Back up or commit your work before proceeding.");
-
-  const answer = await prompt("Migrate project structure? [y/N] ");
-  if (answer.toLowerCase() !== "y") {
-    log.info("Structure migration skipped.");
-    return;
-  }
-
-  for (const issue of issues) {
-    if (issue.kind === "src→ui") {
-      if (existsSync(resolve(root, "src"))) {
-        renameSync(resolve(root, "src"), resolve(root, "ui"));
-        log.ok("src/  →  ui/");
-      }
-
-      const vitePath = resolve(root, "vite.config.ts");
-      if (existsSync(vitePath)) {
-        writeFileSync(vitePath, readFileSync(vitePath, "utf8").replace(/["']src\/content\.tsx["']/g, '"ui/content.tsx"'));
-        log.ok("vite.config.ts entry updated");
-      }
-      const tscPath = resolve(root, "tsconfig.json");
-      if (existsSync(tscPath)) {
-        writeFileSync(tscPath, readFileSync(tscPath, "utf8").replace(/"src"/g, '"ui"'));
-        log.ok("tsconfig.json include updated");
-      }
-    }
-
-    if (issue.kind === "main→py") {
-      mkdirSync(resolve(root, "py"), { recursive: true });
-      renameSync(resolve(root, "main.py"), resolve(root, "py", "main.py"));
-      log.ok("main.py  →  py/main.py");
-    }
-
-    if (issue.kind === "backend→py") {
-      renameSync(resolve(root, "backend"), resolve(root, "py"));
-      log.ok("backend/  →  py/");
-      const pyReqs = resolve(root, "py", "requirements.txt");
-      const rootReqs = resolve(root, "requirements.txt");
-      if (existsSync(pyReqs) && !existsSync(rootReqs)) {
-        renameSync(pyReqs, rootReqs);
-        log.ok("py/requirements.txt  →  requirements.txt (project root)");
-      }
-    }
-  }
-
-  log.ok("Migration complete. Run `muscat-pk build` to verify.");
-}
-
-// ── plugin project local deps ─────────────────────────────────────────────────
-
-function updateLocalDeps(root, tag) {
-  const pm = detectPm(root);
-  const list = [`${KIT_PUBLISHED_NAME}@${tag}`, `${PLUGIN_UI_PACKAGE}@${tag}`];
-  const cmd =
-    pm === "npm"   ? `npm install ${list.join(" ")}`
-    : pm === "yarn" ? `yarn add ${list.join(" ")}`
-    : `${pm} add ${list.join(" ")}`;
-
-  log.step(`Updating plugin local deps (${pm}): ${list.join(", ")}`);
-  try {
-    execSync(cmd, { cwd: root, stdio: "inherit" });
-    log.ok("Local deps updated.");
-  } catch {
-    log.warn("Local deps update failed (offline?). Run manually:\n  " + cmd);
-  }
-}
-
-// ── main ─────────────────────────────────────────────────────────────────────
-
-async function resolveTag(explicitTag) {
-  if (explicitTag) return explicitTag;
-
-  const current = kitVersion();
-  const isDevVersion = current.includes("-dev.");
-
-  if (!isDevVersion) return "latest";
-
-  const answer = await prompt(
-    `You are on a dev version (v${current}).\n` +
-    `  [1] Stay on dev  — update to latest dev build\n` +
-    `  [2] Switch to stable — update to latest stable release\n` +
-    `Choice [1/2, default: 1]: `
-  );
-  return answer.trim() === "2" ? "latest" : "dev";
-}
-
-export async function runUpdate(args = []) {
-  const opts = parseArgs(args, { booleans: ["global"] });
-  const explicitTag = opts._[0] || opts.version || opts.tag || "";
-  const tag = await resolveTag(explicitTag);
-
-  // 지금 도는 게 프로젝트의 로컬 설치면 그 프로젝트만 건드린다. 이 머신의 다른
-  // 프로젝트들이 쓰는 글로벌 CLI까지 같이 올리려면 --global을 명시해야 한다.
-  const runningLocal = isLocalKitInstall();
-
-  // 1. Update the CLI itself
-  if (!runningLocal || opts.global) {
-    if (isBinaryMode) {
-      log.step("Updating binary…");
-      try {
-        await updateBinary(tag);
-      } catch (err) {
-        log.warn(`Binary update failed: ${err.message}`);
-      }
-    } else {
-      const isGlobal = (() => {
-        try {
-          const prefix = execSync("npm prefix -g", { encoding: "utf8" }).trim();
-          return (
-            // Unix: {prefix}/bin/muscat-pk
-            existsSync(join(prefix, "bin", "muscat-pk")) ||
-            // Windows npm: {prefix}/muscat-pk.cmd (no bin/ subdir)
-            existsSync(join(prefix, "muscat-pk.cmd")) ||
-            existsSync(join(prefix, "bin", "muscat-pk.cmd"))
-          );
-        } catch { return false; }
-      })();
-
-      if (isGlobal) {
-        try {
-          updateNpmGlobal(tag);
-        } catch (err) {
-          log.warn(`Global CLI update failed: ${err.message}`);
-        }
-      }
-    }
-  } else {
-    log.info("Local install detected — updating this project only. Pass --global to also update the global CLI.");
-  }
-
-  // 2. Plugin project: structure migration + local deps
-  let root;
-  try {
-    root = findPluginRoot();
-  } catch {
-    // Not inside a plugin project — skip
-    return;
-  }
-
-  try {
-    const structureIssues = detectOldStructure(root);
-    if (structureIssues.length > 0) {
-      await migrateStructure(root, structureIssues);
-    }
-  } catch (err) {
-    log.warn(`Structure check failed: ${err.message}`);
-  }
-
-  updateLocalDeps(root, tag);
-}
+// muscat-pk update — update the CLI itself AND the plugin project's JS deps.
+//
+// Three install modes are handled:
+//   binary  : Bun self-contained binary downloaded from S3
+//             → re-download from S3, replace process.execPath
+//   npm -g  : globally installed Node.js package
+//             → npm install -g @rainbow-robotics/muscat-plugin-kit@<tag>
+//   local   : plugin project's node_modules (fallback)
+//             → <pm> add @rainbow-robotics/muscat-plugin-kit@<tag>
+//
+// After updating the CLI itself, also bumps the plugin project's local deps
+// and migrates the project structure if it's outdated (src/ → ui/, root main.py → py/).
+import { execSync, spawn, spawnSync } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { findPluginRoot, isLocalKitInstall, KIT_PUBLISHED_NAME, kitVersion, log, parseArgs, prompt } from "./util.mjs";
+
+const PLUGIN_UI_PACKAGE = "@rainbow-robotics/plugin-ui";
+const S3_BASE = "https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit";
+
+const isBinaryMode = typeof Bun !== "undefined";
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function detectPm(root) {
+  try {
+    const pkg = JSON.parse(readFileSync(resolve(root, "package.json"), "utf8"));
+    if (pkg.packageManager) return pkg.packageManager.split("@")[0];
+  } catch { /* ignore */ }
+  if (existsSync(resolve(root, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(resolve(root, "yarn.lock"))) return "yarn";
+  if (existsSync(resolve(root, "bun.lockb"))) return "bun";
+  return "npm";
+}
+
+async function fetchText(url) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${url}`);
+  return (await res.text()).trim();
+}
+
+async function fetchBinary(url) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${url}`);
+  return Buffer.from(await res.arrayBuffer());
+}
+
+function s3BinaryName() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const plat = platform === "win32" ? "win" : platform === "darwin" ? "darwin" : "linux";
+  const cpu = arch === "arm64" ? "arm64" : "x64";
+  const ext = platform === "win32" ? ".exe" : "";
+  return `muscat-pk-${plat}-${cpu}${ext}`;
+}
+
+async function resolveS3Version(tag) {
+  const pointer = tag === "dev" ? "dev-version.txt" : "latest-version.txt";
+  return fetchText(`${S3_BASE}/${pointer}`);
+}
+
+// ── self-update: binary ───────────────────────────────────────────────────────
+
+async function updateBinary(tag) {
+  const version = await resolveS3Version(tag);
+  const current = kitVersion();
+  if (version === current) {
+    log.ok(`Already up to date (v${current})`);
+    return;
+  }
+
+  const binaryName = s3BinaryName();
+  const url = `${S3_BASE}/v${version}/${binaryName}`;
+  log.step(`Downloading binary: v${current} → v${version}`);
+
+  const data = await fetchBinary(url);
+  const execPath = process.execPath;
+
+  if (process.platform === "win32") {
+    // Windows: cannot overwrite a running .exe — write .new then schedule replacement
+    const newPath = execPath + ".new";
+    writeFileSync(newPath, data);
+
+    // PowerShell snippet that waits for this process to exit, then renames
+    const ps = `Start-Sleep -Milliseconds 500; Move-Item -Force '${newPath}' '${execPath}'`;
+    spawn("powershell", ["-NoProfile", "-Command", ps], {
+      detached: true,
+      stdio: "ignore",
+    }).unref();
+
+    log.ok(`v${version} will be applied on next run.`);
+  } else {
+    // macOS / Linux: 실행 중인 파일에 덮어쓰면 Linux 는 ETXTBSY. 같은 디렉토리에 쓰고 rename 으로 바꿔치기한다.
+    const newPath = execPath + ".new";
+    writeFileSync(newPath, data);
+    chmodSync(newPath, 0o755);
+    try {
+      renameSync(newPath, execPath);
+    } catch (err) {
+      if (err?.code !== "EACCES" && err?.code !== "EPERM") throw err;
+      log.info("  sudo is required...");
+      const r = spawnSync("sudo", ["mv", "-f", newPath, execPath], { stdio: "inherit" });
+      if (r.status !== 0) throw new Error(`sudo mv failed: ${execPath}`);
+    }
+    log.ok(`Updated to v${version}.`);
+  }
+}
+
+// ── self-update: npm global ───────────────────────────────────────────────────
+
+function updateNpmGlobal(tag) {
+  log.step(`npm install -g ${KIT_PUBLISHED_NAME}@${tag}`);
+  execSync(`npm install -g ${KIT_PUBLISHED_NAME}@${tag}`, { stdio: "inherit" });
+  log.ok("Global CLI updated.");
+}
+
+// ── project structure migration ───────────────────────────────────────────────
+
+function detectOldStructure(root) {
+  const issues = [];
+
+  // src/ exists (old UI dir) or vite.config references src/content.tsx
+  const hasSrcDir = existsSync(resolve(root, "src"));
+  const hasUiDir  = existsSync(resolve(root, "ui"));
+  const viteRef   = (() => {
+    try {
+      return readFileSync(resolve(root, "vite.config.ts"), "utf8").includes("src/content.tsx");
+    } catch { return false; }
+  })();
+  if ((hasSrcDir || viteRef) && !hasUiDir) {
+    issues.push({ kind: "src→ui", desc: "src/  →  ui/  (+ vite.config.ts, tsconfig.json)" });
+  }
+
+  if (existsSync(resolve(root, "main.py")) && !existsSync(resolve(root, "py"))) {
+    issues.push({ kind: "main→py", desc: "main.py  →  py/main.py" });
+  }
+  if (existsSync(resolve(root, "backend"))) {
+    issues.push({ kind: "backend→py", desc: "backend/  →  py/" });
+  }
+  return issues;
+}
+
+async function migrateStructure(root, issues) {
+  log.warn("This plugin project's structure is outdated:");
+  for (const issue of issues) log.info("  • " + issue.desc);
+  log.warn("Files will be moved and modified. Back up or commit your work before proceeding.");
+
+  const answer = await prompt("Migrate project structure? [y/N] ");
+  if (answer.toLowerCase() !== "y") {
+    log.info("Structure migration skipped.");
+    return;
+  }
+
+  for (const issue of issues) {
+    if (issue.kind === "src→ui") {
+      if (existsSync(resolve(root, "src"))) {
+        renameSync(resolve(root, "src"), resolve(root, "ui"));
+        log.ok("src/  →  ui/");
+      }
+
+      const vitePath = resolve(root, "vite.config.ts");
+      if (existsSync(vitePath)) {
+        writeFileSync(vitePath, readFileSync(vitePath, "utf8").replace(/["']src\/content\.tsx["']/g, '"ui/content.tsx"'));
+        log.ok("vite.config.ts entry updated");
+      }
+      const tscPath = resolve(root, "tsconfig.json");
+      if (existsSync(tscPath)) {
+        writeFileSync(tscPath, readFileSync(tscPath, "utf8").replace(/"src"/g, '"ui"'));
+        log.ok("tsconfig.json include updated");
+      }
+    }
+
+    if (issue.kind === "main→py") {
+      mkdirSync(resolve(root, "py"), { recursive: true });
+      renameSync(resolve(root, "main.py"), resolve(root, "py", "main.py"));
+      log.ok("main.py  →  py/main.py");
+    }
+
+    if (issue.kind === "backend→py") {
+      renameSync(resolve(root, "backend"), resolve(root, "py"));
+      log.ok("backend/  →  py/");
+      const pyReqs = resolve(root, "py", "requirements.txt");
+      const rootReqs = resolve(root, "requirements.txt");
+      if (existsSync(pyReqs) && !existsSync(rootReqs)) {
+        renameSync(pyReqs, rootReqs);
+        log.ok("py/requirements.txt  →  requirements.txt (project root)");
+      }
+    }
+  }
+
+  log.ok("Migration complete. Run `muscat-pk build` to verify.");
+}
+
+// ── plugin project local deps ─────────────────────────────────────────────────
+
+function updateLocalDeps(root, tag) {
+  const pm = detectPm(root);
+  const list = [`${KIT_PUBLISHED_NAME}@${tag}`, `${PLUGIN_UI_PACKAGE}@${tag}`];
+  const cmd =
+    pm === "npm"   ? `npm install ${list.join(" ")}`
+    : pm === "yarn" ? `yarn add ${list.join(" ")}`
+    : `${pm} add ${list.join(" ")}`;
+
+  log.step(`Updating plugin local deps (${pm}): ${list.join(", ")}`);
+  try {
+    execSync(cmd, { cwd: root, stdio: "inherit" });
+    log.ok("Local deps updated.");
+  } catch {
+    log.warn("Local deps update failed (offline?). Run manually:\n  " + cmd);
+  }
+}
+
+// ── main ─────────────────────────────────────────────────────────────────────
+
+async function resolveTag(explicitTag) {
+  if (explicitTag) return explicitTag;
+
+  const current = kitVersion();
+  const isDevVersion = current.includes("-dev.");
+
+  if (!isDevVersion) return "latest";
+
+  const answer = await prompt(
+    `You are on a dev version (v${current}).\n` +
+    `  [1] Stay on dev  — update to latest dev build\n` +
+    `  [2] Switch to stable — update to latest stable release\n` +
+    `Choice [1/2, default: 1]: `
+  );
+  return answer.trim() === "2" ? "latest" : "dev";
+}
+
+export async function runUpdate(args = []) {
+  const opts = parseArgs(args, { booleans: ["global"] });
+  const explicitTag = opts._[0] || opts.version || opts.tag || "";
+  const tag = await resolveTag(explicitTag);
+
+  // 지금 도는 게 프로젝트의 로컬 설치면 그 프로젝트만 건드린다. 이 머신의 다른
+  // 프로젝트들이 쓰는 글로벌 CLI까지 같이 올리려면 --global을 명시해야 한다.
+  const runningLocal = isLocalKitInstall();
+
+  // 1. Update the CLI itself
+  if (!runningLocal || opts.global) {
+    if (isBinaryMode) {
+      log.step("Updating binary…");
+      try {
+        await updateBinary(tag);
+      } catch (err) {
+        log.warn(`Binary update failed: ${err.message}`);
+      }
+    } else {
+      const isGlobal = (() => {
+        try {
+          const prefix = execSync("npm prefix -g", { encoding: "utf8" }).trim();
+          return (
+            // Unix: {prefix}/bin/muscat-pk
+            existsSync(join(prefix, "bin", "muscat-pk")) ||
+            // Windows npm: {prefix}/muscat-pk.cmd (no bin/ subdir)
+            existsSync(join(prefix, "muscat-pk.cmd")) ||
+            existsSync(join(prefix, "bin", "muscat-pk.cmd"))
+          );
+        } catch { return false; }
+      })();
+
+      if (isGlobal) {
+        try {
+          updateNpmGlobal(tag);
+        } catch (err) {
+          log.warn(`Global CLI update failed: ${err.message}`);
+        }
+      }
+    }
+  } else {
+    log.info("Local install detected — updating this project only. Pass --global to also update the global CLI.");
+  }
+
+  // 2. Plugin project: structure migration + local deps
+  let root;
+  try {
+    root = findPluginRoot();
+  } catch {
+    // Not inside a plugin project — skip
+    return;
+  }
+
+  try {
+    const structureIssues = detectOldStructure(root);
+    if (structureIssues.length > 0) {
+      await migrateStructure(root, structureIssues);
+    }
+  } catch (err) {
+    log.warn(`Structure check failed: ${err.message}`);
+  }
+
+  updateLocalDeps(root, tag);
+}