@coderpp/yunxiao-cli 0.1.7 → 0.1.8

package/README.md

@@ -1,6 +1,6 @@
 # @coderpp/yunxiao-cli
 
-用于评审和合并云效 Codeup 合并请求的命令行工具。
+用于评审和合并云效 Codeup 合并请求、查询项目协作工作项并维护项目成员的命令行工具。
 
 ## 安装
 
@@ -78,6 +78,8 @@ export YUNXIAO_TOKEN="pt-..."
 export YUNXIAO_DOMAIN="openapi-rdc.aliyuncs.com"
 export YUNXIAO_ORGANIZATION_ID="your-organization-id"
 export YUNXIAO_EDITION="center"
+export YUNXIAO_PROJECT_IDS="project-id-1,project-id-2"
+export YUNXIAO_WORKITEM_CATEGORIES="Req,Task,Bug"
 ```
 
 说明：
@@ -85,8 +87,10 @@ export YUNXIAO_EDITION="center"
 - 中心版默认使用 `openapi-rdc.aliyuncs.com`，并需要 `YUNXIAO_ORGANIZATION_ID`。
 - Region 版设置 `YUNXIAO_EDITION=region`，通常不需要组织 ID。
 - 也可以用命令参数覆盖配置：`--token`、`--domain`、`--organization-id`、`--edition`。
+- 工作项查询不会默认扫描所有项目，需要通过 `--project-id`、`--project-ids` 或 `YUNXIAO_PROJECT_IDS` 指定项目范围。
+- 工作项类型默认查询 `Req,Task,Bug`，可以通过 `--category` 或 `YUNXIAO_WORKITEM_CATEGORIES` 覆盖。
 
-## 命令
+## 合并请求命令
 
 查询合并请求列表：
 
@@ -124,10 +128,40 @@ node dist/src/index.js mr approve-and-merge 2813489 12 --yes --merge-type squash
 node dist/src/index.js mr release yunxiao-cli release/1.2.3 master --yes
 ```
 
+参数顺序是：
+
+```text
+mr release <repositoryName> <sourceBranch> <targetBranch>
+```
+
+例如，把 `release` 合并到 `master`：
+
+```bash
+node dist/src/index.js mr release syjc-web release master --yes
+```
+
 这个命令会先按仓库名称查询代码库 ID，再用当前 token 对应的用户作为评审人创建合并请求，随后评审通过并合并。合并时固定保留源分支，不会删除源分支。
 
+如果只想创建合并请求，不自动评审和合并，使用 `--create-only`：
+
+```bash
+node dist/src/index.js mr release syjc-web release master --yes --create-only
+```
+
+`--create-only` 仍会在云效创建合并请求，所以仍然需要 `--yes`。
+
 创建合并请求时会使用云效 `createFrom=WEB`，以保证云效能正确解析源分支提交。
 
+发布版本时，如果云效返回“源分支相对目标分支没有改动，不能新建代码评审”，可视为该仓库无改动并跳过。
+
+发布所有版本时，推荐顺序为：
+
+1. 商混版：`master` -> `gx-concrete/dev`
+2. 蜀道版：`master` -> `sdjt/dev`
+3. 标准版：`master` -> `release`
+
+标准版应最后发布。
+
 查询变更文件树：
 
 ```bash
@@ -150,7 +184,7 @@ node dist/src/index.js mr patches 2813489 12
 node dist/src/index.js mr list --output table
 node dist/src/index.js mr list --output json
 node dist/src/index.js mr review 2813489 12 --output table
-node dist/src/index.js mr release yunxiao-cli release/1.2.3 master --yes --output json
+node dist/src/index.js mr release yunxiao-cli release/1.2.3 master --yes --create-only --output json
 node dist/src/index.js mr patches 2813489 12 --output json
 ```
 
@@ -174,3 +208,132 @@ node dist/src/index.js mr patches 2813489 12 --output json
 这是为了避免误合并。
 
 未指定 `--merge-type` 时，默认使用 `no-fast-forward`。
