weaver-work-cli 0.1.8 → 0.1.20

package/dist/shortcuts/contract/manifest.js

@@ -0,0 +1,596 @@
+const AUTH = ['e10-session'];
+function readSchema(properties, required = []) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(required.length ? { required } : {}),
+    };
+}
+const pageNoSize = {
+    pageNo: { type: 'integer', minimum: 1 },
+    pageSize: { type: 'integer', minimum: 1, maximum: 1000 },
+};
+const pageNumSize = {
+    pageNum: { type: 'integer', minimum: 0 },
+    pageSize: { type: 'integer', minimum: 1, maximum: 1000 },
+};
+const idString = { type: 'string', pattern: '^[1-9]\\d*$', minLength: 1 };
+const SUBJECT_FORM_TAGS = ['我方签约主体库', '客户签约主体库', '供应商签约主体库'];
+export const contractOperations = [
+    {
+        name: 'contract.type.tree',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/type/allTypes' },
+        inputSchema: readSchema({}),
+    },
+    {
+        name: 'contract.template.tree',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/tpltree/queryList' },
+        inputSchema: readSchema({
+            treeName: { type: 'string' },
+            parentId: idString,
+            treeType: { type: 'integer' },
+            isSystem: { type: 'integer' },
+            useType: { type: 'integer' },
+            appId: idString,
+        }),
+    },
+    {
+        name: 'contract.template.list',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/tplinfo/getListPage', defaults: { pageNo: 1, pageSize: 10 } },
+        inputSchema: readSchema({
+            templateName: { type: 'string' },
+            templateDesc: { type: 'string' },
+            belongId: idString,
+            contractType: idString,
+            templateStatus: { type: 'integer', enum: [0, 1] },
+            source: { type: 'integer', enum: [0, 1, 2] },
+            sourceType: { type: 'string' },
+            templateVersion: { type: 'string' },
+            operateType: { type: 'integer' },
+            useType: { type: 'integer' },
+            code: { type: 'string' },
+            appId: idString,
+            formId: idString,
+            orgId: idString,
+            belongSub: { type: 'string' },
+            outTime: { type: 'boolean' },
+            ...pageNoSize,
+        }),
+    },
+    {
+        name: 'contract.template.detail',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/tplinfo/getById' },
+        inputSchema: readSchema({ id: idString }, ['id']),
+    },
+    {
+        name: 'contract.clause.tree',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/tree/queryList' },
+        inputSchema: readSchema({}),
+    },
+    {
+        name: 'contract.clause.list',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/clauseinfo/getListPage', defaults: { pageNo: 1, pageSize: 10 } },
+        inputSchema: readSchema({
+            belongId: idString,
+            clauseName: { type: 'string' },
+            clauseNum: { type: 'string' },
+            clauseStatus: { type: 'integer', enum: [0, 1] },
+            clauseGroup: { type: 'string' },
+            contractType: idString,
+            clauseVersion: { type: 'string' },
+            orgId: idString,
+            belongSub: { type: 'string' },
+            ...pageNoSize,
+        }),
+    },
+    {
+        name: 'contract.clause.group.list',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/clausegroup/getListPage', defaults: { pageNo: 1, pageSize: 10 } },
+        inputSchema: readSchema({
+            belongId: idString,
+            clauseName: { type: 'string' },
+            clauseNum: { type: 'string' },
+            clauseStatus: { type: 'integer', enum: [0, 1] },
+            contractType: idString,
+            ...pageNoSize,
+        }),
+    },
+    {
+        name: 'contract.clause.search',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/clauseinfo/getClauses', defaults: { pageNum: 0, pageSize: 10 } },
+        inputSchema: readSchema({
+            id: { type: 'string' },
+            title: { type: 'string' },
+            tagId: { type: 'string' },
+            content: { type: 'string' },
+            group: { type: 'boolean' },
+            mark: { type: 'boolean' },
+            ...pageNumSize,
+        }),
+    },
+    {
+        name: 'contract.clause.tags',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebd/contract/clauseinfo/getClausesConfig', defaults: { pageNum: 0, pageSize: 10 } },
+        inputSchema: readSchema({
+            label: { type: 'string' },
+            value: { type: 'string' },
+            ...pageNumSize,
+        }),
+    },
+    {
+        name: 'contract.clause.reference.get',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'POST', path: '/api/ebd/contract/clauseReference/selectData' },
+        inputSchema: readSchema({
+            fileId: idString,
+            requestId: idString,
+            clauseId: idString,
+            referenceObjType: { type: 'integer', enum: [1], default: 1 },
+            startTime: { type: 'string' },
+            endTime: { type: 'string' },
+            ...pageNumSize,
+        }),
+    },
+    {
+        name: 'contract.clause.reference.save.prepare',
+        risk: 'read-before-write',
+        auth: AUTH,
+        fixed: { writeMethod: 'POST', path: '/api/ebd/contract/clauseReference/saveData', referenceObjType: 1 },
+        inputSchema: readSchema({
+            clauseIds: { type: 'array', minItems: 1, items: idString },
+            fileId: idString,
+            fileName: { type: 'string' },
+            requestId: idString,
+            requestName: { type: 'string' },
+        }, ['clauseIds', 'fileId', 'requestId']),
+    },
+    {
+        name: 'contract.clause.reference.save.apply',
+        risk: 'high-risk-write',
+        auth: AUTH,
+        fixed: { writeMethod: 'POST', path: '/api/ebd/contract/clauseReference/saveData', referenceObjType: 1 },
+        inputSchema: readSchema({
+            clauseIds: { type: 'array', minItems: 1, items: idString },
+            fileId: idString,
+            fileName: { type: 'string' },
+            requestId: idString,
+            requestName: { type: 'string' },
+            continuation: { type: 'string', minLength: 1 },
+            confirm: { const: true },
+        }, ['clauseIds', 'fileId', 'requestId', 'continuation', 'confirm']),
+    },
+    {
+        name: 'contract.subject.app',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/bs/ebuilder/app/tags/getAppIds', defaultTag: '合同管理' },
+        inputSchema: readSchema({
+            tag: { type: 'string', minLength: 1, default: '合同管理' },
+        }),
+    },
+    {
+        name: 'contract.subject.form',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebuilder/form/obj/getObjsByTag' },
+        inputSchema: readSchema({
+            appId: idString,
+            tag: { type: 'string', enum: SUBJECT_FORM_TAGS },
+        }, ['appId', 'tag']),
+    },
+    {
+        name: 'contract.subject.fields',
+        risk: 'read',
+        auth: AUTH,
+        fixed: {
+            method: 'POST',
+            path: '/api/ebuilder/common/ds/fields',
+            contentType: 'multipart/form-data',
+            sourceType: 'FORM',
+            defaults: { detailFieldsGroup: true, enableMerge: true, customParam: '{"terminal":""}', params: '[]' },
+        },
+        inputSchema: readSchema({
+            appId: idString,
+            objId: idString,
+            detailFieldsGroup: { type: 'boolean' },
+            enableMerge: { type: 'boolean' },
+            customParam: { type: 'string' },
+            params: { type: 'string' },
+        }, ['appId', 'objId']),
+    },
+    {
+        name: 'contract.subject.options',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/ebuilder/common/ds/options', sourceType: 'FORM' },
+        inputSchema: readSchema({
+            appId: idString,
+            objId: idString,
+            fieldName: idString,
+        }, ['appId', 'objId', 'fieldName']),
+    },
+    {
+        name: 'contract.subject.query',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'POST', path: '/api/ebuilder/form/dataset/v2/getAllData', defaults: { pageNo: 1, pageSize: 10, isReturnDetail: 'n' } },
+        inputSchema: readSchema({
+            objId: idString,
+            mainTable: { type: 'object' },
+            pageNo: { type: 'integer', minimum: 1 },
+            pageSize: { type: 'integer', minimum: 1, maximum: 1000 },
+            isReturnDetail: { type: 'string', enum: ['y', 'n'] },
+        }, ['objId']),
+    },
+    {
+        name: 'contract.subject.create.prepare',
+        risk: 'read-before-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/ebuilder/form/dataset/v2/saveFormData',
+            defaults: { fieldNoFindIgnore: 'true', doAction: 'false' },
+        },
+        inputSchema: readSchema({
+            objId: idString,
+            mainTable: { type: 'object', minProperties: 1 },
+            details: { type: 'object' },
+            fieldNoFindIgnore: { type: 'string', enum: ['true', 'false'] },
+            doAction: { type: 'string', enum: ['true', 'false'] },
+            verify: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { field: { type: 'string', minLength: 1 }, value: { type: 'string' } },
+                required: ['field', 'value'],
+            },
+        }, ['objId', 'mainTable']),
+    },
+    {
+        name: 'contract.subject.create.apply',
+        risk: 'high-risk-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/ebuilder/form/dataset/v2/saveFormData',
+            defaults: { fieldNoFindIgnore: 'true', doAction: 'false' },
+        },
+        inputSchema: readSchema({
+            objId: idString,
+            mainTable: { type: 'object', minProperties: 1 },
+            details: { type: 'object' },
+            fieldNoFindIgnore: { type: 'string', enum: ['true', 'false'] },
+            doAction: { type: 'string', enum: ['true', 'false'] },
+            verify: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { field: { type: 'string', minLength: 1 }, value: { type: 'string' } },
+                required: ['field', 'value'],
+            },
+            continuation: { type: 'string', minLength: 1 },
+            confirm: { const: true },
+        }, ['objId', 'mainTable', 'continuation', 'confirm']),
+    },
+    {
+        name: 'contract.workflow.query',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'POST', path: '/api/workflow/pathdef/openapi/getBaseInfoByCondition', userIdField: 'userid' },
+        inputSchema: readSchema({
+            workflowName: { type: 'string', minLength: 1 },
+            workflowType: { type: 'string' },
+            status: { type: 'string', enum: ['1', '2', '5', '9'] },
+        }, ['workflowName']),
+    },
+    {
+        name: 'contract.workflow.list',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'POST', path: '/api/workflow/list/paService/v1/getCreateWorkflowList', userIdField: 'userid' },
+        inputSchema: readSchema({
+            wfpCode: { type: 'integer', enum: [0, 1] },
+            filterHide: { type: 'string' },
+        }, ['wfpCode']),
+    },
+    {
+        name: 'contract.workflow.form.info',
+        risk: 'read',
+        auth: AUTH,
+        fixed: {
+            method: 'POST',
+            path: '/api/workflow/core/flowPage/loadBaseParam',
+            note: '三段式表单读取：loadBaseParam -> loadFrameParam -> getFormLayout，实际以最后一步为准',
+        },
+        inputSchema: readSchema({ workflowId: idString }, ['workflowId']),
+    },
+    {
+        name: 'contract.workflow.field.options',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'POST', path: '/api/workflow/core/paService/v1/getFieldOption', userIdField: 'userid', acceptsErrcode200: true },
+        inputSchema: readSchema({
+            fieldId: idString,
+            pageNo: { type: 'integer', minimum: 1 },
+            pageSize: { type: 'integer', minimum: 1 },
+        }, ['fieldId']),
+    },
+    {
+        name: 'contract.request.create.prepare',
+        risk: 'read-before-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/workflow/core/paService/v2/doCreateRequest',
+            userIdField: 'userid',
+            defaults: { isnextflow: 0, requestLevel: 0, isVerifyFormRequired: false },
+        },
+        inputSchema: readSchema({
+            workflowId: idString,
+            requestname: { type: 'string', minLength: 1 },
+            remark: { type: 'string' },
+            isnextflow: { type: 'integer', enum: [0, 1] },
+            isVerifyFormRequired: { type: 'boolean' },
+            requestLevel: { type: 'integer', enum: [0, 1, 2] },
+            formData: { type: 'object' },
+            isNewFormData: { type: 'boolean' },
+            seniorFormParam: { type: 'object' },
+        }, ['workflowId']),
+    },
+    {
+        name: 'contract.request.create.apply',
+        risk: 'high-risk-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/workflow/core/paService/v2/doCreateRequest',
+            userIdField: 'userid',
+            defaults: { isnextflow: 0, requestLevel: 0, isVerifyFormRequired: false },
+        },
+        inputSchema: readSchema({
+            workflowId: idString,
+            requestname: { type: 'string', minLength: 1 },
+            remark: { type: 'string' },
+            isnextflow: { type: 'integer', enum: [0, 1] },
+            isVerifyFormRequired: { type: 'boolean' },
+            requestLevel: { type: 'integer', enum: [0, 1, 2] },
+            formData: { type: 'object' },
+            isNewFormData: { type: 'boolean' },
+            seniorFormParam: { type: 'object' },
+            continuation: { type: 'string', minLength: 1 },
+            confirm: { const: true },
+        }, ['workflowId', 'continuation', 'confirm']),
+    },
+    {
+        name: 'contract.request.save.prepare',
+        risk: 'read-before-write',
+        auth: AUTH,
+        fixed: { writeMethod: 'POST', path: '/api/workflow/core/paService/v1/saveFormData', userIdField: 'userid' },
+        inputSchema: readSchema({
+            requestId: idString,
+            workflowId: idString,
+            userCurrentNodeId: idString,
+            formData: {
+                type: 'object',
+                properties: {
+                    formId: idString,
+                    module: { type: 'string' },
+                    dataDetails: { type: 'array', minItems: 1, items: { type: 'object' } },
+                },
+                required: ['dataDetails'],
+                additionalProperties: false,
+            },
+            isNewFormData: { type: 'boolean' },
+            seniorFormParam: { type: 'object' },
+        }, ['requestId', 'formData']),
+    },
+    {
+        name: 'contract.request.save.apply',
+        risk: 'high-risk-write',
+        auth: AUTH,
+        fixed: { writeMethod: 'POST', path: '/api/workflow/core/paService/v1/saveFormData', userIdField: 'userid' },
+        inputSchema: readSchema({
+            requestId: idString,
+            workflowId: idString,
+            userCurrentNodeId: idString,
+            formData: {
+                type: 'object',
+                properties: {
+                    formId: idString,
+                    module: { type: 'string' },
+                    dataDetails: { type: 'array', minItems: 1, items: { type: 'object' } },
+                },
+                required: ['dataDetails'],
+                additionalProperties: false,
+            },
+            isNewFormData: { type: 'boolean' },
+            seniorFormParam: { type: 'object' },
+            continuation: { type: 'string', minLength: 1 },
+            confirm: { const: true },
+        }, ['requestId', 'formData', 'continuation', 'confirm']),
+    },
+    {
+        name: 'contract.request.submit.prepare',
+        risk: 'read-before-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/workflow/core/paService/v1/submitRequest',
+            userIdField: 'userid',
+            secondConfirmation: true,
+            defaults: { isVerifyFormRequired: true },
+        },
+        inputSchema: readSchema({
+            requestId: idString,
+            remark: { type: 'string' },
+            userCurrentNodeId: idString,
+            requestName: { type: 'string' },
+            formdata: { type: 'object' },
+            otherParams: { type: 'string' },
+            isVerifyFormRequired: { type: 'boolean' },
+        }, ['requestId']),
+    },
+    {
+        name: 'contract.request.submit.apply',
+        risk: 'high-risk-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/workflow/core/paService/v1/submitRequest',
+            userIdField: 'userid',
+            secondConfirmation: true,
+            defaults: { isVerifyFormRequired: true },
+        },
+        inputSchema: readSchema({
+            requestId: idString,
+            remark: { type: 'string' },
+            userCurrentNodeId: idString,
+            requestName: { type: 'string' },
+            formdata: { type: 'object' },
+            otherParams: { type: 'string' },
+            isVerifyFormRequired: { type: 'boolean' },
+            continuation: { type: 'string', minLength: 1 },
+            confirm: { const: true },
+        }, ['requestId', 'continuation', 'confirm']),
+    },
+    {
+        name: 'contract.request.supervise.prepare',
+        risk: 'read-before-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/workflow/core/paService/v1/requestSupervise',
+            userIdField: 'userId',
+            secondConfirmation: true,
+            highImpact: true,
+        },
+        inputSchema: readSchema({
+            requestId: idString,
+            remark: { type: 'string' },
+            otherParam: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    otherReminder: { type: 'string' },
+                    currentOperator: { type: 'integer', enum: [0, 1] },
+                    doneOperator: { type: 'integer', enum: [0, 1] },
+                    submitOperator: { type: 'integer', enum: [0, 1] },
+                    ccOperator: { type: 'integer', enum: [0, 1] },
+                    messageRemind: { type: 'integer', enum: [0, 1] },
+                    emailRemind: { type: 'integer', enum: [0, 1] },
+                },
+                anyOf: [
+                    { required: ['currentOperator'] },
+                    { required: ['doneOperator'] },
+                    { required: ['submitOperator'] },
+                    { required: ['ccOperator'] },
+                    { required: ['otherReminder'] },
+                ],
+            },
+        }, ['requestId', 'otherParam']),
+    },
+    {
+        name: 'contract.request.supervise.apply',
+        risk: 'high-risk-write',
+        auth: AUTH,
+        fixed: {
+            writeMethod: 'POST',
+            path: '/api/workflow/core/paService/v1/requestSupervise',
+            userIdField: 'userId',
+            secondConfirmation: true,
+            highImpact: true,
+        },
+        inputSchema: readSchema({
+            requestId: idString,
+            remark: { type: 'string' },
+            otherParam: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    otherReminder: { type: 'string' },
+                    currentOperator: { type: 'integer', enum: [0, 1] },
+                    doneOperator: { type: 'integer', enum: [0, 1] },
+                    submitOperator: { type: 'integer', enum: [0, 1] },
+                    ccOperator: { type: 'integer', enum: [0, 1] },
+                    messageRemind: { type: 'integer', enum: [0, 1] },
+                    emailRemind: { type: 'integer', enum: [0, 1] },
+                },
+                anyOf: [
+                    { required: ['currentOperator'] },
+                    { required: ['doneOperator'] },
+                    { required: ['submitOperator'] },
+                    { required: ['ccOperator'] },
+                    { required: ['otherReminder'] },
+                ],
+            },
+            continuation: { type: 'string', minLength: 1 },
+            confirm: { const: true },
+        }, ['requestId', 'otherParam', 'continuation', 'confirm']),
+    },
+    {
+        name: 'contract.request.status',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/workflow/core/paService/v1/getRequestStatus', userIdField: 'userid' },
+        inputSchema: readSchema({ requestId: idString }, ['requestId']),
+    },
+    {
+        name: 'contract.request.log',
+        risk: 'read',
+        auth: AUTH,
+        fixed: { method: 'GET', path: '/api/workflow/core/paService/v1/getRequestLog', userIdField: 'userid' },
+        inputSchema: readSchema({
+            requestId: idString,
+            otherParams: { type: 'string' },
+        }, ['requestId']),
+    },
+];
+export const contractManifest = {
+    schemaVersion: 1,
+    name: 'contract',
+    title: '泛微E10今承达合同管理',
+    version: '0.1.0',
+    host: 'e10-contract',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-jinchengda',
+    operations: contractOperations,
+    withheldOperations: [
+        {
+            name: 'contract.credit.query',
+            reason: '源资料 enterprise-credit/api-enterprise-credit.md 只有 9 行索引，指向的 api-credit-info.md、api-enterprise-change.md、api-monitor-config.md 三个子文档不存在，缺少接口路径、方法和字段，暂不实现。',
+        },
+        {
+            name: 'contract.credit.change',
+            reason: '企业变更查询接口文档缺失，缺少路径、参数与响应结构。',
+        },
+        {
+            name: 'contract.credit.monitor',
+            reason: '企业监控开启/修改属于写操作，源资料缺少接口路径、参数与确认回查契约。',
+        },
+        {
+            name: 'contract.workflow.withdraw',
+            reason: '撤回/退回接口在源资料中只被提及，未给出路径、方法和参数。',
+        },
+    ],
+};
+export function hasContractOperation(operation) {
+    return contractOperations.some((item) => item.name === operation);
+}

