@soybeanjs/cli 1.7.4 → 1.8.0

package/README.md

@@ -1,51 +1,277 @@
 # @soybeanjs/cli
 
-SoybeanJS 的命令行工具
+SoybeanJS 的命令行工具集，提供 Git 提交规范、依赖更新、Changelog 生成、版本发布等便捷功能。
 
-## 用法
+## 特性
 
-### 安装
+- 📝 **符合 Conventional Commits 规范的 Git 提交** - 交互式选择提交类型和范围
+- ✅ **提交信息校验** - 自动校验 commit message 是否符合规范
+- 🧹 **清理功能** - 一键清理 node_modules、dist 等目录
+- 📦 **依赖更新** - 基于 npm-check-updates 快速升级依赖
+- 📋 **Changelog 生成** - 根据 Git tags 自动生成变更日志
+- 🚀 **版本发布** - 一键完成版本更新、Changelog 生成、代码提交和推送
+- 🌍 **多语言支持** - 支持中文和英文，可持久化设置默认语言
+- ⚙️ **灵活配置** - 支持项目级和全局配置，可自定义提交类型和范围
+
+## 安装
 
 ```bash
-pnpm i -D @soybeanjs/cli
+pnpm add -D @soybeanjs/cli
+# 或者
+npm i -D @soybeanjs/cli
+# 或者
+yarn add -D @soybeanjs/cli
 ```
 
-### 使用
+安装后可通过 `pnpm soy` 或 `npx soy` 使用 CLI 命令。
 
