@rainbow-robotics/muscat-plugin-kit 0.1.2-dev.37 → 0.1.2-dev.39

package/README.md

@@ -17,29 +17,29 @@ npm install -g @rainbow-robotics/muscat-plugin-kit@dev
 npm install -g @rainbow-robotics/muscat-plugin-kit@1.2.3
 ```
 
-### 방법 2 — 설치 스크립트 (Node.js 없어도 됨)
+### 방법 2 — S3 설치 스크립트 (Node.js 없어도 됨)
 
 macOS / Linux / WSL:
 
 ```bash
 # 최신 stable
-curl -fsSL https://raw.githubusercontent.com/rainbow-robotics/web-rainbow-ui/main/scripts/install-muscat-pk.sh | sh
+curl -fsSL https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/install.sh | sh
 
 # dev 채널
-MUSCAT_PK_TAG=dev curl -fsSL https://raw.githubusercontent.com/rainbow-robotics/web-rainbow-ui/main/scripts/install-muscat-pk.sh | sh
+curl -fsSL https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/install.sh | MUSCAT_PK_TAG=dev sh
 
 # 특정 버전
-MUSCAT_PK_TAG=1.2.3 curl -fsSL https://raw.githubusercontent.com/rainbow-robotics/web-rainbow-ui/main/scripts/install-muscat-pk.sh | sh
+curl -fsSL https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/install.sh | MUSCAT_PK_TAG=1.2.3 sh
 ```
 
 Windows PowerShell:
 
 ```powershell
 # 최신 stable
-irm https://raw.githubusercontent.com/rainbow-robotics/web-rainbow-ui/main/scripts/install-muscat-pk.ps1 | iex
+irm https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/install.ps1 | iex
 
 # dev 채널
-$env:MUSCAT_PK_TAG="dev"; irm https://raw.githubusercontent.com/rainbow-robotics/web-rainbow-ui/main/scripts/install-muscat-pk.ps1 | iex
+$env:MUSCAT_PK_TAG="dev"; irm https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/install.ps1 | iex
 ```
 
 > 설치 스크립트는 Node.js 20+가 있으면 npm을 우선 사용하고, 없으면 S3에서 self-contained 바이너리를 받습니다.
@@ -48,12 +48,15 @@ $env:MUSCAT_PK_TAG="dev"; irm https://raw.githubusercontent.com/rainbow-robotics
 
 ```
 https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/v{버전}/{바이너리}
+https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/stable/{바이너리}
+https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/dev/{바이너리}
 ```
 
 | OS | 파일 |
 |---|---|
 | Linux x64 | `muscat-pk-linux-x64` |
 | macOS ARM64 | `muscat-pk-darwin-arm64` |
+| macOS x64 | `muscat-pk-darwin-x64` |
 | Windows x64 | `muscat-pk-win-x64.exe` |
 
 채널 포인터:
@@ -66,6 +69,24 @@ https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/latest-
 https://rainbow-deploy.s3.ap-northeast-2.amazonaws.com/muscat-plugin-kit/dev-version.txt
 ```
 
+### 삭제
+
+설치 방식과 관계없이 `muscat-pk`가 자기 자신을 삭제합니다.
+
+```bash
+muscat-pk uninstall
+```
+
+수동 삭제:
+
+```bash
+# npm으로 설치한 경우
+npm uninstall -g @rainbow-robotics/muscat-plugin-kit
+
+# S3 바이너리로 설치한 경우 (macOS/Linux 기본 경로)
+sudo rm -f /usr/local/bin/muscat-pk
+```
+
 ---
 
 ## 빠른 시작

package/cli/README.md

@@ -16,6 +16,7 @@ muscat-pk dev:ui      # preview the plugin in a mini-Muscat (preview-host)
 muscat-pk dev:back    # run the back end in a Docker container (python / cpp / ros2)
 muscat-pk dev         # dev:ui + dev:back
 muscat-pk update      # update @rainbow-robotics/muscat-plugin-kit and @rainbow-robotics/plugin-ui
