teamix-evo 0.13.4 → 0.14.0

package/dist/core/index.js

@@ -1,6 +1,6 @@
 // src/core/tokens-init.ts
-import * as path9 from "path";
-import * as fs6 from "fs/promises";
+import * as path8 from "path";
+import * as fs7 from "fs/promises";
 import {
   loadTokensPackageManifest,
   getVariantEntry
@@ -96,6 +96,7 @@ import {
   validateSkillsLock,
   TokensPackLockSchema
 } from "@teamix-evo/registry";
+import * as fs2 from "fs/promises";
 
 // src/utils/error.ts
 function getErrorMessage(err) {
@@ -113,9 +114,11 @@ var TEAMIX_DIR = ".teamix-evo";
 var CONFIG_FILE = "config.json";
 var MANIFEST_FILE = "manifest.json";
 var TOKENS_LOCK_FILE = "tokens-lock.json";
-var SKILLS_DIR = "skills-source";
-var LEGACY_SKILLS_DIR = "skills";
-var SKILLS_LOCK_FILE = "manifest.lock.json";
+var SKILLS_LOCK_FILE = "skills-lock.json";
+var LEGACY_SKILLS_LOCK_PATHS = [
+  path2.join("skills-source", "manifest.lock.json"),
+  path2.join("skills", "manifest.lock.json")
+];
 function getTeamixDir(projectRoot) {
   return path2.join(projectRoot, TEAMIX_DIR);
 }
@@ -194,51 +197,61 @@ async function readTokensVariant(projectRoot) {
   const lock = await readTokensLock(projectRoot);
   return lock?.variant.name ?? null;
 }
-function getSkillsSourceDir(projectRoot, skillName) {
-  const base = path2.join(projectRoot, TEAMIX_DIR, SKILLS_DIR);
-  return skillName ? path2.join(base, skillName) : base;
-}
-function getLegacySkillsSourceDir(projectRoot) {
-  return path2.join(projectRoot, TEAMIX_DIR, LEGACY_SKILLS_DIR);
-}
 async function readSkillsLock(projectRoot) {
-  const lockPath = path2.join(
-    projectRoot,
-    TEAMIX_DIR,
-    SKILLS_DIR,
-    SKILLS_LOCK_FILE
-  );
+  const lockPath = path2.join(projectRoot, TEAMIX_DIR, SKILLS_LOCK_FILE);
   const raw = await readFileOrNull(lockPath);
   if (raw === null) return null;
   try {
     const data = JSON.parse(raw);
     const result = validateSkillsLock(data);
     if (!result.success) {
-      logger.warn(`Invalid skills manifest.lock.json: ${result.error}`);
+      logger.warn(`Invalid skills-lock.json: ${result.error}`);
       return null;
     }
     return result.data;
   } catch (err) {
     logger.warn(
-      `Failed to parse skills manifest.lock.json: ${getErrorMessage(err)}`
+      `Failed to parse skills-lock.json: ${getErrorMessage(err)}`
     );
     return null;
   }
 }
 async function writeSkillsLock(projectRoot, lock) {
-  const lockPath = path2.join(
-    projectRoot,
-    TEAMIX_DIR,
-    SKILLS_DIR,
-    SKILLS_LOCK_FILE
-  );
+  const lockPath = path2.join(projectRoot, TEAMIX_DIR, SKILLS_LOCK_FILE);
   await writeFileSafe(lockPath, JSON.stringify(lock, null, 2) + "\n");
   logger.debug(`Wrote skills lock \u2192 ${lockPath}`);
 }
+async function migrateSkillsLockLocation(projectRoot) {
+  const newPath = path2.join(projectRoot, TEAMIX_DIR, SKILLS_LOCK_FILE);
+  try {
+    await fs2.access(newPath);
+  } catch {
+    for (const legacyRel of LEGACY_SKILLS_LOCK_PATHS) {
+      const legacyPath = path2.join(projectRoot, TEAMIX_DIR, legacyRel);
+      try {
+        await fs2.access(legacyPath);
+        await ensureDir(path2.dirname(newPath));
+        await fs2.rename(legacyPath, newPath);
+        logger.debug(`Migrated skills lock: ${legacyRel} \u2192 ${SKILLS_LOCK_FILE}`);
+        break;
+      } catch {
+        continue;
+      }
+    }
+  }
+  for (const staleDir of ["skills-source", "skills"]) {
+    const abs = path2.join(projectRoot, TEAMIX_DIR, staleDir);
+    try {
+      await fs2.rm(abs, { recursive: true, force: true });
+      logger.debug(`Cleaned up stale dir: .teamix-evo/${staleDir}/`);
+    } catch {
+    }
+  }
+}
 
 // src/core/skills-client.ts
 import * as path3 from "path";
-import * as fs2 from "fs/promises";
+import * as fs3 from "fs/promises";
 import { createRequire } from "module";
 import { loadSkillsPackageManifest } from "@teamix-evo/registry";
 var require2 = createRequire(import.meta.url);
@@ -253,7 +266,7 @@ async function loadSkillsData(packageName) {
   let data = {};
   const dataPath = path3.join(packageRoot, "_data.json");
   try {
-    const raw = await fs2.readFile(dataPath, "utf-8");
+    const raw = await fs3.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
   } catch (err) {
     if (err.code !== "ENOENT") {
@@ -266,7 +279,7 @@ async function loadSkillsData(packageName) {
 
 // src/core/skills-installer.ts
 import * as path7 from "path";
-import * as fs5 from "fs/promises";
+import * as fs6 from "fs/promises";
 import {
   replaceManagedRegion,
   hasManagedRegion,
@@ -326,7 +339,7 @@ function getAdapter(kind) {
 
 // src/utils/template.ts
 import Handlebars from "handlebars";
-import * as fs3 from "fs/promises";
+import * as fs4 from "fs/promises";
 Handlebars.registerHelper("lowercase", (str) => {
   return typeof str === "string" ? str.toLowerCase() : String(str ?? "").toLowerCase();
 });
@@ -349,12 +362,12 @@ function renderTemplate(templateContent, data) {
   return compiled(data);
 }
 async function loadTemplateFile(filePath) {
-  return fs3.readFile(filePath, "utf-8");
+  return fs4.readFile(filePath, "utf-8");
 }
 
 // src/utils/path.ts
 import * as path6 from "path";
-import * as fs4 from "fs/promises";
+import * as fs5 from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 var require3 = createRequire2(import.meta.url);
 function resolveSourcePath(source, variantDir, packageRoot) {
@@ -365,7 +378,7 @@ function resolveSourcePath(source, variantDir, packageRoot) {
 }
 async function walkDir(dir, skipDirs) {
   const files = [];
-  const entries = await fs4.readdir(dir, { withFileTypes: true });
+  const entries = await fs5.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
     const fullPath = path6.join(dir, entry.name);
     if (entry.isDirectory()) {
@@ -381,10 +394,13 @@ function resolveTokensPackageRoot(packageName) {
   const pkgJson = require3.resolve(`${packageName}/package.json`);
   return path6.dirname(pkgJson);
 }
+function resolveResourceTarget(projectRoot, target) {
+  return path6.isAbsolute(target) ? target : path6.resolve(projectRoot, target);
+}
 
 // src/core/skills-installer.ts
 async function installSkills(options) {
-  await migrateLegacySkillsSourceDir(options.projectRoot);
+  await migrateSkillsLockLocation(options.projectRoot);
   const { manifest, ides, scope, onlyIds } = options;
   const installed = [];
   const targets = manifest.skills.filter(
@@ -400,75 +416,61 @@ async function installSkills(options) {
       );
       continue;
     }
-    const sourceRecords = await writeSkillSource(skill, options);
-    installed.push(...sourceRecords);
+    const rendered = await renderSkillFiles(skill, options);
     for (const ide of skillIdes) {
-      const mirrorRecords = await mirrorSkillToIde(
+      const records = await writeRenderedToIde(
         skill,
+        rendered,
         ide,
         scope,
         options.projectRoot
       );
-      installed.push(...mirrorRecords);
+      installed.push(...records);
     }
   }
   return { resources: installed, count: installed.length };
 }
-async function writeSkillSource(skill, options) {
-  const { data, packageRoot, projectRoot } = options;
+async function renderSkillFiles(skill, options) {
+  const { data, packageRoot } = options;
   const sourceAbs = path7.resolve(packageRoot, skill.source);
-  const targetDir = getSkillsSourceDir(projectRoot, skill.name);
-  const stat3 = await fs5.stat(sourceAbs);
-  const records = [];
+  const stat3 = await fs6.stat(sourceAbs);
+  const rendered = /* @__PURE__ */ new Map();
   if (stat3.isFile()) {
-    const targetFile = path7.join(targetDir, "SKILL.md");
     const content = await renderSkillContent(sourceAbs, skill, data);
-    await writeFileSafe(targetFile, content);
-    records.push(makeSourceRecord(skill, targetFile, content));
-    logger.debug(`  Wrote source: ${targetFile}`);
-    return records;
+    rendered.set("SKILL.md", content);
+    return rendered;
   }
-  await ensureDir(targetDir);
   const entries = await walkDir(sourceAbs);
   for (const entry of entries) {
-    const rel2 = path7.relative(sourceAbs, entry);
-    let targetFile = path7.join(targetDir, rel2);
-    if (skill.template && targetFile.endsWith(".hbs")) {
-      targetFile = targetFile.slice(0, -4);
+    let rel2 = path7.relative(sourceAbs, entry);
+    if (skill.template && rel2.endsWith(".hbs")) {
+      rel2 = rel2.slice(0, -4);
     }
-    const content = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs5.readFile(entry, "utf-8");
-    await writeFileSafe(targetFile, content);
-    const relWritten = path7.relative(targetDir, targetFile);
-    records.push(makeSourceRecord(skill, targetFile, content, relWritten));
-    logger.debug(`  Wrote source: ${targetFile}`);
+    const content = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs6.readFile(entry, "utf-8");
+    rendered.set(rel2, content);
   }
-  return records;
+  return rendered;
 }
-async function mirrorSkillToIde(skill, ide, scope, projectRoot) {
-  const sourceDir = getSkillsSourceDir(projectRoot, skill.name);
+async function writeRenderedToIde(skill, rendered, ide, scope, projectRoot) {
   const adapter = getAdapter(ide);
   const targetDir = adapter.getSkillTargetDir(skill.name, scope, projectRoot);
   const records = [];
-  const sourceFiles = await walkDir(sourceDir);
   await ensureDir(targetDir);
-  for (const src of sourceFiles) {
-    const rel2 = path7.relative(sourceDir, src);
+  for (const [rel2, sourceContent] of rendered) {
     const targetFile = path7.join(targetDir, rel2);
-    const sourceContent = await fs5.readFile(src, "utf-8");
     const writtenContent = await writeMirrorContent(
       targetFile,
       sourceContent,
-      skill.managedRegions,
-      src
+      skill.managedRegions
     );
     records.push(
-      makeMirrorRecord(skill, targetFile, writtenContent, ide, scope, rel2)
+      makeMirrorRecord(skill, projectRoot, targetFile, writtenContent, ide, scope, rel2)
     );
-    logger.debug(`  Mirrored ${ide}:${scope}: ${targetFile}`);
+    logger.debug(`  Wrote ${ide}:${scope}: ${targetFile}`);
   }
   return records;
 }
-async function writeMirrorContent(targetFile, sourceContent, managedRegions, sourceFile) {
+async function writeMirrorContent(targetFile, sourceContent, managedRegions) {
   const existing = await readFileOrNull(targetFile);
   if (existing === null) {
     await writeFileSafe(targetFile, sourceContent);
@@ -479,7 +481,7 @@ async function writeMirrorContent(targetFile, sourceContent, managedRegions, sou
   if (matchedRegions.length === 0) {
     if (existing !== sourceContent) {
       logger.warn(
-        `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${sourceFile} (not the mirror) and re-run \`npx teamix-evo@latest skills sync\`.`
+        `Drift detected at ${targetFile} \u2014 overwriting from upstream. Re-run \`npx teamix-evo@latest skills sync\` after any manual edits.`
       );
       await writeFileSafe(targetFile, sourceContent);
       return sourceContent;
@@ -521,22 +523,13 @@ async function renderSkillContent(sourceAbs, skill, data) {
     const tpl = await loadTemplateFile(sourceAbs);
     return renderTemplate(tpl, { ...data, skill });
   }
-  return fs5.readFile(sourceAbs, "utf-8");
-}
-function makeSourceRecord(skill, targetAbs, content, rel2) {
-  const id = rel2 ? `${skill.id}:source:${rel2}` : `${skill.id}:source`;
-  return {
-    id,
-    target: targetAbs,
-    hash: computeHash(content),
-    strategy: skill.updateStrategy
-  };
+  return fs6.readFile(sourceAbs, "utf-8");
 }
-function makeMirrorRecord(skill, targetAbs, content, ide, scope, rel2) {
+function makeMirrorRecord(skill, projectRoot, targetAbs, content, ide, scope, rel2) {
   const id = rel2 && rel2 !== "SKILL.md" ? `${skill.id}:${rel2}` : skill.id;
   return {
     id,
-    target: targetAbs,
+    target: path7.relative(projectRoot, targetAbs),
     hash: computeHash(content),
     strategy: skill.updateStrategy,
     ide,
@@ -552,64 +545,41 @@ 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);
-    updated.push(...sourceRecords);
+    const rendered = await renderSkillFiles(skill, options);
     for (const ide of skillIdes) {
-      const mirrorRecords = await mirrorSkillToIde(
+      const records = await updateRenderedInIde(
         skill,
+        rendered,
         ide,
         scope,
-        projectRoot
+        projectRoot,
+        summary
       );
-      updated.push(...mirrorRecords);
+      updated.push(...records);
     }
   }
   return { resources: updated, summary };
 }
-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 stat3 = await fs5.stat(sourceAbs);
-  if (!stat3.isFile()) {
-    await ensureDir(targetDir);
-    const entries = await walkDir(sourceAbs);
-    const records = [];
-    for (const entry of entries) {
-      const rel2 = path7.relative(sourceAbs, entry);
-      let targetFile2 = path7.join(targetDir, rel2);
-      if (skill.template && targetFile2.endsWith(".hbs")) {
-        targetFile2 = targetFile2.slice(0, -4);
-      }
-      const newContent2 = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs5.readFile(entry, "utf-8");
-      const exists2 = await fileExists(targetFile2);
-      const written2 = await rewriteSingleFile({
-        targetFile: targetFile2,
-        newContent: newContent2,
-        exists: exists2,
-        updateStrategy: skill.updateStrategy,
-        managedRegions: skill.managedRegions,
-        projectRoot,
-        summary
-      });
-      const relWritten = path7.relative(targetDir, targetFile2);
-      records.push(makeSourceRecord(skill, targetFile2, written2, relWritten));
-    }
-    return records;
+async function updateRenderedInIde(skill, rendered, ide, scope, projectRoot, summary) {
+  const adapter = getAdapter(ide);
+  const targetDir = adapter.getSkillTargetDir(skill.name, scope, projectRoot);
+  const records = [];
+  await ensureDir(targetDir);
+  for (const [rel2, newContent] of rendered) {
+    const targetFile = path7.join(targetDir, rel2);
+    const exists = await fileExists(targetFile);
+    const written = await rewriteSingleFile({
+      targetFile,
+      newContent,
+      exists,
+      updateStrategy: skill.updateStrategy,
+      managedRegions: skill.managedRegions,
+      projectRoot,
+      summary
+    });
+    records.push(makeMirrorRecord(skill, projectRoot, targetFile, written, ide, scope, rel2));
   }
-  const targetFile = path7.join(targetDir, "SKILL.md");
-  const newContent = await renderSkillContent(sourceAbs, skill, data);
-  const exists = await fileExists(targetFile);
-  const written = await rewriteSingleFile({
-    targetFile,
-    newContent,
-    exists,
-    updateStrategy: skill.updateStrategy,
-    managedRegions: skill.managedRegions,
-    projectRoot,
-    summary
-  });
-  return [makeSourceRecord(skill, targetFile, written)];
+  return records;
 }
 async function rewriteSingleFile(args) {
   const {
@@ -676,41 +646,30 @@ async function rewriteSingleFile(args) {
 function escapeRegExp(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-async function syncSkillsToIdes(options) {
-  await migrateLegacySkillsSourceDir(options.projectRoot);
-  const { projectRoot, skills, ides, scope, onlyIds } = options;
+async function reinstallSkillsToIdes(options) {
+  const { projectRoot, skills, manifest, data, packageRoot, ides, scope } = options;
   const out = [];
-  const targets = skills.filter((s) => !onlyIds || onlyIds.includes(s.id));
-  for (const skill of targets) {
-    const sourceDir = getSkillsSourceDir(projectRoot, skill.name);
-    if (!await fileExists(sourceDir)) {
-      logger.warn(
-        `Skill "${skill.id}" has no source at ${sourceDir}; skipped.`
-      );
+  for (const skill of skills) {
+    const entry = manifest.skills.find((s) => s.id === skill.id);
+    if (!entry) {
+      logger.warn(`Skill "${skill.id}" not found in npm package manifest; skipped.`);
       continue;
     }
+    const rendered = await renderSkillFiles(entry, { data, packageRoot });
     for (const ide of ides) {
       const adapter = getAdapter(ide);
-      const targetDir = adapter.getSkillTargetDir(
-        skill.name,
-        scope,
-        projectRoot
-      );
+      const targetDir = adapter.getSkillTargetDir(skill.name, scope, projectRoot);
       await ensureDir(targetDir);
-      const sourceFiles = await walkDir(sourceDir);
-      for (const src of sourceFiles) {
-        const rel2 = path7.relative(sourceDir, src);
+      for (const [rel2, sourceContent] of rendered) {
         const targetFile = path7.join(targetDir, rel2);
-        const sourceContent = await fs5.readFile(src, "utf-8");
         const writtenContent = await writeMirrorContent(
           targetFile,
           sourceContent,
-          skill.managedRegions,
-          src
+          skill.managedRegions
         );
         out.push({
           id: rel2 === "SKILL.md" ? skill.id : `${skill.id}:${rel2}`,
-          target: targetFile,
+          target: path7.relative(projectRoot, targetFile),
           hash: computeHash(writtenContent),
           strategy: skill.updateStrategy,
           ide,
@@ -721,75 +680,6 @@ async function syncSkillsToIdes(options) {
   }
   return { resources: out, count: out.length };
 }
-async function migrateLegacySkillsSourceDir(projectRoot) {
-  const legacyDir = getLegacySkillsSourceDir(projectRoot);
-  const newDir = getSkillsSourceDir(projectRoot);
-  let legacyExists = false;
-  let newExists = false;
-  try {
-    legacyExists = (await fs5.stat(legacyDir)).isDirectory();
-  } catch {
-    legacyExists = false;
-  }
-  try {
-    newExists = (await fs5.stat(newDir)).isDirectory();
-  } catch {
-    newExists = false;
-  }
-  if (!legacyExists) return;
-  if (newExists) {
-    logger.warn(
-      `Detected stale legacy skills source dir at ${legacyDir} alongside ${newDir}; the new layout takes precedence \u2014 you can safely delete the legacy dir.`
-    );
-    return;
-  }
-  try {
-    await fs5.rename(legacyDir, newDir);
-    logger.info(
-      `Migrated skills source dir: \`.teamix-evo/${LEGACY_SKILLS_DIR}/\` \u2192 \`.teamix-evo/skills-source/\``
-    );
-  } catch (err) {
-    logger.warn(
-      `Failed to rename legacy skills source dir (${getErrorMessage(
-        err
-      )}); leaving as-is. New skills will install under the new layout.`
-    );
-    return;
-  }
-  try {
-    const manifest = await readInstalledManifest(projectRoot);
-    if (!manifest) return;
-    const legacyFragmentPosix = `/.teamix-evo/${LEGACY_SKILLS_DIR}/`;
-    const newFragmentPosix = `/.teamix-evo/skills-source/`;
-    const legacyFragmentNative = `${path7.sep}.teamix-evo${path7.sep}${LEGACY_SKILLS_DIR}${path7.sep}`;
-    const newFragmentNative = `${path7.sep}.teamix-evo${path7.sep}skills-source${path7.sep}`;
-    let touched = 0;
-    for (const pkg of manifest.installed) {
-      for (const r of pkg.resources) {
-        if (typeof r.target !== "string") continue;
-        const before = r.target;
-        let after = before.replace(legacyFragmentPosix, newFragmentPosix);
-        after = after.replace(legacyFragmentNative, newFragmentNative);
-        if (after !== before) {
-          r.target = after;
-          touched += 1;
-        }
-      }
-    }
-    if (touched > 0) {
-      await writeInstalledManifest(projectRoot, manifest);
-      logger.debug(
-        `Rewrote ${touched} manifest target(s) to the new skills-source path.`
-      );
-    }
-  } catch (err) {
-    logger.warn(
-      `Migrated skills source dir but failed to update manifest paths (${getErrorMessage(
-        err
-      )}); manifest may still reference legacy paths.`
-    );
-  }
-}
 async function pruneEmptyIdeSkillDirs(args) {
   const removed = [];
   for (const ide of args.ides) {
@@ -802,7 +692,7 @@ async function pruneEmptyIdeSkillDirs(args) {
     const skillsRoot = path7.dirname(placeholderDir);
     let entries;
     try {
-      entries = await fs5.readdir(skillsRoot);
+      entries = await fs6.readdir(skillsRoot);
     } catch {
       continue;
     }
@@ -810,21 +700,21 @@ async function pruneEmptyIdeSkillDirs(args) {
       const dir = path7.join(skillsRoot, name);
       let stat3;
       try {
-        stat3 = await fs5.stat(dir);
+        stat3 = await fs6.stat(dir);
       } catch {
         continue;
       }
       if (!stat3.isDirectory()) continue;
       let children;
       try {
-        children = await fs5.readdir(dir);
+        children = await fs6.readdir(dir);
       } catch {
         continue;
       }
       if (children.some((c) => c === "SKILL.md")) continue;
       if (children.length !== 0) continue;
       try {
-        await fs5.rmdir(dir);
+        await fs6.rmdir(dir);
         removed.push(dir);
         logger.debug(`Pruned empty IDE skill dir: ${dir}`);
       } catch {
@@ -833,26 +723,29 @@ async function pruneEmptyIdeSkillDirs(args) {
   }
   return removed;
 }
-async function removeSkillFiles(records) {
+async function removeSkillFiles(records, projectRoot) {
   const removed = [];
   for (const r of records) {
+    const abs = resolveResourceTarget(projectRoot, r.target);
     try {
-      await fs5.unlink(r.target);
-      removed.push(r.target);
+      await fs6.unlink(abs);
+      removed.push(abs);
     } catch (err) {
       if (err.code !== "ENOENT") {
-        logger.warn(`Failed to remove ${r.target}: ${getErrorMessage(err)}`);
+        logger.warn(`Failed to remove ${abs}: ${getErrorMessage(err)}`);
       }
     }
   }
-  const startDirs = new Set(records.map((r) => path7.dirname(r.target)));
+  const startDirs = new Set(
+    records.map((r) => path7.dirname(resolveResourceTarget(projectRoot, r.target)))
+  );
   for (const startDir of startDirs) {
     let dir = startDir;
     for (let depth = 0; depth < 8; depth++) {
       try {
-        const entries = await fs5.readdir(dir);
+        const entries = await fs6.readdir(dir);
         if (entries.length !== 0) break;
-        await fs5.rmdir(dir);
+        await fs6.rmdir(dir);
       } catch {
         break;
       }
@@ -862,32 +755,6 @@ async function removeSkillFiles(records) {
   return removed;
 }
 
-// src/utils/mcp.ts
-import * as path8 from "path";
-var MCP_JSON_CONTENT = {
-  mcpServers: {
-    "teamix-evo": {
-      command: "node",
-      args: ["node_modules/@teamix-evo/mcp/dist/cli.js"]
-    }
-  }
-};
-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"
-    );
-    logger.debug(`Wrote .mcp.json \u2192 ${mcpPath}`);
-    return "created";
-  } catch (err) {
-    logger.warn(`Failed to write .mcp.json: ${getErrorMessage(err)}`);
-    return "failed";
-  }
-}
-
 // src/core/skills-add.ts
 var DEFAULT_SKILLS_PACKAGE = "@teamix-evo/skills";
 var FLAT_VARIANT = "_flat";
@@ -1201,7 +1068,6 @@ async function finalizeSkillsInstall(args) {
     };
   }
   await writeSkillsLock(projectRoot, lock);
-  await ensureMcpJson(projectRoot);
   try {
     await pruneEmptyIdeSkillDirs({ projectRoot, ides, scope });
   } catch {
@@ -1346,7 +1212,7 @@ Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
     const result = await installVariantFile(fileRel, packageRoot, projectRoot);
     if (result) installed.push(result);
   }
-  const overridesAbs = path9.join(
+  const overridesAbs = path8.join(
     projectRoot,
     CONSUMER_TOKENS_DIR,
     CONSUMER_OVERRIDES_FILE
@@ -1356,10 +1222,10 @@ Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
   }
   const overridesId = `tokens:${CONSUMER_OVERRIDES_FILE}`;
   if (!installed.some((r) => r.id === overridesId)) {
-    const overridesContent = await fs6.readFile(overridesAbs, "utf-8");
+    const overridesContent = await fs7.readFile(overridesAbs, "utf-8");
     installed.push({
       id: overridesId,
-      target: path9.posix.join(CONSUMER_TOKENS_DIR, CONSUMER_OVERRIDES_FILE),
+      target: path8.posix.join(CONSUMER_TOKENS_DIR, CONSUMER_OVERRIDES_FILE),
       hash: computeHash(overridesContent),
       strategy: "frozen"
     });
@@ -1377,7 +1243,7 @@ Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
     installedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   await writeFileSafe(
-    path9.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
+    path8.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
     JSON.stringify(lock, null, 2) + "\n"
   );
   const config = {
@@ -1409,7 +1275,6 @@ Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
   if (tokensIdx >= 0) prior.installed[tokensIdx] = tokensEntry;
   else prior.installed.push(tokensEntry);
   await writeInstalledManifest(projectRoot, prior);
-  await ensureMcpJson(projectRoot);
   const skills = await tryAutoInstallVariantSkills({
     projectRoot,
     variant,
@@ -1498,12 +1363,12 @@ async function tryAutoInstallVariantSkills(args) {
   }
 }
 async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
-  const sourceAbs = path9.join(packageRoot, fileRelToPackage);
-  const base = path9.basename(fileRelToPackage);
+  const sourceAbs = path8.join(packageRoot, fileRelToPackage);
+  const base = path8.basename(fileRelToPackage);
   if (base === "theme.css") {
-    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");
+    const targetRel = path8.posix.join(CONSUMER_TOKENS_DIR, CONSUMER_THEME_FILE);
+    const targetAbs = path8.join(projectRoot, targetRel);
+    const content = await fs7.readFile(sourceAbs, "utf-8");
     if (await fileExists(targetAbs)) {
       await backupFile(targetAbs, projectRoot);
     }
@@ -1516,13 +1381,13 @@ async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
     };
   }
   if (base === "overrides.css" || base === "tokens.overrides.css") {
-    const targetRel = path9.posix.join(
+    const targetRel = path8.posix.join(
       CONSUMER_TOKENS_DIR,
       CONSUMER_OVERRIDES_FILE
     );
-    const targetAbs = path9.join(projectRoot, targetRel);
+    const targetAbs = path8.join(projectRoot, targetRel);
     if (await fileExists(targetAbs)) {
-      const existing = await fs6.readFile(targetAbs, "utf-8");
+      const existing = await fs7.readFile(targetAbs, "utf-8");
       return {
         id: `tokens:${CONSUMER_OVERRIDES_FILE}`,
         target: targetRel,
@@ -1530,7 +1395,7 @@ async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
         strategy: "frozen"
       };
     }
-    const content = await fs6.readFile(sourceAbs, "utf-8");
+    const content = await fs7.readFile(sourceAbs, "utf-8");
     await writeFileSafe(targetAbs, content);
     return {
       id: `tokens:${CONSUMER_OVERRIDES_FILE}`,
@@ -1557,81 +1422,315 @@ async function listTokenVariants(packageName = DEFAULT_TOKENS_PACKAGE, packageRo
   };
 }
 
-// src/core/skills-update.ts
-var DEFAULT_SKILLS_PACKAGE3 = "@teamix-evo/skills";
-var FLAT_VARIANT2 = "_flat";
-async function runSkillsUpdate(options) {
-  const { projectRoot, names: requestedNames, dryRun } = options;
-  const packageName = options.packageName ?? DEFAULT_SKILLS_PACKAGE3;
+// src/core/agents-md.ts
+import * as fs8 from "fs/promises";
+import * as path9 from "path";
+import { hasManagedRegion as hasManagedRegion2, replaceManagedRegion as replaceManagedRegion2 } from "@teamix-evo/registry";
+var AGENTS_MD_MANAGED_ID = "teamix-evo-skills";
+async function runGenerateAgentsMd(options) {
+  const { projectRoot, variant, skillIds } = options;
+  const mode = options.mode ?? "overwrite";
   const config = await readProjectConfig(projectRoot);
-  const skillsCfg = config?.packages?.skills;
-  if (!skillsCfg) {
-    return { status: "no-skills" };
-  }
-  const ides = skillsCfg.ides ?? ["qoder", "claude"];
-  const scope = skillsCfg.scope ?? "project";
-  const existingLock = await readSkillsLock(projectRoot);
-  if (!existingLock || Object.keys(existingLock.skills).length === 0) {
-    return { status: "no-skills" };
+  const lock = await readSkillsLock(projectRoot);
+  const ides = config?.packages?.skills?.ides ?? ["qoder", "claude"];
+  const scope = config?.packages?.skills?.scope ?? lock?.skills[skillIds[0] ?? ""]?.scope ?? "project";
+  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, ides, scope);
+    sections.push(section);
+    if (missing) missingSkillIds.push(id);
   }
-  const { manifest, data, packageRoot } = await loadSkillsData(packageName);
-  const manifestById = new Map(manifest.skills.map((s) => [s.id, s]));
-  const lockIds = Object.keys(existingLock.skills);
-  const requestedSet = requestedNames ? new Set(requestedNames) : null;
-  if (requestedSet) {
-    const unknown = requestedNames.filter(
-      (n) => !lockIds.includes(n) && !manifestById.has(n)
-    );
-    if (unknown.length > 0) {
-      throw new Error(
-        `Unknown skill id(s): ${unknown.join(
-          ", "
-        )}. Available (installed): ${lockIds.join(", ") || "(none)"}.`
-      );
+  const target = path9.join(projectRoot, "AGENTS.md");
+  const targetExists = await fileExists(target);
+  const fullTemplate = renderAgentsMd({ variant, sections });
+  const managedBody = renderManagedBlockBody({ variant, sections });
+  let outputContent;
+  let merge;
+  if (!targetExists) {
+    outputContent = fullTemplate;
+    merge = "created";
+  } else {
+    await backupFile(target, projectRoot);
+    if (mode === "merge-managed") {
+      const existing = await readFileOrNull(target) ?? "";
+      if (hasManagedRegion2(existing, AGENTS_MD_MANAGED_ID)) {
+        outputContent = replaceManagedRegion2(
+          existing,
+          AGENTS_MD_MANAGED_ID,
+          managedBody
+        );
+        merge = "managed-replaced";
+      } else {
+        const wrapped = wrapManagedBlock(managedBody);
+        outputContent = `${wrapped}
+
+${PRECEDENCE_NOTICE}
+
+${existing.trimStart()}`;
+        merge = "managed-prepended";
+      }
+    } else {
+      outputContent = fullTemplate;
+      merge = "overwritten";
     }
   }
-  const targetIds = [];
-  const skippedSkillIds = [];
-  for (const id of lockIds) {
-    if (requestedSet && !requestedSet.has(id)) continue;
-    const entry2 = manifestById.get(id);
-    if (!entry2) {
-      logger.debug(
-        `Skipping "${id}": no longer in upstream manifest. Use \`skills uninstall ${id}\` to remove.`
-      );
-      skippedSkillIds.push(id);
-      continue;
-    }
-    const effectiveScope = entry2.scope ?? "project";
-    if (effectiveScope !== scope) {
-      logger.debug(
-        `Skipping "${id}" (scope=${effectiveScope}): current install scope is "${scope}".`
-      );
-      skippedSkillIds.push(id);
+  await fs8.writeFile(target, outputContent, "utf8");
+  return {
+    path: target,
+    skillCount: ordered.length,
+    missingSkillIds,
+    backedUp: targetExists,
+    merge
+  };
+}
+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, ides, scope) {
+  const lines = [];
+  lines.push(`### ${skillId}`);
+  let parts = null;
+  let missing = false;
+  for (const ide of ides) {
+    const adapter = getAdapter(ide);
+    const skillPath = path9.join(
+      adapter.getSkillTargetDir(skillId, scope, projectRoot),
+      "SKILL.md"
+    );
+    try {
+      const raw = await fs8.readFile(skillPath, "utf8");
+      parts = extractDescriptionParts(raw);
+      break;
+    } catch {
       continue;
     }
-    targetIds.push(id);
   }
-  const allSame = targetIds.every((id) => {
-    const lockVer = existingLock.skills[id].version;
-    const manVer = manifestById.get(id).version;
-    return lockVer === manVer;
-  });
-  if (targetIds.length > 0 && allSame && !dryRun) {
-    return {
-      status: "no-changes",
-      packageName,
-      version: manifest.version,
-      checkedSkillIds: targetIds
-    };
+  if (!parts) missing = true;
+  if (parts?.capability) {
+    lines.push(`- ${parts.capability}`);
   }
-  if (dryRun) {
-    const plan = targetIds.map((id) => {
-      const lockVer = existingLock.skills[id].version;
-      const entry2 = manifestById.get(id);
-      const sameVersion = lockVer === entry2.version;
-      return {
-        id,
+  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}`);
+  }
+  return { section: lines.join("\n"), missing };
+}
+function renderAgentsMd(args) {
+  const { variant, sections } = args;
+  const managedBody = renderManagedBlockBody({ variant, sections });
+  const wrapped = wrapManagedBlock(managedBody);
+  return `${wrapped}
+
+${PRECEDENCE_NOTICE}
+`;
+}
+function renderManagedBlockBody(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
+
+> AI \u52A9\u624B\uFF1A\u5199\u4EE3\u7801\u524D\u5148\u5BF9\u7167\u4E0B\u65B9 TRIGGER\uFF0C\u547D\u4E2D\u5219\u5FC5\u987B\u8BFB\u5BF9\u5E94 skill \u518D\u52A8\u624B\uFF1B\u4E0D\u786E\u5B9A\u65F6\u4ECD\u5EFA\u8BAE\u5FEB\u901F\u67E5\u9605\u76F8\u5173 skill \u4EE5\u786E\u8BA4\u662F\u5426\u6D89\u53CA\u89C4\u8303\u7EA6\u675F\u3002
+>
+> \u6FC0\u6D3B\u65B9\u5F0F\uFF1A\u5728\u5BF9\u8BDD\u4E2D\u76F4\u63A5\u63D0\u53CA skill \u540D\u79F0\uFF08\u5982 \`teamix-evo-design-${variant}\`\uFF09\uFF0CIDE \u4F1A\u81EA\u52A8\u52A0\u8F7D\u5176\u5B8C\u6574\u5185\u5BB9\u3002
+
+## \u5DF2\u88C5 Skills\uFF08variant: ${variant}\uFF09
+
+${skillBlock}
+
+> \u5237\u65B0\u672C\u6587\u4EF6\uFF1A\`npx teamix-evo@latest skills update\``;
+}
+function wrapManagedBlock(body) {
+  return `<!-- teamix-evo:managed:start id="${AGENTS_MD_MANAGED_ID}" -->
+${body}
+<!-- teamix-evo:managed:end id="${AGENTS_MD_MANAGED_ID}" -->`;
+}
+var PRECEDENCE_NOTICE = `<!-- teamix-evo:precedence -->
+> \u51B2\u7A81\u4EE5\u4E0A\u65B9\u7684 **Skills** \u7D22\u5F15\u4E3A\u51C6\uFF08\u4E0A\u6E38\u8DEF\u5F84\u4E0E TRIGGER/SKIP \u5951\u7EA6\uFF09\uFF1B\u9879\u76EE\u7279\u6709\u7684\u4EBA\u5DE5\u7EC6\u5219\u8BF7\u5199\u5728\u672C\u5904\u4EE5\u4E0B\u3001\u4E0D\u8981\u8986\u76D6\u4E0A\u65B9 managed \u533A\u57DF\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/skills-update.ts
+var DEFAULT_SKILLS_PACKAGE3 = "@teamix-evo/skills";
+var FLAT_VARIANT2 = "_flat";
+async function runSkillsUpdate(options) {
+  const { projectRoot, names: requestedNames, dryRun } = options;
+  const packageName = options.packageName ?? DEFAULT_SKILLS_PACKAGE3;
+  const config = await readProjectConfig(projectRoot);
+  const skillsCfg = config?.packages?.skills;
+  if (!skillsCfg) {
+    return { status: "no-skills" };
+  }
+  const ides = skillsCfg.ides ?? ["qoder", "claude"];
+  const scope = skillsCfg.scope ?? "project";
+  const existingLock = await readSkillsLock(projectRoot);
+  if (!existingLock || Object.keys(existingLock.skills).length === 0) {
+    return { status: "no-skills" };
+  }
+  const { manifest, data, packageRoot } = await loadSkillsData(packageName);
+  const manifestById = new Map(manifest.skills.map((s) => [s.id, s]));
+  const lockIds = Object.keys(existingLock.skills);
+  const requestedSet = requestedNames ? new Set(requestedNames) : null;
+  if (requestedSet) {
+    const unknown = requestedNames.filter(
+      (n) => !lockIds.includes(n) && !manifestById.has(n)
+    );
+    if (unknown.length > 0) {
+      throw new Error(
+        `Unknown skill id(s): ${unknown.join(
+          ", "
+        )}. Available (installed): ${lockIds.join(", ") || "(none)"}.`
+      );
+    }
+  }
+  const targetIds = [];
+  const skippedSkillIds = [];
+  for (const id of lockIds) {
+    if (requestedSet && !requestedSet.has(id)) continue;
+    const entry2 = manifestById.get(id);
+    if (!entry2) {
+      logger.debug(
+        `Skipping "${id}": no longer in upstream manifest. Use \`skills uninstall ${id}\` to remove.`
+      );
+      skippedSkillIds.push(id);
+      continue;
+    }
+    const effectiveScope = entry2.scope ?? "project";
+    if (effectiveScope !== scope) {
+      logger.debug(
+        `Skipping "${id}" (scope=${effectiveScope}): current install scope is "${scope}".`
+      );
+      skippedSkillIds.push(id);
+      continue;
+    }
+    targetIds.push(id);
+  }
+  const allSame = targetIds.every((id) => {
+    const lockVer = existingLock.skills[id].version;
+    const manVer = manifestById.get(id).version;
+    return lockVer === manVer;
+  });
+  if (targetIds.length > 0 && allSame && !dryRun) {
+    return {
+      status: "no-changes",
+      packageName,
+      version: manifest.version,
+      checkedSkillIds: targetIds
+    };
+  }
+  if (dryRun) {
+    const plan = targetIds.map((id) => {
+      const lockVer = existingLock.skills[id].version;
+      const entry2 = manifestById.get(id);
+      const sameVersion = lockVer === entry2.version;
+      return {
+        id,
         current: lockVer,
         next: entry2.version,
         strategy: entry2.updateStrategy ?? "managed",
@@ -1714,6 +1813,24 @@ async function runSkillsUpdate(options) {
     };
   }
   await writeSkillsLock(projectRoot, lock);
+  if (scope === "project") {
+    try {
+      const variant = await readTokensVariant(projectRoot);
+      if (variant) {
+        const projectSkillIds = Object.entries(lock.skills).filter(([, v]) => v.scope === "project").map(([id]) => id);
+        await runGenerateAgentsMd({
+          projectRoot,
+          variant,
+          skillIds: projectSkillIds,
+          mode: "merge-managed"
+        });
+      }
+    } catch (err) {
+      logger.warn(
+        `AGENTS.md \u5237\u65B0\u5931\u8D25\uFF08\u975E\u5173\u952E\uFF09\uFF1A${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
   return {
     status: "updated",
     packageName,
@@ -1734,8 +1851,7 @@ var DEFAULT_UI_ALIASES = {
   utils: "src/lib/utils",
   lib: "src/lib",
   business: "src/components/business",
-  blocks: "src/blocks",
-  templates: "src/templates"
+  blocks: "src/blocks"
 };
 var DEFAULT_UI_ICON_LIBRARY = "lucide";
 async function runUiInit(options) {
@@ -1752,8 +1868,7 @@ async function runUiInit(options) {
     utils: options.aliases?.utils ?? DEFAULT_UI_ALIASES.utils,
     lib: options.aliases?.lib ?? DEFAULT_UI_ALIASES.lib,
     business: options.aliases?.business ?? DEFAULT_UI_ALIASES.business,
-    blocks: options.aliases?.blocks ?? DEFAULT_UI_ALIASES.blocks,
-    templates: options.aliases?.templates ?? DEFAULT_UI_ALIASES.templates
+    blocks: options.aliases?.blocks ?? DEFAULT_UI_ALIASES.blocks
   };
   const iconLibrary = options.iconLibrary ?? DEFAULT_UI_ICON_LIBRARY;
   const tsx = options.tsx ?? true;
@@ -1773,7 +1888,6 @@ async function runUiInit(options) {
     rsc
   };
   await writeProjectConfig(projectRoot, config);
-  await ensureMcpJson(projectRoot);
   return {
     status: "installed",
     aliases,
@@ -1785,7 +1899,7 @@ async function runUiInit(options) {
 
 // src/core/ui-client.ts
 import * as path10 from "path";
-import * as fs7 from "fs/promises";
+import * as fs9 from "fs/promises";
 import { createRequire as createRequire3 } from "module";
 import { loadUiPackageManifest } from "@teamix-evo/registry";
 var require4 = createRequire3(import.meta.url);
@@ -1800,7 +1914,7 @@ async function loadUiData(packageName) {
   let data = {};
   const dataPath = path10.join(packageRoot, "_data.json");
   try {
-    const raw = await fs7.readFile(dataPath, "utf-8");
+    const raw = await fs9.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
   } catch (err) {
     if (err.code !== "ENOENT") {
@@ -1813,7 +1927,7 @@ async function loadUiData(packageName) {
 
 // src/core/ui-installer.ts
 import * as path11 from "path";
-import * as fs8 from "fs/promises";
+import * as fs10 from "fs/promises";
 import { resolveUiEntryOrder } from "@teamix-evo/registry";
 
 // src/utils/transform-imports.ts
@@ -1890,9 +2004,21 @@ async function installUiEntries(options) {
       }
       const rootForEntry = entryPackageRoot?.get(entry.id) ?? packageRoot;
       const sourceAbs = path11.resolve(rootForEntry, file.source);
-      const raw = await fs8.readFile(sourceAbs, "utf-8");
+      const raw = await fs10.readFile(sourceAbs, "utf-8");
       const transformed = rewriteImports(raw, aliases, { flatten });
       if (exists) {
+        const current = await fs10.readFile(targetAbs, "utf-8");
+        if (current === transformed) {
+          logger.info(`  skip (identical): ${rel(projectRoot, targetAbs)}`);
+          skipped++;
+          resources.push({
+            id: `${entry.id}:${file.targetName}`,
+            target: path11.relative(projectRoot, targetAbs),
+            hash: computeHash(transformed),
+            strategy: entry.updateStrategy ?? "frozen"
+          });
+          continue;
+        }
         await backupFile(targetAbs, projectRoot);
       }
       await writeFileSafe(targetAbs, transformed);
@@ -1900,7 +2026,7 @@ async function installUiEntries(options) {
       logger.info(`  write: ${rel(projectRoot, targetAbs)}`);
       resources.push({
         id: `${entry.id}:${file.targetName}`,
-        target: targetAbs,
+        target: path11.relative(projectRoot, targetAbs),
         hash: computeHash(transformed),
         strategy: entry.updateStrategy ?? "frozen"
       });
@@ -1926,23 +2052,26 @@ function resolveTargetPath(projectRoot, aliases, entry, file) {
 function rel(projectRoot, abs) {
   return path11.relative(projectRoot, abs);
 }
-async function removeUiFiles(records) {
+async function removeUiFiles(records, projectRoot) {
   const removed = [];
   for (const r of records) {
+    const abs = resolveResourceTarget(projectRoot, r.target);
     try {
-      await fs8.unlink(r.target);
-      removed.push(r.target);
+      await fs10.unlink(abs);
+      removed.push(abs);
     } catch (err) {
       if (err.code !== "ENOENT") {
-        logger.warn(`Failed to remove ${r.target}: ${getErrorMessage(err)}`);
+        logger.warn(`Failed to remove ${abs}: ${getErrorMessage(err)}`);
       }
     }
   }
-  const parents = new Set(records.map((r) => path11.dirname(r.target)));
+  const parents = new Set(
+    records.map((r) => path11.dirname(resolveResourceTarget(projectRoot, r.target)))
+  );
   for (const dir of parents) {
     try {
-      const entries = await fs8.readdir(dir);
-      if (entries.length === 0) await fs8.rmdir(dir);
+      const entries = await fs10.readdir(dir);
+      if (entries.length === 0) await fs10.rmdir(dir);
     } catch {
     }
   }
@@ -2091,7 +2220,7 @@ async function runVariantUiAdd(packageName, options) {
   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).`
+      `UI not initialized. Run \`teamix-evo ui init\` first \u2014 \`${packageName} add\` writes into the same alias map (business / blocks).`
     );
   }
   const packageRoot = options.packageRoot ?? resolvePackageRoot3(fullPackageName);
@@ -2182,9 +2311,6 @@ function mergeResources2(prior, next) {
 async function runBizUiAdd(options) {
   return runVariantUiAdd("biz-ui", options);
 }
-async function runTemplatesAdd(options) {
-  return runVariantUiAdd("templates", options);
-}
 async function listVariantUi(packageName, packageRoot) {
   const fullPackageName = `@teamix-evo/${packageName}`;
   const root = packageRoot ?? resolvePackageRoot3(fullPackageName);
@@ -2202,9 +2328,6 @@ async function listVariantUi(packageName, packageRoot) {
 async function listBizUiVariants(packageRoot) {
   return listVariantUi("biz-ui", packageRoot);
 }
-async function listTemplatesVariants(packageRoot) {
-  return listVariantUi("templates", packageRoot);
-}
 async function listVariantUiEntries(packageName, variant, packageRoot) {
   const fullPackageName = `@teamix-evo/${packageName}`;
   const root = packageRoot ?? resolvePackageRoot3(fullPackageName);
@@ -2232,13 +2355,10 @@ async function listVariantUiEntries(packageName, variant, packageRoot) {
 async function listBizUiEntries(variant, packageRoot) {
   return listVariantUiEntries("biz-ui", variant, packageRoot);
 }
-async function listTemplatesEntries(variant, packageRoot) {
-  return listVariantUiEntries("templates", variant, packageRoot);
-}
 
 // src/core/lint-init.ts
 import * as path13 from "path";
-import * as fs9 from "fs";
+import * as fs11 from "fs";
 import { execa } from "execa";
 var ESLINT_CONFIG_CONTENT = `/**
  * teamix-evo consumer ESLint preset \u2014 9 token-discipline rules.
@@ -2330,7 +2450,7 @@ async function runLintInit(options) {
   let stylelintIgnoreFilesWarning = false;
   if (!stylelintNeedsWrite && stylelintTemplateExists) {
     try {
-      const existingContent = fs9.readFileSync(stylelintConfigPath, "utf-8");
+      const existingContent = fs11.readFileSync(stylelintConfigPath, "utf-8");
       const usesTeamixPreset = existingContent.includes("@teamix-evo/stylelint-config/presets/") || existingContent.includes("@teamix-evo/stylelint-config/preset/");
       const hasTokenIgnore = existingContent.includes("tokens.theme.css") && existingContent.includes("tokens.overrides.css");
       if (!usesTeamixPreset && !hasTokenIgnore) {
@@ -2344,305 +2464,65 @@ async function runLintInit(options) {
             "    '**/tokens.theme.css',",
             "    '**/tokens.overrides.css',",
             "  ]",
-            "",
-            "\u6216\u5207\u6362\u5230 teamix-evo \u9884\u8BBE\u4EE5\u81EA\u52A8\u83B7\u5F97\u6392\u9664\u89C4\u5219:",
-            "",
-            "  extends: ['@teamix-evo/stylelint-config/presets/consumer']"
-          ].join("\n")
-        );
-      }
-    } catch {
-    }
-  }
-  return {
-    status: "installed",
-    eslint: wroteEslint,
-    stylelint: wroteStylelint,
-    eslintMergeRequested: wroteEslint && eslintStrategy === "merge" && eslintExistingPaths.length > 0,
-    stylelintMergeRequested: wroteStylelint && stylelintStrategy === "merge" && stylelintExistingPaths.length > 0,
-    eslintSkipped: eslintSkipRequested,
-    stylelintSkipped: stylelintSkipRequested,
-    packageJsonPatched,
-    stylelintIgnoreFilesWarning
-  };
-}
-function detectPm(projectRoot) {
-  if (fs9.existsSync(path13.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs9.existsSync(path13.join(projectRoot, "yarn.lock"))) return "yarn";
-  return "npm";
-}
-async function patchPackageJsonScripts(projectRoot) {
-  const pkgPath = path13.join(projectRoot, "package.json");
-  const raw = await readFileOrNull(pkgPath);
-  if (!raw) return false;
-  let pkg;
-  try {
-    pkg = JSON.parse(raw);
-  } catch {
-    return false;
-  }
-  const scripts = pkg.scripts ?? {};
-  let changed = false;
-  if (!scripts.lint) {
-    scripts.lint = "eslint src/";
-    changed = true;
-  }
-  if (!scripts["lint:css"]) {
-    scripts["lint:css"] = "stylelint 'src/**/*.css'";
-    changed = true;
-  }
-  if (changed) {
-    await backupFile(pkgPath, projectRoot);
-    pkg.scripts = scripts;
-    await writeFileSafe(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-    logger.debug("Patched package.json scripts with lint / lint:css");
-  }
-  return changed;
-}
-
-// src/core/agents-md.ts
-import * as fs10 from "fs/promises";
-import * as path14 from "path";
-import { hasManagedRegion as hasManagedRegion2, replaceManagedRegion as replaceManagedRegion2 } from "@teamix-evo/registry";
-var AGENTS_MD_MANAGED_ID = "teamix-evo-skills";
-async function runGenerateAgentsMd(options) {
-  const { projectRoot, variant, skillIds } = options;
-  const mode = options.mode ?? "overwrite";
-  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 target = path14.join(projectRoot, "AGENTS.md");
-  const targetExists = await fileExists(target);
-  const fullTemplate = renderAgentsMd({ variant, sections });
-  const managedBody = renderManagedBlockBody({ variant, sections });
-  let outputContent;
-  let merge;
-  if (!targetExists) {
-    outputContent = fullTemplate;
-    merge = "created";
-  } else {
-    await backupFile(target, projectRoot);
-    if (mode === "merge-managed") {
-      const existing = await readFileOrNull(target) ?? "";
-      if (hasManagedRegion2(existing, AGENTS_MD_MANAGED_ID)) {
-        outputContent = replaceManagedRegion2(
-          existing,
-          AGENTS_MD_MANAGED_ID,
-          managedBody
-        );
-        merge = "managed-replaced";
-      } else {
-        const wrapped = wrapManagedBlock(managedBody);
-        outputContent = `${wrapped}
-
-${PRECEDENCE_NOTICE}
-
-${existing.trimStart()}`;
-        merge = "managed-prepended";
-      }
-    } else {
-      outputContent = fullTemplate;
-      merge = "overwritten";
-    }
-  }
-  await fs10.writeFile(target, outputContent, "utf8");
-  return {
-    path: target,
-    skillCount: ordered.length,
-    missingSkillIds,
-    backedUp: targetExists,
-    merge
-  };
-}
-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 = path14.join(
-    getSkillsSourceDir(projectRoot, skillId),
-    "SKILL.md"
-  );
-  const lines = [];
-  lines.push(`### ${skillId}`);
-  let parts = null;
-  let missing = false;
-  try {
-    const raw = await fs10.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-source/${skillId}/SKILL.md\``);
-  return { section: lines.join("\n"), missing };
-}
-function renderAgentsMd(args) {
-  const { variant, sections } = args;
-  const managedBody = renderManagedBlockBody({ variant, sections });
-  const wrapped = wrapManagedBlock(managedBody);
-  return `${wrapped}
-
-${PRECEDENCE_NOTICE}
-`;
-}
-function renderManagedBlockBody(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\u9075\u5FAA ADR 0038\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
-- \u8FC1\u79FB\u573A\u666F\uFF08"\u4EE3\u7801\u8FC1\u79FB" / "\u6267\u884C\u8FC1\u79FB" / "\u65E7\u9879\u76EE\u8FC1\u79FB" / "\u91CD\u5EFA\u8001\u5DE5\u7A0B"\uFF09\u540C\u6837\u8D70 \`teamix-evo-manage\` \u573A\u666F 6
-
-## UI \u7EC4\u4EF6\u9886\u5730\uFF08init \u540E\u7EA6\u675F\uFF09
-
-- \`src/components/ui/\` \u7531 teamix-evo \u63A5\u7BA1\uFF0C\u7981\u6B62\u624B\u5DE5\u6216\u901A\u8FC7 shadcn CLI \u6DFB\u52A0\u65B0\u7EC4\u4EF6
-- \u5982\u9700\u65B0\u589E UI \u7EC4\u4EF6\uFF0C\u4F7F\u7528 \`npx teamix-evo ui add <id>\`
-- \`src/components/shadcn-ui/\` \u662F init \u524D legacy \u7EC4\u4EF6\u5F52\u6863\uFF0C\u53EA\u8BFB\uFF1B\u65B0\u4EE3\u7801\u4E0D\u5E94\u518D import
-- \u5347\u7EA7 legacy \u7EC4\u4EF6\uFF1A\u89E6\u53D1 teamix-evo-upgrade skill
-
-> \u5237\u65B0\u672C\u6587\u4EF6\uFF1A\`npx teamix-evo skills add\` \u6216\u91CD\u8DD1 \`npm create teamix-evo\` / \`teamix-evo init\`\u3002`;
-}
-function wrapManagedBlock(body) {
-  return `<!-- teamix-evo:managed:start id="${AGENTS_MD_MANAGED_ID}" -->
-${body}
-<!-- teamix-evo:managed:end id="${AGENTS_MD_MANAGED_ID}" -->`;
-}
-var PRECEDENCE_NOTICE = `<!-- teamix-evo:precedence -->
-> \u51B2\u7A81\u4EE5\u4E0A\u65B9\u7684 **Skills** \u7D22\u5F15\u4E3A\u51C6\uFF08\u4E0A\u6E38\u8DEF\u5F84\u4E0E TRIGGER/SKIP \u5951\u7EA6\uFF09\uFF1B\u9879\u76EE\u7279\u6709\u7684\u4EBA\u5DE5\u7EC6\u5219\u8BF7\u5199\u5728\u672C\u5904\u4EE5\u4E0B\u3001\u4E0D\u8981\u8986\u76D6\u4E0A\u65B9 managed \u533A\u57DF\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;
+            "",
+            "\u6216\u5207\u6362\u5230 teamix-evo \u9884\u8BBE\u4EE5\u81EA\u52A8\u83B7\u5F97\u6392\u9664\u89C4\u5219:",
+            "",
+            "  extends: ['@teamix-evo/stylelint-config/presets/consumer']"
+          ].join("\n")
+        );
       }
-      break;
+    } catch {
     }
   }
-  if (startIdx === -1) return null;
-  if (blockMode === "inline") {
-    return inlineValue ?? "";
+  return {
+    status: "installed",
+    eslint: wroteEslint,
+    stylelint: wroteStylelint,
+    eslintMergeRequested: wroteEslint && eslintStrategy === "merge" && eslintExistingPaths.length > 0,
+    stylelintMergeRequested: wroteStylelint && stylelintStrategy === "merge" && stylelintExistingPaths.length > 0,
+    eslintSkipped: eslintSkipRequested,
+    stylelintSkipped: stylelintSkipRequested,
+    packageJsonPatched,
+    stylelintIgnoreFilesWarning
+  };
+}
+function detectPm(projectRoot) {
+  if (fs11.existsSync(path13.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs11.existsSync(path13.join(projectRoot, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+async function patchPackageJsonScripts(projectRoot) {
+  const pkgPath = path13.join(projectRoot, "package.json");
+  const raw = await readFileOrNull(pkgPath);
+  if (!raw) return false;
+  let pkg;
+  try {
+    pkg = JSON.parse(raw);
+  } catch {
+    return false;
   }
-  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));
+  const scripts = pkg.scripts ?? {};
+  let changed = false;
+  if (!scripts.lint) {
+    scripts.lint = "eslint src/";
+    changed = true;
   }
-  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 (!scripts["lint:css"]) {
+    scripts["lint:css"] = "stylelint 'src/**/*.css'";
+    changed = true;
   }
-  if (!inSection) return null;
-  const joined = collected.filter((l) => l !== "").join(" ").replace(/\s+/g, " ").trim();
-  return joined || null;
+  if (changed) {
+    await backupFile(pkgPath, projectRoot);
+    pkg.scripts = scripts;
+    await writeFileSafe(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    logger.debug("Patched package.json scripts with lint / lint:css");
+  }
+  return changed;
 }
 
 // src/core/init-detect.ts
-import * as fs11 from "fs/promises";
-import * as path15 from "path";
+import * as fs12 from "fs/promises";
+import * as path14 from "path";
 var IGNORED_TOP_LEVEL = /* @__PURE__ */ new Set([
   ".git",
   ".gitignore",
@@ -2662,7 +2542,7 @@ var IGNORED_TOP_LEVEL = /* @__PURE__ */ new Set([
   "LICENSE.txt"
 ]);
 async function detectProjectState(cwd) {
-  const absCwd = path15.resolve(cwd);
+  const absCwd = path14.resolve(cwd);
   const teamixDir = getTeamixDir(absCwd);
   const hasTeamixDir = await fileExists(teamixDir);
   if (hasTeamixDir) {
@@ -2670,13 +2550,13 @@ async function detectProjectState(cwd) {
       state: "teamix-evo-installed",
       cwd: absCwd,
       hasTeamixDir: true,
-      hasPackageJson: await fileExists(path15.join(absCwd, "package.json")),
+      hasPackageJson: await fileExists(path14.join(absCwd, "package.json")),
       significantEntries: []
     };
   }
   let entries;
   try {
-    entries = await fs11.readdir(absCwd);
+    entries = await fs12.readdir(absCwd);
   } catch (err) {
     if (err.code === "ENOENT") {
       return {
@@ -2709,9 +2589,151 @@ async function detectProjectState(cwd) {
   };
 }
 
+// src/core/project-state.ts
+import * as fs13 from "fs/promises";
+import * as path15 from "path";
+var IGNORED_TOP_LEVEL2 = /* @__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"
+]);
+var SHADCN_TRAIT_KEYS = ["$schema", "style", "rsc", "tsx", "aliases"];
+async function isShadcnComponentsJson(filePath) {
+  const content = await readFileOrNull(filePath);
+  if (!content) return false;
+  try {
+    const json = JSON.parse(content);
+    return SHADCN_TRAIT_KEYS.some((key) => key in json);
+  } catch {
+    return false;
+  }
+}
+async function detectProjectState2(cwd) {
+  const absCwd = path15.resolve(cwd);
+  const teamixDir = getTeamixDir(absCwd);
+  const hasTeamixDir = await fileExists(teamixDir);
+  if (hasTeamixDir) {
+    return {
+      state: "teamix-evo",
+      cwd: absCwd,
+      hasTeamixDir: true,
+      hasPackageJson: await fileExists(path15.join(absCwd, "package.json")),
+      hasComponentsJson: false,
+      significantEntries: []
+    };
+  }
+  const componentsJsonPath = path15.join(absCwd, "components.json");
+  const hasPackageJson = await fileExists(path15.join(absCwd, "package.json"));
+  const hasComponentsJson = await isShadcnComponentsJson(componentsJsonPath);
+  if (hasPackageJson && hasComponentsJson) {
+    return {
+      state: "shadcn",
+      cwd: absCwd,
+      hasTeamixDir: false,
+      hasPackageJson: true,
+      hasComponentsJson: true,
+      significantEntries: []
+    };
+  }
+  let entries;
+  try {
+    entries = await fs13.readdir(absCwd);
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return {
+        state: "empty",
+        cwd: absCwd,
+        hasTeamixDir: false,
+        hasPackageJson: false,
+        hasComponentsJson: false,
+        significantEntries: []
+      };
+    }
+    throw err;
+  }
+  const significant = entries.filter((e) => !IGNORED_TOP_LEVEL2.has(e));
+  if (significant.length === 0) {
+    return {
+      state: "empty",
+      cwd: absCwd,
+      hasTeamixDir: false,
+      hasPackageJson: false,
+      hasComponentsJson: false,
+      significantEntries: []
+    };
+  }
+  return {
+    state: "other",
+    cwd: absCwd,
+    hasTeamixDir: false,
+    hasPackageJson,
+    hasComponentsJson,
+    significantEntries: significant.slice(0, 20).sort()
+  };
+}
+
+// src/core/command-guard.ts
+var COMMAND_LABELS = {
+  init: "\u521D\u59CB\u5316 Teamix Evo \u5957\u4EF6",
+  migrate: "shadcn \u9879\u76EE\u8FC1\u79FB\u4E3A Teamix Evo \u5957\u4EF6",
+  update: "Teamix Evo \u5957\u4EF6\u66F4\u65B0"
+};
+var STATE_LABELS = {
+  empty: "\u7A7A\u76EE\u5F55",
+  shadcn: "shadcn \u5DE5\u7A0B",
+  "teamix-evo": "Teamix Evo \u5DE5\u7A0B",
+  other: "\u666E\u901A npm \u5DE5\u7A0B"
+};
+var VALID_STATES = {
+  init: "empty",
+  migrate: "shadcn",
+  update: "teamix-evo"
+};
+var STATE_TO_COMMAND = {
+  empty: "init",
+  shadcn: "migrate",
+  "teamix-evo": "update",
+  other: null
+};
+function assertCommandPrecondition(command, state) {
+  const expected = VALID_STATES[command];
+  if (state === expected) return;
+  const stateLabel = STATE_LABELS[state];
+  const commandLabel = COMMAND_LABELS[command];
+  logger.error(
+    `\u5F53\u524D\u9879\u76EE\u72B6\u6001\u4E3A\u300C${stateLabel}\u300D\uFF0C\u65E0\u6CD5\u6267\u884C\u300C${commandLabel}\u300D\u3002`
+  );
+  const suggestion = STATE_TO_COMMAND[state];
+  if (suggestion) {
+    const suggestionLabel = COMMAND_LABELS[suggestion];
+    logger.info(`\u5EFA\u8BAE\u4F7F\u7528\uFF1Ateamix-evo ${suggestion}\uFF08${suggestionLabel}\uFF09`);
+  } else {
+    logger.info(
+      "\u5F53\u524D\u9879\u76EE\u7C7B\u578B\u6682\u4E0D\u652F\u6301\u76F4\u63A5\u63A5\u5165\u3002"
+    );
+    logger.info(
+      "\u5EFA\u8BAE\uFF1A\u5148\u7528 teamix-evo init \u521D\u59CB\u5316 Teamix Evo \u5957\u4EF6\uFF08\u7A7A\u76EE\u5F55\uFF09\uFF0C\u7136\u540E\u5BF9\u65E7\u9879\u76EE\u8FDB\u884C\u91CD\u6784\u3002"
+    );
+  }
+  process.exitCode = 1;
+}
+
 // src/core/init-conflicts.ts
 import * as crypto from "crypto";
-import * as fs12 from "fs/promises";
+import * as fs14 from "fs/promises";
 import * as path16 from "path";
 var TAILWIND_CONFIG_CANDIDATES = [
   "tailwind.config.ts",
@@ -2756,7 +2778,7 @@ var STYLELINT_CONFIG_CANDIDATES = [
 ];
 async function isDir(target) {
   try {
-    const stat3 = await fs12.stat(target);
+    const stat3 = await fs14.stat(target);
     return stat3.isDirectory();
   } catch {
     return false;
@@ -2764,7 +2786,7 @@ async function isDir(target) {
 }
 async function dirHasContent(target) {
   try {
-    const entries = await fs12.readdir(target);
+    const entries = await fs14.readdir(target);
     return entries.length > 0;
   } catch {
     return false;
@@ -2905,7 +2927,7 @@ async function detectShadcnSource(cwd) {
   try {
     const uiDir = path16.join(cwd, "src/components/ui");
     if (await isDir(uiDir)) {
-      const entries = await fs12.readdir(uiDir);
+      const entries = await fs14.readdir(uiDir);
       componentCount = entries.filter(
         (e) => e.endsWith(".tsx") || e.endsWith(".ts")
       ).length;
@@ -2981,19 +3003,97 @@ async function detectStylelintConfig(cwd) {
   };
 }
 
-// src/core/deps-install.ts
-import * as fs13 from "fs/promises";
+// src/core/meta-installer.ts
 import * as path17 from "path";
+import * as fs15 from "fs/promises";
+import { createRequire as createRequire5 } from "module";
+import {
+  loadUiPackageManifest as loadUiPackageManifest3,
+  loadVariantUiPackageManifest as loadVariantUiPackageManifest2
+} from "@teamix-evo/registry";
+var require6 = createRequire5(import.meta.url);
+var META_DIR = "meta";
+function resolvePackageRoot4(packageName) {
+  const pkgJsonPath = require6.resolve(`${packageName}/package.json`);
+  return path17.dirname(pkgJsonPath);
+}
+function getMetaDir(projectRoot, category) {
+  const base = path17.join(getTeamixDir(projectRoot), META_DIR);
+  return category ? path17.join(base, category) : base;
+}
+async function landUiMeta(projectRoot) {
+  const packageRoot = resolvePackageRoot4("@teamix-evo/ui");
+  const manifest = await loadUiPackageManifest3(packageRoot);
+  return landManifestMeta({
+    projectRoot,
+    packageRoot,
+    manifest,
+    category: "ui"
+  });
+}
+async function landBizUiMeta(projectRoot, variant) {
+  const packageRoot = resolvePackageRoot4("@teamix-evo/biz-ui");
+  const variantRoot = path17.join(packageRoot, "variants", variant);
+  const manifest = await loadVariantUiPackageManifest2(variantRoot);
+  return landManifestMeta({
+    projectRoot,
+    packageRoot: variantRoot,
+    manifest,
+    category: "biz-ui"
+  });
+}
+async function landManifestMeta(opts) {
+  const { projectRoot, packageRoot, manifest, category } = opts;
+  await ensureTeamixDir(projectRoot);
+  const metaDir = getMetaDir(projectRoot, category);
+  await ensureDir(metaDir);
+  const manifestDest = path17.join(metaDir, "manifest.json");
+  const manifestSrc = path17.join(packageRoot, "manifest.json");
+  await fs15.copyFile(manifestSrc, manifestDest);
+  logger.debug(`meta: copied manifest.json \u2192 ${manifestDest}`);
+  let written = 0;
+  let total = 0;
+  for (const entry of manifest.entries) {
+    if (!entry.meta) continue;
+    total++;
+    const srcPath = path17.join(packageRoot, entry.meta);
+    const destPath = path17.join(metaDir, `${entry.id}.md`);
+    try {
+      await fs15.copyFile(srcPath, destPath);
+      written++;
+      logger.debug(`meta: ${entry.id} \u2192 ${destPath}`);
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        logger.warn(`meta: ${entry.id} \u2014 source not found: ${srcPath}`);
+      } else {
+        throw err;
+      }
+    }
+  }
+  logger.info(
+    `  meta/${category}: ${written}/${total} meta files, manifest.json`
+  );
+  return {
+    category,
+    manifestWritten: true,
+    metaFilesWritten: written,
+    metaFilesTotal: total
+  };
+}
+
+// src/core/deps-install.ts
+import * as fs16 from "fs/promises";
+import * as path18 from "path";
 import { exec } from "child_process";
 import { promisify } from "util";
 var execAsync = promisify(exec);
 async function detectPackageManager(projectRoot) {
-  if (await fileExists(path17.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (await fileExists(path17.join(projectRoot, "pnpm-workspace.yaml")))
+  if (await fileExists(path18.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (await fileExists(path18.join(projectRoot, "pnpm-workspace.yaml")))
     return "pnpm";
-  if (await fileExists(path17.join(projectRoot, "bun.lockb"))) return "bun";
-  if (await fileExists(path17.join(projectRoot, "bun.lock"))) return "bun";
-  if (await fileExists(path17.join(projectRoot, "yarn.lock"))) return "yarn";
+  if (await fileExists(path18.join(projectRoot, "bun.lockb"))) return "bun";
+  if (await fileExists(path18.join(projectRoot, "bun.lock"))) return "bun";
+  if (await fileExists(path18.join(projectRoot, "yarn.lock"))) return "yarn";
   return "npm";
 }
 function getInstallCommand(pm) {
@@ -3010,7 +3110,7 @@ function getInstallCommand(pm) {
 }
 async function installProjectDeps(options) {
   const { projectRoot, npmDependencies, skipInstall = false } = options;
-  const pkgPath = path17.join(projectRoot, "package.json");
+  const pkgPath = path18.join(projectRoot, "package.json");
   const raw = await readFileOrNull(pkgPath);
   if (!raw) {
     throw new Error(
@@ -3039,7 +3139,7 @@ async function installProjectDeps(options) {
     pkg.dependencies = Object.fromEntries(
       Object.entries(pkg.dependencies).sort(([a], [b]) => a.localeCompare(b))
     );
-    await fs13.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    await fs16.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
     logger.info(
       `  patched package.json: +${Object.keys(added).length} dependencies`
     );
@@ -3101,19 +3201,19 @@ ${stepLines}
 }
 
 // src/core/file-changes.ts
-import * as fs14 from "fs/promises";
-import * as path18 from "path";
+import * as fs17 from "fs/promises";
+import * as path19 from "path";
 function toRelativePosix(p, projectRoot) {
   let rel2 = p;
-  if (path18.isAbsolute(p)) {
-    rel2 = path18.relative(projectRoot, p);
+  if (path19.isAbsolute(p)) {
+    rel2 = path19.relative(projectRoot, p);
   }
-  return rel2.split(path18.sep).join("/");
+  return rel2.split(path19.sep).join("/");
 }
 
 // src/core/project-init.ts
 import * as fsNode from "fs/promises";
-import * as path19 from "path";
+import * as path20 from "path";
 var CRITICAL_STEPS = /* @__PURE__ */ new Set([
   "tokens",
   "skills",
@@ -3124,7 +3224,6 @@ var GITIGNORE_MARKER_END = "# <<< teamix-evo:managed <<<";
 var GITIGNORE_RULES = [
   "# Runtime artifacts (regenerable / archives)",
   ".teamix-evo/.snapshots/",
-  ".teamix-evo/logs/",
   ".teamix-evo/.backups/",
   ".teamix-evo/.upgrade-staging/",
   ".teamix-evo/.upgrade-hints/"
@@ -3206,7 +3305,7 @@ async function runProjectInit(options) {
           detail: `${result.skillCount} skills, ${result.fileCount} files (added: ${result.addedSkillIds.join(", ") || "none"})`,
           changes: result.addedSkillIds.map((id) => ({
             kind: "created",
-            path: `.teamix-evo/skills/${id}/SKILL.md`,
+            path: `.${ides[0] ?? "qoder"}/skills/${id}/SKILL.md`,
             step: "skills",
             detail: "skill installed"
           }))
@@ -3363,6 +3462,31 @@ async function runProjectInit(options) {
       recordFailure("biz-ui-add", err);
     }
   }
+  if (dryRun) {
+    record({
+      name: "meta-landing",
+      status: "planned",
+      detail: `landUiMeta() + landBizUiMeta(${variant})`
+    });
+  } else if (aborted) {
+    record({
+      name: "meta-landing",
+      status: "skip",
+      detail: "aborted: earlier critical step failed"
+    });
+  } else {
+    try {
+      const uiResult = await landUiMeta(projectRoot);
+      const bizResult = await landBizUiMeta(projectRoot, variant);
+      record({
+        name: "meta-landing",
+        status: "ok",
+        detail: `ui: ${uiResult.metaFilesWritten}/${uiResult.metaFilesTotal}, biz-ui: ${bizResult.metaFilesWritten}/${bizResult.metaFilesTotal}`
+      });
+    } catch (err) {
+      recordFailure("meta-landing", err);
+    }
+  }
   if (!dryRun && !aborted && Object.keys(collectedNpmDeps).length > 0) {
     try {
       await installProjectDeps({
@@ -3430,7 +3554,7 @@ async function runProjectInit(options) {
           detail: "projectRoot does not exist"
         });
       } else {
-        const giPath = path19.join(projectRoot, ".gitignore");
+        const giPath = path20.join(projectRoot, ".gitignore");
         let giContent = "";
         try {
           giContent = await fsNode.readFile(giPath, "utf-8");
@@ -3486,15 +3610,16 @@ async function runProjectInit(options) {
       resumeCommand: "teamix-evo init"
     };
   }
-  if (!dryRun) {
+  const hasFailures = steps.some((s) => s.status === "fail" || s.status === "skip");
+  if (!dryRun && hasFailures) {
     try {
       const checklistContent = renderInitChecklist({ variant, status, steps });
-      const checklistPath = path19.join(
+      const checklistPath = path20.join(
         projectRoot,
         ".teamix-evo",
         "init-checklist.md"
       );
-      await fsNode.mkdir(path19.dirname(checklistPath), { recursive: true });
+      await fsNode.mkdir(path20.dirname(checklistPath), { recursive: true });
       await fsNode.writeFile(checklistPath, checklistContent, "utf-8");
       logger.info("  wrote .teamix-evo/init-checklist.md");
     } catch {
@@ -3534,8 +3659,8 @@ function deriveLintChanges(result) {
 }
 
 // src/core/installer.ts
-import * as path20 from "path";
-import * as fs15 from "fs/promises";
+import * as path21 from "path";
+import * as fs18 from "fs/promises";
 async function installResources(options) {
   const { projectRoot, manifest, data, variantDir, packageRoot } = options;
   const installedResources = [];
@@ -3572,13 +3697,13 @@ async function installSingleResource(resource, projectRoot, data, variantDir, pa
     variantDir,
     packageRoot
   );
-  const targetPath = path20.join(projectRoot, resource.target);
+  const targetPath = path21.join(projectRoot, resource.target);
   let content;
   if (resource.template) {
     const templateContent = await loadTemplateFile(sourcePath);
     content = renderTemplate(templateContent, data);
   } else {
-    content = await fs15.readFile(sourcePath, "utf-8");
+    content = await fs18.readFile(sourcePath, "utf-8");
   }
   await writeFileSafe(targetPath, content);
   const hash = computeHash(content);
@@ -3596,13 +3721,13 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
     variantDir,
     packageRoot
   );
-  const targetDir = path20.join(projectRoot, resource.target);
+  const targetDir = path21.join(projectRoot, resource.target);
   const results = [];
   await ensureDir(targetDir);
   const entries = await walkDir(sourcePath);
   for (const entry of entries) {
-    const relPath = path20.relative(sourcePath, entry);
-    let targetFile = path20.join(targetDir, relPath);
+    const relPath = path21.relative(sourcePath, entry);
+    let targetFile = path21.join(targetDir, relPath);
     if (resource.template && targetFile.endsWith(".hbs")) {
       targetFile = targetFile.slice(0, -4);
     }
@@ -3611,11 +3736,11 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
       const templateContent = await loadTemplateFile(entry);
       content = renderTemplate(templateContent, data);
     } else {
-      content = await fs15.readFile(entry, "utf-8");
+      content = await fs18.readFile(entry, "utf-8");
     }
     await writeFileSafe(targetFile, content);
     const hash = computeHash(content);
-    const targetRel = path20.relative(projectRoot, targetFile);
+    const targetRel = path21.relative(projectRoot, targetFile);
     results.push({
       id: `${resource.id}:${relPath}`,
       target: targetRel,
@@ -3628,25 +3753,25 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
 }
 
 // src/core/registry-client.ts
-import * as path21 from "path";
-import * as fs16 from "fs/promises";
-import { createRequire as createRequire5 } from "module";
+import * as path22 from "path";
+import * as fs19 from "fs/promises";
+import { createRequire as createRequire6 } from "module";
 import { loadVariantManifest } from "@teamix-evo/registry";
-var require6 = createRequire5(import.meta.url);
-function resolvePackageRoot4(packageName) {
-  const pkgJsonPath = require6.resolve(`${packageName}/package.json`);
-  return path21.dirname(pkgJsonPath);
+var require7 = createRequire6(import.meta.url);
+function resolvePackageRoot5(packageName) {
+  const pkgJsonPath = require7.resolve(`${packageName}/package.json`);
+  return path22.dirname(pkgJsonPath);
 }
 async function loadVariantData(packageName, variant) {
-  const packageRoot = resolvePackageRoot4(packageName);
-  const variantDir = path21.join(packageRoot, "library", variant);
+  const packageRoot = resolvePackageRoot5(packageName);
+  const variantDir = path22.join(packageRoot, "library", variant);
   logger.debug(`Resolved variant dir: ${variantDir}`);
   logger.debug(`Package root: ${packageRoot}`);
   const manifest = await loadVariantManifest(variantDir);
   let data = {};
-  const dataPath = path21.join(variantDir, "_data.json");
+  const dataPath = path22.join(variantDir, "_data.json");
   try {
-    const raw = await fs16.readFile(dataPath, "utf-8");
+    const raw = await fs19.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
   } catch (err) {
     if (err.code !== "ENOENT") {
@@ -3659,8 +3784,10 @@ async function loadVariantData(packageName, variant) {
 export {
   DEFAULT_UI_ALIASES,
   DEFAULT_UI_ICON_LIBRARY,
+  assertCommandPrecondition,
   detectConflicts,
-  detectProjectState,
+  detectProjectState2 as detectProjectState,
+  detectProjectState as detectProjectStateLegacy,
   ensureTeamixDir,
   extractDescriptionParts,
   getTeamixDir,
@@ -3669,14 +3796,13 @@ export {
   installUiEntries,
   listBizUiEntries,
   listBizUiVariants,
-  listTemplatesEntries,
-  listTemplatesVariants,
   listTokenVariants,
   loadSkillsData,
   loadUiData,
   loadVariantData,
   readInstalledManifest,
   readProjectConfig,
+  reinstallSkillsToIdes,
   removeSkillFiles,
   removeUiFiles,
   runBizUiAdd,
@@ -3686,12 +3812,10 @@ export {
   runSkillsAdd,
   runSkillsInit,
   runSkillsUpdate,
-  runTemplatesAdd,
   runTokensInit,
   runUiAdd,
   runUiInit,
   runUiList,
-  syncSkillsToIdes,
   updateSkills,
   writeInstalledManifest,
   writeProjectConfig