-示例：
+## 快速开始
 
 ```bash
+# 查看帮助
 pnpm soy -h
+
+# 交互式 Git 提交
+pnpm soy git-commit
+```
+
+## 命令说明
+
+### 全局选项
+
+| 选项                      | 说明                                          | 默认值                                  |
+| ------------------------- | --------------------------------------------- | --------------------------------------- |
+| `-v, --version`           | 显示版本号                                    | -                                       |
+| `-e, --execute [command]` | 版本发布时在 bump 之后、commit 之前执行的命令 | `pnpm soy changelog`                    |
+| `-p, --push`              | 发布时是否推送 Git 提交和标签                 | -                                       |
+| `-t, --total`             | 生成 Changelog 时基于所有标签                 | -                                       |
+| `-c, --cleanupDir <dir>`  | 指定清理目录，多个目录用逗号分隔              | 见配置                                  |
+| `-l, --lang <lang>`       | CLI 显示语言 (`zh-cn` / `en-us`)              | `en-us`（可通过 config 命令持久化修改） |
+| `-h, --help`              | 显示帮助信息                                  | -                                       |
+
+### 命令列表
+
+| 命令                | 说明                                                             |
+| ------------------- | ---------------------------------------------------------------- |
+| `cleanup`           | 清理目录（node_modules、dist、lock 文件等）                      |
+| `ncu`               | 升级 package.json 中的依赖到最新版本                             |
+| `update-pkg`        | [已废弃] 请使用 `ncu` 代替                                       |
+| `git-commit`        | 交互式生成符合 Conventional Commits 规范的 Git 提交信息          |
+| `git-commit-verify` | 校验 Git 提交信息是否符合规范（通常配合 Git hooks 使用）         |
+| `changelog`         | 根据 Git tags 生成 Changelog                                     |
+| `release`           | 一键发布：更新版本号 → 生成 Changelog → 提交代码 → 打标签 → 推送 |
+| `config <cmd>`      | 管理 CLI 配置                                                    |
+
+### config 子命令
+
+| 命令                           | 说明                                                           |
+| ------------------------------ | -------------------------------------------------------------- |
+| `config set --set-lang <lang>` | 设置默认语言（`zh-cn` 或 `en-us`），配置会持久化到全局配置文件 |
+| `config get`                   | 查看当前配置信息                                               |
+| `config path`                  | 显示全局配置文件路径                                           |
+
+#### 使用示例
+
+```bash
+# 设置默认语言为中文
+pnpm soy config set --set-lang zh-cn
+
+# 设置默认语言为英文
+pnpm soy config set --set-lang en-us
+
+# 查看当前配置
+pnpm soy config get
+
+# 查看全局配置文件位置
+pnpm soy config path
+```
+
+### git-commit 命令详解
+
+使用 `pnpm soy git-commit` 进行交互式提交：
+
+1. **选择提交类型 (type)** - 如 feat、fix、docs、style 等
+2. **选择提交范围 (scope)** - 如 projects、components、utils 等
+3. **输入提交描述** - 在描述前加 `!` 表示破坏性变更（Breaking Change）
+
+生成的提交信息格式：
+
+```
+<type>(<scope>)<!>: <description>
+```
+
+示例：
+
+```
+feat(components): add new Button component
+fix(utils)!: change API signature
+```
+
+## 配置
+
+支持两层配置：
+
+1. **全局配置** - `~/.soybeanrc`（JSON 格式），通过 `config set` 命令管理
+2. **项目配置** - 项目根目录下的配置文件（支持 TS/JS 等格式），优先级高于全局配置
+
+### 配置文件
+
+在项目根目录创建配置文件（支持以下名称）：
+
+- `soybean.config.ts`（推荐）
+- `soybean.config.js`
+- `soybean.config.mjs`
+- `soybean.config.json`
+- 在 `package.json` 的 `soybean` 字段中配置
+
+使用 TypeScript 配置时，使用 `defineConfig` 获得类型提示：
+
+```ts
+// soybean.config.ts
+import { defineConfig } from '@soybeanjs/cli';
+
+export default defineConfig({
+  // 配置项
+});
+```
+
+### 配置项
+
+| 配置项                   | 类型                       | 说明                                   | 默认值                                                     |
+| ------------------------ | -------------------------- | -------------------------------------- | ---------------------------------------------------------- |
+| `cwd`                    | `string`                   | 项目根目录                             | `process.cwd()`                                            |
+| `lang`                   | `'zh-cn' \| 'en-us'`       | 默认显示语言                           | `'en-us'`                                                  |
+| `cleanupDirs`            | `string[]`                 | 需要清理的目录 glob 模式               | `['**/dist', '**/node_modules', '**/pnpm-lock.yaml', ...]` |
+| `ncuCommandArgs`         | `string[]`                 | ncu 命令参数                           | 自动解析 workspace                                         |
+| `changelogOptions`       | `Partial<ChangelogOption>` | Changelog 生成选项                     | `{}`                                                       |
+| `gitCommitVerifyIgnores` | `RegExp[]`                 | 提交信息校验忽略规则（追加到默认规则） | 见源码                                                     |
+| `gitCommit`              | `GitCommitConfig`          | Git 提交配置                           | 见下方                                                     |
+
+### Git 提交配置 (gitCommit)
+
+用于自定义 commit types 和 scopes：
+
+| 配置项                   | 类型                 | 说明                                                      | 默认值      |
+| ------------------------ | -------------------- | --------------------------------------------------------- | ----------- |
+| `gitCommit.types`        | `[string, string][]` | 自定义提交类型                                            | 默认 types  |
+| `gitCommit.typesAppend`  | `boolean`            | 自定义 types 是否追加到默认 types（`false` 则完全覆盖）   | `true`      |
+| `gitCommit.scopes`       | `[string, string][]` | 自定义提交范围                                            | 默认 scopes |
+| `gitCommit.scopesAppend` | `boolean`            | 自定义 scopes 是否追加到默认 scopes（`false` 则完全覆盖） | `true`      |
+
+**默认提交类型 (types)：**
+
+| type       | 说明 (中文)                           | 说明 (English)                                                |
+| ---------- | ------------------------------------- | ------------------------------------------------------------- |
+| `feat`     | 新功能                                | A new feature                                                 |
+| `fix`      | 修复 Bug                              | A bug fix                                                     |
+| `docs`     | 文档更新                              | Documentation only changes                                    |
+| `style`    | 代码风格修改（不影响代码含义）        | Changes that do not affect the meaning of the code            |
+| `refactor` | 代码重构（既不修复 bug 也不添加功能） | A code change that neither fixes a bug nor adds a feature     |
+| `perf`     | 性能优化                              | A code change that improves performance                       |
+| `optimize` | 代码质量优化                          | A code change that optimizes code quality                     |
+| `test`     | 测试相关                              | Adding missing tests or correcting existing tests             |
+| `build`    | 构建系统或外部依赖变更                | Changes that affect the build system or external dependencies |
+| `ci`       | CI 配置变更                           | Changes to CI configuration files and scripts                 |
+| `chore`    | 其他不修改 src/测试文件的变更         | Other changes that don't modify src or test files             |
+| `revert`   | 还原先前的提交                        | Reverts a previous commit                                     |
+
+**默认提交范围 (scopes)：**
+
+| scope        | 说明 (中文)    | 说明 (English)       |
+| ------------ | -------------- | -------------------- |
+| `projects`   | 项目           | project              |
+| `packages`   | 包             | packages             |
+| `components` | 组件           | components           |
+| `hooks`      | 钩子函数       | hook functions       |
+| `utils`      | 工具函数       | utils functions      |
+| `types`      | TS 类型声明    | TS declaration       |
+| `styles`     | 代码风格       | style                |
+| `deps`       | 项目依赖       | project dependencies |
+| `release`    | 发布项目新版本 | release project      |
+| `other`      | 其他变更       | other changes        |
+
+### 配置示例
+
+#### 1. 追加自定义提交类型和范围
+
+```ts
+// soybean.config.ts
+import { defineConfig } from '@soybeanjs/cli';
+
+export default defineConfig({
+  lang: 'zh-cn', // 项目默认使用中文
+
+  gitCommit: {
+    // 追加自定义 types（在默认 types 基础上添加）
+    types: [
+      ['wip', '工作进行中'],
+      ['merge', '合并分支'],
+      ['i18n', '国际化相关']
+    ],
+
+    // 追加自定义 scopes
+    scopes: [
+      ['ui', 'UI 组件'],
+      ['store', '状态管理'],
+      ['api', 'API 接口']
+    ]
+  }
+});
 ```
 
