@rainbow-robotics/muscat-plugin-kit 0.1.2-dev.27 → 0.1.2-dev.28

package/cli/bin/muscat-pk.mjs

@@ -21,7 +21,7 @@ Usage: muscat-pk <command> [options]
 Commands:
   new [dir]        Scaffold a new plugin project (prompts: author, email, description, type, pm)
   type change      Switch backend type (python | cpp | ros2 | ros2-cpp)
-  build            Build ui/content.tsx -> dist/ and zip into a distributable ZIP (--no-zip to skip)
+  build            Build + lock deps + vendor wheels + zip (--no-zip: skip zip, --no-lock: skip python lock/vendor)
   dev              Run Socket.IO bridge, dev:ui, and dev:back together
   dev:ui           Preview the plugin in a mini-Muscat (preview-host)
   dev:back         Run the plugin back end (python: watchfiles reload / ros2: Docker)

package/cli/docker/Dockerfile.bridge

@@ -5,6 +5,7 @@
 #                         so it reaches the bridge at localhost:10000 too
 # Build context is the `cli/` dir so it can copy src/socketBridge.mjs.
 FROM node:20-slim
+LABEL com.rainbow-robotics.muscat-pk="true"
 
 WORKDIR /bridge
 COPY docker/bridge-package.json package.json

package/cli/docker/Dockerfile.cpp

@@ -3,6 +3,7 @@
 # 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 \

package/cli/docker/Dockerfile.dev

@@ -2,6 +2,7 @@
 # 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 \

package/cli/docker/Dockerfile.python

@@ -1,13 +1,15 @@
-# Dev container for the Python plugin back end.
+# 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` — NOT shipped in the plugin ZIP (the robot
-# pip-installs requirements itself at load time).
+# 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/*
+    && rm -rf /var/lib/apt/lists/* \
+    && pip3 install uv --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

package/cli/src/bridge.mjs

@@ -7,7 +7,7 @@ import { spawnSync } from "node:child_process";
 import { createServer, connect } from "node:net";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { hasBin, kitRoot, log } from "./util.mjs";
+import { hasBin, kitRoot, log, pruneMuskatImages } from "./util.mjs";
 
 export const BRIDGE_IMAGE = "muscat-pk-bridge";
 export const BRIDGE_CONTAINER = "muscat-pk-bridge-run";
@@ -56,6 +56,7 @@ function ensureImage() {
   log.step(`docker build -t ${BRIDGE_IMAGE} (first run is slow, then cached)…`);
   const r = spawnSync("docker", ["build", "-t", BRIDGE_IMAGE, "-f", DOCKERFILE, BUILD_CONTEXT], { stdio: "inherit" });
   if (r.status !== 0) throw new Error("docker build failed (bridge image).");
+  pruneMuskatImages();
 }
 
 /** Build the image, preflight the port, and start the bridge container. */

package/cli/src/build.mjs

