teamix-evo 0.7.0 → 0.8.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command32 } from "commander";
+import { Command as Command37 } from "commander";
 import { createRequire as createRequire8 } from "module";
 
 // src/commands/tokens/index.ts
@@ -69,7 +69,6 @@ function detectIde() {
 // src/core/tokens-init.ts
 import * as path9 from "path";
 import * as fs6 from "fs/promises";
-import { createRequire as createRequire2 } from "module";
 import {
   loadTokensPackageManifest,
   getVariantEntry
@@ -165,6 +164,19 @@ import {
   validateSkillsLock,
   TokensPackLockSchema
 } from "@teamix-evo/registry";
+
+// src/utils/error.ts
+function getErrorMessage(err) {
+  if (err instanceof Error) return err.message;
+  if (typeof err === "string") return err;
+  try {
+    return JSON.stringify(err);
+  } catch {
+    return String(err);
+  }
+}
+
+// src/core/state.ts
 var TEAMIX_DIR = ".teamix-evo";
 var CONFIG_FILE = "config.json";
 var MANIFEST_FILE = "manifest.json";
@@ -188,7 +200,7 @@ async function readProjectConfig(projectRoot) {
     data = JSON.parse(raw);
   } catch (err) {
     throw new Error(
-      `Corrupted config.json (${err.message}). Fix the JSON manually or remove the file to start fresh; refusing to clobber prior config.`
+      `Corrupted config.json (${getErrorMessage(err)}). Fix the JSON manually or remove the file to start fresh; refusing to clobber prior config.`
     );
   }
   const result = validateConfig(data);
@@ -213,7 +225,7 @@ async function readInstalledManifest(projectRoot) {
     data = JSON.parse(raw);
   } catch (err) {
     throw new Error(
-      `Corrupted manifest.json (${err.message}). Fix the JSON manually or remove the file to start fresh; refusing to clobber prior install records.`
+      `Corrupted manifest.json (${getErrorMessage(err)}). Fix the JSON manually or remove the file to start fresh; refusing to clobber prior install records.`
     );
   }
   const result = validateInstalled(data);
@@ -241,9 +253,7 @@ async function readTokensLock(projectRoot) {
     }
     return parsed.data;
   } catch (err) {
-    logger.warn(
-      `Failed to parse tokens-lock.json: ${err.message}`
-    );
+    logger.warn(`Failed to parse tokens-lock.json: ${getErrorMessage(err)}`);
     return null;
   }
 }
@@ -274,7 +284,7 @@ async function readSkillsLock(projectRoot) {
     return result.data;
   } catch (err) {
     logger.warn(
-      `Failed to parse skills manifest.lock.json: ${err.message}`
+      `Failed to parse skills manifest.lock.json: ${getErrorMessage(err)}`
     );
     return null;
   }
@@ -289,6 +299,12 @@ async function writeSkillsLock(projectRoot, lock) {
   await writeFileSafe(lockPath, JSON.stringify(lock, null, 2) + "\n");
   logger.debug(`Wrote skills lock \u2192 ${lockPath}`);
 }
+function findInstalledPackage(installed, packageName) {
+  if (!installed) return null;
+  const matches = installed.installed.filter((p2) => p2.package === packageName);
+  if (matches.length === 0) return null;
+  return matches[matches.length - 1] ?? null;
+}
 
 // src/core/skills-client.ts
 import * as path5 from "path";
@@ -323,7 +339,9 @@ import * as path7 from "path";
 import * as fs5 from "fs/promises";
 import {
   replaceManagedRegion,
-  hasManagedRegion
+  hasManagedRegion,
+  extractFrontmatter,
+  replaceFrontmatter
 } from "@teamix-evo/registry";
 
 // src/utils/template.ts
