teamix-evo 0.15.6 → 0.17.0

package/README.md

@@ -172,6 +172,7 @@ TEAMIX_DEBUG=1 teamix-evo tokens init opentrek
 | `teamix-evo init [-y] [--dry-run] [--variant <n>]`    | 普通版接入：检测冲突 → wizard → 静默落地（已有 npm 工程入口）                                                           |
 | `teamix-evo update [--dry-run] [--cwd <dir>]`         | 一键升级已装资源（tokens + skills，ADR 0003 三态 + ADR 0035 短路）                                                      |
 | `teamix-evo migrate [--cwd <dir>] [--json]`           | shadcn 项目迁移前置检查（AI skill 引导实际迁移）                                                                        |
+| `teamix-evo graft [--variant <v>] [--json] [--cwd <dir>]` | 叠加 Teamix Evo 到传统组件库项目（双栈共存，ADR 0047）                                                              |
 | `teamix-evo restore [ts] [--list] [-y]`               | 回滚 `.teamix-evo/` 到指定 snapshot（ADR 0019 §2 — 自身可逆）                                                           |
 | `teamix-evo switch <new-variant> [--apply] [-y]`      | variant 切换：默认 dry-run 展示 file-level diff，--apply 才真写（ADR 0019 §D3）                                         |
 | `teamix-evo tokens init <variant>`                    | 初始化 tokens                                                                                                           |

package/dist/core/index.d.ts

@@ -656,10 +656,14 @@ interface ProjectStateReport {
     hasPackageJson: boolean;
     hasComponentsJson: boolean;
     significantEntries: string[];
+    /** Legacy component library detected — only populated when state is 'other'. */
+    legacyLib?: string;
+    /** Build tool detected — only populated when state is 'other'. */
+    buildTool?: string;
 }
 declare function detectProjectState(cwd: string): Promise<ProjectStateReport>;
 
-type LifecycleCommand = 'init' | 'migrate' | 'update';
+type LifecycleCommand = 'init' | 'migrate' | 'update' | 'graft';
 declare function assertCommandPrecondition(command: LifecycleCommand, state: ProjectState): void;
 
 /**
@@ -729,7 +733,7 @@ interface FileChange {
  * true, it skips conflict detection entirely.
  */
 
