@teamix-evo/mcp 0.4.0 → 0.4.3

package/dist/data/adr/README.md

@@ -1,7 +1,7 @@
 # Architecture Decision Records
 
 > 本目录沉淀 Teamix Evo 的"为什么这么做"——决策的上下文、选项、取舍与后果。
-> 设计参照 [Michael Nygard. *Documenting Architecture Decisions*. 2011](https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions)。
+> 设计参照 [Michael Nygard. _Documenting Architecture Decisions_. 2011](https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions)。
 
 ## 为什么需要 ADR
 
@@ -13,33 +13,46 @@ ADR 补这一层。每条 ADR 是一份**单决策档案**:在某一时刻、某
 
 ADR 按编号区段对应 [PLAN §12](../../PLAN.md#12-五层模型驱动的演进规划v05) 的抽象层:
 
-| 编号区段 | 抽象层 | 内容 |
-| --- | --- | --- |
-| 0001–0099 | 工程哲学（Philosophy） | 跨工种共享、几乎不变的工程理念 |
+| 编号区段  | 抽象层                               | 内容                                               |
+| --------- | ------------------------------------ | -------------------------------------------------- |
+| 0001–0099 | 工程哲学（Philosophy）               | 跨工种共享、几乎不变的工程理念                     |
 | 0100–0999 | 协议与工具（Foundations + Patterns） | CLI 命令、Schema、组件、Skills、MCP 等具体协议决策 |
-| 1000+ | 业务消费方决策（Scenarios） | 真实业务团队装机后的领域决策 |
+| 1000+     | 业务消费方决策（Scenarios）          | 真实业务团队装机后的领域决策                       |
 
 > **种子 ADR 的特殊处理**:0001–0006 是 P0-1 任务从 PLAN.md §1 / §10 / §11 / 附录 B 反向沉淀的"已发生决策",作为种子条目使用顺序号,不严格按区段分配。从 0007 起按区段约定执行。
 
 ## 当前 ADR 索引
 
-| # | 标题 | 状态 | 日期 |
-| --- | --- | --- | --- |
-| 0001 | [三层对齐(能力/理念/工程)](0001-three-layer-alignment.md) | Accepted | 2026-05-15 |
-| 0002 | [包命名方案](0002-package-naming.md) | Accepted | 2026-05-13 |
-| 0003 | [资源升级三态语义](0003-update-strategy-tri-state.md) | Accepted | 2026-05-13 |
-| 0004 | [CLI 命令结构](0004-cli-command-structure.md) | Accepted | 2026-05-13 |
-| 0005 | [UI 包不分 variant](0005-ui-no-variant.md) | Accepted | 2026-05-14 |
-| 0006 | [UI 升级机制无 baseline](0006-ui-upgrade-no-baseline.md) | Accepted | 2026-05-14 |
-| 0007 | [治理文档放根目录,与 packages/docs/ 分离](0007-governance-docs-at-root.md) | Accepted | 2026-05-17 |
-| 0008 | [ESLint 视觉规则暂为 warn 级,等待 design 补 token](0008-eslint-visual-rules-warn-baseline.md) | Accepted | 2026-05-17 |
-| 0009 | [registry-mcp 作为 AI 协议层的第一个 MCP server](0009-registry-mcp-protocol-layer.md) | Superseded in part by 0011 | 2026-05-17 |
-| 0010 | [design 默认+变体模型(default + variants/ + extends,文件级覆盖)](0010-design-default-and-variants.md) | Proposed | 2026-05-18 |
-| 0011 | [MCP 单包单 bin 多 group + registry-mcp 改名 mcp](0011-mcp-single-package-multi-group.md) | Proposed | 2026-05-18 |
-| 0012 | [ESLint/Stylelint 双包共享 lint-core 内核](0012-lint-shared-core.md) | Proposed | 2026-05-18 |
-| 0013 | [Skills source-mirror 模型(.teamix-evo/skills/ 为源)](0013-skills-source-mirror.md) | Proposed | 2026-05-18 |
-| 0014 | [ui / biz-ui / templates 三层包分层(三包共享变体名空间)](0014-ui-biz-ui-templates-tier.md) | Proposed | 2026-05-18 |
-| 0019 | [已有工程升级 Teamix Evo 流程(语义合并 / 变体迁移 / cva codemod)](0019-project-upgrade-flow.md) | Proposed | 2026-05-21 |
+| #    | 标题                                                                                                                       | 状态                       | 日期       |
+| ---- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------- | ---------- |
+| 0001 | [三层对齐(能力/理念/工程)](0001-three-layer-alignment.md)                                                                  | Superseded by 0036         | 2026-05-15 |
+| 0002 | [包命名方案](0002-package-naming.md)                                                                                       | Accepted                   | 2026-05-13 |
+| 0003 | [资源升级三态语义](0003-update-strategy-tri-state.md)                                                                      | Accepted                   | 2026-05-13 |
+| 0004 | [CLI 命令结构](0004-cli-command-structure.md)                                                                              | Accepted                   | 2026-05-13 |
+| 0005 | [UI 包不分 variant](0005-ui-no-variant.md)                                                                                 | Superseded by 0036         | 2026-05-14 |
+| 0006 | [UI 升级机制无 baseline](0006-ui-upgrade-no-baseline.md)                                                                   | Superseded by 0036         | 2026-05-14 |
+| 0007 | [治理文档放根目录,与 packages/docs/ 分离](0007-governance-docs-at-root.md)                                                 | Accepted                   | 2026-05-17 |
+| 0008 | [ESLint 视觉规则暂为 warn 级,等待 design 补 token](0008-eslint-visual-rules-warn-baseline.md)                              | Accepted                   | 2026-05-17 |
+| 0009 | [registry-mcp 作为 AI 协议层的第一个 MCP server](0009-registry-mcp-protocol-layer.md)                                      | Superseded in part by 0011 | 2026-05-17 |
+| 0010 | [design 默认+变体模型(default + variants/ + extends，文件级覆盖)](0010-design-default-and-variants.md)                     | Superseded by 0036         | 2026-05-18 |
+| 0011 | [MCP 单包单 bin 多 group + registry-mcp 改名 mcp](0011-mcp-single-package-multi-group.md)                                  | Proposed                   | 2026-05-18 |
+| 0012 | [ESLint/Stylelint 双包共享 lint-core 内核](0012-lint-shared-core.md)                                                       | Proposed                   | 2026-05-18 |
+| 0013 | [Skills source-mirror 模型(.teamix-evo/skills/ 为源)](0013-skills-source-mirror.md)                                        | Proposed                   | 2026-05-18 |
+| 0014 | [ui / biz-ui / templates 三层包分层(三包共享变体名空间)](0014-ui-biz-ui-templates-tier.md)                                 | Proposed                   | 2026-05-18 |
+| 0019 | [已有工程升级 Teamix Evo 流程(语义合并 / 变体迁移 / cva codemod)](0019-project-upgrade-flow.md)                            | Proposed                   | 2026-05-21 |
+| 0021 | [语义色 API 统一治理(`tone`/`status`/`variant` 三分 + 字面值对齐 token)](0021-semantic-color-api-unification.md)           | Accepted                   | 2026-05-29 |
+| 0022 | [preferences.css 边界约束(仅装机偏好,禁止组件级 utility / token alias)](0022-preferences-css-boundary.md)                  | Accepted                   | 2026-05-31 |
+| 0025 | [组件 Props 显式声明规范](0025-component-props-explicit-declaration.md)                                                    | Superseded by 0036         | 2026-06-01 |
+| 0026 | [组件级 token 别名创建准则](0026-component-level-token-alias.md)                                                           | Superseded by 0036         | 2026-06-02 |
+| 0027 | [组件视觉属性全轴对齐设计系统基线](0027-component-visual-token-alignment.md)                                               | Superseded by 0036         | 2026-06-02 |
+| 0028 | [UI 组件分类对齐 Ant Design 5.x](0028-ui-component-categorization.md)                                                      | Superseded by 0036         | 2026-06-02 |
+| 0029 | [Input 拆分 + 移除 prefix/suffix/addon 快捷 prop + AutoComplete 内核同源化](0029-input-split-and-prefix-suffix-removal.md) | Superseded by 0036         | 2026-06-02 |
+| 0030 | [uni-manager 变体 design + code skill 落地 + 通用规则反哺 opentrek](0030-skill-uni-manager-uplift.md)                      | Accepted                   | 2026-06-02 |
+| 0031 | [AI Skill 链路解耦 `@teamix-evo/templates` 包（patterns/ 单一默认来源）](0031-skill-templates-decoupling.md)               | Accepted                   | 2026-06-02 |
+| 0036 | [UI 组件库 v2：以 shadcn v4 为基线全量重建](0036-ui-v2-shadcn-baseline-rebuild.md)                                         | Accepted                   | 2026-06-05 |
+| 0037 | [FilterBar v2 重做：组合式架构 + shadcn 三段式子组件](0037-filter-bar-composable-architecture.md)                          | Accepted                   | 2026-06-08 |
+| 0038 | [create 工程根落地 AGENTS.md 作为 skill 触发兜底](0038-create-agents-md-skill-trigger-fallback.md)                         | Accepted                   | 2026-06-11 |
+| 0040 | [组件源码层升级流程（ui / biz-ui staging-driven upgrade）](0040-component-source-layer-upgrade-flow.md)                    | Accepted                   | 2026-06-11 |
 
 ## 写新 ADR 的流程
 
@@ -52,12 +65,12 @@ ADR 按编号区段对应 [PLAN §12](../../PLAN.md#12-五层模型驱动的演
 
 ## 状态值
 
-| 状态 | 含义 |
-| ---- | ---- |
-| Proposed | 草案,等待评审 |
-| Accepted | 已采纳并执行 |
-| Superseded by NNNN | 被另一条 ADR 替代 |
-| Deprecated | 决策不再适用,但无新替代 |
+| 状态               | 含义                    |
+| ------------------ | ----------------------- |
+| Proposed           | 草案,等待评审           |
+| Accepted           | 已采纳并执行            |
+| Superseded by NNNN | 被另一条 ADR 替代       |
+| Deprecated         | 决策不再适用,但无新替代 |
 
 ## 反向约束
 

package/dist/index.js

@@ -88,33 +88,46 @@ function parseFrontmatter(text) {
 
 // src/groups/registry.ts
 var ListComponentsInput = z.object({
-  status: z.enum(["stable", "experimental", "deprecated"]).optional()
+  status: z.enum(["stable", "experimental", "deprecated"]).optional(),
+  /**
+   * Include archived entries from `manifest.deprecatedEntries` (ADR 0028).
+   * Equivalent to `status: "deprecated"` when set alone, but composes with
+   * other filters: e.g. unset status + `includeDeprecated: true` returns
+   * active + deprecated together.
+   */
+  includeDeprecated: z.boolean().optional()
 });
 var GetComponentMetaInput = z.object({
   id: z.string().min(1)
 });
 var FindComponentsInput = z.object({
   query: z.string().min(1),
-  limit: z.number().int().positive().max(100).optional()
+  limit: z.number().int().positive().max(100).optional(),
+  /** Include archived deprecated entries in matches (ADR 0028). */
+  includeDeprecated: z.boolean().optional()
 });
 var TOOLS = [
   {
     name: "list_components",
-    description: "List all UI components in the @teamix-evo/ui registry. Optionally filter by status (stable / experimental / deprecated). Returns id, name, description, status, registryDependencies \u2014 small enough for the model to scan whole.",
+    description: 'List UI components in the @teamix-evo/ui registry. By default excludes archived `deprecatedEntries` (ADR 0028) \u2014 pass `includeDeprecated: true` (or `status: "deprecated"`) to inspect them, e.g. for upgrade audits. Returns id, name, description, status, registryDependencies \u2014 small enough for the model to scan whole.',
     inputSchema: {
       type: "object",
       properties: {
         status: {
           type: "string",
           enum: ["stable", "experimental", "deprecated"],
-          description: "Filter by maturity status."
+          description: "Filter active entries by maturity status. `deprecated` returns the archived `deprecatedEntries` list."
+        },
+        includeDeprecated: {
+          type: "boolean",
+          description: "When true, merge archived `deprecatedEntries` into the result (ADR 0028)."
         }
       }
     }
   },
   {
     name: "get_component_meta",
-    description: "Fetch the full registry entry + parsed meta.md for a single component by id. Returns props schema reference, registryDependencies, npm dependencies, AI generation rules, and the component description.",
+    description: "Fetch the full registry entry + parsed meta.md for a single component by id. Searches both active `entries` and archived `deprecatedEntries`; deprecated hits are flagged via `archived: true` in the payload. Returns props schema reference, registryDependencies, npm dependencies, AI generation rules, and the component description.",
     inputSchema: {
       type: "object",
       properties: {
@@ -128,7 +141,7 @@ var TOOLS = [
   },
   {
     name: "find_components",
-    description: 'Substring match over component id / name / description. Use when you need a component but don\'t know its exact id (e.g. "find a component supporting async search and pagination"). Returns up to `limit` matches (default 10). Note: substring match is a v0.1 implementation; semantic search is planned for v0.7 (see ADR 0009).',
+    description: 'Substring match over component id / name / description. Use when you need a component but don\'t know its exact id (e.g. "find a component supporting async search and pagination"). Excludes archived `deprecatedEntries` by default \u2014 pass `includeDeprecated: true` to widen the search (ADR 0028). Returns up to `limit` matches (default 10). Note: substring match is a v0.1 implementation; semantic search is planned for v0.7 (see ADR 0009).',
     inputSchema: {
       type: "object",
       properties: {
@@ -141,6 +154,10 @@ var TOOLS = [
           minimum: 1,
           maximum: 100,
           description: "Max matches to return (default 10)."
+        },
+        includeDeprecated: {
+          type: "boolean",
+          description: "When true, also search archived `deprecatedEntries` (ADR 0028)."
         }
       },
       required: ["query"]
@@ -160,6 +177,9 @@ function pickListEntry(entry) {
     registryDependencies: entry.registryDependencies ?? []
   };
 }
+function pickArchivedEntry(entry) {
+  return { ...pickListEntry(entry), archived: true };
+}
 function createRegistryGroup(opts = {}) {
   let cache = opts.loaded ?? null;
   function getManifest() {
@@ -174,30 +194,44 @@ function createRegistryGroup(opts = {}) {
       if (name === "list_components") {
         const input = ListComponentsInput.parse(args ?? {});
         const { manifest } = getManifest();
-        const entries = manifest.entries.filter((e) => e.type === "component").filter((e) => input.status ? e.status === input.status : true).map(pickListEntry);
+        const archived = manifest.deprecatedEntries ?? [];
+        if (input.status === "deprecated") {
+          const entries = archived.filter((e) => e.type === "component").map(pickArchivedEntry);
+          return {
+            content: [{ type: "text", text: JSON.stringify(entries, null, 2) }]
+          };
+        }
+        const active = manifest.entries.filter((e) => e.type === "component").filter((e) => input.status ? e.status === input.status : true).map(pickListEntry);
+        const merged = input.includeDeprecated ? [
+          ...active,
+          ...archived.filter((e) => e.type === "component").map(pickArchivedEntry)
+        ] : active;
         return {
-          content: [{ type: "text", text: JSON.stringify(entries, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify(merged, null, 2) }]
         };
       }
       if (name === "get_component_meta") {
         const input = GetComponentMetaInput.parse(args);
         const { manifest, rootDir } = getManifest();
         const entry = manifest.entries.find((e) => e.id === input.id);
-        if (!entry) {
+        const archived = entry ? null : (manifest.deprecatedEntries ?? []).find((e) => e.id === input.id) ?? null;
+        const found = entry ?? archived;
+        if (!found) {
           return {
             content: [
               {
                 type: "text",
-                text: `Component not found: ${input.id}. Use list_components to discover ids.`
+                text: `Component not found: ${input.id}. Use list_components to discover ids (pass includeDeprecated: true to widen the search).`
               }
             ],
             isError: true
           };
         }
-        const meta = loadMeta(entry, rootDir);
+        const meta = loadMeta(found, rootDir);
         const payload = {
-          entry,
-          meta: meta ?? null
+          entry: found,
+          meta: meta ?? null,
+          archived: archived !== null
         };
         return {
           content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
@@ -208,9 +242,23 @@ function createRegistryGroup(opts = {}) {
         const limit = input.limit ?? 10;
         const q = input.query.toLowerCase();
         const { manifest } = getManifest();
-        const matches = manifest.entries.filter((e) => e.type === "component").filter((e) => {
-          return e.id.toLowerCase().includes(q) || e.name.toLowerCase().includes(q) || e.description.toLowerCase().includes(q);
-        }).slice(0, limit).map(pickListEntry);
+        const pool = input.includeDeprecated ? [
+          ...manifest.entries.map((e) => ({ entry: e, archived: false })),
+          ...(manifest.deprecatedEntries ?? []).map((e) => ({
+            entry: e,
+            archived: true
+          }))
+        ] : manifest.entries.map((e) => ({ entry: e, archived: false }));
+        const matches = pool.filter(({ entry }) => entry.type === "component").filter(({ entry, archived: a }) => {
+          if (!input.includeDeprecated && !a && entry.status === "deprecated") {
+            return false;
+          }
+          return true;
+        }).filter(({ entry }) => {
+          return entry.id.toLowerCase().includes(q) || entry.name.toLowerCase().includes(q) || entry.description.toLowerCase().includes(q);
+        }).slice(0, limit).map(
+          ({ entry, archived: a }) => a ? pickArchivedEntry(entry) : pickListEntry(entry)
+        );
         return {
           content: [
             {