@axis-ds/cli 1.4.0 → 1.5.0

package/dist/index.js

@@ -15,12 +15,8 @@ import {
 
 // src/index.ts
 import { Command } from "commander";
-import chalk11 from "chalk";
-import ora6 from "ora";
-import fs11 from "fs-extra";
-import path12 from "path";
+import chalk12 from "chalk";
 import { createRequire as createRequire2 } from "module";
-import prompts3 from "prompts";
 
 // src/library/base-collector.ts
 import crypto from "crypto";
@@ -484,11 +480,11 @@ var ShadcnCollector = class extends BaseCollector {
   /**
    * 파일 타입 추론
    */
-  getFileType(path13) {
-    if (path13.includes("hook") || path13.startsWith("use")) return "hook";
-    if (path13.includes("util") || path13.includes("lib")) return "util";
-    if (path13.endsWith(".css")) return "style";
-    if (path13.endsWith(".d.ts") || path13.includes("types")) return "type";
+  getFileType(path16) {
+    if (path16.includes("hook") || path16.startsWith("use")) return "hook";
+    if (path16.includes("util") || path16.includes("lib")) return "util";
+    if (path16.endsWith(".css")) return "style";
+    if (path16.endsWith(".d.ts") || path16.includes("types")) return "type";
     return "component";
   }
 };
@@ -1505,7 +1501,7 @@ import ora5 from "ora";
 
 // src/template/template-apply.ts
 import fs7 from "fs-extra";
-import path6 from "path";
+import path7 from "path";
 import chalk4 from "chalk";
 import ora3 from "ora";
 import prompts from "prompts";
@@ -1574,12 +1570,14 @@ function deepMerge(target, source) {
 
 // src/config/axis-config.ts
 import fs6 from "fs-extra";
+import path6 from "path";
 var AXIS_CONFIG_SCHEMA_URL = "https://axis.minu.best/schema.json";
 var AXIS_CONFIG_FILE = "axis.config.json";
 function createInitConfig(answers, registry) {
   return {
     $schema: AXIS_CONFIG_SCHEMA_URL,
     componentsDir: answers.componentsDir,
+    ...answers.agenticDir !== void 0 ? { agenticDir: answers.agenticDir } : {},
     ...answers.tailwindConfig !== void 0 ? { tailwindConfig: answers.tailwindConfig } : {},
     globalCss: answers.globalCss,
     registry
@@ -1594,6 +1592,11 @@ function createTemplateConfig(template) {
     globalCss: "./globals.css"
   };
 }
+async function readAxisConfig(baseDir) {
+  const configPath = path6.join(baseDir, AXIS_CONFIG_FILE);
+  if (!await fs6.pathExists(configPath)) return null;
+  return await fs6.readJSON(configPath);
+}
 
 // src/template/template-apply.ts
 async function applyTemplate(slug, options) {
@@ -1606,10 +1609,10 @@ async function applyTemplate(slug, options) {
     spinner.fail(err.message);
     process.exit(1);
   }
-  const baseDir = path6.resolve(options.dir || ".");
+  const baseDir = path7.resolve(options.dir || ".");
   const conflicts = [];
   for (const file of detail.files) {
-    const dest = path6.join(baseDir, file.path);
+    const dest = path7.join(baseDir, file.path);
     if (await fs7.pathExists(dest)) {
       conflicts.push(file.path);
     }
@@ -1634,7 +1637,7 @@ async function applyTemplate(slug, options) {
   if (options.dryRun) {
     console.log(chalk4.blue("\n[\uBBF8\uB9AC\uBCF4\uAE30] \uC0DD\uC131\uB420 \uD30C\uC77C:"));
     for (const file of detail.files) {
-      const dest = path6.join(baseDir, file.path);
+      const dest = path7.join(baseDir, file.path);
       const exists = conflicts.includes(file.path);
       const label = exists ? chalk4.yellow("\uB36E\uC5B4\uC4F0\uAE30") : chalk4.green("\uC0DD\uC131");
       console.log(`  ${label} ${dest}`);
@@ -1649,8 +1652,8 @@ async function applyTemplate(slug, options) {
   }
   const writeSpinner = ora3("\uD30C\uC77C \uC0DD\uC131 \uC911...").start();
   for (const file of detail.files) {
-    const dest = path6.join(baseDir, file.path);
-    await fs7.ensureDir(path6.dirname(dest));
+    const dest = path7.join(baseDir, file.path);
+    await fs7.ensureDir(path7.dirname(dest));
     await fs7.writeFile(dest, file.content);
   }
   writeSpinner.succeed(`${detail.files.length}\uAC1C \uD30C\uC77C \uC0DD\uC131 \uC644\uB8CC`);
@@ -1711,7 +1714,7 @@ async function initTemplate(slug, options) {
     }
     targetDir = dir;
   }
-  const resolved = path6.resolve(targetDir);
+  const resolved = path7.resolve(targetDir);
   if (await fs7.pathExists(resolved)) {
     const entries = await fs7.readdir(resolved);
     if (entries.length > 0) {
@@ -1727,7 +1730,7 @@ async function initTemplate(slug, options) {
     await fs7.ensureDir(resolved);
   }
   await applyTemplate(selectedSlug, { dir: targetDir, yes: true });
-  const configPath = path6.join(resolved, "axis.config.json");
+  const configPath = path7.join(resolved, "axis.config.json");
   if (!await fs7.pathExists(configPath)) {
     const axisConfig = createTemplateConfig(selectedSlug);
     await fs7.writeJSON(configPath, axisConfig, { spaces: 2 });
@@ -1742,7 +1745,7 @@ async function initTemplate(slug, options) {
 
 // src/template/template-diff.ts
 import fs8 from "fs-extra";
-import path7 from "path";
+import path8 from "path";
 import chalk5 from "chalk";
 import ora4 from "ora";
 async function diffTemplate(slug, options) {
@@ -1755,10 +1758,10 @@ async function diffTemplate(slug, options) {
     spinner.fail(err.message);
     process.exit(1);
   }
-  const baseDir = path7.resolve(options.dir || ".");
+  const baseDir = path8.resolve(options.dir || ".");
   const entries = [];
   for (const file of detail.files) {
-    const localPath = path7.join(baseDir, file.path);
+    const localPath = path8.join(baseDir, file.path);
     if (!await fs8.pathExists(localPath)) {
       entries.push({ path: file.path, status: "added" });
       continue;
@@ -1839,12 +1842,12 @@ async function collectLocalFiles(dir, base) {
   }
   for (const entry of entries) {
     if (ignore.has(entry.name)) continue;
-    const fullPath = path7.join(dir, entry.name);
+    const fullPath = path8.join(dir, entry.name);
     if (entry.isDirectory()) {
       const nested = await collectLocalFiles(fullPath, root);
       results.push(...nested);
     } else {
-      results.push(path7.relative(root, fullPath).replace(/\\/g, "/"));
+      results.push(path8.relative(root, fullPath).replace(/\\/g, "/"));
     }
   }
   return results;
@@ -1852,7 +1855,7 @@ async function collectLocalFiles(dir, base) {
 
 // src/template/template-check.ts
 import fs9 from "fs-extra";
-import path8 from "path";
+import path9 from "path";
 import chalk6 from "chalk";
 
 // src/theme/brand-core.ts
@@ -2520,9 +2523,9 @@ function checkTailwindSetup(baseDirInput) {
     return { name: "tailwind.config", severity: "warn", message: "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
   }
   for (const file of otherFiles) {
-    const path13 = join2(baseDir, file);
-    if (existsSync2(path13)) {
-      if (hasTokensPresetReference(readFileSync2(path13, "utf8"))) {
+    const path16 = join2(baseDir, file);
+    if (existsSync2(path16)) {
+      if (hasTokensPresetReference(readFileSync2(path16, "utf8"))) {
         return { name: "tailwind.config", severity: "pass", message: `${file}${PRESET_PASS_SUFFIX}` };
       }
       return { name: "tailwind.config", severity: "warn", message: `${file} \uC874\uC7AC (TypeScript \uAD8C\uC7A5)` };
@@ -2538,7 +2541,7 @@ var SEVERITY_ICON = {
   fail: chalk6.red("FAIL")
 };
 async function collectCheckResults(dir) {
-  const baseDir = path8.resolve(dir || ".");
+  const baseDir = path9.resolve(dir || ".");
   const results = [];
   results.push(await checkFileExists(baseDir, "axis.config.json", "axis.config.json"));
   results.push(checkTailwindSetup(baseDir));
@@ -2583,7 +2586,7 @@ async function runCheck(dir) {
   return { pass: passCount, warn: warnCount, fail: failCount };
 }
 async function checkFileExists(baseDir, fileName, label) {
-  const exists = await fs9.pathExists(path8.join(baseDir, fileName));
+  const exists = await fs9.pathExists(path9.join(baseDir, fileName));
   return {
     name: label,
     severity: exists ? "pass" : "fail",
@@ -2599,7 +2602,7 @@ async function checkUtils(baseDir) {
     "utils.ts"
   ];
   for (const candidate of candidates) {
-    const fullPath = path8.join(baseDir, candidate);
+    const fullPath = path9.join(baseDir, candidate);
     if (await fs9.pathExists(fullPath)) {
       const content = await fs9.readFile(fullPath, "utf-8");
       const hasCn = content.includes("function cn");
@@ -2617,7 +2620,7 @@ async function checkUtils(baseDir) {
   };
 }
 async function checkDependencies(baseDir) {
-  const pkgPath = path8.join(baseDir, "package.json");
+  const pkgPath = path9.join(baseDir, "package.json");
   if (!await fs9.pathExists(pkgPath)) {
     return {
       name: "package.json",
@@ -2791,11 +2794,11 @@ function registerCheckCommand(program2) {
 
 // src/theme/index.ts
 import chalk8 from "chalk";
-import path10 from "path";
+import path11 from "path";
 
 // src/theme/theme-add.ts
 import { accessSync, constants, existsSync as existsSync3, readFileSync as readFileSync3, realpathSync, unlinkSync, writeFileSync } from "fs";
-import path9 from "path";
+import path10 from "path";
 var TOKENS_DEPENDENCY_RANGE = `^${MIN_BRAND_TOKENS_VERSION}`;
 var THEME_PACKAGE = "@axis-ds/theme";
 function readText(file) {
@@ -2867,17 +2870,17 @@ function compareVersions(a, b) {
 function realPathInside(baseDir, file) {
   const realBase = realpathSync(baseDir);
   const realPath = realpathSync(file);
-  const relPath = path9.relative(realBase, realPath);
-  const inside = relPath !== "" && !relPath.startsWith("..") && !path9.isAbsolute(relPath);
+  const relPath = path10.relative(realBase, realPath);
+  const inside = relPath !== "" && !relPath.startsWith("..") && !path10.isAbsolute(relPath);
   return { inside, realPath };
 }
 function isStylesheet(realPath) {
-  return path9.extname(realPath).toLowerCase() === ".css";
+  return path10.extname(realPath).toLowerCase() === ".css";
 }
 function detectInstallCommand(baseDir) {
-  if (existsSync3(path9.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
-  if (existsSync3(path9.join(baseDir, "yarn.lock"))) return "yarn install";
-  if (existsSync3(path9.join(baseDir, "package-lock.json"))) return "npm install";
+  if (existsSync3(path10.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
+  if (existsSync3(path10.join(baseDir, "yarn.lock"))) return "yarn install";
+  if (existsSync3(path10.join(baseDir, "package-lock.json"))) return "npm install";
   return "pnpm install";
 }
 function hasDependency2(pkg, name) {
@@ -2893,7 +2896,7 @@ function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function planThemeAdd(baseDirInput, brand) {
-  const baseDir = path9.resolve(baseDirInput);
+  const baseDir = path10.resolve(baseDirInput);
   const plan = {
     baseDir,
     brand,
@@ -2905,7 +2908,7 @@ function planThemeAdd(baseDirInput, brand) {
     installCommand: detectInstallCommand(baseDir),
     writes: []
   };
-  const configFile = path9.join(baseDir, AXIS_CONFIG_FILE);
+  const configFile = path10.join(baseDir, AXIS_CONFIG_FILE);
   const configText = readText(configFile);
   if (configText === null) {
     plan.errors.push({ kind: "no-config" });
@@ -2971,7 +2974,7 @@ function planThemeAdd(baseDirInput, brand) {
   } else {
     plan.css = { configuredMissing: location.configuredMissing, action: "manual", otherBrands: [] };
   }
-  const pkgFile = path9.join(baseDir, "package.json");
+  const pkgFile = path10.join(baseDir, "package.json");
   const pkgText = readText(pkgFile);
   const installed = plan.tokens.version;
   const upgrade = installed !== void 0 && (compareVersions(installed, MIN_BRAND_TOKENS_VERSION) ?? 0) < 0;
@@ -3031,8 +3034,8 @@ function applyThemeAdd(plan) {
     if (current !== w.before) {
       throw new Error(`${w.file} \uC774 \uACC4\uD68D \uB4A4\uC5D0 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.`);
     }
-    const where = realPathInside(plan.baseDir, w.before === null ? path9.dirname(w.file) : w.file);
-    if (!where.inside && !(w.before === null && path9.dirname(w.file) === plan.baseDir)) {
+    const where = realPathInside(plan.baseDir, w.before === null ? path10.dirname(w.file) : w.file);
+    if (!where.inside && !(w.before === null && path10.dirname(w.file) === plan.baseDir)) {
       throw new Error(`${w.file} \uC758 \uC2E4\uC81C \uC704\uCE58(${where.realPath})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4. \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
     }
     if (!w.file.endsWith(".json") && !isStylesheet(where.realPath)) {
@@ -3044,7 +3047,7 @@ function applyThemeAdd(plan) {
       throw new Error(`${w.file}: \uBE0C\uB79C\uB4DC import \uAC00 \uC815\uD655\uD788 1\uC904\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
     }
     try {
-      accessSync(w.before === null ? path9.dirname(w.file) : w.file, constants.W_OK);
+      accessSync(w.before === null ? path10.dirname(w.file) : w.file, constants.W_OK);
     } catch (err) {
       throw new Error(`${w.file} \uC5D0 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errorMessage(err)}).`);
     }
@@ -3195,7 +3198,7 @@ function renderThemeInfo(result, name) {
   return { lines, exitCode: 0 };
 }
 function rel(plan, file) {
-  return path10.relative(plan.baseDir, file) || file;
+  return path11.relative(plan.baseDir, file) || file;
 }
 function renderThemeAdd(plan, written) {
   const error = plan.errors[0];
@@ -3345,15 +3348,15 @@ function print(output) {
 function registerThemeCommand(program2) {
   const themeCmd = program2.command("theme").description("\uBE0C\uB79C\uB4DC \uD14C\uB9C8 (@axis-ds/tokens \uBE0C\uB79C\uB4DC)");
   themeCmd.command("list").alias("ls").description("\uC124\uCE58\uB41C @axis-ds/tokens \uC758 \uBE0C\uB79C\uB4DC \uBAA9\uB85D").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action((options) => {
-    const baseDir = path10.resolve(options.dir || ".");
+    const baseDir = path11.resolve(options.dir || ".");
     print(renderThemeList(listBrands(baseDir)));
   });
   themeCmd.command("info <brand>").description("\uBE0C\uB79C\uB4DC \uC0C1\uC138: import \uACBD\uB85C \xB7 Provider \uC608\uC2DC \xB7 \uC8FC\uC694 \uD1A0\uD070 \xB7 \uBCF4\uC815 \uB0B4\uC5ED").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action((name, options) => {
-    const baseDir = path10.resolve(options.dir || ".");
+    const baseDir = path11.resolve(options.dir || ".");
     print(renderThemeInfo(getBrand(baseDir, name), name));
   });
   themeCmd.command("add <brand>").description("\uBE0C\uB79C\uB4DC \uC801\uC6A9: CSS import \xB7 package.json \uC758\uC874\uC131 \xB7 axis.config.json brand (\uC124\uCE58\uB294 \uC548\uB0B4\uB9CC)").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action((name, options) => {
-    const baseDir = path10.resolve(options.dir || ".");
+    const baseDir = path11.resolve(options.dir || ".");
     const plan = planThemeAdd(baseDir, name);
     let written = [];
     if (plan.errors.length === 0) {
@@ -3372,11 +3375,461 @@ function registerThemeCommand(program2) {
 import chalk10 from "chalk";
 import prompts2 from "prompts";
 
+// src/registry/schema.ts
+import { createHash } from "crypto";
+var REGISTRY_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var REGISTRY_NAME_MAX_LENGTH = 64;
+function isValidRegistryName(name) {
+  return typeof name === "string" && name.length > 0 && name.length <= REGISTRY_NAME_MAX_LENGTH && REGISTRY_NAME_PATTERN.test(name);
+}
+var REGISTRY_PUBLIC_BASE_URL = "https://axis-design-system.pages.dev/r";
+function redactRegistryUrl(raw) {
+  return maskQueryAndHash(redactUserinfo(raw));
+}
+function maskQueryAndHash(value) {
+  const hashAt = value.indexOf("#");
+  let head = hashAt >= 0 ? value.slice(0, hashAt) : value;
+  const queryAt = head.indexOf("?");
+  if (queryAt >= 0) head = `${head.slice(0, queryAt)}?***`;
+  return hashAt >= 0 ? `${head}#***` : head;
+}
+function redactUserinfo(raw) {
+  let parsed = null;
+  try {
+    parsed = new URL(raw);
+  } catch {
+    parsed = null;
+  }
+  if (parsed && (parsed.username || parsed.password)) {
+    parsed.username = "";
+    parsed.password = "";
+    const href = parsed.href;
+    const scheme = `${parsed.protocol}//`;
+    return href.startsWith(scheme) ? `${scheme}***@${href.slice(scheme.length)}` : `***@${href}`;
+  }
+  const authPrefix = /^\s*[A-Za-z][A-Za-z0-9+.-]*:[/\\]*/.exec(raw)?.[0] ?? "";
+  const authority = raw.slice(authPrefix.length).split(/[/\\]/)[0];
+  const authorityAt = authority.lastIndexOf("@");
+  if (authPrefix && authorityAt >= 0) return `${authPrefix}***${raw.slice(authPrefix.length + authorityAt)}`;
+  if (parsed && (parsed.protocol === "http:" || parsed.protocol === "https:")) return raw;
+  const at = raw.lastIndexOf("@");
+  if (at < 0) return raw;
+  const prefix = /^\s*[A-Za-z][A-Za-z0-9+.-]*:[/\\]*/.exec(raw)?.[0] ?? "";
+  if (prefix.length > at) return raw;
+  return `${prefix}***${raw.slice(at)}`;
+}
+var DEFAULT_DEPENDENCY_BASES = [REGISTRY_PUBLIC_BASE_URL];
+function trimBase(base) {
+  return base.replace(/\/+$/, "");
+}
+function registryDependencyName(dep, allowedBases = DEFAULT_DEPENDENCY_BASES) {
+  if (REGISTRY_NAME_PATTERN.test(dep) && dep.length <= REGISTRY_NAME_MAX_LENGTH) return dep;
+  if (/\s/.test(dep) || dep.includes("?") || dep.includes("#")) return null;
+  let url;
+  try {
+    url = new URL(dep);
+  } catch {
+    return null;
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+  if (url.username || url.password || url.search || url.hash) return null;
+  for (const raw of allowedBases) {
+    const prefix = `${trimBase(raw)}/`;
+    if (!dep.startsWith(prefix) || !dep.endsWith(".json")) continue;
+    const name = dep.slice(prefix.length, -".json".length);
+    if (isValidRegistryName(name)) return name;
+  }
+  return null;
+}
+function registryDependencyArray(obj, where, allowedBases) {
+  const names = [];
+  for (const dep of stringArray(obj, "registryDependencies", where)) {
+    const name = registryDependencyName(dep, allowedBases);
+    if (name === null) {
+      throw new Error(
+        `${where}: registryDependencies \uC758 ${JSON.stringify(redactRegistryUrl(dep).slice(0, 120))} \uB294 \uD56D\uBAA9 \uC774\uB984\uC774\uB098 <\uB808\uC9C0\uC2A4\uD2B8\uB9AC base>/<\uC774\uB984>.json \uD615\uD0DC\uAC00 \uC544\uB2D9\uB2C8\uB2E4(\uBC1B\uB294 base: ${allowedBases.map(trimBase).join(", ")})`
+      );
+    }
+    if (!names.includes(name)) names.push(name);
+  }
+  return names;
+}
+function parseJsonText(text, where) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    const head = text.slice(0, 40).replace(/\s+/g, " ").trim();
+    throw new Error(`${where}: JSON \uC774 \uC544\uB2D9\uB2C8\uB2E4(\uC55E\uBD80\uBD84: ${JSON.stringify(head)})`);
+  }
+}
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function optionalString(obj, key, where) {
+  const v = obj[key];
+  if (v === void 0) return void 0;
+  if (typeof v !== "string") throw new Error(`${where}: ${key} \uAC00 \uBB38\uC790\uC5F4\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+  return v;
+}
+function stringArray(obj, key, where) {
+  const v = obj[key];
+  if (v === void 0) return [];
+  if (!Array.isArray(v) || v.some((s) => typeof s !== "string" || s.length === 0)) {
+    throw new Error(`${where}: ${key} \uB294 \uBE44\uC5B4 \uC788\uC9C0 \uC54A\uC740 \uBB38\uC790\uC5F4 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4`);
+  }
+  return v;
+}
+var DEPENDENCY_SPEC_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*(?:@[0-9A-Za-z.^~<>=*+| -]+)?$/;
+function dependencyArray(obj, key, where) {
+  const list = stringArray(obj, key, where);
+  const bad = list.find((s) => s.length > 214 || !DEPENDENCY_SPEC_PATTERN.test(s));
+  if (bad !== void 0) {
+    throw new Error(`${where}: ${key} \uC5D0 \uD328\uD0A4\uC9C0 \uC774\uB984 \uADDC\uCE59\uC5D0 \uB9DE\uC9C0 \uC54A\uB294 \uAC12\uC774 \uC788\uC2B5\uB2C8\uB2E4(${JSON.stringify(bad.slice(0, 60))})`);
+  }
+  return list;
+}
+function requireType(obj, where) {
+  const type = obj.type;
+  if (typeof type !== "string" || !type.startsWith("registry:")) {
+    throw new Error(`${where}: type \uC774 registry:* \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+  }
+  return type;
+}
+function validateRegistryIndex(data, where = "index.json") {
+  if (!isRecord(data)) throw new Error(`${where}: \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4`);
+  const version = data.version;
+  if (typeof version !== "string" || version.length === 0) {
+    throw new Error(`${where}: version \uC774 \uC5C6\uC2B5\uB2C8\uB2E4`);
+  }
+  if (!Array.isArray(data.items)) throw new Error(`${where}: items \uAC00 \uBC30\uC5F4\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+  const seen = /* @__PURE__ */ new Set();
+  const items = data.items.map((raw, i) => {
+    const at = `${where} items[${i}]`;
+    if (!isRecord(raw)) throw new Error(`${at}: \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4`);
+    if (!isValidRegistryName(raw.name)) throw new Error(`${at}: name \uC774 slug \uADDC\uCE59\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
+    if (seen.has(raw.name)) throw new Error(`${at}: name '${raw.name}' \uAC00 \uC911\uBCF5\uC785\uB2C8\uB2E4`);
+    seen.add(raw.name);
+    const sha256 = optionalString(raw, "sha256", at);
+    if (sha256 !== void 0 && !/^[0-9a-f]{64}$/.test(sha256)) {
+      throw new Error(`${at}: sha256 \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+    }
+    return {
+      name: raw.name,
+      type: requireType(raw, at),
+      title: optionalString(raw, "title", at),
+      description: optionalString(raw, "description", at),
+      ...sha256 !== void 0 ? { sha256 } : {}
+    };
+  });
+  return {
+    name: optionalString(data, "name", where),
+    homepage: optionalString(data, "homepage", where),
+    version,
+    items
+  };
+}
+function validateRegistryItem(data, expectedName, where = `${expectedName}.json`, dependencyBases = DEFAULT_DEPENDENCY_BASES) {
+  if (!isRecord(data)) throw new Error(`${where}: \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4`);
+  if (data.name !== expectedName) {
+    throw new Error(`${where}: name \uC774 '${expectedName}' \uAC00 \uC544\uB2D9\uB2C8\uB2E4(${JSON.stringify(data.name)})`);
+  }
+  const type = requireType(data, where);
+  if (!Array.isArray(data.files) || data.files.length === 0) {
+    throw new Error(`${where}: files \uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4`);
+  }
+  const files = data.files.map((raw, i) => {
+    const at = `${where} files[${i}]`;
+    if (!isRecord(raw)) throw new Error(`${at}: \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4`);
+    if (typeof raw.path !== "string" || raw.path.length === 0 || raw.path.includes("\0")) {
+      throw new Error(`${at}: path \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`);
+    }
+    if (typeof raw.content !== "string") throw new Error(`${at}: content \uAC00 \uBB38\uC790\uC5F4\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+    const fileType = optionalString(raw, "type", at);
+    const target = optionalString(raw, "target", at);
+    return {
+      path: raw.path,
+      content: raw.content,
+      ...fileType !== void 0 ? { type: fileType } : {},
+      ...target !== void 0 ? { target } : {}
+    };
+  });
+  return {
+    name: expectedName,
+    type,
+    title: optionalString(data, "title", where),
+    description: optionalString(data, "description", where),
+    dependencies: dependencyArray(data, "dependencies", where),
+    devDependencies: dependencyArray(data, "devDependencies", where),
+    // URL 형태는 이름으로 바꿔 둡니다. 호출한 쪽(add 의 collectItems)은 이름만 봅니다
+    registryDependencies: registryDependencyArray(data, where, dependencyBases),
+    files
+  };
+}
+function sha256Hex(text) {
+  return createHash("sha256").update(text, "utf8").digest("hex");
+}
+function checkItemSha256(item, entry, where = `${item.name}.json`) {
+  if (entry.sha256 === void 0) return;
+  if (item.files.length !== 1) {
+    throw new Error(`${where}: index.json \uC5D0 sha256 \uC774 \uC788\uB294\uB370 files \uAC00 ${item.files.length}\uAC1C\uB77C sha256 \uC744 \uB300\uC870\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4`);
+  }
+  const actual = sha256Hex(item.files[0].content);
+  if (actual !== entry.sha256) {
+    throw new Error(`${where}: content sha256 \uC774 index.json \uACFC \uB2E4\uB985\uB2C8\uB2E4`);
+  }
+}
+
+// src/registry/remote.ts
+var DEFAULT_REGISTRY_URL = REGISTRY_PUBLIC_BASE_URL;
+var DEFAULT_REGISTRY_TIMEOUT_MS = 5e3;
+var LEGACY_DEFAULT_REGISTRY_URL = "https://axis.minu.best/r";
+var LEGACY_REGISTRY_NOTICE = `axis.config.json \uC758 registry \uAC00 \uC885\uC804 \uAE30\uBCF8 \uC8FC\uC18C(${LEGACY_DEFAULT_REGISTRY_URL})\uB77C \uC0C8 \uAE30\uBCF8 \uC8FC\uC18C(${REGISTRY_PUBLIC_BASE_URL})\uB85C \uC870\uD68C\uD574\uC694. axis.config.json \uC758 registry \uB97C \uACE0\uCE58\uBA74 \uC774 \uC548\uB0B4\uAC00 \uC0AC\uB77C\uC838\uC694`;
+function isLegacyDefaultRegistryUrl(value) {
+  let normalized;
+  try {
+    normalized = normalizeRegistryBaseUrl(value.trim());
+  } catch {
+    return false;
+  }
+  return normalized === LEGACY_DEFAULT_REGISTRY_URL;
+}
+function resolveRegistryUrl(options) {
+  const env = options.env ?? process.env;
+  const fromEnv = env.AXIS_REGISTRY_URL?.trim();
+  if (fromEnv) return { url: fromEnv, source: "env" };
+  const fromConfig = typeof options.config?.registry === "string" ? options.config.registry.trim() : "";
+  if (fromConfig) {
+    if (isLegacyDefaultRegistryUrl(fromConfig)) {
+      return { url: DEFAULT_REGISTRY_URL, source: "config", migratedFrom: fromConfig };
+    }
+    return { url: fromConfig, source: "config" };
+  }
+  return { url: DEFAULT_REGISTRY_URL, source: "default" };
+}
+function normalizeRegistryBaseUrl(raw) {
+  const shown = redactRegistryUrl(raw);
+  if (/\s/.test(raw)) throw new Error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC5D0 \uACF5\uBC31\uC744 \uB458 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${JSON.stringify(shown)}`);
+  if (raw.includes("?") || raw.includes("#")) throw new Error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC5D0 \uCFFC\uB9AC \xB7 \uD574\uC2DC\uB97C \uB458 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${shown}`);
+  let parsed;
+  try {
+    parsed = new URL(raw);
+  } catch {
+    throw new Error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4: ${shown}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC740 http \xB7 https \uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4: ${shown}`);
+  }
+  if (parsed.username || parsed.password) {
+    throw new Error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC5D0 \uC0AC\uC6A9\uC790 \uC815\uBCF4(userinfo)\uB97C \uB458 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${shown}`);
+  }
+  if (parsed.search || parsed.hash) throw new Error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC5D0 \uCFFC\uB9AC \xB7 \uD574\uC2DC\uB97C \uB458 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${shown}`);
+  return `${parsed.protocol}//${parsed.host}${parsed.pathname.replace(/\/+$/, "")}`;
+}
+var RegistryAccessError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "RegistryAccessError";
+  }
+};
+async function fetchRegistryJson(url, options = {}) {
+  const timeoutMs = options.timeoutMs ?? DEFAULT_REGISTRY_TIMEOUT_MS;
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+  if (!fetchImpl) throw new RegistryAccessError("\uC774 Node \uB7F0\uD0C0\uC784\uC5D0\uB294 fetch \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(Node 18 \uC774\uC0C1 \uD544\uC694)");
+  const shown = redactRegistryUrl(url);
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const describe = (error) => {
+    if (controller.signal.aborted) return new RegistryAccessError(`${shown}: ${timeoutMs}ms \uC548\uC5D0 \uC751\uB2F5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4`);
+    const cause = error?.cause;
+    const detail = cause?.code ?? cause?.message ?? (error instanceof Error ? error.message : String(error));
+    return new RegistryAccessError(`${shown}: \uC694\uCCAD \uC2E4\uD328(${detail})`);
+  };
+  let text;
+  try {
+    let res;
+    try {
+      res = await fetchImpl(url, { signal: controller.signal, headers: { accept: "application/json" } });
+    } catch (error) {
+      throw describe(error);
+    }
+    if (!res.ok) {
+      await res.text().catch(() => void 0);
+      throw new RegistryAccessError(`${shown}: HTTP ${res.status}`);
+    }
+    try {
+      text = await res.text();
+    } catch (error) {
+      throw describe(error);
+    }
+  } finally {
+    clearTimeout(timer);
+  }
+  return parseJsonText(text, shown);
+}
+
 // src/init/init.ts
-import { accessSync as accessSync2, constants as constants2, existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
-import path11 from "path";
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync5, lstatSync as lstatSync2, readFileSync as readFileSync4, realpathSync as realpathSync3, statSync as statSync3, writeFileSync as writeFileSync2 } from "fs";
+import path13 from "path";
 import chalk9 from "chalk";
+import fs11 from "fs-extra";
+
+// src/add/safe-write.ts
+import { constants as fsConstants, existsSync as existsSync4, lstatSync, realpathSync as realpathSync2, statSync as statSync2 } from "fs";
+import path12 from "path";
 import fs10 from "fs-extra";
+var NEW_FILE_FLAGS = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
+var OVERWRITE_FLAGS = fsConstants.O_WRONLY | (fsConstants.O_NOFOLLOW ?? 0);
+var HARDLINK_ERROR_CODE = "EAXISHARDLINK";
+var NOT_REGULAR_ERROR_CODE = "EAXISNOTREG";
+function codedError(code, message) {
+  const e = new Error(message);
+  e.code = code;
+  return e;
+}
+function isSameOrInside(parent, child, impl = path12) {
+  const rel3 = impl.relative(parent, child);
+  if (rel3 === "") return true;
+  return !(rel3 === ".." || rel3.startsWith(`..${impl.sep}`) || impl.isAbsolute(rel3));
+}
+function nearestExisting(p) {
+  let cur = p;
+  while (!existsSync4(cur)) {
+    const up = path12.dirname(cur);
+    if (up === cur) return cur;
+    cur = up;
+  }
+  return cur;
+}
+function escapeReason(root, target, options = {}) {
+  const realRoot = realpathSync2(root);
+  if (!isSameOrInside(path12.resolve(root), path12.resolve(target)) || path12.resolve(target) === path12.resolve(root)) {
+    return `\uACBD\uB85C\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4(${target})`;
+  }
+  const anchor = nearestExisting(path12.dirname(target));
+  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`;
+  }
+  let st = null;
+  try {
+    st = lstatSync(target);
+  } catch {
+    st = null;
+  }
+  if (st) {
+    if (st.isDirectory()) return `\uAC19\uC740 \uC774\uB984\uC758 \uB514\uB809\uD130\uB9AC\uAC00 \uC788\uC2B5\uB2C8\uB2E4(${target})`;
+    const shown = path12.relative(path12.resolve(root), path12.resolve(target)).split(path12.sep).join("/");
+    let realTarget;
+    try {
+      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)`;
+    }
+    if (!isSameOrInside(realRoot, realTarget) && !(options.allowOutsideLink && st.isSymbolicLink())) {
+      return `\uAE30\uC874 \uD30C\uC77C\uC758 \uC2E4\uC81C \uC704\uCE58(${realTarget})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`;
+    }
+    let followed;
+    try {
+      followed = statSync2(realTarget);
+    } catch {
+      return `\uAE30\uC874 \uD30C\uC77C \uC815\uBCF4\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${target})`;
+    }
+    if (followed.isDirectory()) {
+      return `\uAC19\uC740 \uC774\uB984\uC758 \uB9C1\uD06C\uAC00 \uB514\uB809\uD130\uB9AC(${realTarget})\uB97C \uAC00\uB9AC\uD0B5\uB2C8\uB2E4(${target})`;
+    }
+    if (!followed.isFile()) {
+      const where = st.isSymbolicLink() ? `\uB9C1\uD06C \uB300\uC0C1(${realTarget})\uC774` : "\uAE30\uC874 \uD30C\uC77C\uC774";
+      return `${where} \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2C8\uB77C \uBE44\uAD50 \xB7 \uB36E\uC5B4\uC4F0\uAE30\uB97C \uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${shown})`;
+    }
+  }
+  return null;
+}
+function isSymlink(p) {
+  try {
+    return lstatSync(p).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+function outsideLinkTarget(root, target) {
+  if (!isSymlink(target)) return null;
+  try {
+    const realTarget = realpathSync2(target);
+    return isSameOrInside(realpathSync2(root), realTarget) ? null : realTarget;
+  } catch {
+    return null;
+  }
+}
+function hardLinkCount(target) {
+  try {
+    const st = lstatSync(target);
+    return st.isFile() && st.nlink >= 2 ? st.nlink : null;
+  } catch {
+    return null;
+  }
+}
+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);
+  let realTarget;
+  try {
+    realTarget = realpathSync2(target);
+  } catch {
+    return target;
+  }
+  return isSameOrInside(realRoot, realTarget) ? null : realTarget;
+}
+async function writeNoFollow(target, content, mode) {
+  let actual = mode;
+  let fd;
+  if (mode === "overwrite") {
+    try {
+      fd = await fs10.open(target, OVERWRITE_FLAGS);
+    } catch (e) {
+      if (e.code !== "ENOENT") throw e;
+      actual = "new";
+      fd = await fs10.open(target, NEW_FILE_FLAGS, 438);
+    }
+  } else {
+    fd = await fs10.open(target, NEW_FILE_FLAGS, 438);
+  }
+  try {
+    if (actual === "overwrite") {
+      const st = await fs10.fstat(fd);
+      if (!st.isFile()) throw codedError(NOT_REGULAR_ERROR_CODE, `${target} \uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+      if (st.nlink >= 2) throw codedError(HARDLINK_ERROR_CODE, hardLinkMessage(target, st.nlink));
+      await fs10.ftruncate(fd, 0);
+    }
+    await fs10.writeFile(fd, content);
+  } finally {
+    await fs10.close(fd);
+  }
+  return actual;
+}
+async function overwriteFollowingLinks(target, content) {
+  const fd = await fs10.open(target, fsConstants.O_WRONLY | fsConstants.O_CREAT, 438);
+  try {
+    const st = await fs10.fstat(fd);
+    if (!st.isFile()) throw codedError(NOT_REGULAR_ERROR_CODE, `${target} \uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
+    if (st.nlink >= 2) throw codedError(HARDLINK_ERROR_CODE, hardLinkMessage(target, st.nlink));
+    await fs10.ftruncate(fd, 0);
+    await fs10.writeFile(fd, content);
+  } finally {
+    await fs10.close(fd);
+  }
+}
+function checkParentInside(root, target) {
+  const realRoot = realpathSync2(root);
+  const realParent = realpathSync2(path12.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`;
+  }
+  return escapeReason(root, target);
+}
+
+// src/init/init.ts
 var CLSX_RANGE = "^2.1.1";
 var TAILWIND_MERGE_RANGES = {
   tailwind4: "^3.4.0",
@@ -3411,8 +3864,29 @@ function describeTailwindBasis(tailwind) {
   return "tailwindcss \uB97C \uCC3E\uC9C0 \uBABB\uD574 \uAE30\uBCF8\uAC12(Tailwind 3)";
 }
 var UTILS_TS_CONTENT = `import { type ClassValue, clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
+import { extendTailwindMerge } from "tailwind-merge";
+
+/**
+ * \`shadow-[shadow:<CSS \uBCC0\uC218 \uCC38\uC870>]\` \uCC98\uB7FC \`shadow:\` \uD0C0\uC785 \uD78C\uD2B8\uAC00 \uBD99\uC740 \uC784\uC758\uAC12 \uADF8\uB9BC\uC790 \uD074\uB798\uC2A4\uC778\uC9C0 \uD310\uC815
+ *
+ * tailwind-merge \uAE30\uBCF8 \uC124\uC815\uC740 \uC774 \uD074\uB798\uC2A4\uB97C \uADF8\uB9BC\uC790 \uC0C9(shadow-color) \uADF8\uB8F9\uC73C\uB85C \uBD84\uB958\uD574\uC11C
+ * \`cn(\uAE30\uBCF8, "shadow-none")\` \uC774 \uAE30\uBCF8 \uADF8\uB9BC\uC790\uB97C \uC9C0\uC6B0\uC9C0 \uBABB\uD558\uACE0, \`shadow-black/50\` \uC740 \uADF8\uB9BC\uC790\uB97C \uD1B5\uC9F8\uB85C \uC9C0\uC6B4\uB2E4.
+ * \uADF8\uB9BC\uC790(shadow) \uADF8\uB8F9\uC5D0 \uB4F1\uB85D\uD574 \uC885\uC804 \`shadow-sm\` \xB7 \`shadow-lg\` \uC640 \uAC19\uC740 \uBCD1\uD569 \uACB0\uACFC\uB97C \uB0B8\uB2E4(WI-0025 U4).
+ */
+const isArbitraryShadowWithHint = (value: string) => /^\\[shadow:.+\\]$/.test(value);
 
+const twMerge = extendTailwindMerge({
+  extend: {
+    classGroups: {
+      shadow: [{ shadow: [isArbitraryShadowWithHint] }],
+    },
+  },
+});
+
+/**
+ * Tailwind CSS \uD074\uB798\uC2A4\uB97C \uBCD1\uD569\uD558\uB294 \uC720\uD2F8\uB9AC\uD2F0 \uD568\uC218
+ * clsx\uB85C \uC870\uAC74\uBD80 \uD074\uB798\uC2A4\uB97C \uCC98\uB9AC\uD558\uACE0 tailwind-merge\uB85C \uCDA9\uB3CC\uC744 \uD574\uACB0
+ */
 export function cn(...inputs: ClassValue[]) {
   return twMerge(clsx(inputs));
 }
@@ -3430,7 +3904,7 @@ var TAILWIND4_TOKENS_VERSION = TAILWIND4_MIN_AXIS_VERSION;
 var TAILWIND4_CONFLICT_LINE = "  ! create-next-app \uAE30\uBCF8 globals.css \uC758 :root \xB7 @theme inline \xB7 @media (prefers-color-scheme: dark) \xB7 body \uBE14\uB85D\uC740 AXIS \uC640 \uAC19\uC740 \uC774\uB984(--background \xB7 --foreground \xB7 --color-background \xB7 --font-sans \xB7 --font-mono)\uC744 \uB2E4\uB978 \uAC12\uC73C\uB85C \uC815\uC758\uD569\uB2C8\uB2E4. \uC774 \uBE14\uB85D\uB4E4\uC744 \uC9C0\uC6B0\uC138\uC694.";
 function readPackageJsonSafe(baseDir) {
   try {
-    const text = readFileSync4(path11.join(baseDir, "package.json"), "utf8");
+    const text = readFileSync4(path13.join(baseDir, "package.json"), "utf8");
     const parsed = JSON.parse(text.startsWith(BOM) ? text.slice(1) : text);
     return isPlainObject2(parsed) ? parsed : void 0;
   } catch {
@@ -3495,7 +3969,7 @@ function addCommandFor(installCommand, deps) {
   return `pnpm add ${specs}`;
 }
 function planUtilsDependencies(baseDirInput) {
-  const baseDir = path11.resolve(baseDirInput);
+  const baseDir = path13.resolve(baseDirInput);
   const installCommand = detectInstallCommand(baseDir);
   const tailwind0 = detectTailwind(baseDir);
   const ranges0 = selectUtilsDependencies(tailwind0);
@@ -3508,8 +3982,8 @@ function planUtilsDependencies(baseDirInput) {
     installCommand,
     addCommand: addCommandFor(installCommand, ranges0)
   };
-  const pkgFile = path11.join(baseDir, "package.json");
-  if (!existsSync4(pkgFile)) return plan;
+  const pkgFile = path13.join(baseDir, "package.json");
+  if (!existsSync5(pkgFile)) return plan;
   const unwritable = (reason) => ({ ...plan, action: "unwritable", reason });
   let where;
   try {
@@ -3562,8 +4036,8 @@ var defaultWriteFile = (file, data) => writeFileSync2(file, data);
 function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile) {
   const w = plan.write;
   if (plan.action !== "add" || !w) return false;
-  const baseDir = path11.resolve(baseDirInput);
-  const current = existsSync4(w.file) ? readFileSync4(w.file, "utf8") : null;
+  const baseDir = path13.resolve(baseDirInput);
+  const current = existsSync5(w.file) ? readFileSync4(w.file, "utf8") : null;
   if (current !== w.before) {
     throw new Error(`${w.file} \uC774 \uACC4\uD68D \uB4A4\uC5D0 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.`);
   }
@@ -3614,29 +4088,206 @@ function reportDependencies(plan, log) {
     if (plan.addCommand.includes('"tailwind-merge@')) logBasis();
   }
 }
+async function existingConfig(baseDir) {
+  try {
+    return await readAxisConfig(baseDir);
+  } catch {
+    return null;
+  }
+}
+function configStateNote(state) {
+  if (state === "created") return "axis.config.json \uC740 \uC774\uBBF8 \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4.";
+  if (state === "updated") return "axis.config.json \uC740 \uC774\uBBF8 \uAC31\uC2E0\uD588\uC2B5\uB2C8\uB2E4.";
+  return "axis.config.json \uC740 \uBC14\uAFB8\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4(\uC774\uBBF8 \uAC19\uC740 \uB0B4\uC6A9).";
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function errCode(e) {
+  return e.code ?? e.message;
+}
+function planUtilsWrite(baseDirInput, utilsPath) {
+  const baseDir = path13.resolve(baseDirInput);
+  const shown = path13.relative(baseDir, utilsPath).split(path13.sep).join("/") || utilsPath;
+  let st;
+  try {
+    st = lstatSync2(utilsPath);
+  } catch (e) {
+    if (e.code === "ENOENT") return { action: "create" };
+    return { action: "reject", reason: `${shown} \uC758 \uC815\uBCF4\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
+  }
+  if (st.isSymbolicLink()) {
+    let real;
+    try {
+      real = realpathSync3(utilsPath);
+    } catch {
+      return { action: "reject", reason: `${shown} \uC774 \uAE68\uC9C4 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB9C1\uD06C\uB97C \uC9C0\uC6B0\uAC70\uB098 \uACE0\uCE5C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694` };
+    }
+    let outside = null;
+    try {
+      outside = isSameOrInside(realpathSync3(baseDir), real) ? null : real;
+    } catch {
+      outside = null;
+    }
+    let target;
+    try {
+      target = statSync3(real);
+    } catch (e) {
+      return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC758 \uC815\uBCF4\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
+    }
+    if (target.isDirectory()) return { action: "reject", reason: `${shown} \uB9C1\uD06C\uAC00 \uB514\uB809\uD130\uB9AC(${real})\uB97C \uAC00\uB9AC\uD0B5\uB2C8\uB2E4` };
+    if (!target.isFile()) return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4` };
+    let content2;
+    try {
+      content2 = readFileSync4(utilsPath, "utf8");
+    } catch (e) {
+      return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
+    }
+    if (content2 === UTILS_TS_CONTENT) return { action: "keep", link: { outside } };
+    const what = outside !== null ? `\uD504\uB85C\uC81D\uD2B8 \uBC16(${outside})\uC744 \uAC00\uB9AC\uD0A4\uB294 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C` : "\uD504\uB85C\uC81D\uD2B8 \uC548\uC744 \uAC00\uB9AC\uD0A4\uB294 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C";
+    return {
+      action: "reject",
+      reason: `\uAE30\uC874 ${shown} \uC774 ${what} \uB36E\uC5B4\uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(\uB0B4\uC6A9\uC774 init \uC758 utils \uC640 \uB2E4\uB984). \uB9C1\uD06C\uB294 \uB530\uB77C\uAC00 \uC4F0\uC9C0 \uC54A\uC73C\uB2C8 \uB9C1\uD06C\uB97C \uC9C0\uC6B0\uAC70\uB098 \uC2E4\uC81C \uD30C\uC77C\uB85C \uBC14\uAFBC \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694`
+    };
+  }
+  if (st.isDirectory()) return { action: "reject", reason: `${shown} \uC774\uB984\uC758 \uB514\uB809\uD130\uB9AC\uAC00 \uC788\uC5B4 \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` };
+  if (!st.isFile()) return { action: "reject", reason: `${shown} \uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2C8\uB77C \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` };
+  let content;
+  try {
+    content = readFileSync4(utilsPath, "utf8");
+  } catch (e) {
+    return { action: "reject", reason: `\uAE30\uC874 ${shown} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
+  }
+  if (content === UTILS_TS_CONTENT) return { action: "keep" };
+  const nlink = hardLinkCount(utilsPath);
+  if (nlink !== null) return { action: "reject", reason: hardLinkMessage(shown, nlink) };
+  try {
+    accessSync2(utilsPath, constants2.W_OK);
+  } catch (e) {
+    return { action: "reject", reason: `\uAE30\uC874 ${shown} \uC5D0 \uC4F8 \uAD8C\uD55C\uC774 \uC5C6\uC5B4 \uB36E\uC5B4\uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
+  }
+  return { action: "overwrite" };
+}
 async function runInit(baseDirInput, answers, registryUrl, log = console.log) {
-  const baseDir = path11.resolve(baseDirInput);
+  const baseDir = path13.resolve(baseDirInput);
+  const current = await existingConfig(baseDir);
+  const existingRegistry = nonEmptyString(current?.registry);
+  const migratedRegistry = existingRegistry !== void 0 && isLegacyDefaultRegistryUrl(existingRegistry);
+  const registry = existingRegistry !== void 0 && !migratedRegistry ? existingRegistry : registryUrl;
+  const existingAgenticDir = nonEmptyString(current?.agenticDir);
   const plan = planUtilsDependencies(baseDir);
   const tailwind4 = isTailwind4(plan.tailwind);
   const axisConfig = createInitConfig(
     {
       componentsDir: answers.componentsDir,
+      agenticDir: existingAgenticDir,
       tailwindConfig: tailwind4 ? void 0 : answers.tailwindConfig,
       globalCss: answers.globalCss
     },
-    registryUrl
+    registry
   );
-  await fs10.writeJSON(path11.join(baseDir, "axis.config.json"), axisConfig, { spaces: 2 });
-  log(chalk9.green("\u2713 axis.config.json \uC0DD\uC131 \uC644\uB8CC"));
-  const utilsPath = path11.resolve(baseDir, answers.componentsDir, "utils.ts");
-  await fs10.ensureDir(path11.dirname(utilsPath));
-  await fs10.writeFile(utilsPath, UTILS_TS_CONTENT);
-  log(chalk9.green("\u2713 utils.ts \uC0DD\uC131 \uC644\uB8CC"));
+  const configPath = path13.join(baseDir, "axis.config.json");
+  const nextText = `${JSON.stringify(axisConfig, null, 2)}
+`;
+  const rejects = [];
+  let previousText = null;
+  try {
+    previousText = await fs11.readFile(configPath, "utf8");
+  } catch (e) {
+    if (e.code !== "ENOENT") {
+      rejects.push(`\uAE30\uC874 axis.config.json \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})`);
+    }
+  }
+  if (previousText !== null && previousText !== nextText) {
+    try {
+      const st = statSync3(configPath);
+      if (st.isFile() && st.nlink >= 2) rejects.push(hardLinkMessage("axis.config.json", st.nlink));
+    } catch {
+    }
+  }
+  const utilsPath = path13.resolve(baseDir, answers.componentsDir, "utils.ts");
+  const utilsPlan = planUtilsWrite(baseDir, utilsPath);
+  if (utilsPlan.action === "reject") rejects.push(utilsPlan.reason);
+  if (rejects.length > 0) {
+    log(chalk9.red("\u2717 \uC4F8 \uC218 \uC5C6\uB294 \uD30C\uC77C\uC774 \uC788\uC5B4 \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4(axis.config.json \xB7 utils.ts \xB7 package.json \uADF8\uB300\uB85C)."));
+    for (const r of rejects) log(chalk9.red(`  - ${r}`));
+    process.exitCode = 1;
+    return;
+  }
+  let configState;
+  if (previousText === null) {
+    try {
+      await fs11.writeFile(configPath, nextText, { flag: "wx" });
+    } catch (err) {
+      const reason = err.code === "EEXIST" ? "\uAC80\uC0AC \uB4A4 \uC4F0\uAE30 \uC9C1\uC804\uC5D0 \uAC19\uC740 \uC774\uB984\uC758 \uD30C\uC77C\uC774 \uC0DD\uACBC\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569)" : err.message;
+      log(chalk9.red(`\u2717 axis.config.json \uC744 \uB9CC\uB4E4\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${reason}. \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`));
+      process.exitCode = 1;
+      return;
+    }
+    configState = "created";
+    log(chalk9.green("\u2713 axis.config.json \uC0DD\uC131 \uC644\uB8CC"));
+  } else if (previousText === nextText) {
+    configState = "kept";
+    log(chalk9.green("\u2713 axis.config.json \uC720\uC9C0(\uC774\uBBF8 \uAC19\uC740 \uB0B4\uC6A9)"));
+  } else {
+    try {
+      await overwriteFollowingLinks(configPath, nextText);
+    } catch (err) {
+      const reason = err.code === HARDLINK_ERROR_CODE ? `\uAC80\uC0AC \uB4A4 \uC4F0\uAE30 \uC9C1\uC804\uC5D0 \uB2E4\uB978 \uACBD\uB85C\uC640 \uD558\uB4DC\uB9C1\uD06C\uB85C \uC774\uC5B4\uC84C\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569, D19)` : err.message;
+      log(chalk9.red(`\u2717 axis.config.json \uC744 \uC4F0\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${reason}. \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`));
+      process.exitCode = 1;
+      return;
+    }
+    configState = "updated";
+    const registryNote = migratedRegistry ? "registry \uB97C \uC0C8 \uAE30\uBCF8 \uC8FC\uC18C\uB85C \uAC31\uC2E0" : existingRegistry !== void 0 ? "registry \uB294 \uAE30\uC874 \uAC12 \uC720\uC9C0" : "registry \uB294 \uAE30\uBCF8\uAC12";
+    const agenticNote = existingAgenticDir !== void 0 ? ", agenticDir \uB294 \uAE30\uC874 \uAC12 \uC720\uC9C0" : "";
+    log(chalk9.green(`\u2713 axis.config.json \uAC31\uC2E0(\uAE30\uC874 \uD30C\uC77C\uC744 init \uAC12\uC73C\uB85C \uB2E4\uC2DC \uC500, ${registryNote}${agenticNote})`));
+    if (migratedRegistry && existingRegistry !== void 0) {
+      log(
+        chalk9.yellow(
+          `  registry \uB97C \uC0C8 \uAE30\uBCF8 \uC8FC\uC18C(${redactRegistryUrl(registry)})\uB85C \uAC31\uC2E0\uD588\uC2B5\uB2C8\uB2E4(\uC885\uC804 axis.minu.best: ${redactRegistryUrl(existingRegistry)}).`
+        )
+      );
+    }
+    const dropped = current ? Object.keys(current).filter((k) => !(k in axisConfig) && current[k] !== void 0) : [];
+    if (dropped.length > 0) {
+      log(chalk9.yellow(`  \uAE30\uC874 \uC124\uC815\uC5D0\uC11C \uBE60\uC9C4 \uD0A4: ${dropped.join(", ")} (\uD544\uC694\uD558\uBA74 axis.config.json \uC5D0 \uB2E4\uC2DC \uC801\uC5B4 \uC8FC\uC138\uC694)`));
+    }
+  }
+  let utilsStateNote = "utils.ts \uB294 \uBC14\uAFB8\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4(\uC774\uBBF8 \uAC19\uC740 \uB0B4\uC6A9).";
+  if (utilsPlan.action === "keep") {
+    if (utilsPlan.link === void 0) log(chalk9.green("\u2713 utils.ts \uC720\uC9C0(\uC774\uBBF8 \uAC19\uC740 \uB0B4\uC6A9)"));
+    else if (utilsPlan.link.outside === null) log(chalk9.green("\u2713 utils.ts \uC720\uC9C0(\uC774\uBBF8 \uAC19\uC740 \uB0B4\uC6A9, \uB9C1\uD06C)"));
+    else log(chalk9.green(`\u2713 utils.ts \uC720\uC9C0(\uC774\uBBF8 \uAC19\uC740 \uB0B4\uC6A9, \uB9C1\uD06C \uB300\uC0C1\uC774 \uD504\uB85C\uC81D\uD2B8 \uBC16: ${utilsPlan.link.outside})`));
+  } else {
+    let actual;
+    try {
+      await fs11.ensureDir(path13.dirname(utilsPath));
+      actual = await writeNoFollow(utilsPath, UTILS_TS_CONTENT, utilsPlan.action === "create" ? "new" : "overwrite");
+    } catch (err) {
+      const code = err.code;
+      const reason = code === HARDLINK_ERROR_CODE ? "\uAC80\uC0AC \uB4A4 \uC4F0\uAE30 \uC9C1\uC804\uC5D0 \uB2E4\uB978 \uACBD\uB85C\uC640 \uD558\uB4DC\uB9C1\uD06C\uB85C \uC774\uC5B4\uC84C\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569, D19)" : code === "ELOOP" || code === "EEXIST" ? "\uAC80\uC0AC \uB4A4 \uC4F0\uAE30 \uC9C1\uC804\uC5D0 \uAC19\uC740 \uC774\uB984\uC758 \uD30C\uC77C \xB7 \uB9C1\uD06C\uAC00 \uC0DD\uACBC\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569)" : err.message;
+      log(
+        chalk9.red(
+          utilsPlan.action === "create" ? `\u2717 utils.ts \uB97C \uB9CC\uB4E4\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${reason}.` : `\u2717 utils.ts \uB97C \uC4F0\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${reason}. \uADF8 \uD30C\uC77C\uC740 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`
+        )
+      );
+      log(chalk9.yellow(`  ${configStateNote(configState)}`));
+      process.exitCode = 1;
+      return;
+    }
+    log(
+      chalk9.green(
+        actual === "new" ? "\u2713 utils.ts \uC0DD\uC131 \uC644\uB8CC" : "\u2713 utils.ts \uB36E\uC5B4\uC500(\uAE30\uC874 \uB0B4\uC6A9\uACFC \uB2EC\uB77C init \uC758 utils \uB85C \uB2E4\uC2DC \uC500)"
+      )
+    );
+    utilsStateNote = actual === "new" ? "utils.ts \uB294 \uC774\uBBF8 \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4." : "utils.ts \uB294 \uC774\uBBF8 \uB36E\uC5B4\uC37C\uC2B5\uB2C8\uB2E4.";
+  }
   try {
     applyUtilsDependencies(baseDir, plan);
   } catch (err) {
     log(chalk9.red(`\u2717 package.json \uC744 \uC4F0\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${err.message}`));
-    log(chalk9.yellow("  axis.config.json \uACFC utils.ts \uB294 \uC774\uBBF8 \uB9CC\uB4E4\uC5B4\uC84C\uC2B5\uB2C8\uB2E4."));
+    log(chalk9.yellow(`  ${configStateNote(configState)} ${utilsStateNote}`));
     log(chalk9.yellow(`  utils.ts \uC758\uC874\uC131 \uC124\uCE58: ${chalk9.cyan(plan.addCommand)}`));
     process.exitCode = 1;
     return;
@@ -3659,7 +4310,7 @@ ${head}`));
 }
 
 // src/init/index.ts
-function registerInitCommand(program2, registryUrl) {
+function registerInitCommand(program2, registryUrl = DEFAULT_REGISTRY_URL) {
   program2.command("init").description("\uD504\uB85C\uC81D\uD2B8\uC5D0 AXIS Design System \uCD08\uAE30\uD654").option("-y, --yes", "\uAE30\uBCF8\uAC12\uC73C\uB85C \uC790\uB3D9 \uC124\uC815").action(async (options) => {
     console.log(chalk10.blue("\n\u{1F3A8} AXIS Design System \uCD08\uAE30\uD654\n"));
     const tailwind4 = isTailwind4(planUtilsDependencies(process.cwd()).tailwind);
@@ -3687,108 +4338,803 @@ function registerInitCommand(program2, registryUrl) {
   });
 }
 
-// src/index.ts
-var { version: CLI_VERSION } = createRequire2(import.meta.url)("../package.json");
-var REGISTRY_URL = process.env.AXIS_REGISTRY_URL || "https://axis.minu.best/r";
-var program = new Command();
-program.name("axis").description("AXIS Design System CLI - shadcn \uD638\uD658 \uCEF4\uD3EC\uB10C\uD2B8 \uC124\uCE58 \uB3C4\uAD6C").version(CLI_VERSION);
-registerInitCommand(program, REGISTRY_URL);
-program.command("add <component>").description("\uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00").option("--agentic", "Agentic UI \uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00").option("-y, --yes", "\uD655\uC778 \uC5C6\uC774 \uB36E\uC5B4\uC4F0\uAE30").action(async (component, options) => {
-  const spinner = ora6(`${component} \uCEF4\uD3EC\uB10C\uD2B8 \uAC00\uC838\uC624\uB294 \uC911...`).start();
+// src/add/index.ts
+import chalk11 from "chalk";
+import prompts3 from "prompts";
+
+// src/add/add.ts
+import { existsSync as existsSync7, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
+import path15 from "path";
+import fs12 from "fs-extra";
+
+// src/registry/bundled.ts
+import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
+import path14 from "path";
+import { fileURLToPath } from "url";
+function findBundledRegistryDir(moduleUrl = import.meta.url) {
+  const here = path14.dirname(fileURLToPath(moduleUrl));
+  for (const dir of [path14.join(here, "registry"), path14.join(here, "..", "registry")]) {
+    if (existsSync6(path14.join(dir, "index.json"))) return dir;
+  }
+  return null;
+}
+function readBundledJson(dir, fileName) {
+  const file = path14.join(dir, fileName);
+  let text;
   try {
-    const configPath = path12.resolve("axis.config.json");
-    if (!await fs11.pathExists(configPath)) {
-      spinner.fail(
-        "axis.config.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.\n  \uD574\uACB0: \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC5D0\uC11C 'npx @axis-ds/cli init'\uC744 \uC2E4\uD589\uD558\uC138\uC694.\n  \uCC38\uACE0: https://axis.minu.best/docs/guides/quick-start"
+    text = readFileSync5(file, "utf8");
+  } catch {
+    throw new Error(`\uB3D9\uBD09 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC5D0 ${fileName} \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(${dir})`);
+  }
+  return parseJsonText(text, `\uB3D9\uBD09 \uB808\uC9C0\uC2A4\uD2B8\uB9AC ${fileName}`);
+}
+
+// src/registry/index.ts
+var RegistryError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "RegistryError";
+  }
+};
+function bundledFallbackMessage(version, reason, kind = "access") {
+  const lead = kind === "invalid" ? "\uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC751\uB2F5\uC774 \uD615\uC2DD \uAC80\uC99D\uC744 \uD1B5\uACFC\uD558\uC9C0 \uBABB\uD574" : "\uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC5D0 \uC811\uADFC\uD558\uC9C0 \uBABB\uD574";
+  return `${lead} CLI \uC5D0 \uD3EC\uD568\uB41C \uB808\uC9C0\uC2A4\uD2B8\uB9AC(version ${version})\uB97C \uC0AC\uC6A9\uD569\uB2C8\uB2E4. (\uC6D0\uC778: ${reason})`;
+}
+function fallbackKindOf(error) {
+  return error instanceof RegistryAccessError ? "access" : "invalid";
+}
+function versionMismatchMessage(remoteVersion, bundledVersion) {
+  return `\uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC(version ${remoteVersion})\uC640 CLI \uC5D0 \uD3EC\uD568\uB41C \uB808\uC9C0\uC2A4\uD2B8\uB9AC(version ${bundledVersion})\uC758 version \uC774 \uB2E4\uB985\uB2C8\uB2E4. \uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uB97C \uC6B0\uC120 \uC0AC\uC6A9\uD569\uB2C8\uB2E4.`;
+}
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var RegistryClient = class {
+  baseUrl;
+  baseUrlError;
+  bundledDir;
+  timeoutMs;
+  fetchImpl;
+  notify;
+  mode = null;
+  indexPromise = null;
+  bundledIndex = null;
+  fallbackAnnounced = false;
+  constructor(options) {
+    let baseUrl = null;
+    let baseUrlError = null;
+    if (options.url !== null) {
+      try {
+        baseUrl = normalizeRegistryBaseUrl(options.url);
+      } catch (error) {
+        baseUrlError = messageOf(error);
+      }
+    } else {
+      baseUrlError = "\uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4";
+    }
+    this.baseUrl = baseUrl;
+    this.baseUrlError = baseUrlError;
+    this.bundledDir = options.bundledDir === void 0 ? findBundledRegistryDir() : options.bundledDir;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_REGISTRY_TIMEOUT_MS;
+    this.fetchImpl = options.fetchImpl;
+    this.notify = options.notify ?? ((message) => console.warn(message));
+  }
+  /** 지금 쓰는 출처. index 를 읽기 전에는 null 입니다 */
+  get origin() {
+    return this.mode;
+  }
+  /** 레지스트리 목록(index.json) */
+  getIndex() {
+    if (!this.indexPromise) this.indexPromise = this.loadIndex();
+    return this.indexPromise;
+  }
+  /** 항목 하나. 이름 검사 → index 확인 → 항목 조회 순서입니다 */
+  async getItem(name) {
+    if (!isValidRegistryName(name)) {
+      throw new RegistryError(
+        "invalid-name",
+        `'${name}' \uB294 \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uD56D\uBAA9 \uC774\uB984 \uADDC\uCE59(\uC18C\uBB38\uC790 \xB7 \uC22B\uC790 \xB7 \uD558\uC774\uD508)\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`
       );
-      process.exit(1);
     }
-    const config = await fs11.readJSON(configPath);
-    const category = options.agentic ? "agentic" : "ui";
-    const componentInfo = await getComponentInfo(component, category);
-    if (!componentInfo) {
-      spinner.fail(
-        `'${component}' \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.
-  \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCEF4\uD3EC\uB10C\uD2B8 \uBAA9\uB85D: npx @axis-ds/cli list
-  Agentic UI \uCEF4\uD3EC\uB10C\uD2B8\uB294 --agentic \uC635\uC158\uC744 \uCD94\uAC00\uD558\uC138\uC694.`
+    const index = await this.getIndex();
+    const entry = index.items.find((it) => it.name === name);
+    if (!entry) {
+      throw new RegistryError("not-found", `'${name}' \uD56D\uBAA9\uC774 \uB808\uC9C0\uC2A4\uD2B8\uB9AC(version ${index.version})\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4`);
+    }
+    if (this.mode === "remote" && this.baseUrl) {
+      try {
+        const data = await fetchRegistryJson(`${this.baseUrl}/${name}.json`, this.fetchOptions());
+        const item = validateRegistryItem(data, name, `${name}.json`, this.remoteDependencyBases());
+        checkItemSha256(item, entry);
+        return item;
+      } catch (error) {
+        await this.switchToBundled(messageOf(error), fallbackKindOf(error));
+        return this.readBundledItem(name);
+      }
+    }
+    return this.readBundledItem(name);
+  }
+  /** 원격 응답의 의존 URL 로 받아 주는 base: 지금 조회 중인 원격 base 와 공개 기본 base(D11) */
+  remoteDependencyBases() {
+    const bases = [REGISTRY_PUBLIC_BASE_URL];
+    if (this.baseUrl && this.baseUrl !== REGISTRY_PUBLIC_BASE_URL) bases.unshift(this.baseUrl);
+    return bases;
+  }
+  fetchOptions() {
+    return { timeoutMs: this.timeoutMs, ...this.fetchImpl ? { fetchImpl: this.fetchImpl } : {} };
+  }
+  async loadIndex() {
+    let remoteError;
+    let kind = "access";
+    if (this.baseUrl) {
+      try {
+        const data = await fetchRegistryJson(`${this.baseUrl}/index.json`, this.fetchOptions());
+        const index = validateRegistryIndex(data, `${this.baseUrl}/index.json`);
+        this.mode = "remote";
+        this.warnVersionMismatch(index.version);
+        return index;
+      } catch (error) {
+        remoteError = messageOf(error);
+        kind = fallbackKindOf(error);
+      }
+    } else {
+      remoteError = this.baseUrlError ?? "\uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC URL \uC774 \uC5C6\uC2B5\uB2C8\uB2E4";
+    }
+    return this.switchToBundled(remoteError, kind);
+  }
+  /** 동봉본 index 를 읽습니다(성공하면 한 번만). 실패하면 이유를 돌려줍니다 */
+  loadBundledIndex() {
+    if (this.bundledIndex) return { index: this.bundledIndex };
+    if (!this.bundledDir) return { error: "CLI \uC5D0 \uD3EC\uD568\uB41C \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4" };
+    try {
+      this.bundledIndex = validateRegistryIndex(readBundledJson(this.bundledDir, "index.json"), "\uB3D9\uBD09 \uB808\uC9C0\uC2A4\uD2B8\uB9AC index.json");
+      return { index: this.bundledIndex };
+    } catch (error) {
+      return { error: messageOf(error) };
+    }
+  }
+  warnVersionMismatch(remoteVersion) {
+    const bundled = this.loadBundledIndex();
+    if ("index" in bundled && bundled.index.version !== remoteVersion) {
+      this.notify(versionMismatchMessage(remoteVersion, bundled.index.version));
+    }
+  }
+  async switchToBundled(reason, kind = "access") {
+    const bundled = this.loadBundledIndex();
+    if ("error" in bundled) {
+      throw new RegistryError(
+        "unavailable",
+        `\uB808\uC9C0\uC2A4\uD2B8\uB9AC\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC6D0\uACA9: ${reason} / \uB3D9\uBD09\uBCF8: ${bundled.error}`
       );
-      process.exit(1);
     }
-    spinner.text = `${component} \uCEF4\uD3EC\uB10C\uD2B8 \uC124\uCE58 \uC911...`;
-    for (const file of componentInfo.files) {
-      const filePath = path12.join(config.componentsDir, file.path);
-      if (await fs11.pathExists(filePath)) {
-        if (!options.yes) {
-          const { overwrite } = await prompts3({
-            type: "confirm",
-            name: "overwrite",
-            message: `${file.path}\uC774(\uAC00) \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uC2DC\uACA0\uC2B5\uB2C8\uAE4C?`,
-            initial: false
-          });
-          if (!overwrite) continue;
+    this.mode = "bundled";
+    this.indexPromise = Promise.resolve(bundled.index);
+    if (!this.fallbackAnnounced) {
+      this.fallbackAnnounced = true;
+      this.notify(bundledFallbackMessage(bundled.index.version, reason, kind));
+    }
+    return bundled.index;
+  }
+  readBundledItem(name) {
+    const index = this.bundledIndex;
+    const entry = index?.items.find((it) => it.name === name);
+    if (!index || !entry || !this.bundledDir) {
+      throw new RegistryError(
+        "not-found",
+        `'${name}' \uD56D\uBAA9\uC774 CLI \uC5D0 \uD3EC\uD568\uB41C \uB808\uC9C0\uC2A4\uD2B8\uB9AC(version ${index?.version ?? "\uC54C \uC218 \uC5C6\uC74C"})\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4`
+      );
+    }
+    try {
+      const item = validateRegistryItem(readBundledJson(this.bundledDir, `${name}.json`), name, `${name}.json`, DEFAULT_DEPENDENCY_BASES);
+      checkItemSha256(item, entry);
+      return item;
+    } catch (error) {
+      throw new RegistryError("unavailable", `CLI \uC5D0 \uD3EC\uD568\uB41C \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC758 '${name}' \uD56D\uBAA9\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${messageOf(error)}`);
+    }
+  }
+};
+
+// src/add/add.ts
+var AGENTIC_PREFIX = "agentic-";
+function applyAgenticAlias(name, agentic) {
+  if (!agentic || name.startsWith(AGENTIC_PREFIX)) return name;
+  return `${AGENTIC_PREFIX}${name}`;
+}
+function describeMissingName(requested, resolved, index, agentic) {
+  const names = new Set(index.items.map((it) => it.name));
+  if (!isValidRegistryName(resolved)) {
+    return `'${requested}': \uC774\uB984 \uADDC\uCE59(\uC18C\uBB38\uC790 \xB7 \uC22B\uC790 \xB7 \uD558\uC774\uD508)\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`;
+  }
+  if (agentic && resolved !== requested && names.has(requested)) {
+    return `'${requested}': Agentic UI \uC5D0 '${resolved}' \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. '${requested}' \uB294 Core UI \uD56D\uBAA9\uC774\uB2C8 --agentic \uC5C6\uC774 \uC2E4\uD589\uD558\uC138\uC694`;
+  }
+  if (!agentic && names.has(`${AGENTIC_PREFIX}${requested}`)) {
+    return `'${requested}': \uC5C6\uC2B5\uB2C8\uB2E4. Agentic UI \uD56D\uBAA9 '${AGENTIC_PREFIX}${requested}' \uB97C \uB73B\uD588\uB2E4\uBA74 \uC804\uCCB4 \uC774\uB984\uC744 \uC4F0\uAC70\uB098 --agentic \uC744 \uBD99\uC774\uC138\uC694`;
+  }
+  return `'${requested}': \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4`;
+}
+function layoutFromConfig(root, config) {
+  const componentsRaw = config.componentsDir;
+  if (typeof componentsRaw !== "string" || componentsRaw.trim() === "") {
+    throw new Error("axis.config.json \uC5D0 componentsDir \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. 'npx @axis-ds/cli init' \uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uAC70\uB098 \uC9C1\uC811 \uC801\uC73C\uC138\uC694");
+  }
+  const agenticRaw = config.agenticDir;
+  if (agenticRaw !== void 0 && (typeof agenticRaw !== "string" || agenticRaw.trim() === "")) {
+    throw new Error("axis.config.json \uC758 agenticDir \uAC00 \uBB38\uC790\uC5F4\uC774 \uC544\uB2D9\uB2C8\uB2E4");
+  }
+  const componentsDir = componentsRaw.replace(/\\/g, "/");
+  const agenticDir = typeof agenticRaw === "string" ? agenticRaw.replace(/\\/g, "/") : path15.posix.join(path15.posix.dirname(componentsDir), "agentic");
+  return { root: path15.resolve(root), componentsDir, agenticDir };
+}
+function toPosix(p, impl = path15) {
+  return p.split(impl.sep).join("/");
+}
+function itemKind(item) {
+  if (item.type === "registry:lib") return "lib";
+  return item.name.startsWith(AGENTIC_PREFIX) ? "agentic" : "ui";
+}
+var INSTALL_FILE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*(?:\.[A-Za-z0-9_-]+)*\.tsx?$/;
+function registryPathProblem(p) {
+  if (p.length === 0) return "\uBE44\uC5B4 \uC788\uC74C";
+  if (p.includes("\0")) return "NUL \uBB38\uC790";
+  if (p.includes("\\")) return "\uC5ED\uC2AC\uB798\uC2DC";
+  if (p.startsWith("/") || /^[A-Za-z]:/.test(p)) return "\uC808\uB300 \uACBD\uB85C";
+  const segments = p.split("/");
+  if (segments.some((seg) => seg === "" || seg === "." || seg === "..")) return "`..` \xB7 `.` \xB7 \uBE48 \uC138\uADF8\uBA3C\uD2B8";
+  return null;
+}
+function placeFile(layout, item, filePath, target) {
+  for (const p of target === void 0 ? [filePath] : [filePath, target]) {
+    const problem = registryPathProblem(p);
+    if (problem) throw new Error(`${item.name}: \uD30C\uC77C \uACBD\uB85C\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(${JSON.stringify(p)}, ${problem})`);
+  }
+  const base = path15.posix.basename(filePath);
+  if (!INSTALL_FILE_NAME_PATTERN.test(base)) {
+    throw new Error(`${item.name}: \uD30C\uC77C \uACBD\uB85C\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(${JSON.stringify(filePath)}, \uD30C\uC77C \uC774\uB984\uC740 .ts \xB7 .tsx \uB9CC \uC124\uCE58\uD569\uB2C8\uB2E4)`);
+  }
+  const dir = itemKind(item) === "agentic" ? layout.agenticDir : layout.componentsDir;
+  return path15.resolve(layout.root, dir, base);
+}
+function stripExt(p) {
+  return p.replace(/\.(?:tsx?|jsx?|mjs|cjs)$/, "");
+}
+function buildImportTargets(entries) {
+  const exact = /* @__PURE__ */ new Map();
+  const lib = /* @__PURE__ */ new Map();
+  for (const { item, file, target } of entries) {
+    const rel3 = stripExt(file.path.replace(/\\/g, "/").replace(/^\.?\//, ""));
+    exact.set(`@/${rel3}`, target);
+    if (itemKind(item) === "lib") lib.set(path15.posix.basename(rel3), target);
+  }
+  return { exact, lib };
+}
+function nonCodeRanges(src) {
+  const comments = [];
+  const strings = [];
+  function scanTemplate(start) {
+    let i = start + 1;
+    let seg = start;
+    while (i < src.length) {
+      const c = src[i];
+      if (c === "\\") {
+        i += 2;
+      } else if (c === "`") {
+        strings.push([seg, i + 1]);
+        return i + 1;
+      } else if (c === "$" && src[i + 1] === "{") {
+        strings.push([seg, i]);
+        i = scanCode(i + 2, true);
+        seg = i;
+        i++;
+      } else {
+        i++;
+      }
+    }
+    strings.push([seg, src.length]);
+    return src.length;
+  }
+  function scanCode(start, untilBrace) {
+    let i = start;
+    let depth = 0;
+    while (i < src.length) {
+      const c = src[i];
+      if (c === "/" && src[i + 1] === "/") {
+        const end = src.indexOf("\n", i);
+        const stop = end === -1 ? src.length : end;
+        comments.push([i, stop]);
+        i = stop;
+      } else if (c === "/" && src[i + 1] === "*") {
+        const end = src.indexOf("*/", i + 2);
+        const stop = end === -1 ? src.length : end + 2;
+        comments.push([i, stop]);
+        i = stop;
+      } else if (c === '"' || c === "'") {
+        const s = i;
+        i++;
+        while (i < src.length && src[i] !== c && src[i] !== "\n") {
+          if (src[i] === "\\") i++;
+          i++;
         }
+        i = Math.min(i + 1, src.length);
+        strings.push([s, i]);
+      } else if (c === "`") {
+        i = scanTemplate(i);
+      } else if (c === "{") {
+        depth++;
+        i++;
+      } else if (c === "}") {
+        if (untilBrace && depth === 0) return i;
+        depth = Math.max(0, depth - 1);
+        i++;
+      } else {
+        i++;
       }
-      await fs11.ensureDir(path12.dirname(filePath));
-      await fs11.writeFile(filePath, file.content);
     }
-    spinner.succeed(chalk11.green(`${component} \uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00 \uC644\uB8CC`));
-    if (componentInfo.dependencies.length > 0) {
-      console.log(chalk11.yellow("\n\uD544\uC694\uD55C \uC758\uC874\uC131:"));
-      console.log(chalk11.cyan(`  pnpm add ${componentInfo.dependencies.join(" ")}`));
+    return src.length;
+  }
+  scanCode(0, false);
+  return { comments, strings };
+}
+function insideRanges(ranges, at) {
+  return ranges.some(([a, b]) => at >= a && at < b);
+}
+var SPECIFIER_PATTERN = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*)(["'])(@\/[^"'\n]+)\2/g;
+var STANDARD_LIB_PATTERN = /^@\/registry\/[^/]+\/lib\/(.+)$/;
+function relativeSpecifier(fromFile, toFile, impl = path15) {
+  let rel3 = toPosix(impl.relative(impl.dirname(fromFile), stripExt(toFile)), impl);
+  if (!rel3.startsWith(".")) rel3 = `./${rel3}`;
+  return rel3;
+}
+function rewriteImports(content, fileTarget, targets) {
+  const rewritten = [];
+  const unresolved = [];
+  const { comments, strings } = nonCodeRanges(content);
+  const out = content.replace(SPECIFIER_PATTERN, (whole, lead, quote, spec, offset) => {
+    if (insideRanges(comments, offset) || insideRanges(strings, offset)) return whole;
+    let target = targets.exact.get(spec);
+    if (target === void 0) {
+      const m = STANDARD_LIB_PATTERN.exec(spec);
+      if (m) target = targets.lib.get(m[1]);
+    }
+    if (target === void 0) {
+      if (spec.startsWith("@/registry/")) unresolved.push(spec);
+      return whole;
+    }
+    const to = relativeSpecifier(fileTarget, target);
+    rewritten.push({ from: spec, to, target });
+    return `${lead}${quote}${to}${quote}`;
+  });
+  return { content: out, rewritten, unresolved };
+}
+var RESOLVE_EXTS = ["", ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", "/index.ts", "/index.tsx", "/index.js"];
+function relativeSpecifierResolves(fromFile, spec) {
+  const base = path15.resolve(path15.dirname(fromFile), spec);
+  return RESOLVE_EXTS.some((ext) => {
+    try {
+      return statSync4(base + ext).isFile();
+    } catch {
+      return false;
     }
-  } catch (error) {
-    spinner.fail(
-      `\uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00 \uC911 \uC624\uB958 \uBC1C\uC0DD: ${error.message}
-  \uB124\uD2B8\uC6CC\uD06C \uBB38\uC81C\uC778 \uACBD\uC6B0 \uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.
-  \uBB38\uC81C\uAC00 \uC9C0\uC18D\uB418\uBA74 GitHub \uC774\uC288\uB97C \uC0DD\uC131\uD574 \uC8FC\uC138\uC694: https://github.com/IDEA-on-Action/AXIS-Design-System/issues`
+  });
+}
+async function collectItems(client, roots) {
+  const first = await collectOnce(client, roots);
+  if (first.origin === "remote" && client.origin === "bundled") return collectOnce(client, roots);
+  return first;
+}
+async function collectOnce(client, roots) {
+  const index = await client.getIndex();
+  const origin = client.origin;
+  const known = new Set(index.items.map((it) => it.name));
+  const visited = /* @__PURE__ */ new Set();
+  const items = [];
+  const missingDeps = [];
+  async function visit(name) {
+    if (visited.has(name)) return;
+    visited.add(name);
+    const item = await client.getItem(name);
+    for (const dep of item.registryDependencies) {
+      if (!known.has(dep)) {
+        missingDeps.push({ name: dep, from: name });
+        continue;
+      }
+      await visit(dep);
+    }
+    items.push(item);
+  }
+  for (const root of roots) await visit(root);
+  return { items, missingDeps, origin };
+}
+function planFiles(layout, items) {
+  const errors = [];
+  const placed = [];
+  const byTarget = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    for (const file of item.files) {
+      let target;
+      try {
+        target = placeFile(layout, item, file.path, file.target);
+      } catch (error) {
+        errors.push(error.message);
+        continue;
+      }
+      const prev = byTarget.get(target);
+      if (prev !== void 0) {
+        errors.push(`${item.name}: ${toPosix(path15.relative(layout.root, target))} \uB97C ${prev} \uC640 \uD568\uAED8 \uC501\uB2C8\uB2E4(\uAC19\uC740 \uC704\uCE58)`);
+        continue;
+      }
+      byTarget.set(target, item.name);
+      placed.push({ item, file, target });
+    }
+  }
+  const targets = buildImportTargets(placed);
+  const files = [];
+  for (const { item, file, target } of placed) {
+    const r = rewriteImports(file.content, target, targets);
+    for (const spec of r.unresolved) {
+      errors.push(`${item.name}: import '${spec}' \uB97C \uC124\uCE58 \uC704\uCE58\uB85C \uBC14\uAFC0 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(registryDependencies \uC5D0 \uD574\uB2F9 \uD56D\uBAA9\uC774 \uC5C6\uC74C)`);
+    }
+    files.push({ item, sourcePath: file.path, target, content: r.content, rewritten: r.rewritten });
+  }
+  for (const f of files) {
+    const reason = escapeReason(layout.root, f.target, { allowOutsideLink: true });
+    if (reason) errors.push(`${f.item.name}: ${reason}. \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
+  }
+  return { files, errors };
+}
+function missingDependencies(root, items) {
+  const installCommand = detectInstallCommand(root);
+  let pkg;
+  try {
+    const text = readFileSync6(path15.join(root, "package.json"), "utf8").replace(/^/, "");
+    const parsed = JSON.parse(text);
+    pkg = isPlainObject2(parsed) ? parsed : void 0;
+  } catch {
+    pkg = void 0;
+  }
+  const ranges = selectUtilsDependencies(detectTailwind(root, pkg));
+  const specs = {};
+  for (const item of items) {
+    for (const dep of item.dependencies) {
+      const name = dependencyName(dep);
+      if (pkg !== void 0 && hasDependency2(pkg, name) !== 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];
+    }
+  }
+  const sorted = {};
+  for (const name of Object.keys(specs).sort()) sorted[name] = specs[name];
+  return { specs: sorted, installCommand };
+}
+function dependencyName(spec) {
+  const at = spec.indexOf("@", spec.startsWith("@") ? 1 : 0);
+  return at > 0 ? spec.slice(0, at) : 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}`;
+}
+function rel2(root, p) {
+  return toPosix(path15.relative(root, p));
+}
+async function runAdd(cwd, requested, options, ctx) {
+  const log = ctx.log ?? console.log;
+  const error = ctx.error ?? console.error;
+  const root = path15.resolve(cwd);
+  const result = { exitCode: 1, written: [], overwritten: [], unchanged: [], skipped: [] };
+  if (requested.length === 0) {
+    error("\uCD94\uAC00\uD560 \uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984\uC744 \uD558\uB098 \uC774\uC0C1 \uC801\uC73C\uC138\uC694. \uBAA9\uB85D: npx @axis-ds/cli list");
+    return result;
+  }
+  let config;
+  try {
+    config = await readAxisConfig(root);
+  } catch (e) {
+    error(`axis.config.json \uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${e.message}`);
+    return result;
+  }
+  if (!config) {
+    error(
+      "axis.config.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.\n  \uD574\uACB0: \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC5D0\uC11C 'npx @axis-ds/cli init'\uC744 \uC2E4\uD589\uD558\uC138\uC694.\n  \uCC38\uACE0: https://axis.minu.best/docs/guides/quick-start"
     );
-    process.exit(1);
+    return result;
   }
-});
-program.command("list").description("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCEF4\uD3EC\uB10C\uD2B8 \uBAA9\uB85D").option("--category <type>", "\uCE74\uD14C\uACE0\uB9AC \uD544\uD130 (ui, agentic)").action(async (options) => {
-  console.log(chalk11.blue("\n\u{1F4E6} AXIS Design System \uCEF4\uD3EC\uB10C\uD2B8\n"));
-  const components = {
-    ui: [
-      { name: "button", description: "\uAE30\uBCF8 \uBC84\uD2BC \uCEF4\uD3EC\uB10C\uD2B8" },
-      { name: "input", description: "\uD14D\uC2A4\uD2B8 \uC785\uB825 \uD544\uB4DC" },
-      { name: "card", description: "\uCE74\uB4DC \uCEE8\uD14C\uC774\uB108" },
-      { name: "dialog", description: "\uBAA8\uB2EC \uB2E4\uC774\uC5BC\uB85C\uADF8" },
-      { name: "badge", description: "\uBC43\uC9C0/\uD0DC\uADF8" },
-      { name: "select", description: "\uC120\uD0DD \uB4DC\uB86D\uB2E4\uC6B4" },
-      { name: "tabs", description: "\uD0ED \uB124\uBE44\uAC8C\uC774\uC158" },
-      { name: "toast", description: "\uC54C\uB9BC \uD1A0\uC2A4\uD2B8" },
-      { name: "label", description: "\uD3FC \uB77C\uBCA8" },
-      { name: "separator", description: "\uAD6C\uBD84\uC120" }
-    ],
-    agentic: [
-      { name: "run-progress", description: "\uC5D0\uC774\uC804\uD2B8 \uC2E4\uD589 \uC9C4\uD589\uB960" },
-      { name: "step-timeline", description: "\uB2E8\uACC4\uBCC4 \uD0C0\uC784\uB77C\uC778" },
-      { name: "approval-card", description: "\uC0AC\uC6A9\uC790 \uC2B9\uC778 \uC694\uCCAD" },
-      { name: "streaming-text", description: "\uC2E4\uC2DC\uAC04 \uD14D\uC2A4\uD2B8 \uC2A4\uD2B8\uB9AC\uBC0D" },
-      { name: "tool-call-card", description: "\uB3C4\uAD6C \uD638\uCD9C \uD45C\uC2DC" },
-      { name: "source-panel", description: "AI \uADFC\uAC70/\uCD9C\uCC98 \uD45C\uC2DC" },
-      { name: "thinking-indicator", description: "\uC0DD\uAC01 \uC911 \uD45C\uC2DC" },
-      { name: "recovery-banner", description: "\uC624\uB958 \uBCF5\uAD6C \uC548\uB0B4" },
-      { name: "agent-avatar", description: "\uC5D0\uC774\uC804\uD2B8 \uC544\uBC14\uD0C0" },
-      { name: "surface-renderer", description: "\uB3D9\uC801 Surface \uB80C\uB354\uB9C1" }
-    ]
-  };
-  const showCategory = (category, items) => {
-    console.log(chalk11.bold(category === "ui" ? "Core UI" : "Agentic UI"));
-    items.forEach((c) => {
-      console.log(`  ${chalk11.cyan(c.name.padEnd(20))} ${chalk11.gray(c.description)}`);
-    });
-    console.log();
+  let layout;
+  try {
+    layout = layoutFromConfig(root, config);
+  } catch (e) {
+    error(e.message);
+    return result;
+  }
+  let index;
+  try {
+    index = await ctx.client.getIndex();
+  } catch (e) {
+    error(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${e.message}`);
+    return result;
+  }
+  const names = new Set(index.items.map((it) => it.name));
+  const resolved = [];
+  const missing = [];
+  for (const req of requested) {
+    const name = applyAgenticAlias(req, options.agentic);
+    if (!isValidRegistryName(name) || !names.has(name)) missing.push(describeMissingName(req, name, index, options.agentic));
+    else if (!resolved.includes(name)) resolved.push(name);
+  }
+  if (missing.length > 0) {
+    error(`\uCEF4\uD3EC\uB10C\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4 \uC544\uBB34\uAC83\uB3C4 \uC124\uCE58\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4(\uB808\uC9C0\uC2A4\uD2B8\uB9AC version ${index.version}).`);
+    for (const m of missing) error(`  - ${m}`);
+    error("  \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uBAA9\uB85D: npx @axis-ds/cli list");
+    return result;
+  }
+  let items;
+  try {
+    const collected = await collectItems(ctx.client, resolved);
+    if (collected.missingDeps.length > 0) {
+      error("\uB808\uC9C0\uC2A4\uD2B8\uB9AC \uD56D\uBAA9\uC758 \uC758\uC874 \uD56D\uBAA9\uC774 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC5D0 \uC5C6\uC5B4 \uC544\uBB34\uAC83\uB3C4 \uC124\uCE58\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
+      for (const d of collected.missingDeps) error(`  - ${d.from} \u2192 ${d.name}`);
+      return result;
+    }
+    items = collected.items;
+  } catch (e) {
+    const msg = e instanceof RegistryError ? e.message : `\uB808\uC9C0\uC2A4\uD2B8\uB9AC \uD56D\uBAA9\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${e.message}`;
+    error(msg);
+    return result;
+  }
+  const plan = planFiles(layout, items);
+  if (plan.errors.length > 0) {
+    error("\uC124\uCE58\uD560 \uC218 \uC5C6\uC5B4 \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
+    for (const e of plan.errors) error(`  - ${e}`);
+    return result;
+  }
+  const existing = /* @__PURE__ */ new Map();
+  const readErrors = [];
+  for (const file of plan.files) {
+    if (!existsSync7(file.target)) {
+      existing.set(file, null);
+      continue;
+    }
+    try {
+      existing.set(file, readFileSync6(file.target, "utf8"));
+    } catch (e) {
+      readErrors.push(
+        `${file.item.name}: \uAE30\uC874 \uD30C\uC77C ${rel2(root, file.target)} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${e.code ?? e.message})`
+      );
+    }
+  }
+  if (readErrors.length > 0) {
+    error("\uC124\uCE58\uD560 \uC218 \uC5C6\uC5B4 \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
+    for (const e of readErrors) error(`  - ${e}`);
+    return result;
+  }
+  const decisions = [];
+  for (const file of plan.files) {
+    const current = existing.get(file) ?? null;
+    if (current === null) {
+      decisions.push({ file, action: "write" });
+      continue;
+    }
+    if (current === file.content) {
+      decisions.push({ file, action: "unchanged" });
+      continue;
+    }
+    if (options.overwrite) {
+      decisions.push({ file, action: "overwrite" });
+    } else if (options.yes || !ctx.confirm) {
+      decisions.push({ file, action: "skip" });
+    } else {
+      const ok = await ctx.confirm(`${rel2(root, file.target)} \uC758 \uB0B4\uC6A9\uC774 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC640 \uB2E4\uB985\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uC2DC\uACA0\uC2B5\uB2C8\uAE4C?`);
+      decisions.push({ file, action: ok ? "overwrite" : "skip" });
+    }
+  }
+  const outsideLinks = /* @__PURE__ */ new Map();
+  for (const d of decisions) {
+    const outside = outsideLinkTarget(root, d.file.target);
+    if (outside !== null) outsideLinks.set(d.file, outside);
+  }
+  const linkErrors = decisions.filter((d) => (d.action === "write" || d.action === "overwrite") && isSymlink(d.file.target)).map((d) => {
+    const outside = outsideLinks.get(d.file);
+    const what = outside !== void 0 ? `\uD504\uB85C\uC81D\uD2B8 \uBC16(${outside})\uC744 \uAC00\uB9AC\uD0A4\uB294 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C` : "\uD504\uB85C\uC81D\uD2B8 \uC548\uC744 \uAC00\uB9AC\uD0A4\uB294 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C";
+    return `${d.file.item.name}: \uAE30\uC874 \uD30C\uC77C ${rel2(root, d.file.target)} \uC774 ${what} \uB36E\uC5B4\uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uB9C1\uD06C\uB294 \uB530\uB77C\uAC00 \uC4F0\uC9C0 \uC54A\uC73C\uB2C8 \uB9C1\uD06C\uB97C \uC9C0\uC6B0\uAC70\uB098 \uC2E4\uC81C \uD30C\uC77C\uB85C \uBC14\uAFBC \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694`;
+  });
+  for (const d of decisions) {
+    if (d.action !== "overwrite") continue;
+    const nlink = hardLinkCount(d.file.target);
+    if (nlink !== null) linkErrors.push(`${d.file.item.name}: ${hardLinkMessage(rel2(root, d.file.target), nlink)}`);
+  }
+  if (linkErrors.length > 0) {
+    error("\uC124\uCE58\uD560 \uC218 \uC5C6\uC5B4 \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
+    for (const e of linkErrors) error(`  - ${e}`);
+    return result;
+  }
+  const stopWriting = (p, reason, tail = "\uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.") => {
+    error(`${p}: ${reason}. ${tail}`);
+    if (result.written.length > 0) {
+      error(`\uC774\uBBF8 \uC4F4 \uD30C\uC77C(${result.written.length}):`);
+      for (const w of result.written) error(`  ${result.overwritten.includes(w) ? "~" : "+"} ${w}`);
+    }
+    return { ...result, exitCode: 1 };
   };
-  if (!options.category || options.category === "ui") {
-    showCategory("ui", components.ui);
+  for (const d of decisions) {
+    const p = rel2(root, d.file.target);
+    if (d.action === "unchanged") {
+      result.unchanged.push(p);
+      continue;
+    }
+    if (d.action === "skip") {
+      result.skipped.push(p);
+      continue;
+    }
+    let actual = d.action === "write" ? "new" : "overwrite";
+    try {
+      const before = escapeReason(root, d.file.target);
+      if (before) return stopWriting(p, before);
+      await fs12.ensureDir(path15.dirname(d.file.target));
+      const after = checkParentInside(root, d.file.target);
+      if (after) return stopWriting(p, after);
+      actual = await writeNoFollow(d.file.target, d.file.content, actual);
+    } catch (e) {
+      const code = e.code;
+      if (code === "ELOOP" || code === "EEXIST" && isSymlink(d.file.target)) {
+        return stopWriting(p, "\uAC80\uC0AC \uB4A4 \uC4F0\uAE30 \uC9C1\uC804\uC5D0 \uB9C1\uD06C\uB85C \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569)");
+      }
+      if (code === HARDLINK_ERROR_CODE) {
+        return stopWriting(
+          p,
+          "\uAC80\uC0AC \uB4A4 \uC4F0\uAE30 \uC9C1\uC804\uC5D0 \uB2E4\uB978 \uACBD\uB85C\uC640 \uD558\uB4DC\uB9C1\uD06C\uB85C \uC774\uC5B4\uC84C\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569)",
+          "\uADF8 \uD30C\uC77C\uC740 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4(D19). \uD558\uB4DC\uB9C1\uD06C\uB97C \uB04A\uC740 \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694."
+        );
+      }
+      if (code === "EEXIST") {
+        return stopWriting(
+          p,
+          "\uC0C8 \uD30C\uC77C\uB85C \uD310\uC815\uD55C \uB4A4(\uD655\uC778 \uB300\uAE30 \uC911 \uB4F1) \uAC19\uC740 \uC774\uB984\uC758 \uD30C\uC77C\uC774 \uC0DD\uACBC\uC2B5\uB2C8\uB2E4(\uB3D9\uC2DC \uACBD\uD569)",
+          "\uADF8 \uD30C\uC77C\uC740 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uB0B4\uC6A9\uC744 \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694."
+        );
+      }
+      return stopWriting(p, `\uC4F0\uAE30 \uC2E4\uD328(${e.message})`);
+    }
+    const outside = writtenOutside(root, d.file.target);
+    if (outside !== null) {
+      return stopWriting(
+        p,
+        `\uC4F4 \uB4A4 \uD655\uC778\uD55C \uC2E4\uC81C \uC704\uCE58(${outside})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4(\uAC80\uC0AC\uC640 \uC4F0\uAE30 \uC0AC\uC774\uC5D0 \uC0C1\uC704 \uB514\uB809\uD130\uB9AC\uAC00 \uBC14\uB010 \uB3D9\uC2DC \uACBD\uD569)`,
+        `\uADF8 \uD30C\uC77C\uC740 \uC9C0\uC6B0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. ${outside} \uB97C \uC9C1\uC811 \uD655\uC778\uD558\uC138\uC694.`
+      );
+    }
+    result.written.push(p);
+    if (actual === "overwrite") result.overwritten.push(p);
+  }
+  const broken = [];
+  for (const d of decisions) {
+    if (d.action === "skip") continue;
+    for (const r of d.file.rewritten) {
+      if (!relativeSpecifierResolves(d.file.target, r.to)) {
+        broken.push(`${rel2(root, d.file.target)}: '${r.to}'(\uC6D0\uB798 '${r.from}')\uAC00 \uAC00\uB9AC\uD0A4\uB294 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4`);
+      }
+    }
   }
-  if (!options.category || options.category === "agentic") {
-    showCategory("agentic", components.agentic);
+  const itemNames = items.map((it) => it.name);
+  log(`\uC124\uCE58 \uD56D\uBAA9(${items.length}): ${itemNames.join(", ")}`);
+  for (const p of result.written) {
+    if (result.overwritten.includes(p)) log(`  ~ ${p} (\uB36E\uC5B4\uC500)`);
+    else log(`  + ${p}`);
   }
-  console.log(chalk11.gray("\uC0AC\uC6A9\uBC95: npx @axis-ds/cli add <component-name>"));
-  console.log(chalk11.gray("Agentic: npx @axis-ds/cli add <component-name> --agentic\n"));
-});
+  const outsideRel = new Set([...outsideLinks.keys()].map((f) => rel2(root, f.target)));
+  for (const p of result.unchanged) {
+    log(outsideRel.has(p) ? `  = ${p} (\uAC19\uC740 \uB0B4\uC6A9\uC774\uB77C \uAC74\uB108\uB700, \uB9C1\uD06C \uB300\uC0C1\uC774 \uD504\uB85C\uC81D\uD2B8 \uBC16)` : `  = ${p} (\uAC19\uC740 \uB0B4\uC6A9\uC774\uB77C \uAC74\uB108\uB700)`);
+  }
+  if (result.skipped.length > 0) {
+    log(`\uB0B4\uC6A9\uC774 \uB2E4\uB978 \uAE30\uC874 \uD30C\uC77C ${result.skipped.length}\uAC1C\uB97C \uAC74\uB108\uB6F0\uC5C8\uC2B5\uB2C8\uB2E4(\uB36E\uC5B4\uC4F0\uB824\uBA74 --overwrite):`);
+    for (const p of result.skipped) log(outsideRel.has(p) ? `  - ${p} (\uB9C1\uD06C \uB300\uC0C1\uC774 \uD504\uB85C\uC81D\uD2B8 \uBC16)` : `  - ${p}`);
+  }
+  if (broken.length > 0) {
+    error("\uC124\uCE58\uD55C \uD30C\uC77C\uC758 import \uAC00 \uD480\uB9AC\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4:");
+    for (const b of broken) error(`  - ${b}`);
+    return { ...result, exitCode: 1 };
+  }
+  const deps = missingDependencies(root, items);
+  if (Object.keys(deps.specs).length > 0) {
+    log("\npackage.json \uC5D0 \uC5C6\uB294 \uC758\uC874\uC131(\uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4):");
+    log(`  ${addCommandForSpecs(deps.installCommand, deps.specs)}`);
+  }
+  return { ...result, exitCode: 0 };
+}
+function groupIndex(index) {
+  const ui = [];
+  const agentic = [];
+  for (const it of index.items) {
+    const kind = itemKind(it);
+    if (kind === "lib") continue;
+    const entry = { name: it.name, title: it.title, description: it.description };
+    (kind === "agentic" ? agentic : ui).push(entry);
+  }
+  return { ui, agentic };
+}
+async function createClientFor(cwd, notify, env = process.env) {
+  let config = null;
+  try {
+    config = await readAxisConfig(path15.resolve(cwd));
+  } catch {
+    config = null;
+  }
+  const resolved = resolveRegistryUrl({ config, env });
+  const say = notify ?? ((message) => console.warn(message));
+  if (resolved.migratedFrom !== void 0) say(LEGACY_REGISTRY_NOTICE);
+  return new RegistryClient({ url: resolved.url, ...notify ? { notify } : {} });
+}
+
+// src/add/index.ts
+function createConfirm(interactive) {
+  if (!interactive) return void 0;
+  return async (message) => {
+    const { overwrite } = await prompts3({ type: "confirm", name: "overwrite", message, initial: false });
+    return overwrite === true;
+  };
+}
+var defaultCreateClient = (cwd) => createClientFor(cwd, (m) => console.warn(chalk11.yellow(m)));
+function registerAddCommand(program2, deps = {}) {
+  program2.command("add <components...>").description("\uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC758 \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uD504\uB85C\uC81D\uD2B8\uC5D0 \uBCF5\uC0AC(registryDependencies \uD3EC\uD568)").option("--agentic", "\uC774\uB984 \uC55E\uC5D0 agentic- \uB97C \uBD99\uC5EC \uCC3E\uC74C(\uC804\uCCB4 \uC774\uB984\uB3C4 \uD5C8\uC6A9)").option("-y, --yes", "\uBB3B\uC9C0 \uC54A\uACE0 \uC9C4\uD589. \uB0B4\uC6A9\uC774 \uB2E4\uB978 \uAE30\uC874 \uD30C\uC77C\uC740 \uAC74\uB108\uB700").option("--overwrite", "\uB0B4\uC6A9\uC774 \uB2E4\uB978 \uAE30\uC874 \uD30C\uC77C\uC744 \uB36E\uC5B4\uC500").action(async (components, options) => {
+    const client = await (deps.createClient ?? defaultCreateClient)(process.cwd());
+    const confirm = createConfirm((deps.isInteractive ?? (() => process.stdin.isTTY === true))());
+    const result = await runAdd(process.cwd(), components, options, {
+      client,
+      log: (...a) => console.log(...a),
+      error: (...a) => console.error(chalk11.red(a.map(String).join(" "))),
+      ...confirm ? { confirm } : {}
+    });
+    process.exitCode = result.exitCode;
+  });
+}
+function registerListCommand(program2, deps = {}) {
+  program2.command("list").description("\uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC758 \uCEF4\uD3EC\uB10C\uD2B8 \uBAA9\uB85D").option("--category <type>", "\uCE74\uD14C\uACE0\uB9AC \uD544\uD130 (ui, agentic)").action(async (options) => {
+    if (options.category !== void 0 && options.category !== "ui" && options.category !== "agentic") {
+      console.error(chalk11.red(`--category \uB294 ui \uB610\uB294 agentic \uC785\uB2C8\uB2E4(\uBC1B\uC740 \uAC12: ${options.category})`));
+      process.exitCode = 1;
+      return;
+    }
+    const client = await (deps.createClient ?? defaultCreateClient)(process.cwd());
+    let groups;
+    let version;
+    try {
+      const index = await client.getIndex();
+      groups = groupIndex(index);
+      version = index.version;
+    } catch (e) {
+      console.error(chalk11.red(`\uB808\uC9C0\uC2A4\uD2B8\uB9AC\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${e.message}`));
+      process.exitCode = 1;
+      return;
+    }
+    const total = groups.ui.length + groups.agentic.length;
+    const origin = client.origin === "bundled" ? "CLI \uC5D0 \uD3EC\uD568\uB41C \uB808\uC9C0\uC2A4\uD2B8\uB9AC" : "\uC6D0\uACA9 \uB808\uC9C0\uC2A4\uD2B8\uB9AC";
+    console.log(chalk11.blue(`
+\u{1F4E6} AXIS Design System \uCEF4\uD3EC\uB10C\uD2B8 ${total}\uAC1C (${origin}, version ${version})
+`));
+    const show = (label, items) => {
+      console.log(chalk11.bold(`${label} (${items.length})`));
+      for (const c of items) {
+        console.log(`  ${chalk11.cyan(c.name.padEnd(32))} ${chalk11.gray(c.description ?? c.title ?? "")}`);
+      }
+      console.log();
+    };
+    if (!options.category || options.category === "ui") show("Core UI", groups.ui);
+    if (!options.category || options.category === "agentic") show("Agentic UI", groups.agentic);
+    console.log(chalk11.gray("\uC0AC\uC6A9\uBC95: npx @axis-ds/cli add <\uC774\uB984...>  (\uC608: add button input card)"));
+    console.log(chalk11.gray("Agentic: npx @axis-ds/cli add run-progress --agentic  (= add agentic-run-progress)\n"));
+  });
+}
+
+// src/index.ts
+var { version: CLI_VERSION } = createRequire2(import.meta.url)("../package.json");
+var program = new Command();
+program.name("axis").description("AXIS Design System CLI - shadcn \uD638\uD658 \uCEF4\uD3EC\uB10C\uD2B8 \uC124\uCE58 \uB3C4\uAD6C").version(CLI_VERSION);
+registerInitCommand(program);
+registerAddCommand(program);
+registerListCommand(program);
 var monetCmd = program.command("monet").description("Monet Design \uCEF4\uD3EC\uB10C\uD2B8 \uAD00\uB9AC (https://monet.design)");
 monetCmd.command("list").alias("ls").description("Monet \uCE74\uD14C\uACE0\uB9AC \uBAA9\uB85D").action(async () => {
   const client = new MonetClient();
@@ -3807,24 +5153,24 @@ monetCmd.command("import").alias("i").description("\uD074\uB9BD\uBCF4\uB4DC\uC5D
   await client.importFromClipboard();
 });
 monetCmd.command("setup").description("Monet MCP \uC11C\uBC84 \uC124\uC815 \uC548\uB0B4").action(() => {
-  console.log(chalk11.blue("\n\u{1F527} Monet MCP \uC11C\uBC84 \uC124\uC815\n"));
-  console.log(chalk11.bold("1. API \uD0A4 \uBC1C\uAE09:"));
-  console.log(chalk11.cyan("   https://monet.design/mcp\n"));
-  console.log(chalk11.bold("2. \uD658\uACBD \uBCC0\uC218 \uC124\uC815:"));
-  console.log(chalk11.gray("   .env \uD30C\uC77C\uC5D0 \uCD94\uAC00:"));
-  console.log(chalk11.cyan("   MONET_API_KEY=your-api-key-here\n"));
-  console.log(chalk11.bold("3. Claude Code MCP \uC124\uC815:"));
-  console.log(chalk11.gray("   .claude/mcp.json\uC5D0\uC11C monet \uC11C\uBC84 \uD65C\uC131\uD654:\n"));
+  console.log(chalk12.blue("\n\u{1F527} Monet MCP \uC11C\uBC84 \uC124\uC815\n"));
+  console.log(chalk12.bold("1. API \uD0A4 \uBC1C\uAE09:"));
+  console.log(chalk12.cyan("   https://monet.design/mcp\n"));
+  console.log(chalk12.bold("2. \uD658\uACBD \uBCC0\uC218 \uC124\uC815:"));
+  console.log(chalk12.gray("   .env \uD30C\uC77C\uC5D0 \uCD94\uAC00:"));
+  console.log(chalk12.cyan("   MONET_API_KEY=your-api-key-here\n"));
+  console.log(chalk12.bold("3. Claude Code MCP \uC124\uC815:"));
+  console.log(chalk12.gray("   .claude/mcp.json\uC5D0\uC11C monet \uC11C\uBC84 \uD65C\uC131\uD654:\n"));
   console.log(
-    chalk11.cyan(`   "monet": {
+    chalk12.cyan(`   "monet": {
      "url": "https://www.monet.design/api/remote/mcp",
      "headers": { "Authorization": "Bearer \${MONET_API_KEY}" },
      "disabled": false
    }
 `)
   );
-  console.log(chalk11.bold("4. Claude Code \uC7AC\uC2DC\uC791 \uD6C4 \uC0AC\uC6A9:"));
-  console.log(chalk11.gray('   "monet\uC5D0\uC11C hero \uCEF4\uD3EC\uB10C\uD2B8 \uCC3E\uC544\uC918"\n'));
+  console.log(chalk12.bold("4. Claude Code \uC7AC\uC2DC\uC791 \uD6C4 \uC0AC\uC6A9:"));
+  console.log(chalk12.gray('   "monet\uC5D0\uC11C hero \uCEF4\uD3EC\uB10C\uD2B8 \uCC3E\uC544\uC918"\n'));
 });
 var v0Cmd = program.command("v0").description("V0 (v0.app) \uCF54\uB4DC \uBCC0\uD658 \uBC0F \uD1B5\uD569");
 v0Cmd.command("convert <file>").alias("c").description("V0 \uCF54\uB4DC\uB97C AXIS \uC2A4\uD0C0\uC77C\uB85C \uBCC0\uD658").option("-o, --output <path>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C").action(async (file, options) => {
@@ -3861,18 +5207,18 @@ libraryCmd.command("collect").alias("c").description("\uC678\uBD80 \uC18C\uC2A4\
     total += result.collected;
     failed += result.failed;
   }
-  console.log(chalk11.blue(`
+  console.log(chalk12.blue(`
 \u{1F4CA} \uC218\uC9D1 \uC644\uB8CC: ${total}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8`));
   if (failed > 0) {
-    console.log(chalk11.yellow(`   \uC2E4\uD328: ${failed}\uAC1C`));
+    console.log(chalk12.yellow(`   \uC2E4\uD328: ${failed}\uAC1C`));
   }
 });
 libraryCmd.command("list").alias("ls").description("\uB77C\uC774\uBE0C\uB7EC\uB9AC \uCEF4\uD3EC\uB10C\uD2B8 \uBAA9\uB85D").option("-c, --category <category>", "\uCE74\uD14C\uACE0\uB9AC \uD544\uD130").option("-s, --source <source>", "\uC18C\uC2A4 \uD544\uD130").action(async (options) => {
   const curator = new LibraryCurator();
   const index = await curator.loadIndex();
   if (!index) {
-    console.log(chalk11.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(chalk11.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
+    console.log(chalk12.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk12.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
     return;
   }
   let components = index.components;
@@ -3882,7 +5228,7 @@ libraryCmd.command("list").alias("ls").description("\uB77C\uC774\uBE0C\uB7EC\uB9
   if (options.source) {
     components = components.filter((c) => c.source.type === options.source);
   }
-  console.log(chalk11.blue(`
+  console.log(chalk12.blue(`
 \u{1F4E6} Library Components (${components.length}\uAC1C)
 `));
   const byCategory = /* @__PURE__ */ new Map();
@@ -3894,14 +5240,14 @@ libraryCmd.command("list").alias("ls").description("\uB77C\uC774\uBE0C\uB7EC\uB9
     byCategory.get(cat).push(comp);
   }
   for (const [category, items] of byCategory) {
-    console.log(chalk11.bold(`${category} (${items.length})`));
+    console.log(chalk12.bold(`${category} (${items.length})`));
     for (const item of items.slice(0, 10)) {
       console.log(
-        `  ${chalk11.cyan(item.name.padEnd(25))} ${chalk11.gray(item.source.type.padEnd(8))} ${chalk11.gray(item.description.slice(0, 40))}`
+        `  ${chalk12.cyan(item.name.padEnd(25))} ${chalk12.gray(item.source.type.padEnd(8))} ${chalk12.gray(item.description.slice(0, 40))}`
       );
     }
     if (items.length > 10) {
-      console.log(chalk11.gray(`  ... \uC678 ${items.length - 10}\uAC1C`));
+      console.log(chalk12.gray(`  ... \uC678 ${items.length - 10}\uAC1C`));
     }
     console.log();
   }
@@ -3913,21 +5259,21 @@ libraryCmd.command("search <query>").alias("s").description("\uCEF4\uD3EC\uB10C\
     source: options.source
   });
   if (results.length === 0) {
-    console.log(chalk11.yellow(`
+    console.log(chalk12.yellow(`
 '${query}'\uC5D0 \uB300\uD55C \uAC80\uC0C9 \uACB0\uACFC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.
 `));
     return;
   }
-  console.log(chalk11.blue(`
+  console.log(chalk12.blue(`
 \u{1F50D} '${query}' \uAC80\uC0C9 \uACB0\uACFC (${results.length}\uAC1C)
 `));
   for (const comp of results.slice(0, 20)) {
     console.log(
-      `  ${chalk11.cyan(comp.name.padEnd(25))} ${chalk11.gray(comp.source.type.padEnd(8))} ${chalk11.gray(comp.category.padEnd(12))} ${chalk11.gray(comp.description.slice(0, 30))}`
+      `  ${chalk12.cyan(comp.name.padEnd(25))} ${chalk12.gray(comp.source.type.padEnd(8))} ${chalk12.gray(comp.category.padEnd(12))} ${chalk12.gray(comp.description.slice(0, 30))}`
     );
   }
   if (results.length > 20) {
-    console.log(chalk11.gray(`
+    console.log(chalk12.gray(`
   ... \uC678 ${results.length - 20}\uAC1C`));
   }
   console.log();
@@ -3941,12 +5287,12 @@ libraryCmd.command("publish").description("\uC0AC\uC774\uD2B8\uC5D0 \uB77C\uC774
   const publisher2 = new Publisher();
   const index = await curator.loadIndex();
   if (!index) {
-    console.log(chalk11.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(chalk11.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
+    console.log(chalk12.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk12.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
     return;
   }
-  console.log(chalk11.blue("\n\u{1F4E4} Library \uBC30\uCE58\n"));
-  console.log(chalk11.gray(`\uCD1D ${index.stats.total}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8
+  console.log(chalk12.blue("\n\u{1F4E4} Library \uBC30\uCE58\n"));
+  console.log(chalk12.gray(`\uCD1D ${index.stats.total}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8
 `));
   if (options.clean) {
     await publisher2.clean(options.output);
@@ -3957,17 +5303,17 @@ libraryCmd.command("publish").description("\uC0AC\uC774\uD2B8\uC5D0 \uB77C\uC774
     generateSearchIndex: true
   });
   if (result.success) {
-    console.log(chalk11.green(`
+    console.log(chalk12.green(`
 \u2713 \uBC30\uCE58 \uC644\uB8CC`));
-    console.log(chalk11.gray(`  - \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC: ${result.outputDir}`));
-    console.log(chalk11.gray(`  - \uC0DD\uC131\uB41C \uD30C\uC77C: ${result.files.length}\uAC1C`));
-    console.log(chalk11.gray(`  - \uCE74\uD14C\uACE0\uB9AC: ${result.stats.categoriesPublished}\uAC1C`));
-    console.log(chalk11.gray(`  - \uAC80\uC0C9 \uC778\uB371\uC2A4: ${result.stats.searchIndexSize}\uAC1C \uD56D\uBAA9`));
+    console.log(chalk12.gray(`  - \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC: ${result.outputDir}`));
+    console.log(chalk12.gray(`  - \uC0DD\uC131\uB41C \uD30C\uC77C: ${result.files.length}\uAC1C`));
+    console.log(chalk12.gray(`  - \uCE74\uD14C\uACE0\uB9AC: ${result.stats.categoriesPublished}\uAC1C`));
+    console.log(chalk12.gray(`  - \uAC80\uC0C9 \uC778\uB371\uC2A4: ${result.stats.searchIndexSize}\uAC1C \uD56D\uBAA9`));
   } else {
-    console.log(chalk11.red(`
+    console.log(chalk12.red(`
 \u2717 \uBC30\uCE58 \uC2E4\uD328`));
     for (const error of result.errors) {
-      console.log(chalk11.red(`  - ${error}`));
+      console.log(chalk12.red(`  - ${error}`));
     }
   }
   console.log();
@@ -3976,64 +5322,4 @@ registerSyncCommand(program);
 registerTemplateCommand(program);
 registerCheckCommand(program);
 registerThemeCommand(program);
-async function getComponentInfo(name, category) {
-  const localComponents = {
-    button: {
-      name: "button",
-      type: "ui",
-      description: "Primary button component",
-      dependencies: ["@radix-ui/react-slot", "class-variance-authority", "clsx", "tailwind-merge"],
-      files: [
-        {
-          path: "button.tsx",
-          content: `import * as React from "react"
-import { Slot } from "@radix-ui/react-slot"
-import { cva, type VariantProps } from "class-variance-authority"
-import { cn } from "./utils"
-
-const buttonVariants = cva(
-  "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
-  {
-    variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground hover:bg-primary/90",
-        secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        ghost: "hover:bg-accent hover:text-accent-foreground",
-        destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
-        outline: "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        sm: "h-8 px-3 text-xs",
-        default: "h-10 px-4 py-2",
-        lg: "h-12 px-6 text-base",
-        icon: "h-10 w-10",
-      },
-    },
-    defaultVariants: { variant: "default", size: "default" },
-  }
-)
-
-export interface ButtonProps
-  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {
-  asChild?: boolean
-}
-
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button"
-    return <Comp className={cn(buttonVariants({ variant, size, className }))} ref={ref} {...props} />
-  }
-)
-Button.displayName = "Button"
-
-export { Button, buttonVariants }
-`
-        }
-      ]
-    }
-  };
-  return localComponents[name] || null;
-}
 program.parse();