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

package/cli/src/check-package.mjs

@@ -1,13 +1,13 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
-for (const dir of ["cli", "preview-host"]) {
-  if (!existsSync(resolve(root, dir))) continue;
-  execSync(
-    `find ${dir} -name '*.mjs' ! -path '*/dist/*' ! -path '*/runtime/*' ! -path '*/templates/*' -exec node --check {} +`,
-    { cwd: root, stdio: "inherit" },
-  );
-}
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+for (const dir of ["cli", "preview-host"]) {
+  if (!existsSync(resolve(root, dir))) continue;
+  execSync(
+    `find ${dir} -name '*.mjs' ! -path '*/dist/*' ! -path '*/runtime/*' ! -path '*/templates/*' -exec node --check {} +`,
+    { cwd: root, stdio: "inherit" },
+  );
+}

package/cli/src/completion.mjs

@@ -1,166 +1,166 @@
-// muscat-pk completion — print a shell completion script for bash / zsh / fish.
-//
-//   muscat-pk completion zsh >> ~/.zshrc      (or source it from there)
-//   muscat-pk completion bash >> ~/.bashrc
-//   muscat-pk completion fish > ~/.config/fish/completions/muscat-pk.fish
-//   muscat-pk completion powershell >> $PROFILE
-//
-// Keep COMMANDS in sync with the switch in bin/muscat-pk.mjs.
-import { log } from "./util.mjs";
-
-const COMMANDS = [
-  ["new", "Scaffold a new plugin project"],
-  ["type", "Switch backend type"],
-  ["build", "Build + zip the plugin"],
-  ["dev", "Bridge + dev:ui + dev:back"],
-  ["dev:ui", "Preview the plugin in a mini-Muscat"],
-  ["dev:back", "Run the plugin back end"],
-  ["storybook", "Browse the bundled rb-components Storybook"],
-  ["mcp", "Start an MCP server (stdio)"],
-  ["update", "Update muscat-pk and plugin-ui"],
-  ["uninstall", "Remove the installed muscat-pk CLI"],
-  ["sdk", "Manage the rainbow-rb-sdk version (python: requirements.txt, C++: CMakeLists.txt)"],
-  ["version", "Print the installed muscat-pk version"],
-  ["completion", "Print a shell completion script"],
-  ["help", "Show help"],
-];
-
-const SUBCOMMANDS = {
-  type: ["change"],
-  sdk: ["list", "update"],
-  completion: ["bash", "zsh", "fish", "powershell"],
-};
-
-const names = COMMANDS.map(([name]) => name);
-
-function bashScript() {
-  const subCases = Object.entries(SUBCOMMANDS)
-    .map(([cmd, subs]) => `    ${cmd}) COMPREPLY=( $(compgen -W "${subs.join(" ")}" -- "$cur") ); return ;;`)
-    .join("\n");
-
-  return `_muscat_pk() {
-  local cur prev
-  cur="\${COMP_WORDS[COMP_CWORD]}"
-  prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  case "$prev" in
-${subCases}
-  esac
-  if [ "$COMP_CWORD" -eq 1 ]; then
-    COMPREPLY=( $(compgen -W "${names.join(" ")}" -- "$cur") )
-    # bash treats ":" as a word break, so "dev:ui" would come back duplicated
-    if type __ltrim_colon_completions >/dev/null 2>&1; then
-      __ltrim_colon_completions "$cur"
-    fi
-  fi
-}
-complete -F _muscat_pk muscat-pk`;
-}
-
-function zshScript() {
-  // _describe splits on ":", so a command name containing one (dev:ui) must escape it
-  const cmds = COMMANDS.map(
-    ([name, desc]) => `    '${name.replace(/:/g, "\\:")}:${desc}'`,
-  ).join("\n");
-  const subCases = Object.entries(SUBCOMMANDS)
-    .map(([cmd, subs]) => `      ${cmd}) _values 'subcommand' ${subs.join(" ")} ;;`)
-    .join("\n");
-
-  // Sourced from ~/.zshrc, compdef only exists once compinit has run — a bare
-  // zsh (no oh-my-zsh, no compinit) would error on every shell start otherwise.
-  return `#compdef muscat-pk
-if ! whence compdef > /dev/null; then
-  autoload -Uz compinit && compinit
-fi
-_muscat_pk() {
-  local -a cmds
-  cmds=(
-${cmds}
-  )
-  if (( CURRENT == 2 )); then
-    _describe 'command' cmds
-  else
-    case \${words[2]} in
-${subCases}
-    esac
-  fi
-}
-if whence compdef > /dev/null; then
-  compdef _muscat_pk muscat-pk
-fi`;
-}
-
-function fishScript() {
-  const top = COMMANDS.map(
-    ([name, desc]) =>
-      `complete -c muscat-pk -f -n __fish_use_subcommand -a ${name} -d ${JSON.stringify(desc)}`,
-  );
-  const subs = Object.entries(SUBCOMMANDS).flatMap(([cmd, list]) =>
-    list.map(
-      (sub) =>
-        `complete -c muscat-pk -f -n "__fish_seen_subcommand_from ${cmd}" -a ${sub}`,
-    ),
-  );
-  return [...top, ...subs].join("\n");
-}
-
-function powershellScript() {
-  const subMap = Object.entries(SUBCOMMANDS)
-    .map(([cmd, subs]) => `    '${cmd}' = @(${subs.map((s) => `'${s}'`).join(", ")})`)
-    .join("\n");
-
-  return `Register-ArgumentCompleter -Native -CommandName muscat-pk -ScriptBlock {
-  param($wordToComplete, $commandAst, $cursorPosition)
-  $commands = @(${names.map((n) => `'${n}'`).join(", ")})
-  $subcommands = @{
-${subMap}
-  }
-  $elements = @($commandAst.CommandElements | ForEach-Object { $_.ToString() })
-  # element 0 is "muscat-pk"; a trailing partial word is also in the list
-  $typedCommand = if ($elements.Count -gt 1) { $elements[1] } else { '' }
-  $candidates =
-    if ($elements.Count -gt 2 -or ($elements.Count -eq 2 -and $wordToComplete -eq '')) {
-      if ($subcommands.ContainsKey($typedCommand)) { $subcommands[$typedCommand] } else { @() }
-    } else { $commands }
-  $candidates |
-    Where-Object { $_ -like "$wordToComplete*" } |
-    ForEach-Object {
-      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
-    }
-}`;
-}
-
-const GENERATORS = {
-  bash: bashScript,
-  zsh: zshScript,
-  fish: fishScript,
-  powershell: powershellScript,
-};
-
-const HINTS = {
-  bash: "muscat-pk completion bash >> ~/.bashrc  →  then: source ~/.bashrc",
-  zsh: "muscat-pk completion zsh >> ~/.zshrc  →  then: source ~/.zshrc",
-  fish: "muscat-pk completion fish > ~/.config/fish/completions/muscat-pk.fish",
-  powershell: "muscat-pk completion powershell >> $PROFILE  →  then: . $PROFILE",
-};
-
-/** Guess the user's shell from $SHELL; PowerShell on Windows, else bash. */
-function detectShell() {
-  const shell = (process.env.SHELL || "").split(/[/\\]/).pop();
-  if (shell in GENERATORS) return shell;
-  return process.platform === "win32" ? "powershell" : "bash";
-}
-
-export async function runCompletion(args = []) {
-  const shell = args[0] ?? detectShell();
-  const generate = GENERATORS[shell];
-
-  if (!generate) {
-    throw new Error(
-      `Unsupported shell "${shell}" (supported: ${Object.keys(GENERATORS).join(", ")})`,
-    );
-  }
-
-  // Only the script goes to stdout, so `>> ~/.zshrc` stays valid.
-  console.log(generate());
-  if (process.stdout.isTTY) log.info(`\nInstall: ${HINTS[shell]}`);
-}
+// muscat-pk completion — print a shell completion script for bash / zsh / fish.
+//
+//   muscat-pk completion zsh >> ~/.zshrc      (or source it from there)
+//   muscat-pk completion bash >> ~/.bashrc
+//   muscat-pk completion fish > ~/.config/fish/completions/muscat-pk.fish
+//   muscat-pk completion powershell >> $PROFILE
+//
+// Keep COMMANDS in sync with the switch in bin/muscat-pk.mjs.
+import { log } from "./util.mjs";
+
+const COMMANDS = [
+  ["new", "Scaffold a new plugin project"],
+  ["type", "Switch backend type"],
+  ["build", "Build + zip the plugin"],
+  ["dev", "Bridge + dev:ui + dev:back"],
+  ["dev:ui", "Preview the plugin in a mini-Muscat"],
+  ["dev:back", "Run the plugin back end"],
+  ["storybook", "Browse the bundled rb-components Storybook"],
+  ["mcp", "Start an MCP server (stdio)"],
+  ["update", "Update muscat-pk and plugin-ui"],
+  ["uninstall", "Remove the installed muscat-pk CLI"],
+  ["sdk", "Manage the rainbow-rb-sdk version (python: requirements.txt, C++: CMakeLists.txt)"],
+  ["version", "Print the installed muscat-pk version"],
+  ["completion", "Print a shell completion script"],
+  ["help", "Show help"],
+];
+
+const SUBCOMMANDS = {
+  type: ["change"],
+  sdk: ["list", "update"],
+  completion: ["bash", "zsh", "fish", "powershell"],
+};
+
+const names = COMMANDS.map(([name]) => name);
+
+function bashScript() {
+  const subCases = Object.entries(SUBCOMMANDS)
+    .map(([cmd, subs]) => `    ${cmd}) COMPREPLY=( $(compgen -W "${subs.join(" ")}" -- "$cur") ); return ;;`)
+    .join("\n");
+
+  return `_muscat_pk() {
+  local cur prev
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  case "$prev" in
+${subCases}
+  esac
+  if [ "$COMP_CWORD" -eq 1 ]; then
+    COMPREPLY=( $(compgen -W "${names.join(" ")}" -- "$cur") )
+    # bash treats ":" as a word break, so "dev:ui" would come back duplicated
+    if type __ltrim_colon_completions >/dev/null 2>&1; then
+      __ltrim_colon_completions "$cur"
+    fi
+  fi
+}
+complete -F _muscat_pk muscat-pk`;
+}
+
+function zshScript() {
+  // _describe splits on ":", so a command name containing one (dev:ui) must escape it
+  const cmds = COMMANDS.map(
+    ([name, desc]) => `    '${name.replace(/:/g, "\\:")}:${desc}'`,
+  ).join("\n");
+  const subCases = Object.entries(SUBCOMMANDS)
+    .map(([cmd, subs]) => `      ${cmd}) _values 'subcommand' ${subs.join(" ")} ;;`)
+    .join("\n");
+
+  // Sourced from ~/.zshrc, compdef only exists once compinit has run — a bare
+  // zsh (no oh-my-zsh, no compinit) would error on every shell start otherwise.
+  return `#compdef muscat-pk
+if ! whence compdef > /dev/null; then
+  autoload -Uz compinit && compinit
+fi
+_muscat_pk() {
+  local -a cmds
+  cmds=(
+${cmds}
+  )
+  if (( CURRENT == 2 )); then
+    _describe 'command' cmds
+  else
+    case \${words[2]} in
+${subCases}
+    esac
+  fi
+}
+if whence compdef > /dev/null; then
+  compdef _muscat_pk muscat-pk
+fi`;
+}
+
+function fishScript() {
+  const top = COMMANDS.map(
+    ([name, desc]) =>
+      `complete -c muscat-pk -f -n __fish_use_subcommand -a ${name} -d ${JSON.stringify(desc)}`,
+  );
+  const subs = Object.entries(SUBCOMMANDS).flatMap(([cmd, list]) =>
+    list.map(
+      (sub) =>
+        `complete -c muscat-pk -f -n "__fish_seen_subcommand_from ${cmd}" -a ${sub}`,
+    ),
+  );
+  return [...top, ...subs].join("\n");
+}
+
+function powershellScript() {
+  const subMap = Object.entries(SUBCOMMANDS)
+    .map(([cmd, subs]) => `    '${cmd}' = @(${subs.map((s) => `'${s}'`).join(", ")})`)
+    .join("\n");
+
+  return `Register-ArgumentCompleter -Native -CommandName muscat-pk -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+  $commands = @(${names.map((n) => `'${n}'`).join(", ")})
+  $subcommands = @{
+${subMap}
+  }
+  $elements = @($commandAst.CommandElements | ForEach-Object { $_.ToString() })
+  # element 0 is "muscat-pk"; a trailing partial word is also in the list
+  $typedCommand = if ($elements.Count -gt 1) { $elements[1] } else { '' }
+  $candidates =
+    if ($elements.Count -gt 2 -or ($elements.Count -eq 2 -and $wordToComplete -eq '')) {
+      if ($subcommands.ContainsKey($typedCommand)) { $subcommands[$typedCommand] } else { @() }
+    } else { $commands }
+  $candidates |
+    Where-Object { $_ -like "$wordToComplete*" } |
+    ForEach-Object {
+      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+    }
+}`;
+}
+
+const GENERATORS = {
+  bash: bashScript,
+  zsh: zshScript,
+  fish: fishScript,
+  powershell: powershellScript,
+};
+
+const HINTS = {
+  bash: "muscat-pk completion bash >> ~/.bashrc  →  then: source ~/.bashrc",
+  zsh: "muscat-pk completion zsh >> ~/.zshrc  →  then: source ~/.zshrc",
+  fish: "muscat-pk completion fish > ~/.config/fish/completions/muscat-pk.fish",
+  powershell: "muscat-pk completion powershell >> $PROFILE  →  then: . $PROFILE",
+};
+
+/** Guess the user's shell from $SHELL; PowerShell on Windows, else bash. */
+function detectShell() {
+  const shell = (process.env.SHELL || "").split(/[/\\]/).pop();
+  if (shell in GENERATORS) return shell;
+  return process.platform === "win32" ? "powershell" : "bash";
+}
+
+export async function runCompletion(args = []) {
+  const shell = args[0] ?? detectShell();
+  const generate = GENERATORS[shell];
+
+  if (!generate) {
+    throw new Error(
+      `Unsupported shell "${shell}" (supported: ${Object.keys(GENERATORS).join(", ")})`,
+    );
+  }
+
+  // Only the script goes to stdout, so `>> ~/.zshrc` stays valid.
+  console.log(generate());
+  if (process.stdout.isTTY) log.info(`\nInstall: ${HINTS[shell]}`);
+}