@@ -12,6 +12,7 @@
 import { chmodSync, cpSync, copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { basename, dirname, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
 import { execSync, spawnSync } from "node:child_process";
 import { ensureDocker, findPluginRoot, hasBin, humanSize, log } from "./util.mjs";
 import { assertManifest } from "./manifest.mjs";
@@ -287,18 +288,79 @@ function packZip(pluginRoot) {
   log.warn("robot install checks free space via GET /plugin/capacity (507 if low).");
 }
 
+/**
+ * Ask which target arch(es) to build for.
+ * Non-TTY (CI): auto-selects current machine arch.
+ * @returns {Promise<string[]>} e.g. ['x86_64'] | ['aarch64'] | ['x86_64','aarch64']
+ */
+async function promptArch() {
+  if (!process.stdin.isTTY) {
+    const { arch } = await import("node:os");
+    const machine = arch() === "arm64" ? "aarch64" : "x86_64";
+    log.info(`arch auto-selected (non-TTY): ${machine}`);
+    return [machine];
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  process.stdout.write(
+    "\n  Target arch:\n" +
+    "    1) amd64 (x86_64)\n" +
+    "    2) arm64 (aarch64)\n" +
+    "    3) Both (fat ZIP)\n",
+  );
+  const answer = (await rl.question("  Select [1/2/3, default: 3]: ")).trim() || "3";
+  rl.close();
+  if (answer === "1") return ["x86_64"];
+  if (answer === "2") return ["aarch64"];
+  return ["x86_64", "aarch64"];
+}
+
+async function promptVersion(root) {
+  if (!process.stdin.isTTY) return;
+  const manifestPath = resolve(root, "manifest.json");
+  if (!existsSync(manifestPath)) return;
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  const current = manifest.version ?? "1.0.0";
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const input = (await rl.question(`  Version (current: ${current}, leave blank to keep): `)).trim();
+  rl.close();
+
+  if (!input) return;
+  manifest.version = input;
+  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+  log.ok(`manifest.json version → ${input}`);
+}
+
 export async function runBuild(args) {
   const noZip = args.includes("--no-zip");
+  const noLock = args.includes("--no-lock");
   const root = findPluginRoot();
-  // cpp / ros2 compile inside Docker — require it up front (python/none don't).
   const rt = manifestRuntime(root);
-  if (rt === "cpp" || rt === "ros2") ensureDocker();
-  if (!args.includes("--no-pin")) {
-    const stableOnly = isMainBranch();
-    log.step(`pinning requirements.txt to latest ${stableOnly ? "stable " : ""}PyPI versions`);
-    await pinRequirements(root, { stableOnly });
-  }
+
+  // All runtimes except "none" need Docker
+  if (rt !== "none") ensureDocker();
+
+  await promptVersion(root);
+  const archs = await promptArch();
+
   const { pluginRoot, distDir } = await buildPlugin({ root, minify: true });
+
+  // python / rclpy: lock + wheel vendor in Ubuntu 24.04 container
+  if (!noLock) {
+    const manifest = JSON.parse(readFileSync(resolve(root, "manifest.json"), "utf8")).runtime ?? {};
+    const needsLock =
+      manifest.type === "python" ||
+      (manifest.type === "ros2" && manifest.rosClient === "rclpy");
+    if (needsLock) {
+      const { lockAndVendor } = await import("./python.mjs");
+      try {
+        lockAndVendor(pluginRoot);
+      } catch (e) {
+        log.warn(`python lock/vendor skipped: ${e.message}`);
+      }
+    }
+  }
+
   await exportRos2Build(root);
   await exportCppBuild(root, distDir);
   if (!noZip) packZip(pluginRoot);

package/cli/src/cpp.mjs

@@ -4,7 +4,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { hasBin, kitRoot, log } from "./util.mjs";
+import { hasBin, kitRoot, log, pruneMuskatImages } from "./util.mjs";
 
 export const CPP_DEV_IMAGE = "muscat-pk-cpp-dev";
 
@@ -29,6 +29,7 @@ export function ensureImage(image = CPP_DEV_IMAGE) {
     { stdio: "inherit" },
   );
   if (r.status !== 0) throw new Error("docker build failed.");
+  pruneMuskatImages();
 }
 
 /**

package/cli/src/python.mjs

@@ -1,9 +1,9 @@
 // Shared Python Docker helpers (Ubuntu 24.04 + Python 3.12 — matches the robot).
-// Used by dev:back so the dev backend runs in the same environment as the robot.
+// Used by dev:back (hot-reload) and build (lock + wheel vendor).
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { hasBin, kitRoot, log } from "./util.mjs";
+import { hasBin, kitRoot, log, pruneMuskatImages } from "./util.mjs";
 
 export const PYTHON_DEV_IMAGE = "muscat-pk-python-dev";
 
@@ -28,4 +28,54 @@ export function ensureImage(image = PYTHON_DEV_IMAGE) {
     { stdio: "inherit" },
   );
   if (r.status !== 0) throw new Error("docker build failed.");
+  pruneMuskatImages();
+}
+
+/**
+ * Ubuntu 24.04 + py3.12 컨테이너 안에서:
+ *   1. uv pip compile requirements.txt → dist/requirements.lock  (전이 포함 완전 lock)
+ *   2. pip download -r dist/requirements.lock → dist/wheels/     (타겟 플랫폼 휠 벤더링)
+ *
+ * 컨테이너 arch = 빌드 머신 arch = 로봇 arch 가 동일해야 네이티브 휠이 일치한다.
+ * 순수 Python 패키지(py3-none-any)는 arch 무관.
+ * requirements.txt 없으면 조용히 건너뜀.
+ */
+export function lockAndVendor(pluginRoot) {
+  const reqTxt = resolve(pluginRoot, "requirements.txt");
+  if (!existsSync(reqTxt)) {
+    log.warn("requirements.txt not found — lock/vendor skipped");
+    return;
+  }
+
+  ensureImage();
+
+  log.step("generating lock (uv pip compile)…");
+  const lockResult = spawnSync(
+    "docker",
+    [
+      "run", "--rm",
+      "-v", `${pluginRoot}:/plugin`,
+      PYTHON_DEV_IMAGE,
+      "bash", "-c",
+      "set -e && cd /plugin && mkdir -p dist && uv pip compile requirements.txt --python-version 3.12 -o dist/requirements.lock",
+    ],
+    { stdio: "inherit" },
+  );
+  if (lockResult.status !== 0) throw new Error("lock generation failed (uv pip compile)");
+  log.ok("dist/requirements.lock ready");
+
+  log.step("vendoring wheels (pip download)…");
+  const vendorResult = spawnSync(
+    "docker",
+    [
+      "run", "--rm",
+      "-v", `${pluginRoot}:/plugin`,
+      PYTHON_DEV_IMAGE,
+      "bash", "-c",
+      "set -e && cd /plugin && mkdir -p dist/wheels && pip3 download -r dist/requirements.lock --only-binary=:all: -d dist/wheels",
+    ],
+    { stdio: "inherit" },
+  );
+  if (vendorResult.status !== 0) throw new Error("wheel vendoring failed (pip download)");
+  log.ok("dist/wheels/ ready");
 }

package/cli/src/ros2.mjs

@@ -3,7 +3,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { hasBin, kitRoot, log } from "./util.mjs";
+import { hasBin, kitRoot, log, pruneMuskatImages } from "./util.mjs";
 
 export const ROS2_DEV_IMAGE = "muscat-pk-ros2-dev";
 
@@ -39,6 +39,7 @@ export function ensureImage(image = ROS2_DEV_IMAGE) {
     { stdio: "inherit" },
   );
   if (r.status !== 0) throw new Error("docker build failed.");
+  pruneMuskatImages();
 }
 
 /**

package/cli/src/util.mjs

@@ -101,6 +101,18 @@ export function ensureDocker() {
   throw new Error("Docker is required for dev / dev:back / build.");
 }
 
+/**
+ * Remove dangling (untagged) muscat-pk images left behind after a rebuild.
+ * Uses label filter so only our images are touched — other Docker images are safe.
+ */
+export function pruneMuskatImages() {
+  spawnSync(
+    "docker",
+    ["image", "prune", "--force", "--filter", "label=com.rainbow-robotics.muscat-pk=true"],
+    { stdio: "ignore" },
+  );
+}
+
 export function humanSize(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;

package/package.json

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