@axis-ds/mcp 1.4.0 → 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,14 +871,85 @@ 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 detectInstallCommand(baseDir) {
-  if (existsSync2(path3.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
-  if (existsSync2(path3.join(baseDir, "yarn.lock"))) return "yarn install";
-  if (existsSync2(path3.join(baseDir, "package-lock.json"))) return "npm install";
+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"],
+  ["package-lock.json", "npm install"]
+];
+function lockfileCommandAt(dir) {
+  return LOCKFILE_COMMANDS.find(([file]) => existsSync2(path3.join(dir, file)))?.[1];
+}
+function isWorkspaceRootDir(dir) {
+  if (isFile(path3.join(dir, "pnpm-workspace.yaml"))) return true;
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(path3.join(dir, "package.json"), "utf8"));
+  } catch {
+    return false;
+  }
+  if (!isPlainObject(parsed)) return false;
+  const ws = parsed.workspaces;
+  return Array.isArray(ws) || isPlainObject(ws) && Array.isArray(ws.packages);
+}
+function findWorkspaceRoot(baseDirInput) {
+  let dir = resolveBaseDir(baseDirInput);
+  for (; ; ) {
+    if (isWorkspaceRootDir(dir)) return dir;
+    if (existsSync2(path3.join(dir, ".git"))) return void 0;
+    const parent = path3.dirname(dir);
+    if (parent === dir) return void 0;
+    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 = resolveBaseDir(baseDirInput);
+  const own = lockfileCommandAt(baseDir);
+  if (own !== void 0) return own;
+  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];
@@ -888,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",
@@ -934,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");
@@ -954,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);
@@ -975,16 +1084,10 @@ function compareExactVersions(a, b) {
 }
 
 // ../axis-registry-core/src/template/tailwind-core.ts
-import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync4 } from "fs";
-import { extname, join as join2, resolve } 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;
+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 declaredRange(baseDir, pkg, name) {
+  return declaredDependency(baseDir, pkg, name)?.range;
 }
 function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1057,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;