+muscat-pk uninstall   # remove muscat-pk itself (npm global or S3 binary)
 muscat-pk sdk list | sdk update [version]   # manage rainbow-rb-sdk (python)
 ```
 

package/cli/bin/muscat-pk.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // muscat-pk — Muscat plugin developer CLI.
-// Subcommands: new, build, dev, dev:ui, dev:back, update, sdk.
+// Subcommands: new, build, dev, dev:ui, dev:back, update, uninstall, sdk.
 import { log } from "../src/util.mjs";
 import { runNew } from "../src/new.mjs";
 import { runBuild } from "../src/build.mjs";
@@ -8,6 +8,7 @@ import { runDevUi } from "../src/devUi.mjs";
 import { runDevBack } from "../src/devBack.mjs";
 import { runDev } from "../src/dev.mjs";
 import { runUpdate } from "../src/update.mjs";
+import { runUninstall } from "../src/uninstall.mjs";
 import { runSdk } from "../src/sdk.mjs";
 import { runType } from "../src/type.mjs";
 import { runPreview } from "../src/preview.mjs";
@@ -27,6 +28,7 @@ Commands:
   dev:back         Run the plugin back end (python: watchfiles reload / ros2: Docker)
   preview          Preview against a real Muscat server (prompts for robot IP)
   update           Update @rainbow-robotics/muscat-plugin-kit and @rainbow-robotics/plugin-ui
+  uninstall        Remove the installed muscat-pk CLI (npm global or S3 binary)
   sdk <list|update [version]>   Manage the python rainbow-rb-sdk version
 
 Run "muscat-pk <command> --help" for details.`;
