@share-crm/sharedev-cli 0.0.4-rc.32 → 0.0.4-rc.33

package/dist/sharedev.js

@@ -9611,6 +9611,90 @@ function registerApprovalNamespace(program, runtimeContext) {
 }
 
 
+/***/ },
+
+/***/ 9959
+(__unused_webpack_module, exports, __webpack_require__) {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.registerBiNamespace = registerBiNamespace;
+const index_ts_1 = __webpack_require__(1474);
+/**
+ * 注册 bi 命名空间（透传命令，全部参数直接透传操作中心 data）
+ * 命令路径与操作中心 commandPath 完全一致，通过 PassthroughCommandManager 声明一次即可
+ */
+function registerBiNamespace(program, runtimeContext) {
+    const bi = program.command('bi').description('BI development workspace commands');
+    const passthrough = new index_ts_1.PassthroughCommandManager(bi, { namespace: 'bi', runtimeContext });
+    passthrough
+        .command('dev-goal')
+        .command('goal-list-rules')
+        .description('List goal rules via shareCli execute (passthrough to operation center)')
+        .option('--name <name>', 'Goal rule name')
+        .option('--page-size <number>', 'Page size (number)', (value) => parseInt(value, 10))
+        .option('--page-number <number>', 'Page number (number)', (value) => parseInt(value, 10))
+        .option('--goal-rule-id <goalRuleId>', 'Goal rule id')
+        .option('--goal-rule-detail-id <goalRuleDetailId>', 'Goal rule detail id')
+        .option('--time-zone-list <list>', 'Time zone list (comma separated, converted to array)', (value) => value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean))
+        .route({
+        examples: [
+            '$ sharedev bi dev-goal goal-list-rules --name demo --page-size 10 --page-number 1 --time-zone-list "Asia/Shanghai,UTC"',
+        ],
+    });
+    passthrough
+        .command('dev-goal')
+        .command('goal-get-rule')
+        .description('Get goal rule via shareCli execute (passthrough to operation center)')
+        .requiredOption('--rule-id <ruleId>', 'Goal rule id')
+        .map('ruleId', 'rule_id')
+        .route({
+        examples: [
+            '$ sharedev bi dev-goal goal-get-rule --rule-id xxx',
+        ],
+    });
+    passthrough
+        .command('dev-goal')
+        .command('goal-get-value-header')
+        .description('Get goal value header via shareCli execute (passthrough to operation center)')
+        .requiredOption('--goal-rule-id <goalRuleId>', 'Goal rule id')
+        .requiredOption('--fiscal-year <fiscalYear>', 'Fiscal year')
+        .map('goalRuleId', 'goal_rule_id')
+        .map('fiscalYear', 'fiscal_year')
+        .route({
+        examples: [
+            '$ sharedev bi dev-goal goal-get-value-header --goal-rule-id xxx --fiscal-year 2026',
+        ],
+    });
+    passthrough
+        .command('dev-goal')
+        .command('goal-list-values')
+        .description('List goal values via shareCli execute (passthrough to operation center)')
+        .requiredOption('--object-describe-api-name <objectDescribeApiName>', 'Object describe api name')
+        .requiredOption('--search-query-info <searchQueryInfo>', 'Search query info')
+        .map('objectDescribeApiName', 'object_describe_api_name')
+        .map('searchQueryInfo', 'search_query_info')
+        .route({
+        examples: [
+            '$ sharedev bi dev-goal goal-list-values --object-describe-api-name AccountObj --search-query-info "{}"',
+        ],
+    });
+    passthrough
+        .command('dev-goal')
+        .command('goal-save-values')
+        .description('Save goal values via shareCli execute (passthrough to operation center)')
+        .requiredOption('--datas <json>', 'Goal values data (JSON string, parsed to array/object)', (value) => JSON.parse(value))
+        .route({
+        examples: [
+            '$ sharedev bi dev-goal goal-save-values --datas \'[{"name":"a"},{"name":"b"}]\'',
+        ],
+    });
+}
+
+
 /***/ },
 
 /***/ 4781
