weaver-work-cli 0.1.5 → 0.1.7

package/dist/shortcuts/okr/errors.js

@@ -0,0 +1,70 @@
+import { CliError, ExitCode } from '../../core/errors.js';
+export class OkrCliError extends CliError {
+    type;
+    subtype;
+    code;
+    retryable;
+    stage;
+    details;
+    partialData;
+    constructor(type, subtype, message, options = {}) {
+        super(message, options.exitCode ?? ExitCode.InternalError);
+        this.name = 'OkrCliError';
+        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 okrValidationError(subtype, message, details) {
+    return new OkrCliError('validation', subtype, message, {
+        details,
+        exitCode: ExitCode.UsageError,
+    });
+}
+export function okrAuthError(subtype, message, details) {
+    return new OkrCliError('authentication', subtype, message, {
+        details,
+        exitCode: ExitCode.AuthError,
+    });
+}
+export function okrNetworkError(subtype, message, options = {}) {
+    return new OkrCliError('network', subtype, message, {
+        ...options,
+        retryable: options.retryable ?? true,
+        exitCode: ExitCode.NetworkError,
+    });
+}
+export function okrApiError(subtype, message, details) {
+    return new OkrCliError('api', subtype, message, {
+        details,
+        exitCode: ExitCode.GeneralError,
+    });
+}
+export function okrConfirmationError(action, details) {
+    return new OkrCliError('confirmation', 'required', '该操作需要明确确认', {
+        details: { action, ...details },
+        exitCode: ExitCode.ConfirmationRequired,
+    });
+}
+/** 当前接口链路不支持该能力：源资料未提供该链路的实现依据，而不是输入错误。 */
+export function okrUnsupportedError(subtype, message, details) {
+    return new OkrCliError('policy', subtype, message, {
+        details,
+        exitCode: ExitCode.PolicyError,
+    });
+}
+export function okrPartialError(message, partialData, details) {
+    return new OkrCliError('partial', 'write_uncertain', message, {
+        details,
+        partialData,
+        exitCode: ExitCode.Partial,
+    });
+}
+/** 按结构化错误的 type 判定类型（不依赖类实例，兼容包装过的错误对象）。 */
+export function isOkrErrorType(error, type) {
+    return Boolean(error && typeof error === 'object' && error.type === type);
+}

package/dist/shortcuts/okr/host.js

@@ -0,0 +1,169 @@
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { getActiveProfile } from '../../internal/e10/auth/session.js';
+import { requireE10Session } from '../../internal/e10/context.js';
+import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { okrStateRoot } from './continuation.js';
+import { OkrCliError, okrAuthError, okrNetworkError, okrValidationError } from './errors.js';
+function inferProfile(ctx) {
+    const options = ctx.getGlobalOptions();
+    return options.profile || getActiveProfile();
+}
+function cacheFilename(root, key) {
+    const digest = createHash('sha256').update(key).digest('hex').slice(0, 40);
+    return resolve(root, 'cache', 'okr', `${digest}.json`);
+}
+async function readCacheFile(root, key) {
+    const file = cacheFilename(root, key);
+    if (!existsSync(file))
+        return undefined;
+    try {
+        const parsed = JSON.parse(await readFile(file, 'utf8'));
+        if (parsed.key !== key)
+            return undefined;
+        if (typeof parsed.expiresAt === 'number' && parsed.expiresAt < Date.now())
+            return undefined;
+        return parsed.value;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeCacheFile(root, key, value, ttlMs) {
+    const file = cacheFilename(root, key);
+    await mkdir(resolve(file, '..'), { recursive: true });
+    const payload = {
+        key,
+        value,
+        expiresAt: ttlMs === undefined ? null : Date.now() + ttlMs,
+        updatedAt: new Date().toISOString(),
+    };
+    await writeFile(file, `${JSON.stringify(payload)}\n`, 'utf8');
+}
+/** 统一业务错误消息提取。 */
+export function businessMessage(value) {
+    if (!value || typeof value !== 'object')
+        return '泛微接口返回业务失败';
+    const candidates = [
+        value.msg,
+        value.message,
+        value.resultMsg,
+        value.datajson?.message,
+        value.datajson?.msg,
+    ];
+    for (const item of candidates) {
+        if (typeof item === 'string' && item.trim())
+            return item;
+    }
+    return '泛微接口返回业务失败';
+}
+/** ebuilder datajson 结构成功判定：`datajson.status === true`（兼容字符串 "true"）。 */
+export function isDatajsonSuccess(value) {
+    const status = value?.datajson?.status;
+    return status === true || status === 'true';
+}
+/** 标准版标记型成功判定：`status` 为 "1" / 1 / true。 */
+export function isFlagSuccess(value) {
+    const status = value?.status;
+    return status === '1' || status === 1 || status === true;
+}
+function assertPath(requestPath) {
+    if (typeof requestPath !== 'string' || !requestPath.startsWith('/') || requestPath.startsWith('//')) {
+        throw okrValidationError('path_invalid', '请求路径必须是相对绝对路径');
+    }
+    if (/^https?:/i.test(requestPath) || /[\r\n]/.test(requestPath) || requestPath.includes('/../')) {
+        throw okrValidationError('path_invalid', '请求路径不允许跨域或路径逃逸');
+    }
+    if (!requestPath.startsWith('/api/')) {
+        throw okrValidationError('path_not_allowed', 'OKR 目标模块只能调用 /api/ 路径');
+    }
+}
+function omitEmptyQueryValues(query) {
+    if (!query)
+        return undefined;
+    return Object.fromEntries(Object.entries(query).filter(([, value]) => value !== '' && value !== undefined && value !== null));
+}
+function mapRuntimeNetworkError(error) {
+    if (error instanceof E10ApiError && error.type === 'network') {
+        throw okrNetworkError(error.subtype, error.message, {
+            retryable: error.retryable,
+            details: error.details,
+        });
+    }
+    throw error;
+}
+export function createOkrHost(ctx, dependencies = {}) {
+    let e10Session = null;
+    let sessionContext = null;
+    const requireSession = dependencies.requireSession || requireE10Session;
+    const cacheRoot = okrStateRoot(ctx);
+    async function ensureSession() {
+        if (!e10Session) {
+            e10Session = await requireSession(ctx);
+            sessionContext = {
+                baseUrl: e10Session.getBaseUrl(),
+                profile: inferProfile(ctx),
+                userId: e10Session.userId,
+                tenantKey: e10Session.tenantKey,
+                eteamsId: e10Session.eteamsId,
+            };
+        }
+        return e10Session;
+    }
+    async function getSession() {
+        await ensureSession();
+        return sessionContext;
+    }
+    async function runtime() {
+        return createE10RequestRuntime(ctx, await ensureSession(), {
+            interceptors: dependencies.interceptors,
+            fetch: dependencies.fetch,
+        });
+    }
+    async function request(request) {
+        const { method, path, query, body, operation, timeoutMs = 30_000 } = request;
+        assertPath(path);
+        let response;
+        try {
+            response = await (await runtime()).requestJson({
+                module: 'okr',
+                operation,
+                method: (method || 'POST').toUpperCase(),
+                path,
+                query: omitEmptyQueryValues(query),
+                body,
+                headers: { 'X-Requested-With': 'XMLHttpRequest' },
+                timeoutMs,
+                bigIntStrings: true,
+            });
+        }
+        catch (error) {
+            mapRuntimeNetworkError(error);
+        }
+        if (response.status === 401 || response.status === 302) {
+            throw okrAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url E10_DOMAIN --agent_type AGENT_NAME 完成登录', { httpStatus: response.status });
+        }
+        if (response.parseError) {
+            throw okrNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, { retryable: false });
+        }
+        if (response.status === 404) {
+            throw new OkrCliError('api', 'endpoint_not_found', `接口返回 404，当前环境可能未安装「OKR 目标」相关应用或未部署该接口（${path}）`, { code: response.status, details: { path }, exitCode: 1 });
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new OkrCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                code: response.status,
+                details: { status: response.status, message: businessMessage(response.value) },
+                exitCode: 1,
+            });
+        }
+        return response.value;
+    }
+    return {
+        request,
+        getSession,
+        getCache: (key) => readCacheFile(cacheRoot, key),
+        setCache: (key, value, ttlMs) => writeCacheFile(cacheRoot, key, value, ttlMs),
+    };
+}

package/dist/shortcuts/okr/index.js

@@ -0,0 +1,155 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createOkrContinuationSigner } from './continuation.js';
+import { okrValidationError } from './errors.js';
+import { createOkrHost } from './host.js';
+import { okrManifest } from './manifest.js';
+import { executeOkrOperation } 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+/, '');
+}
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw okrValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson) {
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    }
+    if (opts.input) {
+        let raw;
+        try {
+            raw = stripBom(opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8'));
+        }
+        catch {
+            throw okrValidationError('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 okrValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+export function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data === undefined ? null : result.data,
+        ...(result.meta ? { meta: result.meta } : {}),
+        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 executeOkrOperation(operation, input, {
+            ctx,
+            host: createOkrHost(ctx),
+            continuation: createOkrContinuationSigner(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 okrShortcut = {
+    name: 'okr',
+    description: '泛微E10 OKR 目标管理 CLI（目标查询/新建/编辑、关键成果、目标对齐、评论）',
+    category: 'shortcut',
+    register({ program, action }) {
+        const okr = program.command('okr').description('泛微E10 OKR 目标管理（目标列表/详情/新建/编辑、关键成果、目标对齐、评论、链路判定）');
+        okr.command('schema')
+            .description('Print okr operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(okrManifest, { json: true });
+        }));
+        okr.command('run')
+            .description('Run an okr operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. okr.list')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        // 高频便捷命令
+        okr.command('route')
+            .description('判定当前租户 OKR 接口链路（okr.version.check 薄包装）')
+            .option('--refresh', '忽略 1 天租户缓存，强制重新判定')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'okr.version.check', opts.refresh ? { refresh: true } : {});
+        }));
+        okr.command('get')
+            .description('查询单个目标详情（okr.get 薄包装）')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .option('--id <id>', '目标 ID')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'okr.get', await inputFrom(options, { id: opts.id }));
+        }));
+        okr.command('list')
+            .description('分页查询目标列表（okr.list 薄包装）')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .option('--period-type <type>', '周期类型：1-年度 2-季度 3-月度 4-自定义')
+            .option('--period-range <range>', '周期范围：年度/季度为 yyyy，月度为 yyyy-MM，自定义为「开始日期,结束日期」')
+            .option('--period-quarter <quarter>', '季度值 1-4')
+            .option('--page-no <n>', '页码')
+            .option('--page-size <n>', '每页条数')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'okr.list', await inputFrom(options, {
+                period_type: opts.periodType,
+                period_range: opts.periodRange,
+                period_quarter: opts.periodQuarter,
+                page_no: opts.pageNo,
+                page_size: opts.pageSize,
+            }));
+        }));
+        okr.command('viewlink')
+            .description('为已有目标 ID 生成详情页链接（okr.viewlink 薄包装）')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .option('--ids <ids>', '目标 ID，英文逗号拼接')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'okr.viewlink', await inputFrom(options, { ids: opts.ids }));
+        }));
+    },
+};