package/dist/shortcuts/contract/operations/clause-reference.js

@@ -0,0 +1,78 @@
+import { contractPartialError, contractPolicyError } from '../errors.js';
+import { maskText, objectFingerprint, requireId } from './shared.js';
+import { ContractWriteApplyOperation, ContractWritePrepareOperation } from './write.js';
+const SAVE_PATH = '/api/ebd/contract/clauseReference/saveData';
+const SELECT_PATH = '/api/ebd/contract/clauseReference/selectData';
+function clauseIdsOf(input) {
+    const value = input.clauseIds;
+    if (!Array.isArray(value) || !value.length) {
+        throw contractPolicyError('clause_ids_required', 'clauseIds 必须是非空 ID 数组');
+    }
+    return value.map((item, index) => requireId(item, `clauseIds[${index}]`));
+}
+async function referencedClauseIds(input, host) {
+    const result = await host.contractRequest({
+        method: 'POST',
+        path: SELECT_PATH,
+        body: {
+            fileId: requireId(input.fileId, 'fileId'),
+            requestId: requireId(input.requestId, 'requestId'),
+            referenceObjType: 1,
+            pageNum: 1,
+            pageSize: 200,
+        },
+    });
+    const records = Array.isArray(result?.data?.records) ? result.data.records : [];
+    return new Set(records.map((item) => String(item?.clauseId ?? '')).filter(Boolean));
+}
+const CLAUSE_REFERENCE_SAVE_SPEC = {
+    method: 'POST',
+    path: SAVE_PATH,
+    defaults: { referenceObjType: 1 },
+    body: (input) => ({
+        clauseIds: clauseIdsOf(input),
+        fileId: requireId(input.fileId, 'fileId'),
+        requestId: requireId(input.requestId, 'requestId'),
+        ...(input.fileName === undefined ? {} : { fileName: String(input.fileName) }),
+        ...(input.requestName === undefined ? {} : { requestName: String(input.requestName) }),
+    }),
+    fingerprint: (input) => objectFingerprint({
+        clauseIds: clauseIdsOf(input),
+        fileId: input.fileId,
+        requestId: input.requestId,
+    }),
+    preview: (input) => ({
+        action: '把条款引用写入合同文档',
+        path: SAVE_PATH,
+        fileId: maskText(input.fileId),
+        requestId: maskText(input.requestId),
+        requestName: input.requestName,
+        clauseCount: clauseIdsOf(input).length,
+        clauseIds: clauseIdsOf(input).map((id) => maskText(id)),
+    }),
+    async precheck(input, host) {
+        const existing = await referencedClauseIds(input, host);
+        const duplicated = clauseIdsOf(input).filter((id) => existing.has(id));
+        if (duplicated.length) {
+            throw contractPolicyError('already_referenced', `以下条款已被该合同文档引用，禁止重复插入：${duplicated.map((id) => maskText(id)).join('、')}`, { duplicatedCount: duplicated.length });
+        }
+        return { existingCount: existing.size, duplicated: false };
+    },
+    async readback(_result, input, host) {
+        const existing = await referencedClauseIds(input, host);
+        const missing = clauseIdsOf(input).filter((id) => !existing.has(id));
+        if (missing.length) {
+            throw contractPartialError('条款引用接口已返回成功，但回读发现部分条款未生效，结果不确定', {
+                missingCount: missing.length,
+                missing: missing.map((id) => maskText(id)),
+            }, { stage: 'readback' });
+        }
+        return { referencedCount: existing.size, insertedCount: clauseIdsOf(input).length };
+    },
+};
+export const contractClauseReferenceSavePrepareOperation = new ContractWritePrepareOperation('contract.clause.reference.save.prepare', 'contract.clause.reference.save.apply', CLAUSE_REFERENCE_SAVE_SPEC);
+export const contractClauseReferenceSaveApplyOperation = new ContractWriteApplyOperation('contract.clause.reference.save.apply', CLAUSE_REFERENCE_SAVE_SPEC);
+export const contractClauseReferenceOperations = [
+    contractClauseReferenceSavePrepareOperation,
+    contractClauseReferenceSaveApplyOperation,
+];