@@ -10938,6 +11022,7 @@ const interface_dev_ts_1 = __webpack_require__(8965);
 const sales_ts_1 = __webpack_require__(4056);
 const data_ts_1 = __webpack_require__(7170);
 const email_ts_1 = __webpack_require__(4952);
+const bi_ts_1 = __webpack_require__(9959);
 const access_ts_1 = __webpack_require__(1696);
 const app_dev_ts_1 = __webpack_require__(4041);
 function registerNamespaces(program, context) {
@@ -10964,6 +11049,7 @@ function registerNamespaces(program, context) {
     (0, sales_ts_1.registerSalesNamespace)(program, context);
     (0, data_ts_1.registerDataNamespace)(program, context);
     (0, email_ts_1.registerEmailNamespace)(program, context);
+    (0, bi_ts_1.registerBiNamespace)(program, context);
     (0, access_ts_1.registerAccessNamespace)(program, context);
     (0, app_dev_ts_1.registerAppDevNamespace)(program, context);
 }
@@ -14123,6 +14209,259 @@ const fetchLatestNpmVersion = (packageName, timeoutMs = 1500) => new Promise((re
 exports.fetchLatestNpmVersion = fetchLatestNpmVersion;
 
 
+/***/ },
+
+/***/ 1474
+(__unused_webpack_module, exports, __webpack_require__) {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.PassthroughCommandBuilder = exports.PassthroughCommandManager = void 0;
+const command_ts_1 = __webpack_require__(528);
+const logger_ts_1 = __webpack_require__(3333);
+const request_execute_ts_1 = __webpack_require__(8554);
+const isShareCliExecuteResponse = (value) => Boolean(value && typeof value === 'object');
+/**
+ * 解析 --data JSON 字符串为对象（空值返回空对象）
+ */
+const parsePassthroughJson = (raw) => {
+    if (typeof raw !== 'string' || !raw.trim()) {
+        throw new Error('--data must be a valid JSON string.');
+    }
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('--data must be a JSON object.');
+    }
+    return parsed;
+};
+/**
+ * 将 commander 短横线选项名转为小驼峰（--obj-desc-api-name -> objDescApiName）
+ * 与 commander 内部 opts() 的属性名转换规则保持一致
+ */
+const kebabToCamel = (name) => {
+    const trimmed = name.replace(/^--?/, '');
+    const segments = trimmed.split('-').filter(Boolean);
+    return segments[0] + segments.slice(1).map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1)).join('');
+};
+/**
+ * 从 commander 命令层级收集 CLI 路径（不含根 program 可执行名）
+ * page -> ['page']；object-dev > print-template > page -> ['object-dev', 'print-template', 'page']
+ */
+const resolveCommandPathFromCli = (command) => {
+    const names = [];
+    let current = command;
+    while (current && current.parent) {
+        names.unshift(current.name());
+        current = current.parent;
+    }
+    return names;
+};
+/**
+ * 在父命令下查找或创建子命令：多个透传命令共享同一层级（如多个 dev-goal 子命令）时复用已有命令
+ */
+const findOrCreateCommand = (parent, name) => {
+    const existing = parent.commands.find((command) => command.name() === name);
+    return existing ?? parent.command(name);
+};
+/**
+ * 透传命令管理器
+ *
+ * 用于 CLI 指令路径与操作中心 commandPath 一致、参数直接透传后端的命令注册。
+ * 包装 commander 保持链式调用语法，自动完成：
+ * - CLI 短横线参数自动转换为接口接受的小驼峰参数（commander opts 原生行为）
+ * - 通过 .requiredOption() 声明参数必需性
+ * - 可选 .dataOption() 提供 --data 原样 JSON 合并
+ * - 自动提供 --yes 透传 NEED_CONFIRM 确认标记
+ * - 统一处理响应（success === true && code === 'OK' 判定成功）
+ *
+ * 用法：
+ * ```ts
+ * const passthrough = new PassthroughCommandManager(objectDev, {
+ *     namespace: 'object-dev',
+ *     runtimeContext
+ * });
+ * // 方式一：显式指定操作中心 commandPath
+ * passthrough
+ *     .command('page')
+ *     .description('Page print templates')
+ *     .option('--obj-desc-api-name <apiName>', 'Object describe api name')
+ *     .option('--page-number <number>', 'Page number', parseInt)
+ *     .requiredOption('--template-id <templateId>', 'Template id')
+ *     .route({ commandPath: getShareCliCommandPath('printTemplate', 'page') });
+ *
+ * // 方式二：不传 commandPath，自动收集 CLI 命令层级路径（object-dev print-template page -> 对应数组）
+ * passthrough
+ *     .command('page')
+ *     .option('--obj-desc-api-name <apiName>', 'Object describe api name')
+ *     .route();
+ * ```
+ */
+class PassthroughCommandManager {
+    constructor(command, options) {
+        this.parentCommand = command;
+        this.options = options;
+    }
+    /**
+     * 创建透传子命令（commander 链式入口）；已存在同名子命令时复用（共享层级）
+     */
+    command(name) {
+        return new PassthroughCommandBuilder(findOrCreateCommand(this.parentCommand, name), this.options);
+    }
+}
+exports.PassthroughCommandManager = PassthroughCommandManager;
+/**
+ * 透传子命令构建器：包装 commander Command，保持链式调用语法
+ */
+class PassthroughCommandBuilder {
+    constructor(command, options) {
+        /** CLI 行为参数（不透传至后端），记录 commander opts 中的小驼峰键名 */
+        this.rawKeys = [];
+        /** 自定义参数名转换规则：commander opts 小驼峰键名 -> 后端字段名（如 ruleId -> rule_id） */
+        this.paramMappings = new Map();
+        /** 是否启用 --data 原样 JSON 合并 */
+        this.dataEnabled = false;
+        this.childCommand = command;
+        this.options = options;
+    }
+    /**
+     * 嵌套创建透传子命令（commander 链式入口），用于多级 CLI 路径（如 object-dev > print-template > page）
+     * 已存在同名子命令时复用（多个透传命令共享同一层级）
+     */
+    command(name) {
+        return new PassthroughCommandBuilder(findOrCreateCommand(this.childCommand, name), this.options);
+    }
+    /**
+     * 命令描述（commander 原生语法）
+     */
+    description(text) {
+        this.childCommand.description(text);
+        return this;
+    }
+    /**
+     * 声明透传参数（commander 原生语法，短横线参数自动转小驼峰透传）
+     * @param flags commander 选项声明，如 '--obj-desc-api-name <apiName>'
+     * @param description 选项描述
+     * @param parseArg 可选值解析函数（如 parseInt 转数字），commander 原生支持
+     */
+    option(flags, description, parseArg) {
+        if (parseArg) {
+            this.childCommand.option(flags, description ?? '', parseArg);
+        }
+        else {
+            this.childCommand.option(flags, description);
+        }
+        return this;
+    }
+    /**
+     * 声明必填透传参数（commander 原生语法，缺失时 commander 自动报错退出）
+     */
+    requiredOption(flags, description, parseArg) {
+        if (parseArg) {
+            this.childCommand.requiredOption(flags, description ?? '', parseArg);
+        }
+        else {
+            this.childCommand.requiredOption(flags, description);
+        }
+        return this;
+    }
+    /**
+     * 声明 CLI 行为参数（不透传至后端），如 --json 输出开关
+     */
+    rawOption(flags, description) {
+        this.childCommand.option(flags, description);
+        this.rawKeys.push(kebabToCamel(flags));
+        return this;
+    }
+    /**
+     * 自定义参数名转换规则：默认短横线参数自动转小驼峰透传，当后端字段名与默认转换不一致时使用
+     * 如 CLI --rule-id（默认转 ruleId），后端要求 rule_id：.map('ruleId', 'rule_id')
+     * @param cliKey commander opts 中的小驼峰键名
+     * @param backendKey 透传给后端的字段名
+     */
+    map(cliKey, backendKey) {
+        this.paramMappings.set(cliKey, backendKey);
+        return this;
+    }
+    /**
+     * 启用 --data <json>：JSON 原样解析后合并进操作中心 data（兼容旧透传用法）
+     */
+    dataOption(description) {
+        this.childCommand.option('--data <json>', description ?? 'Request body (JSON), merged into operation center data');
+        this.dataEnabled = true;
+        return this;
+    }
+    /**
+     * 追加 help 示例
+     */
+    examples(lines) {
+        this.childCommand.addHelpText('after', `\nExamples:\n${lines.map((line) => `  ${line}`).join('\n')}`);
+        return this;
+    }
+    /**
+     * 绑定操作中心 commandPath 并注册自动透传 action（链式收尾）
+     * 收集全部声明的透传参数（短横线已转小驼峰），排除 CLI 行为参数与 --data/--yes
+     * commandPath 缺省时自动收集当前 CLI 命令层级路径作为操作中心 commandPath
+     */
+    route(options = {}) {
+        const { commandPath, description, examples, yes } = options;
+        const resolvedCommandPath = commandPath ?? resolveCommandPathFromCli(this.childCommand);
+        if (description) {
+            this.childCommand.description(description);
+        }
+        if (examples && examples.length > 0) {
+            this.examples(examples);
+        }
+        if (yes !== false) {
+            this.childCommand.option('--yes', 'Skip confirmation if the command returns NEED_CONFIRM');
+        }
+        const traceName = resolvedCommandPath.join('.');
+        this.childCommand.action((0, command_ts_1.createCommandAction)(this.options.namespace, traceName, this.options.runtimeContext, async ({ options: rawOptions }) => {
+            const raw = rawOptions;
+            const data = {};
+            // --data JSON 原样合并（声明后优先，独立参数叠加其后）
+            if (this.dataEnabled && raw.data !== undefined) {
+                Object.assign(data, parsePassthroughJson(raw.data));
+            }
+            // 收集声明的透传参数：commander 已将短横线参数转为小驼峰，排除 CLI 行为参数与保留参数
+            for (const [key, value] of Object.entries(raw)) {
+                if (key === 'data' || key === 'yes') {
+                    continue;
+                }
+                if (this.rawKeys.includes(key)) {
+                    continue;
+                }
+                if (value === undefined) {
+                    continue;
+                }
+                // 应用自定义参数名转换规则（如 ruleId -> rule_id），未声明时保持默认小驼峰
+                const backendKey = this.paramMappings.get(key) ?? key;
+                data[backendKey] = value;
+            }
+            // --yes 透传 NEED_CONFIRM 确认标记
+            const others = raw.yes === true ? { yes: true } : undefined;
+            logger_ts_1.loggerService.startLoading(`${resolvedCommandPath.join(' ')} ...`);
+            try {
+                const response = await (0, request_execute_ts_1.executeShareCliCommand)(resolvedCommandPath, data, others);
+                if (!isShareCliExecuteResponse(response)) {
+                    logger_ts_1.loggerService.error('Invalid response from operation center.');
+                    return;
+                }
+                if (!(response.success === true && response.code === 'OK')) {
+                    logger_ts_1.loggerService.error(response.message || 'Unknown error.');
+                    return;
+                }
+                logger_ts_1.loggerService.success(`${resolvedCommandPath.join(' ')} executed.`);
+            }
+            finally {
+                logger_ts_1.loggerService.stopLoading();
+            }
+        }));
+        return this;
+    }
+}
+exports.PassthroughCommandBuilder = PassthroughCommandBuilder;
+
+
 /***/ },
 
 /***/ 2351
