teamix-evo 0.13.4 → 0.14.1

package/README.md

@@ -171,6 +171,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 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                                                                                                           |
@@ -200,11 +201,7 @@ TEAMIX_DEBUG=1 teamix-evo tokens init opentrek
 | `teamix-evo blocks add <id...>`                       | 安装营销页区块（保留目录结构）                                                                                          |
 | `teamix-evo blocks list [--installed] [--json]`       | 列出可用/已安装区块                                                                                                     |
 | `teamix-evo blocks upgrade [<id...>]`                 | 升级已安装的区块源码                                                                                                    |
-| `teamix-evo templates list-variants`                  | _(deprecated → blocks)_ 列出 templates 包内提供的页面模板变体                                                           |
-| `teamix-evo templates add <id...> --variant <name>`   | _(deprecated → blocks)_ 安装变体感知页面模板                                                                            |
 | `teamix-evo lint init [-y]`                           | 一键安装 ESLint + Stylelint token-discipline 规则集                                                                     |
-| `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

@@ -1,4 +1,4 @@
-import { InstalledResource, SkillIde, SkillScope, UiAliases, UiEntry, VariantManifest, SkillsPackageManifest, SkillEntry, UiPackageManifest, InstalledManifest, ProjectConfig } from '@teamix-evo/registry';
+import { InstalledResource, SkillIde, SkillScope, UiAliases, UiEntry, VariantManifest, SkillEntry, SkillsPackageManifest, UiPackageManifest, InstalledManifest, ProjectConfig } from '@teamix-evo/registry';
 export { InstalledManifest, InstalledResource, ProjectConfig, SkillIde, SkillScope, TailwindVersion, UiAliases } from '@teamix-evo/registry';
 
 interface RunTokensInitOptions {
@@ -74,7 +74,6 @@ interface ListVariantsResult {
         description?: string;
         linked?: {
             'biz-ui'?: string;
-            templates?: string;
         };
     }>;
 }
@@ -315,8 +314,14 @@ interface RunUiAddResult {
     packageName: string;
     /** Registered ids in install order (deps + requested). */
     orderedIds: string[];
-    /** Number of files written. */
+    /** Number of files written (= created + overwritten). */
     written: number;
+    /** Number of files newly created. */
+    created: number;
+    /** Number of existing files overwritten. */
+    overwritten: number;
+    /** Number of overwritten files that had local modifications. */
+    userModified: number;
     /** Number of files skipped due to frozen + exists. */
     skipped: number;
     /** Aggregate npm dependencies of the installed entries. */
@@ -391,14 +396,15 @@ interface RunVariantUiAddResult {
     variant: string;
     orderedIds: string[];
     written: number;
+    created: number;
+    overwritten: number;
+    userModified: number;
     skipped: number;
     npmDependencies: Record<string, string>;
     resources: InstalledResource[];
 }
 /** `teamix-evo biz-ui add <ids...> --variant <name>`. */
 declare function runBizUiAdd(options: RunVariantUiAddOptions): Promise<RunVariantUiAddResult>;
-/** `teamix-evo templates add <ids...> --variant <name>`. */
-declare function runTemplatesAdd(options: RunVariantUiAddOptions): Promise<RunVariantUiAddResult>;
 interface ListVariantUiResult {
     packageName: string;
     variants: Array<{
@@ -409,7 +415,6 @@ interface ListVariantUiResult {
     }>;
 }
 declare function listBizUiVariants(packageRoot?: string): Promise<ListVariantUiResult>;
-declare function listTemplatesVariants(packageRoot?: string): Promise<ListVariantUiResult>;
 interface ListVariantUiEntriesResult {
     packageName: string;
     variant: string;
@@ -422,7 +427,6 @@ interface ListVariantUiEntriesResult {
     }>;
 }
 declare function listBizUiEntries(variant: string, packageRoot?: string): Promise<ListVariantUiEntriesResult>;
-declare function listTemplatesEntries(variant: string, packageRoot?: string): Promise<ListVariantUiEntriesResult>;
 
 /**
  * Phase 3.E lint conflict strategies (mirrors `init-conflicts.ts`).
@@ -521,9 +525,8 @@ interface RunGenerateAgentsMdOptions {
     /** Tokens / skills variant (e.g. "opentrek"). Used for header context. */
     variant: string;
     /**
-     * Skill ids whose `<projectRoot>/.teamix-evo/skills/<id>/SKILL.md` should be
-     * indexed. Caller is responsible for filtering out global-only skills
-     * (e.g. `teamix-evo-manage`).
+     * Skill ids to index. Caller is responsible for filtering out global-only
+     * skills (e.g. `teamix-evo-manage`).
      */
     skillIds: string[];
     /**
@@ -603,10 +606,10 @@ declare function extractDescriptionParts(fileContent: string): SkillDescriptionP
  * - `teamix-evo-installed`: 已存在 `.teamix-evo/` → 推荐 `teamix-evo update` / 卸载流程
  * - `non-teamix-evo`      : 已有非 teamix-evo 工程 → 走 `teamix-evo init` 普通版接入
  */
-type ProjectState = 'empty' | 'teamix-evo-installed' | 'non-teamix-evo';
-interface ProjectStateReport {
+type ProjectState$1 = 'empty' | 'teamix-evo-installed' | 'non-teamix-evo';
+interface ProjectStateReport$1 {
     /** Decision-tree branch the caller should take. */
-    state: ProjectState;
+    state: ProjectState$1;
     /** Absolute path that was inspected. */
     cwd: string;
     /** Whether `.teamix-evo/` exists at `cwd`. */
@@ -629,8 +632,28 @@ interface ProjectStateReport {
  *                               → `empty`
  * 3. otherwise                  → `non-teamix-evo`
  */
+declare function detectProjectState$1(cwd: string): Promise<ProjectStateReport$1>;
+
+/**
+ * ADR 0046 — Three-command lifecycle model.
+ *
+ * Detection priority:
+ *   .teamix-evo/ → components.json (with shadcn traits) → empty → other
+ */
+type ProjectState = 'empty' | 'shadcn' | 'teamix-evo' | 'other';
+interface ProjectStateReport {
+    state: ProjectState;
+    cwd: string;
+    hasTeamixDir: boolean;
+    hasPackageJson: boolean;
+    hasComponentsJson: boolean;
+    significantEntries: string[];
+}
 declare function detectProjectState(cwd: string): Promise<ProjectStateReport>;
 
+type LifecycleCommand = 'init' | 'migrate' | 'update';
+declare function assertCommandPrecondition(command: LifecycleCommand, state: ProjectState): void;
+
 /**
  * The 8 categories of consumer-side files that `teamix-evo init` may
  * conflict with when running against a non-teamix-evo project.
@@ -698,7 +721,7 @@ interface FileChange {
  * true, it skips conflict detection entirely.
  */
 
-type ProjectInitStepName = 'tokens' | 'skills' | 'agents-md' | 'ui-init' | 'ui-add' | 'biz-ui-add' | 'lint' | 'gitignore';
+type ProjectInitStepName = 'tokens' | 'skills' | 'agents-md' | 'ui-init' | 'ui-add' | 'biz-ui-add' | 'meta-landing' | 'lint' | 'gitignore';
 type ProjectInitStepStatus = 'ok' | 'skip' | 'fail' | 'planned';
 interface ProjectInitStep {
     name: ProjectInitStepName;
@@ -767,19 +790,9 @@ interface InstallResult {
 declare function installResources(options: InstallOptions): Promise<InstallResult>;
 
 /**
- * Source-mirror skills installer (per ADR 0013).
- *
- * Two-stage flow:
- *   1. **writeSkillSources** — render upstream `<packageRoot>/<skill.source>` and
- *      write to `<projectRoot>/.teamix-evo/skills-source/<id>/` (the consumer-side
- *      source of truth, regenerable, in git).
- *   2. **syncSkillsToIdes** — pure byte-for-byte copy from source dir to each
- *      requested IDE mirror path (`.qoder/skills/<id>/`, `.claude/skills/<id>/`).
- *      Mirrors are 100% derived; not subject to managed-region preservation.
- *
- * `installSkills` orchestrates both. `updateSkills` re-renders the source with
- * managed-region preservation against the existing source (NOT the mirrors),
- * then re-syncs.
+ * Skills installer — renders upstream skill sources from the npm package
+ * and writes directly to IDE mirror paths (`.qoder/skills/<id>/`,
+ * `.claude/skills/<id>/`).
  */
 interface SkillInstallOptions {
     /** Project root directory */
@@ -802,28 +815,12 @@ interface SkillInstallResult {
     count: number;
 }
 /**
- * Install (or reinstall) all skills declared in the manifest using the
- * source-mirror flow. Returns InstalledResource records for both source files
- * and IDE mirror files.
+ * Install (or reinstall) all skills declared in the manifest.
+ * Renders from the npm package and writes directly to IDE mirror paths.
  */
 declare function installSkills(options: SkillInstallOptions): Promise<SkillInstallResult>;
 interface SkillUpdateOptions extends SkillInstallOptions {
-    /**
-     * Optional: existing installed records (legacy parameter kept for callers that
-     * still pass it). The refactored updater consults the file-system source under
-     * `.teamix-evo/skills/<id>/` for managed-region preservation, so this is
-     * unused by the new flow. Callers should stop passing it.
-     */
     installed?: InstalledResource[];
-    /**
-     * Optional: limit the update to these skill ids. When provided, skills not
-     * in the set are skipped (no source rewrite, no mirror). Per ADR 0035,
-     * the high-level `runSkillsUpdate` always passes this with the intersection
-     * of `keys(lock.skills)` and the current install scope, ensuring update
-     * never accidentally installs new skills or skills from a mismatched scope.
-     *
-     * Type matches `SkillInstallOptions.onlyIds` (mutable `string[] | undefined`).
-     */
     onlyIds?: string[];
 }
 interface SkillUpdateResult {
@@ -836,49 +833,42 @@ interface SkillUpdateResult {
     };
 }
 /**
- * Update skills with managed-region preservation applied at the SOURCE layer
- * (not the mirrors). After source is rewritten, mirrors are re-synced cleanly.
+ * Update skills with strategy-aware logic (frozen/regenerable/managed) applied
+ * directly to IDE mirror files.
  */
 declare function updateSkills(options: SkillUpdateOptions): Promise<SkillUpdateResult>;
 /**
- * Sync existing skill sources to the requested IDE mirror paths.
- *
- * Used by:
- *   - `skills add` (immediate mirror after source write — handled by installSkills)
- *   - `skills sync` (re-mirror after the user adds an IDE or moves machines)
- *   - `skills update` (re-mirror after source is rewritten)
- *
- * `onlyIds` lets the caller limit which skills are synced.
+ * Re-install skills from the npm package to IDE mirror paths.
+ * Used by `skills sync` to refresh IDE files from upstream.
  */
-interface SkillSyncOptions {
+interface ReinstallToIdesOptions {
     projectRoot: string;
-    /** Skills present in the source dir to mirror (caller derives from lock). */
+    /** Skills to reinstall (caller derives from lock). */
     skills: ReadonlyArray<{
         id: string;
         name: string;
         updateStrategy: SkillEntry['updateStrategy'];
-        /** Managed-region ids for region-aware mirror sync. */
         managedRegions?: readonly string[];
     }>;
+    /** Upstream package data for rendering. */
+    manifest: SkillsPackageManifest;
+    data: Record<string, unknown>;
+    packageRoot: string;
     ides: readonly SkillIde[];
     scope: SkillScope;
-    onlyIds?: string[];
 }
-interface SkillSyncResult {
+interface ReinstallToIdesResult {
     resources: InstalledResource[];
     count: number;
 }
 /**
- * Mirror existing source dirs (`.teamix-evo/skills/<id>/`) to the given IDE
- * paths. Pure byte-for-byte copy — no rendering, no merge.
+ * Reinstall skills from npm package directly to IDE mirrors.
  */
-declare function syncSkillsToIdes(options: SkillSyncOptions): Promise<SkillSyncResult>;
+declare function reinstallSkillsToIdes(options: ReinstallToIdesOptions): Promise<ReinstallToIdesResult>;
 /**
  * Remove all installed skill files. Returns the absolute paths removed.
- * After files are unlinked, walks up the directory tree pruning empty dirs
- * until a non-empty ancestor is reached (#33).
  */
-declare function removeSkillFiles(records: InstalledResource[]): Promise<string[]>;
+declare function removeSkillFiles(records: InstalledResource[], projectRoot: string): Promise<string[]>;
 
 interface UiInstallOptions {
     /** Project root directory */
@@ -890,7 +880,7 @@ interface UiInstallOptions {
     /**
      * Optional per-entry package root override. When set, entries in the map
      * resolve their `file.source` against the mapped root instead of `packageRoot`.
-     * Used by variant-aware packages (biz-ui / templates) that pull in
+     * Used by variant-aware packages (biz-ui) that pull in
      * @teamix-evo/ui transitive deps — each entry resolves from its source package.
      */
     entryPackageRoot?: Map<string, string>;
@@ -902,6 +892,8 @@ interface UiInstallOptions {
     skipExisting?: boolean;
     /** When false, preserve directory structure in import paths (skip flattenRestPath). Defaults to true. */
     flatten?: boolean;
+    /** Prior manifest resources for the same package — used to detect user-modified files before overwrite. */
+    priorResources?: InstalledResource[];
 }
 interface UiInstallResult {
     /** Ordered list of entry ids that were processed (deps + requested) */
@@ -910,8 +902,14 @@ interface UiInstallResult {
     resources: InstalledResource[];
     /** Aggregate npm dependencies across the installed entries */
     npmDependencies: Record<string, string>;
-    /** Number of files written */
+    /** Number of files written (= created + overwritten, kept for backwards compat) */
     written: number;
+    /** Number of files newly created (target did not exist) */
+    created: number;
+    /** Number of existing files overwritten */
+    overwritten: number;
+    /** Number of overwritten files that had local modifications vs manifest hash */
+    userModified: number;
     /** Number of files skipped because they already exist (frozen) */
     skipped: number;
 }
@@ -923,7 +921,7 @@ declare function installUiEntries(options: UiInstallOptions): Promise<UiInstallR
 /**
  * Remove all installed ui resource files and prune empty parent directories.
  */
-declare function removeUiFiles(records: InstalledResource[]): Promise<string[]>;
+declare function removeUiFiles(records: InstalledResource[], projectRoot: string): Promise<string[]>;
 
 /**
  * Load the variant manifest and _data.json for template rendering.
@@ -992,4 +990,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 ProjectStateReport, 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 SkillSyncOptions, type SkillSyncResult, type SkillUpdateOptions, type SkillUpdateResult, type UiEntryListItem, type UiInstallOptions, type UiInstallResult, type UpdatePlanItem, detectConflicts, detectProjectState, ensureTeamixDir, extractDescriptionParts, getTeamixDir, installResources, installSkills, installUiEntries, listBizUiEntries, listBizUiVariants, listTemplatesEntries, listTemplatesVariants, listTokenVariants, loadSkillsData, loadUiData, loadVariantData, readInstalledManifest, readProjectConfig, removeSkillFiles, removeUiFiles, runBizUiAdd, runGenerateAgentsMd, runLintInit, runProjectInit, runSkillsAdd, runSkillsInit, runSkillsUpdate, runTemplatesAdd, runTokensInit, runUiAdd, runUiInit, runUiList, syncSkillsToIdes, updateSkills, writeInstalledManifest, writeProjectConfig };
+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 };