teamix-evo 0.4.0 → 0.4.1

package/README.md

@@ -167,27 +167,28 @@ TEAMIX_DEBUG=1 teamix-evo tokens init opentrek
 
 ## 命令参考
 
-| 命令                                                | 说明                                              |
-| --------------------------------------------------- | ------------------------------------------------- |
-| `teamix-evo tokens init <variant>`                  | 初始化 tokens                                     |
-| `teamix-evo tokens list-variants`                   | 列出可用 variant                                  |
-| `teamix-evo tokens list`                            | 查看已装机的 variant                              |
-| `teamix-evo tokens update`                          | 更新已装资源(stub,v0.7 见 ADR 0019)               |
-| `teamix-evo tokens uninstall`                       | 卸载已装 tokens                                   |
-| `teamix-evo skills add [name...]`                   | 装 skills(写源 + 镜像 IDE);不传 = 全装            |
-| `teamix-evo skills list`                            | 列出所有 skill 的安装状态                         |
-| `teamix-evo skills update`                          | 升级 skills(保留 managed 改动)                    |
-| `teamix-evo skills sync [name...]`                  | 源 → IDE 镜像(漂移恢复用)                         |
-| `teamix-evo skills doctor`                          | 检测源/镜像漂移(ADR 0013)                         |
-| `teamix-evo skills uninstall`                       | 卸载 skills(源 + 镜像 + lock)                     |
-| `teamix-evo ui init`                                | 初始化 ui 配置(aliases / iconLibrary / tsx / rsc) |
-| `teamix-evo ui add <id...>`                         | 安装指定 ui 组件源码                              |
-| `teamix-evo ui list [--installed]`                  | 列出可用/已安装 ui 组件                           |
-| `teamix-evo biz-ui list-variants`                   | 列出 biz-ui 包内提供的业务变体                    |
-| `teamix-evo biz-ui add <id...> --variant <name>`    | 安装变体感知业务组件(`--variant` 必填)            |
-| `teamix-evo templates list-variants`                | 列出 templates 包内提供的页面模板变体             |
-| `teamix-evo templates add <id...> --variant <name>` | 安装变体感知页面模板(`--variant` 必填)            |
-| `teamix-evo logs analyze [...]`                     | 分析 vibe-logger AI 调用链(`.log/ai/**/*.jsonl`)  |
+| 命令                                                | 说明                                                           |
+| --------------------------------------------------- | -------------------------------------------------------------- |
+| `teamix-evo tokens init <variant>`                  | 初始化 tokens                                                  |
+| `teamix-evo tokens list-variants`                   | 列出可用 variant                                               |
+| `teamix-evo tokens list`                            | 查看已装机的 variant                                           |
+| `teamix-evo tokens update`                          | 更新已装资源(stub,v0.7 见 ADR 0019)                            |
+| `teamix-evo tokens uninstall`                       | 卸载已装 tokens                                                |
+| `teamix-evo skills add [name...]`                   | 装 skills(写源 + 镜像 IDE);不传 = 全装                         |
+| `teamix-evo skills list`                            | 列出所有 skill 的安装状态                                      |
+| `teamix-evo skills update`                          | 升级 skills(保留 managed 改动)                                 |
+| `teamix-evo skills sync [name...]`                  | 源 → IDE 镜像(漂移恢复用)                                      |
+| `teamix-evo skills doctor`                          | 检测源/镜像漂移(ADR 0013)                                      |
+| `teamix-evo skills uninstall`                       | 卸载 skills(源 + 镜像 + lock)                                  |
+| `teamix-evo ui init`                                | 初始化 ui 配置(aliases / iconLibrary / tsx / rsc)              |
+| `teamix-evo ui add <id...>`                         | 安装指定 ui 组件源码                                           |
+| `teamix-evo ui list [--installed]`                  | 列出可用/已安装 ui 组件                                        |
+| `teamix-evo biz-ui list-variants`                   | 列出 biz-ui 包内提供的业务变体                                 |
+| `teamix-evo biz-ui add <id...> --variant <name>`    | 安装变体感知业务组件(`--variant` 必填)                         |
+| `teamix-evo templates list-variants`                | 列出 templates 包内提供的页面模板变体                          |
+| `teamix-evo templates add <id...> --variant <name>` | 安装变体感知页面模板(`--variant` 必填)                         |
+| `teamix-evo logs analyze [...]`                     | 分析 vibe-logger AI 调用链(`.log/ai/**/*.jsonl`)               |
+| `teamix-evo logs trace [...]`                       | 按会话还原 AI 调用链(prompt → PreToolUse → PostToolUse → Stop) |
 
 > 占位组件 → 真组件的升级流程**不是** CLI 子命令，由
 > [`teamix-evo-manage`](../../packages/skills/src/teamix-evo-manage/SKILL.md)

