@ruan-cat/utils 4.11.0 → 4.12.1

package/dist/node-esm/index.d.ts

@@ -39,6 +39,74 @@ declare function hasChangelogMd(): boolean;
  */
 declare function copyChangelogMd(/** 目标文件夹 */ target: string): void;
 
+/**
+ * 检查指定根目录是否存在 .claude/agents 文件夹
+ * @param options - 配置选项
+ * @param options.rootDir - 可选的根目录路径，支持相对路径（如 `../../../` 表示向上三级目录）。
+ *                          如果不传入，将自动向上查找包含 pnpm-workspace.yaml 的 monorepo 根目录。
+ *                          相对路径会基于当前工作目录 (process.cwd()) 解析为绝对路径。
+ * @returns 是否存在 .claude/agents 文件夹
+ * @example
+ * // 自动检测 monorepo 根目录
+ * hasClaudeAgents()
+ *
+ * // 手动指定相对路径（从当前工作目录向上三级）
+ * hasClaudeAgents({ rootDir: '../../../' })
+ *
+ * // 手动指定绝对路径
+ * hasClaudeAgents({ rootDir: '/path/to/monorepo' })
+ */
+declare function hasClaudeAgents(options?: {
+    rootDir?: string;
+}): boolean;
+/**
+ * 将 .claude/agents 文件夹复制到指定位置的配置选项
+ */
+interface CopyClaudeAgentsOptions {
+    /**
+     * 目标文件夹路径（相对于当前工作目录）
+     * @example 'dist', 'build/output', './public'
+     */
+    target: string;
+    /**
+     * 可选的根目录路径，支持相对路径（如 `../../../` 表示向上三级目录）
+     * @description
+     * - 如果不传入，将自动向上查找包含 pnpm-workspace.yaml 的 monorepo 根目录
+     * - 相对路径会基于当前工作目录 (process.cwd()) 解析为绝对路径
+     * - 绝对路径将直接使用
+     * @example
+     * // 相对路径：向上三级目录
+     * '../../../'
+     *
+     * // 绝对路径
+     * '/absolute/path/to/monorepo'
+     */
+    rootDir?: string;
+}
+/**
+ * 将 .claude/agents 文件夹复制到指定位置
+ * @param options - 配置选项
+ * @description
+ * 该函数相当于实现 `cpx .claude/agents <target>` 命令。
+ * 从根目录的 .claude/agents 复制到目标位置。
+ * @example
+ * // 自动检测 monorepo 根目录，复制到当前目录的 dist 文件夹
+ * copyClaudeAgents({ target: 'dist' })
+ *
+ * // 手动指定根目录为向上三级，复制到 build 文件夹
+ * copyClaudeAgents({
+ *   target: 'build',
+ *   rootDir: '../../../'
+ * })
+ *
+ * // 使用绝对路径指定根目录
+ * copyClaudeAgents({
+ *   target: 'dist',
+ *   rootDir: '/absolute/path/to/monorepo'
+ * })
+ */
+declare function copyClaudeAgents(options: CopyClaudeAgentsOptions): void;
+
 /** 检查当前运行的根目录 是否存在文件名大写的 `README.md` 文件 */
 declare function hasCapitalReadmeMd(): boolean;
 /** 检查当前运行的根目录 是否存在文件名小写的 `readme.md` 文件 */
