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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/muscat-plugin-kit",
-  "version": "0.1.2-dev.38",
+  "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.38",
+    "@rainbow-robotics/preview-host": "0.1.2-dev.39",
     "socket.io": "^4.8.1"
   },
   "optionalDependencies": {