@axis-ds/mcp 1.4.1 → 1.4.2

package/README.md

@@ -41,7 +41,7 @@ Claude Desktop 또는 기타 MCP 호환 클라이언트에서 설정:
 - 이름은 레지스트리 이름 그대로입니다. Agentic UI 는 `agentic-` 접두를 붙입니다(예: `agentic-run-progress`). 의존 항목(`utils` · `agentic-a11y-labels`)은 함께 설치됩니다.
 - `targetDir` 는 이미 있는 프로젝트 루트입니다(상대 경로는 서버의 현재 디렉터리 기준). `axis.config.json` 이 있으면 그 `componentsDir` · `agenticDir` 에, 없으면 `components/ui` · `components/agentic` 에 설치하고 그 사실을 알립니다. 프로젝트 밖으로 나가는 경로는 아무것도 쓰지 않고 실패합니다.
 - 내용이 다른 기존 파일은 덮어쓰지 않고 건너뛰며 응답 첫머리에 건너뛴 수를 적습니다. `overwrite: true` 일 때만 덮어씁니다.
-- 의존성은 설치하지 않고 lockfile 에 맞는 명령(`pnpm add` · `npm install` · `yarn add`)만 안내합니다.
+- 의존성은 설치하지 않고 lockfile 에 맞는 명령(`pnpm add` · `npm install` · `yarn add`)만 안내합니다. lockfile 이 없으면 `package.json` 의 `packageManager` 를 봅니다(1.4.2 부터). `axis.apply_template` 의 「필요한 의존성」 · `axis.list_brands` · `axis.get_brand` 의 설치 안내도 1.4.2 부터 같은 방식으로 `targetDir` 의 매니저를 따릅니다(1.4.1 까지는 `pnpm` 고정).
 
 ## 토큰 도구
 

package/dist/index.js