@@ -50,6 +52,8 @@ async function main() {
         return await runPreview(args);
       case "update":
         return await runUpdate(args);
+      case "uninstall":
+        return await runUninstall(args);
       case "sdk":
         return await runSdk(args);
       case undefined:

package/cli/bundle-templates.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// Pre-build step: serialise cli/templates/** into cli/src/templates-embedded.mjs
+// so that `bun build --compile` can embed them without needing the filesystem.
+import { readdirSync, readFileSync, writeFileSync, statSync } from "node:fs";
+import { resolve, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(fileURLToPath(import.meta.url), "..");
+const templatesDir = resolve(root, "templates");
+const out = resolve(root, "src/templates-embedded.mjs");
+
+const files = {};
+function walk(dir) {
+  for (const name of readdirSync(dir)) {
+    const full = resolve(dir, name);
+    if (statSync(full).isDirectory()) { walk(full); continue; }
+    const key = relative(templatesDir, full);
+    files[key] = readFileSync(full, "base64");
+  }
+}
+walk(templatesDir);
+
+writeFileSync(out,
+  `// AUTO-GENERATED by cli/bundle-templates.mjs — do not edit.\n` +
+  `// ponytail: generated at publish time; not tracked in git.\n` +
+  `export const TEMPLATES = ${JSON.stringify(files)};\n`
+);
+console.log(`bundled ${Object.keys(files).length} template files → src/templates-embedded.mjs`);

package/cli/src/devBack.mjs

@@ -53,6 +53,7 @@ function runPython(root) {
   log.step("starting Python dev container…");
   const up = docker(
     ["run", "-d", "--name", container, ...netFlags,
+      "-e", "PIP_ROOT_USER_ACTION=ignore",
       "-v", `${root}:/plugin`, "-w", "/plugin", PYTHON_DEV_IMAGE, "sleep", "infinity"],
     { stdio: "inherit" },
   );
@@ -112,7 +113,7 @@ function runRos2(root) {
   docker(["rm", "-f", container], { stdio: "ignore" });
   log.step("starting ROS2 dev container…");
   const up = docker(
-    ["run", "-d", "--name", container, "-v", `${root}:/plugin`, "-w", "/plugin", ROS2_DEV_IMAGE, "sleep", "infinity"],
+    ["run", "-d", "--name", container, "-e", "PIP_ROOT_USER_ACTION=ignore", "-v", `${root}:/plugin`, "-w", "/plugin", ROS2_DEV_IMAGE, "sleep", "infinity"],
     { stdio: "inherit" },
   );
   if (up.status !== 0) throw new Error("failed to start dev container.");

package/cli/src/new.mjs

@@ -7,13 +7,28 @@ import {
   readFileSync,
   readdirSync,
   renameSync,
+  rmSync,
   statSync,
   writeFileSync,
 } from "node:fs";
-import { basename, resolve } from "node:path";
-import { rmSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
 import { hasBin, kitVersion, parseArgs, prompt, templatesDir, log } from "./util.mjs";
 
+// Like cpSync(src, dst, {recursive:true}) but reads from the embedded snapshot
+// when the templates dir doesn't exist on disk (compiled binary mode).
+// ponytail: import() is module-cached by the runtime — no manual cache needed.
+async function copyTemplate(srcDir, dst) {
+  if (existsSync(templatesDir)) { cpSync(srcDir, dst, { recursive: true }); return; }
+  const { TEMPLATES } = await import("./templates-embedded.mjs");
+  const prefix = srcDir.slice(templatesDir.length + 1).replace(/\\/g, "/") + "/";
+  for (const [key, b64] of Object.entries(TEMPLATES)) {
+    if (!key.startsWith(prefix)) continue;
+    const dest = resolve(dst, key.slice(prefix.length));
+    mkdirSync(dirname(dest), { recursive: true });
+    writeFileSync(dest, Buffer.from(b64, "base64"));
+  }
+}
+
 // `--type` values map to a runtime descriptor. ros2 has a python (rclpy) and a
 // C++ (rclcpp) flavor; we expose them as distinct type choices for clarity.
 export const TYPE_CHOICES = {
@@ -91,15 +106,15 @@ function renameSlugPaths(dir, slug) {
 // the kit (cli/docker/) so authors can't edit it. Caller runs applyTokens after.
 //   rclpy  → templates/ros2      (ament_python)
 //   rclcpp → templates/ros2-cpp  (ament_cmake)
-export function overlayRos2(target, slug, rosClient = "rclpy") {
+export async function overlayRos2(target, slug, rosClient = "rclpy") {
   const tmpl = rosClient === "rclcpp" ? "ros2-cpp" : "ros2";
-  cpSync(resolve(templatesDir, tmpl), target, { recursive: true });
+  await copyTemplate(resolve(templatesDir, tmpl), target);
   renameSlugPaths(resolve(target, "ros2_ws"), slug);
 }
 
 // Copy the cpp/ overlay (CMake project) into a plugin. Caller runs applyTokens after.
-export function overlayCpp(target) {
-  cpSync(resolve(templatesDir, "cpp"), target, { recursive: true });
+export async function overlayCpp(target) {
+  await copyTemplate(resolve(templatesDir, "cpp"), target);
 }
 
 export async function runNew(args) {
@@ -171,10 +186,10 @@ export async function runNew(args) {
   //   cpp      → cpp/ 오버레이, py/·requirements.txt 제거
   //   ros2(*)  → ros2_ws/ 오버레이 (rclpy=ament_python, rclcpp=ament_cmake)
   log.step(`scaffolding ${type} plugin → ${target}`);
-  cpSync(resolve(templatesDir, "common"), target, { recursive: true });
-  if (runtimeChoice.type === "ros2") overlayRos2(target, slug, runtimeChoice.rosClient);
+  await copyTemplate(resolve(templatesDir, "common"), target);
+  if (runtimeChoice.type === "ros2") await overlayRos2(target, slug, runtimeChoice.rosClient);
   if (runtimeChoice.type === "cpp") {
-    overlayCpp(target);
+    await overlayCpp(target);
     rmSync(resolve(target, "py"), { recursive: true, force: true });
     rmSync(resolve(target, "requirements.txt"), { force: true });
   }

package/cli/src/ros2.mjs

@@ -89,7 +89,7 @@ export function colconBuild(root, { image = ROS2_DEV_IMAGE, symlink = false, arc
   const platformFlags = dockerPlatform ? ["--platform", dockerPlatform] : [];
   const r = spawnSync(
     "docker",
-    ["run", "--rm", ...platformFlags, "-v", `${root}:/plugin`, "-w", "/plugin", actualImage, "bash", "-lc", script],
+    ["run", "--rm", ...platformFlags, "-e", "PIP_ROOT_USER_ACTION=ignore", "-v", `${root}:/plugin`, "-w", "/plugin", actualImage, "bash", "-lc", script],
     { cwd: root, stdio: "inherit" },
   );
   if (r.status !== 0) throw new Error(`colcon build failed${arch ? ` (${arch})` : ""}.`);

package/cli/src/type.mjs

@@ -69,7 +69,7 @@ export async function runType(args) {
       log.warn("ros2_ws/ already exists — keeping it, only flipping manifest type.");
     } else {
       log.step(`adding ros2_ws/ overlay (${runtimeChoice.rosClient})`);
-      overlayRos2(root, slug, runtimeChoice.rosClient);
+      await overlayRos2(root, slug, runtimeChoice.rosClient);
       applyTokens(root, {
         __PLUGIN_ID__: pluginId,
         __PLUGIN_NAME__: pluginName,
@@ -83,7 +83,7 @@ export async function runType(args) {
       log.warn("cpp/ already exists — keeping it, only flipping manifest type.");
     } else {
       log.step("adding cpp/ overlay");
-      overlayCpp(root);
+      await overlayCpp(root);
       applyTokens(root, {
         __PLUGIN_ID__: pluginId,
         __PLUGIN_NAME__: pluginName,

package/cli/src/uninstall.mjs

@@ -0,0 +1,98 @@
+// muscat-pk uninstall - remove the installed CLI, whether npm-global or S3 binary.
+import { execSync, spawn, spawnSync } from "node:child_process";
+import { existsSync, realpathSync, rmSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { KIT_PUBLISHED_NAME, kitRoot, log, parseArgs } from "./util.mjs";
+
+const isBinaryMode = typeof Bun !== "undefined";
+
+function isInside(child, parent) {
+  const rel = relative(parent, child);
+  return rel === "" || (!!rel && !rel.startsWith("..") && !rel.includes(":"));
+}
+
+function npmGlobalRoot() {
+  return execSync("npm root -g", { encoding: "utf8" }).trim();
+}
+
+function isNpmGlobalInstall() {
+  try {
+    return isInside(realpathSync(kitRoot), realpathSync(npmGlobalRoot()));
+  } catch {
+    return false;
+  }
+}
+
+function uninstallNpmGlobal() {
+  log.step(`npm uninstall -g ${KIT_PUBLISHED_NAME}`);
+  execSync(`npm uninstall -g ${KIT_PUBLISHED_NAME}`, { stdio: "inherit" });
+  log.ok("Global npm package removed.");
+}
+
+function uninstallBinary() {
+  const execPath = process.execPath;
+  log.step(`Removing binary: ${execPath}`);
+
+  if (process.platform === "win32") {
+    const ps = `Start-Sleep -Milliseconds 500; Remove-Item -Force '${execPath}'`;
+    spawn("powershell", ["-NoProfile", "-Command", ps], {
+      detached: true,
+      stdio: "ignore",
+    }).unref();
+    log.ok("Binary will be removed after this process exits.");
+    return;
+  }
+
+  try {
+    rmSync(execPath, { force: true });
+  } catch (err) {
+    if (err?.code !== "EACCES" && err?.code !== "EPERM") throw err;
+    log.info("  sudo is required...");
+    const result = spawnSync("sudo", ["rm", "-f", execPath], { stdio: "inherit" });
+    if (result.status !== 0) throw new Error(`sudo rm failed: ${execPath}`);
+  }
+
+  const parent = dirname(execPath);
+  for (const shim of ["muscat-pk.cmd", "muscat-pk.ps1"]) {
+    rmSync(join(parent, shim), { force: true });
+  }
+
+  log.ok("Binary removed.");
+}
+
+export async function runUninstall(args = []) {
+  const opts = parseArgs(args, { booleans: ["help"] });
+
+  if (opts.help) {
+    log.info(
+      [
+        "Usage: muscat-pk uninstall",
+        "",
+        "Removes the installed muscat-pk CLI.",
+        "  npm global install  -> npm uninstall -g @rainbow-robotics/muscat-plugin-kit",
+        "  S3 binary install   -> remove the muscat-pk executable",
+      ].join("\n"),
+    );
+    return;
+  }
+
+  if (isBinaryMode) {
+    uninstallBinary();
+    return;
+  }
+
+  if (isNpmGlobalInstall()) {
+    uninstallNpmGlobal();
+    return;
+  }
+
+  const localBin = process.argv[1] || "";
+  if (localBin.includes(`${join("node_modules", ".bin")}`) || existsSync(join(process.cwd(), "package.json"))) {
+    log.warn("This muscat-pk appears to be running from a project/local install.");
+    log.warn("Remove it from the project package manager instead, for example:");
+    log.warn(`  npm uninstall ${KIT_PUBLISHED_NAME}`);
+    return;
+  }
+
+  throw new Error("Could not determine install mode. Remove muscat-pk manually from your PATH.");
+}

package/cli/templates/common/README.md

@@ -386,4 +386,5 @@ muscat-pk type change    # switch backend type
 muscat-pk sdk list       # show current Python SDK version
 muscat-pk sdk update     # update Python SDK to latest
 muscat-pk update         # update muscat-plugin-kit itself
+muscat-pk uninstall      # remove muscat-pk itself
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/muscat-plugin-kit",
-  "version": "0.1.2-dev.37",
+  "version": "0.1.2-dev.39",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -31,7 +31,7 @@
     "@types/react-dom": "^19.0.4"
   },
   "dependencies": {
-    "@rainbow-robotics/preview-host": "0.1.2-dev.37",
+    "@rainbow-robotics/preview-host": "0.1.2-dev.39",
     "socket.io": "^4.8.1"
   },
   "optionalDependencies": {