weaver-work-cli 0.1.8 → 0.1.20

package/dist/shortcuts/blog/errors.js

@@ -0,0 +1,60 @@
+import { CliError, ExitCode } from '../../core/errors.js';
+/** 日报模块结构化错误：type/subtype 驱动 Agent 决策，exitCode 决定进程退出码。 */
+export class BlogCliError extends CliError {
+    type;
+    subtype;
+    code;
+    retryable;
+    stage;
+    details;
+    partialData;
+    constructor(type, subtype, message, options = {}) {
+        super(message, options.exitCode ?? ExitCode.InternalError);
+        this.name = 'BlogCliError';
+        this.type = type;
+        this.subtype = subtype;
+        this.code = options.code;
+        this.retryable = options.retryable ?? false;
+        this.stage = options.stage;
+        this.details = options.details;
+        this.partialData = options.partialData;
+    }
+}
+export function blogValidationError(subtype, message, details) {
+    return new BlogCliError('validation', subtype, message, {
+        details,
+        exitCode: ExitCode.UsageError,
+    });
+}
+export function blogAuthError(subtype, message, details) {
+    return new BlogCliError('authentication', subtype, message, {
+        details,
+        exitCode: ExitCode.AuthError,
+    });
+}
+export function blogNetworkError(subtype, message, options = {}) {
+    return new BlogCliError('network', subtype, message, {
+        ...options,
+        retryable: options.retryable ?? true,
+        exitCode: ExitCode.NetworkError,
+    });
+}
+export function blogConfirmationError(action, details) {
+    return new BlogCliError('confirmation', 'required', '该操作需要明确确认', {
+        details: { action, ...details },
+        exitCode: ExitCode.ConfirmationRequired,
+    });
+}
+export function blogPartialError(message, partialData, details) {
+    return new BlogCliError('partial', 'write_uncertain', message, {
+        details,
+        partialData,
+        exitCode: ExitCode.Partial,
+    });
+}
+export function isBlogNetworkError(error) {
+    return Boolean(error
+        && typeof error === 'object'
+        && 'type' in error
+        && error.type === 'network');
+}

package/dist/shortcuts/blog/host.js