@@ -72,4 +140,4 @@ interface AddChangelog2docOptions<T = Record<string, any>> {
 /** 将变更日志添加到指定的文档目录内 并提供参数 */
 declare function addChangelog2doc<T>(options: AddChangelog2docOptions<T>): void;
 
-export { type AddChangelog2docOptions, type PackageInfo, type WriteYaml2mdParams, addChangelog2doc, clean, copyChangelogMd, copyReadmeMd, defaultCleanTargets, getRuanCatPkgInfo, hasCapitalReadmeMd, hasChangelogMd, hasLowerCaseReadmeMd, hasReadmeMd, writeYaml2md };
+export { type AddChangelog2docOptions, type CopyClaudeAgentsOptions, type PackageInfo, type WriteYaml2mdParams, addChangelog2doc, clean, copyChangelogMd, copyClaudeAgents, copyReadmeMd, defaultCleanTargets, getRuanCatPkgInfo, hasCapitalReadmeMd, hasChangelogMd, hasClaudeAgents, hasLowerCaseReadmeMd, hasReadmeMd, writeYaml2md };

package/dist/node-esm/index.js

@@ -137,23 +137,75 @@ function copyChangelogMd(target) {
   fs.copyFileSync(source, destination);
 }
 
-// src/node-esm/scripts/copy-readme.ts
+// src/node-esm/scripts/copy-claude-agents.ts
 import fs2 from "fs";
 import path2 from "path";
 import consola4 from "consola";
+function findMonorepoRoot() {
+  let currentDir = process.cwd();
+  const root = path2.parse(currentDir).root;
+  while (currentDir !== root) {
+    const workspaceFile2 = path2.join(currentDir, "pnpm-workspace.yaml");
+    if (fs2.existsSync(workspaceFile2)) {
+      return currentDir;
+    }
+    currentDir = path2.dirname(currentDir);
+  }
+  const workspaceFile = path2.join(root, "pnpm-workspace.yaml");
+  if (fs2.existsSync(workspaceFile)) {
+    return root;
+  }
+  return null;
+}
+function resolveRootDir(rootDir) {
+  if (rootDir) {
+    return path2.resolve(process.cwd(), rootDir);
+  }
+  const monorepoRoot = findMonorepoRoot();
+  if (monorepoRoot) {
+    return monorepoRoot;
+  }
+  return process.cwd();
+}
+function hasClaudeAgents(options) {
+  const root = resolveRootDir(options?.rootDir);
+  const claudeAgentsPath = path2.join(root, ".claude/agents");
+  const exists = fs2.existsSync(claudeAgentsPath);
+  if (!exists) {
+    consola4.log("\u68C0\u6D4B\u7684\u6839\u76EE\u5F55\u4E3A\uFF1A", root);
+    consola4.warn("\u8BE5\u6839\u76EE\u5F55\u4E0D\u5B58\u5728 .claude/agents \u6587\u4EF6\u5939");
+  }
+  return exists;
+}
+function copyClaudeAgents(options) {
+  if (!hasClaudeAgents({ rootDir: options.rootDir })) {
+    return;
+  }
+  const root = resolveRootDir(options.rootDir);
+  const source = path2.join(root, ".claude/agents");
+  const destination = path2.resolve(process.cwd(), options.target);
+  fs2.mkdirSync(path2.dirname(destination), { recursive: true });
+  fs2.cpSync(source, destination, { recursive: true });
+  consola4.success(`\u5DF2\u6210\u529F\u590D\u5236 .claude/agents \u5230 ${destination}`);
+}
+
+// src/node-esm/scripts/copy-readme.ts
+import fs3 from "fs";
+import path3 from "path";
+import consola5 from "consola";
 var capitalReadmeMd = "README.md";
 var lowerCaseReadmeMd = "readme.md";
 function hasCapitalReadmeMd() {
-  const res = fs2.existsSync(path2.resolve(process.cwd(), capitalReadmeMd));
+  const res = fs3.existsSync(path3.resolve(process.cwd(), capitalReadmeMd));
   if (!res) {
-    consola4.warn(`\u5F53\u524D\u9879\u76EE\u6839\u76EE\u5F55\u4E0D\u5B58\u5728 ${capitalReadmeMd} \u6587\u4EF6`);
+    consola5.warn(`\u5F53\u524D\u9879\u76EE\u6839\u76EE\u5F55\u4E0D\u5B58\u5728 ${capitalReadmeMd} \u6587\u4EF6`);
   }
   return res;
 }
 function hasLowerCaseReadmeMd() {
-  const res = fs2.existsSync(path2.resolve(process.cwd(), lowerCaseReadmeMd));
+  const res = fs3.existsSync(path3.resolve(process.cwd(), lowerCaseReadmeMd));
   if (!res) {
-    consola4.log(`\u5F53\u524D\u9879\u76EE\u6839\u76EE\u5F55\u4E0D\u5B58\u5728 ${lowerCaseReadmeMd} \u6587\u4EF6`);
+    consola5.log(`\u5F53\u524D\u9879\u76EE\u6839\u76EE\u5F55\u4E0D\u5B58\u5728 ${lowerCaseReadmeMd} \u6587\u4EF6`);
   }
   return res;
 }
@@ -171,14 +223,14 @@ function copyReadmeMd(target) {
   } else if (hasLowerCaseReadmeMd()) {
     readmeFileName = lowerCaseReadmeMd;
   }
-  const source = path2.resolve(process.cwd(), readmeFileName);
-  const destination = path2.resolve(process.cwd(), target, "index.md");
-  fs2.copyFileSync(source, destination);
+  const source = path3.resolve(process.cwd(), readmeFileName);
+  const destination = path3.resolve(process.cwd(), target, "index.md");
+  fs3.copyFileSync(source, destination);
 }
 
 // src/node-esm/scripts/yaml-to-md.ts
 import { readFileSync, writeFileSync } from "fs";