+
+## 项目与成员命令
+
+查询项目列表：
+
+```bash
+node dist/src/index.js project list --name 研发 --output table
+```
+
+获取项目信息：
+
+```bash
+node dist/src/index.js project get <projectId> --output json
+```
+
+获取项目成员：
+
+```bash
+node dist/src/index.js project members <projectId> --role-id project.admin
+```
+
+添加项目成员：
+
+```bash
+node dist/src/index.js project member-add <projectId> \
+  --user-ids user-id-1,user-id-2 \
+  --role-id project.participant \
+  --yes
+```
+
+移除项目成员：
+
+```bash
+node dist/src/index.js project member-remove <projectId> \
+  --user-ids user-id-1 \
+  --role-id project.participant \
+  --yes
+```
+
+查询组织成员：
+
+```bash
+node dist/src/index.js member list --per-page 100
+node dist/src/index.js member get <memberId> --output json
+```
+
+## 工作项命令
+
+查询当前用户待办工作项：
+
+```bash
+node dist/src/index.js workitem mine --project-ids project-id-1,project-id-2 --state todo
+```
+
+查询指定成员待办、进行中或已完成工作项：
+
+```bash
+node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --assigned-to user-id --state todo
+node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --assigned-to user-id --state doing
+node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --assigned-to user-id --state done
+```
+
+按时间范围查询工作项：
+
+```bash
+node dist/src/index.js workitem list \
+  --project-ids project-id-1,project-id-2 \
+  --from "2026-04-01 00:00:00" \
+  --to "2026-04-30 23:59:59"
+```
+
+默认时间字段为 `gmtCreate`。如需按更新时间等字段过滤，可加 `--date-field gmtModified` 或其他云效支持的字段标识。
+
+如果已知云效状态 ID，可使用服务端状态过滤：
+
+```bash
+node dist/src/index.js workitem list --project-ids project-id-1 --status-ids 100005,100010
+```
+
+`--state todo|doing|done` 是便捷过滤，会根据返回结果中的状态英文名或中文名做本地过滤；不同项目模板状态差异较大时，优先使用 `--status-ids`。
+
+默认只查询每个项目的一页结果。需要拉取所有分页时可以加 `--all-pages`：
+
+```bash
+node dist/src/index.js workitem list --project-ids project-id-1,project-id-2 --all-pages
+```
+
+获取工作项详情、动态、评论：
+
+```bash
+node dist/src/index.js workitem get <workitemId> --output json
+node dist/src/index.js workitem activities <workitemId>
+node dist/src/index.js workitem comments <workitemId>
+node dist/src/index.js workitem timeline <workitemId> --output json
+```
+
+修改工作项负责人、参与人和计划完成时间：
+
+```bash
+node dist/src/index.js workitem update <workitemId> \
+  --assigned-to user-id \
+  --participants user-id-1,user-id-2 \
+  --due-date "2026-05-01 18:00:00" \
+  --yes
+```
+
+计划完成时间默认写入字段 `dueDate`。如果项目模板使用的是自定义字段，可以用 `--due-field <fieldId>` 覆盖：
+
+```bash
+node dist/src/index.js workitem update <workitemId> \
+  --due-field custom-plan-finish-field-id \
+  --due-date "2026-05-01 18:00:00" \
+  --yes
+```
+
+也可以用 `--field key=value` 或 `--fields '{"fieldId":"value"}'` 更新云效支持的其他字段。
+
+创建工作项评论：
+
+```bash
+node dist/src/index.js workitem comment <workitemId> --content "处理完成，请确认。" --yes
+```
+
+会改变云效数据的命令需要 `--yes`：
+
+- `project member-add`
+- `project member-remove`
+- `workitem update`
+- `workitem comment`

package/dist/src/cli.js

@@ -1,6 +1,15 @@
 import { YunxiaoClient } from "./client.js";
 const mergeTypes = new Set(["ff-only", "no-fast-forward", "squash", "rebase"]);
 const outputFormats = new Set(["table", "json"]);
+const booleanFlags = new Set(["all-pages", "create-only", "help", "json", "remove-source-branch", "yes"]);
+const workitemStateNames = new Map([
+    ["todo", ["TODO", "待处理", "待办"]],
+    ["opened", ["TODO", "待处理", "待办"]],
+    ["doing", ["DOING", "IN_PROGRESS", "PROCESSING", "进行中", "处理中"]],
+    ["in-progress", ["DOING", "IN_PROGRESS", "PROCESSING", "进行中", "处理中"]],
+    ["done", ["DONE", "COMPLETED", "CLOSED", "已完成", "完成", "已关闭"]],
+    ["completed", ["DONE", "COMPLETED", "CLOSED", "已完成", "完成", "已关闭"]]
+]);
 export async function runCli(args = process.argv.slice(2), env = process.env, io = {}) {
     const stdout = io.stdout ?? ((text) => process.stdout.write(text));
     const stderr = io.stderr ?? ((text) => process.stderr.write(text));
@@ -10,64 +19,13 @@ export async function runCli(args = process.argv.slice(2), env = process.env, io
             stdout(helpText());
             return 0;
         }
-        const [scope, command, repositoryId, localIdRaw] = parsed.positionals;
-        if (scope !== "mr" || !command) {
+        const [scope, command] = parsed.positionals;
+        if (!command) {
             throw new Error(`Unknown command: ${parsed.positionals.join(" ")}`);
         }
         const outputFormat = outputFormatFromFlags(parsed.flags);
         const client = createClient(parsed.flags, env, io.fetcher);
-        let result;
-        if (command === "list") {
-            result = await client.listChangeRequests(listOptions(parsed.flags));
-            printResult(result, outputFormat, stdout);
-            return 0;
-        }
-        if (!repositoryId || !localIdRaw) {
-            throw new Error(`Command mr ${command} requires <repositoryId> and <localId>.`);
-        }
-        if (command === "release") {
-            requireConfirmation(parsed.flags);
-            result = await client.releaseByRepositoryName({
-                repositoryName: repositoryId,
-                sourceBranch: localIdRaw,
-                targetBranch: requiredPositional(parsed.positionals[4], "targetBranch"),
-                title: optionalString(parsed.flags.title),
-                description: optionalString(parsed.flags.description),
-                mergeType: mergeOptions(parsed.flags).mergeType
-            });
-            printResult(result, outputFormat, stdout);
-            return 0;
-        }
-        const localId = parseLocalId(localIdRaw);
-        switch (command) {
-            case "review":
-                result = await client.reviewChangeRequest(repositoryId, localId, {
-                    reviewComment: optionalString(parsed.flags.comment)
-                });
-                break;
-            case "merge":
-                requireConfirmation(parsed.flags);
-                result = await client.mergeChangeRequest(repositoryId, localId, mergeOptions(parsed.flags));
-                break;
-            case "approve-and-merge":
-                requireConfirmation(parsed.flags);
-                result = await client.approveAndMerge(repositoryId, localId, {
-                    reviewComment: optionalString(parsed.flags.comment),
-                    ...mergeOptions(parsed.flags)
-                });
-                break;
-            case "tree":
-                result = await client.getChangeRequestTree(repositoryId, localId, {
-                    fromPatchSetId: requiredFlag(parsed.flags, "from-patch-set-id"),
-                    toPatchSetId: requiredFlag(parsed.flags, "to-patch-set-id")
-                });
-                break;
-            case "patches":
-                result = await client.listChangeRequestPatchSets(repositoryId, localId);
-                break;
-            default:
-                throw new Error(`Unknown mr command: ${command}`);
-        }
+        const result = await runCommand(scope, command, parsed, client, env);
         printResult(result, outputFormat, stdout);
         return 0;
     }
@@ -76,6 +34,147 @@ export async function runCli(args = process.argv.slice(2), env = process.env, io
         return 1;
     }
 }