-## 命令介绍
+#### 2. 完全覆盖默认提交类型和范围
 
-| 命令              | 作用                                                                                 |
-| ----------------- | ------------------------------------------------------------------------------------ |
-| help(-h)          | 查看全部命令用法                                                                     |
-| git-commit        | 生成符合 Angular 规范的 git 提交信息 (在提交信息添加前缀`!`可以表示破坏性更新的提交) |
-| git-commit-verify | 校验 git 的提交信息是否符合 Angular 规范                                             |
-| cleanup           | 清空依赖和构建产物                                                                   |
-| ncu               | 命令 npm-check-updates, 升级依赖                                                     |
-| changelog         | 根据两次 tag 生成 changelog (--total: 根据所有 tag 生成 changelog)                   |
-| release           | 发布：更新版本号、生成 changelog、提交代码                                           |
+```ts
+// soybean.config.ts
+import { defineConfig } from '@soybeanjs/cli';
 
-## 更多自定义配置
+export default defineConfig({
+  gitCommit: {
+    // 完全覆盖默认 types
+    types: [
+      ['feat', '新功能'],
+      ['fix', '修复'],
+      ['docs', '文档']
+    ],
+    typesAppend: false, // 不追加，完全覆盖
 
-- 在项目根目录新建 soybean-config.ts
+    // 完全覆盖默认 scopes
+    scopes: [
+      ['frontend', '前端'],
+      ['backend', '后端'],
+      ['shared', '共享代码']
+    ],
+    scopesAppend: false
+  }
+});
+```
 
-- 导入 defineConfig 函数
+#### 3. 修改默认清理目录
 
-  ```ts
-  import { defineConfig } from '@soybeanjs/cli';
+```ts
+// soybean.config.ts
+import { defineConfig } from '@soybeanjs/cli';
 
-  export default defineConfig({
-    // options
-  });
-  ```
+export default defineConfig({
+  cleanupDirs: ['**/dist', '**/.cache', '**/coverage', '**/node_modules', '!node_modules/**']
+});
+```
+
+### package.json 脚本配置示例
+
+```json
+{
+  "scripts": {
+    "commit": "soy git-commit",
+    "commit:zh": "soy git-commit -l=zh-cn",
+    "cleanup": "soy cleanup",
+    "ncu": "soy ncu",
+    "changelog": "soy changelog",
+    "release": "soy release"
+  }
+}
+```
 
