@rainbow-robotics/muscat-plugin-kit 0.1.2-dev.49 → 0.1.2-dev.50

package/cli/src/bridge.mjs

@@ -75,7 +75,7 @@ export async function startBridge() {
   log.step("starting Socket.IO bridge container…");
   const up = spawnSync(
     "docker",
-    ["run", "-d", "--name", BRIDGE_CONTAINER, "-p", `${BRIDGE_PORT}:${BRIDGE_PORT}`, BRIDGE_IMAGE],
+    ["run", "-d", "--name", BRIDGE_CONTAINER, "-p", `127.0.0.1:${BRIDGE_PORT}:${BRIDGE_PORT}`, BRIDGE_IMAGE],
     { stdio: "inherit" },
   );
   if (up.status !== 0) throw new Error("failed to start bridge container.");

package/cli/src/dev.mjs

@@ -1,6 +1,6 @@
 // muscat-pk dev — run the Socket.IO bridge (Docker), dev:ui, and dev:back together.
 import { runDevUi } from "./devUi.mjs";
-import { runDevBack } from "./devBack.mjs";
+import { runDevBack, stopDevBackContainers } from "./devBack.mjs";
 import { startBridge, stopBridge, BRIDGE_CONTAINER, BRIDGE_PORT } from "./bridge.mjs";
 import { assertManifestPorts } from "./manifest.mjs";
 import { formatPortRanges } from "./ports.mjs";
@@ -31,7 +31,12 @@ export async function runDev(args = []) {
     process.env.MUSCAT_PK_BRIDGE_CONTAINER = BRIDGE_CONTAINER;
   }
 
-  const cleanup = () => { if (bridgeStarted) stopBridge(); };
+  process.env.MUSCAT_PK_MANAGED_DEV = "1";
+
+  const cleanup = () => {
+    stopDevBackContainers();
+    if (bridgeStarted) stopBridge();
+  };
   process.once("SIGINT", cleanup);
   process.once("SIGTERM", cleanup);
   process.once("exit", cleanup);

package/cli/src/devBack.mjs

@@ -34,6 +34,22 @@ import {
   ensureImage as cppEnsureImage,
 } from "./cpp.mjs";
 
+const MANAGED_DEV_ENV = "MUSCAT_PK_MANAGED_DEV";
+
+function exitAfterCleanup(code = 0) {
+  if (process.env[MANAGED_DEV_ENV] !== "1") process.exit(code ?? 0);
+}
+
+export function stopDevBackContainers() {
+  for (const container of [
+    `${PYTHON_DEV_IMAGE}-run`,
+    `${ROS2_DEV_IMAGE}-run`,
+    `${CPP_DEV_IMAGE}-run`,
+  ]) {
+    spawnSync("docker", ["rm", "-f", container], { stdio: "ignore" });
+  }
+}
+
 // ── IDE tooling venv (best-effort, non-blocking) ────────────────────────────
 // `muscat-pk new` already creates this up front (see new.mjs); this just
 // refreshes it on every `dev`/`dev:back` in case requirements.txt changed.
@@ -72,6 +88,9 @@ async function runPython(root, portRanges) {
   // bridge (set by `muscat-pk dev`). Standalone dev:back has no bridge to join.
   const bridgeContainer = process.env.MUSCAT_PK_BRIDGE_CONTAINER;
   const netFlags = bridgeContainer ? ["--network", `container:${bridgeContainer}`] : [];
+  const hostGatewayFlags = bridgeContainer
+    ? []
+    : ["--add-host", "host.docker.internal:host-gateway"];
   // Without the bridge's netns, this container is isolated — its own
   // 127.0.0.1 (rainbow.rb_sdk's gateway default) is itself, not the host, so
   // it can never see a gateway already running on the host (e.g. the user's
@@ -101,7 +120,7 @@ async function runPython(root, portRanges) {
     ["run", "-d", "--name", container, ...netFlags,
       // host.docker.internal is automatic on Docker Desktop (macOS/Windows);
       // this makes it resolve on Linux too, for the no-bridge gateway fallback above.
-      "--add-host", "host.docker.internal:host-gateway",
+      ...hostGatewayFlags,
       "-e", "PIP_ROOT_USER_ACTION=ignore",
       "-v", `${root}:/plugin`, "-w", "/plugin", PYTHON_DEV_IMAGE, "sleep", "infinity"],
     { stdio: "inherit" },
@@ -130,16 +149,21 @@ async function runPython(root, portRanges) {
     }
   });
 
-  const cleanup = () => {
+  let cleaned = false;
+  const cleanupResources = () => {
+    if (cleaned) return;
+    cleaned = true;
     stopPortMonitor();
-    if (!child.killed) child.kill();
+    if (!child.killed && child.exitCode === null) child.kill();
     spawnSync("docker", ["rm", "-f", container], { stdio: "ignore" });
-    process.exit(0);
+  };
+  const cleanup = () => {
+    cleanupResources();
+    exitAfterCleanup(0);
   };
   child.on("exit", (code) => {
-    stopPortMonitor();
-    spawnSync("docker", ["rm", "-f", container], { stdio: "ignore" });
-    process.exit(code ?? 0);
+    cleanupResources();
+    exitAfterCleanup(code ?? 0);
   });
   process.once("SIGINT", cleanup);
   process.once("SIGTERM", cleanup);
@@ -228,7 +252,7 @@ async function runRos2(root, portRanges) {
     stopPortMonitor();
     if (child) child.kill();
     spawnSync("docker", ["rm", "-f", container], { stdio: "ignore" });
-    process.exit(0);
+    exitAfterCleanup(0);
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
@@ -304,7 +328,7 @@ async function runCpp(root, portRanges) {
     stopPortMonitor();
     if (child) child.kill();
     spawnSync("docker", ["rm", "-f", container], { stdio: "ignore" });
-    process.exit(0);
+    exitAfterCleanup(0);
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);

package/cli/src/devUi.mjs

@@ -211,13 +211,19 @@ export async function runDevUi(args = []) {
     { stdio: "inherit" },
   );
 
+  let cleaned = false;
   const cleanup = () => {
-    if (viteProc && !viteProc.killed) viteProc.kill();
-    if (!child.killed) child.kill();
+    if (cleaned) return;
+    cleaned = true;
+    if (viteProc && !viteProc.killed && viteProc.exitCode === null) viteProc.kill();
+    if (!child.killed && child.exitCode === null) child.kill();
   };
   process.once("SIGINT", cleanup);
   process.once("SIGTERM", cleanup);
-  child.on("exit", (code) => process.exit(code ?? 0));
+  child.on("exit", (code) => {
+    cleanup();
+    process.exit(code ?? 0);
+  });
 }
 
 export { findPluginRoot, findPreviewHostRoot };

package/cli/src/new.mjs

@@ -148,7 +148,7 @@ export async function runNew(args) {
 
   let type = opts.type;
   if (!type && !opts.yes) {
-    console.log("\n플러그인 타입을 선택하세요:");
+    console.log("\nSelect the plugin type:");
     console.log("  1) Python");
     console.log("  2) C++");
     console.log("  3) ROS2 (rclpy / Python)");

package/cli/storybook-dist/project.json

@@ -1 +1 @@
-{"generatedAt":1783637905594,"userSince":1750932757926,"hasCustomBabel":false,"hasCustomWebpack":false,"hasStaticDirs":false,"hasStorybookEslint":true,"refCount":0,"testPackages":{"@vitest/browser":"3.2.4","@vitest/coverage-v8":"3.2.4","playwright":"1.59.1","vitest":"3.2.4"},"hasRouterPackage":false,"monorepo":"Turborepo","packageManager":{"type":"yarn","version":"berry","agent":"yarn@berry"},"preview":{"usesGlobals":false},"framework":{"name":"@storybook/react-vite","options":{}},"builder":"@storybook/builder-vite","renderer":"@storybook/react","portableStoriesFileCount":0,"applicationFileCount":0,"storybookVersion":"8.6.18","storybookVersionSpecifier":"^8.6.4","language":"typescript","storybookPackages":{"@chromatic-com/storybook":{"version":"3.2.7"},"@storybook/addon-essentials":{"version":"8.6.18"},"@storybook/addon-links":{"version":"8.6.18"},"@storybook/addon-onboarding":{"version":"8.6.18"},"@storybook/addon-themes":{"version":"8.6.18"},"@storybook/blocks":{"version":"8.6.18"},"@storybook/experimental-addon-test":{"version":"8.6.18"},"@storybook/react":{"version":"8.6.18"},"@storybook/react-vite":{"version":"8.6.18"},"@storybook/test":{"version":"8.6.18"},"@storybook/theming":{"version":"8.6.18"},"eslint-plugin-storybook":{"version":"0.11.6"},"storybook":{"version":"8.6.18"},"storybook-addon-react-docgen":{"version":"1.2.44"}},"addons":{"$SNIP/node_modules/@storybook/addon-links":{"version":null},"$SNIP/node_modules/@storybook/addon-essentials":{"version":null},"$SNIP/node_modules/@chromatic-com/storybook":{"version":null},"$SNIP/node_modules/@storybook/addon-themes":{"version":null},"$SNIP/node_modules/@storybook/experimental-addon-test":{"version":null}}}
+{"generatedAt":1783639482772,"userSince":1750932757926,"hasCustomBabel":false,"hasCustomWebpack":false,"hasStaticDirs":false,"hasStorybookEslint":true,"refCount":0,"testPackages":{"@vitest/browser":"3.2.4","@vitest/coverage-v8":"3.2.4","playwright":"1.59.1","vitest":"3.2.4"},"hasRouterPackage":false,"monorepo":"Turborepo","packageManager":{"type":"yarn","version":"berry","agent":"yarn@berry"},"preview":{"usesGlobals":false},"framework":{"name":"@storybook/react-vite","options":{}},"builder":"@storybook/builder-vite","renderer":"@storybook/react","portableStoriesFileCount":0,"applicationFileCount":0,"storybookVersion":"8.6.18","storybookVersionSpecifier":"^8.6.4","language":"typescript","storybookPackages":{"@chromatic-com/storybook":{"version":"3.2.7"},"@storybook/addon-essentials":{"version":"8.6.18"},"@storybook/addon-links":{"version":"8.6.18"},"@storybook/addon-onboarding":{"version":"8.6.18"},"@storybook/addon-themes":{"version":"8.6.18"},"@storybook/blocks":{"version":"8.6.18"},"@storybook/experimental-addon-test":{"version":"8.6.18"},"@storybook/react":{"version":"8.6.18"},"@storybook/react-vite":{"version":"8.6.18"},"@storybook/test":{"version":"8.6.18"},"@storybook/theming":{"version":"8.6.18"},"eslint-plugin-storybook":{"version":"0.11.6"},"storybook":{"version":"8.6.18"},"storybook-addon-react-docgen":{"version":"1.2.44"}},"addons":{"$SNIP/node_modules/@storybook/addon-links":{"version":null},"$SNIP/node_modules/@storybook/addon-essentials":{"version":null},"$SNIP/node_modules/@chromatic-com/storybook":{"version":null},"$SNIP/node_modules/@storybook/addon-themes":{"version":null},"$SNIP/node_modules/@storybook/experimental-addon-test":{"version":null}}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/muscat-plugin-kit",
-  "version": "0.1.2-dev.49",
+  "version": "0.1.2-dev.50",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -53,8 +53,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@rainbow-robotics/plugin-ui": "0.1.2-dev.49",
-    "@rainbow-robotics/preview-host": "0.1.2-dev.49",
+    "@rainbow-robotics/plugin-ui": "0.1.2-dev.50",
+    "@rainbow-robotics/preview-host": "0.1.2-dev.50",
     "postcss": "^8.5.8",
     "socket.io": "^4.8.1",
     "typescript": "^5.8.0",