weaver-work-cli 0.1.7 → 0.1.20

package/dist/shortcuts/contract/operations/form-info.js

@@ -0,0 +1,371 @@
+import { randomUUID } from 'node:crypto';
+import { contractValidationError } from '../errors.js';
+import { requireId } from './shared.js';
+/**
+ * 流程表单读取（三段式）。
+ *
+ * 原实现走 `/api/workflow/pathdef/openapi/getFormInfo`，实测在 E10 10.0.9807.01 合同租户上
+ * 返回 errcode 0 但**表单为空**，读不到任何字段。与 `weaver-e10-workflow`（`src/shortcuts/workflow`）
+ * 同源的正确做法是三次调用：
+ *
+ *   1. `loadBaseParam`  取表单会话（requestId / nodeId / authStr / authSignature）
+ *   2. `loadFrameParam` 取表单身份（formId / relateType / nodeId / 权限开关）
+ *   3. `getFormLayout`  取字段布局（`form` + `formLayout` + `viewRelateConfig` 静态必填）
+ *
+ * 前两步的结果只服务于第三步，不落 continuation 状态、不写本地文件，因此保持为只读 operation。
+ */
+const FORM_INFO_ENDPOINTS = {
+    loadBase: '/api/workflow/core/flowPage/loadBaseParam',
+    loadFrame: '/api/workflow/core/flowPage/loadFrameParam',
+    formLayout: '/api/workflow/core/form/core/getFormLayout',
+};
+/** 表单接口公共 query 参数，与 workflow 模块的 AJAX_QUERY 一致。 */
+const AJAX_QUERY = { sf_request_type: 'ajax' };
+const SELECT_COMPONENTS = new Set(['select', 'selectmultiple', 'radiobox', 'checkbox', 'radio', 'multiselect']);
+const BROWSER_COMPONENTS = new Set([
+    'employee', 'department', 'subcompany', 'jobtitle', 'job', 'relatebrowser',
+    'browser', 'workflow', 'ebuilder', 'customer', 'project',
+]);
+const NON_INPUT_COMPONENTS = new Set([
+    'paragraph', 'label', 'divider', 'option', 'detailtable', 'group', 'layout', 'internaltitle', 'multilingualtag',
+]);
+const READONLY_COMPONENTS = new Set([
+    'dividingline', 'paragraph', 'slidercomponent', 'button', 'subtablecontrol', 'mobileinteraction',
+]);
+/**
+ * 建模表单（relateType = WEA_EBUILDER）的布局接口在另一个 module 下，需替换路径前缀。
+ * 传短 key 会原样返回导致路径非法，因此只接受完整路径。
+ */
+function formApiUrl(path, relateType) {
+    if (String(relateType || '').trim() === 'WEA_EBUILDER') {
+        return path.replace('/api/workflow/core/', '/api/ebuilder/flow/');
+    }
+    return path;
+}
+/**
+ * 这三条接口的响应统一形如 `{ code, msg, status, data: { ... } }`——业务载荷在 `data` 里，
+ * 顶层只有状态。缺 `data`（或 `data` 不是对象）时按裸载荷兜底，避免单点判空。
+ */
+function unwrapPayload(value) {
+    const data = (value ?? {}).data;
+    return (data && typeof data === 'object') ? data : (value ?? {});
+}
+/** loadBaseParam → 表单会话（对应 workflow 模块的 parseRuntime）。 */
+function parseRuntime(data, workflowId) {
+    if (!data || typeof data !== 'object')
+        throw contractValidationError('format_error', 'loadBaseParam 未返回 data');
+    const common = data.commonParam;
+    if (!common || typeof common !== 'object')
+        throw contractValidationError('format_error', 'loadBaseParam 未返回 commonParam');
+    const currentUser = (common.currentUser && typeof common.currentUser === 'object') ? common.currentUser : {};
+    const employeeId = String(currentUser.userId ?? '');
+    if (!employeeId)
+        throw contractValidationError('format_error', '缺少 commonParam.currentUser.userId');
+    const requestInfo = (data.requestInfo && typeof data.requestInfo === 'object') ? data.requestInfo : {};
+    return {
+        request_id: String(common.requestId ?? ''),
+        node_id: String(common.userCurrentNodeId ?? common.fixedNodeId ?? ''),
+        employee_id: employeeId,
+        identity_id: String(common.identityId ?? employeeId),
+        identity_type: Number(common.identityType ?? 0),
+        auth_str: String(common.authStr ?? ''),
+        auth_signature: String(common.authSignatureStr ?? ''),
+        workflow_name: String(requestInfo.workflowName ?? ''),
+        default_request_name: String(requestInfo.requestName ?? '').trim(),
+    };
+}
+/** loadFrameParam → 表单身份（对应 workflow 模块的 parseFrame）。 */
+function parseFrame(data, nodeId) {
+    if (!data || typeof data !== 'object')
+        throw contractValidationError('format_error', 'loadFrameParam 未返回 data');
+    const configs = data.formConfig;
+    if (!Array.isArray(configs) || configs.length !== 1 || !configs[0] || typeof configs[0] !== 'object') {
+        throw contractValidationError('format_error', 'loadFrameParam 返回的表单配置不是唯一项');
+    }
+    const config = configs[0];
+    const formInfo = (config.formInfo && typeof config.formInfo === 'object') ? config.formInfo : {};
+    const formId = String(formInfo.relateKey ?? '');
+    if (!formId)
+        throw contractValidationError('format_error', '缺少 formConfig.formInfo.relateKey');
+    const relateType = String(formInfo.relateType ?? '').trim() || 'WEA_FORM';
+    const viewNodeId = String(config.viewFormNodeId ?? nodeId);
+    if (!viewNodeId)
+        throw contractValidationError('format_error', '缺少 formConfig.viewFormNodeId');
+    if (viewNodeId !== nodeId)
+        throw contractValidationError('format_error', 'loadBaseParam 与 loadFrameParam 返回了不同节点');
+    const ts = String(config.timestamp ?? '').match(/^\d+$/) ? Number(config.timestamp) : Date.now();
+    return {
+        form_id: formId,
+        relate_type: relateType,
+        permission_id: String(config.permissionId ?? '').trim(),
+        permission_type: Number(config.permissionType ?? 1),
+        layout_multi_id: String(config.layoutMultiId ?? config.defaultLayoutId ?? ''),
+        new_layout: config.newLayout !== false,
+        sys_field_new_mode: config.sysFieldNewMode !== false,
+        view_form_node_id: viewNodeId,
+        timestamp: ts,
+        // enableNodePermission=false ⇒ 未启用节点权限，顶层不带 permissionId 才能拿到 viewRelateConfig。
+        enable_node_permission: config.enableNodePermission !== false,
+    };
+}
+/** getFormLayout 请求体（对应 workflow 模块的 buildLayoutRequest）。 */
+function buildLayoutRequest(workflowId, runtime, frame) {
+    const permissionId = String(frame.permission_id ?? '').trim();
+    const nodePermissionEnabled = frame.enable_node_permission !== false;
+    return {
+        terminalType: 'PC',
+        formId: frame.form_id,
+        ...(nodePermissionEnabled && permissionId ? { permissionId } : {}),
+        module: 'workflow',
+        customParam: {
+            permissionType: frame.permission_type,
+            requestId: runtime.request_id,
+            workflowId,
+            nodeId: runtime.node_id,
+            authSignatureStr: runtime.auth_signature,
+            authStr: runtime.auth_str,
+            readOnly: false,
+            identityId: runtime.identity_id,
+            identityType: runtime.identity_type,
+            isTest: false,
+            create: true,
+            mobile: false,
+            formId: frame.form_id,
+            source: 'view',
+            isAgent: false,
+            beAgentId: '0',
+            hideSysFieldArea: true,
+            viewFormNodeId: frame.view_form_node_id,
+            timestamp: frame.timestamp,
+            turnTodoUser: [],
+            sysFieldNewMode: frame.sys_field_new_mode,
+        },
+        cacheUid: randomUUID(),
+        newLayout: frame.new_layout,
+        layoutMultiId: frame.layout_multi_id,
+        dataCrossLayout: false,
+        employeeId: runtime.employee_id,
+        refId: workflowId,
+        initialDatas: [
+            { keyType: null, key: 'isCreate', value: 1 },
+            { keyType: null, key: 'isMobile', value: 0 },
+        ],
+        cost: false,
+        effectValues: [workflowId, runtime.node_id],
+        orgAsyncPageQuery: true,
+    };
+}
+/** 静态必填/只读/显示：优先取 getFormLayout 下发的 viewRelateConfig，缺省回落字段自带标记。 */
+function viewRelateMaps(layoutData) {
+    const required = {};
+    const disableEdit = {};
+    const viewRelateConfig = Array.isArray(layoutData.viewRelateConfig) ? layoutData.viewRelateConfig : [];
+    for (const item of viewRelateConfig) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const fieldId = String(item.fieldId ?? '').trim();
+        if (!fieldId)
+            continue;
+        required[fieldId] = Boolean(item.required);
+        disableEdit[fieldId] = Boolean(item.disableEdit);
+    }
+    return { required, disableEdit };
+}
+/**
+ * 读布局页签结构，与 workflow 模块的 parseLayoutMeta 同源：
+ * - `hidePositions`：Excel 布局里 `attrs.hide` 的格子坐标，落在这些位置的字段视为不可见
+ * - `compsFieldIds`：第一页 `comps[].config.fieldId`，主表字段必须在此白名单内
+ *   明细表字段不受此约束（它们挂在 detailtable 组件下，不出现在页面 comps 里）
+ */
+function parseLayoutMeta(layoutData) {
+    const hiddenCellIds = new Set();
+    const compsFieldIds = new Set();
+    let page0 = null;
+    const pageLayouts = layoutData && layoutData.formLayout ? layoutData.formLayout.pageLayouts : undefined;
+    if (Array.isArray(pageLayouts) && pageLayouts.length)
+        page0 = pageLayouts[0];
+    if (page0 && typeof page0 === 'object') {
+        const workbook = (page0.config && page0.config.workbook) ? page0.config.workbook : {};
+        const cells = workbook.Sheet1 ? workbook.Sheet1.cells : null;
+        const hidePositions = new Set();
+        if (Array.isArray(cells)) {
+            for (const cell of cells) {
+                if (!cell || typeof cell !== 'object')
+                    continue;
+                const attrs = (cell.tag && cell.tag.attrs) ? cell.tag.attrs : {};
+                if (attrs.hide)
+                    hidePositions.add(`${cell.col}:${cell.row}`);
+            }
+        }
+        for (const comp of page0.comps || []) {
+            if (!comp || typeof comp !== 'object')
+                continue;
+            const cfg = comp.config || {};
+            const fieldId = String(cfg.fieldId ?? '').trim();
+            if (!fieldId)
+                continue;
+            const excel = cfg.excel || {};
+            if (hidePositions.has(`${excel.col}:${excel.row}`))
+                hiddenCellIds.add(fieldId);
+            compsFieldIds.add(fieldId);
+        }
+    }
+    return { hiddenCellIds, compsFieldIds };
+}
+/** 从布局树里收集字段（同一 fieldId 取信息量最大的那个节点）。 */
+function extractFields(layoutData) {
+    const candidates = {};
+    const walk = (value) => {
+        if (Array.isArray(value)) {
+            for (const child of value)
+                walk(child);
+            return;
+        }
+        if (!value || typeof value !== 'object')
+            return;
+        const fieldId = String(value.fieldId ?? '').trim();
+        const component = String(value.componentKey ?? value.type ?? '').trim();
+        if (fieldId && component) {
+            const previous = candidates[fieldId];
+            if (previous === undefined || Object.keys(value).length > Object.keys(previous).length) {
+                candidates[fieldId] = value;
+            }
+        }
+        for (const child of Object.values(value))
+            walk(child);
+    };
+    walk(layoutData.formLayout);
+    const meta = parseLayoutMeta(layoutData);
+    const { required: requiredMap, disableEdit } = viewRelateMaps(layoutData);
+    const result = [];
+    for (const fieldId of Object.keys(candidates)) {
+        const raw = candidates[fieldId];
+        const component = String(raw.componentKey ?? raw.type ?? '');
+        const normalized = component.toLowerCase();
+        if (NON_INPUT_COMPONENTS.has(normalized) || normalized.startsWith('flowpagesysfield'))
+            continue;
+        const subFormId = String(raw.subFormId ?? '');
+        if (meta.hiddenCellIds.has(fieldId))
+            continue;
+        // 主表字段必须真的挂在页面上；明细字段不在页面 comps 里，不受白名单约束
+        if (meta.compsFieldIds.size && !subFormId && !meta.compsFieldIds.has(fieldId))
+            continue;
+        const browserType = (raw.browserType && typeof raw.browserType === 'object') ? raw.browserType : {};
+        const options = [];
+        for (const option of raw.options || []) {
+            if (!option || typeof option !== 'object')
+                continue;
+            const optionId = String(option.valueKey ?? option.selectionId ?? option.id ?? '').trim();
+            const name = String(option.name ?? option.content ?? '').trim();
+            if (optionId && name)
+                options.push({ id: optionId, name });
+        }
+        // browserType 已归一化为对象：JS 的 Boolean({}) 恒为 true，必须判"非空对象"，
+        // 否则每个字段都会被当成浏览按钮字段（workflow 模块 2026-09-16 的同类修复）。
+        const isBrowser = Object.keys(browserType).length > 0 || BROWSER_COMPONENTS.has(normalized);
+        result.push({
+            id: fieldId,
+            name: String(raw.title ?? raw.name ?? raw.dataKey ?? fieldId),
+            componentKey: component,
+            required: requiredMap[fieldId] !== undefined ? requiredMap[fieldId] : Boolean(raw.required || raw.mustInput),
+            readOnly: Boolean(READONLY_COMPONENTS.has(normalized) || raw.readOnly || disableEdit[fieldId]),
+            subFormId,
+            isBrowser,
+            isSelect: SELECT_COMPONENTS.has(normalized) || options.length > 0,
+            isMultiple: (SELECT_COMPONENTS.has(normalized) && (normalized === 'selectmultiple' || normalized === 'checkbox' || normalized === 'multiselect'))
+                || (isBrowser && raw.isSingle === false),
+            browserType: String(browserType.type ?? browserType.id ?? raw.browserTypeCode ?? ''),
+            browserModule: String(browserType.module ?? raw.browserModule ?? ''),
+            options,
+            format: String(raw.format ?? raw.formatPattern ?? ''),
+            typeLen: raw.typeLen !== undefined ? raw.typeLen : raw.typeLength,
+            showOrder: raw.showOrder !== undefined ? raw.showOrder : 0,
+        });
+    }
+    result.sort((a, b) => {
+        if (Boolean(a.subFormId) !== Boolean(b.subFormId))
+            return a.subFormId ? 1 : -1;
+        if (a.subFormId !== b.subFormId)
+            return a.subFormId < b.subFormId ? -1 : 1;
+        const sa = Number(a.showOrder || 0);
+        const sb = Number(b.showOrder || 0);
+        if (sa !== sb)
+            return sa - sb;
+        return a.id < b.id ? -1 : 1;
+    });
+    return result;
+}
+/**
+ * `contract.workflow.form.info`：读流程发起表单的字段定义。
+ * 输入只需 `workflowId`；三段式内部的中间值（formId / requestId / nodeId）由实现自行串联。
+ */
+export const contractWorkflowFormInfoOperation = {
+    name: 'contract.workflow.form.info',
+    async execute(input, context) {
+        const { host } = context;
+        const workflowId = requireId(input.workflowId, 'workflowId');
+        const query = { workflowId, isCreate: 1, ...AJAX_QUERY };
+        const base = { workflowId, isCreate: 1, isMobile: 0 };
+        const baseValue = await host.contractRequest({
+            method: 'POST',
+            path: FORM_INFO_ENDPOINTS.loadBase,
+            query,
+            body: base,
+        });
+        const frameValue = await host.contractRequest({
+            method: 'POST',
+            path: FORM_INFO_ENDPOINTS.loadFrame,
+            query,
+            body: base,
+        });
+        const runtime = parseRuntime(unwrapPayload(baseValue), workflowId);
+        const frame = parseFrame(unwrapPayload(frameValue), runtime.node_id);
+        const layoutPath = formApiUrl(FORM_INFO_ENDPOINTS.formLayout, frame.relate_type);
+        const layoutValue = await host.contractRequest({
+            method: 'POST',
+            path: layoutPath,
+            query: { formId: frame.form_id, ...AJAX_QUERY },
+            body: buildLayoutRequest(workflowId, runtime, frame),
+        });
+        const layout = unwrapPayload(layoutValue);
+        if (!layout || typeof layout !== 'object') {
+            throw contractValidationError('format_error', 'getFormLayout 未返回有效 data');
+        }
+        const returnedFormId = String((layout.form ?? {}).id ?? '');
+        if (returnedFormId && returnedFormId !== frame.form_id) {
+            throw contractValidationError('format_error', 'getFormLayout 返回了不同的 formId');
+        }
+        const fields = extractFields(layout);
+        const requiredFields = fields.filter((field) => field.required).map((field) => field.id);
+        const subFormRequired = {};
+        for (const field of fields) {
+            if (!field.subFormId || !field.required)
+                continue;
+            (subFormRequired[field.subFormId] ??= []).push(field.id);
+        }
+        // 必填口径：viewRelateConfig 非空时它才是权威来源（字段自带 required 只是表单设计默认值），
+        // 另有 lowercase 的差异来自条件必填——服务端按场景动态判定，静态读取拿不到，交给发起侧实时校验。
+        const requiredSource = Array.isArray(layout.viewRelateConfig) && layout.viewRelateConfig.length
+            ? 'viewRelateConfig'
+            : 'field-metadata';
+        return {
+            status: 'COMPLETE',
+            data: {
+                path: layoutPath,
+                steps: [FORM_INFO_ENDPOINTS.loadBase, FORM_INFO_ENDPOINTS.loadFrame, layoutPath],
+                formId: frame.form_id,
+                layoutId: String((layout.formLayout ?? {}).id ?? ''),
+                relateType: frame.relate_type,
+                requestId: runtime.request_id,
+                nodeId: runtime.node_id,
+                workflowName: runtime.workflow_name,
+                defaultRequestName: runtime.default_request_name,
+                fieldCount: fields.length,
+                requiredFields,
+                requiredSource,
+                subFormRequired,
+                fields,
+            },
+        };
+    },
+};

