weaver-work-cli 0.1.5 → 0.1.7

package/dist/shortcuts/okr/operations/write.js

@@ -0,0 +1,838 @@
+import { okrApiError, okrPartialError, okrValidationError } from '../errors.js';
+import { businessMessage, isDatajsonSuccess, isFlagSuccess } from '../host.js';
+import { buildStandardSaveBody, createDetailUrlResolver, fetchGoalRaw, goalPrincipalId, okrAbsoluteUrl, resolveLink, } from './link.js';
+import { assertLinkSupported, compact, ebPeriodFields, ensureConfirmLease, fingerprint, optionValue, resolvePeriod, toIdString, toPersonIdListText, toPersonIdString, } from './shared.js';
+import { okrSuccess, schemaOf, SCHEMA_DATE, SCHEMA_ID, SCHEMA_ID_LIST_TEXT, SCHEMA_PERSON_ID, SCHEMA_PERIOD_TYPE, SCHEMA_QUARTER, SCHEMA_SCOPE, } from './types.js';
+const CONTINUATION_TTL_SECONDS = 600;
+/** ebuilder 新建目标接口支持的 mainTable 字段（源资料 okr_createGoal 传入字段）。 */
+const EB_CREATE_KEYS = [
+    'principal_dept',
+    'wb_state',
+    'partners',
+    'obj_name',
+    'principalid',
+    'period_quarter',
+    'period_year',
+    'period_month',
+    'period_type',
+    'parent_id',
+    'category_id',
+    'progress',
+    'm_status',
+    'scope_id',
+    'period_range_0',
+    'period_range_1',
+];
+/** ebuilder 编辑目标接口支持的 mainTable 字段（源资料 okr_updateGoal 传入字段）。 */
+const EB_UPDATE_KEYS = [
+    'id',
+    'isremind',
+    'remind_time',
+    'wb_state',
+    'partners',
+    'obj_name',
+    'principalid',
+    'period_quarter',
+    'period_year',
+    'period_type',
+    'parent_id',
+    'score',
+    'category_id',
+    'scope_id',
+    'period_range_0',
+    'period_range_1',
+    'remark',
+];
+const KEYRESULT_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        name: { type: 'string', minLength: 1, description: '关键成果名称' },
+        principalid: SCHEMA_PERSON_ID,
+        target_value: { type: 'number', description: '目标值' },
+        weight: { type: 'number', description: '权重' },
+    },
+    required: ['name'],
+};
+/** 目标写入字段（新建与编辑共用；编辑时全部可选，未传字段沿用当前详情）。 */
+const GOAL_WRITE_FIELDS = {
+    name: { type: 'string', minLength: 1, description: '目标名称' },
+    period_type: SCHEMA_PERIOD_TYPE,
+    period_range: {
+        type: 'string',
+        minLength: 1,
+        description: '周期范围：年度/季度为 yyyy，月度为 yyyy-MM，自定义为「开始日期,结束日期」',
+    },
+    period_quarter: SCHEMA_QUARTER,
+    principalid: SCHEMA_PERSON_ID,
+    partners: {
+        oneOf: [SCHEMA_ID_LIST_TEXT, { type: 'array', items: SCHEMA_PERSON_ID }],
+        description: '参与人人员 ID（英文逗号拼接或数组）',
+    },
+    scope_id: SCHEMA_SCOPE,
+    scope_data_id: SCHEMA_ID,
+    principal_dept: SCHEMA_ID,
+    parent_id: SCHEMA_ID,
+    category_id: { type: 'string', description: '目标分类 id' },
+    remark: { type: 'string', description: '目标描述' },
+    progress: { type: 'number', minimum: 0, maximum: 100, description: '目标进度' },
+    status: {
+        type: 'string',
+        enum: ['0', '1'],
+        description: '标准版新建/编辑状态：0-保存草稿 1-正式提交（默认 0）',
+    },
+    m_status: {
+        type: 'string',
+        enum: ['1', '2', '3', '4', '5'],
+        description: 'ebuilder 目标进展：1-进行中 2-已完成 3-已撤销 4-审批中 5-未开始（新建默认 1）',
+    },
+    wb_state: { type: 'string', enum: ['1', '2', '3'], description: 'ebuilder 目标紧急状态：1-正常 2-紧急 3-非常紧急' },
+    keyresult_list: {
+        type: 'array',
+        items: KEYRESULT_SCHEMA,
+        description: '随目标一起创建的关键成果（仅标准版链路）',
+    },
+};
+function pickKeys(source, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (source[key] !== undefined && source[key] !== null && source[key] !== '')
+            result[key] = source[key];
+    }
+    return result;
+}
+/** 把用户输入的目标字段映射为 ebuilder mainTable 字段（新建）。 */
+function buildEbCreateMainTable(args, period, principalid) {
+    const scopeId = args.scope_id === undefined ? '1' : String(args.scope_id);
+    const principalDept = args.principal_dept === undefined ? undefined : toIdString(args.principal_dept, 'principal_dept');
+    if (scopeId === '2' && !principalDept) {
+        throw okrValidationError('principal_dept_required', 'ebuilder 链路创建部门目标（scope_id=2）必须提供 principal_dept（责任人部门 id）');
+    }
+    return compact({
+        ...ebPeriodFields(period),
+        obj_name: String(args.name),
+        scope_id: scopeId,
+        principalid,
+        ...(principalDept ? { principal_dept: principalDept } : {}),
+        ...(args.partners === undefined ? {} : { partners: toPersonIdListText(args.partners, 'partners') }),
+        ...(args.parent_id === undefined ? {} : { parent_id: toIdString(args.parent_id, 'parent_id') }),
+        ...(args.category_id === undefined ? {} : { category_id: String(args.category_id) }),
+        // 源资料默认值：目标进展默认为进行中（m_status=1），目标进度默认 0。
+        m_status: args.m_status === undefined ? '1' : String(args.m_status),
+        progress: args.progress === undefined ? 0 : Number(args.progress),
+        ...(args.wb_state === undefined ? {} : { wb_state: String(args.wb_state) }),
+    });
+}
+/** 把目标详情（标准版 obj 结构）还原为新建/编辑请求体字段，用于编辑时全量合并。 */
+function standardBodyFromCurrent(current) {
+    return compact({
+        name: current?.name,
+        scopeId: optionValue(current?.scopeId) ?? (current?.scopeId === undefined ? undefined : String(current.scopeId)),
+        scopeDataId: current?.scopeDataId === undefined ? undefined : String(current.scopeDataId),
+        periodType: optionValue(current?.periodType) ?? (current?.periodType === undefined ? undefined : String(current.periodType)),
+        periodRange: current?.periodRange === undefined ? undefined : String(current.periodRange),
+        periodQuarter: optionValue(current?.periodQuarter) ?? (current?.periodQuarter === undefined ? undefined : String(current.periodQuarter)),
+        principalid: current?.principalid === undefined ? undefined : String(current.principalid),
+        partners: current?.partners === undefined ? undefined : String(current.partners),
+        remark: current?.remark,
+        parentId: current?.parentId === undefined ? undefined : String(current.parentId),
+    });
+}
+/** 构造标准版链路的新建/编辑请求体。 */
+function buildStandardGoalBody(args, mode, host) {
+    const current = host.current ?? {};
+    const base = standardBodyFromCurrent(current);
+    const scopeId = args.scope_id === undefined
+        ? (base.scopeId === undefined ? '1' : String(base.scopeId))
+        : String(args.scope_id);
+    const scopeDataId = args.scope_data_id === undefined
+        ? (base.scopeDataId === undefined ? undefined : String(base.scopeDataId))
+        : toIdString(args.scope_data_id, 'scope_data_id');
+    if (scopeId === '2' && !scopeDataId) {
+        throw okrValidationError('scope_data_id_required', '标准版链路创建/编辑部门目标（scope_id=2）必须提供 scope_data_id（部门 id）');
+    }
+    const periodType = host.period ? host.period.periodType : (base.periodType === undefined ? undefined : String(base.periodType));
+    if (!periodType) {
+        throw okrValidationError('period_type_invalid', '无法从当前目标还原周期类型，请显式提供 period_type 与 period_range');
+    }
+    const periodRange = host.period ? host.period.periodRange : (base.periodRange === undefined ? undefined : String(base.periodRange));
+    if (!periodRange) {
+        throw okrValidationError('period_range_required', '无法从当前目标还原周期范围，请显式提供 period_type 与 period_range');
+    }
+    const periodQuarter = periodType === '2'
+        ? (host.period?.periodQuarter ?? (base.periodQuarter === undefined ? undefined : String(base.periodQuarter)))
+        : undefined;
+    if (periodType === '2' && !periodQuarter) {
+        throw okrValidationError('period_quarter_invalid', '季度目标必须提供 period_quarter（1/2/3/4）');
+    }
+    const keyresultList = Array.isArray(args.keyresult_list)
+        ? args.keyresult_list.map((item) => compact({
+            name: String(item.name),
+            ...(item.principalid === undefined ? {} : { principalid: toPersonIdString(item.principalid, 'keyresult_list[].principalid') }),
+            weight: item.weight === undefined ? '0' : String(item.weight),
+            ...(item.target_value === undefined ? {} : { targetValue: item.target_value }),
+        }))
+        : undefined;
+    // 新建默认保存草稿（源资料：新建目标时默认保存为草稿状态，不直接提交）；
+    // 编辑必须显式指定 status，避免把正式目标静默回退成草稿。
+    let status;
+    if (args.status === undefined) {
+        if (mode === 'update') {
+            throw okrValidationError('status_required', '标准版编辑目标必须显式传 status（0-保存草稿 1-正式提交），避免把正式目标回退为草稿');
+        }
+        status = '0';
+    }
+    else {
+        status = String(args.status);
+    }
+    return buildStandardSaveBody({
+        ...(host.goalId ? { goalId: host.goalId } : {}),
+        name: args.name === undefined ? String(base.name ?? '') : String(args.name),
+        scopeId,
+        ...(scopeDataId ? { scopeDataId } : {}),
+        periodType,
+        periodRange,
+        ...(periodQuarter ? { periodQuarter } : {}),
+        principalid: args.principalid === undefined ? host.principalid : toPersonIdString(args.principalid, 'principalid'),
+        ...(args.partners === undefined
+            ? (base.partners === undefined ? {} : { partners: String(base.partners) })
+            : { partners: toPersonIdListText(args.partners, 'partners') }),
+        ...(args.remark === undefined ? (base.remark === undefined ? {} : { remark: String(base.remark) }) : { remark: String(args.remark) }),
+        ...(keyresultList ? { keyresultList } : {}),
+        status,
+        parentId: args.parent_id === undefined
+            ? (base.parentId === undefined ? '0' : String(base.parentId))
+            : toIdString(args.parent_id, 'parent_id'),
+    });
+}
+function goalPreview(link, body) {
+    if (link === 'standard') {
+        return {
+            目标名称: body.name,
+            目标级别: body.scopeId === '2' ? '部门目标' : '个人目标',
+            周期类型: body.periodType,
+            周期范围: body.periodRange,
+            责任人: body.principalid,
+            参与人: body.partners ?? null,
+            状态: body.status === '1' ? '正式提交' : '保存草稿',
+            上级目标: body.parentId ?? '0',
+            描述: body.remark ?? null,
+        };
+    }
+    return {
+        目标名称: body.obj_name,
+        目标级别: body.scope_id === '2' ? '部门目标' : '个人目标',
+        周期类型: body.period_type,
+        周期范围: `${body.period_range_0 ?? ''} ~ ${body.period_range_1 ?? ''}`,
+        责任人: body.principalid,
+        参与人: body.partners ?? null,
+        进展: body.m_status ?? null,
+        进度: body.progress ?? null,
+        紧急状态: body.wb_state ?? null,
+    };
+}
+async function buildGoalPayload(args, env, mode) {
+    const { host } = env;
+    const { link } = await resolveLink(host);
+    const session = await host.getSession();
+    const notes = [];
+    const warnings = [];
+    const goalId = mode === 'update' ? toIdString(args.id, 'id') : null;
+    const hasPeriod = args.period_type !== undefined || args.period_range !== undefined;
+    let period = null;
+    if (hasPeriod) {
+        if (mode === 'create' && (args.period_type === undefined || args.period_range === undefined)) {
+            throw okrValidationError('period_required', 'okr.create 必须同时传 period_type 与 period_range');
+        }
+        period = resolvePeriod(args);
+    }
+    else if (mode === 'create') {
+        throw okrValidationError('period_required', 'okr.create 必须同时传 period_type 与 period_range');
+    }
+    if (mode === 'create' && (args.name === undefined || String(args.name).trim() === '')) {
+        throw okrValidationError('name_required', 'name（目标名称）必填');
+    }
+    const current = mode === 'update' ? await fetchGoalRaw(host, link, goalId) : null;
+    if (mode === 'update' && !current) {
+        throw okrValidationError('not_found', `未查询到目标 ${goalId}，无法编辑；请确认目标 ID 或查看权限`);
+    }
+    const principalid = args.principalid === undefined
+        ? (mode === 'update' ? (goalPrincipalId(current, link) ?? session.userId) : session.userId)
+        : toPersonIdString(args.principalid, 'principalid');
+    if (link === 'standard') {
+        if (args.m_status !== undefined || args.wb_state !== undefined || args.principal_dept !== undefined) {
+            notes.push('eb_only_fields_ignored:m_status/wb_state/principal_dept');
+        }
+        const body = buildStandardGoalBody(args, mode, { current, principalid, period, ...(goalId ? { goalId } : {}) });
+        return {
+            link,
+            endpoint: mode === 'create' ? 'standard-create' : 'standard-update',
+            goalId,
+            body,
+            preview: goalPreview(link, body),
+            notes,
+            warnings,
+        };
+    }
+    if (args.keyresult_list !== undefined) {
+        notes.push('standard_only_fields_ignored:keyresult_list');
+    }
+    let mainTable;
+    if (mode === 'create') {
+        mainTable = buildEbCreateMainTable(args, period, principalid);
+    }
+    else {
+        const base = pickKeys(current, EB_UPDATE_KEYS);
+        mainTable = compact({
+            ...base,
+            id: goalId,
+            ...(hasPeriod ? ebPeriodFields(period) : {}),
+            ...(args.name === undefined ? {} : { obj_name: String(args.name) }),
+            ...(args.scope_id === undefined ? {} : { scope_id: String(args.scope_id) }),
+            principalid,
+            ...(args.partners === undefined ? {} : { partners: toPersonIdListText(args.partners, 'partners') }),
+            ...(args.parent_id === undefined ? {} : { parent_id: toIdString(args.parent_id, 'parent_id') }),
+            ...(args.category_id === undefined ? {} : { category_id: String(args.category_id) }),
+            ...(args.remark === undefined ? {} : { remark: String(args.remark) }),
+            ...(args.wb_state === undefined ? {} : { wb_state: String(args.wb_state) }),
+        });
+    }
+    return {
+        link,
+        endpoint: mode === 'create' ? 'eb-create' : 'eb-update',
+        goalId,
+        body: mainTable,
+        preview: goalPreview(link, mainTable),
+        notes,
+        warnings,
+    };
+}
+const GOAL_PREPARE_SCHEMA = schemaOf({ ...GOAL_WRITE_FIELDS }, { required: ['name', 'period_type', 'period_range'] });
+const GOAL_UPDATE_PREPARE_SCHEMA = schemaOf({ id: SCHEMA_ID, ...GOAL_WRITE_FIELDS }, { required: ['id'] });
+const GOAL_APPLY_EXTRA = { confirm: { const: true }, continuation: { type: 'string', minLength: 1 } };
+function standardSavePath(endpoint) {
+    return endpoint === 'standard-create' ? '/api/workrelate/goal/create' : '/api/workrelate/goal/update';
+}
+function ebSavePath(endpoint) {
+    return endpoint === 'eb-create'
+        ? '/api/ebuilder/form/formdata/v2/saveFormData/okr_createGoal'
+        : '/api/ebuilder/form/formdata/v2/updateFormData/okr_updateGoal';
+}
+/** 提交目标写入请求，并把返回的新建/编辑目标 ID 转成可点击详情页链接。 */
+async function submitGoalWrite(env, payload, action) {
+    const { host } = env;
+    const session = await host.getSession();
+    let response;
+    try {
+        if (payload.link === 'standard') {
+            response = await host.request({
+                method: 'POST',
+                path: standardSavePath(payload.endpoint),
+                operation: action,
+                body: payload.body,
+            });
+            // 标准版新建/编辑接口源资料只给出 `{data:{...}}` 成功结构，没有独立成功码：
+            // 仅在明确返回 status=false 时判为业务失败，避免把正常返回误判为失败。
+            if (response?.status === false || response?.status === 'false') {
+                throw okrApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+            }
+        }
+        else {
+            response = await host.request({
+                method: 'POST',
+                path: ebSavePath(payload.endpoint),
+                operation: action,
+                body: {
+                    datajson: {
+                        datas: [{ mainTable: payload.body }],
+                        header: { operator: session.userId },
+                    },
+                },
+            });
+            if (!isDatajsonSuccess(response)) {
+                throw okrApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+            }
+        }
+    }
+    catch (error) {
+        if (error?.type === 'network') {
+            throw okrPartialError('目标写入请求发送后连接中断，是否已写入不确定，禁止自动重试，请通过 okr.get 复核', { attempted: { endpoint: payload.endpoint, goalId: payload.goalId, preview: payload.preview } }, { stage: payload.endpoint });
+        }
+        throw error;
+    }
+    let writtenId = payload.goalId;
+    if (!writtenId && payload.link === 'standard') {
+        const rawId = response?.data?.id;
+        writtenId = rawId === undefined || rawId === null || rawId === '' ? null : String(rawId);
+    }
+    if (!writtenId && payload.link === 'eb') {
+        const dataIds = response?.datajson?.dataIds;
+        if (Array.isArray(dataIds) && dataIds.length > 0 && dataIds[0] !== undefined && dataIds[0] !== null) {
+            writtenId = String(dataIds[0]);
+        }
+    }
+    const resolver = await createDetailUrlResolver(host, payload.link);
+    const detailPath = await resolver.resolve(writtenId);
+    const detailUrl = okrAbsoluteUrl(session.baseUrl, detailPath);
+    return okrSuccess(action, {
+        status: 'COMPLETE',
+        link: payload.link,
+        endpoint: payload.endpoint,
+        goalId: writtenId,
+        path: detailPath,
+        detailUrl,
+        anchor: '查看目标详情',
+        result: response,
+    }, {
+        ...(payload.notes.length > 0 ? { notes: payload.notes } : {}),
+        ...(resolver.warnings.length > 0 ? { warnings: resolver.warnings } : {}),
+    });
+}
+function goalWriteDefinitions(mode) {
+    const singular = mode === 'create' ? 'create' : 'update';
+    const label = mode === 'create' ? '新建目标' : '编辑目标';
+    const prepareName = `okr.${singular}.prepare`;
+    const applyName = `okr.${singular}.apply`;
+    const prepare = {
+        name: prepareName,
+        resource: 'okr',
+        method: `${singular}.prepare`,
+        action: prepareName,
+        summary: mode === 'create'
+            ? '准备新建目标：归一化周期/人员/默认值（进展默认进行中、进度默认 0、责任人默认当前用户），生成确认预览，不写入'
+            : '准备编辑目标：先查询当前目标详情并合并修改（全量覆盖），生成确认预览，不写入',
+        capability: 'okr',
+        risk: 'read-before-write',
+        requiresConfirmation: true,
+        inputSchema: mode === 'create' ? GOAL_PREPARE_SCHEMA : GOAL_UPDATE_PREPARE_SCHEMA,
+        handler: async (args, env) => {
+            const payload = await buildGoalPayload(args, env, mode);
+            const session = await env.host.getSession();
+            const token = await env.continuation.issue({
+                operation: applyName,
+                baseUrl: session.baseUrl,
+                profile: session.profile,
+                userId: session.userId,
+                link: payload.link,
+                endpoint: payload.endpoint,
+                goalId: payload.goalId,
+                payload: payload.body,
+                fingerprint: fingerprint(payload.body),
+            }, CONTINUATION_TTL_SECONDS * 1000);
+            return okrSuccess(prepareName, {
+                status: 'AWAITING_CONFIRMATION',
+                link: payload.link,
+                endpoint: payload.endpoint,
+                goalId: payload.goalId,
+                preview: payload.preview,
+                continuation: token,
+                expiresInSeconds: CONTINUATION_TTL_SECONDS,
+            }, {
+                ...(payload.notes.length > 0 ? { notes: payload.notes } : {}),
+                ...(payload.warnings.length > 0 ? { warnings: payload.warnings } : {}),
+            });
+        },
+    };
+    const applyFields = mode === 'create'
+        ? { ...GOAL_WRITE_FIELDS, ...GOAL_APPLY_EXTRA }
+        : { id: SCHEMA_ID, ...GOAL_WRITE_FIELDS, ...GOAL_APPLY_EXTRA };
+    const apply = {
+        name: applyName,
+        resource: 'okr',
+        method: `${singular}.apply`,
+        action: applyName,
+        summary: `提交${label}；必须在用户明确确认后调用，且要求 prepare 返回的 continuation`,
+        capability: 'okr',
+        risk: 'high-risk-write',
+        requiresConfirmation: true,
+        inputSchema: schemaOf(applyFields, { required: mode === 'create' ? ['confirm', 'continuation'] : ['id', 'confirm', 'continuation'] }),
+        handler: async (args, env) => {
+            const lease = await ensureConfirmLease(args, applyName, env);
+            if (mode === 'update') {
+                const goalId = toIdString(args.id, 'id');
+                if (String(lease.goalId ?? '') !== goalId) {
+                    throw okrValidationError('target_changed', '目标 ID 与 prepare 时的快照不一致，请重新执行 prepare');
+                }
+            }
+            const payload = {
+                link: lease.link,
+                endpoint: lease.endpoint,
+                goalId: lease.goalId ?? null,
+                body: (lease.payload ?? {}),
+                preview: {},
+                notes: [],
+                warnings: [],
+            };
+            if (lease.fingerprint !== fingerprint(payload.body)) {
+                throw okrValidationError('target_changed', '写入内容与 prepare 时的快照不一致，请重新执行 prepare');
+            }
+            return submitGoalWrite(env, payload, applyName);
+        },
+    };
+    return [prepare, apply];
+}
+// ---------------------------------------------------------------------------
+// 关键成果保存（新建 / 修改）
+// ---------------------------------------------------------------------------
+const KR_WRITE_FIELDS = {
+    kr_id: { ...SCHEMA_ID, description: '关键成果 ID；不传为新建，传了为修改' },
+    object_id: { ...SCHEMA_ID, description: '所属目标 ID（ebuilder 链路必填）' },
+    name: { type: 'string', minLength: 1, description: '关键成果名称' },
+    principalid: SCHEMA_PERSON_ID,
+    participants: {
+        oneOf: [SCHEMA_ID_LIST_TEXT, { type: 'array', items: SCHEMA_PERSON_ID }],
+        description: '参与人人员 ID（仅标准版链路）',
+    },
+    target_value: { type: 'number', description: '目标值' },
+    actual_value: { type: 'number', description: '实际值' },
+    weight: { type: 'number', description: '权重' },
+    progress: { type: 'number', minimum: 0, maximum: 100, description: '进度' },
+    score: { type: 'number', description: '分数' },
+    range: {
+        oneOf: [
+            { type: 'array', items: SCHEMA_DATE, minItems: 2, maxItems: 2 },
+            { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2},\\d{4}-\\d{2}-\\d{2}$' },
+        ],
+        description: '起止日期 [开始, 结束]，yyyy-MM-dd',
+    },
+    kr_unit: { type: 'string', description: '单位（仅 ebuilder 链路）' },
+    confidence: { type: 'number', description: '信心指数（仅 ebuilder 链路）' },
+    risk: { type: 'string', enum: ['1', '2', '3'], description: '风险指数：1-正常 2-有风险 3-已延期（仅 ebuilder 链路）' },
+};
+function resolveDateRange(value) {
+    if (value === undefined || value === null || value === '')
+        return null;
+    const parts = Array.isArray(value) ? value.map((item) => String(item)) : String(value).split(',');
+    if (parts.length !== 2 || !/^\d{4}-\d{2}-\d{2}$/.test(parts[0]) || !/^\d{4}-\d{2}-\d{2}$/.test(parts[1])) {
+        throw okrValidationError('range_invalid', 'range 必须是 [开始日期, 结束日期]（yyyy-MM-dd）或「开始日期,结束日期」字符串');
+    }
+    if (parts[0] > parts[1]) {
+        throw okrValidationError('range_invalid', 'range 的开始日期不能晚于结束日期');
+    }
+    return [parts[0], parts[1]];
+}
+async function buildKrPayload(args, env) {
+    const { host } = env;
+    const { link } = await resolveLink(host);
+    const session = await host.getSession();
+    const notes = [];
+    const krId = args.kr_id === undefined ? null : toIdString(args.kr_id, 'kr_id');
+    const name = String(args.name ?? '').trim();
+    if (!name)
+        throw okrValidationError('name_required', 'name（关键成果名称）必填');
+    const principalid = args.principalid === undefined
+        ? session.userId
+        : toPersonIdString(args.principalid, 'principalid');
+    const range = resolveDateRange(args.range);
+    if (link === 'standard') {
+        for (const field of ['kr_unit', 'confidence', 'risk']) {
+            if (args[field] !== undefined)
+                notes.push(`eb_only_fields_ignored:${field}`);
+        }
+        const objectId = toIdString(args.object_id, 'object_id');
+        const body = compact({
+            baseInfo: compact({
+                ...(krId ? { id: krId } : {}),
+                objectId,
+                name,
+                principalId: principalid,
+                ...(args.participants === undefined
+                    ? {}
+                    : { participants: toPersonIdListText(args.participants, 'participants') }),
+                ...(args.target_value === undefined ? {} : { targetValue: args.target_value }),
+                ...(args.actual_value === undefined ? {} : { actualValue: args.actual_value }),
+                ...(args.weight === undefined ? {} : { weight: args.weight }),
+                ...(args.progress === undefined ? {} : { progress: args.progress }),
+                ...(args.score === undefined ? {} : { score: args.score }),
+                ...(range ? { range } : {}),
+            }),
+        });
+        return {
+            link,
+            endpoint: 'standard-kr-save',
+            body,
+            preview: {
+                关键成果名称: name,
+                所属目标: objectId,
+                责任人: principalid,
+                目标值: args.target_value ?? null,
+                实际值: args.actual_value ?? null,
+                权重: args.weight ?? null,
+                起止日期: range ? range.join(' ~ ') : null,
+                操作: krId ? `修改（${krId}）` : '新建',
+            },
+            notes,
+        };
+    }
+    if (args.participants !== undefined)
+        notes.push('standard_only_fields_ignored:participants');
+    const mainTable = compact({
+        ...(krId ? { id: krId } : {}),
+        object_id: toIdString(args.object_id, 'object_id'),
+        wk_name: name,
+        principalid,
+        ...(args.target_value === undefined ? {} : { target_value: args.target_value }),
+        ...(args.actual_value === undefined ? {} : { actual_value: args.actual_value }),
+        ...(args.weight === undefined ? {} : { weight: args.weight }),
+        ...(args.progress === undefined ? {} : { progress: args.progress }),
+        ...(args.score === undefined ? {} : { score: args.score }),
+        ...(range ? { plan_start_end_0: range[0], plan_start_end_1: range[1] } : {}),
+        ...(args.kr_unit === undefined ? {} : { kr_unit: String(args.kr_unit) }),
+        ...(args.confidence === undefined ? {} : { confidence: args.confidence }),
+        ...(args.risk === undefined ? {} : { risk: String(args.risk) }),
+    });
+    return {
+        link,
+        endpoint: krId ? 'eb-kr-update' : 'eb-kr-create',
+        body: mainTable,
+        preview: {
+            关键成果名称: name,
+            所属目标: mainTable.object_id,
+            责任人: principalid,
+            目标值: args.target_value ?? null,
+            实际值: args.actual_value ?? null,
+            权重: args.weight ?? null,
+            起止日期: range ? range.join(' ~ ') : null,
+            操作: krId ? `修改（${krId}）` : '新建',
+        },
+        notes,
+    };
+}
+const okrKrSavePrepare = {
+    name: 'okr.kr.save.prepare',
+    resource: 'okr',
+    method: 'kr.save.prepare',
+    action: 'okr.kr.save.prepare',
+    summary: '准备新建/修改关键成果（传 kr_id 为修改，不传为新建），生成确认预览，不写入',
+    capability: 'okr',
+    risk: 'read-before-write',
+    requiresConfirmation: true,
+    inputSchema: schemaOf({ ...KR_WRITE_FIELDS }, { required: ['object_id', 'name'] }),
+    handler: async (args, env) => {
+        const payload = await buildKrPayload(args, env);
+        const session = await env.host.getSession();
+        const token = await env.continuation.issue({
+            operation: 'okr.kr.save.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            link: payload.link,
+            endpoint: payload.endpoint,
+            payload: payload.body,
+            fingerprint: fingerprint(payload.body),
+        }, CONTINUATION_TTL_SECONDS * 1000);
+        return okrSuccess('okr.kr.save.prepare', {
+            status: 'AWAITING_CONFIRMATION',
+            link: payload.link,
+            endpoint: payload.endpoint,
+            preview: payload.preview,
+            continuation: token,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
+        }, payload.notes.length > 0 ? { notes: payload.notes } : undefined);
+    },
+};
+const okrKrSaveApply = {
+    name: 'okr.kr.save.apply',
+    resource: 'okr',
+    method: 'kr.save.apply',
+    action: 'okr.kr.save.apply',
+    summary: '提交关键成果保存；必须在用户明确确认后调用，且要求 prepare 返回的 continuation',
+    capability: 'okr',
+    risk: 'high-risk-write',
+    requiresConfirmation: true,
+    inputSchema: schemaOf({ ...KR_WRITE_FIELDS, confirm: { const: true }, continuation: { type: 'string', minLength: 1 } }, { required: ['object_id', 'name', 'confirm', 'continuation'] }),
+    handler: async (args, env) => {
+        const lease = await ensureConfirmLease(args, 'okr.kr.save.apply', env);
+        const body = (lease.payload ?? {});
+        if (lease.fingerprint !== fingerprint(body)) {
+            throw okrValidationError('target_changed', '写入内容与 prepare 时的快照不一致，请重新执行 prepare');
+        }
+        const session = await env.host.getSession();
+        const endpoint = lease.endpoint;
+        let response;
+        try {
+            if (endpoint === 'standard-kr-save') {
+                response = await env.host.request({
+                    method: 'POST',
+                    path: '/api/workrelate/goal/fs/krForm/saveForm',
+                    operation: 'okr.kr.save.apply',
+                    body,
+                });
+                if (!isFlagSuccess(response)) {
+                    throw okrApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+                }
+            }
+            else {
+                response = await env.host.request({
+                    method: 'POST',
+                    path: endpoint === 'eb-kr-create'
+                        ? '/api/ebuilder/form/formdata/v2/saveFormData/okr_createKeyResult'
+                        : '/api/ebuilder/form/formdata/v2/updateFormData/okr_updateKeyResult',
+                    operation: 'okr.kr.save.apply',
+                    body: {
+                        datajson: {
+                            datas: [{ mainTable: body }],
+                            header: { operator: session.userId },
+                        },
+                    },
+                });
+                if (!isDatajsonSuccess(response)) {
+                    throw okrApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+                }
+            }
+        }
+        catch (error) {
+            if (error?.type === 'network') {
+                throw okrPartialError('关键成果保存请求发送后连接中断，是否已写入不确定，禁止自动重试，请通过 okr.get / okr.kr.list 复核', { attempted: { endpoint } }, { stage: endpoint });
+            }
+            throw error;
+        }
+        return okrSuccess('okr.kr.save.apply', {
+            status: 'COMPLETE',
+            link: lease.link,
+            endpoint,
+            result: response,
+        });
+    },
+};
+// ---------------------------------------------------------------------------
+// 添加目标对齐（ebuilder 链路专属）
+// ---------------------------------------------------------------------------
+const ALIGN_FIELDS = {
+    current_id: { ...SCHEMA_ID, description: '当前目标 ID' },
+    align_obj_id: { ...SCHEMA_ID, description: '对齐目标 ID' },
+    cur_obj_principalid: SCHEMA_PERSON_ID,
+    ali_obj_principalid: SCHEMA_PERSON_ID,
+};
+async function buildAlignPayload(args, env) {
+    const { host } = env;
+    const { link } = await resolveLink(host);
+    assertLinkSupported(link, 'eb', 'okr.align.create', 'e10 标准版链路源资料未提供「添加目标对齐」接口，无法执行目标对齐');
+    const currentId = toIdString(args.current_id, 'current_id');
+    const alignObjId = toIdString(args.align_obj_id, 'align_obj_id');
+    if (currentId === alignObjId) {
+        throw okrValidationError('align_invalid', '当前目标与对齐目标不能是同一个目标');
+    }
+    // 未显式提供双方负责人时，用目标详情接口取值；取不到就明确报错，绝不臆造。
+    let curPrincipal = args.cur_obj_principalid === undefined
+        ? null
+        : toPersonIdString(args.cur_obj_principalid, 'cur_obj_principalid');
+    let aliPrincipal = args.ali_obj_principalid === undefined
+        ? null
+        : toPersonIdString(args.ali_obj_principalid, 'ali_obj_principalid');
+    if (!curPrincipal) {
+        const raw = await fetchGoalRaw(host, 'eb', currentId);
+        curPrincipal = goalPrincipalId(raw, 'eb');
+    }
+    if (!aliPrincipal) {
+        const raw = await fetchGoalRaw(host, 'eb', alignObjId);
+        aliPrincipal = goalPrincipalId(raw, 'eb');
+    }
+    if (!curPrincipal || !aliPrincipal) {
+        throw okrValidationError('align_principal_unresolved', '无法从目标详情解析双方负责人，请显式提供 cur_obj_principalid 与 ali_obj_principalid（人员 ID 由 weaver-e10-hrm skill 解析）', { currentId, alignObjId });
+    }
+    const body = compact({
+        current_id: currentId,
+        align_obj_id: alignObjId,
+        cur_obj_principalid: curPrincipal,
+        ali_obj_principalid: aliPrincipal,
+    });
+    return {
+        body,
+        preview: {
+            当前目标: currentId,
+            当前目标负责人: curPrincipal,
+            对齐目标: alignObjId,
+            对齐目标负责人: aliPrincipal,
+        },
+    };
+}
+const okrAlignCreatePrepare = {
+    name: 'okr.align.create.prepare',
+    resource: 'okr',
+    method: 'align.create.prepare',
+    action: 'okr.align.create.prepare',
+    summary: '准备添加目标对齐（仅 ebuilder 链路）：补全双方负责人并生成确认预览，不写入',
+    capability: 'okr',
+    risk: 'read-before-write',
+    requiresConfirmation: true,
+    inputSchema: schemaOf({ ...ALIGN_FIELDS }, { required: ['current_id', 'align_obj_id'] }),
+    handler: async (args, env) => {
+        const payload = await buildAlignPayload(args, env);
+        const session = await env.host.getSession();
+        const token = await env.continuation.issue({
+            operation: 'okr.align.create.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            link: 'eb',
+            payload: payload.body,
+            fingerprint: fingerprint(payload.body),
+        }, CONTINUATION_TTL_SECONDS * 1000);
+        return okrSuccess('okr.align.create.prepare', {
+            status: 'AWAITING_CONFIRMATION',
+            link: 'eb',
+            preview: payload.preview,
+            continuation: token,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
+        });
+    },
+};
+const okrAlignCreateApply = {
+    name: 'okr.align.create.apply',
+    resource: 'okr',
+    method: 'align.create.apply',
+    action: 'okr.align.create.apply',
+    summary: '提交添加目标对齐；必须在用户明确确认后调用，且要求 prepare 返回的 continuation',
+    capability: 'okr',
+    risk: 'high-risk-write',
+    requiresConfirmation: true,
+    inputSchema: schemaOf({ ...ALIGN_FIELDS, confirm: { const: true }, continuation: { type: 'string', minLength: 1 } }, { required: ['current_id', 'align_obj_id', 'confirm', 'continuation'] }),
+    handler: async (args, env) => {
+        const lease = await ensureConfirmLease(args, 'okr.align.create.apply', env);
+        const body = (lease.payload ?? {});
+        if (String(body.current_id ?? '') !== toIdString(args.current_id, 'current_id')) {
+            throw okrValidationError('target_changed', '当前目标 ID 与 prepare 时的快照不一致，请重新执行 prepare');
+        }
+        if (lease.fingerprint !== fingerprint(body)) {
+            throw okrValidationError('target_changed', '写入内容与 prepare 时的快照不一致，请重新执行 prepare');
+        }
+        const session = await env.host.getSession();
+        let response;
+        try {
+            response = await env.host.request({
+                method: 'POST',
+                path: '/api/ebuilder/form/formdata/v2/saveFormData/okr_createGoalAlign',
+                operation: 'okr.align.create.apply',
+                body: {
+                    datajson: {
+                        datas: [{ mainTable: body }],
+                        header: { operator: session.userId },
+                    },
+                },
+            });
+        }
+        catch (error) {
+            if (error?.type === 'network') {
+                throw okrPartialError('目标对齐请求发送后连接中断，是否已写入不确定，禁止自动重试，请通过 okr.get 复核', { attempted: { current_id: body.current_id, align_obj_id: body.align_obj_id } }, { stage: 'okr.align.create.apply' });
+            }
+            throw error;
+        }
+        if (!isDatajsonSuccess(response)) {
+            throw okrApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+        }
+        return okrSuccess('okr.align.create.apply', {
+            status: 'COMPLETE',
+            link: 'eb',
+            result: response,
+        });
+    },
+};
+export const okrWriteOperations = [
+    ...goalWriteDefinitions('create'),
+    ...goalWriteDefinitions('update'),
+    okrKrSavePrepare,
+    okrKrSaveApply,
+    okrAlignCreatePrepare,
+    okrAlignCreateApply,
+];