vps-work 2.4.1 → 2.5.1

package/dist/packages/vps-work/src/commands/task/task-center.js

@@ -0,0 +1,595 @@
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { VertuError } from '../../core/errors.js';
+import { attachSharedShortcutOptions, mergeShortcutParams, parseOptionalInt, parseOptionalFloat, previewShortcutRequest, } from '../shortcut-common.js';
+function applyListFilters(query, opts, kind) {
+    for (const [name, value] of [['start_time', opts.startTime], ['end_time', opts.endTime]]) {
+        if (value !== undefined) {
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || !Number.isFinite(Date.parse(value)) || new Date(value).toISOString().slice(0, 10) !== value)
+                throw new VertuError(`${name} must be a valid YYYY-MM-DD date`);
+            query[name] = value;
+        }
+    }
+    if (opts.startTime && opts.endTime && opts.startTime > opts.endTime)
+        throw new VertuError('start_time must not exceed end_time');
+    if (opts.dateField !== undefined) {
+        const fields = ['created_at', 'updated_at', 'deadline', 'completed_at', ...(kind === 'tasks' ? ['start_date'] : [])];
+        if (!fields.includes(opts.dateField))
+            throw new VertuError(`date_field must be one of: ${fields.join(', ')}`);
+        query.date_field = opts.dateField;
+    }
+    if (opts.includeDepartment === false)
+        query.include_department = false;
+    const raw = kind === 'tasks' ? opts.offset : opts.page;
+    if (raw !== undefined) {
+        const n = Number(raw);
+        if (!/^\d+$/.test(raw) || !Number.isSafeInteger(n) || n < (kind === 'tasks' ? 0 : 1))
+            throw new VertuError('Invalid pagination value');
+        query[kind === 'tasks' ? 'offset' : 'page'] = n;
+    }
+}
+function resolveBaseUrl(opts, cmd) {
+    const merged = cmd.optsWithGlobals();
+    return opts.baseUrl ?? merged.baseUrl;
+}
+function requireNonEmpty(raw, flag) {
+    const value = raw?.trim();
+    if (!value) {
+        throw new VertuError(`${flag} is required.`);
+    }
+    return value;
+}
+function requireId(raw, flag) {
+    const value = raw?.trim();
+    if (!value) {
+        throw new VertuError(`${flag} is required.`);
+    }
+    return value;
+}
+function requireUpdateBody(body) {
+    const fields = ['name', 'project_type', 'description', 'goal', 'priority', 'progress',
+        'status', 'owner_user_id', 'start_date', 'deadline', 'milestones'];
+    if (!fields.some((field) => Object.hasOwn(body, field))) {
+        throw new VertuError('At least one project field is required for update.');
+    }
+}
+function rejectDeleteParams(opts) {
+    if (opts.params !== undefined || opts.paramsFile !== undefined) {
+        throw new VertuError('Delete commands have a fixed archive action; --params is not supported.');
+    }
+}
+function putString(target, key, raw) {
+    const value = raw?.trim();
+    if (value) {
+        target[key] = value;
+    }
+}
+function putInt(target, key, raw, flag) {
+    const value = parseOptionalInt(raw, flag);
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+function putOkrContributionWeight(target, raw) {
+    const value = parseOptionalFloat(raw, '--okr-contribution-weight');
+    if (value === undefined)
+        return;
+    if (value <= 0 || value > 100) {
+        throw new VertuError('--okr-contribution-weight must be greater than 0 and at most 100.');
+    }
+    target.okr_contribution_weight = value;
+}
+function putPositiveInt(target, key, raw, flag) {
+    const value = parseOptionalInt(raw, flag);
+    if (value !== undefined) {
+        if (!Number.isSafeInteger(value) || value <= 0) {
+            throw new VertuError(`Invalid ${flag}: expected a positive integer.`);
+        }
+        target[key] = value;
+    }
+}
+function putMeetingTodoSource(body, opts) {
+    const meetingId = opts.meetingId?.trim();
+    const rawIndex = opts.meetingTodoIndex?.trim();
+    if (!meetingId && !rawIndex)
+        return;
+    if (!meetingId) {
+        throw new VertuError('--meeting-todo-index requires --meeting-id.');
+    }
+    if (!rawIndex) {
+        throw new VertuError('--meeting-id requires --meeting-todo-index.');
+    }
+    const index = parseOptionalInt(rawIndex, '--meeting-todo-index');
+    if (index === undefined || index <= 0) {
+        throw new VertuError('Invalid --meeting-todo-index: expected a positive integer.');
+    }
+    body.source = 'ai';
+    body.source_ref = `meeting-minutes:${meetingId}:todo:${index - 1}`;
+}
+function taskRelation(raw) {
+    const value = raw?.trim() || 'all';
+    if (value !== 'all' && value !== 'created' && value !== 'assisting') {
+        throw new VertuError('Invalid --relation: expected all, created or assisting.');
+    }
+    return value;
+}
+function todoRelation(raw) {
+    const value = raw?.trim() || 'all';
+    if (value !== 'all' &&
+        value !== 'owned' &&
+        value !== 'created' &&
+        value !== 'following' &&
+        value !== 'assisting' &&
+        value !== 'completed') {
+        throw new VertuError('Invalid --relation: expected all, owned, created, following, assisting or completed.');
+    }
+    return value;
+}
+function departmentSection(raw) {
+    const value = raw?.trim() || 'all';
+    if (value === 'all' || value === 'projects' || value === 'tasks' || value === 'todos' || value === 'files') {
+        return value;
+    }
+    throw new VertuError('Invalid --section: expected all, projects, tasks, todos or files.');
+}
+async function allDepartmentItems(baseUrl, departmentId, section, pageSize, userId) {
+    const items = [];
+    let offset = 0;
+    let first = null;
+    while (true) {
+        const page = await imRequest('GET', '/v1/task-center/department-overview', {
+            baseUrl,
+            query: { department_id: departmentId, section, limit: pageSize, offset, user_id: userId },
+        });
+        first ??= page;
+        const rows = Array.isArray(page.items) ? page.items : [];
+        items.push(...rows);
+        if (!page.page?.has_more || rows.length === 0)
+            break;
+        offset += rows.length;
+    }
+    return {
+        ...(first ?? {}),
+        items,
+        page: {
+            total: first?.page?.total ?? items.length,
+            returned: items.length,
+            has_more: false,
+        },
+    };
+}
+function attachTaskCenterList(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+tc-department-overview')
+        .description('任务中心：按部门管理员授权读取部门及子部门的项目、任务和待办')
+        .option('--department-id <id>', '授权部门 ID；省略时列出当前账号的部门授权')
+        .option('--user-id <id>', '集成 API Key 查询时指定员工 res.users ID；账号会话始终使用本人')
+        .option('--section <name>', 'all|projects|tasks|todos|files', 'all')
+        .option('--page-size <n>', '每次请求条数，1-200', '200')).action(async (opts, cmd) => {
+        const baseUrl = resolveBaseUrl(opts, cmd);
+        const userId = parseOptionalInt(opts.userId, '--user-id');
+        if (userId !== undefined && (!Number.isSafeInteger(userId) || userId <= 0)) {
+            throw new VertuError('Invalid --user-id: expected a positive integer.');
+        }
+        if (!opts.departmentId?.trim()) {
+            if (opts.section !== 'all' || opts.pageSize !== '200') {
+                throw new VertuError('--section and --page-size require --department-id.');
+            }
+            const query = { user_id: userId };
+            if (previewShortcutRequest(opts, cmd, 'GET', '/v1/task-center/department-overview', { query }))
+                return;
+            const result = await imRequest('GET', '/v1/task-center/department-overview', { baseUrl, query });
+            printImResult(opts.json, result);
+            return;
+        }
+        const departmentId = parseOptionalInt(opts.departmentId, '--department-id');
+        if (departmentId === undefined || departmentId <= 0) {
+            throw new VertuError('Invalid --department-id: expected a positive integer.');
+        }
+        const pageSize = parseOptionalInt(opts.pageSize, '--page-size') ?? 200;
+        if (pageSize < 1 || pageSize > 200) {
+            throw new VertuError('Invalid --page-size: expected an integer from 1 to 200.');
+        }
+        const selected = departmentSection(opts.section);
+        const sections = selected === 'all'
+            ? ['projects', 'tasks', 'todos']
+            : [selected];
+        if (previewShortcutRequest(opts, cmd, 'GET', '/v1/task-center/department-overview', {
+            query: {
+                department_id: departmentId,
+                sections,
+                limit: pageSize,
+                offset: 0,
+                user_id: userId,
+            },
+        }))
+            return;
+        const pages = await Promise.all(sections.map((section) => allDepartmentItems(baseUrl, departmentId, section, pageSize, userId)));
+        if (selected !== 'all') {
+            printImResult(opts.json, pages[0]);
+            return;
+        }
+        printImResult(opts.json, {
+            ok: true,
+            department: pages[0]?.department ?? null,
+            sections: Object.fromEntries(pages.map((page, index) => [sections[index], {
+                    total: page.page?.total ?? page.items?.length ?? 0,
+                    items: page.items ?? [],
+                }])),
+        });
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-tasks')
+        .description('任务中心：我的任务列表（新任务助手，直连库）')
+        .option('--limit <n>', '最多返回条数', '200')
+        .option('--start-time <date>', '起始日期 YYYY-MM-DD（业务时区）')
+        .option('--end-time <date>', '结束日期 YYYY-MM-DD（含当天）')
+        .option('--date-field <field>', '日期字段：deadline、created_at、updated_at、completed_at、start_date')
+        .option('--no-include-department', '不扩大到部门范围')
+        .option('--offset <n>', '翻页位置（从 0 开始）')
+        .option('--relation <name>', 'all|created|assisting', 'all')
+        .option('--principal-user-id <id>', '仅查看指定被协助人的全部相关事项；需 relation=assisting')
+        .option('--owner-user-id <id>', '按负责人 res.users id 过滤')
+        .option('--project-id <id>', '按项目过滤（task-center 项目 UUID）')
+        .option('--okr-objective-id <id>', '按 OKR 目标过滤')
+        .option('--isolated', '仅未关联项目/OKR 的临时任务', false)
+        .option('--include-parents', '包含用于汇总进度的父任务', false)
+        .option('--include-closed', '包含已完成/已取消', false)).action(async (opts, cmd) => {
+        const query = {
+            limit: parseOptionalInt(opts.limit, '--limit') ?? 200,
+            relation: taskRelation(opts.relation),
+        };
+        putPositiveInt(query, 'principal_user_id', opts.principalUserId, '--principal-user-id');
+        if (query.principal_user_id !== undefined && query.relation !== 'assisting') {
+            throw new VertuError('--principal-user-id requires --relation assisting.');
+        }
+        putPositiveInt(query, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        putString(query, 'project_id', opts.projectId);
+        putString(query, 'okr_objective_id', opts.okrObjectiveId);
+        if (opts.isolated) {
+            query.isolated = true;
+        }
+        if (opts.includeClosed) {
+            query.open_only = false;
+        }
+        if (opts.includeParents) {
+            query.include_parents = true;
+        }
+        applyListFilters(query, opts, 'tasks');
+        const result = await imRequest('GET', '/v1/task-center/tasks', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-todos')
+        .description('任务中心：我的待办列表（新任务助手，直连库）')
+        .option('--limit <n>', '最多返回条数', '200')
+        .option('--start-time <date>', '起始日期 YYYY-MM-DD（业务时区）')
+        .option('--end-time <date>', '结束日期 YYYY-MM-DD（含当天）')
+        .option('--date-field <field>', '日期字段：deadline、created_at、updated_at、completed_at')
+        .option('--no-include-department', '不扩大到部门范围')
+        .option('--page <n>', '翻页位置（从 1 开始）')
+        .option('--relation <name>', 'all|owned|created|following|assisting|completed', 'all')
+        .option('--principal-user-id <id>', '仅查看指定被协助人的全部相关事项；需 relation=assisting')
+        .option('--owner-user-id <id>', '按负责人 res.users id 过滤')
+        .option('--include-closed', '包含已完成/已取消', false)).action(async (opts, cmd) => {
+        const query = {
+            limit: parseOptionalInt(opts.limit, '--limit') ?? 200,
+            relation: todoRelation(opts.relation),
+        };
+        putPositiveInt(query, 'principal_user_id', opts.principalUserId, '--principal-user-id');
+        if (query.principal_user_id !== undefined && query.relation !== 'assisting') {
+            throw new VertuError('--principal-user-id requires --relation assisting.');
+        }
+        putPositiveInt(query, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        if (opts.includeClosed) {
+            query.open_only = false;
+        }
+        applyListFilters(query, opts, 'todos');
+        const result = await imRequest('GET', '/v1/task-center/todos', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-assisted-users')
+        .description('任务中心：当前登录用户可协助的 PDCA 用户（只读授权上下文）')).action(async (opts, cmd) => {
+        const result = await imRequest('GET', '/v1/workbench/pdca/assistant-principals', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent.command('+tc-projects').description('任务中心：我参与的项目列表')).action(async (opts, cmd) => {
+        const result = await imRequest('GET', '/v1/task-center/projects', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+        });
+        printImResult(opts.json, result);
+    });
+}
+function attachTaskCenterTaskWrite(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+tc-task-create')
+        .description('任务中心：创建任务')
+        .requiredOption('--title <text>', '任务标题')
+        .option('--description <text>', '任务描述')
+        .option('--status <name>', 'not_started|in_progress|paused|done|cancelled')
+        .option('--priority <n>', '0-3')
+        .option('--progress <n>', '0-100')
+        .option('--owner-user-id <id>', '负责人 res.users id（默认自己）')
+        .option('--project-id <id>', '所属项目 UUID')
+        .option('--start-date <ymd>', 'YYYY-MM-DD')
+        .option('--deadline <ymd>', 'YYYY-MM-DD')
+        .option('--okr-kr-id <id>', '关联正式 KR ID')
+        .option('--okr-contribution-weight <n>', '该任务对 KR 的贡献权重，(0, 100]')).action(async (opts, cmd) => {
+        const body = { title: requireNonEmpty(opts.title, '--title') };
+        putString(body, 'description', opts.description);
+        putString(body, 'status', opts.status);
+        putInt(body, 'priority', opts.priority, '--priority');
+        putInt(body, 'progress', opts.progress, '--progress');
+        putInt(body, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        putString(body, 'project_id', opts.projectId);
+        putString(body, 'start_date', opts.startDate);
+        putString(body, 'deadline', opts.deadline);
+        putString(body, 'okr_kr_id', opts.okrKrId);
+        putOkrContributionWeight(body, opts.okrContributionWeight);
+        const merged = await mergeShortcutParams(body, opts);
+        if (previewShortcutRequest(opts, cmd, 'POST', '/v1/task-center/tasks', { body: merged }))
+            return;
+        const result = await imRequest('POST', '/v1/task-center/tasks', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body: merged,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-task-update')
+        .description('任务中心：更新任务（PATCH）')
+        .requiredOption('--task-id <id>', '任务 UUID')
+        .option('--title <text>', '标题')
+        .option('--description <text>', '描述')
+        .option('--status <name>', 'not_started|in_progress|paused|done|cancelled')
+        .option('--progress <n>', '0-100')
+        .option('--priority <n>', '0-3')
+        .option('--owner-user-id <id>', '负责人 res.users id')
+        .option('--activity-content <text>', '本次进展内容；更新进度时写入任务活动记录')
+        .option('--okr-kr-id <id>', '绑定到正式 KR ID')
+        .option('--okr-contribution-weight <n>', '该任务对 KR 的贡献权重，(0, 100]')
+        .option('--clear-okr', '解除当前正式 OKR/KR 关联', false)).action(async (opts, cmd) => {
+        const taskId = requireId(opts.taskId, '--task-id');
+        const body = {};
+        putString(body, 'title', opts.title);
+        putString(body, 'description', opts.description);
+        putString(body, 'status', opts.status);
+        putInt(body, 'progress', opts.progress, '--progress');
+        putInt(body, 'priority', opts.priority, '--priority');
+        putInt(body, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        putString(body, 'activity_content', opts.activityContent);
+        if (opts.clearOkr && opts.okrKrId?.trim()) {
+            throw new VertuError('--clear-okr and --okr-kr-id cannot be used together.');
+        }
+        if (opts.clearOkr) {
+            body.okr_objective_id = null;
+            body.okr_kr_id = null;
+        }
+        else {
+            putString(body, 'okr_kr_id', opts.okrKrId);
+        }
+        putOkrContributionWeight(body, opts.okrContributionWeight);
+        const merged = await mergeShortcutParams(body, opts);
+        const path = `/v1/task-center/tasks/${encodeURIComponent(taskId)}`;
+        if (previewShortcutRequest(opts, cmd, 'PATCH', path, { body: merged }))
+            return;
+        const result = await imRequest('PATCH', path, {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body: merged,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent.command('+tc-task-delete')
+        .description('任务中心：归档任务（可恢复，不物理删除）')
+        .requiredOption('--task-id <id>', '任务 UUID')).action(async (opts, cmd) => {
+        rejectDeleteParams(opts);
+        const path = `/v1/task-center/tasks/${encodeURIComponent(requireId(opts.taskId, '--task-id'))}`;
+        const body = { status: 'archived' };
+        if (previewShortcutRequest(opts, cmd, 'PATCH', path, { body }))
+            return;
+        printImResult(opts.json, await imRequest('PATCH', path, {
+            baseUrl: resolveBaseUrl(opts, cmd), body,
+        }));
+    });
+}
+function attachTaskCenterTodoWrite(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+tc-todo-create')
+        .description('任务中心：创建待办')
+        .requiredOption('--title <text>', '待办标题')
+        .option('--remark <text>', '备注')
+        .option('--priority <n>', '0-3')
+        .option('--owner-user-id <id>', '负责人 res.users id（默认自己）')
+        .option('--project-id <id>', '所属项目 UUID')
+        .option('--deadline <ymd>', 'YYYY-MM-DD')
+        .option('--meeting-id <id>', '关联会议/录音 ID（meeting +detail 的 id 或 minutes_id）')
+        .option('--meeting-todo-index <n>', '会议待办序号（从 1 开始；与 --meeting-id 同时使用）')).action(async (opts, cmd) => {
+        const body = { title: requireNonEmpty(opts.title, '--title') };
+        putString(body, 'remark', opts.remark);
+        putInt(body, 'priority', opts.priority, '--priority');
+        putInt(body, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        putString(body, 'project_id', opts.projectId);
+        putString(body, 'deadline', opts.deadline);
+        putMeetingTodoSource(body, opts);
+        const merged = await mergeShortcutParams(body, opts);
+        const result = await imRequest('POST', '/v1/task-center/todos', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body: merged,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-todo-update')
+        .description('任务中心：更新待办（PATCH；完成用 --status done）')
+        .requiredOption('--todo-id <id>', '待办 UUID')
+        .option('--title <text>', '标题')
+        .option('--remark <text>', '备注')
+        .option('--status <name>', 'pending|in_progress|done|cancelled')
+        .option('--progress <n>', '0-100')
+        .option('--priority <n>', '0-3')).action(async (opts, cmd) => {
+        const todoId = requireId(opts.todoId, '--todo-id');
+        const body = {};
+        putString(body, 'title', opts.title);
+        putString(body, 'remark', opts.remark);
+        putString(body, 'status', opts.status);
+        putInt(body, 'progress', opts.progress, '--progress');
+        putInt(body, 'priority', opts.priority, '--priority');
+        const merged = await mergeShortcutParams(body, opts);
+        const result = await imRequest('PATCH', `/v1/task-center/todos/${encodeURIComponent(todoId)}`, {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body: merged,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent.command('+tc-todo-delete')
+        .description('任务中心：归档待办（可恢复，不物理删除）')
+        .requiredOption('--todo-id <id>', '待办 UUID')).action(async (opts, cmd) => {
+        rejectDeleteParams(opts);
+        const path = `/v1/task-center/todos/${encodeURIComponent(requireId(opts.todoId, '--todo-id'))}`;
+        const body = { status: 'archived' };
+        if (previewShortcutRequest(opts, cmd, 'PATCH', path, { body }))
+            return;
+        printImResult(opts.json, await imRequest('PATCH', path, {
+            baseUrl: resolveBaseUrl(opts, cmd), body,
+        }));
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-todo-convert')
+        .description('任务中心：待办转任务')
+        .requiredOption('--todo-id <id>', '待办 UUID')
+        .option('--title <text>', '覆盖任务标题')
+        .option('--project-id <id>', '关联项目 UUID')
+        .option('--deadline <ymd>', 'YYYY-MM-DD')
+        .option('--priority <n>', '0-3')).action(async (opts, cmd) => {
+        const todoId = requireId(opts.todoId, '--todo-id');
+        const body = {};
+        putString(body, 'title', opts.title);
+        putString(body, 'project_id', opts.projectId);
+        putString(body, 'deadline', opts.deadline);
+        putInt(body, 'priority', opts.priority, '--priority');
+        const merged = await mergeShortcutParams(body, opts);
+        const result = await imRequest('POST', `/v1/task-center/todos/${encodeURIComponent(todoId)}`, {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query: { action: 'convert' },
+            body: merged,
+        });
+        printImResult(opts.json, result);
+    });
+}
+function attachTaskCenterProjectAndOkr(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+tc-okr-options')
+        .description('任务中心：列出当前用户可绑定的正式 OKR/KR')
+        .option('--period <ym>', 'YYYY-MM，省略=当前周期')
+        .option('--owner-type <person|department>', '限定个人或部门 OKR')
+        .option('--owner-id <id>', '与 --owner-type 配套的负责人或部门 ID')).action(async (opts, cmd) => {
+        const query = {};
+        putString(query, 'period', opts.period);
+        putString(query, 'owner_type', opts.ownerType);
+        putString(query, 'owner_id', opts.ownerId);
+        if (previewShortcutRequest(opts, cmd, 'GET', '/v1/task-center/okr-options', { query }))
+            return;
+        const result = await imRequest('GET', '/v1/task-center/okr-options', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tc-project-create')
+        .description('任务中心：创建项目（创建人自动成为管理员）')
+        .requiredOption('--name <text>', '项目名称')
+        .option('--description <text>', '项目描述')
+        .option('--goal <text>', '项目目标')
+        .option('--priority <n>', '0-3')
+        .option('--owner-user-id <id>', '负责人 res.users id（默认自己）')
+        .option('--start-date <ymd>', 'YYYY-MM-DD')
+        .option('--deadline <ymd>', 'YYYY-MM-DD')).action(async (opts, cmd) => {
+        const body = { name: requireNonEmpty(opts.name, '--name') };
+        putString(body, 'description', opts.description);
+        putString(body, 'goal', opts.goal);
+        putInt(body, 'priority', opts.priority, '--priority');
+        putInt(body, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        putString(body, 'start_date', opts.startDate);
+        putString(body, 'deadline', opts.deadline);
+        const merged = await mergeShortcutParams(body, opts);
+        const result = await imRequest('POST', '/v1/task-center/projects', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body: merged,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent.command('+tc-project-update')
+        .description('任务中心：更新项目（PATCH）')
+        .requiredOption('--project-id <id>', '项目 UUID')
+        .option('--name <text>', '项目名称')
+        .option('--project-type <text>', '项目类型')
+        .option('--description <text>', '项目描述')
+        .option('--goal <text>', '项目目标')
+        .option('--priority <n>', '0-3')
+        .option('--progress <n>', '0-100')
+        .option('--status <name>', 'not_started|in_progress|paused|completed|cancelled|archived')
+        .option('--owner-user-id <id>', '负责人 res.users id')
+        .option('--start-date <ymd>', 'YYYY-MM-DD')
+        .option('--deadline <ymd>', 'YYYY-MM-DD')).action(async (opts, cmd) => {
+        const path = `/v1/task-center/projects/${encodeURIComponent(requireId(opts.projectId, '--project-id'))}`;
+        const body = {};
+        putString(body, 'name', opts.name);
+        putString(body, 'project_type', opts.projectType);
+        putString(body, 'description', opts.description);
+        putString(body, 'goal', opts.goal);
+        putInt(body, 'priority', opts.priority, '--priority');
+        putInt(body, 'progress', opts.progress, '--progress');
+        putString(body, 'status', opts.status);
+        putPositiveInt(body, 'owner_user_id', opts.ownerUserId, '--owner-user-id');
+        putString(body, 'start_date', opts.startDate);
+        putString(body, 'deadline', opts.deadline);
+        const merged = await mergeShortcutParams(body, opts);
+        requireUpdateBody(merged);
+        if (previewShortcutRequest(opts, cmd, 'PATCH', path, { body: merged }))
+            return;
+        printImResult(opts.json, await imRequest('PATCH', path, {
+            baseUrl: resolveBaseUrl(opts, cmd), body: merged,
+        }));
+    });
+    attachSharedShortcutOptions(parent.command('+tc-project-delete')
+        .description('任务中心：归档项目（可恢复，不物理删除）')
+        .requiredOption('--project-id <id>', '项目 UUID')).action(async (opts, cmd) => {
+        rejectDeleteParams(opts);
+        const path = `/v1/task-center/projects/${encodeURIComponent(requireId(opts.projectId, '--project-id'))}`;
+        if (previewShortcutRequest(opts, cmd, 'DELETE', path))
+            return;
+        printImResult(opts.json, await imRequest('DELETE', path, {
+            baseUrl: resolveBaseUrl(opts, cmd),
+        }));
+    });
+    attachSharedShortcutOptions(parent
+        .command('+my-okr')
+        .description('任务助手：我的/团队 OKR（task-assistant，直连库）')
+        .option('--type <mine|team>', '默认 mine', 'mine')
+        .option('--period <ym>', 'YYYY-MM，省略=当前周期')).action(async (opts, cmd) => {
+        const type = opts.type?.trim() === 'team' ? 'team' : 'mine';
+        const query = { type };
+        putString(query, 'period', opts.period);
+        const result = await imRequest('GET', '/v1/task-assistant/okr', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+}
+/** 新任务中心（task-center）+ 任务助手 OKR 子命令，统一挂在 `task` 命令下。 */
+export function attachTaskCenterShortcuts(parent) {
+    attachTaskCenterList(parent);
+    attachTaskCenterTaskWrite(parent);
+    attachTaskCenterTodoWrite(parent);
+    attachTaskCenterProjectAndOkr(parent);
+}