package/dist/shortcuts/okr/manifest.js

@@ -0,0 +1,70 @@
+import { okrOperationDefinitions } from './operations/registry.js';
+/**
+ * 禁用边界：源资料未提供以下能力的实现依据，因此不生成对应 operation，或只能限定在某一链路。
+ * - e10 标准版没有独立的关键成果分页接口：关键成果随目标列表/详情返回。
+ * - ebuilder 版没有目标评论接口：评论能力只在标准版链路可用。
+ * - e10 标准版没有「添加目标对齐」接口：目标对齐只在 ebuilder 链路可用。
+ */
+const WITHHELD = [
+    {
+        name: 'okr.kr.list.standard',
+        reason: 'e10 标准版源资料未提供独立的关键成果分页接口，关键成果通过 okr.list 的 goals[].keyresultList 或 okr.get 的 goal.keyresultList 获取；okr.kr.list 仅支持 ebuilder 链路',
+    },
+    {
+        name: 'okr.comment.list.eb',
+        reason: 'ebuilder 版源资料未提供目标评论接口，okr.comment.list 仅支持 e10 标准版链路',
+    },
+    {
+        name: 'okr.align.create.standard',
+        reason: 'e10 标准版源资料未提供「添加目标对齐」接口，okr.align.create.* 仅支持 ebuilder 链路',
+    },
+    {
+        name: 'okr.eb.kr.delete',
+        reason: '源资料只提供关键成果新建与编辑接口，没有删除关键成果接口，故不生成删除 operation',
+    },
+];
+function buildOperations() {
+    return okrOperationDefinitions().map((definition) => ({
+        name: definition.name,
+        resource: definition.resource,
+        summary: definition.summary,
+        ...(definition.capability ? { capability: definition.capability } : {}),
+        risk: definition.risk,
+        ...(definition.requiresConfirmation ? { requiresConfirmation: true } : {}),
+        inputSchema: definition.inputSchema,
+    }));
+}
+export const okrManifest = {
+    schemaVersion: 1,
+    name: 'okr',
+    title: '泛微E10 OKR 目标管理（目标查询/新建/编辑、关键成果、目标对齐、评论）',
+    version: '0.1.0',
+    host: 'e10-okr',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-okr',
+    capabilities: ['okr'],
+    /**
+     * OKR 目标接口链路路由：先读租户隔离、有效期 1 天的版本判定缓存，未命中才调用 okr_searchAppver
+     * 读取 ver_name；`ver_name >= V2` 走 e10-ebuilder 链路，其它情况走 e10 标准版链路。
+     * ebuilder 链路命中后严禁混用标准版接口，反之亦然。
+     */
+    linkRouting: {
+        versionInterface: 'okr_searchAppver',
+        versionField: 'ver_name',
+        ebWhen: '>=V2',
+        cacheKeyPrefix: 'okr:version:',
+        cacheTtlSeconds: 86400,
+        ebAppTag: 'weaver-wr-goal-eb',
+        ebFormTag: 'uf_wrgm_baseinfo',
+        ebFormIdFixedTenants: { tqasclatif: '1027322801024458753' },
+        ebFormIdCache: 'permanent-per-tenant',
+        standardDetailUrl: '/sp/goal/openDetail?id={goalId}',
+        ebDetailUrl: '/sp/ebdfpage/card/0/{okr目标详情eb表单id}/{goalId}',
+    },
+    /** 源资料强制规则：分页目标列表固定列，目标名称可点击跳转详情。 */
+    goalTableColumns: ['目标名称', '目标责任人名称', '目标周期类型', '目标周期范围'],
+    /** 源资料强制规则：人员 ID 必须先由 weaver-e10-hrm skill 解析，禁止直接传人员名称，禁止取 userId 字段。 */
+    personIdSource: 'weaver-e10-hrm',
+    operations: buildOperations(),
+    withheldOperations: WITHHELD,
+};