-type ProjectInitStepName = 'tokens' | 'skills' | 'agents-md' | 'ui-init' | 'ui-add' | 'biz-ui-add' | 'meta-landing' | 'lint' | 'gitignore';
+type ProjectInitStepName = 'tokens' | 'html-theme' | 'skills' | 'agents-md' | 'ui-init' | 'ui-add' | 'biz-ui-add' | 'meta-landing' | 'lint' | 'gitignore';
 type ProjectInitStepStatus = 'ok' | 'skip' | 'fail' | 'planned';
 interface ProjectInitStep {
     name: ProjectInitStepName;
@@ -774,6 +778,42 @@ interface RunProjectInitResult {
 }
 declare function runProjectInit(options: RunProjectInitOptions): Promise<RunProjectInitResult>;
 
+/**
+ * Programmatic orchestrator for `teamix-evo graft` (ADR 0047).
+ *
+ * Installs the teamix-evo AICoding stack (tokens, skills, UI, biz-ui,
+ * AGENTS.md, config) into an existing project that uses a legacy component
+ * library (Fusion / Antd / Element). Designed to be called by the
+ * `graft.md` skill after AI-driven steps (Tailwind install, PostCSS merge,
+ * CSS entry creation) are complete.
+ *
+ * Does NOT create CSS entry files or modify PostCSS config — those are
+ * handled by the skill (AI judgement required).
+ */
+
+type GraftInitStepName = 'ensure-teamix-dir' | 'snapshot' | 'tokens' | 'ui-init' | 'ui-add' | 'biz-ui-add' | 'skills' | 'agents-md' | 'agents-md-graft' | 'meta-landing' | 'config-mode' | 'gitignore';
+type GraftInitStepStatus = 'ok' | 'skip' | 'fail';
+interface GraftInitStep {
+    name: GraftInitStepName;
+    status: GraftInitStepStatus;
+    detail?: string;
+}
+interface GraftInitOptions {
+    projectRoot: string;
+    variant: string;
+    legacyLib: string;
+    ide?: string;
+    ides?: SkillIde[];
+    scope?: SkillScope;
+    skipInstall?: boolean;
+    onStep?: (step: GraftInitStep) => void;
+}
+interface GraftInitResult {
+    status: 'success' | 'partial';
+    steps: GraftInitStep[];
+}
+declare function runGraftInit(options: GraftInitOptions): Promise<GraftInitResult>;
+
 interface InstallOptions {
     /** Project root directory */
     projectRoot: string;
@@ -998,4 +1038,4 @@ declare function readInstalledManifest(projectRoot: string): Promise<InstalledMa
  */
 declare function writeInstalledManifest(projectRoot: string, manifest: InstalledManifest): Promise<void>;
 
-export { type ConflictItem, type ConflictKey, type ConflictReport, type ConflictStrategy, DEFAULT_UI_ALIASES, DEFAULT_UI_ICON_LIBRARY, type InstallOptions, type InstallResult, type ListVariantUiEntriesResult, type ListVariantUiResult, type ListVariantsResult, type ProjectInitStep, type ProjectInitStepName, type ProjectInitStepStatus, type ProjectState, type ProjectState$1 as ProjectStateLegacy, type ProjectStateReport, type ProjectStateReport$1 as ProjectStateReportLegacy, type ReinstallToIdesOptions, type ReinstallToIdesResult, type ResumeHint, type RunGenerateAgentsMdOptions, type RunGenerateAgentsMdResult, type RunLintInitOptions, type RunLintInitResult, type RunProjectInitOptions, type RunProjectInitResult, type RunSkillsAddOptions, type RunSkillsAddResult, type RunSkillsInitOptions, type RunSkillsInitResult, type RunSkillsUpdateOptions, type RunSkillsUpdateResult, type RunTokensInitOptions, type RunTokensInitResult, type RunUiAddOptions, type RunUiAddResult, type RunUiInitOptions, type RunUiInitResult, type RunUiListOptions, type RunUiListResult, type RunVariantUiAddOptions, type RunVariantUiAddResult, type SkillInstallOptions, type SkillInstallResult, type SkillUpdateOptions, type SkillUpdateResult, type UiEntryListItem, type UiInstallOptions, type UiInstallResult, type UpdatePlanItem, assertCommandPrecondition, detectConflicts, detectProjectState, detectProjectState$1 as detectProjectStateLegacy, ensureTeamixDir, extractDescriptionParts, getTeamixDir, installResources, installSkills, installUiEntries, listBizUiEntries, listBizUiVariants, listTokenVariants, loadSkillsData, loadUiData, loadVariantData, readInstalledManifest, readProjectConfig, reinstallSkillsToIdes, removeSkillFiles, removeUiFiles, runBizUiAdd, runGenerateAgentsMd, runLintInit, runProjectInit, runSkillsAdd, runSkillsInit, runSkillsUpdate, runTokensInit, runUiAdd, runUiInit, runUiList, updateSkills, writeInstalledManifest, writeProjectConfig };
+export { type ConflictItem, type ConflictKey, type ConflictReport, type ConflictStrategy, DEFAULT_UI_ALIASES, DEFAULT_UI_ICON_LIBRARY, type GraftInitOptions, type GraftInitResult, type GraftInitStep, type GraftInitStepName, type GraftInitStepStatus, type InstallOptions, type InstallResult, type ListVariantUiEntriesResult, type ListVariantUiResult, type ListVariantsResult, type ProjectInitStep, type ProjectInitStepName, type ProjectInitStepStatus, type ProjectState, type ProjectState$1 as ProjectStateLegacy, type ProjectStateReport, type ProjectStateReport$1 as ProjectStateReportLegacy, type ReinstallToIdesOptions, type ReinstallToIdesResult, type ResumeHint, type RunGenerateAgentsMdOptions, type RunGenerateAgentsMdResult, type RunLintInitOptions, type RunLintInitResult, type RunProjectInitOptions, type RunProjectInitResult, type RunSkillsAddOptions, type RunSkillsAddResult, type RunSkillsInitOptions, type RunSkillsInitResult, type RunSkillsUpdateOptions, type RunSkillsUpdateResult, type RunTokensInitOptions, type RunTokensInitResult, type RunUiAddOptions, type RunUiAddResult, type RunUiInitOptions, type RunUiInitResult, type RunUiListOptions, type RunUiListResult, type RunVariantUiAddOptions, type RunVariantUiAddResult, type SkillInstallOptions, type SkillInstallResult, type SkillUpdateOptions, type SkillUpdateResult, type UiEntryListItem, type UiInstallOptions, type UiInstallResult, type UpdatePlanItem, assertCommandPrecondition, detectConflicts, detectProjectState, detectProjectState$1 as detectProjectStateLegacy, ensureTeamixDir, extractDescriptionParts, getTeamixDir, installResources, installSkills, installUiEntries, listBizUiEntries, listBizUiVariants, listTokenVariants, loadSkillsData, loadUiData, loadVariantData, readInstalledManifest, readProjectConfig, reinstallSkillsToIdes, removeSkillFiles, removeUiFiles, runBizUiAdd, runGenerateAgentsMd, runGraftInit, runLintInit, runProjectInit, runSkillsAdd, runSkillsInit, runSkillsUpdate, runTokensInit, runUiAdd, runUiInit, runUiList, updateSkills, writeInstalledManifest, writeProjectConfig };