@@ -603,7 +603,7 @@ function createPinnedFetch(options = {}) {
   const judge = options.judge ?? blockedAddressReason;
   const send = options.request ?? httpsRequest;
   const maxBytes = options.maxBytes ?? PINNED_FETCH_MAX_BYTES;
-  return (input, init) => new Promise((resolve5, reject) => {
+  return (input, init) => new Promise((resolve4, reject) => {
     let url;
     try {
       url = new URL(input);
@@ -644,7 +644,7 @@ function createPinnedFetch(options = {}) {
           if (failed) return;
           const body = Buffer.concat(chunks).toString("utf8");
           const status = res.statusCode ?? 0;
-          resolve5({ ok: status >= 200 && status < 300, status, text: async () => body });
+          resolve4({ ok: status >= 200 && status < 300, status, text: async () => body });
         });
       }
     );
@@ -871,8 +871,16 @@ var RegistryClient = class {
 };
 
 // ../axis-registry-core/src/project.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3, statSync } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync3, realpathSync, statSync } from "fs";
 import path3 from "path";
+function resolveBaseDir(baseDirInput) {
+  const resolved = path3.resolve(baseDirInput);
+  try {
+    return realpathSync(resolved);
+  } catch {
+    return resolved;
+  }
+}
 var LOCKFILE_COMMANDS = [
   ["pnpm-lock.yaml", "pnpm install"],
   ["yarn.lock", "yarn install"],
@@ -894,7 +902,7 @@ function isWorkspaceRootDir(dir) {
   return Array.isArray(ws) || isPlainObject(ws) && Array.isArray(ws.packages);
 }
 function findWorkspaceRoot(baseDirInput) {
-  let dir = path3.resolve(baseDirInput);
+  let dir = resolveBaseDir(baseDirInput);
   for (; ; ) {
     if (isWorkspaceRootDir(dir)) return dir;
     if (existsSync2(path3.join(dir, ".git"))) return void 0;
@@ -903,17 +911,45 @@ function findWorkspaceRoot(baseDirInput) {
     dir = parent;
   }
 }
+var PACKAGE_MANAGER_COMMANDS = {
+  pnpm: "pnpm install",
+  yarn: "yarn install",
+  npm: "npm install"
+};
+function packageManagerCommandAt(dir) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(path3.join(dir, "package.json"), "utf8"));
+  } catch {
+    return void 0;
+  }
+  if (!isPlainObject(parsed) || typeof parsed.packageManager !== "string") return void 0;
+  const name = /^(pnpm|yarn|npm)@/.exec(parsed.packageManager.trim())?.[1];
+  return name !== void 0 ? PACKAGE_MANAGER_COMMANDS[name] : void 0;
+}
 function detectInstallCommand(baseDirInput) {
-  const baseDir = path3.resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   const own = lockfileCommandAt(baseDir);
   if (own !== void 0) return own;
-  const root = findWorkspaceRoot(baseDir);
-  if (root !== void 0 && root !== baseDir) {
+  const found = findWorkspaceRoot(baseDir);
+  const root = found !== void 0 && found !== baseDir ? found : void 0;
+  if (root !== void 0) {
     const fromRoot = lockfileCommandAt(root);
     if (fromRoot !== void 0) return fromRoot;
   }
+  const ownManager = packageManagerCommandAt(baseDir);
+  if (ownManager !== void 0) return ownManager;
+  if (root !== void 0) {
+    const rootManager = packageManagerCommandAt(root);
+    if (rootManager !== void 0) return rootManager;
+  }
   return "pnpm install";
 }
+function packageManagerOf(command) {
+  if (command.startsWith("yarn")) return "yarn";
+  if (command.startsWith("npm")) return "npm";
+  return "pnpm";
+}
 function hasDependency(pkg, name) {
   for (const field of ["dependencies", "devDependencies"]) {
     const deps = pkg[field];
@@ -923,14 +959,52 @@ function hasDependency(pkg, name) {
   }
   return void 0;
 }
+function workspaceRootPackage(baseDirInput) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const root = findWorkspaceRoot(baseDir);
+  if (root === void 0 || root === baseDir) return void 0;
+  try {
+    const parsed = JSON.parse(readFileSync3(path3.join(root, "package.json"), "utf8"));
+    return isPlainObject(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function declaredDependency(baseDir, pkg, name, rootPkg) {
+  if (pkg === void 0) return void 0;
+  const own = hasDependency(pkg, name);
+  if (own !== void 0) return { range: own, source: "app" };
+  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 isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function addCommandFor(installCommand, deps) {
+function addCommandPrefix(installCommand, options = {}) {
+  const dev = options.dev ? " -D" : "";
+  switch (packageManagerOf(installCommand)) {
+    case "yarn":
+      return `yarn add${dev}`;
+    case "npm":
+      return `npm install${dev}`;
+    default:
+      return `pnpm add${dev}`;
+  }
+}
+function addCommandFor(installCommand, deps, options = {}) {
   const specs = Object.entries(deps).map(([name, range]) => `"${name}@${range}"`).join(" ");
-  if (installCommand.startsWith("yarn")) return `yarn add ${specs}`;
-  if (installCommand.startsWith("npm")) return `npm install ${specs}`;
-  return `pnpm add ${specs}`;
+  return `${addCommandPrefix(installCommand, options)} ${specs}`;
+}
+function workspaceRunCommand(installCommand, pkg, script) {
+  switch (packageManagerOf(installCommand)) {
+    case "yarn":
+      return `yarn workspace ${pkg} ${script}`;
+    case "npm":
+      return `npm run ${script} -w ${pkg}`;
+    default:
+      return `pnpm --filter ${pkg} ${script}`;
+  }
 }
 var GLOBAL_CSS_CANDIDATES = [
   "app/globals.css",
@@ -969,7 +1043,7 @@ function exactVersionOf(version) {
   return v;
 }
 function findInstalledPackage(baseDirInput, name) {
-  let dir = path3.resolve(baseDirInput);
+  let dir = resolveBaseDir(baseDirInput);
   for (; ; ) {
     const pkgDir = path3.join(dir, "node_modules", ...name.split("/"));
     const file = path3.join(pkgDir, "package.json");
@@ -989,7 +1063,7 @@ function findInstalledPackage(baseDirInput, name) {
   }
 }
 function isPnpProject(baseDirInput) {
-  let dir = path3.resolve(baseDirInput);
+  let dir = resolveBaseDir(baseDirInput);
   for (; ; ) {
     if (isFile(path3.join(dir, ".pnp.cjs")) || isFile(path3.join(dir, ".pnp.js"))) return true;
     const parent = path3.dirname(dir);
@@ -1010,16 +1084,10 @@ function compareExactVersions(a, b) {
 }
 
 // ../axis-registry-core/src/template/tailwind-core.ts
-import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync4, realpathSync } from "fs";
+import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync4, realpathSync as realpathSync2 } from "fs";
 import { basename, dirname as dirname2, extname, isAbsolute, join as join2, relative, resolve, sep } from "path";
-function hasDependency2(pkg, name) {
-  for (const field of ["dependencies", "devDependencies"]) {
-    const deps = pkg[field];
-    if (typeof deps === "object" && deps !== null && name in deps) {
-      return String(deps[name]);
-    }
-  }
-  return void 0;
+function declaredRange(baseDir, pkg, name) {
+  return declaredDependency(baseDir, pkg, name)?.range;
 }
 function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1092,8 +1160,8 @@ function majorFromVersion(version) {
   return Number(m[1]);
 }
 function detectTailwind(baseDirInput, pkg) {
-  const baseDir = resolve(baseDirInput);
-  const declared = pkg ? hasDependency2(pkg, "tailwindcss") : void 0;
+  const baseDir = resolveBaseDir(baseDirInput);
+  const declared = pkg ? declaredRange(baseDir, pkg, "tailwindcss") : void 0;
   const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
   const declaredMajor = bounds?.lower;
   const version = isPnpProject(baseDir) ? void 0 : findInstalledPackage(baseDir, "tailwindcss")?.version;
@@ -1144,7 +1212,7 @@ function findTokensCssImport(css) {
 var TOKENS_CSS_JS_IMPORT = /(?:\bimport\s+|\bfrom\s+|\brequire\s*\(\s*)(["'])(@axis-ds\/tokens\/css(?:\/shadcn|\/tailwind4)?)\1/;
 var AXIS_VARIABLE_DEFINITION = /(?<![\w-])--axis-[\w-]+\s*:/;
 function findLayoutTokensCssImport(baseDirInput) {
-  const baseDir = resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   for (const candidate of ROOT_LAYOUT_FILES) {
     const file = join2(baseDir, candidate);
     if (!existsSync3(file)) continue;
@@ -1160,7 +1228,7 @@ function findLayoutTokensCssImport(baseDirInput) {
   return void 0;
 }
 function checkGlobalsCss(baseDirInput) {
-  const baseDir = resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   for (const candidate of TAILWIND_CSS_CANDIDATES) {
     const file = join2(baseDir, candidate);
     if (!existsSync3(file)) continue;
@@ -1252,11 +1320,11 @@ function installedAxisVersion(baseDir, name) {
 }
 function axisPackagesBelowTailwind4(pkg, baseDirInput) {
   if (!pkg) return [];
-  const baseDir = baseDirInput !== void 0 ? resolve(baseDirInput) : void 0;
+  const baseDir = baseDirInput !== void 0 ? resolveBaseDir(baseDirInput) : void 0;
   const out = [];
   const min = lowerOf(TAILWIND4_MIN_AXIS_VERSION);
   for (const name of TAILWIND4_AXIS_PACKAGES) {
-    const range = hasDependency2(pkg, name);
+    const range = baseDir !== void 0 ? declaredRange(baseDir, pkg, name) : hasDependency(pkg, name);
     if (range === void 0 || range.trim().startsWith("workspace:")) continue;
     const installed = baseDir !== void 0 ? installedAxisVersion(baseDir, name) : void 0;
     const installedLower = installed !== void 0 ? lowerOf(installed) : void 0;
@@ -1396,7 +1464,7 @@ function isCommonJsConfig(file, source) {
   return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
 }
 function packageVersionGate(baseDirInput, pkg, name, min) {
-  const baseDir = resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   if (!isPnpProject(baseDir)) {
     const installed = findInstalledPackage(baseDir, name)?.version;
     if (installed !== void 0) {
@@ -1404,7 +1472,7 @@ function packageVersionGate(baseDirInput, pkg, name, min) {
       if (cmp !== void 0) return { status: cmp >= 0 ? "ok" : "below", source: "installed", value: installed };
     }
   }
-  const declared = pkg ? hasDependency2(pkg, name) : void 0;
+  const declared = pkg ? declaredRange(baseDir, pkg, name) : void 0;
   if (declared !== void 0) {
     const atLeast = rangeLowerAtLeast(declared, min);
     if (atLeast !== void 0) return { status: atLeast ? "ok" : "below", source: "declared", value: declared };
@@ -1425,12 +1493,12 @@ function readPackageJson(baseDir) {
     return void 0;
   }
 }
-function tailwind4Issues(css, pkg, versions) {
+function tailwind4Issues(css, pkg, versions, baseDir) {
   const issues = [];
   const hasEntry = hasTokensTailwind4Import(css);
   if (!hasEntry) issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${TOKENS_TAILWIND4_IMPORT_LINE}`);
   const missing = TAILWIND4_COMPONENT_PACKAGES.filter(
-    (name) => pkg !== void 0 && hasDependency2(pkg, name) !== void 0 && !hasComponentTailwindImport(css, name) && !hasComponentSource(css, name)
+    (name) => declaredRange(baseDir, pkg, name) !== void 0 && !hasComponentTailwindImport(css, name) && !hasComponentSource(css, name)
   );
   if (missing.length > 0) {
     issues.push(`\uCEF4\uD3EC\uB10C\uD2B8 \uC2A4\uCE94 \uACBD\uB85C(tailwind.css)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${missing.map(componentTailwindImportLine).join(" ")}`);
@@ -1450,7 +1518,7 @@ function tailwind4Issues(css, pkg, versions) {
   return issues;
 }
 function checkTailwindSetup(baseDirInput) {
-  const baseDir = resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   const pkg = readPackageJson(baseDir);
   const tailwind = detectTailwind(baseDir, pkg);
   if (tailwind.major !== void 0 && tailwind.major >= 4) {
@@ -1467,7 +1535,7 @@ function checkTailwindSetup(baseDirInput) {
         };
       }
       const versions = axisPackagesBelowTailwind4(pkg, baseDir);
-      const issues = tailwind4Issues(css, pkg, versions);
+      const issues = tailwind4Issues(css, pkg, versions, baseDir);
       if (issues.length > 0) {
         return {
           name: "tailwind.config",
@@ -1606,7 +1674,7 @@ function realpathPosix(p) {
   const tail = [];
   for (let i = 0; i < 64; i++) {
     try {
-      return [realpathSync(cur), ...tail].join(sep).split(sep).join("/");
+      return [realpathSync2(cur), ...tail].join(sep).split(sep).join("/");
     } catch {
       const parent = dirname2(cur);
       if (parent === cur) return void 0;
@@ -1626,7 +1694,8 @@ function contentGlobBranchCovers(glob, sample, baseDir) {
   }
   return leadingParentSegments(glob) === leadingParentSegments(sample) && contentGlobToRegExp(glob).test(sample);
 }
-function contentGlobCovers(glob, sample, baseDir) {
+function contentGlobCovers(glob, sample, baseDirInput) {
+  const baseDir = resolveBaseDir(baseDirInput);
   const branches = expandBraces(glob.trim()) ?? [glob];
   return branches.some((b) => contentGlobBranchCovers(b, sample, baseDir));
 }
@@ -1687,7 +1756,7 @@ function normalizeRel(p) {
   return s;
 }
 function inspectTailwindContent(baseDirInput) {
-  const baseDir = resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   const pkg = readPackageJson(baseDir);
   const tailwind = detectTailwind(baseDir, pkg);
   if (tailwind.major !== void 0 && tailwind.major >= 4) return null;
@@ -1700,7 +1769,7 @@ function inspectTailwindContent(baseDirInput) {
     targets.push({ label: `componentsDir(${componentsDir})`, sample: `${rel2}/button.tsx`, suggest: `./${rel2}/**/*.{ts,tsx}` });
   }
   for (const name of TAILWIND4_COMPONENT_PACKAGES) {
-    if (pkg !== void 0 && hasDependency2(pkg, name) !== void 0) {
+    if (declaredRange(baseDir, pkg, name) !== void 0) {
       targets.push({ label: name, ...packageContentTarget(baseDir, name) });
     }
   }
@@ -1778,10 +1847,10 @@ function componentsUseAnimation(baseDir, componentsDir) {
   return false;
 }
 function checkAnimationPlugin(baseDirInput) {
-  const baseDir = resolve(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   const pkg = readPackageJson(baseDir);
   const config = readAxisConfigLike(baseDir);
-  const declared = pkg !== void 0 && hasDependency2(pkg, "@axis-ds/ui-react") !== void 0;
+  const declared = declaredRange(baseDir, pkg, "@axis-ds/ui-react") !== void 0;
   const copied = typeof config?.componentsDir === "string" && componentsUseAnimation(baseDir, config.componentsDir);
   if (!declared && !copied) return null;
   const by = declared ? "@axis-ds/ui-react \uC120\uC5B8" : "componentsDir \uC758 animate-in \uB958 \uD074\uB798\uC2A4";
@@ -1799,7 +1868,7 @@ function checkAnimationPlugin(baseDirInput) {
   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 = pkg !== void 0 && hasDependency2(pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0;
+  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) {
     return { name: "animation", severity: "pass", message: `${configFile}\uC758 plugins \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 \uC788\uC2B5\uB2C8\uB2E4` };
@@ -1891,7 +1960,7 @@ function selectUtilsDependencies(tailwind) {
 }
 
 // ../axis-registry-core/src/add/safe-write.ts
-import { constants as fsConstants, existsSync as existsSync4, lstatSync as lstatSync2, realpathSync as realpathSync2, statSync as statSync2 } from "fs";
+import { constants as fsConstants, existsSync as existsSync4, lstatSync as lstatSync2, realpathSync as realpathSync3, statSync as statSync2 } from "fs";
 import path4 from "path";
 import fs2 from "fs-extra";
 var NEW_FILE_FLAGS = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
@@ -1918,12 +1987,12 @@ function nearestExisting(p) {
   return cur;
 }
 function escapeReason(root, target, options = {}) {
-  const realRoot = realpathSync2(root);
+  const realRoot = realpathSync3(root);
   if (!isSameOrInside(path4.resolve(root), path4.resolve(target)) || path4.resolve(target) === path4.resolve(root)) {
     return `\uACBD\uB85C\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4(${target})`;
   }
   const anchor = nearestExisting(path4.dirname(target));
-  const realAnchor = realpathSync2(anchor);
+  const realAnchor = realpathSync3(anchor);
   if (!isSameOrInside(realRoot, realAnchor)) {
     return `\uC0C1\uC704 \uB514\uB809\uD130\uB9AC\uC758 \uC2E4\uC81C \uC704\uCE58(${realAnchor})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`;
   }
@@ -1938,7 +2007,7 @@ function escapeReason(root, target, options = {}) {
     const shown = path4.relative(path4.resolve(root), path4.resolve(target)).split(path4.sep).join("/");
     let realTarget;
     try {
-      realTarget = realpathSync2(target);
+      realTarget = realpathSync3(target);
     } catch {
       return `\uAE30\uC874 \uD30C\uC77C ${shown} \uC774 \uAE68\uC9C4 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C \uB530\uB77C\uAC08 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(\uB9C1\uD06C\uB97C \uC9C0\uC6B0\uAC70\uB098 \uACE0\uCE5C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694)`;
     }
@@ -1971,8 +2040,8 @@ function isSymlink(p) {
 function outsideLinkTarget(root, target) {
   if (!isSymlink(target)) return null;
   try {
-    const realTarget = realpathSync2(target);
-    return isSameOrInside(realpathSync2(root), realTarget) ? null : realTarget;
+    const realTarget = realpathSync3(target);
+    return isSameOrInside(realpathSync3(root), realTarget) ? null : realTarget;
   } catch {
     return null;
   }
@@ -1989,10 +2058,10 @@ function hardLinkMessage(shownPath, nlink) {
   return `\uAE30\uC874 \uD30C\uC77C ${shownPath} \uC774 \uB2E4\uB978 \uACBD\uB85C\uC640 \uD558\uB4DC\uB9C1\uD06C\uB85C \uC774\uC5B4\uC9C4 \uD30C\uC77C\uC774\uB77C(\uB9C1\uD06C \uC218 ${nlink}) \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uBA74 \uC774\uC5B4\uC9C4 \uB2E4\uB978 \uACBD\uB85C\uC758 \uB0B4\uC6A9\uB3C4 \uBC14\uB01D\uB2C8\uB2E4. \uD558\uB4DC\uB9C1\uD06C\uB97C \uB04A\uC740(\uD30C\uC77C\uC744 \uBCF5\uC0AC\uD574 \uBC14\uAFBC) \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694`;
 }
 function writtenOutside(root, target) {
-  const realRoot = realpathSync2(root);
+  const realRoot = realpathSync3(root);
   let realTarget;
   try {
-    realTarget = realpathSync2(target);
+    realTarget = realpathSync3(target);
   } catch {
     return target;
   }
@@ -2026,8 +2095,8 @@ async function writeNoFollow(target, content, mode) {
   return actual;
 }
 function checkParentInside(root, target) {
-  const realRoot = realpathSync2(root);
-  const realParent = realpathSync2(path4.dirname(target));
+  const realRoot = realpathSync3(root);
+  const realParent = realpathSync3(path4.dirname(target));
   if (!isSameOrInside(realRoot, realParent)) {
     return `\uBD80\uBAA8 \uB514\uB809\uD130\uB9AC\uC758 \uC2E4\uC81C \uC704\uCE58(${realParent})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`;
   }
@@ -2301,11 +2370,12 @@ function missingDependencies(root, items) {
     pkg = void 0;
   }
   const ranges = selectUtilsDependencies(detectTailwind(root, pkg));
+  const rootPkg = pkg !== void 0 ? workspaceRootPackage(root) ?? null : null;
   const specs = {};
   for (const item of items) {
     for (const dep of item.dependencies) {
       const name = dependencyName(dep);
-      if (pkg !== void 0 && hasDependency(pkg, name) !== void 0) continue;
+      if (declaredDependency(root, pkg, name, rootPkg) !== void 0) continue;
       if (name in specs) continue;
       const explicit = dep.length > name.length ? dep.slice(name.length + 1) : void 0;
       specs[name] = explicit ?? ranges[name];
@@ -2321,9 +2391,7 @@ function dependencyName(spec) {
 }
 function addCommandForSpecs(installCommand, specs) {
   const args = Object.entries(specs).map(([name, range]) => range ? `"${name}@${range}"` : name).join(" ");
-  if (installCommand.startsWith("yarn")) return `yarn add ${args}`;
-  if (installCommand.startsWith("npm")) return `npm install ${args}`;
-  return `pnpm add ${args}`;
+  return `${addCommandPrefix(installCommand)} ${args}`;
 }
 function rel(root, p) {
   return toPosix(path5.relative(root, p));
@@ -4850,7 +4918,7 @@ function getBrand(baseDir, name) {
 
 // ../axis-registry-core/src/template/dependencies-core.ts
 import { readFileSync as readFileSync9 } from "fs";
-import { join as join5, resolve as resolve4 } from "path";
+import { join as join5 } from "path";
 var REQUIRED_DEPENDENCIES = ["tailwindcss"];
 var RECOMMENDED_DEPENDENCIES = ["clsx", "tailwind-merge"];
 function declaredAxisPackages(pkg) {
@@ -4862,18 +4930,8 @@ function declaredAxisPackages(pkg) {
   }
   return out;
 }
-function workspaceRootPackage(baseDir) {
-  const root = findWorkspaceRoot(baseDir);
-  if (root === void 0 || root === baseDir) return void 0;
-  try {
-    const parsed = JSON.parse(readFileSync9(join5(root, "package.json"), "utf8"));
-    return isPlainObject(parsed) ? parsed : void 0;
-  } catch {
-    return void 0;
-  }
-}
 function checkDependencies(baseDirInput) {
-  const baseDir = resolve4(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   let pkg;
   try {
     const parsed = JSON.parse(readFileSync9(join5(baseDir, "package.json"), "utf8"));
@@ -4885,17 +4943,18 @@ 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);
-  const fromRoot = (d) => !hasDependency(pkg, d) && rootPkg !== void 0 && Boolean(hasDependency(rootPkg, d));
-  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => !hasDependency(pkg, d) && !fromRoot(d));
+  const rootPkg = workspaceRootPackage(baseDir) ?? null;
+  const declared = (d) => declaredDependency(baseDir, pkg, d, rootPkg);
+  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) => !hasDependency(pkg, d) && !fromRoot(d));
+  const missingRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => declared(d) === void 0);
   const rootDeclared = [...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => fromRoot(d));
   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) => hasDependency(pkg, d) !== void 0 || fromRoot(d)),
+    ...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => declared(d) !== void 0),
     ...declaredAxisPackages(pkg)
   ];
   const pnp = isPnpProject(baseDir);
@@ -4970,6 +5029,7 @@ async function handleGetTemplate(params) {
 async function handleApplyTemplate(params) {
   const detail = await fetchTemplateDetail(params.name);
   const baseDir = path9.resolve(params.targetDir);
+  const installCommand = detectInstallCommand(baseDir);
   const files = [];
   for (const file of detail.files) {
     const dest = path9.join(baseDir, file.path);
@@ -5007,7 +5067,8 @@ async function handleApplyTemplate(params) {
     files,
     dependencies: detail.dependencies || {},
     devDependencies: detail.devDependencies || {},
-    dryRun: !!params.dryRun
+    dryRun: !!params.dryRun,
+    installCommand
   };
 }
 async function handleDiffTemplate(params) {
@@ -5214,11 +5275,12 @@ function formatApplyTemplateResult(result) {
   const devDeps = Object.entries(result.devDependencies);
   if (deps.length > 0 || devDeps.length > 0) {
     lines.push("", "### \uD544\uC694\uD55C \uC758\uC874\uC131", "");
+    const installCommand = result.installCommand ?? "pnpm install";
     if (deps.length > 0) {
-      lines.push(`\`pnpm add ${deps.map(([k, v]) => `${k}@${v}`).join(" ")}\``);
+      lines.push(`\`${addCommandFor(installCommand, result.dependencies)}\``);
     }
     if (devDeps.length > 0) {
-      lines.push(`\`pnpm add -D ${devDeps.map(([k, v]) => `${k}@${v}`).join(" ")}\``);
+      lines.push(`\`${addCommandFor(installCommand, result.devDependencies, { dev: true })}\``);
     }
   }
   return lines.join("\n");
@@ -5263,6 +5325,11 @@ 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}`
+  });
+}
 async function handleListBrands(params) {
   return listBrands(baseDirOf(params.targetDir));
 }
@@ -5273,32 +5340,32 @@ async function handleGetBrand(params) {
   }
   return getBrand(baseDirOf(params.targetDir), name);
 }
-function formatTokensStatusGuide(status, version) {
+function formatTokensStatusGuide(status, version, installCommand = TOKENS_INSTALL_COMMAND) {
   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: \`${TOKENS_INSTALL_COMMAND}\``
+        `- \uC124\uCE58: \`${installCommand}\``
       ].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: \`${TOKENS_INSTALL_COMMAND}\``
+        `- \uC5C5\uADF8\uB808\uC774\uB4DC: \`${installCommand}\``
       ].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 \`pnpm --filter ${TOKENS_PACKAGE} build\`, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: \`${TOKENS_INSTALL_COMMAND}\``
+        `- \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 \`${workspaceRunCommand(installCommand, TOKENS_PACKAGE, "build")}\`, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: \`${installCommand}\``
       ].join("\n");
   }
 }
-function formatListBrandsResult(result) {
+function formatListBrandsResult(result, installCommand) {
   const lines = ["## AXIS \uBE0C\uB79C\uB4DC\n"];
   if (result.status !== "ok") {
-    lines.push(formatTokensStatusGuide(result.status, result.version));
+    lines.push(formatTokensStatusGuide(result.status, result.version, installCommand));
     return lines.join("\n");
   }
   if (result.brands.length === 0) {
@@ -5332,10 +5399,10 @@ function tokenTable(brand) {
   }
   return lines;
 }
-function formatGetBrandResult(result, name) {
+function formatGetBrandResult(result, name, installCommand) {
   if (result.status !== "ok") {
     return [`## \uBE0C\uB79C\uB4DC: ${name}
-`, formatTokensStatusGuide(result.status, result.version)].join("\n");
+`, formatTokensStatusGuide(result.status, result.version, installCommand)].join("\n");
   }
   const brand = result.brand;
   if (!brand) {
@@ -5949,7 +6016,7 @@ server.tool(
   async ({ targetDir }) => {
     try {
       const result = await handleListBrands({ targetDir });
-      const formatted = formatListBrandsResult(result);
+      const formatted = formatListBrandsResult(result, tokensInstallCommandFor(targetDir));
       return {
         content: [
           {
@@ -5974,7 +6041,7 @@ server.tool(
 );
 server.tool(
   "axis.get_brand",
-  "\uBE0C\uB79C\uB4DC \uD558\uB098\uC758 import \uACBD\uB85C \xB7 Provider \uC124\uC815 \uC608\uC2DC(defaultBrand) \xB7 \uC8FC\uC694 \uD1A0\uD070 \xB7 \uBCF4\uC815 \uB0B4\uC5ED\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4.",
+  "\uBE0C\uB79C\uB4DC \uD558\uB098\uC758 import \uACBD\uB85C \xB7 \uBE0C\uB79C\uB4DC \uCF1C\uAE30 \uC608\uC2DC(<html data-brand> \xB7 ThemeProvider setBrand) \xB7 \uC8FC\uC694 \uD1A0\uD070 \xB7 \uBCF4\uC815 \uB0B4\uC5ED\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4.",
   {
     name: z.string().describe("\uBE0C\uB79C\uB4DC \uC774\uB984 (\uC608: ontology)"),
     targetDir: z.string().optional().describe("\uB300\uC0C1 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD1A0\uB9AC (\uAE30\uBCF8: \uD604\uC7AC \uB514\uB809\uD1A0\uB9AC)")
@@ -5982,7 +6049,7 @@ server.tool(
   async ({ name, targetDir }) => {
     try {
       const result = await handleGetBrand({ name, targetDir });
-      const formatted = formatGetBrandResult(result, name);
+      const formatted = formatGetBrandResult(result, name, tokensInstallCommandFor(targetDir));
       return {
         content: [
           {

package/package.json

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