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

package/cli/bin/muscat-pk.mjs

@@ -5,13 +5,13 @@ 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 { color, compareKitVersions, 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 { runUpdate, runUpdateCheck } from "../src/update.mjs";
 import { runUninstall } from "../src/uninstall.mjs";
 import { runSdk } from "../src/sdk.mjs";
 import { runType } from "../src/type.mjs";
@@ -50,6 +50,13 @@ if (isBinaryMode && !process.env.MUSCAT_PK_VERSION) {
     // 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);
+    // An older local copy can't update a project correctly — it doesn't know what changed since
+    // it was published. Run this CLI's update instead, still touching this project only.
+    if (process.argv[2] === "update" && localVersion && compareKitVersions(localVersion, kitVersion()) < 0) {
+      console.error(color.dim(`[muscat-pk] project's local install (v${localVersion}) is older — updating it with this CLI (v${kitVersion()})`));
+      process.env.MUSCAT_PK_UPDATE_PROJECT_ONLY = "1";
+      return;
+    }
     console.error(
       color.dim(`[muscat-pk] using this project's local install${localVersion ? ` (v${localVersion})` : ""}: ${localBin}`),
     );
@@ -121,6 +128,8 @@ async function main() {
       }
       case "update":
         return await runUpdate(args);
+      case "update:check": // internal: update runs it with the freshly installed local kit
+        return await runUpdateCheck(args);
       case "uninstall":
         return await runUninstall(args);
       case "sdk":

package/cli/src/update.mjs

@@ -13,7 +13,10 @@
 import { execSync, spawn, spawnSync } from "node:child_process";
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join, relative, resolve } from "node:path";
-import { findPluginRoot, isLocalKitInstall, KIT_PUBLISHED_NAME, kitVersion, log, parseArgs, prompt } from "./util.mjs";
+import {
+  compareKitVersions, findPluginRoot, isLocalKitInstall, KIT_PUBLISHED_NAME, kitVersion, log, parseArgs, prompt,
+  resolveLocalCliBin,
+} from "./util.mjs";
 
 const PLUGIN_UI_PACKAGE = "@rainbow-robotics/plugin-ui";
 const PREVIEW_HOST_PACKAGE = "@rainbow-robotics/preview-host";
@@ -301,15 +304,53 @@ export function findLegacyUiUsage(root) {
   return found;
 }
 
-function reportLegacyUi(root) {
+// The known-API list above only knows past changes. Type-checking against the plugin-ui that was
+// just installed catches whatever a later release removes or reshapes, with no list to keep up.
+function typeScriptErrors(root) {
+  const tsc = resolve(root, "node_modules/typescript/bin/tsc");
+  if (!existsSync(tsc) || !existsSync(resolve(root, "tsconfig.json"))) return [];
+  const runtime = isBinaryMode ? "node" : process.execPath;
+  const r = spawnSync(runtime, [tsc, "--noEmit", "-p", root, "--pretty", "false"], { cwd: root, encoding: "utf8" });
+  return `${r.stdout ?? ""}`
+    .split("\n")
+    .map((l) => /^(.+?)\((\d+),\d+\): error (TS\d+): (.*)$/.exec(l))
+    .filter(Boolean)
+    .map(([, file, line, code, text]) => ({ file: relative(root, resolve(root, file)), line: Number(line), text: `${code} ${text}` }));
+}
+
+function reportProject(root) {
   const found = findLegacyUiUsage(root);
-  if (!found.length) return;
-  log.warn("This project still uses the old plugin-ui API (removed in plugin-ui 1.x). Fix these before `muscat-pk dev` / `build`:");
+  const tsErrors = typeScriptErrors(root);
+  if (!found.length && !tsErrors.length) return;
+  log.warn("This project needs changes for the updated plugin-ui. Fix these before `muscat-pk dev` / `build`:");
   for (const f of found) log.info(`  ${f.file}:${f.line}  ${f.text}`);
-  log.info("  Props changed too (e.g. RBSlider onValueChange(values[]), RBSwitch onCheckedChange(bool) instead of event.detail).");
+  if (tsErrors.length) {
+    log.info("  TypeScript (tsc --noEmit):");
+    for (const e of tsErrors) log.info(`  ${e.file}:${e.line}  ${e.text}`);
+  }
   log.info("  For working examples, generate a fresh project and read its ui/content.tsx:  muscat-pk new <dir>");
 }
 
+/** `muscat-pk update:check` — the post-update project check, run by the freshly installed kit. */
+export async function runUpdateCheck() {
+  reportProject(findPluginRoot());
+}
+
+// Prefer the kit update just installed: it knows the plugin-ui it shipped with, this process may not.
+function checkProjectAfterUpdate(root) {
+  const localBin = resolveLocalCliBin(root);
+  let localVersion = "";
+  try {
+    localVersion = JSON.parse(readFileSync(resolve(localBin, "../../../package.json"), "utf8")).version;
+  } catch { /* no local kit */ }
+  if (localBin && localVersion && compareKitVersions(localVersion, kitVersion()) >= 0) {
+    const runtime = isBinaryMode ? "node" : process.execPath;
+    const r = spawnSync(runtime, [localBin, "update:check"], { cwd: root, stdio: "inherit" });
+    if (!r.error && r.status === 0) return;
+  }
+  reportProject(root);
+}
+
 // ── main ─────────────────────────────────────────────────────────────────────
 
 async function resolveTag(explicitTag) {
@@ -336,7 +377,7 @@ export async function runUpdate(args = []) {
 
   // 지금 도는 게 프로젝트의 로컬 설치면 그 프로젝트만 건드린다. 이 머신의 다른
   // 프로젝트들이 쓰는 글로벌 CLI까지 같이 올리려면 --global을 명시해야 한다.
-  const runningLocal = isLocalKitInstall();
+  const runningLocal = isLocalKitInstall() || process.env.MUSCAT_PK_UPDATE_PROJECT_ONLY === "1";
 
   // 1. Update the CLI itself
   if (!runningLocal || opts.global) {
@@ -394,8 +435,8 @@ export async function runUpdate(args = []) {
   updateLocalDeps(root, tag);
 
   try {
-    reportLegacyUi(root);
+    checkProjectAfterUpdate(root);
   } catch (err) {
-    log.warn(`Legacy UI check failed: ${err.message}`);
+    log.warn(`Project check failed: ${err.message}`);
   }
 }

package/cli/src/util.mjs

@@ -403,6 +403,18 @@ export function isNewer(a, b) {
   return a3 > b3;
 }
 
+/** Compare "x.y.z[-dev.N]" including the dev number (a release sorts after its dev builds). <0, 0, >0. */
+export function compareKitVersions(a, b) {
+  const parse = (v) => {
+    const [rel, pre] = String(v).split("-");
+    const nums = rel.split(".").map((n) => parseInt(n, 10) || 0);
+    return [...nums, pre === undefined ? Infinity : parseInt(pre.split(".").pop(), 10) || 0];
+  };
+  const pa = parse(a), pb = parse(b);
+  for (let i = 0; i < 4; i++) if (pa[i] !== pb[i]) return pa[i] > pb[i] ? 1 : -1;
+  return 0;
+}
+
 /**
  * Non-blocking check for a newer published kit. Prints an update suggestion if
  * one exists. Fails silently when offline. Honors `RB_REGISTRY` and is skipped

package/cli/storybook-dist/project.json

@@ -1 +1 @@
-{"generatedAt":1792689204059,"userSince":1750997484097,"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":1792689973585,"userSince":1750997484097,"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": "1.10.2-dev.1",
+  "version": "1.10.2-dev.2",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -52,8 +52,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@rainbow-robotics/plugin-ui": "1.10.2-dev.1",
-    "@rainbow-robotics/preview-host": "1.10.2-dev.1",
+    "@rainbow-robotics/plugin-ui": "1.10.2-dev.2",
+    "@rainbow-robotics/preview-host": "1.10.2-dev.2",
     "@types/react": "^19.0.10",
     "postcss": "^8.5.8",
     "typescript": "^5.8.0",