@@ -0,0 +1,175 @@
+import { ExitCode } from '../../core/errors.js';
+import { requireE10Session } from '../../internal/e10/context.js';
+import { getActiveProfile } from '../../internal/e10/auth/session.js';
+import { createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { BlogCliError, blogAuthError, blogNetworkError, blogValidationError, } from './errors.js';
+const MAX_EXPORT_BYTES = 50 * 1024 * 1024;
+/** E10 登录失效在业务响应体里的 code（实测 -2 既可能是数字也可能是字符串） */
+const SESSION_EXPIRED_CODES = new Set(['-2', -2]);
+function assertPath(requestPath) {
+    if (typeof requestPath !== 'string' || !requestPath.startsWith('/') || requestPath.startsWith('//')) {
+        throw blogValidationError('path_invalid', '请求路径必须是相对绝对路径');
+    }
+    if (/^https?:/i.test(requestPath) || /[\r\n]/.test(requestPath) || requestPath.includes('/../')) {
+        throw blogValidationError('path_invalid', '请求路径不允许跨域或路径逃逸');
+    }
+    if (!requestPath.startsWith('/api/')) {
+        throw blogValidationError('path_not_allowed', '日报模块只能调用 /api/ 路径');
+    }
+}
+/** 业务码位置在三种响应形态间漂移：顶层 code / res_base.ret / data.res_base.ret */
+function responseCode(value) {
+    return value?.code ?? value?.res_base?.ret ?? value?.data?.res_base?.ret;
+}
+function responseMessage(value) {
+    if (typeof value?.msg === 'string')
+        return value.msg;
+    if (typeof value?.message === 'string')
+        return value.message;
+    if (typeof value?.error === 'string')
+        return value.error;
+    return '泛微接口返回业务失败';
+}
+function isSessionExpired(value) {
+    const code = responseCode(value);
+    return code !== undefined && SESSION_EXPIRED_CODES.has(code);
+}
+/** 业务失败判定：fail === true，或 code 存在且不在 {0, 200} 与登录失效码之内 */
+function isBusinessFailure(value) {
+    if (value?.fail === true)
+        return true;
+    const code = responseCode(value);
+    if (code === undefined || code === null)
+        return false;
+    return !SESSION_EXPIRED_CODES.has(code)
+        && code !== 0 && code !== '0' && code !== 200 && code !== '200';
+}
+function inferProfile(ctx) {
+    const options = ctx.getGlobalOptions();
+    return options.profile || getActiveProfile();
+}
+export function createBlogHost(ctx, dependencies = {}) {
+    let e10Session = null;
+    let sessionContext = null;
+    const requireSession = dependencies.requireSession || requireE10Session;
+    async function ensureSession() {
+        if (!e10Session) {
+            e10Session = await requireSession(ctx);
+            sessionContext = {
+                baseUrl: e10Session.getBaseUrl(),
+                profile: inferProfile(ctx),
+                userId: e10Session.userId,
+            };
+        }
+        return e10Session;
+    }
+    async function getSession() {
+        await ensureSession();
+        return sessionContext;
+    }
+    async function runtime() {
+        return createE10RequestRuntime(ctx, await ensureSession(), {
+            interceptors: dependencies.interceptors,
+            fetch: dependencies.fetch,
+        });
+    }
+    function assertSession(value) {
+        if (isSessionExpired(value)) {
+            throw blogAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> --agent_type <当前智能体名称> 完成登录');
+        }
+    }
+    async function blogRequest(request) {
+        const { method = 'POST', path, query, body, operation, timeoutMs = 30_000 } = request;
+        assertPath(path);
+        const response = await (await runtime()).requestJson({
+            module: 'blog',
+            operation,
+            method,
+            path,
+            query: query,
+            body,
+            timeoutMs,
+        });
+        if (response.status === 401 || response.status === 302) {
+            throw blogAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> --agent_type <当前智能体名称> 完成登录', { httpStatus: response.status });
+        }
+        if (response.parseError) {
+            if (response.status < 200 || response.status >= 300) {
+                throw new BlogCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                    code: response.status,
+                    details: { status: response.status },
+                    exitCode: ExitCode.GeneralError,
+                });
+            }
+            throw blogNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, { retryable: false });
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new BlogCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                code: response.status,
+                details: { status: response.status, message: responseMessage(response.value) },
+                exitCode: ExitCode.GeneralError,
+            });
+        }
+        assertSession(response.value);
+        if (isBusinessFailure(response.value)) {
+            throw new BlogCliError('api', 'business_error', responseMessage(response.value), {
+                code: String(responseCode(response.value)),
+                details: { response: response.value },
+                exitCode: ExitCode.GeneralError,
+            });
+        }
+        return response.value;
+    }
+    async function blogBinaryRequest(request) {
+        const { method = 'POST', path, query, body, operation, timeoutMs = 60_000 } = request;
+        assertPath(path);
+        const response = await (await runtime()).requestBinary({
+            module: 'blog',
+            operation,
+            method,
+            path,
+            query: query,
+            body,
+            timeoutMs,
+            headers: { Accept: 'application/octet-stream, */*' },
+        });
+        if (response.status === 401 || response.status === 302) {
+            throw blogAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> --agent_type <当前智能体名称> 完成登录', { httpStatus: response.status });
+        }
+        const contentType = response.contentType;
+        const declaredLength = Number(response.headers.get('content-length'));
+        if (Number.isFinite(declaredLength) && declaredLength > MAX_EXPORT_BYTES) {
+            throw blogNetworkError('response_too_large', `导出文件超过 ${MAX_EXPORT_BYTES} 字节限制`, { retryable: false });
+        }
+        const content = response.content;
+        const looksLikeJson = /^[\s\r\n]*[[{]/.test(content.subarray(0, 64).toString('utf8'));
+        // 导出接口出错时返回 JSON（登录失效 / 业务失败），需在落盘前识别
+        if (response.status < 200 || response.status >= 300 || contentType.includes('json') || looksLikeJson) {
+            let value = {};
+            try {
+                value = JSON.parse(content.toString('utf8'));
+            }
+            catch {
+                value = {};
+            }
+            assertSession(value);
+            throw new BlogCliError('api', 'export_failed', responseMessage(value) || `导出失败（HTTP ${response.status}）`, {
+                code: response.status,
+                details: { status: response.status, preview: content.subarray(0, 500).toString('utf8') },
+                exitCode: ExitCode.GeneralError,
+            });
+        }
+        if (!content.length) {
+            throw blogNetworkError('protocol', '导出接口返回空文件', { retryable: false });
+        }
+        if (content.length > MAX_EXPORT_BYTES) {
+            throw blogNetworkError('response_too_large', `导出文件超过 ${MAX_EXPORT_BYTES} 字节限制`, { retryable: false });
+        }
+        return { content, contentType };
+    }
+    return {
+        blogRequest,
+        blogBinaryRequest,
+        getSession,
+    };
+}

package/dist/shortcuts/blog/index.js

@@ -0,0 +1,324 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createBlogContinuationSigner } from './continuation.js';
+import { blogValidationError } from './errors.js';
+import { createBlogHost } from './host.js';
+import { blogManifest } from './manifest.js';
+import { executeBlogOperation } from './operations.js';
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function stripBom(value) {
+    return value.replace(/^\uFEFF+/u, '');
+}
+/** 统一解析 `--input-json` / `--input <path>` / `--input -`，并合并薄包装命令的具名参数。 */
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw blogValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson) {
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    }
+    if (opts.input) {
+        let raw;
+        try {
+            raw = opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8');
+        }
+        catch {
+            throw blogValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+        input = parseJsonInput(raw, '--input');
+    }
+    return {
+        ...input,
+        ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== '')),
+    };
+}
+function parseJsonInput(raw, label) {
+    try {
+        const parsed = JSON.parse(stripBom(raw));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('input must be an object');
+        }
+        return parsed;
+    }
+    catch {
+        throw blogValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+function withJsonInputOptions(command) {
+    command
+        .option('--input <path>', 'JSON input file, or - for stdin')
+        .option('--input-json <json>', 'inline JSON input object');
+    return command;
+}
+function intOption(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+function namesOption(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const items = value.split(',').map((item) => item.trim()).filter(Boolean);
+    return items.length ? items : undefined;
+}
+function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data,
+        meta: { status: result.status },
+        warnings: [],
+    };
+}
+function failureEnvelope(error) {
+    const structured = error;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        ...(structured?.partialData === undefined ? {} : { data: structured.partialData }),
+        error: toErrorEnvelope(error),
+    };
+}
+async function executeAndPrint(ctx, operation, input) {
+    try {
+        const result = await executeBlogOperation(operation, input, {
+            host: createBlogHost(ctx),
+            continuation: createBlogContinuationSigner(ctx),
+        });
+        ctx.output.write(successEnvelope(operation, result), { json: true });
+    }
+    catch (error) {
+        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+export const blogShortcut = {
+    name: 'blog',
+    description: '泛微E10工作日报 CLI（查询/发布/编辑/评论/点赞/提醒/导出）',
+    category: 'shortcut',
+    register({ program, action }) {
+        const blog = program.command('blog').description('E10 工作日报（查询/发布/编辑/评论/点赞/提醒/导出）');
+        blog.command('schema')
+            .description('Print blog operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(blogManifest, { json: true });
+        }));
+        withJsonInputOptions(blog.command('run')
+            .description('Run a blog operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. blog.query')).action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        withJsonInputOptions(blog.command('query')
+            .description('批量查群体日报（下属/关注），按天汇总提交情况')
+            .option('--user-type <type>', 'directSubordinate|indirectSubordinate|allSubordinate|myFollow')
+            .option('--start <date>', 'start date YYYY-MM-DD')
+            .option('--end <date>', 'end date YYYY-MM-DD')
+            .option('--keywords <text>', 'keyword filter')
+            .option('--page-size <n>', 'page size (max 300)')
+            .option('--page-no <n>', 'page number')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.query', await inputFrom(options, {
+                user_type: opts.userType,
+                start_date: opts.start,
+                end_date: opts.end,
+                keywords: opts.keywords,
+                page_size: intOption(opts.pageSize),
+                page_no: intOption(opts.pageNo),
+            }));
+        }));
+        withJsonInputOptions(blog.command('query-user')
+            .description('查单人日报（detailsByDate 逐日扫描，区间上限 62 天）')
+            .option('--user-id <id>', 'target user id')
+            .option('--name <name>', 'target user name (HRM exact match)')
+            .option('--date <date>', 'start date YYYY-MM-DD')
+            .option('--end <date>', 'end date (inclusive)')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.query_user', await inputFrom(options, {
+                user_id: opts.userId,
+                name: opts.name,
+                date: opts.date,
+                end_date: opts.end,
+            }));
+        }));
+        withJsonInputOptions(blog.command('resolve-users')
+            .description('HRM 按姓名解析 userId')
+            .option('--name <name>', 'employee name')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.resolve_users', await inputFrom(options, { name: opts.name }));
+        }));
+        withJsonInputOptions(blog.command('comments')
+            .description('查某条日报的评论列表')
+            .option('--blog-id <id>', 'blog id')
+            .option('--page-size <n>', 'page size (max 100)')
+            .option('--page-no <n>', 'page number')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.comments', await inputFrom(options, {
+                blog_id: opts.blogId,
+                page_size: intOption(opts.pageSize),
+                page_no: intOption(opts.pageNo),
+            }));
+        }));
+        withJsonInputOptions(blog.command('default-permission')
+            .description('查某日期的默认共享对象')
+            .option('--date <date>', 'blog date YYYY-MM-DD')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.default_permission', await inputFrom(options, { date: opts.date }));
+        }));
+        withJsonInputOptions(blog.command('export')
+            .description('导出日报为 xlsx 文件（拒绝覆盖已存在文件）')
+            .option('--start <date>', 'start date YYYY-MM-DD')
+            .option('--end <date>', 'end date YYYY-MM-DD')
+            .option('--output <path>', 'output .xlsx path')
+            .option('--page-size <n>', 'page size')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.export', await inputFrom(options, {
+                start_date: opts.start,
+                end_date: opts.end,
+                output: opts.output,
+                page_size: intOption(opts.pageSize),
+            }));
+        }));
+        const publish = blog.command('publish').description('发布日报命令组（prepare -> apply）');
+        withJsonInputOptions(publish.command('prepare')
+            .description('Prepare blog.publish（查重 + 回填默认共享 + 签发 continuation）')
+            .option('--date <date>', 'blog date YYYY-MM-DD')
+            .option('--content <text>', 'blog content')
+            .option('--no-share-default', 'skip default share objects')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.publish.prepare', await inputFrom(options, {
+                date: opts.date,
+                content: opts.content,
+                share_default: opts.shareDefault === false ? false : undefined,
+            }));
+        }));
+        withJsonInputOptions(publish.command('apply')
+            .description('Apply blog.publish（需 confirm 与 continuation）')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.publish.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const edit = blog.command('edit').description('编辑日报命令组（prepare -> apply）');
+        withJsonInputOptions(edit.command('prepare')
+            .description('Prepare blog.edit（回查原内容与差异 + 签发 continuation）')
+            .option('--user-id <id>', 'target user id')
+            .option('--name <name>', 'target user name')
+            .option('--date <date>', 'blog date YYYY-MM-DD')
+            .option('--content <text>', 'new blog content')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.edit.prepare', await inputFrom(options, {
+                user_id: opts.userId,
+                name: opts.name,
+                date: opts.date,
+                content: opts.content,
+            }));
+        }));
+        withJsonInputOptions(edit.command('apply')
+            .description('Apply blog.edit（需 confirm 与 continuation）')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.edit.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const comment = blog.command('comment').description('评论日报命令组（prepare -> apply）');
+        withJsonInputOptions(comment.command('prepare')
+            .description('Prepare blog.comment（定位目标日报 + 签发 continuation）')
+            .option('--blog-id <id>', 'blog id (or date + user)')
+            .option('--user-id <id>', 'target user id')
+            .option('--name <name>', 'target user name')
+            .option('--date <date>', 'blog date YYYY-MM-DD')
+            .option('--content <text>', 'comment content')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.comment.prepare', await inputFrom(options, {
+                blog_id: opts.blogId,
+                user_id: opts.userId,
+                name: opts.name,
+                date: opts.date,
+                content: opts.content,
+            }));
+        }));
+        withJsonInputOptions(comment.command('apply')
+            .description('Apply blog.comment（需 confirm 与 continuation）')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.comment.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const like = blog.command('like').description('点赞/取消点赞命令组（prepare -> apply）');
+        withJsonInputOptions(like.command('prepare')
+            .description('Prepare blog.like（定位目标日报 + 签发 continuation）')
+            .option('--blog-id <id>', 'blog id (or date + user)')
+            .option('--user-id <id>', 'target user id')
+            .option('--name <name>', 'target user name')
+            .option('--date <date>', 'blog date YYYY-MM-DD')
+            .option('--cancel', 'cancel the like (cancelVote)')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.like.prepare', await inputFrom(options, {
+                blog_id: opts.blogId,
+                user_id: opts.userId,
+                name: opts.name,
+                date: opts.date,
+                cancel: opts.cancel === true ? true : undefined,
+            }));
+        }));
+        withJsonInputOptions(like.command('apply')
+            .description('Apply blog.like（需 confirm 与 continuation）')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.like.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const remind = blog.command('remind').description('提醒提交日报命令组（prepare -> apply）');
+        withJsonInputOptions(remind.command('prepare')
+            .description('Prepare blog.remind（解析被提醒人 + 默认文案 + 签发 continuation）')
+            .option('--user-ids <id,id,...>', 'remind target user ids')
+            .option('--names <name,name,...>', 'remind target names (HRM resolved)')
+            .option('--date <date>', 'blog date YYYY-MM-DD')
+            .option('--content <text>', 'custom remind content')
+            .option('--year <n>', 'blog year')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.remind.prepare', await inputFrom(options, {
+                user_ids: opts.userIds,
+                names: namesOption(opts.names),
+                date: opts.date,
+                content: opts.content,
+                year: intOption(opts.year),
+            }));
+        }));
+        withJsonInputOptions(remind.command('apply')
+            .description('Apply blog.remind（需 confirm 与 continuation）')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')).action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'blog.remind.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+    },
+};