@@ -14545,9 +14884,18 @@ const logger_ts_1 = __webpack_require__(3333);
 const trace_ts_1 = __webpack_require__(3632);
 const debug_ts_1 = __webpack_require__(654);
 const pkgMeta_ts_1 = __webpack_require__(5016);
+const normalize_ts_1 = __importDefault(__webpack_require__(9268));
 function generateTraceId() {
     return `E-E.cli-sharedev-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
+/**
+ * 检测当前系统语言并归一化为 Accept-Language 头值（如 zh-CN / en-US）。
+ * 按 LC_ALL / LC_MESSAGES / LANG 优先级读取环境变量；无法识别时回退 zh-CN（项目默认中文）。
+ */
+function detectSystemLanguage() {
+    const raw = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG;
+    return normalize_ts_1.default.normalizeAcceptLanguage(raw) ?? 'zh-CN';
+}
 function shouldWriteDebugLog(config) {
     if (config?.__sharedevNoDebug || config?.__sharedevSkipInterceptor) {
         return false;
@@ -14639,7 +14987,8 @@ class RequestService {
             baseURL: settings.domain,
             timeout: 30000,
             headers: {
-                Authorization: settings.certificate
+                Authorization: settings.certificate,
+                'Accept-Language': detectSystemLanguage()
             }
         });
         this.axiosInstance.interceptors.request.use((config) => {
@@ -39449,6 +39798,36 @@ const normalizeText = (value) => typeof value === 'string'
     ? value.replace(/[\r\n\t]+/g, ' ').trim()
     : typeof value === 'boolean' || typeof value === 'number' && Number.isFinite(value)
         ? String(value) : '';
+/**
+ * 将系统语言环境变量（如 zh_CN.UTF-8 / en_US.utf8 / zh-CN / de_DE.UTF-8@euro）归一化为 Accept-Language 头格式（如 zh-CN / en-US / zh）。
+ * - 忽略字符集后缀（.UTF-8）与修饰符（@euro）
+ * - 语言转小写、地区转大写
+ * - 无法识别（空 / C / POSIX / 非语言格式）返回 undefined，由调用方决定回退
+ */
+const normalizeAcceptLanguage = (value) => {
+    const raw = normalizeString(value);
+    if (!raw) {
+        return undefined;
+    }
+    const cleaned = raw.split(/[@.]/u, 1)[0].trim();
+    if (!cleaned) {
+        return undefined;
+    }
+    const upper = cleaned.toUpperCase();
+    if (upper === 'C' || upper === 'POSIX') {
+        return undefined;
+    }
+    const [language, region] = cleaned.split(/[_-]/u);
+    const normalizedLanguage = language?.toLowerCase();
+    if (!normalizedLanguage || !/^[a-z]{2,3}$/u.test(normalizedLanguage)) {
+        return undefined;
+    }
+    if (!region) {
+        return normalizedLanguage;
+    }
+    const normalizedRegion = region.toUpperCase();
+    return /^[A-Z]{2}$/u.test(normalizedRegion) ? `${normalizedLanguage}-${normalizedRegion}` : normalizedLanguage;
+};
 const normalizeDateTime = (value) => {
     const timestamp = typeof value === 'number'
         ? value
@@ -39541,7 +39920,7 @@ const compareSemver = (a, b) => {
     }
     return 0;
 };
-const normalize = { normalizeString, asString, isRecord, jsonStringToBoolean, normalizeText, normalizeDateTime, validateLocalKey, parseSemver, compareSemver };
+const normalize = { normalizeString, asString, isRecord, jsonStringToBoolean, normalizeText, normalizeDateTime, validateLocalKey, parseSemver, compareSemver, normalizeAcceptLanguage };
 exports["default"] = normalize;
 
 
@@ -53807,7 +54186,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"application/1d-interleaved-parityfec
 /***/ 8330
 (module) {
 
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@share-crm/sharedev-cli","version":"0.0.4-rc.32","private":false,"description":"sharedev command line tool","type":"module","main":"dist/sharedev.js","bin":{"sharedev":"./bin/cli.mjs"},"author":{"name":"sharecrm-npm"},"files":["dist","bin","README.md"],"scripts":{"build":"tsc --noEmit && webpack --config build/webpack/webpack.prod.cjs","build:debug":"tsc --noEmit && webpack --config build/webpack/webpack.debug.cjs","build:bin":"bun build --compile --target=bun-darwin-x64 src/cli.ts --outfile scripts/sharedev-darwin-x64 && bun build --compile --target=bun-darwin-arm64 src/cli.ts --outfile scripts/sharedev-darwin-arm64 && bun build --compile --target=bun-windows-x64 src/cli.ts --outfile scripts/sharedev-windows-x64.exe","build:all":"npm run build && npm run build:bin","dev":"tsc --noEmit --watch & webpack --config build/webpack/webpack.dev.cjs --watch","dev2":"node src/cli.ts","typecheck":"tsc --noEmit","prettier":"prettier --write ./src/**/*.ts","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"dependencies":{"@clack/prompts":"^1.1.0","@mariozechner/pi-coding-agent":"^0.62.0","axios":"~1.13.0","chalk":"^5.6.2","commander":"^14.0.1","extract-zip":"^2.0.1","fast-xml-parser":"^5.2.5","fs-extra":"^11.3.2","lodash-es":"^4.18.1","ora":"^9.3.0","terser-webpack-plugin":"^5.6.1"},"devDependencies":{"@types/extract-zip":"^2.0.3","@types/fs-extra":"^11.0.4","@types/lodash-es":"^4.17.12","@types/node":"^24.3.0","@vitest/coverage-v8":"^4.1.8","ts-loader":"^9.5.4","typescript":"^5.9.2","vitest":"^3.2.6","webpack":"^5.101.3","webpack-cli":"^6.0.1","webpack-merge":"^6.0.1"},"packageManager":"pnpm@10.17.0"}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@share-crm/sharedev-cli","version":"0.0.4-rc.33","private":false,"description":"sharedev command line tool","type":"module","main":"dist/sharedev.js","bin":{"sharedev":"./bin/cli.mjs"},"author":{"name":"sharecrm-npm"},"files":["dist","bin","README.md"],"scripts":{"build":"tsc --noEmit && webpack --config build/webpack/webpack.prod.cjs","build:debug":"tsc --noEmit && webpack --config build/webpack/webpack.debug.cjs","build:bin":"bun build --compile --target=bun-darwin-x64 src/cli.ts --outfile scripts/sharedev-darwin-x64 && bun build --compile --target=bun-darwin-arm64 src/cli.ts --outfile scripts/sharedev-darwin-arm64 && bun build --compile --target=bun-windows-x64 src/cli.ts --outfile scripts/sharedev-windows-x64.exe","build:all":"npm run build && npm run build:bin","dev":"tsc --noEmit --watch & webpack --config build/webpack/webpack.dev.cjs --watch","dev2":"node src/cli.ts","typecheck":"tsc --noEmit","prettier":"prettier --write ./src/**/*.ts","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"dependencies":{"@clack/prompts":"^1.1.0","@mariozechner/pi-coding-agent":"^0.62.0","axios":"~1.13.0","chalk":"^5.6.2","commander":"^14.0.1","extract-zip":"^2.0.1","fast-xml-parser":"^5.2.5","fs-extra":"^11.3.2","lodash-es":"^4.18.1","ora":"^9.3.0","terser-webpack-plugin":"^5.6.1"},"devDependencies":{"@types/extract-zip":"^2.0.3","@types/fs-extra":"^11.0.4","@types/lodash-es":"^4.17.12","@types/node":"^24.3.0","@vitest/coverage-v8":"^4.1.8","ts-loader":"^9.5.4","typescript":"^5.9.2","vitest":"^3.2.6","webpack":"^5.101.3","webpack-cli":"^6.0.1","webpack-merge":"^6.0.1"},"packageManager":"pnpm@10.17.0"}');
 
 /***/ }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@share-crm/sharedev-cli",
-  "version": "0.0.4-rc.32",
+  "version": "0.0.4-rc.33",
   "private": false,
   "description": "sharedev command line tool",
   "type": "module",