package/dist/shortcuts/contract/operations/read.js

@@ -0,0 +1,118 @@
+import { maskText } from './shared.js';
+const PASSTHROUGH_KEYS = [
+    'code',
+    'msg',
+    'message',
+    'status',
+    'fail',
+    'data',
+    'baseInfoList',
+    'activeWfId',
+    'total',
+    'maxPage',
+];
+function defaultShape(value) {
+    const result = {};
+    for (const key of PASSTHROUGH_KEYS) {
+        if (value[key] !== undefined)
+            result[key] = value[key];
+    }
+    return result;
+}
+export class ContractReadOperation {
+    name;
+    spec;
+    constructor(name, spec) {
+        this.name = name;
+        this.spec = spec;
+    }
+    async execute(input, { host }) {
+        const query = {
+            ...(this.spec.method === 'GET' ? this.spec.defaults ?? {} : {}),
+            ...(this.spec.query?.(input) ?? {}),
+        };
+        const body = {
+            ...(this.spec.method === 'POST' ? this.spec.defaults ?? {} : {}),
+            ...(this.spec.body?.(input) ?? {}),
+        };
+        const form = this.spec.form?.(input);
+        const value = await host.contractRequest({
+            method: this.spec.method,
+            path: this.spec.path,
+            query,
+            ...(form ? { form } : this.spec.method === 'POST' ? { body } : {}),
+            ...(this.spec.userIdField ? { userIdField: this.spec.userIdField } : {}),
+        });
+        return {
+            status: 'COMPLETE',
+            data: { path: this.spec.path, ...(this.spec.shape ?? defaultShape)(value) },
+        };
+    }
+}
+function asArray(value) {
+    return Array.isArray(value) ? value.filter((item) => item && typeof item === 'object') : [];
+}
+/** 只保留环境无关的展示字段，去掉 tenantKey / 人员 ID / 完整 appId。 */
+export function projectSubjects(value) {
+    return {
+        code: value.code,
+        msg: value.msg,
+        objs: asArray(value.data).map((item) => ({
+            id: item.id,
+            objName: item.objName,
+            showName: item.showName,
+            tag: item.tag,
+        })),
+    };
+}
+export function projectWorkflowBase(value) {
+    return {
+        message: value.message,
+        workflows: asArray(value.baseInfoList).map((item) => ({
+            id: item.id,
+            workflowName: item.workflowName,
+            workflowType: item.workflowType,
+            status: item.status,
+            versionId: item.versionId,
+            activeWfId: item.activeWfId,
+        })),
+    };
+}
+export function projectWorkflowList(value) {
+    return {
+        message: value.message,
+        workflows: asArray(value.data).map((item) => ({
+            id: item.id,
+            workflowName: item.workflowName,
+            workflowType: item.workflowType,
+        })),
+    };
+}
+export function projectRequestStatus(value) {
+    const base = (value.data ?? {});
+    const info = (base.workflowBaseInfo ?? {});
+    return {
+        message: value.message,
+        request: {
+            requestId: info.requestId,
+            workflowId: info.workflowId,
+            requestName: info.requestName,
+            status: info.status ?? base.status,
+            flowStatus: info.flowStatus,
+            currentNodeType: base.currentNodeType,
+            lastOperator: info.lastOperator === undefined ? undefined : maskText(info.lastOperator),
+        },
+    };
+}
+export function projectRequestLog(value) {
+    return {
+        message: value.message,
+        logs: asArray(value.data).map((item) => ({
+            operatorName: (item.commentor ?? {}).name,
+            content: item.content,
+            commentType: item.commentType,
+            stepName: item.stepName,
+            addTime: item.addTime,
+        })),
+    };
+}

