@hecom/codearts 0.2.0 → 0.2.1

package/dist/services/business.service.js

@@ -32,6 +32,45 @@ class BusinessService {
         const allMembers = membersResponse.data?.members || [];
         return allMembers.filter((member) => member.role_id === roleId);
     }
+    /**
+     * 获取项目中的所有角色列表（去重）
+     * @param projectId 项目ID
+     * @returns 项目中的所有角色列表
+     */
+    async getProjectRoles(projectId) {
+        // 分页获取所有成员
+        const allMembers = [];
+        const pageSize = 100;
+        let offset = 0;
+        let hasMore = true;
+        while (hasMore) {
+            const membersResponse = await this.apiService.getMembers(projectId, {
+                limit: pageSize,
+                offset: offset,
+            });
+            if (!membersResponse.success) {
+                throw new Error(`获取成员列表失败: ${membersResponse.error || '未知错误'}`);
+            }
+            const members = membersResponse.data?.members.filter((member) => member.role_id !== -1 && member.nick_name != null) || [];
+            allMembers.push(...members);
+            // 判断是否还有更多数据
+            const total = membersResponse.data?.total || 0;
+            offset += pageSize;
+            hasMore = offset < total;
+        }
+        // 使用 Map 去重，key 为 role_id
+        const rolesMap = new Map();
+        allMembers.forEach((member) => {
+            if (!rolesMap.has(member.role_id)) {
+                rolesMap.set(member.role_id, {
+                    role_id: member.role_id,
+                    role_name: member.role_name,
+                });
+            }
+        });
+        // 转换为数组并按 role_id 排序
+        return Array.from(rolesMap.values()).sort((a, b) => a.role_id - b.role_id);
+    }
     /**
      * 获取指定日期之后的迭代列表
      * @param projectId 项目ID
@@ -383,7 +422,7 @@ class BusinessService {
         let pageNo = 1;
         let hasMore = true;
         while (hasMore) {
-            const response = await this.apiService.getChildIssues(projectId, issueId, pageSize, pageNo);
+            const response = await this.apiService.getChildIssuesV2(projectId, issueId, pageSize, pageNo);
             if (!response.success || !response.data) {
                 throw new Error(`获取子工作项失败: ${response.error || '未知错误'}`);
             }
@@ -395,5 +434,31 @@ class BusinessService {
         }
         return allChildIssues;
     }
+    /**
+     * 验证 IAM 凭证是否有效
+     * @returns 验证结果，包含成功状态和可能的错误信息
+     */
+    async validateCredentials() {
+        try {
+            await this.apiService.refreshToken();
+            return { success: true };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMsg };
+        }
+    }
+    /**
+     * 获取项目列表
+     * @param limit 返回的项目数量限制，默认100
+     * @returns 项目列表
+     */
+    async getProjects(limit = 100) {
+        const response = await this.apiService.getProjects({ limit });
+        if (!response.success || !response.data) {
+            throw new Error(response.error || '获取项目列表失败');
+        }
+        return response.data.projects;
+    }
 }
 exports.BusinessService = BusinessService;

package/dist/types/index.d.ts

@@ -152,6 +152,10 @@ export interface ProjectMemberQueryParams {
     offset?: number;
     limit?: number;
 }