package/dist/core/index.d.ts

@@ -159,7 +159,6 @@ type RunUiInitResult = {
     iconLibrary: string;
     tsx: boolean;
     rsc: boolean;
-    preferencesCss: 'deployed' | 'skipped' | 'source-missing';
 } | {
     status: 'already-initialized';
 };
@@ -180,6 +179,12 @@ interface RunUiAddOptions {
     overwrite?: boolean;
     /** Override the ui package name (defaults to "@teamix-evo/ui"). */
     packageName?: string;
+    /**
+     * When true, allow installing entries that live in `manifest.deprecatedEntries`
+     * (ADR 0028). Default: false — deprecated ids are treated as unknown and the
+     * call errors with a hint pointing the user at the active replacement.
+     */
+    includeDeprecated?: boolean;
 }
 interface RunUiAddResult {
     packageName: string;
@@ -209,12 +214,19 @@ interface RunUiListOptions {
     installedOnly?: boolean;
     /** Override the ui package name (defaults to "@teamix-evo/ui"). */
     packageName?: string;
+    /**
+     * When true, also include archived entries from `manifest.deprecatedEntries`
+     * (ADR 0028). They are flagged with `deprecated: true` in the result.
+     */
+    includeDeprecated?: boolean;
 }
 interface UiEntryListItem {
     id: string;
     type: UiEntry['type'];
     description: string;
     installed: boolean;
+    /** True when the entry comes from `manifest.deprecatedEntries` (ADR 0028). */
+    deprecated: boolean;
 }
 interface RunUiListResult {
     packageName: string;

package/dist/core/index.js

@@ -1,5 +1,5 @@
 // src/core/tokens-init.ts
-import * as path8 from "path";
+import * as path9 from "path";
 import * as fs6 from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import {
@@ -253,7 +253,10 @@ async function loadSkillsData(packageName) {
 // src/core/skills-installer.ts
 import * as path7 from "path";
 import * as fs5 from "fs/promises";
-import { replaceManagedRegion } from "@teamix-evo/registry";
+import {
+  replaceManagedRegion,
+  hasManagedRegion
+} from "@teamix-evo/registry";
 
 // src/ide/QoderAdapter.ts
 import * as os from "os";
@@ -428,20 +431,63 @@ async function mirrorSkillToIde(skill, ide, scope, projectRoot) {
     const rel2 = path7.relative(sourceDir, src);
     const targetFile = path7.join(targetDir, rel2);
     const sourceContent = await fs5.readFile(src, "utf-8");
-    const existing = await readFileOrNull(targetFile);
-    if (existing !== null && existing !== sourceContent) {
-      logger.warn(
-        `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${src} (not the mirror) and re-run \`teamix-evo skills sync\`.`
-      );
-    }
-    await writeFileSafe(targetFile, sourceContent);
+    const writtenContent = await writeMirrorContent(
+      targetFile,
+      sourceContent,
+      skill.managedRegions,
+      src
+    );
     records.push(
-      makeMirrorRecord(skill, targetFile, sourceContent, ide, scope, rel2)
+      makeMirrorRecord(skill, targetFile, writtenContent, ide, scope, rel2)
     );
     logger.debug(`  Mirrored ${ide}:${scope}: ${targetFile}`);
   }
   return records;
 }
+async function writeMirrorContent(targetFile, sourceContent, managedRegions, sourceFile) {
+  const existing = await readFileOrNull(targetFile);
+  if (existing === null) {
+    await writeFileSafe(targetFile, sourceContent);
+    return sourceContent;
+  }
+  const regions = managedRegions ?? [];
+  const matchedRegions = regions.filter((id) => hasManagedRegion(existing, id));
+  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 \`teamix-evo skills sync\`.`
+      );
+      await writeFileSafe(targetFile, sourceContent);
+      return sourceContent;
+    }
+    return existing;
+  }
+  let merged = existing;
+  for (const id of matchedRegions) {
+    const newRegion = extractRegionBody(sourceContent, id);
+    if (newRegion === null) continue;
+    try {
+      merged = replaceManagedRegion(merged, id, newRegion);
+    } catch {
+    }
+  }
+  if (merged !== existing) {
+    await writeFileSafe(targetFile, merged);
+  }
+  return merged;
+}
+function extractRegionBody(content, id) {
+  const re = new RegExp(
+    `<!-- teamix-evo:managed:start id="${escapeRegExp(
+      id
+    )}" -->([\\s\\S]*?)<!-- teamix-evo:managed:end id="${escapeRegExp(
+      id
+    )}" -->`
+  );
+  const m = content.match(re);
+  if (!m) return null;
+  return m[1].replace(/^\n/, "").replace(/\n$/, "");
+}
 async function renderSkillContent(sourceAbs, skill, data) {
   if (skill.template ?? sourceAbs.endsWith(".hbs")) {
     const tpl = await loadTemplateFile(sourceAbs);
@@ -601,17 +647,16 @@ async function syncSkillsToIdes(options) {
         const rel2 = path7.relative(sourceDir, src);
         const targetFile = path7.join(targetDir, rel2);
         const sourceContent = await fs5.readFile(src, "utf-8");
-        const existing = await readFileOrNull(targetFile);
-        if (existing !== null && existing !== sourceContent) {
-          logger.warn(
-            `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${src} (not the mirror) and re-run \`teamix-evo skills sync\`.`
-          );
-        }
-        await writeFileSafe(targetFile, sourceContent);
+        const writtenContent = await writeMirrorContent(
+          targetFile,
+          sourceContent,
+          skill.managedRegions,
+          src
+        );
         out.push({
           id: rel2 === "SKILL.md" ? skill.id : `${skill.id}:${rel2}`,
           target: targetFile,
-          hash: computeHash(sourceContent),
+          hash: computeHash(writtenContent),
           strategy: skill.updateStrategy,
           ide,
           scope
@@ -650,6 +695,29 @@ async function removeSkillFiles(records) {
   return removed;
 }
 
+// src/utils/mcp.ts
+import * as path8 from "path";
+var MCP_JSON_CONTENT = {
+  mcpServers: {
+    "teamix-evo": {
+      command: "npx",
+      args: ["-y", "@teamix-evo/mcp"]
+    }
+  }
+};
+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: ${err.message}`);
+    return "failed";
+  }
+}
+
 // src/core/skills-add.ts
 var DEFAULT_SKILLS_PACKAGE = "@teamix-evo/skills";
 var FLAT_VARIANT = "_flat";
@@ -661,9 +729,6 @@ async function runSkillsAdd(options) {
   await ensureTeamixDir(projectRoot);
   const existingConfig = await readProjectConfig(projectRoot);
   const existingSkillsCfg = existingConfig?.packages?.skills;
-  if (!isIncremental && existingSkillsCfg) {
-    return { status: "already-added" };
-  }
   const ides = options.ides && options.ides.length > 0 ? [...options.ides] : existingSkillsCfg?.ides ? [...existingSkillsCfg.ides] : [];
   const scope = options.scope ?? existingSkillsCfg?.scope;
   if (ides.length === 0) {
@@ -701,8 +766,7 @@ async function runSkillsAdd(options) {
     skippedSkillIds = requestedNames.filter((n) => existingSkillIds.has(n));
     onlyIds = requestedNames.filter((n) => !existingSkillIds.has(n));
   } else {
-    skippedSkillIds = [];
-    onlyIds = manifest.skills.filter((s) => {
+    const candidateIds = manifest.skills.filter((s) => {
       if (!s.variant) return true;
       if (!currentTokensVariant) {
         logger.debug(
@@ -718,6 +782,11 @@ async function runSkillsAdd(options) {
       }
       return true;
     }).map((s) => s.id);
+    skippedSkillIds = candidateIds.filter((id) => existingSkillIds.has(id));
+    onlyIds = candidateIds.filter((id) => !existingSkillIds.has(id));
+  }
+  if (!isIncremental && existingSkillsCfg && onlyIds.length === 0) {
+    return { status: "already-added" };
   }
   if (isIncremental && onlyIds.length === 0) {
     return {
@@ -794,6 +863,7 @@ async function runSkillsAdd(options) {
     };
   }
   await writeSkillsLock(projectRoot, lock);
+  await ensureMcpJson(projectRoot);
   return {
     status: "installed",
     packageName,
@@ -831,6 +901,16 @@ async function runTokensInit(options) {
   const { projectRoot, variant, ide } = options;
   const packageName = options.packageName ?? DEFAULT_TOKENS_PACKAGE;
   await ensureTeamixDir(projectRoot);
+  const packageRoot = options.packageRoot ?? resolveTokensPackageRoot(packageName);
+  const catalog = await loadTokensPackageManifest(packageRoot);
+  const variantEntry = getVariantEntry(catalog, variant);
+  if (!variantEntry) {
+    const known = catalog.variants.map((v) => v.name).join(", ");
+    throw new Error(
+      `Unknown variant "${variant}". Available variants: ${known || "(none)"}.
+Run \`teamix-evo tokens list-variants\` to see all options.`
+    );
+  }
   const existingConfig = await readProjectConfig(projectRoot);
   if (existingConfig?.packages?.tokens) {
     const existingVariant = existingConfig.packages.tokens.variant;
@@ -843,21 +923,12 @@ async function runTokensInit(options) {
       requestedVariant: variant
     };
   }
-  const packageRoot = options.packageRoot ?? resolveTokensPackageRoot(packageName);
-  const catalog = await loadTokensPackageManifest(packageRoot);
-  const variantEntry = getVariantEntry(catalog, variant);
-  if (!variantEntry) {
-    const known = catalog.variants.map((v) => v.name).join(", ");
-    throw new Error(
-      `Tokens variant not found: "${variant}". Known variants: ${known || "(none)"}. Hint: run "teamix-evo tokens list-variants" to see all.`
-    );
-  }
   const installed = [];
   for (const fileRel of variantEntry.files) {
     const result = await installVariantFile(fileRel, packageRoot, projectRoot);
     if (result) installed.push(result);
   }
-  const overridesAbs = path8.join(
+  const overridesAbs = path9.join(
     projectRoot,
     CONSUMER_TOKENS_DIR,
     CONSUMER_OVERRIDES_FILE
@@ -868,7 +939,7 @@ async function runTokensInit(options) {
   const overridesContent = await fs6.readFile(overridesAbs, "utf-8");
   installed.push({
     id: `tokens:${CONSUMER_OVERRIDES_FILE}`,
-    target: path8.posix.join(CONSUMER_TOKENS_DIR, CONSUMER_OVERRIDES_FILE),
+    target: path9.posix.join(CONSUMER_TOKENS_DIR, CONSUMER_OVERRIDES_FILE),
     hash: computeHash(overridesContent),
     strategy: "frozen"
   });
@@ -885,7 +956,7 @@ async function runTokensInit(options) {
     installedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   await writeFileSafe(
-    path8.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
+    path9.join(projectRoot, ".teamix-evo", "tokens-lock.json"),
     JSON.stringify(lock, null, 2) + "\n"
   );
   const config = {
@@ -917,6 +988,7 @@ async function runTokensInit(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,
@@ -1003,14 +1075,14 @@ async function tryAutoInstallVariantSkills(args) {
   }
 }
 async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
-  const sourceAbs = path8.join(packageRoot, fileRelToPackage);
-  const base = path8.basename(fileRelToPackage);
+  const sourceAbs = path9.join(packageRoot, fileRelToPackage);
+  const base = path9.basename(fileRelToPackage);
   if (base === "theme.css") {
-    const targetRel = path8.posix.join(
+    const targetRel = path9.posix.join(
       CONSUMER_TOKENS_DIR,
       CONSUMER_THEME_FILE
     );
-    const targetAbs = path8.join(projectRoot, targetRel);
+    const targetAbs = path9.join(projectRoot, targetRel);
     const content = await fs6.readFile(sourceAbs, "utf-8");
     await writeFileSafe(targetAbs, content);
     return {
@@ -1021,11 +1093,11 @@ async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
     };
   }
   if (base === "overrides.css" || base === "tokens.overrides.css") {
-    const targetRel = path8.posix.join(
+    const targetRel = path9.posix.join(
       CONSUMER_TOKENS_DIR,
       CONSUMER_OVERRIDES_FILE
     );
-    const targetAbs = path8.join(projectRoot, targetRel);
+    const targetAbs = path9.join(projectRoot, targetRel);
     if (await fileExists(targetAbs)) {
       const existing = await fs6.readFile(targetAbs, "utf-8");
       return {
@@ -1048,7 +1120,7 @@ async function installVariantFile(fileRelToPackage, packageRoot, projectRoot) {
 }
 function resolveTokensPackageRoot(packageName) {
   const pkgJson = require3.resolve(`${packageName}/package.json`);
-  return path8.dirname(pkgJson);
+  return path9.dirname(pkgJson);
 }
 async function listTokenVariants(packageName = DEFAULT_TOKENS_PACKAGE, packageRoot) {
   const root = packageRoot ?? resolveTokensPackageRoot(packageName);
@@ -1067,35 +1139,6 @@ async function listTokenVariants(packageName = DEFAULT_TOKENS_PACKAGE, packageRo
 }
 
 // src/core/ui-init.ts
-import * as fs7 from "fs/promises";
-import { createRequire as createRequire3 } from "module";
-import * as path9 from "path";
-var require4 = createRequire3(import.meta.url);
-async function deployPreferencesCss(projectRoot) {
-  const targetDir = path9.join(projectRoot, "src");
-  const targetPath = path9.join(targetDir, "preferences.css");
-  try {
-    await fs7.access(targetPath);
-    logger.debug(`preferences.css already exists at ${targetPath}, skipping`);
-    return "skipped";
-  } catch {
-  }
-  let sourcePath;
-  try {
-    const uiPkgJson = require4.resolve("@teamix-evo/ui/package.json");
-    sourcePath = path9.join(path9.dirname(uiPkgJson), "src", "preferences.css");
-    await fs7.access(sourcePath);
-  } catch {
-    logger.debug(
-      "Could not resolve @teamix-evo/ui/src/preferences.css; skipping deploy"
-    );
-    return "source-missing";
-  }
-  await fs7.mkdir(targetDir, { recursive: true });
-  const content = await fs7.readFile(sourcePath, "utf-8");
-  await fs7.writeFile(targetPath, content, "utf-8");
-  return "deployed";
-}
 var DEFAULT_UI_ALIASES = {
   components: "src/components/ui",
   hooks: "src/hooks",
@@ -1139,25 +1182,24 @@ async function runUiInit(options) {
     rsc
   };
   await writeProjectConfig(projectRoot, config);
-  const preferencesCss = await deployPreferencesCss(projectRoot);
+  await ensureMcpJson(projectRoot);
   return {
     status: "installed",
     aliases,
     iconLibrary,
     tsx,
-    rsc,
-    preferencesCss
+    rsc
   };
 }
 
 // src/core/ui-client.ts
 import * as path10 from "path";
-import * as fs8 from "fs/promises";
-import { createRequire as createRequire4 } from "module";
+import * as fs7 from "fs/promises";
+import { createRequire as createRequire3 } from "module";
 import { loadUiPackageManifest } from "@teamix-evo/registry";
-var require5 = createRequire4(import.meta.url);
+var require4 = createRequire3(import.meta.url);
 function resolvePackageRoot2(packageName) {
-  const pkgJsonPath = require5.resolve(`${packageName}/package.json`);
+  const pkgJsonPath = require4.resolve(`${packageName}/package.json`);
   return path10.dirname(pkgJsonPath);
 }
 async function loadUiData(packageName) {
@@ -1167,7 +1209,7 @@ async function loadUiData(packageName) {
   let data = {};
   const dataPath = path10.join(packageRoot, "_data.json");
   try {
-    const raw = await fs8.readFile(dataPath, "utf-8");
+    const raw = await fs7.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
   } catch (err) {
     if (err.code !== "ENOENT") {
@@ -1180,7 +1222,7 @@ async function loadUiData(packageName) {
 
 // src/core/ui-installer.ts
 import * as path11 from "path";
-import * as fs9 from "fs/promises";
+import * as fs8 from "fs/promises";
 import { resolveUiEntryOrder } from "@teamix-evo/registry";
 
 // src/utils/transform-imports.ts
@@ -1254,7 +1296,7 @@ async function installUiEntries(options) {
       }
       const rootForEntry = entryPackageRoot?.get(entry.id) ?? packageRoot;
       const sourceAbs = path11.resolve(rootForEntry, file.source);
-      const raw = await fs9.readFile(sourceAbs, "utf-8");
+      const raw = await fs8.readFile(sourceAbs, "utf-8");
       const transformed = rewriteImports(raw, aliases);
       await writeFileSafe(targetAbs, transformed);
       written++;
@@ -1291,7 +1333,7 @@ async function removeUiFiles(records) {
   const removed = [];
   for (const r of records) {
     try {
-      await fs9.unlink(r.target);
+      await fs8.unlink(r.target);
       removed.push(r.target);
     } catch (err) {
       if (err.code !== "ENOENT") {
@@ -1302,8 +1344,8 @@ async function removeUiFiles(records) {
   const parents = new Set(records.map((r) => path11.dirname(r.target)));
   for (const dir of parents) {
     try {
-      const entries = await fs9.readdir(dir);
-      if (entries.length === 0) await fs9.rmdir(dir);
+      const entries = await fs8.readdir(dir);
+      if (entries.length === 0) await fs8.rmdir(dir);
     } catch {
     }
   }
@@ -1313,7 +1355,7 @@ async function removeUiFiles(records) {
 // src/core/ui-add.ts
 var DEFAULT_UI_PACKAGE = "@teamix-evo/ui";
 async function runUiAdd(options) {
-  const { projectRoot, ids, overwrite } = options;
+  const { projectRoot, ids, overwrite, includeDeprecated } = options;
   const packageName = options.packageName ?? DEFAULT_UI_PACKAGE;
   if (ids.length === 0) {
     throw new Error("At least one entry id must be provided.");
@@ -1326,7 +1368,21 @@ async function runUiAdd(options) {
     );
   }
   const { manifest, packageRoot } = await loadUiData(packageName);
-  const knownIds = new Set(manifest.entries.map((e) => e.id));
+  const archived = manifest.deprecatedEntries ?? [];
+  const archivedIds = new Set(archived.map((e) => e.id));
+  const activeIds = new Set(manifest.entries.map((e) => e.id));
+  const requestedDeprecated = ids.filter((id) => archivedIds.has(id));
+  if (requestedDeprecated.length > 0 && !includeDeprecated) {
+    const list = requestedDeprecated.map((s) => `"${s}"`).join(", ");
+    throw new Error(
+      `Refusing to install deprecated entr${requestedDeprecated.length === 1 ? "y" : "ies"} ${list}. These entries are archived and not part of the active distribution (ADR 0028). Pass \`--include-deprecated\` to override (e.g. for migration tooling).`
+    );
+  }
+  const effectiveManifest = includeDeprecated ? { ...manifest, entries: [...manifest.entries, ...archived] } : manifest;
+  const knownIds = /* @__PURE__ */ new Set([
+    ...activeIds,
+    ...includeDeprecated ? archivedIds : []
+  ]);
   const unknown = ids.filter((id) => !knownIds.has(id));
   if (unknown.length > 0) {
     throw new Error(
@@ -1335,7 +1391,7 @@ async function runUiAdd(options) {
   }
   const result = await installUiEntries({
     projectRoot,
-    manifest,
+    manifest: effectiveManifest,
     packageRoot,
     aliases: uiCfg.aliases,
     requested: ids,
@@ -1383,7 +1439,7 @@ function mergeResources(prior, next) {
 // src/core/ui-list.ts
 var DEFAULT_UI_PACKAGE2 = "@teamix-evo/ui";
 async function runUiList(options) {
-  const { projectRoot, installedOnly } = options;
+  const { projectRoot, installedOnly, includeDeprecated } = options;
   const packageName = options.packageName ?? DEFAULT_UI_PACKAGE2;
   const { manifest } = await loadUiData(packageName);
   const installedManifest = await readInstalledManifest(projectRoot);
@@ -1395,15 +1451,21 @@ async function runUiList(options) {
     const colon = r.id.indexOf(":");
     installedIds.add(colon >= 0 ? r.id.slice(0, colon) : r.id);
   }
-  const entries = manifest.entries.filter((e) => !installedOnly || installedIds.has(e.id)).map((e) => ({
-    id: e.id,
-    type: e.type,
-    description: e.description,
-    installed: installedIds.has(e.id)
+  const archived = manifest.deprecatedEntries ?? [];
+  const pool = includeDeprecated ? [
+    ...manifest.entries.map((e) => ({ entry: e, deprecated: false })),
+    ...archived.map((e) => ({ entry: e, deprecated: true }))
+  ] : manifest.entries.map((e) => ({ entry: e, deprecated: false }));
+  const entries = pool.filter(({ entry }) => !installedOnly || installedIds.has(entry.id)).map(({ entry, deprecated }) => ({
+    id: entry.id,
+    type: entry.type,
+    description: entry.description,
+    installed: installedIds.has(entry.id),
+    deprecated
   }));
   return {
     packageName,
-    total: manifest.entries.length,
+    total: manifest.entries.length + (includeDeprecated ? archived.length : 0),
     installedCount: installedIds.size,
     entries
   };
@@ -1411,7 +1473,7 @@ async function runUiList(options) {
 
 // src/core/installer.ts
 import * as path12 from "path";
-import * as fs10 from "fs/promises";
+import * as fs9 from "fs/promises";
 async function installResources(options) {
   const { projectRoot, manifest, data, variantDir, packageRoot } = options;
   const installedResources = [];
@@ -1454,7 +1516,7 @@ async function installSingleResource(resource, projectRoot, data, variantDir, pa
     const templateContent = await loadTemplateFile(sourcePath);
     content = renderTemplate(templateContent, data);
   } else {
-    content = await fs10.readFile(sourcePath, "utf-8");
+    content = await fs9.readFile(sourcePath, "utf-8");
   }
   await writeFileSafe(targetPath, content);
   const hash = computeHash(content);
@@ -1487,7 +1549,7 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
       const templateContent = await loadTemplateFile(entry);
       content = renderTemplate(templateContent, data);
     } else {
-      content = await fs10.readFile(entry, "utf-8");
+      content = await fs9.readFile(entry, "utf-8");
     }
     await writeFileSafe(targetFile, content);
     const hash = computeHash(content);
@@ -1505,12 +1567,12 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
 
 // src/core/registry-client.ts
 import * as path13 from "path";
-import * as fs11 from "fs/promises";
-import { createRequire as createRequire5 } from "module";
+import * as fs10 from "fs/promises";
+import { createRequire as createRequire4 } from "module";
 import { loadVariantManifest } from "@teamix-evo/registry";
-var require6 = createRequire5(import.meta.url);
+var require5 = createRequire4(import.meta.url);
 function resolvePackageRoot3(packageName) {
-  const pkgJsonPath = require6.resolve(`${packageName}/package.json`);
+  const pkgJsonPath = require5.resolve(`${packageName}/package.json`);
   return path13.dirname(pkgJsonPath);
 }
 async function loadVariantData(packageName, variant) {
@@ -1522,7 +1584,7 @@ async function loadVariantData(packageName, variant) {
   let data = {};
   const dataPath = path13.join(variantDir, "_data.json");
   try {
-    const raw = await fs11.readFile(dataPath, "utf-8");
+    const raw = await fs10.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
   } catch (err) {
     if (err.code !== "ENOENT") {