+async function runCommand(scope, command, parsed, client, env) {
+    switch (scope) {
+        case "mr":
+            return runMergeRequestCommand(command, parsed, client);
+        case "project":
+            return runProjectCommand(command, parsed, client);
+        case "member":
+            return runMemberCommand(command, parsed, client);
+        case "workitem":
+        case "wi":
+            return runWorkitemCommand(command, parsed, client, env);
+        default:
+            throw new Error(`Unknown command scope: ${scope}`);
+    }
+}
+async function runMergeRequestCommand(command, parsed, client) {
+    const [, , repositoryId, localIdRaw] = parsed.positionals;
+    if (command === "list") {
+        return client.listChangeRequests(listOptions(parsed.flags));
+    }
+    if (!repositoryId || !localIdRaw) {
+        throw new Error(`Command mr ${command} requires <repositoryId> and <localId>.`);
+    }
+    if (command === "release") {
+        requireConfirmation(parsed.flags);
+        return client.releaseByRepositoryName({
+            repositoryName: repositoryId,
+            sourceBranch: localIdRaw,
+            targetBranch: requiredPositional(parsed.positionals[4], "targetBranch"),
+            createOnly: hasFlag(parsed.flags, "create-only"),
+            title: optionalString(parsed.flags.title),
+            description: optionalString(parsed.flags.description),
+            mergeType: mergeOptions(parsed.flags).mergeType
+        });
+    }
+    const localId = parseLocalId(localIdRaw);
+    switch (command) {
+        case "review":
+            return client.reviewChangeRequest(repositoryId, localId, {
+                reviewComment: optionalString(parsed.flags.comment)
+            });
+        case "merge":
+            requireConfirmation(parsed.flags);
+            return client.mergeChangeRequest(repositoryId, localId, mergeOptions(parsed.flags));
+        case "approve-and-merge":
+            requireConfirmation(parsed.flags);
+            return client.approveAndMerge(repositoryId, localId, {
+                reviewComment: optionalString(parsed.flags.comment),
+                ...mergeOptions(parsed.flags)
+            });
+        case "tree":
+            return client.getChangeRequestTree(repositoryId, localId, {
+                fromPatchSetId: requiredFlag(parsed.flags, "from-patch-set-id"),
+                toPatchSetId: requiredFlag(parsed.flags, "to-patch-set-id")
+            });
+        case "patches":
+            return client.listChangeRequestPatchSets(repositoryId, localId);
+        default:
+            throw new Error(`Unknown mr command: ${command}`);
+    }
+}
+async function runProjectCommand(command, parsed, client) {
+    const projectId = parsed.positionals[2];
+    switch (command) {
+        case "list":
+        case "search":
+            return client.searchProjects(projectSearchOptions(parsed.flags));
+        case "get":
+            return client.getProject(requiredPositional(projectId, "projectId"));
+        case "members":
+            return client.listProjectMembers(requiredPositional(projectId, "projectId"), {
+                name: optionalString(parsed.flags.name),
+                roleId: optionalString(parsed.flags["role-id"])
+            });
+        case "member-add":
+        case "add-member":
+            requireConfirmation(parsed.flags);
+            return client.createProjectMember(requiredPositional(projectId, "projectId"), {
+                operatorId: optionalString(parsed.flags["operator-id"]),
+                roleId: optionalString(parsed.flags["role-id"]) ?? "project.participant",
+                userIds: requiredCsvFlag(parsed.flags, "user-ids")
+            });
+        case "member-remove":
+        case "remove-member":
+            requireConfirmation(parsed.flags);
+            return client.deleteProjectMember(requiredPositional(projectId, "projectId"), {
+                operatorId: optionalString(parsed.flags["operator-id"]),
+                roleId: optionalString(parsed.flags["role-id"]) ?? "project.participant",
+                userIds: requiredCsvFlag(parsed.flags, "user-ids")
+            });
+        default:
+            throw new Error(`Unknown project command: ${command}`);
+    }
+}
+async function runMemberCommand(command, parsed, client) {
+    switch (command) {
+        case "list":
+            return client.listMembers({
+                page: optionalNumber(parsed.flags.page),
+                perPage: optionalNumber(parsed.flags["per-page"])
+            });
+        case "get":
+            return client.getMember(requiredPositional(parsed.positionals[2], "memberId"));
+        default:
+            throw new Error(`Unknown member command: ${command}`);
+    }
+}
+async function runWorkitemCommand(command, parsed, client, env) {
+    const workitemId = parsed.positionals[2];
+    switch (command) {
+        case "list":
+        case "search":
+            return searchWorkitems(client, parsed.flags, env);
+        case "mine": {
+            const currentUser = await client.getCurrentUser();
+            return searchWorkitems(client, { ...parsed.flags, "assigned-to": currentUser.id }, env);
+        }
+        case "get":
+            return client.getWorkitem(requiredPositional(workitemId, "workitemId"));
+        case "update":
+            requireConfirmation(parsed.flags);
+            return client.updateWorkitem(requiredPositional(workitemId, "workitemId"), workitemUpdateBody(parsed.flags));
+        case "activities":
+            return client.listWorkitemActivities(requiredPositional(workitemId, "workitemId"));
+        case "comments":
+            return client.listWorkitemComments(requiredPositional(workitemId, "workitemId"));
+        case "comment":
+        case "comment-create":
+            requireConfirmation(parsed.flags);
+            return client.createWorkitemComment(requiredPositional(workitemId, "workitemId"), {
+                content: requiredFlag(parsed.flags, "content"),
+                operatorId: optionalString(parsed.flags["operator-id"]),
+                parentId: optionalString(parsed.flags["parent-id"])
+            });
+        case "timeline":
+        case "history":
+            return client.getWorkitemTimeline(requiredPositional(workitemId, "workitemId"));
+        default:
+            throw new Error(`Unknown workitem command: ${command}`);
+    }
+}
 function createClient(flags, env, fetcher) {
     return new YunxiaoClient({
         token: stringFlag(flags.token) ?? env.YUNXIAO_TOKEN ?? "",
@@ -96,20 +195,28 @@ function parseArgs(args) {
         }
         const [rawName, inlineValue] = arg.slice(2).split("=", 2);
         if (inlineValue !== undefined) {
-            flags[rawName] = inlineValue;
+            setFlag(flags, rawName, inlineValue);
             continue;
         }
         const next = args[index + 1];
-        if (next && !next.startsWith("--") && !["json", "yes", "remove-source-branch", "help"].includes(rawName)) {
-            flags[rawName] = next;
+        if (next && !next.startsWith("--") && !booleanFlags.has(rawName)) {
+            setFlag(flags, rawName, next);
             index += 1;
         }
         else {
-            flags[rawName] = true;
+            setFlag(flags, rawName, true);
         }
     }
     return { positionals, flags };
 }
+function setFlag(flags, name, value) {
+    const existing = flags[name];
+    if (existing === undefined) {
+        flags[name] = value;
+        return;
+    }
+    flags[name] = [...flagValues(existing), ...flagValues(value)];
+}
 function listOptions(flags) {
     return {
         page: optionalNumber(flags.page),
@@ -125,6 +232,135 @@ function listOptions(flags) {
         createdAfter: optionalString(flags["created-after"])
     };
 }
+function projectSearchOptions(flags) {
+    return {
+        conditions: optionalString(flags.conditions) ?? projectNameConditions(optionalString(flags.name)),
+        extraConditions: optionalString(flags["extra-conditions"]),
+        orderBy: optionalString(flags["order-by"]) ?? "gmtCreate",
+        page: optionalNumber(flags.page) ?? 1,
+        perPage: optionalNumber(flags["per-page"]) ?? 20,
+        sort: optionalString(flags.sort) ?? "desc"
+    };
+}
+async function searchWorkitems(client, flags, env) {
+    const projectIds = workitemProjectIds(flags, env);
+    const perPage = optionalNumber(flags["per-page"]) ?? 20;
+    const firstPage = optionalNumber(flags.page) ?? 1;
+    const results = [];
+    for (const projectId of projectIds) {
+        let page = firstPage;
+        while (true) {
+            const response = await client.searchWorkitems(workitemSearchOptions(flags, projectId, page, perPage, env));
+            const rows = Array.isArray(response) ? response : [response];
+            results.push(...rows.map((row) => addQueryProjectId(row, projectId)));
+            if (!hasFlag(flags, "all-pages") || !Array.isArray(response) || response.length < perPage) {
+                break;
+            }
+            page += 1;
+        }
+    }
+    return filterWorkitems(results, flags);
+}
+function workitemSearchOptions(flags, projectId, page, perPage, env) {
+    return {
+        category: optionalString(flags.category) ?? env.YUNXIAO_WORKITEM_CATEGORIES ?? "Req,Task,Bug",
+        conditions: workitemConditions(flags),
+        orderBy: optionalString(flags["order-by"]) ?? "gmtCreate",
+        page,
+        perPage,
+        sort: optionalString(flags.sort) ?? "desc",
+        spaceId: projectId,
+        spaceType: optionalString(flags["space-type"]) ?? "Project"
+    };
+}
+function workitemConditions(flags) {
+    const rawConditions = optionalString(flags.conditions);
+    const filters = [];
+    const assignedTo = optionalString(flags["assigned-to"]) ?? optionalString(flags.assignee);
+    const creator = optionalString(flags.creator);
+    const statusIds = optionalString(flags["status-ids"]);
+    const subject = optionalString(flags.subject);
+    const from = optionalString(flags.from) ?? optionalString(flags["created-after"]);
+    const to = optionalString(flags.to) ?? optionalString(flags["created-before"]);
+    if (rawConditions && (assignedTo || creator || statusIds || subject || from || to)) {
+        throw new Error("--conditions cannot be combined with shortcut workitem filters.");
+    }
+    if (rawConditions) {
+        return rawConditions;
+    }
+    if (assignedTo) {
+        filters.push(userCondition("assignedTo", csvValues(assignedTo)));
+    }
+    if (creator) {
+        filters.push(userCondition("creator", csvValues(creator)));
+    }
+    if (statusIds) {
+        filters.push({
+            fieldIdentifier: "status",
+            operator: "CONTAINS",
+            value: csvValues(statusIds),
+            toValue: null,
+            className: "status",
+            format: "list"
+        });
+    }
+    if (subject) {
+        filters.push({
+            fieldIdentifier: "subject",
+            operator: "CONTAINS",
+            value: [subject],
+            toValue: null,
+            className: "string",
+            format: "input"
+        });
+    }
+    if (from || to) {
+        filters.push({
+            fieldIdentifier: optionalString(flags["date-field"]) ?? "gmtCreate",
+            operator: "BETWEEN",
+            value: from ? [from] : [],
+            toValue: to ?? null,
+            className: "dateTime",
+            format: "input"
+        });
+    }
+    return filters.length > 0 ? JSON.stringify({ conditionGroups: [filters] }) : undefined;
+}
+function userCondition(fieldIdentifier, value) {
+    return {
+        fieldIdentifier,
+        operator: "CONTAINS",
+        value,
+        toValue: null,
+        className: "user",
+        format: "list"
+    };
+}
+function workitemUpdateBody(flags) {
+    const body = {
+        ...jsonObjectFlag(flags.fields)
+    };
+    for (const field of flagStrings(flags.field)) {
+        const [key, value] = parseKeyValue(field, "--field");
+        body[key] = parseValue(value);
+    }
+    const assignedTo = optionalString(flags["assigned-to"]) ?? optionalString(flags.assignee);
+    if (assignedTo) {
+        body.assignedTo = assignedTo;
+    }
+    const participants = optionalString(flags.participants);
+    if (participants) {
+        body.participants = csvValues(participants);
+    }
+    const dueDate = optionalString(flags["due-date"]) ?? optionalString(flags["plan-finish-at"]);
+    if (dueDate) {
+        body[optionalString(flags["due-field"]) ?? "dueDate"] = dueDate;
+    }
+    if (Object.keys(body).length === 0) {
+        throw new Error("No workitem fields to update. Use --assigned-to, --participants, --due-date, --fields, or --field.");
+    }
+    return body;
+}
 function mergeOptions(flags) {
     const mergeType = optionalString(flags["merge-type"]) ?? "no-fast-forward";
     if (!mergeTypes.has(mergeType)) {
@@ -133,20 +369,20 @@ function mergeOptions(flags) {
     return {
         mergeMessage: optionalString(flags.message),
         mergeType: mergeType,
-        removeSourceBranch: Boolean(flags["remove-source-branch"])
+        removeSourceBranch: hasFlag(flags, "remove-source-branch")
     };
 }
 function requireConfirmation(flags) {
-    if (!flags.yes) {
-        throw new Error("This command changes repository state. Re-run with --yes after you have reviewed the merge request.");
+    if (!hasFlag(flags, "yes")) {
+        throw new Error("This command changes state. Re-run with --yes after you have reviewed the operation.");
     }
 }
 function outputFormatFromFlags(flags) {
     const requestedOutput = optionalString(flags.output);
-    if (flags.json && requestedOutput && requestedOutput !== "json") {
+    if (hasFlag(flags, "json") && requestedOutput && requestedOutput !== "json") {
         throw new Error("--json cannot be combined with --output table.");
     }
-    const output = flags.json ? "json" : requestedOutput ?? "table";
+    const output = hasFlag(flags, "json") ? "json" : requestedOutput ?? "table";
     if (!outputFormats.has(output)) {
         throw new Error(`Invalid --output: ${output}. Supported formats: table, json.`);
     }
@@ -176,7 +412,26 @@ function formatTable(rows) {
         return "No records found.\n";
     }
     const normalizedRows = rows.map((row) => (isRecord(row) ? row : { value: row }));
-    const preferredKeys = ["localId", "projectId", "title", "state", "sourceBranch", "targetBranch", "detailUrl"].filter((key) => normalizedRows.some((row) => row[key] !== undefined));
+    const preferredKeys = [
+        "localId",
+        "projectId",
+        "queryProjectId",
+        "id",
+        "serialNumber",
+        "name",
+        "subject",
+        "title",
+        "state",
+        "status",
+        "assignedTo",
+        "userId",
+        "userName",
+        "roleName",
+        "email",
+        "sourceBranch",
+        "targetBranch",
+        "detailUrl"
+    ].filter((key) => normalizedRows.some((row) => row[key] !== undefined));
     const keys = preferredKeys.length > 0 ? preferredKeys : uniqueKeys(normalizedRows);
     const widths = keys.map((key) => Math.max(key.length, ...normalizedRows.map((row) => formatCellValue(row[key]).length)));
     const line = (values) => values.map((value, index) => value.padEnd(widths[index])).join("  ");
@@ -200,7 +455,14 @@ function formatCellValue(value) {
     if (value === null || value === undefined) {
         return "";
     }
-    if (typeof value === "object") {
+    if (Array.isArray(value)) {
+        return value.map(formatCellValue).join(",");
+    }
+    if (isRecord(value)) {
+        const displayValue = value.displayName ?? value.name ?? value.userName ?? value.title ?? value.id;
+        if (displayValue !== undefined) {
+            return String(displayValue);
+        }
         return JSON.stringify(value);
     }
     return String(value);
@@ -225,19 +487,143 @@ function requiredFlag(flags, name) {
     }
     return value;
 }
+function requiredCsvFlag(flags, name) {
+    return csvValues(requiredFlag(flags, name));
+}
+function projectNameConditions(name) {
+    if (!name) {
+        return undefined;
+    }
+    return JSON.stringify({
+        conditionGroups: [
+            [
+                {
+                    className: "string",
+                    fieldIdentifier: "name",
+                    format: "input",
+                    operator: "CONTAINS",
+                    toValue: null,
+                    value: [name]
+                }
+            ]
+        ]
+    });
+}
+function workitemProjectIds(flags, env) {
+    const value = optionalString(flags["project-ids"]) ?? optionalString(flags["project-id"]) ?? env.YUNXIAO_PROJECT_IDS;
+    if (!value) {
+        throw new Error("Missing workitem project scope. Set --project-id, --project-ids, or YUNXIAO_PROJECT_IDS.");
+    }
+    return csvValues(value);
+}
+function addQueryProjectId(row, projectId) {
+    return isRecord(row) ? { queryProjectId: projectId, ...row } : row;
+}
+function filterWorkitems(rows, flags) {
+    const state = optionalString(flags.state);
+    const statusNameEn = optionalString(flags["status-name-en"]);
+    const statusName = optionalString(flags["status-name"]);
+    return rows.filter((row) => {
+        if (!isRecord(row)) {
+            return true;
+        }
+        if (statusNameEn && statusText(row.status, "nameEn") !== statusNameEn) {
+            return false;
+        }
+        if (statusName && statusText(row.status, "name") !== statusName && statusText(row.status, "displayName") !== statusName) {
+            return false;
+        }
+        if (state && state !== "all") {
+            const expected = workitemStateNames.get(state);
+            if (!expected) {
+                throw new Error(`Invalid --state: ${state}. Supported values: todo, doing, in-progress, done, completed, all.`);
+            }
+            const actualValues = [
+                statusText(row.status, "nameEn"),
+                statusText(row.status, "name"),
+                statusText(row.status, "displayName")
+            ].filter((value) => Boolean(value));
+            return actualValues.some((actual) => expected.includes(actual));
+        }
+        return true;
+    });
+}
+function statusText(value, key) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const text = value[key];
+    return typeof text === "string" ? text : undefined;
+}
+function jsonObjectFlag(value) {
+    const raw = optionalString(value);
+    if (!raw) {
+        return {};
+    }
+    const parsed = JSON.parse(raw);
+    if (!isRecord(parsed) || Array.isArray(parsed)) {
+        throw new Error("--fields must be a JSON object.");
+    }
+    return parsed;
+}
+function parseKeyValue(value, flagName) {
+    const separatorIndex = value.indexOf("=");
+    if (separatorIndex <= 0) {
+        throw new Error(`${flagName} expects key=value, got: ${value}`);
+    }
+    return [value.slice(0, separatorIndex), value.slice(separatorIndex + 1)];
+}
+function parseValue(value) {
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    if (value === "null") {
+        return null;
+    }
+    if (/^[\[{]/.test(value)) {
+        return JSON.parse(value);
+    }
+    return value;
+}
+function csvValues(value) {
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function flagValues(value) {
+    return Array.isArray(value) ? value : [value];
+}
+function flagStrings(value) {
+    if (value === undefined) {
+        return [];
+    }
+    return flagValues(value).filter((item) => typeof item === "string");
+}
+function hasFlag(flags, name) {
+    const value = flags[name];
+    return value === true || (Array.isArray(value) && value.includes(true));
+}
 function optionalString(value) {
+    if (Array.isArray(value)) {
+        return [...value].reverse().find((item) => typeof item === "string");
+    }
     return typeof value === "string" ? value : undefined;
 }
 function stringFlag(value) {
     return optionalString(value);
 }
 function optionalNumber(value) {
-    if (typeof value !== "string") {
+    const stringValue = optionalString(value);
+    if (!stringValue) {
         return undefined;
     }
-    const number = Number(value);
+    const number = Number(stringValue);
     if (!Number.isInteger(number) || number <= 0) {
-        throw new Error(`Expected a positive integer, got: ${value}`);
+        throw new Error(`Expected a positive integer, got: ${stringValue}`);
     }
     return number;
 }
@@ -245,16 +631,31 @@ function isRecord(value) {
     return typeof value === "object" && value !== null;
 }
 function helpText() {
-    return `yunxiao - Yunxiao Codeup merge request helper
+    return `yunxiao - Yunxiao DevOps command helper
 
 Usage:
   yunxiao mr list [--state opened] [--project-ids 2813489] [--output table|json]
   yunxiao mr review <repositoryId> <localId> [--comment "LGTM"] [--output table|json]
   yunxiao mr merge <repositoryId> <localId> --yes [--merge-type no-fast-forward] [--output table|json]
   yunxiao mr approve-and-merge <repositoryId> <localId> --yes [--merge-type no-fast-forward] [--output table|json]
-  yunxiao mr release <repositoryName> <sourceBranch> <targetBranch> --yes [--title "Release"] [--output table|json]
+  yunxiao mr release <repositoryName> <sourceBranch> <targetBranch> --yes [--create-only] [--title "Release"] [--output table|json]
   yunxiao mr tree <repositoryId> <localId> --from-patch-set-id <id> --to-patch-set-id <id> [--output table|json]
   yunxiao mr patches <repositoryId> <localId> [--output table|json]
+  yunxiao project list [--name keyword] [--output table|json]
+  yunxiao project get <projectId> [--output table|json]
+  yunxiao project members <projectId> [--name keyword] [--role-id project.admin] [--output table|json]
+  yunxiao project member-add <projectId> --user-ids user1,user2 [--role-id project.participant] --yes
+  yunxiao project member-remove <projectId> --user-ids user1,user2 [--role-id project.participant] --yes
+  yunxiao member list [--page 1] [--per-page 100] [--output table|json]
+  yunxiao member get <memberId> [--output table|json]
+  yunxiao workitem list --project-ids p1,p2 [--assigned-to userId] [--state todo|doing|done] [--from "2026-04-01 00:00:00"] [--to "2026-04-30 23:59:59"]
+  yunxiao workitem mine --project-ids p1,p2 [--state todo|doing|done] [--output table|json]
+  yunxiao workitem get <workitemId> [--output table|json]
+  yunxiao workitem update <workitemId> --yes [--assigned-to userId] [--participants user1,user2] [--due-date "2026-05-01 18:00:00"] [--field key=value]
+  yunxiao workitem activities <workitemId> [--output table|json]
+  yunxiao workitem comments <workitemId> [--output table|json]
+  yunxiao workitem comment <workitemId> --content "comment" --yes [--output table|json]
+  yunxiao workitem timeline <workitemId> [--output table|json]
 
 Output:
   --output table             Plain text table output, default
@@ -266,5 +667,7 @@ Config:
   YUNXIAO_DOMAIN             API domain, default openapi-rdc.aliyuncs.com
   YUNXIAO_ORGANIZATION_ID    Required for center edition
   YUNXIAO_EDITION            center or region
+  YUNXIAO_PROJECT_IDS        Default comma-separated project IDs for workitem commands
+  YUNXIAO_WORKITEM_CATEGORIES Default workitem categories, default Req,Task,Bug
 `;
 }

package/dist/src/client.d.ts

@@ -42,6 +42,48 @@ export interface ListRepositoriesOptions {
     search?: string;
     archived?: boolean;
 }
+export interface SearchProjectsOptions {
+    conditions?: string;
+    extraConditions?: string;
+    orderBy?: "gmtCreate" | "name" | string;
+    page?: number;
+    perPage?: number;
+    sort?: "asc" | "desc" | string;
+}
+export interface ListProjectMembersOptions {
+    name?: string;
+    roleId?: string;
+}
+export interface ChangeProjectMemberOptions {
+    operatorId?: string;
+    roleId: string;
+    userIds: string[];
+}
+export interface DeleteProjectMemberOptions {
+    operatorId?: string;
+    roleId: string;
+    userIds: string[];
+}
+export interface ListMembersOptions {
+    page?: number;
+    perPage?: number;
+}
+export interface SearchWorkitemsOptions {
+    category: string;
+    conditions?: string;
+    orderBy?: "gmtCreate" | "gmtModified" | "updateStatusAt" | "name" | string;
+    page?: number;
+    perPage?: number;
+    sort?: "asc" | "desc" | string;
+    spaceId: string;
+    spaceType?: "Project" | "Program" | string;
+}
+export interface CreateWorkitemCommentOptions {
+    content: string;
+    operatorId?: string;
+    parentId?: string;
+}
+export type UpdateWorkitemOptions = Record<string, unknown>;
 export interface RepositorySummary {
     id: number | string;
     name?: string;
@@ -71,6 +113,7 @@ export interface ReleaseByRepositoryNameOptions {
     repositoryName: string;
     sourceBranch: string;
     targetBranch: string;
+    createOnly?: boolean;
     title?: string;
     description?: string;
     mergeType?: MergeChangeRequestOptions["mergeType"];
@@ -78,8 +121,8 @@ export interface ReleaseByRepositoryNameOptions {
 export interface ReleaseResult {
     repository: RepositorySummary;
     changeRequest: unknown;
-    review: unknown;
-    merge: unknown;
+    review: unknown | null;
+    merge: unknown | null;
 }
 export interface ApproveAndMergeOptions extends ReviewChangeRequestOptions, MergeChangeRequestOptions {
 }
@@ -100,6 +143,20 @@ export declare class YunxiaoClient {
     listChangeRequests(options?: ListChangeRequestsOptions): Promise<unknown>;
     getCurrentUser(): Promise<CurrentUser>;
     listRepositories(options?: ListRepositoriesOptions): Promise<RepositorySummary[]>;
+    searchProjects(options?: SearchProjectsOptions): Promise<unknown>;
+    getProject(projectId: string): Promise<unknown>;
+    listProjectMembers(projectId: string, options?: ListProjectMembersOptions): Promise<unknown>;
+    createProjectMember(projectId: string, options: ChangeProjectMemberOptions): Promise<unknown>;
+    deleteProjectMember(projectId: string, options: DeleteProjectMemberOptions): Promise<unknown>;
+    listMembers(options?: ListMembersOptions): Promise<unknown>;
+    getMember(memberId: string): Promise<unknown>;
+    searchWorkitems(options: SearchWorkitemsOptions): Promise<unknown>;
+    getWorkitem(workitemId: string): Promise<unknown>;
+    updateWorkitem(workitemId: string, options: UpdateWorkitemOptions): Promise<unknown>;
+    listWorkitemActivities(workitemId: string): Promise<unknown>;
+    listWorkitemComments(workitemId: string): Promise<unknown>;
+    createWorkitemComment(workitemId: string, options: CreateWorkitemCommentOptions): Promise<unknown>;
+    getWorkitemTimeline(workitemId: string): Promise<unknown>;
     createChangeRequest(repositoryId: string, options: CreateChangeRequestOptions): Promise<unknown>;
     reviewChangeRequest(repositoryId: string, localId: number, options?: ReviewChangeRequestOptions): Promise<unknown>;
     mergeChangeRequest(repositoryId: string, localId: number, options?: MergeChangeRequestOptions): Promise<unknown>;
@@ -111,5 +168,9 @@ export declare class YunxiaoClient {
     private repositoriesPath;
     private repositoryPath;
     private repositoryChangeRequestPath;
+    private projexPath;
+    private workitemsSearchPath;
+    private projectPath;
+    private platformMembersPath;
     private request;
 }

package/dist/src/client.js

@@ -40,6 +40,75 @@ export class YunxiaoClient {
     listRepositories(options = {}) {
         return this.request("GET", this.repositoriesPath(), options);
     }
+    searchProjects(options = {}) {
+        return this.request("POST", this.projexPath("/projects:search"), undefined, options);
+    }
+    getProject(projectId) {
+        return this.request("GET", this.projectPath(projectId));
+    }
+    listProjectMembers(projectId, options = {}) {
+        return this.request("GET", `${this.projectPath(projectId)}/members`, options);
+    }
+    createProjectMember(projectId, options) {
+        return this.request("POST", `${this.projectPath(projectId)}/members`, undefined, {
+            operatorId: options.operatorId,
+            roleId: options.roleId,
+            userIds: options.userIds
+        });
+    }
+    deleteProjectMember(projectId, options) {
+        return this.request("DELETE", `${this.projectPath(projectId)}/members`, undefined, {
+            operatorId: options.operatorId,
+            roleIds: [options.roleId],
+            userId: options.userIds.length === 1 ? options.userIds[0] : undefined,
+            userIds: options.userIds.length > 1 ? options.userIds : undefined
+        });
+    }
+    listMembers(options = {}) {
+        return this.request("GET", this.platformMembersPath(), options);
+    }
+    getMember(memberId) {
+        return this.request("GET", `${this.platformMembersPath()}/${encodePathSegment(memberId)}`);
+    }
+    searchWorkitems(options) {
+        return this.request("POST", this.workitemsSearchPath(), undefined, {
+            category: options.category,
+            conditions: options.conditions,
+            orderBy: options.orderBy,
+            page: options.page,
+            perPage: options.perPage,
+            sort: options.sort,
+            spaceId: options.spaceId,
+            spaceType: options.spaceType ?? "Project"
+        });
+    }
+    getWorkitem(workitemId) {
+        return this.request("GET", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}`);
+    }
+    updateWorkitem(workitemId, options) {
+        return this.request("PUT", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}`, undefined, options);
+    }
+    listWorkitemActivities(workitemId) {
+        return this.request("GET", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/activities`);
+    }
+    listWorkitemComments(workitemId) {
+        return this.request("GET", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/comments`);
+    }
+    createWorkitemComment(workitemId, options) {
+        return this.request("POST", `${this.projexPath("/workitems")}/${encodePathSegment(workitemId)}/comments`, undefined, {
+            content: options.content,
+            operatorId: options.operatorId,
+            parentId: options.parentId
+        });
+    }
+    async getWorkitemTimeline(workitemId) {
+        const [workitem, activities, comments] = await Promise.all([
+            this.getWorkitem(workitemId),
+            this.listWorkitemActivities(workitemId),
+            this.listWorkitemComments(workitemId)
+        ]);
+        return { workitem, activities, comments };
+    }
     createChangeRequest(repositoryId, options) {
         return this.request("POST", `${this.repositoryPath(repositoryId)}/changeRequests`, undefined, {
             createFrom: options.createFrom ?? "WEB",
@@ -116,6 +185,14 @@ export class YunxiaoClient {
             description: options.description
         });
         const localId = localIdFromChangeRequest(changeRequest);
+        if (options.createOnly) {
+            return {
+                repository,
+                changeRequest,
+                review: null,
+                merge: null
+            };
+        }
         const review = await this.reviewChangeRequest(repositoryId, localId, {
             reviewComment: "Approved by yunxiao-cli release workflow"
         });
@@ -152,6 +229,29 @@ export class YunxiaoClient {
     repositoryChangeRequestPath(repositoryId, localId) {
         return `${this.repositoryPath(repositoryId)}/changeRequests/${localId}`;
     }
+    projexPath(path) {
+        if (this.edition === "center") {
+            return `/oapi/v1/projex/organizations/${encodePathSegment(this.organizationId ?? "")}${path}`;
+        }
+        return `/oapi/v1/projex${path}`;
+    }
+    workitemsSearchPath() {
+        if (this.edition === "center") {
+            return this.projexPath("/workitems:search");
+        }
+        return this.organizationId
+            ? `/oapi/v1/projex/${encodePathSegment(this.organizationId)}/workitems:search`
+            : "/oapi/v1/projex/workitems:search";
+    }
+    projectPath(projectId) {
+        return `${this.projexPath("/projects")}/${encodePathSegment(projectId)}`;
+    }
+    platformMembersPath() {
+        if (this.edition === "center") {
+            return `/oapi/v1/platform/organizations/${encodePathSegment(this.organizationId ?? "")}/members`;
+        }
+        return "/oapi/v1/platform/members";
+    }
     async request(method, path, query, body) {
         const url = new URL(`https://${this.domain}${path}`);
         for (const [key, value] of Object.entries(query ?? {})) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coderpp/yunxiao-cli",
-  "version": "0.1.7",
-  "description": "A CLI for Yunxiao Codeup merge request review and merge workflows.",
+  "version": "0.1.8",
+  "description": "A CLI for Yunxiao merge request, project member, and workitem workflows.",
   "type": "module",
   "repository": {
     "type": "git",