@@ -1109,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;
@@ -1125,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;
@@ -1217,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;
@@ -1361,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) {
@@ -1369,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 };
@@ -1390,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(" ")}`);
@@ -1415,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) {
@@ -1432,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",
@@ -1519,6 +1622,93 @@ function contentGlobToRegExp(glob) {
   }
   return new RegExp(`^${re}$`);
 }
+function leadingParentSegments(p) {
+  const s = p.trim().replace(/\\/g, "/").replace(/^\.\//, "");
+  return (/^(?:\.\.\/)*/.exec(s)?.[0].length ?? 0) / 3;
+}
+function isAbsoluteGlob(glob) {
+  const t = glob.trim();
+  return t.startsWith("/") || /^[A-Za-z]:[\\/]/.test(t);
+}
+var MAX_BRACE_EXPANSION = 256;
+function expandBraces(glob) {
+  const open = glob.indexOf("{");
+  if (open === -1) return [glob];
+  let depth = 0;
+  let close = -1;
+  const commas = [];
+  for (let i = open; i < glob.length; i++) {
+    const c = glob[i];
+    if (c === "{") depth++;
+    else if (c === "}") {
+      depth--;
+      if (depth === 0) {
+        close = i;
+        break;
+      }
+    } else if (c === "," && depth === 1) commas.push(i);
+  }
+  const head = glob.slice(0, open + 1);
+  if (close === -1 || commas.length === 0) {
+    return expandBraces(glob.slice(open + 1))?.map((r) => head + r);
+  }
+  const parts = [];
+  let from = open + 1;
+  for (const c of [...commas, close]) {
+    parts.push(glob.slice(from, c));
+    from = c + 1;
+  }
+  const prefix = glob.slice(0, open);
+  const suffix = glob.slice(close + 1);
+  const out = [];
+  for (const part of parts) {
+    const expanded = expandBraces(prefix + part + suffix);
+    if (expanded === void 0) return void 0;
+    out.push(...expanded);
+    if (out.length > MAX_BRACE_EXPANSION) return void 0;
+  }
+  return out;
+}
+function realpathPosix(p) {
+  let cur = p;
+  const tail = [];
+  for (let i = 0; i < 64; i++) {
+    try {
+      return [realpathSync2(cur), ...tail].join(sep).split(sep).join("/");
+    } catch {
+      const parent = dirname2(cur);
+      if (parent === cur) return void 0;
+      tail.unshift(basename(cur));
+      cur = parent;
+    }
+  }
+  return void 0;
+}
+function contentGlobBranchCovers(glob, sample, baseDir) {
+  if (isAbsoluteGlob(glob)) {
+    const re = contentGlobToRegExp(glob.trim().replace(/\\/g, "/"));
+    const absSample = resolve(baseDir, sample);
+    if (re.test(absSample.split(sep).join("/"))) return true;
+    const real = realpathPosix(absSample);
+    return real !== void 0 && re.test(real);
+  }
+  return leadingParentSegments(glob) === leadingParentSegments(sample) && contentGlobToRegExp(glob).test(sample);
+}
+function contentGlobCovers(glob, sample, baseDirInput) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const branches = expandBraces(glob.trim()) ?? [glob];
+  return branches.some((b) => contentGlobBranchCovers(b, sample, baseDir));
+}
+var CONTENT_PARENT_PATH_NOTE = "\uC0C1\uC704 \uACBD\uB85C\uB294 Tailwind 3 \uAC00 \uBE4C\uB4DC\uB97C \uC2E4\uD589\uD55C \uB514\uB809\uD130\uB9AC \uAE30\uC900\uC73C\uB85C \uD480\uB824\uC694. \uBAA8\uB178\uB808\uD3EC \uB8E8\uD2B8 \uB4F1 \uC571 \uB514\uB809\uD130\uB9AC \uBC16\uC5D0\uC11C \uBE4C\uB4DC\uD558\uBA74 content: { relative: true, files: [...] } \uB85C \uC124\uC815 \uD30C\uC77C \uAE30\uC900\uC73C\uB85C \uBC14\uAFB8\uC138\uC694";
+function packageContentTarget(baseDir, name) {
+  const found = isPnpProject(baseDir) ? void 0 : findInstalledPackage(baseDir, name);
+  const rel2 = found === void 0 ? void 0 : relative(baseDir, found.dir);
+  const relDir = rel2 === void 0 || rel2 === "" || isAbsolute(rel2) ? `node_modules/${name}` : rel2.split(sep).join("/");
+  return {
+    sample: `${relDir}/dist/index.js`,
+    suggest: `${relDir.startsWith("../") ? "" : "./"}${relDir}/dist/**/*.{js,mjs}`
+  };
+}
 function balancedSlice(src, start) {
   const open = src[start];
   const close = open === "[" ? "]" : "}";
@@ -1566,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;
@@ -1579,18 +1769,18 @@ 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) {
-      targets.push({ label: name, sample: `node_modules/${name}/dist/index.js`, suggest: `./node_modules/${name}/dist/**/*.{js,mjs}` });
+    if (declaredRange(baseDir, pkg, name) !== void 0) {
+      targets.push({ label: name, ...packageContentTarget(baseDir, name) });
     }
   }
   if (targets.length === 0) return null;
   const read = readTailwindContent(readFileSync4(join2(baseDir, configFile), "utf8"));
-  const patterns = (read?.globs ?? []).filter((g) => !g.trim().startsWith("!")).map(contentGlobToRegExp);
+  const globs = (read?.globs ?? []).filter((g) => !g.trim().startsWith("!"));
   return {
     configFile,
     unreadable: read === void 0,
     dynamic: read?.dynamic ?? false,
-    targets: targets.map((t) => ({ ...t, covered: patterns.some((re) => re.test(t.sample)) }))
+    targets: targets.map((t) => ({ ...t, covered: globs.some((g) => contentGlobCovers(g, t.sample, baseDir)) }))
   };
 }
 function checkTailwindContent(baseDir) {
@@ -1605,17 +1795,18 @@ function checkTailwindContent(baseDir) {
     };
   }
   const list = missing.map((t) => `${t.label} \u2192 "${t.suggest}"`).join(" \xB7 ");
+  const note = missing.some((t) => t.suggest.startsWith("../")) ? ` (${CONTENT_PARENT_PATH_NOTE})` : "";
   if (r.unreadable || r.dynamic) {
     return {
       name: "tailwind.content",
       severity: "warn",
-      message: `${r.configFile}\uC758 content \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${list}`
+      message: `${r.configFile}\uC758 content \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${list}${note}`
     };
   }
   return {
     name: "tailwind.content",
     severity: "fail",
-    message: `${r.configFile}\uC758 content \uAC00 \uCEF4\uD3EC\uB10C\uD2B8 \uACBD\uB85C\uB97C \uB36E\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uD074\uB798\uC2A4\uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC74C): ${list}`
+    message: `${r.configFile}\uC758 content \uAC00 \uCEF4\uD3EC\uB10C\uD2B8 \uACBD\uB85C\uB97C \uB36E\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uD074\uB798\uC2A4\uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC74C): ${list}${note}`
   };
 }
 var ANIMATION_PLUGIN_TAILWIND3 = "tailwindcss-animate";
@@ -1656,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";
@@ -1677,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` };
@@ -1769,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, 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);
@@ -1796,12 +1987,12 @@ function nearestExisting(p) {
   return cur;
 }
 function escapeReason(root, target, options = {}) {
-  const realRoot = realpathSync(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 = realpathSync(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`;
   }
@@ -1816,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 = realpathSync(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)`;
     }
@@ -1849,8 +2040,8 @@ function isSymlink(p) {
 function outsideLinkTarget(root, target) {
   if (!isSymlink(target)) return null;
   try {
-    const realTarget = realpathSync(target);
-    return isSameOrInside(realpathSync(root), realTarget) ? null : realTarget;
+    const realTarget = realpathSync3(target);
+    return isSameOrInside(realpathSync3(root), realTarget) ? null : realTarget;
   } catch {
     return null;
   }
@@ -1867,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 = realpathSync(root);
+  const realRoot = realpathSync3(root);
   let realTarget;
   try {
-    realTarget = realpathSync(target);
+    realTarget = realpathSync3(target);
   } catch {
     return target;
   }
@@ -1904,8 +2095,8 @@ async function writeNoFollow(target, content, mode) {
   return actual;
 }
 function checkParentInside(root, target) {
-  const realRoot = realpathSync(root);
-  const realParent = realpathSync(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`;
   }
@@ -2179,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];
@@ -2199,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));
@@ -4427,7 +4617,7 @@ import path9 from "path";
 // src/tools/brand-core.ts
 import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
 import { createRequire } from "module";
-import { dirname as dirname3, join as join4, relative, resolve as resolve3, sep } from "path";
+import { dirname as dirname4, join as join4, relative as relative2, resolve as resolve3, sep as sep2 } from "path";
 var TOKENS_PACKAGE = "@axis-ds/tokens";
 var MIN_BRAND_TOKENS_VERSION = "1.3.0";
 var TOKENS_DEPENDENCY_MIN_VERSION = "1.6.0";
@@ -4457,7 +4647,7 @@ function findTokensPackageJson(baseDir) {
   for (; ; ) {
     const candidate = join4(dir, "node_modules", TOKENS_PACKAGE, "package.json");
     if (existsSync8(candidate)) return candidate;
-    const parent = dirname3(dir);
+    const parent = dirname4(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -4541,7 +4731,7 @@ function inspectBrandImport(baseDir) {
   if (!location.path) {
     return { ...base, state: "css-missing", imports: [] };
   }
-  const cssFile = relative(root, location.path).split(sep).join("/");
+  const cssFile = relative2(root, location.path).split(sep2).join("/");
   const imports = [...new Set(findBrandImports(readFileSync8(location.path, "utf8")))];
   let state;
   if (imports.includes(brand)) state = "match";
@@ -4657,7 +4847,7 @@ function findBrandActivation(baseDir) {
     const providerTexts = [];
     for (const m of text.matchAll(/from\s+["']\.\/(providers?)["']/g)) {
       for (const ext of [".tsx", ".jsx", ".ts", ".js"]) {
-        const rel2 = `${dirname3(candidate)}/${m[1]}${ext}`;
+        const rel2 = `${dirname4(candidate)}/${m[1]}${ext}`;
         const p = join4(root, rel2);
         if (isFile2(p)) providerTexts.push({ rel: rel2, text: stripJsLikeComments(readFileSync8(p, "utf8")) });
       }
@@ -4728,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) {
@@ -4741,7 +4931,7 @@ function declaredAxisPackages(pkg) {
   return out;
 }
 function checkDependencies(baseDirInput) {
-  const baseDir = resolve4(baseDirInput);
+  const baseDir = resolveBaseDir(baseDirInput);
   let pkg;
   try {
     const parsed = JSON.parse(readFileSync9(join5(baseDir, "package.json"), "utf8"));
@@ -4753,13 +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 missingRequired = REQUIRED_DEPENDENCIES.filter((d) => !hasDependency(pkg, 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));
+  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),
+    ...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => declared(d) !== void 0),
     ...declaredAxisPackages(pkg)
   ];
   const pnp = isPnpProject(baseDir);
@@ -4769,11 +4964,14 @@ function checkDependencies(baseDirInput) {
   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 (problems.length > 0) return { name: "dependencies", severity: "warn", message: problems.join(" / ") };
+  if (problems.length > 0) {
+    return { name: "dependencies", severity: "warn", message: problems.join(" / ") + (rootNote ? ` (${rootNote})` : "") };
+  }
+  const note = rootNote ? `, ${rootNote}` : "";
   return {
     name: "dependencies",
     severity: "pass",
-    message: pnp ? `\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uC120\uC5B8\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (Plug'n'Play \uB77C \uC124\uCE58\uBCF8\uC740 \uD655\uC778\uD558\uC9C0 \uC54A\uC74C, ${targets.length}\uAC1C)` : `\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uC120\uC5B8 \xB7 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (${targets.length}\uAC1C \uD655\uC778)`
+    message: pnp ? `\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uC120\uC5B8\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (Plug'n'Play \uB77C \uC124\uCE58\uBCF8\uC740 \uD655\uC778\uD558\uC9C0 \uC54A\uC74C, ${targets.length}\uAC1C${note})` : `\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uC120\uC5B8 \xB7 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (${targets.length}\uAC1C \uD655\uC778${note})`
   };
 }
 
@@ -4831,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);
@@ -4868,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) {
@@ -5075,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");
@@ -5124,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));
 }
@@ -5134,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) {
@@ -5193,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) {
@@ -5810,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: [
           {
@@ -5835,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)")
@@ -5843,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.0",
+  "version": "1.4.2",
   "type": "module",
   "description": "AXIS Design System - MCP Server for AI-assisted component discovery",
   "bin": {