+export interface ProjectRole {
+    role_id: number;
+    role_name: string;
+}
 export interface ShowProjectWorkHoursRequest {
     begin_time?: string;
     end_time?: string;
@@ -521,3 +525,42 @@ export interface AllWorkHourStats {
     totalEntries: number;
     userStats: UserAllWorkHourStats[];
 }
+/**
+ * 配置键枚举
+ * 用于类型安全的配置项访问
+ */
+export declare enum ConfigKey {
+    HUAWEI_CLOUD_IAM_ENDPOINT = "HUAWEI_CLOUD_IAM_ENDPOINT",
+    HUAWEI_CLOUD_REGION = "HUAWEI_CLOUD_REGION",
+    HUAWEI_CLOUD_USERNAME = "HUAWEI_CLOUD_USERNAME",
+    HUAWEI_CLOUD_PASSWORD = "HUAWEI_CLOUD_PASSWORD",
+    HUAWEI_CLOUD_DOMAIN = "HUAWEI_CLOUD_DOMAIN",
+    CODEARTS_BASE_URL = "CODEARTS_BASE_URL",
+    PROJECT_ID = "PROJECT_ID",
+    ROLE_ID = "ROLE_ID"
+}
+/**
+ * 不可变配置键（只能通过 config 命令设置）
+ */
+export declare const IMMUTABLE_CONFIG_KEYS: ConfigKey[];
+/**
+ * 可变配置键（可以通过命令行参数覆盖）
+ */
+export declare const MUTABLE_CONFIG_KEYS: ConfigKey[];
+/**
+ * 类型安全的配置映射
+ */
+export type ConfigMap = {
+    [ConfigKey.HUAWEI_CLOUD_IAM_ENDPOINT]: string;
+    [ConfigKey.HUAWEI_CLOUD_REGION]: string;
+    [ConfigKey.HUAWEI_CLOUD_USERNAME]: string;
+    [ConfigKey.HUAWEI_CLOUD_PASSWORD]: string;
+    [ConfigKey.HUAWEI_CLOUD_DOMAIN]: string;
+    [ConfigKey.CODEARTS_BASE_URL]: string;
+    [ConfigKey.PROJECT_ID]: string;
+    [ConfigKey.ROLE_ID]: string;
+};
+/**
+ * 部分配置映射（用于读取配置文件）
+ */
+export type PartialConfigMap = Partial<ConfigMap>;

package/dist/types/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefectAnalysisType = void 0;
+exports.MUTABLE_CONFIG_KEYS = exports.IMMUTABLE_CONFIG_KEYS = exports.ConfigKey = exports.DefectAnalysisType = void 0;
 /**
  * 缺陷技术分析选项枚举
  * custom_field32（缺陷技术分析）字段的选项值枚举定义
@@ -23,3 +23,36 @@ var DefectAnalysisType;
     DefectAnalysisType["USAGE_AND_CONFIG"] = "\u4F7F\u7528\u53CA\u914D\u7F6E\u95EE\u9898";
     DefectAnalysisType["OTHER"] = "\u5176\u4ED6\u95EE\u9898";
 })(DefectAnalysisType || (exports.DefectAnalysisType = DefectAnalysisType = {}));
+/**
+ * 配置键枚举
+ * 用于类型安全的配置项访问
+ */
+var ConfigKey;
+(function (ConfigKey) {
+    // 不可变配置（只能通过 config 命令设置）
+    ConfigKey["HUAWEI_CLOUD_IAM_ENDPOINT"] = "HUAWEI_CLOUD_IAM_ENDPOINT";
+    ConfigKey["HUAWEI_CLOUD_REGION"] = "HUAWEI_CLOUD_REGION";
+    ConfigKey["HUAWEI_CLOUD_USERNAME"] = "HUAWEI_CLOUD_USERNAME";
+    ConfigKey["HUAWEI_CLOUD_PASSWORD"] = "HUAWEI_CLOUD_PASSWORD";
+    ConfigKey["HUAWEI_CLOUD_DOMAIN"] = "HUAWEI_CLOUD_DOMAIN";
+    ConfigKey["CODEARTS_BASE_URL"] = "CODEARTS_BASE_URL";
+    ConfigKey["PROJECT_ID"] = "PROJECT_ID";
+    // 可变配置（可以通过命令行参数覆盖）
+    ConfigKey["ROLE_ID"] = "ROLE_ID";
+})(ConfigKey || (exports.ConfigKey = ConfigKey = {}));
+/**
+ * 不可变配置键（只能通过 config 命令设置）
+ */
+exports.IMMUTABLE_CONFIG_KEYS = [
+    ConfigKey.HUAWEI_CLOUD_IAM_ENDPOINT,
+    ConfigKey.HUAWEI_CLOUD_REGION,
+    ConfigKey.HUAWEI_CLOUD_USERNAME,
+    ConfigKey.HUAWEI_CLOUD_PASSWORD,
+    ConfigKey.HUAWEI_CLOUD_DOMAIN,
+    ConfigKey.CODEARTS_BASE_URL,
+    ConfigKey.PROJECT_ID,
+];
+/**
+ * 可变配置键（可以通过命令行参数覆盖）
+ */
+exports.MUTABLE_CONFIG_KEYS = [ConfigKey.ROLE_ID];

package/dist/utils/config-loader.d.ts

@@ -1,13 +1,27 @@
-import { HuaweiCloudConfig } from '../types';
+import { HuaweiCloudConfig, PartialConfigMap } from '../types';
+/**
+ * 获取全局配置文件路径
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * 检查全局配置文件是否存在
+ */
+export declare function globalConfigExists(): boolean;
+/**
+ * 读取全局配置
+ */
+export declare function readGlobalConfig(): PartialConfigMap;
+/**
+ * 写入全局配置
+ * 支持动态配置项，自动按分组组织配置文件
+ */
+export declare function writeGlobalConfig(config: PartialConfigMap): void;
+/**
+ * 删除全局配置
+ */
+export declare function deleteGlobalConfig(): void;
 export interface CliOptions {
-    projectId?: string;
     roleId?: string;
-    username?: string;
-    password?: string;
-    domain?: string;
-    region?: string;
-    iamEndpoint?: string;
-    codeartsUrl?: string;
 }
 export interface LoadedConfig {
     projectId: string;
@@ -15,8 +29,13 @@ export interface LoadedConfig {
     config: HuaweiCloudConfig;
 }
 /**
- * 加载配置，优先级：命令行参数 > 当前目录 .env > 全局配置 > 默认值
+ * 加载配置，优先级：命令行参数 > 全局配置
  * @param cliOptions 命令行选项
  * @returns 加载的配置
  */
 export declare function loadConfig(cliOptions?: CliOptions): LoadedConfig;
+/**
+ * 获取最终合并后的配置（用于显示）
+ * @returns 合并后的配置映射
+ */
+export declare function getConfig(): PartialConfigMap;

package/dist/utils/config-loader.js

@@ -1,56 +1,220 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalConfigPath = getGlobalConfigPath;
+exports.globalConfigExists = globalConfigExists;
+exports.readGlobalConfig = readGlobalConfig;
+exports.writeGlobalConfig = writeGlobalConfig;
+exports.deleteGlobalConfig = deleteGlobalConfig;
 exports.loadConfig = loadConfig;
-const dotenv_1 = __importDefault(require("dotenv"));
-const global_config_1 = require("./global-config");
-// 加载当前目录的 .env 文件（如果存在）
-dotenv_1.default.config();
+exports.getConfig = getConfig;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const types_1 = require("../types");
+/**
+ * 全局配置管理工具
+ * 配置文件存储在用户主目录下的 .hecom-codearts 目录
+ */
+const CONFIG_DIR = path.join(os.homedir(), '.hecom-codearts');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.env');
+/**
+ * 确保配置目录存在
+ */
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * 获取全局配置文件路径
+ */
+function getGlobalConfigPath() {
+    return CONFIG_FILE;
+}
+/**
+ * 检查全局配置文件是否存在
+ */
+function globalConfigExists() {
+    return fs.existsSync(CONFIG_FILE);
+}
+/**
+ * 读取全局配置
+ */
+function readGlobalConfig() {
+    if (!globalConfigExists()) {
+        return {};
+    }
+    const config = {};
+    try {
+        const content = fs.readFileSync(CONFIG_FILE, 'utf-8');
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const trimmedLine = line.trim();
+            if (!trimmedLine || trimmedLine.startsWith('#')) {
+                continue;
+            }
+            const equalIndex = trimmedLine.indexOf('=');
+            if (equalIndex > 0) {
+                const key = trimmedLine.substring(0, equalIndex).trim();
+                const value = trimmedLine.substring(equalIndex + 1).trim();
+                // 只保存合法的配置键
+                if (Object.values(types_1.ConfigKey).includes(key)) {
+                    config[key] = value;
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error('读取全局配置文件失败:', error);
+    }
+    return config;
+}
+/**
+ * 配置项分组和顺序定义
+ */
+const CONFIG_GROUPS = [
+    {
+        title: '华为云IAM认证端点（根据区域调整）',
+        keys: [types_1.ConfigKey.HUAWEI_CLOUD_IAM_ENDPOINT, types_1.ConfigKey.HUAWEI_CLOUD_REGION],
+    },
+    {
+        title: 'IAM用户凭证',
+        keys: [
+            types_1.ConfigKey.HUAWEI_CLOUD_USERNAME,
+            types_1.ConfigKey.HUAWEI_CLOUD_PASSWORD,
+            types_1.ConfigKey.HUAWEI_CLOUD_DOMAIN,
+        ],
+    },
+    {
+        title: '项目配置',
+        keys: [types_1.ConfigKey.CODEARTS_BASE_URL, types_1.ConfigKey.PROJECT_ID, types_1.ConfigKey.ROLE_ID],
+    },
+];
+/**
+ * 写入全局配置
+ * 支持动态配置项，自动按分组组织配置文件
+ */
+function writeGlobalConfig(config) {
+    ensureConfigDir();
+    // 构建配置文件头部
+    let content = `# Hecom CodeArts 全局配置文件`;
+    // 记录已写入的配置项
+    const writtenKeys = new Set();
+    // 按分组写入配置
+    for (const group of CONFIG_GROUPS) {
+        content += `\n# ${group.title}\n`;
+        for (const key of group.keys) {
+            const value = config[key] || '';
+            content += `${key}=${value}\n`;
+            writtenKeys.add(key);
+        }
+    }
+    // 写入未分组的其他配置项（支持未来扩展）
+    const otherKeys = Object.keys(config).filter((key) => !writtenKeys.has(key));
+    if (otherKeys.length > 0) {
+        content += `\n# 其他配置\n`;
+        for (const key of otherKeys) {
+            const value = config[key] || '';
+            content += `${key}=${value}\n`;
+        }
+    }
+    try {
+        fs.writeFileSync(CONFIG_FILE, content, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`写入全局配置文件失败: ${error}`);
+    }
+}
+/**
+ * 删除全局配置
+ */
+function deleteGlobalConfig() {
+    if (globalConfigExists()) {
+        try {
+            fs.unlinkSync(CONFIG_FILE);
+        }
+        catch (error) {
+            throw new Error(`删除全局配置文件失败: ${error}`);
+        }
+    }
+}
 // 加载全局配置
-const globalConfig = (0, global_config_1.globalConfigExists)() ? (0, global_config_1.readGlobalConfig)() : {};
+const globalConfig = globalConfigExists() ? readGlobalConfig() : {};
 /**
- * 加载配置，优先级：命令行参数 > 当前目录 .env > 全局配置 > 默认值
+ * 加载配置，优先级：命令行参数 > 全局配置
  * @param cliOptions 命令行选项
  * @returns 加载的配置
  */
 function loadConfig(cliOptions = {}) {
-    // 命令行参数 > 当前目录 .env > 全局配置
-    const projectId = cliOptions.projectId || process.env.PROJECT_ID || globalConfig.PROJECT_ID;
-    const roleIdStr = cliOptions.roleId || process.env.ROLE_ID || globalConfig.ROLE_ID;
+    // 命令行参数 > 全局配置
+    const projectId = globalConfig[types_1.ConfigKey.PROJECT_ID];
+    const roleIdStr = cliOptions.roleId || globalConfig[types_1.ConfigKey.ROLE_ID];
     if (!projectId) {
-        throw new Error('缺少必需参数: --project-id 或环境变量 PROJECT_ID\n提示：运行 codearts config 创建配置');
+        throw new Error('缺少项目 ID');
     }
     if (!roleIdStr) {
-        throw new Error('缺少必需参数: --role-id 或环境变量 ROLE_ID\n提示：运行 codearts config 创建配置');
+        throw new Error('缺少角色 ID');
     }
     const roleIds = roleIdStr.split(',').map((id) => parseInt(id.trim()));
     if (roleIds.some((id) => isNaN(id))) {
         throw new Error('ROLE_ID 格式不正确，应为数字或逗号分隔的数字列表');
     }
-    const username = cliOptions.username || process.env.HUAWEI_CLOUD_USERNAME || globalConfig.HUAWEI_CLOUD_USERNAME;
-    const password = cliOptions.password || process.env.HUAWEI_CLOUD_PASSWORD || globalConfig.HUAWEI_CLOUD_PASSWORD;
-    const domain = cliOptions.domain || process.env.HUAWEI_CLOUD_DOMAIN || globalConfig.HUAWEI_CLOUD_DOMAIN;
-    if (!username || !password || !domain) {
-        throw new Error('缺少华为云认证信息: --username, --password, --domain 或对应的环境变量\n提示：运行 codearts config 创建配置');
+    const username = globalConfig[types_1.ConfigKey.HUAWEI_CLOUD_USERNAME];
+    const password = globalConfig[types_1.ConfigKey.HUAWEI_CLOUD_PASSWORD];
+    const domain = globalConfig[types_1.ConfigKey.HUAWEI_CLOUD_DOMAIN];
+    const iamEndpoint = globalConfig[types_1.ConfigKey.HUAWEI_CLOUD_IAM_ENDPOINT];
+    const region = globalConfig[types_1.ConfigKey.HUAWEI_CLOUD_REGION];
+    const endpoint = globalConfig[types_1.ConfigKey.CODEARTS_BASE_URL];
+    if (!username || !password || !domain || !iamEndpoint || !region || !endpoint) {
+        throw new Error('缺少华为云认证信息，请先运行 `npx @hecom/codearts config` 创建配置');
     }
     const config = {
-        iamEndpoint: cliOptions.iamEndpoint ||
-            process.env.HUAWEI_CLOUD_IAM_ENDPOINT ||
-            globalConfig.HUAWEI_CLOUD_IAM_ENDPOINT ||
-            'https://iam.cn-north-4.myhuaweicloud.com',
-        region: cliOptions.region ||
-            process.env.HUAWEI_CLOUD_REGION ||
-            globalConfig.HUAWEI_CLOUD_REGION ||
-            'cn-north-4',
-        endpoint: cliOptions.codeartsUrl ||
-            process.env.CODEARTS_BASE_URL ||
-            globalConfig.CODEARTS_BASE_URL ||
-            'https://projectman-ext.cn-north-4.myhuaweicloud.cn',
+        iamEndpoint,
+        region,
+        endpoint,
         username,
         password,
         domainName: domain,
     };
     return { projectId, roleIds, config };
 }
+/**
+ * 获取最终合并后的配置（用于显示）
+ * @returns 合并后的配置映射
+ */
+function getConfig() {
+    return globalConfig;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hecom/codearts",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "华为云 CodeArts 统计分析工具",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,6 @@
   "files": [
     "dist",
     "bin",
-    ".env.example",
     "README.md"
   ],
   "scripts": {
@@ -47,7 +46,6 @@
   "dependencies": {
     "axios": "^1.5.0",
     "commander": "^12.1.0",
-    "dotenv": "^16.3.1",
     "inquirer": "^9.3.8"
   },
   "devDependencies": {

package/.env.example

@@ -1,20 +0,0 @@
-# 华为云CodeArts API 环境变量配置
-# 复制此文件为 .env 并填入真实的配置值
-
-# 华为云IAM认证端点（根据区域调整）
-HUAWEI_CLOUD_IAM_ENDPOINT=https://iam.cn-north-4.myhuaweicloud.com
-HUAWEI_CLOUD_REGION=cn-north-4
-
-# IAM用户凭证
-HUAWEI_CLOUD_USERNAME=your-iam-username
-HUAWEI_CLOUD_PASSWORD=your-iam-password
-HUAWEI_CLOUD_DOMAIN=your-domain-name
-
-# CodeArts API基础URL（可选，默认根据区域自动生成）
-CODEARTS_BASE_URL=https://projectman-ext.cn-north-4.myhuaweicloud.cn
-
-PROJECT_ID=your-project-id
-
-# 角色ID（支持多个，逗号分隔）
-ROLE_ID=your-role-id
-# 示例：ROLE_ID=1,2,3

package/dist/utils/global-config.d.ts

@@ -1,24 +0,0 @@
-/**
- * 获取全局配置文件路径
- */
-export declare function getGlobalConfigPath(): string;
-/**
- * 检查全局配置文件是否存在
- */
-export declare function globalConfigExists(): boolean;
-/**
- * 读取全局配置
- */
-export declare function readGlobalConfig(): Record<string, string>;
-/**
- * 写入全局配置
- */
-export declare function writeGlobalConfig(config: Record<string, string>): void;
-/**
- * 删除全局配置
- */
-export declare function deleteGlobalConfig(): void;
-/**
- * 获取配置信息（用于显示）
- */
-export declare function getConfigInfo(): string;