package/dist/shortcuts/contract/operations/registry.js

@@ -0,0 +1,43 @@
+import { contractValidationError } from '../errors.js';
+import { contractOperations } from '../manifest.js';
+import { contractClauseReferenceOperations } from './clause-reference.js';
+import { contractRequestOperations } from './request.js';
+import { contractSubjectOperations } from './subject.js';
+import { contractTemplateOperations } from './template.js';
+import { contractWorkflowOperations } from './workflow.js';
+function buildRegistry() {
+    const registry = new Map();
+    const handlers = [
+        ...contractTemplateOperations,
+        ...contractClauseReferenceOperations,
+        ...contractSubjectOperations,
+        ...contractWorkflowOperations,
+        ...contractRequestOperations,
+    ];
+    for (const handler of handlers) {
+        if (registry.has(handler.name))
+            throw new Error(`duplicate contract operation handler: ${handler.name}`);
+        registry.set(handler.name, handler);
+    }
+    for (const contract of contractOperations) {
+        if (!registry.has(contract.name))
+            throw new Error(`missing contract operation handler: ${contract.name}`);
+    }
+    for (const name of registry.keys()) {
+        if (!contractOperations.some((contract) => contract.name === name)) {
+            throw new Error(`contract operation handler without manifest contract: ${name}`);
+        }
+    }
+    return registry;
+}
+const contractOperationRegistry = buildRegistry();
+export function getContractOperation(operation) {
+    const handler = contractOperationRegistry.get(operation);
+    if (!handler) {
+        throw contractValidationError('operation_unknown', `今承达合同管理不支持操作：${operation}`);
+    }
+    return handler;
+}
+export function listContractOperations() {
+    return [...contractOperationRegistry.keys()];
+}