-- 配置参考
+## License
 
-  ```ts
-  import type { CliOption } from '@soybeanjs/cli';
-  ```
+[MIT](./LICENSE)

package/dist/index.d.ts

@@ -1,5 +1,57 @@
 import { ChangelogOption } from "@soybeanjs/changelog";
+//#region src/locales/index.d.ts
+type Lang = 'zh-cn' | 'en-us';
+//#endregion
 //#region src/types/index.d.ts
+type CommitItem = [string, string];
+interface GitCommitConfig {
+  /**
+   * Commit types
+   *
+   * If not set, it will use the default types
+   *
+   * @example
+   * ```ts
+   * {
+   *   types: [
+   *     ['feat', '新功能'],
+   *     ['wip', '工作进行中']
+   *   ],
+   *   typesAppend: true // append to defaults, set to false to overwrite
+   * }
+   * ```
+   */
+  types?: CommitItem[];
+  /**
+   * Whether to append custom types to defaults or overwrite
+   *
+   * @default true
+   */
+  typesAppend?: boolean;
+  /**
+   * Commit scopes
+   *
+   * If not set, it will use the default scopes
+   *
+   * @example
+   * ```ts
+   * {
+   *   scopes: [
+   *     ['ui', 'UI 相关'],
+   *     ['api', 'API 相关']
+   *   ],
+   *   scopesAppend: true // append to defaults, set to false to overwrite
+   * }
+   * ```
+   */
+  scopes?: CommitItem[];
+  /**
+   * Whether to append custom scopes to defaults or overwrite
+   *
+   * @default true
+   */
+  scopesAppend?: boolean;
+}
 interface CliOption {
   /** The project root directory */
   cwd: string;
@@ -28,6 +80,18 @@ interface CliOption {
   changelogOptions: Partial<ChangelogOption>;
   /** The ignore pattern list of git commit verify */
   gitCommitVerifyIgnores: RegExp[];
+  /**
+   * Git commit config for types and scopes
+   */
+  gitCommit?: GitCommitConfig;
+  /**
+   * Default display language of cli
+   *
+   * Can be 'zh-cn' or 'en-us'
+   *
+   * @default 'en-us'
+   */
+  lang?: Lang;
 }
 //#endregion
 //#region src/index.d.ts

package/dist/index.js

@@ -1,61 +1,21 @@
 #!/usr/bin/env node
 import { cac } from "cac";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import process$1 from "node:process";
 import { loadConfig } from "c12";
-import { readFileSync } from "node:fs";
+import { bgRed, green, red, yellow } from "kolorist";
 import path, { join, posix } from "node:path";
 import enquirer from "enquirer";
-import { bgRed, green, red, yellow } from "kolorist";
 import { rimraf } from "rimraf";
 import { readFile } from "node:fs/promises";
 import { glob } from "tinyglobby";
-import { existsSync } from "fs";
+import { existsSync as existsSync$1 } from "fs";
 import { join as join$1 } from "path";
 import { generateChangelog, generateTotalChangelog } from "@soybeanjs/changelog";
 import { versionBump } from "bumpp";
+import { consola } from "consola";
 //#region package.json
-var version = "1.7.4";
-//#endregion
-//#region src/config/index.ts
-const defaultOptions = {
-	cwd: process$1.cwd(),
-	cleanupDirs: [
-		"**/dist",
-		"**/package-lock.json",
-		"**/yarn.lock",
-		"**/pnpm-lock.yaml",
-		"**/node_modules",
-		"!node_modules/**"
-	],
-	ncuCommandArgs: [],
-	changelogOptions: {},
-	gitCommitVerifyIgnores: [
-		/^((Merge pull request)|(Merge (.*?) into (.*?)|(Merge branch (.*?)))(?:\r?\n)*$)/m,
-		/^(Merge tag (.*?))(?:\r?\n)*$/m,
-		/^(R|r)evert (.*)/,
-		/^(amend|fixup|squash)!/,
-		/^(Merged (.*?)(in|into) (.*)|Merged PR (.*): (.*))/,
-		/^Merge remote-tracking branch(\s*)(.*)/,
-		/^Automatic merge(.*)/,
-		/^Auto-merged (.*?) into (.*)/
-	]
-};
-async function loadCliOptions(overrides, cwd = process$1.cwd()) {
-	const { config } = await loadConfig({
-		name: "soybean",
-		defaults: defaultOptions,
-		overrides,
-		cwd,
-		packageJson: true
-	});
-	return config;
-}
-//#endregion
-//#region src/shared/index.ts
-async function execCommand(cmd, args, options) {
-	const { execa } = await import("execa");
-	return ((await execa(cmd, args, options))?.stdout)?.trim() || "";
-}
+var version = "1.8.0";
 //#endregion
 //#region src/locales/index.ts
 const locales = {
@@ -129,21 +89,125 @@ const locales = {
 	}
 };
 //#endregion
+//#region src/config/index.ts
+const defaultGitCommitVerifyIgnores = [
+	/^((Merge pull request)|(Merge (.*?) into (.*?)|(Merge branch (.*?)))(?:\r?\n)*$)/m,
+	/^(Merge tag (.*?))(?:\r?\n)*$/m,
+	/^(R|r)evert (.*)/,
+	/^(amend|fixup|squash)!/,
+	/^(Merged (.*?)(in|into) (.*)|Merged PR (.*): (.*))/,
+	/^Merge remote-tracking branch(\s*)(.*)/,
+	/^Automatic merge(.*)/,
+	/^Auto-merged (.*?) into (.*)/
+];
+const defaultOptions = {
+	cwd: process$1.cwd(),
+	cleanupDirs: [
+		"**/dist",
+		"**/package-lock.json",
+		"**/yarn.lock",
+		"**/pnpm-lock.yaml",
+		"**/node_modules",
+		"!node_modules/**"
+	],
+	ncuCommandArgs: [],
+	changelogOptions: {},
+	gitCommitVerifyIgnores: defaultGitCommitVerifyIgnores,
+	gitCommit: {
+		typesAppend: true,
+		scopesAppend: true
+	},
+	lang: "en-us"
+};
+function mergeCommitItems(defaults, custom, append = true) {
+	if (!custom || custom.length === 0) return defaults;
+	if (!append) return custom;
+	const existing = new Map(defaults);
+	for (const [key, value] of custom) existing.set(key, value);
+	return Array.from(existing.entries());
+}
+function resolveGitCommitConfig(config, lang) {
+	const gitCommitConfig = config.gitCommit || {};
+	const defaultLocale = locales[lang] || locales["en-us"];
+	const defaultTypes = defaultLocale.gitCommitTypes;
+	const defaultScopes = defaultLocale.gitCommitScopes;
+	return {
+		types: mergeCommitItems(defaultTypes, gitCommitConfig.types, gitCommitConfig.typesAppend !== false),
+		scopes: mergeCommitItems(defaultScopes, gitCommitConfig.scopes, gitCommitConfig.scopesAppend !== false),
+		typesAppend: gitCommitConfig.typesAppend !== false,
+		scopesAppend: gitCommitConfig.scopesAppend !== false
+	};
+}
+function readGlobalConfig$1() {
+	const globalConfigPath = getGlobalConfigPath();
+	if (!existsSync(globalConfigPath)) return {};
+	try {
+		const content = readFileSync(globalConfigPath, "utf8");
+		return JSON.parse(content);
+	} catch {
+		return {};
+	}
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof RegExp) && !(value instanceof Date);
+}
+function deepMerge(target, source) {
+	const result = { ...target };
+	for (const key of Object.keys(source)) {
+		const sourceVal = source[key];
+		const targetVal = result[key];
+		if (sourceVal !== void 0) if (isPlainObject(sourceVal) && isPlainObject(targetVal)) result[key] = deepMerge(targetVal, sourceVal);
+		else result[key] = sourceVal;
+	}
+	return result;
+}
+async function loadCliOptions(overrides, cwd = process$1.cwd()) {
+	const { config: projectConfig } = await loadConfig({
+		name: "soybean",
+		defaults: {},
+		overrides,
+		cwd,
+		packageJson: true,
+		rcFile: false
+	});
+	const globalConfig = readGlobalConfig$1();
+	let mergedConfig = deepMerge({ ...defaultOptions }, globalConfig);
+	mergedConfig = deepMerge(mergedConfig, projectConfig);
+	const resolvedConfig = mergedConfig;
+	if (resolvedConfig.gitCommitVerifyIgnores) resolvedConfig.gitCommitVerifyIgnores = [...defaultGitCommitVerifyIgnores, ...resolvedConfig.gitCommitVerifyIgnores.filter((item) => !defaultGitCommitVerifyIgnores.some((def) => def.toString() === item.toString()))];
+	const lang = resolvedConfig.lang || "en-us";
+	resolvedConfig.gitCommit = resolveGitCommitConfig(resolvedConfig, lang);
+	resolvedConfig.lang = lang;
+	return resolvedConfig;
+}
+function getGlobalConfigPath() {
+	return `${process$1.env.HOME || process$1.env.USERPROFILE || "."}/.soybeanrc`;
+}
+//#endregion
+//#region src/shared/index.ts
+async function execCommand(cmd, args, options) {
+	const { execa } = await import("execa");
+	return ((await execa(cmd, args, options))?.stdout)?.trim() || "";
+}
+//#endregion
 //#region src/command/git-commit.ts
 /**
 * Git commit with Conventional Commits standard
 *
-* @param lang
+* @param options
 */
