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

package/cli/bin/muscat-pk.mjs

@@ -1,155 +1,155 @@
-#!/usr/bin/env node
-// muscat-pk — Muscat plugin developer CLI.
-// Subcommands: new, build, dev, dev:ui, dev:back, storybook, mcp, update, uninstall, sdk, version.
-import { readFileSync, realpathSync } from "node:fs";
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-import { color, kitVersion, log, resolveLocalCliBin } from "../src/util.mjs";
-import { runNew } from "../src/new.mjs";
-import { runBuild } from "../src/build.mjs";
-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 { runStorybook } from "../src/storybook.mjs";
-import { runCompletion } from "../src/completion.mjs";
-// mcp.mjs is dynamically imported below — it pulls in the MCP SDK + a full
-// TypeScript program, and every other command would pay that cold-start cost
-// on every invocation otherwise (see ros2.mjs/python.mjs/cpp.mjs for the same
-// pattern in build.mjs).
-
-// 실행 중인 게 글로벌/바이너리인데 cwd 상위에 로컬 설치가 있으면 그쪽으로 넘긴다.
-// vite preset / preview-host / manifest 검증이 항상 프로젝트가 고정한 버전과
-// 맞아야 해서다 (버전이 안 맞으면 "module not found" 류 에러로 터진다).
-function readVersion(binPath) {
-  try {
-    return JSON.parse(readFileSync(resolve(binPath, "../../../package.json"), "utf8")).version;
-  } catch {
-    return "";
-  }
-}
-
-const isBinaryMode = typeof Bun !== "undefined";
-
-// 바이너리에는 package.json 이 없다 — 컴파일 시 임베드한 버전을 쓴다.
-if (isBinaryMode && !process.env.MUSCAT_PK_VERSION) {
-  process.env.MUSCAT_PK_VERSION = (await import("../src/templates-embedded.mjs")).KIT_VERSION;
-}
-
-(function delegateToLocalInstall() {
-  try {
-    const localBin = resolveLocalCliBin();
-    if (!localBin) return;
-    // 바이너리는 node_modules 안의 mjs일 수 없으니 자기 자신 비교 생략.
-    // (import.meta.url이 /$bunfs/ 가상 경로라 realpath가 throw하기도 한다.)
-    if (!isBinaryMode && realpathSync(localBin) === realpathSync(fileURLToPath(import.meta.url))) return;
-    // Say so — otherwise an outdated local copy silently answers instead, and
-    // its missing/renamed subcommands look like the CLI is broken.
-    const localVersion = readVersion(localBin);
-    console.error(
-      color.dim(`[muscat-pk] using this project's local install${localVersion ? ` (v${localVersion})` : ""}: ${localBin}`),
-    );
-    // Bun 바이너리의 execPath는 스크립트 인자를 실행하지 않으니 PATH의 node로 넘긴다.
-    const runtime = isBinaryMode ? "node" : process.execPath;
-    const r = spawnSync(runtime, [localBin, ...process.argv.slice(2)], { stdio: "inherit" });
-    if (r.error) {
-      log.warn(`Failed to run local install via ${runtime} (${r.error.code}); continuing with this binary.`);
-      return;
-    }
-    process.exit(r.status ?? 0);
-  } catch {
-    // realpath 실패 등 — 그냥 지금 프로세스로 계속.
-  }
-})();
-
-const [, , cmd, ...args] = process.argv;
-
-const commandRow = (command, description) => `  ${color.cyan(command.padEnd(30))}${description}`;
-const option = (text) => color.yellow(text);
-
-function formatHelp() {
-  return [
-    `${color.bold("muscat-pk")} ${color.dim("— Muscat plugin kit")}`,
-    "",
-    `${color.bold("Usage:")} ${color.cyan("muscat-pk")} ${color.yellow("<command>")} ${color.dim("[options]")}`,
-    "",
-    color.bold("Commands:"),
-    commandRow("new [dir]", `Scaffold a new plugin project ${color.dim("(prompts: author, email, description, type, front-package-manager)")}`),
-    commandRow("type change", `Switch backend type ${color.dim("(python | cpp | ros2-python | ros2-cpp)")}`),
-    commandRow("build", `Build + lock deps + vendor wheels + zip ${color.dim(`(${option("--no-zip")}: skip zip, ${option("--no-lock")}: skip python lock/vendor, ${option("--arch")} amd64|arm64|both)`)}`),
-    commandRow("dev", "Run a local Muscat runtime, dev:ui, and dev:back together"),
-    commandRow("dev:ui", `Preview the plugin in a mini-Muscat ${color.dim("(preview-host)")}`),
-    commandRow("dev:back", `Run the plugin back end ${color.dim("(python: watchfiles reload / ros2: Docker)")}`),
-    commandRow("storybook", `Browse the bundled rb-components Storybook ${color.dim(`(${option("--port")} <n>, ${option("--rebuild")})`)}`),
-    commandRow("mcp", `Start an MCP server ${color.dim("(stdio)")} exposing rb-components/rb SDK docs to AI agents ${color.dim(`(${option("--install")} codex: register in ~/.codex/config.toml)`)}`),
-    commandRow("update", `Update ${color.magenta("@rainbow-robotics/muscat-plugin-kit")} and ${color.magenta("@rainbow-robotics/plugin-ui")} ${color.dim(`(local-only if run from a project's local install; ${option("--global")} also updates the global CLI)`)}`),
-    commandRow("uninstall", `Remove the installed ${color.cyan("muscat-pk")} CLI ${color.dim("(npm global or S3 binary)")}`),
-    commandRow("sdk <list|update [version]>", "Manage the python rainbow-rb-sdk version"),
-    commandRow("version", `Print the installed ${color.cyan("muscat-pk")} version`),
-    commandRow("completion [shell]", `Print a shell completion script ${color.dim("(bash | zsh | fish | powershell)")}`),
-    "",
-    `Run ${color.cyan("muscat-pk <command> --help")} for details.`,
-  ].join("\n");
-}
-
-async function main() {
-  try {
-    switch (cmd) {
-      case "new":
-        return await runNew(args);
-      case "type":
-        return await runType(args);
-      case "build":
-        return await runBuild(args);
-      case "dev":
-        return await runDev(args);
-      case "dev:ui":
-        return await runDevUi(args);
-      case "dev:back":
-        return await runDevBack(args);
-      case "storybook":
-        return await runStorybook(args);
-      case "mcp": {
-        const { runMcp, installMcp } = await import("../src/mcp.mjs");
-        if (args[0] === "--install" || args[0] === "install")
-          return installMcp(args[1]);
-        return await runMcp(args);
-      }
-      case "update":
-        return await runUpdate(args);
-      case "uninstall":
-        return await runUninstall(args);
-      case "sdk":
-        return await runSdk(args);
-      case "completion":
-        return await runCompletion(args);
-      case "version":
-      case "-v":
-      case "--version":
-        console.log(kitVersion());
-        return;
-      case undefined:
-      case "-h":
-      case "--help":
-      case "help":
-        console.log(formatHelp());
-        return;
-      default:
-        console.error(`Unknown command: ${cmd}\n`);
-        console.log(formatHelp());
-        process.exitCode = 1;
-    }
-  } catch (err) {
-    console.error();
-    log.error(err?.message || String(err));
-    // exit, not exitCode: a failed dev:ui (e.g. Ctrl+C before vite was ready) leaves file watchers that
-    // would keep the process hanging.
-    process.exit(1);
-  }
-}
-
-main();
+#!/usr/bin/env node
+// muscat-pk — Muscat plugin developer CLI.
+// Subcommands: new, build, dev, dev:ui, dev:back, storybook, mcp, update, uninstall, sdk, version.
+import { readFileSync, realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import { color, kitVersion, log, resolveLocalCliBin } from "../src/util.mjs";
+import { runNew } from "../src/new.mjs";
+import { runBuild } from "../src/build.mjs";
+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 { runStorybook } from "../src/storybook.mjs";
+import { runCompletion } from "../src/completion.mjs";
+// mcp.mjs is dynamically imported below — it pulls in the MCP SDK + a full
+// TypeScript program, and every other command would pay that cold-start cost
+// on every invocation otherwise (see ros2.mjs/python.mjs/cpp.mjs for the same
+// pattern in build.mjs).
+
+// 실행 중인 게 글로벌/바이너리인데 cwd 상위에 로컬 설치가 있으면 그쪽으로 넘긴다.
+// vite preset / preview-host / manifest 검증이 항상 프로젝트가 고정한 버전과
+// 맞아야 해서다 (버전이 안 맞으면 "module not found" 류 에러로 터진다).
+function readVersion(binPath) {
+  try {
+    return JSON.parse(readFileSync(resolve(binPath, "../../../package.json"), "utf8")).version;
+  } catch {
+    return "";
+  }
+}
+
+const isBinaryMode = typeof Bun !== "undefined";
+
+// 바이너리에는 package.json 이 없다 — 컴파일 시 임베드한 버전을 쓴다.
+if (isBinaryMode && !process.env.MUSCAT_PK_VERSION) {
+  process.env.MUSCAT_PK_VERSION = (await import("../src/templates-embedded.mjs")).KIT_VERSION;
+}
+
+(function delegateToLocalInstall() {
+  try {
+    const localBin = resolveLocalCliBin();
+    if (!localBin) return;
+    // 바이너리는 node_modules 안의 mjs일 수 없으니 자기 자신 비교 생략.
+    // (import.meta.url이 /$bunfs/ 가상 경로라 realpath가 throw하기도 한다.)
+    if (!isBinaryMode && realpathSync(localBin) === realpathSync(fileURLToPath(import.meta.url))) return;
+    // Say so — otherwise an outdated local copy silently answers instead, and
+    // its missing/renamed subcommands look like the CLI is broken.
+    const localVersion = readVersion(localBin);
+    console.error(
+      color.dim(`[muscat-pk] using this project's local install${localVersion ? ` (v${localVersion})` : ""}: ${localBin}`),
+    );
+    // Bun 바이너리의 execPath는 스크립트 인자를 실행하지 않으니 PATH의 node로 넘긴다.
+    const runtime = isBinaryMode ? "node" : process.execPath;
+    const r = spawnSync(runtime, [localBin, ...process.argv.slice(2)], { stdio: "inherit" });
+    if (r.error) {
+      log.warn(`Failed to run local install via ${runtime} (${r.error.code}); continuing with this binary.`);
+      return;
+    }
+    process.exit(r.status ?? 0);
+  } catch {
+    // realpath 실패 등 — 그냥 지금 프로세스로 계속.
+  }
+})();
+
+const [, , cmd, ...args] = process.argv;
+
+const commandRow = (command, description) => `  ${color.cyan(command.padEnd(30))}${description}`;
+const option = (text) => color.yellow(text);
+
+function formatHelp() {
+  return [
+    `${color.bold("muscat-pk")} ${color.dim("— Muscat plugin kit")}`,
+    "",
+    `${color.bold("Usage:")} ${color.cyan("muscat-pk")} ${color.yellow("<command>")} ${color.dim("[options]")}`,
+    "",
+    color.bold("Commands:"),
+    commandRow("new [dir]", `Scaffold a new plugin project ${color.dim("(prompts: author, email, description, type, front-package-manager)")}`),
+    commandRow("type change", `Switch backend type ${color.dim("(python | cpp | ros2-python | ros2-cpp)")}`),
+    commandRow("build", `Build + lock deps + vendor wheels + zip ${color.dim(`(${option("--no-zip")}: skip zip, ${option("--no-lock")}: skip python lock/vendor, ${option("--arch")} amd64|arm64|both)`)}`),
+    commandRow("dev", "Run a local Muscat runtime, dev:ui, and dev:back together"),
+    commandRow("dev:ui", `Preview the plugin in a mini-Muscat ${color.dim("(preview-host)")}`),
+    commandRow("dev:back", `Run the plugin back end ${color.dim("(python: watchfiles reload / ros2: Docker)")}`),
+    commandRow("storybook", `Browse the bundled rb-components Storybook ${color.dim(`(${option("--port")} <n>, ${option("--rebuild")})`)}`),
+    commandRow("mcp", `Start an MCP server ${color.dim("(stdio)")} exposing rb-components/rb SDK docs to AI agents ${color.dim(`(${option("--install")} codex: register in ~/.codex/config.toml)`)}`),
+    commandRow("update", `Update ${color.magenta("@rainbow-robotics/muscat-plugin-kit")} and ${color.magenta("@rainbow-robotics/plugin-ui")} ${color.dim(`(local-only if run from a project's local install; ${option("--global")} also updates the global CLI)`)}`),
+    commandRow("uninstall", `Remove the installed ${color.cyan("muscat-pk")} CLI ${color.dim("(npm global or S3 binary)")}`),
+    commandRow("sdk <list|update [version]>", "Manage the python rainbow-rb-sdk version"),
+    commandRow("version", `Print the installed ${color.cyan("muscat-pk")} version`),
+    commandRow("completion [shell]", `Print a shell completion script ${color.dim("(bash | zsh | fish | powershell)")}`),
+    "",
+    `Run ${color.cyan("muscat-pk <command> --help")} for details.`,
+  ].join("\n");
+}
+
+async function main() {
+  try {
+    switch (cmd) {
+      case "new":
+        return await runNew(args);
+      case "type":
+        return await runType(args);
+      case "build":
+        return await runBuild(args);
+      case "dev":
+        return await runDev(args);
+      case "dev:ui":
+        return await runDevUi(args);
+      case "dev:back":
+        return await runDevBack(args);
+      case "storybook":
+        return await runStorybook(args);
+      case "mcp": {
+        const { runMcp, installMcp } = await import("../src/mcp.mjs");
+        if (args[0] === "--install" || args[0] === "install")
+          return installMcp(args[1]);
+        return await runMcp(args);
+      }
+      case "update":
+        return await runUpdate(args);
+      case "uninstall":
+        return await runUninstall(args);
+      case "sdk":
+        return await runSdk(args);
+      case "completion":
+        return await runCompletion(args);
+      case "version":
+      case "-v":
+      case "--version":
+        console.log(kitVersion());
+        return;
+      case undefined:
+      case "-h":
+      case "--help":
+      case "help":
+        console.log(formatHelp());
+        return;
+      default:
+        console.error(`Unknown command: ${cmd}\n`);
+        console.log(formatHelp());
+        process.exitCode = 1;
+    }
+  } catch (err) {
+    console.error();
+    log.error(err?.message || String(err));
+    // exit, not exitCode: a failed dev:ui (e.g. Ctrl+C before vite was ready) leaves file watchers that
+    // would keep the process hanging.
+    process.exit(1);
+  }
+}
+
+main();

package/cli/bundle-templates.mjs

@@ -1,31 +1,31 @@
-#!/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 } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const root = resolve(fileURLToPath(import.meta.url), "..");
-const out = resolve(root, "src/templates-embedded.mjs");
-
-const files = {};
-function walk(baseDir, prefix) {
-  for (const name of readdirSync(baseDir)) {
-    const full = resolve(baseDir, name);
-    const key = prefix + name;
-    if (statSync(full).isDirectory()) { walk(full + "/", key + "/"); continue; }
-    files[key] = readFileSync(full, "base64");
-  }
-}
-walk(resolve(root, "templates") + "/", "");
-walk(resolve(root, "docker") + "/", "docker/");
-
-const { version } = JSON.parse(readFileSync(resolve(root, "../package.json"), "utf8"));
-
-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 KIT_VERSION = ${JSON.stringify(version)};\n` +
-  `export const TEMPLATES = ${JSON.stringify(files)};\n`
-);
-console.log(`bundled ${Object.keys(files).length} template files → src/templates-embedded.mjs`);
+#!/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 } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(fileURLToPath(import.meta.url), "..");
+const out = resolve(root, "src/templates-embedded.mjs");
+
+const files = {};
+function walk(baseDir, prefix) {
+  for (const name of readdirSync(baseDir)) {
+    const full = resolve(baseDir, name);
+    const key = prefix + name;
+    if (statSync(full).isDirectory()) { walk(full + "/", key + "/"); continue; }
+    files[key] = readFileSync(full, "base64");
+  }
+}
+walk(resolve(root, "templates") + "/", "");
+walk(resolve(root, "docker") + "/", "docker/");
+
+const { version } = JSON.parse(readFileSync(resolve(root, "../package.json"), "utf8"));
+
+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 KIT_VERSION = ${JSON.stringify(version)};\n` +
+  `export const TEMPLATES = ${JSON.stringify(files)};\n`
+);
+console.log(`bundled ${Object.keys(files).length} template files → src/templates-embedded.mjs`);

package/cli/docker/Dockerfile.cpp

@@ -1,28 +1,28 @@
-# Dev/build container for the pure C++ plugin back end.
-# Matches the Muscat robot backend OS (Ubuntu 24.04) so the compiled binary
-# is ABI-compatible with the robot. Used by `muscat-pk dev:back` and `build`
-# — NOT shipped in the plugin ZIP.
-FROM ubuntu:24.04
-LABEL com.rainbow-robotics.muscat-pk="true"
-
-RUN apt-get update && apt-get install -y --no-install-recommends \
-      build-essential \
-      cmake \
-    && rm -rf /var/lib/apt/lists/*
-
-# Rainbow Robotics C++ SDK for find_package(rb_sdk). muscat-pk passes the version pinned in the
-# project's CMakeLists.txt (find_package(rb_sdk <ver> EXACT)); without a pin (ROS 2 rclpy, `muscat-pk mcp`
-# outside a project) the newest SDK is installed. Runtime and -dev are installed together at one version.
-ARG RB_SDK_VERSION=
-RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl \
-    && install -d /etc/apt/keyrings \
-    && curl -fsSL https://rainbowrobotics.github.io/rb-sdk/rb-sdk-apt-repo.gpg.key -o /etc/apt/keyrings/rb-sdk.asc \
-    && printf 'deb [signed-by=/etc/apt/keyrings/rb-sdk.asc] https://rainbowrobotics.github.io/rb-sdk %s main\n' stable dev > /etc/apt/sources.list.d/rb-sdk.list \
-    && apt-get update \
-    && apt-get install -y --no-install-recommends "rainbow-rb-sdk${RB_SDK_VERSION:+=$RB_SDK_VERSION}" "rainbow-rb-sdk-dev${RB_SDK_VERSION:+=$RB_SDK_VERSION}" \
-    && rm -rf /var/lib/apt/lists/*
-
-
-WORKDIR /plugin
-
-CMD ["bash"]
+# Dev/build container for the pure C++ plugin back end.
+# Matches the Muscat robot backend OS (Ubuntu 24.04) so the compiled binary
+# is ABI-compatible with the robot. Used by `muscat-pk dev:back` and `build`
+# — NOT shipped in the plugin ZIP.
+FROM ubuntu:24.04
+LABEL com.rainbow-robotics.muscat-pk="true"
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      build-essential \
+      cmake \
+    && rm -rf /var/lib/apt/lists/*
+
+# Rainbow Robotics C++ SDK for find_package(rb_sdk). muscat-pk passes the version pinned in the
+# project's CMakeLists.txt (find_package(rb_sdk <ver> EXACT)); without a pin (ROS 2 rclpy, `muscat-pk mcp`
+# outside a project) the newest SDK is installed. Runtime and -dev are installed together at one version.
+ARG RB_SDK_VERSION=
+RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl \
+    && install -d /etc/apt/keyrings \
+    && curl -fsSL https://rainbowrobotics.github.io/rb-sdk/rb-sdk-apt-repo.gpg.key -o /etc/apt/keyrings/rb-sdk.asc \
+    && printf 'deb [signed-by=/etc/apt/keyrings/rb-sdk.asc] https://rainbowrobotics.github.io/rb-sdk %s main\n' stable dev > /etc/apt/sources.list.d/rb-sdk.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends "rainbow-rb-sdk${RB_SDK_VERSION:+=$RB_SDK_VERSION}" "rainbow-rb-sdk-dev${RB_SDK_VERSION:+=$RB_SDK_VERSION}" \
+    && rm -rf /var/lib/apt/lists/*
+
+
+WORKDIR /plugin
+
+CMD ["bash"]

package/cli/docker/Dockerfile.dev

@@ -1,30 +1,30 @@
-# Dev-only container for the ROS2 plugin back end.
-# Matches the Muscat robot backend: ROS2 Jazzy + Python 3.12 (Ubuntu 24.04).
-# Used by `muscat-pk dev:back` — NOT shipped in the plugin ZIP.
-FROM ros:jazzy-ros-base
-LABEL com.rainbow-robotics.muscat-pk="true"
-
-RUN apt-get update && apt-get install -y --no-install-recommends \
-      python3-pip \
-      python3-colcon-common-extensions \
-    && rm -rf /var/lib/apt/lists/*
-
-# Rainbow Robotics C++ SDK for find_package(rb_sdk). muscat-pk passes the version pinned in the
-# project's CMakeLists.txt (find_package(rb_sdk <ver> EXACT)); without a pin (ROS 2 rclpy, `muscat-pk mcp`
-# outside a project) the newest SDK is installed. Runtime and -dev are installed together at one version.
-ARG RB_SDK_VERSION=
-RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl \
-    && install -d /etc/apt/keyrings \
-    && curl -fsSL https://rainbowrobotics.github.io/rb-sdk/rb-sdk-apt-repo.gpg.key -o /etc/apt/keyrings/rb-sdk.asc \
-    && printf 'deb [signed-by=/etc/apt/keyrings/rb-sdk.asc] https://rainbowrobotics.github.io/rb-sdk %s main\n' stable dev > /etc/apt/sources.list.d/rb-sdk.list \
-    && apt-get update \
-    && apt-get install -y --no-install-recommends "rainbow-rb-sdk${RB_SDK_VERSION:+=$RB_SDK_VERSION}" "rainbow-rb-sdk-dev${RB_SDK_VERSION:+=$RB_SDK_VERSION}" \
-    && rm -rf /var/lib/apt/lists/*
-
-
-# `docker exec` skips /ros_entrypoint.sh — source ROS for the login shells dev:back runs.
-RUN echo ". /opt/ros/${ROS_DISTRO}/setup.sh" > /etc/profile.d/ros.sh
-
-WORKDIR /plugin
-
-CMD ["bash"]
+# Dev-only container for the ROS2 plugin back end.
+# Matches the Muscat robot backend: ROS2 Jazzy + Python 3.12 (Ubuntu 24.04).
+# Used by `muscat-pk dev:back` — NOT shipped in the plugin ZIP.
+FROM ros:jazzy-ros-base
+LABEL com.rainbow-robotics.muscat-pk="true"
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      python3-pip \
+      python3-colcon-common-extensions \
+    && rm -rf /var/lib/apt/lists/*
+
+# Rainbow Robotics C++ SDK for find_package(rb_sdk). muscat-pk passes the version pinned in the
+# project's CMakeLists.txt (find_package(rb_sdk <ver> EXACT)); without a pin (ROS 2 rclpy, `muscat-pk mcp`
+# outside a project) the newest SDK is installed. Runtime and -dev are installed together at one version.
+ARG RB_SDK_VERSION=
+RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl \
+    && install -d /etc/apt/keyrings \
+    && curl -fsSL https://rainbowrobotics.github.io/rb-sdk/rb-sdk-apt-repo.gpg.key -o /etc/apt/keyrings/rb-sdk.asc \
+    && printf 'deb [signed-by=/etc/apt/keyrings/rb-sdk.asc] https://rainbowrobotics.github.io/rb-sdk %s main\n' stable dev > /etc/apt/sources.list.d/rb-sdk.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends "rainbow-rb-sdk${RB_SDK_VERSION:+=$RB_SDK_VERSION}" "rainbow-rb-sdk-dev${RB_SDK_VERSION:+=$RB_SDK_VERSION}" \
+    && rm -rf /var/lib/apt/lists/*
+
+
+# `docker exec` skips /ros_entrypoint.sh — source ROS for the login shells dev:back runs.
+RUN echo ". /opt/ros/${ROS_DISTRO}/setup.sh" > /etc/profile.d/ros.sh
+
+WORKDIR /plugin
+
+CMD ["bash"]

package/cli/docker/Dockerfile.python

@@ -1,21 +1,21 @@
-# Dev/build container for the Python plugin back end.
-# Matches the Muscat robot backend: Ubuntu 24.04 + Python 3.12.
-# Used by `muscat-pk dev:back` (hot-reload) and `muscat-pk build` (lock + wheel vendor).
-# NOT shipped in the plugin ZIP — the robot installs deps from dist/wheels/ offline.
-FROM ubuntu:24.04
-LABEL com.rainbow-robotics.muscat-pk="true"
-
-RUN apt-get update && apt-get install -y --no-install-recommends \
-      python3 \
-      python3-pip \
-    && rm -rf /var/lib/apt/lists/* \
-    && pip3 install uv==0.8.18 --break-system-packages
-
-# TODO(cpp-sdk): the Python SDK is a pybind wrapper over the cpp SDK, so the
-# cpp SDK shared lib must be present for the python module to load. Install the
-# rainbow cpp SDK (apt, pinned to the robot's version) here once it exists.
-
-
-WORKDIR /plugin
-
-CMD ["bash"]
+# Dev/build container for the Python plugin back end.
+# Matches the Muscat robot backend: Ubuntu 24.04 + Python 3.12.
+# Used by `muscat-pk dev:back` (hot-reload) and `muscat-pk build` (lock + wheel vendor).
+# NOT shipped in the plugin ZIP — the robot installs deps from dist/wheels/ offline.
+FROM ubuntu:24.04
+LABEL com.rainbow-robotics.muscat-pk="true"
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      python3 \
+      python3-pip \
+    && rm -rf /var/lib/apt/lists/* \
+    && pip3 install uv==0.8.18 --break-system-packages
+
+# TODO(cpp-sdk): the Python SDK is a pybind wrapper over the cpp SDK, so the
+# cpp SDK shared lib must be present for the python module to load. Install the
+# rainbow cpp SDK (apt, pinned to the robot's version) here once it exists.
+
+
+WORKDIR /plugin
+
+CMD ["bash"]