teamix-evo 0.14.1 → 0.14.2

package/dist/core/index.d.ts

@@ -509,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-
@@ -524,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

package/dist/core/index.js

@@ -1463,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);
   }
@@ -1558,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) {
@@ -1873,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"
         });
       }
@@ -1966,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 {
@@ -2285,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,
@@ -2319,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) {
@@ -2342,7 +2365,7 @@ async function runVariantUiAdd(packageName, options) {
   const adaptedManifest = {
     schemaVersion: 1,
     package: "ui",
-    version: variantManifest.version,
+    version: packageVersion,
     engines: variantManifest.engines,
     entries: mergedEntries
   };
@@ -2370,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
   };
@@ -2446,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.
@@ -2538,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) {
@@ -2575,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) {
@@ -2609,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",
@@ -2644,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 {
@@ -2678,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",
@@ -2738,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 {
@@ -2821,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",
@@ -2866,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;
@@ -2874,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;
@@ -3015,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;
@@ -3093,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,
@@ -3137,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;
@@ -3147,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) {
@@ -3170,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";
@@ -3227,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`
     );
@@ -3289,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;
@@ -3418,6 +3441,7 @@ async function runProjectInit(options) {
           `teamix-evo-design-${variant}`,
           `teamix-evo-code-${variant}`
         ],
+        globalSkillIds: ["teamix-evo-manage"],
         mode: "merge-managed"
       });
       record({
@@ -3748,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 = [];
@@ -3791,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);
@@ -3824,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);
@@ -3842,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);
@@ -3859,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") {