weaver-work-cli 0.1.6 → 0.1.7

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

@@ -0,0 +1,381 @@
+import { createHash } from 'node:crypto';
+import { okrConfirmationError, okrValidationError } from '../errors.js';
+import { EB_M_STATUS_LABELS, PERIOD_TYPE_LABELS, STANDARD_STATUS_LABELS, } from './types.js';
+import { okrUnsupportedError } from '../errors.js';
+/** 原型污染防护：禁止出现在输入对象中的键。 */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/** 凭证类字段禁止出现在业务输入中：认证由 CLI 托管。 */
+const FORBIDDEN_INPUT_KEYS = new Set([
+    'authorization',
+    'cookie',
+    'eteamsid',
+    'access_token',
+    'app_key',
+    'app_secret',
+    'token',
+    'user_agent',
+]);
+export function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw okrValidationError('input_not_object', '输入必须是 JSON 对象');
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    for (const key of Object.keys(input)) {
+        if (FORBIDDEN_KEYS.has(key)) {
+            throw okrValidationError('forbidden_key', `输入包含非法字段：${key}`);
+        }
+        if (FORBIDDEN_INPUT_KEYS.has(key.toLowerCase())) {
+            throw okrValidationError('field_forbidden', `禁止业务输入字段：${key}（认证由 CLI 托管）`);
+        }
+    }
+}
+export function toIdString(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw okrValidationError('id_invalid', `${field} 必须是数字 ID（雪花 ID 请用字符串传递）`);
+    }
+    const text = String(value);
+    if (!/^\d+$/.test(text)) {
+        throw okrValidationError('id_invalid', `${field} 必须是数字 ID`);
+    }
+    return text;
+}
+/**
+ * 人员 ID 归一化。源资料强制规则：入参不能直接传人员名称，必须先由 weaver-e10-hrm skill 解析为
+ * id 或 employeeId；这里在 CLI 边界再做一次硬校验，避免姓名被当成 ID 传下去。
+ */
+export function toPersonIdString(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw okrValidationError('person_id_required', `${field} 必填`);
+    }
+    const text = String(value);
+    if (!/^\d+$/.test(text)) {
+        throw okrValidationError('person_id_invalid', `${field} 必须是人员 ID（数字字符串），不能直接传人员名称；请先通过 weaver-e10-hrm skill 用姓名解析出 id 或 employeeId（禁止取 userId 字段）`, { field, value: text });
+    }
+    return text;
+}
+/** 人员 ID 列表归一化：接受 `"1001,1002"` 或 `["1001","1002"]`，输出英文逗号拼接字符串。 */
+export function toPersonIdListText(value, field) {
+    const list = [];
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (item === undefined || item === null || item === '')
+                continue;
+            list.push(String(item));
+        }
+    }
+    else if (typeof value === 'string' || typeof value === 'number') {
+        for (const part of String(value).split(',')) {
+            const trimmed = part.trim();
+            if (trimmed)
+                list.push(trimmed);
+        }
+    }
+    else {
+        throw okrValidationError('person_id_invalid', `${field} 必须是人员 ID 或人员 ID 数组`);
+    }
+    if (list.length === 0) {
+        throw okrValidationError('person_id_required', `${field} 至少需要一个人员 ID`);
+    }
+    for (const id of list) {
+        if (!/^\d+$/.test(id)) {
+            throw okrValidationError('person_id_invalid', `${field} 必须是人员 ID（数字字符串），不能直接传人员名称；请先通过 weaver-e10-hrm skill 解析`, { field, value: id });
+        }
+    }
+    return list.join(',');
+}
+/** 移除值为 undefined / null / '' 的键（ebuilder 自定义接口要求空字符串字段直接不传）。 */
+export function compact(value) {
+    for (const key of Object.keys(value)) {
+        const item = value[key];
+        if (item === undefined || item === null || item === '')
+            delete value[key];
+    }
+    return value;
+}
+/** eb Select 字段归一化：可能是 `[{name,id}]`、`["1"]`、`"1"` 或数字，统一返回标量字符串。 */
+export function optionValue(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (Array.isArray(value)) {
+        const first = value[0];
+        if (first === undefined || first === null)
+            return undefined;
+        if (typeof first === 'string' || typeof first === 'number')
+            return String(first);
+        if (typeof first === 'object') {
+            const record = first;
+            const candidate = record.id ?? record.value ?? record.name;
+            if (candidate === undefined || candidate === null || candidate === '')
+                return undefined;
+            return String(candidate);
+        }
+        return undefined;
+    }
+    if (typeof value === 'string' || typeof value === 'number')
+        return String(value);
+    return undefined;
+}
+/** 从 eb datajson 响应中取出 datas[].mainTable 列表。 */
+export function ebMainTables(value) {
+    const datas = value?.datajson?.datas;
+    if (!Array.isArray(datas))
+        return [];
+    const list = [];
+    for (const item of datas) {
+        if (item && typeof item === 'object' && item.mainTable && typeof item.mainTable === 'object') {
+            list.push(item.mainTable);
+        }
+    }
+    return list;
+}
+export function fingerprint(value) {
+    return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
+}
+export function requireConfirm(args, action) {
+    if (args.confirm !== true) {
+        throw okrConfirmationError(action, {
+            hint: '重新调用时传入 confirm=true 与 prepare 返回的 continuation',
+        });
+    }
+}
+/** 校验 confirm + continuation，并确认登录上下文未变化。 */
+export async function ensureConfirmLease(args, action, env) {
+    requireConfirm(args, action);
+    const lease = await env.continuation.verify(args.continuation, action);
+    const session = await env.host.getSession();
+    if (lease.baseUrl !== session.baseUrl || lease.profile !== session.profile || lease.userId !== session.userId) {
+        throw okrValidationError('context_mismatch', '确认上下文已变化（租户或登录账号不同），请重新执行 prepare');
+    }
+    return lease;
+}
+/** 断言当前链路支持该能力，否则抛 policy 错误（源资料未提供该链路的实现依据）。 */
+export function assertLinkSupported(link, supported, capability, message, details) {
+    if (link !== supported) {
+        throw okrUnsupportedError('link_unsupported', message, {
+            capability,
+            link,
+            expectedLink: supported,
+            ...(details || {}),
+        });
+    }
+}
+function pad(value) {
+    return String(value).padStart(2, '0');
+}
+function lastDayOfMonth(year, month) {
+    return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+export function assertPeriodType(value) {
+    const text = value === undefined || value === null ? '' : String(value);
+    if (!['1', '2', '3', '4'].includes(text)) {
+        throw okrValidationError('period_type_invalid', 'period_type 取值必须是 1（年度）/ 2（季度）/ 3（月度）/ 4（自定义）');
+    }
+    return text;
+}
+/**
+ * 解析并校验周期参数。源资料约定：
+ * - 年度目标：period_range 为年份字符串，示例 "2026"
+ * - 季度目标：period_range 为年份字符串，同时用 period_quarter 标识季度，示例 "4"
+ * - 月度目标：period_range 为 yyyy-MM，示例 "2026-04"
+ * - 自定义周期：period_range 为「开始日期,结束日期」，示例 "2026-01-01,2026-12-31"
+ */
+export function resolvePeriod(args) {
+    const periodType = assertPeriodType(args.period_type);
+    const periodRange = args.period_range;
+    if (typeof periodRange !== 'string' || !periodRange.trim()) {
+        throw okrValidationError('period_range_required', 'period_range（周期范围）必填，格式随 period_type 变化');
+    }
+    const range = periodRange.trim();
+    const spec = { periodType, periodRange: range };
+    if (periodType === '1') {
+        if (!/^\d{4}$/.test(range)) {
+            throw okrValidationError('period_range_invalid', '年度目标的 period_range 必须是年份字符串，示例 "2026"');
+        }
+        return spec;
+    }
+    if (periodType === '2') {
+        if (!/^\d{4}$/.test(range)) {
+            throw okrValidationError('period_range_invalid', '季度目标的 period_range 必须是年份字符串，示例 "2026"');
+        }
+        const quarter = args.period_quarter === undefined || args.period_quarter === null || args.period_quarter === ''
+            ? ''
+            : String(args.period_quarter);
+        if (!['1', '2', '3', '4'].includes(quarter)) {
+            throw okrValidationError('period_quarter_invalid', '季度目标的 period_quarter 必填，取值 1/2/3/4');
+        }
+        spec.periodQuarter = quarter;
+        return spec;
+    }
+    if (periodType === '3') {
+        if (!/^\d{4}-\d{2}$/.test(range)) {
+            throw okrValidationError('period_range_invalid', '月度目标的 period_range 必须是 yyyy-MM 格式，示例 "2026-04"');
+        }
+        return spec;
+    }
+    if (!/^\d{4}-\d{2}-\d{2},\d{4}-\d{2}-\d{2}$/.test(range)) {
+        throw okrValidationError('period_range_invalid', '自定义周期目标的 period_range 必须是「开始日期,结束日期」格式，示例 "2026-01-01,2026-12-31"');
+    }
+    const [start, end] = range.split(',');
+    if (start > end) {
+        throw okrValidationError('period_range_invalid', '自定义周期的开始日期不能晚于结束日期');
+    }
+    return spec;
+}
+/** 把周期转换为 ebuilder 表单字段（period_year / period_month / period_quarter / period_range_0 / period_range_1）。 */
+export function ebPeriodFields(spec) {
+    const fields = { period_type: spec.periodType };
+    if (spec.periodType === '1') {
+        const year = Number(spec.periodRange);
+        fields.period_year = spec.periodRange;
+        fields.period_range_0 = `${year}-01-01`;
+        fields.period_range_1 = `${year}-12-31`;
+        return fields;
+    }
+    if (spec.periodType === '2') {
+        const year = Number(spec.periodRange);
+        const quarter = Number(spec.periodQuarter);
+        const startMonth = (quarter - 1) * 3 + 1;
+        const endMonth = startMonth + 2;
+        fields.period_year = spec.periodRange;
+        fields.period_quarter = String(quarter);
+        fields.period_range_0 = `${year}-${pad(startMonth)}-01`;
+        fields.period_range_1 = `${year}-${pad(endMonth)}-${pad(lastDayOfMonth(year, endMonth))}`;
+        return fields;
+    }
+    if (spec.periodType === '3') {
+        const [yearText, monthText] = spec.periodRange.split('-');
+        const year = Number(yearText);
+        const month = Number(monthText);
+        fields.period_year = yearText;
+        fields.period_month = spec.periodRange;
+        fields.period_range_0 = `${yearText}-${monthText}-01`;
+        fields.period_range_1 = `${yearText}-${monthText}-${pad(lastDayOfMonth(year, month))}`;
+        return fields;
+    }
+    const [start, end] = spec.periodRange.split(',');
+    fields.period_range_0 = start;
+    fields.period_range_1 = end;
+    return fields;
+}
+/**
+ * ebuilder 列表筛选字段：只传源资料列出的筛选字段，空值不传。
+ * 周期筛选同时给到 period_type + 派生字段（period_year / period_month / period_quarter）
+ * 与起止日期字段 period_range_0 / period_range_1，保证按周期命中的目标集合精确可预期。
+ */
+export function ebPeriodFilters(spec) {
+    const fields = ebPeriodFields(spec);
+    const filters = {
+        period_type: spec.periodType,
+        period_range_0: fields.period_range_0,
+        period_range_1: fields.period_range_1,
+    };
+    if (fields.period_year)
+        filters.period_year = fields.period_year;
+    if (spec.periodType === '2')
+        filters.period_quarter = String(spec.periodQuarter);
+    else if (fields.period_month)
+        filters.period_month = fields.period_month;
+    return filters;
+}
+function asText(value) {
+    if (value === undefined || value === null)
+        return null;
+    const text = String(value);
+    return text === '' ? null : text;
+}
+function asNumber(value) {
+    if (value === undefined || value === null || value === '')
+        return null;
+    const numeric = Number(value);
+    return Number.isFinite(numeric) ? numeric : null;
+}
+function periodTypeLabelOf(periodType) {
+    return periodType ? (PERIOD_TYPE_LABELS[periodType] ?? null) : null;
+}
+/** 标准版目标对象 → 统一业务结构（status 用标准版状态映射）。 */
+export function normalizeStandardGoal(item, detailUrl, keyresultList) {
+    const periodType = asText(item?.periodType);
+    const status = asText(item?.status);
+    return {
+        goalId: asText(item?.id),
+        name: asText(item?.name),
+        principalid: asText(item?.principalid),
+        principalName: asText(item?.principalName),
+        periodType,
+        periodTypeLabel: periodTypeLabelOf(periodType),
+        periodRange: asText(item?.periodRange),
+        periodStart: asText(item?.periodStart),
+        periodEnd: asText(item?.periodEnd),
+        status,
+        statusLabel: status ? (STANDARD_STATUS_LABELS[status] ?? null) : null,
+        progress: asNumber(item?.progress),
+        score: asNumber(item?.score),
+        parentId: asText(item?.parentId),
+        creator: asText(item?.creator),
+        createTime: asText(item?.createTime),
+        remark: asText(item?.remark),
+        detailUrl,
+        ...(keyresultList === undefined ? {} : { keyresultList }),
+    };
+}
+/** ebuilder mainTable → 统一业务结构（m_status 用 ebuilder 进展映射）。 */
+export function normalizeEbGoal(mainTable, detailUrl) {
+    const periodType = optionValue(mainTable?.period_type) ?? null;
+    const mStatus = optionValue(mainTable?.m_status) ?? null;
+    const start = asText(optionValue(mainTable?.period_range_0));
+    const end = asText(optionValue(mainTable?.period_range_1));
+    const principal = mainTable?.principalid;
+    const principalName = Array.isArray(principal)
+        ? asText(principal[0]?.name ?? principal[0]?.value)
+        : asText(principal?.name);
+    return {
+        goalId: asText(mainTable?.id),
+        name: asText(mainTable?.obj_name),
+        principalid: Array.isArray(principal)
+            ? asText(principal[0]?.id ?? principal[0])
+            : (asText(typeof principal === 'object' && principal ? principal.id : principal)),
+        principalName,
+        periodType,
+        periodTypeLabel: periodTypeLabelOf(periodType),
+        periodRange: start && end ? `${start} ~ ${end}` : (start ?? end),
+        periodStart: start,
+        periodEnd: end,
+        status: mStatus,
+        statusLabel: mStatus ? (EB_M_STATUS_LABELS[mStatus] ?? null) : null,
+        progress: asNumber(optionValue(mainTable?.progress)),
+        score: asNumber(optionValue(mainTable?.score)),
+        parentId: asText(optionValue(mainTable?.parent_id)),
+        creator: asText(optionValue(mainTable?.creator)),
+        createTime: asText(mainTable?.create_time),
+        remark: asText(mainTable?.remark),
+        detailUrl,
+    };
+}
+/**
+ * 分页目标列表的表格输出。源资料强制规则：固定列「目标名称、目标责任人名称、目标周期类型、
+ * 目标周期范围」，且目标名称可点击直接跳转目标详情。
+ */
+export function buildGoalTable(goals) {
+    const columns = ['目标名称', '目标责任人名称', '目标周期类型', '目标周期范围'];
+    const rows = goals.map((goal) => ({
+        name: goal.name ?? '',
+        principalName: goal.principalName ?? '',
+        periodType: goal.periodTypeLabel ?? '',
+        periodRange: goal.periodRange ?? '',
+        view_link: goal.detailUrl,
+        anchor: goal.name ?? '',
+    }));
+    const header = `| ${columns.join(' | ')} |`;
+    const divider = `| ${columns.map(() => '---').join(' | ')} |`;
+    const body = rows.map((row) => {
+        const nameCell = row.view_link ? `[${row.anchor}](${row.view_link})` : row.anchor;
+        return `| ${nameCell} | ${row.principalName} | ${row.periodType} | ${row.periodRange} |`;
+    });
+    return {
+        columns,
+        rows,
+        markdown: [header, divider, ...body].join('\n'),
+    };
+}

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

@@ -0,0 +1,88 @@
+export function okrSuccess(action, data, meta) {
+    const payload = { ok: true, action, data };
+    if (meta && Object.keys(meta).length > 0)
+        payload.meta = meta;
+    return payload;
+}
+/** 构造「对象类型 + 严格禁止额外字段」的 JSON Schema。 */
+export function schemaOf(properties, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(options.required?.length ? { required: options.required } : {}),
+        ...(options.oneOf?.length ? { oneOf: options.oneOf } : {}),
+        ...(options.anyOf?.length ? { anyOf: options.anyOf } : {}),
+        ...(options.description ? { description: options.description } : {}),
+    };
+}
+/** 目标 / 关键成果 ID：雪花 ID 语义，接受数字或数字字符串。 */
+export const SCHEMA_ID = {
+    oneOf: [{ type: 'integer' }, { type: 'string', pattern: '^\\d+$' }],
+};
+/**
+ * 人员 ID：必须保持字符串形态（源资料强制规则：雪花 ID 传参必须加引号包裹为字符串，避免精度丢失）。
+ */
+export const SCHEMA_PERSON_ID = { type: 'string', minLength: 1, pattern: '^\\d+$' };
+/** 多个人员 ID（英文逗号拼接）。 */
+export const SCHEMA_ID_LIST_TEXT = { type: 'string', pattern: '^\\d+(,\\d+)*$' };
+/** 日期 yyyy-MM-dd。 */
+export const SCHEMA_DATE = { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' };
+/** 周期类型：1-年度 2-季度 3-月度 4-自定义。 */
+export const PERIOD_TYPE_VALUES = ['1', '2', '3', '4'];
+export const SCHEMA_PERIOD_TYPE = { type: 'string', enum: [...PERIOD_TYPE_VALUES] };
+/** 季度：1-4。 */
+export const QUARTER_VALUES = ['1', '2', '3', '4'];
+export const SCHEMA_QUARTER = { type: 'string', enum: [...QUARTER_VALUES] };
+/** 目标级别：1-个人 2-部门。 */
+export const SCOPE_VALUES = ['1', '2'];
+export const SCHEMA_SCOPE = { type: 'string', enum: [...SCOPE_VALUES] };
+/** 周期类型文案。 */
+export const PERIOD_TYPE_LABELS = {
+    '1': '年度',
+    '2': '季度',
+    '3': '月度',
+    '4': '自定义',
+};
+/** 目标级别文案（两个链路语义一致）。 */
+export const SCOPE_LABELS = {
+    '1': '个人目标',
+    '2': '部门目标',
+};
+/** e10 标准版目标状态：0-草稿 1-进行中 2-已完成 3-已撤销 4-目标制定待审批 5-目标更新待审批 6-目标完成待审批。 */
+export const STANDARD_STATUS_LABELS = {
+    '0': '草稿',
+    '1': '进行中',
+    '2': '已完成',
+    '3': '已撤销',
+    '4': '目标制定待审批',
+    '5': '目标更新待审批',
+    '6': '目标完成待审批',
+};
+/** e10 标准版新建/编辑接口的 status：0-保存草稿 1-正式提交。 */
+export const STANDARD_SAVE_STATUS_LABELS = {
+    '0': '保存草稿',
+    '1': '正式提交',
+};
+/** ebuilder 目标进展 m_status：1-进行中 2-已完成 3-已撤销 4-审批中 5-未开始。 */
+export const EB_M_STATUS_LABELS = {
+    '1': '进行中',
+    '2': '已完成',
+    '3': '已撤销',
+    '4': '审批中',
+    '5': '未开始',
+};
+/** ebuilder 目标紧急状态 wb_state：1-正常 2-紧急 3-非常紧急。 */
+export const WB_STATE_LABELS = {
+    '1': '正常',
+    '2': '紧急',
+    '3': '非常紧急',
+};
+/** ebuilder 关键成果风险指数 risk：1-正常 2-有风险 3-已延期。 */
+export const KR_RISK_LABELS = {
+    '1': '正常',
+    '2': '有风险',
+    '3': '已延期',
+};
+/** 关键成果列表固定展示列（源资料强制规则：目标名称、目标责任人名称、目标周期类型、目标周期范围）。 */
+export const GOAL_TABLE_COLUMNS = ['目标名称', '目标责任人名称', '目标周期类型', '目标周期范围'];