package/cli/src/cpp.mjs

@@ -1,78 +1,78 @@
-// Shared C++ Docker helpers (Ubuntu 24.04 + build-essential + cmake).
-// Matches the robot OS so the compiled binary is relocatable to the robot.
-// Used by dev:back (interactive dev loop) and build (export the binary into the ZIP).
-import { spawnSync } from "node:child_process";
-import { dirname } from "node:path";
-import { canSkipImageBuild, cppSdkVersion, pluginRootOrNull, imageKey, imageKeyLabel, dockerUserFlags, hasBin, log, pruneMuskatImages, resolveDockerfile, buildCacheFlags } from "./util.mjs";
-import { syncCppIde } from "./cppIde.mjs";
-
-export const CPP_DEV_IMAGE = "muscat-pk-cpp-dev";
-
-export function assertDockerReady() {
-  if (!hasBin("docker")) {
-    throw new Error("Docker not found. C++ builds need Docker (Ubuntu 24.04 + cmake container).");
-  }
-}
-
-/** Build the dev image from the kit's bundled Dockerfile (Docker layer-caches). */
-export async function ensureImage(image = CPP_DEV_IMAGE, { platform = null, root = pluginRootOrNull() } = {}) {
-  await buildImage(image, platform, root);
-  // Dev images feed the editor's SDK headers: the native one (dev) or the host-arch one (build).
-  const hostArch = process.arch === "arm64" ? "arm64" : "amd64";
-  if (root && (image === CPP_DEV_IMAGE || image === `${CPP_DEV_IMAGE}-${hostArch}`)) syncCppIde(root, image);
-}
-
-async function buildImage(image, platform, root) {
-  const dockerfile = await resolveDockerfile("Dockerfile.cpp");
-  const sdkVer = cppSdkVersion(root);
-  const key = imageKey(dockerfile, sdkVer ?? "");
-  if (canSkipImageBuild(image, key)) {
-    return;
-  }
-  log.step(`docker build -t ${image}${platform ? ` (${platform})` : ""} (first run is slow, then cached)…`);
-  const platformFlags = platform ? ["--platform", platform] : [];
-  const buildArgs = [...(sdkVer ? ["--build-arg", `RB_SDK_VERSION=${sdkVer}`] : []), ...imageKeyLabel(key)];
-  const r = spawnSync(
-    "docker",
-    ["build", ...buildCacheFlags(), ...platformFlags, ...buildArgs, "-t", image, "-f", dockerfile, dirname(dockerfile)],
-    { stdio: "inherit" },
-  );
-  if (r.status !== 0) throw new Error("docker build failed.");
-  pruneMuskatImages();
-}
-
-// Docker platform token for each target arch
-export const ARCH_DOCKER_PLATFORM = {
-  amd64: "linux/amd64",
-  arm64: "linux/arm64",
-};
-
-/**
- * Configure + build cpp/ inside the container, producing cpp/build-{arch}/<entry>
- * on the host (the workspace is mounted).
- * - arch null → native (dev mode, uses cpp/build/)
- * - arch "x86_64" / "aarch64" → cross via --platform (Release builds for ZIP)
- * buildType "Debug" for dev, "Release" for export builds that ship in the ZIP.
- */
-export function cmakeBuild(root, { image = CPP_DEV_IMAGE, buildType = "Debug", arch = null } = {}) {
-  const buildDir = arch ? `cpp/build-${arch}` : "cpp/build";
-  const dockerPlatform = arch ? ARCH_DOCKER_PLATFORM[arch] : null;
-  const platformFlags = dockerPlatform ? ["--platform", dockerPlatform] : [];
-  // arch 빌드 시 arch별 이미지 사용 (로컬 이미지와 platform 불일치 방지)
-  const actualImage = arch ? `${CPP_DEV_IMAGE}-${arch}` : image;
-  // Export builds ship lib/ next to the binary: librb_sdk.so (robot has no SDK) + any .so the
-  // plugin copied there itself. Found via RPATH $ORIGIN/lib.
-  const script = [
-    `cmake -S cpp -B ${buildDir} -DCMAKE_BUILD_TYPE=${buildType}` + (arch ? ` -DCMAKE_BUILD_RPATH='$ORIGIN/lib'` : ""),
-    `cmake --build ${buildDir} -j`,
-    ...(arch ? [`rm -f ${buildDir}/lib/librb_sdk.so.* && if readelf -d $(find ${buildDir} -maxdepth 1 -type f -executable) 2>/dev/null | grep -q librb_sdk; then mkdir -p ${buildDir}/lib && cp -a $(dpkg -L rainbow-rb-sdk | grep -E '/librb_sdk[.]so[.][0-9]') ${buildDir}/lib/; fi`] : []),
-  ].join(" && ");
-  const label = arch ? `cmake build (${buildType}, ${arch}, in container)…` : `cmake build (${buildType}, in container)…`;
-  log.step(label);
-  const r = spawnSync(
-    "docker",
-    ["run", "--rm", ...dockerUserFlags(), ...platformFlags, "-v", `${root}:/plugin`, "-w", "/plugin", actualImage, "bash", "-lc", script],
-    { cwd: root, stdio: "inherit" },
-  );
-  if (r.status !== 0) throw new Error(`cmake build failed${arch ? ` (${arch})` : ""}.`);
-}
+// Shared C++ Docker helpers (Ubuntu 24.04 + build-essential + cmake).
+// Matches the robot OS so the compiled binary is relocatable to the robot.
+// Used by dev:back (interactive dev loop) and build (export the binary into the ZIP).
+import { spawnSync } from "node:child_process";
+import { dirname } from "node:path";
+import { canSkipImageBuild, cppSdkVersion, pluginRootOrNull, imageKey, imageKeyLabel, dockerUserFlags, hasBin, log, pruneMuskatImages, resolveDockerfile, buildCacheFlags } from "./util.mjs";
+import { syncCppIde } from "./cppIde.mjs";
+
+export const CPP_DEV_IMAGE = "muscat-pk-cpp-dev";
+
+export function assertDockerReady() {
+  if (!hasBin("docker")) {
+    throw new Error("Docker not found. C++ builds need Docker (Ubuntu 24.04 + cmake container).");
+  }
+}
+
+/** Build the dev image from the kit's bundled Dockerfile (Docker layer-caches). */
+export async function ensureImage(image = CPP_DEV_IMAGE, { platform = null, root = pluginRootOrNull() } = {}) {
+  await buildImage(image, platform, root);
+  // Dev images feed the editor's SDK headers: the native one (dev) or the host-arch one (build).
+  const hostArch = process.arch === "arm64" ? "arm64" : "amd64";
+  if (root && (image === CPP_DEV_IMAGE || image === `${CPP_DEV_IMAGE}-${hostArch}`)) syncCppIde(root, image);
+}
+
+async function buildImage(image, platform, root) {
+  const dockerfile = await resolveDockerfile("Dockerfile.cpp");
+  const sdkVer = cppSdkVersion(root);
+  const key = imageKey(dockerfile, sdkVer ?? "");
+  if (canSkipImageBuild(image, key)) {
+    return;
+  }
+  log.step(`docker build -t ${image}${platform ? ` (${platform})` : ""} (first run is slow, then cached)…`);
+  const platformFlags = platform ? ["--platform", platform] : [];
+  const buildArgs = [...(sdkVer ? ["--build-arg", `RB_SDK_VERSION=${sdkVer}`] : []), ...imageKeyLabel(key)];
+  const r = spawnSync(
+    "docker",
+    ["build", ...buildCacheFlags(), ...platformFlags, ...buildArgs, "-t", image, "-f", dockerfile, dirname(dockerfile)],
+    { stdio: "inherit" },
+  );
+  if (r.status !== 0) throw new Error("docker build failed.");
+  pruneMuskatImages();
+}
+
+// Docker platform token for each target arch
+export const ARCH_DOCKER_PLATFORM = {
+  amd64: "linux/amd64",
+  arm64: "linux/arm64",
+};
+
+/**
+ * Configure + build cpp/ inside the container, producing cpp/build-{arch}/<entry>
+ * on the host (the workspace is mounted).
+ * - arch null → native (dev mode, uses cpp/build/)
+ * - arch "x86_64" / "aarch64" → cross via --platform (Release builds for ZIP)
+ * buildType "Debug" for dev, "Release" for export builds that ship in the ZIP.
+ */
+export function cmakeBuild(root, { image = CPP_DEV_IMAGE, buildType = "Debug", arch = null } = {}) {
+  const buildDir = arch ? `cpp/build-${arch}` : "cpp/build";
+  const dockerPlatform = arch ? ARCH_DOCKER_PLATFORM[arch] : null;
+  const platformFlags = dockerPlatform ? ["--platform", dockerPlatform] : [];
+  // arch 빌드 시 arch별 이미지 사용 (로컬 이미지와 platform 불일치 방지)
+  const actualImage = arch ? `${CPP_DEV_IMAGE}-${arch}` : image;
+  // Export builds ship lib/ next to the binary: librb_sdk.so (robot has no SDK) + any .so the
+  // plugin copied there itself. Found via RPATH $ORIGIN/lib.
+  const script = [
+    `cmake -S cpp -B ${buildDir} -DCMAKE_BUILD_TYPE=${buildType}` + (arch ? ` -DCMAKE_BUILD_RPATH='$ORIGIN/lib'` : ""),
+    `cmake --build ${buildDir} -j`,
+    ...(arch ? [`rm -f ${buildDir}/lib/librb_sdk.so.* && if readelf -d $(find ${buildDir} -maxdepth 1 -type f -executable) 2>/dev/null | grep -q librb_sdk; then mkdir -p ${buildDir}/lib && cp -a $(dpkg -L rainbow-rb-sdk | grep -E '/librb_sdk[.]so[.][0-9]') ${buildDir}/lib/; fi`] : []),
+  ].join(" && ");
+  const label = arch ? `cmake build (${buildType}, ${arch}, in container)…` : `cmake build (${buildType}, in container)…`;
+  log.step(label);
+  const r = spawnSync(
+    "docker",
+    ["run", "--rm", ...dockerUserFlags(), ...platformFlags, "-v", `${root}:/plugin`, "-w", "/plugin", actualImage, "bash", "-lc", script],
+    { cwd: root, stdio: "inherit" },
+  );
+  if (r.status !== 0) throw new Error(`cmake build failed${arch ? ` (${arch})` : ""}.`);
+}