-async function gitCommit(lang = "en-us") {
-	const { gitCommitMessages, gitCommitTypes, gitCommitScopes } = locales[lang];
-	const typesChoices = gitCommitTypes.map(([value, msg]) => {
+async function gitCommit(options = {}) {
+	const lang = options.lang || "en-us";
+	const { gitCommitMessages } = locales[lang];
+	const types = options.types || locales[lang].gitCommitTypes;
+	const scopes = options.scopes || locales[lang].gitCommitScopes;
+	const typesChoices = types.map(([value, msg]) => {
 		return {
 			name: value,
 			message: `${`${value}:`.padEnd(12)}${msg}`
 		};
 	});
-	const scopesChoices = gitCommitScopes.map(([value, msg]) => ({
+	const scopesChoices = scopes.map(([value, msg]) => ({
 		name: value,
 		message: `${value.padEnd(30)} (${msg})`
 	}));
@@ -257,7 +321,7 @@ async function resolveDefaultNcuArgs(cwd = process$1.cwd()) {
 //#endregion
 //#region src/command/changelog.ts
 async function genChangelog(options, total = false) {
-	const hasChangelog = existsSync(join$1(process.cwd(), "CHANGELOG.md"));
+	const hasChangelog = existsSync$1(join$1(process.cwd(), "CHANGELOG.md"));
 	if (total) await generateTotalChangelog(options);
 	else await generateChangelog(options);
 	if (!hasChangelog) await execCommand("git", ["add", "CHANGELOG.md"]);
@@ -275,15 +339,54 @@ async function release(execute = "pnpm soy changelog", push = true) {
 	});
 }
 //#endregion
+//#region src/command/config.ts
+function readGlobalConfig() {
+	const filePath = getGlobalConfigPath();
+	if (!existsSync(filePath)) return {};
+	try {
+		const content = readFileSync(filePath, "utf8");
+		return JSON.parse(content);
+	} catch {
+		consola.warn(`Failed to parse global config at ${filePath}, will create new one.`);
+		return {};
+	}
+}
+function writeGlobalConfig(config) {
+	writeFileSync(getGlobalConfigPath(), JSON.stringify(config, null, 2), "utf8");
+}
+async function configSet(options) {
+	const config = readGlobalConfig();
+	if (options.lang) {
+		if (options.lang !== "zh-cn" && options.lang !== "en-us") {
+			consola.error(`Invalid language: ${options.lang}. Supported values: 'zh-cn', 'en-us'`);
+			return;
+		}
+		config.lang = options.lang;
+		writeGlobalConfig(config);
+		consola.success(`Default language set to ${green(options.lang)}`);
+		consola.info(`Config file: ${yellow(getGlobalConfigPath())}`);
+	}
+}
+async function configGet() {
+	const config = await loadCliOptions();
+	consola.log("\nCurrent configuration:");
+	consola.log(`  ${green("lang")}:         ${config.lang}`);
+	consola.log(`  ${green("cwd")}:          ${config.cwd}`);
+	consola.log(`  ${green("global config")}: ${getGlobalConfigPath()}\n`);
+}
+async function configPath() {
+	consola.log(getGlobalConfigPath());
+}
+//#endregion
 //#region src/index.ts
 async function setupCli() {
 	const cliOptions = await loadCliOptions();
 	const cli = cac("soybean");
-	cli.version(version).option("-e, --execute [command]", "Execute additional command after bumping and before git commit. Defaults to 'pnpm soy changelog'").option("-p, --push", "Indicates whether to push the git commit and tag").option("-t, --total", "Generate changelog by total tags").option("-c, --cleanupDir <dir>", "The glob pattern of dirs to cleanup, If not set, it will use the default value, Multiple values use \",\" to separate them").option("-l, --lang <lang>", "display lang of cli", {
-		default: "en-us",
+	cli.version(version).option("-e, --execute [command]", "Execute additional command after bumping and before git commit. Defaults to 'pnpm soy changelog'").option("-p, --push", "Indicates whether to push the git commit and tag").option("-t, --total", "Generate changelog by total tags").option("-c, --cleanupDir <dir>", "The glob pattern of dirs to cleanup, If not set, it will use the default value, Multiple values use \",\" to separate them").option("-l, --lang <lang>", `display lang of cli (default: ${cliOptions.lang})`, {
+		default: cliOptions.lang,
 		type: [String]
 	}).help();
-	const commands = {
+	const simpleCommands = {
 		cleanup: {
 			desc: "delete dirs: node_modules, dist, etc.",
 			action: async (args) => {
@@ -307,13 +410,17 @@ async function setupCli() {
 		"git-commit": {
 			desc: "git commit, generate commit message which match Conventional Commits standard",
 			action: async (args) => {
-				await gitCommit(args?.lang);
+				await gitCommit({
+					lang: args?.lang || cliOptions.lang,
+					types: cliOptions.gitCommit?.types,
+					scopes: cliOptions.gitCommit?.scopes
+				});
 			}
 		},
 		"git-commit-verify": {
 			desc: "verify git commit message, make sure it match Conventional Commits standard",
 			action: async (args) => {
-				await gitCommitVerify(args?.lang, cliOptions.gitCommitVerifyIgnores);
+				await gitCommitVerify(args?.lang || cliOptions.lang, cliOptions.gitCommitVerifyIgnores);
 			}
 		},
 		changelog: {
@@ -329,7 +436,24 @@ async function setupCli() {
 			}
 		}
 	};
-	for await (const [command, { desc, action }] of Object.entries(commands)) cli.command(command, desc).action(action);
+	for (const [cmdName, { desc, action }] of Object.entries(simpleCommands)) cli.command(cmdName, desc).action(action);
+	cli.command("config <cmd>", "manage cli configuration (set|get|path)").option("--set-lang <lang>", "Set default language (zh-cn or en-us)").action(async (cmd, options) => {
+		switch (cmd) {
+			case "set":
+				await configSet({ lang: options.setLang });
+				break;
+			case "get":
+				await configGet();
+				break;
+			case "path":
+				await configPath();
+				break;
+			default:
+				console.error(`Unknown config subcommand: ${cmd}`);
+				console.log("Available subcommands: set, get, path");
+				process.exit(1);
+		}
+	});
 	cli.parse();
 }
 setupCli();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soybeanjs/cli",
-  "version": "1.7.4",
+  "version": "1.8.0",
   "description": "SoybeanJS's command line tools",
   "homepage": "https://github.com/soybeanjs/cli",
   "bugs": {
@@ -37,7 +37,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@soybeanjs/changelog": "^0.4.7",
+    "@soybeanjs/changelog": "^0.5.2",
     "bumpp": "^12.0.0",
     "c12": "^3.3.4",
     "cac": "^7.0.0",