-import { consola as consola5 } from "consola";
+import { consola as consola6 } from "consola";
 import { isUndefined } from "lodash-es";
 
 // ../../node_modules/.pnpm/js-yaml@4.1.0/node_modules/js-yaml/dist/js-yaml.mjs
@@ -2805,16 +2857,16 @@ var js_yaml_default = jsYaml;
 
 // src/node-esm/scripts/yaml-to-md.ts
 function writeYaml2md(params) {
-  consola5.info(` \u5F53\u524D\u8FD0\u884C\u7684\u5730\u5740\u4E3A\uFF1A ${process.cwd()} `);
+  consola6.info(` \u5F53\u524D\u8FD0\u884C\u7684\u5730\u5740\u4E3A\uFF1A ${process.cwd()} `);
   const { mdPath, data } = params;
   if (isUndefined(mdPath)) {
-    consola5.error(" \u8BF7\u63D0\u4F9Bmd\u6587\u4EF6\u7684\u5730\u5740 ");
+    consola6.error(" \u8BF7\u63D0\u4F9Bmd\u6587\u4EF6\u7684\u5730\u5740 ");
     process.exit(1);
   }
   try {
     readFileSync(mdPath, "utf-8");
   } catch (error) {
-    consola5.error(` \u6587\u4EF6 ${mdPath} \u4E0D\u5B58\u5728 `);
+    consola6.error(` \u6587\u4EF6 ${mdPath} \u4E0D\u5B58\u5728 `);
     process.exit(1);
   }
   const mdContent = readFileSync(mdPath, "utf-8");
@@ -2824,18 +2876,18 @@ ${yamlContent}---
 
 ${mdContent}`;
   writeFileSync(mdPath, newContent, "utf-8");
-  consola5.success(` \u5DF2\u5C06YAML\u6570\u636E\u5199\u5165\u5230 ${mdPath} `);
+  consola6.success(` \u5DF2\u5C06YAML\u6570\u636E\u5199\u5165\u5230 ${mdPath} `);
 }
 
 // src/node-esm/scripts/add-changelog-to-doc.ts
-import path3 from "path";
+import path4 from "path";
 function addChangelog2doc(options) {
   const { data, target } = options;
   if (!hasChangelogMd()) {
     return;
   }
   copyChangelogMd(target);
-  const mdPath = path3.resolve(process.cwd(), target, "CHANGELOG.md");
+  const mdPath = path4.resolve(process.cwd(), target, "CHANGELOG.md");
   writeYaml2md({
     mdPath,
     data
@@ -2845,11 +2897,13 @@ export {
   addChangelog2doc,
   clean,
   copyChangelogMd,
+  copyClaudeAgents,
   copyReadmeMd,
   defaultCleanTargets,
   getRuanCatPkgInfo,
   hasCapitalReadmeMd,
   hasChangelogMd,
+  hasClaudeAgents,
   hasLowerCaseReadmeMd,
   hasReadmeMd,
   writeYaml2md