@axis-ds/mcp 1.4.4 → 1.4.5

package/README.md

@@ -66,6 +66,7 @@ Claude Desktop 또는 기타 MCP 호환 클라이언트에서 설정:
 
 - `targetDir` 를 주지 않으면 서버의 현재 디렉터리를 봅니다.
 - `@axis-ds/tokens` 가 없거나 1.3.0 미만이거나 빌드 산출물이 없으면 오류(`isError`)가 아니라 설치 · 업그레이드 안내를 돌려줍니다. 빈 목록으로 답하지 않습니다.
+  - 1.4.5 부터 안내는 CLI `axis theme list` 와 같게 선언 출처를 따릅니다(앱 · pnpm · yarn 루트 선언은 `<pm> install`, npm 루트 선언은 「워크스페이스 루트에서 `npm install`」, Yarn PnP 앱 선언은 판정하지 못했다는 한 줄, 선언이 없으면 종전 추가 명령).
 - 프로젝트에 적용하는 일(import 추가 · `axis.config.json` 의 `brand`)은 CLI `axis theme add <brand>` 가 맡습니다.
 
 ## 문서

package/dist/index.js

@@ -970,14 +970,56 @@ function workspaceRootPackage(baseDirInput) {
     return void 0;
   }
 }
-function declaredDependency(baseDir, pkg, name, rootPkg) {
+function declaredDependency(baseDir, pkg, name, rootPkg, options = {}) {
   if (pkg === void 0) return void 0;
   const own = hasDependency(pkg, name);
   if (own !== void 0) return { range: own, source: "app" };
+  if (options.appOnlyInPnp && isPnpProject(baseDir)) return void 0;
   const root = rootPkg === void 0 ? workspaceRootPackage(baseDir) : rootPkg ?? void 0;
   const fromRoot = root !== void 0 ? hasDependency(root, name) : void 0;
   return fromRoot !== void 0 ? { range: fromRoot, source: "root" } : void 0;
 }
+function pnpRootOnlyDependency(baseDir, pkg, name, rootPkg) {
+  if (pkg === void 0 || hasDependency(pkg, name) !== void 0 || !isPnpProject(baseDir)) return void 0;
+  const found = declaredDependency(baseDir, pkg, name, rootPkg);
+  return found?.source === "root" ? found : void 0;
+}
+var PNP_ROOT_ONLY_NOTE = "\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uB9CC \uC120\uC5B8\uB3FC Plug'n'Play \uC5D0\uC11C \uC571\uC774 \uD574\uC11D\uD558\uC9C0 \uBABB\uD569\uB2C8\uB2E4";
+var APP_LOCKFILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lockb", "bun.lock"];
+function hasAppLockfile(baseDirInput) {
+  const baseDir = path3.resolve(baseDirInput);
+  return APP_LOCKFILES.some((f) => existsSync2(path3.join(baseDir, f)));
+}
+function rootDeclarationsAllowed(baseDir, pkg) {
+  return pkg !== void 0 && !isPnpProject(baseDir) && !hasAppLockfile(baseDir);
+}
+function readPackageJsonAt(dir) {
+  try {
+    const parsed = JSON.parse(readFileSync3(path3.join(dir, "package.json"), "utf8"));
+    return isPlainObject(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function dependencyInstallGuide(baseDirInput, name, range) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const installCommand = detectInstallCommand(baseDir);
+  const base = { installCommand, addCommand: addCommandFor(installCommand, { [name]: range }) };
+  const pkg = readPackageJsonAt(baseDir);
+  if (pkg === void 0) return { kind: "add", ...base };
+  const own = hasDependency(pkg, name);
+  if (isPnpProject(baseDir)) return own !== void 0 ? { kind: "pnp", source: "app", range: own, ...base } : { kind: "add", ...base };
+  if (own !== void 0) return { kind: "install", source: "app", range: own, ...base };
+  if (!rootDeclarationsAllowed(baseDir, pkg)) return { kind: "add", ...base };
+  const declared = declaredDependency(baseDir, pkg, name);
+  if (declared?.source !== "root") return { kind: "add", ...base };
+  return {
+    kind: packageManagerOf(installCommand) === "npm" ? "install-at-root" : "install",
+    source: "root",
+    range: declared.range,
+    ...base
+  };
+}
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1066,6 +1108,7 @@ function isPnpProject(baseDirInput) {
   let dir = resolveBaseDir(baseDirInput);
   for (; ; ) {
     if (isFile(path3.join(dir, ".pnp.cjs")) || isFile(path3.join(dir, ".pnp.js"))) return true;
+    if (existsSync2(path3.join(dir, ".git"))) return false;
     const parent = path3.dirname(dir);
     if (parent === dir) return false;
     dir = parent;
@@ -1089,6 +1132,9 @@ import { basename, dirname as dirname2, extname, isAbsolute, join as join2, rela
 function declaredRange(baseDir, pkg, name) {
   return declaredDependency(baseDir, pkg, name)?.range;
 }
+function declaredRangeForCheck(baseDir, pkg, name) {
+  return declaredDependency(baseDir, pkg, name, void 0, { appOnlyInPnp: true })?.range;
+}
 function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1463,7 +1509,7 @@ function hasBareCjsPresetRequire(code) {
 function isCommonJsConfig(file, source) {
   return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
 }
-function packageVersionGate(baseDirInput, pkg, name, min) {
+function packageVersionGate(baseDirInput, pkg, name, min, options = {}) {
   const baseDir = resolveBaseDir(baseDirInput);
   if (!isPnpProject(baseDir)) {
     const installed = findInstalledPackage(baseDir, name)?.version;
@@ -1472,7 +1518,11 @@ function packageVersionGate(baseDirInput, pkg, name, min) {
       if (cmp !== void 0) return { status: cmp >= 0 ? "ok" : "below", source: "installed", value: installed };
     }
   }
-  const declared = pkg ? declaredRange(baseDir, pkg, name) : void 0;
+  const declared = pkg ? declaredDependency(baseDir, pkg, name, void 0, options)?.range : void 0;
+  if (declared === void 0 && options.appOnlyInPnp) {
+    const rootOnly = pnpRootOnlyDependency(baseDir, pkg, name);
+    if (rootOnly !== void 0) return { status: "unresolved", source: "declared", value: rootOnly.range };
+  }
   if (declared !== void 0) {
     const atLeast = rangeLowerAtLeast(declared, min);
     if (atLeast !== void 0) return { status: atLeast ? "ok" : "below", source: "declared", value: declared };
@@ -1481,6 +1531,7 @@ function packageVersionGate(baseDirInput, pkg, name, min) {
   return { status: "unknown", source: "none" };
 }
 function versionGateLabel(gate) {
+  if (gate.status === "unresolved") return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 \uC120\uC5B8 ${gate.value}`;
   if (gate.source === "installed") return `\uC124\uCE58\uBCF8 ${gate.value}`;
   if (gate.source === "declared") return `\uC120\uC5B8 ${gate.value}`;
   return "\uC124\uCE58\uBCF8 \xB7 \uC120\uC5B8 \uC5C6\uC74C";
@@ -1562,7 +1613,14 @@ function checkTailwindSetup(baseDirInput) {
     if (hasTokensPresetReference(content)) {
       const code = stripJsComments(content);
       if (isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code)) {
-        const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION);
+        const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION, { appOnlyInPnp: true });
+        if (gate.status === "unresolved") {
+          return {
+            name: "tailwind.config",
+            severity: "warn",
+            message: `${file}\uC5D0 AXIS preset \uCC38\uC870\uAC00 \uC788\uC9C0\uB9CC @axis-ds/tokens \uAC00 ${PNP_ROOT_ONLY_NOTE}(${versionGateLabel(gate)}) \u2192 \uC571 package.json \uC5D0 @axis-ds/tokens ${TOKENS_CJS_PRESET_FIXED_VERSION} \uC774\uC0C1\uC744 \uC120\uC5B8\uD558\uC138\uC694`
+          };
+        }
         if (gate.status !== "ok") {
           const why = gate.status === "below" ? `@axis-ds/tokens ${versionGateLabel(gate)} \uC5D0\uC11C\uB294 CommonJS \uC758 require("${TOKENS_TAILWIND3_PRESET}") \uAC00 preset \uC774 \uC544\uB2C8\uB77C { default } \uB97C \uB3CC\uB824\uC918 \uC0C9 \xB7 keyframes \uAC00 \uC801\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` : `@axis-ds/tokens \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${versionGateLabel(gate)}). ${TOKENS_CJS_PRESET_FIXED_VERSION} \uBBF8\uB9CC\uC774\uBA74 CommonJS \uC758 require("${TOKENS_TAILWIND3_PRESET}") \uB85C\uB294 preset \uC774 \uC801\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`;
           return {
@@ -1908,30 +1966,56 @@ function checkAnimationPlugin(baseDirInput) {
   if (!declared && !copied) return null;
   const by = declared ? "@axis-ds/ui-react \uC120\uC5B8" : "componentsDir \uC758 animate-in \uB958 \uD074\uB798\uC2A4";
   const tailwind = detectTailwind(baseDir, pkg);
+  const pnp = isPnpProject(baseDir);
+  const pluginProblem = (name) => {
+    if (declaredRangeForCheck(baseDir, pkg, name) === void 0) {
+      return pnpRootOnlyDependency(baseDir, pkg, name) !== void 0 ? `${name} \uAC00 ${PNP_ROOT_ONLY_NOTE}` : `${name} \uC120\uC5B8 \uC5C6\uC74C`;
+    }
+    if (!pnp && findInstalledPackage(baseDir, name) === void 0) return `${name} \uBBF8\uC124\uCE58(\uC120\uC5B8\uB9CC \uC788\uC74C)`;
+    return void 0;
+  };
   if (tailwind.major !== void 0 && tailwind.major >= 4) {
     const file = TAILWIND_CSS_CANDIDATES.find((c) => existsSync3(join2(baseDir, c)));
     const css = file !== void 0 ? stripCssComments(readFileSync4(join2(baseDir, file), "utf8")) : "";
-    const ok = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${ANIMATION_PLUGIN_TAILWIND4}["']`).test(css) || new RegExp(`@plugin\\s+["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(css);
-    return ok ? { name: "animation", severity: "pass", message: `${file}\uC5D0 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC788\uC2B5\uB2C8\uB2E4` } : {
+    const lines = [];
+    if (new RegExp(`@import\\s+(?:url\\(\\s*)?["']${ANIMATION_PLUGIN_TAILWIND4}["']`).test(css)) lines.push(ANIMATION_PLUGIN_TAILWIND4);
+    if (new RegExp(`@plugin\\s+["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(css)) lines.push(ANIMATION_PLUGIN_TAILWIND3);
+    if (lines.length === 0) {
+      return {
+        name: "animation",
+        severity: "warn",
+        message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${ANIMATION_PLUGIN_TAILWIND4} \uC124\uCE58 \uB4A4 @import "${ANIMATION_PLUGIN_TAILWIND4}";`
+      };
+    }
+    const problems = lines.map((name) => ({ name, why: pluginProblem(name) })).filter((x) => x.why !== void 0);
+    if (problems.length === 0) return { name: "animation", severity: "pass", message: `${file}\uC5D0 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC788\uC2B5\uB2C8\uB2E4` };
+    return {
       name: "animation",
       severity: "warn",
-      message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${ANIMATION_PLUGIN_TAILWIND4} \uC124\uCE58 \uB4A4 @import "${ANIMATION_PLUGIN_TAILWIND4}";`
+      message: `${file}\uC758 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC744 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${by}, ${problems.map((x) => x.why).join(" \xB7 ")}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uACE0 \uBE4C\uB4DC\uAC00 \uC2E4\uD328\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4 \u2192 ${problems.map((x) => x.name).join(" \xB7 ")} \uB97C package.json \uC5D0 \uC120\uC5B8 \xB7 \uC124\uCE58\uD558\uC138\uC694`
     };
   }
   const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync3(join2(baseDir, f)));
   const source = configFile !== void 0 ? stripJsComments(readFileSync4(join2(baseDir, configFile), "utf8")) : "";
   const plugins = configFile !== void 0 ? readAnimationPluginUse(source) : "absent";
-  const pluginDeclared = declaredRange(baseDir, pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0;
-  const pluginInstalled = pluginDeclared && (isPnpProject(baseDir) || findInstalledPackage(baseDir, ANIMATION_PLUGIN_TAILWIND3) !== void 0);
-  if (plugins === "found" && pluginDeclared && pluginInstalled) {
+  const pluginReason = pluginProblem(ANIMATION_PLUGIN_TAILWIND3);
+  if (plugins === "found" && pluginReason === void 0) {
     return { name: "animation", severity: "pass", message: `${configFile}\uC758 plugins \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 \uC788\uC2B5\uB2C8\uB2E4` };
   }
   const cfg = configFile ?? "tailwind.config";
+  const configReason = plugins === "dynamic" ? `${cfg} plugins \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD568` : plugins !== "found" ? `${cfg} plugins \uC5D0 \uC5C6\uC74C` : void 0;
+  if (pluginReason !== void 0 && pnpRootOnlyDependency(baseDir, pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0) {
+    const extra = configReason !== void 0 ? `, ${configReason}` : "";
+    const plug = configReason !== void 0 ? ` \xB7 plugins \uC5D0 require("${ANIMATION_PLUGIN_TAILWIND3}")` : "";
+    return {
+      name: "animation",
+      severity: "warn",
+      message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 ${PNP_ROOT_ONLY_NOTE}(${by}${extra}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uC571 package.json \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uB97C \uC120\uC5B8\uD558\uC138\uC694${plug}`
+    };
+  }
   const reasons = [];
-  if (!pluginDeclared) reasons.push(`${ANIMATION_PLUGIN_TAILWIND3} \uC120\uC5B8 \uC5C6\uC74C`);
-  else if (!pluginInstalled) reasons.push(`${ANIMATION_PLUGIN_TAILWIND3} \uBBF8\uC124\uCE58(\uC120\uC5B8\uB9CC \uC788\uC74C)`);
-  if (plugins === "dynamic") reasons.push(`${cfg} plugins \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD568`);
-  else if (plugins !== "found") reasons.push(`${cfg} plugins \uC5D0 \uC5C6\uC74C`);
+  if (pluginReason !== void 0) reasons.push(pluginReason);
+  if (configReason !== void 0) reasons.push(configReason);
   return {
     name: "animation",
     severity: "warn",
@@ -4924,7 +5008,11 @@ function inspectBrandActivation(baseDir) {
   if (typeof brand !== "string" || brand.trim() === "") return null;
   const location = findBrandActivation(baseDir);
   if (!location.markupWithProvider) return { brand, ...location };
-  return { brand, ...location, theme: packageVersionGate(baseDir, readProjectPackageJson(baseDir), THEME_PACKAGE, THEME_MARKUP_BRAND_MIN_VERSION) };
+  return {
+    brand,
+    ...location,
+    theme: packageVersionGate(baseDir, readProjectPackageJson(baseDir), THEME_PACKAGE, THEME_MARKUP_BRAND_MIN_VERSION, { appOnlyInPnp: true })
+  };
 }
 var THEME_PACKAGE = "@axis-ds/theme";
 function readProjectPackageJson(baseDir) {
@@ -4997,25 +5085,43 @@ function checkDependencies(baseDirInput) {
     return { name: "dependencies", severity: "fail", message: "package.json \uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(JSON \uD655\uC778)" };
   }
   const rootPkg = workspaceRootPackage(baseDir) ?? null;
-  const declared = (d) => declaredDependency(baseDir, pkg, d, rootPkg);
+  const pnp = isPnpProject(baseDir);
+  const declared = (d) => declaredDependency(baseDir, pkg, d, rootPkg, { appOnlyInPnp: true });
+  const pnpRootOnly = (d) => pnpRootOnlyDependency(baseDir, pkg, d, rootPkg) !== void 0;
   const fromRoot = (d) => declared(d)?.source === "root";
-  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => declared(d) === void 0);
-  if (missingRequired.length > 0) {
-    return { name: "dependencies", severity: "fail", message: `\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}` };
-  }
-  const missingRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => declared(d) === void 0);
-  const rootDeclared = [...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => fromRoot(d));
+  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => declared(d) === void 0 && !pnpRootOnly(d));
+  const pnpRootRequired = REQUIRED_DEPENDENCIES.filter((d) => pnpRootOnly(d));
+  if (missingRequired.length > 0 || pnpRootRequired.length > 0) {
+    const fails = [];
+    if (missingRequired.length > 0) fails.push(`\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}`);
+    if (pnpRootRequired.length > 0) fails.push(`\uD544\uC218 \uC758\uC874\uC131 ${pnpRootRequired.join(", ")} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`);
+    return { name: "dependencies", severity: "fail", message: fails.join(" / ") };
+  }
+  const missingRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => declared(d) === void 0 && !pnpRootOnly(d));
+  const pnpRootRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => pnpRootOnly(d));
+  const appAxis = declaredAxisPackages(pkg);
+  const rootOnlyAxis = rootPkg !== null ? declaredAxisPackages(rootPkg).filter((d) => !appAxis.includes(d)) : [];
+  const rootAxis = pnp ? [] : rootOnlyAxis;
+  const pnpRootAxis = pnp ? rootOnlyAxis : [];
+  const rootDeclared = [...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => fromRoot(d)), ...rootAxis];
   const rootNote = rootDeclared.length > 0 ? `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8: ${rootDeclared.join(", ")}` : void 0;
   const targets = [
     ...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => declared(d) !== void 0),
-    ...declaredAxisPackages(pkg)
+    ...appAxis,
+    ...rootAxis
   ];
-  const pnp = isPnpProject(baseDir);
   const notInstalled = pnp ? [] : targets.filter((d) => findInstalledPackage(baseDir, d) === void 0);
+  const notInstalledRoot = notInstalled.filter((d) => rootAxis.includes(d));
+  const notInstalledOther = notInstalled.filter((d) => !rootAxis.includes(d));
   const problems = [];
   if (missingRecommended.length > 0) problems.push(`\uAD8C\uC7A5 \uC758\uC874\uC131 \uB204\uB77D: ${missingRecommended.join(", ")}`);
-  if (notInstalled.length > 0) {
-    problems.push(`\uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC740 \uC758\uC874\uC131: ${notInstalled.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
+  if (pnpRootRecommended.length > 0) problems.push(`\uAD8C\uC7A5 \uC758\uC874\uC131 ${pnpRootRecommended.join(", ")} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`);
+  if (pnpRootAxis.length > 0) problems.push(`${pnpRootAxis.join(", ")} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`);
+  if (notInstalledOther.length > 0) {
+    problems.push(`\uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC740 \uC758\uC874\uC131: ${notInstalledOther.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
+  }
+  if (notInstalledRoot.length > 0) {
+    problems.push(`\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB3FC \uC788\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4: ${notInstalledRoot.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
   }
   if (problems.length > 0) {
     return { name: "dependencies", severity: "warn", message: problems.join(" / ") + (rootNote ? ` (${rootNote})` : "") };
@@ -5185,6 +5291,13 @@ function brandCheckResult(check) {
   }
 }
 function brandActivationResult(check) {
+  if (check.found && check.theme?.status === "unresolved") {
+    return {
+      name: "brand.activation",
+      severity: "warn",
+      message: `${check.found}\uC758 <html data-brand> \uB97C ThemeProvider \uC640 \uD568\uAED8 \uC4F0\uB294\uB370 @axis-ds/theme \uAC00 ${PNP_ROOT_ONLY_NOTE}(${versionGateLabel(check.theme)}) \u2192 \uC571 package.json \uC5D0 @axis-ds/theme ${THEME_MARKUP_BRAND_MIN_VERSION} \uC774\uC0C1\uC744 \uC120\uC5B8\uD558\uAC70\uB098 setBrand("${check.brand}")`
+    };
+  }
   if (check.found && check.theme && check.theme.status !== "ok") {
     const label = versionGateLabel(check.theme);
     const why = check.theme.status === "below" ? `@axis-ds/theme ${label} \uC758 ThemeProvider \uAC00 \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6C1\uB2C8\uB2E4` : `@axis-ds/theme \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${label}). ${THEME_MARKUP_BRAND_MIN_VERSION} \uBBF8\uB9CC\uC774\uBA74 ThemeProvider \uAC00 \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6C1\uB2C8\uB2E4`;
@@ -5378,10 +5491,8 @@ var TOKENS_INSTALL_COMMAND = addCommandFor("pnpm install", { [TOKENS_PACKAGE]: `
 function baseDirOf(targetDir) {
   return path10.resolve(targetDir || process.cwd());
 }
-function tokensInstallCommandFor(targetDir) {
-  return addCommandFor(detectInstallCommand(baseDirOf(targetDir)), {
-    [TOKENS_PACKAGE]: `^${TOKENS_DEPENDENCY_MIN_VERSION}`
-  });
+function tokensInstallGuideFor(targetDir) {
+  return dependencyInstallGuide(baseDirOf(targetDir), TOKENS_PACKAGE, `^${TOKENS_DEPENDENCY_MIN_VERSION}`);
 }
 async function handleListBrands(params) {
   return listBrands(baseDirOf(params.targetDir));
@@ -5394,24 +5505,25 @@ async function handleGetBrand(params) {
   return getBrand(baseDirOf(params.targetDir), name);
 }
 function formatTokensStatusGuide(status, version, installCommand = TOKENS_INSTALL_COMMAND) {
+  const g = typeof installCommand === "string" ? { kind: "add", installCommand, addCommand: installCommand } : installCommand;
+  if (g.kind === "pnp") {
+    return `${TOKENS_PACKAGE}${g.range ? ` ${g.range}` : ""} \uAC00 package.json \uC5D0 \uC120\uC5B8\uB3FC \uC788\uC9C0\uB9CC Plug'n'Play \uC124\uCE58\uB77C \uC124\uCE58\uBCF8\uC744 \uD310\uC815\uD558\uC9C0 \uBABB\uD574 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`;
+  }
+  const install = g.kind === "install-at-root" ? `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C \`${g.installCommand}\`` : `\`${g.kind === "install" ? g.installCommand : g.addCommand}\``;
   switch (status) {
     case "not-installed":
-      return [
-        `${TOKENS_PACKAGE} \uAC00 \uC124\uCE58\uB3FC \uC788\uC9C0 \uC54A\uC544 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`,
-        "",
-        `- \uC124\uCE58: \`${installCommand}\``
-      ].join("\n");
+      return [`${TOKENS_PACKAGE} \uAC00 \uC124\uCE58\uB3FC \uC788\uC9C0 \uC54A\uC544 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`, "", `- \uC124\uCE58: ${install}`].join("\n");
     case "unsupported":
       return [
         `${TOKENS_PACKAGE} ${version ?? "(\uBC84\uC804 \uBAA8\uB984)"} \uC740 \uBE0C\uB79C\uB4DC\uB97C \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(${MIN_BRAND_TOKENS_VERSION} \uC774\uC0C1 \uD544\uC694).`,
         "",
-        `- \uC5C5\uADF8\uB808\uC774\uB4DC: \`${installCommand}\``
+        g.source === "root" ? `- \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 package.json \uC758 ${TOKENS_PACKAGE} \uC120\uC5B8\uC744 ^${MIN_BRAND_TOKENS_VERSION} \uC774\uC0C1\uC73C\uB85C \uC62C\uB9AC\uACE0 \uC124\uCE58\uD558\uC138\uC694.` : `- \uC5C5\uADF8\uB808\uC774\uB4DC: \`${g.addCommand}\``
       ].join("\n");
     case "not-built":
       return [
         `${TOKENS_PACKAGE}${version ? ` ${version}` : ""} \uB294 \uC788\uC9C0\uB9CC \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC774 \uC5C6\uC5B4 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`,
         "",
-        `- \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 \`${workspaceRunCommand(installCommand, TOKENS_PACKAGE, "build")}\`, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: \`${installCommand}\``
+        `- \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 \`${workspaceRunCommand(g.installCommand, TOKENS_PACKAGE, "build")}\`, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: ${install}`
       ].join("\n");
   }
 }
@@ -6069,7 +6181,7 @@ server.tool(
   async ({ targetDir }) => {
     try {
       const result = await handleListBrands({ targetDir });
-      const formatted = formatListBrandsResult(result, tokensInstallCommandFor(targetDir));
+      const formatted = formatListBrandsResult(result, tokensInstallGuideFor(targetDir));
       return {
         content: [
           {
@@ -6102,7 +6214,7 @@ server.tool(
   async ({ name, targetDir }) => {
     try {
       const result = await handleGetBrand({ name, targetDir });
-      const formatted = formatGetBrandResult(result, name, tokensInstallCommandFor(targetDir));
+      const formatted = formatGetBrandResult(result, name, tokensInstallGuideFor(targetDir));
       return {
         content: [
           {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axis-ds/mcp",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "type": "module",
   "description": "AXIS Design System - MCP Server for AI-assisted component discovery",
   "bin": {