@stalfh233/omc-cli 0.6.6 → 0.6.10

package/dist/lanes/workflow-contract.js

@@ -196,15 +196,15 @@ export const WORKFLOW_LANE_CONTRACT = Object.freeze({
         }),
         "org.role.list": Object.freeze({
             scope: "workflow participant resolution",
-            description: "列出组织角色（`GET /api/api/organization/role/list`），递归展开角色组，返回 {count, roleCount, groupCount, roles[{id,name,code,roleType,corpId,group}], groups[{id,name,code,path,childCount}]}。**`count` 只数角色，不含角色组**——角色组是容器（平台行标记 `group:true`），旧版把空组当角色列出，曾让调用方把「19 个角色组」误读成「目标角色未创建」；`groups[].childCount` 才说明组内是否真的没有角色。用于把审批节点的参与者解析成平台认识的引用。**真实参与者语法**（2026-09-23 生产观察）：`participant` 只能是 (a) 关键字 `{Originator}`；(b) 参与者对象数组 JSON `[{\"code\":\"<roleCode>\",\"corpId\":\"<corpId|other>\",\"id\":\"<roleId>\",\"name\":\"<角色名>\",\"type\":2}]`（type 2=角色，3=用户；多个用 `+` 连接）；(c) 函数表达式如 `FindUserByRole({Originator.OU},\"<roleCode>\",\"random\")`。**自由文本角色名（如 `部门负责人`）能 publish 但解析不到人、不生成待办**——先用本工具拿到 `code`/`id` 再构造对象数组。",
+            description: "列出组织角色（`GET /api/api/organization/role/list`），递归展开角色组，返回 {count, roleCount, groupCount, roles[{id,name,code,roleType,corpId,group,groupId,groupCode,groupName}], groups[{id,name,code,parentId,path,childCount}]}。**`count` 只数角色，不含角色组**——角色组是容器（平台行标记 `group:true`），旧版把空组当角色列出，曾让调用方把「19 个角色组」误读成「目标角色未创建」；`groups[].childCount` 才说明组内是否真的没有角色。`roles[].group` 是组名（兼容旧读法），写角色请用 `groupId`/`groupCode`。用于把审批节点的参与者解析成平台认识的引用。**真实参与者语法**（2026-09-23 生产观察）：`participant` 只能是 (a) 关键字 `{Originator}`；(b) 参与者对象数组 JSON `[{\"code\":\"<roleCode>\",\"corpId\":\"<corpId|other>\",\"id\":\"<roleId>\",\"name\":\"<角色名>\",\"type\":2}]`（type 2=角色，3=用户；多个用 `+` 连接）；(c) 函数表达式如 `FindUserByRole({Originator.OU},\"<roleCode>\",\"random\")`。**自由文本角色名（如 `部门负责人`）能 publish 但解析不到人、不生成待办**——先用本工具拿到 `code`/`id` 再构造对象数组。",
         }),
         "org.department.list": Object.freeze({
             scope: "workflow participant resolution",
-            description: "列出组织结构（`GET /api/api/organization/department/tree`），扁平化为 {id,name,code,corpId,parentId}。**平台语义：不带 deptIds 只返回根部门；带 deptIds=<id> 返回该部门整棵子树（不是一层）**——工具先取根再逐个取子树，支持多层；可选 parentId 只看子树。用于需要按部门解析审批人（配合 `FindUserByRole({Originator.OU},\"<roleCode>\",\"random\")` 或部门引用）时取得真实 code/id。",
+            description: "列出组织结构（`GET /api/api/organization/department/tree`），扁平化为 {id,name,code,corpId,parentId}。**平台语义：不带 deptIds 只返回根部门；带 deptIds=<id> 返回该部门整棵子树（不是一层）**——工具先取根再逐个取子树，支持多层；可选 parentId 只看子树。compact 读回仍保留 `{id,name,code,parentId}`（不会压成 `id｜name` 丢掉层级）。用于需要按部门解析审批人（配合 `FindUserByRole({Originator.OU},\"<roleCode>\",\"random\")` 或部门引用）时取得真实 code/id。",
         }),
         "org.user.search": Object.freeze({
             scope: "workflow participant resolution",
-            description: "按关键字搜索用户（`POST /api/api/organization/user/search`，body `{wd,page,size,filterType?}`，返回 {id,name,username,userId,departmentId,corpId,status}）。平台 `wd` 必填、空串报 10005，所以**省略 wd 时不打 user/search**：工具改为遍历部门树（`organization/department/tree` + `department/list_user`）聚合成全员清单（返回 `keyword:null` 与 `departmentsScanned`；>200 部门会带 `truncated`）。用于把「张三」解析成真实用户 id/username 再构造参与者对象（`[{\"code\":\"<username|userId>\",\"corpId\":\"<corpId|other>\",\"id\":\"<userId>\",\"name\":\"<姓名>\",\"type\":3}]`，type 3=用户 / 2=角色 / 多个用 `+` 连接）；只要某部门的人用 org.department.users，角色用 org.role.list。",
+            description: "按关键字搜索用户（`POST /api/api/organization/user/search`，body `{wd,page,size,filterType?}`，返回 {id,name,username,userId,departmentId,corpId,status}）。平台 `wd` 必填、空串报 10005，所以**省略 wd 时不打 user/search**：工具改为遍历部门树（`organization/department/tree` + `department/list_user`）聚合成全员清单（返回 `keyword:null` 与 `departmentsScanned`；>200 部门会带 `truncated`）。≤50 人默认内联 `{id,name,username,departmentId}`，更大才外置 artifact。用于把「张三」解析成真实用户 id/username 再构造参与者对象（`[{\"code\":\"<username|userId>\",\"corpId\":\"<corpId|other>\",\"id\":\"<userId>\",\"name\":\"<姓名>\",\"type\":3}]`，type 3=用户 / 2=角色 / 多个用 `+` 连接）；只要某部门的人用 org.department.users，角色用 org.role.list。",
         }),
         "workitem.list": Object.freeze({
             scope: "runtime workflow work-item query",