teamix-evo 0.6.1 → 0.7.0

package/dist/index.js

@@ -467,7 +467,7 @@ async function writeMirrorContent(targetFile, sourceContent, managedRegions, sou
   if (matchedRegions.length === 0) {
     if (existing !== sourceContent) {
       logger.warn(
-        `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${sourceFile} (not the mirror) and re-run \`teamix-evo skills sync\`.`
+        `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${sourceFile} (not the mirror) and re-run \`npx teamix-evo@latest skills sync\`.`
       );
       await writeFileSafe(targetFile, sourceContent);
       return sourceContent;
@@ -569,34 +569,56 @@ async function rewriteSkillSource(skill, options, summary) {
       if (skill.template && targetFile2.endsWith(".hbs")) {
         targetFile2 = targetFile2.slice(0, -4);
       }
-      const content = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs5.readFile(entry, "utf-8");
+      const newContent2 = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs5.readFile(entry, "utf-8");
       const exists2 = await fileExists(targetFile2);
-      if (exists2) {
-        await backupFile(targetFile2, projectRoot);
-        summary.overwritten++;
-      } else {
-        summary.created++;
-      }
-      await writeFileSafe(targetFile2, content);
+      const written2 = await rewriteSingleFile({
+        targetFile: targetFile2,
+        newContent: newContent2,
+        exists: exists2,
+        updateStrategy: skill.updateStrategy,
+        managedRegions: skill.managedRegions,
+        projectRoot,
+        summary
+      });
       const relWritten = path7.relative(targetDir, targetFile2);
-      records.push(makeSourceRecord(skill, targetFile2, content, relWritten));
+      records.push(makeSourceRecord(skill, targetFile2, written2, relWritten));
     }
     return records;
   }
   const targetFile = path7.join(targetDir, "SKILL.md");
   const newContent = await renderSkillContent(sourceAbs, skill, data);
   const exists = await fileExists(targetFile);
-  if (skill.updateStrategy === "frozen") {
+  const written = await rewriteSingleFile({
+    targetFile,
+    newContent,
+    exists,
+    updateStrategy: skill.updateStrategy,
+    managedRegions: skill.managedRegions,
+    projectRoot,
+    summary
+  });
+  return [makeSourceRecord(skill, targetFile, written)];
+}
+async function rewriteSingleFile(args) {
+  const {
+    targetFile,
+    newContent,
+    exists,
+    updateStrategy,
+    managedRegions,
+    projectRoot,
+    summary
+  } = args;
+  if (updateStrategy === "frozen") {
     if (exists) {
       summary.skipped++;
-      const current2 = await readFileOrNull(targetFile) ?? newContent;
-      return [makeSourceRecord(skill, targetFile, current2)];
+      return await readFileOrNull(targetFile) ?? newContent;
     }
     await writeFileSafe(targetFile, newContent);
     summary.created++;
-    return [makeSourceRecord(skill, targetFile, newContent)];
+    return newContent;
   }
-  if (skill.updateStrategy === "regenerable" || !exists) {
+  if (updateStrategy === "regenerable" || !exists) {
     if (exists) {
       await backupFile(targetFile, projectRoot);
       summary.overwritten++;
@@ -604,11 +626,11 @@ async function rewriteSkillSource(skill, options, summary) {
       summary.created++;
     }
     await writeFileSafe(targetFile, newContent);
-    return [makeSourceRecord(skill, targetFile, newContent)];
+    return newContent;
   }
   const current = await readFileOrNull(targetFile);
   let merged = current ?? newContent;
-  for (const regionId of skill.managedRegions ?? []) {
+  for (const regionId of managedRegions ?? []) {
     const re = new RegExp(
       `<!-- teamix-evo:managed:start id="${escapeRegExp(
         regionId
@@ -628,10 +650,12 @@ async function rewriteSkillSource(skill, options, summary) {
       }
     }
   }
-  await backupFile(targetFile, projectRoot);
-  await writeFileSafe(targetFile, merged);
+  if (merged !== current) {
+    await backupFile(targetFile, projectRoot);
+    await writeFileSafe(targetFile, merged);
+  }
   summary.managed++;
-  return [makeSourceRecord(skill, targetFile, merged)];
+  return merged;
 }
 function escapeRegExp(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -996,7 +1020,7 @@ async function runTokensInit(options) {
     const known = catalog.variants.map((v) => v.name).join(", ");
     throw new Error(
       `Unknown variant "${variant}". Available variants: ${known || "(none)"}.
-Run \`teamix-evo tokens list-variants\` to see all options.`
+Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
     );
   }
   const existingConfig = await readProjectConfig(projectRoot);
@@ -1264,7 +1288,8 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
       logger.error(
         "No package.json found in current directory. Please run this command in a valid project root."
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     logger.info(`Initializing design system: variant="${variant}"`);
     logger.debug(`Project root: ${projectRoot}`);
@@ -1278,7 +1303,7 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
     });
     if (result.status === "already-initialized") {
       logger.info(
-        `Design system already initialized (variant: ${result.existingVariant}). Use "teamix-evo tokens update" to refresh resources.`
+        `Design system already initialized (variant: ${result.existingVariant}). Use "npx teamix-evo@latest tokens update" to refresh resources.`
       );
       return;
     }
@@ -1287,8 +1312,8 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
         `Cannot switch tokens variant in place. Currently installed: "${result.existingVariant}"; requested: "${result.requestedVariant}".`
       );
       logger.info("To switch variants:");
-      logger.info("  1. teamix-evo tokens uninstall --yes");
-      logger.info(`  2. teamix-evo tokens init ${result.requestedVariant}`);
+      logger.info("  1. npx teamix-evo@latest tokens uninstall --yes");
+      logger.info(`  2. npx teamix-evo@latest tokens init ${result.requestedVariant}`);
       logger.info(
         "Note: tokens.overrides.css (frozen) is preserved across uninstall/init by default."
       );
@@ -1320,9 +1345,9 @@ var initCommand = new Command("init").description("\u521D\u59CB\u5316\u8BBE\u8BA
       }
     }
     logger.info("");
-    logger.info('Run "teamix-evo tokens update" to update resources later.');
+    logger.info('Run "npx teamix-evo@latest tokens update" to update resources later.');
     logger.info(
-      'Run "teamix-evo tokens list-variants" to see all available variants.'
+      'Run "npx teamix-evo@latest tokens list-variants" to see all available variants.'
     );
   } catch (err) {
     logger.error(`Failed to initialize: ${err.message}`);
@@ -1360,7 +1385,7 @@ async function runTokensUpdate(options) {
   const variantEntry = getVariantEntry2(catalog, currentVariant);
   if (!variantEntry) {
     throw new Error(
-      `Currently installed variant "${currentVariant}" no longer exists in ${packageName}@${catalog.version}. Available: ${catalog.variants.map((v) => v.name).join(", ")}. Run \`teamix-evo tokens uninstall\` then \`teamix-evo tokens init <variant>\` to switch.`
+      `Currently installed variant "${currentVariant}" no longer exists in ${packageName}@${catalog.version}. Available: ${catalog.variants.map((v) => v.name).join(", ")}. Run \`npx teamix-evo@latest tokens uninstall\` then \`npx teamix-evo@latest tokens init <variant>\` to switch.`
     );
   }
   if (variantEntry.version === currentVersion) {
@@ -1462,7 +1487,7 @@ var updateCommand = new Command2("update").description(
     const result = await runTokensUpdate({ projectRoot });
     if (result.status === "not-initialized") {
       logger.error(
-        "No tokens variant installed. Run `teamix-evo tokens init <variant>` first."
+        "No tokens variant installed. Run `npx teamix-evo@latest tokens init <variant>` first."
       );
       process.exitCode = 1;
       return;
@@ -1503,7 +1528,7 @@ var listCommand = new Command3("list").description("\u5217\u51FA\u5DF2\u5B89\u88
     const config = await readProjectConfig(projectRoot);
     if (!config?.packages?.tokens) {
       logger.info("No tokens variant installed.");
-      logger.info('Run "teamix-evo tokens init [variant]" to get started.');
+      logger.info('Run "npx teamix-evo@latest tokens init [variant]" to get started.');
       return;
     }
     const { variant, version: version2 } = config.packages.tokens;
@@ -1555,7 +1580,7 @@ var listVariantsCommand = new Command4("list-variants").description("\u5217\u51F
       }
       logger.info("");
     }
-    logger.info("Install a variant: teamix-evo tokens init <name>");
+    logger.info("Install a variant: npx teamix-evo@latest tokens init <name>");
   } catch (err) {
     logger.error(`Failed to list variants: ${err.message}`);
     logger.debug(err.stack ?? "");
@@ -1669,6 +1694,29 @@ import { Command as Command14 } from "commander";
 // src/commands/skills/init.ts
 import { Command as Command7 } from "commander";
 import * as prompts2 from "@clack/prompts";
+
+// src/commands/skills/_parse.ts
+function parseIdeList(input) {
+  const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  const result = [];
+  for (const p of parts) {
+    if (p === "qoder" || p === "claude") {
+      if (!result.includes(p)) result.push(p);
+    } else {
+      throw new Error(
+        `Unknown IDE: "${p}". Expected one of: ${ALL_IDE_KINDS.join(", ")}.`
+      );
+    }
+  }
+  return result;
+}
+function parseScope(input) {
+  const v = (input ?? "project").toLowerCase();
+  if (v === "project" || v === "global") return v;
+  throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
+}
+
+// src/commands/skills/init.ts
 var initCommand2 = new Command7("init").description(
   "\u81EA\u4E3E teamix-evo skills\uFF08\u6309 tokens variant + scope \u5168\u88C5\u7B26\u5408\u6761\u4EF6\u7684 skill\uFF1Bscope \u4E3A global-only \u7684 entry skill \u81EA\u52A8\u8DF3\u8FC7 \u2014 ADR 0033\uFF09"
 ).option("--ide <list>", '\u9017\u53F7\u5206\u9694\u7684 IDE \u5217\u8868\uFF0C\u5982 "qoder,claude"').option("--scope <scope>", "project | global\uFF08\u9ED8\u8BA4 project\uFF09").option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u503C\uFF0C\u8DF3\u8FC7\u4EA4\u4E92").action(async (opts) => {
@@ -1684,7 +1732,8 @@ var initCommand2 = new Command7("init").description(
       logger.error(
         "No package.json found in current directory. Please run this command in a valid project root."
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     logger.info(
       `Initializing skills (bulk): ides=[${ides.join(",")}], scope="${scope}"`
@@ -1698,7 +1747,7 @@ var initCommand2 = new Command7("init").description(
     });
     if (result.status === "already-initialized") {
       logger.warn(
-        `Skills already initialized. Use "teamix-evo skills add <name>" to add specific skills, "teamix-evo skills update" to refresh, or "teamix-evo skills uninstall" to remove.`
+        `Skills already initialized. Use "npx teamix-evo@latest skills add <name>" to add specific skills, "npx teamix-evo@latest skills update" to refresh, or "npx teamix-evo@latest skills uninstall" to remove.`
       );
       return;
     }
@@ -1715,7 +1764,7 @@ var initCommand2 = new Command7("init").description(
     }
     logger.info(`  Files:   ${result.fileCount}`);
     logger.info("");
-    logger.info('Run "teamix-evo skills list" to see installed skills.');
+    logger.info('Run "npx teamix-evo@latest skills list" to see installed skills.');
   } catch (err) {
     logger.error(`Failed to init skills: ${err.message}`);
     logger.debug(err.stack ?? "");
@@ -1758,23 +1807,6 @@ async function resolveIdesAndScope(args) {
   }
   return { ides: idesAns, scope: scopeAns };
 }
-function parseIdeList(input) {
-  const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
-  const result = [];
-  for (const p of parts) {
-    if (p === "qoder" || p === "claude") {
-      if (!result.includes(p)) result.push(p);
-    } else {
-      throw new Error(`Unknown IDE: "${p}". Expected qoder | claude.`);
-    }
-  }
-  return result;
-}
-function parseScope(input) {
-  const v = (input ?? "project").toLowerCase();
-  if (v === "project" || v === "global") return v;
-  throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
-}
 
 // src/commands/skills/add.ts
 import { Command as Command8 } from "commander";
@@ -1800,7 +1832,8 @@ var addCommand = new Command8("add").description(
       logger.error(
         "No package.json found in current directory. Please run this command in a valid project root."
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     logger.info(
       `Adding skills [${names.join(",")}]: ides=[${ides.join(
@@ -1819,7 +1852,7 @@ var addCommand = new Command8("add").description(
       logger.warn(
         `\u5DF2\u5B58\u5728\uFF0C\u65E0\u9700\u6DFB\u52A0\uFF1A${result.skippedSkillIds.join(
           ", "
-        )}\u3002\u5982\u9700\u5237\u65B0\u5185\u5BB9\u8BF7\u8FD0\u884C "teamix-evo skills update"\u3002`
+        )}\u3002\u5982\u9700\u5237\u65B0\u5185\u5BB9\u8BF7\u8FD0\u884C "npx teamix-evo@latest skills update"\u3002`
       );
       return;
     }
@@ -1836,7 +1869,7 @@ var addCommand = new Command8("add").description(
     }
     logger.info(`  Files:   ${result.fileCount}`);
     logger.info("");
-    logger.info('Run "teamix-evo skills list" to see installed skills.');
+    logger.info('Run "npx teamix-evo@latest skills list" to see installed skills.');
   } catch (err) {
     logger.error(`Failed to add skills: ${err.message}`);
     logger.debug(err.stack ?? "");
@@ -1859,8 +1892,8 @@ async function resolveIdesAndScope2(args) {
     }
   }
   if (opts.ide || opts.yes) {
-    const ides = opts.ide ? parseIdeList2(opts.ide) : [...ALL_IDE_KINDS];
-    const scope = parseScope2(opts.scope);
+    const ides = opts.ide ? parseIdeList(opts.ide) : [...ALL_IDE_KINDS];
+    const scope = parseScope(opts.scope);
     if (ides.length === 0) {
       throw new Error("At least one IDE must be selected.");
     }
@@ -1891,23 +1924,6 @@ async function resolveIdesAndScope2(args) {
   }
   return { ides: idesAns, scope: scopeAns };
 }
-function parseIdeList2(input) {
-  const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
-  const result = [];
-  for (const p of parts) {
-    if (p === "qoder" || p === "claude") {
-      if (!result.includes(p)) result.push(p);
-    } else {
-      throw new Error(`Unknown IDE: "${p}". Expected qoder | claude.`);
-    }
-  }
-  return result;
-}
-function parseScope2(input) {
-  const v = (input ?? "project").toLowerCase();
-  if (v === "project" || v === "global") return v;
-  throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
-}
 
 // src/commands/skills/list.ts
 import { Command as Command9 } from "commander";
@@ -1941,7 +1957,7 @@ var listCommand2 = new Command9("list").alias("ls").description(
     if (opts.installed) {
       if (!config?.packages?.skills || !pkg) {
         logger.info("No skills installed.");
-        logger.info('Run "teamix-evo skills init" to get started.');
+        logger.info('Run "npx teamix-evo@latest skills init" to get started.');
         return;
       }
       printInstalledHeader(config.packages.skills, pkg.installedAt);
@@ -1965,12 +1981,12 @@ var listCommand2 = new Command9("list").alias("ls").description(
       printInstalledHeader(config.packages.skills, pkg.installedAt);
     } else if (isInstalled) {
       logger.info(
-        `Installed (${installedBySkill.size} skill(s)) \u2014 config or manifest record missing; run "teamix-evo skills doctor" to repair.`
+        `Installed (${installedBySkill.size} skill(s)) \u2014 config or manifest record missing; run "npx teamix-evo@latest skills doctor" to repair.`
       );
     } else {
       logger.info("Skills package not yet added.");
       logger.info(
-        'Run "teamix-evo skills init" to bootstrap, or "teamix-evo skills add <id...>" for specific skills.'
+        'Run "npx teamix-evo@latest skills init" to bootstrap, or "npx teamix-evo@latest skills add <id...>" for specific skills.'
       );
     }
     logger.info("");
@@ -1981,7 +1997,7 @@ var listCommand2 = new Command9("list").alias("ls").description(
       const installed = fileCount !== void 0;
       if (installed) installedCount++;
       const mark = installed ? "\u2713" : "\u25CB";
-      const tail = installed ? `[installed, ${fileCount} file${fileCount > 1 ? "s" : ""}]` : `[not installed \u2014 run "teamix-evo skills add ${s.id}"]`;
+      const tail = installed ? `[installed, ${fileCount} file${fileCount > 1 ? "s" : ""}]` : `[not installed \u2014 run "npx teamix-evo@latest skills add ${s.id}"]`;
       logger.info(`  ${mark} ${s.id}@${s.version}  ${tail}`);
       if (s.description) {
         logger.info(`      ${s.description}`);
@@ -2201,7 +2217,7 @@ var updateCommand2 = new Command10("update").description(
     switch (result.status) {
       case "no-skills":
         logger.error(
-          'Skills not added. Run "teamix-evo skills init" first.'
+          'Skills not added. Run "npx teamix-evo@latest skills init" first.'
         );
         process.exitCode = 1;
         return;
@@ -2658,8 +2674,8 @@ var syncCommand = new Command12("sync").description(
     if (projectRoot !== cwd) {
       logger.info(`Using global skills meta root: ${projectRoot}`);
     }
-    const ides = opts.ide ? parseIdeList3(opts.ide) : void 0;
-    const scope = opts.scope ? parseScope3(opts.scope) : void 0;
+    const ides = opts.ide ? parseIdeList(opts.ide) : void 0;
+    const scope = opts.scope ? parseScope(opts.scope) : void 0;
     const result = await runSkillsSync({
       projectRoot,
       ides,
@@ -2691,25 +2707,6 @@ var syncCommand = new Command12("sync").description(
     process.exitCode = 1;
   }
 });
-function parseIdeList3(input) {
-  const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
-  const result = [];
-  for (const p of parts) {
-    if (p === "qoder" || p === "claude") {
-      if (!result.includes(p)) result.push(p);
-    } else {
-      throw new Error(
-        `Unknown IDE: "${p}". Expected one of: ${ALL_IDE_KINDS.join(", ")}.`
-      );
-    }
-  }
-  return result;
-}
-function parseScope3(input) {
-  const v = input.toLowerCase();
-  if (v === "project" || v === "global") return v;
-  throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
-}
 
 // src/commands/skills/doctor.ts
 import { Command as Command13 } from "commander";
@@ -2731,7 +2728,7 @@ async function runSkillsDoctor(options) {
         kind: "missing-source",
         skillId,
         path: sourceDir,
-        detail: 'Run "teamix-evo skills init" to reinstall.'
+        detail: 'Run "npx teamix-evo@latest skills init" to reinstall.'
       });
       continue;
     }
@@ -2755,7 +2752,7 @@ async function runSkillsDoctor(options) {
           ide,
           scope: entry.scope,
           path: mirrorDir,
-          detail: 'Run "teamix-evo skills sync" to re-mirror.'
+          detail: 'Run "npx teamix-evo@latest skills sync" to re-mirror.'
         });
         continue;
       }
@@ -2768,7 +2765,7 @@ async function runSkillsDoctor(options) {
             ide,
             scope: entry.scope,
             path: mirrorFile,
-            detail: 'Run "teamix-evo skills sync" to re-mirror.'
+            detail: 'Run "npx teamix-evo@latest skills sync" to re-mirror.'
           });
           continue;
         }
@@ -2780,7 +2777,7 @@ async function runSkillsDoctor(options) {
             ide,
             scope: entry.scope,
             path: mirrorFile,
-            detail: 'Mirror differs from source. Re-run "teamix-evo skills sync" to overwrite.'
+            detail: 'Mirror differs from source. Re-run "npx teamix-evo@latest skills sync" to overwrite.'
           });
         }
       }
@@ -2814,7 +2811,7 @@ var doctorCommand = new Command13("doctor").description(
     const result = await runSkillsDoctor({ projectRoot });
     if (result.status === "no-skills") {
       logger.info(
-        'No skills recorded. Run "teamix-evo skills init" first.'
+        'No skills recorded. Run "npx teamix-evo@latest skills init" first.'
       );
       return;
     }
@@ -2823,7 +2820,7 @@ var doctorCommand = new Command13("doctor").description(
       return;
     }
     logger.warn(
-      `Found ${result.findings.length} drift issue(s). Run "teamix-evo skills sync" to repair mirrors.`
+      `Found ${result.findings.length} drift issue(s). Run "npx teamix-evo@latest skills sync" to repair mirrors.`
     );
     for (const f of result.findings) {
       const idePart = f.ide ? ` [${f.ide}]` : "";
@@ -2927,7 +2924,8 @@ var initCommand3 = new Command15("init").description(
       logger.error(
         "No package.json found in current directory. Please run this command in a valid project root."
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     const cfg = await resolveConfig(opts);
     const result = await runUiInit({
@@ -2940,7 +2938,7 @@ var initCommand3 = new Command15("init").description(
     });
     if (result.status === "already-initialized") {
       logger.warn(
-        "UI already initialized. Edit `.teamix-evo/config.json` directly to change aliases, or run `teamix-evo ui list`."
+        "UI already initialized. Edit `.teamix-evo/config.json` directly to change aliases, or run `npx teamix-evo@latest ui list`."
       );
       return;
     }
@@ -2952,7 +2950,7 @@ var initCommand3 = new Command15("init").description(
     logger.info(`  iconLibrary: ${result.iconLibrary}`);
     logger.info(`  tsx: ${result.tsx}, rsc: ${result.rsc}`);
     logger.info("");
-    logger.info("Next: `npx teamix-evo ui add button`");
+    logger.info("Next: `npx teamix-evo@latest ui add button`");
   } catch (err) {
     logger.error(`Failed to initialize ui: ${err.message}`);
     logger.debug(err.stack ?? "");
@@ -3636,7 +3634,7 @@ var listCommand4 = new Command20("list").description("\u5217\u51FA\u6307\u5B9A\u
       logger.info("");
     }
     logger.info(
-      `Install: teamix-evo biz-ui add <id> --variant ${result.variant}`
+      `Install: npx teamix-evo@latest biz-ui add <id> --variant ${result.variant}`
     );
   } catch (err) {
     logger.error(`Failed: ${err.message}`);
@@ -3660,7 +3658,7 @@ var listVariantsCommand2 = new Command21("list-variants").description("\u5217\u5
       if (v.description) logger.info(`    ${v.description}`);
       logger.info("");
     }
-    logger.info("Install from a variant: teamix-evo biz-ui add <id> --variant <name>");
+    logger.info("Install from a variant: npx teamix-evo@latest biz-ui add <id> --variant <name>");
   } catch (err) {
     logger.error(`Failed: ${err.message}`);
     process.exitCode = 1;
@@ -3746,7 +3744,7 @@ var listCommand5 = new Command24("list").description("\u5217\u51FA\u6307\u5B9A\u
       logger.info("");
     }
     logger.info(
-      `Install: teamix-evo templates add <id> --variant ${result.variant}`
+      `Install: npx teamix-evo@latest templates add <id> --variant ${result.variant}`
     );
   } catch (err) {
     logger.error(`Failed: ${err.message}`);
@@ -3770,7 +3768,7 @@ var listVariantsCommand3 = new Command25("list-variants").description("\u5217\u5
       if (v.description) logger.info(`    ${v.description}`);
       logger.info("");
     }
-    logger.info("Install from a variant: teamix-evo templates add <id> --variant <name>");
+    logger.info("Install from a variant: npx teamix-evo@latest templates add <id> --variant <name>");
   } catch (err) {
     logger.error(`Failed: ${err.message}`);
     process.exitCode = 1;
@@ -3790,27 +3788,19 @@ import { Command as Command29 } from "commander";
 
 // src/commands/logs/analyze.ts
 import { Command as Command27 } from "commander";
-import { readFileSync, readdirSync, existsSync as existsSync2, statSync } from "fs";
-import { resolve as resolve3, join as join17 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { resolve as resolve3, join as join18 } from "path";
+
+// src/commands/logs/_io.ts
+import { readFileSync, readdirSync, statSync } from "fs";
+import { join as join17 } from "path";
 var DATE_DIR_RE = /^\d{4}-\d{2}-\d{2}$/;
-var logsAnalyzeCommand = new Command27("analyze").description(
-  "\u6C47\u603B vibe-logger \u8F93\u51FA (.teamix-evo/logs/ai/**/*.jsonl) \u2014 \u5DE5\u5177 / \u5305\u6807\u7B7E / MCP \u8C03\u7528\u9891\u7387,\u8F85\u52A9\u751F\u6001\u4F18\u5316"
-).option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option(
-  "--days <n>",
-  "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4\u5168\u90E8;\u6309\u76EE\u5F55\u540D YYYY-MM-DD \u6BD4\u5BF9,\u4E0D\u89E3\u6790\u8BB0\u5F55 ts)"
-).option("--top <n>", "\u6BCF\u4E2A\u6392\u884C\u5C55\u793A\u524D N \u9879 (\u9ED8\u8BA4 10)", "10").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
-  const baseDir = resolve3(
-    opts.dir ?? join17(process.cwd(), ".teamix-evo", "logs", "ai")
-  );
-  if (!existsSync2(baseDir)) {
-    logger.warn(`No log directory at ${baseDir}.`);
-    logger.info(
-      "\u8FD0\u884C vibe-logger hook \u89E6\u53D1\u540E\u4F1A\u5728\u6B64\u76EE\u5F55\u751F\u6210 JSONL \u2014 \u89C1 .claude/scripts/vibe-logger.mjs\uFF08\u9ED8\u8BA4\u8DEF\u5F84 .teamix-evo/logs/ai\uFF09"
-    );
-    return;
-  }
-  const dayLimit = parseIntOrUndef(opts.days);
-  const top = parseIntOrUndef(opts.top) ?? 10;
+function parseIntOrUndef(v) {
+  if (v === void 0) return void 0;
+  const n = Number.parseInt(v, 10);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+function readRecords(baseDir, dayLimit) {
   const dayDirs = readdirSync(baseDir, { withFileTypes: true }).filter((e) => e.isDirectory() && DATE_DIR_RE.test(e.name)).map((e) => e.name).sort().reverse();
   const selected = dayLimit !== void 0 ? dayDirs.slice(0, dayLimit) : dayDirs;
   const records = [];
@@ -3840,12 +3830,35 @@ var logsAnalyzeCommand = new Command27("analyze").description(
       }
     }
   }
+  return records;
+}
+
+// src/commands/logs/analyze.ts
+var logsAnalyzeCommand = new Command27("analyze").description(
+  "\u6C47\u603B vibe-logger \u8F93\u51FA (.teamix-evo/logs/ai/**/*.jsonl) \u2014 \u5DE5\u5177 / \u5305\u6807\u7B7E / MCP \u8C03\u7528\u9891\u7387,\u8F85\u52A9\u751F\u6001\u4F18\u5316"
+).option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option(
+  "--days <n>",
+  "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4\u5168\u90E8;\u6309\u76EE\u5F55\u540D YYYY-MM-DD \u6BD4\u5BF9,\u4E0D\u89E3\u6790\u8BB0\u5F55 ts)"
+).option("--top <n>", "\u6BCF\u4E2A\u6392\u884C\u5C55\u793A\u524D N \u9879 (\u9ED8\u8BA4 10)", "10").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
+  const baseDir = resolve3(
+    opts.dir ?? join18(process.cwd(), ".teamix-evo", "logs", "ai")
+  );
+  if (!existsSync2(baseDir)) {
+    logger.warn(`No log directory at ${baseDir}.`);
+    logger.info(
+      "\u8FD0\u884C vibe-logger hook \u89E6\u53D1\u540E\u4F1A\u5728\u6B64\u76EE\u5F55\u751F\u6210 JSONL \u2014 \u89C1 .claude/scripts/vibe-logger.mjs\uFF08\u9ED8\u8BA4\u8DEF\u5F84 .teamix-evo/logs/ai\uFF09"
+    );
+    return;
+  }
+  const dayLimit = parseIntOrUndef(opts.days);
+  const top = parseIntOrUndef(opts.top) ?? 10;
+  const records = readRecords(baseDir, dayLimit);
   const report = buildReport(records, top);
   if (opts.json) {
     process.stdout.write(JSON.stringify(report, null, 2) + "\n");
     return;
   }
-  printReport(baseDir, selected.length, report);
+  printReport(baseDir, dayLimit, report);
 });
 function buildReport(records, top) {
   const byAgent = {};
@@ -3920,10 +3933,10 @@ function buildReport(records, top) {
 function sortAndSlice(m, top) {
   return [...m.entries()].sort((a, b) => b[1] - a[1]).slice(0, top);
 }
-function printReport(baseDir, dayCount, r) {
+function printReport(baseDir, dayLimit, r) {
   logger.info(`vibe-logger \u5206\u6790\u62A5\u544A`);
   logger.info(`  \u76EE\u5F55:  ${baseDir}`);
-  logger.info(`  \u5929\u6570:  ${dayCount}`);
+  logger.info(`  \u5929\u6570:  ${dayLimit ?? "all"}`);
   logger.info(`  \u65F6\u95F4:  ${r.range.from ?? "-"} \u2192 ${r.range.to ?? "-"}`);
   logger.info("");
   logger.info(
@@ -3968,22 +3981,16 @@ function pad(n, width) {
   const s = String(n);
   return s.length >= width ? s : " ".repeat(width - s.length) + s;
 }
-function parseIntOrUndef(v) {
-  if (v === void 0) return void 0;
-  const n = Number.parseInt(v, 10);
-  return Number.isFinite(n) && n > 0 ? n : void 0;
-}
 
 // src/commands/logs/trace.ts
 import { Command as Command28 } from "commander";
-import { readFileSync as readFileSync2, readdirSync as readdirSync2, existsSync as existsSync3, statSync as statSync2 } from "fs";
-import { resolve as resolve4, join as join18 } from "path";
-var DATE_DIR_RE2 = /^\d{4}-\d{2}-\d{2}$/;
+import { existsSync as existsSync3 } from "fs";
+import { resolve as resolve4, join as join19 } from "path";
 var logsTraceCommand = new Command28("trace").description(
   "\u6309\u4F1A\u8BDD\u8FD8\u539F AI \u8C03\u7528\u94FE\u8DEF:\u4ECE\u7528\u6237 prompt \u8D77\u59CB,\u4E32\u8054\u540E\u7EED PreToolUse/PostToolUse \u76F4\u5230\u4E0B\u4E00\u4E2A prompt \u6216 Stop"
 ).option("--prompt <keyword>", "\u6309\u7528\u6237\u8F93\u5165\u5173\u952E\u5B57\u8FC7\u6EE4 (\u5B50\u4E32\u5339\u914D,\u4E0D\u533A\u5206\u5927\u5C0F\u5199)").option("--session <id>", "\u6307\u5B9A\u4F1A\u8BDD ID (\u524D\u7F00\u5339\u914D)").option("--days <n>", "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4 7)", "7").option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
   const baseDir = resolve4(
-    opts.dir ?? join18(process.cwd(), ".teamix-evo", "logs", "ai")
+    opts.dir ?? join19(process.cwd(), ".teamix-evo", "logs", "ai")
   );
   if (!existsSync3(baseDir)) {
     logger.warn(`No log directory at ${baseDir}.`);
@@ -3992,7 +3999,7 @@ var logsTraceCommand = new Command28("trace").description(
     );
     return;
   }
-  const dayLimit = parseIntOrUndef2(opts.days) ?? 7;
+  const dayLimit = parseIntOrUndef(opts.days) ?? 7;
   const records = readRecords(baseDir, dayLimit);
   const report = buildTrace(records, {
     prompt: opts.prompt,
@@ -4004,38 +4011,6 @@ var logsTraceCommand = new Command28("trace").description(
   }
   printTrace(baseDir, report);
 });
-function readRecords(baseDir, dayLimit) {
-  const dayDirs = readdirSync2(baseDir, { withFileTypes: true }).filter((e) => e.isDirectory() && DATE_DIR_RE2.test(e.name)).map((e) => e.name).sort().reverse();
-  const selected = dayDirs.slice(0, dayLimit);
-  const records = [];
-  for (const day of selected) {
-    const dayPath = join18(baseDir, day);
-    let entries;
-    try {
-      entries = readdirSync2(dayPath);
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      if (!entry.endsWith(".jsonl")) continue;
-      const fp = join18(dayPath, entry);
-      try {
-        if (!statSync2(fp).isFile()) continue;
-      } catch {
-        continue;
-      }
-      const text2 = readFileSync2(fp, "utf8");
-      for (const line of text2.split("\n")) {
-        if (!line.trim()) continue;
-        try {
-          records.push(JSON.parse(line));
-        } catch {
-        }
-      }
-    }
-  }
-  return records;
-}
 function buildTrace(records, filter = {}) {
   const groups = /* @__PURE__ */ new Map();
   for (const r of records) {
@@ -4182,11 +4157,6 @@ function padRight(s, n) {
 function padLeft(s, n) {
   return s.length >= n ? s : " ".repeat(n - s.length) + s;
 }
-function parseIntOrUndef2(v) {
-  if (v === void 0) return void 0;
-  const n = Number.parseInt(v, 10);
-  return Number.isFinite(n) && n > 0 ? n : void 0;
-}
 
 // src/commands/logs/index.ts
 var logsCommand = new Command29("logs").description(
@@ -4313,7 +4283,8 @@ var initCommand4 = new Command30("init").description(
       logger.error(
         "No package.json found in current directory. Please run this command in a valid project root."
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     const isInteractive = Boolean(process.stdin.isTTY);
     if (!opts.yes && isInteractive) {