vps-work 2.5.0 → 2.5.1

package/dist/packages/vps-work/src/commands/approval/shortcuts.js

@@ -0,0 +1,259 @@
+import { VertuError } from '../../core/errors.js';
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { attachSharedShortcutOptions, parseOptionalInt, resolveShortcutVpsServiceUrl, } from '../shortcut-common.js';
+function requireDocArgs(opts) {
+    const resModel = opts.resModel?.trim();
+    if (!resModel) {
+        throw new VertuError('--res-model is required.');
+    }
+    const resId = parseOptionalInt(opts.resId, '--res-id');
+    if (resId === undefined) {
+        throw new VertuError('Invalid --res-id.');
+    }
+    return { resModel, resId };
+}
+function approvalCenterSource(raw) {
+    const source = raw?.trim() || 'all';
+    if (source !== 'all' && source !== 'business' && source !== 'attendance') {
+        throw new VertuError('--source must be one of: all, business, attendance.');
+    }
+    return source;
+}
+function approvalPendingScope(raw) {
+    const scope = raw?.trim() || 'mine';
+    if (scope !== 'mine' && scope !== 'department' && scope !== 'all') {
+        throw new VertuError('--scope must be one of: mine, department, all.');
+    }
+    return scope;
+}
+function csvPositiveIds(raw, flag) {
+    if (!raw?.trim())
+        return undefined;
+    const ids = raw.split(',').map((value) => Number(value.trim()));
+    if (ids.some((value) => !Number.isInteger(value) || value <= 0)) {
+        throw new VertuError(`${flag} must be comma-separated positive integers.`);
+    }
+    return [...new Set(ids)].join(',');
+}
+function eventDate(item) {
+    const value = item.event_date;
+    return typeof value === 'string' ? value : '';
+}
+async function listApprovalCenter(tab, opts, cmd) {
+    const limit = parseOptionalInt(opts.limit, '--limit') ?? 20;
+    const offset = parseOptionalInt(opts.offset, '--offset') ?? 0;
+    if (limit < 1)
+        throw new VertuError('--limit must be at least 1.');
+    if (offset < 0)
+        throw new VertuError('--offset must be at least 0.');
+    if (opts.all && offset !== 0) {
+        throw new VertuError('--all cannot be combined with a non-zero --offset.');
+    }
+    const source = approvalCenterSource(opts.source);
+    const merged = cmd.optsWithGlobals();
+    const baseUrl = opts.baseUrl ?? merged.baseUrl;
+    const page = async (pageSource, pageOffset) => (await imRequest('GET', '/v1/approvals/center', {
+        baseUrl,
+        query: { tab, limit, offset: pageOffset, source: pageSource === 'business' ? 'odoo' : pageSource },
+    }));
+    if (!opts.all)
+        return page(source, offset);
+    const sources = source === 'all' ? ['business', 'attendance'] : [source];
+    const items = [];
+    let firstPage;
+    for (const pageSource of sources) {
+        let pageOffset = 0;
+        while (true) {
+            const current = await page(pageSource, pageOffset);
+            firstPage ??= current;
+            items.push(...current.items);
+            if (!current.has_more)
+                break;
+            const nextOffset = current.next_offset;
+            if (typeof nextOffset !== 'number' || nextOffset <= pageOffset) {
+                throw new VertuError('Vertu 服务返回了无效的审批分页游标。');
+            }
+            pageOffset = nextOffset;
+        }
+    }
+    items.sort((left, right) => eventDate(right).localeCompare(eventDate(left)));
+    return {
+        ok: firstPage?.ok ?? true,
+        tab,
+        count: items.length,
+        items,
+        has_more: false,
+        next_offset: null,
+        web_url: firstPage?.web_url,
+    };
+}
+export function attachApprovalShortcuts(parent) {
+    const waitListOpts = (cmd) => cmd.option('--limit <n>', 'Max rows', '200');
+    const centerListOpts = (cmd) => cmd
+        .option('--limit <n>', 'Rows per page (server maximum: 20)', '20')
+        .option('--offset <n>', 'Starting row offset', '0')
+        .option('--source <source>', '审批来源：all、business 或 attendance', 'all')
+        .option('--all', 'Fetch all pages (separates sources to avoid skipped rows)', false);
+    attachSharedShortcutOptions(waitListOpts(parent
+        .command('+wait')
+        .description('待我审批（含单据标题与关键字段）'))).action(async (opts, cmd) => {
+        const limit = parseOptionalInt(opts.limit, '--limit') ?? 50;
+        const merged = cmd.optsWithGlobals();
+        const result = (await imRequest('GET', '/v1/approvals', {
+            baseUrl: opts.baseUrl ?? merged.baseUrl,
+            query: { limit },
+        }));
+        if (opts.json === false) {
+            if (!result.items.length) {
+                console.log('当前没有待你审批的单据。');
+                return;
+            }
+            console.log(`待审批 ${result.count} 条：`);
+            result.items.forEach((item, index) => {
+                const head = `${index + 1}. ${item.title ?? item.flow_name} (${item.res_model}#${item.res_id})`;
+                const fields = (item.fields ?? [])
+                    .map((field) => `${field.label}: ${field.value}`)
+                    .join('；');
+                console.log(fields ? `${head} — ${fields}` : head);
+            });
+            return;
+        }
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+pending')
+        .description('按本人、负责部门或全公司查询待审批单')
+        .option('--scope <scope>', 'Query scope: mine, department, or all', 'mine')
+        .option('--department-ids <ids>', 'Comma-separated approver department IDs')
+        .option('--approver-user-ids <ids>', 'Comma-separated approver user IDs')
+        .option('--limit <n>', 'Rows per page (server maximum: 200)', '50')
+        .option('--offset <n>', 'Starting row offset', '0')
+        .option('--all', 'Fetch all pages', false)
+        .option('--all-pages', 'Alias for --all', false)).action(async (opts, cmd) => {
+        const scope = approvalPendingScope(opts.scope);
+        const limit = parseOptionalInt(opts.limit, '--limit') ?? 50;
+        let offset = parseOptionalInt(opts.offset, '--offset') ?? 0;
+        if (limit < 1 || limit > 200)
+            throw new VertuError('--limit must be between 1 and 200.');
+        if (offset < 0)
+            throw new VertuError('--offset must be at least 0.');
+        const fetchAll = opts.all === true || opts.allPages === true;
+        if (fetchAll && offset !== 0) {
+            throw new VertuError('--all cannot be combined with a non-zero --offset.');
+        }
+        const merged = cmd.optsWithGlobals();
+        const baseUrl = opts.baseUrl ?? merged.baseUrl;
+        const query = {
+            scope,
+            limit,
+            department_ids: csvPositiveIds(opts.departmentIds, '--department-ids'),
+            approver_user_ids: csvPositiveIds(opts.approverUserIds, '--approver-user-ids'),
+        };
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            printImResult(opts.json, {
+                validateOnly: true,
+                endpoint: `${resolveShortcutVpsServiceUrl(opts, cmd)}/v1/approvals`,
+                query: { ...query, offset },
+                all: fetchAll,
+            });
+            return;
+        }
+        const items = [];
+        let first = null;
+        while (true) {
+            const page = await imRequest('GET', '/v1/approvals', {
+                baseUrl,
+                query: { ...query, offset },
+            });
+            first ??= page;
+            items.push(...(Array.isArray(page.items) ? page.items : []));
+            if (!fetchAll || page.has_more !== true)
+                break;
+            if (typeof page.next_offset !== 'number' || page.next_offset <= offset) {
+                throw new VertuError('Vertu 服务返回了无效的审批分页游标。');
+            }
+            offset = page.next_offset;
+        }
+        printImResult(opts.json, fetchAll ? { ...first, items, has_more: false, next_offset: null } : first);
+    });
+    attachSharedShortcutOptions(centerListOpts(parent
+        .command('+my-submitted')
+        .description('我提交的审批'))).action(async (opts, cmd) => {
+        const result = await listApprovalCenter('submitted', opts, cmd);
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(centerListOpts(parent
+        .command('+my-approved')
+        .description('我已审批的'))).action(async (opts, cmd) => {
+        const result = await listApprovalCenter('processed', opts, cmd);
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(centerListOpts(parent
+        .command('+cc')
+        .description('抄送我的审批'))).action(async (opts, cmd) => {
+        const result = await listApprovalCenter('cc', opts, cmd);
+        printImResult(opts.json, result);
+    });
+    const docAction = (cmd, description, requireProposal) => {
+        const c = cmd
+            .description(description)
+            .requiredOption('--res-model <name>', '业务模型 _name，如 sale.order')
+            .requiredOption('--res-id <id>', '业务记录 id');
+        if (requireProposal) {
+            return c.requiredOption('--proposal <text>', '驳回原因（不可为空）');
+        }
+        return c.option('--proposal <text>', '审批意见；省略等同空串');
+    };
+    attachSharedShortcutOptions(docAction(parent.command('+pass'), '审批通过当前待办步骤', false)).action(async (opts, cmd) => {
+        const { resModel, resId } = requireDocArgs(opts);
+        const merged = cmd.optsWithGlobals();
+        const result = await imRequest('POST', '/v1/approvals/pass', {
+            baseUrl: opts.baseUrl ?? merged.baseUrl,
+            body: { res_model: resModel, res_id: resId, proposal: opts.proposal ?? '' },
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(docAction(parent.command('+refuse'), '审批驳回', true)).action(async (opts, cmd) => {
+        const { resModel, resId } = requireDocArgs(opts);
+        const proposal = opts.proposal?.trim();
+        if (!proposal) {
+            throw new VertuError('--proposal is required for refuse.');
+        }
+        const merged = cmd.optsWithGlobals();
+        const result = await imRequest('POST', '/v1/approvals/refuse', {
+            baseUrl: opts.baseUrl ?? merged.baseUrl,
+            body: { res_model: resModel, res_id: resId, proposal },
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+logs')
+        .description('单据审批轨迹')
+        .requiredOption('--res-model <name>', '业务模型 _name')
+        .requiredOption('--res-id <id>', '业务记录 id')).action(async (opts, cmd) => {
+        const { resModel, resId } = requireDocArgs(opts);
+        const merged = cmd.optsWithGlobals();
+        const result = (await imRequest('GET', '/v1/approvals/logs', {
+            baseUrl: opts.baseUrl ?? merged.baseUrl,
+            query: { res_model: resModel, res_id: resId },
+        }));
+        if (opts.json === false) {
+            if (!result.logs.length) {
+                console.log('该单据暂无审批轨迹。');
+                return;
+            }
+            for (const log of result.logs) {
+                const segments = [
+                    log.action_label,
+                    log.employee_name ? `由 ${log.employee_name}` : '',
+                    log.node_name ? `(${log.node_name})` : '',
+                    new Date(log.created_at).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }),
+                ].filter(Boolean);
+                const line = segments.join(' ');
+                console.log(log.proposal ? `${line} — ${log.proposal}` : line);
+            }
+            return;
+        }
+        printImResult(opts.json, result);
+    });
+}

package/dist/packages/vps-work/src/commands/attendance/applications.js

@@ -0,0 +1,21 @@
+import { attachSharedShortcutOptions, runSkillShortcutExecute } from '../shortcut-common.js';
+const SKILL = 'vps-attendance-applications';
+export function attachAttendanceApplications(parent) {
+    const add = (name, description, script, configure) => {
+        let command = parent.command(name).description(description);
+        if (configure)
+            command = configure(command);
+        attachSharedShortcutOptions(command).action(async (opts, cmd) => {
+            await runSkillShortcutExecute(SKILL, script, opts.requestId ? { request_id: opts.requestId } : {}, opts, cmd);
+        });
+    };
+    add('+applications', '查询本人考勤申请；过滤条件通过 --params 传入', 'list_requests');
+    add('+application-preview', '预览申请审批流和服务端计算结果', 'request_preview');
+    add('+leave-types', '查询可用假期类型', 'leave_types');
+    add('+leave-options', '查询考勤申请选项', 'leave_options');
+    add('+leave-policy', '解析请假策略和可用余额', 'leave_policy');
+    add('+leave-balances', '查询本人假期余额', 'leave_balances');
+    add('+overtime-balances', '查询本人加班余额', 'overtime_balances');
+    add('+application-submit', '提交请假、出差、外勤、加班、补卡或换班申请；申请体通过 --params-file 传入', 'submit_request');
+    add('+application-cancel', '取消本人待审批考勤申请', 'cancel_request', (cmd) => cmd.requiredOption('--request-id <id>'));
+}

package/dist/packages/vps-work/src/commands/attendance/index.js

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+import { attachAttendanceShortcuts } from './shortcuts.js';
+import { attachAttendanceApplications } from './applications.js';
+export function buildAttendanceCommand() {
+    const attendance = new Command('attendance').description('Query attendance reports and manage authorized employee schedules.');
+    attachAttendanceShortcuts(attendance);
+    attachAttendanceApplications(attendance);
+    return attendance;
+}

package/dist/packages/vps-work/src/commands/attendance/scheduling.js

@@ -0,0 +1,183 @@
+import { VertuError } from '../../core/errors.js';
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { resolveVpsServiceUrl } from '../../core/sales-query-client.js';
+import { expandAtFileToken } from '../../utils/at-file.js';
+import { parseJsonArg } from '../../utils/parse-json-arg.js';
+import { attachSharedShortcutOptions, mergeShortcutParams } from '../shortcut-common.js';
+function text(value, flag) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new VertuError(`${flag} must not be empty.`);
+    return value.trim();
+}
+function date(value, flag) {
+    const result = text(value, flag);
+    const parsed = new Date(`${result}T00:00:00.000Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(result) || Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== result) {
+        throw new VertuError(`${flag} must be a valid YYYY-MM-DD date.`);
+    }
+    return result;
+}
+function positive(value, flag, fallback, max) {
+    const raw = value === undefined || value === null || value === '' ? fallback : Number(value);
+    if (!Number.isSafeInteger(raw) || Number(raw) <= 0 || (max !== undefined && Number(raw) > max)) {
+        throw new VertuError(`${flag} must be a positive integer${max ? ` no greater than ${max}` : ''}.`);
+    }
+    return Number(raw);
+}
+function normalizeRange(input) {
+    const from = date(input.from_date, 'from_date');
+    const to = date(input.to_date, 'to_date');
+    const days = (Date.parse(`${to}T00:00:00Z`) - Date.parse(`${from}T00:00:00Z`)) / 86_400_000 + 1;
+    if (days < 1 || days > 93)
+        throw new VertuError('The schedule date range must contain 1 to 93 days.');
+    const result = {
+        ...input,
+        from_date: from,
+        to_date: to,
+        page: positive(input.page, 'page', 1),
+        page_size: positive(input.page_size, 'page_size', 100, 200),
+    };
+    if (input.employee_id !== undefined)
+        result.employee_id = positive(input.employee_id, 'employee_id');
+    if (input.department_id !== undefined)
+        result.department_id = positive(input.department_id, 'department_id');
+    if (input.query !== undefined && typeof input.query !== 'string')
+        throw new VertuError('query must be a string.');
+    return result;
+}
+function normalizePlan(input, apply) {
+    const ruleID = text(input.rule_id, 'rule_id');
+    const mode = input.mode === undefined ? 'fill_missing' : text(input.mode, 'mode');
+    if (!['fill_missing', 'replace'].includes(mode))
+        throw new VertuError('mode must be fill_missing or replace.');
+    if (!Array.isArray(input.items) || input.items.length < 1 || input.items.length > 5000)
+        throw new VertuError('items must contain 1 to 5000 schedule entries.');
+    const keys = new Set();
+    const employees = new Set();
+    const dates = [];
+    const items = input.items.map((raw, index) => {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+            throw new VertuError(`items[${index}] must be an object.`);
+        const item = raw;
+        const employeeID = positive(item.employee_id, `items[${index}].employee_id`);
+        const workDate = date(item.work_date, `items[${index}].work_date`);
+        const shiftTemplateID = text(item.shift_template_id, `items[${index}].shift_template_id`);
+        const remark = item.remark === undefined ? undefined : text(item.remark, `items[${index}].remark`);
+        const key = `${employeeID}:${workDate}`;
+        if (keys.has(key))
+            throw new VertuError(`Duplicate schedule entry for ${key}.`);
+        keys.add(key);
+        employees.add(employeeID);
+        dates.push(workDate);
+        return { employee_id: employeeID, work_date: workDate, shift_template_id: shiftTemplateID, ...(remark ? { remark } : {}) };
+    });
+    if (employees.size > 200)
+        throw new VertuError('A schedule plan cannot contain more than 200 employees.');
+    dates.sort();
+    const rangeDays = (Date.parse(`${dates.at(-1)}T00:00:00Z`) - Date.parse(`${dates[0]}T00:00:00Z`)) / 86_400_000 + 1;
+    if (rangeDays > 93)
+        throw new VertuError('A schedule plan cannot span more than 93 days.');
+    const result = { ...input, rule_id: ruleID, mode, items };
+    if (apply) {
+        result.preview_token = text(input.preview_token, 'preview_token');
+        result.client_request_id = text(input.client_request_id, 'client_request_id');
+    }
+    else {
+        delete result.preview_token;
+        delete result.client_request_id;
+    }
+    return result;
+}
+async function basePlan(opts) {
+    if (opts.items !== undefined && opts.itemsFile !== undefined)
+        throw new VertuError('--items and --items-file are mutually exclusive.');
+    let items;
+    if (opts.items !== undefined)
+        items = parseJsonArg(opts.items, '--items');
+    if (opts.itemsFile !== undefined)
+        items = parseJsonArg(await expandAtFileToken(`@${opts.itemsFile}`, '--items-file'), '--items-file');
+    const shorthandUsed = Boolean(opts.employeeIds || opts.fromDate || opts.toDate || opts.shiftTemplateId);
+    if (items !== undefined && shorthandUsed)
+        throw new VertuError('--items/--items-file cannot be combined with range shorthand options.');
+    if (items === undefined && shorthandUsed) {
+        const employeeIDs = text(opts.employeeIds, '--employee-ids').split(',').map((value) => positive(value.trim(), '--employee-ids'));
+        const from = date(opts.fromDate, '--from-date');
+        const to = date(opts.toDate, '--to-date');
+        const shift = text(opts.shiftTemplateId, '--shift-template-id');
+        const days = (Date.parse(`${to}T00:00:00Z`) - Date.parse(`${from}T00:00:00Z`)) / 86_400_000 + 1;
+        if (days < 1 || days > 93)
+            throw new VertuError('The schedule date range must contain 1 to 93 days.');
+        items = [];
+        for (let offset = 0; offset < days; offset += 1) {
+            const current = new Date(`${from}T00:00:00Z`);
+            current.setUTCDate(current.getUTCDate() + offset);
+            for (const employeeID of employeeIDs) {
+                items.push({ employee_id: employeeID, work_date: current.toISOString().slice(0, 10), shift_template_id: shift, ...(opts.remark?.trim() ? { remark: opts.remark.trim() } : {}) });
+            }
+        }
+    }
+    return { rule_id: opts.ruleId, mode: opts.mode ?? 'fill_missing', ...(items === undefined ? {} : { items }), ...(opts.previewToken ? { preview_token: opts.previewToken } : {}), ...(opts.clientRequestId ? { client_request_id: opts.clientRequestId } : {}) };
+}
+function baseURL(opts, cmd) {
+    return opts.baseUrl ?? cmd.optsWithGlobals().baseUrl;
+}
+function preview(opts, cmd, method, path, payload) {
+    if (opts.validateOnly !== true && opts.dryRun !== true)
+        return false;
+    printImResult(opts.json, { validateOnly: true, method, endpoint: `${resolveVpsServiceUrl(baseURL(opts, cmd))}${path}`, ...payload });
+    return true;
+}
+export function attachAttendanceSchedulingShortcuts(parent) {
+    attachSharedShortcutOptions(parent.command('+schedule-rules').description('查询当前用户可执行排班的考勤规则'))
+        .action(async (opts, cmd) => {
+        const path = '/v1/attendance/scheduling/rules';
+        if (preview(opts, cmd, 'GET', path, {}))
+            return;
+        printImResult(opts.json, await imRequest('GET', path, { baseUrl: baseURL(opts, cmd) }));
+    });
+    attachSharedShortcutOptions(parent.command('+schedule-shifts').description('查询规则下可用和不可用班次').requiredOption('--rule-id <id>').option('--availability <value>', 'all|available|unavailable', 'all'))
+        .action(async (opts, cmd) => {
+        const params = await mergeShortcutParams({ availability: opts.availability }, opts);
+        const ruleID = text(params.rule_id ?? opts.ruleId, 'rule_id');
+        const availability = text(params.availability ?? 'all', 'availability');
+        if (!['all', 'available', 'unavailable'].includes(availability))
+            throw new VertuError('availability must be all, available, or unavailable.');
+        const path = `/v1/attendance/scheduling/rules/${encodeURIComponent(ruleID)}/shifts`;
+        const query = { availability };
+        if (preview(opts, cmd, 'GET', path, { query }))
+            return;
+        printImResult(opts.json, await imRequest('GET', path, { baseUrl: baseURL(opts, cmd), query }));
+    });
+    for (const [name, description] of [['+schedule-members', '查询规则下人员及排班事实'], ['+schedules', '查询规则下排班详情']]) {
+        attachSharedShortcutOptions(parent.command(name).description(description).requiredOption('--rule-id <id>').requiredOption('--from-date <ymd>').requiredOption('--to-date <ymd>')
+            .option('--employee-id <id>').option('--department-id <id>').option('--query <text>').option('--page <n>', '页码', '1').option('--page-size <n>', '每页人数，最大 200', '100'))
+            .action(async (opts, cmd) => {
+            const merged = await mergeShortcutParams({ rule_id: opts.ruleId, from_date: opts.fromDate, to_date: opts.toDate, employee_id: opts.employeeId, department_id: opts.departmentId, query: opts.query, page: opts.page, page_size: opts.pageSize }, opts);
+            const ruleID = text(merged.rule_id, 'rule_id');
+            delete merged.rule_id;
+            Object.keys(merged).forEach((key) => merged[key] === undefined && delete merged[key]);
+            const query = normalizeRange(merged);
+            const segment = name === '+schedules' ? 'schedules' : 'members';
+            const path = `/v1/attendance/scheduling/rules/${encodeURIComponent(ruleID)}/${segment}`;
+            if (preview(opts, cmd, 'GET', path, { query }))
+                return;
+            printImResult(opts.json, await imRequest('GET', path, { baseUrl: baseURL(opts, cmd), query }));
+        });
+    }
+    for (const [name, action] of [['+schedule-preview', 'preview'], ['+schedule-apply', 'apply']]) {
+        const command = parent.command(name).description(action === 'preview' ? '预览排班计划并获取短期令牌' : '使用预览令牌原子应用排班计划')
+            .requiredOption('--rule-id <id>').option('--mode <mode>', 'fill_missing|replace', 'fill_missing')
+            .option('--employee-ids <ids>', '逗号分隔员工 ID（范围简写）').option('--from-date <ymd>').option('--to-date <ymd>')
+            .option('--shift-template-id <id>').option('--remark <text>').option('--items <json>', '排班项目 JSON 数组')
+            .option('--items-file <path>', '从文件读取排班项目 JSON 数组');
+        if (action === 'apply')
+            command.requiredOption('--preview-token <token>').requiredOption('--client-request-id <id>');
+        attachSharedShortcutOptions(command).action(async (opts, cmd) => {
+            const body = normalizePlan(await mergeShortcutParams(await basePlan(opts), opts), action === 'apply');
+            const path = `/v1/attendance/scheduling/plans/${action}`;
+            if (preview(opts, cmd, 'POST', path, { body }))
+                return;
+            printImResult(opts.json, await imRequest('POST', path, { baseUrl: baseURL(opts, cmd), body }));
+        });
+    }
+}

package/dist/packages/vps-work/src/commands/attendance/shortcuts.js

@@ -0,0 +1,131 @@
+import { VertuError } from '../../core/errors.js';
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { resolveVpsServiceUrl } from '../../core/sales-query-client.js';
+import { attachSharedShortcutOptions, mergeShortcutParams, parseOptionalInt, } from '../shortcut-common.js';
+import { attachAttendanceSchedulingShortcuts } from './scheduling.js';
+function validDate(value, flag) {
+    const date = value?.trim() ?? '';
+    const parsed = new Date(`${date}T00:00:00.000Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(date) || Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== date) {
+        throw new VertuError(`${flag} must be a valid YYYY-MM-DD date.`);
+    }
+    return date;
+}
+function positiveInt(value, flag, fallback, max) {
+    const parsed = parseOptionalInt(value, flag) ?? fallback;
+    if (parsed <= 0 || (max !== undefined && parsed > max)) {
+        throw new VertuError(max === undefined ? `${flag} must be a positive integer.` : `${flag} must be between 1 and ${max}.`);
+    }
+    return parsed;
+}
+function queryText(value, flag) {
+    if (typeof value !== 'string')
+        throw new VertuError(`${flag} must be a string.`);
+    return value.trim();
+}
+function queryPositiveInt(value, flag, fallback, max) {
+    if (value === undefined || value === null)
+        return fallback;
+    if ((typeof value !== 'string' && typeof value !== 'number') || String(value).trim() === '') {
+        throw new VertuError(`${flag} must be a positive integer.`);
+    }
+    return positiveInt(String(value), flag, fallback, max);
+}
+export function normalizeAttendanceDailyQuery(input) {
+    const fromDate = validDate(queryText(input.from_date, 'from_date'), 'from_date');
+    const toDate = validDate(queryText(input.to_date, 'to_date'), 'to_date');
+    const days = Math.floor((Date.parse(`${toDate}T00:00:00Z`) - Date.parse(`${fromDate}T00:00:00Z`)) / 86_400_000) + 1;
+    if (days <= 0)
+        throw new VertuError('from_date cannot be later than to_date.');
+    if (days > 93)
+        throw new VertuError('The attendance daily query range cannot exceed 93 days.');
+    const scope = input.scope === undefined ? 'self' : queryText(input.scope, 'scope');
+    if (!['self', 'managed', 'employee', 'department', 'all'].includes(scope)) {
+        throw new VertuError('scope must be self, managed, employee, department, or all.');
+    }
+    const hasEmployeeId = input.employee_id !== undefined && input.employee_id !== null;
+    const hasDepartmentPath = input.department_path !== undefined && input.department_path !== null;
+    if ((scope === 'employee') !== hasEmployeeId) {
+        throw new VertuError('employee_id may only and must be provided when scope=employee.');
+    }
+    if ((scope === 'department') !== hasDepartmentPath) {
+        throw new VertuError('department_path may only and must be provided when scope=department.');
+    }
+    const query = {
+        ...input,
+        from_date: fromDate,
+        to_date: toDate,
+        scope,
+        page: queryPositiveInt(input.page, 'page', 1),
+        page_size: queryPositiveInt(input.page_size, 'page_size', 50, 200),
+    };
+    if (hasEmployeeId)
+        query.employee_id = queryPositiveInt(input.employee_id, 'employee_id', 0);
+    if (hasDepartmentPath) {
+        const departmentPath = queryText(input.department_path, 'department_path');
+        if (!departmentPath)
+            throw new VertuError('department_path must not be empty.');
+        query.department_path = departmentPath;
+    }
+    return query;
+}
+export function buildAttendanceDailyQuery(opts) {
+    const fromDate = validDate(opts.fromDate, '--from-date');
+    const toDate = validDate(opts.toDate, '--to-date');
+    const days = Math.floor((Date.parse(`${toDate}T00:00:00Z`) - Date.parse(`${fromDate}T00:00:00Z`)) / 86_400_000) + 1;
+    if (days <= 0)
+        throw new VertuError('--from-date cannot be later than --to-date.');
+    if (days > 93)
+        throw new VertuError('The attendance daily query range cannot exceed 93 days.');
+    const selectors = [
+        opts.managedDepartments ? 'managed' : undefined,
+        opts.employeeId ? 'employee' : undefined,
+        opts.departmentPath?.trim() ? 'department' : undefined,
+        opts.all ? 'all' : undefined,
+    ].filter((value) => value !== undefined);
+    if (selectors.length > 1) {
+        throw new VertuError('--managed-departments, --employee-id, --department-path, and --all are mutually exclusive.');
+    }
+    const scope = selectors[0] ?? 'self';
+    const query = {
+        from_date: fromDate,
+        to_date: toDate,
+        scope,
+        page: positiveInt(opts.page, '--page', 1),
+        page_size: positiveInt(opts.pageSize, '--page-size', 50, 200),
+    };
+    if (scope === 'employee')
+        query.employee_id = positiveInt(opts.employeeId, '--employee-id', 0);
+    if (scope === 'department')
+        query.department_path = opts.departmentPath?.trim();
+    return normalizeAttendanceDailyQuery(query);
+}
+export function attachAttendanceShortcuts(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+daily')
+        .description('查询考勤日报及影响当日的申请；默认查询本人')
+        .requiredOption('--from-date <ymd>', '开始日期，YYYY-MM-DD（含）')
+        .requiredOption('--to-date <ymd>', '结束日期，YYYY-MM-DD（含）')
+        .option('--managed-departments', '查询当前有权管理的部门员工', false)
+        .option('--employee-id <id>', '查询指定员工；需要本人、部门或全员权限')
+        .option('--department-path <path>', '按部门完整路径查询该部门及子部门')
+        .option('--all', '查询全体在职考勤员工；需要全员权限', false)
+        .option('--page <n>', '页码', '1')
+        .option('--page-size <n>', '每页条数，最大 200', '50')).action(async (opts, cmd) => {
+        const query = normalizeAttendanceDailyQuery(await mergeShortcutParams(buildAttendanceDailyQuery(opts), opts));
+        const globals = cmd.optsWithGlobals();
+        const baseUrl = opts.baseUrl ?? globals.baseUrl;
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            printImResult(opts.json, {
+                validateOnly: true,
+                method: 'GET',
+                endpoint: `${resolveVpsServiceUrl(baseUrl)}/v1/attendance/daily-reports`,
+                query,
+            });
+            return;
+        }
+        const result = await imRequest('GET', '/v1/attendance/daily-reports', { baseUrl, query });
+        printImResult(opts.json, result);
+    });
+    attachAttendanceSchedulingShortcuts(parent);
+}

package/dist/packages/vps-work/src/commands/auth/check.js

@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import { fetchVpsUserScopes, userHasVpsScope } from '../../core/vps-auth-scopes.js';
+import { resolveVpsServiceUrl } from '../../core/sales-query-client.js';
+export function buildAuthCheckCommand() {
+    return new Command('check')
+        .description('校验当前用户是否具备指定 scope（如 okr:structured:read）。exit 0 = 有权限，1 = 缺失。')
+        .argument('<scope>', 'resource:action，例如 execute:read')
+        .option('--base-url <url>', 'Vertu 服务地址')
+        .option('--json', '输出 JSON')
+        .action(async (scopeArg, opts, cmd) => {
+        const merged = cmd.optsWithGlobals();
+        const scope = scopeArg.trim();
+        const serviceUrl = resolveVpsServiceUrl(opts.baseUrl ?? merged.baseUrl);
+        const payload = await fetchVpsUserScopes(serviceUrl, scope);
+        const granted = payload.granted === true ||
+            userHasVpsScope(payload.userScopes ?? [], scope);
+        const out = {
+            appId: payload.appId,
+            scope,
+            granted,
+            login: payload.login,
+        };
+        if (opts.json) {
+            console.log(JSON.stringify(out, null, 2));
+        }
+        else if (granted) {
+            console.log(`scope 已授权：${scope}`);
+        }
+        else {
+            console.error(`scope 未授权：${scope}`);
+        }
+        process.exitCode = granted ? 0 : 1;
+    });
+}

package/dist/packages/vps-work/src/commands/auth/index.js

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import { buildLoginCommand } from '../login.js';
+import { buildLogoutCommand } from '../logout.js';
+import { buildAuthCheckCommand } from './check.js';
+import { buildAuthListCommand } from './list.js';
+import { buildAuthScopesCommand } from './scopes.js';
+import { buildAuthStatusCommand } from './status.js';
+import { buildAuthTenantsCommand } from './tenants.js';
+import { buildAuthUseCommand } from './use.js';
+export function buildAuthCommand() {
+    const auth = new Command('auth').description('Sign-in, sessions, and API scopes (resource:action).');
+    auth.addCommand(buildLoginCommand());
+    auth.addCommand(buildLogoutCommand());
+    auth.addCommand(buildAuthStatusCommand());
+    auth.addCommand(buildAuthCheckCommand());
+    auth.addCommand(buildAuthScopesCommand());
+    auth.addCommand(buildAuthListCommand());
+    auth.addCommand(buildAuthTenantsCommand());
+    auth.addCommand(buildAuthUseCommand());
+    return auth;
+}