teamix-evo 0.14.0 → 0.14.2

package/dist/core/index.d.ts

@@ -314,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. */
@@ -390,6 +396,9 @@ interface RunVariantUiAddResult {
     variant: string;
     orderedIds: string[];
     written: number;
+    created: number;
+    overwritten: number;
+    userModified: number;
     skipped: number;
     npmDependencies: Record<string, string>;
     resources: InstalledResource[];
@@ -500,9 +509,14 @@ declare function runLintInit(options: RunLintInitOptions): Promise<RunLintInitRe
  * skill activation conditions even when the user prompt does not directly
  * hit the description-based trigger.
  *
+ * Includes both project-scope content skills AND global-scope lifecycle skills
+ * (e.g. `teamix-evo-manage`): manage triggers are rendered into the project
+ * AGENTS.md so team members who clone the repo see the lifecycle entry points
+ * even before installing the global skill themselves. A "全局技能" note guides
+ * the AI to check availability and prompt installation when needed (ADR 0033).
+ *
  * Out of scope (per ADR 0038):
  * - Does NOT copy skill body / rules / patterns — those stay in the skill.
- * - Does NOT include `teamix-evo-manage` (entry skill, global scope, ADR 0033).
  *
  * Lifted from `create-teamix-evo` (v0.5) into `teamix-evo/core` so both
  * `npm create teamix-evo` (scaffold path) and `teamix-evo init` (existing-
@@ -515,11 +529,14 @@ interface RunGenerateAgentsMdOptions {
     projectRoot: string;
     /** Tokens / skills variant (e.g. "opentrek"). Used for header context. */
     variant: string;
+    /** Project-scope skill ids to index. */
+    skillIds: string[];
     /**
-     * Skill ids to index. Caller is responsible for filtering out global-only
-     * skills (e.g. `teamix-evo-manage`).
+     * Global-scope skill ids to include alongside project skills. Rendered with
+     * a "全局技能" installation note. TRIGGER / SKIP text is read from the
+     * global IDE mirror path at generation time.
      */
-    skillIds: string[];
+    globalSkillIds?: string[];
     /**
      * Reconciliation mode (Phase 2.B):
      *   - `'overwrite'` (default): always rewrite the full file. Pre-existing
@@ -883,6 +900,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) */
@@ -891,8 +910,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;
 }

package/dist/core/index.js

@@ -165,12 +165,40 @@ async function readInstalledManifest(projectRoot) {
     );
   }
   const result = validateInstalled(data);
-  if (!result.success) {
-    throw new Error(
-      `Invalid manifest.json schema: ${result.error}. Fix the file manually or remove it to start fresh.`
+  if (result.success) {
+    return result.data;
+  }
+  const migrated = migrateManifest(data);
+  const retryResult = validateInstalled(migrated);
+  if (retryResult.success) {
+    logger.warn(
+      "Migrated legacy manifest.json \u2014 will be overwritten on next install."
     );
+    return retryResult.data;
   }
-  return result.data;
+  throw new Error(
+    `Invalid manifest.json schema: ${result.error}. Fix the file manually or remove it to start fresh.`
+  );
+}
+function migrateManifest(data) {
+  if (typeof data !== "object" || data === null) return data;
+  const obj = data;
+  if (!("schemaVersion" in obj)) obj.schemaVersion = 1;
+  if (!Array.isArray(obj.installed)) obj.installed = [];
+  for (const pkg of obj.installed) {
+    if (typeof pkg !== "object" || pkg === null) continue;
+    if (!pkg.variant) pkg.variant = "_flat";
+    if (!pkg.installedAt) pkg.installedAt = "";
+    if (!pkg.version) pkg.version = "0.0.0";
+    if (Array.isArray(pkg.resources)) {
+      for (const res of pkg.resources) {
+        if (typeof res !== "object" || res === null) continue;
+        if (!res.hash) res.hash = "sha256:legacy-unknown";
+        if (!res.strategy) res.strategy = "frozen";
+      }
+    }
+  }
+  return obj;
 }
 async function writeInstalledManifest(projectRoot, manifest) {
   const manifestPath = path2.join(projectRoot, TEAMIX_DIR, MANIFEST_FILE);
@@ -948,9 +976,15 @@ function partitionByVersion(ids, manifest, existing) {
       onlyIds.push(name);
       continue;
     }
-    const installedVer = existing.lock?.skills?.[name]?.version;
+    const installedVer = existing.lock?.skills?.[name]?.version ?? existing.pkg?.version;
     const latestVer = manifestById.get(name)?.version;
-    if (installedVer && latestVer && compareSemver(installedVer, latestVer) < 0) {
+    if (!installedVer || !latestVer) {
+      if (latestVer) {
+        outdatedSkills.push({ id: name, installed: "0.0.0", latest: latestVer });
+      } else {
+        skippedSkillIds.push(name);
+      }
+    } else if (compareSemver(installedVer, latestVer) < 0) {
       outdatedSkills.push({
         id: name,
         installed: installedVer,
@@ -1429,18 +1463,24 @@ import { hasManagedRegion as hasManagedRegion2, replaceManagedRegion as replaceM
 var AGENTS_MD_MANAGED_ID = "teamix-evo-skills";
 async function runGenerateAgentsMd(options) {
   const { projectRoot, variant, skillIds } = options;
+  const globalSkillIds = options.globalSkillIds ?? [];
   const mode = options.mode ?? "overwrite";
   const config = await readProjectConfig(projectRoot);
   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(
+  const skillScopeMap = /* @__PURE__ */ new Map();
+  for (const id of skillIds) skillScopeMap.set(id, scope);
+  for (const id of globalSkillIds) skillScopeMap.set(id, "global");
+  const allSkillIds = [...skillIds, ...globalSkillIds];
+  const ordered = allSkillIds.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);
+    const skillScope = skillScopeMap.get(id) ?? scope;
+    const { section, missing } = await renderSkillSection(projectRoot, id, ides, skillScope);
     sections.push(section);
     if (missing) missingSkillIds.push(id);
   }
@@ -1524,6 +1564,12 @@ async function renderSkillSection(projectRoot, skillId, ides, scope) {
   if (parts?.coordinates) {
     lines.push(`- **Coordinates with**: ${parts.coordinates}`);
   }
+  if (scope === "global") {
+    lines.push("");
+    lines.push(
+      "> **\u5168\u5C40\u6280\u80FD** \u2014 \u5B89\u88C5\u5728\u5168\u5C40\u800C\u975E\u9879\u76EE\u5185\uFF0C\u4E0D\u968F\u4EE3\u7801\u4ED3\u5E93\u5206\u53D1\u3002AI \u89E6\u53D1\u65F6\u5E94\u5148\u786E\u8BA4\u672C\u6280\u80FD\u53EF\u7528\uFF1B\u82E5\u4E0D\u53EF\u7528\uFF0C\u5F15\u5BFC\u7528\u6237\u6267\u884C\u5168\u5C40\u5B89\u88C5\u3002"
+    );
+  }
   return { section: lines.join("\n"), missing };
 }
 function renderAgentsMd(args) {
@@ -1669,13 +1715,34 @@ async function runSkillsUpdate(options) {
   }
   const ides = skillsCfg.ides ?? ["qoder", "claude"];
   const scope = skillsCfg.scope ?? "project";
-  const existingLock = await readSkillsLock(projectRoot);
+  let existingLock = await readSkillsLock(projectRoot);
   if (!existingLock || Object.keys(existingLock.skills).length === 0) {
-    return { status: "no-skills" };
+    const installedManifest2 = await readInstalledManifest(projectRoot);
+    const pkg = installedManifest2?.installed.find(
+      (p) => p.package === packageName
+    );
+    if (!pkg || pkg.resources.length === 0) {
+      return { status: "no-skills" };
+    }
+    const derivedSkills = {};
+    for (const r of pkg.resources) {
+      const skillId = r.id.split(":")[0] ?? r.id;
+      if (!derivedSkills[skillId]) {
+        derivedSkills[skillId] = {
+          version: pkg.version,
+          from: packageName,
+          installedAt: "",
+          scope,
+          mirroredTo: []
+        };
+      }
+    }
+    existingLock = { schemaVersion: 1, skills: derivedSkills };
   }
+  const activeLock = existingLock;
   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 lockIds = Object.keys(activeLock.skills);
   const requestedSet = requestedNames ? new Set(requestedNames) : null;
   if (requestedSet) {
     const unknown = requestedNames.filter(
@@ -1712,7 +1779,7 @@ async function runSkillsUpdate(options) {
     targetIds.push(id);
   }
   const allSame = targetIds.every((id) => {
-    const lockVer = existingLock.skills[id].version;
+    const lockVer = activeLock.skills[id].version;
     const manVer = manifestById.get(id).version;
     return lockVer === manVer;
   });
@@ -1726,7 +1793,7 @@ async function runSkillsUpdate(options) {
   }
   if (dryRun) {
     const plan = targetIds.map((id) => {
-      const lockVer = existingLock.skills[id].version;
+      const lockVer = activeLock.skills[id].version;
       const entry2 = manifestById.get(id);
       const sameVersion = lockVer === entry2.version;
       return {
@@ -1798,7 +1865,7 @@ async function runSkillsUpdate(options) {
   await writeInstalledManifest(projectRoot, installedManifest);
   const lock = {
     schemaVersion: 1,
-    skills: { ...existingLock.skills }
+    skills: { ...activeLock.skills }
   };
   for (const id of targetIds) {
     const skillDef = manifestById.get(id);
@@ -1818,10 +1885,12 @@ async function runSkillsUpdate(options) {
       const variant = await readTokensVariant(projectRoot);
       if (variant) {
         const projectSkillIds = Object.entries(lock.skills).filter(([, v]) => v.scope === "project").map(([id]) => id);
+        const globalSkillIds = Object.entries(lock.skills).filter(([, v]) => v.scope === "global").map(([id]) => id);
         await runGenerateAgentsMd({
           projectRoot,
           variant,
           skillIds: projectSkillIds,
+          globalSkillIds,
           mode: "merge-managed"
         });
       }
@@ -1911,6 +1980,10 @@ async function loadUiData(packageName) {
   const packageRoot = resolvePackageRoot2(packageName);
   logger.debug(`Resolved ui package root: ${packageRoot}`);
   const manifest = await loadUiPackageManifest(packageRoot);
+  const pkgJson = JSON.parse(
+    await fs9.readFile(path10.join(packageRoot, "package.json"), "utf-8")
+  );
+  manifest.version = pkgJson.version;
   let data = {};
   const dataPath = path10.join(packageRoot, "_data.json");
   try {
@@ -1984,8 +2057,14 @@ async function installUiEntries(options) {
   const idToEntry = new Map(manifest.entries.map((e) => [e.id, e]));
   const resources = [];
   const npmDeps = {};
-  let written = 0;
+  let created = 0;
+  let overwritten = 0;
+  let userModified = 0;
   let skipped = 0;
+  const { priorResources } = options;
+  const priorByTarget = new Map(
+    (priorResources ?? []).map((r) => [r.target, r])
+  );
   for (const id of orderedIds) {
     const entry = idToEntry.get(id);
     if (!entry) continue;
@@ -2019,11 +2098,25 @@ async function installUiEntries(options) {
           });
           continue;
         }
+        const relPath = path11.relative(projectRoot, targetAbs);
+        const prior = priorByTarget.get(relPath);
+        if (prior && prior.hash !== "sha256:legacy-unknown") {
+          const onDiskHash = computeHash(current);
+          if (onDiskHash !== prior.hash) {
+            logger.warn(
+              `  \u26A0 ${relPath} has local modifications (backed up)`
+            );
+            userModified++;
+          }
+        }
         await backupFile(targetAbs, projectRoot);
+        overwritten++;
+        logger.info(`  overwrite: ${rel(projectRoot, targetAbs)}`);
+      } else {
+        created++;
+        logger.info(`  create: ${rel(projectRoot, targetAbs)}`);
       }
       await writeFileSafe(targetAbs, transformed);
-      written++;
-      logger.info(`  write: ${rel(projectRoot, targetAbs)}`);
       resources.push({
         id: `${entry.id}:${file.targetName}`,
         target: path11.relative(projectRoot, targetAbs),
@@ -2036,7 +2129,10 @@ async function installUiEntries(options) {
     orderedIds,
     resources,
     npmDependencies: npmDeps,
-    written,
+    written: created + overwritten,
+    created,
+    overwritten,
+    userModified,
     skipped
   };
 }
@@ -2115,17 +2211,22 @@ async function runUiAdd(options) {
       `Unknown entry id(s): ${unknown.map((s) => `"${s}"`).join(", ")}. Run \`teamix-evo ui list\` to see options.`
     );
   }
+  const existingManifest = await readInstalledManifest(
+    projectRoot
+  ) ?? { schemaVersion: 1, installed: [] };
+  const priorPkg = existingManifest.installed.find(
+    (p) => p.package === packageName
+  );
   const result = await installUiEntries({
     projectRoot,
     manifest: effectiveManifest,
     packageRoot,
     aliases: uiCfg.aliases,
     requested: ids,
-    skipExisting: !overwrite
+    skipExisting: !overwrite,
+    priorResources: priorPkg?.resources
   });
-  const installed = await readInstalledManifest(
-    projectRoot
-  ) ?? { schemaVersion: 1, installed: [] };
+  const installed = existingManifest;
   const idx = installed.installed.findIndex((p) => p.package === packageName);
   const prior = idx >= 0 ? installed.installed[idx] : null;
   const mergedResources = mergeResources(
@@ -2150,6 +2251,9 @@ async function runUiAdd(options) {
     packageName,
     orderedIds: result.orderedIds,
     written: result.written,
+    created: result.created,
+    overwritten: result.overwritten,
+    userModified: result.userModified,
     skipped: result.skipped,
     npmDependencies: result.npmDependencies,
     resources: result.resources
@@ -2199,6 +2303,7 @@ async function runUiList(options) {
 
 // src/core/variant-ui-add.ts
 import * as path12 from "path";
+import * as fs11 from "fs/promises";
 import { createRequire as createRequire4 } from "module";
 import {
   loadUiPackageManifest as loadUiPackageManifest2,
@@ -2233,6 +2338,10 @@ async function runVariantUiAdd(packageName, options) {
   }
   const variantDir = path12.join(packageRoot, "variants", variant);
   const variantManifest = await loadVariantUiPackageManifest(variantDir);
+  const pkgJson = JSON.parse(
+    await fs11.readFile(path12.join(packageRoot, "package.json"), "utf-8")
+  );
+  const packageVersion = pkgJson.version;
   const knownIds = new Set(variantManifest.entries.map((e) => e.id));
   const unknown = ids.filter((id) => !knownIds.has(id));
   if (unknown.length > 0) {
@@ -2256,28 +2365,27 @@ async function runVariantUiAdd(packageName, options) {
   const adaptedManifest = {
     schemaVersion: 1,
     package: "ui",
-    version: variantManifest.version,
+    version: packageVersion,
     engines: variantManifest.engines,
     entries: mergedEntries
   };
+  const installed = await readInstalledManifest(
+    projectRoot
+  ) ?? { schemaVersion: 1, installed: [] };
+  const idx = installed.installed.findIndex(
+    (p) => p.package === fullPackageName && p.variant === variant
+  );
+  const prior = idx >= 0 ? installed.installed[idx] : null;
   const result = await installUiEntries({
     projectRoot,
     manifest: adaptedManifest,
     packageRoot: variantDir,
-    // default for variant entries
     entryPackageRoot,
-    // ui entries resolve from uiPackageRoot
     aliases: uiCfg.aliases,
     requested: ids,
-    skipExisting: !overwrite
+    skipExisting: !overwrite,
+    priorResources: prior?.resources
   });
-  const installed = await readInstalledManifest(
-    projectRoot
-  ) ?? { schemaVersion: 1, installed: [] };
-  const idx = installed.installed.findIndex(
-    (p) => p.package === fullPackageName && p.variant === variant
-  );
-  const prior = idx >= 0 ? installed.installed[idx] : null;
   const mergedResources = mergeResources2(
     prior?.resources ?? [],
     result.resources
@@ -2285,7 +2393,7 @@ async function runVariantUiAdd(packageName, options) {
   const entry = {
     package: fullPackageName,
     variant,
-    version: variantManifest.version,
+    version: packageVersion,
     installedAt: (/* @__PURE__ */ new Date()).toISOString(),
     resources: mergedResources
   };
@@ -2297,6 +2405,9 @@ async function runVariantUiAdd(packageName, options) {
     variant,
     orderedIds: result.orderedIds,
     written: result.written,
+    created: result.created,
+    overwritten: result.overwritten,
+    userModified: result.userModified,
     skipped: result.skipped,
     npmDependencies: result.npmDependencies,
     resources: result.resources
@@ -2358,7 +2469,7 @@ async function listBizUiEntries(variant, packageRoot) {
 
 // src/core/lint-init.ts
 import * as path13 from "path";
-import * as fs11 from "fs";
+import * as fs12 from "fs";
 import { execa } from "execa";
 var ESLINT_CONFIG_CONTENT = `/**
  * teamix-evo consumer ESLint preset \u2014 9 token-discipline rules.
@@ -2450,7 +2561,7 @@ async function runLintInit(options) {
   let stylelintIgnoreFilesWarning = false;
   if (!stylelintNeedsWrite && stylelintTemplateExists) {
     try {
-      const existingContent = fs11.readFileSync(stylelintConfigPath, "utf-8");
+      const existingContent = fs12.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) {
@@ -2487,8 +2598,8 @@ async function runLintInit(options) {
   };
 }
 function detectPm(projectRoot) {
-  if (fs11.existsSync(path13.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs11.existsSync(path13.join(projectRoot, "yarn.lock"))) return "yarn";
+  if (fs12.existsSync(path13.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs12.existsSync(path13.join(projectRoot, "yarn.lock"))) return "yarn";
   return "npm";
 }
 async function patchPackageJsonScripts(projectRoot) {
@@ -2521,7 +2632,7 @@ async function patchPackageJsonScripts(projectRoot) {
 }
 
 // src/core/init-detect.ts
-import * as fs12 from "fs/promises";
+import * as fs13 from "fs/promises";
 import * as path14 from "path";
 var IGNORED_TOP_LEVEL = /* @__PURE__ */ new Set([
   ".git",
@@ -2556,7 +2667,7 @@ async function detectProjectState(cwd) {
   }
   let entries;
   try {
-    entries = await fs12.readdir(absCwd);
+    entries = await fs13.readdir(absCwd);
   } catch (err) {
     if (err.code === "ENOENT") {
       return {
@@ -2590,7 +2701,7 @@ async function detectProjectState(cwd) {
 }
 
 // src/core/project-state.ts
-import * as fs13 from "fs/promises";
+import * as fs14 from "fs/promises";
 import * as path15 from "path";
 var IGNORED_TOP_LEVEL2 = /* @__PURE__ */ new Set([
   ".git",
@@ -2650,7 +2761,7 @@ async function detectProjectState2(cwd) {
   }
   let entries;
   try {
-    entries = await fs13.readdir(absCwd);
+    entries = await fs14.readdir(absCwd);
   } catch (err) {
     if (err.code === "ENOENT") {
       return {
@@ -2733,7 +2844,7 @@ function assertCommandPrecondition(command, state) {
 
 // src/core/init-conflicts.ts
 import * as crypto from "crypto";
-import * as fs14 from "fs/promises";
+import * as fs15 from "fs/promises";
 import * as path16 from "path";
 var TAILWIND_CONFIG_CANDIDATES = [
   "tailwind.config.ts",
@@ -2778,7 +2889,7 @@ var STYLELINT_CONFIG_CANDIDATES = [
 ];
 async function isDir(target) {
   try {
-    const stat3 = await fs14.stat(target);
+    const stat3 = await fs15.stat(target);
     return stat3.isDirectory();
   } catch {
     return false;
@@ -2786,7 +2897,7 @@ async function isDir(target) {
 }
 async function dirHasContent(target) {
   try {
-    const entries = await fs14.readdir(target);
+    const entries = await fs15.readdir(target);
     return entries.length > 0;
   } catch {
     return false;
@@ -2927,7 +3038,7 @@ async function detectShadcnSource(cwd) {
   try {
     const uiDir = path16.join(cwd, "src/components/ui");
     if (await isDir(uiDir)) {
-      const entries = await fs14.readdir(uiDir);
+      const entries = await fs15.readdir(uiDir);
       componentCount = entries.filter(
         (e) => e.endsWith(".tsx") || e.endsWith(".ts")
       ).length;
@@ -3005,7 +3116,7 @@ async function detectStylelintConfig(cwd) {
 
 // src/core/meta-installer.ts
 import * as path17 from "path";
-import * as fs15 from "fs/promises";
+import * as fs16 from "fs/promises";
 import { createRequire as createRequire5 } from "module";
 import {
   loadUiPackageManifest as loadUiPackageManifest3,
@@ -3049,7 +3160,7 @@ async function landManifestMeta(opts) {
   await ensureDir(metaDir);
   const manifestDest = path17.join(metaDir, "manifest.json");
   const manifestSrc = path17.join(packageRoot, "manifest.json");
-  await fs15.copyFile(manifestSrc, manifestDest);
+  await fs16.copyFile(manifestSrc, manifestDest);
   logger.debug(`meta: copied manifest.json \u2192 ${manifestDest}`);
   let written = 0;
   let total = 0;
@@ -3059,7 +3170,7 @@ async function landManifestMeta(opts) {
     const srcPath = path17.join(packageRoot, entry.meta);
     const destPath = path17.join(metaDir, `${entry.id}.md`);
     try {
-      await fs15.copyFile(srcPath, destPath);
+      await fs16.copyFile(srcPath, destPath);
       written++;
       logger.debug(`meta: ${entry.id} \u2192 ${destPath}`);
     } catch (err) {
@@ -3082,7 +3193,7 @@ async function landManifestMeta(opts) {
 }
 
 // src/core/deps-install.ts
-import * as fs16 from "fs/promises";
+import * as fs17 from "fs/promises";
 import * as path18 from "path";
 import { exec } from "child_process";
 import { promisify } from "util";
@@ -3139,7 +3250,7 @@ async function installProjectDeps(options) {
     pkg.dependencies = Object.fromEntries(
       Object.entries(pkg.dependencies).sort(([a], [b]) => a.localeCompare(b))
     );
-    await fs16.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    await fs17.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
     logger.info(
       `  patched package.json: +${Object.keys(added).length} dependencies`
     );
@@ -3201,7 +3312,7 @@ ${stepLines}
 }
 
 // src/core/file-changes.ts
-import * as fs17 from "fs/promises";
+import * as fs18 from "fs/promises";
 import * as path19 from "path";
 function toRelativePosix(p, projectRoot) {
   let rel2 = p;
@@ -3330,6 +3441,7 @@ async function runProjectInit(options) {
           `teamix-evo-design-${variant}`,
           `teamix-evo-code-${variant}`
         ],
+        globalSkillIds: ["teamix-evo-manage"],
         mode: "merge-managed"
       });
       record({
@@ -3660,7 +3772,7 @@ function deriveLintChanges(result) {
 
 // src/core/installer.ts
 import * as path21 from "path";
-import * as fs18 from "fs/promises";
+import * as fs19 from "fs/promises";
 async function installResources(options) {
   const { projectRoot, manifest, data, variantDir, packageRoot } = options;
   const installedResources = [];
@@ -3703,7 +3815,7 @@ async function installSingleResource(resource, projectRoot, data, variantDir, pa
     const templateContent = await loadTemplateFile(sourcePath);
     content = renderTemplate(templateContent, data);
   } else {
-    content = await fs18.readFile(sourcePath, "utf-8");
+    content = await fs19.readFile(sourcePath, "utf-8");
   }
   await writeFileSafe(targetPath, content);
   const hash = computeHash(content);
@@ -3736,7 +3848,7 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
       const templateContent = await loadTemplateFile(entry);
       content = renderTemplate(templateContent, data);
     } else {
-      content = await fs18.readFile(entry, "utf-8");
+      content = await fs19.readFile(entry, "utf-8");
     }
     await writeFileSafe(targetFile, content);
     const hash = computeHash(content);
@@ -3754,7 +3866,7 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
 
 // src/core/registry-client.ts
 import * as path22 from "path";
-import * as fs19 from "fs/promises";
+import * as fs20 from "fs/promises";
 import { createRequire as createRequire6 } from "module";
 import { loadVariantManifest } from "@teamix-evo/registry";
 var require7 = createRequire6(import.meta.url);
@@ -3771,7 +3883,7 @@ async function loadVariantData(packageName, variant) {
   let data = {};
   const dataPath = path22.join(variantDir, "_data.json");
   try {
-    const raw = await fs19.readFile(dataPath, "utf-8");
+    const raw = await fs20.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
   } catch (err) {
     if (err.code !== "ENOENT") {