@@ -357,6 +375,8 @@ async function loadTemplateFile(filePath) {
 // src/utils/path.ts
 import * as path6 from "path";
 import * as fs4 from "fs/promises";
+import { createRequire as createRequire2 } from "module";
+var require3 = createRequire2(import.meta.url);
 async function walkDir(dir) {
   const files = [];
   const entries = await fs4.readdir(dir, { withFileTypes: true });
@@ -370,6 +390,10 @@ async function walkDir(dir) {
   }
   return files;
 }
+function resolveTokensPackageRoot(packageName) {
+  const pkgJson = require3.resolve(`${packageName}/package.json`);
+  return path6.dirname(pkgJson);
+}
 
 // src/core/skills-installer.ts
 async function installSkills(options) {
@@ -406,9 +430,9 @@ async function writeSkillSource(skill, options) {
   const { data, packageRoot, projectRoot } = options;
   const sourceAbs = path7.resolve(packageRoot, skill.source);
   const targetDir = getSkillsSourceDir(projectRoot, skill.name);
-  const stat4 = await fs5.stat(sourceAbs);
+  const stat7 = await fs5.stat(sourceAbs);
   const records = [];
-  if (stat4.isFile()) {
+  if (stat7.isFile()) {
     const targetFile = path7.join(targetDir, "SKILL.md");
     const content = await renderSkillContent(sourceAbs, skill, data);
     await writeFileSafe(targetFile, content);
@@ -475,6 +499,10 @@ async function writeMirrorContent(targetFile, sourceContent, managedRegions, sou
     return existing;
   }
   let merged = existing;
+  const upstreamFm = extractFrontmatter(sourceContent);
+  if (upstreamFm) {
+    merged = replaceFrontmatter(merged, upstreamFm);
+  }
   for (const id of matchedRegions) {
     const newRegion = extractRegionBody(sourceContent, id);
     if (newRegion === null) continue;
@@ -536,11 +564,7 @@ async function updateSkills(options) {
     if (idFilter && !idFilter.has(skill.id)) continue;
     const skillIdes = skill.ides.filter((i) => ides.includes(i));
     if (skillIdes.length === 0) continue;
-    const sourceRecords = await rewriteSkillSource(
-      skill,
-      options,
-      summary
-    );
+    const sourceRecords = await rewriteSkillSource(skill, options, summary);
     updated.push(...sourceRecords);
     for (const ide of skillIdes) {
       const mirrorRecords = await mirrorSkillToIde(
@@ -558,8 +582,8 @@ async function rewriteSkillSource(skill, options, summary) {
   const { data, packageRoot, projectRoot } = options;
   const sourceAbs = path7.resolve(packageRoot, skill.source);
   const targetDir = getSkillsSourceDir(projectRoot, skill.name);
-  const stat4 = await fs5.stat(sourceAbs);
-  if (!stat4.isFile()) {
+  const stat7 = await fs5.stat(sourceAbs);
+  if (!stat7.isFile()) {
     await ensureDir(targetDir);
     const entries = await walkDir(sourceAbs);
     const records = [];
@@ -630,6 +654,10 @@ async function rewriteSingleFile(args) {
   }
   const current = await readFileOrNull(targetFile);
   let merged = current ?? newContent;
+  const upstreamFm = extractFrontmatter(newContent);
+  if (upstreamFm) {
+    merged = replaceFrontmatter(merged, upstreamFm);
+  }
   for (const regionId of managedRegions ?? []) {
     const re = new RegExp(
       `<!-- teamix-evo:managed:start id="${escapeRegExp(
@@ -712,7 +740,7 @@ async function removeSkillFiles(records) {
       removed.push(r.target);
     } catch (err) {
       if (err.code !== "ENOENT") {
-        logger.warn(`Failed to remove ${r.target}: ${err.message}`);
+        logger.warn(`Failed to remove ${r.target}: ${getErrorMessage(err)}`);
       }
     }
   }
@@ -747,11 +775,14 @@ async function ensureMcpJson(projectRoot) {
   const mcpPath = path8.join(projectRoot, ".mcp.json");
   if (await fileExists(mcpPath)) return "exists";
   try {
-    await writeFileSafe(mcpPath, JSON.stringify(MCP_JSON_CONTENT, null, 2) + "\n");
+    await writeFileSafe(
+      mcpPath,
+      JSON.stringify(MCP_JSON_CONTENT, null, 2) + "\n"
+    );
     logger.debug(`Wrote .mcp.json \u2192 ${mcpPath}`);
     return "created";
   } catch (err) {
-    logger.warn(`Failed to write .mcp.json: ${err.message}`);
+    logger.warn(`Failed to write .mcp.json: ${getErrorMessage(err)}`);
     return "failed";
   }
 }
@@ -889,7 +920,7 @@ async function runSkillsAdd(options) {
 }
 async function readExistingState(projectRoot, packageName) {
   const installed = await readInstalledManifest(projectRoot);
-  const pkg = installed?.installed.find((p) => p.package === packageName);
+  const pkg = installed?.installed.find((p2) => p2.package === packageName);
   const lock = await readSkillsLock(projectRoot);
   const skillIds = /* @__PURE__ */ new Set([
     ...Object.keys(lock?.skills ?? {}),
@@ -924,8 +955,8 @@ async function finalizeSkillsInstall(args) {
     onlyIds
   });
   const config = existingConfig ?? {
-    $schema: "https://teamix-evo.dev/schema/config/v1.json",
-    schemaVersion: 1,
+    $schema: "https://teamix-evo.dev/schema/config/v2.json",
+    schemaVersion: 2,
     ide: ideIdent,
     packages: {}
   };
@@ -942,7 +973,7 @@ async function finalizeSkillsInstall(args) {
     installed: []
   };
   const idx = installedManifest.installed.findIndex(
-    (p) => p.package === packageName
+    (p2) => p2.package === packageName
   );
   const mergedResources = mergeInstalledResources(
     existing.pkg?.resources ?? [],
@@ -1008,7 +1039,6 @@ var CONSUMER_OVERRIDES_FILE = "tokens.overrides.css";
 var EMPTY_OVERRIDES_TEMPLATE = `/* User-owned token overrides \u2014 frozen on subsequent installs. */
 /* See @teamix-evo/tokens variant theme.css for available CSS custom properties. */
 `;
-var require3 = createRequire2(import.meta.url);
 async function runTokensInit(options) {
   const { projectRoot, variant, ide } = options;
   const packageName = options.packageName ?? DEFAULT_TOKENS_PACKAGE;
@@ -1072,8 +1102,8 @@ Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
     JSON.stringify(lock, null, 2) + "\n"
   );
   const config = {
-    $schema: "https://teamix-evo.dev/schema/config/v1.json",
-    schemaVersion: 1,
+    $schema: "https://teamix-evo.dev/schema/config/v2.json",
+    schemaVersion: 2,
     ide: existingConfig?.ide ?? ide,
     packages: {
       ...existingConfig?.packages ?? {},
@@ -1089,7 +1119,7 @@ Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
     schemaVersion: 1,
     installed: []
   };
-  const tokensIdx = prior.installed.findIndex((p) => p.package === packageName);
+  const tokensIdx = prior.installed.findIndex((p2) => p2.package === packageName);
   const tokensEntry = {
     package: packageName,
     variant,
@@ -1126,7 +1156,9 @@ async function tryAutoInstallVariantSkills(args) {
     manifestSkillIds = new Set(manifest.skills.map((s) => s.id));
   } catch (err) {
     logger.warn(
-      `Skipping skills auto-install: could not load skills manifest (${err.message}).`
+      `Skipping skills auto-install: could not load skills manifest (${getErrorMessage(
+        err
+      )}).`
     );
     return {
       attempted: [],
@@ -1176,7 +1208,7 @@ async function tryAutoInstallVariantSkills(args) {
     };
   } catch (err) {
     logger.warn(
-      `Skills auto-install failed (continuing): ${err.message}`
+      `Skills auto-install failed (continuing): ${getErrorMessage(err)}`
     );
     return {
       attempted: desired,
@@ -1190,10 +1222,7 @@ async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
   const sourceAbs = path9.join(packageRoot, fileRelToPackage);
   const base = path9.basename(fileRelToPackage);
   if (base === "theme.css") {
-    const targetRel = path9.posix.join(
-      CONSUMER_TOKENS_DIR,
-      CONSUMER_THEME_FILE
-    );
+    const targetRel = path9.posix.join(CONSUMER_TOKENS_DIR, CONSUMER_THEME_FILE);
     const targetAbs = path9.join(projectRoot, targetRel);
     const content = await fs6.readFile(sourceAbs, "utf-8");
     await writeFileSafe(targetAbs, content);
@@ -1230,10 +1259,6 @@ async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
   }
   return null;
 }
-function resolveTokensPackageRoot(packageName) {
-  const pkgJson = require3.resolve(`${packageName}/package.json`);
-  return path9.dirname(pkgJson);
-}
 async function listTokenVariants(packageName = DEFAULT_TOKENS_PACKAGE, packageRoot) {
   const root = packageRoot ?? resolveTokensPackageRoot(packageName);
   const catalog = await loadTokensPackageManifest(root);
@@ -1313,7 +1338,9 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
       );
       logger.info("To switch variants:");
       logger.info("  1. npx teamix-evo@latest tokens uninstall --yes");
-      logger.info(`  2. npx teamix-evo@latest tokens init ${result.requestedVariant}`);
+      logger.info(
+        `  2. npx teamix-evo@latest tokens init ${result.requestedVariant}`
+      );
       logger.info(
         "Note: tokens.overrides.css (frozen) is preserved across uninstall/init by default."
       );
@@ -1329,13 +1356,13 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
     if (result.skills) {
       const { addedSkillIds, skippedSkillIds, missing } = result.skills;
       if (addedSkillIds.length > 0) {
-        logger.info(
-          `  Skills:   auto-installed ${addedSkillIds.join(", ")}`
-        );
+        logger.info(`  Skills:   auto-installed ${addedSkillIds.join(", ")}`);
       }
       if (skippedSkillIds.length > 0) {
         logger.info(
-          `  Skills:   already installed (skipped) ${skippedSkillIds.join(", ")}`
+          `  Skills:   already installed (skipped) ${skippedSkillIds.join(
+            ", "
+          )}`
         );
       }
       if (missing.length > 0) {
@@ -1345,12 +1372,14 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
       }
     }
     logger.info("");
-    logger.info('Run "npx teamix-evo@latest tokens update" to update resources later.');
+    logger.info(
+      'Run "npx teamix-evo@latest tokens update" to update resources later.'
+    );
     logger.info(
       'Run "npx teamix-evo@latest tokens list-variants" to see all available variants.'
     );
   } catch (err) {
-    logger.error(`Failed to initialize: ${err.message}`);
+    logger.error(`Failed to initialize: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
@@ -1360,17 +1389,94 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
 import { Command as Command2 } from "commander";
 
 // src/core/tokens-update.ts
-import * as path11 from "path";
+import * as path12 from "path";
 import * as fs8 from "fs/promises";
-import { createRequire as createRequire3 } from "module";
 import {
   loadTokensPackageManifest as loadTokensPackageManifest2,
   getVariantEntry as getVariantEntry2
 } from "@teamix-evo/registry";
+
+// src/core/upgrade-hints.ts
+import * as path11 from "path";
+var TEAMIX_DIR3 = ".teamix-evo";
+var HINTS_DIR = ".upgrade-hints";
+function isoToFsSafe(iso) {
+  return iso.replace(/[:.]/g, "-");
+}
+async function writeTokensUpgradeHint(options) {
+  if (options.renames.length === 0) return null;
+  const isoTs = options.isoTs ?? (/* @__PURE__ */ new Date()).toISOString();
+  const fsTs = isoToFsSafe(isoTs);
+  const filename = `tokens-${fsTs}.json`;
+  const target = path11.join(
+    options.projectRoot,
+    TEAMIX_DIR3,
+    HINTS_DIR,
+    filename
+  );
+  const payload = {
+    schemaVersion: 1,
+    ts: isoTs,
+    package: "tokens",
+    trigger: options.trigger,
+    fromVariant: options.fromVariant,
+    toVariant: options.toVariant,
+    fromVersion: options.fromVersion,
+    toVersion: options.toVersion,
+    renames: options.renames
+  };
+  await writeFileSafe(target, JSON.stringify(payload, null, 2) + "\n");
+  return {
+    path: target,
+    ts: fsTs,
+    renameCount: options.renames.length
+  };
+}
+function selectApplicableRenames(renames, fromVersion, toVersion) {
+  return renames.filter(
+    (r) => compareSemver(r.sinceVersion, fromVersion) > 0 && compareSemver(r.sinceVersion, toVersion) <= 0
+  ).sort((a, b) => compareSemver(a.sinceVersion, b.sinceVersion));
+}
+function compareSemver(a, b) {
+  const [aMain = "", aRest = ""] = a.split("-", 2);
+  const [bMain = "", bRest = ""] = b.split("-", 2);
+  const aParts = aMain.split(".").map((n) => Number.parseInt(n, 10));
+  const bParts = bMain.split(".").map((n) => Number.parseInt(n, 10));
+  for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+    const ai = aParts[i] ?? 0;
+    const bi = bParts[i] ?? 0;
+    if (ai !== bi) return ai - bi;
+  }
+  if (aRest === "" && bRest !== "") return 1;
+  if (aRest !== "" && bRest === "") return -1;
+  return aRest.localeCompare(bRest, void 0, { numeric: true });
+}
+
+// src/core/managed-merge.ts
+import { hasManagedRegion as hasManagedRegion2, replaceManagedRegion as replaceManagedRegion2 } from "@teamix-evo/registry";
+function mergeManagedRegions(upstreamContent, consumerContent) {
+  let updated = consumerContent;
+  const re = /<!-- teamix-evo:managed:start id="([^"]+)" -->([\s\S]*?)<!-- teamix-evo:managed:end(?: id="\1")? -->/g;
+  let match;
+  while ((match = re.exec(upstreamContent)) !== null) {
+    const id = match[1];
+    const body = match[2].replace(/^\n/, "").replace(/\n$/, "");
+    if (!hasManagedRegion2(updated, id)) {
+      throw new Error(
+        `Managed region "${id}" missing from consumer file \u2014 refusing to silently rewrite (ADR 0003).`
+      );
+    }
+    updated = replaceManagedRegion2(updated, id, body);
+  }
+  return updated;
+}
+
+// src/core/tokens-update.ts
 var DEFAULT_TOKENS_PACKAGE2 = "@teamix-evo/tokens";
-var CONSUMER_TOKENS_DIR2 = "tokens";
-var CONSUMER_THEME_FILE2 = "tokens.theme.css";
-var require4 = createRequire3(import.meta.url);
+var CONSUMER_BASENAME_BY_UPSTREAM = {
+  "theme.css": "tokens.theme.css",
+  "overrides.css": "tokens.overrides.css"
+};
 async function runTokensUpdate(options) {
   const { projectRoot } = options;
   const packageName = options.packageName ?? DEFAULT_TOKENS_PACKAGE2;
@@ -1380,7 +1486,7 @@ async function runTokensUpdate(options) {
   }
   const currentVariant = config.packages.tokens.variant;
   const currentVersion = config.packages.tokens.version;
-  const packageRoot = options.packageRoot ?? resolveTokensPackageRoot2(packageName);
+  const packageRoot = options.packageRoot ?? resolveTokensPackageRoot(packageName);
   const catalog = await loadTokensPackageManifest2(packageRoot);
   const variantEntry = getVariantEntry2(catalog, currentVariant);
   if (!variantEntry) {
@@ -1388,27 +1494,92 @@ async function runTokensUpdate(options) {
       `Currently installed variant "${currentVariant}" no longer exists in ${packageName}@${catalog.version}. Available: ${catalog.variants.map((v) => v.name).join(", ")}. Run \`npx teamix-evo@latest tokens uninstall\` then \`npx teamix-evo@latest tokens init <variant>\` to switch.`
     );
   }
+  const upstreamByBasename = /* @__PURE__ */ new Map();
+  for (const fileRel of variantEntry.files) {
+    upstreamByBasename.set(
+      path12.basename(fileRel),
+      path12.join(packageRoot, fileRel)
+    );
+  }
+  const prior = await readInstalledManifest(projectRoot) ?? {
+    schemaVersion: 1,
+    installed: []
+  };
+  const installedIdx = prior.installed.findIndex(
+    (p2) => p2.package === packageName
+  );
+  const priorResources = installedIdx >= 0 ? prior.installed[installedIdx].resources : [];
+  const rewritten = [];
+  const managedReplaced = [];
+  const preserved = [];
+  const frozenDrift = [];
+  const refreshedResources = [];
+  for (const resource of priorResources) {
+    const consumerAbs = path12.isAbsolute(resource.target) ? resource.target : path12.join(projectRoot, resource.target);
+    const consumerBasename = path12.basename(resource.target);
+    const upstreamBasename = lookupUpstreamBasename(consumerBasename);
+    const upstreamAbs = upstreamBasename ? upstreamByBasename.get(upstreamBasename) : void 0;
+    if (resource.strategy === "regenerable") {
+      if (!upstreamAbs) {
+        refreshedResources.push(resource);
+        continue;
+      }
+      const content = await fs8.readFile(upstreamAbs, "utf-8");
+      await writeFileSafe(consumerAbs, content);
+      rewritten.push(resource.target);
+      refreshedResources.push({
+        ...resource,
+        hash: computeHash(content)
+      });
+      continue;
+    }
+    if (resource.strategy === "managed") {
+      if (!upstreamAbs || !await fileExists(consumerAbs)) {
+        refreshedResources.push(resource);
+        continue;
+      }
+      const upstreamContent = await fs8.readFile(upstreamAbs, "utf-8");
+      const consumerContent = await fs8.readFile(consumerAbs, "utf-8");
+      const merged = mergeManagedRegions(upstreamContent, consumerContent);
+      if (merged !== consumerContent) {
+        await writeFileSafe(consumerAbs, merged);
+        managedReplaced.push(resource.target);
+      }
+      refreshedResources.push({
+        ...resource,
+        hash: computeHash(merged)
+      });
+      continue;
+    }
+    if (await fileExists(consumerAbs)) preserved.push(resource.target);
+    if (upstreamAbs) {
+      const upstreamContent = await fs8.readFile(upstreamAbs, "utf-8");
+      const upstreamHash = computeHash(upstreamContent);
+      if (resource.hash && upstreamHash !== resource.hash) {
+        frozenDrift.push({
+          target: resource.target,
+          reason: "upstream-changed"
+        });
+      }
+    }
+    refreshedResources.push(resource);
+  }
   if (variantEntry.version === currentVersion) {
-    await rewriteRegenerableFiles(variantEntry.files, packageRoot, projectRoot);
+    if (installedIdx >= 0) {
+      prior.installed[installedIdx] = {
+        ...prior.installed[installedIdx],
+        resources: refreshedResources
+      };
+      await writeInstalledManifest(projectRoot, prior);
+    }
     return {
       status: "up-to-date",
       packageName,
       variant: currentVariant,
-      version: currentVersion
+      version: currentVersion,
+      frozenDrift
     };
   }
-  const rewritten = await rewriteRegenerableFiles(
-    variantEntry.files,
-    packageRoot,
-    projectRoot
-  );
-  const preserved = [];
-  const overridesAbs = path11.join(
-    projectRoot,
-    CONSUMER_TOKENS_DIR2,
-    "tokens.overrides.css"
-  );
-  if (await fileExists(overridesAbs)) preserved.push("tokens.overrides.css");
   const lock = {
     schemaVersion: 1,
     variant: {
@@ -1422,29 +1593,38 @@ async function runTokensUpdate(options) {
     installedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   await writeFileSafe(
-    path11.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
+    path12.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
     JSON.stringify(lock, null, 2) + "\n"
   );
   config.packages.tokens.version = variantEntry.version;
   await writeProjectConfig(projectRoot, config);
-  const prior = await readInstalledManifest(projectRoot) ?? {
-    schemaVersion: 1,
-    installed: []
-  };
-  const idx = prior.installed.findIndex((p) => p.package === packageName);
-  if (idx >= 0) {
-    prior.installed[idx].version = variantEntry.version;
-    prior.installed[idx].installedAt = (/* @__PURE__ */ new Date()).toISOString();
-    for (const r of prior.installed[idx].resources) {
-      if (r.strategy === "regenerable") {
-        const abs = path11.isAbsolute(r.target) ? r.target : path11.join(projectRoot, r.target);
-        if (await fileExists(abs)) {
-          r.hash = computeHash(await fs8.readFile(abs, "utf-8"));
-        }
-      }
-    }
+  if (installedIdx >= 0) {
+    prior.installed[installedIdx] = {
+      ...prior.installed[installedIdx],
+      version: variantEntry.version,
+      installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      resources: refreshedResources
+    };
     await writeInstalledManifest(projectRoot, prior);
   }
+  const renames = selectApplicableRenames(
+    variantEntry.renames ?? [],
+    currentVersion,
+    variantEntry.version
+  );
+  let hintPath;
+  if (renames.length > 0) {
+    const hint = await writeTokensUpgradeHint({
+      projectRoot,
+      trigger: "update",
+      fromVariant: currentVariant,
+      toVariant: currentVariant,
+      fromVersion: currentVersion,
+      toVersion: variantEntry.version,
+      renames
+    });
+    if (hint) hintPath = hint.path;
+  }
   return {
     status: "updated",
     packageName,
@@ -1452,34 +1632,25 @@ async function runTokensUpdate(options) {
     from: currentVersion,
     to: variantEntry.version,
     rewritten,
-    preserved
+    managedReplaced,
+    preserved,
+    frozenDrift,
+    renames,
+    ...hintPath ? { hintPath } : {}
   };
 }
-async function rewriteRegenerableFiles(files, packageRoot, projectRoot) {
-  const written = [];
-  for (const fileRel of files) {
-    const base = path11.basename(fileRel);
-    if (base !== "theme.css") continue;
-    const sourceAbs = path11.join(packageRoot, fileRel);
-    const targetAbs = path11.join(
-      projectRoot,
-      CONSUMER_TOKENS_DIR2,
-      CONSUMER_THEME_FILE2
-    );
-    const content = await fs8.readFile(sourceAbs, "utf-8");
-    await writeFileSafe(targetAbs, content);
-    written.push(CONSUMER_THEME_FILE2);
+function lookupUpstreamBasename(consumerBasename) {
+  for (const [upstream, consumer] of Object.entries(
+    CONSUMER_BASENAME_BY_UPSTREAM
+  )) {
+    if (consumer === consumerBasename) return upstream;
   }
-  return written;
-}
-function resolveTokensPackageRoot2(packageName) {
-  const pkgJson = require4.resolve(`${packageName}/package.json`);
-  return path11.dirname(pkgJson);
+  return consumerBasename;
 }
 
 // src/commands/tokens/update.ts
 var updateCommand = new Command2("update").description(
-  "\u5237\u65B0 design tokens\uFF08regenerable \u8986\u76D6\u3001frozen \u4FDD\u7559 \u2014 ADR 0003 \u4E09\u6001\uFF09"
+  "\u5237\u65B0 design tokens\uFF08regenerable \u8986\u76D6 / managed \u533A\u6BB5\u66FF\u6362 / frozen \u4FDD\u7559 \u2014 ADR 0003 \u4E09\u6001\uFF09"
 ).action(async () => {
   try {
     const ide = detectIde();
@@ -1496,9 +1667,8 @@ var updateCommand = new Command2("update").description(
       logger.success(
         `Already at latest: ${result.packageName} (${result.variant} v${result.version})`
       );
-      logger.info(
-        "  Regenerable files refreshed in case of manual edits."
-      );
+      logger.info("  Regenerable files refreshed in case of manual edits.");
+      printFrozenDrift(result.frozenDrift);
       return;
     }
     logger.success(
@@ -1507,17 +1677,41 @@ var updateCommand = new Command2("update").description(
     if (result.rewritten.length > 0) {
       logger.info(`  Rewrote:  ${result.rewritten.join(", ")}`);
     }
+    if (result.managedReplaced.length > 0) {
+      logger.info(
+        `  Managed regions updated: ${result.managedReplaced.join(", ")}`
+      );
+    }
     if (result.preserved.length > 0) {
       logger.info(
-        `  Preserved: ${result.preserved.join(", ")} (frozen \u2014 your customizations kept)`
+        `  Preserved: ${result.preserved.join(
+          ", "
+        )} (frozen \u2014 your customizations kept)`
+      );
+    }
+    printFrozenDrift(result.frozenDrift);
+    if (result.hintPath) {
+      logger.info("");
+      logger.info(`\u{1F4A1} token rename hint: ${result.hintPath}`);
+      logger.info(
+        `   \u68C0\u6D4B\u5230 ${result.renames.length} \u4E2A token rename\uFF0C\u5EFA\u8BAE\u8C03\u7528 \`teamix-evo-upgrade\` skill \u626B src/** \u7ED9 codemod \u5EFA\u8BAE\uFF08ADR 0019 \xA7D4\uFF09\u3002`
       );
     }
   } catch (err) {
-    logger.error(`Failed to update tokens: ${err.message}`);
+    logger.error(`Failed to update tokens: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
 });
+function printFrozenDrift(drift) {
+  if (drift.length === 0) return;
+  logger.warn(
+    `  \u26A0\uFE0F frozen drift\uFF08\u4E0A\u6E38\u6709\u53D8\u52A8\uFF0C\u4F46\u672C\u5730\u5C5E\u7528\u6237\u53D7\u63A7\u6587\u4EF6 \u2014 ADR 0019 \xA7D2\uFF09\uFF1A${drift.map((d) => d.target).join(", ")}`
+  );
+  logger.info(
+    "     \u5982\u9700\u5BF9\u7167\u4E0A\u6E38\u53D8\u52A8\uFF0C\u8BF7\u624B\u52A8 diff \u6216\u540E\u7EED\u4F7F\u7528 `--accept-upstream <target>`\uFF08\u5F85\u6279\u6B21 5 \u843D\u5730\uFF09\u3002"
+  );
+}
 
 // src/commands/tokens/list.ts
 import { Command as Command3 } from "commander";
@@ -1528,7 +1722,9 @@ var listCommand = new Command3("list").description("\u5217\u51FA\u5DF2\u5B89\u88
     const config = await readProjectConfig(projectRoot);
     if (!config?.packages?.tokens) {
       logger.info("No tokens variant installed.");
-      logger.info('Run "npx teamix-evo@latest tokens init [variant]" to get started.');
+      logger.info(
+        'Run "npx teamix-evo@latest tokens init [variant]" to get started.'
+      );
       return;
     }
     const { variant, version: version2 } = config.packages.tokens;
@@ -1540,7 +1736,7 @@ var listCommand = new Command3("list").description("\u5217\u51FA\u5DF2\u5B89\u88
     const manifest = await readInstalledManifest(projectRoot);
     if (manifest) {
       const pkg = manifest.installed.find(
-        (p) => p.package === "@teamix-evo/tokens" && p.variant === variant
+        (p2) => p2.package === "@teamix-evo/tokens" && p2.variant === variant
       );
       if (pkg) {
         logger.info(`  Resources: ${pkg.resources.length} files`);
@@ -1550,7 +1746,7 @@ var listCommand = new Command3("list").description("\u5217\u51FA\u5DF2\u5B89\u88
       }
     }
   } catch (err) {
-    logger.error(`Failed to list: ${err.message}`);
+    logger.error(`Failed to list: ${getErrorMessage(err)}`);
     process.exitCode = 1;
   }
 });
@@ -1580,9 +1776,11 @@ var listVariantsCommand = new Command4("list-variants").description("\u5217\u51F
       }
       logger.info("");
     }
-    logger.info("Install a variant: npx teamix-evo@latest tokens init <name>");
+    logger.info(
+      "Install a variant: npx teamix-evo@latest tokens init <name>"
+    );
   } catch (err) {
-    logger.error(`Failed to list variants: ${err.message}`);
+    logger.error(`Failed to list variants: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
@@ -1591,7 +1789,7 @@ var listVariantsCommand = new Command4("list-variants").description("\u5217\u51F
 // src/commands/tokens/uninstall.ts
 import { Command as Command5 } from "commander";
 import * as fs9 from "fs/promises";
-import * as path12 from "path";
+import * as path13 from "path";
 import * as prompts from "@clack/prompts";
 var TOKENS_PACKAGE = "@teamix-evo/tokens";
 var uninstallCommand = new Command5("uninstall").description(
@@ -1613,7 +1811,7 @@ var uninstallCommand = new Command5("uninstall").description(
     }
     const installedManifest = await readInstalledManifest(projectRoot);
     const pkg = installedManifest?.installed.find(
-      (p) => p.package === TOKENS_PACKAGE
+      (p2) => p2.package === TOKENS_PACKAGE
     );
     const resources = pkg?.resources ?? [];
     const removable = opts.keepFiles ? [] : opts.purge ? resources.filter((r) => r.strategy !== "managed") : resources.filter((r) => r.strategy === "regenerable");
@@ -1622,38 +1820,36 @@ var uninstallCommand = new Command5("uninstall").description(
       `Will remove ${removable.length} file(s); keep ${kept} managed file(s).`
     );
     if (!opts.yes) {
-      const confirm5 = await prompts.confirm({
+      const confirm8 = await prompts.confirm({
         message: "\u786E\u8BA4\u5378\u8F7D tokens \u53D8\u4F53\uFF1F",
         initialValue: false
       });
-      if (prompts.isCancel(confirm5) || !confirm5) {
+      if (prompts.isCancel(confirm8) || !confirm8) {
         logger.info("Cancelled.");
         return;
       }
     }
     let removed = 0;
     for (const r of removable) {
-      const target = path12.isAbsolute(r.target) ? r.target : path12.join(projectRoot, r.target);
+      const target = path13.isAbsolute(r.target) ? r.target : path13.join(projectRoot, r.target);
       try {
         await fs9.unlink(target);
         removed++;
       } catch (err) {
         if (err.code !== "ENOENT") {
-          logger.warn(
-            `Failed to remove ${target}: ${err.message}`
-          );
+          logger.warn(`Failed to remove ${target}: ${getErrorMessage(err)}`);
         }
       }
     }
     if (installedManifest) {
       installedManifest.installed = installedManifest.installed.filter(
-        (p) => p.package !== TOKENS_PACKAGE
+        (p2) => p2.package !== TOKENS_PACKAGE
       );
       await writeInstalledManifest(projectRoot, installedManifest);
     }
     delete config.packages.tokens;
     await writeProjectConfig(projectRoot, config);
-    const lockPath = path12.join(
+    const lockPath = path13.join(
       projectRoot,
       ".teamix-evo",
       "tokens-lock.json"
@@ -1663,18 +1859,18 @@ var uninstallCommand = new Command5("uninstall").description(
     } catch (err) {
       if (err.code !== "ENOENT") {
         logger.warn(
-          `Failed to remove tokens-lock.json: ${err.message}`
+          `Failed to remove tokens-lock.json: ${getErrorMessage(err)}`
         );
       }
     }
     logger.success(`Uninstalled ${TOKENS_PACKAGE}`);
     logger.info(`  Removed: ${removed} files`);
     if (kept > 0) {
-      const note = opts.purge ? "managed (you may delete manually)" : "frozen / managed (preserved \u2014 ADR 0003; --purge to force)";
-      logger.info(`  Kept:    ${kept} files \u2014 ${note}`);
+      const note2 = opts.purge ? "managed (you may delete manually)" : "frozen / managed (preserved \u2014 ADR 0003; --purge to force)";
+      logger.info(`  Kept:    ${kept} files \u2014 ${note2}`);
     }
   } catch (err) {
-    logger.error(`Failed to uninstall: ${err.message}`);
+    logger.error(`Failed to uninstall: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
@@ -1695,16 +1891,24 @@ import { Command as Command14 } from "commander";
 import { Command as Command7 } from "commander";
 import * as prompts2 from "@clack/prompts";
 
+// src/utils/cancelled.ts
+var CancelledError = class extends Error {
+  constructor(message = "Cancelled by user.") {
+    super(message);
+    this.name = "CancelledError";
+  }
+};
+
 // src/commands/skills/_parse.ts
 function parseIdeList(input) {
   const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
   const result = [];
-  for (const p of parts) {
-    if (p === "qoder" || p === "claude") {
-      if (!result.includes(p)) result.push(p);
+  for (const p2 of parts) {
+    if (p2 === "qoder" || p2 === "claude") {
+      if (!result.includes(p2)) result.push(p2);
     } else {
       throw new Error(
-        `Unknown IDE: "${p}". Expected one of: ${ALL_IDE_KINDS.join(", ")}.`
+        `Unknown IDE: "${p2}". Expected one of: ${ALL_IDE_KINDS.join(", ")}.`
       );
     }
   }
@@ -1736,7 +1940,9 @@ var initCommand2 = new Command7("init").description(
       return;
     }
     logger.info(
-      `Initializing skills (bulk): ides=[${ides.join(",")}], scope="${scope}"`
+      `Initializing skills (bulk): ides=[${ides.join(
+        ","
+      )}], scope="${scope}"`
     );
     logger.debug(`Project root: ${projectRoot}`);
     const result = await runSkillsInit({
@@ -1764,10 +1970,16 @@ var initCommand2 = new Command7("init").description(
     }
     logger.info(`  Files:   ${result.fileCount}`);
     logger.info("");
-    logger.info('Run "npx teamix-evo@latest skills list" to see installed skills.');
+    logger.info(
+      'Run "npx teamix-evo@latest skills list" to see installed skills.'
+    );
   } catch (err) {
-    logger.error(`Failed to init skills: ${err.message}`);
-    logger.debug(err.stack ?? "");
+    if (err instanceof CancelledError) {
+      logger.info("skills init \u5DF2\u53D6\u6D88\u3002");
+      return;
+    }
+    logger.error(`Failed to init skills: ${getErrorMessage(err)}`);
+    logger.debug(err instanceof Error ? err.stack ?? "" : "");
     process.exitCode = 1;
   }
 });
@@ -1792,7 +2004,7 @@ async function resolveIdesAndScope(args) {
     required: true
   });
   if (prompts2.isCancel(idesAns)) {
-    throw new Error("Cancelled by user.");
+    throw new CancelledError();
   }
   const scopeAns = await prompts2.select({
     message: "\u5B89\u88C5\u8303\u56F4\uFF1F",
@@ -1803,7 +2015,7 @@ async function resolveIdesAndScope(args) {
     initialValue: "project"
   });
   if (prompts2.isCancel(scopeAns)) {
-    throw new Error("Cancelled by user.");
+    throw new CancelledError();
   }
   return { ides: idesAns, scope: scopeAns };
 }
@@ -1869,10 +2081,16 @@ var addCommand = new Command8("add").description(
     }
     logger.info(`  Files:   ${result.fileCount}`);
     logger.info("");
-    logger.info('Run "npx teamix-evo@latest skills list" to see installed skills.');
+    logger.info(
+      'Run "npx teamix-evo@latest skills list" to see installed skills.'
+    );
   } catch (err) {
-    logger.error(`Failed to add skills: ${err.message}`);
-    logger.debug(err.stack ?? "");
+    if (err instanceof CancelledError) {
+      logger.info("skills add \u5DF2\u53D6\u6D88\u3002");
+      return;
+    }
+    logger.error(`Failed to add skills: ${getErrorMessage(err)}`);
+    logger.debug(err instanceof Error ? err.stack ?? "" : "");
     process.exitCode = 1;
   }
 });
@@ -1909,7 +2127,7 @@ async function resolveIdesAndScope2(args) {
     required: true
   });
   if (prompts3.isCancel(idesAns)) {
-    throw new Error("Cancelled by user.");
+    throw new CancelledError();
   }
   const scopeAns = await prompts3.select({
     message: "\u5B89\u88C5\u8303\u56F4\uFF1F",
@@ -1920,7 +2138,7 @@ async function resolveIdesAndScope2(args) {
     initialValue: "project"
   });
   if (prompts3.isCancel(scopeAns)) {
-    throw new Error("Cancelled by user.");
+    throw new CancelledError();
   }
   return { ides: idesAns, scope: scopeAns };
 }
@@ -1941,7 +2159,7 @@ var listCommand2 = new Command9("list").alias("ls").description(
     const config = await readProjectConfig(projectRoot);
     const installedManifest = await readInstalledManifest(projectRoot);
     const pkg = installedManifest?.installed.find(
-      (p) => p.package === SKILLS_PACKAGE
+      (p2) => p2.package === SKILLS_PACKAGE
     );
     const skillsLock = await readSkillsLock(projectRoot);
     const installedBySkill = /* @__PURE__ */ new Map();
@@ -1957,7 +2175,9 @@ var listCommand2 = new Command9("list").alias("ls").description(
     if (opts.installed) {
       if (!config?.packages?.skills || !pkg) {
         logger.info("No skills installed.");
-        logger.info('Run "npx teamix-evo@latest skills init" to get started.');
+        logger.info(
+          'Run "npx teamix-evo@latest skills init" to get started.'
+        );
         return;
       }
       printInstalledHeader(config.packages.skills, pkg.installedAt);
@@ -2008,7 +2228,7 @@ var listCommand2 = new Command9("list").alias("ls").description(
       `  Total: ${skills.length} skill(s) \u2014 ${installedCount} installed, ${skills.length - installedCount} available`
     );
   } catch (err) {
-    logger.error(`Failed to list: ${err.message}`);
+    logger.error(`Failed to list: ${getErrorMessage(err)}`);
     process.exitCode = 1;
   }
 });
@@ -2023,7 +2243,7 @@ function printInstalledHeader(cfg, installedAt) {
 
 // src/commands/skills/update.ts
 import { Command as Command10 } from "commander";
-import { createRequire as createRequire4 } from "module";
+import { createRequire as createRequire3 } from "module";
 
 // src/core/skills-update.ts
 var DEFAULT_SKILLS_PACKAGE3 = "@teamix-evo/skills";
@@ -2146,7 +2366,7 @@ async function runSkillsUpdate(options) {
     installed: []
   };
   const idx = installedManifest.installed.findIndex(
-    (p) => p.package === packageName
+    (p2) => p2.package === packageName
   );
   const installedAt = (/* @__PURE__ */ new Date()).toISOString();
   const prior = idx >= 0 ? installedManifest.installed[idx].resources : [];
@@ -2196,15 +2416,18 @@ async function runSkillsUpdate(options) {
 }
 
 // src/commands/skills/update.ts
-var require5 = createRequire4(import.meta.url);
+var require4 = createRequire3(import.meta.url);
 var SKILLS_PACKAGE2 = "@teamix-evo/skills";
 var updateCommand2 = new Command10("update").description(
   "\u66F4\u65B0\u5DF2\u5B89\u88C5\u7684 teamix-evo skills\uFF08\u4EC5\u5347\u7EA7 lock \u5DF2\u8BB0\u5F55\u4E14 scope \u5339\u914D\u7684 skill \u2014 ADR 0035\uFF09"
-).argument("[names...]", "\u53EF\u9009\uFF1A\u4EC5\u5347\u7EA7\u6307\u5B9A skill id;\u7701\u7565\u5219\u5347\u7EA7\u5168\u90E8\u5DF2\u88C5").option("--dry-run", "\u9884\u89C8\u53D8\u66F4\uFF0C\u4E0D\u5199\u76D8").action(async (names, opts) => {
+).argument("[names...]", "\u53EF\u9009\uFF1A\u4EC5\u5347\u7EA7\u6307\u5B9A skill id\uFF1B\u7701\u7565\u5219\u5347\u7EA7\u5168\u90E8\u5DF2\u88C5").option("--dry-run", "\u9884\u89C8\u53D8\u66F4\uFF0C\u4E0D\u5199\u76D8").option(
+  "--scope <scope>",
+  "project | global\uFF08\u9ED8\u8BA4\u6309 cwd \u63A8\u65AD\uFF1Acwd \u662F\u9879\u76EE\u2192project\uFF1B\u5426\u5219 fallback \u5230\u5168\u5C40\uFF09"
+).action(async (names, opts) => {
   try {
     const ide = detectIde();
     const cwd = ide.getProjectRoot();
-    const projectRoot = resolveSkillsMaintenanceRoot(cwd);
+    const projectRoot = resolveUpdateRoot(cwd, opts.scope);
     if (projectRoot !== cwd) {
       logger.info(`Using global skills meta root: ${projectRoot}`);
     }
@@ -2249,13 +2472,13 @@ var updateCommand2 = new Command10("update").description(
           `Skills updated to v${result.version} (${result.updatedSkillIds.length} skill(s)).`
         );
         if (result.updatedSkillIds.length > 0) {
-          logger.info(
-            `  Updated: ${result.updatedSkillIds.join(", ")}`
-          );
+          logger.info(`  Updated: ${result.updatedSkillIds.join(", ")}`);
         }
         if (result.skippedSkillIds.length > 0) {
           logger.info(
-            `  Skipped: ${result.skippedSkillIds.join(", ")} (scope mismatch / removed upstream)`
+            `  Skipped: ${result.skippedSkillIds.join(
+              ", "
+            )} (scope mismatch / removed upstream)`
           );
         }
         logger.info(`  Created:     ${summary.created}`);
@@ -2266,11 +2489,32 @@ var updateCommand2 = new Command10("update").description(
       }
     }
   } catch (err) {
-    logger.error(`Failed to update skills: ${err.message}`);
+    logger.error(`Failed to update skills: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
 });
+function resolveUpdateRoot(cwd, scopeFlag) {
+  if (scopeFlag === void 0) {
+    return resolveSkillsMaintenanceRoot(cwd);
+  }
+  const scope = parseScope(scopeFlag);
+  if (scope === "global") {
+    const globalRoot = getGlobalMetaRoot();
+    if (!isTeamixEvoProject(globalRoot)) {
+      throw new Error(
+        `No global skills installed at ${globalRoot}. Run "npx teamix-evo@latest skills add <id> --scope global" first.`
+      );
+    }
+    return globalRoot;
+  }
+  if (!isTeamixEvoProject(cwd)) {
+    throw new Error(
+      `Current directory is not a teamix-evo project (.teamix-evo/config.json missing). Re-run without --scope, or use "--scope global".`
+    );
+  }
+  return cwd;
+}
 function formatPlanItem(item) {
   const tag = item.action === "up-to-date" ? "  =" : item.strategy === "frozen" ? "  \u2298 " : item.strategy === "managed" ? "  \u2295 " : "  \u2192 ";
   const ver = item.action === "up-to-date" ? `v${item.current} (no change)` : `v${item.current} \u2192 v${item.next} [${item.strategy}]`;
@@ -2279,7 +2523,7 @@ function formatPlanItem(item) {
 async function printVersionBanner() {
   let cliVersion;
   try {
-    const pkg = require5("../package.json");
+    const pkg = require4("../package.json");
     cliVersion = pkg.version;
   } catch {
   }
@@ -2299,15 +2543,12 @@ async function printVersionBanner() {
 // src/commands/skills/uninstall.ts
 import { Command as Command11 } from "commander";
 import * as prompts4 from "@clack/prompts";
-import * as path13 from "path";
+import * as path14 from "path";
 import * as fs10 from "fs/promises";
 var SKILLS_PACKAGE3 = "@teamix-evo/skills";
 var uninstallCommand2 = new Command11("uninstall").description(
   "\u5378\u8F7D\u5DF2\u5B89\u88C5\u7684 teamix-evo skills\uFF1B\u4E0D\u4F20 ids \u5219\u5378\u8F7D\u6574\u5305\uFF0C\u4F20 ids \u5219\u6309 skill \u5220\u9664"
-).argument(
-  "[ids...]",
-  "\u53EF\u9009\uFF1A\u4EC5\u5378\u8F7D\u6307\u5B9A skill id\uFF1B\u7701\u7565\u5219\u5378\u8F7D\u6574\u4E2A skills \u5305"
-).option("-y, --yes", "\u8DF3\u8FC7\u786E\u8BA4").action(async (ids, opts) => {
+).argument("[ids...]", "\u53EF\u9009\uFF1A\u4EC5\u5378\u8F7D\u6307\u5B9A skill id\uFF1B\u7701\u7565\u5219\u5378\u8F7D\u6574\u4E2A skills \u5305").option("-y, --yes", "\u8DF3\u8FC7\u786E\u8BA4").action(async (ids, opts) => {
   try {
     const ide = detectIde();
     const cwd = ide.getProjectRoot();
@@ -2322,7 +2563,7 @@ var uninstallCommand2 = new Command11("uninstall").description(
     }
     const installedManifest = await readInstalledManifest(projectRoot);
     const pkg = installedManifest?.installed.find(
-      (p) => p.package === SKILLS_PACKAGE3
+      (p2) => p2.package === SKILLS_PACKAGE3
     );
     const resources = pkg?.resources ?? [];
     if (ids.length === 0) {
@@ -2345,7 +2586,7 @@ var uninstallCommand2 = new Command11("uninstall").description(
       opts
     });
   } catch (err) {
-    logger.error(`Failed to uninstall: ${err.message}`);
+    logger.error(`Failed to uninstall: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
@@ -2356,11 +2597,11 @@ async function runFullUninstall(args) {
     `Will remove ${resources.length} skill file(s) installed by ${SKILLS_PACKAGE3}.`
   );
   if (!opts.yes) {
-    const confirm5 = await prompts4.confirm({
+    const confirm8 = await prompts4.confirm({
       message: "\u786E\u8BA4\u5378\u8F7D\uFF1F\u6B64\u64CD\u4F5C\u4F1A\u5220\u9664\u4E0A\u8FF0\u6587\u4EF6\u3002",
       initialValue: false
     });
-    if (prompts4.isCancel(confirm5) || !confirm5) {
+    if (prompts4.isCancel(confirm8) || !confirm8) {
       logger.info("Cancelled.");
       return;
     }
@@ -2373,9 +2614,7 @@ async function runFullUninstall(args) {
     await fs10.rm(skillsRoot, { recursive: true, force: true });
     logger.debug(`Removed source dir ${skillsRoot}`);
   } catch (err) {
-    logger.warn(
-      `Failed to remove ${skillsRoot}: ${err.message}`
-    );
+    logger.warn(`Failed to remove ${skillsRoot}: ${getErrorMessage(err)}`);
   }
   const skillNames = collectSkillNames({
     fromSources: sourceSkillNames,
@@ -2390,7 +2629,7 @@ async function runFullUninstall(args) {
   );
   if (installedManifest && pkg) {
     installedManifest.installed = installedManifest.installed.filter(
-      (p) => p.package !== SKILLS_PACKAGE3
+      (p2) => p2.package !== SKILLS_PACKAGE3
     );
     await writeInstalledManifest(projectRoot, installedManifest);
   }
@@ -2398,10 +2637,10 @@ async function runFullUninstall(args) {
   await writeProjectConfig(projectRoot, config);
   logger.success(`Uninstalled ${SKILLS_PACKAGE3}`);
   logger.info(`  Removed: ${removed.length} files`);
-  logger.info(`  Source:  ${path13.relative(projectRoot, skillsRoot)} (cleaned)`);
+  logger.info(`  Source:  ${path14.relative(projectRoot, skillsRoot)} (cleaned)`);
   if (cleanedMirrorDirs.length > 0) {
     logger.info(
-      `  Mirrors: ${cleanedMirrorDirs.map((d) => path13.relative(projectRoot, d)).join(", ")} (cleaned)`
+      `  Mirrors: ${cleanedMirrorDirs.map((d) => path14.relative(projectRoot, d)).join(", ")} (cleaned)`
     );
   }
 }
@@ -2425,11 +2664,11 @@ async function runPartialUninstall(args) {
     `Will remove ${matched.length} skill(s): ${matched.join(", ")} (${toRemove.length} file(s)).`
   );
   if (!opts.yes) {
-    const confirm5 = await prompts4.confirm({
+    const confirm8 = await prompts4.confirm({
       message: "\u786E\u8BA4\u5378\u8F7D\uFF1F\u6B64\u64CD\u4F5C\u4F1A\u5220\u9664\u4E0A\u8FF0\u6587\u4EF6\u3002",
       initialValue: false
     });
-    if (prompts4.isCancel(confirm5) || !confirm5) {
+    if (prompts4.isCancel(confirm8) || !confirm8) {
       logger.info("Cancelled.");
       return;
     }
@@ -2442,7 +2681,7 @@ async function runPartialUninstall(args) {
       await fs10.rm(dir, { recursive: true, force: true });
       logger.debug(`Removed source dir ${dir}`);
     } catch (err) {
-      logger.warn(`Failed to remove ${dir}: ${err.message}`);
+      logger.warn(`Failed to remove ${dir}: ${getErrorMessage(err)}`);
     }
   }
   const config = await readProjectConfig(projectRoot);
@@ -2461,13 +2700,11 @@ async function runPartialUninstall(args) {
     pkg.resources = resources.filter((r) => !matched.includes(skillIdOf(r)));
     await writeInstalledManifest(projectRoot, installedManifest);
   }
-  logger.success(
-    `Removed ${matched.length} skill(s): ${matched.join(", ")}`
-  );
+  logger.success(`Removed ${matched.length} skill(s): ${matched.join(", ")}`);
   logger.info(`  Files:   ${removed.length}`);
   if (cleanedMirrorDirs.length > 0) {
     logger.info(
-      `  Mirrors: ${cleanedMirrorDirs.map((d) => path13.relative(projectRoot, d)).join(", ")} (cleaned)`
+      `  Mirrors: ${cleanedMirrorDirs.map((d) => path14.relative(projectRoot, d)).join(", ")} (cleaned)`
     );
   }
   if (missing.length > 0) {
@@ -2510,11 +2747,11 @@ async function removeMirrorDirs(projectRoot, scope, ides, skillNames) {
         removed.push(dir);
         logger.debug(`Removed mirror dir ${dir}`);
       } catch (err) {
-        logger.warn(`Failed to remove ${dir}: ${err.message}`);
+        logger.warn(`Failed to remove ${dir}: ${getErrorMessage(err)}`);
       }
     }
     if (removed.length > 0) {
-      const skillsParent = path13.dirname(
+      const skillsParent = path14.dirname(
         adapter.getSkillTargetDir("placeholder", targetScope, projectRoot)
       );
       try {
@@ -2549,15 +2786,15 @@ function dedupe(values) {
 import { Command as Command12 } from "commander";
 
 // src/core/skills-sync.ts
-import * as path14 from "path";
+import * as path15 from "path";
 import * as fs11 from "fs/promises";
-import { createRequire as createRequire5 } from "module";
+import { createRequire as createRequire4 } from "module";
 import { loadSkillsPackageManifest as loadSkillsPackageManifest2 } from "@teamix-evo/registry";
-var require6 = createRequire5(import.meta.url);
+var require5 = createRequire4(import.meta.url);
 async function readSkillMetaFromUpstream(skillId) {
   try {
-    const pkgJson = require6.resolve("@teamix-evo/skills/package.json");
-    const packageRoot = path14.dirname(pkgJson);
+    const pkgJson = require5.resolve("@teamix-evo/skills/package.json");
+    const packageRoot = path15.dirname(pkgJson);
     const manifest = await loadSkillsPackageManifest2(packageRoot);
     const entry = manifest.skills.find((s) => s.id === skillId);
     if (!entry) return null;
@@ -2635,10 +2872,10 @@ async function runSkillsSync(options) {
     missingSourceIds: missing
   };
 }
-async function dirExists(p) {
+async function dirExists(p2) {
   try {
-    const stat4 = await fs11.stat(p);
-    return stat4.isDirectory();
+    const stat7 = await fs11.stat(p2);
+    return stat7.isDirectory();
   } catch {
     return false;
   }
@@ -2646,7 +2883,7 @@ async function dirExists(p) {
 async function refreshMirrorRecords(projectRoot, newMirrorRecords) {
   const installed = await readInstalledManifest(projectRoot);
   if (!installed) return;
-  const pkg = installed.installed.find((p) => p.package === SKILLS_PACKAGE_DEFAULT);
+  const pkg = installed.installed.find((p2) => p2.package === SKILLS_PACKAGE_DEFAULT);
   if (!pkg) return;
   const sourceOnly = pkg.resources.filter((r) => r.ide === void 0);
   pkg.resources = [...sourceOnly, ...newMirrorRecords];
@@ -2663,10 +2900,7 @@ var syncCommand = new Command12("sync").description(
 ).option(
   "--ide <list>",
   "\u9017\u53F7\u5206\u9694\u7684 IDE \u5217\u8868\uFF08\u8986\u76D6 lock \u4E2D\u8BB0\u5F55\u7684 mirroredTo\uFF09"
-).option(
-  "--scope <scope>",
-  "project | global\uFF08\u8986\u76D6 lock \u4E2D\u8BB0\u5F55\u7684 scope\uFF09"
-).action(async (names, opts) => {
+).option("--scope <scope>", "project | global\uFF08\u8986\u76D6 lock \u4E2D\u8BB0\u5F55\u7684 scope\uFF09").action(async (names, opts) => {
   try {
     const ide = detectIde();
     const cwd = ide.getProjectRoot();
@@ -2702,7 +2936,7 @@ var syncCommand = new Command12("sync").description(
       );
     }
   } catch (err) {
-    logger.error(`Failed to sync skills: ${err.message}`);
+    logger.error(`Failed to sync skills: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
@@ -2712,7 +2946,7 @@ var syncCommand = new Command12("sync").description(
 import { Command as Command13 } from "commander";
 
 // src/core/skills-doctor.ts
-import * as path15 from "path";
+import * as path16 from "path";
 import * as fs12 from "fs/promises";
 async function runSkillsDoctor(options) {
   const { projectRoot } = options;
@@ -2735,7 +2969,7 @@ async function runSkillsDoctor(options) {
     const sourceFiles = await walkDir(sourceDir);
     const sourceContents = /* @__PURE__ */ new Map();
     for (const f of sourceFiles) {
-      const rel2 = path15.relative(sourceDir, f);
+      const rel2 = path16.relative(sourceDir, f);
       sourceContents.set(rel2, await fs12.readFile(f, "utf-8"));
     }
     for (const ide of entry.mirroredTo) {
@@ -2757,7 +2991,7 @@ async function runSkillsDoctor(options) {
         continue;
       }
       for (const [rel2, sourceContent] of sourceContents.entries()) {
-        const mirrorFile = path15.join(mirrorDir, rel2);
+        const mirrorFile = path16.join(mirrorDir, rel2);
         if (!await fileExists(mirrorFile)) {
           findings.push({
             kind: "missing-mirror",
@@ -2788,19 +3022,17 @@ async function runSkillsDoctor(options) {
     findings
   };
 }
-async function dirExists2(p) {
+async function dirExists2(p2) {
   try {
-    const stat4 = await fs12.stat(p);
-    return stat4.isDirectory();
+    const stat7 = await fs12.stat(p2);
+    return stat7.isDirectory();
   } catch {
     return false;
   }
 }
 
 // src/commands/skills/doctor.ts
-var doctorCommand = new Command13("doctor").description(
-  "\u68C0\u67E5 .teamix-evo/skills/ \u6E90\u4E0E IDE \u955C\u50CF\u662F\u5426\u6F02\u79FB\uFF1B\u63D0\u793A\u5982\u4F55\u4FEE\u590D"
-).action(async () => {
+var doctorCommand = new Command13("doctor").description("\u68C0\u67E5 .teamix-evo/skills/ \u6E90\u4E0E IDE \u955C\u50CF\u662F\u5426\u6F02\u79FB\uFF1B\u63D0\u793A\u5982\u4F55\u4FEE\u590D").action(async () => {
   try {
     const ide = detectIde();
     const cwd = ide.getProjectRoot();
@@ -2830,7 +3062,7 @@ var doctorCommand = new Command13("doctor").description(
     }
     process.exitCode = 1;
   } catch (err) {
-    logger.error(`Failed to run doctor: ${err.message}`);
+    logger.error(`Failed to run doctor: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
@@ -2849,7 +3081,7 @@ skillsCommand.addCommand(doctorCommand);
 skillsCommand.addCommand(uninstallCommand2);
 
 // src/commands/ui/index.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/commands/ui/init.ts
 import { Command as Command15 } from "commander";
@@ -2885,8 +3117,8 @@ async function runUiInit(options) {
   const tsx = options.tsx ?? true;
   const rsc = options.rsc ?? false;
   const config = existingConfig ?? {
-    $schema: "https://teamix-evo.dev/schema/config/v1.json",
-    schemaVersion: 1,
+    $schema: "https://teamix-evo.dev/schema/config/v2.json",
+    schemaVersion: 2,
     ide: ideIdent,
     packages: {}
   };
@@ -2952,8 +3184,12 @@ var initCommand3 = new Command15("init").description(
     logger.info("");
     logger.info("Next: `npx teamix-evo@latest ui add button`");
   } catch (err) {
-    logger.error(`Failed to initialize ui: ${err.message}`);
-    logger.debug(err.stack ?? "");
+    if (err instanceof CancelledError) {
+      logger.info("ui init \u5DF2\u53D6\u6D88\u3002");
+      return;
+    }
+    logger.error(`Failed to initialize ui: ${getErrorMessage(err)}`);
+    logger.debug(err instanceof Error ? err.stack ?? "" : "");
     process.exitCode = 1;
   }
 });
@@ -2978,37 +3214,37 @@ async function resolveConfig(opts) {
     message: "components \u8DEF\u5F84\uFF08\u6CE8\u5165\u6309\u94AE\u7B49\u7EC4\u4EF6\u6E90\u7801\u7684\u76EE\u5F55\uFF09",
     initialValue: opts.components ?? DEFAULT_UI_ALIASES.components
   });
-  if (prompts5.isCancel(components)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(components)) throw new CancelledError();
   const hooks = await prompts5.text({
     message: "hooks \u8DEF\u5F84",
     initialValue: opts.hooks ?? DEFAULT_UI_ALIASES.hooks
   });
-  if (prompts5.isCancel(hooks)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(hooks)) throw new CancelledError();
   const utils = await prompts5.text({
     message: "utils \u8DEF\u5F84\uFF08cn \u7B49\u5DE5\u5177\uFF09",
     initialValue: opts.utils ?? DEFAULT_UI_ALIASES.utils
   });
-  if (prompts5.isCancel(utils)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(utils)) throw new CancelledError();
   const lib = await prompts5.text({
     message: "lib \u8DEF\u5F84\uFF08\u5171\u4EAB\u4EE3\u7801\u6839\uFF09",
     initialValue: opts.lib ?? DEFAULT_UI_ALIASES.lib
   });
-  if (prompts5.isCancel(lib)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(lib)) throw new CancelledError();
   const iconLibrary = await prompts5.text({
     message: "icon \u5E93\uFF08\u58F0\u660E\u6027\uFF0C\u7EC4\u4EF6\u6E90\u7801\u5DF2 hardcode lucide-react\uFF09",
     initialValue: opts.iconLibrary ?? "lucide"
   });
-  if (prompts5.isCancel(iconLibrary)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(iconLibrary)) throw new CancelledError();
   const tsxAns = await prompts5.confirm({
     message: "\u4F7F\u7528 TSX\uFF1F",
     initialValue: opts.tsx ?? true
   });
-  if (prompts5.isCancel(tsxAns)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(tsxAns)) throw new CancelledError();
   const rscAns = await prompts5.confirm({
     message: "\u4F7F\u7528 React Server Components\uFF1F",
     initialValue: opts.rsc ?? false
   });
-  if (prompts5.isCancel(rscAns)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(rscAns)) throw new CancelledError();
   return {
     aliases: {
       components,
@@ -3028,21 +3264,21 @@ async function resolveConfig(opts) {
 import { Command as Command16 } from "commander";
 
 // src/core/ui-client.ts
-import * as path16 from "path";
+import * as path17 from "path";
 import * as fs13 from "fs/promises";
-import { createRequire as createRequire6 } from "module";
+import { createRequire as createRequire5 } from "module";
 import { loadUiPackageManifest } from "@teamix-evo/registry";
-var require7 = createRequire6(import.meta.url);
+var require6 = createRequire5(import.meta.url);
 function resolvePackageRoot2(packageName) {
-  const pkgJsonPath = require7.resolve(`${packageName}/package.json`);
-  return path16.dirname(pkgJsonPath);
+  const pkgJsonPath = require6.resolve(`${packageName}/package.json`);
+  return path17.dirname(pkgJsonPath);
 }
 async function loadUiData(packageName) {
   const packageRoot = resolvePackageRoot2(packageName);
   logger.debug(`Resolved ui package root: ${packageRoot}`);
   const manifest = await loadUiPackageManifest(packageRoot);
   let data = {};
-  const dataPath = path16.join(packageRoot, "_data.json");
+  const dataPath = path17.join(packageRoot, "_data.json");
   try {
     const raw = await fs13.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
@@ -3056,7 +3292,7 @@ async function loadUiData(packageName) {
 }
 
 // src/core/ui-installer.ts
-import * as path17 from "path";
+import * as path18 from "path";
 import * as fs14 from "fs/promises";
 import { resolveUiEntryOrder } from "@teamix-evo/registry";
 
@@ -3130,7 +3366,7 @@ async function installUiEntries(options) {
         continue;
       }
       const rootForEntry = entryPackageRoot?.get(entry.id) ?? packageRoot;
-      const sourceAbs = path17.resolve(rootForEntry, file.source);
+      const sourceAbs = path18.resolve(rootForEntry, file.source);
       const raw = await fs14.readFile(sourceAbs, "utf-8");
       const transformed = rewriteImports(raw, aliases);
       await writeFileSafe(targetAbs, transformed);
@@ -3159,10 +3395,10 @@ function resolveTargetPath(projectRoot, aliases, entry, file) {
       `Entry "${entry.id}" requires alias "${file.targetAlias}" but it is not configured.`
     );
   }
-  return path17.join(projectRoot, aliasDir, file.targetName);
+  return path18.join(projectRoot, aliasDir, file.targetName);
 }
 function rel(projectRoot, abs) {
-  return path17.relative(projectRoot, abs);
+  return path18.relative(projectRoot, abs);
 }
 
 // src/core/ui-add.ts
@@ -3213,7 +3449,7 @@ async function runUiAdd(options) {
   const installed = await readInstalledManifest(
     projectRoot
   ) ?? { schemaVersion: 1, installed: [] };
-  const idx = installed.installed.findIndex((p) => p.package === packageName);
+  const idx = installed.installed.findIndex((p2) => p2.package === packageName);
   const prior = idx >= 0 ? installed.installed[idx] : null;
   const mergedResources = mergeResources(
     prior?.resources ?? [],
@@ -3281,7 +3517,7 @@ var addCommand2 = new Command16("add").description(
         logger.info(`  # or: npm install ${installCmd}`);
       }
     } catch (err) {
-      const message = err.message;
+      const message = getErrorMessage(err);
       if (message.startsWith("UI not initialized")) {
         logger.error(
           "UI not initialized. Run `npx teamix-evo ui init` first."
@@ -3307,7 +3543,7 @@ async function runUiList(options) {
   const installedManifest = await readInstalledManifest(projectRoot);
   const installedIds = /* @__PURE__ */ new Set();
   const uiPkg = installedManifest?.installed.find(
-    (p) => p.package === packageName
+    (p2) => p2.package === packageName
   );
   for (const r of uiPkg?.resources ?? []) {
     const colon = r.id.indexOf(":");
@@ -3378,72 +3614,695 @@ var listCommand3 = new Command17("list").description("\u5217\u51FA @teamix-evo/u
         `Total: ${total} entr${total === 1 ? "y" : "ies"}, ${installedCount} installed.`
       );
     } catch (err) {
-      logger.error(`Failed to list ui entries: ${err.message}`);
+      logger.error(`Failed to list ui entries: ${getErrorMessage(err)}`);
       logger.debug(err.stack ?? "");
       process.exitCode = 1;
     }
   }
 );
 
-// src/commands/ui/index.ts
-var uiCommand = new Command18("ui").description(
-  "\u7BA1\u7406 teamix-evo ui \u7EC4\u4EF6\uFF08\u6E90\u7801\u6CE8\u5165\u5F0F\u5B89\u88C5\uFF0Cshadcn \u98CE\u683C\uFF09"
-);
-uiCommand.addCommand(initCommand3);
-uiCommand.addCommand(addCommand2);
-uiCommand.addCommand(listCommand3);
-
-// src/commands/biz-ui/index.ts
-import { Command as Command22 } from "commander";
-
-// src/commands/biz-ui/add.ts
-import { Command as Command19 } from "commander";
+// src/commands/_upgrade-command-factory.ts
+import { Command as Command18 } from "commander";
 
-// src/core/variant-ui-add.ts
-import * as path18 from "path";
-import { createRequire as createRequire7 } from "module";
+// src/core/ui-upgrade.ts
+import * as path21 from "path";
+import { createRequire as createRequire6 } from "module";
 import {
   loadUiPackageManifest as loadUiPackageManifest2,
-  loadVariantUiPackageCatalog,
   loadVariantUiPackageManifest
 } from "@teamix-evo/registry";
-var require8 = createRequire7(import.meta.url);
-function resolvePackageRoot3(packageName) {
-  const pkgJsonPath = require8.resolve(`${packageName}/package.json`);
-  return path18.dirname(pkgJsonPath);
+
+// src/core/ui-upgrade-detector.ts
+import * as fs15 from "fs/promises";
+import * as path19 from "path";
+var PACKAGE_NAME = {
+  ui: "@teamix-evo/ui",
+  "biz-ui": "@teamix-evo/biz-ui"
+};
+var ALIAS_KEY = {
+  ui: "components",
+  "biz-ui": "business"
+};
+var COMPONENT_FILE_RE = /\.(tsx|ts)$/;
+var SKIP_FILENAMES = /* @__PURE__ */ new Set(["index.ts", "index.tsx"]);
+async function detectComponentLineage(options) {
+  const { projectRoot, category } = options;
+  const config = options.config ?? await readProjectConfig(projectRoot);
+  const installed = options.installed ?? await readInstalledManifest(projectRoot);
+  const installDir = resolveInstallDir(category, config);
+  const installDirAbs = path19.join(projectRoot, installDir);
+  const installDirExists = await directoryExists(installDirAbs);
+  const hasComponentsJson = await fileExists(
+    path19.join(projectRoot, "components.json")
+  );
+  const installedPkg = findInstalledPackage(installed, PACKAGE_NAME[category]);
+  const registeredIds = installedPkg ? extractIds(installedPkg).sort() : [];
+  const onDiskIds = installDirExists ? await listComponentIds(installDirAbs) : [];
+  const registeredSet = new Set(registeredIds);
+  const unregisteredIds = onDiskIds.filter((id) => !registeredSet.has(id)).sort();
+  const lineage = classifyLineage({
+    hasInstalled: installedPkg !== null,
+    hasComponentsJson,
+    onDiskIds,
+    unregisteredIds
+  });
+  return {
+    category,
+    lineage,
+    installDir,
+    installDirExists,
+    hasComponentsJson,
+    registeredIds,
+    unregisteredIds,
+    installedVersion: installedPkg?.version ?? null,
+    installedVariant: installedPkg?.variant ?? null
+  };
 }
-async function runVariantUiAdd(packageName, options) {
-  const { projectRoot, variant, ids, overwrite } = options;
-  const fullPackageName = options.packageName ?? `@teamix-evo/${packageName}`;
-  if (ids.length === 0) {
-    throw new Error("At least one entry id must be provided.");
+function resolveInstallDir(category, config) {
+  const aliasMap = config?.packages?.ui?.aliases ?? config?.packages?.["biz-ui"]?.aliases ?? DEFAULT_UI_ALIASES;
+  const key = ALIAS_KEY[category];
+  return aliasMap[key] ?? DEFAULT_UI_ALIASES[key];
+}
+function extractIds(pkg) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const r of pkg.resources) {
+    const colon = r.id.indexOf(":");
+    ids.add(colon >= 0 ? r.id.slice(0, colon) : r.id);
   }
-  const config = await readProjectConfig(projectRoot);
-  const uiCfg = config?.packages?.ui;
-  if (!config || !uiCfg?.aliases) {
-    throw new Error(
-      `UI not initialized. Run \`teamix-evo ui init\` first \u2014 \`${packageName} add\` writes into the same alias map (business / templates).`
-    );
+  return [...ids];
+}
+async function directoryExists(p2) {
+  try {
+    const stat7 = await fs15.stat(p2);
+    return stat7.isDirectory();
+  } catch {
+    return false;
   }
-  const packageRoot = options.packageRoot ?? resolvePackageRoot3(fullPackageName);
-  const catalog = await loadVariantUiPackageCatalog(packageRoot);
-  if (!catalog.variants.some((v) => v.name === variant)) {
-    const known = catalog.variants.map((v) => v.name).join(", ");
-    throw new Error(
-      `Variant "${variant}" not found in ${fullPackageName}. Known variants: ${known}. Hint: \`teamix-evo ${packageName} list-variants\` shows all.`
-    );
+}
+async function listComponentIds(installDirAbs) {
+  const entries = await fs15.readdir(installDirAbs, { withFileTypes: true });
+  const ids = [];
+  for (const e of entries) {
+    if (!e.isFile()) continue;
+    if (SKIP_FILENAMES.has(e.name)) continue;
+    if (!COMPONENT_FILE_RE.test(e.name)) continue;
+    ids.push(e.name.replace(COMPONENT_FILE_RE, ""));
+  }
+  return ids.sort();
+}
+function classifyLineage(args) {
+  const { hasInstalled, hasComponentsJson, onDiskIds, unregisteredIds } = args;
+  if (hasInstalled) {
+    return unregisteredIds.length === 0 ? "teamix-evo" : "mixed";
   }
-  const variantDir = path18.join(packageRoot, "variants", variant);
-  const variantManifest = await loadVariantUiPackageManifest(variantDir);
-  const knownIds = new Set(variantManifest.entries.map((e) => e.id));
-  const unknown = ids.filter((id) => !knownIds.has(id));
+  if (onDiskIds.length === 0) return "absent";
+  return hasComponentsJson ? "shadcn-native" : "custom-only";
+}
+
+// src/core/ui-upgrade-staging.ts
+import * as path20 from "path";
+var TEAMIX_DIR4 = ".teamix-evo";
+var STAGING_DIR = ".upgrade-staging";
+var PACKAGE_NAME2 = {
+  ui: "@teamix-evo/ui",
+  "biz-ui": "@teamix-evo/biz-ui"
+};
+function isoToFsSafe2(iso) {
+  return iso.replace(/[:.]/g, "-");
+}
+async function buildUiUpgradeStaging(options) {
+  const { lineageReport, category } = options;
+  if (lineageReport.lineage !== "teamix-evo" && lineageReport.lineage !== "mixed") {
+    return null;
+  }
+  const installed = options.installed ?? await readInstalledManifest(options.projectRoot);
+  const installedPkg = findInstalledPackage(installed, PACKAGE_NAME2[category]);
+  if (!installedPkg) return null;
+  const isoTs = options.isoTs ?? (/* @__PURE__ */ new Date()).toISOString();
+  const fsTs = isoToFsSafe2(isoTs);
+  const stagingDir = path20.join(
+    options.projectRoot,
+    TEAMIX_DIR4,
+    STAGING_DIR,
+    `${category}-${fsTs}`
+  );
+  const entryMap = new Map(
+    options.manifest.entries.map((e) => [e.id, e])
+  );
+  const resByEntryId = collectResourcesByEntry(installedPkg.resources);
+  const onlyIds = options.onlyIds && options.onlyIds.length > 0 ? new Set(options.onlyIds) : null;
+  const entries = [];
+  for (const id of lineageReport.registeredIds) {
+    if (onlyIds && !onlyIds.has(id)) continue;
+    const built = await processRegistered({
+      id,
+      entry: entryMap.get(id),
+      resource: resByEntryId.get(id),
+      packageRoot: options.packageRoot,
+      entryPackageRoot: options.entryPackageRoot,
+      aliases: options.aliases,
+      stagingDir,
+      projectRoot: options.projectRoot,
+      category,
+      sourceVersion: options.manifest.version
+    });
+    if (built) entries.push(built);
+  }
+  for (const id of lineageReport.unregisteredIds) {
+    if (onlyIds && !onlyIds.has(id)) continue;
+    const built = await processForeign({
+      id,
+      installDirAbs: path20.join(options.projectRoot, lineageReport.installDir),
+      stagingDir,
+      projectRoot: options.projectRoot,
+      category
+    });
+    if (built) entries.push(built);
+  }
+  if (entries.length === 0) return null;
+  const byRisk = aggregateByRisk(entries);
+  const manifestOut = {
+    schemaVersion: 1,
+    ts: isoTs,
+    package: category,
+    trigger: options.trigger,
+    variant: lineageReport.installedVariant ?? "_flat",
+    fromVersion: lineageReport.installedVersion ?? "",
+    toVersion: options.manifest.version,
+    lineage: lineageReport.lineage,
+    summary: { total: entries.length, byRisk },
+    entries
+  };
+  await ensureDir(stagingDir);
+  await writeFileSafe(
+    path20.join(stagingDir, "meta.json"),
+    JSON.stringify(manifestOut, null, 2) + "\n"
+  );
+  return { stagingDir, manifest: manifestOut };
+}
+async function processRegistered(args) {
+  const { id, entry, resource, stagingDir, projectRoot, category } = args;
+  if (!resource) return null;
+  const currentSource = await readFileOrNull(resource.target);
+  if (currentSource === null) {
+    return buildBreakingEntry({
+      id,
+      category,
+      resource,
+      projectRoot,
+      stagingDir,
+      currentSource: "",
+      hint: "installed file missing on disk"
+    });
+  }
+  if (!entry) {
+    return buildBreakingEntry({
+      id,
+      category,
+      resource,
+      projectRoot,
+      stagingDir,
+      currentSource,
+      hint: "entry removed in upstream package"
+    });
+  }
+  const file = entry.files[0];
+  if (!file) return null;
+  const rootForEntry = args.entryPackageRoot?.get(id) ?? args.packageRoot;
+  const sourceAbs = path20.resolve(rootForEntry, file.source);
+  const raw = await readFileOrNull(sourceAbs);
+  if (raw === null) {
+    return null;
+  }
+  const incomingTransformed = rewriteImports(raw, args.aliases);
+  const incomingHash = computeHash(incomingTransformed);
+  const currentExt = path20.extname(resource.target) || ".tsx";
+  const incomingExt = path20.extname(file.targetName) || currentExt;
+  const currentRel = `${id}/current${currentExt}`;
+  const incomingRel = `${id}/incoming${incomingExt}`;
+  await writeFileSafe(path20.join(stagingDir, currentRel), currentSource);
+  await writeFileSafe(path20.join(stagingDir, incomingRel), incomingTransformed);
+  const diff = classifyRisk({
+    currentHash: resource.hash,
+    incomingHash,
+    currentSource,
+    incomingSource: incomingTransformed,
+    multiFile: entry.files.length > 1
+  });
+  return {
+    id,
+    category,
+    current: {
+      target: path20.relative(projectRoot, resource.target),
+      hash: resource.hash,
+      sourceLineage: "teamix-evo"
+    },
+    incoming: {
+      sourceVersion: args.sourceVersion,
+      hash: incomingHash,
+      relPath: incomingRel
+    },
+    diff
+  };
+}
+async function processForeign(args) {
+  const { id, installDirAbs, stagingDir, projectRoot, category } = args;
+  const tsx = path20.join(installDirAbs, `${id}.tsx`);
+  const ts = path20.join(installDirAbs, `${id}.ts`);
+  const target = await fileExists(tsx) ? tsx : await fileExists(ts) ? ts : null;
+  if (!target) return null;
+  const raw = await readFileOrNull(target);
+  if (raw === null) return null;
+  const ext = path20.extname(target);
+  const currentRel = `${id}/current${ext}`;
+  await writeFileSafe(path20.join(stagingDir, currentRel), raw);
+  return {
+    id,
+    category,
+    current: {
+      target: path20.relative(projectRoot, target),
+      hash: computeHash(raw),
+      sourceLineage: "custom"
+    },
+    diff: {
+      riskLevel: "foreign",
+      hints: [
+        "component is on disk but not registered in .teamix-evo/manifest.json",
+        "AI should propose: (a) ignore, (b) re-register via teamix-evo ui add, or (c) remove"
+      ],
+      filesChangedCount: 0
+    }
+  };
+}
+async function buildBreakingEntry(args) {
+  const ext = path20.extname(args.resource.target) || ".tsx";
+  const currentRel = `${args.id}/current${ext}`;
+  await writeFileSafe(
+    path20.join(args.stagingDir, currentRel),
+    args.currentSource
+  );
+  return {
+    id: args.id,
+    category: args.category,
+    current: {
+      target: path20.relative(args.projectRoot, args.resource.target),
+      hash: args.resource.hash,
+      sourceLineage: "teamix-evo"
+    },
+    diff: {
+      riskLevel: "breaking",
+      hints: [args.hint],
+      filesChangedCount: 0
+    }
+  };
+}
+function classifyRisk(args) {
+  if (args.currentHash === args.incomingHash) {
+    return { riskLevel: "unchanged", hints: [], filesChangedCount: 0 };
+  }
+  const curExports = extractExportNames(args.currentSource);
+  const newExports = extractExportNames(args.incomingSource);
+  const removedExports = setDiff(curExports, newExports);
+  const addedExports = setDiff(newExports, curExports);
+  const curVariants = extractCvaVariantValues(args.currentSource);
+  const newVariants = extractCvaVariantValues(args.incomingSource);
+  const removedVariants = setDiff(curVariants, newVariants);
+  const addedVariants = setDiff(newVariants, curVariants);
+  const hints = [];
+  for (const e of removedExports) hints.push(`removed export: ${e}`);
+  for (const e of addedExports) hints.push(`new export: ${e}`);
+  for (const v of removedVariants) hints.push(`removed cva variant: ${v}`);
+  for (const v of addedVariants) hints.push(`new cva variant: ${v}`);
+  if (args.multiFile) hints.push("multi-file entry; only first file staged");
+  let riskLevel;
+  if (removedExports.length > 0 || removedVariants.length > 0) {
+    riskLevel = "risky";
+  } else if (addedExports.length > 0 || addedVariants.length > 0 || args.multiFile) {
+    riskLevel = "upgradable-medium";
+  } else {
+    riskLevel = "upgradable-low";
+  }
+  return { riskLevel, hints, filesChangedCount: 1 };
+}
+function extractExportNames(src) {
+  const names = /* @__PURE__ */ new Set();
+  const re = /^\s*export\s+(?:default\s+)?(?:async\s+)?(?:const|let|var|function|class|interface|type|enum)\s+(\w+)/gm;
+  let m;
+  while ((m = re.exec(src)) !== null) {
+    if (m[1]) names.add(m[1]);
+  }
+  for (const dm of src.matchAll(/^\s*export\s+default\s+(\w+)\s*;/gm)) {
+    if (dm[1]) names.add(dm[1]);
+  }
+  return [...names];
+}
+function extractCvaVariantValues(src) {
+  const block = extractVariantsBlock(src);
+  if (block === null) return [];
+  const names = /* @__PURE__ */ new Set();
+  for (const groupBody of extractGroupBodies(block)) {
+    for (const km of groupBody.matchAll(/^\s*(?:['"]?)(\w+)(?:['"]?)\s*:/gm)) {
+      if (km[1]) names.add(km[1]);
+    }
+  }
+  return [...names];
+}
+function extractVariantsBlock(src) {
+  const idx = src.search(/\bvariants\s*:\s*\{/);
+  if (idx < 0) return null;
+  const open = src.indexOf("{", idx);
+  if (open < 0) return null;
+  let depth = 0;
+  for (let i = open; i < src.length; i++) {
+    const c = src[i];
+    if (c === "{") depth++;
+    else if (c === "}") {
+      depth--;
+      if (depth === 0) return src.slice(open + 1, i);
+    }
+  }
+  return null;
+}
+function* extractGroupBodies(block) {
+  const re = /(\w+)\s*:\s*\{/g;
+  let m;
+  while ((m = re.exec(block)) !== null) {
+    const open = block.indexOf("{", m.index);
+    if (open < 0) continue;
+    let depth = 0;
+    for (let i = open; i < block.length; i++) {
+      const c = block[i];
+      if (c === "{") depth++;
+      else if (c === "}") {
+        depth--;
+        if (depth === 0) {
+          yield block.slice(open + 1, i);
+          re.lastIndex = i + 1;
+          break;
+        }
+      }
+    }
+  }
+}
+function setDiff(a, b) {
+  const bset = new Set(b);
+  return a.filter((x) => !bset.has(x)).sort();
+}
+function collectResourcesByEntry(resources) {
+  const out = /* @__PURE__ */ new Map();
+  for (const r of resources) {
+    const colon = r.id.indexOf(":");
+    const eid = colon >= 0 ? r.id.slice(0, colon) : r.id;
+    if (!out.has(eid)) out.set(eid, r);
+  }
+  return out;
+}
+function aggregateByRisk(entries) {
+  const out = {};
+  for (const e of entries) {
+    const k = e.diff.riskLevel;
+    out[k] = (out[k] ?? 0) + 1;
+  }
+  return out;
+}
+
+// src/core/ui-upgrade.ts
+var nodeRequire = createRequire6(import.meta.url);
+function resolvePackageRoot3(packageName) {
+  const pkgJsonPath = nodeRequire.resolve(`${packageName}/package.json`);
+  return path21.dirname(pkgJsonPath);
+}
+async function runUiUpgrade(options) {
+  const { projectRoot, category, ids = [], trigger } = options;
+  const config = await readProjectConfig(projectRoot);
+  if (!config) return { status: "not-initialized" };
+  const cfgKey = category === "ui" ? "ui" : "biz-ui";
+  if (!config.packages?.[cfgKey]) {
+    return { status: "not-installed", detail: `${category} not installed` };
+  }
+  const aliases = config.packages.ui?.aliases ?? config.packages["biz-ui"]?.aliases;
+  if (!aliases) {
+    return {
+      status: "not-installed",
+      detail: `${category} aliases not configured (run \`teamix-evo ui init\` first)`
+    };
+  }
+  const installed = await readInstalledManifest(projectRoot);
+  const lineageReport = await detectComponentLineage({
+    projectRoot,
+    category,
+    config,
+    installed
+  });
+  if (lineageReport.lineage !== "teamix-evo" && lineageReport.lineage !== "mixed") {
+    return {
+      status: "skipped",
+      detail: `lineage=${lineageReport.lineage}; nothing to stage`,
+      lineage: lineageReport.lineage
+    };
+  }
+  if (ids.length > 0) {
+    const knownIds = /* @__PURE__ */ new Set([
+      ...lineageReport.registeredIds,
+      ...lineageReport.unregisteredIds
+    ]);
+    const unknown = ids.filter((id) => !knownIds.has(id));
+    if (unknown.length > 0) {
+      throw new Error(
+        `Unknown ${category} component id(s): ${unknown.map((s) => `"${s}"`).join(
+          ", "
+        )}. Hint: \`teamix-evo ${category} list\` shows available ids.`
+      );
+    }
+  }
+  const built = await buildStaging({
+    category,
+    projectRoot,
+    aliases,
+    lineageReport,
+    trigger,
+    onlyIds: ids,
+    uiPackageRoot: options.uiPackageRoot,
+    bizUiPackageRoot: options.bizUiPackageRoot
+  });
+  if (built === null) {
+    return {
+      status: "skipped",
+      detail: "no entries to stage",
+      lineage: lineageReport.lineage
+    };
+  }
+  return {
+    status: "staged",
+    stagingDir: built.stagingDir,
+    manifest: built.manifest
+  };
+}
+async function buildStaging(args) {
+  const { category, projectRoot, aliases, lineageReport, trigger, onlyIds } = args;
+  if (category === "ui") {
+    const root = args.uiPackageRoot ?? resolvePackageRoot3("@teamix-evo/ui");
+    const manifest = await loadUiPackageManifest2(root);
+    return buildUiUpgradeStaging({
+      projectRoot,
+      category,
+      manifest,
+      packageRoot: root,
+      aliases,
+      lineageReport,
+      trigger,
+      onlyIds
+    });
+  }
+  const bizRoot = args.bizUiPackageRoot ?? resolvePackageRoot3("@teamix-evo/biz-ui");
+  const variant = lineageReport.installedVariant ?? "_flat";
+  const variantDir = path21.join(bizRoot, "variants", variant);
+  const variantManifest = await loadVariantUiPackageManifest(variantDir);
+  const uiRoot = args.uiPackageRoot ?? resolvePackageRoot3("@teamix-evo/ui");
+  const uiManifest = await loadUiPackageManifest2(uiRoot);
+  const entryPackageRoot = /* @__PURE__ */ new Map();
+  const merged = [];
+  for (const e of variantManifest.entries) {
+    entryPackageRoot.set(e.id, variantDir);
+    merged.push(e);
+  }
+  for (const e of uiManifest.entries) {
+    if (entryPackageRoot.has(e.id)) continue;
+    entryPackageRoot.set(e.id, uiRoot);
+    merged.push(e);
+  }
+  const synthetic = {
+    schemaVersion: 1,
+    package: "ui",
+    version: variantManifest.version,
+    engines: variantManifest.engines,
+    entries: merged
+  };
+  return buildUiUpgradeStaging({
+    projectRoot,
+    category,
+    manifest: synthetic,
+    packageRoot: variantDir,
+    entryPackageRoot,
+    aliases,
+    lineageReport,
+    trigger,
+    onlyIds
+  });
+}
+
+// src/commands/_upgrade-command-factory.ts
+var META = {
+  ui: {
+    category: "ui",
+    installDirHint: "src/components/ui",
+    notInstalledHint: "npx teamix-evo ui init",
+    trigger: "ui-upgrade"
+  },
+  "biz-ui": {
+    category: "biz-ui",
+    installDirHint: "src/components/business",
+    notInstalledHint: "npx teamix-evo biz-ui add <id>",
+    trigger: "biz-ui-upgrade"
+  }
+};
+function makeUpgradeCommand(category) {
+  const meta = META[category];
+  return new Command18("upgrade").description(
+    `\u4E3A ${category} \u7EC4\u4EF6\u751F\u6210\u5347\u7EA7 staging\uFF08\u4E0D\u5199 src\uFF0C\u9700\u901A\u8FC7 teamix-evo-upgrade skill \u5E94\u7528\uFF09`
+  ).argument(
+    "[ids...]",
+    "\u53EF\u9009 entry id \u5217\u8868\uFF1B\u7701\u7565\u65F6\u5BF9\u5168\u90E8\u5DF2\u5B89\u88C5\u7EC4\u4EF6\u751F\u6210 staging"
+  ).option(
+    "--apply",
+    `\uFF08\u5B88\u536B\u63D0\u793A\uFF09\u4FDD\u7559\u4F46\u62D2\u7EDD\u6267\u884C\uFF1ACLI \u4E0D\u5199 ${meta.installDirHint}\uFF0C\u8BF7\u901A\u8FC7 teamix-evo-upgrade skill \u5E94\u7528 staging`
+  ).action(async (ids, opts) => {
+    if (opts.apply) {
+      logger.error(
+        `CLI \u4E0D\u4F1A\u81EA\u52A8\u5199\u5165 ${meta.installDirHint}\uFF08ADR 0019 frozen \u8FB9\u754C\uFF09\u3002`
+      );
+      logger.error(
+        `\u8BF7\u8FD0\u884C \`teamix-evo ${category} upgrade\` \u751F\u6210 staging\uFF0C\u518D\u8BA9 AI \u8C03\u7528 teamix-evo-upgrade skill \u9010\u6587\u4EF6\u5E94\u7528\u3002`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      const ide = detectIde();
+      const projectRoot = ide.getProjectRoot();
+      const result = await runUiUpgrade({
+        projectRoot,
+        category: meta.category,
+        ids,
+        trigger: meta.trigger
+      });
+      switch (result.status) {
+        case "not-initialized":
+          logger.error(
+            "Project not initialized. Run `npx teamix-evo init` first."
+          );
+          process.exitCode = 1;
+          return;
+        case "not-installed":
+          logger.error(`${category} not installed: ${result.detail}`);
+          logger.error(`Run \`${meta.notInstalledHint}\` first.`);
+          process.exitCode = 1;
+          return;
+        case "skipped":
+          logger.info(
+            `Nothing to stage (lineage=${result.lineage}): ${result.detail}`
+          );
+          return;
+        case "staged": {
+          const { manifest, stagingDir } = result;
+          logger.success(
+            `${category} staging written: ${manifest.summary.total} entries \u2192 ${stagingDir}`
+          );
+          const byRisk = manifest.summary.byRisk;
+          const parts = Object.entries(byRisk).filter(([, n]) => (n ?? 0) > 0).map(([k, n]) => `${k}=${n}`);
+          if (parts.length > 0) {
+            logger.info(`  risk: ${parts.join(", ")}`);
+          }
+          logger.info("");
+          logger.info(
+            "Next: \u8BA9 AI \u8C03\u7528 teamix-evo-upgrade skill\uFF0C\u6309 risk \u5206\u6279 review & apply\u3002"
+          );
+          return;
+        }
+      }
+    } catch (err) {
+      logger.error(
+        `Failed to build ${category} staging: ${getErrorMessage(err)}`
+      );
+      logger.debug(err.stack ?? "");
+      process.exitCode = 1;
+    }
+  });
+}
+
+// src/commands/ui/upgrade.ts
+var upgradeCommand = makeUpgradeCommand("ui");
+
+// src/commands/ui/index.ts
+var uiCommand = new Command19("ui").description(
+  "\u7BA1\u7406 teamix-evo ui \u7EC4\u4EF6\uFF08\u6E90\u7801\u6CE8\u5165\u5F0F\u5B89\u88C5\uFF0Cshadcn \u98CE\u683C\uFF09"
+);
+uiCommand.addCommand(initCommand3);
+uiCommand.addCommand(addCommand2);
+uiCommand.addCommand(listCommand3);
+uiCommand.addCommand(upgradeCommand);
+
+// src/commands/biz-ui/index.ts
+import { Command as Command23 } from "commander";
+
+// src/commands/biz-ui/add.ts
+import { Command as Command20 } from "commander";
+
+// src/core/variant-ui-add.ts
+import * as path22 from "path";
+import { createRequire as createRequire7 } from "module";
+import {
+  loadUiPackageManifest as loadUiPackageManifest3,
+  loadVariantUiPackageCatalog,
+  loadVariantUiPackageManifest as loadVariantUiPackageManifest2
+} from "@teamix-evo/registry";
+var require7 = createRequire7(import.meta.url);
+function resolvePackageRoot4(packageName) {
+  const pkgJsonPath = require7.resolve(`${packageName}/package.json`);
+  return path22.dirname(pkgJsonPath);
+}
+async function runVariantUiAdd(packageName, options) {
+  const { projectRoot, variant, ids, overwrite } = options;
+  const fullPackageName = options.packageName ?? `@teamix-evo/${packageName}`;
+  if (ids.length === 0) {
+    throw new Error("At least one entry id must be provided.");
+  }
+  const config = await readProjectConfig(projectRoot);
+  const uiCfg = config?.packages?.ui;
+  if (!config || !uiCfg?.aliases) {
+    throw new Error(
+      `UI not initialized. Run \`teamix-evo ui init\` first \u2014 \`${packageName} add\` writes into the same alias map (business / templates).`
+    );
+  }
+  const packageRoot = options.packageRoot ?? resolvePackageRoot4(fullPackageName);
+  const catalog = await loadVariantUiPackageCatalog(packageRoot);
+  if (!catalog.variants.some((v) => v.name === variant)) {
+    const known = catalog.variants.map((v) => v.name).join(", ");
+    throw new Error(
+      `Variant "${variant}" not found in ${fullPackageName}. Known variants: ${known}. Hint: \`teamix-evo ${packageName} list-variants\` shows all.`
+    );
+  }
+  const variantDir = path22.join(packageRoot, "variants", variant);
+  const variantManifest = await loadVariantUiPackageManifest2(variantDir);
+  const knownIds = new Set(variantManifest.entries.map((e) => e.id));
+  const unknown = ids.filter((id) => !knownIds.has(id));
   if (unknown.length > 0) {
     throw new Error(
       `Unknown entry id(s) in ${packageName}#${variant}: ${unknown.map((s) => `"${s}"`).join(", ")}. Run \`teamix-evo ${packageName} list-variants\` to see this package's variants, or \`teamix-evo ${packageName} list --variant ${variant}\` for its entries.`
     );
   }
-  const uiPackageRoot = resolvePackageRoot3("@teamix-evo/ui");
-  const uiManifest = await loadUiPackageManifest2(uiPackageRoot);
+  const uiPackageRoot = resolvePackageRoot4("@teamix-evo/ui");
+  const uiManifest = await loadUiPackageManifest3(uiPackageRoot);
   const entryPackageRoot = /* @__PURE__ */ new Map();
   const mergedEntries = [];
   for (const e of variantManifest.entries) {
@@ -3477,7 +4336,7 @@ async function runVariantUiAdd(packageName, options) {
     projectRoot
   ) ?? { schemaVersion: 1, installed: [] };
   const idx = installed.installed.findIndex(
-    (p) => p.package === fullPackageName && p.variant === variant
+    (p2) => p2.package === fullPackageName && p2.variant === variant
   );
   const prior = idx >= 0 ? installed.installed[idx] : null;
   const mergedResources = mergeResources2(
@@ -3518,7 +4377,7 @@ async function runTemplatesAdd(options) {
 }
 async function listVariantUi(packageName, packageRoot) {
   const fullPackageName = `@teamix-evo/${packageName}`;
-  const root = packageRoot ?? resolvePackageRoot3(fullPackageName);
+  const root = packageRoot ?? resolvePackageRoot4(fullPackageName);
   const catalog = await loadVariantUiPackageCatalog(root);
   return {
     packageName: fullPackageName,
@@ -3538,7 +4397,7 @@ async function listTemplatesVariants(packageRoot) {
 }
 async function listVariantUiEntries(packageName, variant, packageRoot) {
   const fullPackageName = `@teamix-evo/${packageName}`;
-  const root = packageRoot ?? resolvePackageRoot3(fullPackageName);
+  const root = packageRoot ?? resolvePackageRoot4(fullPackageName);
   const catalog = await loadVariantUiPackageCatalog(root);
   if (!catalog.variants.some((v) => v.name === variant)) {
     const known = catalog.variants.map((v) => v.name).join(", ");
@@ -3546,8 +4405,8 @@ async function listVariantUiEntries(packageName, variant, packageRoot) {
       `Variant "${variant}" not found in ${fullPackageName}. Known: ${known}.`
     );
   }
-  const variantDir = path18.join(root, "variants", variant);
-  const variantManifest = await loadVariantUiPackageManifest(variantDir);
+  const variantDir = path22.join(root, "variants", variant);
+  const variantManifest = await loadVariantUiPackageManifest2(variantDir);
   return {
     packageName: fullPackageName,
     variant,
@@ -3568,7 +4427,7 @@ async function listTemplatesEntries(variant, packageRoot) {
 }
 
 // src/commands/biz-ui/add.ts
-var addCommand3 = new Command19("add").description(
+var addCommand3 = new Command20("add").description(
   "\u5B89\u88C5\u4E00\u4E2A\u6216\u591A\u4E2A\u4E1A\u52A1 UI \u7EC4\u4EF6(\u6309 id,\u81EA\u52A8\u5C55\u5F00 ui \u5305\u7684 registryDependencies)"
 ).argument("<ids...>", '\u7EC4\u4EF6 id \u5217\u8868,\u5982 "tenant-switcher" "org-picker"').option("--variant <name>", '\u53D8\u4F53 id(\u5FC5\u586B,\u5982 "opentrek"\u3001"uni-manager")').option("--overwrite", "\u5373\u4F7F\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728\u4E5F\u8986\u76D6").action(
   async (ids, opts) => {
@@ -3587,7 +4446,9 @@ var addCommand3 = new Command19("add").description(
         );
       }
       logger.info(
-        `Installing biz-ui entries from variant "${opts.variant}": ${ids.join(", ")}`
+        `Installing biz-ui entries from variant "${opts.variant}": ${ids.join(
+          ", "
+        )}`
       );
       const result = await runBizUiAdd({
         projectRoot,
@@ -3609,7 +4470,7 @@ var addCommand3 = new Command19("add").description(
         logger.info(`  pnpm add ${installCmd}`);
       }
     } catch (err) {
-      logger.error(`Failed: ${err.message}`);
+      logger.error(`Failed: ${getErrorMessage(err)}`);
       logger.debug(err.stack ?? "");
       process.exitCode = 1;
     }
@@ -3617,8 +4478,8 @@ var addCommand3 = new Command19("add").description(
 );
 
 // src/commands/biz-ui/list.ts
-import { Command as Command20 } from "commander";
-var listCommand4 = new Command20("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 biz-ui entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
+import { Command as Command21 } from "commander";
+var listCommand4 = new Command21("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 biz-ui entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
   try {
     const result = await listBizUiEntries(opts.variant);
     logger.info(`${result.packageName}#${result.variant} entries:`);
@@ -3637,14 +4498,14 @@ var listCommand4 = new Command20("list").description("\u5217\u51FA\u6307\u5B9A\u
       `Install: npx teamix-evo@latest biz-ui add <id> --variant ${result.variant}`
     );
   } catch (err) {
-    logger.error(`Failed: ${err.message}`);
+    logger.error(`Failed: ${getErrorMessage(err)}`);
     process.exitCode = 1;
   }
 });
 
 // src/commands/biz-ui/list-variants.ts
-import { Command as Command21 } from "commander";
-var listVariantsCommand2 = new Command21("list-variants").description("\u5217\u51FA @teamix-evo/biz-ui \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u4E1A\u52A1\u53D8\u4F53").action(async () => {
+import { Command as Command22 } from "commander";
+var listVariantsCommand2 = new Command22("list-variants").description("\u5217\u51FA @teamix-evo/biz-ui \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u4E1A\u52A1\u53D8\u4F53").action(async () => {
   try {
     const result = await listBizUiVariants();
     logger.info(`Available biz-ui variants in ${result.packageName}:`);
@@ -3658,27 +4519,33 @@ var listVariantsCommand2 = new Command21("list-variants").description("\u5217\u5
       if (v.description) logger.info(`    ${v.description}`);
       logger.info("");
     }
-    logger.info("Install from a variant: npx teamix-evo@latest biz-ui add <id> --variant <name>");
+    logger.info(
+      "Install from a variant: npx teamix-evo@latest biz-ui add <id> --variant <name>"
+    );
   } catch (err) {
-    logger.error(`Failed: ${err.message}`);
+    logger.error(`Failed: ${getErrorMessage(err)}`);
     process.exitCode = 1;
   }
 });
 
+// src/commands/biz-ui/upgrade.ts
+var upgradeCommand2 = makeUpgradeCommand("biz-ui");
+
 // src/commands/biz-ui/index.ts
-var bizUiCommand = new Command22("biz-ui").description(
+var bizUiCommand = new Command23("biz-ui").description(
   "\u7BA1\u7406\u4E1A\u52A1 UI \u7EC4\u4EF6(\u53D8\u4F53\u611F\u77E5 \u2014 \u4E0E design / templates \u540C\u53D8\u4F53\u540D\u7A7A\u95F4)"
 );
 bizUiCommand.addCommand(addCommand3);
 bizUiCommand.addCommand(listCommand4);
 bizUiCommand.addCommand(listVariantsCommand2);
+bizUiCommand.addCommand(upgradeCommand2);
 
 // src/commands/templates/index.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 
 // src/commands/templates/add.ts
-import { Command as Command23 } from "commander";
-var addCommand4 = new Command23("add").description(
+import { Command as Command24 } from "commander";
+var addCommand4 = new Command24("add").description(
   "\u5B89\u88C5\u4E00\u4E2A\u6216\u591A\u4E2A\u9875\u9762\u6A21\u677F(\u6309 id,\u81EA\u52A8\u5C55\u5F00 ui \u5305\u7684 registryDependencies)"
 ).argument("<ids...>", '\u6A21\u677F id \u5217\u8868,\u5982 "list-detail-page"').option("--variant <name>", '\u53D8\u4F53 id(\u5FC5\u586B,\u5982 "opentrek"\u3001"uni-manager")').option("--overwrite", "\u5373\u4F7F\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728\u4E5F\u8986\u76D6").action(
   async (ids, opts) => {
@@ -3697,7 +4564,9 @@ var addCommand4 = new Command23("add").description(
         );
       }
       logger.info(
-        `Installing templates from variant "${opts.variant}": ${ids.join(", ")}`
+        `Installing templates from variant "${opts.variant}": ${ids.join(
+          ", "
+        )}`
       );
       const result = await runTemplatesAdd({
         projectRoot,
@@ -3719,7 +4588,7 @@ var addCommand4 = new Command23("add").description(
         logger.info(`  pnpm add ${installCmd}`);
       }
     } catch (err) {
-      logger.error(`Failed: ${err.message}`);
+      logger.error(`Failed: ${getErrorMessage(err)}`);
       logger.debug(err.stack ?? "");
       process.exitCode = 1;
     }
@@ -3727,8 +4596,8 @@ var addCommand4 = new Command23("add").description(
 );
 
 // src/commands/templates/list.ts
-import { Command as Command24 } from "commander";
-var listCommand5 = new Command24("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 templates entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
+import { Command as Command25 } from "commander";
+var listCommand5 = new Command25("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 templates entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
   try {
     const result = await listTemplatesEntries(opts.variant);
     logger.info(`${result.packageName}#${result.variant} entries:`);
@@ -3747,14 +4616,14 @@ var listCommand5 = new Command24("list").description("\u5217\u51FA\u6307\u5B9A\u
       `Install: npx teamix-evo@latest templates add <id> --variant ${result.variant}`
     );
   } catch (err) {
-    logger.error(`Failed: ${err.message}`);
+    logger.error(`Failed: ${getErrorMessage(err)}`);
     process.exitCode = 1;
   }
 });
 
 // src/commands/templates/list-variants.ts
-import { Command as Command25 } from "commander";
-var listVariantsCommand3 = new Command25("list-variants").description("\u5217\u51FA @teamix-evo/templates \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u9875\u9762\u6A21\u677F\u53D8\u4F53").action(async () => {
+import { Command as Command26 } from "commander";
+var listVariantsCommand3 = new Command26("list-variants").description("\u5217\u51FA @teamix-evo/templates \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u9875\u9762\u6A21\u677F\u53D8\u4F53").action(async () => {
   try {
     const result = await listTemplatesVariants();
     logger.info(`Available templates variants in ${result.packageName}:`);
@@ -3768,15 +4637,17 @@ var listVariantsCommand3 = new Command25("list-variants").description("\u5217\u5
       if (v.description) logger.info(`    ${v.description}`);
       logger.info("");
     }
-    logger.info("Install from a variant: npx teamix-evo@latest templates add <id> --variant <name>");
+    logger.info(
+      "Install from a variant: npx teamix-evo@latest templates add <id> --variant <name>"
+    );
   } catch (err) {
-    logger.error(`Failed: ${err.message}`);
+    logger.error(`Failed: ${getErrorMessage(err)}`);
     process.exitCode = 1;
   }
 });
 
 // src/commands/templates/index.ts
-var templatesCommand = new Command26("templates").description(
+var templatesCommand = new Command27("templates").description(
   "\u7BA1\u7406\u9875\u9762\u6A21\u677F(\u53D8\u4F53\u611F\u77E5 \u2014 \u4E0E design / biz-ui \u540C\u53D8\u4F53\u540D\u7A7A\u95F4)"
 );
 templatesCommand.addCommand(addCommand4);
@@ -3784,16 +4655,16 @@ templatesCommand.addCommand(listCommand5);
 templatesCommand.addCommand(listVariantsCommand3);
 
 // src/commands/logs/index.ts
-import { Command as Command29 } from "commander";
+import { Command as Command30 } from "commander";
 
 // src/commands/logs/analyze.ts
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 import { existsSync as existsSync2 } from "fs";
-import { resolve as resolve3, join as join18 } from "path";
+import { resolve as resolve4, join as join22 } from "path";
 
 // src/commands/logs/_io.ts
 import { readFileSync, readdirSync, statSync } from "fs";
-import { join as join17 } from "path";
+import { join as join21 } from "path";
 var DATE_DIR_RE = /^\d{4}-\d{2}-\d{2}$/;
 function parseIntOrUndef(v) {
   if (v === void 0) return void 0;
@@ -3805,7 +4676,7 @@ function readRecords(baseDir, dayLimit) {
   const selected = dayLimit !== void 0 ? dayDirs.slice(0, dayLimit) : dayDirs;
   const records = [];
   for (const day of selected) {
-    const dayPath = join17(baseDir, day);
+    const dayPath = join21(baseDir, day);
     let entries;
     try {
       entries = readdirSync(dayPath);
@@ -3814,7 +4685,7 @@ function readRecords(baseDir, dayLimit) {
     }
     for (const entry of entries) {
       if (!entry.endsWith(".jsonl")) continue;
-      const fp = join17(dayPath, entry);
+      const fp = join21(dayPath, entry);
       try {
         if (!statSync(fp).isFile()) continue;
       } catch {
@@ -3834,14 +4705,14 @@ function readRecords(baseDir, dayLimit) {
 }
 
 // src/commands/logs/analyze.ts
-var logsAnalyzeCommand = new Command27("analyze").description(
+var logsAnalyzeCommand = new Command28("analyze").description(
   "\u6C47\u603B vibe-logger \u8F93\u51FA (.teamix-evo/logs/ai/**/*.jsonl) \u2014 \u5DE5\u5177 / \u5305\u6807\u7B7E / MCP \u8C03\u7528\u9891\u7387,\u8F85\u52A9\u751F\u6001\u4F18\u5316"
 ).option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option(
   "--days <n>",
   "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4\u5168\u90E8;\u6309\u76EE\u5F55\u540D YYYY-MM-DD \u6BD4\u5BF9,\u4E0D\u89E3\u6790\u8BB0\u5F55 ts)"
 ).option("--top <n>", "\u6BCF\u4E2A\u6392\u884C\u5C55\u793A\u524D N \u9879 (\u9ED8\u8BA4 10)", "10").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
-  const baseDir = resolve3(
-    opts.dir ?? join18(process.cwd(), ".teamix-evo", "logs", "ai")
+  const baseDir = resolve4(
+    opts.dir ?? join22(process.cwd(), ".teamix-evo", "logs", "ai")
   );
   if (!existsSync2(baseDir)) {
     logger.warn(`No log directory at ${baseDir}.`);
@@ -3983,14 +4854,14 @@ function pad(n, width) {
 }
 
 // src/commands/logs/trace.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 import { existsSync as existsSync3 } from "fs";
-import { resolve as resolve4, join as join19 } from "path";
-var logsTraceCommand = new Command28("trace").description(
+import { resolve as resolve5, join as join23 } from "path";
+var logsTraceCommand = new Command29("trace").description(
   "\u6309\u4F1A\u8BDD\u8FD8\u539F AI \u8C03\u7528\u94FE\u8DEF:\u4ECE\u7528\u6237 prompt \u8D77\u59CB,\u4E32\u8054\u540E\u7EED PreToolUse/PostToolUse \u76F4\u5230\u4E0B\u4E00\u4E2A prompt \u6216 Stop"
 ).option("--prompt <keyword>", "\u6309\u7528\u6237\u8F93\u5165\u5173\u952E\u5B57\u8FC7\u6EE4 (\u5B50\u4E32\u5339\u914D,\u4E0D\u533A\u5206\u5927\u5C0F\u5199)").option("--session <id>", "\u6307\u5B9A\u4F1A\u8BDD ID (\u524D\u7F00\u5339\u914D)").option("--days <n>", "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4 7)", "7").option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
-  const baseDir = resolve4(
-    opts.dir ?? join19(process.cwd(), ".teamix-evo", "logs", "ai")
+  const baseDir = resolve5(
+    opts.dir ?? join23(process.cwd(), ".teamix-evo", "logs", "ai")
   );
   if (!existsSync3(baseDir)) {
     logger.warn(`No log directory at ${baseDir}.`);
@@ -4159,22 +5030,22 @@ function padLeft(s, n) {
 }
 
 // src/commands/logs/index.ts
-var logsCommand = new Command29("logs").description(
+var logsCommand = new Command30("logs").description(
   "\u67E5\u8BE2 vibe-logger \u8F93\u51FA (.teamix-evo/logs/ai/**/*.jsonl) \u2014 AI \u8C03\u7528\u94FE\u5206\u6790"
 );
 logsCommand.addCommand(logsAnalyzeCommand);
 logsCommand.addCommand(logsTraceCommand);
 
 // src/commands/lint/index.ts
-import { Command as Command31 } from "commander";
+import { Command as Command32 } from "commander";
 
 // src/commands/lint/init.ts
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 import * as prompts6 from "@clack/prompts";
 
 // src/core/lint-init.ts
-import * as path19 from "path";
-import * as fs15 from "fs";
+import * as path23 from "path";
+import * as fs16 from "fs";
 import { execa } from "execa";
 var ESLINT_CONFIG_CONTENT = `/**
  * teamix-evo consumer ESLint preset \u2014 9 token-discipline rules.
@@ -4202,8 +5073,8 @@ var ESLINT_DEPS = [
 var STYLELINT_DEPS = ["@teamix-evo/stylelint-config", "stylelint"];
 async function runLintInit(options) {
   const { projectRoot, skipInstall } = options;
-  const eslintConfigPath = path19.join(projectRoot, "eslint.config.js");
-  const stylelintConfigPath = path19.join(projectRoot, "stylelint.config.cjs");
+  const eslintConfigPath = path23.join(projectRoot, "eslint.config.js");
+  const stylelintConfigPath = path23.join(projectRoot, "stylelint.config.cjs");
   const eslintExists = await fileExists(eslintConfigPath);
   const stylelintExists = await fileExists(stylelintConfigPath);
   if (eslintExists && stylelintExists) {
@@ -4241,12 +5112,12 @@ async function runLintInit(options) {
   };
 }
 function detectPm(projectRoot) {
-  if (fs15.existsSync(path19.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs15.existsSync(path19.join(projectRoot, "yarn.lock"))) return "yarn";
+  if (fs16.existsSync(path23.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs16.existsSync(path23.join(projectRoot, "yarn.lock"))) return "yarn";
   return "npm";
 }
 async function patchPackageJsonScripts(projectRoot) {
-  const pkgPath = path19.join(projectRoot, "package.json");
+  const pkgPath = path23.join(projectRoot, "package.json");
   const raw = await readFileOrNull(pkgPath);
   if (!raw) return;
   let pkg;
@@ -4273,7 +5144,7 @@ async function patchPackageJsonScripts(projectRoot) {
 }
 
 // src/commands/lint/init.ts
-var initCommand4 = new Command30("init").description(
+var initCommand4 = new Command31("init").description(
   "\u521D\u59CB\u5316 ESLint + Stylelint \u5DE5\u7A0B\u89C4\u8303\uFF08\u5B89\u88C5\u4F9D\u8D56 + \u751F\u6210\u914D\u7F6E\u6587\u4EF6 + \u6CE8\u5165 scripts\uFF09"
 ).option("-y, --yes", "\u8DF3\u8FC7\u786E\u8BA4\uFF0C\u76F4\u63A5\u6267\u884C").action(async (opts) => {
   try {
@@ -4314,22 +5185,2273 @@ var initCommand4 = new Command30("init").description(
     logger.info('Run "npm run lint" to check JSX/TSX token discipline.');
     logger.info('Run "npm run lint:css" to check CSS token discipline.');
   } catch (err) {
-    logger.error(`Failed to initialize lint: ${err.message}`);
+    logger.error(`Failed to initialize lint: ${getErrorMessage(err)}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
 });
 
 // src/commands/lint/index.ts
-var lintCommand = new Command31("lint").description(
+var lintCommand = new Command32("lint").description(
   "\u7BA1\u7406\u5DE5\u7A0B\u89C4\u8303\uFF08ESLint + Stylelint token-discipline \u89C4\u5219\u96C6\uFF09"
 );
 lintCommand.addCommand(initCommand4);
 
+// src/commands/init/index.ts
+import { Command as Command33 } from "commander";
+import * as path29 from "path";
+
+// src/core/init-detect.ts
+import * as fs17 from "fs/promises";
+import * as path24 from "path";
+var IGNORED_TOP_LEVEL = /* @__PURE__ */ new Set([
+  ".git",
+  ".gitignore",
+  ".gitattributes",
+  ".gitkeep",
+  ".DS_Store",
+  "Thumbs.db",
+  ".idea",
+  ".vscode",
+  ".qoder",
+  ".claude",
+  "README.md",
+  "README",
+  "README.txt",
+  "LICENSE",
+  "LICENSE.md",
+  "LICENSE.txt"
+]);
+async function detectProjectState(cwd) {
+  const absCwd = path24.resolve(cwd);
+  const teamixDir = getTeamixDir(absCwd);
+  const hasTeamixDir = await fileExists(teamixDir);
+  if (hasTeamixDir) {
+    return {
+      state: "teamix-evo-installed",
+      cwd: absCwd,
+      hasTeamixDir: true,
+      hasPackageJson: await fileExists(path24.join(absCwd, "package.json")),
+      significantEntries: []
+    };
+  }
+  let entries;
+  try {
+    entries = await fs17.readdir(absCwd);
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return {
+        state: "empty",
+        cwd: absCwd,
+        hasTeamixDir: false,
+        hasPackageJson: false,
+        significantEntries: []
+      };
+    }
+    throw err;
+  }
+  const significant = entries.filter((e) => !IGNORED_TOP_LEVEL.has(e));
+  const hasPackageJson2 = entries.includes("package.json");
+  if (significant.length === 0) {
+    return {
+      state: "empty",
+      cwd: absCwd,
+      hasTeamixDir: false,
+      hasPackageJson: false,
+      significantEntries: []
+    };
+  }
+  return {
+    state: "non-teamix-evo",
+    cwd: absCwd,
+    hasTeamixDir: false,
+    hasPackageJson: hasPackageJson2,
+    significantEntries: significant.slice(0, 20).sort()
+  };
+}
+
+// src/core/init-conflicts.ts
+import * as crypto from "crypto";
+import * as fs18 from "fs/promises";
+import * as path25 from "path";
+var TAILWIND_CONFIG_CANDIDATES = [
+  "tailwind.config.ts",
+  "tailwind.config.js",
+  "tailwind.config.cjs",
+  "tailwind.config.mjs"
+];
+var TOKENS_FILE_CANDIDATES = [
+  "src/design-tokens.css",
+  "src/styles/design-tokens.css",
+  "src/styles/tokens.css"
+];
+var TOKENS_DIR_CANDIDATES = ["tokens"];
+var INDEX_CSS_CANDIDATES = [
+  "src/index.css",
+  "src/main.css",
+  "src/app.css",
+  "src/styles/index.css",
+  "src/styles/globals.css"
+];
+var SHADCN_FILE_CANDIDATES = ["src/lib/utils.ts"];
+var SHADCN_DIR_CANDIDATES = ["src/components/ui"];
+async function isDir(target) {
+  try {
+    const stat7 = await fs18.stat(target);
+    return stat7.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function dirHasContent(target) {
+  try {
+    const entries = await fs18.readdir(target);
+    return entries.length > 0;
+  } catch {
+    return false;
+  }
+}
+function fingerprint(parts) {
+  const hash = crypto.createHash("sha256");
+  for (const p2 of [...parts].sort()) hash.update(p2);
+  return `sha256:${hash.digest("hex").slice(0, 16)}`;
+}
+async function readPackageJson(cwd) {
+  const raw = await readFileOrNull(path25.join(cwd, "package.json"));
+  if (raw === null) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function detectTailwindMajor(pkg) {
+  if (!pkg) return null;
+  const v = pkg.dependencies?.tailwindcss ?? pkg.devDependencies?.tailwindcss ?? null;
+  if (!v) return null;
+  const m = /(\d+)/.exec(v);
+  if (!m) return null;
+  const major = Number.parseInt(m[1], 10);
+  if (major === 3) return 3;
+  if (major === 4) return 4;
+  return null;
+}
+async function detectAgentsMd(cwd) {
+  const target = path25.join(cwd, "AGENTS.md");
+  const content = await readFileOrNull(target);
+  const exists = content !== null;
+  return {
+    key: "agents-md",
+    exists,
+    paths: exists ? ["AGENTS.md"] : [],
+    fingerprint: exists ? fingerprint([content]) : void 0,
+    recommendedStrategy: exists ? "merge-managed" : "overwrite",
+    availableStrategies: ["merge-managed", "overwrite", "skip"]
+  };
+}
+async function detectComponentsJson(cwd) {
+  const target = path25.join(cwd, "components.json");
+  const content = await readFileOrNull(target);
+  const exists = content !== null;
+  return {
+    key: "components-json",
+    exists,
+    paths: exists ? ["components.json"] : [],
+    fingerprint: exists ? fingerprint([content]) : void 0,
+    recommendedStrategy: exists ? "diff-prompt" : "overwrite",
+    availableStrategies: ["diff-prompt", "overwrite", "skip"]
+  };
+}
+async function detectTailwindConfig(cwd) {
+  const matched = [];
+  const contents = [];
+  for (const rel2 of TAILWIND_CONFIG_CANDIDATES) {
+    const c = await readFileOrNull(path25.join(cwd, rel2));
+    if (c !== null) {
+      matched.push(rel2);
+      contents.push(c);
+    }
+  }
+  const pkg = await readPackageJson(cwd);
+  const tailwindMajor = detectTailwindMajor(pkg);
+  const exists = matched.length > 0;
+  return {
+    key: "tailwind-config",
+    exists,
+    paths: matched,
+    fingerprint: exists ? fingerprint(contents) : void 0,
+    recommendedStrategy: exists ? "backup-overwrite" : "overwrite",
+    availableStrategies: ["backup-overwrite", "overwrite", "skip"],
+    meta: { tailwindMajor }
+  };
+}
+async function detectTokens(cwd) {
+  const matched = [];
+  const contents = [];
+  for (const rel2 of TOKENS_FILE_CANDIDATES) {
+    const c = await readFileOrNull(path25.join(cwd, rel2));
+    if (c !== null) {
+      matched.push(rel2);
+      contents.push(c);
+    }
+  }
+  for (const rel2 of TOKENS_DIR_CANDIDATES) {
+    const abs = path25.join(cwd, rel2);
+    if (await isDir(abs) && await dirHasContent(abs)) {
+      matched.push(`${rel2}/`);
+    }
+  }
+  const exists = matched.length > 0;
+  return {
+    key: "tokens",
+    exists,
+    paths: matched,
+    fingerprint: contents.length > 0 ? fingerprint(contents) : void 0,
+    recommendedStrategy: exists ? "migrate" : "overwrite",
+    availableStrategies: ["migrate", "coexist", "overwrite", "skip"]
+  };
+}
+async function detectIndexCss(cwd) {
+  const matched = [];
+  const contents = [];
+  for (const rel2 of INDEX_CSS_CANDIDATES) {
+    const c = await readFileOrNull(path25.join(cwd, rel2));
+    if (c !== null) {
+      matched.push(rel2);
+      contents.push(c);
+    }
+  }
+  const exists = matched.length > 0;
+  return {
+    key: "index-css",
+    exists,
+    paths: matched,
+    fingerprint: exists ? fingerprint(contents) : void 0,
+    recommendedStrategy: exists ? "append" : "overwrite",
+    availableStrategies: ["append", "diff-prompt", "overwrite", "skip"]
+  };
+}
+async function detectShadcnSource(cwd) {
+  const matched = [];
+  for (const rel2 of SHADCN_FILE_CANDIDATES) {
+    if (await fileExists(path25.join(cwd, rel2))) matched.push(rel2);
+  }
+  for (const rel2 of SHADCN_DIR_CANDIDATES) {
+    const abs = path25.join(cwd, rel2);
+    if (await isDir(abs) && await dirHasContent(abs)) {
+      matched.push(`${rel2}/`);
+    }
+  }
+  let componentCount = 0;
+  try {
+    const uiDir = path25.join(cwd, "src/components/ui");
+    if (await isDir(uiDir)) {
+      const entries = await fs18.readdir(uiDir);
+      componentCount = entries.filter(
+        (e) => e.endsWith(".tsx") || e.endsWith(".ts")
+      ).length;
+    }
+  } catch {
+  }
+  const exists = matched.length > 0;
+  return {
+    key: "shadcn-source",
+    exists,
+    paths: matched,
+    recommendedStrategy: exists ? "skip-existing" : "overwrite",
+    availableStrategies: ["skip-existing", "per-file-prompt", "overwrite"],
+    meta: { componentCount }
+  };
+}
+async function detectConflicts(cwd) {
+  const absCwd = path25.resolve(cwd);
+  const items = await Promise.all([
+    detectAgentsMd(absCwd),
+    detectComponentsJson(absCwd),
+    detectTailwindConfig(absCwd),
+    detectTokens(absCwd),
+    detectIndexCss(absCwd),
+    detectShadcnSource(absCwd)
+  ]);
+  return {
+    cwd: absCwd,
+    items,
+    hasAnyConflict: items.some((i) => i.exists)
+  };
+}
+
+// src/core/legacy-tokens-migrate.ts
+import * as path26 from "path";
+import * as fs19 from "fs/promises";
+var CONSUMER_TOKENS_DIR2 = "tokens";
+var CONSUMER_OVERRIDES_FILE2 = "tokens.overrides.css";
+var EMPTY_OVERRIDES_TEMPLATE2 = `/* User-owned token overrides \u2014 frozen on subsequent installs. */
+/* See @teamix-evo/tokens variant theme.css for available CSS custom properties. */
+`;
+function buildMigrationBanner(legacyRel, isoTimestamp) {
+  return `/* === Migrated from ${legacyRel} on ${isoTimestamp} === */
+`;
+}
+function computeBackupRel(legacyRel, isoTimestamp) {
+  const tsSafe = isoTimestamp.replace(/[:.]/g, "-");
+  return path26.posix.join(
+    ".teamix-evo",
+    ".backups",
+    `${legacyRel}.${tsSafe}.bak`
+  );
+}
+async function migrateLegacyTokens(options) {
+  const { projectRoot, legacyPaths, dryRun = false } = options;
+  const seen = /* @__PURE__ */ new Set();
+  const uniqueLegacy = [];
+  for (const raw of legacyPaths) {
+    const norm = raw.split(path26.sep).join("/");
+    if (!seen.has(norm)) {
+      seen.add(norm);
+      uniqueLegacy.push(norm);
+    }
+  }
+  const overridesRel = path26.posix.join(
+    CONSUMER_TOKENS_DIR2,
+    CONSUMER_OVERRIDES_FILE2
+  );
+  const overridesAbs = path26.join(projectRoot, overridesRel);
+  const existingOverrides = await readFileOrNull(overridesAbs);
+  const overridesCreated = existingOverrides === null;
+  const baseContent = existingOverrides === null ? EMPTY_OVERRIDES_TEMPLATE2 : existingOverrides;
+  const migrated = [];
+  const skipped = [];
+  const isoTimestamp = (/* @__PURE__ */ new Date()).toISOString();
+  let appendedPayload = "";
+  for (const legacyRel of uniqueLegacy) {
+    const legacyAbs = path26.join(projectRoot, legacyRel);
+    const content = await readFileOrNull(legacyAbs);
+    if (content === null) {
+      skipped.push({ from: legacyRel, reason: "not-found" });
+      continue;
+    }
+    if (content.trim() === "") {
+      skipped.push({ from: legacyRel, reason: "empty" });
+      continue;
+    }
+    const banner = buildMigrationBanner(legacyRel, isoTimestamp);
+    const separator = appendedPayload === "" && baseContent.endsWith("\n\n") ? "" : "\n";
+    const block = `${separator}${banner}${content}${content.endsWith("\n") ? "" : "\n"}`;
+    appendedPayload += block;
+    const backupRel = dryRun ? null : computeBackupRel(legacyRel, isoTimestamp);
+    migrated.push({
+      from: legacyRel,
+      backupTo: backupRel,
+      bytesAppended: Buffer.byteLength(block, "utf-8")
+    });
+  }
+  if (dryRun || migrated.length === 0) {
+    return {
+      migrated,
+      skipped,
+      overridesPath: overridesRel,
+      overridesCreated: dryRun ? overridesCreated : false,
+      dryRun
+    };
+  }
+  await ensureDir(path26.dirname(overridesAbs));
+  const merged = baseContent + appendedPayload;
+  const tmp = overridesAbs + ".tmp";
+  await fs19.writeFile(tmp, merged, "utf-8");
+  await fs19.rename(tmp, overridesAbs);
+  for (const entry of migrated) {
+    const legacyAbs = path26.join(projectRoot, entry.from);
+    const backupAbs = path26.join(projectRoot, entry.backupTo);
+    await ensureDir(path26.dirname(backupAbs));
+    const srcContent = await readFileOrNull(legacyAbs);
+    if (srcContent === null) {
+      logger.debug(
+        `legacy-tokens-migrate: source disappeared before backup: ${entry.from}`
+      );
+      continue;
+    }
+    await fs19.writeFile(backupAbs, srcContent, "utf-8");
+    if (await fileExists(legacyAbs)) {
+      await fs19.unlink(legacyAbs);
+    }
+    logger.debug(
+      `legacy-tokens-migrate: ${entry.from} \u2192 ${overridesRel} (backup: ${entry.backupTo})`
+    );
+  }
+  return {
+    migrated,
+    skipped,
+    overridesPath: overridesRel,
+    overridesCreated,
+    dryRun: false
+  };
+}
+
+// src/core/agents-md.ts
+import * as fs20 from "fs/promises";
+import * as path27 from "path";
+async function runGenerateAgentsMd(options) {
+  const { projectRoot, variant, skillIds } = options;
+  const ordered = [...skillIds].sort(
+    (a, b) => bucketRank(a) - bucketRank(b) || a.localeCompare(b)
+  );
+  const sections = [];
+  const missingSkillIds = [];
+  for (const id of ordered) {
+    const { section, missing } = await renderSkillSection(projectRoot, id);
+    sections.push(section);
+    if (missing) missingSkillIds.push(id);
+  }
+  const body = renderAgentsMd({ variant, sections });
+  const target = path27.join(projectRoot, "AGENTS.md");
+  await fs20.writeFile(target, body, "utf8");
+  return {
+    path: target,
+    skillCount: ordered.length,
+    missingSkillIds
+  };
+}
+function bucketRank(id) {
+  if (id.startsWith("teamix-evo-design-")) return 0;
+  if (id.startsWith("teamix-evo-code-")) return 1;
+  return 2;
+}
+async function renderSkillSection(projectRoot, skillId) {
+  const skillPath = path27.join(
+    projectRoot,
+    ".teamix-evo",
+    "skills",
+    skillId,
+    "SKILL.md"
+  );
+  const lines = [];
+  lines.push(`### ${skillId}`);
+  let parts = null;
+  let missing = false;
+  try {
+    const raw = await fs20.readFile(skillPath, "utf8");
+    parts = extractDescriptionParts(raw);
+  } catch {
+    missing = true;
+  }
+  if (parts?.capability) {
+    lines.push(`- ${parts.capability}`);
+  }
+  lines.push(
+    `- **TRIGGER**: ${parts?.trigger ?? "\u672A\u914D\u7F6E\u89E6\u53D1\u6761\u4EF6\uFF0C\u9700\u624B\u52A8\u6FC0\u6D3B\u8BE5 skill\u3002"}`
+  );
+  lines.push(
+    `- **SKIP**: ${parts?.skip ?? "\u672A\u914D\u7F6E\u8DF3\u8FC7\u6761\u4EF6\uFF0C\u6309 TRIGGER \u515C\u5E95\u5224\u5B9A\u3002"}`
+  );
+  if (parts?.coordinates) {
+    lines.push(`- **Coordinates with**: ${parts.coordinates}`);
+  }
+  lines.push(`- **\u4F4D\u7F6E**: \`.teamix-evo/skills/${skillId}/SKILL.md\``);
+  return { section: lines.join("\n"), missing };
+}
+function renderAgentsMd(args) {
+  const { variant, sections } = args;
+  const skillBlock = sections.length > 0 ? sections.join("\n\n") : "_\uFF08\u672C\u5DE5\u7A0B\u672A\u88C5\u914D\u5DE5\u7A0B\u7EA7 skill\u3002\uFF09_";
+  return `# AGENTS.md
+
+> \u672C\u5DE5\u7A0B\u5DF2\u88C5\u914D Teamix Evo AI skills\u3002AI \u52A9\u624B\u5728\u4EE5\u4E0B\u573A\u666F\u4E0B**\u5FC5\u987B\u5148\u8BFB\u5BF9\u5E94 skill** \u518D\u52A8\u624B\u3002
+> \u672C\u6587\u4EF6\u7531 \`teamix-evo init\` / \`create-teamix-evo\` \u81EA\u52A8\u751F\u6210\uFF08regenerable\uFF0C[ADR 0038](https://github.com/teamix-evo/teamix-evo/blob/main/docs/adr/0038-create-agents-md-skill-trigger-fallback.md)\uFF09\uFF0C\u5237\u65B0\u65B9\u5F0F\u89C1\u5E95\u90E8\u3002
+
+## \u5DF2\u88C5 Skills\uFF08variant: ${variant}\uFF09
+
+${skillBlock}
+
+## \u89E6\u53D1\u515C\u5E95\u89C4\u5219
+
+- \u5199\u65B0 \`.tsx\` / \`.ts\` \u524D\uFF0C\u5BF9\u7167\u4E0A\u8FF0 TRIGGER \u5224\u5B9A\u662F\u5426\u547D\u4E2D
+- \u547D\u4E2D\u5219\u5148\u8BFB\u5BF9\u5E94 \`SKILL.md\`\uFF0C\u518D\u52A8\u624B\uFF1B\u4E8C\u8005\u540C\u65F6\u547D\u4E2D\u5219\u4E24\u4E2A\u90FD\u8BFB
+- \u6A21\u7CCA\u573A\u666F\uFF1A\u5148\u6309 SKIP \u53CD\u5411\u6392\u9664\uFF0C\u5269\u4F59\u552F\u4E00 skill \u5373\u4E3A\u5165\u53E3
+- \u751F\u547D\u5468\u671F\u547D\u4EE4\uFF08\`init\` / \`update\` / \`add\`\uFF09\u8D70 \`teamix-evo-manage\`\uFF08\u5168\u5C40 skill\uFF0C\u672C\u6587\u4EF6\u4E0D\u5217\uFF09
+
+> \u5237\u65B0\u672C\u6587\u4EF6\uFF1A\`npx teamix-evo skills add\` \u6216\u91CD\u8DD1 \`npm create teamix-evo\` / \`teamix-evo init\`\u3002
+`;
+}
+function extractDescriptionParts(fileContent) {
+  const description = extractDescriptionBlock(fileContent);
+  if (description == null) return null;
+  const allLines = description.split("\n").map((l) => l.trim()).filter(Boolean);
+  let capability = "";
+  for (const line of allLines) {
+    if (/^(TRIGGER when:|SKIP:|Coordinates with:)/i.test(line)) break;
+    capability = capability ? `${capability} ${line}` : line;
+  }
+  return {
+    capability: capability.trim(),
+    trigger: extractSection(description, "TRIGGER when:"),
+    skip: extractSection(description, "SKIP:"),
+    coordinates: extractSection(description, "Coordinates with:")
+  };
+}
+function extractDescriptionBlock(fileContent) {
+  const lines = fileContent.split("\n");
+  if (lines[0]?.trim() !== "---") return null;
+  let endIdx = -1;
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i]?.trim() === "---") {
+      endIdx = i;
+      break;
+    }
+  }
+  if (endIdx === -1) return null;
+  const fmLines = lines.slice(1, endIdx);
+  let startIdx = -1;
+  let inlineValue = null;
+  let blockMode = "inline";
+  for (let i = 0; i < fmLines.length; i++) {
+    const m = fmLines[i]?.match(/^description:\s*(\|[+-]?|>[+-]?)?\s*(.*)$/);
+    if (m) {
+      startIdx = i;
+      const indicator = (m[1] ?? "").trim();
+      const rest = m[2] ?? "";
+      if (indicator.startsWith("|")) blockMode = "literal";
+      else if (indicator.startsWith(">")) blockMode = "folded";
+      else {
+        blockMode = "inline";
+        inlineValue = rest;
+      }
+      break;
+    }
+  }
+  if (startIdx === -1) return null;
+  if (blockMode === "inline") {
+    return inlineValue ?? "";
+  }
+  const body = [];
+  let blockIndent = -1;
+  for (let i = startIdx + 1; i < fmLines.length; i++) {
+    const line = fmLines[i] ?? "";
+    if (line.trim() === "") {
+      body.push("");
+      continue;
+    }
+    const indentMatch = line.match(/^(\s+)/);
+    const indent = indentMatch ? indentMatch[1].length : 0;
+    if (indent === 0) break;
+    if (blockIndent === -1) blockIndent = indent;
+    if (indent < blockIndent) break;
+    body.push(line.slice(blockIndent));
+  }
+  while (body.length > 0 && body[body.length - 1] === "") body.pop();
+  return body.join("\n");
+}
+function extractSection(description, marker) {
+  const markers = ["TRIGGER when:", "SKIP:", "Coordinates with:"];
+  const lines = description.split("\n");
+  let inSection = false;
+  const collected = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    const startsWithMarker = trimmed.toLowerCase().startsWith(marker.toLowerCase());
+    if (!inSection && startsWithMarker) {
+      inSection = true;
+      collected.push(trimmed.slice(marker.length).trim());
+      continue;
+    }
+    if (inSection) {
+      const hitNextMarker = markers.some(
+        (m) => m !== marker && trimmed.toLowerCase().startsWith(m.toLowerCase())
+      );
+      if (hitNextMarker) break;
+      if (trimmed === "") {
+        if (collected[collected.length - 1] === "") break;
+        collected.push("");
+        continue;
+      }
+      collected.push(trimmed);
+    }
+  }
+  if (!inSection) return null;
+  const joined = collected.filter((l) => l !== "").join(" ").replace(/\s+/g, " ").trim();
+  return joined || null;
+}
+
+// src/core/snapshot.ts
+import * as fs21 from "fs/promises";
+import * as path28 from "path";
+var TEAMIX_DIR5 = ".teamix-evo";
+var SNAPSHOTS_DIR = ".snapshots";
+var LOGS_DIR = "logs";
+var META_FILE = "_meta.json";
+var DEFAULT_KEEP = 5;
+function isoToFsSafe3(iso) {
+  return iso.replace(/[:.]/g, "-");
+}
+function fsSafeToIso(safe) {
+  return safe.replace(
+    /^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})(Z)$/,
+    "$1T$2:$3:$4.$5$6"
+  );
+}
+async function createSnapshot(projectRoot, opts = {}) {
+  const teamixDir = path28.join(projectRoot, TEAMIX_DIR5);
+  try {
+    const stat7 = await fs21.stat(teamixDir);
+    if (!stat7.isDirectory()) return null;
+  } catch (err) {
+    if (err.code === "ENOENT") return null;
+    throw err;
+  }
+  const isoTs = (/* @__PURE__ */ new Date()).toISOString();
+  const ts = isoToFsSafe3(isoTs);
+  const snapshotRoot = path28.join(teamixDir, SNAPSHOTS_DIR);
+  const target = path28.join(snapshotRoot, ts);
+  await fs21.mkdir(target, { recursive: true });
+  const entries = await fs21.readdir(teamixDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === SNAPSHOTS_DIR) continue;
+    if (entry.name === LOGS_DIR) continue;
+    const src = path28.join(teamixDir, entry.name);
+    const dst = path28.join(target, entry.name);
+    await fs21.cp(src, dst, { recursive: true });
+  }
+  const meta = {
+    ts: isoTs,
+    reason: opts.reason ?? "manual"
+  };
+  await fs21.writeFile(
+    path28.join(target, META_FILE),
+    JSON.stringify(meta, null, 2) + "\n",
+    "utf-8"
+  );
+  logger.debug(
+    `Snapshot created \u2192 ${path28.relative(projectRoot, target)} (${meta.reason})`
+  );
+  const keep = opts.keep ?? DEFAULT_KEEP;
+  await pruneSnapshots(projectRoot, keep, { protectedTs: opts.protectedTs });
+  return { ts, path: target };
+}
+async function listSnapshots(projectRoot) {
+  const snapshotRoot = path28.join(projectRoot, TEAMIX_DIR5, SNAPSHOTS_DIR);
+  let entries;
+  try {
+    entries = await fs21.readdir(snapshotRoot, { withFileTypes: true });
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    throw err;
+  }
+  const result = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const dir = path28.join(snapshotRoot, entry.name);
+    let isoTs = null;
+    let reason = null;
+    try {
+      const raw = await fs21.readFile(path28.join(dir, META_FILE), "utf-8");
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.ts === "string") isoTs = parsed.ts;
+      if (typeof parsed.reason === "string" && ["init", "update", "switch", "restore", "manual"].includes(
+        parsed.reason
+      )) {
+        reason = parsed.reason;
+      }
+    } catch {
+      isoTs = fsSafeToIso(entry.name);
+    }
+    result.push({ ts: entry.name, isoTs, reason, path: dir });
+  }
+  result.sort((a, b) => a.ts < b.ts ? 1 : a.ts > b.ts ? -1 : 0);
+  return result;
+}
+async function pruneSnapshots(projectRoot, keep = DEFAULT_KEEP, opts = {}) {
+  if (keep < 0)
+    throw new Error(`pruneSnapshots: keep must be >= 0, got ${keep}`);
+  const snapshots = await listSnapshots(projectRoot);
+  if (snapshots.length <= keep) return [];
+  const tail = snapshots.slice(keep);
+  const toRemove = opts.protectedTs ? tail.filter((s) => s.ts !== opts.protectedTs) : tail;
+  const removed = [];
+  for (const snap of toRemove) {
+    await fs21.rm(snap.path, { recursive: true, force: true });
+    removed.push(snap.ts);
+    logger.debug(`Pruned snapshot ${snap.ts}`);
+  }
+  return removed.reverse();
+}
+async function restoreSnapshot(projectRoot, ts) {
+  const snapshotRoot = path28.join(projectRoot, TEAMIX_DIR5, SNAPSHOTS_DIR);
+  const target = path28.join(snapshotRoot, ts);
+  try {
+    const stat7 = await fs21.stat(target);
+    if (!stat7.isDirectory()) {
+      throw new Error(`Snapshot path is not a directory: ${target}`);
+    }
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      throw new Error(
+        `Snapshot not found: "${ts}". Run \`teamix-evo restore --list\` to see available timestamps.`
+      );
+    }
+    throw err;
+  }
+  await createSnapshot(projectRoot, { reason: "restore", protectedTs: ts });
+  const teamixDir = path28.join(projectRoot, TEAMIX_DIR5);
+  const live = await fs21.readdir(teamixDir, { withFileTypes: true });
+  for (const entry of live) {
+    if (entry.name === SNAPSHOTS_DIR) continue;
+    if (entry.name === LOGS_DIR) continue;
+    await fs21.rm(path28.join(teamixDir, entry.name), {
+      recursive: true,
+      force: true
+    });
+  }
+  const snapshotEntries = await fs21.readdir(target, { withFileTypes: true });
+  for (const entry of snapshotEntries) {
+    if (entry.name === META_FILE) continue;
+    const src = path28.join(target, entry.name);
+    const dst = path28.join(teamixDir, entry.name);
+    await fs21.cp(src, dst, { recursive: true });
+  }
+  logger.debug(`Restored .teamix-evo/ from snapshot ${ts}`);
+}
+
+// src/core/project-init.ts
+var BASELINE_UI_ENTRIES = [
+  "button",
+  "button-group",
+  "input",
+  "form",
+  "card",
+  "collapsible",
+  "dialog",
+  "dropdown-menu",
+  "tabs",
+  "table",
+  "sidebar",
+  "page-shell",
+  "page-header"
+];
+var CRITICAL_STEPS = /* @__PURE__ */ new Set([
+  "tokens",
+  "skills",
+  "ui-init"
+]);
+var IMPLEMENTED_STRATEGIES = {
+  "agents-md": ["merge-managed", "overwrite", "skip"],
+  tokens: ["migrate", "overwrite", "skip"],
+  "components-json": ["overwrite", "skip"],
+  "shadcn-source": ["overwrite", "skip-existing", "skip"],
+  "tailwind-config": ["skip"],
+  "index-css": ["skip"]
+};
+function pickIde(ides) {
+  return ides[0] ?? "qoder";
+}
+function strategyImplemented(key, strategy) {
+  return IMPLEMENTED_STRATEGIES[key]?.includes(strategy) ?? false;
+}
+async function resolveUiEntries(options) {
+  if (options.uiEntries && options.uiEntries.length > 0) {
+    return [...options.uiEntries];
+  }
+  if (options.answers.uiSelection === "all") {
+    const { manifest } = await loadUiData("@teamix-evo/ui");
+    return manifest.entries.map((e) => e.id);
+  }
+  return [...BASELINE_UI_ENTRIES];
+}
+async function runProjectInit(options) {
+  const { projectRoot, answers, dryRun = false, onStep } = options;
+  const ide = pickIde(answers.ides);
+  const steps = [];
+  const pending = [];
+  let snapshot = null;
+  let snapshotError;
+  if (!dryRun) {
+    try {
+      snapshot = await createSnapshot(projectRoot, { reason: "init" });
+    } catch (err) {
+      snapshotError = getErrorMessage(err);
+    }
+  }
+  let aborted = false;
+  const firstFailure = {
+    value: null
+  };
+  function record(step) {
+    steps.push(step);
+    onStep?.(step);
+  }
+  function recordPending(key) {
+    const strategy = answers.conflictDecisions[key];
+    if (!strategy) return;
+    if (strategyImplemented(key, strategy)) return;
+    pending.push({
+      key,
+      strategy,
+      reason: `Strategy "${strategy}" requires the managed-region engine (batch 4); recorded for follow-up.`
+    });
+  }
+  function recordFailure(name, err) {
+    const message = getErrorMessage(err);
+    record({ name, status: "fail", detail: message });
+    if (!firstFailure.value)
+      firstFailure.value = { step: name, error: message };
+    if (CRITICAL_STEPS.has(name)) aborted = true;
+  }
+  const tokensDecision = answers.conflictDecisions.tokens;
+  const legacyTokensPaths = options.legacyTokensPaths ?? [];
+  const wantMigrate = tokensDecision === "migrate" && legacyTokensPaths.length > 0;
+  if (tokensDecision === "skip") {
+    record({
+      name: "tokens",
+      status: "skip",
+      detail: "conflict strategy = skip"
+    });
+  } else if (dryRun) {
+    const planDetail = wantMigrate ? `runTokensInit(variant=${answers.variant}); migrateLegacyTokens(${legacyTokensPaths.length} file${legacyTokensPaths.length === 1 ? "" : "s"})` : `runTokensInit(variant=${answers.variant})`;
+    record({
+      name: "tokens",
+      status: "planned",
+      detail: planDetail
+    });
+  } else {
+    try {
+      const result = await runTokensInit({
+        projectRoot,
+        variant: answers.variant,
+        ide
+      });
+      let detail = result.status === "installed" ? `${result.packageName}@${result.version} (${result.count} files)` : result.status;
+      if (wantMigrate) {
+        try {
+          const m = await migrateLegacyTokens({
+            projectRoot,
+            legacyPaths: legacyTokensPaths
+          });
+          detail += `; migrated ${m.migrated.length}/${legacyTokensPaths.length} legacy file${legacyTokensPaths.length === 1 ? "" : "s"} \u2192 ${m.overridesPath}`;
+          if (m.skipped.length > 0) {
+            detail += ` (skipped ${m.skipped.length})`;
+          }
+        } catch (err) {
+          detail += `; migrate failed: ${getErrorMessage(err)}`;
+        }
+      }
+      record({
+        name: "tokens",
+        status: "ok",
+        detail
+      });
+    } catch (err) {
+      recordFailure("tokens", err);
+    }
+  }
+  recordPending("tokens");
+  const codeSkillId = `teamix-evo-code-${answers.variant}`;
+  if (dryRun) {
+    record({
+      name: "skills",
+      status: "planned",
+      detail: `runSkillsAdd(${codeSkillId})`
+    });
+  } else if (aborted) {
+    record({
+      name: "skills",
+      status: "skip",
+      detail: "aborted: earlier critical step failed"
+    });
+  } else {
+    try {
+      const result = await runSkillsAdd({
+        projectRoot,
+        names: [codeSkillId],
+        ides: answers.ides,
+        scope: answers.scope,
+        ide
+      });
+      record({
+        name: "skills",
+        status: "ok",
+        detail: result.status === "installed" ? `added: ${result.addedSkillIds.join(", ") || "none"}; existing: ${result.skippedSkillIds.join(", ") || "none"}` : result.status
+      });
+    } catch (err) {
+      recordFailure("skills", err);
+    }
+  }
+  const agentsMdDecision = answers.conflictDecisions["agents-md"];
+  const agentsMdSkillIds = [
+    `teamix-evo-design-${answers.variant}`,
+    codeSkillId
+  ];
+  if (agentsMdDecision === "skip") {
+    record({
+      name: "agents-md",
+      status: "skip",
+      detail: "conflict strategy = skip"
+    });
+  } else if (dryRun) {
+    record({
+      name: "agents-md",
+      status: "planned",
+      detail: `runGenerateAgentsMd(${agentsMdSkillIds.length} skills)`
+    });
+  } else {
+    try {
+      const result = await runGenerateAgentsMd({
+        projectRoot,
+        variant: answers.variant,
+        skillIds: agentsMdSkillIds
+      });
+      record({
+        name: "agents-md",
+        status: "ok",
+        detail: `${result.skillCount} skill index${result.missingSkillIds.length > 0 ? ` (missing SKILL.md: ${result.missingSkillIds.join(", ")})` : ""}`
+      });
+    } catch (err) {
+      recordFailure("agents-md", err);
+    }
+  }
+  recordPending("agents-md");
+  const componentsJsonDecision = answers.conflictDecisions["components-json"];
+  const shadcnDecision = answers.conflictDecisions["shadcn-source"];
+  const skipUiInit = !answers.withUi || componentsJsonDecision === "skip";
+  if (skipUiInit) {
+    record({
+      name: "ui-init",
+      status: "skip",
+      detail: !answers.withUi ? "withUi = false" : "components.json conflict strategy = skip"
+    });
+    record({
+      name: "ui-add",
+      status: "skip",
+      detail: !answers.withUi ? "withUi = false" : "components.json conflict strategy = skip"
+    });
+  } else if (dryRun) {
+    record({
+      name: "ui-init",
+      status: "planned",
+      detail: "runUiInit()"
+    });
+    const entries = await resolveUiEntries(options).catch(() => [
+      ...BASELINE_UI_ENTRIES
+    ]);
+    record({
+      name: "ui-add",
+      status: "planned",
+      detail: `runUiAdd(${entries.length} entries: ${entries.slice(0, 3).join(", ")}${entries.length > 3 ? "\u2026" : ""})`
+    });
+  } else {
+    if (aborted) {
+      record({
+        name: "ui-init",
+        status: "skip",
+        detail: "aborted: earlier critical step failed"
+      });
+      record({
+        name: "ui-add",
+        status: "skip",
+        detail: "aborted: earlier critical step failed"
+      });
+    } else {
+      let uiInitOk = false;
+      try {
+        const initResult = await runUiInit({ projectRoot, ide });
+        record({
+          name: "ui-init",
+          status: "ok",
+          detail: initResult.status === "installed" ? "config.json packages.ui written" : initResult.status
+        });
+        uiInitOk = true;
+      } catch (err) {
+        recordFailure("ui-init", err);
+      }
+      if (!uiInitOk) {
+        record({
+          name: "ui-add",
+          status: "skip",
+          detail: "aborted: ui-init failed"
+        });
+      } else if (shadcnDecision === "skip") {
+        record({
+          name: "ui-add",
+          status: "skip",
+          detail: "shadcn-source conflict strategy = skip"
+        });
+      } else {
+        try {
+          const entries = await resolveUiEntries(options);
+          const addResult = await runUiAdd({
+            projectRoot,
+            ids: entries,
+            // 'overwrite' strategy → overwrite=true; everything else (incl.
+            // 'skip-existing' which is the default) → overwrite=false.
+            overwrite: shadcnDecision === "overwrite"
+          });
+          record({
+            name: "ui-add",
+            status: "ok",
+            detail: `${addResult.orderedIds.length} entries (${addResult.written} written, ${addResult.skipped} skipped)`
+          });
+        } catch (err) {
+          recordFailure("ui-add", err);
+        }
+      }
+    }
+  }
+  recordPending("components-json");
+  recordPending("shadcn-source");
+  if (!answers.withLint) {
+    record({
+      name: "lint",
+      status: "skip",
+      detail: "withLint = false"
+    });
+  } else if (dryRun) {
+    record({
+      name: "lint",
+      status: "planned",
+      detail: "runLintInit()"
+    });
+  } else {
+    try {
+      const result = await runLintInit({
+        projectRoot,
+        skipInstall: options.skipInstall ?? false
+      });
+      record({
+        name: "lint",
+        status: "ok",
+        detail: result.status === "installed" ? `eslint=${result.eslint}, stylelint=${result.stylelint}` : result.status
+      });
+    } catch (err) {
+      recordFailure("lint", err);
+    }
+  }
+  recordPending("tailwind-config");
+  recordPending("index-css");
+  const status = dryRun ? "dry-run" : steps.some((s) => s.status === "fail") ? "partial" : "installed";
+  const out = {
+    status,
+    steps,
+    pendingConflictWork: pending,
+    snapshot
+  };
+  if (snapshotError) out.snapshotError = snapshotError;
+  if (firstFailure.value) {
+    out.resumeHint = {
+      failedAt: firstFailure.value.step,
+      completed: steps.filter((s) => s.status === "ok").map((s) => s.name),
+      failed: steps.filter((s) => s.status === "fail").map((s) => s.name),
+      error: firstFailure.value.error,
+      // Every sub-step is idempotent (returns `already-initialized` when its
+      // state file already exists), so a plain re-run resumes from the
+      // failed step. A richer --resume model lands with batch 3 (lock
+      // snapshot + restore).
+      resumeCommand: "teamix-evo init"
+    };
+  }
+  return out;
+}
+
+// src/commands/init/wizard.ts
+import * as p from "@clack/prompts";
+var FRIENDLY_KEY = {
+  "agents-md": "AGENTS.md",
+  "components-json": "components.json",
+  "tailwind-config": "tailwind.config.*",
+  tokens: "tokens / src/design-tokens.css",
+  "index-css": "src/index.css",
+  "shadcn-source": "src/lib/utils.ts + src/components/ui/"
+};
+var STRATEGY_LABEL = {
+  overwrite: "\u8986\u76D6\uFF08\u5199\u5165\u65B0\u6587\u4EF6\uFF09",
+  "merge-managed": "\u5408\u5E76\u5230 <!-- teamix-evo:managed --> \u5757\uFF08\u63A8\u8350\uFF09",
+  skip: "\u8DF3\u8FC7\uFF08\u4FDD\u7559\u73B0\u72B6\uFF09",
+  "diff-prompt": "\u5C55\u793A diff \u540E\u9010\u9879\u51B3\u5B9A",
+  "backup-overwrite": "\u5907\u4EFD\u540E\u91CD\u5199\uFF08\u63A8\u8350\uFF09",
+  migrate: "\u8FC1\u79FB\u5230 tokens/ \u6807\u51C6\u4F4D\uFF08\u63A8\u8350\uFF09",
+  coexist: "\u5171\u5B58\uFF08\u4EC5\u5199 overrides\uFF0C\u4E0D\u8986\u76D6\u73B0\u6709\uFF09",
+  append: "\u8FFD\u52A0 @import \u884C + managed \u6807\u8BB0\uFF08\u63A8\u8350\uFF09",
+  "skip-existing": "\u8DF3\u8FC7\u540C\u540D\u6587\u4EF6\uFF0C\u4EC5\u88C5\u65B0\u589E\uFF08\u63A8\u8350\uFF09",
+  "per-file-prompt": "\u9010\u6587\u4EF6\u8BE2\u95EE"
+};
+function strategyLabel(s) {
+  return STRATEGY_LABEL[s];
+}
+function defaultConflictDecisions(conflicts, override = {}) {
+  const out = {};
+  for (const item of conflicts.items) {
+    out[item.key] = override[item.key] ?? (item.exists ? item.recommendedStrategy : "overwrite");
+  }
+  return out;
+}
+function ensureNotCancelled(value) {
+  if (p.isCancel(value)) {
+    throw new CancelledError();
+  }
+  return value;
+}
+async function listVariantOptions() {
+  try {
+    const catalog = await listTokenVariants();
+    return catalog.variants.map((v) => ({
+      value: v.name,
+      label: `${v.displayName} (${v.name})`,
+      hint: v.description
+    }));
+  } catch {
+    return [
+      { value: "opentrek", label: "OpenTrek (opentrek)" },
+      { value: "uni-manager", label: "Uni-Manager (uni-manager)" }
+    ];
+  }
+}
+async function runInitWizard(options) {
+  const { cwd, conflicts, seed = {} } = options;
+  const interactive = !options.nonInteractive && Boolean(process.stdin.isTTY) && !options.acceptDefaults;
+  let variant = seed.variant;
+  if (!variant) {
+    const variantOptions = await listVariantOptions();
+    if (!interactive) {
+      variant = variantOptions[0]?.value ?? "opentrek";
+    } else {
+      p.intro("teamix-evo init");
+      p.note(`\u{1F4E6} \u63A5\u5165\u76EE\u5F55\uFF1A${cwd}`);
+      const choice = await p.select({
+        message: "Tokens variant",
+        options: variantOptions,
+        initialValue: variantOptions[0]?.value ?? "opentrek"
+      });
+      variant = ensureNotCancelled(choice);
+    }
+  }
+  let ides = seed.ides;
+  if (!ides || ides.length === 0) {
+    if (!interactive) {
+      ides = [...ALL_IDE_KINDS];
+    } else {
+      const choice = await p.multiselect({
+        message: "\u6CE8\u5165\u6280\u80FD\u7684 AI IDE\uFF08\u81F3\u5C11\u4E00\u4E2A\uFF09",
+        options: ALL_IDE_KINDS.map((k) => ({
+          value: k,
+          label: k === "qoder" ? "Qoder" : "Claude Code"
+        })),
+        initialValues: [...ALL_IDE_KINDS],
+        required: true
+      });
+      ides = ensureNotCancelled(choice);
+    }
+  }
+  const scope = seed.scope ?? "project";
+  let withLint = seed.withLint;
+  if (withLint === void 0) {
+    if (!interactive) {
+      withLint = true;
+    } else {
+      const ans = await p.confirm({
+        message: "\u5B89\u88C5 ESLint + Stylelint token-discipline \u89C4\u5219\uFF1F",
+        initialValue: true
+      });
+      withLint = ensureNotCancelled(ans);
+    }
+  }
+  let withUi = seed.withUi;
+  if (withUi === void 0) {
+    if (!interactive) {
+      withUi = true;
+    } else {
+      const ans = await p.confirm({
+        message: "\u5B89\u88C5 @teamix-evo/ui \u7EC4\u4EF6\u6E90\u7801\uFF1F",
+        initialValue: true
+      });
+      withUi = ensureNotCancelled(ans);
+    }
+  }
+  let uiSelection = seed.uiSelection;
+  if (withUi && !uiSelection) {
+    if (!interactive) {
+      uiSelection = "baseline";
+    } else {
+      const ans = await p.select({
+        message: "UI \u7EC4\u4EF6\u6E05\u5355",
+        options: [
+          {
+            value: "baseline",
+            label: "Baseline\uFF08\u63A8\u8350\uFF1Abutton / input / dialog \u7B49\u6838\u5FC3 ~20 \u4E2A\uFF09"
+          },
+          { value: "all", label: "\u5168\u91CF\u88C5\u673A\uFF0880+ \u7EC4\u4EF6\u6E90\u7801\uFF09" }
+        ],
+        initialValue: "baseline"
+      });
+      uiSelection = ensureNotCancelled(ans);
+    }
+  }
+  uiSelection ??= "baseline";
+  let withBizUi = seed.withBizUi;
+  if (withBizUi === void 0) {
+    if (!interactive) {
+      withBizUi = false;
+    } else {
+      const ans = await p.confirm({
+        message: "\u5B89\u88C5 @teamix-evo/biz-ui \u4E1A\u52A1\u7EC4\u4EF6\uFF1F\uFF08\u53EF\u7A0D\u540E\u7528 teamix-evo biz-ui add \u589E\u88C5\uFF09",
+        initialValue: false
+      });
+      withBizUi = ensureNotCancelled(ans);
+    }
+  }
+  const conflictDecisions = defaultConflictDecisions(
+    conflicts,
+    seed.conflictDecisions
+  );
+  if (interactive && conflicts.hasAnyConflict) {
+    p.note(
+      "\u68C0\u6D4B\u5230\u4E0E teamix-evo \u5199\u5165\u8DEF\u5F84\u51B2\u7A81\u7684\u73B0\u6709\u6587\u4EF6\uFF0C\u8BF7\u9010\u9879\u786E\u8BA4\u5904\u7406\u7B56\u7565\u3002\n\u9ED8\u8BA4\u7B56\u7565\u5DF2\u6839\u636E\u5185\u5BB9\u542F\u53D1\u5F0F\u63A8\u8350\uFF08\u6700\u5B89\u5168\u7684\u65B9\u6848\uFF09\u3002",
+      "\u26A0 \u63A5\u5165\u51B2\u7A81"
+    );
+    for (const item of conflicts.items) {
+      if (!item.exists) continue;
+      if (seed.conflictDecisions?.[item.key]) continue;
+      const ans = await p.select({
+        message: `${FRIENDLY_KEY[item.key]} ${describeMatched(item)}`,
+        options: item.availableStrategies.map((s) => ({
+          value: s,
+          label: strategyLabel(s)
+        })),
+        initialValue: item.recommendedStrategy
+      });
+      conflictDecisions[item.key] = ensureNotCancelled(ans);
+    }
+  }
+  if (interactive) {
+    p.outro("\u51C6\u5907\u5C31\u7EEA\uFF0C\u5F00\u59CB\u88C5\u673A\u2026");
+  }
+  return {
+    variant,
+    ides,
+    scope,
+    withLint,
+    withUi,
+    uiSelection,
+    withBizUi,
+    conflictDecisions
+  };
+}
+function describeMatched(item) {
+  if (item.paths.length === 0) return "";
+  const head = item.paths.slice(0, 2).join(", ");
+  const more = item.paths.length > 2 ? ` +${item.paths.length - 2}` : "";
+  return `\uFF08\u547D\u4E2D\uFF1A${head}${more}\uFF09`;
+}
+
+// src/commands/_shared/step-icon.ts
+var STEP_ICON = {
+  ok: "\u2714",
+  skip: "\u2298",
+  fail: "\u2716",
+  planned: "\xB7"
+};
+
+// src/commands/init/index.ts
+var initCommand5 = new Command33("init").description(
+  "\u628A teamix-evo AI \u5957\u4EF6\u63A5\u5165\u5DF2\u6709\u5DE5\u7A0B\uFF08\u666E\u901A\u7248\u63A5\u5165\uFF1A\u68C0\u6D4B\u51B2\u7A81 \u2192 \u5F15\u5BFC wizard \u2192 \u9759\u9ED8\u843D\u5730\uFF09"
+).option("--cwd <dir>", "\u6307\u5B9A\u5DE5\u7A0B\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A\u5F53\u524D\u76EE\u5F55\uFF09").option("-y, --yes", "\u8DF3\u8FC7\u4EA4\u4E92\uFF0C\u5168\u90E8\u4F7F\u7528\u63A8\u8350\u9ED8\u8BA4\u503C").option("--dry-run", "\u53EA\u8F93\u51FA\u6267\u884C\u8BA1\u5212\uFF0C\u4E0D\u5199\u4EFB\u4F55\u6587\u4EF6").option("--variant <name>", "tokens variant\uFF08\u8986\u76D6 wizard \u8BE2\u95EE\uFF09").action(async (opts) => {
+  const cwd = path29.resolve(opts.cwd ?? process.cwd());
+  try {
+    const state = await detectProjectState(cwd);
+    if (state.state === "empty") {
+      logger.warn("\u5F53\u524D\u76EE\u5F55\u662F\u7A7A\u76EE\u5F55\u6216\u4EC5\u542B\u53EF\u5FFD\u7565\u6587\u4EF6\u3002");
+      logger.info("");
+      logger.info(
+        "\u63A8\u8350\u4F7F\u7528\u811A\u624B\u67B6\u5B8C\u6574\u7248\uFF1A`npm create teamix-evo@latest`\uFF08\u63D0\u4F9B base \u6A21\u677F + variant overlay + \u9ED8\u8BA4\u9875\u9762\u9AA8\u67B6\uFF09\u3002"
+      );
+      logger.info(
+        "\u5982\u786E\u9700\u5728\u7A7A\u76EE\u5F55\u4E0A\u8DD1 init\uFF0C\u8BF7\u5148 `npm init -y` \u751F\u6210 package.json\u3002"
+      );
+      return;
+    }
+    if (state.state === "teamix-evo-installed") {
+      logger.warn(
+        "\u5F53\u524D\u76EE\u5F55\u5DF2\u68C0\u6D4B\u5230 .teamix-evo/ \u2014 \u8BE5\u5DE5\u7A0B\u5DF2\u7ECF\u63A5\u5165\u8FC7 teamix-evo\u3002"
+      );
+      logger.info("");
+      logger.info("\u8BF7\u4F7F\u7528\uFF1A");
+      logger.info("  \u2022 `teamix-evo update`  \u5347\u7EA7 / \u540C\u6B65\u8D44\u6E90\uFF08managed \u533A\u5757\uFF09");
+      logger.info("  \u2022 `teamix-evo doctor`  \u8BCA\u65AD\u5F53\u524D\u5B89\u88C5\u72B6\u6001");
+      logger.info("  \u2022 `teamix-evo skills uninstall <id>`  \u5378\u8F7D\u6307\u5B9A\u8D44\u6E90");
+      return;
+    }
+    if (!state.hasPackageJson) {
+      logger.error(
+        "\u5F53\u524D\u76EE\u5F55\u975E teamix-evo \u5DE5\u7A0B\u4E14\u65E0 package.json \u2014 \u8BF7\u5728\u5DE5\u7A0B\u6839\u76EE\u5F55\u6267\u884C\uFF0C\u6216\u5148 `npm init -y`\u3002"
+      );
+      process.exitCode = 1;
+      return;
+    }
+    const conflicts = await detectConflicts(cwd);
+    const isInteractive = Boolean(process.stdin.isTTY);
+    const answers = await runInitWizard({
+      cwd,
+      conflicts,
+      seed: opts.variant ? { variant: opts.variant } : void 0,
+      acceptDefaults: opts.yes ?? false,
+      nonInteractive: !isInteractive
+    });
+    const dryRun = opts.dryRun ?? false;
+    if (dryRun) {
+      logger.info("");
+      logger.info("\u{1F4CB} dry-run \u6A21\u5F0F\uFF1A\u4EE5\u4E0B\u8BA1\u5212\u4E0D\u4F1A\u5199\u5165\u4EFB\u4F55\u6587\u4EF6");
+    }
+    const legacyTokensPaths = (conflicts.items.find((it) => it.key === "tokens")?.paths ?? []).filter((p2) => !p2.startsWith("tokens/"));
+    const result = await runProjectInit({
+      projectRoot: cwd,
+      answers,
+      dryRun,
+      legacyTokensPaths,
+      onStep: (step) => {
+        const icon = STEP_ICON[step.status];
+        const detail = step.detail ? ` \u2014 ${step.detail}` : "";
+        logger.info(`  ${icon} ${step.name}${detail}`);
+      }
+    });
+    logger.info("");
+    if (result.status === "dry-run") {
+      logger.success("dry-run \u5B8C\u6210\u3002\u79FB\u9664 --dry-run \u5373\u53EF\u5B9E\u9645\u6267\u884C\u3002");
+    } else if (result.status === "partial") {
+      logger.warn("init \u90E8\u5206\u5B8C\u6210\uFF08\u542B\u5931\u8D25\u6B65\u9AA4\uFF09\u3002\u8BE6\u89C1\u4E0A\u65B9\u6B65\u9AA4\u660E\u7EC6\u3002");
+      if (result.resumeHint) {
+        const { failedAt, completed, error, resumeCommand } = result.resumeHint;
+        logger.info("");
+        logger.info("\u6062\u590D\u6307\u5F15\uFF1A");
+        logger.info(`  \u2022 \u5931\u8D25\u6B65\u9AA4\uFF1A${failedAt}`);
+        logger.info(`  \u2022 \u9519\u8BEF\u4FE1\u606F\uFF1A${error}`);
+        if (completed.length > 0) {
+          logger.info(
+            `  \u2022 \u5DF2\u5B8C\u6210\u6B65\u9AA4\uFF08\u518D\u6B21\u8FD0\u884C\u4F1A\u81EA\u52A8\u8DF3\u8FC7\uFF09\uFF1A${completed.join(", ")}`
+          );
+        }
+        logger.info(
+          `  \u2022 \u4FEE\u590D\u540E\u91CD\u8DD1\uFF1A\`${resumeCommand}\`\uFF08\u6BCF\u4E2A\u5B50\u6B65\u9AA4\u5E42\u7B49\uFF0C\u4F1A\u4ECE\u65AD\u70B9\u5904\u7EED\u63A5\uFF09`
+        );
+        if (result.snapshot) {
+          logger.info(
+            `  \u2022 \u5B8C\u5168\u56DE\u6EDA\uFF1A\`teamix-evo restore ${result.snapshot.ts}\`\uFF08\u64A4\u9500\u672C\u6B21 init \u5199\u5165 \u2014 ADR 0019 \xA72\uFF09`
+          );
+        }
+      }
+      process.exitCode = 1;
+    } else {
+      logger.success(`teamix-evo \u5DF2\u63A5\u5165 ${cwd}`);
+      if (result.snapshot) {
+        logger.info(
+          `\u{1F4BE} \u5DF2\u6355\u83B7 snapshot\uFF1A${result.snapshot.ts}\uFF08\u5982\u9700\u5B8C\u5168\u64A4\u9500\uFF1A\`teamix-evo restore ${result.snapshot.ts}\`\uFF09`
+        );
+      } else if (result.snapshotError) {
+        logger.debug(`snapshot \u6355\u83B7\u5931\u8D25\uFF1A${result.snapshotError}`);
+      }
+    }
+    if (result.pendingConflictWork.length > 0) {
+      logger.info("");
+      logger.warn(
+        `\u4EE5\u4E0B\u51B2\u7A81\u7B56\u7565\u9700\u8981 managed-region \u5F15\u64CE\uFF08\u6279\u6B21 4 \u843D\u5730\u540E\u53EF\u7528 \`teamix-evo conflict resolve\` \u5B8C\u6210\uFF09\uFF1A`
+      );
+      for (const w of result.pendingConflictWork) {
+        logger.info(`  \u2022 ${w.key} \u2192 ${w.strategy}`);
+      }
+    }
+    if (result.status === "installed") {
+      logger.info("");
+      logger.info("Next steps:");
+      logger.info("  \u2022 \u542F\u52A8 dev server \u9A8C\u8BC1\uFF1A`npm run dev`");
+      if (answers.withLint) {
+        logger.info("  \u2022 lint \u68C0\u67E5\uFF1A`npm run lint` / `npm run lint:css`");
+      }
+    }
+  } catch (err) {
+    if (err instanceof CancelledError) {
+      logger.info("init \u5DF2\u53D6\u6D88\u3002");
+      return;
+    }
+    const message = getErrorMessage(err);
+    logger.error(`init \u5931\u8D25\uFF1A${message}`);
+    logger.debug(err instanceof Error ? err.stack ?? "" : "");
+    process.exitCode = 1;
+  }
+});
+
+// src/commands/update/index.ts
+import { Command as Command34 } from "commander";
+import * as path31 from "path";
+
+// src/core/project-update.ts
+import * as path30 from "path";
+import {
+  loadTokensPackageManifest as loadTokensPackageManifest3,
+  getVariantEntry as getVariantEntry3
+} from "@teamix-evo/registry";
+var DEFAULT_TOKENS_PACKAGE3 = "@teamix-evo/tokens";
+var DEFAULT_SKILLS_PACKAGE4 = "@teamix-evo/skills";
+var CRITICAL_STEPS2 = /* @__PURE__ */ new Set(["tokens"]);
+async function runProjectUpdate(options) {
+  const { projectRoot, dryRun = false, onStep } = options;
+  const tokensPackage = options.tokensPackageName ?? DEFAULT_TOKENS_PACKAGE3;
+  const skillsPackage = options.skillsPackageName ?? DEFAULT_SKILLS_PACKAGE4;
+  const config = await readProjectConfig(projectRoot);
+  if (!config) {
+    return { status: "not-initialized" };
+  }
+  let snapshot = null;
+  let snapshotError;
+  if (!dryRun) {
+    try {
+      snapshot = await createSnapshot(projectRoot, { reason: "update" });
+    } catch (err) {
+      snapshotError = getErrorMessage(err);
+    }
+  }
+  const steps = [];
+  let aborted = false;
+  const firstFailure = { value: null };
+  function record(step) {
+    steps.push(step);
+    onStep?.(step);
+  }
+  function recordFailure(name, err) {
+    const message = getErrorMessage(err);
+    record({ name, status: "fail", detail: message });
+    if (!firstFailure.value) {
+      firstFailure.value = { step: name, error: message };
+    }
+    if (CRITICAL_STEPS2.has(name)) aborted = true;
+  }
+  let anyChanged = false;
+  if (!config.packages?.tokens) {
+    record({
+      name: "tokens",
+      status: "skip",
+      detail: "tokens not installed"
+    });
+  } else if (dryRun) {
+    try {
+      const plan = await planTokensUpdate(tokensPackage, config);
+      record({ name: "tokens", status: "planned", detail: plan });
+    } catch (err) {
+      recordFailure("tokens", err);
+    }
+  } else {
+    try {
+      const result = await runTokensUpdate({
+        projectRoot,
+        packageName: tokensPackage
+      });
+      if (result.status === "not-initialized") {
+        record({
+          name: "tokens",
+          status: "skip",
+          detail: "tokens not installed"
+        });
+      } else if (result.status === "up-to-date") {
+        const driftSuffix = result.frozenDrift.length > 0 ? `, frozen drift: ${result.frozenDrift.length}` : "";
+        record({
+          name: "tokens",
+          status: "ok",
+          detail: `up-to-date (${result.variant} v${result.version}${driftSuffix})`
+        });
+      } else {
+        anyChanged = true;
+        const extras = [];
+        if (result.managedReplaced.length > 0)
+          extras.push(`managed: ${result.managedReplaced.length}`);
+        if (result.frozenDrift.length > 0)
+          extras.push(`frozen drift: ${result.frozenDrift.length}`);
+        const suffix = extras.length > 0 ? ` [${extras.join(", ")}]` : "";
+        record({
+          name: "tokens",
+          status: "ok",
+          detail: `${result.variant} v${result.from} \u2192 v${result.to}${suffix}`
+        });
+      }
+    } catch (err) {
+      recordFailure("tokens", err);
+    }
+  }
+  if (!config.packages?.skills) {
+    record({
+      name: "skills",
+      status: "skip",
+      detail: "skills not installed"
+    });
+  } else if (aborted) {
+    record({
+      name: "skills",
+      status: "skip",
+      detail: "aborted: earlier critical step failed"
+    });
+  } else {
+    try {
+      const result = await runSkillsUpdate({
+        projectRoot,
+        dryRun,
+        packageName: skillsPackage
+      });
+      if (result.status === "no-skills") {
+        record({
+          name: "skills",
+          status: "skip",
+          detail: "no skills locked"
+        });
+      } else if (result.status === "no-changes") {
+        record({
+          name: "skills",
+          status: "ok",
+          detail: `up-to-date (${result.checkedSkillIds.length} skill(s) at v${result.version})`
+        });
+      } else if (result.status === "dry-run") {
+        const bumps = result.plan.filter((p2) => p2.action === "version-bump");
+        const detail = bumps.length === 0 ? `up-to-date (${result.plan.length} skill(s) checked at v${result.currentVersion})` : `${bumps.length} skill(s) would update: ${result.currentVersion} \u2192 ${result.availableVersion}`;
+        record({ name: "skills", status: "planned", detail });
+      } else {
+        anyChanged = true;
+        const summary = result.updatedSkillIds.length > 0 ? `updated: ${result.updatedSkillIds.join(", ")} (v${result.version})` : `refreshed at v${result.version}`;
+        record({ name: "skills", status: "ok", detail: summary });
+      }
+    } catch (err) {
+      recordFailure("skills", err);
+    }
+  }
+  await runComponentSourceStep("ui", {
+    projectRoot,
+    config,
+    dryRun,
+    record,
+    recordFailure
+  });
+  await runComponentSourceStep("biz-ui", {
+    projectRoot,
+    config,
+    dryRun,
+    record,
+    recordFailure
+  });
+  const out = (() => {
+    if (firstFailure.value) {
+      return {
+        status: "partial",
+        steps,
+        resumeHint: {
+          failedAt: firstFailure.value.step,
+          completed: steps.filter((s) => s.status === "ok").map((s) => s.name),
+          failed: steps.filter((s) => s.status === "fail").map((s) => s.name),
+          error: firstFailure.value.error,
+          resumeCommand: "teamix-evo update"
+        },
+        snapshot,
+        ...snapshotError ? { snapshotError } : {}
+      };
+    }
+    if (dryRun) return { status: "dry-run", steps, snapshot: null };
+    if (anyChanged)
+      return {
+        status: "updated",
+        steps,
+        snapshot,
+        ...snapshotError ? { snapshotError } : {}
+      };
+    return {
+      status: "up-to-date",
+      steps,
+      snapshot,
+      ...snapshotError ? { snapshotError } : {}
+    };
+  })();
+  return out;
+}
+async function runComponentSourceStep(category, args) {
+  const { projectRoot, config, dryRun, record, recordFailure } = args;
+  const cfgKey = category === "ui" ? "ui" : "biz-ui";
+  if (!config.packages?.[cfgKey]) {
+    record({
+      name: category,
+      status: "skip",
+      detail: `${category} not installed`
+    });
+    return;
+  }
+  const aliases = config.packages.ui?.aliases ?? config.packages["biz-ui"]?.aliases;
+  if (!aliases) {
+    record({
+      name: category,
+      status: "skip",
+      detail: `${category} aliases not configured`
+    });
+    return;
+  }
+  let report;
+  try {
+    report = await detectComponentLineage({
+      projectRoot,
+      category,
+      config
+    });
+  } catch (err) {
+    record({
+      name: category,
+      status: "skip",
+      detail: `lineage detect failed: ${getErrorMessage(err)}`
+    });
+    return;
+  }
+  if (report.lineage !== "teamix-evo" && report.lineage !== "mixed") {
+    record({
+      name: category,
+      status: "skip",
+      detail: `lineage=${report.lineage}; nothing to stage`
+    });
+    return;
+  }
+  if (dryRun) {
+    const total = report.registeredIds.length + report.unregisteredIds.length;
+    record({
+      name: category,
+      status: "planned",
+      detail: total === 0 ? "no components to stage" : `${total} component(s) to stage (lineage=${report.lineage})`
+    });
+    return;
+  }
+  try {
+    const built = await buildStaging({
+      category,
+      projectRoot,
+      aliases,
+      lineageReport: report,
+      trigger: "update",
+      onlyIds: []
+    });
+    if (built === null) {
+      record({
+        name: category,
+        status: "skip",
+        detail: "no entries to stage"
+      });
+      return;
+    }
+    const stagingRel = path30.relative(projectRoot, built.stagingDir);
+    const summary = summarizeStagingRisk(built.manifest.summary.byRisk);
+    record({
+      name: category,
+      status: "ok",
+      detail: `${built.manifest.summary.total} component(s) staged${summary ? ` (${summary})` : ""}, see ${stagingRel}`
+    });
+  } catch (err) {
+    recordFailure(category, err);
+  }
+}
+function summarizeStagingRisk(byRisk) {
+  const order = [
+    "risky",
+    "breaking",
+    "foreign",
+    "upgradable-medium",
+    "upgradable-low",
+    "unchanged"
+  ];
+  const parts = [];
+  for (const k of order) {
+    const v = byRisk[k];
+    if (v && v > 0) parts.push(`${v} ${k}`);
+  }
+  return parts.join(", ");
+}
+async function planTokensUpdate(tokensPackage, config) {
+  const tokensCfg = config.packages?.tokens;
+  if (!tokensCfg) return "tokens not installed";
+  const packageRoot = resolveTokensPackageRoot(tokensPackage);
+  const catalog = await loadTokensPackageManifest3(packageRoot);
+  const variantEntry = getVariantEntry3(catalog, tokensCfg.variant);
+  if (!variantEntry) {
+    return `variant "${tokensCfg.variant}" no longer in ${tokensPackage}@${catalog.version} \u2014 uninstall + re-init to switch`;
+  }
+  if (variantEntry.version === tokensCfg.version) {
+    return `up-to-date (${tokensCfg.variant} v${tokensCfg.version})`;
+  }
+  return `${tokensCfg.variant} v${tokensCfg.version} \u2192 v${variantEntry.version}`;
+}
+
+// src/commands/update/index.ts
+var updateCommand3 = new Command34("update").description(
+  "\u4E00\u952E\u5347\u7EA7 teamix-evo \u5DF2\u88C5\u8D44\u6E90\uFF08regenerable \u8986\u76D6\u3001frozen \u4FDD\u7559\u3001managed \u5408\u5E76 \u2014 ADR 0003 \u4E09\u6001\uFF09"
+).option("--cwd <dir>", "\u6307\u5B9A\u5DE5\u7A0B\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A\u5F53\u524D\u76EE\u5F55\uFF09").option("--dry-run", "\u53EA\u8F93\u51FA\u5347\u7EA7\u8BA1\u5212\uFF0C\u4E0D\u5199\u4EFB\u4F55\u6587\u4EF6").action(async (opts) => {
+  const cwd = path31.resolve(opts.cwd ?? process.cwd());
+  const dryRun = opts.dryRun ?? false;
+  try {
+    if (dryRun) {
+      logger.info("");
+      logger.info("\u{1F4CB} dry-run \u6A21\u5F0F\uFF1A\u4EE5\u4E0B\u8BA1\u5212\u4E0D\u4F1A\u5199\u5165\u4EFB\u4F55\u6587\u4EF6");
+    }
+    const result = await runProjectUpdate({
+      projectRoot: cwd,
+      dryRun,
+      onStep: (step) => {
+        const icon = STEP_ICON[step.status];
+        const detail = step.detail ? ` \u2014 ${step.detail}` : "";
+        logger.info(`  ${icon} ${step.name}${detail}`);
+      }
+    });
+    logger.info("");
+    if (result.status === "not-initialized") {
+      logger.warn(
+        "\u5F53\u524D\u76EE\u5F55\u672A\u68C0\u6D4B\u5230 .teamix-evo/ \u2014 \u8BE5\u5DE5\u7A0B\u5C1A\u672A\u63A5\u5165 teamix-evo\u3002"
+      );
+      logger.info("");
+      logger.info("\u8BF7\u4F7F\u7528\uFF1A");
+      logger.info(
+        "  \u2022 `npx teamix-evo@latest init`  \u666E\u901A\u7248\u63A5\u5165\uFF08\u5DF2\u6709 npm \u5DE5\u7A0B\uFF09"
+      );
+      logger.info(
+        "  \u2022 `npm create teamix-evo@latest`  \u5B8C\u6574\u7248\u811A\u624B\u67B6\uFF08\u7A7A\u76EE\u5F55\uFF09"
+      );
+      process.exitCode = 1;
+      return;
+    }
+    if (result.status === "dry-run") {
+      logger.success("dry-run \u5B8C\u6210\u3002\u79FB\u9664 --dry-run \u5373\u53EF\u5B9E\u9645\u6267\u884C\u3002");
+      return;
+    }
+    if (result.status === "partial") {
+      logger.warn("update \u90E8\u5206\u5B8C\u6210\uFF08\u542B\u5931\u8D25\u6B65\u9AA4\uFF09\u3002\u8BE6\u89C1\u4E0A\u65B9\u6B65\u9AA4\u660E\u7EC6\u3002");
+      if (result.resumeHint) {
+        const { failedAt, completed, error, resumeCommand } = result.resumeHint;
+        logger.info("");
+        logger.info("\u6062\u590D\u6307\u5F15\uFF1A");
+        logger.info(`  \u2022 \u5931\u8D25\u6B65\u9AA4\uFF1A${failedAt}`);
+        logger.info(`  \u2022 \u9519\u8BEF\u4FE1\u606F\uFF1A${error}`);
+        if (completed.length > 0) {
+          logger.info(
+            `  \u2022 \u5DF2\u5B8C\u6210\u6B65\u9AA4\uFF08\u518D\u6B21\u8FD0\u884C\u4F1A\u81EA\u52A8\u8DF3\u8FC7\uFF09\uFF1A${completed.join(", ")}`
+          );
+        }
+        logger.info(
+          `  \u2022 \u4FEE\u590D\u540E\u91CD\u8DD1\uFF1A\`${resumeCommand}\`\uFF08\u6BCF\u4E2A\u5B50\u6B65\u9AA4\u5E42\u7B49\uFF0Cversion-diff \u77ED\u8DEF\uFF09`
+        );
+        if (result.snapshot) {
+          logger.info(
+            `  \u2022 \u5B8C\u5168\u56DE\u6EDA\uFF1A\`teamix-evo restore ${result.snapshot.ts}\`\uFF08\u64A4\u9500\u672C\u6B21 update \u5199\u5165 \u2014 ADR 0019 \xA72\uFF09`
+          );
+        }
+      }
+      process.exitCode = 1;
+      return;
+    }
+    if (result.status === "up-to-date") {
+      logger.success("\u5DF2\u662F\u6700\u65B0\u7248\u672C\uFF0C\u65E0\u9700\u5347\u7EA7\u3002");
+      return;
+    }
+    logger.success("teamix-evo \u5DF2\u5347\u7EA7\u5230\u6700\u65B0\u7248\u672C\u3002");
+    if (result.snapshot) {
+      logger.info(
+        `\u{1F4BE} \u5DF2\u6355\u83B7 snapshot\uFF1A${result.snapshot.ts}\uFF08\u5982\u9700\u5B8C\u5168\u64A4\u9500\uFF1A\`teamix-evo restore ${result.snapshot.ts}\`\uFF09`
+      );
+    } else if (result.snapshotError) {
+      logger.debug(`snapshot \u6355\u83B7\u5931\u8D25\uFF1A${result.snapshotError}`);
+    }
+  } catch (err) {
+    const message = getErrorMessage(err);
+    logger.error(`update \u5931\u8D25\uFF1A${message}`);
+    logger.debug(err instanceof Error ? err.stack ?? "" : "");
+    process.exitCode = 1;
+  }
+});
+
+// src/commands/restore/index.ts
+import { Command as Command35 } from "commander";
+import * as path32 from "path";
+import * as prompts7 from "@clack/prompts";
+function createRestoreCommand() {
+  return new Command35("restore").description(
+    "\u56DE\u6EDA .teamix-evo/ \u5230\u6307\u5B9A snapshot\uFF08init/update \u5931\u8D25\u65F6\u4F7F\u7528 \u2014 ADR 0019 \xA72\uFF09"
+  ).argument("[ts]", "\u76EE\u6807 snapshot \u65F6\u95F4\u6233\uFF08\u5982 2026-06-11T20-59-03-000Z\uFF09").option("--list", "\u5217\u51FA\u53EF\u7528 snapshot\uFF08\u4E0D\u505A\u5B9E\u9645\u56DE\u6EDA\uFF09").option("--cwd <dir>", "\u6307\u5B9A\u5DE5\u7A0B\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A\u5F53\u524D\u76EE\u5F55\uFF09").option("-y, --yes", "\u8DF3\u8FC7\u4E8C\u6B21\u786E\u8BA4\uFF08destructive\uFF0C\u8BF7\u786E\u8BA4\u65E0\u8BEF\uFF09").action(async (ts, opts) => {
+    const cwd = path32.resolve(opts.cwd ?? process.cwd());
+    try {
+      const snapshots = await listSnapshots(cwd);
+      if (opts.list) {
+        printSnapshotTable(snapshots);
+        return;
+      }
+      if (!ts) {
+        logger.info("\u7528\u6CD5\uFF1A");
+        logger.info(
+          "  teamix-evo restore --list           \u5217\u51FA\u53EF\u7528 snapshot"
+        );
+        logger.info(
+          "  teamix-evo restore <ts> [-y]        \u56DE\u6EDA\u5230\u6307\u5B9A snapshot"
+        );
+        logger.info("");
+        if (snapshots.length === 0) {
+          logger.warn(
+            "\u5F53\u524D .teamix-evo/.snapshots/ \u4E3A\u7A7A\uFF08\u6216\u5DE5\u7A0B\u672A\u63A5\u5165 teamix-evo\uFF09\u3002"
+          );
+        } else {
+          logger.info(`\u5F53\u524D\u5171 ${snapshots.length} \u4E2A\u53EF\u7528 snapshot\u3002`);
+        }
+        process.exitCode = 1;
+        return;
+      }
+      const target = snapshots.find((s) => s.ts === ts);
+      if (!target) {
+        logger.error(`\u672A\u627E\u5230 snapshot\uFF1A${ts}`);
+        logger.info("");
+        logger.info(
+          "\u8FD0\u884C `teamix-evo restore --list` \u67E5\u770B\u53EF\u7528 snapshot \u5217\u8868\u3002"
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const isInteractive = Boolean(process.stdin.isTTY);
+      if (!opts.yes && isInteractive) {
+        logger.info("");
+        logger.info(`\u5373\u5C06\u56DE\u6EDA\u5230 snapshot\uFF1A${target.ts}`);
+        if (target.reason) logger.info(`  \u2022 \u539F\u56E0\uFF1A${target.reason}`);
+        if (target.isoTs) logger.info(`  \u2022 \u65F6\u95F4\uFF1A${target.isoTs}`);
+        logger.info(
+          "\u8BE5\u64CD\u4F5C\u4F1A\u8986\u76D6\u5F53\u524D .teamix-evo/ \u5185\u5BB9\uFF08\u9664 .snapshots/ \u4E0E logs/ \u5916\uFF09\u3002"
+        );
+        logger.info(
+          '\u56DE\u6EDA\u524D\u4F1A\u81EA\u52A8\u518D\u505A\u4E00\u6B21 reason="restore" \u7684\u5B89\u5168 snapshot\uFF0C\u53EF\u4E8C\u6B21\u56DE\u6EDA\u3002'
+        );
+        const confirmed = await prompts7.confirm({
+          message: "\u7EE7\u7EED\u56DE\u6EDA\uFF1F"
+        });
+        if (prompts7.isCancel(confirmed) || !confirmed) {
+          logger.info("\u5DF2\u53D6\u6D88\u3002");
+          return;
+        }
+      }
+      await restoreSnapshot(cwd, ts);
+      logger.success(`\u5DF2\u56DE\u6EDA\u5230 snapshot\uFF1A${ts}`);
+      logger.info(
+        '\u63D0\u793A\uFF1A\u672C\u6B21\u64CD\u4F5C\u524D\u7684\u72B6\u6001\u5DF2\u4FDD\u5B58\u4E3A\u65B0\u7684 reason="restore" snapshot\uFF0C\u5982\u9700\u518D\u6B21\u56DE\u6EDA\u53EF\u6267\u884C `teamix-evo restore --list` \u67E5\u770B\u3002'
+      );
+    } catch (err) {
+      const message = getErrorMessage(err);
+      logger.error(`restore \u5931\u8D25\uFF1A${message}`);
+      logger.debug(err.stack ?? "");
+      process.exitCode = 1;
+    }
+  });
+}
+var restoreCommand = createRestoreCommand();
+function printSnapshotTable(snapshots) {
+  if (snapshots.length === 0) {
+    logger.warn("\u672A\u627E\u5230\u53EF\u7528 snapshot\u3002");
+    logger.info("");
+    logger.info(
+      "\u63D0\u793A\uFF1Asnapshot \u7531 `teamix-evo init` / `teamix-evo update` \u5728\u6267\u884C\u524D\u81EA\u52A8\u751F\u6210\uFF1B"
+    );
+    logger.info(
+      "\u82E5\u5DE5\u7A0B\u521A\u63A5\u5165\u6216\u4ECE\u672A\u8FD0\u884C\u8FC7\u8FD9\u4E9B\u547D\u4EE4\uFF0C\u76EE\u5F55\u4F1A\u662F\u7A7A\u7684\uFF08\u8FD9\u662F\u6B63\u5E38\u72B6\u6001\uFF09\u3002"
+    );
+    return;
+  }
+  logger.info(`\u5171 ${snapshots.length} \u4E2A snapshot\uFF08\u6700\u65B0\u5728\u524D\uFF09\uFF1A`);
+  logger.info("");
+  for (let i = 0; i < snapshots.length; i++) {
+    const s = snapshots[i];
+    const reason = s.reason ?? "(unknown)";
+    const iso = s.isoTs ?? "(meta missing)";
+    logger.info(`  [${i + 1}] ${s.ts}`);
+    logger.info(`      reason=${reason}  iso=${iso}`);
+  }
+  logger.info("");
+  logger.info("\u56DE\u6EDA\u547D\u4EE4\uFF1Ateamix-evo restore <ts>");
+}
+
+// src/commands/switch/index.ts
+import { Command as Command36 } from "commander";
+import * as path34 from "path";
+import * as prompts8 from "@clack/prompts";
+
+// src/core/variant-switch.ts
+import * as path33 from "path";
+import * as fs22 from "fs/promises";
+import {
+  loadTokensPackageManifest as loadTokensPackageManifest4,
+  getVariantEntry as getVariantEntry4
+} from "@teamix-evo/registry";
+var DEFAULT_TOKENS_PACKAGE4 = "@teamix-evo/tokens";
+var CONSUMER_BASENAME_BY_UPSTREAM2 = {
+  "theme.css": "tokens.theme.css",
+  "overrides.css": "tokens.overrides.css"
+};
+async function runVariantSwitch(options) {
+  const { projectRoot, newVariant, apply = false } = options;
+  const packageName = options.packageName ?? DEFAULT_TOKENS_PACKAGE4;
+  const config = await readProjectConfig(projectRoot);
+  if (!config?.packages?.tokens) {
+    return { status: "not-initialized" };
+  }
+  const currentVariant = config.packages.tokens.variant;
+  if (currentVariant === newVariant) {
+    return { status: "already-on-variant", variant: currentVariant };
+  }
+  const packageRoot = options.packageRoot ?? resolveTokensPackageRoot(packageName);
+  const catalog = await loadTokensPackageManifest4(packageRoot);
+  const variantEntry = getVariantEntry4(catalog, newVariant);
+  if (!variantEntry) {
+    return {
+      status: "variant-not-found",
+      requested: newVariant,
+      available: catalog.variants.map((v) => v.name)
+    };
+  }
+  const upstreamByBasename = /* @__PURE__ */ new Map();
+  for (const fileRel of variantEntry.files) {
+    upstreamByBasename.set(
+      path33.basename(fileRel),
+      path33.join(packageRoot, fileRel)
+    );
+  }
+  const prior = await readInstalledManifest(projectRoot) ?? {
+    schemaVersion: 1,
+    installed: []
+  };
+  const installedIdx = prior.installed.findIndex(
+    (p2) => p2.package === packageName
+  );
+  const priorResources = installedIdx >= 0 ? prior.installed[installedIdx].resources : [];
+  const priorVersion = installedIdx >= 0 ? prior.installed[installedIdx].version : "0.0.0";
+  const changes = [];
+  for (const resource of priorResources) {
+    const consumerBasename = path33.basename(resource.target);
+    const upstreamBasename = lookupUpstreamBasename2(consumerBasename);
+    const upstreamAbs = upstreamBasename ? upstreamByBasename.get(upstreamBasename) : void 0;
+    if (resource.strategy === "frozen") {
+      changes.push({
+        target: resource.target,
+        kind: "preserve",
+        strategy: "frozen",
+        reason: "frozen \u2014 user-owned, never auto-overwritten"
+      });
+      continue;
+    }
+    if (!upstreamAbs) {
+      changes.push({
+        target: resource.target,
+        kind: "preserve",
+        strategy: resource.strategy,
+        reason: `no upstream counterpart in variant "${newVariant}"`
+      });
+      continue;
+    }
+    const upstreamContent = await fs22.readFile(upstreamAbs, "utf-8");
+    if (resource.strategy === "regenerable") {
+      const newHash = computeHash(upstreamContent);
+      if (newHash === resource.hash) {
+        changes.push({
+          target: resource.target,
+          kind: "unchanged",
+          strategy: "regenerable",
+          reason: "identical bytes between old and new variant"
+        });
+      } else {
+        changes.push({
+          target: resource.target,
+          kind: "rewrite",
+          strategy: "regenerable",
+          reason: `regenerable swap (${currentVariant} \u2192 ${newVariant})`
+        });
+      }
+      continue;
+    }
+    changes.push({
+      target: resource.target,
+      kind: "managed-update",
+      strategy: "managed",
+      reason: "managed regions replayed; outside content preserved"
+    });
+  }
+  if (!apply) {
+    return {
+      status: "dry-run",
+      from: currentVariant,
+      to: newVariant,
+      toVersion: variantEntry.version,
+      changes
+    };
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  let snapshot = null;
+  let snapshotError;
+  try {
+    logger.debug(
+      `[variant-switch] capturing snapshot (reason=switch, from=${currentVariant}, to=${newVariant})`
+    );
+    snapshot = await createSnapshot(projectRoot, { reason: "switch" });
+    logger.debug(
+      `[variant-switch] snapshot captured: ${snapshot?.ts ?? "(none)"}`
+    );
+  } catch (err) {
+    snapshotError = getErrorMessage(err);
+    logger.debug(`[variant-switch] snapshot capture failed: ${snapshotError}`);
+  }
+  const refreshedResources = [];
+  for (const resource of priorResources) {
+    const consumerAbs = path33.isAbsolute(resource.target) ? resource.target : path33.join(projectRoot, resource.target);
+    const consumerBasename = path33.basename(resource.target);
+    const upstreamBasename = lookupUpstreamBasename2(consumerBasename);
+    const upstreamAbs = upstreamBasename ? upstreamByBasename.get(upstreamBasename) : void 0;
+    if (resource.strategy === "regenerable" && upstreamAbs) {
+      const upstreamContent = await fs22.readFile(upstreamAbs, "utf-8");
+      await writeFileSafe(consumerAbs, upstreamContent);
+      logger.debug(`[variant-switch] rewrite regenerable: ${resource.target}`);
+      refreshedResources.push({
+        ...resource,
+        hash: computeHash(upstreamContent)
+      });
+      continue;
+    }
+    if (resource.strategy === "managed" && upstreamAbs && await fileExists(consumerAbs)) {
+      const upstreamContent = await fs22.readFile(upstreamAbs, "utf-8");
+      const consumerContent = await fs22.readFile(consumerAbs, "utf-8");
+      const merged = mergeManagedRegions(upstreamContent, consumerContent);
+      if (merged !== consumerContent) {
+        await writeFileSafe(consumerAbs, merged);
+        logger.debug(`[variant-switch] managed-update: ${resource.target}`);
+      } else {
+        logger.debug(
+          `[variant-switch] managed-update no-op (bytes unchanged): ${resource.target}`
+        );
+      }
+      refreshedResources.push({
+        ...resource,
+        hash: computeHash(merged)
+      });
+      continue;
+    }
+    refreshedResources.push(resource);
+  }
+  const lock = {
+    schemaVersion: 1,
+    variant: {
+      name: variantEntry.name,
+      displayName: variantEntry.displayName,
+      version: variantEntry.version,
+      from: packageName
+    },
+    packageVersion: catalog.version,
+    linked: variantEntry.linked,
+    installedAt: now
+  };
+  await writeFileSafe(
+    path33.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
+    JSON.stringify(lock, null, 2) + "\n"
+  );
+  logger.debug(
+    `[variant-switch] tokens-lock.json updated (variant=${newVariant}, version=${variantEntry.version})`
+  );
+  const renames = selectApplicableRenames(
+    variantEntry.renames ?? [],
+    "0.0.0",
+    variantEntry.version
+  );
+  const renamesMap = {};
+  for (const r of renames) renamesMap[r.from] = r.to;
+  const switchTs = now;
+  config.priorVariant = currentVariant;
+  config.packages.tokens.variant = newVariant;
+  config.packages.tokens.version = variantEntry.version;
+  const history = config.tokenRenameHistory ?? [];
+  history.push({
+    ts: switchTs,
+    fromVariant: currentVariant,
+    toVariant: newVariant,
+    renames: renamesMap
+  });
+  config.tokenRenameHistory = history;
+  await writeProjectConfig(projectRoot, config);
+  logger.debug(
+    `[variant-switch] config.json updated (priorVariant=${currentVariant}, variant=${newVariant}, renames=${renames.length})`
+  );
+  if (installedIdx >= 0) {
+    prior.installed[installedIdx] = {
+      ...prior.installed[installedIdx],
+      variant: newVariant,
+      version: variantEntry.version,
+      installedAt: now,
+      resources: refreshedResources
+    };
+    await writeInstalledManifest(projectRoot, prior);
+    logger.debug(
+      `[variant-switch] installed manifest updated (resources=${refreshedResources.length})`
+    );
+  }
+  let hintPath;
+  if (renames.length > 0) {
+    const hint = await writeTokensUpgradeHint({
+      projectRoot,
+      trigger: "switch",
+      fromVariant: currentVariant,
+      toVariant: newVariant,
+      fromVersion: priorVersion,
+      toVersion: variantEntry.version,
+      renames,
+      isoTs: switchTs
+    });
+    if (hint) hintPath = hint.path;
+  }
+  if (hintPath) {
+    logger.debug(`[variant-switch] upgrade hint written: ${hintPath}`);
+  }
+  logger.debug(
+    `[variant-switch] apply complete (from=${currentVariant}, to=${newVariant}, toVersion=${variantEntry.version})`
+  );
+  return {
+    status: "switched",
+    from: currentVariant,
+    to: newVariant,
+    toVersion: variantEntry.version,
+    changes,
+    snapshot,
+    ...snapshotError ? { snapshotError } : {},
+    renames,
+    ...hintPath ? { hintPath } : {}
+  };
+}
+function lookupUpstreamBasename2(consumerBasename) {
+  for (const [upstream, consumer] of Object.entries(
+    CONSUMER_BASENAME_BY_UPSTREAM2
+  )) {
+    if (consumer === consumerBasename) return upstream;
+  }
+  return consumerBasename;
+}
+
+// src/commands/switch/index.ts
+var KIND_ICON = {
+  rewrite: "\u270E",
+  "managed-update": "\u2295",
+  preserve: "\u2298",
+  unchanged: "="
+};
+var KIND_LABEL = {
+  rewrite: "rewrite",
+  "managed-update": "managed-update",
+  preserve: "preserve",
+  unchanged: "unchanged"
+};
+function createSwitchCommand() {
+  return new Command36("switch").description(
+    "variant \u5207\u6362\uFF1A\u5148\u5C55\u793A file-level diff\uFF0C--apply \u624D\u771F\u5199\uFF08ADR 0019 \xA7D3\uFF09"
+  ).argument("<new-variant>", "\u76EE\u6807 variant id\uFF08\u5982 opentrek / uni-manager\uFF09").option("--cwd <dir>", "\u6307\u5B9A\u5DE5\u7A0B\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A\u5F53\u524D\u76EE\u5F55\uFF09").option("--apply", "\u771F\u6B63\u6267\u884C\u5207\u6362\uFF08\u9ED8\u8BA4 dry-run\uFF0C\u4EC5\u5C55\u793A\u8BA1\u5212\uFF09").option("-y, --yes", "\u8DF3\u8FC7 --apply \u4E8C\u6B21\u786E\u8BA4\uFF08destructive\uFF0C\u8BF7\u786E\u8BA4\u65E0\u8BEF\uFF09").action(async (newVariant, opts) => {
+    const cwd = path34.resolve(opts.cwd ?? process.cwd());
+    const apply = opts.apply ?? false;
+    try {
+      const plan = await runVariantSwitch({
+        projectRoot: cwd,
+        newVariant,
+        apply: false
+      });
+      if (plan.status === "not-initialized") {
+        logger.warn(
+          "\u5F53\u524D\u76EE\u5F55\u672A\u68C0\u6D4B\u5230 .teamix-evo/ \u2014 \u8BE5\u5DE5\u7A0B\u5C1A\u672A\u63A5\u5165 teamix-evo\u3002"
+        );
+        logger.info("\u8BF7\u5148\u8FD0\u884C `npx teamix-evo@latest init` \u63A5\u5165\u3002");
+        process.exitCode = 1;
+        return;
+      }
+      if (plan.status === "already-on-variant") {
+        logger.success(`\u5F53\u524D variant \u5DF2\u662F "${plan.variant}"\uFF0C\u65E0\u9700\u5207\u6362\u3002`);
+        return;
+      }
+      if (plan.status === "variant-not-found") {
+        logger.error(`\u672A\u77E5 variant\uFF1A"${plan.requested}"`);
+        logger.info(`\u53EF\u7528 variant\uFF1A${plan.available.join(", ") || "(none)"}`);
+        logger.info(
+          "\u8FD0\u884C `teamix-evo tokens list-variants` \u53EF\u67E5\u770B\u5B8C\u6574\u5217\u8868\u3002"
+        );
+        process.exitCode = 1;
+        return;
+      }
+      printChangePlan(plan.from, plan.to, plan.toVersion, plan.changes);
+      if (!apply) {
+        logger.info("");
+        logger.info(
+          "\u4EE5\u4E0A\u4E3A dry-run \u8BA1\u5212\u3002\u5982\u9700\u771F\u6B63\u5207\u6362\uFF0C\u8BF7\u52A0 --apply\uFF08\u5EFA\u8BAE\u5148 commit \u5F53\u524D\u6539\u52A8\uFF09\u3002"
+        );
+        return;
+      }
+      const isInteractive = Boolean(process.stdin.isTTY);
+      if (!opts.yes && isInteractive) {
+        logger.info("");
+        logger.info(
+          "switch --apply \u4F1A\u91CD\u5199 regenerable \u6587\u4EF6\u5E76\u66F4\u65B0 .teamix-evo/ \u72B6\u6001\u3002"
+        );
+        logger.info(
+          '\u6267\u884C\u524D\u4F1A\u81EA\u52A8\u6355\u83B7 reason="switch" snapshot\uFF0C\u53EF\u901A\u8FC7 `teamix-evo restore <ts>` \u56DE\u6EDA\u3002'
+        );
+        const confirmed = await prompts8.confirm({
+          message: `\u7EE7\u7EED\u5207\u6362\u81F3 "${newVariant}"\uFF1F`
+        });
+        if (prompts8.isCancel(confirmed) || !confirmed) {
+          logger.info("\u5DF2\u53D6\u6D88\u3002");
+          return;
+        }
+      }
+      const applied = await runVariantSwitch({
+        projectRoot: cwd,
+        newVariant,
+        apply: true
+      });
+      if (applied.status !== "switched") {
+        logger.error(`switch \u5F02\u5E38\uFF1A\u72B6\u6001 ${applied.status}`);
+        process.exitCode = 1;
+        return;
+      }
+      logger.success(
+        `\u5DF2\u5207\u6362\u81F3 variant "${applied.to}" (v${applied.toVersion})\u3002`
+      );
+      if (applied.snapshot) {
+        logger.info(
+          `\u{1F4BE} snapshot\uFF1A${applied.snapshot.ts}\uFF08\u56DE\u6EDA\uFF1A\`teamix-evo restore ${applied.snapshot.ts}\`\uFF09`
+        );
+      } else if (applied.snapshotError) {
+        logger.debug(`snapshot \u6355\u83B7\u5931\u8D25\uFF1A${applied.snapshotError}`);
+      }
+      if (applied.hintPath) {
+        logger.info("");
+        logger.info(`\u{1F4A1} token rename hint: ${applied.hintPath}`);
+        logger.info(
+          `   \u68C0\u6D4B\u5230 ${applied.renames.length} \u4E2A token rename\uFF0C\u5EFA\u8BAE\u8C03\u7528 \`teamix-evo-upgrade\` skill \u626B src/** \u7ED9 codemod \u5EFA\u8BAE\uFF08ADR 0019 \xA7D4\uFF09\u3002`
+        );
+      } else {
+        logger.info(
+          "\u63D0\u793A\uFF1A\u672C\u6B21\u5207\u6362\u672A\u68C0\u6D4B\u5230 token rename\uFF08\u65B0 variant \u672A\u58F0\u660E renames \u6216 sinceVersion \u5747\u5728\u8303\u56F4\u5916\uFF09\u3002"
+        );
+      }
+    } catch (err) {
+      const message = getErrorMessage(err);
+      logger.error(`switch \u5931\u8D25\uFF1A${message}`);
+      logger.debug(err.stack ?? "");
+      process.exitCode = 1;
+    }
+  });
+}
+var switchCommand = createSwitchCommand();
+function printChangePlan(from, to, toVersion, changes) {
+  logger.info("");
+  logger.info(`variant \u5207\u6362\u8BA1\u5212\uFF1A${from} \u2192 ${to} (v${toVersion})`);
+  logger.info("");
+  if (changes.length === 0) {
+    logger.warn(
+      "\u6CA1\u6709\u53EF\u5904\u7406\u7684\u8D44\u6E90\uFF08installed manifest \u4E3A\u7A7A\uFF09\u3002\u8BF7\u5148\u8FD0\u884C `teamix-evo init`\u3002"
+    );
+    return;
+  }
+  for (const change of changes) {
+    const icon = KIND_ICON[change.kind];
+    const label = KIND_LABEL[change.kind];
+    logger.info(
+      `  ${icon} [${label}] ${change.target}  (${change.strategy}) \u2014 ${change.reason}`
+    );
+  }
+}
+
 // src/index.ts
-var require9 = createRequire8(import.meta.url);
-var { version } = require9("../package.json");
-var program = new Command32();
+var require8 = createRequire8(import.meta.url);
+var { version } = require8("../package.json");
+var program = new Command37();
 program.name("teamix-evo").description("Where ideas evolve. \u2014 AI Coding \u5957\u4EF6").version(version);
 program.addCommand(tokensCommand);
 program.addCommand(skillsCommand);
@@ -4338,6 +7460,10 @@ program.addCommand(bizUiCommand);
 program.addCommand(templatesCommand);
 program.addCommand(logsCommand);
 program.addCommand(lintCommand);
+program.addCommand(initCommand5);
+program.addCommand(updateCommand3);
+program.addCommand(restoreCommand);
+program.addCommand(switchCommand);
 function enableHelpAfterError(cmd) {
   cmd.showHelpAfterError(true);
   for (const child of cmd.commands) enableHelpAfterError(child);