@axis-ds/mcp 1.3.5 → 1.4.1

package/dist/index.js

@@ -10,61 +10,67 @@ import { z } from "zod";
 import { readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
+
+// src/types.ts
+var TOKEN_CATEGORIES = [
+  "color",
+  "typography",
+  "spacing",
+  "radius",
+  "shadow",
+  "density",
+  "component"
+];
+
+// src/registry/loader.ts
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
 var DATA_DIR = join(__dirname, "data");
-var cachedRegistry = null;
+var cachedComponents = null;
+var cachedTokens = null;
 function loadComponents() {
-  const filePath = join(DATA_DIR, "components.json");
-  const content = readFileSync(filePath, "utf-8");
-  const data = JSON.parse(content);
-  return data.components;
+  if (!cachedComponents) {
+    const filePath = join(DATA_DIR, "components.json");
+    const content = readFileSync(filePath, "utf-8");
+    const data = JSON.parse(content);
+    cachedComponents = data.components;
+  }
+  return cachedComponents;
 }
 function loadTokens() {
-  const filePath = join(DATA_DIR, "tokens.json");
-  const content = readFileSync(filePath, "utf-8");
-  const data = JSON.parse(content);
-  return data.tokens;
-}
-function getRegistry() {
-  if (!cachedRegistry) {
-    cachedRegistry = {
-      components: loadComponents(),
-      tokens: loadTokens()
-    };
+  if (!cachedTokens) {
+    const filePath = join(DATA_DIR, "tokens.json");
+    const content = readFileSync(filePath, "utf-8");
+    const data = JSON.parse(content);
+    cachedTokens = { source: data.source, tokens: data.tokens };
   }
-  return cachedRegistry;
+  return cachedTokens;
 }
 function getComponentMeta(name) {
-  const registry = getRegistry();
-  return registry.components.find(
+  return loadComponents().find(
     (c) => c.name.toLowerCase() === name.toLowerCase()
   );
 }
 function listTokens(category) {
-  const registry = getRegistry();
+  const { tokens } = loadTokens();
   if (category) {
-    return registry.tokens.filter((t) => t.category === category);
+    return tokens.filter((t) => t.category === category);
   }
-  return registry.tokens;
+  return tokens;
 }
 function getToken(path11) {
-  const registry = getRegistry();
-  return registry.tokens.find(
-    (t) => t.path.toLowerCase() === path11.toLowerCase()
+  const q = path11.trim().toLowerCase();
+  return loadTokens().tokens.find(
+    (t) => t.path.toLowerCase() === q || (t.aliases ?? []).some((a) => a.toLowerCase() === q) || t.cssVariable.toLowerCase() === q
   );
 }
+function getTokenSource() {
+  return loadTokens().source;
+}
 function getTokenStats() {
-  const registry = getRegistry();
-  const stats = {
-    color: 0,
-    typography: 0,
-    spacing: 0,
-    radius: 0,
-    shadow: 0,
-    animation: 0
-  };
-  for (const token of registry.tokens) {
+  const { tokens } = loadTokens();
+  const stats = Object.fromEntries(TOKEN_CATEGORIES.map((c) => [c, 0]));
+  for (const token of tokens) {
     stats[token.category]++;
   }
   return stats;
@@ -867,10 +873,45 @@ var RegistryClient = class {
 // ../axis-registry-core/src/project.ts
 import { existsSync as existsSync2, readFileSync as readFileSync3, 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";
+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 = path3.resolve(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;
+  }
+}
+function detectInstallCommand(baseDirInput) {
+  const baseDir = path3.resolve(baseDirInput);
+  const own = lockfileCommandAt(baseDir);
+  if (own !== void 0) return own;
+  const root = findWorkspaceRoot(baseDir);
+  if (root !== void 0 && root !== baseDir) {
+    const fromRoot = lockfileCommandAt(root);
+    if (fromRoot !== void 0) return fromRoot;
+  }
   return "pnpm install";
 }
 function hasDependency(pkg, name) {
@@ -969,8 +1010,8 @@ 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";
+import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync4, realpathSync } 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];
@@ -1052,22 +1093,17 @@ function majorFromVersion(version) {
 }
 function detectTailwind(baseDirInput, pkg) {
   const baseDir = resolve(baseDirInput);
-  const installedFile = join2(baseDir, "node_modules", "tailwindcss", "package.json");
   const declared = pkg ? hasDependency2(pkg, "tailwindcss") : void 0;
   const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
   const declaredMajor = bounds?.lower;
-  try {
-    const installed = JSON.parse(readFileSync4(installedFile, "utf8"));
-    const version = isPlainObject2(installed) ? installed.version : void 0;
-    const major = majorFromVersion(version);
-    if (major !== void 0) {
-      const found = { major, source: "installed", value: String(version) };
-      if (declared !== void 0 && bounds !== void 0 && !majorWithin(major, bounds)) {
-        found.mismatch = { declared, declaredMajor: bounds.lower };
-      }
-      return found;
+  const version = isPnpProject(baseDir) ? void 0 : findInstalledPackage(baseDir, "tailwindcss")?.version;
+  const major = majorFromVersion(version);
+  if (version !== void 0 && major !== void 0) {
+    const found = { major, source: "installed", value: version };
+    if (declared !== void 0 && bounds !== void 0 && !majorWithin(major, bounds)) {
+      found.mismatch = { declared, declaredMajor: bounds.lower };
     }
-  } catch {
+    return found;
   }
   if (declared !== void 0) {
     if (declaredMajor !== void 0) return { major: declaredMajor, source: "declared", value: declared };
@@ -1210,19 +1246,9 @@ function rangeLowerAtLeast(range, min) {
   if (!lower || !target) return void 0;
   return compareLower(lower, target) >= 0;
 }
-function exactVersion(version) {
-  if (typeof version !== "string") return void 0;
-  const v = version.trim();
-  if (!/^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(v) || /^v?0\.0\.0-/.test(v)) return void 0;
-  return v;
-}
-function installedVersion(baseDir, name) {
-  try {
-    const parsed = JSON.parse(readFileSync4(join2(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
-    return isPlainObject2(parsed) ? exactVersion(parsed.version) : void 0;
-  } catch {
-    return void 0;
-  }
+function installedAxisVersion(baseDir, name) {
+  if (isPnpProject(baseDir)) return void 0;
+  return findInstalledPackage(baseDir, name)?.version;
 }
 function axisPackagesBelowTailwind4(pkg, baseDirInput) {
   if (!pkg) return [];
@@ -1232,7 +1258,7 @@ function axisPackagesBelowTailwind4(pkg, baseDirInput) {
   for (const name of TAILWIND4_AXIS_PACKAGES) {
     const range = hasDependency2(pkg, name);
     if (range === void 0 || range.trim().startsWith("workspace:")) continue;
-    const installed = baseDir !== void 0 ? installedVersion(baseDir, name) : void 0;
+    const installed = baseDir !== void 0 ? installedAxisVersion(baseDir, name) : void 0;
     const installedLower = installed !== void 0 ? lowerOf(installed) : void 0;
     if (installed !== void 0 && installedLower !== void 0) {
       if (compareLower(installedLower, min) < 0) out.push({ name, range, status: "below", source: "installed", installed });
@@ -1528,6 +1554,92 @@ 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 [realpathSync(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, baseDir) {
+  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 === "[" ? "]" : "}";
@@ -1589,17 +1701,17 @@ function inspectTailwindContent(baseDirInput) {
   }
   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}` });
+      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) {
@@ -1614,17 +1726,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";
@@ -1778,7 +1891,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 realpathSync2, 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);
@@ -1805,12 +1918,12 @@ function nearestExisting(p) {
   return cur;
 }
 function escapeReason(root, target, options = {}) {
-  const realRoot = realpathSync(root);
+  const realRoot = realpathSync2(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 = realpathSync2(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`;
   }
@@ -1825,7 +1938,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 = realpathSync2(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)`;
     }
@@ -1858,8 +1971,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 = realpathSync2(target);
+    return isSameOrInside(realpathSync2(root), realTarget) ? null : realTarget;
   } catch {
     return null;
   }
@@ -1876,10 +1989,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 = realpathSync2(root);
   let realTarget;
   try {
-    realTarget = realpathSync(target);
+    realTarget = realpathSync2(target);
   } catch {
     return target;
   }
@@ -1913,8 +2026,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 = realpathSync2(root);
+  const realParent = realpathSync2(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`;
   }
@@ -2727,20 +2840,36 @@ function formatComponentDetail(result) {
   }
   return lines.join("\n");
 }
-function formatTokenDetail(token) {
+function cssUsage(token) {
+  const shadcnColor = !token.cssVariable.startsWith("--axis-") && token.value.startsWith("hsl(");
+  return shadcnColor ? `hsl(var(${token.cssVariable}))` : `var(${token.cssVariable})`;
+}
+function formatTokenNotFound(path11) {
+  return [
+    `\uD1A0\uD070\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: \`${path11}\``,
+    "",
+    "- \uACBD\uB85C\uB294 `axis.list_tokens` \uB85C \uD655\uC778\uD558\uC138\uC694. \uACBD\uB85C \xB7 tokens \uC774\uB984 \uAE30\uBC18 \uACBD\uB85C(\uC608: `control.h.md`) \xB7 CSS \uBCC0\uC218 \uC774\uB984(\uC608: `--axis-control-h-md`)\uC744 \uBC1B\uC2B5\uB2C8\uB2E4.",
+    "- \uBE0C\uB79C\uB4DC \uAC12\uC740 `axis.list_brands` \xB7 `axis.get_brand` \uB85C \uC870\uD68C\uD558\uC138\uC694."
+  ].join("\n");
+}
+function formatTokenDetail(token, query = "") {
   if (!token) {
-    return "\uD1A0\uD070\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.";
+    return formatTokenNotFound(query);
   }
   const lines = [];
   lines.push(`# \uD1A0\uD070: ${token.path}`);
   lines.push("");
   lines.push(`- **\uAC12**: \`${token.value}\``);
+  if (token.dark !== void 0) {
+    lines.push(`- **\uB2E4\uD06C \uAC12**: \`${token.dark}\`${token.dark === token.value ? " (\uB77C\uC774\uD2B8\uC640 \uAC19\uC74C)" : ""}`);
+  }
   lines.push(`- **\uCE74\uD14C\uACE0\uB9AC**: ${token.category}`);
   if (token.description) {
     lines.push(`- **\uC124\uBA85**: ${token.description}`);
   }
-  if (token.cssVariable) {
-    lines.push(`- **CSS \uBCC0\uC218**: \`var(${token.cssVariable})\``);
+  lines.push(`- **CSS \uBCC0\uC218**: \`${token.cssVariable}\` (\uC0AC\uC6A9: \`${cssUsage(token)}\`)`);
+  if (token.aliases && token.aliases.length > 0) {
+    lines.push(`- **\uD568\uAED8 \uBC1B\uB294 \uACBD\uB85C**: ${token.aliases.map((a) => `\`${a}\``).join(", ")}`);
   }
   return lines.join("\n");
 }
@@ -2776,7 +2905,8 @@ function handleListTokens(params) {
     tokens,
     totalCount: tokens.length,
     stats,
-    category
+    category,
+    sourceVersion: getTokenSource()?.version
   };
 }
 function formatComponentList(result) {
@@ -2821,41 +2951,51 @@ function formatComponentList(result) {
   lines.push("\uC124\uCE58: `axis.install_component` \uC5D0 `name`(\uB610\uB294 `names`)\uACFC \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8 `targetDir` \uB97C \uC8FC\uC138\uC694. \uC774\uB984\uC740 \uC704 \uD45C\uC758 \uC774\uB984 \uADF8\uB300\uB85C\uC785\uB2C8\uB2E4(agentic \uC740 `agentic-` \uC811\uB450 \uD3EC\uD568).");
   return lines.join("\n");
 }
+var TOKEN_CATEGORY_LABELS = {
+  color: "Color",
+  typography: "Typography",
+  spacing: "Spacing",
+  radius: "Radius",
+  shadow: "Shadow",
+  density: "Density (\uBC00\uB3C4)",
+  component: "Component"
+};
+var cell = (v) => v.replace(/\|/g, "\\|");
 function formatTokenList(result) {
   const lines = [];
+  const total = TOKEN_CATEGORIES.reduce((n, c) => n + result.stats[c], 0);
   lines.push("# AXIS Design System \uD1A0\uD070 \uBAA9\uB85D");
   lines.push("");
+  if (result.sourceVersion) {
+    lines.push(`- **\uCD9C\uCC98**: @axis-ds/tokens ${result.sourceVersion} \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC5D0\uC11C \uC0DD\uC131(\uB77C\uC774\uD2B8 :root \xB7 \uB2E4\uD06C .dark)`);
+  }
+  lines.push("- **\uBE0C\uB79C\uB4DC \uAC12**: `axis.list_brands` \xB7 `axis.get_brand` \uB85C \uC870\uD68C\uD558\uC138\uC694(\uB300\uC0C1 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC124\uCE58\uB41C tokens \uB97C \uC77D\uC74C)");
+  lines.push("");
   lines.push("## \uCE74\uD14C\uACE0\uB9AC\uBCC4 \uD1B5\uACC4");
   lines.push("| \uCE74\uD14C\uACE0\uB9AC | \uAC1C\uC218 |");
   lines.push("|----------|------|");
-  lines.push(`| Color | ${result.stats.color} |`);
-  lines.push(`| Typography | ${result.stats.typography} |`);
-  lines.push(`| Spacing | ${result.stats.spacing} |`);
-  lines.push(`| Radius | ${result.stats.radius} |`);
-  lines.push(`| Shadow | ${result.stats.shadow} |`);
-  lines.push(`| Animation | ${result.stats.animation} |`);
-  lines.push(`| **\uD569\uACC4** | **${result.totalCount}** |`);
+  for (const c of TOKEN_CATEGORIES) {
+    lines.push(`| ${TOKEN_CATEGORY_LABELS[c]} | ${result.stats[c]} |`);
+  }
+  lines.push(`| **\uD569\uACC4** | **${total}** |`);
   lines.push("");
   if (result.category) {
-    lines.push(`## ${result.category} \uD1A0\uD070`);
+    lines.push(`## ${result.category} \uD1A0\uD070 (${result.totalCount}\uAC1C)`);
   } else {
     lines.push("## \uC804\uCCB4 \uD1A0\uD070");
   }
   lines.push("");
-  const grouped = {};
-  for (const token of result.tokens) {
-    if (!grouped[token.category]) {
-      grouped[token.category] = [];
-    }
-    grouped[token.category].push(token);
-  }
-  for (const [category, tokens] of Object.entries(grouped)) {
-    lines.push(`### ${category.charAt(0).toUpperCase() + category.slice(1)}`);
-    lines.push("| \uACBD\uB85C | \uAC12 | \uC124\uBA85 |");
-    lines.push("|------|-----|------|");
+  for (const c of TOKEN_CATEGORIES) {
+    const tokens = result.tokens.filter((t) => t.category === c);
+    if (tokens.length === 0) continue;
+    lines.push(`### ${TOKEN_CATEGORY_LABELS[c]}`);
+    lines.push("| \uACBD\uB85C | \uAC12 | \uB2E4\uD06C | CSS | \uC124\uBA85 |");
+    lines.push("|------|-----|------|-----|------|");
     for (const t of tokens) {
-      const desc = t.description || "-";
-      lines.push(`| \`${t.path}\` | \`${t.value}\` | ${desc} |`);
+      const dark = t.dark === void 0 ? "-" : t.dark === t.value ? "(\uAC19\uC74C)" : `\`${cell(t.dark)}\``;
+      lines.push(
+        `| \`${t.path}\` | \`${cell(t.value)}\` | ${dark} | \`${cssUsage(t)}\` | ${t.description ? cell(t.description) : "-"} |`
+      );
     }
     lines.push("");
   }
@@ -4409,7 +4549,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";
@@ -4439,7 +4579,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;
   }
@@ -4523,7 +4663,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";
@@ -4639,7 +4779,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")) });
       }
@@ -4722,6 +4862,16 @@ 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);
   let pkg;
@@ -4735,13 +4885,17 @@ 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);
+  const fromRoot = (d) => !hasDependency(pkg, d) && rootPkg !== void 0 && Boolean(hasDependency(rootPkg, d));
+  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => !hasDependency(pkg, d) && !fromRoot(d));
   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) => !hasDependency(pkg, d) && !fromRoot(d));
+  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) => hasDependency(pkg, d) !== void 0 || fromRoot(d)),
     ...declaredAxisPackages(pkg)
   ];
   const pnp = isPnpProject(baseDir);
@@ -4751,11 +4905,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})`
   };
 }
 
@@ -5233,7 +5390,7 @@ var server = new McpServer({
   version: SERVER_VERSION
 });
 var ComponentCategorySchema = z.enum(["core", "agentic", "form", "layout", "ui"]).optional().describe("\uCEF4\uD3EC\uB10C\uD2B8 \uCE74\uD14C\uACE0\uB9AC \uD544\uD130 (ui = Core UI \uC804\uCCB4, agentic = Agentic UI)");
-var TokenCategorySchema = z.enum(["color", "typography", "spacing", "radius", "shadow", "animation"]).optional().describe("\uD1A0\uD070 \uCE74\uD14C\uACE0\uB9AC \uD544\uD130");
+var TokenCategorySchema = z.enum(TOKEN_CATEGORIES).optional().describe("\uD1A0\uD070 \uCE74\uD14C\uACE0\uB9AC \uD544\uD130 (density = \uCEE8\uD2B8\uB864 \uB192\uC774 \xB7 \uAE00\uC790 \uD06C\uAE30 \uB4F1 \uBC00\uB3C4 \uD1A0\uD070, component = \uCEF4\uD3EC\uB10C\uD2B8 \uD1A0\uD070)");
 server.tool(
   "axis.search_components",
   "AXIS \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C\uC5D0\uC11C \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uAC80\uC0C9\uD569\uB2C8\uB2E4.",
@@ -5338,7 +5495,7 @@ server.tool(
 );
 server.tool(
   "axis.list_tokens",
-  "AXIS \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C\uC758 \uB514\uC790\uC778 \uD1A0\uD070 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4.",
+  "AXIS \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C\uC758 \uB514\uC790\uC778 \uD1A0\uD070 \uBAA9\uB85D(\uB77C\uC774\uD2B8 \xB7 \uB2E4\uD06C \uAC12, CSS \uBCC0\uC218)\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4. \uAC12\uC740 @axis-ds/tokens \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC5D0\uC11C \uC0DD\uC131\uD569\uB2C8\uB2E4.",
   {
     category: TokenCategorySchema
   },
@@ -5372,21 +5529,23 @@ server.tool(
 );
 server.tool(
   "axis.get_token",
-  "AXIS \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C \uD1A0\uD070\uC758 \uC0C1\uC138 \uC815\uBCF4\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4.",
+  "AXIS \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C \uD1A0\uD070\uC758 \uC0C1\uC138 \uC815\uBCF4(\uB77C\uC774\uD2B8 \xB7 \uB2E4\uD06C \uAC12, CSS \uBCC0\uC218)\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4. \uC5C6\uB294 \uACBD\uB85C\uB294 isError \uB85C \uB2F5\uD569\uB2C8\uB2E4.",
   {
-    path: z.string().describe("\uD1A0\uD070 \uACBD\uB85C (\uC608: colors.primary, spacing.4)")
+    path: z.string().describe("\uD1A0\uD070 \uACBD\uB85C (\uC608: colors.primary, spacing.4, control.h.md) \uB610\uB294 CSS \uBCC0\uC218 \uC774\uB984 (\uC608: --axis-control-h-md)")
   },
   async ({ path: path11 }) => {
     try {
       const token = handleGetToken({ path: path11 });
-      const formatted = formatTokenDetail(token);
+      const formatted = formatTokenDetail(token, path11);
       return {
         content: [
           {
             type: "text",
             text: formatted
           }
-        ]
+        ],
+        // WI-0076: 없는 토큰은 일반 텍스트가 아니라 오류로 답합니다(응답 계약 변경)
+        ...token ? {} : { isError: true }
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958";